AcGiFaceData::setNormals

C++

virtual ACDBCORE2D_PORT void setNormals(
    const AcGeVector3d* pNormals
);

Description

Sets pNormals to be the array of face normal vectors used by the AcGiFaceData object. The array must have exactly the same number of elements as there are faces in the mesh or shell it is used with. The array elements specify the normal vectors of the mesh or shell faces--the first array element specifies the normal vector for the first face, the second element for the second face, etc.

The caller of this function is responsible for allocating and de-allocating the memory for the array. This function accepts a pointer to the array and then uses the array directly--it does not make a copy of the array.

AcGi only uses this array for the duration of the current worldDraw() or viewportDraw() function call, so the memory for this array should be deallocated just before returning from the worldDraw() or viewportDraw() function. It is safe to allocate the array memory on the stack (that is, a local array).

Prematurely freeing or deleting the array passed into this function terminates AutoCAD.

Parameters

Links

AcGiFaceData