Labeller
Interpolates labels along a linear or polygonal feature. Labels are
placed at a regular perpendicular distance from the closest point on the
line at some interval, and are given a rotation perpendicular to the line.
Parameters
Label
The label text desired on the output geometry.
Prevent Label Overlaps
If this parameter is
set to Yes, labels will only be generated if they don’t overlap with other
labels already generated by the same transformer. If it is set to No,
overlapping labels will be generated.
Label Position
The Label Position controls
where the label will be placed relative to the original line.
- If Above or Left
is specified, then the points are located the <offset> distance
above (or, if the line is vertical, to the left of) the line. Above
or Right is identical, except if the line is vertical then label
point will then be to the right of the linear feature.
- Below or Left
and Below or Right work similarly
with all label points being below the linear feature unless it is vertical.
If it is vertical, then the label points are to the left and right, respectively.
- If Right
is specified, then the label is always placed on the right side of the
line.
- If Left
is specified, then the label is always placed on the left side of the
line.
Label Offset
The labels
will be placed Label Offset units
perpendicular to the closest point on the line, where the offset is also
measured in ground units. You can either enter a number, or take the value of a feature attribute
by selecting the attribute name from the pull-down list.
Labels at End Points
This parameter
controls whether or not labels will be placed at the end points of the
line. If not, then the labels will start half the label spacing from the
start of the line.
Label Height
This parameter controls the
height of the labels, measured in ground units. You can either enter a number, or take the value of a feature attribute
by selecting the attribute name from the pull-down list.
Average Character Width
This parameter controls the
average character width. If left as the default, 0.0, the Label Height will also be used as the average character width.
Label Spacing
This parameter controls the
interval of the labels. A label spacing of 0 will result in a single label
being placed at the midpoint of the line. You can either enter a number, or take the value of a feature attribute
by selecting the attribute name from the pull-down list.
Minimum Length
This parameter
sets a length threshold. If a line does not meet the minimum length requirement,
no labels will be generated for it.
Label Rotation Attribute
This is the name of the attribute which will hold the rotation of the label. This rotation
is adjusted from the orientation of the line so that text oriented at
the label point will be parallel to the line segment and will not be upside
down or right-to-left.
All rotations are measured in degrees counterclockwise from horizontal.
Parallel Rotation Attribute
This is the name of the attribute which will hold the rotation of the line itself at
the point being labeled.
All rotations are measured in degrees counterclockwise from horizontal.
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
FME Licensing Level
FME Professional edition and above
Technical History
Associated FME function or factory: LabelFactory
Search FME Community
Search for samples and information about this transformer on the FME Community.