home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The CDPD Public Domain Collection for CDTV 3
/
CDPDIII.bin
/
bbs
/
ff779.lha
/
FF779
/
AAP_AAC
/
AAC.Doc
< prev
next >
Wrap
Text File
|
1992-12-06
|
9KB
|
313 lines
04. Oct 1992 Docfile for AAC version 1.1 (1.st public release)
** Table of contents in this docfile **
1. .... FUNCTIONAL OVERVIEW
2. .... USAGE (CLI-OPTIONS)
3. .... AAC KEYS
4. .... USING SCRIPT FILES
5. .... FRAME TIMING
6. .... CONVERTING EXAMPLES
7. .... CONVERTING LIMITATIONS
8. .... BUGS
1. FUNCTIONAL OVERVIEW
AAC (AmigaAnimConvert) offers the following features:
- Convert a sequence of pictures and/or anims to anim
files
- Convert a sequence of pictures and/or anims to single
pictures
- Supported pictures: IFF ILBM
- Supported anims : IFF ANIM_5 (byte oriented)
ANIM_7 (short oriented)
ANIM_7 (long oriented)
(For a description of the new ANIM7 fileformat
see Anim7.doc file.)
2. USAGE (CLI-OPTIONS)
AAC is designed for cli call.
Usage:
aac [-switches] anim | picture | script
All the switches are optional.
[-d] Input from diskfile (default)
[-m] Preload inputfile(s) into memory.
[-l] Type script while analyzing it.
[-s] Set global frame timing (speed in jiffies).
[-a] Output as anim filetype. (default)
Write output frames to one animation file.
All frames of an output animation file must have
the same size!
If the Input frame Sequence is a script with
different sizes of frames:
Each frame of the input sequence (script) that does
not match in width, height or depth with the
previous frame begins a seperate anim outputfile.
(Using basename and the next filecontnumber to
build its name).
(Do NOT combine -p and -a option !!)
Customize anim file with following number options:
(number options should always be used in
combination with -a Option)
[-4] Use ANIM7 type with long data (data is organized as
longword (= 4 Byte) enables maximum playbackrates
on 68030 machines with 32-Bit organized memory).
[-2] Use ANIM7 type with short datamodel (data is
organized as words (= 2 Byte).
[-1] Use ANIM5 IFF type. (default)
(Data is organized in bytes and mixed with opcode
List. ANIM5 files are usually better packed than
ANIM7 but they playback slower.)
[-0] Write initial frame#0 as DLTA chunk otherwise use
BODY chunk for frame#0 (default).
This option usually produces better compression
results on the first frame (because the first frame
is stored as difference (DLTA) to an empty frame).
But: It produces NON-IFF outputs.
[-p] Output as sequence of pictures (IFF,ILBM).
Each frame is written to a seperate IFF ILBM file.
(Do NOT combine -p and -a option!!)
[-b] Option generate uncompressed BODY chunks otherwise
use RLC-compressed BODY. (default)
(This option does not make sense in combination
with -0)
[-o] Basename for the outputffile.
With -o you may specify a basename for your output-
files (pictures or animations). A filecount number
(minimum of 3 digits) is added as suffix to the
basename.
The basename must follow immediate behind the 'o'
letter!!
Further options must be separated by a blank.
-odh0:pictures/pic.
results in:
dh0:pictures/pic.000
dh0:pictures/pic.001
:
dh0:pictures/pic.nnn
AAC needs no additional files or libraries to run.
AAC runs on AMIGAs with Kickstart 1.3 and higher.
3. AAC KEYS
Press ESC to stop AAC (Hold down ESC for a while, because AAC
writes the current frame to the outputfile before checking the
ESC key).
4. USING SCRIPT FILES
Both programs AAP and AAC use the same kind of scriptfiles.
Scripts are used to assemble animation sequences or picture
slide shows.
Scripts are line-structured ASCII files and can be made with
any editor.
- There can be only ONE filename or command in a single line.
- Files with binary data are not accepted as script.
- Script files are not case sensitive.
- Blank lines, or lines starting with the semicolon ';' are
remarklines.
- All lines that are no command or no remarklines must
contain the name of a picture or animation file. The
filenames MUST NOT contain Blanks!!
See docfile AAP.doc for a detailed description about
the script command Syntax and possibilities.
Warning:
Bear in mind, that _BEG_LOOP's default is 32000. (That gives a
lot of Frames ...
... so do not use LOOPs lightly with AAC.)
Restrictions:
AAC ignores some of the commands in the script; marked with *)
List of ignored script commands:
_ADRESS *)
_MSG *)
_VIEW_DX [ofs] *)
_VIEW_DY [ofs] *)
_KEY_BREAK *)
5. FRAME TIMING
The playback rate is stored in a DPAN chunk as "frames_per_second" value.
AAC timing is based on jiffies, this limits the f/sec values to multiples
of the display frequency. (see table below).
speed PAL NTSC
(jiffies) (frames/sec) (frame/sec)
1 50 60
2 25 30
3 16.6 20
4 12.5 15
5 10 12
6 8.3 10
7 7.1 8.5
Timing informations are also stored as relative frametime jiffies
in ANHD Chunks along with each frame.
Timing informations are lost when the output to single pictures
is used.
6. CONVERTING EXAMPLES
Convert a single file, named MyAnim5.file from IFF ANIM5 (or ANIM7 short)
to a single file ANIM7 (long)
AAC -a4 -oMyAnim. MyAnim5.file
==> Output to file: MyAnim.000
since we did not specify any path within the filenames
both input and output file are located in the current directory.
Convert any ANIM file of types ANIM7
to a single file of IFF ANIM5 (as used by DPAINT)
AAC -a -oDH0:Dpaint/Anims/MyAnim. MyAnim.000
==> Output to file DH0:Dpaint/Anims/MyAnim.000
note that this example will NOT work if the current directory is
DH0:Dpaint/Anims/
because the output file must not be the same as the input file
on a disk based conversion.
(You may use the same file for input and output if the -m
option is set to operate from Memory)
Convert any ANIM file of types ANIM7 or ANIM5
to a group of Picture files of IFF ILBM type
AAC -p -oDH0:Dpaint/pictures/MyPic. MyAnim.000
==> Output to file DH0:Dpaint/pictures/MyPic.000
==> Output to file DH0:Dpaint/pictures/MyPic.001
==> Output to file DH0:Dpaint/pictures/MyPic.002
==> Output to file DH0:Dpaint/pictures/MyPic.003
...
...
... until all frames are saved as picture
Convert a Sequence of Pictures
into one big Animation.
Therefore you need to create a script that may look like this:
; This Remark is the 1.st line of the ConvertScript
;
MyPic.000
MyPic.001
MyPic.002
MyPic.003
MyPic.004
MyPic.005
; at the end of the Animation we add the first
; 2 frames.
; that enables a continous loop replay.
; (note that Dpaint stores Anims in the same way.
; and truncates the last 2 frames when loading
; an animation)
MyPic.000
MyPic.001
; This is the last line of the ConvertScript
AAC -a -oMyAnim. ConvertScript
==> Output to file MyAnim.000
This Example will work properly if all pictures have
the same height, width and depth.
if not the result wolud be two (or more) outputfiles.
(==> Output to file MyAnim.001, MyAnim.002, ...)
7. CONVERTING LIMITATIONS
Files of the IFF structure are organized in Chunks.
In this Version AAC supports only those Chunk Types
needed in AAP.
- This Informations will be stored in the Output file(s):
Information Type | Chunk Type
-----------------------------------
Headers | FORM, BMHD, ANHD
Dpaint Timing | DPAN
Bitmap Data | BODY, DLTA
Colormap Data | CMAP
Viewmode Info | CAMG
- All other Information (such as the CRNG Colorcycling chunk)
found in Inputfiles is ignored.
- There may be Changes of viewmodes palette and
relative_frametiming between each frame.
However:
Changes of width, height and depth
can not be packed into a single output animation file.
.. the result are 2 or more anim file outputs.
(filenames are made of a basename and a count number)
8. BUGS
There are no known Bugs.