PEXOCCRemoveFromNameSet - Remove Names from Name Set (5.0)

Synopsis

 
   void PEXOCCRemoveFromNameSet(
           PEXOCC context,
           unsigned long count,
           PEXName *names
      )

 
   void PEXRemoveFromNameSet(
           Display *display,
           XID resource_id,
           PEXOCRequestType req_type,
           unsigned long count,
           PEXName *names
     )

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).
count: The number of names.
names: An array of names to be removed from the current name set.

Returns

None.

Description

Invoke PEXOCCRemoveFromNameSet to create an attribute output command which removes the specified list of names from the name set indicated by the renderer's pipeline state.

PEXlib uses included and excluded names to determine whether functions, such as highlighting, invisibility, and picking, should be applied to a primitive based on the pipeline state's name set.

If any name is above the maximum supported value for a name, then PEXlib ignores that name. Inquire the maximum supported value for a name by invoking the PEXGetImpDepConstants function.

This function is a member of the global attribute set and affects all output primitives.

Errors