Description
Allocates the face, curve, segment and point storage of an object
to be at least as large as indicated by the counters passed in.
When constructing an object face by face and it is known how many
faces will be created, it will be much faster to pre allocate the
storage upfront. If this function is not called,
and will allocated storage for faces, curves
and segments as needed. However, memory fragmentation will occur
and each check whether more storage is needed and possible allocation
of more memory when needs is slower than allocating the memory in one shot
upfront.
Plugin Prototype
fzrt_error_td fz_objt_fact_allocate(
fzrt_int | windex, |
obj, | |
fzrt_int | nface, |
fzrt_int | ncurv, |
fzrt_int | nsegt, |
fzrt_int | ncord ) |
Parameters
windex [Input]
project window index
obj [Input]
object
nface [Input]
number of faces to allocate
Range: nface >= 1
ncurv [Input]
number of curves to allocate
Range: ncurv >= 1
nsegt [Input]
number of segments to allocate
Range: nsegt >= 1
ncord [Input]
number of coordinates(points) to allocate
Range: ncord >= 1
Returns
Error codes
Availability
5.0.0.0
Example Files
See Also
,
Function Set
Defined in