1290 lines
51 KiB
Plaintext
1290 lines
51 KiB
Plaintext
|
|
,gg
|
|
""""Y$b ,d$P""Y$b ,d$P ,d$P""Y$$'
|
|
,d$P""Y$$' ,$$' `""" ,$$' ,$$' ,$$'
|
|
,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$'
|
|
",$$' ",$$' ,$$' ",$$' ,$$' ,$$' ",$$' """"""""""""""""""""" " "" "" " """ "
|
|
,$$' .$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$ ,d$"""Y$b ,$$' ,$$' ,$$
|
|
`"""""""' `"""""""' `"' `"""""""' ,$$' ,$$' ,$$' ,$$""""""' ,$$' ,$$' ,$$'
|
|
,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$'
|
|
" " "" "" """ """"""""""""""" ,$$' ",$$' ,$$ ,$$' ",$$' ,$$' ,$$' ,$$'
|
|
,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$' ,$$'
|
|
`"""""""' `"' `"""""""' `"""""""""""'
|
|
|
|
|
|
ACiD Productions(tm)' Acquisition Enhanced File Viewer
|
|
Coded by Skull Leader and Tasmaniac
|
|
Screens by Lord Jazz
|
|
|
|
Ú¿ÄÄÄ ÄÄ Ä Ä ÄÄ ÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄ ùù
|
|
ÀÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
|
|
³³ Documentation and Update History of ACiD Productions' ACiD View ³ù
|
|
:³ ³:
|
|
ù³ By Skull Leader and RaD Man of ACiD Productions(tm) ³³
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅ¿
|
|
ùù ÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ ÄÄ Ä Ä ÄÄ ÄÄÄÀÙ
|
|
|
|
[ Current version of ACiD View : 4.30 / 09-01-1996ù04:30 ]
|
|
|
|
Note: This is a full release of ACiD View IV, but there is always the
|
|
possibility that you may encounter a bug or two. If you have
|
|
any questions, comments, suggestions or bug reports regarding this
|
|
release, please direct them to us at acid-public@acid.org via
|
|
the internet, or on the Utilities Discussion base on AgoraNet.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Introduction to ACiD View º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
ACiD View welcomes you to the most comprehensive Art View-
|
|
er in production. This innovative program is capable of dis-
|
|
playing ANSI, BIN, GIF, JPG, RIPscrip and XBIN graphics. In
|
|
addition, the viewer has been designed with a special the
|
|
viewer has been designed with a special interest for those who
|
|
multitask. ACiD View utilizes its own internal ANSI routines,
|
|
making it capable of viewing ANSI without a separate device
|
|
driver. We hope that ACiD View provides you with as much
|
|
pleasure as we intended with its creation.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Features º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
þ Now supporting our very own special SAUCE
|
|
þ Command Line Viewing
|
|
þ Variable Speed ANSI Viewing
|
|
þ XMS Support
|
|
þ Slide Show Viewing (File Tagging)
|
|
þ Modem-Simulation for ANSI Viewing (Doesn't affect multitaskers)
|
|
þ Different file listing methods, including detailed information
|
|
þ File Masking (Six possible masks)
|
|
þ Drive and Directory switching
|
|
þ Level 0-1 RIP Viewing, with multiple fonts built in
|
|
þ Smoothscroll, Textscroll, and Autoscroll ANSI, BIN and XBIN Viewing
|
|
þ 25-, 28-, 30-, 35-, 43-, and 50-line mode ANSI and BIN Viewing
|
|
þ Fully-Features ANSI Scroll Back in several different video modes
|
|
þ ANSI and BIN Viewing in 80x25 or 80x50 text modes
|
|
þ ANSI and BIN Viewing in 320x200x256 MXGA mode
|
|
þ ANSI and BIN Viewing in 320x400x256 XGA mode
|
|
þ ANSI and BIN Viewing in 640x480x16 VGA mode
|
|
þ ANSI and BIN Viewing in 640x400, 640x480, 800x600, and 1024x768x256
|
|
SVGA modes
|
|
þ GIF Viewing
|
|
þ JPEG Viewing
|
|
þ Support for most SVGA chipsets and VESA
|
|
þ File deleting capability
|
|
þ Full mouse support
|
|
þ Screen capturing, in .GIF format.
|
|
þ Number of ANSI lines and files in a directory limited only by
|
|
how much memory is available.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Requires º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
þ EGA graphics (preferably SVGA)
|
|
þ 286 or better processor
|
|
þ about 500K of conventional memory (more memory = bigger ANSIs)
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ What ACiD View Displays º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
þ ACiD View will display ANSI screens in several different video
|
|
modes. These modes include the default, text mode, 640x480x16
|
|
VGA, 320x200x256 MCGA, 320x400x256 XGA, 640x400, 640x480,
|
|
800x600, and 1024x768x256 VESA SVGA modes. ACiD View also
|
|
supports most SVGA chipsets.
|
|
|
|
þ ACiD View displays most low level (0-1) RIPscrips. Although
|
|
it will show all of the RIPs presented in the Acquisition, it
|
|
may not display some of the other RIPs you own. This is due
|
|
to the fact that some of the higher level RIP commands have
|
|
not been implemented. Several fonts including 8x8, Triplex,
|
|
Small Font, Sans Serif, Gothic, Simplex, Complex, European,
|
|
and Bold Outline have been added.
|
|
|
|
þ ACiD View can show GIF and JPEG graphics files. The video mode
|
|
for these formats is selected automaticly. If a mode that is
|
|
capable of showing the entire picture is not found, the picture
|
|
is not shown.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ ACiD View Functions º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
Funtion Keys
|
|
Esc KeyPad ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
|
|
ÚÄÄÄÄ¿ ÚÄÄÄÄÄÄÂÄÄÄÄÄÄÂÄÄÄÄÄÄÂÄÄÄÄÄ¿ ³ F1 = Help ³
|
|
³Exit³ ³ Num ³ Next ³ Prev ³ - ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
ÀÄÄÄÄÙ ³ Lock ³ Font ³ Font ³ Res ³ ³ F2 = Switch Video Mode ³
|
|
ÃÄÄÄÄÄÄÅÄÄÄÄÄÄÅÄÄÄÄÄÄÅÄÄÄÄÄ´ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
Tab ³ Home ³ Up ³ Page ³ ³ ³ F3 = Switch Font Size ³
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄ¿ ³ ³ ³ Up ³ ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
³ SAUCE Mode³ ÃÄÄÄÄÄÄÅÄÄÄÄÄÄÅÄÄÄÄÄÄ´ + ³ ³ F4 = Switch Line Mode ³
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÙ ³ Left ³ Tag ³ Right³ Res ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
³ ³ File ³ ³ ³ ³ F5 = Toggle Smoothscroll ³
|
|
Enter ÃÄÄÄÄÄÄÅÄÄÄÄÄÄÅÄÄÄÄÄÄÅÄÄÄÄÄ´ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
ÚÄÄÄÄÄÄÄÄÄ¿ ³ End ³ Down ³ Page ³ ³ ³ F6 = Toggle Autoscroll ³
|
|
³View File³ ³ ³ ³ Down ³ ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
ÀÄÄÄÄÄÄÄÄÄÙ ÃÄÄÄÄÄÄÁÄÄÄÄÄÄÅÄÄÄÄÄÄ´Enter³ ³ F7 = Toggle BPS ³
|
|
³ Insert ³ Del ³ ³ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
³ ³ ³ ³ ³ F8 = Toggle Color/Grey/B&W ³
|
|
Space ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÁÄÄÄÄÄÙ ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ ³ F9 = Toggle Ext/Blinking ³
|
|
³Tag/Untag File(s) ³ ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
|
|
|
|
|
|
ÚÄÄÄÄ·
|
|
³ F1 º Quick-Help : Brief description of the keys.
|
|
ÀÍÍÍͼ
|
|
|
|
ÚÄÄÄÄ·
|
|
³ F2 º Video Mode : Selects the video mode that the selected ANSI
|
|
ÀÍÍÍͼ or BIN is to be viewed in. Note: GIF and PCX
|
|
will auto detect the appropriate mode, if a mode
|
|
large enough to fit the entire picture is not
|
|
found, the file is not displayed.
|
|
|
|
þ Text - 80x25 or 80x50 (VGA) text mode, depending on
|
|
the aspect ratio.
|
|
|
|
þ XGA - Displays in 320x200x256 tweaked "Mode X" mode.
|
|
|
|
þ MXGA - Displays in 320x400x256 tweaked "Mode X" mode.
|
|
|
|
þ VGA - Displays in 640x400x16 VGA mode.
|
|
|
|
þ SVGA1 - Displays in 640x400x256 SVGA mode
|
|
|
|
þ SVGA2 - Displays in 640x480x256 SVGA mode
|
|
|
|
þ SVGA3 - Displays in 800x600x256 SVGA mode
|
|
|
|
þ SVGA4 - Displays in 1024x768x256 SVGA mode
|
|
|
|
|
|
ÚÄÄÄÄ·
|
|
³ F3 º Font Size : This determines the font size to be used while
|
|
ÀÍÍÍͼ displaying an ANSI in a VGA mode.
|
|
|
|
ÚÄÄÄÄ·
|
|
³ F4 º Line Modes : Toggles which line mode will be used while
|
|
ÀÍÍÍͼ displaying ANSI in Text Video Mode.
|
|
|
|
ÚÄÄÄÄ·
|
|
³ F5 º Smoothscroll : Toggles if the ANSI will be displayed line-by-line
|
|
ÀÍÍÍͼ or pixel-by-pixel in Text Video Mode.
|
|
|
|
ÚÄÄÄÄ·
|
|
³ F6 º Autoscroll : Toggles if the ANSI will scroll down automatically
|
|
ÀÍÍÍͼ or if you must control the viewing manually.
|
|
|
|
ÚÄÄÄÄ·
|
|
³ F7 º BPS Simulation : Changes the BPS simulation speed for ANSIs in
|
|
ÀÍÍÍͼ View mode.
|
|
|
|
ÚÄÄÄÄ·
|
|
³ F8 º Color Mode : This is usually set to Color, however it can be
|
|
ÀÍÍÍͼ set to Grey to do greyscale or ASCII to strip
|
|
the color from ANSIs and BINs.
|
|
|
|
ÚÄÄÄÄ·
|
|
³ F9 º Toggle Blink : Determines if 16 background colors instead of
|
|
ÀÍÍÍͼ blinking will be used for ANSI and BIN display.
|
|
|
|
|
|
ÚÄÄÄÄÄ·
|
|
³ F10 º Capture Screen : When this is pressed when a ansi or rip is being
|
|
ÀÍÍÍÍͼ viewed, a image of the screen will be saved in
|
|
.GIF format, in the current directory. The file
|
|
name for this capture file is AVCAPXX.GIF where
|
|
XX is a number which increases with the number of
|
|
captured files. Note- This does not work during
|
|
viewing of an ansi in text mode, nor does it work
|
|
properly for VGA mode 320x400.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ ACiD View Alternative Functions º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
ALT-D : When a file is selected, and this key combination
|
|
is pressed, a confirmation message will apear.
|
|
Hitting "Y" at this message will allow you do
|
|
delete the file.
|
|
|
|
ÚÄÄÄÄÄ·
|
|
³ TAB º : Toggles between three different file display options
|
|
ÀÍÍÍÍͼ including regular with sauce, multiple columns,
|
|
and full file information.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ ACiD View Command Line Viewing º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
ACiD View now allows the ability for command line viewing. There are
|
|
several option available. (These option can be obtained by running
|
|
ACiD View with the -h, switch when calling ACiDVIEW)
|
|
|
|
|
|
ACiDVIEW [/R:#] [/F:#] [/C:{C,G,A}] [/SMOOTH] [/AUTO] [/B:#] @Filename(s)/Mask
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
|
|
³Resolution(R)³³ Font(F) ³³ /C /SMOOTH ³
|
|
ÃÄÄÄÂÄÄÄÄÄÄÄÄÄ´ÃÄÄÄÂÄÄÄÄÄÂÄÄÄÄÄ´³ C = Color Smooth Scroll ³
|
|
³ 1 ³ Text ³³ ³TEXT ³ VGA ³³ G = Grey /AUTO ³
|
|
³ 2 ³ 320x200 ³³ ÃÄÄÄÄÄÁÄÄÄÄÄ´³ A = Ascii Auto Scroll ³
|
|
³ 3 ³ 320x400 ³³ 1 ³ 25L ³ 1x2 ³ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
|
|
³ 4 ³ 640x400v³³ 2 ³ 28L ³ 2x2 ³ @Filename - Text file containg list of files.
|
|
³ 5 ³ 640x400 ³³ 3 ³ 30L ³ 1x4 ³ One filename per line.
|
|
³ 6 ³ 640x680 ³³ 4 ³ 35L ³ 2x4 ³
|
|
³ 7 ³ 800x600 ³³ 5 ³ 43L ³ 4x4 ³ Filename(s) - Single file, or multiple.
|
|
³ 8 ³1024x768 ³³ 6 ³ 50L ³ 4x8 ³
|
|
ÀÄÄÄÁÄÄÄÄÄÄÄÄÄÙÀÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÙ Mask - Mask for files to view.
|
|
|
|
|
|
@Filename - This is the name of a regular text file containing a list of
|
|
files which are to be viewed, in respective order. This list
|
|
can contain the name of any file, ACiD View will automatically
|
|
determine which format the file is in. Wildcards are not
|
|
not supported in this text file. Invalid file(s) will not be
|
|
displayed, just skipped over.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ What is SAUCE? º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
Recipe for SAUCE
|
|
|
|
Chef cuisinier : Tasmaniac / ACiD
|
|
Maitre d'h“tel : Rad Man / ACiD
|
|
|
|
ANSi's used to be just ANSi's, pictures were just pictures,
|
|
loaders were just loaders and quite frankly, every file was just
|
|
as plain tasting as every other. This is about to change, how-
|
|
ever, because ACiD has decided to give their files an extra
|
|
"je-ne-sais-quoi." In reality, we'll be adding SAUCE to every
|
|
file you can imagine.
|
|
|
|
Now, before we thoroughly confuse you, let us explain what we
|
|
are doing here. SAUCE stands for "Standard Architecture for
|
|
Universal Comment Extensions." Although originally intended for
|
|
personal use in ANSi's and RIP screens, early in the developement
|
|
of EFI (Extended File Information) it was decided that EFI should
|
|
be extended to have support for more than just ANSi and RIP
|
|
screens. Our brainchild was born and the specs were designed.
|
|
The only aspect left undecided was the name, and after rejecting
|
|
some very funny candidates, SAUCE was unanimously chosen. This
|
|
leads us to the big question in the sky, "What is SAUCE ?" SAUCE
|
|
is a universal process to incorporate a full description for any
|
|
type of file. The most outstanding aspect of this concept is that
|
|
you have access to the complete file name, the file's title, the
|
|
creation date, the creator of the file, the group that the creator
|
|
is employed by, and much, much, more.
|
|
|
|
A full explanation on how you can implement SAUCE is
|
|
described at the end of this document in the PLATES (Programming
|
|
Language Architecture To Extract SAUCE) section. Although you can
|
|
create your own programs to implement SAUCE to your files, we
|
|
recommend that you use the SPOON.EXE program to ensure a greater
|
|
universal compatibility.
|
|
|
|
SAUCE already supports a plethora of filetypes (See PLATES).
|
|
If you have a need for the SAUCE specifications, please contact us
|
|
before you make the changes yourself. We will accomodate your
|
|
needs as soon as possible. After all, SAUCE is designed to become
|
|
a standard, and if people change the specs without allowing us to
|
|
make a complete update, there will be no standard. In the event
|
|
that we change SAUCE, we will quickly release a public update
|
|
which will most definately include an improved and updated
|
|
SPOON.EXE.
|
|
|
|
SAUCE has advantages over any other system in use. Each
|
|
description will be added to the file and will provide a file
|
|
description no matter what computer it is used for. SAUCE, how-
|
|
ever, also provides a back compatibility that uses a file with
|
|
descriptions for those files that do NOT already have a SAUCE
|
|
description. Processing in this manner is fully implemented in
|
|
SPOON.EXE and one can extract embedded SAUCE to this data file and
|
|
add SAUCE to files from this data file.
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
|
|
³ ³
|
|
³ ! NOTICE ! ³
|
|
³ ³
|
|
³ SAUCE was initially created for supporting only the ANSi & RIP ³
|
|
³ screens. Since both ANSi and RIP are in effect text-based and ³
|
|
³ have no other form of control, SAUCE never interferes with the ³
|
|
³ workings of a program using either ANSi or RIP. If it does, ³
|
|
³ the program is not functioning the way it should. ³
|
|
³ This is _NOT_ true for the other types of file SAUCE supports ³
|
|
³ however. Adding SAUCE to some of the other filetypes supported ³
|
|
³ in the SAUCE specifications may have serious consequences on ³
|
|
³ the proper functioning of other programs using those files, ³
|
|
³ In the worst case, they'll simply refuse the file, stating it ³
|
|
³ is invalid. ³
|
|
³ ³
|
|
³ It's not up to us to decide whether or not adding SAUCE is a ³
|
|
³ bad thing. The one who added the SAUCE to the file should be ³
|
|
³ fully aware of any problems that can arise when 'SAUCEing' a ³
|
|
³ file other than the 'Character' or XBIN datatypes. ³
|
|
³ ³
|
|
³ You may have your own specialized viewing/editing tools and ³
|
|
³ simply not care about the file not being recognized in other ³
|
|
³ viewing/editing programs. ³
|
|
³ ³
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
|
|
|
|
|
|
PLATES
|
|
------
|
|
|
|
Let us begin with a description of the record layouts used.
|
|
The record layouts and code examples are in a variated pascal
|
|
pseudo code, and should be transferrable enough to implement in
|
|
most other programming languages. For ease of reading, the
|
|
examples assume that the file is correct and that no error-
|
|
checking need be included. How rigorous you check for errors is
|
|
completely up to you, and will most likely depend on the file type
|
|
you are describing.
|
|
|
|
|
|
SAUCE RECORD
|
|
------------
|
|
|
|
This portion of the documentation is about the SAUCE record.
|
|
The SAUCE record describes the file in short, and provides other
|
|
information not included in the SAUCE record itself.
|
|
|
|
A sauce record is _EXACTLY_ 128 bytes in size.
|
|
|
|
Fieldname : Name of the field.
|
|
Size : Size of the field in BYTES
|
|
Type : Type of data. This can be :
|
|
BYTE : One byte unsigned numeric value (0 to 255)
|
|
WORD : Two byte unsigned numeric value (0 to 65535)
|
|
INTEGER : Two byte signed numeric value (-32768 to 32767)
|
|
LONG : Four byte signed numeric value (-2147483648 to 2147483647)
|
|
CHARACTER : One byte ASCII value. Longer character fields are
|
|
padded with spaces. It is _NOT_ a PASCAL string (with a
|
|
leading length byte), and it's _NOT_ a C-Style string
|
|
(with a trailing nul-byte). A 10 byte character field
|
|
holding the text 'ANSI' would look like this: 'ANSI '.
|
|
|
|
Numeric fields should be zero when not used, character fields
|
|
should be all spaces when not used.
|
|
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
No fields are REQUIRED to be filled in except for ID, Version, FileSize,
|
|
DataType and FileType.
|
|
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|
|
|
V# : SAUCE Version number. This indicates the version of
|
|
SAUCE when the field was implemented.
|
|
|
|
Description : Complete description of the field.
|
|
|
|
FieldName Size Type V# Description
|
|
--------- ---- --------- -- -----------
|
|
ID 5 Character 00 SAUCE Identification. This should be equal to
|
|
'SAUCE' or the record is not a valid SAUCE
|
|
record.
|
|
Version 2 Character 00 Version number of SAUCE. Current version is
|
|
'00'. As new features are added to the
|
|
specifications of SAUCE, this version number
|
|
will change. Future versions SHOULD remain
|
|
compatible with version 00 only ADDING on
|
|
the specifications, it is however not unlikely
|
|
that this compatibility is impossible to
|
|
maintain, but this is of no concern now.
|
|
Title 35 Character 00 Title of the file.
|
|
Author 20 Character 00 Name or handle of the creator of the file.
|
|
Group 20 Character 00 Name of the group/company the creator is
|
|
employed by.
|
|
Date 8 Character 00 Date the file was created. This date is in
|
|
the format CCYYMMDD (Century, year, month,
|
|
day). By storing it in this way, it's very
|
|
easy to sort SAUCE records by date.
|
|
FileSize 4 Long 00 Original filesize NOT including any
|
|
information of SAUCE.
|
|
DataType 1 Byte 00 Type of Data. (See DATATYPES further on)
|
|
FileType 1 Byte 00 Type of File. (See DATATYPES further on)
|
|
TInfo1 2 Word 00 Numeric information field 1 (See DATATYPES)
|
|
When used, this field holds informative
|
|
values. Any program using SAUCE should not
|
|
rely on these values being correct or filled
|
|
in.
|
|
TInfo2 2 Word 00 Numeric information field 2 (See DATATYPES)
|
|
TInfo3 2 Word 00 Numeric information field 3 (See DATATYPES)
|
|
TInfo4 2 Word 00 Numeric information field 4 (See DATATYPES)
|
|
Comments 1 Byte 00 Number of Comment lines (See COMMENTS)
|
|
Flags 1 Byte * 00 Flags indication optional settings/switches
|
|
These flags have different meaning depending
|
|
on the datatype & filetype .
|
|
The flags weren't originally in the concept
|
|
for version 00 of SAUCE. But since the
|
|
specification of SAUCE expects all filler
|
|
bytes to be binary zero, the flags should be
|
|
set to ZERO in all previous files, and cause
|
|
no harm.
|
|
|
|
|
|
An Example PASCAL record looks like this:
|
|
|
|
TYPE SAUCERec = RECORD
|
|
ID : Array[1..5] of Char;
|
|
Version : Array[1..2] of Char;
|
|
Title : Array[1..35] of Char;
|
|
Author : Array[1..20] of Char;
|
|
Group : Array[1..20] of Char;
|
|
Date : Array[1..8] of Char;
|
|
FileSize : Longint;
|
|
DataType : Byte;
|
|
FileType : Byte;
|
|
TInfo1 : Word;
|
|
TInfo2 : Word;
|
|
TInfo3 : Word;
|
|
TInfo4 : Word;
|
|
Comments : Byte;
|
|
Flags : Byte;
|
|
Filler : Array[1..22] of Char;
|
|
END;
|
|
|
|
An Example C record looks like this:
|
|
|
|
typedef SAUCEREC {
|
|
char ID[5];
|
|
char Version[2];
|
|
char Title[35];
|
|
char Author[20];
|
|
char Group[20];
|
|
char Date[8];
|
|
signed long FileSize;
|
|
unsigned char DataType;
|
|
unsigned char FileType;
|
|
unsigned short TInfo1;
|
|
unsigned short TInfo2;
|
|
unsigned short TInfo3;
|
|
unsigned short TInfo4;
|
|
unsigned char Comments;
|
|
unsigned char Flags;
|
|
char Filler[22];
|
|
} SAUCEREC;
|
|
|
|
|
|
DATATYPES
|
|
---------
|
|
DataType and FileType hold the information needed to deter-
|
|
mine what type of file it is.
|
|
|
|
There are 5 DataTypes, these are (with their respective numeric values) :
|
|
0) None : Undefined filetype, you could use this to add SAUCE
|
|
information to personal datafiles needed by programs,
|
|
but not having any other meaning.
|
|
1) Character : Any character based file. Examples are ASCII, ANSi and
|
|
RIP.
|
|
2) Graphics : Any bitmap graphic file. Examples are GIF, LBM, and
|
|
PCX.
|
|
3) Vector : Any vector based graphic file. Examples are DXF and
|
|
CAD files.
|
|
4) Sound : Any sound related file. Examples are samples, MOD
|
|
files and MIDI.
|
|
5) BinaryText: This is RAW memory copy of a text screen. It's
|
|
basically the BIN format you can save from whitin
|
|
TheDraw. Each character is built up of two consecutive
|
|
bytes. The first is the character to be displayed. The
|
|
second is the Attribute byte.
|
|
6) XBIN : XBIN is the so called eXtended BIN format. It is
|
|
similar to the BinaryText, but provides for fonts,
|
|
palettes, and has built-in compression.
|
|
7) Archive : Any type of archive. Examples are ARC, ZIP, ARJ and
|
|
LZH.
|
|
8) Executable: Any file that is executable.
|
|
|
|
|
|
None
|
|
----
|
|
When using the 'None' datatype, you should have FileType set to
|
|
zero also. This is a compatibility issue as it's not unlikely,
|
|
the 'None' datatype will have filetypes in the future.
|
|
|
|
Character
|
|
---------
|
|
When using the 'Character' datatype, you have following filetypes
|
|
available :
|
|
|
|
0) ASCII : Plain text file with no formatting codes or color codes.
|
|
TInfo1 is used for the width of the file.
|
|
TInfo2 is used to hold the number of lines in the file.
|
|
1) ANSi : ANSi file. With ANSi color codes and cursor
|
|
positioning.
|
|
TInfo1 is used for the width of the file.
|
|
TInfo2 is used to hold the number of ANSi screen lines
|
|
in the file.
|
|
2) ANSiMation: ANSi Animation. With ANSi color codes and cursor
|
|
positioning. While an ANSi file can also have animated
|
|
sequences, there is a clear distinction. While an ANSi
|
|
may or may not have a beginning animated sequence
|
|
introducing the group or artist the rest is just a
|
|
sequence of colored characters. An ANSiMation on the
|
|
other hand is a more like a text mode cartoon.
|
|
TInfo1 is used for the width of the file.
|
|
TInfo2 is used to hold the number of ANSi screen lines
|
|
the ANSiMation was created for.
|
|
A program using SAUCE may use these two values to
|
|
switch to the appropriate video mode.
|
|
3) RIP : Remote Imaging Protocol (RIP) graphics file.
|
|
TInfo1 holds the width (should be 640)
|
|
TInfo2 holds the height (should be 350)
|
|
TInfo3 holds the number of colors (should be 16)
|
|
4) PCBoard : File with PCBoard style @X color codes and @ macro's
|
|
and ANSi codes.
|
|
TInfo1 is used for the width of the file.
|
|
TInfo2 is used to hold the number of ANSi screen lines
|
|
in the file.
|
|
5) AVATAR : A file with AVATAR and ANSi color codes and cursor
|
|
positioning.
|
|
6) HTML : HyperText Markup Language. The type of file used on
|
|
World Wide Web (WWW).
|
|
7) SOURCE : A piece of sourcecode for any type of programming
|
|
language. The file extention should determine the
|
|
programming language (.C=C, .PAS=Pascal, ...)
|
|
|
|
FLAGS for the Character Datatype.
|
|
-----
|
|
ÚÄ 7 ÄÂÄ 6 ÄÂÄ 5 ÄÂÄ 4 ÄÂÄ 3 ÄÂÄ 2 ÄÂÄ 1 ÄÂÄ 0 Ä¿
|
|
³ ³ ³ ³ ³ ³ ³ ³ ³
|
|
³ 0 ³ 0 ³ 0 ³ 0 ³ 0 ³ 0 ³ 0 ³ A ³
|
|
³ ³ ³ ³ ³ ³ ³ ³ ³
|
|
ÀÄÄÄÄÄÁÄÄÄÄÄÁÄÄÄÄÄÁÄÄÄÄÄÁÄÄÄÄÄÁÄÄÄÄÄÁÄÄÄÄÄÁÄÄÄÄÄÙ
|
|
|
|
All non-used bits should be ZERO.
|
|
|
|
A) Non-Blink mode (iCE Color).
|
|
When this bit is SET (equal to 1) The ANSi is created using iCE
|
|
color codes. This is a special mode where the blinking is
|
|
disabled, and you have 16 background colors available. Basically,
|
|
you have the same choice for background colors as for foreground
|
|
colors.
|
|
|
|
Please note:
|
|
|
|
When the picture does not make specific use of the iCE color, you
|
|
should NOT have this bit set. When you do not support the iCE
|
|
color mode, you should probably not display the file as it could
|
|
look pretty weird in normal mode.
|
|
|
|
|
|
Graphics
|
|
--------
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
|
|
³ WARNING: Adding SAUCE to some of these files can make them ³
|
|
³ invalid. See the NOTICE at the start of this document. ³
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
|
|
|
|
For all graphics types, TInfo1 holds width of the image, TInfo2
|
|
holds the Height of the image and TInfo3 holds the number of bits
|
|
per pixel (a 256 colour image would have 8 bits per pixel, a
|
|
TrueColour image would have 24);
|
|
|
|
Following Graphics filetypes are available :
|
|
|
|
0) GIF (CompuServe Graphics Interchange format)
|
|
1) PCX (ZSoft Paintbrush PCX format)
|
|
2) LBM/IFF (DeluxePaint LBM/IFF format)
|
|
3) TGA (Targa Truecolor)
|
|
4) FLI (Autodesk FLI animation file)
|
|
5) FLC (Autodesk FLC animation file)
|
|
6) BMP (Windows or OS/2 Bitmap)
|
|
7) GL (Grasp GL Animation)
|
|
8) DL (DL Animation)
|
|
9) WPG (Wordperfect Bitmap)
|
|
10) PNG (Portable Graphics)
|
|
11) JPG (JPeg compressed File)
|
|
12) MPG (MPeg compressed animation/video)
|
|
13) AVI (Audio Visual Interlace)
|
|
|
|
FLAGS
|
|
-----
|
|
Not used, should be all zeroes.
|
|
|
|
|
|
Vector
|
|
------
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
|
|
³ WARNING: Adding SAUCE to some of these files will make them ³
|
|
³ invalid. See the NOTICE at the start of this document. ³
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
|
|
|
|
Following Vector filetypes are available :
|
|
0) DXF (CAD Data eXchange File)
|
|
1) DWG (AutoCAD Drawing file)
|
|
2) WPG (WordPerfect/DrawPerfect vector graphics)
|
|
3) 3DS (3D Studio file).
|
|
|
|
FLAGS
|
|
-----
|
|
Not used, should be all zeroes.
|
|
|
|
|
|
Sound
|
|
-----
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
|
|
³ WARNING: Adding SAUCE to some of these files will make them ³
|
|
³ invalid. See the NOTICE at the start of this document. ³
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
|
|
|
|
Following sound filetypes are available :
|
|
0) MOD (4, 6 or 8 channel MOD/NST file)
|
|
1) 669 (Renaissance 8 channel 669 format)
|
|
2) STM (Future Crew 4 channel ScreamTracker format)
|
|
3) S3M (Future Crew variable channel ScreamTracker3 format)
|
|
4) MTM (Renaissance variable channel MultiTracker Module)
|
|
5) FAR (Farandole composer module)
|
|
6) ULT (UltraTracker module)
|
|
7) AMF (DMP/DSMI Advanced Module Format)
|
|
8) DMF (Delusion Digital Music Format (XTracker))
|
|
9) OKT (Oktalyser module)
|
|
10) ROL (AdLib ROL file (FM))
|
|
11) CMF (Creative Labs FM)
|
|
12) MIDI (MIDI file)
|
|
13) SADT (SAdT composer FM Module)
|
|
14) VOC (Creative Labs Sample)
|
|
15) WAV (Windows Wave file)
|
|
16) SMP8 (8 Bit Sample, TInfo1 holds sampling rate)
|
|
17) SMP8S (8 Bit sample stereo, TInfo1 holds sampling rate)
|
|
18) SMP16 (16 Bit sample, TInfo1 holds sampling rate)
|
|
19) SMP16S (16 Bit sample stereo, TInfo1 holds sampling rate)
|
|
20) PATCH8 (8 Bit patch-file)
|
|
21) PATCH16(16 Bit Patch-file)
|
|
22) XM (FastTracker ][ Module)
|
|
23) HSC (HSC Module)
|
|
|
|
FLAGS
|
|
-----
|
|
Not used, should be all zeroes.
|
|
|
|
|
|
BinaryText
|
|
----------
|
|
The Binary Text format, basically has no Filetype, since the datatype
|
|
has already defined how the file will look.
|
|
The FileType however specifies the WIDTH of the BinaryText screen.
|
|
Only the Width is required, as the Height can be calculated by dividing
|
|
the filesize by the Width.
|
|
In an attempt to provide as much WIDTH as possible in a possible 256
|
|
values of the Byte-sized FileType. The width is specified in Multiples
|
|
of 2. The fact that the Width is specified in multiples of 2 isn't
|
|
really a problem, since you also need to define the effective screen
|
|
size in multiples of 2.
|
|
|
|
An example : For normal 80*25 binary images as made with TheDraw the
|
|
FileType value would be 40 (since 2*40 equals 80 <g>)
|
|
All you need to do is divide the width of the binary text
|
|
image by 2. This gives a maximum width of 510 characters.
|
|
Although currently not supported, should there be a need
|
|
for even bigger images, this can be arranged.
|
|
|
|
Please note. BinaryText expects the character-attribute pairs to be
|
|
stored one row at a time. If you wanted to create a 80*100 Image, you
|
|
could do this by just copying 4 80*25 or 2 80*50 together to form one
|
|
bigger image.
|
|
If for example you wanted to create a 160*25 image from 2 80*25 images,
|
|
you would need to write a little program which would copy line 1 from
|
|
image 1, line 1 from image 2, Line 2 from Image 1, Line 2 from Image 2
|
|
and so on.
|
|
Basically, you should have all character-attribute pairs from one line
|
|
of the COMPLETE image one after the other, followed by all
|
|
char-attribute pairs from the next row, and so on.
|
|
|
|
If the picture does not fit this format. You should use the NONE
|
|
datatype. Besides, you'd probably want to have it in this format
|
|
anyway, as it seems to be the most logical approach to have these kind
|
|
of images.
|
|
|
|
FLAGS for the BinaryText Datatype.
|
|
-----
|
|
ÚÄ 7 ÄÂÄ 6 ÄÂÄ 5 ÄÂÄ 4 ÄÂÄ 3 ÄÂÄ 2 ÄÂÄ 1 ÄÂÄ 0 Ä¿
|
|
³ ³ ³ ³ ³ ³ ³ ³ ³
|
|
³ 0 ³ 0 ³ 0 ³ 0 ³ 0 ³ 0 ³ 0 ³ A ³
|
|
³ ³ ³ ³ ³ ³ ³ ³ ³
|
|
ÀÄÄÄÄÄÁÄÄÄÄÄÁÄÄÄÄÄÁÄÄÄÄÄÁÄÄÄÄÄÁÄÄÄÄÄÁÄÄÄÄÄÁÄÄÄÄÄÙ
|
|
|
|
All non-used bits should be ZERO.
|
|
|
|
A) Non-blink mode (iCE Color).
|
|
This bit has exactly the same meaning as for the Character
|
|
datatype. It indicates whether the picture uses iCE color.
|
|
|
|
|
|
XBIN
|
|
----
|
|
The XBIN datatype has no other filetypes. Further specification son
|
|
the XBIN format are available in the XBIN archive or on the XBIN Web
|
|
page.
|
|
The filetype should be zero.
|
|
TInfo1 holds width of the image, TInfo2 holds the Height of the image.
|
|
|
|
FLAGS
|
|
-----
|
|
Not used, should be all zeroes.
|
|
|
|
|
|
Archive
|
|
-------
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
|
|
³ WARNING: Adding SAUCE to some of these files can make them ³
|
|
³ invalid. See the NOTICE at the start of this document. ³
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
|
|
|
|
Following sound filetypes are available :
|
|
0) ZIP (PKWare)
|
|
1) ARJ (Robert K. Jung)
|
|
2) LZH (Haruyasu Yoshizaki (Yoshi))
|
|
3) ARC (SEA)
|
|
4) TAR (Unix TAR format)
|
|
5) ZOO
|
|
6) RAR
|
|
7) UC2
|
|
8) PAK
|
|
9) SQZ
|
|
|
|
FLAGS
|
|
-----
|
|
Not used, should be all zeroes.
|
|
|
|
|
|
Executable
|
|
----------
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
|
|
³ WARNING: Adding SAUCE to some of these files can make them ³
|
|
³ invalid. See the NOTICE at the start of this document. ³
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
|
|
|
|
The executable datatype has no other filetypes. Executables usually
|
|
have any of the following file extentions : BAT, COM, EXE, OVL, OVR,
|
|
DLL, ...
|
|
The filetype should be zero.
|
|
|
|
FLAGS
|
|
-----
|
|
Not used, should be all zeroes.
|
|
|
|
|
|
|
|
COMMENTS
|
|
--------
|
|
The comment block is an addition to the SAUCE record. It
|
|
holds up to 255 lines of additional information. Each line 64
|
|
characters wide.
|
|
|
|
When the Comments field is not zero, it holds the number of
|
|
additional comment lines available. A single comment line is 64
|
|
characters long. Like the character fields in the SAUCE record,
|
|
it is padded with spaces, and has no leading length byte or
|
|
trailing null-byte.
|
|
|
|
The comment block is preceded with a 5 character identifi-
|
|
cation mark. This identification mark is 'COMNT'.
|
|
|
|
|
|
SAUCE IN FILES
|
|
--------------
|
|
A file with SAUCE added to it. Will look like this:
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
|
|
³ ³
|
|
³ FILE DATA ³ Actual file data. As if it would be without SAUCE.
|
|
³ ³
|
|
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
³ ³
|
|
³ EOF MARKER ³ EOF marker. This will assure character files can
|
|
³ ³ easily determine the end of file.
|
|
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
³ ³
|
|
³ COMMENT BLOCK ³ Optional Comment block.
|
|
³ ³
|
|
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
³ ³
|
|
³ SAUCE RECORD ³ SAUCE record.
|
|
³ ³
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
|
|
|
|
|
|
The Comment block
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿
|
|
³ ³
|
|
³ 'COMNT' ³ Comment block ID bytes
|
|
³ ³
|
|
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
³ ³
|
|
³ COMMENTLINE 1 ³ First comment line
|
|
³ ³
|
|
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
³ ³
|
|
³ COMMENTLINE 2 ³ Second comment line
|
|
³ ³
|
|
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
...
|
|
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
|
|
³ ³
|
|
³ COMMENTLINE N ³ n-th comment line, n equals the Comments field
|
|
³ ³ in SAUCE record.
|
|
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ
|
|
|
|
|
|
|
|
EXAMPLE CODE TO READ SAUCE
|
|
--------------------------
|
|
Variables:
|
|
Byte : Count;
|
|
Long : FileSize;
|
|
file : F;
|
|
|
|
Code:
|
|
Open_File(F); | Open the file for read access
|
|
FileSize = Size_of_file(F); | Determine filesize
|
|
Seek_file (F, FileSize-128); | Seek to start of SAUCE (Eof-128)
|
|
Read_File (F, SAUCE); | Read the SAUCE record
|
|
IF SAUCE.ID="SAUCE" THEN | ID bytes match "SAUCE" ?
|
|
IF SAUCE.Comments>0 THEN | Is there a comment block ?
|
|
Seek_File(F, FileSize-128-(SAUCE.Comments*64)-5);
|
|
| Seek to start of Comment block.
|
|
Read_File(F, CommentID); | Read Comment ID.
|
|
IF CommentID="COMNT" THEN | Comment ID matches "COMNT" ?
|
|
For Count=1 to SAUCE.Comments| \ Read all comment lines.
|
|
Read_File(F, CommentLine) | /
|
|
ENDFOR
|
|
ELSE
|
|
Invalid_Comment; | Non fatal, No comment present.
|
|
ENDIF
|
|
ENDIF
|
|
ELSE
|
|
Invalid_SAUCE; | No valid SAUCE record was found.
|
|
ENDIF
|
|
|
|
|
|
SOURCECODE AVAILABILITY
|
|
-----------------------
|
|
A fully working implementation for SAUCE extraction is available
|
|
as a PASCAL unit. The extraction code itself is implemented in
|
|
built-in Assembly. It should be fairly easy to port the source
|
|
code to C. SAUCE_.PAS should be available in the ACiD Acquisitions
|
|
and on the SAUCE Web page
|
|
|
|
INFORMATION OR UPGRADES
|
|
-----------------------
|
|
If you have a need for additional information on SAUCE, or
|
|
need modifications, you can contact me at these places...
|
|
|
|
email:
|
|
|
|
tas@acid.org
|
|
|
|
SAUCE Web Page :
|
|
|
|
http://uc2.unicall.be/tasmaniac/sauce.htm
|
|
|
|
(!) This page is still being constructed, it may not yet be
|
|
available at the time you are reading this. The page
|
|
will contain up to date information about the SAUCE
|
|
specifications and implementations of SAUCE.
|
|
|
|
BBS:
|
|
|
|
Leave a message to TASMANIAC on any of these boards :
|
|
|
|
Neo Tokyo +32-50-620112 USR 33600 Dual
|
|
+32-50-625717 ZyXEL 28800
|
|
Succotash +1-XXX-XXX-ACiD USR 33600 Dual
|
|
|
|
or contact one of our coders in the Utilities base via AgoraNet.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 4.30 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) *INTERNAL* True-Color and 256-Dithered JPEG viewing!
|
|
|
|
2) Full XBIN support implemented.
|
|
|
|
3) Fixed minor arc bug in RIPscrip engine.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 4.21 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) RIPscrip viewer now supports large cut and paste commands.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 4.20 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) Additional configurable file-masks added
|
|
|
|
2) Bug which caused duplicate lines corrected.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 4.14 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) Woops, we forgot to add XMS for BIN files. Now it's there.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 4.14 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) ACiD View ANSI, GIF and RIP display routines optimized. ACiD View now
|
|
claims to be THE fastest ANSI viewing utility, bar none.
|
|
|
|
2) The entire BGI RIP font set has been made external, making our viewer
|
|
(in it's executable form) a mere 69kilobytes!
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 4.13 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) ALL BGI RIP fonts added to ACiD View.
|
|
|
|
2) Fixed minor bugs related to ANSI to GIF screen capturing.
|
|
|
|
3) Baud-simulator for RIP re-implemented. (New to 4.xx series)
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 4.12 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) File deleting capabilities reimplemented. (New to 4.xx series)
|
|
|
|
2) Command line viewing mode added.
|
|
|
|
3) Mouse support while viewing images was enhanced.
|
|
|
|
4) More RIP fonts were added to the program.
|
|
|
|
5) Multiple SAUCE/File view options, with the TAB key.
|
|
|
|
6) Added screen capturing ability [F10].
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 4.10 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) Multiple file tagging (slideshow) added.
|
|
|
|
2) A bug which added extra lines while scrolling ANSI in VGA was removed.
|
|
|
|
3) ANSI-VGA mode routines optimized for speed.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 4.00b º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) Re-written from scratch, ACiD View presents a completely new version of
|
|
ACiD View. This edition offers all the features of previous versions
|
|
combined and more, with and interface that has the look and feel of
|
|
The Hit Man's final version of The Viewer. Although virtually all the
|
|
features are still here, the memory and disk space requirements have
|
|
been cut down to one third of it's predecessor.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 3.99 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) Finally detected and removed bug which causes the screen to shake while
|
|
using the bouncing interface.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 3.06 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) Changes to multifriendly environment made.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 3.05 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) ACiD View now loads maximum lines of text or ANSI, according to
|
|
free memory available rather than crashing to OS.
|
|
|
|
2) Other minor cosmetic changes made.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 3.04 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) ACiD View reimplements imbedded RIP fonts, resulting in slightly
|
|
faster display, ease of configuration, but reducing available
|
|
memory by another 120k.
|
|
|
|
2) Fixed minor bug in the RIP parser.
|
|
|
|
3) Interface modified to display cleaner.
|
|
|
|
4) ACiD View forces multi-friendly mode when a Trident video card is
|
|
dectected due to its history of problems with the split screen
|
|
"bouncing" interface.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 3.03 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) Support for Tab characters in ANSi parser (Tab stops every 5 columns)
|
|
|
|
2) Help screen is now avaible in multi-friendly mode
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 3.02 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) No longer uses an EGA text mode when VGA is avaible.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 3.01 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) More code reduction, less memory used for code and smaller file.
|
|
|
|
2) File and directory indexing added. Entering a lowercase charactor
|
|
brings the selection bar to the first file begining with that letter.
|
|
A uppercase charactor does the same, except with directories.
|
|
|
|
3) Fixed a bug in the CFG parser. Did not recognise custom MASKs.
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 3.00 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) Initial release of a completely new ACiD View, coded by SiDS &
|
|
Tasmaniac.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 2.02 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) New RIP routines by Cap'n Crunch used in part with already exist-
|
|
ing source to accelerate display speed.
|
|
|
|
2) ACiD View now uses Tasmaniac's assembly source for SAUCE reading,
|
|
and increases the speed of on-the-fly definition loading.
|
|
|
|
3) Fixed ansimation mode bug.
|
|
|
|
4) Fixed mouse bug and other minute flaws.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 2.01 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) New pull-down interface by Icy of ACiD Productions.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 2.00 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) ACiD View takes on a hot new look in its new interface created by
|
|
Dr. Tongue of ACiD Productions. The layout has been completely
|
|
reconstructed, and now provides the end user with pull-downs and
|
|
the same familiar hot keys.
|
|
|
|
2) ACiD View now makes use of on-the-fly SAUCE definition loading.
|
|
This process will greatly increase your initialization speed on
|
|
computers that contain a multitude of files.
|
|
|
|
3) ACiD View now caters to mouse users, supporting a wide spectrum
|
|
of different mouse types.
|
|
|
|
4) ACiD View has recently been implemented with progress bars. Your
|
|
estimated position in the list of files or directories can now be
|
|
visually monitored with the help of the elevator located to the
|
|
right of the file/directory listing.
|
|
|
|
5) VESA SVGA viewing updated for 640x480, 800x600, and 1024x768x256
|
|
modes. ACiD View supports the following chipsets as well as the
|
|
VESA standard mode: Ahead, ATI, Chips & Tech, Everex, Genoa,
|
|
Paradise, Oak, Trident, TSeng, and Video7. If you have trouble
|
|
viewing in SVGA mode, try loading your video cards VESA driver.
|
|
|
|
6) All setup changes made during the run-time of ACiD View will be
|
|
saved upon exiting the program.
|
|
|
|
7) More minor bugs fixed.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 1.50 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) ACiD View Control File support Added. ACiD View will now load
|
|
defaults from ACIDVIEW.INI.
|
|
|
|
2) Screen now displays the current directory.
|
|
|
|
3) Drive switching now added. ACiD View will show drives A: - Z:.
|
|
(Including FLOPPY, SUBST, RAM, and other drives.)
|
|
|
|
4) Command line Viewing is now supported! (Type "ACiDView /?")
|
|
|
|
5) ND CHECK (NO DELAY mode w/Error Checking) display speed added.
|
|
This speed is the same as NO DELAY except it checks if ANSIs con-
|
|
tain lines with more than 255 characters per line.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 1.40 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) Multitasking environment awareness implemented (ie. DesqView and
|
|
OS/2.)
|
|
|
|
2) Modem simulation routines are now disabled when ACiD View is loaded
|
|
under multitasking environments.
|
|
|
|
3) Directory switching added. Change directories simply by pressing
|
|
the return key.
|
|
|
|
4) "File jumping" and auto-sorting added. ACiD View will now jump to
|
|
the first file that begins with the character entered by the user.
|
|
|
|
5) 640x480 viewing is now two times faster than version 1.32.
|
|
320x200 Normal Wide have also been optimized for speed.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 1.32 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) Major bug erradicated in file reading routines.
|
|
|
|
2) Fixed the problem with the Viewer exiting if no files were found
|
|
matching the default mask. ACiDView will now simply display the
|
|
normal interface with no files, allowing you to MASK or exit until
|
|
you specify a valid file mask.
|
|
|
|
3) Fixed the key-reading loop with the 320x200 and 320x200 WIDE emu-
|
|
lations when ScrollBack was turned off.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 1.30 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) File Masking added, allowing the user to select files within the
|
|
mask.
|
|
|
|
2) Added 320x200x256 ansimation mode.
|
|
|
|
3) Added modem simulator which emulates user-defined bps rate.
|
|
|
|
4) Minor bug corrected in the scroll back of large ANSIs.
|
|
|
|
5) Removed slow panning upon exit.
|
|
|
|
6) 640x480x16 now FULLY supports ansimations. Small bug fixed.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Acquisition Viewer 1.20 º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
1) Maximum number of files in one directory has been increased to
|
|
2,000.
|
|
|
|
2) A bug in the RIP portion of the viewer which caused the colors
|
|
of plotted objects to display improperly has been squashed.
|
|
|
|
3) RIP code has been optimized for speed, and it is now possible to
|
|
abort the screens.
|
|
|
|
4) Scrolled viewing has since been implemented, and 320x200x256 MCGA
|
|
display modes are now supported.
|
|
|
|
5) The old font has been replaced with a new character set, and a new
|
|
interface has been added which features icons.
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Credits º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
Interface by: RaD Man and Skull Leader
|
|
ANSI Screens by: Lord Jazz
|
|
File Handling & Baud Simulation by: Skull Leader
|
|
ANSI and BIN display and GIF Mode Detect by: Skull Leader
|
|
JPEG Decoding by: Independant JPEG Group
|
|
JPEG C to Pascal port by: Jacques Nomssi Nzali
|
|
JPEG VESA TrueColor and 256Color dithering code by: Skull Leader
|
|
RIP Display routines by: Capn' Crunch & SiDS
|
|
Mode-X Primatives by: Matt Pritchard
|
|
Other Graphics Primatives, GIF & PCX from Fastgraph by TGS
|
|
Compiled with Turbo Pascal v7.0
|
|
|
|
|
|
ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ·
|
|
³ Bugs? º
|
|
ÀÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍͼ
|
|
|
|
|
|
Did you find any bugs? If so, please write us at
|
|
acid-public@acid.org, or mail Skull Leader on any ACiD
|
|
affiliated system via AgoraNet.
|
|
|
|
|
|
SAUCE00ACiD View Documentation RaD Man ACiD Productions 19960901–Ê P |