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)[źródło]

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[źródło]

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

clone() classObj[źródło]

Return an independent copy of the class without a parent layer

convertToString() char[źródło]

Output the CLASS as a Mapfile string

createLegendIcon(map: mapObj, layer: layerObj, width: int, height: int) imageObj[źródło]

Draw and return a new legend icon

drawLegendIcon(map: mapObj, layer: layerObj, width: int, height: int, dstImage: imageObj, dstX: int, dstY: int) int[źródło]

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

getExpressionString() char[źródło]

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

getLabel(i: int) labelObj[źródło]

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

getStyle(i: int) styleObj[źródło]

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

getTextString() char[źródło]

Return a string representation of TEXT

insertStyle(style: styleObj, index: int = -1) int[źródło]

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[źródło]

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

moveStyleUp(index: int) int[źródło]

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

removeLabel(index: int) labelObj[źródło]

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[źródło]

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

setExpression(expression: char) int[źródło]

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

setText(text: char) int[źródło]

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

updateFromString(snippet: char) int[źródło]

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