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–Ê |