C++
Acad::ErrorStatus acreEntityToFaces( ads_name ss, ACHAR** const name, int normal );
File
scene.h
Description
This function provides a faceted approximation of the entities in the selection set passed in by ss.
The caller receives the faceted data through an AcReCallout object (registered with a previous call to acreRegisterCallout()). Optionally, this function creates a temporary file with the facet information. In this case, the name of the temporary file is returned in *name.
If no AcReCallout object was registered with a previous call to acreRegisterCallout(), this function will generate only the temporary file with the facet information.
If normal is nonzero, the facet's normal vectors are also generated. If normal is zero, no normal vector information will be provided.
The optional temporary file is generated if the RENDER_CACHE flag of the flags data member of the registered AcReCallout object is set. See the AcReCallout class documentation for more information.
Returns Acad::eOk if successful.
Returns Acad::eInvalidInput if any of the arguments are not acceptable.
Returns Acad::eNotApplicable if called while AutoCAD is in drag mode (that is, something is being dragged in the AutoCAD graphics window).
It is the caller's responsibility to free the string to which *name points.
If *name is not an empty string (""), it is also the caller's responsibility to erase the temporary file that *name specifies.
Parameters
| Parameters | Description |
|---|---|
| ss | Input selection set of the entities whose faceted information you want to retrieve |
| name | Input address of a pointer to char*; output with the char* pointing to a string containing the name of the file to which the information was saved |
| normal | Input indicating if the you want to get the facet's normal vectors in addition to the facet information |