L_VecSetViewMode

#include "lvkrn.h"

L_INT EXT_FUNCTION L_VecSetViewMode(pVector, nMode)

pVECTORHANDLE pVector;

/* pointer to a vector handle */

L_INT nMode;

/* the view mode to set */

Sets the view mode.

Parameter

Description

pVector

Pointer to the vector handle.

nMode

The view mode to set. Possible values are:

 

Value

Meaning

 

VECTOR_VIEWMODE_FIT

Fit the drawing on the view-port, keeping the aspect ratio.

 

VECTOR_VIEWMODE_SNAP

Snap the drawing into the view-port.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This function will set the view mode used when drawing the vector handle.

The view mode is used with the view port to determine the resulting physical drawing extents.

Not supported in OpenGL and DirectX.

Required DLLs and Libraries

LVKRN

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

L_VecGetViewMode, L_VecPaint

Example

/* This example toggles the view mode of a vector handle */

void ToggleViewMode( pVECTORHANDLE pVector )
{
   if(L_VecGetViewMode( pVector ) == VECTOR_VIEWMODE_FIT)
      L_VecSetViewMode( pVector, VECTOR_VIEWMODE_SNAP );
   else
      L_VecSetViewMode( pVector, VECTOR_VIEWMODE_FIT );
}