home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 January, February, March & April / Chip-Cover-CD-2007-02.iso / dosutils / weirdx / weirdx.jar / INSTALL < prev    next >
Text File  |  2001-12-10  |  14KB  |  374 lines
  1.  
  2. How to use WeirdX
  3. ====================================================================
  4. Last modified: Wed Nov 15 16:20:17 UTC 2000
  5.  
  6.   * SUPPORTED PLATFORMS
  7.   * REQUIREMENTS
  8.   * OPTIONAL
  9.   * USAGE
  10.   * USAGE AS AN APPLET
  11.   * WeirdX runs without Swing!
  12.   * XDMCP
  13.   * Copy/Paste
  14.   * Multibyte Characters
  15.   * Keyboard
  16.   * Hacks for the Alpha Transparency
  17.   * EsounD Support
  18.   * DXPC Support
  19.   * XJS Extension for WeirdX
  20.   * PROPERTIES
  21.  
  22. SUPPORTED PLATFORMS
  23. ===================
  24. WeirdX is implemented with JDK 1.1.*.
  25. So, WeirdX will be available on any platform, which support JDK 1.1.
  26. Here, we list supported platforms, which we have confirmed already.
  27. If you succeed to run WeirdX on other platform, please add it to
  28. this list. 
  29.  
  30. - Windows 95
  31. - Windows 98
  32. - Windows NT
  33. - Windows 2000 Professional using JDK 1.3.0rc1 (feedback from Schult, John)
  34. - OS/2, J2SE 1.3 (feeback from Dan Nimick)
  35. - Sparc Solaris, Netscape4.72&Java2 Plug-in
  36.   (feedback from Chris Debenham)
  37. - Intel Solaris 2.6.0
  38. - Intel GNU/Linux, J2SE v.1.2.2 
  39.   (feedback from David Golden)
  40. - FreeBSD
  41.   (feedback from Brian Gilman)
  42. - Alpha OSF1, J2SDK.v.1.2.1 
  43.   (feedback from Keith Schincke)
  44. - MacOS X Beta, Java HotSpot Client 1.3 
  45.   (feedback from Ryan Calder)
  46. - MacOS 9 with MRJ 2.1.4, MacOS 8.6 with MRJ 2.1.x 
  47.   (feedback from Tarun Reddy, Eric Albert)
  48.  
  49. REQUIREMENTS:
  50. =============
  51.  
  52. The following softwares are required to use WeirdX.
  53.  
  54. - JDK 1.1.*(in some case, Swing 1.1.*) or Java2
  55.  
  56. WeirdX runs without the Swing API and, in a optional mode, 
  57. it runs with the Swing API. 
  58. For the difference between them, please refer to the section
  59. 'WeirdX runs without Swing!'.
  60.  
  61.  
  62. OPTIONAL:
  63. =========
  64.  
  65. WeirdX is also usable as an Java applet;
  66. WeirdX will run in a web browser, Internet Explorer, Netscape Navigator.
  67. If you try WeirdX on Windows 95/98, we recommend to run WeirdX in a
  68. web browser. If you run WeirdX as an application on DOS prompt,
  69. it will run very slowly.
  70.  
  71. - web browser.
  72.     Internet Explorer or Netscape Navigator.
  73.         Don't use Java2 plug-in on Opera. Opera will crash.
  74.  
  75. USAGE:
  76. ======
  77. Before using WeirdX, check CLASSPATH includes swingall.jar in Swing 1.1.*
  78. and current directory. Then type,
  79.      
  80.        javac -O com/jcraft/weirdx/*.java com/jcraft/util/*.java
  81. # In this distribution, *.class files has been included, 
  82. # so you can skip this step. 
  83.  
  84.        java com.jcraft.weirdx.WeirdX
  85. or
  86.        cd misc
  87.        java -jar weirdx.jar
  88.  
  89. If 'config/props' exists, property settings in that file will be
  90. loaded. If you want to over write those propety settings, just edit 
  91. that file or give options to java command. For example,
  92.  
  93.        java -Dweirdx.displaynum=3 -Dweirdx.jesd=yes -jar weirdx.jar
  94.  
  95. If everything goes well automagically, one window will be opened 
  96. on your desktop. This is an X Window System server. 
  97. In default setting, WeirdX will use display-name '<your hostname>:2.0' .
  98.  
  99. To run x clients on WeirdX, just specify '-display' option.
  100. Suppose that WeirdX are running on some machine, named "foo",
  101. and you have Un*x machine, named "bar". Try next command on machine "bar"
  102.  
  103.        xlogo -display foo:2.0
  104.  
  105. "misc" directory has some scripts for executing WeirdX easily.
  106. At present, scripts for Unix, Windows and OS/2 are located.
  107.  
  108.  
  109. USAGE AS AN APPLET:
  110. ==================
  111. Copy "misc/weirdx.jar" and "misc/weirdx.html" to some directory,
  112. which is accessible through a http server, then open weirdx.html with 
  113. a web browser via a http server. If everything goes well, 
  114. WeirdX will start in your web browser.
  115. In default setting, WeirdX use display-name 
  116. '<your hostname>:2.0' .
  117. If you have Java Plug-in, try 'weirdx-JRE12.html'.
  118.  
  119. In some situations, JVM may throw the Security Exception.
  120. WeirdX must gain access to TCP port(6002) and JVM may reject to do so.
  121.  
  122.  
  123. WeirdX runs without Swing!:
  124. ==========================
  125. Since 1.0.16, WeirdX runs without the Swing API.
  126. # This improvement has been done by Marcus Schiesser.
  127. This new version has advantages over previous versions, 
  128. which had used Swing API, in that, needless to say, 
  129. it can run on web browser without Java Plug-in
  130. and it is free from the snail Swing's painting system.
  131. The disadvantage is that you will observe unnecessary re-paintings on the
  132. Swing free version. In other words, WeirdX had used the Swing API to
  133. prevent those re-paintings. If you want to use Swing version, set a
  134. property 'weirdx.ddxwindow' as 'com.jcraft.weirdx.DDXWindowImpSwing' .
  135.  
  136.  
  137. XDMCP:
  138. ======
  139. WeirdX supports XDMCP. If you want to use this functionality,
  140. specify properties, 'weirdx.xdmcp.mode' and 'weirdx.xdmcp.address'
  141. appropriately. In current implementation, 'indirect query' has not
  142. been supported.
  143. And this functionality can be used as a stand alone program,
  144. so it will be useful for X Window System users, whose X server 
  145. does not support XDMCP. Try,
  146.  
  147.   java com.jcraft.weirdx.XDMCP -query somewhere -display display-name
  148. or
  149.   java com.jcraft.weirdx.XDMCP -broadcast somewhere -display display-name
  150.  
  151. If everything goes well, xdm will open a login-window on your
  152. X server. After you get a login-window, please kill the above java process
  153. as soon as possible.
  154. Caution: At present, any authorization mechanism has not been implemented.
  155. So please use this functionality with your own risk.
  156.  
  157.  
  158. Copy/Paste:
  159. ==========
  160. Copy/paste operations between the native window system
  161. and WeirdX(CUT_BUFFER0) has been supported. 
  162. For example, you can copy/paste strings on 'xterm', 
  163. which runs on WeirdX, to 'notepad' on Windows98.
  164. At present, 'selection' has not been supported. So you can't copy strings
  165. on TextField widgets of GTK,Motif to apps on Windows98.
  166. However, 'xcutsel' will help you.
  167.  
  168.  
  169. Multibyte Characters:
  170. ====================
  171. WeirdX supports to display multibyte characters on the internationalized JRE.
  172. If you need to display Japanese, Korean and Chinese characters on Weirdx, try
  173. weirdx.display.charset=JISX,KSC5601,GB2312
  174. At present, WeirdX supports Japanese, Korean and Chinese characters,
  175. but only Japanese characters have been confirmed to be
  176. handled correctly.
  177. If you succeeded or failed to display others, please write us.
  178.  
  179.  
  180. Keyboard:
  181. ========
  182. In default settings, WeirdX supposes that key events are from
  183. US layout keyboard. If your keyboard is other layout one, 
  184. you can change internal keymap definitions by setting 
  185. a property 'weirdx.display.keymap'.
  186. If your keyboard is for U.K., try
  187. weirdx.display.keymap=gb
  188. At present, WeirdX supports gb(U.K. layout keyboard), de.
  189. If you are using other keyborad, for example, jp106. Please try
  190. 'misc/keymap/genkeymap.pl'. It is a perl script and generates
  191. java files for supporting your keyboard. 
  192. Please refer to 'misc/keymap/HOWTO'for its usage.
  193.  
  194.  
  195. Hacks for the Alpha Transparency:
  196. =================================
  197. Two hacks for the alpha transparency have been added.
  198. * First hack renders backgrounds of every windows,
  199.   which have pixel background value, with alpha compositions. 
  200.   For example, if you set a property 'weirdx.ddxwindow' as
  201.   'com.jcraft.weirdx.DDXWindowImpSwingAlphaBackground',
  202.   a property 'weirdx.display.background.alpha' as '0xff0000:0x20' 
  203.   and run 'xterm -bg red', 
  204.   the background of xterm will be rendered as '0x20ff0000'.
  205. * Second hack renders contents of windows with alpha compositions. 
  206.   This hack is based on Java2D, so J2SE 1.2.* or higher are required.
  207.   To enable this hack, set a property 
  208.   'weirdx.ddxwindow' as 
  209.   'com.jcraft.weirdx.DDXWindowImpSwingAlphaBackground2D' .
  210.  
  211. Please note those hacks are just for the fun, not for the practical use
  212. and they will be useful for surprising your friends.
  213.  
  214.  
  215. EsounD Support:
  216. ===============
  217. You can run EsounD compatible applications on WeirdX with JEsd.
  218. JEsd is a re-implementation of EsounD in pure Java and
  219. has been developed by JCraft. Please note that your JVM must be 
  220. J2SE v1.3 or higher to use this functionality. To enable this
  221. functionality, try following steps,
  222. 1. Download a jesd archive from http://www.jcraft.com/jesd/ ,
  223.    extract class files from it and then
  224.    make these class files to be accessible through the CLASSPATH by WeirdX.
  225. 2. Specify property 'weirdx.jesd' as 'yes'.
  226. 3. Run WeirdX.
  227. 4. On the remote host, try next command,
  228.    $ esdcat -s 'hostname where WeirdX is running' 'filename of WAV file'
  229.    Try other EsounD compatible apps, mpg123, gqmpeg and xmms.
  230.  
  231.  
  232. DXPC Support:
  233. =============
  234. The dxpc(Differential X Protocol Compressor) is an X protocol compressor 
  235. designed to improve the speed of X applications run over low-bandwidth links 
  236. (such as dialup PPP connections).
  237. WeirdX can accept connections via dxpc from X clients with the assistance 
  238. of JDxpc. JDxpc is a re-implementation of dxpc in pure Java and it has been
  239. developed by JCraft under LGPL. It is available at http://www.jcraft.com/weirdx/ . To enable this functionality, try following steps,
  240. 1. Download a JDxpc archive from http://www.jcraft.com/jdxpc/ ,
  241.    extract class files from it and then make these class files to 
  242.    be accessible through the CLASSPATH by WeirdX.
  243. 2. Specify property 'weirdx.jdxpc' as 'yes'.
  244. 3. Run WeirdX.
  245. 4. On the remote host, try next command,
  246.    $ dxpc -w 'hostname where WeirdX is running'
  247.    $ export DISPLAY=localhost:8.0
  248.    $ xlogo
  249.    Please note that dxpc must be version 3.7.0 and it is downloadable from
  250.    http://www.vigor.nu/dxpc/dxpc-3.7.0.html . Of course, you can use JDxpc
  251.    instead of using dxpc on remote host.
  252.  
  253. If you need to change the communication port number(by default, 4000) between
  254. dxpc client and server proxies, specify the  appropriate number to the property
  255. 'weirdx.jdxpcport'. (To use this property, JDxpc 0.0.6 or higher is required).
  256.  
  257.  
  258. XJS Extension for WeirdX 
  259. ========================
  260. Now, XJS Extension for WeirdX has been included.
  261. It is contributed by Christian Werner<Christian.Werner@t-online.de>
  262. and enable you to use the JavaScriptTM engine from X clients.
  263. For further descriptions, please check 'misc/xjs/README'.
  264.  
  265.  
  266. PROPERTIES:
  267. ==========
  268. WeirdX has some properties as below,
  269.  
  270. * weirdx.display.width: numeral
  271.   Width of root window. If you don't specify 
  272.   this property, the property "WIDTH" will be used.
  273.  
  274. * weirdx.display.height: numeral
  275.   Height of root window. If you don't specify this property,
  276.   the property "HEIGHT" will be used.
  277.  
  278. * weirdx.displaynum: numeral
  279.   default: 2
  280.   If you specify "3", display-name, "hostname:3.0" will be used.
  281.  
  282. * weirdx.ddxwindow: class name
  283.   default: com.jcraft.weirdx.DDXWindowImp
  284.   Give a class name, which implements com.jcraft.weirdx.DDXWindow interface.
  285.   If you have the Swing, specify 'com.jcraft.weirdx.DDXWindowImpSwing' .
  286.   At present, 'com.jcraft.weirdx.DDXWindowImp', 
  287.   'com.jcraft.weirdx.DDXWindowImpSwing', 
  288.   'com.jcraft.weirdx.DDXWindowImpSwingAlphaBackground' and
  289.   'com.jcraft.weirdx.DDXWindowImpSwingAlphaBackground2D' are acceptable.
  290.  
  291. * weirdx.windowmode: InBrowser | Rootless | RootlessWM
  292.   default: InBrowser
  293.   If you specify 'Rootless' or 'RootlessWM', each toplevel window, 
  294.   whose parent is root window, will have its own window frame.
  295.   In the 'RootlessWM' mode, you don't have to run X window manager and
  296.   title bars will be attached to X apps by the native window system. 
  297.  
  298. * weirdx.display.visual: TrueColor16 | PseudoColor8 | StaticGray8
  299.   default: PseudoColor8
  300.   If 'PseudoColor8' is specified, 256 colors are used.
  301.   On the other hand, in specifying 'StaticGray8', 256 gray scaled 
  302.   colors will be used.
  303.  
  304. * weirdx.display.acl: [+hostname[,+hostname[,...]]]
  305.   default: -
  306.   WeirdX only supports ACL based on hostnames.
  307.  
  308. * weirdx.display.threebutton: yes | no
  309.   default: no
  310.   Three button mouse emulation is enabled.
  311.  
  312. * weirdx.display.charset: [charset[,charset[,...]]]
  313.   Specified charsets will be handled.
  314.   For Japanese characters, specify 'JISX'. For Korean characters,
  315.   specify 'KSC5601', and for Chinese characters, specify 'GB2312'.
  316.  
  317. * weirdx.display.keymap: a name of keymap. 
  318.   default: 101
  319.   Specified keymap definitions is used.
  320.   At present, '101', 'gb' and 'de' are acceptable.
  321.  
  322. * weirdx.xdmcp.mode: query | broadcast | no
  323.   default: no
  324.   If you require the XDMCP service, specify 'query' or 'broadcast'.
  325.  
  326. * weirdx.xdmcp.address: ip-address
  327.   Specify a query address or a broadcast address.
  328.  
  329. * weirdx.xrexec: yes | no
  330.   default: no
  331.   If you require the rexec service, specify 'yes'.
  332.  
  333. * weirdx.extension: names of extensions.
  334.   default: DummySHAPE
  335.   In current implementation, dummy of SHAPE extension is
  336.   included. If you hate such a hack, leave this property in blank.
  337.  
  338. * weirdx.display.background.alpha: pixel value:alpha value[,pixel:alpha[,...]]
  339.   default: blank
  340.   Specify pairs of a background pixel value and an alpha channel value.
  341.   If you specify '0xff0000:0x20, 0x00ff00:0x80',
  342.   The background color 'red' will be '0x20ff0000'
  343.   and the background color 'green' will be '0x8000ff00'.
  344.  
  345. * weirdx.jesd: yes | no
  346.   default: no
  347.   If you need to run EsounD compatible applications, specify 'yes'.
  348.   For using this functionality, your JVM must be J2SE v1.3 or higher. 
  349.  
  350. * weirdx.jdxpc: yes | no
  351.   default: no
  352.   If you need to use dxpc, specify 'yes'.
  353.  
  354. * weirdx.jdxpcport: numeral
  355.   default: 4000
  356.   a number of TCP port for communication between dxpc server and client
  357.   proxies.
  358.  
  359. * weirdx.jdxpc.socket: class-name
  360.   default: null
  361.  
  362. * weirdx.jdxpc.serverproxy: class-name
  363.   default: com.jcraft.jdxpc.ServerProxy
  364.  
  365. * weirdx.displaysocket: class name
  366.   default com.jcraft.weirdx.DisplaySocket6k
  367.  
  368. * weirdx.display.autosize: boolean
  369.   default: false
  370.   The size of root window will be assigned according to the size of desktop. 
  371.   This functionality will be useful in Rootless/RootlessWM mode.
  372.  
  373. In running as an application, "config/props" will be referred.
  374.