Technical information

175
Embedded commands
Embedded commands
You can embed vfx commands in ASCII text, PCL, or PostScript files, then pipe or redirect them to the vfx
command as standard input (STDIN). These embedded commands are processed as if you had entered them directly
on the command line.
Embedded commands are typically used to:
Embed images, such as company logos, directly into a file you want to fax
Embed tags that contain fax envelope information See The fax envelope directly into a file you want to fax
Embedded commands are especially useful when integrators are programmatically generating a faxable file directly
from an existing business application. These embedded commands allow you to create the entire fax (including the
fax envelope information) and hand it to the fax server for sending-no additional formatting or intervention is required.
Embedded images
There are two embedded commands available for embedding images into the file you want to fax:
@+IMAGE
@+INCLUDE
The @+IMAGE command embeds the specified image file behind the text while the @+INCLUDE command embeds
the specified image file in line with the text.
The @+INCLUDE embedded image command cannot be passed through STDIN whereas the @+IMAGE embedded
image command can be used with or without passing through STDIN.
@+IMAGE
The @+IMAGE embedded image command allows you to include TIFF files, like your company logo or a personal
signature, in a faxable document. Furthermore, you can control the exact position of each embedded image on the
faxed document. The image is included behind the text.
Note
Using the @+IMAGE embedded image command requires a good working knowledge of the format to modify.
The basic syntax for an embedded image statement is:
@+IMAGE[<file_name.tif>]
Where <file_name.tif> is the name of your TIFF file.
Image positioning
The default location for embedded images is the current location of the embedded image statement in the text, PCL,
or PostScript file. In other words, if you placed your embedded image in the middle of a text, PCL, or PostScript file,
the top-left corner of that embedded image would appear in the middle of the faxed document behind the text.
While this may be sufficient for some applications, in most cases more precise positioning is required. This is
accomplished by including position coordinates in your embedded image statement as follows:
@+IMAGE[<filename.tif>;x=<pos>{i|cm};
y=<pos>{i|cm};