ChartDirector 7.0 (Python Edition)

ContourLayer.setContourLabelSpacing


Usage

setContourLabelSpacing(labelSpacing, minContourLen)

Description

Sets the spacing between contour labels.

ChartDirector will try to place labels at relative straight segments along the contour while ensuring the labels are not too close together. The default target label spacing is 300 pixels.

If the contour is short relative to the label length, all or a large part of the contour may become the label, and the contour line may become hard to see. By default, ChartDirector will not put a label on a contour if the contour length is less than 3 times that of the label length. This allows the contour on either side of the label to be as least as long as the label.

This method can be used to adjust what is the target label spacing and contour length for positioning labels.

Arguments

ArgumentDefaultDescription
labelSpacing(Mandatory)The target label spacing in pixels. The actual spacing may be different as the labels can only be placed on relatively straight segments along the contour.
minContourLen(Mandatory)The minimum contour length in pixels below which there will be no contour label.

Return Value

None