AcGiFaceData::setLayers

C++

virtual ACDBCORE2D_PORT void setLayers(
    const AcDbObjectId * layers
);

Description

Sets layers to be the array of layerTableRecord object IDs 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 control the layers the mesh or shell faces reside on--the first array element specifies the layer used 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