home *** CD-ROM | disk | FTP | other *** search
/ World of Graphics / WOGRAPH.BIN / 039.NOTE.TXT < prev    next >
Text File  |  1992-08-14  |  13KB  |  274 lines
  1. This is some notes on changes between versions. Like all others
  2. I find it very painful to update documentation. You will now 
  3. have a small document for NakedEye 1.10 in three formats: TEXT, 
  4. POSTSCRIPT, WINWORD 2.0. The files are nakedeye.txt, nakedeye.ps 
  5. and nakedeye.doc respectively.
  6.  
  7. Please refer to nakedeye.cfg, nakedeye.snd and nakedeye.trc for
  8. fine tuning the way NakedEye 1.10 works.
  9.  
  10. Enjoy!
  11.  
  12. Changes from 1.02 to 1.10
  13. ---------------------------
  14. NakedEye 1.10 migrates into the world of Object-Oriented
  15. programming. It has been modified gradually to take advantage
  16. of object-oriented approach to control the code size and add 
  17. some more functionality without getting the program too big.
  18. However it is expected that an Object-oriented program is
  19. a bit bigger than normal.
  20.  
  21.     * PostScript generation for PostScript laser printer. 
  22.       NakedEye offers to ways. The first way is to generate a
  23.       single postscript file for the current image. The user 
  24.       will be asked to supply the output file name and the
  25.       mode Vertical, Horizontal or Automatic. The second way
  26.       is to generate postscript files for all loaded images.
  27.       The ones which have not been decoded will be skipped.
  28.       In this mode the user chooses the orientation of
  29.       the page for all images, and a compression option is
  30.       available. If compression is chosen then every output
  31.       file is compressed into a ZIP archive. This will reduce
  32.       the amount of disk space needed by a factor of 3 
  33.       about times or more. In a test I generated 41 images
  34.       of size 640x480 and bigger in 45 minutes. This took
  35.       up 8Mbytes of disk space, and more than half of the 
  36.       time was spent in compression. If compression was
  37.       not used then the diskspace needed would be close to
  38.       30Mbytes. TO set up for compression one must edit
  39.       the file nakedeye.cfg and add the name of the file
  40.       compressing program. The default is zip.exe that is
  41.       copyrighted C) 1990,1991 Mark Adler, Richard B. Wales, 
  42.       and Jean-loup Gailly. This has to be installed on 
  43.       your computer system. If it is not NakedEye will
  44.       know and does not prompt for this option.
  45.  
  46.       The default compression format is ZIP. Every PostScript 
  47.       output file is in a ZIP archive of its own. The program 
  48.       UNZIP is used to decompress them. PKUNZIP can also be 
  49.       used to uncompress them.
  50.  
  51.       At the middle of processing NakedEye cannot be interrupted, 
  52.       however any key will stop NakedEye when it finishes a
  53.       postscript file. The user is then asked to continue or
  54.       stop.
  55.  
  56.     * A mouse click in the image area will now activate a pop
  57.       up menu. This menu allows popular commands to be selected
  58.       even when the control panel is not available in FullScreen
  59.       mode. It makes it significantly faster to activate a
  60.       command. This is probably the most significant enhancement
  61.       from NakedEye 1.02
  62.  
  63.     * The arrows functions on the control panel have been
  64.       removed. They were accessible by the arrow keys on the 
  65.       keyboard therefore wasting space on the control panel.
  66.  
  67.     - Function VertFlip now looks if there is just enough 
  68.       conventional memory to do a flip rather than using file 
  69.       swapping. This makes it several times faster to flip an 
  70.       image of size about 640x480.
  71.  
  72.     - Minor changes to the presentation of images when a 
  73.       slide show is on. Especially when the fullscreen mode 
  74.       is chosen for the slide show, when ESC is used to get
  75.       back, NakedEye switches automatically to Control mode
  76.       to give access to the Control panel.
  77.  
  78.     * A new function is added to support association between
  79.       text files and GIF files. You can display you favorite
  80.       poem at any place on the screen when you look at a 
  81.       picture. When a slide show is on, the key T is used to
  82.       activate this feature. Other time, the function is 
  83.       activated by mouse from the Control Panel.
  84.  
  85.       This works the same way as the sound association file.
  86.       The exception is that there are two optional numbers
  87.       after the text file name. They tell where the window for
  88.       the text should be. The configuration file is 
  89.       nakedeye.trc . To change the default extension look
  90.       at the variable  textext  in nakedeye.cfg
  91.  
  92.     * The Control Panel can be flipped to the left or right.
  93.       Flag lefthand can be set to yes in the file nakedeye.cfg
  94.       to make this a default. The key F4 is employed to toggle
  95.       the mode on/off.
  96.  
  97.     - When Glass is running, a click of the mouse stops it.
  98.       Similarly for Convex and Concave, but it only stops the
  99.       building of the mirror and let you choose a new area for
  100.       a new mirror.
  101.  
  102.     - Significant faster refresh after prompting user for some
  103.       keyboard input.
  104.  
  105. Changes from 1.01 to 1.02
  106. -------------------------
  107. There have been little changes. In fact this is 1.01 released
  108. again with the little bugs fixed up. I am preparing version
  109. 1.1 with a lot of changes. It still has some bugs to be fixed.
  110.  
  111.     - Some known bugs have been fixed up.
  112.  
  113.     - There is no more restriction on this software. There is
  114.       a key comming with the distribution to allow acess to all
  115.       functions. The software will not expire any more for this
  116.       version. Versions comming after this still expire.
  117.  
  118.     - The Sound association file is NakedEye.snd . It is the 
  119.       default association file for GIF and VOC files. If you
  120.       have a soundblaster card, simply edit this file to set
  121.       up the association and play the sound. The key M is used
  122.       to activate the sound when you are having a slide show.
  123.  
  124.     - The TEXT association file is NakedEye.trc . It allows you
  125.       to set the association between GIF and TEXT files. The 
  126.       text file can be displayed by selecting ShowText on the
  127.       control panel or T when a slide show is on. This is for
  128.       people who want to display some comments or poetry etc.
  129.  
  130.     * Version 1.1 will be released later in the year when I get
  131.       the bugs out. It will be very different with pop-up menu
  132.       user interface. It will also support XMS memory. I will 
  133.       also rewrite the documentation to make it simple and precise.  
  134.  
  135. Changes from 1.0 to 1.0.1
  136. -------------------------
  137. There are several changes. I am not rewriting the manual
  138. because it simply take too much time to be worth it. From now
  139. on all new changes will be in this NOTE.TXT file.
  140.  
  141. There have been changes from version 1.0 to version 1.0.1
  142. Most features are the same but the internal implementations
  143. may have changed for better or for worse. You will find
  144. the version number changes very slowly because the software
  145. is fairly complete in what it is designed to be: a GIF Viewer
  146.  
  147. Here are the changes from 1.0 to 1.0.1 (Oct 1991). A * means
  148. important.
  149.  
  150.    * The executable is now abbreviated to ne.exe . Many
  151.      people have found NakedEye is too long to type.
  152.  
  153.    - NakedEye will swap itself to EMS or XMS memory if DOS
  154.      escape is invoked by F9 or SHELL. If it cannot find
  155.      either types of memory it will spawn the DOS shell
  156.      without swapping itself out of conventional memory.
  157.  
  158.    * NakedEye is now an overlay program. It will have only
  159.      active segments in conventional memory. The rest is in
  160.      a memory cache in EMS or XMS. This has released about 
  161.      60K extra out for general use. Typically after start-up
  162.      there will be 370K of memory left for general use. You 
  163.      should set up your system with some EMS memory if you
  164.      have 2Mbytes or more of memory. A line like the 
  165.      following (or similar) can be added to your config.sys
  166.  
  167.         device=c:\dos\emm386.exe 1024 ram 
  168.  
  169.      If you have a lot of memory then the more memory is set
  170.      up for EMS the faster NakedEye will refresh display and
  171.      paint the next picture. I prefer to reboot my machine
  172.      with a different set up when I want to use NakedEye 
  173.      with a lot of GIF files. There are many programs on the net
  174.      for this purpose.
  175.  
  176.      It is recommended that NakedEye is installed on your hard 
  177.      disk. Running NakedEye from a floppy disk is too slow.
  178.  
  179.    - Rotation and Resize are now faster if there is enough 
  180.      memory. NakedEye will swap itself out of conventional
  181.      memory and invoke a tiny program outside to do the job.
  182.      If there is about 500K left when NakedEye starts, it
  183.      will be able to deal with images of size 800x600 or
  184.      similar sizes very effectively.
  185.  
  186.    * A small change to user interface. Option /m alone will
  187.      put it into a selection menu which was the default in 
  188.      version 1.0. It is nicer to start NakedEye into the 
  189.      first picture for experienced users.
  190.  
  191.    - NakedEye will now deal with about 97Mbytes of information
  192.      after decompression from GIF into normal indexed raster 
  193.      image. About 200 GIF files can be opened in a session
  194.      if they are not all too big.
  195.  
  196.    * Command Shake'it and ShLevel are added for the pleasure 
  197.      of the eyes. The Shake'it command add vibration to a 
  198.      selected region. The other tells NakedEye how much to 
  199.      shake the region. Use the mouse to pause for selecting
  200.      more regions to be set into motion. Type ESC will get you
  201.      back to normal control.
  202.  
  203.    * Command Curtain and Curmode are added. Curtain draws a
  204.      curtain of 50% visibility across the area selected. Curmode
  205.      controls the direction of drawing. This set is another
  206.      chewing gum for the eyes. These weird commands and the
  207.      lenses etc ... are the unique features of NakedEye.
  208.  
  209.    * A sound player is incorporated in the distribution. It is
  210.      called SPLAYER.EXE . This program will play a VOC format
  211.      file for the Sound Blaster card continuously. Two commands
  212.      are added into NakedEye 1.0.1 called Music and Mfile. 
  213.      Music plays the sound file associating with a gif file.
  214.      Mfile let you name the associating file for GIF and VOC
  215.      files. You need a Sound Blaster board to play music/sound
  216.      while looking at the GIF files. This SPLAYER.EXE program
  217.      takes an optional argument -ns standing for non-stop playing.
  218.  
  219.      The format of the sound association file is simple. A line
  220.      starting with # is a comment line. The rest contain two 
  221.      formats; one for the sound player and the other for GIF and
  222.      VOC files
  223.  
  224. Example: File NakedEye.SND
  225.  
  226. ######################################################################
  227. # This is the sample sound association file.                         #
  228. # The character # is used to comment a line.                         #
  229. #                                                                    #
  230. # player should be set to your favourite VOC player. The default one #
  231. # is SPLAYER.EXE distributed with NakedEye 1.0.1 . There can be more #
  232. # than one player. The last one immediate before the correct         #
  233. # GIF = VOC association entry will be used to play the VOC file.     #
  234. #                                                                    #
  235. ######################################################################
  236. player=.\splayer.exe 
  237. paradise.gif=.\oxygen.voc
  238. wgardn1.gif=.\waltz1.voc
  239.  
  240.      The above file shows an example of the sound association file
  241.      between GIF files and VOC files for NakedEye 1.0.1. You can see
  242.      that the sound player is .\splayer.exe and for every GIF file 
  243.      there is a VOC file name. Also note that the file name on the 
  244.      right hand side of  =  is with full directory path name.
  245.      The name on the left is the filename of the GIF file without
  246.      the directory path.
  247.  
  248.      Now you can set up the association file between GIF and VOC
  249.      and play music or sound when you view the picture. BE CAREFUL
  250.      and make sure that FULL PATH NAMES are used for the sound
  251.      player and the VOC files. If this is not set correctly NakedEye
  252.      will simply complain "Cannot open". You will have to edit
  253.      your own association file or modify the sample file NakedEye.SND
  254.      to make sure that it works even when you run NakedEye from a
  255.      directory different from where you install NakedEye.
  256.  
  257.      The key M was used for displaying the memory status in 1.0
  258.      Now it is used to play sound (Music). When you first request
  259.      for music, NakedEye will ask for the association file name. It
  260.      will scan the file for GIF <-> VOC association and play the
  261.      VOC file. Subsequent request will cause NakedEye to scan the
  262.      same association file. You can change the association file any
  263.      time by the command Mfile which must be selected from the
  264.      control panel.
  265.  
  266.    * Slide show with MUSIC is possible now with NakedEye 1.0.1
  267.      You simply type M when the slide show is on (using F2).
  268.      NakedEye will play the VOC file associating with the current
  269.      GIF file, when finished it will display the next GIF file and
  270.      play the next sound file and so on ...
  271.  
  272.      When the slide show and music are on  at the same time, to stop
  273.      them you have to type ESC twice.
  274.