LabelPointReplacer

Replaces the geometry of the feature with a label point.

The insertion point of the text is guaranteed to be inside (in case of polygons) or on (lines and points) the original object. Note that since the text itself may be larger than an input area feature, the bounds of the label may exceed the bounds of the area.

Input Ports

Input

Input features must have the correct geometry: point, line or area.

Output Ports

Labelpoint

The features with the replaced geometry are output via this port.

<Rejected>

Invalid features are output via this port.

Rejected features will have an fme_rejection_code attribute with one of the following values: EXTRA_FEATURE, INVALID_GEOMETRY_TYPE, INVALID_GEOMETRY_VERTICES.

Results

• If the feature was already a point, it is simply turned into a text feature at the original location.
• If the feature was a line, it is turned into a point text feature at the midpoint of the line, with a rotation parallel to the line.
• If the feature was an area feature, the resulting point is somewhere in the interior of the feature (and outside of any holes in the area).

Parameters

Label

The label to add to the geometry.

Label Height

The label height is measured in ground units, and may either be entered as a number, or can be taken from the value of a feature attribute by selecting the attribute name from the pull-down list.

Always Rotate Label

The label is rotated to prevent it from appearing upside down.

Example

Editing Transformer Parameters

Using a set of menu options, transformer parameters can be assigned by referencing other elements in the workspace. More advanced functions, such as an advanced editor and an arithmetic editor, are also available in some transformers. To access a menu of these options, click beside the applicable parameter. For more information, see Transformer Parameter Menu Options.

Transformer Categories

Cartography and Reports

Geometries

Related Transformers

To generate a point that will be used as a centroid for polygons, use an CenterPointReplacer. This saves you the overhead of having a text object.

FME Licensing Level

FME Professional edition and above

Technical History

Associated FME function or factory: @GeneratePoint, PIPComponentsFactory

Search FME Knowledge Center

Search for samples and information about this transformer on the FME Knowledge Center.

Tags Keywords: LabelPointCreator TextReplacer