Label Object

Print this page
Learn more about Verizon Connect GeoBase.
Get information about the latest release

Label objects are used to manage placement of text on map features.

Labels are drawn after all other map features are placed no matter which block they are related to. During label drawing all labels are sorted into priority order. Labels with a higher priority will be drawn first if possible. A label will not be positioned with another label in its buffer region, or within another label's buffer.

Syntax

cam

Copy

LABEL<FONT[, buffer[, mindist[, priority[, auxiliarylayer]]]][:options]>

Examples

cam

Copy

LABEL<FONT<arial,10,(0,0,0)>, 10,30,50>
LABEL<!country_font, 10, 100, 100:overlay,overflow,expandable,upcase>
LABEL<!railway_font, 10, 40, 25:above_line>

Parameters

font

A font object that describes the font to render the label with.

buffer

The distance between this label and any other feature's label. Optional, defaults to 0.

mindist

The minimum distance allowed between any two labels within the same block that share the same text. Optional, defaults to 0.

priority

Used to determine the order for rendering and which labels are more likely to be displayed, high first. Optional, defaults to 0.

auxiliarylayer

Renders the label on the specified auxiliary layer. Optional, 0 to 255, defaults to 0.

Label Rendering Options

The following optional parameters may be specified, comma-separated, to control label rendering.

above_line

Renders the label above the center of the street line.

below_line

Renders the label below the center of the street line.

bendy_labels

Enable / disable 'bendy' labels. This permits the street labels to follow the curvature of the street.

Desktop default=true

colname

The GeoBase column to use for the text - only for custom data. See CustomColumn and Custom Lines.

curve_tolerance

Sets the tolerance for the curve when drawing labels on streets that are not straight. This allows street labels to slightly leave the street in order to draw the label. Allowed distance is n * font-size * 0.5, where n = 0 to 9.

Desktop default=0

expandable

If there is room, the label will be rendered with increased spacing between letters.

overflow

Polygon labels are not forcibly confined to the interior of the polygon. This is meaningless for other feature types, and has no effect.

overlay

Specifies that the label should be rendered on the overlay mask.

upcase

Renders the text using capital letters.

street_overflow

Allow street labels to overflow streets (sideways) by n * font-size * 0.5, where n = 0 to 9.

Desktop default=0