LVectorBase::SetOrigin

#include "ltwrappr.h"

virtual L_INT LVectorBase::SetOrigin(pOrigin=NULL)

/* pointer to a vector point */

Sets the new origin for the class object's associated vector.

Parameter	Description
pOrigin	Pointer to a VECTORPOINT structure that contains the new origin. If this parameter is NULL, the new origin will be calculated based on the objects currently in the vector handle.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

The origin of a vector drawing may change whenever new objects are added. To insure that the drawing is centered around its origin, call LVectorBase::SetOrigin(NULL) after adding objects.

The origin may be retrieved using LVectorBase::GetOrigin.

LVectorBase::ApplyTransformation must be called to make the new origin take effect; if you don’t your changes will not be saved.

Note for OpenGL and DirectX, this function has no effect.

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:	LVectorBase::GetOrigin, LVectorBase::ApplyTransformation
Topics:	Working with Vector Handles

Example

//This example moves the vector origin.
L_VOID Example63(HWND hWnd, LVectorBase *pVector)
{
   VECTORPOINT pointOrigin;

   pVector->GetOrigin (&pointOrigin);
   pointOrigin.x +=1;
   pVector->SetOrigin(&pointOrigin);
}