

          [1mVideo & CD-Archive -- Export-Filters[23m[22m
             [1mCopyright: Harald Zottmann 1998[23m[22m




[1m1) What is it all about[23m[22m
[1m=======================[23m[22m

Since Version 3.30, the Video & CD-Archive is able to export
data to various different formats. It therefore makes use
of external Export-Filters, which can be written by the user.

With this installation, the Video & CD-Archive comes already 
featuring a large number of different filter types:

  - ASCII format
  - LaTeX format
  - PostScript format
  - PageStream format 





[1m2) Write your own filter[23m[22m
[1m========================[23m[22m

All Export-Filter files must reside in the directory "Filters" which 
is located beneath the program directory of the Video & CD-Archive.
The Export-Filter names have various suffixes to distinguish between 
them:

 .MC   for Tapes
 .PH   for Longplayers
 .CD   for Compact Discs
 .VI   for Video Tapes

Export-Filter files are pure ASCII files which can be created and 
modified by every normal text editor. Control sequences are used to 
tell the program what to do. Supported control sequnces so far are:

[32m@TXT[31m                write following ASCII text to export file
[32m@BIN[31m                write binary data to output file
[32m@REPxyz@abc[31m         replace sequence "xyz" with sequence "abc"
[32m@%<format>s@xx@yy[31m   write dataset row and column to export file


[1ma) Example for ASCII text data:[23m[22m
[1m-------------------------------[23m[22m

These rows define the beginning of a LaTeX document:

[32m@TXT\documentstyle[german]{article}[31m
[32m@TXT\begin{document}[31m
[32m@TXT\footnotesize[31m


This row defines a horizontal line that is used in conjunction with
the ASCII MC cover output:

[32m@TXT|-------------------------------------------------------------------|[31m


[1mb) Example for binary data:[23m[22m
[1m---------------------------[23m[22m

This row defines binary data in hexadecimal notation (00-ff) to
be written to the exported file:

[32m@BIN 07 23 19 92 00 0d 02 00 00 00 e8 f8 00 01 49 7c 00 00 00 00[31m


[1mc) Example for replacements:[23m[22m
[1m----------------------------[23m[22m

These rows define e.g. the standard replacement list for LaTeX 
Export-Filters:

[32m@REP\@ \(\backslash\)[31m
[32m@REP~@ \~\[31m
[32m@REP^@ \^\[31m
[32m@REP$@ \$[31m
[32m@REP{@ \{[31m
[32m@REP}@ \}[31m
[32m@REP%@ \%[31m
[32m@REP&@ \&[31m
[32m@REP#@ \#[31m
[32m@REP_@ \_[31m
[32m@REPä@\"a[31m
[32m@REPö@\"o[31m
[32m@REPü@\"u[31m
[32m@REPÄ@\"A[31m
[32m@REPÖ@\"O[31m
[32m@REPÜ@\"U[31m
[32m@REPß@\ss{}[31m


[1md) Example for dataset output:[23m[22m
[1m------------------------------[23m[22m

This row writes an `|` followed by row 14, starting with column 0
of the current dataset with a minimum printing width of 33 characters.
The format definition follows the syntax of the `C` programming language.
Then comes again the character `|` and row 14, starting this time with
column 34 of the current dataset. Note that in the MC and the CD case,
column 0 means the left part of the cover and column 34 identifies the right
part of the cover. The definition ends again with the character `|`:

[32m@TXT|@%-33.33s@00@14@TXT|@%-33.33s@34@14@TXT|[31m

See the Export-Filter files that come with this package for examples
and more details.





[1m3) How to use the program `MakeFilter`[23m[22m
[1m======================================[23m[22m


This program is intended to support you to create Export-Filters for
any third party program you like. I will explain the necessary steps
using PageStream as an example.

First of all you have to decide for what mode (MC, CD, Phono or Video)
you want to create a new Export-Filter. Let`s say that you want to create
a new MC cover design.

Start PageStream and import the ASCII file `MakeFilter.MC` which contains
necessary format definitions which is used by the program `MakeFilter` later on.
The sequences of this file represent some kind of placeholder for the real 
datasets which will be inserted during export with the Video & CD-Archive.
You may change the position of these sequences by dragging them around or by
copy and paste, but don`t modify the sequences themself at all, not even delete 
them partly.

You may now design the cover as you prefer it. You can use every feature 
PageStream offers you, for example coloured lines, shaded text and so on. 
You may even use cliparts in your cover design.

If you`ve finished your work, save the cover as a normal PageStream document.
In the directory `MakeFilter/PageStreamTemplates` there are some examples on 
how these files may look like. You can also use these files and modify them 
to your personal taste.

Now invoke `MakeFilter` with the shell command:


             [33mMakeFilter <PageStreamFile> <ExportFilter.MC>[31m


Note that PageStream uses a special character for the german `ß`. To implement
the conversion between the `ß` used by the Video & CD-Archive and the character
used by PageStream, you have to add the line:

[32m@REPß@»[31m

at the top of the resulting Export-Filter file. This command directs the export
function of the Video & CD-Archive to replace every `ß` of the exported dataset 
to a special character known by PageStream.

Now copy the resulting file `ExportFilter.MC` to the `Filters` directory
beneath the program directory and invoke the Video & CD-Archive`s export
function from the main menu. Follow the steps described in the respective 
section of the AmigaGuide file by pressing the `Help` key within the 
Video & CD-Archive if you have problems here.

If everything went fine, you now can load the just exported file directly to 
PageStream and print it.

Be aware that the procedure described above works only if the program you want
to design Export-Filters for (e.g. FinalWriter, PageStream etc.) saves its files
without changing the ASCII sequences of the format definitions file. That should
normally be the case, but you never know.




[1m4) How it works[23m[22m
[1m===============[23m[22m


MakeFilter is a pretty simple but nevertheless powerful tool. The way it works
is converting the unknown binary data of some document file to @BIN sequences
which are understood by the export function of the Video & CD-Archive.
Well, that would not help too much if there weren`t those placeholders inserted
in the document file, which are understood by MakeFilter and are replaced by

[32m@%<format>s@xx@yy[31m

sequences which in turn are understood by the Video & CD-Archive. See chapter 2
of this document for more information on those control sequences.

The placeholders which have to be imported and arranged somehow in the template
document, see chapter 4, have the following formats:



[1ma) MC mode - MakeFilter.MC[23m[22m
[1m--------------------------[23m[22m

[32m@A0@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B0@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A1@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B1@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A2@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B2@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A3@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B3@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A4@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B4@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A5@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B5@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A6@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B6@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A7@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B7@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A8@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B8@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A9@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B9@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AA@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BA@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AB@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BB@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AC@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BC@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AD@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BD@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AE@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BE@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m

[32m@AF@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BF@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m

[32m@AG@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BG@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m

[32m@AH@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AI@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AJ@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m


[1mb) CD mode - MakeFilter.CD[23m[22m
[1m--------------------------[23m[22m

[32m@A0@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m

[32m@A1@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B1@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m

[32m@A2@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B2@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A3@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B3@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A4@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B4@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A5@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B5@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A6@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B6@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A7@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B7@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A8@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B8@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A9@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @B9@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AA@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BA@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AB@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BB@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AC@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BC@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AD@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BD@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AE@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BE@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AF@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BF@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AG@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BG@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AH@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BH@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AI@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BI@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AJ@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @BJ@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m


[1mc) Phono mode - MakeFilter.PH[23m[22m
[1m-----------------------------[23m[22m

[32m@A0@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m

[32m@A1@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A2@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m

[32m@A3@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A4@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A5@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A6@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A7@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A8@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@A9@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AA@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AB@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AC@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AD@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AE@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AF@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AG@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AH@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AI@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m
[32m@AJ@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m


[1md) Video mode - MakeFilter.VI[23m[22m
[1m-----------------------------[23m[22m

[32m@A0@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@[31m

[32m@A1@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @C1@ @D1@@@@@[31m
[32m@A2@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @C2@ @D2@@@@@[31m
[32m@A3@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @C3@ @D3@@@@@[31m
[32m@A4@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @C4@ @D4@@@@@[31m
[32m@A5@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @C5@ @D5@@@@@[31m
[32m@A6@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @C6@ @D6@@@@@[31m
[32m@A7@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @C7@ @D7@@@@@[31m
[32m@A8@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @C8@ @D8@@@@@[31m
[32m@A9@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @C9@ @D9@@@@@[31m
[32m@AA@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @CA@ @DA@@@@@[31m
[32m@AB@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ @CB@ @DB@@@@@[31m



Every sequence start with the character `@`, followed by two characters
which give the internal position of the dataset string. The first character
may have values from A...D, giving the x position:

 A --> 0    A-Side MC / Left-Side CD / Phono / Filmtitle-Field Video
 B --> 34   B-Side MC / Right-Side CD
 C --> 54   Time-Field Video
 D --> 59   Counter-Field Video

The second character defines the y position, giving the row of the dataset.
This one may have values from 0...9 and from A...J which means 10 to 19 then.

With this position information, a certain length information for the sequence
in question is included. MakeFilter checks the length of the sequences and 
compares that information with internal settings. If it encounters possible
problems, it will give you detailed information on what might be incorrect.




[1m5) What you might want to know now[23m[22m
[1m==================================[23m[22m


Note that new Export-Filters will be made available on my personal WWW site:


              [33mhttp://home.t-online.de/home/harald.zottmann[31m


as soon as they are available. If you have written some new and [1mreally good[23m[22m
Export-Filters yourself, feel free to E-mail them to me in order to release 
them on this site, or to get them included in a forthcoming release of the 
program. As a reward for sending me Export-Filters which are [1mworth[23m[22m to be 
released, you [1mmay[23m[22m earn a free KeyFile for the Video & CD-Archive. Note that 
I will distribute free KeyFiles only via E-Mail and only if I receive an 
electronic copy of the ORDERFORM with the requested personal data from you. 
The ORDERFORM file is included in the Video & CD-Archive program package.

