home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / Graphics / 3d / 3DDeviceServer.0.51.README < prev    next >
Encoding:
Text File  |  1995-02-15  |  7.5 KB  |  228 lines
  1. Release 0.51, 10.12.1994 by Thomas Engel (tomi@shinto.nbg.sub.org)
  2.  
  3.  
  4.  
  5.              The 3DDeviceServer         
  6.                 Application
  7.  
  8. ATTENTION..you need gnutar and gzip to unpack this package.
  9.  
  10.  
  11.  This NeXTSTEP application is a general purpose device server. It is
  12. the central part of a collection of various device drivers for many
  13. different 3D hardware tools. With the help of NeXTs DO/PDO system it
  14. will allow an easy 'plug-in' into existing software that may run
  15. distributed accross a network.
  16.  
  17. The server tries to simplify shared access to one hardware device by
  18. multiple clients (or as I call them: device targets). In addition to
  19. that it will allow switching between different devices while they are
  20. in use.
  21.  
  22.  
  23.  
  24.          Using the Server
  25.  
  26.  
  27.  Just start the server. When you click on one of the buttons from the
  28. Device windows scrollview, the corresponding driver will become
  29. active. Detailed information on how to use the program can be found
  30. inside the online help system. 
  31.  
  32. For more information on how to use the server in your own projects
  33. please read the tutorial in the second chapter.
  34.  
  35.  
  36. The Package
  37.  
  38. Version 0.51 comes in two packages:
  39.  
  40.  -     3DDeviceServer.app & Documentation.     
  41.      The 3DDeviceServer.0.51.NIHS.bd.tar.gz archive contains a plug'n'play
  42.     binary for NeXT, Intel, HP and Sparc hardware that was compiled under
  43.     NeXTSTEP v3.3.
  44.  
  45.  -     Source.     
  46.      In 3DDeviceServer.0.51.s.tar.gz you can find the
  47.     complete sourcecode for this project. More details on compiling are
  48.     included below.
  49.  
  50.  On where to find the latest releases please see the 'About this
  51. Project' section.
  52.  
  53.  
  54. Features
  55.  
  56. This project is still some kind of beta although it runs very stable.
  57. From all the possible devices that this server offers access methods
  58. for (mouse, glove, display, scanner, motionTracker) only the mouse
  59. method will return a valid driver. Right now I only have a 3D mouse
  60. API. If you would like to help designing APIs for other equipment
  61. please let me know.
  62.  
  63. The connections to devices work via the servers PDO port named
  64. "<hostname>/3DDeviceServer". For more details read the Release Notes
  65. and some History.
  66.  
  67. The only 3D mouse the server knows about at the moment is the
  68. SpaceMouse (Driver release v0.8). It is the only mouse I own. In my
  69. opinion it is the best 3D mouse solution I have seen so far. More
  70. information about the hardware can be found in the online help.
  71.  
  72. The other 'mouse' is the Virtual 3D Mouse (Driver release v0.6). It
  73. is just a simple GUI (slider based) pseudo mouse.  Good for testing
  74. your software and for setting exact rotation values.
  75.  
  76. If you own a different kind of 3D input device it should be straight
  77. forward to write a driver yourself and include it into the server.
  78.  
  79.  
  80. Supporting Software
  81.  
  82. Currently (as of 10.12.94) there is one publicly available
  83. application that is able to use this server. But others projects are
  84. underway. 
  85.  
  86.  BeakerBoy.     
  87.   My privat chemistry program…and the reason why I
  88.   wrote this server. Version 0.3 will include 3D mouse support but is
  89.   not ready yet because I need to include the IconKit before I put it
  90.   on the net archives.     The code used to handle to 3D mouse events
  91.   can be found inside the tutorial.
  92.  
  93.  solidThinking MODELER.     
  94.   Guido Quaroni from Gestel was one of the
  95.   early supporters of this server. He is trying to include 3D mouse
  96.   control into the v2.2 release that might be be around sometime in mid
  97.   '95.
  98.  
  99.  HippoDraw.     
  100.   The Reason Gang enhanced NeXTs original Draw demo
  101.   application to allow displaying n-tuple data and the relations
  102.   between certain columns of the tables. Mouse support should be around
  103.   by Q1/95.
  104.  
  105.  WavesWorld.     
  106.   This free collection of objects and InterfaceBuilder
  107.   palettes was created by Michael B. Johnson. It allows RenderMan
  108.   objects to be controlled by TCL scripts or other control object.
  109.   Mouse support should be around once the rotation handling of the
  110.   WW3DWell class has cleaned up a little.
  111.  
  112. For details on the support I might give other programmers please read
  113. the tutorial. If you are a user and would like to use a 3D mouse in
  114. your vavorite application you should contact its developers. Maybe
  115. they haven't heard of this server or they think it is not worth 10-20
  116. minutes of programming unless someone needs it.
  117.  
  118.  
  119. Future plans
  120.  
  121. Here are the most wanted improvements form my ToDo-list. More can be
  122. found in the online help. 
  123.  
  124.  -     Loading the drivers from bundles. Well quite easy but it
  125.     needs some time until the MiscFile classes have come to a rest.
  126.  
  127.  -     I like datagloves so I might take a look at the PowerGlove
  128.     code moving around the net. Gloves might be a subclass of 3DMouse
  129.     adding absolut postitons (transformationEvent:isAbsolut:) and data
  130.     about the fingers (fingerEvent:). This way 3D mouse systems with
  131.     absolut positions could work as gloves as well. We might also have a
  132.     right… and leftGlove in our server.
  133.  
  134.  
  135.  
  136.          About this Project
  137.  
  138.  Development will continue – but not at very high speed because my
  139. main project is still the BeakerBoy application. At this moment it is
  140. still not clear if the driver objects and this server program will
  141. find their way into the MiscKit project. Maybe with a Misc3DKit this
  142. might get more realistic. Anyway, the MiscRtMatrix is necessary to use
  143. this server in your applications.
  144.  
  145. The latest version of this server will be available at the
  146. ftp.informatik.uni-muenchen.de or ftp.cs.orst.edu anonymous ftp
  147. servers. SpaceControl will have access to the latest version too, so
  148. when you want to buy a mouse just tell them that you are using a
  149. NeXTSTEP system. This will cost no extra charge! (as they assured me)
  150.  
  151.  
  152. Compiling
  153.  
  154. This version includes all the source code needed to just compile the
  155. program from scratch but it does not include objects that are part of
  156. the MiscKit distribution. So if you need to recompile the application
  157. you will need to get the MiscKit project from the archives (Version
  158. 1.2.8 or higher)
  159.  
  160. For more details on the MiscKit collection see the ftp servers
  161. mentioned above or get the Objective-C or NeXT FAQs. If you would
  162. like to submit something to this collection you should contact: Don
  163. Yacktman <don@darth.byu.edu>
  164.  
  165.  
  166. In Case of Trouble
  167.  
  168. If you have any questions you might contact me.
  169.  
  170.     Thomas Engel
  171.     Netpunstr. 9     
  172.     D-90522 Oberasbach 
  173.     Germany          
  174.     
  175.     E-mail:    tsengel@cip.informatik.uni-erlangen.de 
  176.             tomi@shinto.nbg.sub.org
  177.  
  178. I would like to thank my brother (IconDesign), Matt Brandts
  179. (MiscSerialPort), DLR & SpaceControl (hardware questions), Guido
  180. Quaroni (software support) and NeXT (DOs are quite cool) for making
  181. my work easier.
  182.  
  183.  
  184.  
  185.         Warrenty and copyright
  186.  
  187. Copyleft
  188.  
  189. Source code that is not part of the MiscKit project - and therefore
  190. underlies the MiscKit distribution and copyright rules - is
  191. distributed under the GNUpublic license.
  192.  
  193. If you want to write a device driver that you would like to sell,
  194. please contact me.
  195.  
  196.  
  197. No Warrenty
  198.  
  199. This software is provided 'as is' and the programmer is not
  200. responsible for any harm this program may cause. You - the user - are
  201. responsible for everything that may happen to your business,
  202. hardware, software, car, CD collection or what ever may be worth your
  203. attention or money. Using this product is at your own risk and
  204. your private fun.
  205.  
  206. There should be no serious bugs inside but remember that a
  207. carbon-based unit did the coding.
  208.  
  209.  
  210. TravelWare
  211.  
  212. Like all my projects this app is free and should be considered as
  213. travel-ware.
  214.  
  215.  1. Let it travel to as many people as you know. 
  216.  
  217.  2. Send me a postcard or E-mail if you use it. I will try to
  218.     keep you informed about new releases.
  219.  
  220.  3. If you have a free bed or some free space on your floor... give
  221.     me a hint. I might come and visit you on my trip to the US 
  222.     (locations on Hawaii, near Seattle or WhistlerMnt. (Canada) 
  223.     preferred)
  224.  
  225.  
  226.  
  227. Enjoy it. 
  228.