Uts_print_editor

Synopsis

The true scale print editor allows you to set parameters to affect the printing of the view

Input Ports

Output Ports

none

Description

Uts_print_editor does not change the appearance of the object currently in the view; it allows you to set parameters to affect the printing of the view. When you select True Scale Print from the Editors menu, you will see that the TrueScale print editor has two separate sections: TrueScaleUI and PrintUI.

Uts_print_editor is similar to the other UI editors in the GD kit. It is not a part of the SingleWindowApp or MultiWindowApp by default. When connected to a Uviewer3D, for example, it will be added as an entry in the Editors menu. Uts_print_editor may also be parented in a UIshell.

Note that the preview is not an exact representation of what will be drawn. Text and other items may not be normalized appropriately. The preview should be used as a guide to choosing the TrueScale parameters.

Input Ports

in_render_view

The render view to perform editing operations on

in_view

The view to perform editing operations on

Parameters

Uniform Scaling

Selecting Uniform Scaling causes the same scale factor (Map Scale) to be used for both the x and y dimensions.

Map Scale (units/cm)

Map Scale defines the scale factor for the x axis. Map Scale is the number of a field’s coordinate system units that should be mapped to each centimeter of printed page. If Uniform Scaling is selected, Map Scale is also used for the y axis. This scale factor can be any value greater than zero.

Y Map Scale (units/cm)

Y Map Scale is used to set a scale factor for the y axis that is different from the scale factor for the x axis and is only available if Uniform Scaling is not selected. Y Map Scale can be any value greater than zero.

X Origin

X Origin defines the x coordinate of the scene that should be mapped to the left-most point on the printed page.

Y Origin

Y Origin defines the y coordinate of the scene that should be mapped to the bottom of the printed page.

Scale Data to Fit

Scale Data to Fit is similar to the Normalize command in a viewer. It calculates values for Map Scale, Y Map Scale (if Uniform Scaling is not selected), and the x and y origins such that the entire scene fits within the extents of the selected paper size.

Center Data

Center Data adjusts the origins in order to center the object on the printed page. It will not change any scale factors that you have set.

Show Preview

When Show Preview is selected, a viewer is created in a UIshell for use as a preview window. The preview window contains all of the objects in the view as well as an outline representing the current printer page size. Clearing Show Preview makes the preview window disappear. This preview always has auto-normalize on, so that the object and page outline will always be visible.

Note that the preview is not an exact representation of what will be drawn. Text and other items may not be normalized appropriately. The preview should be used as a guide to choosing the TrueScale parameters, not as a substitute for the TrueScale output.

Preview Match Background

Setting this option will cause the preview window to use the background specified in the PrintUI portion of the TrueScale interface. Clearing this option will cause the TrueScale preview to use a black background.

Note: Some objects (e.g., AGContourFieldObj) have geometry specified in their viewports that overrides the coordinates of the data. This geometry array is typically goes from -3 to 3 for X and Y and these values will form the basis for TrueScale scaling, not the data coordinates. To scale based on the data coordinates, you can change the geometry specified in the object’s viewport to refer to the input data (e.g., geometry => in_field.points).

See Also

UtsPrintEditor