VIEW3D REFERENCE

Object Editing Functions

The following functions can be used to control the interactive editing of an object.

Function Name Description
XintView3DChangeEditVectorDir Changes the direction of the edit vector.
XintView3DChangeEditVectorLoc Changes the location of the edit vector.
XintView3DDisableEditVector Disable editing of objects.
XintView3DVectorGetCount Get the number of vertices in the specified object.
XintView3DVectorGetValue Get the object vertex value at the specified index.
XintView3DEnableEditVector Enable editing of objects.
XintView3DUpdateModel Recalculate the object limits after an object has been modified.
XintView3DUpdateObject Update an object after it has been edited.
XintView3DVectorSetValue Set a new vertex value for the specified object.

Function Name	Description
XintView3DChangeEditVectorDir	Changes the direction of the edit vector.
XintView3DChangeEditVectorLoc	Changes the location of the edit vector.
XintView3DDisableEditVector	Disable editing of objects.
XintView3DVectorGetCount	Get the number of vertices in the specified object.
XintView3DVectorGetValue	Get the object vertex value at the specified index.
XintView3DEnableEditVector	Enable editing of objects.
XintView3DUpdateModel	Recalculate the object limits after an object has been modified.
XintView3DUpdateObject	Update an object after it has been edited.
XintView3DVectorSetValue	Set a new vertex value for the specified object.

XintView3DChangeEditVectorDir

This function changes the direction of the edit vector.

     void XintView3DChangeEditVectorDir (...)

Widget widget ID of the View3D widget.
XintVector3 new_direction The new direction for the edit vector.

XintView3DChangeEditVectorLoc

This function changes the location of the edit vector.

     void XintView3DChangeEditVectorLoc (...)

Widget widget ID of the View3D widget.
XintVector3 new_location The new location for the edit vector.

XintView3DDisableEditVector

This function can be used to terminate editing of an object's point. It can be called only if function XintView3DEnableEditVector has been previously called. Function XintView3DDisableEditVector removes the vector used to guide editing and changes the cursor back to its original mode.

     void XintView3DDisableEditVector (...)

Widget widget ID of the View3D widget.

XintView3DVectorGetCount

This function returns the number of vertices contained in the specified object.

     int XintView3DVectorGetCount (...)

XintView3DObject * object ID of the object of interest.

XintView3DVectorGetValue

This function returns the value of an object vertex at the specified index.

     void XintView3DVectorGetValue (...)

XintView3DObject * object The object (must be a Surface, Line or Point object).
int index Index of the vertex (between 0 and nvertices-1).
XintVector3 value Contains the value of the vertex at the specified index when the function returns.

XintView3DEnableEditVector

This function enables the editing of objects. It draws a colored line showing the location of the vertex being edited and the direction where editing is permitted.

     void XintView3DEnableEditVector (...)

Widget widget View3D widget.
XintVector3 location Origin of the point to edit.
XintVector3 direction Direction where editing is constrained.
XintView3DEditVectorType type Set to XintEDIT_VECTOR_LINE.
XintView3DEditVectorLimits limits Set to XintLIMIT_NONE for no limits, or XintLIMIT_MODEL to limit to model boundary, or XintLIMIT_USER to limit to user coords specified as next two arguments.
XintVector3 top_user_limit Top user limit.
XintVector3 bot_user_limit Bottom user limit.

XintView3DUpdateModel

This function recalculates the limits of the model (maximum and minimum values in X, Y and Z across all objects). It should be called after an object has been edited only if argument limit_to_model (see function XintView3DEnableEditVector) was set to False.

     void XintView3DUpdateModel (...)

Widget widget ID of the View3D widget.

XintView3DUpdateObject

This function must be called after editing of an object's point or points is completed. It is required so that new normals and internal structures can be recalculated.

     void XintView3DUpdateObject (...)

XintView3DObject object ID of the View3D object of interest.

XintView3DVectorSetValue

This function is used to modify the vertex value of an object.

     void XintView3DVectorSetValue (...)

XintView3DObject * object Object to modify (must be a Surface, Line or Point object).
int index Index of the vertex (between 0 and nvertices-1).
XintVector3 value New vertex value.

Widget	widget	ID of the View3D widget.
XintVector3	new_direction	The new direction for the edit vector.

XintView3DObject *	object	The object (must be a Surface, Line or Point object).
int	index	Index of the vertex (between 0 and nvertices-1).
XintVector3	value	Contains the value of the vertex at the specified index when the function returns.

Widget	widget	View3D widget.
XintVector3	location	Origin of the point to edit.
XintVector3	direction	Direction where editing is constrained.
XintView3DEditVectorType	type	Set to XintEDIT_VECTOR_LINE.
XintView3DEditVectorLimits	limits	Set to XintLIMIT_NONE for no limits, or XintLIMIT_MODEL to limit to model boundary, or XintLIMIT_USER to limit to user coords specified as next two arguments.
XintVector3	top_user_limit	Top user limit.
XintVector3	bot_user_limit	Bottom user limit.

XintView3DObject *	object	Object to modify (must be a Surface, Line or Point object).
int	index	Index of the vertex (between 0 and nvertices-1).
XintVector3	value	New vertex value.