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)[burim]

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[burim]

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

clone() classObj[burim]

Return an independent copy of the class without a parent layer

convertToString() char[burim]

Output the CLASS as a Mapfile string

createLegendIcon(map: mapObj, layer: layerObj, width: int, height: int) imageObj[burim]

Draw and return a new legend icon

drawLegendIcon(map: mapObj, layer: layerObj, width: int, height: int, dstImage: imageObj, dstX: int, dstY: int) int[burim]

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

getExpressionString() char[burim]

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

getLabel(i: int) labelObj[burim]

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

getStyle(i: int) styleObj[burim]

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

getTextString() char[burim]

Return a string representation of TEXT

insertStyle(style: styleObj, index: int = -1) int[burim]

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[burim]

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

moveStyleUp(index: int) int[burim]

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

removeLabel(index: int) labelObj[burim]

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[burim]

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

setExpression(expression: char) int[burim]

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

setText(text: char) int[burim]

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

updateFromString(snippet: char) int[burim]

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