Loading

Media

Media

Syntax

XPath: /JDF/ResourcePool/Media/

Supported range

@MediaType

@MediaTypeDetails

@oce:CustomMediaType

@DescriptiveName

@HoleType

@HoleCount

@MediaColorName

@MediaColorNameDetails

@MediaSetCount

@Weight

@Dimension

GeneralID[IDUsage="oce:Orientation"]/@IDValue

Description

The media resources used at job level and for page programming are located in the "ResourcePool" element.

The oce:Orientation GeneralID corresponds to the "Preferred Feed Edge".

The supported media attributes are described in the following specifications.

Media job/page level

Syntax

XPath: /JDF/ResourcePool/DigitalPrintingParams/MediaRef/@rRef

When partitioned

/JDF/ResourcePool/DigitalPrintingParams[@PartIDKeys="RunIndex"]/DigitalPrintingParams[@RunIndex="…"]/ MediaRef/@rRef

Description

The media decoded at job level is referred by //DigitalPrintingParams/MediaRef/@rRef. The media decoded at job level can also be referred by a MediaLink in the ResourcePoolLink node. At least one Media element must be present.

No attributes are mandatory.

If job level media is not required, then the job media definition can be left empty.

Page level media are specified using partitioning.

Example: Media for the whole job

<JDF>

<ResourcePool>

<DigitalPrintingParams ID="res_6">

<MediaRef rRef="media_job_default"/>

</DigitalPrintingParams>

<Media ID="media_job_default" Class="Consumable" Status="Available">

</Media>

</ResourcePool>

<ResourceLinkPool>

<DigitalPrintingParamsLink rRef="res_6" Usage="Input"/>

<MediaLink rRef="media_job_default" Usage="Input"/>

</ResourceLinkPool>

</JDF>

Example: Media for pages 1-4

<JDF>

<ResourcePool>

<DigitalPrintingParams ID="res_6">

<DigitalPrintingParams RunIndex="0 ~ 3">

<MediaRef rRef="media_1"/>

</DigitalPrintingParams>

</DigitalPrintingParams>

<Media ID="media_1" Class="Consumable" Status="Available" DescriptiveName="" oce:CustomMediaType="Plain paper" MediaColorNameDetails="White" Weight="80" HoleCount="0" HoleType="Explicit" MediaSetCount="1">

</Media>

</ResourcePool>

<ResourceLinkPool>

<DigitalPrintingParamsLink rRef="res_6" Usage="Input"/>

<MediaLink rRef="media_1" Usage="Input"/>

</ResourceLinkPool>

</JDF>

Media colour

Syntax for predefined colours

XPath: /JDF/ResourcePool/Media/@MediaColorName

Type

NamedColor

Supported range

  • Black

  • Blue

  • Brown

  • Buff

  • Cyan

  • Gold

  • Goldenrod

  • Gray

  • Green

  • Ivory

  • Magenta

  • MultiColor

  • Mustard

  • NoColor

  • Orange

  • Pink

  • Red

  • Silver

  • Turquoise

  • Violet

  • White

  • Yellow

Description

The colours of the supported range must be defined with attribute @MediaColorName. Other colours must be defined with attribute @MediaColorNameDetails. When a colour is defined with attribute @MediaColorNameDetails, attribute @MediaColorName must be left empty.

Syntax for custom colours

XPath: /JDF/ResourcePool/Media/@MediaColorNameDetails

Type

String

Description

The colours of the supported range must be defined with attribute @MediaColorName. Other colours must be defined with attribute @MediaColorNameDetails. When a colour is defined with attribute @MediaColorNameDetails, attribute @MediaColorName must be left empty.

Media weight

Syntax

XPath: /JDF/ResourcePool/Media/@Weight

Type

Integer

Supported range

Positive values with unit g/m²

Description

Only a positive value is decoded. Negative values are ignored.

Media name

Syntax

XPath: /JDF/ResourcePool/Media/@DescriptiveName

Type

String

Supported range

[0 .. 40] characters

Description

Longer names are accepted but truncated to 40 characters.

Media type

Syntax for media types

XPath: /JDF/ResourcePool/Media/@MediaType

Type

Enumeration

Supported range

Paper

Transparency

Film

Other

Syntax for details of the media types

XPath: /JDF/ResourcePool/Media/@MediaTypeDetails

Type

NMTOKEN

Supported range

  • Stationary

  • PreCutTabs

  • Plain

  • Envelope

  • Aluminium

  • CardBoard

  • CD

  • ContinuousLong

  • ContinuousShort

  • CtPVisiblePhotoPolymer

  • CtPVisibleSilver

  • CtPThermal

  • DoubleWall

  • DVD

  • DryFilm

  • Envelope

  • EnvelopePlain

  • EnvelopeWindow

  • FlexoBase

  • FlexoPhotoPolymer

  • Flute

  • FullCutTabs

  • ImageSetterPaper

  • Labels

  • Letterhead

  • MultiLayer

  • MultiPartForm

  • Photographic

  • PlateUV

  • Polyester

  • SingleFace

  • SingleWall

  • TabStock

  • Tractor

  • TripleWall

  • WetFilm

Syntax for custom media types

XPath: /JDF/ResourcePool/Media/@oce:CustomMediaType

Type

String

Description

The media type is specified with attribute @MediaType. If attribute @MediaType is not available, then attribute @MediaTypeDetails is used.

If none of these attributes are found, attribute @oce:CustomMediaType is used.

Attribute @oce:CustomMediaType must only be used when a custom string cannot be mapped to @MediaType or @MediaTypeDetails.

Example

<Media ID="media_2" Class="Consumable" Status="Available" MediaType="Paper" MediaTypeDetails="Plain" Dimension="648.0 792.0"/>

Tab media type

Syntax

XPath: /JDF/ResourcePool/Media[@MediaTypeDetails=”PreCutTabs”]

Description

The media is considered as a tab media when @MediaTypeDetails = “PreCutTabs”.

Example

< Media ID = "media_1" Class="Consumable" Status="Available" DescriptiveName="My media" oce:CustomMediaType="TopColor" MediaColorNameDetails="White" Weight="80" MediaType="Paper" MediaTypeDetails="PreCutTabs" Dimension="648.0 792.0"/>

Insert media type

Syntax

XPath: /JDF/ResourcePool/Media[@ImagableSide=”Neither”]

Description

The media is considered as insert media when @ImagableSide = ”Neither”.

Pre-punched media

Syntax for the hole type

XPath: /JDF/ResourcePool/Media/@HoleType

Type

Enumeration

Supported range

@HoleType

Escape sequence

None

Not pre-punched

R2-generic

Pre-punched with 2 holes

R3-generic

Pre-punched with 3 holes

R4-generic

Pre-punched with 4 holes

Explicit

Pre-punched

Syntax for the number of holes

XPath: /JDF/ResourcePool/Media/@HoleCount

Type

Integer

Description

The punch pattern for pre-punched media is determined by @HoleType. When @HoleType is “Explicit” the number of pre-punched holes is determined by @HoleCount.

Attribute @HoleCount is only used when a free integer is required which is not covered by @HoleType. Attribute @HoleCount must be used only in combination with @HoleType=”Explicit”.

Media cycle length

Syntax

XPath: /JDF/ResourcePool/Media/@MediaSetCount

Type

Integer

Description

This attribute determines the number of different sheets in a set of cyclic media. Cyclic media are tab sheet, pre-printed color sheets, etc.

Media dimension

Syntax

XPath: /JDF/ResourcePool/Media/@Dimension

Type

XYPair

Description

The syntax for @Dimension is “X Y”, where X and Y are respectively the width (horizontal edge) and height (vertical edge) of the media. If X and/or Y = “0”, the Media Dimension specification will be ignored and the orientation is assumed to be portrait.

NOTE

In the PRISMAsync media catalogue, width is always less than or equal to the height. In JDF, this rule does not exist. However, whether X < Y, or Y < X, the correct media is always selected from the PRISMAsync media catalogue.

The unit for this attribute is: point (1 point=1/72 inch).

There is a tolerance of 5 points when specifying the media dimension. Any specified media which is within 5 points distance to a known standard media, or to a custom media defined in the media catalogue, is changed to the nearest corresponding known or custom media dimension.

Preferred feed edge

Syntax

XPath: /JDF/ResourcePool/Media/GeneralID[@IDUsage="oce:Orientation"]/@IDValue

Type

String

Supported range

@IDValue

Escape sequence

LongEdgeFeed

Request to print the job with long edge fed paper.

ShortEdgeFeed

Request to print the job with short edge fed paper.

Description

The preferred media feed edge is determined by "GeneralID" named "oce:Orientation". The attribute "@IDValue" is a request. Required job finishing (if specified) may cause the device to use another feed edge than specified as preferred feed edge.