# fz_objt_fact_allocate

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,
fz_objt_ptr | 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

tool_star.fsl

See Also

,

Function Set

fz_model_fset

Defined in

fz_objt_api.h