L_VecSetViewport

#include "lvkrn.h"

L_LVKRN_API L_INT L_VecSetViewport(pVector, pViewport)

pVECTORHANDLE pVector;

pointer to a vector handle

const L_RECT *pViewport;

pointer to a structure

Sets the current view port.

Parameter

Description

pVector

Pointer to a vector handle.

pViewport

Pointer to a RECT structure that contains data on the new view port.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Use this function to set the view port associated with a vector.

If pVector is attached to a window, you must call this function when processing WM_SIZE messages, since the VECTOR library needs to know when the window size has changed (DirectX), or when the double buffer mode is selected in the current VECTOR engine.

This function and L_VecSetCamera are required to complete the projection process from a vector image onto a 2D surface.

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_VecGetViewport, L_VecSetPan, L_VecGetPan

Example

This example will use L_VecSetViewport to realize a vector drawing into the upper left corner of a BITMAPHANDLE.

L_INT VecSetViewportExample( 
pVECTORHANDLE pVector, 
pBITMAPHANDLE pBitmap) 
{ 
   L_INT nRet; 
   RECT rect; 
   /* Setup the viewport rectangle */ 
   rect.left   = 0; 
   rect.top    = 0; 
   rect.right  = pBitmap->Width / 2; 
   rect.bottom = pBitmap->Height / 2; 
   /* Set the viewport */ 
   nRet = L_VecSetViewport( pVector, &rect ); 
   if (nRet != SUCCESS) 
      return nRet; 
   /* Realize */ 
   nRet = L_VecRealize( pBitmap, pVector, FALSE ); 
   return nRet; 
} 

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Vector C API Help