PEXOCCSetMarkerScale - Set Marker Scale (5.0)

Synopsis 

 
   void PEXOCCSetMarkerScale(
        PEXOCC context,
        double scale
   )
 


 
   void PEXSetMarkerScale(
        Display *display,
        XID resource_id,
        PEXOCRequestType req_type,
        double scale
    )

Arguments

context
An OC context returned by a successful PEXCreateOCC call.

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).

scale
The marker scale factor.

Returns

None.

Description

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

By setting the marker scale attribute's ASF to PEXIndividual (see PEXOCCSetIndividualASF), you use the pipeline state's marker scale entry to set the size of a marker. When you set the marker scale attribute's ASF to PEXBundled, the implementation uses the marker scale from the marker bundle table.

PEXlib multiplies the value you specify for scale by the nominal marker size for the display device. Then it maps the marker size to the nearest supported marker size. A negative marker scale factor results in the smallest supported marker.

Inquire the nominal marker size, the minimum marker size, the maximum marker size, and the number of supported marker sizes by invoking the PEXGetImpDepConstants function.

This 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 output attribute functions, see Output Attribute Functions.