VECTOR_DISPLAY

VECTOR_DISPLAY_OPTIONS

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.

Comments

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.