If triangulating a non-triangular polygon, LiPrimitiveTriangulate will create each triangle with a call to LiPolygonCreate. The triangulation code will take care of the triangle's LI_PROP_POLY_VREFS property, but all other properties are initialised by calling this callback function.

Any triangles which are presented as input to LiPrimitiveTriangulate will also be `initialised' with a call to the LI_MESH_CALLBACK_TRI_PROPERTIES callback function.

If users find that the default callback, LiMeshingTriProperties, is not handling things to their satisfaction, then they can write their own callback (perhaps utilising LiMeshingTriProperties).

For example, if the caller wishes to associate data structures of their own, with each triangle, then they can write their own LtFuncMeshingTriProperties callback, and the resulting triangulation will consist of triangles that each have user-generated data structures associated with them.

/*
 * writing my own LtFuncMeshingTriProperties
 */
LtStatus
my_tri_props_func (
      LtPrim   prim, 
      LtPoly   poly
)
{
   LtStatus   result;

   /* 1: sort the basics */
   result = LiMeshingTriProperties(...);

   /* 2: sort my specifics */
   ...

   return ( result );
}