home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / r / rend24i.zip / REND.DOC < prev    next >
Text File  |  1992-09-22  |  35KB  |  808 lines

  1. ----------------------------------------------------------------------------
  2.  
  3.  
  4.                 Rend24 - A Batch Image Conversion System
  5.  
  6.                        Written by Thomas Krehbiel
  7.  
  8.                   Copyright ⌐ 1991,1992 Thomas Krehbiel
  9.                           All Rights Reserved
  10.  
  11.  
  12. ----------------------------------------------------------------------------
  13.  
  14.  
  15. DISTRIBUTION
  16.  
  17.     Rend24 is being distributed as Shareware.  If you find this program
  18.     useful, please consider sending a donation of $25 or so to the
  19.     author (address given at the end of this document).  In return,
  20.     I will send you a disk with the latest registered version of the
  21.     program.  The registered version does not contain any "guilt"
  22.     messages.
  23.  
  24.     If you are a registered user of Rend24, send me a disk (and a SASE
  25.     if you really want to make it easy for me) and I'll send you the
  26.     registered version of Rend24 1.04x.
  27.  
  28.     Rend24 may be freely distributed to any bulletin board, network, or
  29.     through any public domain library collection, so long as no fees
  30.     (beyond reasonable media costs) are charged for such distribution.
  31.     This product is being distributed "as is", with no warranties
  32.     expressed or implied as to the use or misuse of the program.
  33.  
  34.  
  35. INTRODUCTION
  36.  
  37.  
  38.     Rend24 was originally written as an excercise in converting
  39.     24-Bit IFF files into displayable resolutions.  At that time,
  40.     I was working with the Toaster's Lightwave 3D often, and without
  41.     the benefit of a single-frame controller, it was somewhat awkward
  42.     getting a displayable animation out of Lightwave.  Lightwave is
  43.     capable of saving each frame it generates as a 24-Bit IFF file;
  44.     hence, an idea was born.
  45.  
  46.     What I needed was a program that would wait around in the
  47.     background while Lightwave generated a frame.  Then, when the
  48.     frame was saved to disk, the program would jump in and convert
  49.     the 24-bit file down to an Amiga-displayable format and pack
  50.     it into an IFF Animation file and return to waiting for the
  51.     next frame.
  52.  
  53.     So I set out to write my own program to do the job.  Along the
  54.     way it has acquired a number of useful features which don't relate
  55.     at all to the original plan.  You can use it to convert GIF
  56.     files to Amiga format.  You can use it to view JPEG files directly.
  57.     You can use it interactively convert VistaPro generated files into
  58.     DCTV animations.  This program does a lot for the money...
  59.  
  60.  
  61. CONCEPT
  62.  
  63.     Rend24's purpose is to convert one or more input images into
  64.     individual viewable ILBM images or a single viewable ANIM animation.
  65.     The input images may be 24-bit ILBMs, GIF format images, or even
  66.     JPEG compressed images.  You control the format of the output
  67.     images and/or animations, including the color depth, dithering,
  68.     and size.
  69.  
  70.     Rend24's strength lies in its ability to convert batches of images
  71.     at a time.  You tell Rend24 where to find the input images, how many
  72.     there are, and then sit back and watch it go.
  73.  
  74.  
  75. FEATURES
  76.  
  77.     o Runs under Workbench 1.3 and 2.04.
  78.  
  79.     o Generally fast conversion times.
  80.  
  81.     o Supports most standard IFF-ILBM image formats, from 2-color through
  82.       HAM all the way up to 8- and 24-bit.
  83.  
  84.     o Supports reading Compuserve GIF format images directly.
  85.  
  86.     o Supports reading JPEG/JFIF compressed images directly (if somewhat
  87.       slowly...).
  88.  
  89.     o Can generate individual pictures or a standard IFF-ANIM Op 5 animation,
  90.       with or without palette locking.
  91.  
  92.     o Supports HAM-E and DCTV format rendering.
  93.  
  94.     o Supports Floyd-Steinberg dithering to increase the number of apparent
  95.       colors.
  96.  
  97.     o Now includes a handy-dandy front-end for CLI-phobes.
  98.  
  99.     o Supports arbitrary scaling of input images.
  100.  
  101.  
  102. HARDWARE REQUIREMENTS
  103.  
  104.      Rend24 should run on any Amiga with any amount of chip and fast
  105.      memory.  However, due to the nature of 24-bit image manipulation,
  106.      Rend24 can use up quite a bit of memory loading and converting an
  107.      image.  Working with 320x200x24 images I would say you would need
  108.      1Meg minimum.  Working with 768x480x24 images you will probably
  109.      need at least 3Meg of free memory.  Rend24 always uses fast memory
  110.      except for the memory to open the display screen, so chip memory
  111.      should not be a problem.
  112.  
  113.      Rend24 is fully Workbench 2.0 compatible (as of the time of this
  114.      writing, at least).  In fact, it takes advantage of a couple of
  115.      features in 2.0 which make Amiga mode conversion times a tad
  116.      faster.
  117.  
  118.  
  119. INSTALLATION
  120.  
  121.     Rend24 is fairly easy to install.  Simply drag the program icon
  122.     to wherever you would like it to reside.  It doesn't have to be
  123.     in your C: directory (although if you plan to use the program
  124.     from CLI you might want to put it in your command path somewhere).
  125.  
  126.     Certain features of Rend24 require some libraries to be installed
  127.     in your LIBS: directory.  There should be an installation program
  128.     accompanying the main program, which will guide you through
  129.     installing the libraries.  The libraries are:
  130.  
  131.         hame.library        Required for generating HAM-E images.
  132.  
  133.         dctv.library        Required for generating DCTV images.
  134.  
  135.         arp.library         Required under version 1.3 of the
  136.                             operating system to have a file
  137.                             requester available in the front end.
  138.  
  139.     That's it!  That wasn't so hard, was it? :)
  140.  
  141.  
  142.  
  143. RUNNING THE PROGRAM FROM WORKBENCH
  144.  
  145.     Couldn't be easier... simply double click the Rend24 icon and
  146.     in a few seconds a window will appear on your Workbench with
  147.     a whole bunch of gadgets in it.  This is what I call the "Front End"
  148.     window, and is where you tell Rend24 what you want to do in a
  149.     (hopefully) convienient manner.
  150.  
  151.  
  152.     Source Image Pattern
  153.  
  154.         This is where you enter input file(s).  Click in the string gadget
  155.         and just type the full pathname of image you want to convert.
  156.         Or, you can click on the Choose gadget to the right to open a
  157.         file requester where you can choose the input image.
  158.  
  159.         You can specify a standard wildcard pattern for the source image,
  160.         to convert more than one at a time.  The pattern is the same
  161.         used by standard AmigaDOS commands (#?)... you may also use
  162.         the Unix-style '*' character as a wildcard.  So if you specify
  163.         "DollFace*.pic" as the source image pattern, then all files
  164.         matching that pattern will be converted.
  165.  
  166.         If you are using the Frame Count gadget (see below), then enter
  167.         only the filename "base" without any numbers.
  168.  
  169.  
  170.     Source Frame Count
  171.  
  172.         This is used when you are converting a series of frames output
  173.         by, for example, Lightwave or VistaPro.  It expects the source
  174.         image filenames to be in the format "Picture001", "Picture002",
  175.         "Picture003", etc.  You enter the base name of the files (eg.
  176.         what you entered in Lightwave or VistaPro for the file prefixes;
  177.         do NOT include the numbers afterward!) into the Source Image
  178.         Pattern gadget, and then enter the number of frames you want to
  179.         convert in the Source Frame Count gadget.
  180.  
  181.  
  182.     Dest Picture Pattern:
  183.  
  184.         If you want to generate individual IFF-ILBM pictures, you
  185.         enter the full pathname of the output file here.  You can also
  186.         click on the Choose gadget to the right to bring up a file
  187.         requester to make you selection easier.
  188.  
  189.         If you are converting more than one input file, you will probably
  190.         want to specify a pattern for the output pictures.  The pattern
  191.         is just like a standard pathname, except there should be a single
  192.         '*' character in the path somewhere.  For each file converted,
  193.         the '*' character will be replaced with the name of the input
  194.         image currently being converted, minus any extensions.  So if
  195.         the current input image is "DollFace.pic" and your output pattern
  196.         is "mydrive:*.ham" then the output filename for "Dollface.pic"
  197.         will by "mydrive:Dollface.ham".
  198.  
  199.  
  200.     Dest Animation:
  201.  
  202.         If you want to create an animation file, then enter the full
  203.         pathname of the destination animation file here.  Once again,
  204.         you can click on the Choose gadget to bring up a file requester.
  205.         All files converted will be packed into this animation file.
  206.  
  207.         Note that you cannot append to an existing animation file; you
  208.         can only create an animation from the conversions done in a
  209.         single Rend24 session.  So to create an animation you need to
  210.         either use an input pattern or specify a frame count.  Otherwise
  211.         the animation will only have one frame in it.
  212.  
  213.  
  214.     Output Image Format:
  215.  
  216.         This cycling gadget controls the output image type.  "Lumascale
  217.         B&W Image" will create an NTSC greyscale image, created
  218.         by taking the luminence value of the red, green, and blue components
  219.         of each pixel.  "Greyscale Image" will also create a greyscale
  220.         image, but it simply averages the red, green, and blue components
  221.         of each pixel to get the grey value.  "Color Image" will create
  222.         a register-mapped color image.  "HAM Image" will create a HAM
  223.         (Hold and Modify) image.
  224.  
  225.         Note that if you have selected DCTV rendering, this gadget is
  226.         ignored.  DCTV rendering always uses full NTSC color.
  227.  
  228.         Following is a table of the amount of colors used for each
  229.         image format:
  230.  
  231.  
  232.             Format              Amiga       HAM-E       DCTV
  233.             ----------------    ---------   ---------   --------
  234.             Lumascale           16          256         n/a
  235.             Greyscale           16          256         n/a
  236.             Color               16 or 32*   256         n/a
  237.             HAM                 4096        262,144     n/a
  238.  
  239.             * = depends on image width; for images bigger than 384 pixels
  240.                 wide (ie. hires images) Rend24 will use 16 colors; otherwise
  241.                 it will use 32 colors.
  242.  
  243.  
  244.     Use DCTV:
  245.  
  246.         When checked, all images and animations generated will be
  247.         in DCTV format.  Note that you must have dctv.library in your
  248.         LIBS: directory for this to work.
  249.  
  250.     Use HAM-E:
  251.  
  252.         When checked, all images and animations generated will be
  253.         in HAM-E format.  You must have hame.library in your LIBS:
  254.         directory for this to work.
  255.  
  256.     High Quality:
  257.  
  258.         This gadget only has meaning for DCTV and HAM-E rendering
  259.         formats.  For DCTV images, if High Quality is checked then
  260.         Rend24 will use 4 bitplanes instead of 3.  For HAM-E images,
  261.         if High Quality is checked then Rend24 will generate a
  262.         palette with a higher degree of accuracy, which can take
  263.         significantly longer.
  264.  
  265.     Run "Convert":
  266.  
  267.         If checked, then Rend24 will attempt to run Black Belt Systems'
  268.         "Convert" program on each input file.  This can be used to
  269.         convert foreign file types to standard IFF24 for use with
  270.         Rend24.  You will probably not need to use this very often, if
  271.         ever.
  272.  
  273.     Lock Palette:
  274.  
  275.         When checked, this will keep the palette the same across multiple
  276.         conversions.  That is, it will generate a palette for the first
  277.         frame only, and then use that same palette for all subsequent
  278.         frames.  This is most useful for HAM-E animations and for creating
  279.         animations for, say, DPaint (which doesn't support different
  280.         palettes for different frames).
  281.  
  282.     F/S Dither:
  283.  
  284.         This enables the Floyd-Steinberg dithering algorithm, which can
  285.         increase the number of apparent colors in an image.  It generally
  286.         does not work too well for HAM images, though, and in all cases
  287.         increases the amount of time it takes to convert each image.
  288.         For animations, this can also significantly increase the number
  289.         of changes between frames, causing the animation to play slower
  290.         and consume huge amounts of memory.
  291.  
  292.     Double Width:
  293.  
  294.         When selected, Rend24 will double the width of any images that
  295.         are smaller than 384 pixels wide.  This was added for rendering
  296.         HAM-size images into DCTV format without squishing the image
  297.         horizontally.  When rendering to DCTV, you probably want to
  298.         leave this checked.
  299.  
  300.     Halve Width:
  301.  
  302.         When this is checked, Rend24 will halve the width of any images that
  303.         are larger than 384 pixels wide.  This is handy when converting
  304.         hires 768x480 images into HAM images.
  305.  
  306.     Halve Height:
  307.  
  308.         When checked, Rend24 will halve the height of any images that are
  309.         larger than 240 pixels tall.  Handy for converting what would
  310.         normally be an interlace image into non-interlace.
  311.  
  312.     Rotate 90 Degrees:
  313.  
  314.         This will rotate each input image 90 degrees counter-clockwise.
  315.         Handy for reading images saved by ASDG's ScanLab, which for some
  316.         reason only saves images in portrait mode.
  317.  
  318.     NTSC Limit:
  319.  
  320.         When checked, this will reduce the brightness of each input image
  321.         to fit into NTSC limits.  Note that my implementation is a VERY
  322.         simple algorithm, and may not be what you want.
  323.  
  324.     Delete Source's:
  325.  
  326.         When checked, Rend24 will delete each input 24-bit image after
  327.         it has been converted.  This is most handy when converting frames
  328.         from, for example, Lightwave or VistaPro as they generate the
  329.         images.  It will reduce the amount of hard drive space you need
  330.         free while converting.  However, it also eliminates the possibility
  331.         of redoing the conversion since the source images will be gone.
  332.         So be careful with this one.  I recommend leaving this off (unless
  333.         you are really pressed for hard drive space) and delete the source
  334.         images only after you are satisfied with the results of Rend24.
  335.  
  336.     Hide Conversion:
  337.  
  338.         When checked, Rend24 will not show you images as they are being
  339.         converted.  For 16-color Hires images, this can significantly
  340.         speed up the conversion process.  It's also handy if you don't
  341.         want to be annoyed by a bunch of screens popping to the front
  342.         all the time.
  343.  
  344.     Don't Pause:
  345.  
  346.         Normally, Rend24 will pause after each image is converted and
  347.         wait for a mouse click.  When this option is enabled, it will
  348.         go into "batch" mode and perform all of its conversions without
  349.         user involvement.  For converting animations, you will probably
  350.         want to check this item.
  351.  
  352.     Wait for Source's:
  353.  
  354.         When checked, Rend24 will sit in a loop waiting for each input
  355.         file to appear.  This is especially useful for converting frames
  356.         produced by Lightwave as the frames are generated.
  357.  
  358.     Ping-Pong Anim:
  359.  
  360.         When generating an animation from a numbered series of frames
  361.         (ie. when you have a number other than zero in the Frame Count
  362.         gadget), this will cause Rend24 to create the animation such
  363.         that it will ping-pong when played back.  It does this by
  364.         duplicating all the frames in descending order after processing
  365.         all the frames normally.  Thus, it takes about twice as long
  366.         to do this and the animation will be about twice as big.
  367.  
  368.     No Loop Frames:
  369.  
  370.         Normally, Rend24 will append two "looping" frames to the end
  371.         of any animation it creates.  Turning this option on will
  372.         keep Rend24 from doing this.
  373.  
  374.     X: Y:
  375.  
  376.         These two gadgets let you perform arbitrary scaling on source
  377.         images.  Enter the width and height of the resulting images you
  378.         want in the X and Y gadget respectively, and Rend24 will scale
  379.         the source images to this size, regardless of the original
  380.         image size.  Thus if you enter 160 and 100 into these gadgets
  381.         then all resulting files will be 160x100 images/animations.
  382.         Enter 0 and 0 to turn off the arbitrary scaling.
  383.  
  384.     Begin Conversion
  385.  
  386.         Click this when you have everything setup the way you want it
  387.         to let Rend24 start working.
  388.  
  389.     CANCEL!
  390.  
  391.         Click this or the window close gadget to quit Rend24.
  392.  
  393.  
  394.     The front-end also has a few menus.  They are described below:
  395.  
  396.     Save Settings (Right Amiga-S)
  397.  
  398.         This will save all your current front-end settings to
  399.         a file in your S: directory.  After you have things setup
  400.         the way you want them, you might want to save the settings
  401.         so you don't have to re-setup each time you run Rend24.
  402.  
  403.     Default Source Directory...
  404.  
  405.         Lets you choose the directory where input images come from
  406.         by default.  This is the directory that first comes up
  407.         when you click the Choose gadget next to Source Image
  408.         Pattern.
  409.  
  410.     Default Destination Directory...
  411.  
  412.         Lets you choose the directory where images are saved to
  413.         by default.  This is the directory that first comes up
  414.         when you click the Choose gadget next to Dest Image
  415.         Pattern.
  416.  
  417.     Default Animation Directory...
  418.  
  419.         Lets you choose the directory where animations are saved
  420.         by default.  This is the directory that first comes up
  421.         when you click the Choose gadget next to Dest Animation.
  422.  
  423.  
  424.  
  425. RUNNING THE PROGRAM FROM CLI
  426.  
  427.     Is a bit more complicated.  Certain features of Rend24 are only
  428.     available from CLI.
  429.  
  430.     Useage from CLI is as follows:
  431.  
  432.         1> Rend24 [options] <input_file> [input_file] ...
  433.  
  434.     The input file(s) must follow the options.  You may specify more
  435.     than one input file on the command line, and each input file may
  436.     contains wildcard characters (standard AmigaDos patterns).
  437.  
  438.     Options consist of a dash (-) followed by a single (case-sensitive!)
  439.     letter.  You may specify more than one option letter after a
  440.     single dash, except options that require an argument; they must be
  441.     separate.  Following is a list of all options currently supported
  442.     in Rend24:
  443.  
  444.         -D          Generate DCTV format images (note that CAPITAL D).
  445.                     Requires dctv.library.
  446.         -6          High Quality ("6-bit") HAM-E mode.
  447.         -aFILE      Pack output files into the given animation file "FILE".
  448.         -c          Call Black Belt's Convert for each input file.  The
  449.                     Convert program must be in your current command
  450.                     path somewhere (ie. your C: directory).
  451.         -d          Enable Floyd-Steinberg dithering.
  452.         -e          Generate HAM-E format images.  Requires hame.library.
  453.         -fNUM       Convert "NUM" input frames.
  454.         -g          Generate greyscale (average) images.
  455.         -h          Generate HAM images.
  456.         -L          Do not add looping frames to animations.
  457.         -l          Generate lumascale (luminence) images.
  458.         -n          Do not pause after converting each image.
  459.         -o[PATTERN] Specify individual output image pattern.  If PATTERN
  460.                     is not given (ie. -o by itself) then each file will
  461.                     be saved to the same directory as the source image
  462.                     with a representative extension.
  463.         -P          Generate a ping-pong animation.
  464.         -p[FILE]    Palette locking.  If "FILE" exists, then a palette
  465.                     is read from it.  If "FILE" does not exist, then
  466.                     the generated palette is saved to it.
  467.         -r          Delete (remove) input files after converting.
  468.         -s          Only generate palette, do not actually render an image.
  469.         -t          Enable NTSC limiting.
  470.         -v          Hide conversion process.
  471.         -w          Wait for input images to appear.
  472.         -X          Double the width of input images.
  473.         -x[WIDTH]   Scale width by half, or to the given pixel width.
  474.         -y[HEIGHT]  Scale height by half, or to the given pixel height.
  475.         -z          Rotate image 90 degrees counter-clockwise.
  476.  
  477.     Note that you do not *have* to specify any outputs at all; if you
  478.     don't then each input file will simply be rendered and viewed.
  479.  
  480.     The arbitrary scaling (-xN and -yN) does not anti-alias (or
  481.     interpolate).  It is meant to be fast.
  482.  
  483.     Rend24 writes standard ILBM palette files that can be read by
  484.     DPaint.  It will also read a standard ILBM palette file.  Thus
  485.     you can save your favorite palette from DPaint and have Rend24
  486.     render all its images using that same palette.
  487.  
  488.  
  489. FILE FORMATS
  490.  
  491.     Rend24 will load most all types of IFF-ILBM images, including
  492.     8- and 24-bit images and standard Amiga resolutions.  The only
  493.     things I know of that it doesn't load are SHAM, Dynamic HAM, and
  494.     Dynamic Hires images.  It should handle images with mask planes.
  495.  
  496.     It will also load Compuserve GIF format images.  It will handle
  497.     interlaced and non-interlaced formats.  For multiple-frame
  498.     GIF's, it will just load the first frame.
  499.  
  500.     And it will also read JPEG images stored in the standard JFIF
  501.     file format (the format used by all Amiga JPEG implementations that
  502.     I know of).
  503.  
  504.     Rend24 reads and write standard IFF-ILBM palette files (ie. a
  505.     BMHD and CMAP, no BODY).
  506.  
  507.     Rend24 writes images in standard IFF-ILBM format suitable for
  508.     viewing with any standard picture viewer, and writes
  509.     animations in standard IFF-ANIM Op 5 format.  It automatically
  510.     creates "looping" frames on the end of any animation it generates,
  511.     unless turned off with No Loop Frames option.
  512.  
  513.  
  514. QUIRKS
  515.  
  516.     Rend24 is not really designed to handle images larger than 768x480.
  517.  
  518.     Since Rend24 uses hame.library for opening and maintaining HAM-E
  519.     screens (it does NOT use renderhame.library!), Rend24 is subject
  520.     to that library's limitations.  The version of hame.library that
  521.     I have does not like to open screens of odd sizes, so you may
  522.     have to scale your images to a "regular" size to get it to work
  523.     right.
  524.  
  525.     Rend24 relies completely on dctv.library for generating DCTV format
  526.     images, so if there are problems with DCTV renderings, it is more
  527.     than likely the fault of dctv.library.
  528.  
  529.  
  530. EXAMPLES
  531.  
  532.     What you've all been waiting for...
  533.  
  534.     These examples assume you are using the front-end.  You'll have to
  535.     interpret a bit if you are using the CLI interface.
  536.  
  537.     Example #1 - Lightwave
  538.     ~~~~~~~~~~~~~~~~~~~~~~
  539.     (Note:  This is based on memory as I don't happen to have a Toaster
  540.     sitting in front of me.  I haven't seen much of Toaster 2.0 either,
  541.     so this could be completely obsolete.)
  542.  
  543.     Suppose you want to convert a 30 frame animation generated with
  544.     Lightwave into a standard Amiga animation.  You might want to do
  545.     this if you A) want to see a color preview of your animation before
  546.     single-framing to tape to save wear and tear on your recorder, or
  547.     B) don't *have* a single-frame recorder.
  548.  
  549.     We will call the animation scene "DollFace".
  550.  
  551.     1.  Go into Lightwave and create a killer 30 frame animation,
  552.         ready for rendering in 768x480 mode.
  553.  
  554.     2.  Go into the "Record" menu, and choose the "Save Images" gadget.
  555.         Save Images will save each frame generated on disk as a standard
  556.         IFF-ILBM file - perfect for Rend24.  Do NOT choose "Save Frames",
  557.         as this saves in FrameStore format which Rend24 cannot read.
  558.         You will be presented with a file requester from which you choose
  559.         the image prefix for the frames generated.  For this example, we
  560.         will choose a prefix of "DollFace" - pick a convenient directory
  561.         (we'll use "Images" in this example) and enter "DollFace" into
  562.         the file gadget.  Each frame generated will now be called
  563.         "DollFaceNNN", where the "NNN" will be replaced with the number
  564.         of the frame.  (Ie. DollFace001, DollFace002, etc.).
  565.  
  566.     3.  Now pop back to Workbench and run Rend24.  When the front-end
  567.         window appears, open the file requester to enter a source
  568.         image pattern (by clicking the Choose gadget next to the
  569.         Source Image Pattern gadget).  Pick the same directory you
  570.         entered in Lightwave ("Images" in our example), and also enter
  571.         the exact same image prefix you entered in Lightwave ("DollFace"
  572.         in our example, without any trailing numbers).  So the result
  573.         in the Source Image Pattern gadget should look something like
  574.         "DH3:Toaster/3D/Images/DollFace".
  575.  
  576.     4.  Since the animation will be 30 frames, enter the number 30 into
  577.         the Source Frame Count gadget.  This tells Rend24 to append
  578.         001 - 030 to the source image pattern given above to get the
  579.         name of each file to load, exactly like Lightwave does.
  580.  
  581.     5.  Now choose the filename of your destination animation.  For
  582.         our example, we will simply save it to RAM:.  You will probably
  583.         want to save the result to somewhere on your hard drive.
  584.         Open the file requester (by clicking on Choose next to the
  585.         Dest Animation gadget), and enter your output filename.  For
  586.         our example, we'll use "RAM:DollFace.anim".
  587.  
  588.     6.  Now decide on your animation image format.  In this example,
  589.         we'll keep things simple and just render to Amiga HAM mode.
  590.         Click the Image Format cycler gagdet until it reads "HAM Image".
  591.  
  592.     7.  Decide on your conversion options.  If you plan to be loading
  593.         this animation into DPaint, you should choose the "Lock Palette"
  594.         option to keep the palette the same for all frames.  A HAM image
  595.         needs to be lores (< 384 pixels wide) so we need to turn on the
  596.         "Halve Width" option to reduce the width of Lightwave's hires
  597.         images down to lores.  If you don't want interlace images
  598.         (desirable to make the animation run faster and reduce conversion
  599.         times), click on the "Halve Height" button as well.  If you want
  600.         to delete the files that Lightwave generates from disk as Rend24
  601.         finishes converting them, choose the "Delete Source's" checkbox.
  602.         This will save a lot of hard drive space, but make it impossible
  603.         to redo the conversion process if something goes wrong.  If you
  604.         don't want Rend24 to show each frame as it's converting (probably
  605.         desirable in this case), check the "Hide Conversion" gadget.  You
  606.         will definitely want to check the "Don't Pause" gadget to make
  607.         Rend24 not wait for a mouse click after each frame is converted.
  608.         And you DEFINITELY want to check the "Wait for Source's" gadget
  609.         as this will make Rend24 sit around in the background waiting
  610.         for Lightwave to generate each frame.
  611.  
  612.     8.  Now that everything is setup, click the "Begin Conversion" gadget
  613.         in Rend24.  It will open it's status window and say that it is
  614.         waiting for "DollFace001".
  615.  
  616.     9.  Now pop back to Lightwave and tell it to begin rendering.  As
  617.         Lightwave finishes rendering each frame, Rend24 will kick in,
  618.         convert the image to HAM, pack it into the destination
  619.         animation, and then go back to sleep waiting for the next frame.
  620.         When all the frames are finished, Rend24 will build looping
  621.         frames on the end of the animation, and you can then show
  622.         the animation ("RAM:DollFace.anim" in our example) with your
  623.         favorite animation viewing program.
  624.  
  625.  
  626. THE AUTHOR AND ACKS
  627.  
  628.      I can be reached at the following U.S. Mail address:
  629.  
  630.           Thomas Krehbiel
  631.           10747 Surry Road
  632.           Chester, VA  23831
  633.  
  634.      This is where you want to send your donations.
  635.  
  636.      If you have a modem and don't mind calling long-distance, I can
  637.      also be reached on the Late Nite Amiga BBS (804-262-9944) as Tom
  638.      Krehbiel (user #13).  Note that in older versions of Rend24
  639.      documentation I got the Late Nite phone number wrong (oops).
  640.  
  641.      And at long last I now have an account on BIX, so you can bixmail
  642.      me as "tkrehbiel".
  643.  
  644.      BTW, I much prefer E-mail to regular mail... and I really don't
  645.      have the time to give phone support (sorry!).
  646.  
  647.      Thanks to the following people for helping to make this program
  648.      like you now see it:
  649.  
  650.           Kermit Woodall . . . . .  Promotion/Research/Testing
  651.           Mike Vunck . . . . . . . . . . . . Promotion/Testing
  652.           Bob Fisher . . . . . . . . . . . . . . . . . Testing
  653.           Stuart Ragland . . . . . . . . . . . . . . . Testing
  654.  
  655.           (And everyone else in the Late Nite Developer sub.)
  656.  
  657.      Thanks to Mike Vunck for the spiffy icon!
  658.  
  659.  
  660. REVISION HISTORY (for the curious)
  661.  
  662.      1.04f     Added Double Width option for DCTV fanatics.
  663.      Release   Added option to make Ping-Pong animation from numbered frames.
  664.      3/14/92   Added option to not tack on looping frames to animations.
  665.                Revised front-end to include new options.
  666.  
  667.      1.04e     Pads odd length DLTA chunks for !#$!@#$ buggy DPaint.
  668.      Beta      Fixed CMAP chunk lengths for (once again) DPaint.
  669.      3/8/92
  670.  
  671.      1.04d     Will now load GIF images directly.
  672.      Beta      Will now load JPEG images directly (if somewhat slowly).
  673.      2/28/92   Now returns to front end after Aborting an operation.
  674.                New documentation!  Better?  Good question...
  675.                No longer detaches from CLI for better script handling.
  676.  
  677.      1.04c     Clicking Close gadget while waiting no longer exits.
  678.      Beta      Refreshes screen properly under 2.0 after a Zoom.
  679.      11/15/91  Can scale images to any arbitrary width and height.
  680.                Now reads and writes standard IFF ILBM palette files.
  681.                Fixed an occasional massive crashing bug in ILBM saving.
  682.                Fixed scaling settings being "forgotten" over multiple files.
  683.  
  684.      1.04b     Now detaches from the CLI; don't have to Run it anymore.
  685.      Beta      No longer opens a console when run from Workbench.
  686.      11/10/91  Closes front-end window while doing conversions.
  687.                A nifty iconify feature added for Workbench 2.04.
  688.  
  689.      1.04a     Fixed a couple of bugs in animation creation.
  690.      Beta
  691.      11/9/91
  692.  
  693.      1.04      Now includes a built-in Front End, runnable from Workbench.
  694.      Beta      (Drumroll, please)... now generates DCTV images!
  695.      11/7/91
  696.  
  697.      1.03      Compiled with the SAS/C Global Optimizer.
  698.      Reg Only  Now includes a version compiled for 68020/68030 machines.
  699.      10/22/91  Now loads standard IFF images and converts to 24-bit.
  700.                Fixed some Enforcer hits and "free non-tracked" messages.
  701.                Can now click on Rendered screen to continue.
  702.  
  703.      1.02      Now handles odd width images correctly (I hope).
  704.      Release   Fixed numerous Enforcer hits during loading (oops).
  705.      7/11/91
  706.  
  707.      1.01      Fixed a bug in IFF24 loader code.
  708.      Release   Fixed bug in the WaitFor routines.
  709.      6/3/91    Now loads ADPro 8-bit greyscale images.
  710.  
  711.      1.00      First public release.
  712.      Release   Now includes `RendFE.rexx' front-end program.
  713.      5/18/91   Fixed trying to add loop frames to non-existant ANIMs.
  714.  
  715.      0.18      No longer clobbers numeric filename extensions.
  716.      Beta      Recognizes ^C again to abort for compatibility.
  717.      5/16/91   Added dither "threshold" control for Color renders.
  718.  
  719.      0.17      Fixed scaling "forgetfulness" over multiple files.
  720.      Beta      HAM rendering significantly faster.
  721.      5/14/91   Better overscan display (I hope).
  722.                Nice little output window with status bar.
  723.                Loop frames now tacked onto end of animations created.
  724.                Added 90 degree counter-clockwise rotation option `-z'.
  725.  
  726.      0.16      Recompiled with SAS/C 5.10.
  727.      Alpha     Now requires `hame.library' for HAM-E rendering.
  728.      5/8/91    Much faster IFF24 loading; as fast as ADPro now.
  729.                Wildcarding rewritten; requires Arp under 1.3.
  730.                Added `-t' for NTSC Limiting.
  731.                Beginnings of better documentation.
  732.                Generally faster rendering times, especially greyscale.
  733.                Can now scale image height in half with `-y' option.
  734.                Scaling now a seperate operation from the rendering.
  735.                Significantly faster rendering under 2.0.
  736.                Loader will handle anywhere from 9- to 24-bit images.
  737.  
  738.      0.15      Palette save/load now functional.
  739.      Alpha     Fixed memory leak in ANIM compression.
  740.      4/9/91
  741.  
  742.      0.14      Fixed Hame reg mode color wrongness.
  743.      Alpha     Now overscans picture under 1.3, too.
  744.      4/5/91    Now alphabetizes wildcarded input files.
  745.  
  746.      0.13      Color palette selection rewritten.  Less redundancy.
  747.      Alpha     Now takes scaling into account when building histogram.
  748.      4/5/91    Histogram (unfortunately) noticeably slower.
  749.                But palette selection is faster and uses less memory.
  750.                Fixed left-edge-HAM-fringe-in-non-dithered problem.
  751.                Definitely a speed decrease here.
  752.  
  753.      0.12      Fixed phantom palette load/save problem.
  754.      Alpha     I think I fixed the death on out of memory during load.
  755.      4/2/91    Fixed small memory leak problem.
  756.                Pads width of input images to a byte boundary.
  757.                Slight speed increase in non-HAM, especially dithered.
  758.  
  759.      0.11      Fixed bug in -hx mode.
  760.      Alpha     New `-a' animation packer option.
  761.      3/30/91   New `-f' for specifying Lightwave frames.
  762.                New palette locking method with `-p' option.
  763.  
  764.      0.10      Added `@' input script file option.
  765.      Alpha     Now overscans Hame cookie and palette lines if it can.
  766.      3/27/91   Added `-w' to wait for input files to appear.
  767.                Added `-r' option to remove input files when done.
  768.                Hides screen while saving for those of us with 2090's.
  769.  
  770.      0.09      Grey24, Color24, and Ham24 consolidated into Render24.
  771.      Alpha     Command line options changed somewhat.
  772.      3/26/91   Better output file pattern parsing (eg: -oPics/*.reg).
  773.  
  774.      0.08      Fixed occasional after-save guru.
  775.      Alpha     Supports uncompressed IFF24's now (I think).
  776.      3/26/91   ^C will break a rendering in progress (hurray!).
  777.                Clean Hame ham mode support!
  778.  
  779.      0.07      Does not use Hame color register 0 at all.
  780.      Alpha     Hame ham support added, but looks terrible.
  781.      3/26/91
  782.  
  783.      0.06      Makes FORM length even for DPaint's mangled-IFF bug.
  784.      Alpha     Only deletes Convert temp file AFTER image is rendered.
  785.      3/24/91   Initial HAM rendering -- slow, no Hame.
  786.  
  787.      0.05      Fixed all-black-horizontal-line-turning-off-Hame problem.
  788.      Alpha     Allows Unix-style wildcard input pattern.
  789.      3/23/91   Added Kermit's kludge to call BB's Convert on input files.
  790.                Color rendering 1x-3x faster non-dithered.
  791.  
  792.      0.04      Color rendering about 4x faster non-dithered.
  793.      Alpha
  794.      3/22/91
  795.  
  796.      0.03      Initial color rendering -- VERY slow.
  797.      Alpha
  798.      3/21/91
  799.  
  800.      0.02      Initial REAL greyscale rendering.
  801.      Alpha     Added option to save resulting image.
  802.      3/20/91
  803.  
  804.      0.01      Experimental greyscale rendering.
  805.      Alpha
  806.      3/19/91
  807.  
  808.