home *** CD-ROM | disk | FTP | other *** search
/ Peanuts NeXT Software Archives / Peanuts-3.iso / Graphics / video / NDCamera.0.21.README < prev    next >
Encoding:
Text File  |  1995-07-26  |  7.7 KB  |  231 lines
  1. Release 0.21, 25.07.1995 by Thomas Engel (tomi@shinto.nbg.sub.org)
  2.  
  3.  
  4.  
  5.                 The NDCamera application
  6.  
  7. ATTENTION..you need gnutar and gzip to unpack this package.
  8.  
  9.  
  10. WHAT's NEW IN 0.21:
  11.  - NDCamera has a DO-port.
  12.  - 2 Example apps show how to use it (e.g. grab from the commandline)
  13.  
  14.  
  15. This is a NeXTdimension based auto frame grabber which might help you to 
  16. create NeXTIME movies or other image sequences.
  17. It follows the tradition of Icon.app, DVR.app and Capture.app which have 
  18. been written some time ago but seem to be not supported anymore. NDCamera 
  19. was developed under NeXTSTEP 3.3, always keeps only one frame in memory 
  20. and allows resizing of the image before saving it to your disk.
  21.  
  22. Use it with patience because the NeXTdimension's software is buggy!
  23.  
  24.  
  25.  
  26.           What it does
  27.  
  28.  
  29. It grabs images. Now that is basically all this app will do for you. 
  30. Besides that it allows you to create .anim movies. Every frame is titled, 
  31. numbered and stored as a Tiff file inside a specified directory. 
  32.  
  33. So you can use the app in different ways. Either as a "small, rarely updated"
  34. monitor or as a "single frame once a while" camera.
  35. When creating movies you can choose to record each frame by hand or use the
  36. continuous time-based grab feature. Whenever the frame count increase you 
  37. have a short period of time to switch to the next frame. Some VCRs can even 
  38. be set up to play a movie in slow motion. Thus syncronizing the VCR with 
  39. the grabbing speed on the NDCamera could allow you to record long movie 
  40. automatically.
  41.  
  42. Still there are some problems with automatic recording. Sometimes it happens 
  43. that the VCR switches to another frame while the ND is grabbing. This will 
  44. cause bad image quality because the ND now might grab two subsequent video 
  45. frames which will cause smear effects if the actors are moving fast.
  46. Resizing is also a none trivial aspect. Under certain size factors you will 
  47. get a funny stripe pattern due to the interlaced frames.
  48.  
  49. The NeXTcube is also a little slow at processing the single frames. Thats 
  50. why for big images you won't even reach a rate of 1 fps. With fps rates 
  51. turning to random (due to calculation delays) you will have a hard time to 
  52. sync you VCR at all...so the savest way to advance the video tape is using 
  53. the remote control and single frame stepping.
  54. But you might also choose the change the frame base rate (see the Release 
  55. Notes for details).
  56. Syncing can be quite easy if you have a way to control the VCR by your 
  57. computer. Then you can use the included commandline example which causes 
  58. the NDCamera to grab a single frame by using distributed objects.
  59.  
  60.  
  61. The Package
  62.  
  63. Version 0.21 comes in a package that includes:
  64.  
  65.  - NDCamera.app for NeXT hardware only. You need a NeXTdimension to use 
  66.    this app successfully.
  67.  
  68.  - An Examples directory containing a simple movie recorded using this 
  69.    app and a cheap video player plus two applications which allow show 
  70.    you how to do remote controlling of the NDCamera.
  71.  
  72.  - Online help...minimal
  73.  
  74.  - Full sourcecode
  75.  
  76.  - The documentation and an ASCII version (README) of this introduction
  77.  
  78.  
  79. ATTENTION:     You need gnutar and gzip und unpack those files. Both programs 
  80. come bundled with NeXTSTEP since version 3.2.
  81.  
  82.  
  83. On where to find the latest releases please see the 'About this Project' 
  84. section.
  85.  
  86.  
  87. Features
  88.  
  89. As a fun project this app does nothing special. After all some people might 
  90. find it useful to create their private movies. The included example was 
  91. created using the NeXTdimension and a cheap video player. Somehow the 
  92. Dimension failed to grab certain frames which makes the movie a little 
  93. un-smooth. This was most likely due to the fact that even one frame/sec 
  94. was too much work and the poor Cube couldn't keep up with the input.
  95. If you want to record movies automatically you might enlarge the time 
  96. between timed entries (see above).
  97. Here is what the app can do in the current stage:
  98.  
  99.  - Choose a video source and adjust its settings. 
  100.  
  101.  - Grab single frames on a timed basis. 
  102.  
  103.  - Scale the grabbed images and display them on the screen or save them 
  104.    to a .anim file. 
  105.  
  106. Some features will definitly be improved over time but there is definitly 
  107. more useful work out here (if you have a desperate need for some features 
  108. let me know anyhow).
  109.  
  110.  
  111. ATTENTION:     The implementation of the NeXTdimension's software is a 
  112. little buggy. Running at high frame rates or with a huge system load 
  113. will most propably crash the WindowServer. Don't say you havn't been 
  114. warned.
  115.  
  116.  
  117. For a complete description of known bugs see the Release Notes in the 
  118. second chapter.
  119.  
  120.  
  121.  
  122.           About this Project
  123.  
  124.  
  125. Once the NeXTIME framework is documented (or I had the time to figure out
  126. some APIs on my own) I would like to include support for other output 
  127. options. This could be just other file formats or even using the NDCamera 
  128. as a NeXTIME video source.
  129. Time will tell but it will never be much more then an app to play with. 
  130. The performance of the system is not high enough to allow realtime video 
  131. grabbing. You definitly need some extra hardware for such a job...or some 
  132. really fast machines.
  133.  
  134. The latest version of this application will be available at the
  135. ftp.nmr.embl-heidelberg.de, ftp.informatik.uni-muenchen.de or
  136. ftp.cs.orst.edu anonymous ftp servers. There is a WWW page were you
  137. can find out more about the status of this...and all the other
  138. projects I'm working on:
  139.  
  140.     
  141.     http://wwwcip.informatik.uni-erlangen.de/user/tsengel/
  142.     Projects/Projects.html
  143.  
  144.  
  145. Compiling
  146.  
  147. This version includes all the source code necessary to recompile the
  148. program from scratch. It does not come with all the libraries! You
  149. might need to get the MiscKit project (Version 1.4.0 or higher) from
  150. the archives.
  151.  
  152. For more details on the MiscKit collection see the common NeXT ftp
  153. servers, get the Objective-C or NeXT FAQs or take a look at the
  154. EduSteps developer area:  
  155.     
  156.     http://www.nmr.embl-heidelberg.de/eduStep/Developer/Kits/
  157.     MiscKit/MiscKit.html
  158.     
  159. If you would like to submit something to this collection you should
  160. contact the current maintainer: Don Yacktman <don@darth.byu.edu> 
  161.  
  162.  
  163. In Case of Trouble
  164.  
  165. If you have any questions you can contact me.
  166.  
  167.     Thomas Engel     
  168.     Netpunstr. 9     
  169.     D-90522 Oberasbach 
  170.     Germany          
  171.     
  172.     E-mail:    tsengel@cip.informatik.uni-erlangen.de 
  173.                tomi@shinto.nbg.sub.org
  174.  
  175.                (NeXTMail welcome)
  176.  
  177.  
  178.  
  179.           Warranty and copyright
  180.  
  181.  
  182. Copyleft
  183.  
  184. All source code is distributed under the GNU General Public License.
  185. This does not apply to the ObjectWare used, which most likely comes
  186. with its own licensing rules (e.g. code that belongs to the MiscKit
  187. project).
  188.  
  189. You are free to extend and modify this application. But don't
  190. redistribute a modified version under the same name unless I gave you
  191. the permission. I don't want to have different, confusingly
  192. incompatible versions running around the world. 
  193.  
  194. Anyway...comments are highly appreciated.
  195.  
  196.  
  197. No Warranty
  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 your
  204. 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 travelware.
  213.  
  214.  1. Let it travel to as many people as you know. 
  215.  
  216.  2. Send me an E-mail or postcard if you use it. I will try to
  217.     keep you informed about new releases.
  218.  
  219.  3. If you have a free bed or some free space on your floor...give
  220.     me a hint. I might come and visit you on my next trip to the
  221.     US...locations on Hawaii, near Seattle or WhistlerMnt. (Canada)
  222.     preferred.
  223.  
  224.  
  225.  
  226. Enjoy it.
  227.  
  228.     Tomi
  229.  
  230.  
  231.