L_VecSetCamera

#include "lvkrn.h"

L_INT EXT_FUNCTION L_VecSetCamera(pVector, pCamera)

pVECTORHANDLE pVector;

/* pointer to a vector handle */

const pVECTORCAMERA pCamera;

/* pointer to a structure */

Sets the new camera settings.

Parameter

Description

pVector

Pointer to a vector handle.

pCamera

Pointer to a VECTORCAMERA structure that contains the new camera settings. If this is NULL, the default camera settings will be used.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This function will set the current viewing camera.

The camera is used with the view port to determine how the drawing will be projected into the destination DC when using L_VecPaint.

If pCamera is NULL, the default camera will be set. The default camera is defined as a top view camera .

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_VecGetCamera, L_VecPaint

Example

/* This example will set new camera settings */

void SetMyCamera( pVECTORHANDLE pVector )
{
   VECTORCAMERA   camera;     /* Camera */   

   /* Set rotation around the Z-axis to 30 degrees */
   camera.Theta = 30.0;

   /* Set rotation off the Z-Axis to 60 degrees */
   camera.Phi = 20.0;

   /* Use perspective projection */
   camera.bPerspective = TRUE;

   /* Set camera position 200 units from the object */
   camera.Distance = 200.0;

   /* Set the new camera settings */
   L_VecSetCamera( pVector, &camera );
}