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.