home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1996 October / PCO_10.ISO / filesbbs / image.arj / README.TXT < prev    next >
Encoding:
Text File  |  1996-05-26  |  16.7 KB  |  338 lines
  1.                            ImageGen Version 2.1a2
  2.  
  3.                         Written By Robert Thivierge
  4.  
  5.                        For 16-bit and 32-bit Windows
  6.  
  7. ImageGen is a freeware Windows program that produces HTML Web pages
  8. consisting of small in-line GIF images. These images can be clicked on in a
  9. Web browser (like Netscape or Mosaic) to see the full sized JPEG or GIF
  10. picture. The output can be customized to suit your tastes. ImageGen is
  11. available in 16-bit and 32-bit versions.
  12. ---------------------------------------------------------------------------
  13. Note: Before downloading the program, you need to read through this entire
  14. web page so you're aware of all the benefits and pitfalls of ImageGen.
  15.  
  16. This document is on the web at http://www.canuck.com/~thivier1/imagegen and
  17. is a plain text file (called README.TXT), which is included with ImageGen.
  18.  
  19. Table of Contents
  20.  
  21.    * ImageGen News
  22.    * Current Features
  23.    * Planned Features
  24.    * Obtaining the Program
  25.    * Legal Issues and Credits
  26.         o Ownership
  27.         o Freeware Status
  28.         o Credits
  29.         o Disclaimer
  30.    * System Requirements
  31.    * Installation Procedures
  32.    * Known Bugs
  33.    * Known Potential Problems
  34.    * Contacting the Author
  35.  
  36. ImageGen News
  37.  
  38. Version 2.1 has an added feature for advanced users. It can read pictures
  39. off a CD-ROM, when creating a web site. HTML pages and in-line images are
  40. written to your hard disk, and everything is linked together. For more
  41. information select "Help/Contents" in ImageGen. Then click on "CD-ROM
  42. Support".
  43.  
  44. Version 2.1a2 introduces a couple of safety improvements. Because ImageGen
  45. creates a lot of files in a run, it used to clean-up some old files (ie.
  46. delete them) before re-creating a web site. Several people didn't think was
  47. very user friendly. To be safe, ImageGen no longer does this. Now, ImageGen
  48. only destroys a file if you explicitly delete it, or ImageGen has to
  49. overwrite it with an up-to-date version (ie. you re-create a page).
  50. However, it is still necessary to back-up your valuable data before using
  51. ImageGen. There are no safety gaurentees.
  52.  
  53. Current Features
  54.  
  55. Web Features
  56.  
  57.    * For every JPEG or GIF file in your site, it creates a smaller GIF
  58.      version.
  59.    * It generates one or more HTML files which contain links to these
  60.      pictures. If you choose to have a sophisticated multi-page site (which
  61.      you don't have to) a browser of your site will be able to traverse
  62.      through all the pages by following links.
  63.    * Within ImageGen you can preview JPEG pictures, after you've generated
  64.      a site. This is useful if you want to place descriptive text next to
  65.      the picture (which ImageGen supports).
  66.    * Your site can have one or more pages in any directory and any number
  67.      (zero, one, or many) sub-directories and any level of sub-directories.
  68.    * You can have ImageGen automatically generate a layout for your
  69.      pictures with the "AutoOrganize" feature. It recognizes repeated file
  70.      name patterns (ie. cc01.jpg, cc02.jpg, etc...), and groups them for
  71.      you. Optionally you can edit this default layout.
  72.    * All text outputted in pages can be changed. You can make changes
  73.      globally that effect all pages, make changes that effect a certain
  74.      type of page, make changes that effect only a particular directory, or
  75.      effect only a particular page. You can also specify certain text to go
  76.      next to individual pictures. For instance, next to a photo you could
  77.      have the title of the photo and the name of the person (or object) in
  78.      the photo. The text you specify may contain any HTML tags you wish.
  79.      Pretty much, anything that can be done in HTML can be done with
  80.      ImageGen.
  81.    * You can have any number of pictures appear on a row in a table (if you
  82.      choose to use tables to display your pictures).
  83.    * You can control the display width and height of images.
  84.    * ImageGen (by default) uses the WIDTH and HEIGHT tag to tell the
  85.      browser the dimensions of a picture. This speeds up the display of
  86.      your page for most browser users. Browsers not supporting these tags,
  87.      simple ignore them.
  88.    * As an optional alternative to having the Directory Index Pages link
  89.      directly to the anchor image, you can have them link to a picture
  90.      Detail Page. This detail page can optionally show the full sized image
  91.      or the reduced size image.
  92.    * You can choose from a pre-defined list of sample layouts.
  93.    * You can choose what file extension is used in HTML pages created. They
  94.      can be "htm" or "html". This makes it easier for you to transport web
  95.      pages to different operating systems (ie. UNIX), that may prefer a
  96.      particular extension. Only Windows 95 and NT users of the 32-bit
  97.      version can actually create files with the "html" extension, since
  98.      Windows 3.1 doesn't support long file names.
  99.    * Support for the new progressive-JPEG file format. Progressive-JPEG
  100.      files take less disk space and have a fade in effect when viewed by
  101.      Netscape.
  102.    * Picture files can be renamed from within ImageGen.
  103.    * You can create a web site out of pictures on a CD-ROM. HTML pages and
  104.      in-line GIF files are written to the hard disk, and everything is
  105.      linked together.
  106.  
  107. If there's anything you can't get ImageGen to do when making Web Pages,
  108. please let me know.
  109.  
  110. Planned Features
  111.  
  112. These are features I would like to implement if I get feedback on their
  113. usefullness.
  114.  
  115.    * Support using Java Applets. Currently, since you can enter any HTML
  116.      code into ImageGen, you can use Java Applets with your ImageGen sites.
  117.      However, I would like to have some kind of special support. For
  118.      instance, right now, ImageGen shows a sample image from a sub-page for
  119.      the user to click on to go to the sub-page. With Java, I could let you
  120.      see a slideshow of pictures in the sub-page. I'ld appreciate any
  121.      help/suggestions from people who know something about Java.
  122.    * Allow users to create Netscape Client Side Image Maps. The image map
  123.      would show the user a single image which is a composite of thumbnails
  124.      of the images in the directory (a.k.a. a contact sheet or image
  125.      index). The browse user could use this image map, or they could use
  126.      the traditional HTML index page to access the pictures (or
  127.      sub-directories). In the Image Map text could be placed next to the
  128.      images, such as the file name.
  129.    * Allow users to copy and move picture files from within ImageGen.
  130.    * Provide an even more user friendly interface for customizing a site.
  131.    * Provide an easy built-in way to package files to be uploaded to a UNIX
  132.      box.
  133.    * Let the user choose between GIF and JPEG format for in-line images.
  134.    * Allow the user to group picture files onto different pages based on
  135.      the values in user defined fields. Pictures with the same value in a
  136.      given field would go on the same page.
  137.    * Proper support for interlaced GIF images.
  138.  
  139. Choosing the Right Version and Obtaining the Program
  140.  
  141. Select the highlighted text below to download the ZIP file. In Netscape use
  142. the right mouse button, and choose "Save this link as". In Mosiac use the
  143. right mouse button, and choose "Save anchor to disk. With any browser, you
  144. should be able to just click with the left mouse button, and then be given
  145. an option to the save the file to disk. Don't forget to read about the
  146. installation.
  147.  
  148.    * Dowload the 32-bit version if you are running Windows 95 or Windows
  149.      NT. Also, you can use it if you have Windows 3.1 or Windows for
  150.      Workgroups 3.11 and you have win32s. This version can run 2 to 3 times
  151.      faster then the 16-bit version.
  152.    * Download the 16-bit version if you can't run the 32-bit version. OS/2
  153.      may not support win32s (I don't know). Iif you use the 32-bit version
  154.      with Windows 3.1 or WFW 3.11, it will hog the computer while running.
  155.      Other programs will be temporarily idle. This could be a problem if
  156.      you have a live internet or network connection. However, if this is
  157.      the case, I strongly suggest the real solution to the problem is an
  158.      upgrade to Windows 95 or NT.
  159.  
  160. Note: Since very few people seem to download the 16-bit version, I may well
  161. discontinue its production. If you need it, then please, let me know. This
  162. is very important. Once it's gone, it may never come back. By focussing on
  163. the 32-bit version alone, I can acheive some speed improvements.
  164.  
  165. Legal Issues and Credits
  166.  
  167. Ownership
  168.  
  169. ImageGen(c) 1996
  170. The Picture Page Generator
  171. Written by Robert Thivierge
  172. All rights reserved by Robert Thivierge
  173.  
  174. Any attempt by a person other than myself to reverse compile, sell, or to
  175. represent the program as their own is prohibited. You may give a copy of
  176. the the program to someone else free of charge, provided you include all
  177. the files you received yourself. They then should notify me of receipt of
  178. it.
  179.  
  180. However, any person or organization may distribute my program as freeware.
  181. They may charge a fee for the service of distribution (such as on-line
  182. charges, charge for distribution media, etc...). An acceptable form of
  183. distribution is including my program on CD-ROMs containing
  184. freeware/shareware, where there is a charge for the CD-ROM. However, it
  185. must be understood that they are not selling my program. And absolutely
  186. nobody, but me, may imply or suggest that they authored this program or
  187. that it is their property. I must always be given full credit.
  188.  
  189. Freeware Status
  190.  
  191. This program is freeware. I do not require financial payment for use of
  192. this product provided you meet the following terms:
  193.  
  194.   1. I be notified when you obtain my program.
  195.   2. I be given the URL of any site produced with ImageGen.
  196.   3. I be given access to any private site produced with ImageGen,
  197.      including a password if needed.
  198.   4. I be notified of any commercial use of my program.
  199.   5. All terms of use mentioned in this document, and on-line help of
  200.      ImageGen are fully read, understood, and complied with.
  201.  
  202. If and only if all the above terms are granted do you have the right to use
  203. ImageGen for free and own, royalty free, anything produced with it.
  204.  
  205. Credits
  206.  
  207.    * This software is based in part on the work of the Independent JPEG
  208.      Group. They are kind enough to allow programmers to use their code
  209.      library without financial charge.
  210.    * The Graphics Interchange Format(C) is the Copyright property of
  211.      CompuServe Incorporated. GIF(SM) is a Service Mark property of
  212.      CompuServe Incorporated.
  213.    * The actual compression method used in GIF is copywrited by Unisys
  214.      Corporation. I thank them for allowing freeware authors to use their
  215.      compression method without obtaining a license or paying royalties.
  216.      See the Unisys FAQ on GIF for further details.
  217.    * This program uses code from TabDlg.DLL which is Copyright (c) 1994
  218.      Edward McCreary
  219.  
  220. Due to time constraints I have unable to mention all the people who helped
  221. with suggestions. I'm to busy implementing them.
  222.  
  223. Disclaimer
  224.  
  225. Use my program at your own risk. There are bugs I know of, there are bugs I
  226. don't know of. I assume no liability for any losses incurred by use of my
  227. program. I myself have accidently overwritten files with ImageGen. So, if I
  228. can loose stuff, you can too. In fact, some users have lost files and been
  229. unable to recover.
  230.  
  231. System Requirements
  232.  
  233.    * Operating System: Windows 3.1, WFW 3.11, 95, or NT. Should also run on
  234.      OS/2. Read about Which Is The Correct Version. Windows 95 is the
  235.      preferred platform.
  236.    * Memory: The more the better. 8 Megs should do it.
  237.    * Hard Disk Space: If you have lot's of pictures, you'll need lot's of
  238.      hard disk space.
  239.  
  240. Installation Procedures
  241.  
  242. To install, do the following:
  243.  
  244.   1. Back-up everything that's important to you before installing this or
  245.      any program. If you don't you will cry later. People have told of
  246.      loosing stuff and being unable to recover it. There was nothing I
  247.      could do in these cases. Do not think that "undelete" or the "Recycle
  248.      Bin" (in Win95) will save you. It won't. Be smart. Be careful.
  249.   2. Make a directory for the program (such as C:\IMAGEGEN). It is very
  250.      important that you have a directory set aside exclusively for
  251.      ImageGen. Never use the same directory for the program that you use
  252.      for your Web Site (ie. the directory where you keep all your
  253.      pictures).
  254.   3. Copy the ZIP File into it.
  255.   4. Unzip it with PKUNZIP or a compatible program.
  256.   5. Make sure all the files are in the same directory, with no other files
  257.      present. Never use this directory to put your pictures or HTML files
  258.      in.
  259.   6. In Windows 3.1 double click the "imagegen.exe" file in the File
  260.      Manager. In Win95 use the Windows Explorer to do the same
  261.      (double-click on "imagegne").
  262.   7. When you generate a site, you'll be asked for your full name, enter
  263.      it. There is on-line help available from the pull-down menu. Use it.
  264.   8. IMPORTANT: Select File/Select Directory and tell ImageGen where you're
  265.      Web Site is. In other words this is the directory where all of you
  266.      JPEG or GIF pictures are located.
  267.   9. Now look through the various settings (all of which can be accessed on
  268.      the main screen), ensure they are all as you wish. Pay special
  269.      attention to "General Settings" and the sub-items under it.
  270.  
  271. Known Bugs
  272.  
  273. Please let me know of any and all bugs you have had experience with. First
  274. be sure that you have the latest version of ImageGen from
  275. http://www.canuck.com/~thivier1/imagegen/index.html. Keep in mind, I am
  276. interested in the bug, even if others have reported it, and information
  277. about it is below. The more people who tell me about how they got (or
  278. didn't get) a bug, and what the circustances were, the sooner I will be
  279. able to fix the problem.
  280.  
  281. If you experience a bug and it goes away, or you work around it, please let
  282. me know. This will help others. Also, always report all the details of the
  283. bug (ie. what happened on the screen), and your configuration (ie. what
  284. operating system do you have).
  285.  
  286. If possible, please try seeing if you get the same error with a target
  287. version. That is if you used the 32-bit version, try the 16-bit version,
  288. and vice-versa. Remember, the more I know about the problem, the quicker
  289. the fix.
  290.  
  291. Bug List
  292.  
  293.    * If ImageGen (16-bit) is in the middle of a very long task, clicking
  294.      anywhere on the program, could cause it to crash. You can switch to
  295.      other programs safely while ImageGen is running. But, you must never
  296.      try to do two things at once with ImageGen itself. The 32-bit version
  297.      doens't have this bug, since it ignores the mouse while it's in the
  298.      midst of a big task.
  299.    * Every so often when clicking on a picture item, the 16-bit version
  300.      will crash while trying to display the pre-view image. I haven't
  301.      encountered this in the 32-bit version.
  302.    * You can't preview GIF files. I plan to fix this in a future release.
  303.      This problem is part of the price of much faster previewing of JPEG
  304.      files.
  305.  
  306. Known Potential Problems
  307.  
  308. Pease be advised certain actions taken in ImageGen have massive and
  309. permanent consequences, for which users (ie. you) and not me, are 100%
  310. liable for. A list of only some (not all) of these follows. Always back up
  311. valuable work, before using ImageGen. Remember, I am not responsible for
  312. any problems you have with ImageGen. Even if I do not warn you about them.
  313.  
  314.    * ImageGen can create a very large number of files automatically. It
  315.      creates in-line image files (*.gif), web pages (*.htm), cache image
  316.      files (*.bmp), and sub-directories, as needed. Sometimes a file may no
  317.      longer be needed, it's your responsibility to periodically clean-up up
  318.      your hard disk. ImageGen no longer attempts to do this, because
  319.      several users have complained about the "AutoDelete" "feature" of
  320.      ImageGen. I'm open to ideas on improving this situation.
  321.    * When writing files, ImageGen will overwright existing files of the
  322.      same name, with absolutely no warning. In particular ImageGen always
  323.      creates a file called index.htm (or index.html). Make sure you don't
  324.      already have a file of the same name.
  325.    * If you use the "File/Delete" function in ImageGen, the file(s)
  326.      selected will be permanently deleted. Please realize that this does
  327.      not just mean ImageGen won't use the file. It means the file is
  328.      actually deleted permanently off your hard disk. No Recycle Bin is
  329.      used. The stuff is gone forever. This is not a bug. This is what
  330.      "delete" means. If you want to keep a file, then don't delete it.
  331.  
  332. Contacting the Author
  333.  
  334. You are welcome to contact me with your comments, suggestions, and bug
  335. reports at thivier1@canuck.com.
  336.  
  337. Visit my Home Page at http://www.canuck.com/~thivier1
  338.