home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / f / fracxtr4.zip / FBAT102.ZIP / FRACBAT.DOC next >
Text File  |  1993-02-21  |  28KB  |  734 lines
  1. ----------------------------------------------------------
  2.  F R A C B A T  1.02  DOCUMENTATION     1992        page 1
  3. ===========================================================
  4.      by Jussi Kantola / The Three Relaxed Byte-Biters
  5. -----------------------------------------------------------
  6.  
  7.                    FRACBAT.DOC :
  8.                                            page
  9.    What's FracBat?........................  1
  10.    New in version 1.01 & 1.02.............  2
  11.    Usage.................................. 3- 4
  12.    Commandline-options.................... 5- 6
  13.    SSTOOLS.INI-options.................... 7-10
  14.    Menu...................................  11
  15.    Results................................  12
  16.    Examples of configuration..............  13
  17.    Future, contacts and hello's...........  14
  18. -----------------------------------------------------------
  19.  
  20.                   What's FracBat?
  21.  
  22.     FracBat is a simple and fast program to create
  23.     batches from FractInt's parameter files. FracBat
  24.     reads the parameter file to get the name of each
  25.     parameter, adds the configured functions and then
  26.     writes the collected data to a batch.
  27.  
  28.     I did this becoz I found it rather boring to first
  29.     <b>atch from FractInt, then edit the parameterfile
  30.     for possible functions, then create the batch (this
  31.     was the worst part, yuck, all that '@filename/
  32.     parameter batch=yes'. It ain't fun, even with
  33.     Q-edit!) and finally run it just to see that I made
  34.     a mistake somewhere.  What I needed, was a program
  35.     that would just create the batch-entries with the
  36.     information from parameter-file, and maybe add some
  37.     neat functions, configured beforehand.
  38.  
  39.     I got what I wanted.  FracBat gives You a change to
  40.     make a batch of 100 fractals in a few seconds (on
  41.     XT!) - still, the output .GIF's are named after the
  42.     name of the parameter that's batched!  (In fact,
  43.     this will run toooooooo fast with AT's -- You
  44.     propably won't see much of what FracBat tells..)
  45.  
  46.     This version is 1.02. It has a little bugfix, and a
  47.     significant improvement in commandline parameters-
  48.     handling : a few more options, and there can be as
  49.     much of them as You want to, on one line!  Why not
  50.     try something like Fracbat /A- /C /PARNAME /ADD /SU
  51.     /R par.par bat.bat, and have no sstools at all!
  52.     (No, really, SSTOOLS is pure metal, commandline-
  53.     options are only switces to do something in a
  54.     different way with some particular batch!)
  55.  
  56.     This documentation has a page length of 60.
  57.  
  58. -----------------------------------------------------------
  59.  F R A C B A T   1.01 DOCUMENTATION                 page 2
  60. ===========================================================
  61.                New in version 1.01 & 1.02
  62.                ==========================
  63.  
  64.     - Commandline-operationing is fully fixed!  You may
  65.       now use as many options from commandline as You
  66.       want to!  (Most of which are useless, if
  67.       SSTOOLS.INI is well done ... )
  68.  
  69.     - New options :
  70.       -----------
  71.        ASK=YES/NO
  72.        (commandline : /ASK)
  73.  
  74.        Forces FracBat to ask with _every_ parameter, if
  75.        it's to be batched.
  76.        --------
  77.        SKIPQUES=NOGIF
  78.        (commandline : /SN)
  79.  
  80.        If not exists [parname].GIF then batch the
  81.        parameter, even if parameter in FRACBAT.DUN
  82.        -- no questions.
  83.  
  84.        Also changed SKIPQUES=DISBATCH > SKIPQUES=UNBATCH
  85.        (commandline : /SU)
  86.        That ain't much better than the original form, but..
  87.        If You've gotta good word to describe the unbatch-
  88.        option, please, don't be quiet!  (NoBatch stinks,
  89.        don't even try with that :-D)
  90.        --------
  91.        BAT=APPEND/REWRITE
  92.        (commandline : /ADD[-])
  93.  
  94.        Controls if FracBat should append to
  95.        existing batch instead of rewriting a new.
  96.        Really, *really* weird, if set to APPEND in
  97.        sstools, but it's now possible anyway!
  98.  
  99.        --------
  100.        New commandline options :
  101.        /A-      ... ADDUN=NO
  102.        /ADD [-] ... BAT=REWRITE
  103.        /C-      ... CHKDUN=NO
  104.        /R       ... RESUMEIFEXIST=YES
  105.        /R-      ... RESUMEIFEXIST=NO
  106.        /PARNAME ... SAVENAME=[parname]
  107.        /PLAIN   ... fractint @parfile/[parname] batch=yes
  108.        /MENU    ... Tag parameters from menu
  109.        /VIDEO [m] ... Use [m] as a videomode
  110.  
  111.        So, as You may see, few options now have the
  112.        negative meaning, if you specifie '-' with them.
  113.        Why?  For some reason with some particular
  114.        batch You may not want FracBat to CHKDUN - using
  115.        /C- You don't have to edit sstools.ini!
  116.  
  117.     - Fixes several bugs, adds helpscreen (if no
  118.       parameters to FracBat are given).
  119.  
  120. -----------------------------------------------------------
  121.  F R A C B A T   1.01 DOCUMENTATION                 page 3
  122. ===========================================================
  123.  
  124.                        Usage
  125.  
  126.     Using FracBat is fairly simple.  First You've got
  127.     to create a parameter file.  You do that from
  128.     FractInt - just select the fractal-type or Zoom
  129.     You'd like to see, hit <b>atch and give FractInt
  130.     the data it wants to add the parameters of that
  131.     fractal into the file You just defined.  Example
  132.     (This happends in FractInt) :
  133.  
  134.          Select [mandel] for fractal-<t>ype start
  135.          counting, hit <b>. To filename, give
  136.          'MYPARAM.PAR', for example. Name that
  137.          particular entry as 'MYFIRSTPARAM', and give
  138.          it the comments You want to. When ready,
  139.          strike <enter> to save data.
  140.  
  141.     You may add as much of parameters to 'MYPARAM.PAR'
  142.     as You want to - just remember to give a different
  143.     name to all of those.
  144.  
  145.     After the parameter file is created, You've got to
  146.     edit Your SSTOOLS.INI -file.  If You don't have
  147.     one, well, make it QUICK!  It's really nize file,
  148.     let's You avoid all the boring video-mode
  149.     selections and such during the startup!  Read
  150.     FractInt's documentation for more info about it.
  151.     Now all You've have to do, is to define a label for
  152.     FracBat, and THAT is simple.  Add the line
  153.  
  154.     [fracbat]
  155.  
  156.     somewhere into SSTOOLS.INI -- not in the middle of
  157.     some other programs section anyway.  So, if You've
  158.     already the [fractint] label and options defined
  159.     under it, place [fracbat] after those options.
  160.     After [fracbat] You define the options You want
  161.     fracbat to use.  Options are listed here, and
  162.     explained later in the document :
  163.  
  164.     MAP=        MAXITER=          SAVENAME=  CHKDUN=
  165.     SAVETIME=   RESUMEIFEXIST=    VIDEO=     ADDUN=
  166.     SKIPQUES=   ASK=              BAT=
  167.  
  168.     The following rules are given :
  169.             - Leave _NO_ space between the option-label
  170.               and equals-sign.  Also do NOT leave a
  171.               space between equals-sign and the
  172.               definition.
  173.  
  174.             - everything after one empty char, e.g.
  175.               'one <space>' is comment, though You may
  176.               (and I do) add the ; after that space,
  177.               just to keep things clear.
  178.  
  179.  
  180. -----------------------------------------------------------
  181.  F R A C B A T   1.01 DOCUMENTATION                 page 4
  182. ===========================================================
  183.  
  184.     That was the SSTOOLS.INI.  Executing of FracBat
  185.     still remains unexplained.
  186.  
  187.     FracBat includes a neat option to make batches to
  188.     'know' if some parameter is counted once already.
  189.     That way is the file FRACBAT.DUN, which FracBat
  190.     will create on its first run, or whenever it is
  191.     missing. FRACBAT.DUN has information in this
  192.     format :
  193.  
  194.     parameter=[parname]
  195.  
  196.     Now, if You've defined the option CHKDUN=YES at
  197.     SSTOOLS.INI, FracBat will search for each batched
  198.     parameter from FRACBAT.DUN, before it writes the
  199.     parameter into .bat.
  200.  
  201.     IF the parameter of the same name that is to be
  202.     batched is found, FracBat will tell this and ask,
  203.     if You'd like to batch that parameter anyway; the
  204.     batch entry will now seem the way it 'normally'
  205.     seems - no functions to resume any files are
  206.     written. IF the parameter in parfile and
  207.     FRACBAT.DUN do match, AND there exists a
  208.     [parname].GIF, FracBat will again inform You about
  209.     it, and ask if You'd like to batch that entry; if
  210.     so, the batch entry will now be a resuming-entry,
  211.     i.e. FracBat will force FractInt to resume that
  212.     existing [parname].gif, no matter if it is actually
  213.     finished.
  214.  
  215.     All the questionning can be passed with option
  216.     SKIPQUES=BATCH/DISPATCH/NOGIF or commandline
  217.     /SB, /SU, /SG.  See part SKIPQUES, page 10,
  218.     and commandline-options, page 5.
  219.  
  220.     How are the entries in FRACBAT.DUN created, then?
  221.     There are two ways.  If You configure SSTOOLS.INI
  222.     with entry ADDUN=YES, FracBat will write an entry
  223.     'FracBat /D parameter' after EVERY actual
  224.     batch-line.  Another way is to run FractInt with
  225.     parameter '/A', which is the commandline equivalent
  226.     for ADDUN=YES.  You may, of course, make some
  227.     parameter 'dun' just by running 'fracbat /d parameter'.
  228.  
  229.     NOTE : FRACBAT.DUN should not be longer than 1000
  230.            lines. The lines over 1000 are handled as
  231.            lines over 0; You don't understand that, I
  232.            guess.  See, line 1001 is in fact line 1 ->
  233.            1001 overwrites the data of line 1, but only
  234.            in Your compu's memory -- FracBat.dun stays
  235.            the same.  You may wonder why is this so,
  236.            but ho-ho, I let You wonder and just believe
  237.            that's the best way to do.  You may always
  238.            Q-edit the 'waste' lines off fracbat.dun.
  239.  
  240.  
  241. -----------------------------------------------------------
  242. F R A C B A T   1.01 DOCUMENTATION                  page 5
  243. ===========================================================
  244.  
  245.     Short and clear :
  246.     FRACBAT.DUN + ADDUN=YES + CHKDUN=YES, those
  247.     together give you a *great* ability of using only
  248.     two, or even ONE parameterfile / batchfile.  One
  249.     for testing and another for saving the _real_
  250.     beauties.  Only one for testing?  Hell, of course
  251.     that's possible, because FracBat doesn't batch all
  252.     the old parameters as well, if You don't want so!
  253.  
  254.     Then, finally, for the usage itself :
  255.  
  256.     FRACBAT [options][-] parfile.ext batfile.ext
  257.  
  258.     [-]         ... Some parameters have an optional
  259.                     negative-switch :  -
  260.     parfile.ext ... File that has the parameters-data
  261.     batfile.ext ... File the batch will be written
  262.                     into
  263.  
  264.     Commandline-options are :
  265.  
  266.     /A[-]
  267.         ... to add 'FracBat /D parameter' after every actual
  268.             batchstring (useless, if You're smart enough to
  269.             put ADDUN=YES into SSTOOLS.INI) (but /A-
  270.             usable then, sometimes)
  271.  
  272.     /ADD[-]
  273.         ... Forces FracBat to append into the batfile,
  274.             not rewrite it.  The batfile must exist!
  275.             Handy, when writing batch of multiple
  276.             parameter files.  /ADD- forces FB to create
  277.             a new batch, if BAT=APPEND in SSTOOLS.INI
  278.  
  279.     /ASK... Forces FracBat to ask with _every_ parameter
  280.             if it's to be batched.
  281.  
  282.     /C[-]
  283.         ... to switch CHKDUN ON.  Handy, if You for some
  284.             reason like CHKDUN only temporarily :-).
  285.             In other means, /C- to temporarily switch
  286.             CHKDUN off.
  287.  
  288.     /D parameter
  289.         ... to add 'parameter=[parname]' into FRACBAT.DUN
  290.             ** MAY NOT BE USED WITH OTHER PARAMETERS! **
  291.  
  292.     /PARNAME
  293.         ... Get savename from the batched parameter.
  294.  
  295.     /PLAIN
  296.         ... Results a _very_ simple batchentry:
  297.             fractint @parfile/[parname] batch=yes.
  298.             The same You'll get without sstools.ini.
  299.             No reason to use this with other
  300.             parameters, it overrides 'em...
  301.  
  302.  
  303. -----------------------------------------------------------
  304.  F R A C B A T   1.01 DOCUMENTATION                 page 6
  305. ===========================================================
  306.  
  307.     /R[-]
  308.         ... If exists [parname].gif, then resume it.
  309.             See RESUMEIFEXIST-option, described later.
  310.             /R- for negative effect.
  311.  
  312.     FracBat by default batches _every_ parameter NOT in
  313.     FRACBAT.DUN (if not defined /ASK).  Use these
  314.     options or SKIPQUES= in SSTOOLS.INI to control what
  315.     FracBat does if parameter found in FRACBAT.DUN
  316.  
  317.     /SB ... Batch all the parameters without any questions.
  318.             Same as SKIPQUES=BATCH
  319.  
  320.     /SU ... Do NOT batch the parameters that were found
  321.             from FRACBAT.DUN, no questions are asked.
  322.             Same as SKIPQUES=UNBATCH
  323.  
  324.     /SG ... Batch parameter, if [parname].gif doesn't
  325.             exist, even if parameter in FRACBAT.DUN.
  326.             No questions. Same as SKIPQUES=NOGIF
  327.  
  328.     /SO ... Turns on the questionning, no matter what's
  329.             defined in SSTOOLS.INI.  So, if parameter
  330.             in FRACBAT.DUN, then question.
  331.  
  332.     /VIDEO [mode] ... Use [mode] as a video mode in
  333.                       batch.  Example :
  334.                       /VIDEO F4 -- [mode] is a
  335.                       fractint-style -mode.
  336.  
  337.     /MENU   See page 11
  338.  
  339.    -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
  340.  
  341.     Every commandline-option overrides the setting in
  342.     SSTOOLS.INI.  That means, You may configure in
  343.     sstools SKIPQUES=UNBATCH, to advice FracBat to
  344.     leave parameters found in FRACBAT.DUN unbatched,
  345.     and ask no questions.  Then, if You temporarily
  346.     want FracBat to ask what to do with parameters in
  347.     FRACBAT.DUN, run 'fracbat /SO myfracs.par my.bat',
  348.     and FracBat stops to ask if they are to be batched.
  349.     (Every parameter NOT in FracBat.DUN is still batched
  350.     without questions; use /ASK to question with those,
  351.     too.)
  352.  
  353.  
  354.  -----------------------------------------------------------
  355.  F R A C B A T   1.01 DOCUMENTATION                 page 7
  356.  ===========================================================
  357.  
  358.          Summary and explanation of options
  359.  
  360.     Every option consists of its label, equals-sign and the
  361.     final definition.  Format :
  362.  
  363.     KEYWORD=definition
  364.  
  365.     Every option defined under [fracbat] overrides the
  366.     options - even of the same function - under
  367.     [fractint].
  368.  
  369.     Options are :
  370.  
  371.     ------------
  372.     ADDUN=YES/NO
  373.     ------------
  374.  
  375.     Controls, if FracBat should write 'FracBat /D
  376.     parameter' after every 'true' batchentry.
  377.     If ADDUN=NO, You may switch it on with commandline-
  378.     option /A
  379.  
  380.     ----------
  381.     ASK=YES/NO
  382.     ----------
  383.  
  384.     Forces FracBat to ask with _every_ parameter, if it's
  385.     to be batched
  386.  
  387.  
  388.     ------------------
  389.     BAT=APPEND/REWRITE
  390.     ------------------
  391.  
  392.     Use append to always write into the SAME,
  393.     EXISTING batch, rewrite to create always a new
  394.     batch.  (Append, if used here, is actually really
  395.     stoopid!-))
  396.  
  397.     -------------
  398.     CHKDUN=YES/NO
  399.     -------------
  400.  
  401.     Controls whether FracBat checks for FRACBAT.DUN to
  402.     see if the parameter currently to be batched is
  403.     found in there -- i.e., if it has been created
  404.     before.  If You're not interested in this, I mean
  405.     that FracBat keeps an eye on Your stupid
  406.     double-creations, switch this to NO.  Also, it
  407.     might be a very good idea to switch ADDUN to NO
  408.     then.
  409.  
  410.     If You define CHKDUN=NO, You may temporarily switch it
  411.     on with commandline-option /C
  412.  
  413. -----------------------------------------------------------
  414.  F R A C B A T   1.01 DOCUMENTATION                 page 8
  415. ===========================================================
  416.  
  417.     ----------------
  418.     MAP=filename.ext
  419.     ----------------
  420.  
  421.     Let's You define an own mapfile for batches.  This
  422.     is quite useless, but I included it anyway.
  423.     Filename.ext is the name of mapfile to use.
  424.  
  425.     -------------
  426.     MAXITER=nnnnn
  427.     -------------
  428.  
  429.     Since You're in no hurry while sleeping, You may
  430.     find it pleasurable to create better pictures at
  431.     once.  Here You can define a (usually) greater
  432.     iteration for batches. There IS a difference
  433.     between iteration of 300 and 3000, but You may not
  434.     want to wait those 3000 iterations while awake. So,
  435.     place maxiter=300 under [fractint], and
  436.     maxiter=3000 under [fracbat]. nnnnn is a iteration
  437.     maximum, e.g. a number.
  438.  
  439.     --------------------
  440.     RESUMEIFEXIST=yes/no
  441.     --------------------
  442.  
  443.     Here's another neat option.  If FracBat finds a
  444.     .GIF that has the same name that the to-be-created
  445.     [parname].gif, it assumes that You've dun some
  446.     counting on the same parameter before, and resumes
  447.     that file, to be finished.  In practice, if You
  448.     make a batch, run it to some point, quit, do
  449.     something else, then run FracBat again on the same
  450.     parameter-file - DADA!  FracBat makes note of the
  451.     file You quitted in, and advices FractInt to finish
  452.     it!  Really neat and eazy :-D.
  453.  
  454.     NOTE!NOTE!NOTE!  FracBat switches the OVERWRITE
  455.     -option to YES, whenever it finds an existing,
  456.     resumable file!  If there was an unfinished
  457.     MANDEL.GIF on disk, FracBat instructs FractInt to
  458.     finish it, and then save it to MANDEL.GIF.  IF You
  459.     don't like this feature (!), leave the
  460.     RESUMEIFEXIST out of sstools.ini, or switch it to
  461.     NO (/R- from commandline), or Q-edit the OVERWRITE=YES
  462.     -strings to hell out of the batch!
  463.  
  464.     If RESUMEIFEXIST=NO, use commandline-option /R
  465.     to switch it ON in some particular batch
  466.  
  467.  
  468. -----------------------------------------------------------
  469.  F R A C B A T   1.01 DOCUMENTATION                 page 9
  470. ===========================================================
  471.  
  472.     -------------------------------
  473.     SAVENAME=filename / [PARNAME]
  474.     -------------------------------
  475.  
  476.     You may define the name from which the names of the
  477.     fractals created during batch are derived with this
  478.     option, OR You may use the (most) fantastic ability
  479.     of FracBat : let it give an unique name to all of
  480.     fractals!  If You define savename=tonite0, fractint
  481.     will save the first picture of that batch to
  482.     TONITE0.GIF, the second to TONITE1.GIF, the third
  483.     into TONITE2.GIF and so on.  That's quite okay too,
  484.     but in no way it beats the SAVENAME=[PARNAME]!  This
  485.     advices FracBat to define the eight first letters
  486.     of parameters name to be the savename - so if You
  487.     named Your parameter as MyMandelBrotZoom, it would
  488.     be saved to disk as MYMANDEL.GIF.  WOO! Luv it!
  489.  
  490.     BUT :  YOU MAY NOT NAME THE PARAMETER WITH
  491.     CHARACTERS THAT ARE ILLEGAL IN NORMAL
  492.     DOS-FILENAMES!  Got that clear?  If You named the
  493.     parameter MyM'brot, You've got a problem!
  494.  
  495.     Example :
  496.       SAVENAME=MANDZOOM    ; to name .gifs with MANDZOOn
  497.       or
  498.       SAVENAME=[PARNAME]   ; to name .gifs with name of
  499.                              the parameter!
  500.  
  501.    If SAVENAME=filename, use commandline-option
  502.    /PARNAME to get savenames in _that_ batch from
  503.    parameters.
  504.  
  505.     ------------
  506.     SAVETIME=nnn
  507.     ------------
  508.  
  509.     Does the same as FractInt's savetime.  It's used
  510.     here just to override the possible savetime in
  511.     [fractint].  nnn is the time after the file should
  512.     be saved, in minutes.
  513.  
  514.  
  515. -----------------------------------------------------------
  516.  F R A C B A T   1.01 DOCUMENTATION                page 10
  517. ===========================================================
  518.  
  519.     ---------------------------
  520.     SKIPQUES=BATCH/UNBATCH/OFF
  521.     ---------------------------
  522.  
  523.     Controls the questionning of what-to-do-if-file-
  524.     in-fracbat.dun.
  525.  
  526.     SKIPQUES=BATCH   -> Every parameter that's found in
  527.                         FRACBAT.DUN is batched, that is,
  528.                         written into the batch!  No
  529.                         questions.
  530.  
  531.     SKIPQUES=UNBATCH -> Every parameter that's found
  532.                         in FRACBAT.DUN is tossed away,
  533.                         so, it is NOT batched.  This
  534.                         can also be described as 'Batch
  535.                         only NEW parameters'.  No
  536.                         questions.
  537.  
  538.     SKIPQUES=NOGIF   -> Batch parameter, if there isn't
  539.                         [parname].GIF in same
  540.                         directory.  No questions asked.
  541.  
  542.     SKIPQUES=OFF     -> Let FracBat question, what to
  543.                         do with every parameter in
  544.                         FRACBAT.DUN.  The equivalent of
  545.                         leaving skipques off
  546.                         sstools.ini.
  547.  
  548.     Commandline-parameters /SB, /SU, /SG and /SO
  549.     override these settings.
  550.  
  551.     ----------
  552.     VIDEO=mode
  553.     ----------
  554.  
  555.     This lets You use some particular videmode in
  556.     batces - perhaps a slower than the one You use
  557.     normally, when sitting next to computer.  Mode =
  558.     videmode, defined in FRACTINT.CFG
  559.  
  560.  
  561. -----------------------------------------------------------
  562.  F R A C B A T   1.01 DOCUMENTATION                page 11
  563. ===========================================================
  564.  
  565.                       Menu
  566.  
  567.     As of version 1.01, FracBat includes a commandline
  568.     option
  569.  
  570.     /MENU
  571.  
  572.     This can be used to force FracBat to create a menu
  573.     of the parameters in parfile.  From this menu You
  574.     simply tag (using <space> & arrows) the parameters
  575.     You'd like to batch.  <Enter> shall display the
  576.     data of high-lighted parameter.
  577.  
  578.     You may use a few other commandline options with
  579.     /menu -- entering any of all those doesn't cause a
  580.     disaster of any kind, but some won't just work.
  581.     The ones that WILL work are /A[-], /ADD, /R[-],
  582.     /PLAIN and /PARNAME.
  583.  
  584.     To batch the tagged parameters, hit F10.  F1 will
  585.     give a lil' help screen.
  586.  
  587.     WHEN USING MENU, PARFILE.EXT MAY NOT HAVE MORE THAN
  588.     100 PARAMETERS!
  589.  
  590. -----------------------------------------------------------
  591.  F R A C B A T   1.01 DOCUMENTATION                page 12
  592. ===========================================================
  593.  
  594.                     Results
  595.  
  596.     How does it all look like, after You've run the
  597.     batch?  I'll show!  We'll assume, that You've
  598.     defined all the best options :-)
  599.  
  600.     If the file-to-be-created is not a resumable, e.g.
  601.     a file of the same name.gif didn't exist, the final
  602.     batch-entry looks something like this :
  603.  
  604.     fractint batch=yes @yutefrac.par/Eternity
  605.     MAP=SOFTEGA.MAP VIDEO=F2 MAXITER=768 SAVETIME=60
  606.     SAVENAME=Eternity
  607.  
  608.     Except that it'll all be on one line.  That entry
  609.     would create parameter (=fractal) ETERNITY from the
  610.     file yutefrac.par to video F2, using SOFTEGA.MAP,
  611.     maximal iteration of 768, output it to ETERNITY.GIF
  612.     and save it after every one hour.
  613.  
  614.     Now, let's see how the entry looks like, if there
  615.     was a eternity.gif before You run FracBat :
  616.  
  617.     fractint batch=yes OVERWRITE=YES FILENAME=Eternity
  618.     MAP=SSOFTEGA.MAP VIDEO=F2 MAXITER=768 SAVETIME=60
  619.     SAVENAME=Eternity
  620.  
  621.     See?  It loads the ETERNITY.GIF (not finished),
  622.     finishes it and saves to ETERNITY.GIF.  IF FracBat
  623.     wouldn't switch the overwriting to YES, the
  624.     finished image would be in ETERNIT1.GIF.
  625.  
  626.  
  627. -----------------------------------------------------------
  628. F R A C B A T   1.01 DOCUMENTATION                 page 13
  629. ===========================================================
  630.  
  631.             Examples of configuration
  632.  
  633.     SSTOOLS.INI might look something like this, after
  634.     You've configured FracBat :
  635.  
  636.     [fractint]
  637.     VIDEO=F2
  638.     INSIDE=0
  639.     MAXITER=300
  640.     MAP=softega.map
  641.     [fracbat]
  642.     VIDEO=F2            ;  Video-mode to use in batches
  643.     SAVENAME=PARNAME    ;  Savename derived of the parameter's name
  644.     RESUMEIFEXIST=YES   ;  Resume existing .gif's
  645.     MAXITER=768         ;  Maximal iteration during batches
  646.     SAVETIME=60         ;  How often to save during batches
  647.     MAP=softega.map     ;  Use this map in batches
  648.     SKIPQUES=UNBATCH    ;  FracBat asks how to do.
  649.     CHKDUN=YES          ;  Check, if the parameter is created before
  650.     BAT=REWRITE         ;  By default, create always a new batch
  651.     ADDUN=YES           ;  FracBat writes into FracBat.Dun
  652.                         ;  after the parameter is finished
  653.  
  654.     or, another [fracbat]-section :
  655.  
  656.     [fracbat]
  657.     SAVENAME=BATCH000 ;  batch000.gif, batch001.gif ...
  658.     MAXITER=7680
  659.     SAVETIME=120
  660.     SKIPQUES=UNBATCH  ;  Skip every parameter that existed
  661.     BAT=APPEND        ;  Requires the batfile to EXIST!
  662.     CHKDUN=NO         ;  Or just leave this away, just
  663.                       ;  the same
  664.  
  665.     There!
  666.  
  667.     Now, if You're using a configuration similar to the
  668.     first example, and would like FracBat to ask what
  669.     to do with parameters that are found in
  670.     FRACBAT.DUN, and in this particular batch wouldn't
  671.     like fracbat to add 'fracbat /d [parname]'s, and
  672.     would like FracBat to add only new entrys from
  673.     TEST.PAR to existing batch called MYNICEST.BAT, the
  674.     commandline goes like this : (was that a phrase!)
  675.  
  676.     Fracbat /su /a- /add test.par mynicest.bat
  677.  
  678.     You're getting it?  /A- because You've defined
  679.     ADDUN=YES in sstools, /add to add :), /su to turn
  680.     off questioning but leave the parameters found in
  681.     fracbat.dun be -> batch only the parameters NOT in
  682.     fracbat.dun = new parameters.
  683.  
  684.  
  685. -----------------------------------------------------------
  686. F R A C B A T   1.01 DOCUMENTATION                 page 14
  687. ===========================================================
  688.  
  689.      Opinions and improvements are gladly accepted.
  690.      If You're going to use this, please tell me if
  691.      there's anything that could be done better, and
  692.      it will.
  693.  
  694.      I can be reached as :
  695.      jute@sday.pulp.nullnet.fi        (Internet email)
  696. -----------------------------------------------------------
  697.  
  698.     My traditional final words :
  699.  
  700.     This program, FracBat.EXE, it's documentation and
  701.     everything included in zip (fracbat.exe, fracbat.doc,
  702.     sstools.pre, softega.map, yutefrac.par) is pure PD
  703.     as long as I stand.  You may NOT modify the
  704.     program nor the source WITHOUT asking me first.
  705.     (Well, You don't have the source, but .. O:-).  It's
  706.     available anyway, just ask!
  707.     !!!!
  708.     addition (21/02/93):  Sorry, I've lost the source.
  709.     If *you* have it, please email it to me... it
  710.     could be included in some fbat102 release; actually
  711.     a fbat102b...)
  712.  
  713.     I verily like the distribution policy of FractInt,
  714.     but I'd like to add this :
  715.     YOU MAY NOT BECOME RICH WITH THIS, AT LEAST IF I'LL
  716.     STILL REMAIN POOR!
  717.     Not that it would be possible to become rich with
  718.     this.
  719.  
  720.     If FracBat causes ANY harm to Your system, which it
  721.     doesn't, but if does, which it doesn't, but if it does
  722.     ... Where was I?  Yea, all the harm -- even the classic
  723.     grandma-formatting -- caused by FracBat is Your own
  724.     fault, not mine.  I guarantee only, that this has
  725.     been only a _great_ help for myself, and hasn't
  726.     deleted anything nor formatted anyone.  If You lost
  727.     that beloved selected.par due to this, blame
  728.     Yourself -- You probably couldn't use this.  (Or
  729.     messed up with the extensions...:
  730.     Fracbat selected.bat selected.par >:-))
  731.  
  732.     Happy hacking,
  733.     Jussi Kantola
  734.