A3DAsmModelFileDelete

A3DStatus A3DAsmModelFileDelete(A3DAsmModelFile *pModelFile)

deprecated

A3DStatus A3DAsmModelFileDelete(A3DAsmModelFile* pModelFile)

Deletes the entire A3DAsmModelFile entity from memory.

This function frees all the all memory allocated for pModelFile. It recursively deletes all entities inside the model file, thus deleting the whole PRC tree. After the call, access to the model file is no longer possible, and pModelFile is invalid.

Warning

This function is deprecated. Please use A3DEntityDelete() instead to implement the same behaviour. This will be removed in version 2028.1.0.

Return Values

A3D_INVALID_ENTITY_NULL:

A3D_INVALID_ENTITY_TYPE:

A3D_SUCCESS:

This function is only applicable to a model file.

This function must not be applied within an HOOPS Visualize context. See

embed:rst:inline :doc:`/start/getting-started`

.

See A3DEntityDelete() for a more generic approach.

Returns

A3D_SUCCESS on success, or an error code on failure