mapscript.classObj

class mapscript.classObj(layer: layerObj | None = None)

The CLASS object. Used for symbolization and classification information.

Overview

The classObj has the following relationships:

../../../_images/classObj_hashTableObj.png ../../../_images/classObj_labelObj.png ../../../_images/classObj_layerObj.png ../../../_images/classObj_styleObj.png

Examples

Class creation:

lyr = mapscript.layerObj()
lyr.name = 'foo'
c = mapscript.classObj(lyr)
assert c.thisown == 1
assert c.layer.name == lyr.name
assert c.numstyles == 0

Attributes

debug

int MS_TRUE or MS_FALSE - see DEBUG

group

char See GROUP

isfallback

int MS_TRUE or MS_FALSE use MS_TRUE if this class should be applied if and only if no other class is applicable

keyimage

char See KEYIMAGE

layer

layerObj immutable reference to the parent layer

leader

labelLeaderObj immutable see LEADER

maxscaledenom

double See MAXSCALEDENOM

metadata

hashTableObj immutable see METADATA

minfeaturesize

int See MINFEATURESIZE minimum feature size in pixels

minscaledenom

double See MINSCALEDENOM

name

char See NAME should be unique within a layer

numlabels

int immutable number of labels for class

numstyles

int immutable number of styles for class

refcount

int immutable number of references to this object

sizeunits

int Supersedes layer's sizeunits and applies to all styles and labels - see LAYER SIZEUNITS

status

int MS_ON or MS_OFF - draw features of this class or do not - see STATUS

template

char See TEMPLATE

thisown

The membership flag

title

char See TITLE

validation

hashTableObj immutable see VALIDATION

Methods

__init__(layer: layerObj | None = None)[исходный код]

Create a new child classObj instance at the tail (highest index) of the class array of the parent_layer. A class can be created outside the context of a parent layer by omitting the layerObj constructor argument

addLabel(label: labelObj) int[исходный код]

Add a labelObj to the classObj and return its index in the labels array

clone() classObj[исходный код]

Return an independent copy of the class without a parent layer

convertToString() char[исходный код]

Output the CLASS as a Mapfile string

createLegendIcon(map: mapObj, layer: layerObj, width: int, height: int) imageObj[исходный код]

Draw and return a new legend icon

drawLegendIcon(map: mapObj, layer: layerObj, width: int, height: int, dstImage: imageObj, dstX: int, dstY: int) int[исходный код]

Draw the legend icon onto image at dstx, dsty. Returns MS_SUCCESS or MS_FAILURE

getExpressionString() char[исходный код]

Return a string representation of the EXPRESSION enclosed in the quote characters appropriate to the expression type

getLabel(i: int) labelObj[исходный код]

Return a reference to the labelObj at index in the labels array

getStyle(i: int) styleObj[исходный код]

Return a reference to the styleObj at index in the styles array

getTextString() char[исходный код]

Return a string representation of TEXT

insertStyle(style: styleObj, index: int = -1) int[исходный код]

Insert a copy of style into the styles array at index index Default is -1, or the end of the array. Returns the index at which the style was inserted.

moveStyleDown(index: int) int[исходный код]

Swap the styleObj at index with the styleObj at index + 1

moveStyleUp(index: int) int[исходный код]

Swap the styleObj at index with the styleObj at index - 1

removeLabel(index: int) labelObj[исходный код]

Remove the labelObj at index from the labels array and return a reference to the labelObj. numlabels is decremented, and the array is updated

removeStyle(index: int) styleObj[исходный код]

Remove the styleObj at index from the styles array and return a copy.

setExpression(expression: char) int[исходный код]

Set EXPRESSION string where expression is a MapServer regular, logical or string expression. Returns MS_SUCCESS or MS_FAILURE

setText(text: char) int[исходный код]

Set TEXT string where text is a MapServer text expression. Returns MS_SUCCESS or MS_FAILURE

updateFromString(snippet: char) int[исходный код]

Update a class from a string snippet. Returns MS_SUCCESS or MS_FAILURE