home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / viewers / pixb10.zip / PIXBASE.DOC < prev    next >
Text File  |  1993-06-02  |  11KB  |  234 lines
  1. PixBase v1.0 for DOS.
  2. Smart GIF/JPEG viewer/cataloger for VESA SuperVGA.
  3. (C) Copyright 1993, All Rights Reserved
  4. by Davide Rossi
  5.    Vicolo Zanella 55B
  6.    31100 Treviso, Italy
  7.    E-mail: rossi@cs.unibo.it (until end of 1993).
  8.  
  9. This program is shareware, you can use it for a 10 day free trial period.
  10. If you continue using it after that time, you must register your copy.
  11. The registration fee is only $20.
  12. Read the file order.frm for further information.
  13.  
  14. -What is PixBase.
  15.   PixBase is a database that creates catalogs (here called "groups") of
  16.   thumbnails (tiny replica here called PIXs) of given picture files.
  17.   It is intended to retrieve pictures and disks that hold them without 
  18.   searching and viewing a lot of images while wasting your time.
  19.   It also allows the user to manage multiple catalogs so that you can 
  20.   group images by category (such as raytrace, flowers, supermodels and so on).
  21.   PixBase is also a viewer but this capability is intended as a secondary
  22.   feature for it is slow and does not have panning.
  23.   The SuperVGA is driven through a VESA bios extension.
  24.   If it is not built-in your adapter's ROM you can use a TSR which is included
  25.   with this package. Almost all SuperVGA chipset have a TSR VESA driver.
  26.   Read the file VESA.DOC for further information.
  27.  
  28. -What PixBase needs.
  29.   -An IBM PC or compatible with DOS 3 or later and at least 512k memory.
  30.   -A SuperVGA graphics card with VESA bios extension (also a TSR works well).
  31.   If you manage large JPEG images the PixBase program will use XMS/EMS or disk
  32.   space to store temporary data.
  33.  
  34. -What PixBase supports.
  35.   PixBase supports VESA v1.2 HiColor (32768 colors) modes.
  36.  
  37. -What PixBase does not support.
  38.   -GIF89a. You may try and see what happens: sometimes it works, sometimes
  39.     doesn't.
  40.   -Interlaced GIFs.
  41.  
  42. -Options on the command line.
  43.   -v.
  44.     Before starting PixBase shows information about the VESA driver.
  45.   -g PATH.
  46.     PixBase will use the specified path for groups. If this option is omitted
  47.     the program will use the PixBase directory.
  48.     Note: groups are disk-space hungry so if you use an on-line compressor
  49.     program  (such as SuperStor, DoubleSpace, Stacker,etc ...) it is a good
  50.     idea to place groups in a compressed disk.
  51.   -t PATH.
  52.     PixBase will use the specified path for writing Targa files.
  53.   -f SUFFIX.
  54.     PixBase will use the specified suffix for all the output Targa files (the
  55.     default suffix is pb).
  56.     The maximum length for SUFFIX is six characters.
  57.  
  58. -The main screen.
  59.   The main screen is spliced into 4 panels.
  60.   The first 3 panels allow the user to navigate between listed choices.
  61.   The last panel is the active menu.
  62.   The following options are always active:
  63.   Hit F9  to change the prefix of output graphic filename. The filename 
  64.           format is:
  65.           prefixXX.tga where XX is a number from 00 to 99; Any time you save a
  66.           new file XX increments by 1 or more in order not to interfere with
  67.           other filenames.
  68.   Hit F10 to change setup of PixBase.
  69.   Hit ESC to exit program.
  70.   Note also that anytime an input is requested for the user, the operation may
  71.   be aborted by hitting ESC key.
  72.  
  73. -How to move between panels.
  74.   To change the active panel (which is double-framed) use left/right cursor 
  75.   keys or TAB/ShiftTAB.
  76.  
  77. -How to move between listed choices in a panel.
  78.   To change highlighted choice, use cursor up/down and/or page up/down.
  79.   To change selection for the highlighted choice use INS (where allowed).
  80.  
  81. -The first panel.
  82.   The first panel shows current path and disk label.
  83.   The listed choices are sub-dirs and up-dir (in upper case), and the GIF/JPEG
  84.   filenames (in lower case).
  85.   Hit ENTER to change working directory to the highlighted or to show
  86.             highlighted picture file.
  87.   Hit F1    to convert selected picture files into PIXs and add them to
  88.             selected group.
  89.             If no picture is selected it works on current highlighted picture.
  90.   Hit F2    to change drive/disk.
  91.   Hit F3    to get information about highlighted picture file.
  92.   Hit F4    to select all picture files.
  93.   Hit F5    to deselect all picture files.
  94.   Hit F8    to delete selected picture files. If no picture is selected it
  95.             works on current highlighted picture.
  96.  
  97. -The second panel.
  98.   The second panel shows the selected group name.
  99.   The listed choices are PIXs contained in that group.
  100.   Hit ENTER to show selected PIXs. If no PIX is selected it works on current
  101.             highlighted PIX.
  102.   Hit F2    to move selected PIXs. If there is at least one PIX selected above
  103.             the highlighted PIX, it will move below highlighted PIX; else the
  104.             selected PIXs will move above the highlighted PIX.
  105.   Hit F4    to select all PIXs.
  106.   Hit F5    to deselect all PIXs.
  107.   Hit F8    to delete selected PIXs. If no PIX is selected it works on current
  108.             highlighted PIX.
  109.  
  110. -The third panel.
  111.   The listed choices are existing groups.
  112.   Hit ENTER to show all the PIXs in highlighted group.
  113.   Hit F1    to create a new group.
  114.   Hit F2    to modify the highlighted group.
  115.   Hit F3    to get information about the highlighted group.
  116.  
  117. -How to save the graphic display.
  118.   While viewing PIXs in graphic mode you can save current screen in Targa
  119.   (.tga) file format by pressing F9.
  120.  
  121. -The setup requester.
  122.   Use cursor up/down and/or page up/down to change the highlighted option.
  123.   Use cursor left/right to change highlighted option value.
  124.   "Use 800x600 modes" option:
  125.      Set this option to No if your video card supports the 800x600 modes but
  126.      your monitor doesn't.
  127.   "Use 1024x768 modes" option:
  128.      Set this option to No if your video card supports the 1024x768 modes but
  129.      your monitor doesn't.
  130.   "Use 1280x1024 modes" option:
  131.      Set this option to No if your video card supports the 1280x1024 modes but
  132.      your monitor doesn't.
  133.   "Keep aspect ratio" option:
  134.     If this option is set to Yes the PIX will have the same aspect of
  135.     the original picture.
  136.     If this option is set to No the PIX will always have the maximum size.
  137.     If this option is set to Ask and the aspect size of the picture is not
  138.     the same as that of the PIX the user will be asking.
  139.     Note that if this option is set to Yes and the image size is smaller than
  140.     320x200 an aspect ratio of 1:1.2 will be used to compensate for the pixel
  141.     aspect ratio for 320x200 VGA display mode.
  142.   "Show PIC name in PIXs" option:
  143.     If this option is set to Yes the original picture filename will appear
  144.     below any PIX.
  145.   "Show PIC size in PIXs" option:
  146.     If this option is set to Yes the original picture size will appear below 
  147.     any PIX.
  148.   "Show diskname in PIXs" option:
  149.     If this option is set to Yes the label of the disk that holds the original
  150.     picture will appear below any PIX.
  151.  
  152. -The new/modify group requester.
  153.   Use cursor up/down and/or page up/down to change highlighted option.
  154.   Use cursor left/right to change highlighted option value.
  155.   Use ALT-cursor left/right to change color fields 10 by 10.
  156.   "PIXs width" field:
  157.     This field indicates the PIX width for EACH PIX in this group.
  158.   "PIXs height" field:
  159.     This field indicates the PIX height for EACH PIX in this group.
  160.   "PIXs X displacement" field:
  161.     This field indicates the horizontal distance between PIXs.
  162.   "PIXs Y displacement" field:
  163.     This field indicates the vertical distance between PIXs.
  164.   "Group type" field:
  165.     This field can assume 3 values:
  166.     gray: the picture is reduced to a gray PIX.
  167.     color: the picture is reduced to a HiColor PIX (needs HiColor graphics
  168.       card).
  169.     dithered: the picture is reduced to a HiColor PIX then dithered using a
  170.       uniform palette allowing the user to show more than one PIX at the same 
  171.       time using the 256 color modes.
  172.   "Default display mode" field:
  173.     This field indicates the video mode set while showing PIXs.
  174.   "PIXs text color (red/green/blue)" fields:
  175.     These fields indicate the 3 components of the color used to show
  176.     information below PIXs.
  177.   "PIXs box color (red/green/blue)" fields:
  178.     These fields indicate the 3 components of the color used to frame the
  179.     PIXs.
  180.  
  181. -Limitations.
  182.   The first panel cannot hold more than 200 files.
  183.   Each group cannot have more than 400 PIXs.
  184.   The third panel cannot hold more than 50 groups.
  185.   The maximum size of a PIX is 200x150.
  186.   The maximum size of a picture to be resized is 4000x4000.
  187.  
  188. -Future possibilities.
  189.   If this program will be a success (I measure that in number of registered
  190.   user) I will update it by adding new  features (and, obviously, fixing bugs).
  191.   When you register send me a list of new features you would like to see 
  192.   and any bugs you encounter. If many of you request the same feature I will 
  193.   add it (if I know how to do it, obviously).
  194.  
  195.   This is a list of things I could add in some future version.
  196.  
  197.   -Mouse support (does someone really need it?).
  198.   -Speed up GIF decoding.
  199.   -Add some options to the viewer.
  200.   -Save 256 color screens as a GIF file.
  201.   -Stitch multiple screens of the same group in the same file.
  202.   -Edit PIX original file name and disk.
  203.   -Save & load single PIXs.
  204.  
  205. -Acknowledgements & credits.
  206.   The Graphics Interchange Format(c) is the Copyright property of
  207.   CompuServe Incorporated. GIF(sm) is a Service Mark property of
  208.   CompuServe Incorporated.
  209.  
  210.   All other trademarks and registered trademarks are the properties of their
  211.   respective holders.
  212.  
  213.   The JPEG decoder is based on the Independent JPEG Group's software,
  214.   Copyright (C) 1993 Tomas G. Lane.
  215.  
  216.   The GIF decoder is loosely based on a work done by Steven A. Bennett
  217.   and Steve Wilhite.
  218.  
  219.   And last, but not least, I wish to thank Joshua Haravay and Steve Driscoll
  220.   (and others) who proofread the documentation (all mistakes are because I made
  221.   changes after they read it).
  222.  
  223. -Disclaimer & legal information.
  224.   -This software is provided as is without any guarantees or warranty.
  225.     Although the author has attempted to find and correct any bugs in the
  226.     program, he is not responsible for any damage or losses of any kind caused
  227.     by the use or misuse of the program.
  228.   -Shareware and freeware distribution companies may distribute file pb10.zip
  229.    under the following conditions:
  230.     -The contents of the archive pb10.zip may not be modified.
  231.     -No more than six dollars US ($6) can be charged per floppy disk for the copying
  232.       of this software and the media it is provided on. Space on each disk must
  233.       be used completely.
  234.