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