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.
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>
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.
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.
Syntax
XPath: /JDF/ResourcePool/Media/@DescriptiveName
Type
String
Supported range
[0 .. 40] characters
Description
Longer names are accepted but truncated to 40 characters.
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"/>
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"/>
Syntax
XPath: /JDF/ResourcePool/Media[@ImagableSide=”Neither”]
Description
The media is considered as insert media when @ImagableSide = ”Neither”.
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”.
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.
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.
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.
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.