Feature Representation

In addition to the generic FME feature attributes that FME Workbench adds to all features (see About Feature Type Attributes), this format adds the format-specific attributes described in this topic.

FME raster features represent raster data and use several concepts that are unlike those used in the handling of vector data. See About FME Rasters.

PDF files can be written with non-square pixel dimensions.

PDF supports rasters with an arbitrary number of bands, provided all bands are the same data type and no band has a palette. PDF also supports rasters with a single band that has a palette.

Attribute Name	Contents
pdf_type	The value specifies PDF geometric type of this entity. Range: pdf_area pdf_collection pdf_line pdf_point pdf_text Default: No default
pdf_name	If attribution data is written, then the value of this attribute determines the name of the structure element associated with the feature. If this attribute is not set, then the structure element will be numbered sequentially. The names need not be unique. Range: <string> Default: <auto-generated integer>
pdf_feature_order	The value specifies the order in which features are drawn when they are written to the same page, frame, and layer. Features with the most negative value will be drawn first, and features with the most positive value will be drawn last. Range: <integer> Default: 0
pdf_line_width	The value specifies the line width in typographical points of line geometries and boundaries of area geometries. Points within half the line width perpendicular distance from the line path will be painted. Range: <float> Default: 1.0
pdf_line_cap_style	The value specifies the cap style for the ends of lines. Range: 0 - Butt cap: Lines are squared off at the end and do not project past the end of the line. 1 - Round cap: Semicircles with diameter equal to the line width cap the ends of lines. 2 - Projecting square cap: Lines project past the end by a distance equal to half the line width and are squared off. Default: 0
pdf_line_join_style	The value specifies the shape of corners between segments of paths. Range: 0 - Miter join: Outer edges of segments are extended until they meet. 1 - Round join: Arcs with diameter equal to the line width are drawn around corners. 2 - Bevel join: Two adjacent segments are finished with butt caps, and the notch beyond the ends is filled with a triangle. Default: 0
pdf_line_miter_limit	For miter joins, the miter limit imposes a maximum on the ratio of the miter length to the line width. For example, a miter limit of 1.414 will bevel the ends of two segments meeting at an angle less than 90 degrees (the far corner will be at a distance sqrt(1^2+1^2)=sqrt(2) from the line). Range: <0.0...> Default: 0.0
pdf_line_dash_pattern{}	The values in this list attribute specify the dash pattern for line geometries and the boundaries of area geometries. This attribute works together with pdf_line_dash_pattern_phase to establish a simple dashed line style. Elements of the list specify the alternating lengths of dashes and gaps. The pattern starts with a dash. Range: For each element in the list: <1,2,...> Default: Empty list
pdf_line_dash_pattern_ phase	The value specifies the starting phase of the dash pattern. This attribute works together with pdf_line_dash_pattern to establish a simple dashed line style. The following is an example dash pattern specification: pdf_line_dash_pattern{0} = 2 pdf_line_dash_pattern{1} = 3 pdf_line_dash_pattern_phase = 1 A dash of length 1 will be drawn, then gaps of length 3 and dashes of length 2 will cyclically follow thereafter. Before beginning to stroke a path, the dash array is cycled, adding the lengths of dashes and gaps. When the accumulated length equals the value specified by the dash phase, stroking of the path begins, and the dash array is used cyclically from that point onward. The table below shows examples of line dash patterns. As shown, an empty dash array and zero phase can be used to restore the dash pattern to a solid line: Range: <0,1,2,...> Default: 0
pdf_url	If this attribute is set, then the feature will become an interactive annotation. When a user clicks on the feature in a PDF viewer application that supports URI actions, the value will be treated as a URI and it will be resolved. In the common case that the value is a URL, Adobe Acrobat Reader will open a web browser to resolve the address specified. Note: See the Annotations below for behavioral notes.
pdf_tooltip	If this attribute is set, then the feature will become an interactive annotation. The value specifies the tooltip string that will be displayed when an user hovers over the feature with the mouse cursor in the PDF viewer application. Note: See Annotations below for behavioral notes.
pdf_fill_opacity	The value specifies the opacity of the fill color of the feature. A value of 1.0 is fully opaque, and 0.0 is completely transparent. If this value is not set, then the opacity of the feature is determined by the pdf_default_opacity feature type parameter. If the feature type parameter is not set either, then the writer parameter Default Opacity determines the opacity.
pdf_pen_opacity	The value specifies the opacity of the stroking color of the feature. A value of 1.0 is fully opaque, and 0.0 is completely transparent. If this value is not set, then the stroking opacity is set to fully opaque.

Text

pdf_type: pdf_text

A PDF text feature is drawn as a text annotation according to its fme_text_string, fme_text_size, and fme_rotation attributes.

The encoding of the text string is determined as follows:

If the font is one of the PDF Core 14 fonts, then the string is decoded using Windows ANSI code page 1252.
If the font is a TrueType font, then the string is decoded using the Macintosh Roman code page. If the TrueType font has a Microsoft Symbol character map table, then the font is treated as a symbolic font, and the text string can specify characters in the FF00-FFFF range of the character map by encoding only the low-byte of the code point.

Desired characters in symbolic fonts can either be specified using XML numeric character references (NCR) in rich text format (see below) or if the code point coincides with ASCII characters, the ASCII characters themselves.

Note that text and multitext geometries in FME currently do not support justification and have an insertion point of the text baseline and the left edge of the text bounding box. Due to the FME text geometry bounds being only an approximation, these are not attempted to be mapped to the PDF lower left corner bounds text justification model. Instead, the insertion points are mapped directly. The result is that, unlike non-text geometries, rendered text may appear below the expected insertion point, particularly for multitext geometries.

The following attributes are applicable to text features:

Attribute Name	Contents
pdf_text_font	The value specifies the default font family of the text representation. If left blank, Helvetica will be used. Default: Helvetica
pdf_text_underline	If the value is Y, the text will be underlined. Default: N
pdf_text_strikethrough	If the value is Y, the text will have a strikethrough. Default: N
pdf_text_bold	If the value is Y, the text will have a bold style. Default: N
pdf_text_italic	If the value is Y, the text will have an italic or oblique style. Default: N

The text string can be specified in a rich text format. The format is a subset of XHTML. For more information on XHTML, visit http://www.w3.org/TR/xhtml1/. The following are the supported XML elements:

<body>...</body>, <span>...</span>, <p>...</p>	Can be used to specify a style for its enclosed text through its “style” attribute.
<b>...</b>	Bolds the enclosed text.
<i>...</i>	Italicizes the enclosed text.
<u>...</u>	Underlines the enclosed text.
<del>...</del>	Adds a strikethrough to the enclosed text.
<br/>	Adds a line break.

The “style” XML attribute has the following format:

“property:value;...;property:value”

The following properties are supported:

font-family	Specifies the font family of the text.
font-size	Specifies the point size of the font.
color	Specifies the color of the text. The color can be specified through the format “#RRGGBB” where each color component is specified as a hexadecimal value, or through the 16 HTML color names (http://www.w3.org/TR/REC-html40/types.html#h-6.5).
text-decoration	Valid values are “underline” and “line-through”.

The following is an example rich text fme_text_string value:

<body>Hello<br/><span style=”font-size:30”>World!</span></body>

In the PDF document, the text “Hello” will use the styling specified through the format attributes. The text “World!” appears on the next line and will have a font size of 30 but will inherit all other style attributes.

Rasters

pdf_type: pdf_raster

A PDF raster feature is drawn as a grid of pixels comprising an image. Rasters written to PDF are converted to a JPEG2000 byte string and stored as a blob. Therefore, the nature of raster support is defined by the JPEG2000 format.

The following attribute is applicable to raster features:

Attribute Name	Contents
pdf_raster_compression_level	It sets the quality of the compression. The range of the value is from 0 (best quality) to 100 (worst quality). The default value is 75. Setting the value to 0 enables lossless compression. This is a writer attribute.

Attribute Name

Contents

pdf_raster_compression_level

It sets the quality of the compression.

The range of the value is from 0 (best quality) to 100 (worst quality). The default value is 75. Setting the value to 0 enables lossless compression.

This is a writer attribute.