VECTOR_DISPLAY_OPTIONS

Summary

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.

Syntax

typedef  struct  _VECTOR_DISPLAY_OPTIONS 
{ 
   VECTOR_TEXTRENDER TextRender; 
   VECTOR_ANTIALIASING AntiAliasing; 
   L_INT  nClipMode; 
   L_SIZE_T  dwReserved; 
} VECTOR_DISPLAY_OPTIONS,  *pVECTOR_DISPLAY_OPTIONS; 

Members

VECTOR_TEXTRENDER TextRender

Text rendering options.

VECTOR_ANTIALIASING AntiAliasing

Anti-aliasing setting. VECTOR_ANTIALIASING structure that contains the anti-aliasing information.

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

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

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.

Usage

Data Types

Functions

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Vector C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.