home *** CD-ROM | disk | FTP | other *** search
/ Computerworld 1996 March / Computerworld_1996-03_cd.bin / idg_cd3 / grafika / fraktaly / fractxtr / other / partob31.txt < prev    next >
Encoding:
Text File  |  1994-09-16  |  7.2 KB  |  202 lines
  1.  
  2.  PARtoBAT                                        Version 3.1 / September 1994
  3.  
  4.    written by Michael Peters [CIS 100041,247] [Internet mpe@hop.dinoco.de]
  5.    Copyright (C) 1992-94 The Stone Soup Group
  6.  
  7.  PARtoBAT generates batch files from FractInt PAR files.
  8.  
  9.  This program is freeware. It may be freely copied and distributed but
  10.  may not be sold.
  11.  
  12.  
  13.  ┌────────────────┐
  14.  │ Change history │
  15.  └────────────────┘
  16.  
  17.    2.1 introduced code names for GIF files
  18.        (Suggestion by Jon Horner)
  19.    2.2 checks Fractint errorlevel, plus: If the video mode is not specified,
  20.        it can now be entered on the batch command line.
  21.        (Suggestions by Timothy Wegner)
  22.    3.0 this version features some more ideas by Tim (and some of my own).
  23.        Batches now quits with errorlevel 2 (for Fractint v. 18 and above,
  24.          has no effect if earlier versions are used)
  25.        PAR files shown in alphabetical order
  26.        Wildcard support, creates Newpars.Bat, reads SSTOOLS.INI
  27.        Indirect @ files can be read (suggestion by Nelson Hinman)
  28.    3.1 ignores {comments} and can handle very large PAR files.
  29.        (Update suggestion by Timothy Wegner.)
  30.        For technical reasons, the PAR filename display is now no longer
  31.        sorted by PARtoBAT itself but utilizes the MS-DOS external SORT
  32.        command (SORT.EXE must be in the path for this reason).
  33.        PARtoBAT becomes a Stone Soup Group program with 3.1.
  34.  
  35.  
  36.  
  37.  ┌────────┐
  38.  │ Syntax │
  39.  └────────┘
  40.  
  41.   PARtoBAT [o[+|-]] [PAR files] [VIDEO=<mode>] [CODENAME=xxxxx[nnn]] [parms]
  42.  
  43.   where
  44.     [-o[+|-]]             = Overwrite or don't overwrite existing batch files.
  45.                             Enter -o or -o+ to enable overwrite,
  46.                             -o- to disable overwrite.
  47.     [PAR files]           = a Fractint .PAR filename (wildcards allowed).
  48.                             An indirect filename (a file containing PAR
  49.                             filenames, see below) can be entered instead.
  50.     [VIDEO=mode]          = specify a Fractint video mode here
  51.     [CODENAME=xxxxx[nnn]] = a codename for GIF files (see below)
  52.     [parms]               = any number of other Fractint startup parameters
  53.  
  54.   e.g. PARtoBAT -o+ M*.PAR VIDEO=SF7 CODENAME=WOW027 SOUND=ON HERTZ=440
  55.  
  56.  
  57.   PARtoBAT started without parms will prompt for the corresponding values
  58.     unless they are specified in SSTOOLS.INI (see below).
  59.  
  60.  
  61.   NOTE: In PARtoBAT version 1 and 2, the video mode could be entered without
  62.         a leading 'VIDEO='. This is no longer possible - you now have to add
  63.         the 'VIDEO=', e.g. VIDEO=SF7.
  64.  
  65.  ┌─────────────────────┐
  66.  │ SSTOOLS.INI support │
  67.  └─────────────────────┘
  68.  
  69.   PARtoBAT default values can be put into the Fractint file SSTOOLS.INI
  70.   (a description for SSTOOLS.INI is contained in Fractint). You need to
  71.   specify a [PARtoBAT] section in SSTOOLS.INI. Other sections will be
  72.   ignored by PARtoBAT.
  73.  
  74.   One of the following parameter values can be put into SSTOOLS.INI:
  75.  
  76.      BATCHOVERWRITE=yes|no  = default value for batch overwrite
  77.      VIDEO=mode             = specify a Fractint video mode here
  78.      CODENAME=xxxxx[nnn]    = a codename for GIF files (see below)
  79.  
  80.   and any other default parameters for Fractint, like
  81.      SOUND=ON
  82.      HERTZ=440
  83.   etc.
  84.  
  85.  
  86.   If overwrite, videomode, or codename are specified in the command line,
  87.   this will override the defaults from SSTOOLS.INI.
  88.  
  89.   If overwrite is not specified in SSTOOLS.INI or in the command line, and
  90.   batch files for the specified PAR files are found, PARtoBAT will ask you
  91.   if they can be overwritten.
  92.  
  93.   If the videomode is neither specified in SSTOOLS.INI nor in the command
  94.   line, PARtoBAT will ask for it.
  95.  
  96.   If no codename was specified in SSTOOLS.INI or in the command line,
  97.   PARtoBAT will ask for one *only when it is called without parameters*
  98.   in the command line, that is, if you enter PARtoBAT on the C> prompt.
  99.  
  100.  
  101.  ┌──────────┐
  102.  │ Filename │
  103.  └──────────┘
  104.  
  105.   You have to specify the name of the PAR file (wildcards can be used).
  106.   The PAR files must be located in the current directory.
  107.   Instead of a PAR filename, you can also enter an indirect filename,
  108.   that is, the name of a file that contains PAR filenames (one per line).
  109.   If you do this, use a @ to indicate the indirect filename, e.g.
  110.  
  111.     PARtoBAT @Indirect.Txt
  112.  
  113.   instead of
  114.  
  115.     PARtoBAT X*.PAR
  116.  
  117.  
  118.  ┌────────────────────────────────┐
  119.  │ Overwrite existing batch files │
  120.  └────────────────────────────────┘
  121.  
  122.   If no overwrite option was entered on the command line or in SSTOOLS.INI
  123.   and batch files for the PAR files are found, PARtoBAT will ask you if
  124.   the batch files can be overwritten.
  125.  
  126.  
  127.  ┌────────────┐
  128.  │ Video mode │
  129.  └────────────┘
  130.  
  131.   Enter a Fractint video mode (PARtoBAT does not check if the video mode
  132.   you specify is valid) in SSTOOLS.INI or on the command line (in the
  133.   format VIDEO=<mode> ), or on the PARtoBAT prompt.
  134.  
  135.   The video mode can be left empty. In this case, it will be included
  136.   in the batch file as a %1 batch parameter: You have to specify the video
  137.   mode as a command line parameter when you run the batchfile.
  138.  
  139.  
  140.  ┌─────────────────────────────┐
  141.  │ Optional startup parameters │
  142.  └─────────────────────────────┘
  143.  
  144.   Enter any number of optional startup parameters for Fractint (e.g.
  145.   SOUND=OFF SAVETIME=60 etc.) in SSTOOLS.INI, on the command line,
  146.   or on the PARtoBAT prompt. Anything not recognized by PARtoBAT, e.g.
  147.  
  148.     BLAH=BLAH
  149.     ABCDEFGHIJKLM
  150.  
  151.   will be transferred to the batch command and to Fractint.
  152.  
  153.  
  154.  ┌───────────────┐
  155.  │ GIF code name │
  156.  └───────────────┘
  157.  
  158.   Each fractal in the PAR file has been given a name already. The
  159.   corresponding GIF file will be named like in the PAR file. Alternatively
  160.   you may specify a code name for the GIF files in this file. The new GIF
  161.   files will be given this code name plus a 3-digit number (Code name EXAMP
  162.   will produce the GIF names EXAMP001.GIF, EXAMP002.GIF etc.). If the
  163.   specified code name already contains a 3-digit number, the new GIF files
  164.   will start counting from there.
  165.  
  166.   If GIF files with the code name exist, the numbers will automatically
  167.   increment from there.
  168.  
  169.   Maximum length for the code name (without trailing digits) is 5
  170.   characters.
  171.  
  172.   If no code name is specified, the default names are used for the GIF
  173.   files.
  174.  
  175.  
  176.  ┌─────────────────┐
  177.  │ The batch files │
  178.  └─────────────────┘
  179.  
  180.   Each batch line containing a Fractint call is followed by an errorlevel
  181.   check (errorlevel 2). If Fractint is aborted during the batch, the batch
  182.   execution will stop.
  183.  
  184.   For each GIF file that already exists, the corresponding command line
  185.   will be disabled by a 'rem'. This means that you can interrupt a PARtoBAT
  186.   generated batch file anytime, and start it again later. Before you start
  187.   it again, just run PARtoBAT (with overwrite enabled) to recreate the
  188.   batch file. While creating the batch file, the lines that refer to GIF
  189.   files which already exist will be disabled.
  190.  
  191.   If you use wildcards when specifying the PAR files, and more than one
  192.   batch file is created by PARtoBAT, an additional batch file will be
  193.   written (NEWPARS.BAT). This batch can be run to execute all new batch
  194.   files at once.
  195.  
  196.  
  197.  
  198.   Michael Peters
  199.   CIS 100041,247
  200.   mpe@hop.dinoco.de
  201.  
  202.