home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / raytrace / dkb / dkbutdoc.zoo / splitdkb.doc < prev    next >
Encoding:
Text File  |  1991-06-09  |  5.5 KB  |  121 lines
  1. SPLITDKB.EXE Version 1.0
  2. By Dan Farmer March 10, '91
  3.  
  4. HISTORY:
  5.     The concept for this program came from Randy Antler, who created a
  6.     batchfile named PARTS.BAT to do the same job as this program does.
  7.     The limitation I ran into, however, was that I was constantly re-editing
  8.     copies of PARTS.BAT into 3PART.BAT and 4PART.BAT, and re-calculating the
  9.     starting and ending lines for the various formats I wanted to render, etc.
  10.  
  11.     SPLITDKB yields the same results as PARTS.BAT, except that it allows
  12.     you to custom tailor the resulting batch files easily.
  13.  
  14. HOW IT WORKS:
  15.         SPLITDKB creates batch files.  It will create a batch file for
  16.         each portion of the split, named PART1.BAT, PART2.BAT, etc.
  17.         It also creates a batch file named GLUE.BAT that uses GLUETGA.EXE
  18.         (came with your DKB stuff) to put Humpty-Dumpty back together again,
  19.         and runs a processing batch file that you provide. (more on that later.)
  20.  
  21. COMMAND LINE:
  22.         An input filename is mandatory.  Extension is optional, with .DAT
  23.         assumed if none is specified.  You can also override the default
  24.         switches by specifiying them FOLLOWING the input filename.
  25.  
  26.         The switches specified by default are: dkbno87 -p -a -v +d.
  27.         These switches
  28.            run the no87 version of dkb,
  29.            do not pause when finished
  30.            have no anti-aliasing
  31.            suppress line numbers
  32.            display the image during processing.
  33.  
  34.         NOTE: This is a simple program: ANY SWITCH ON THE COMMAND LINE
  35.         WILL CAUSE THE PROGRAM TO DROP ALL DEFAULT SWITCHES, including
  36.         the name of the DKB program to run!!  Your switch list MUST
  37.         include the name of your DKB executeable! (Screen resolution
  38.         is not considered a command line switch in this document.  The
  39.         are provided by user input from within the program.)
  40.  
  41.         A convenient way to run SPLITDKB with a different set of switches
  42.         would be with a batch file like the following:
  43.  
  44.         RUNSPLIT.BAT
  45.             @echo off
  46.             splitdkb %1 dkb [your list of preferred switches]
  47.  
  48.  
  49. ENVIRONMENT VARIABLES:
  50.         There are two environment variables that can optionally be
  51.         set before running (or by a batch file that runs SPLITDKB).
  52.  
  53.         The first is the path to the directory holding your input .DAT file.
  54.         If your data file is not in the current directory (the one holding
  55.         SPLITDKB), then you must SET DATA=data directory (SET DATA=C:\DKB\DATA)
  56.         DO NOT INCLUDE A TRAILING BACKSLASH! (The program will put it in where
  57.         its needed)
  58.  
  59.         The second is the path to the directory to put the output .TGA files.
  60.         This is also where you need to keep the progam GLUETGA.EXE and
  61.         a batch file named PROCESS.BAT that will do the image conversion.
  62.         More about PROCESS.BAT later...
  63.         So, to send the output to another directory, SET GLUE=glue directory.
  64.         (SET GLUE=D:\GLUE)
  65.         Again, DO NOT INCLUDE A TRAILING BACKSLASH! (The program will put it
  66.         in where its needed)
  67.  
  68. PROCESS.BAT:
  69.         Whether you chose to use a separate GLUE directory, or just dump
  70.         everything into the current directory, you should have a batch file
  71.         called PROCESS.BAT in the SAME DIRECTORY AS GLUETGA.EXE.  This batch
  72.         file should accept one, and only one parameter: the root name of the
  73.         original DKB data file.  It should call whatever program(s) you use
  74.         to process the .TGA image into a .GIF image, whether that be PICLAB
  75.         or TGA2IMG/IMG2GIF or whatever.  If you wish to skip this step, then
  76.         before running any of the PARTn.BATs, edit GLUE.BAT to remove the
  77.         call to PROCESS.BAT.
  78.         Here is my own PROCESS.BAT using the TGA2IMG/IMG2GIF combination:
  79.  
  80.             @echo off
  81.             :loop
  82.                 if "%1"=="" goto end
  83.                 tga2img %1
  84.                 img2gif -d -m %1
  85.                 del %1.img
  86.                 shift
  87.                 goto loop
  88.             :end
  89.  
  90. --------------------------------------------------------------------------------
  91. CREDITS:
  92.     DKB is a ray tracing program written by David K. Buck and Aaron A Collins.
  93.     PICLAB is an image processing program written by the Stone Soup Group.
  94.     TGA2IMG.EXE is an image conversion program written by myself.
  95.     IMG2GIF is a program written by Stephen B. Coy, provided with his
  96.     ray tracing program, "VIVID".
  97.  
  98. NOTE:
  99.     If anyone knows enough about other (non-DOS) operating systems to
  100.     write a portable version of this program in C, please go for it.
  101.     I hold no claims on the rights to this program.  It is fully
  102.     released to the public domain.
  103.  
  104.  
  105. CHANGES IN SPLITDKB SINCE INITIAL RELEASE TO BBS ( Mar 10, '91)
  106. -------------------------------------------------
  107. - Convert commandline switches to lower case.
  108. - Re-calc default columns after row has been entered. (rows * 0.625)
  109. - Put a beep at the end of GLUE.BAT to signal completion.
  110. - The GLUE.BAT WAIT idea only works if using a separate GLUE directory.
  111.   Otherwise, the .tga files DO exist, they just haven't been released yet.
  112. - Limit splits to 9 or risk overflow on the PRINT USING's.
  113. - If only 1 part, skip call to GLUETGA and simply rename it to ROOT$+".TGA"
  114. - Delete PART?.TGA when finished.
  115. - RUNSPLIT.BAT included.  First commandline parm is filename, rest are
  116.   substituted.  RUNSPLIT filename %2 %3 %4, etc.
  117.   An example would be: RUNSPLIT MYFILE -q0
  118. - OOPS! Had rows & cols reversed in original code!
  119. - Default # of parts is now 1.
  120. - LZEXE the executeable for smaller size.
  121.