Appendix A- Output File Naming. Global Graphics Epson Stylus Pro 4800

PDF

Tài liệu

Quảng cáo

Appendix A–Output File Naming

Using text and tags you can automatically generate an output file name from the job name, job details (such as colorant information and resolution), or date and time information. The tags are entered in the File Template field in the Epson Configuration dialog box, and a complete list of supported tabs can be found in

Table A.1, page 24 .

Most tags are content tags, representing variables such as the date and time a job is processed; the other tags allow you to reject names that would be illegal in a specified operating system. The maximum length of variables can be specified by preceding the tag name with an integer. For example,

<5jobname>

truncates the job name to a maximum of five characters. Tags that produce numeric values are truncated from left to right, whereas tags that produce alphanumeric strings (strings containing the characters a-z, A-Z, and 0-9) are trun-

cated from right to left. See “Examples of tag usage”, page 26

for further details.

Fixed text can be part of the file name stem or extension. For example, stem_

<3unique><sepname><dot>epf would generate a file name of the form: stem_

000Cyan.epf

, in which stem_ can be any identifying text.

Try to use a file name extension that does not clash with any established convention. The extension epf

is a suggestion only and is formed from the initial letters of Epson Printer File

Note: This file naming scheme does not provide useful file names derived from job names that contain doublebyte characters.

A.1 Content generating tags

The following tags are available and can be used in any order

Tag Description

<date>

<dot>

<job#>

The color space of the device, such as PhotoInk.

The name of the separation, such as

Cyan

The date when the job is processed, in the format

YYYYMMDD

, unless a truncated form is specified.

Separates the stem of the file name from the file extension, and appears as a period character (

) in the file name. For example,

stem

<dot>

ext appears as stem.ext

. The use of the

<dot>

tag enables the verification of the stem and extension lengths.

The job number allocated by the RIP. Automatic numbering means that successive jobs have incremented job numbers: 000, 001, 002, 003, and so on.

The page buffer name without the page number prefix and without characters illegal to the operating system. White space characters are used, if present in the job name.

The page buffer name without the page number prefix, and using only alphanumeric characters (a-z, A-Z, 0-9). White space characters are not used.

Table A.1 Output file name tags

AG50566 REV. 5

PROOFMATE (PROOFREADY) PLUGIN FOR EPSON STYLUS PRO 4800

Tag

<page#>

<time>

<xres>

<yres>

Description

This gives the job name without the separation name in brackets, For example, where <jobname> would give myjob(PANTONE Reflex Blue CVC)

<jobonly> will give myjob

The page number (allocated by the RIP), within the current job. For example: 002.

The page number prefix from the page buffer name, such as

, and so on.

You can use this tag to include the characters from the prefix before the full stop in the job name (that is, the prefix, not including the dot and space characters).

The time when the job is processed, in the 24-hour format

HHMMSS

, unless a truncated form is specified.

A unique sequence number used to make file names unique when outputting files to a directory.

The horizontal resolution of the page, as specified in the page setup.

The vertical resolution of the page, as specified in the page setup.

Table A.1 Output file name tags

A.2 Checking tags

The plugin always checks the legality of an automatically generated file name against the requirements of the operating system on which the RIP and the plugin are running.

To enable portability of files from one operating system to another, you can also use tags to specify the operating system for which generated file names must be suitable. The use of these tags changes the rules by which a file name is deemed valid. The tags do not modify the file names generated, but cause error messages if the file name is invalid.

For example, you can create the template

<dos>Averylongfilename.epf

, but an error is generated. This error occurs because DOS file names require the 8.3 format for stem and extension, which this template fails to meet

by having 17 characters in its stem. Table A.2

lists the operating system tags.

Tag

<ascii>

<dos>

<mac>

<unix>

<win32>

Description

This limits the character set of the file name (from the point of the tag onwards) to ascii characters in the range 32 (0x20) to 126 (0x7E). Char-actors outside this range are discarded. If the user wishes to substitute invalid characters rather than discarding them, prefix the ascii tag with the substitution character value in decimal.

Verifies that the file name is a legal file name for the MS-DOS operating system.

Verifies that the file name is a legal file name for the Mac OS 9.x operating system.

Verifies that the file name is a legal file name for the Mac OS X operating system.

Verifies that the file name is a legal file name for the UNIX operating system.

Verifies that the file name is a legal file name for Windows operating systems.

Table A.2 Operating system tags

AG50566 REV. 5

PROOFMATE (PROOFREADY) PLUGIN FOR EPSON STYLUS PRO 4800

A.3 Examples of tag usage

The following examples demonstrate the format of strings produced by individual tags. Some examples also show how the tags may be used in combination to form a template. The examples are based on these job details:

Page buffer name: 1. Uncalibrated Target: Epson Stylus Roll-Fed 4-Color Target.

Date: 10th of March, 2007.

Note: When creating multiple copies of a file, the same page buffer provides tag information. If a template contains dynamic tags (such as

<time>

, where the value changes each time that a page buffer file is output), then multiple copies of the file are created. If the template contains just static tags (such as

, where the job name remains constant), then a single output file is created because previous files are overwritten.

This tag includes the color space of the device in the file name string.

For example, the template

<colorant><dot>epf

produces a file name of the form

PhotoInk.epf for a device using a PhotoInk color space.

The tag

can be used to include the name of the separation in a file name, for example:

Cyan

You can include just the first letter of the separation by using the tag

<1colorname>

, which truncates the separation name to its first letter. If a composite style is used this is indicated by the string

Composite

. If a monochrome style is used this is indicated by the string

Gray

<date>

The template

<date><dot>epf

produces the file name

20070310.epf

. You can remove the year information by using the tag

<4date> to produce the file name

0310.epf

<dos>

The use of this tag verifies that the file name is suitable for use in a DOS operating system. Illegal characters such as a colon, and white space characters are removed.

For example, the template

<dos><jobname><dot>epf

, would generate an illegal file name because the job name is greater than the eight characters allowed in DOS operating systems. Truncation can be forced by using the template

<dos><8jobname><dot>epf

, which produces the file name

Uncalibr.epf

<dot>

This tag separates the file name stem from the file name extension and enables the verification of their lengths. It is particularly necessary when creating file names compatible with DOS and Windows, otherwise the extension may be considered as part of the file name.

For example, the template

<dos><8jobname>.epf

would cause an error because the dot is removed as an illegal character and epf

is then considered part of the file name stem.

<job#>

You can use this tag to include the job number in the file name string. The default length of the number is three digits, so the first file name created with this tag would be 000, unless a different length is specified.

You can specify the length of the job number by preceding the

<job#>

tag with an integer. For example,

5job#

> creates job numbers five digits long.

In multi-page jobs use the

<page#>

tag as well as the

<job#>

tag to differentiate between the different pages of a job.

This tag ensures that only legal operating system characters are used in the job name.

AG50566 REV. 5

PROOFMATE (PROOFREADY) PLUGIN FOR EPSON STYLUS PRO 4800

For example, in the RIP running under any Microsoft Windows operating system, the template

<jobname><dot>epf

can produce the file name

Uncalibrated Target Epson Stylus Roll-Fed 4-

Color Target.epf

. The colon character (

) is removed from the file name, because this is not a valid file name character for any version of Microsoft Windows.

This tag ensures that only alphanumeric characters are used in the job name.

For example, in the RIP running under a Windows operating system, the template

<jobname1><dot>epf can produce the file name

UncalibratedTargetEpsonStylusRollFed4ColorTarget.epf

. The colon, hyphens and white space characters are removed from the file name, because they are not alphanumeric characters.

The use of this tag verifies that the file name is suitable for use in a Mac OS X operating system. Illegal characters such as a colon, or double-quotation marks are removed.

For example, the template

<macosx><jobname><dot>epf

produces the file name

Uncalibrated Target

Epson Stylus Sheet-Fed 4-Color Target.epf

, in which the colon has been removed.

<page#>

You can use this tag to include the page number in the file name string.

For example, the template

<page#><dot>epf produces a file name of the form

001.epf

. It is advisable to use this tag with the job number tag to differentiate between the same pages of different jobs.

You can use this tag to include the page number prefix from the page buffer name in the file name string.

For example, based on the page buffer name above, this tag produces the string

<time>

You can use this tag to include the time a file is processed in the file name string.

For example, if printing to file at 15:39:36 (approximately 3:39 pm) this tag produces the string

153936

You can use this tag to generate a unique sequence number for the page. The default length of the number generated is four digits long, so the first number would be

0000

. The length of the number can be specified, as detailed in the example for the tag

<job#>

, e.g.

<2unique>

When restarting the RIP, the unique numbering will attempt to restart at its initial value, for example:

0000

However, if a file exists with that number, the next available unique number is used.

<unix>

The use of this tag verifies that the file name is suitable for use in the UNIX operating system. Illegal characters such as an asterisk, colon, and quotation marks are removed. The

<dot>

tag cannot be used with this tag because file names in UNIX are composed of a single string and are not considered to have separate file extensions.

For example, using the template

<unix><255jobname>.epf

produces the file name

UncalibratedTargetEpsonStylusRoll-Fed4-ColorTarget.epf

, in which the colon and white space characters have been removed.

<win32>

The use of this tag verifies that the file name is suitable for use in a Windows operating system. Illegal characters such as an asterisk, colon, or quotation marks are removed.

For example, the template

<win32><jobname><dot>epf

produces the file name

Uncalibrated Target

Epson Stylus Sheet-Fed 4-Color Target.epf

, in which the colon has been removed.

AG50566 REV. 5

PROOFMATE (PROOFREADY) PLUGIN FOR EPSON STYLUS PRO 4800

<xres>

You can use this tag to include the horizontal resolution of the page in the file name string.

For example, you can differentiate between pages with a resolution of 1440 x 720 dpi and 720 x 720 dpi by using this tag. This tag produces a string such as

1440

720

, depending on the horizontal resolution.

<yres>

You can use this tag to include the vertical resolution of the page in the file name string. For example, on a page with the resolution 1440 x 720, this tag produces the string

0720

AG50566 REV. 5