home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Exec 5 / CD_Magazyn_EXEC_nr_5.iso / Programy / X-Window / readme next >
Encoding:
Text File  |  2001-02-15  |  6.2 KB  |  249 lines
  1. This is another public release of my attempt to build an X11 server for
  2. Amiga. It is supposed to fix all known bugs from the previous release and
  3. may even have some new features. For details, see changes below.
  4.  
  5.  
  6.  
  7. Contact:
  8. --------
  9.  
  10.     email:    dspach@free.fr
  11.     web:    http://dspach.free.fr
  12.  
  13.  
  14.  
  15. Changes:
  16. --------
  17.  
  18. * main changes in v030
  19.  
  20.     this release is now fully based on Xfree402 source code
  21.  
  22.     IMPORTANT:
  23.  
  24.     amiga specific options syntax has changed to avoid options name
  25.     clashes with Xfree one's, this is now
  26.  
  27.     Xami402 [regularXoptions] -amiga:option1,option2,option3 ...
  28.  
  29.     features
  30.  
  31.     - only one version for RTG and OCS/ECS/AGA
  32.     - built-ins fixed fonts and cursors
  33.     - depth support 4/8/15/16/24/32 bits per pixel
  34.     - always use a colormap for depth <= 8
  35.     - hardware cursor is enabled by default
  36.     - work-around for clients using little endian pixmaps
  37.     - may display in a window
  38.     - may display in a PiP window
  39.     - Workbench tooltypes handling has changed, see below
  40.  
  41.  
  42.  
  43. Requirements:
  44. -------------
  45.  
  46.     - WB 3.0 or up
  47.     - 020, 030, 040 or 060 CPU with FPU
  48.     - network subsystem such as AmiTCP, Genesis or Miami
  49.  
  50.     Supported depth, pixel formats and additionnal requirements:
  51.  
  52.     * Xami402
  53.  
  54.     - depth 4 bits for OCS/ECS chipsets
  55.     - depth 4 or 8 bits for AGA chipsets
  56.  
  57.     when using a graphic card:
  58.  
  59.     - requires RTG system such as Cybergraphics (V41) or Picasso96 (V2)
  60.     - depth 8, 15, 16, 24, 32 bits
  61.     - window mode requires Picasso96 V2
  62.     - PiP window mode requires Picasso96 V2
  63.  
  64. NOTE1:
  65. some knowledge about X11 is required, since I'm not going to supply it !
  66.  
  67.  
  68. NOTE2:
  69. no more fonts are provided in this distribution since this release has
  70. some built-ins fonts and cursors. But most clients will require more
  71. fonts, so you may get them from my site, from the Geek Gadgets distribution
  72. at http://www.ninemoons.com or from any BSD/Linux distribution.
  73. Fonts must be dropped in X11ami:lib/X11/fonts/font-type-dir,
  74. just make sure that fonts.dir and fonts.alias files have the correct
  75. content (see an X font manual for description).
  76.  
  77.  
  78.  
  79. Useful links:
  80. -------------
  81.  
  82. X is a big subject on his own, so you may find some related infos at
  83.  
  84.     http://www.xfree86.org
  85.     http://www.rahul.net/kenton
  86.  
  87.  
  88.  
  89. Usage:
  90. ------
  91.  
  92. Before starting the server, make sure to launch the MakeAssign icon,
  93. since an assign is required for the server to find fonts and bitmaps
  94. at the right place.
  95.  
  96. To learn the Workbench ToolTypes and/or CLI options, use a CLI and
  97. type:
  98.  
  99.     X11ami:Xami402 zzz
  100.  
  101. Almost all the CLI options are the same as the standart X11 servers
  102. found in the Un*x world.
  103.  
  104. Amiga specific options are:
  105.  
  106.   noaccel
  107.  
  108.     turn off graphic acceleration. This will considerably slowdown
  109.     graphics operations such as on screen rectangle fills or
  110.     blittings. However this may in some cases be safer.
  111.  
  112.   nohwcursor
  113.  
  114.     disable hardware cursor emulation
  115.  
  116.   nolock
  117.  
  118.     This is a dangerous option that may crash your machine, you have
  119.     been warned. This will remove the locking/unlocking mechanism
  120.     of the screen or PIP bitmap.
  121.  
  122.   nocbpixe
  123.  
  124.     turn off pixmap endianness work-around
  125.  
  126.   planar
  127.  
  128.     use native Amiga chipset instead of RTG card
  129.  
  130.   pip
  131.  
  132.     show X display in a PiP window, you need a graphic card that has
  133.     Picture in Picture capability and you must use the Picasso96
  134.     RTG system. Some more restrictions may apply for your card, e.g.
  135.     8 bits PiP on a 16 bits screen, etc .... Consult your P96 doc.
  136.  
  137.   window
  138.  
  139.     show X display in a window of the default public screen, here also
  140.     Picasso96 RTG system is mandatory. The depth of the X display will
  141.     be the same as the public screen one's. The public screen depth
  142.     must be more than 8 bits, that is an RTG card is required. (NOTE3)
  143.  
  144.   screen=mode
  145.  
  146.     use that 'mode' screen, the value may be specified in Hex or decimal.
  147.     For a PAL Hires Screen Mode this value is 0x29000.
  148.  
  149.   priority=N
  150.  
  151.     set the foreground process priority when the server is running
  152.     (process will go down to priority -1 when iconified)
  153.  
  154.   dpi=XxY
  155.  
  156.     set display resolution to X and Y dpi instead of defaults 75
  157.  
  158.   pixel=format
  159.  
  160.     set pixel format such as rgb15, bgr24, argb32 ... (NOTE3)
  161.  
  162.   WIDTHxHEIGHTxDEPTH
  163.  
  164.     use a display size of WIDTH and HEIGHT with a pixel that DEPTH
  165.  
  166.  
  167.  
  168. NOTE3:
  169. specifying a pixel format such as rgb15pc or rgb16pc without using the
  170. window mode will surely display color garbage. If your card only supports
  171. little endian 15/16 bits modes (rgb15pc or rgb16pc), do the following:
  172.  
  173.     - make the default public screen (Workbench probably) that format
  174.     - use options: window,pixel=rgb15 or rgb16
  175.  
  176. the window mode uses an off-screen frame buffer, and is able to do on
  177. the fly rgb15 to rgb15pc or rgb16 to rgb16pc conversions
  178.  
  179.  
  180.  
  181. Workbench usage:
  182. ----------------
  183.  
  184. If you want to start the server from Workbench you will have to setup
  185. the icon as a project whose tool is X11ami:Xami402 and provide
  186. tooltypes almost the same way as the CLI options.
  187.  
  188. if you use from CLI
  189.  
  190.     Xami402 -amiga:800x600x16 -query pc -fp built-ins,tcp/pc:7100
  191.  
  192. then do on the icon
  193.  
  194.     - tool            X11ami:Xami402
  195.     - 1st tooltype        -amiga:800x600x16
  196.     - 2nd tooltype        -query pc
  197.     - 3rd tooltype        -fp built-ins,tcp/pc:7100
  198.  
  199. NOTE4:
  200. in the above example, we use a host named pc (probably a Linux box)
  201. with a display manager (-query pc) and a font server on TCP port 7100,
  202. but built-ins server fonts are first searched
  203.  
  204.  
  205. Make sure also to modify the etc/X0.hosts file in order to allow remote
  206. machines to display on your amiga machine.
  207.  
  208. Here are the settings I use to connect to my pc Linux box from my A4000
  209. with AriadNE2 and PicassoIV cards:
  210.  
  211.     Xami402 -amiga:nolock,pip,960x720,pixel=rgb16,priority=1
  212.         :0 -query pc -fp built-ins,tcp/pc:7100 -once
  213.  
  214.  
  215.  
  216. Shortkeys:
  217. ----------
  218.  
  219. - RAmiga-Q    quit the server
  220. - RAmiga-R    reset the server
  221. - RAmiga-M    send screen or window to back
  222. - RAmiga-H    iconify the server
  223.  
  224.  
  225.  
  226. Known issues:
  227. -------------
  228.  
  229. - only TCP/IP transport is used even with local clients
  230. - does not check if PIP window is greater than screen
  231. - memory fragmentation (huge usage of alloc/free)
  232. - pixel=bgr24 shows wrong colors, as probably some other formats
  233.  
  234.  
  235.  
  236. Please note also:
  237. -----------------
  238.  
  239. The following may apply if the nocbpixe option is used.
  240.  
  241. Some applications running on Little Endian machines (PC's) display
  242. wrong colors on the Amiga server which is a Big Endian machine. For
  243. instance, StarOffice is known for that problem, as are some Window
  244. Managers.
  245.  
  246.     THIS IS NOT a bug of Xami !
  247.  
  248.  
  249.