PDFPageFormatter

Specifies the standard unit of measurement that displays in this dialog: Inches, Centimeters, or Points.

Note: A point measures 1/72 of an inch. For example, a Letter-sized page measures 612 x 792 points.

Specifies which page will contain the desired Page Objects.

Selecting one of the commonly used page sizes will populate the Page Width and Page Height parameters with the corresponding dimensions of the selected page in the currently selected unit.

Specifies the orientation of the page. Switching between Portrait and Landscape will swap the values of Page Width and Page Height.

The width of the PDF page to be produced. The unit of this value is specified in the Preferred Unit parameter.

The height of the PDF page to be produced. The unit of this value is specified in the Preferred Unit parameter.

A visual rendering of the boxes on the page where content will be placed by the writer. Each box is labeled with the corresponding input port.

Boxes can be dragged to new locations and can be resized by dragging an edge or corner of the box.

To set the input port and location explicitly, double-click the box or select the ‘Properties…’ option on the context menu for a box. An Edit Page Object dialog opens, where you can specify the Input Port that is supplying the data for the box, as well as the position (Upper Left X coordinate and Upper Left Y coordinate) and size (Width and Height) of the box.

Which input port the page object corresponds to on the transformer. It is possible to map multiple input ports to the same page object if wanting to route the data in the workflow differently due to styling or order but have them drawn in the same location on the page.

The X coordinate of the upper left corner of the page object in page units. Changing these values will change the location of the page object on the canvas.

The Y coordinate of the upper left corner of the page object in page units. Changing these values will change the location of the page object on the canvas.

The horizontal breadth of the page object in page units. Changing these values will resize the page object on the canvas.

The vertical breadth of the page object in page units. Changing these values will resize the page object on the canvas.

The normal behavior of the transformer is to capture both the world bounds of the input features, the page bounds and the page object bounds to define the locations and size of the feature on the page. The default behavior is to scale the features in a uniform way in both X and Y dimensions, also known as maintaining the same aspect ratio or relative scaling for the height and width of each input feature geometry.

By default, the Maintain Aspect Ratio setting of Yes will use the minimum scale factor for x and y to fit the input feature geometry bounds into the page object bounds, maintaining the shape of the input feature geometries. Conversely, a value of No will scale x and y values independently to obtain a better fit of the input features into the page object bounds at the cost of potentially distorting their shape and location.

Features that extend beyond the bounds of the page object were previously clipped to the bounds of the object. This option allows input features to optionally be clipped or to extend beyond the page object boundary when rendered. The new default is No indicating that the input features will not be clipped to the page object boundary.

Note that in the default case the world rectangle is calculated using the bounds of the input features for this page object and thus when the input features are scaled to match the page object they should all fit inside. Exceptions may occur if the world rectangle is modified manually or if the bounds for the input features are not representative of the rendered geometry. This may occur specifically with text and multitext inputs which use only rough approximate bounds.