typedef struct _VECTOR_DISPLAY_OPTIONS
{
VECTOR_TEXTRENDER TextRender;
VECTOR_ANTIALIASING AntiAliasing;
L_INT nClipMode;
L_SIZE_T dwReserved;
}VECTOR_DISPLAY_OPTIONS, *pVECTOR_DISPLAY_OPTIONS;
The VECTOR_DISPLAY_OPTIONS structure has the display settings for the vector toolkit. Some or all of the members can be set to apply some effects or filters to the output.
Member | Description | |
TextRender | Text rendering options. | |
AntiAliasing | Anti-aliasing setting. VECTOR_ANTIALIASING structure that contains the anti-aliasing information. | |
nClipMode | Flag that describes how the toolkit applies the clipping when two or more clipping polydraw objects exist. Possible values are: | |
Value | Meaning | |
VECTOR_CLIPMODE_COPY | Overwrite the old clipping region with this one. | |
VECTOR_CLIPMODE_AND | Generates a new clipping region from the intersection of the old and current regions. | |
VECTOR_CLIPMODE_DIFF | Generates a new clipping region in the area between the old and current regions. | |
VECTOR_CLIPMODE_OR | Generates a new clipping region from the area represented by both the old and current regions. | |
VECTOR_CLIPMODE_XOR | Generates a clipping region from XORing the two clipping regions (the old one and the current). | |
The "old region" refers to the region specified by a clipping polydraw that was added previously to the vector space and the "current region" is a new region that is about to be drawn. | ||
dwReserved | Reserved for future expansion. Use 0. |
pVECTOR_DISPLAY_OPTIONS is a pointer to a VECTOR_DISPLAY_OPTIONS structure. Where the function parameter type is pVECTOR_DISPLAY_OPTIONS, you can declare a VECTOR_DISPLAY_OPTIONS variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pVECTOR_DISPLAY_OPTIONS variable is necessary only if your program requires a pointer.
The VECTOR_DISPLAY_OPTIONS structure is used with the LVectorBase::GetDisplayOptions and LVectorBase::SetDisplayOptions functions.
A clipping polydraw sets a clipping region that is applied to any vector object added after the clipping polydraw is added. For example, if the user adds object #1, then adds a clipping polydraw, and then adds objects #2 and #3, the toolkit will draw object #1 without modification. It will then render the clipping polydraw, which will set a clipping region. the toolkit will then draw objects #2 and #3, which will be clipped according to the clipping polydraw and the clip mode specified in nClipMode.
If nClipMode is set to 0, no clipping will be performed.