PEXOCCSetMarkerType - Set Marker Type (5.0)

Synopsis 

 
   void PEXOCCSetMarkerType(
        PEXOCC context,
        int marker_type
   )
 


 
   void PEXSetMarkerType(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        int marker_type
   )

Arguments

display (OCC)
A pointer to a display structure returned by a successful XOpenDisplay call.

resource_id (OCC)
The resource identifier of the renderer or structure.

req_type (OCC)
The request type for the output command (PEXOCRender, PEXOCStore, PEXOCRenderSingle or PEXOCStoreSingle).

marker_type
The marker type (PEXMarkerDot, PEXMarkerCross, PEXMarkerAsterisk, PEXMarkerCircle or PEXMarkerX).

Returns

None.

Description

Invoke PEXOCCSetMarkerType to create an attribute output command which sets the marker type attribute in the renderer's pipeline state according to the value specified by marker_type.

By setting the marker type attribute's ASF to PEXIndividual (see PEXOCCSetIndividualASF), you use the pipeline state's marker type entry to set the style for rendering markers. When you set the marker type attribute's ASF to PEXBundled, the implementation uses the marker type from the marker bundle table.

Use marker_type to specify the shape of a marker primitive. If the renderer's marker glyph table entry is Null, then the marker type selects one of the following marker types defined by PEXlib:

PEXMarkerDot -
"." (dot) displays the smallest dot supported by the implementation. The marker scale factor is ignored. The dot is positioned at the marker position. (5.0)

PEXMarkerCross -
"+" displays a cross or plus sign. The intersection of the cross is positioned at the marker position. (5.0)

PEXMarkerAsterisk -
"*" displays an asterisk or star. The intersection of the asterisk is positioned at the marker position. (5.0)

PEXMarkerCircle -
"o" displays a circle. The center of the circle is positioned at the marker position. (5.0)

PEXMarkerX -
"x" displays an x. The intersection of the x is positioned at the marker position. (5.0)

If the renderer's marker glyph table entry is Null and you specify a marker type (marker_type) that is not supported, then the marker type defaults to PEXMarkerAsterisk. Inquire the supported values for the marker type by invoking the PEXGetEnumTypeInfo function.

The marker type function is a member of the marker attribute set.

Errors

BadPEXRenderer
The specified renderer resource identifier is invalid.

BadPEXStructure
The specified structure resource identifier is invalid.

See Also

For an overview and for a list of all output attribute functions, see Output Attribute Functions.