home *** CD-ROM | disk | FTP | other *** search
/ Boston 2 / boston-2.iso / WINDOWS / TOOLS / PIXFOLIO / PIXREAD.ME < prev    next >
Text File  |  1993-12-01  |  22KB  |  572 lines
  1. PixFolio - Windows Image Viewer and Catalog Manager (Shareware)
  2.  
  3. (c) Allen C. Kempe, 1991. All rights reserved.
  4.  
  5. Portions (c) Microsoft Corporation, 1985-1991. All rights reserved.
  6.  
  7. PixFolio (formerly ShowGif) is a Microsoft Windows program that can view a
  8. variety of bitmapped graphics formats and maintain multiple catalogs of
  9. images. Version 1.03 is being distributed as Shareware for $25.00 plus $4
  10. Shipping and Handling ($7 outside of US and Canada) by the author,
  11. Allen C. Kempe. You are free to use PixFolio for a 30 day period. After that
  12. time, you are expected to register your copy and pay the $25.00 registration
  13. fee (plus shipping & handling).
  14.  
  15. The graphics formats currently supported are:
  16.     BMP -   Windows Bitmap
  17.     CLP -   Windows clipboard file
  18.     DRW/GRF - Micrografx draw and graph files.
  19.     EPS -   Encapsulated Postscript with imbedded TIFF preview images.
  20.     GIF -   CompuServe Graphics Interchange Format
  21.     ICO -   Windows Icon
  22.     IFF -   IFF/LBM (Amiga) used by Computer Eyes frame grabber.
  23.     IMG -   GEM/IMG (Digital Research).
  24.     MAC -   Macintosh MacPaint files.
  25.     PCX -   Microsoft Paint & PC Paintbrush
  26.     RLE -   Windows Run Length Encoded
  27.     TGA -   Targa
  28.     TIFF-   Tag Image Format. Most formats including 24 bit color
  29.             are supported.
  30.     WMF -   Windows Metafile.
  31.  
  32. Note: Not all variations that may be possible in the above file formats have
  33. been tested due to lack of suitable test files.
  34.  
  35. The major feature of PixFolio is the ability to build catalogs of
  36. images, that may reside on different disks. The catalog can then be searched
  37. and images can be easily located. Provisions are made for saving a primary and
  38. backup location for the image concurrently. To enhance searching for a
  39. particular image the program can display postage stamp images in a matrix.
  40.  
  41. The ability to read an image in one format and to save it in another allows
  42. the program to be used as a file conversion utility.
  43.  
  44. PixFolio version 1.03 is Shareware (see the accompanying file "PIXREGST.ME").
  45. PixFolio may be freely distributed on Bulletin Boards so long as all files
  46. are included along with this file.
  47.  
  48. THE AUTHOR RESERVES ALL RIGHTS TO THIS PROGRAM. THE AUTHOR DOES NOT WARRANT
  49. THIS PROGRAM'S FITNESS OR SUITABILITY FOR ANY PURPOSE. ALL USERS SHOULD USE
  50. IT AT THEIR OWN RISK.
  51.  
  52. The author will make a reasonable effort to correct problems and software
  53. bugs relating to documented features of the program for registered users.
  54. The author intends to make continuing improvements to the program including
  55. supporting additional file formats. To this end, comments and suggestions are
  56. welcomed.
  57.  
  58. Users may contact the author, Allen C. Kempe on CompuServe (71220,23) or
  59. in writing at:
  60.  
  61.         Allen C. Kempe
  62.         298 W. Audubon Drive
  63.         Shepherdsville, KY 40165-8836
  64.         USA
  65.  
  66.     GERMAN Version.
  67.  
  68.         A German version will soon be available. Read the accompanying file
  69.         "DEUTSCH.TXT" with Windows Notepad.
  70.  
  71. Main Features
  72.  
  73. File Menu:
  74.     New File - create a blank image suitable for pasting from the
  75.            clipboard.
  76.     Open File - Open a new file for viewing.
  77.     Save File - Save an image, possibly in a different format.
  78.     Move/Copy file - Move or copy a file.
  79.     Delete - Delete a file.
  80.     Print - print all or part of an image.
  81.     Export - Export the contents of a catalog for input to a database
  82.          or spreadsheet.
  83.     Select Printer - select a printer
  84.     Close
  85.  
  86. Catalog Menu:
  87.     Select catalog: Create, delete, select or rename an image catalog.
  88.     Catalog. Create or update a catalog entry for a displayed image.
  89.     Browse Catalog. View catalog entries one by one; select a subset
  90.                     for viewing.
  91.     Build Catalog. Create catalog entries for groups of images.
  92.     Print Catalog Entries. Two formats are provided.
  93.     Rebuild Catalog Index. Recover lost space in file and compact it.
  94.  
  95. Edit Menu:
  96.     Paste palette and image from clipboard.
  97.     Copy all or part of an image to the clipboard.
  98.     Cut a selected area from an image.
  99.     Crop an image.
  100.     Expand an image to fill the dimensions of the current window.
  101.     Resize an image by a percentage amount or fit to a given dimension.
  102.  
  103. Options:
  104.     Set background color used when image is expanded.
  105.     Set whether to use a solid or pattern background color.
  106.     Display DIB or Bitmap format.
  107.     Control whether warning messages will be displayed.
  108.     Establish default operating options.
  109.  
  110. View Options:
  111.     Palette manipulation (Brightness and contrast).
  112.     Convert to gray scale.
  113.     Dither to Black & White
  114.     Dither to a lower color resolution.
  115.     View thumbnails of catalog entries.
  116.     Play a GIF animation sequence.
  117.     Single step through a GIF animation sequence.
  118.     Change the speed of a GIF animation sequence.
  119.  
  120. Other:
  121.     Using the mouse in the main viewing window, a marquee can be
  122.     selected for copying or cutting to the clipboard. The right mouse
  123.     button can be used to draw a stretch marquee where the selected
  124.     image rectangle is copied.
  125.  
  126. Help:
  127.     Context sensitive help is included for all menu items.
  128.  
  129. ******** Equipment Requirements **********
  130.  
  131. While PixFolio will execute in a minimal Windows installation, for example, a
  132. 286 with 2 megabytes of memory, program operation will be severely inhibited
  133. by a lack of memory. On such a configuration, large bitmaps, especially 8 or
  134. 24 bit images may fail. Other applications could be adversely affected as
  135. well and fail with unexpected UAE's. Actual results will vary depending upon
  136. the amount of memory used by other applications running concurrently.
  137.  
  138. PixFolio was developed and tested on a 20-MHz 386 with 8 megabytes of memory.
  139. It is recommended that PixFolio be run on a machine with at least 2 and pre-
  140. ferrably, 4 megabytes of memory. Running in 386-Enhanced mode will also
  141. make available the benefits of virtual memory.
  142.  
  143. The display of images containing more than 16 colors requires that you have
  144. a Super VGA or better video display and a 256 color Windows device driver in
  145. order to display the full range of colors in the image. However, PixFolio
  146. incorporates dithering functions that will allow display of a 256
  147. color image using a 16 color driver such as the standard VGA driver. Such
  148. operations are slow and the results are not as good as if you have a video
  149. display capable of displaying 256 colors.
  150.  
  151. ********** Program Limitations *************
  152.  
  153. PixFolio has no limit on the number of catalogs that can be created or the
  154. size of these catalogs except those restraints imposed by your file system
  155. and te amount of available memory. However, the following points should be
  156. noted:
  157.  
  158. 1. The size of a catalog is limited by the amount of disk space where it
  159.    resides or 32,767 index entries. Catalog records are variable length and
  160.    depend upon the type of image and how big the comments are.
  161.  
  162. 2. PixFolio may encounter difficulty with extremely large images, those in
  163.    excess of 1024 x 768 pixels. This is particularly true of color images
  164.    and even more so by 24 bit color or gray scale images. This is primarily
  165.    due to the increased memory requirements.
  166.  
  167. 3. While PixFolio and Windows supports 24 bit color and gray scale images,
  168.    the display of such images using a video driver that only displays 256
  169.    colors, can result in some lengthy delays whenever windows has to realize
  170.    the 24 bit RGB data to an 8 bit palette. It may take 15 to 20 minutes to
  171.    realize a 640 x 480 image depending upon the speed of your machine.
  172.    Dithering a 24 bit image to 256 colors can take more than an hour in some
  173.    cases.
  174.  
  175. 4. The support for GIF animation in PixFolio requires large amounts of free
  176.    memory. GIF animation files with a large number of frames or overlays may
  177.    unexpectedly fail when PixFolio runs out of memory.
  178.  
  179. 5. PixFolio has not been rigorously tested in a network environment. The
  180.    affect of network operations and more than one user accessing PixFolio
  181.    files concurrently cannot be predicted.
  182.  
  183. 6. Not all graphics formats are supported equally with respect to reading and
  184.    saving a file. For example, not all of the compression options are
  185.    currently supported for saving TIFF images. GIF images can only be saved
  186.    in GIF87a format. Likewise, some of the more obscure or obsolete formats
  187.    such as 4 color CGA formats for PCX cannot be written although they can be
  188.    read.
  189.  
  190. 7. The author has not been able to test PixFolio with printers that print
  191.    in color. The new HP LaserJet "Intellefont" driver does produce good
  192.    quality halftones from color images without dithering.
  193.  
  194. 8. The rendition of Windows Metafile (.WMF) images has not been extensivly
  195.    tested with a variety of files. Use at your own risk.
  196.  
  197. 9. The implementation of Micrografx .DRW and .GRF files is not rigorous. Some
  198.    features of these files are not supported. Unless you have Adobe Type
  199.    Manager or scalable typefaces, the rendition of fonts used in these files
  200.    may not be optimal when Windows matches fonts.
  201.  
  202. 10. Other program limitations, if any, can be determined by accessing the
  203.    online context-sensitive help.
  204.  
  205. ******** NOTE **********
  206.  
  207. If you have previously loaded Showgif (the former name of this program), you
  208. should edit your WIN.INI file changing the section name [Showgif] to
  209. [PixFolio]. Catalog file names, e.g. SHOWGIF.CAT need not be renamed but if
  210. you do, be sure to rename the index file, SHOWGIF.CIX also!
  211.  
  212. ****** Installation and Getting Started*******
  213.  
  214. If your copy of PixFolio was received on a distribution diskette, the
  215. installation can be done from within windows by running "SETUP" from drive
  216. A: or B: (whichever is appropriate). Otherwise, the following installation
  217. procedure should be followed:
  218.  
  219. It is suggested that the files which constitute PixFolio be placed in their
  220. own subdirectory on your hard disk. These files are:
  221.  
  222.     PIXFOLIO.EXE
  223.     PIXFOLIO.HLP
  224.     SPIN.DLL
  225.     METER.DLL
  226.     PIXDLL.DLL
  227.     PIXIODLL.DLL
  228.     PIXHELP.DLL
  229.     PIXCATLG.DLL
  230.     PIXTIFF.DLL
  231.     PIXGIF.DLL
  232.  
  233.     The following file is a Microsoft supplied DLL that provides common
  234.     dialog services and other functionality. You should place this file in
  235.     your Windows\System directory. Future versions of Windows may contain
  236.     newer versions of this file.
  237.  
  238.     COMMDLG.DLL
  239.  
  240. Not necessary for program operation are this file PIXREAD.ME, PIXREGST.FRM
  241. and PIXREGST.ME. PIXPACK.LST is a list of files included in this zip file.
  242. The user guide is USRGUIDE.WRI. It can be printed with Windows Write and
  243. formatted for your particyular printer.
  244.  
  245. Once the above files have been located in the subdirectory of your choice,
  246. start Windows and then use the Program Manager "Add" command to add PixFolio
  247. to the desired program group.
  248.  
  249. When PixFolio runs for the first time, it will establish a section in
  250. your WIN.INI file with program variables. These default options should enable
  251. you to start using PixFolio immediately. Once PixFolio is running you may
  252. access the online Help command for specific instructions and explanation of
  253. PixFolio menu commands.
  254.  
  255. A quick review of PixFolio features and operating procedures can be gained by
  256. reviewing the user guide.
  257.  
  258. ****** Credits ******
  259.  
  260. The author of PixFolio would like to recognize the efforts of Mr. Paul Hachey,
  261. (CompuServe Id 76247,3716) who performed an invaluable service by getting
  262. deeply involved in the extensive testing that went on over a period of months.
  263. Paul is responsible for the design of the PixFolio cover page, Icon and
  264. "About" dialog box and his many suggestions greatly influenced the "look and
  265. feel" of PixFolio.
  266.  
  267. ****** Known Bugs in Version 1.01a  that have been corrected ******
  268.  
  269. 1.  Saving an uncompressed PCX file does not create a file that can be
  270.     read by other programs such as Windows Paint. Try the compressed
  271.     option.
  272.  
  273. 2.  The save IFF file format is not working; the resulting file cannot
  274.     be read.
  275.  
  276. 3.  PixFolio does not properly interpret the image origin bit for
  277.     TGA images. Some TGA images may display upside down.
  278.  
  279. 4.  There is a memory allocation problem. After viewing a GIF file,
  280.     an attempt to view a TGA file will result in a "Local Alloc" error.
  281.     It may be necessary to stop and restart PixFolio to read a TGA file.
  282.  
  283. 5.  The "DIB to Screen" radio button on the default Options dialog does
  284.     not work. The option can still be changed from the Options menu.
  285.  
  286. 6.  If you uncatalog a slide that is displayed in Slide View, the slide
  287.     is not erased from the screen and subsequent attempts to access it
  288.     will result in a UAE.
  289.  
  290. 7.  You may experience UAE's after attempting to read a corrupted TIFF
  291.     file.
  292.  
  293. 8.  PixFolio would fail when attempting to create a thumbnail of a large
  294.     image.
  295.  
  296. 9.  The File Open/Save dialog wil now allow direct entry of a pathname in
  297.     lieu of selecting from the listbox.
  298.  
  299. 10. PixFolio "hangs" when the only item in a Catalog is Uncataloged.
  300.  
  301. 11. Windows crashes after exiting PixFolio. (This problem was introduced in
  302.     version 1.02.) This problem could occur if global memory was compacted
  303.     because while PixFolio was running.
  304.  
  305. ***** What's new in Version 1.02 *****
  306.  
  307. New features in version 1.02 include:
  308.  
  309. 1.  Print contents of a catalog, including the thumbnails or print selected
  310.     entries.
  311.  
  312. 2.  Read MACPAINT .MAC files.
  313.  
  314. 3.  Read imbedded TIFF preview images in Encapsulated Postscript .EPS files.
  315.  
  316. 4.  Dither 256 color images to 16 colors when using a standard VGA driver
  317.     which only supports 16 colors. Or dither 24 bit images to 256 colors.
  318.     An "Auto Dither" option has been added which provides for automatically
  319.     dithering an image for display if it's color resolution is greater than
  320.     your display driver's.
  321.  
  322. 5.  Cut and paste different images with different palettes and/or number
  323.     of colors.
  324.  
  325. 6.  File and record locking needed for running in a network environment.
  326.  
  327. 7.  Separate, printable user manual.
  328.  
  329. 8.  The file list in the Build function can now optionally display only
  330.     those images that are not cataloged.
  331.  
  332. 9.  Support has been added for users of PixFolio using Bernoulli boxes or
  333.     other high-capacity removable media. See the User Guide for details.
  334.  
  335. 10. "Slide View" has been renamed "Thumbnail View".
  336.  
  337. 11. PixFolio will maintain the original color information. Previous
  338.     versions would reduce color resolution to that of the display whenever
  339.     editing operations took place. For example, you can cut and paste 24
  340.     bit images even if you don't have a 24 bit video display and retain the
  341.     24 bit color data in the image. Likewise, PixFolio will not lose color
  342.     information when working on 8 bit color images and using the standard
  343.     VGA, 16 color driver.
  344.  
  345. 12. The contents of a catalog, less the thumbnail image, can be written to
  346.     a standard ASCII comma-delimited file which can be read by many
  347.     database programs or spreadsheets.
  348.  
  349. 13. Another application can be launched from the Thumbnail view using a
  350.     selected image file.
  351.  
  352. 14.    Support has been added for the Windows MetaFile clipboard format.
  353.  
  354. 15. Date and time in catalog entries will now be formatted per WIN.INI
  355.     (Control Panel - International) settings rather than customary USA
  356.     usage. (See the special note below).
  357.  
  358. 16. Support added for reading GEM ".IMG" files.
  359.  
  360. 17. Added a "Slide Show" for sequentially viewing selected images in full
  361.     screen mode.
  362.  
  363. 18. Added support for reading Windows Icon ".ICO" files.
  364.  
  365. 19. Added support for Windows clipboard ".CLP" files.
  366.  
  367. ***** Changes in Version 1.02.1 ****
  368.  
  369. 20. Added support for user defined scaling parameters for printed images.
  370.  
  371. 21. Add support for labeling a backup volume that has no label.
  372.  
  373. 22. Correct bug in DLL's that caused Windows to crash in some instances
  374.     when memory was low after PixFolio ends.
  375.  
  376. ***** Changes in Version 1.02.2 ****
  377.  
  378. 23. Add option to print catalog entries by reading in original image for
  379.     better print resolution as opposed to printing the thumbnail from the
  380.     catalog entry.
  381.  
  382. 24. Keep print options in WIN.INI file associated with a given printer. Allow
  383.     setting print options in Select Printer dialog.
  384.  
  385. 25. Correct bug that prevented printing 2 color images when printing catalog
  386.     entries.
  387.  
  388. 26. Corrected operation of Select Catalog dialog.
  389.  
  390. 27. Correct thumbnail of 2 color image; black and white reversed.
  391.  
  392. 28. Correct decoding of Primary Drives and Backup Drives WIN.INI options.
  393.  
  394. ****** Changes in Version 1.02.3 *****
  395.  
  396. 29. Add volume label checking for Catalog files.
  397.  
  398. 30. Correct bug in Thumbnail view where the last thumbnail disappears after
  399.     another thumnail is moved or uncataloged.
  400.  
  401. 31. Add Save As to View's File menu.
  402.  
  403. 32. Provide for alternative "PixFolio.INI" file to hold program options.
  404.     See note below!
  405.  
  406. 33. Added display of current catalog in window title bar in addition to
  407.     file name and format info.
  408.  
  409. **** Changes in Version 1.02.4 *****
  410.  
  411. 34. Corrected bug in print catalog routine causing 2 color images to not
  412.     print  and causing various UAE's, hangs, etc.
  413.  
  414. 35. Added subset of Edit menu to View window's menu.
  415.  
  416. **** Changes in version 1.02.4 *****
  417.  
  418. 36. Correct mismatch on Volume labels greater than 8 bytes long.
  419.  
  420. 37.    Correct bug in Re-index that caused "deleted"items to be re-instated.
  421.  
  422. **** Changes in Version 1.02.5 *****
  423.  
  424. 38. Add ability to select font to use for catalog printout.
  425.  
  426. 39. Retain user defined sequence when changing catalogs.
  427.  
  428. 40. Fix bug in TIFF processing routines that caused UAE's when the
  429.     TIFF image does not have Stripbytecounts per TIFF specs.
  430.  
  431. 41. Eliminate UAE that occurs when moving a thumbnail to a blank position.
  432.  
  433. 42. Correct scaling of images printed on catalog listing.
  434.  
  435. 43. Correct UAE that occurs when an inactive printer is selected.
  436.  
  437. **** Changes in Version 1.02.6 *****
  438.  
  439. 44. Correct bug causing various UAE's and inability to select catalogs or
  440.     create new ones.
  441.  
  442. 45. Change File Open/Save/Move to use common dialog dll (COMMDLG.DLL).
  443.  
  444. **** Changes in version 1.02.6a *****
  445.  
  446. 46. Change background color dialog to use common dialog.
  447.  
  448. 47. Change font selection to use common dialog.
  449.  
  450. 48. Add "ICN" as valid file extension for Windows ICON file.
  451.  
  452. 49. Correct error "Cannot Open Catalog" when moving or copying marked slides.
  453.  
  454. 50. Correct bug in Launch where profile options could not be found.
  455.  
  456. **** Changes in version 1.02.6b ****
  457.  
  458. 51. Correct bug in establishing color palette for PCX files.
  459.  
  460. ***** Changes in version 1.02.7 *****
  461.  
  462. 52. Modify Build dialog to use common dialogs.
  463.  
  464. 53. Correct bug in which prevented Catalog Export from executing.
  465.  
  466. 54. Correct UAE that occurred when saving a TIFF file.
  467.  
  468. 55. Include new version of COMMDLG.DLL
  469.  
  470. 56. Add Browse option to File - Launch. (1.02.7a)
  471.  
  472. ***** Version 1.03 *****
  473.  
  474. 57. Fix version 3 PCX file's palette.
  475.  
  476. 58. Create PIXGIF.DLL
  477.  
  478. 59. Correct bug in Select Catalog Delete function.
  479.  
  480. 60. Increase stack size.
  481.  
  482. 61. Add support for symbol rotation in Micrografx .DRW files.
  483.  
  484. 62. Correct display of metafiles for .WMF & .DRW/.GRF files.
  485.  
  486. 63. Eliminate "hang" when cancelling Catalog dialog in Build function.
  487.  
  488. 64. Include new version of COMMDLG.DLL.
  489.  
  490. 65. Eliminate spurious "File Locked" message whe performing a catalog
  491.     operation in a network environment.
  492.  
  493. ****** Version 1.03.1 ******
  494.  
  495. 66. Correct palette generation for PCX version 5 2 color files.
  496.  
  497. 67. Correct "hang" when "building" single catalog entry in Build function;
  498.     also, correct display of Status bar and inappropriate message that GIF
  499.     file format is invalid.
  500.  
  501. 68. Correct UAE which occurred when catalog volume label error message is
  502.     cancelled when starting Thumbnail View.
  503.  
  504. ***** Version 1.03.2 *****
  505.  
  506. 69. Correct date search when date format is different than US standard.
  507.  
  508. 70. Eliminate "This may take a while message" when displaying a 24 bit image
  509.     on a video display that displays greater than  256 colors.
  510.  
  511. **** Version 1.03.3 *****
  512.  
  513. 71. Fix palette for PCX version 2 - 2 color files.
  514.  
  515. **** Version 1.03.4 *****
  516.  
  517. 72. Fix another PCX palette problem resulting in images being displayed in
  518.     reverse video.
  519.  
  520. 73. Fix HELP button in File Open, Move/Copy and Catalog Export.
  521.  
  522. 74. Widen directory display listbox in File Operation, et. at. to display long
  523.     pathnames without clipping.
  524.  
  525. 75. Correct copy to clipboard from a View Window. Also, remove "crop" from
  526.     View window Edit menu. Fix UAE that occurs when using the COPY command
  527.     from a view window.
  528.  
  529. 76. Eliminate empty main window which appears temporarily while doing a
  530.     build operation.
  531.  
  532. 77. Revamp Catalog print format to more consistently print 4 images per
  533.     page.
  534.  
  535. **** Version 1.03.5 *****
  536.  
  537. 78. Correct UAE caused by error in formatting window title when catalog
  538.     titles were more than approximately 15 bytes.
  539.  
  540. 79. Correct truncation of last character of volume id in catalog information
  541.     when volume name was 11 characters long.
  542.  
  543. 80. Correct erroneous "Save" after selecting File - New.
  544.  
  545. 81. Correct UAEs involved in Cut and Crop operations.
  546.  
  547. 82. Correct Bug in Thumbnail ProcessThumnails, uncatalog. Would only
  548.     uncatalog part of those thumbnails selected.
  549.  
  550. **** Special Notes for users updating from a prior version ****
  551.  
  552. If you are upgrading from a previous version of PixFolio, you may wish to
  553. update the default extensions (via the default Options command) or the
  554. extensions defined for each catalog (via the Select Catalog command) to add
  555. the new extensions for file types ".EPS", ".ICO", ".IMG" and ".MAC" if you
  556. plan to use these file types. Alternatively, you may change these options
  557. by editing the PixFolio section of your WIN.INI file.
  558.  
  559. If you are not using the US standard date and time formats, PixFolio will not
  560. convert dates and times in existing catalogs to the format specified in your
  561. Windows WIN.INI file. However, all new catalog entries will use these formats.
  562.  
  563. PixFolio defaults to WIN.INI for storing program options. All options will be
  564. stored following a [PixFolio] header. If you do not want to store program
  565. options in WIN.INI, PixFolio can save its options in a file named
  566. "PIXFOLIO.INI" which can be located in the Windows directory, the PixFolio
  567. program directory, or any directory listed in your PATH statement. If you want
  568. to excercise this option, use NotePad to delete the entries for PixFolio in
  569. your WIN.INI file and paste them into a new file named "PIXFOLIO.INI".
  570. Subsequently, if PixFolio finds a file called "PIXFOLIO.INI" it will use it
  571. instead of WIN.INI.
  572.