MF Digital DIRECTOR Developers Guide - Manual (Page 12)

DIRECTOR EasiAPI
22nd FEB. 2013
D E V E L O P E R ’ S G U I D E
Page 12
ArchiveOption: The ArchiveOption is a Boolean value, and can be set to true or false where
“0” equals false, and “1” equals true. When set to true, or “1”, the Director will attempt to read
in the disc on the top of the input spindle and create an image file of the disc. This Image file is
a single file stand-alone representation of the master disc. Once read in, the master will no
longer be needed as the image file contains the complete data of the source CD. The Quantity
option must be set to “0”. Unless you are trying to read-in, or archive a disc, this option should
be set to “0” for off.
PrintOption: The PrintOption is a Boolean value, and can be set to true or false where “0”
equals false, and “1” equals true When set to “1”, or true, the disc will be printed after the
being written using the label artwork defined under [Label] line item in the .JOB file. If set to
“0” or false, no printing will be performed even if a label file is listed under [Label].
[Image]: This section simply indicates which CD image file you wish to use. A few different
types are supported but all have the same result. They serve as a representation of the DATA to
be written to the disc. The image file can be a Director Image Script (*.ISC), a Director CD
image file (*.IMG), or an ISO image file produced with a third party software package such as
Gear, Toast, or Easy CD Creator to name but a few. Keep in mind that the file listed here must
be relative to the Director. For example if your application builds the image file on your “C”
drive then the Director must also refer to your drive as “C”. It is best to map a drive whereby
both your PC and the Director reference the same shared drive as say “Z”. Another way around
this is to copy the file to the Director or use UNC file naming.
LabelFile =: This section simply indicates which CD label artwork file is to be used when the
PrintOption=1. The artwork file can be either a .PRN file or a Director Label file (*.LBL).
.LBL files can be created using Label Designer software integral to the Director application.
The advantage to this file type is its easy controllability from a calling application. For
example, if you desired to print the same artwork to each disc but increment a serial number
each disc, or wished to customize each disc with the customer’s name, then the LBL file is for
you. More on this in a bit. .PRN files are created by simply using the printer’s driver set to
“Print to File” under the printer’s properties. “Printing to file” captures what would normally
be sent direct to the printer, to a file. This file can then be used to print CDs. The advantage of
this file type is if you prefer to generate your artwork with graphic design software such as
Quark Express or CorelDRAW. Keep in mind that you can still use these packages in
conjunction with .LBL files but you must export to a Windows bitmap file format (*.BMP) and
then paste in the graphic as an element of the label file (*.LBL).