void PEXOCCSetPatternSize(
PEXOCC context,
double width,
double height
)
void PEXSetPatternSize(
Display *display,
XID resource_id,
PEXOCRequestType req_type,
double width,
double height
)
None.
Invoke PEXOCCSetPatternSize to create an attribute output command which sets the pattern size attribute, in modeling coordinates, in the renderer's pipeline state.
This function only applies the magnitude of the specified width and height.
To determine if your implementation supports PEXInteriorStylePattern, invoke the PEXGetEnumTypeInfo request. If the style is supported, then the pipeline state's interior style index selects an entry of the renderer's pattern table and applies it to fill area primitives of interior style PEXInteriorStylePattern.
When applying interior style PEXInteriorStylePattern to a fill area primitive, the reference point and vectors are projected along a normal vector onto the plane of each facet of the primitive. A parallelogram is formed with it's origin defined by the projected reference point. A vector (vector1) defines one side of the parallelogram. This vector's direction is parallel to the first projected reference vector and has a length that is equal to the absolute value of the x-component of the pattern size. The adjacent side of the parallelogram is defined similarly by the second projected reference vector (vector2) and the absolute value of the y-component of the pattern size. The pattern, a list of m x n equally-sized color cells, is applied across the parallelogram such that the first cell has the parallelogram origin in one corner. The first m colors in the pattern correspond to the row of cells nearest to and along the first projected reference vector (vector1). The pattern is mapped onto the facet by replicating the pattern parallelogram in directions parallel to the parallelogram's sides until the entire facet is covered.
If you specify the interior style as PEXInteriorStylePattern, then the implementation uses the pattern size width and height plus the pattern reference point and the pattern reference vector to position, scale, and rotate the pattern on the surface. If you specify either of the x-component and/or the y-component as zero, then the implementation ignores this output command and the pattern size entry of the pipeline state is not updated.
This function is a member of the styled and shaded surface attribute set.
For an overview and for a list of all output attribute functions, see Output Attribute Functions.