home *** CD-ROM | disk | FTP | other *** search
/ World of Graphics / WOGRAPH.BIN / 243.GDRAW97B.ZIP / GJOIN.DOC < prev    next >
Text File  |  1992-07-10  |  10KB  |  240 lines
  1. GJOIN.EXE Document file VER .97 -- Copyright 1991  Wright Engineering
  2. ********************** ANOTHER TOOL IN THE GTOOLS LINE **********************
  3.  
  4. FEATURES:
  5.  
  6. * Allows joining of many GDRAW sequences into a single .vg. file!
  7. * MAKE file allows a complex group of sequences to be managed easily.
  8. * Allows anims and presentations larger than GDRAW'S capacity to be made.
  9.  
  10. *****************************************************************************
  11. WARNING: ALL JOINING OPERATIONS SHOULD BE PERFORMED ON FILES THAT
  12.  ARE COPIES, DON'T TAKE CHANCES WITH YOUR WORK!
  13. *****************************************************************************
  14.  
  15. INTRODUCTION:
  16.  
  17.      
  18.           GJOIN is designed to let the user create incredibly
  19.      large run time Animation/Presentations that play as a single 
  20.      .vg or .vr format file.  This larger Animation/Presentation
  21.      is made of as few as 2 or as many as 255 individual GDRAW
  22.      sequences, each saved as a different filename.
  23.  
  24.     GJOIN effectively provides two essential services:
  25.  
  26.           1. It sums the contents of a list of .VG format GDRAW
  27.      files into a single .vg file that will be slightly smaller
  28.      in size than the sum of the individual files (this is due
  29.      to the elimination of redundant header information when the
  30.      files are joined).  Since each file can contain up to 2000
  31.      object commands and up to 255 files can be joined together
  32.      into a single file, you can now have
  33.      Presentation/Animations with up to 510,000 object commands.
  34.      A file with that many objects would typically be about 2.5
  35.      MB's long and have a RUN TIME of approximately 7 hours.  Use
  36.      of imported images can reduce efficiency significantly.
  37.  
  38.           2. GJOIN provides project management facilities, like
  39.      a MAKE FACILITY, typical of a programming environment.
  40.      Each time you wish to create an output .VR? that consists
  41.      of many individual sequences, the .MAK file will guide
  42.      GJoin in linking each of the individual .vg files into a
  43.      single file (in the proper order). This file may now be
  44.      played with GPLAY or it can be GRELLED to shrink RUN TIME
  45.      size and make the presentation/animation uneditable. 
  46.  
  47.  
  48.  
  49. USAGE:
  50.  
  51.           GJOIN inputfilename[.EXT] [/SWITCHES]
  52.  
  53. Inputfilename is the name of the makefile created with a text editor.
  54. [.EXT] indicates an optional extension. 
  55. [/SWITCHES] is any of the supported GJoin commands switches
  56. If no [.EXT] is specified then GJOIN assumes a .MAK extension.
  57.  
  58. NOTE: VER. .97 does not support any command line switches.
  59.  
  60.  
  61.           GJOIN MAKEFILES:
  62.  
  63.           GJoin makefiles tell GJoin how to make the
  64.      presentation from the various sequences that make up the
  65.      final Presentation/Animation.  Here is a sample makefile
  66.      called Flight.MAK produced with a text editor...
  67.  
  68.     ; This Makefile will create the Flight animation in mode G
  69.     ; A short little movie that shows off most features
  70.     ;
  71.     flight.vgg;         Output filename in VG format
  72.     thepad.vgg;    #1    rocket on pad, launch lift, men enter ship
  73.     console.vgg;    #2    control console and lift off instruments
  74.     orbit.vgg;    #3    leaving planet surface
  75.     seperate.vgg;    #4    seperation and hyperspace entry
  76.     solarmap.vgg;    #5    Tracking map of Solar System
  77.     reentry.vgg;    #6    Reentry to Subspace and docking
  78.     airlock.vgg;    #7    Airlock closing repressurize
  79.  
  80.           Each line of the makefile must be either a file name
  81.      or comment or a filename with a comment. To insert a blank
  82.      line just use a semicolon with nothing after it.
  83.  
  84.           Notice that the first filename you specify is the
  85.      name you wish to have the output file to have. Since this
  86.      Presentation/Animation was made in mode G the extension is
  87.      .VGG and so all the files must be in mode G.
  88.  
  89.           Each line of the .MAK file can have only ONE filename
  90.      on it.  The end of the filename must end in a semicolon
  91.      (;), to tell GJoin that the line is complete and that
  92.      anything afterwards is a description of that sequence.
  93.  
  94.           Do NOT embed any blank lines in the file and do NOT
  95.      end your last line with a carriage return or you will
  96.      confuse GJoin.
  97.  
  98.           If you wish to have text lines for comments, then
  99.      start the line with a semicolon in the first position of
  100.      that line, and GJoin will ignore that line.  If you place
  101.      the semicolon in a position other than the first position
  102.      of the line, GJoin will assume that all characters to the
  103.      left of the semi- colon make up a valid filename and GJoin
  104.      will become confused and exit without making the output
  105.      file.
  106.  
  107.           Each of the filenames after the output filename should
  108.      be a GDraw created sequence that will be linked together in
  109.      the order of their appearance in the make file.  This
  110.      points out something very interesting.  If you are trying
  111.      to make a Presentation/Animation that is flexible, easily
  112.      updated, or modified you can change the order of the files
  113.      or substitute some files for other files.
  114.  
  115.           NOTE: You cannot specify a name in the joining list
  116.      that conflicts with output file name as this would overwrite
  117.      one of the input files destroying it.
  118.     
  119.           Note: GJoin .97 does not support mixing sequences made
  120.      in different screen modes but it is anticipated in VER .98.
  121.  
  122.           Joining information window:
  123.  
  124.           When you invoke GJoin to make a Presentation/Animation
  125.      GJoin follows these steps in making your presentation.
  126.  
  127.           1. It opens the makefile you have created with a text
  128.      editor.
  129.  
  130.           2. It opens each one of the files in the list to
  131.      examine the files header information and verify that it
  132.      exists.  If one of the filenames does not exist GJoin will
  133.      exit with an error and attempt to tell you what happened to
  134.      make it fail.  With errors in the files header, the program
  135.      will show an error message and exit.
  136.  
  137.           3. GJoin then opens its Information Window, which
  138.      informs you about the state of joining.  
  139.  
  140.  
  141.                   Copyright 1990 Wright Engineering
  142.                     Graphics Joiner   Version .97
  143.      ╔════════════════════════════════════════════════════════════╗
  144.      ║        Processing :   current file being processed         ║
  145.      ║      File Comment :   file comment from current file       ║
  146.      ║       Screen Mode :   screen mode of the current file      ║
  147.      ║        GD Version :   GDRAW version used to create current ║
  148.      ║ Objects this file :   # object processed so far in current ║
  149.      ║     Total Objects :   total # in current file to process   ║
  150.      ║   Bytes this file :   # bytes processed in current file    ║
  151.      ║       Total Bytes :   # bytes processed in all files       ║
  152.      ║ Current file size :   # of bytes in the current file       ║
  153.      ║       Total Files :   # of files to join together          ║
  154.      ║   Files Remaining :   # of files before GJoin is finished  ║
  155.      ║        # Commands :   # of GDRAW commands processed        ║
  156.      ║  Total # Commands :   # GDRAW + GJOIN commands used        ║
  157.      ║   Output Filename :   # the name of the joined file        ║
  158.      ║  Output File size :   # instantaneousness size of output file   ║
  159.      ║        % Complete :   # percentage complete 100% = done    ║
  160.      ╚════════════════════════════════════════════════════════════╝
  161.  
  162.           Should any file that is being joined be flawed, then
  163.      GJoin will delete the output file and exit with an error
  164.      message.
  165.  
  166.  
  167.  
  168.  
  169.           GDRAW and GJOINED vgX files
  170.            ___________________________
  171.  
  172.           If you join a large group of files into a single file
  173.      that is larger than 2000 commands, that file can no longer
  174.      be loaded into GDraw for editing; so GJoin will destroy the
  175.      output file from GJoin (if the output file has more than
  176.      2000 commands in it) after it has GRel'ed the file.  This
  177.      will save disk space and prevent you from depending on that
  178.      single file for editing purposes only to find out that it
  179.      can't be loaded on your machine because it is too large to
  180.      fit in GDraw.
  181.  
  182.  
  183. NOTE 2: DON'T ASSUME THAT YOU CAN ALWAYS EDIT THE OUTPUT .VG FILE EVEN
  184.         THOUGH IT HAS LESS THAN 2000 OBJECTS.  YOU CAN NEVER BE 100%
  185.         SURE THAT YOU CAN EDIT IT UNTIL YOU TRY, SO NEVER DESTROY 
  186.         YOUR INDIVIDUAL SOURCE FILES!
  187.  
  188.      ____________________________________________________________
  189.      GJOINING files into a single file smaller than 2000 commands
  190.      ____________________________________________________________
  191.  
  192.      If you GJoin files into a single file that contains less
  193.      than 2000 commands total then you can possibly use that as
  194.      an as GDRAW file. file under GDRAW the only exceptions to this is
  195.      that certain commands use a lot of raw machine memory.
  196.      These might make you run out of raw memory in GDRAW before
  197.      you run out of commands memory and even though you are less
  198.      than 2000 objects your machine may not be able to edit the
  199.      file.
  200.  
  201.  
  202.      PLAYING MASSIVE .VG FILES 
  203.      ________________________
  204.  
  205.           GPlay can play any .vg file regardless of the file
  206.      size, so if for some reason you wish to keep the massive
  207.      single .vgX output file then use with GPLAY.
  208.  
  209.  
  210.      FOR MORE INFORMATION 
  211.      -------------------- 
  212.      If you wish to find out more about:
  213.  
  214.     GDRAW  - GFX vectored Graphics interpreter
  215.     GPLAY  - Vectored Graphics player
  216.     GCHECK - Vectored Graphics file checker
  217.     GREL   - Graphics Relative Compiler
  218.     GFONT  - Graphic Font maker
  219.     GTERM  - GFX terminal software
  220.     GBBS   - GBBS (Graphics Bulletin Board System)
  221.  
  222.      please contact the Wright Engineering HQ BBS
  223.  
  224.     at 714-847-2548  14.4 HST and below
  225.     the board is open from 9 p.m. to 9 a.m. Pacific time
  226.  
  227.      or you may write:     
  228.         
  229.         WRIGHT ENGINEERING 
  230.         19744 BEACH BLVD.
  231.         SUITE # 309
  232.         HUNTINGTON BEACH, CA.
  233.         92648
  234.  
  235.  
  236.           This board is running WWIV BBS software until the
  237.      official release of GBBS which is currently under alpha
  238.      testing.
  239.  
  240.