home *** CD-ROM | disk | FTP | other *** search
/ dark domain - the artpacks.acid.org collection / darkdomain.iso / artpacks / 1994 / acdu0494.zip / ACIDVIEW.NFO < prev    next >
Text File  |  1994-04-01  |  33KB  |  762 lines

  1.  
  2.                          ▄       ▄       ▄           ▄
  3.                           ▀█▄    ▐██▄▄  ██▄    ▄▄▄███▌TM
  4.                          ▄ ▐██   ████▀▀▄ █▀ ▄▀▀▄ ▀▀███▄
  5.                         █▌  ███ ▐███    ▄▄ ▀ ▄██    ▐███
  6.                        ██▀▀▀▐██▌ ███▌   ▐███  ██▌    ████
  7.                       ███▌  ▐███ ▐███▄   ██▌  ▐██▄▄ ▐████▌
  8.                      ▐████▄▄ ▀▀▀▀  ▀▀▀▀▀▀ ▀▀ ▀▀▀█████████
  9.                       ▀█▀▀    V    I    E    W     ▀▀▀█▀
  10.  
  11.            ACiD Productions(tm)' Acquisition Enhanced File Viewer
  12.                         Coding by The Hit M/┤N of ACiD
  13.                    Screen and Layout by Dr. Tongue of ACiD
  14.                           Character Font by RaD Man
  15.                Modem Simulation Routines by Tasmaniac of ACiD
  16.  
  17.    ┌┐─── ──  ─   ─  ── ───────────────────────────────────────────────────┬─ ∙∙
  18.    └┼─────────────────────────────────────────────────────────────────────┐
  19.    ││   Documentation and Update History of ACiD Productions' ACiD View   │∙
  20.    :│                                                                     │:
  21.    ∙│         By The Hit Man and RaD Man of ACiD Productions(tm)          ││
  22.     └─────────────────────────────────────────────────────────────────────┼┐
  23. ∙∙ ─┴─────────────────────────────────────────────────── ──  ─   ─  ── ───└┘
  24.  
  25.            [ Current version of ACiD View : 2.00 / 03-31-1994∙19:12 ]
  26.  
  27.  
  28. ┌────────────────────────────╖
  29. │ Introduction to ACiD View  ║
  30. └════════════════════════════╝
  31.  
  32.  
  33.             ACiD View welcomes you to the most comprehensive Art View-
  34.         er in production.  This innovative program  is capable of dis-
  35.         playing both ANSI and RIP  graphics.  In  addition, the viewer
  36.         has been designed with a special interest for those who multi-
  37.         tasked.  ACiD View utilizes  its  own  internal ANSI routines,
  38.         making it capable of viewing  ANSI  without  a separate device
  39.         driver.  We hope  that  ACiD  View  provides  you with as much
  40.         pleasure as we intended with its creation.
  41.  
  42.  
  43. ┌──────────────────────────╖
  44. │ Features                 ║
  45. └══════════════════════════╝
  46.  
  47.  
  48.      ■  Full File Description and Artist Initial Identification
  49.      ■  Now supporting our very own special SAUCE
  50.      ■  Semi "Gooey" Menu System
  51.      ■  Mouse support
  52.      ■  Pull-down Menus
  53.      ■  Command Line Viewing
  54.      ■  Slide-Show capable
  55.      ■  Variable Speed ANSI Viewing
  56.      ■  Modem-Simulation for both ANSI and RIP Viewing
  57.      ■  File Masking
  58.      ■  Drive and Directory switching
  59.      ■  Level 0-1 RIP Viewing
  60.      ■  Fully-Features ANSI Scroll Back in several different video modes
  61.      ■  ANSI Viewing in 80x25 or 80x50/80x43 text modes
  62.      ■  ANSI Viewing in 640x480x16 VGA mode
  63.      ■  ANSI Viewing in 320x200x256 MCGA mode
  64.      ■  ANSI Viewing in 640x480, 800x600, and 1024x768x256 SVGA VESA modes
  65.      ■  Supports up to 2000 files in one directory
  66.      ■  ACiD View Default Setup (INI) with automatic saving
  67.  
  68.  
  69. ┌──────────────────────────╖
  70. │ What ACiD View Displays  ║
  71. └══════════════════════════╝
  72.  
  73.  
  74.      ■  ACiD View will display ANSI screens in several different video
  75.         modes.  These modes include the default, 80x25, and others
  76.         such as the 80x43/80x50 text modes, 640x480x16 VGA,
  77.         320x200x256 MCGA, 640x480, 800x600, and 1024x768x256 VESA SVGA
  78.         modes.  ACiD View also supports all of the major SVGA chipsets
  79.         (Trident, Oak, TSeng, etc.)
  80.  
  81.      ■  ACiD View displays most low level (0-1) RIP screens.  Although
  82.         it will show all of the RIPs presented in the Acquisition, it
  83.         may not display some of the other RIPS you own.  This is due
  84.         to the fact that some of the higher level RIP commands have
  85.         not yet been implemented.
  86.  
  87.      ■  ACiD View is capable of displaying ANSI or RIP files at sim-
  88.         ulated modem speeds.  To ensure that these files display at
  89.         the same speed on all computers, the timer interrupt is altered.
  90.         This can create a possibility for problems while running ACiD
  91.         View under a multitasking operating system, such as DesqView.
  92.         In order to prevent this problem, these modem simulation
  93.         routines have been disabled within all multitasking environ-
  94.         ments.
  95.  
  96.  
  97. ┌──────────────────────────╖
  98. │ ACiD View Functions      ║
  99. └══════════════════════════╝
  100.  
  101.  
  102.  ┌────╖
  103.  │ F1 ║  Quick-Help   :  Brief description of function keys.
  104.  └════╝
  105.  ┌────╖
  106.  │ F2 ║  Scroll Back  :  Toggles Scrolled viewing ON/OFF.  Default is
  107.  └════╝                  OFF.  While ON, you can scroll back ANSI in
  108.                          80x25, 80x43/80x50, and 320x200 Modes.
  109.  ┌────╖
  110.  │ F3 ║  Toggle Speed :  Displays files in a variety of speeds: No Delay,
  111.  └════╝                  ErrorChecking, 38,400, 19,200, 14,400, 12,000,
  112.                          9600, 4800, and 2400 bps.  The default is No
  113.                          Delay.  If you want to display files at an
  114.                          alternate bps rate, you can customize the speed
  115.                          by pressing the (+) or (-) keys to increase or
  116.                          decrease the speed, repsectively.
  117.  ┌────╖
  118.  │ F4 ║  Display Mode :  Selects the video mode that the selected ANSI
  119.  └════╝                  is to be viewed in.
  120.  
  121.  
  122.      ■  80x50 Display - If you have a VGA card, this will compress the
  123.                         default 8x16 font into an 8x8 font and display
  124.                         the screen. This feature is nice when you want
  125.                         to display a big ANSI on one screen.
  126.  
  127.      ■  VGA 16        - Displays ANSI in 640x480x16 VGA mode.
  128.  
  129.      ■  MCGA 256      - ACiD View will display ANSIs in 320x200x256
  130.                         MCGA (mode 13h) graphics mode.
  131.  
  132.      ■  VESA SVGA     - Displays ANSI in 640x480, 800x600, and
  133.                         1024x768x256 SVGA modes.  VESA SVGA is required
  134.                         for these viewing modes.
  135.  
  136.  
  137.  ╓────────────────┬───────────────────────────────────────┬─────────╖
  138.  ║  Display Mode  │  Description                          │  Flags  ║
  139.  ╟────────────────┼───────────────────────────────────────┼─────────╢
  140.  ║       25 Line  │  Standard 80x25 Text Mode             │  ABS    ║
  141.  ║       50 Line  │  80x43/80x50 Compressed Text Mode     │  ABES   ║
  142.  ║        VGA 16  │  640x480x256 VGA Graphics Mode        │  AV     ║
  143.  ║      MCGA 256  │  320x200x256 MCGA Graphics Mode       │  AMS    ║
  144.  ║       640x480  │  640x480x256 VESA SVGA Graphics Mode  │  AG     ║ 
  145.  ║       800x600  │  800x600x256 VESA SVGA Graphics Mode  │  AG     ║ 
  146.  ║      1024x768  │  1024x768x256 VESA SVGA Graphics Mode │  AG     ║ 
  147.  ║           RIP  │  640x350x16 EGA Graphics Mode         │  BER    ║
  148.  ╙────────────────┴───────────────────────────────────────┴─────────╜
  149.  
  150.   Flags:
  151.    A = Ansimated Viewing Supported    B = Modem Simulation Supported
  152.    R = RipScrip Graphics Supported    S = Scroll Back Supported
  153.    E = EGA Required                   M = MCGA Minimum Required
  154.    V = VGA Required                   G = VESA/SVGA Required
  155.  
  156.  ┌────╖
  157.  │ F5 ║  File-Masking :  Selects files within a specified file mask.
  158.  └════╝
  159.  
  160. ┌───────╖
  161. │ Alt+A ║  Ansimation :  Forces the ansimation flag of the highlighted
  162. └═══════╝                file.  Use this option when you know the ANSI
  163.                          you want to view contains ansimation and is
  164.                          not flagged so.  This option only affects the
  165.                          320x200x256 MCGA mode.
  166.  
  167.  
  168. ┌──────────────────────────╖
  169. │ The ACIDVIEW.INI File    ║
  170. └══════════════════════════╝
  171.  
  172.  
  173.             ACiD View  now  includes  an  INItialization  file, which
  174.         allows you to set up your preferred defaults upon the loading
  175.         of the viewer.  ACIDVIEW.INI can be edited with virtually any
  176.         text editor of your choice.  While  editing  the file, please
  177.         note that each line  is  interpreted  as  a command, unless a
  178.         semi-colon  precedes  it.  Only  the  information  within the
  179.         quotes  or  after the  equal  character should  be  modified.
  180.         Follow  the  instructions   for   each  entry,  as  shown  in
  181.         ACIDVIEW.INI.  ACiD View will  automatically save any changes
  182.         made to the configuration  during  run-time in the initializ-
  183.         ation file.
  184.  
  185.  
  186. ┌──────────────────────────╖
  187. │ What is SAUCE?           ║
  188. └══════════════════════════╝
  189.  
  190.  
  191.    Recipe for SAUCE
  192.  
  193.    Chef cuisinier : Tasmaniac / ACiD
  194.    Maitre d'hôtel : Rad Man / ACiD
  195.  
  196.        ANSi's used to be just ANSi's, pictures were just pictures, loaders 
  197.    were just loaders and quite frankly, every file was just as plain tasting 
  198.    as every other.  This is about to change, however, because ACiD has decided
  199.    to give their files an extra "je-ne-sais-quoi."  In reality, we'll be 
  200.    adding SAUCE to every file you can imagine.
  201.  
  202.        Now, before we thoroughly confuse you, let us explain what we are 
  203.    doing here.  SAUCE stands for "Standard Architecture for Universal Comment 
  204.    Extensions."  Although originally intended for personal use in ANSi's and
  205.    RIP screens, early in the developement of EFI (Extended File Information) it
  206.    was decided that EFI should be extended to have support for more than just 
  207.    ANSi and RIP screens.  Our brainchild was born and the specs were designed.  
  208.    The only aspect left undecided was the name, and after rejecting some very 
  209.    funny candidates, SAUCE was unanimously chosen.  This leads us to the big 
  210.    question in the sky, "What is sauce?"   SAUCE is a universal process to 
  211.    incorporate a full description for any type of file. The most outstanding
  212.    aspect of this concept is that you have access to the complete file name, 
  213.    the file's title, the creation date, the creator of the file, the group 
  214.    that the creator is employed by, and much, much, more.
  215.  
  216.        A full explanation on how you can implement SAUCE is described at 
  217.    the end of this document in the PLATES (Programming Language Architecture 
  218.    To Extract SAUCE) section.  Although you can create your own programs to 
  219.    implement SAUCE to your files, we recommend that you use the SPOON.EXE 
  220.    program to ensure a greater universal compatibility.  There is a minor 
  221.    stipulation, however, in that complete specs to SAUCE are not available.  
  222.    Thus, SPOON.EXE will not be available this month, but will be out in the
  223.    near future.
  224.  
  225.        SAUCE already supports a plethora of filetypes (See PLATES).  If you
  226.    have a need for the SAUCE specifications, please contact us before you make 
  227.    the changes yourself.  We will accomodate your needs as soon as possible.  
  228.    After all, SAUCE is designed to become a standard, and if people change 
  229.    the specs without allowing us to make a complete update, there will be no 
  230.    standard.  In the event that we change SAUCE, we will quickly release a
  231.    public update which will most definately include an improved and updated
  232.    SPOON.EXE. 
  233.  
  234.        SAUCE has advantages over any other system in use.  Each description
  235.    will be added to the file and will provide a file description no matter what
  236.    computer it is used for.  SAUCE, however, also provides a back compatibility
  237.    that uses a file with descriptions for those files that do NOT already have 
  238.    a SAUCE description.  Processing in this manner is fully implemented in 
  239.    SPOON.EXE and one can extract embedded SAUCE to this data file and add SAUCE
  240.    to files from this data file.
  241.  
  242.  
  243.    PLATES
  244.    ------
  245.    
  246.        Let us begin with a description of the record layouts used.
  247.    The record layouts and code examples are in a varieted pascal pseudo code,
  248.    and should be transferrable enough to implement in most other programming
  249.    languages.  For ease of reading, the examples assume that the file is cor-
  250.    rect and that no error-checking need be included.  How rigorous you check 
  251.    for errors is completely up to you, and will most likely depend on the file
  252.    type you are describing.
  253.  
  254.  
  255.    SAUCE RECORD
  256.    ------------
  257.    
  258.        This portion of the documentation is about the SAUCE record.  The 
  259.    SAUCE record describes the file in short, and provides other information
  260.    not included in the SAUCE record itself.
  261.  
  262.    A sauce record is _EXACTLY_ 128 bytes in size.
  263.  
  264.    Fieldname   : Name of the field.
  265.    Size        : Size of the field in BYTES
  266.    Type        : Type of data. This can be :
  267.      BYTE      : One byte unsigned numeric value (0 to 255)
  268.      WORD      : Two byte unsigned numeric value (0 to 65535)
  269.      INTEGER   : Two byte signed numeric value (-32768 to 32767)
  270.      LONG      : Four byte signed numeric value (-2147483648 to 2147483647)
  271.      CHARACTER : One byte ASCII value.  Longer character fields are
  272.                  padded with spaces.  It is _NOT_ a PASCAL string (with a
  273.                  leading length byte), and it's _NOT_ a C-Style string
  274.                  (with a trailing nul-byte).  A 10 byte character field
  275.                  holding the text 'ANSI' would look like this.
  276.                  'ANSI      '.
  277.    
  278.     Numeric fields should be zero when not used, character fields should
  279.    be all spaces when not used.
  280.    
  281.     V#          : SAUCE Version number.  This indicates the version of SAUCE
  282.                   when the field was implemented.
  283.  
  284.     Description : Complete description of the field.
  285.  
  286.  
  287.     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  288.     No fields are REQUIRED to be filled in except for ID, Version, FileSize,
  289.     DataType and FileType.
  290.     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  291.  
  292.     FieldName Size Type      V# Description
  293.     --------- ---- --------- -- -----------
  294.     ID          5  Character 00 SAUCE Identification. This should be equal to
  295.                                 'SAUCE' or the record is not a valid SAUCE
  296.                                 record.
  297.     Version     2  Character 00 Version number of SAUCE. Current version is
  298.                                 '00'.  As new features are added to the
  299.                                 specifications of SAUCE, this version number
  300.                                 will change.  Future versions SHOULD remain
  301.                                 compatible with version 00 only ADDING on
  302.                                 the specifications, it is however not unlikly
  303.                                 that this compatibility is impossible to
  304.                                 maintain, but this is of no concern now.
  305.     Title      35  Character 00 Title of the file.
  306.     Author     20  Character 00 Name or handle of the creator of the file.
  307.     Group      20  Character 00 Name of the group the creator is employed by.
  308.     Date        8  Character 00 Date the file was created. This date is in
  309.                                 the format CCYYMMDD (Century, year, month,
  310.                                 day).  There is a good reason why the date
  311.                                 is in this format, but it's not used in
  312.                                 version '00' of SAUCE.  It will be used in
  313.                                 a future version of SAUCE.
  314.     FileSize    4  Long      00 Original filesize NOT including any
  315.                                 information of SAUCE.
  316.     DataType    1  Byte      00 Type of Data. (See DATATYPES further on)
  317.     FileType    1  Byte      00 Type of File. (See DATATYPES further on)
  318.     TInfo1      2  Word      00 Numeric information field 1 (See DATATYPES)
  319.                                 When used, this field holds informative
  320.                                 values.  Any program using SAUCE should not
  321.                                 rely on these values being correct or filled
  322.                                 in.
  323.     TInfo2      2  Word      00 Numeric information field 2 (See DATATYPES)
  324.     TInfo3      2  Word      00 Numeric information field 3 (See DATATYPES)
  325.     TInfo4      2  Word      00 Numeric information field 4 (See DATATYPES)
  326.     Comments    1  Byte      00 Number of Comment lines (See COMMENTS)
  327.     Filler     23  Byte         Reserved bytes. 
  328.  
  329.  
  330.     An Example PASCAL record looks like this:
  331.  
  332.       TYPE SAUCERec = RECORD
  333.                         ID       : Array[1..5] of Char;
  334.                         Version  : Array[1..2] of Char;
  335.                         Title    : Array[1..35] of Char;
  336.                         Author   : Array[1..20] of Char;
  337.                         Group    : Array[1..20] of Char;
  338.                         Date     : Array[1..8] of Char;
  339.                         FileSize : Longint;
  340.                         DataType : Byte;
  341.                         FileType : Byte;
  342.                         TInfo1   : Word;
  343.                         TInfo2   : Word;
  344.                         TInfo3   : Word;
  345.                         TInfo4   : Word;
  346.                         Comments : Byte;
  347.                         Filler   : Array[1..23] of Char;
  348.                       END;
  349.  
  350.     An Example C record looks like this:
  351.  
  352.       typedef SAUCEREC {
  353.          char          ID[5];
  354.          char          Version[2];
  355.          char          Title[35];
  356.          char          Author[20];
  357.          char          Group[20];
  358.          char          Date[8];
  359.          signed long   FileSize;
  360.          unsigned char DataType;
  361.          unsigned char FileType;
  362.          unsigned int  TInfo1;
  363.          unsigned int  TInfo1;
  364.          unsigned int  TInfo1;
  365.          unsigned int  TInfo1;
  366.          unsigned char Comments;
  367.          char          Filler[23];
  368.       } SAUCEREC;
  369.  
  370.  
  371.     DATATYPES
  372.     ---------
  373.     DataType and FileType hold the information needed to determine what type
  374.     of file it is.
  375.  
  376.     There are 5 DataTypes, these are (with their respective numeric values) :
  377.       0) None      : Undefined filetype, you could use this to add SAUCE
  378.                      information to personal datafiles needed by programs,
  379.                      but not having any other meaning.
  380.       1) Character : Any character based file.  Examples are ASCII, ANSi and
  381.                      RIP.
  382.       2) Graphics  : Any bitmap graphic file.  Examples are GIF, LBM, and
  383.                      PCX.
  384.       3) Vector    : Any vector based graphic file.  Examples are DXF and
  385.                      CAD files.
  386.       4) Sound     : Any sound related file.  Examples are samples, MOD
  387.                      files and MIDI.
  388.  
  389.      None
  390.      ----
  391.      When using the 'None' datatype, you should have FileType set to zero
  392.      also.  This is a compatibility issue as it's not unlikely, the 'None'
  393.      datatype will have filetypes in the future.
  394.  
  395.      Character
  396.      ---------
  397.      When using the 'Character' datatype, you have following filetypes
  398.      available :
  399.       0) ASCII     : Plain text file with no formatting codes or color codes.
  400.                      TInfo1 is used for the width of the file.
  401.                      TInfo2 is used to hold the number of lines in the file.
  402.       1) ANSi      : ANSi file.  With ANSi color codes and cursor
  403.                      positioning.
  404.                      TInfo1 is used for the width of the file.
  405.                      TInfo2 is used to hold the number of ANSi screen lines
  406.                      in the file.
  407.       2) ANSiMation: ANSi Animation.  With ANSi color codes and cursor
  408.                      positioning.  While an ANSi file can also have animated
  409.                      sequences, there is a clear distinction.  While an ANSi
  410.                      may or may not have a beginning animated sequence
  411.                      introducing the group or artist the rest is just a
  412.                      sequence of colored characters.  An ANSiMation on the
  413.                      other hand is a more like a text mode cartoon.
  414.                      TInfo1 is used for the width of the file.
  415.                      TInfo2 is used to hold the number of ANSi screen lines
  416.                      the ANSiMation was created for.
  417.                      A program using SAUCE may use these two values to
  418.                      switch to the appropriate video mode.
  419.       3) RIP       : Remote Imaging Protocol (RIP) graphics file.
  420.                      TInfo1 holds the width (should be 640)
  421.                      TInfo2 holds the height (should be 350)
  422.                      TInfo3 holds the number of bits per pixel (should be 4)
  423.       4) PCBoard   : File with PCBoard style @X color codes and @ macro's
  424.                      and ANSi codes.
  425.                      TInfo1 is used for the width of the file.
  426.                      TInfo2 is used to hold the number of ANSi screen lines
  427.                      in the file.
  428.       5) AVATAR    : A file with AVATAR and ANSi color codes and cursor
  429.                      positioning.
  430.  
  431.  
  432.      Graphics
  433.      --------
  434.      For all graphics types, TInfo1 holds width of the image, TInfo2 holds
  435.      the Height of the image and TInfo3 holds the number of bits per pixel
  436.      (a 256 colour image would have 8 bits per pixel, a TrueColor image
  437.      would have 24);
  438.  
  439.      Following Graphics filetypes are available :
  440.      0) GIF     (CompuServ Graphics Interchange format).
  441.      1) PCX     (ZSoft Paintbrush PCX format).
  442.      2) LBM/IFF (DeluxePaint LBM/IFF format).
  443.      3) TGA     (Targa Truecolor)
  444.      4) FLI     (Autodesk FLI animation file).
  445.      5) FLC     (Autodesk FLC animation file).
  446.      6) BMP     (Windows Bitmap)
  447.      7) GL      (Grasp GL Animation)
  448.      8) DL      (DL Animation).
  449.      9) WPG     (Wordperfect Bitmap)
  450.  
  451.  
  452.      Vector
  453.      ------
  454.      Following Vector filetypes are available :
  455.      0) DXF     (CAD Data eXchange File)
  456.      1) DWG     (AutoCAD Drawing file)
  457.      2) WPG     (WordPerfect/DrawPerfect vector graphics)
  458.  
  459.  
  460.      Sound
  461.      -----
  462.      Following sound filetypes are available :
  463.      0)  MOD    (4, 6 or 8 channel MOD/NST file)
  464.      1)  669    (Renaissance 8 channel 669 format)
  465.      2)  STM    (Future Crew 4 channel ScreamTracker format)
  466.      3)  S3M    (Future Crew variable channel ScreamTracker3 format)
  467.      4)  MTM    (Renaissance variable channel MultiTracker Module)
  468.      5)  FAR    (Farandole composer module)
  469.      6)  ULT    (UltraTracker module)
  470.      7)  AMF    (DMP/DSMI Advanced Module Format)
  471.      8)  DMF    (Delusion Digital Music Format (XTracker))
  472.      9)  OKT    (Oktalyser module)
  473.      10) ROL    (AdLib ROL file (FM))
  474.      11) CMF    (Creative Labs FM)
  475.      12) MIDI   (MIDI file)
  476.      13) SADT   (SAdT composer FM Module)
  477.      14) VOC    (Creative Labs Sample)
  478.      15) WAV    (Windows Wave file)
  479.      16) SMP8   (8 Bit Sample, TInfo1 holds sampling rate)
  480.      17) SMP8S  (8 Bit sample stereo, TInfo1 holds sampling rate)
  481.      18) SMP16  (16 Bit sample, TInfo1 holds sampling rate)
  482.      19) SMP16S (16 Bit sample stereo, TInfo1 holds sampling rate)
  483.  
  484.  
  485.     COMMENTS
  486.     --------
  487.     The comment block is an addition to the SAUCE record.  It holds up to 255
  488.     lines of additional information.  Each line 64 characters wide.
  489.  
  490.     When the Comments field is not zero, it holds the number of additional
  491.     comment lines are available.  A single comment line is 64 characters long.
  492.     Like the character fields in the SAUCE record, it is padded with spaces,
  493.     and has no leading length byte or trailing null-byte.
  494.  
  495.     The comment block is preceded with a 5 character identification mark.
  496.     This identification mark is 'COMNT'.
  497.  
  498.  
  499.     SAUCE IN FILES
  500.     --------------
  501.     A file with SAUCE added to it.  Will look like this:
  502.  
  503.      ┌───────────────┐
  504.      │               │
  505.      │   FILE DATA   │  Actual file data.  As if it would be without SAUCE.
  506.      │               │
  507.      ├───────────────┤
  508.      │               │
  509.      │  EOF MARKER   │  EOF marker.  This will assure character files can
  510.      │               │  easily determine the end of file.
  511.      ├───────────────┤
  512.      │               │
  513.      │ COMMENT BLOCK │  Optional Comment block.
  514.      │               │
  515.      ├───────────────┤
  516.      │               │
  517.      │ SAUCE RECORD  │  SAUCE record.
  518.      │               │
  519.      └───────────────┘
  520.  
  521.  
  522.     The Comment block
  523.  
  524.      ┌───────────────┐
  525.      │               │
  526.      │   'COMNT'     │  Comment block ID bytes
  527.      │               │
  528.      ├───────────────┤
  529.      │               │
  530.      │ COMMENTLINE 1 │  First comment line
  531.      │               │
  532.      ├───────────────┤
  533.      │               │
  534.      │ COMMENTLINE 2 │  Second comment line
  535.      │               │
  536.      ├───────────────┤
  537.      ...
  538.      ├───────────────┤
  539.      │               │
  540.      │ COMMENTLINE N │  n-th comment line, n equals the Comments field in
  541.      │               │  SAUCE record.
  542.      └───────────────┘
  543.  
  544.  
  545.  
  546.     EXAMPLE CODE TO READ SAUCE
  547.     --------------------------
  548.     Variables:
  549.       Byte : Count;
  550.       Long : FileSize;
  551.       file : F;
  552.  
  553.     Code:
  554.       Open_File(F);                         | Open the file for read access
  555.       FileSize = Size_of_file(F);           | Determine filesize
  556.       Seek_file (F, FileSize-128);          | Seek to start of SAUCE (Eof-128)
  557.       Read_File (F, SAUCE);                 | Read the SAUCE record
  558.       IF SAUCE.ID="SAUCE" THEN              | ID bytes match "SAUCE" ?
  559.          IF SAUCE.Comments>0 THEN           | Is there a comment block ?
  560.             Seek_File(F, FileSize-128-(SAUCE.Comments*64)-5);
  561.                                             | Seek to start of Comment block.
  562.             Read_File(F, CommentID);        | Read Comment ID.
  563.             IF CommentID="COMNT" THEN       | Comment ID matches "COMNT" ?
  564.                For Count=1 to SAUCE.Comments| \ Read all comment lines.
  565.                   Read_File(F, CommentLine) | /
  566.                ENDFOR
  567.             ELSE
  568.                Invalid_Comment;             | Non fatal, No comment present.
  569.             ENDIF
  570.          ENDIF
  571.       ELSE
  572.          Invalid_SAUCE;                     | No valid SAUCE record was found.
  573.       ENDIF
  574.  
  575.  
  576.  
  577.     SAUCE DATAFILE
  578.     --------------
  579.     The full specifications of the SAUCE datafile are not ready yet.
  580.  
  581.  
  582.     INFORMATION OR UPGRADES
  583.     -----------------------
  584.     If you have a need for additional information on SAUCE, or need
  585.     modifications, you can contact me at these places...
  586.  
  587.     Leave a message to TASMANIAC on any of these boards :
  588.  
  589.     FUN-derbird BBS +32-50-620112   USR 16800 Dual
  590.                     +32-50-625717   ZyXEL 19200
  591.     The End of TiME +1-803-855-0783 USR 21600 Dual
  592.     Channel Zer0    +1-714-532-5950 Practical 14400
  593.                     +1-714-532-5968 USR 16800 Dual
  594.  
  595.  
  596. ┌──────────────────────────╖
  597. │ Acquisition Viewer 2.00  ║
  598. └══════════════════════════╝
  599.  
  600.  
  601. 1)  ACiD View takes on a hot new look in its new interface created by
  602.     Dr. Tongue of ACiD Productions.  The layout has been completely
  603.     reconstructed, and now provides the end user with pull-down and
  604.     the same familiar hot keys.
  605.  
  606. 2)  ACiD View now makes use of on-the-fly SAUCE definition loading.
  607.     This process will greatly increase your initialization speed on
  608.     computers that contain a multitude of files.
  609.  
  610. 3)  ACiD View now caters to mouse users, supporting a wide spectrum
  611.     of different mouse types.
  612.  
  613. 4)  ACiD View has recently been implemented with progress bars.  Your
  614.     estimated position in the list of files or directories can now be
  615.     visually monitored with the help of the elevator located to the
  616.     right of the file/directory listing.
  617.  
  618. 5)  VESA SVGA viewing updated for 640x480, 800x600, and 1024x768x256
  619.     modes.  ACiD View supports the following chipsets as well as the
  620.     VESA standard mode:  Ahead, ATI, Chips & Tech, Everex, Genoa,
  621.     Paradise, Oak, Trident, TSeng, and Video7.  If you have trouble
  622.     viewing in SVGA mode, try loading your video cards VESA driver.
  623.  
  624. 6)  All setup changes made during the run-time of ACiD View will be saved
  625.     upon exiting the program.
  626.  
  627. 7)  More minor bugs fixed.
  628.  
  629.  
  630. ┌──────────────────────────╖
  631. │ Acquisition Viewer 1.50  ║
  632. └══════════════════════════╝
  633.  
  634.  
  635. 1)  ACiD View Control File support Added.  ACiD View will now load
  636.     defaults from ACIDVIEW.INI.
  637.  
  638. 2)  Screen now displays the current directory.
  639.  
  640. 3)  Drive switching now added.  ACiD View will show drives A: - Z:.
  641.     (Including FLOPPY, SUBST, RAM, and other drives.)
  642.  
  643. 4)  Command line Viewing is now supported!  (Type "ACiDView /?")
  644.  
  645. 5)  ND CHECK (NO DELAY mode w/Error Checking) display speed added.
  646.     This speed is the same as NO DELAY except it checks if ANSIs con-
  647.     tain lines with more than 255 characters per line.
  648.  
  649.  
  650. ┌──────────────────────────╖
  651. │ Acquisition Viewer 1.40  ║
  652. └══════════════════════════╝
  653.  
  654.  
  655. 1)  Multitasking environment awareness implemented (ie. DesqView and
  656.     OS/2.)
  657.  
  658. 2)  Modem simulation routines are now disabled when ACiD View is loaded
  659.     under multitasking environments.
  660.  
  661. 3)  Directory switching added.  Change directories simply by pressing
  662.     the return key.
  663.  
  664. 4)  "File jumping" and auto-sorting added.  ACiD View will now jump to
  665.     the first file that begins with the character entered by the user.
  666.  
  667. 5)  640x480 viewing is now two times faster than version 1.32.  320x200
  668.     Normal Wide have also been optimized for speed.
  669.  
  670.  
  671. ┌──────────────────────────╖
  672. │ Acquisition Viewer 1.32  ║
  673. └══════════════════════════╝
  674.  
  675.  
  676. 1)  Major bug erradicated in file reading routines.
  677.  
  678. 2)  Fixed the problem with the Viewer exiting if no files were found
  679.     matching the default mask.  ACiDView will now simply display the
  680.     normal interface with no files, allowing you to MASK or exit until
  681.     you specify a valid file mask.
  682.  
  683. 3)  Fixed the key-reading loop with the 320x200 and 320x200 WIDE emu-
  684.     lations when ScrollBack was turned off.
  685.  
  686.  
  687. ┌──────────────────────────╖
  688. │ Acquisition Viewer 1.30  ║
  689. └══════════════════════════╝
  690.  
  691.  
  692. 1)  File Masking added, allowing the user to select files within the mask.
  693.  
  694. 2)  Added 320x200x256 ansimation mode.
  695.  
  696. 3)  Added modem simulator which emulates user-defined bps rate.
  697.  
  698. 4)  Minor bug corrected in the scroll back of large ANSIs.
  699.  
  700. 5)  Removed slow panning upon exit.
  701.  
  702. 6)  640x480x16 now FULLY supports ansimations.  Small bug fixed.
  703.  
  704.  
  705. ┌──────────────────────────╖
  706. │ Acquisition Viewer 1.20  ║
  707. └══════════════════════════╝
  708.  
  709.  
  710. 1)  Maximum number of files in one directory has been increased to
  711.     2,000.
  712.  
  713. 2)  A bug in the RIP portion of the viewer which caused the colors
  714.     of plotted objects to display improperly has been squashed.
  715.  
  716. 3)  RIP code has been optimized for speed, and it is now possible to
  717.     abort the screens.
  718.  
  719. 4)  Scrolled viewing has since been implemented, and 320x200x256 MCGA
  720.     display modes are now supported.
  721.  
  722. 5)  The old font has been replaced with a new character set, and a new
  723.     interface has been added which features icons.
  724.  
  725.  
  726. ┌──────────────────────────╖
  727. │ Bugs?                    ║
  728. └══════════════════════════╝
  729.  
  730.  
  731.         Did you find any Bugs?  If so, contact me at the board below...
  732.  
  733.  
  734.                              · The End of TiME ·
  735.                          New Age World HeadQuarters
  736.                         /┤CiD South Carolina Outpost
  737.                     PsychoSquad US HQ - HypernovA US HQ
  738.            Anarchy/PC US HQ - Taurus US HQ - Synergy Design US HQ
  739.       Dust Dist - Future Crew Dist  - VLA Dist - Imphobia Dist - DaRK Dist
  740.        SoundBoard Connection - Demo Productions Network - FEDNet - PPEnet
  741.           United States HeadQuarters for the Creativity Demo Net [CDN]
  742.                   One of the best PC Demo boards in the world
  743.                     Running PCBoard 15.0 totally customized
  744.                       PC Demos/Music/Grafix/ANSI Support
  745.                        Staff: The Hit M/┤N & Holy Water
  746.                          USRobotics 21.6k Dual v.Terbo
  747.                               High Speed Required
  748.                                - 8O3-855-O783 -
  749.  
  750.  
  751.       Greetings go out to...
  752.  
  753.  
  754.       Holy Water      New Age       Don't I know you?
  755.       Acidic          ACiD          Craaaaaawwwwwllll
  756.       Beastie         ACiD          ".YLLAER" ,gnihtoN
  757.       Cetis           ACiD          "Coded for the masses, not for the few."
  758.       Fear            ACiD          Time is near, near for fear.
  759.       RaD Man         ACiD          What will it tak--All hail.
  760.       Soul Rebel      iCE           Uck.  You STILL suck. . . heh heh heh. . .
  761.       [Your Handle]   [Your Group]  80x25 is an exact 1:1 scale-down!
  762.