\begin{figure}[hb] \vspace* \special{psfile=api/figures/edgesplit.ps hoffset=80} Application of LtFuncMeshingEdgeSplit callback \end{figure}

This function is called from LiPrimitiveTriangulate, when edge splitting, before triangulation, in response to a LI_MESH_CRIT_MAX_EDGE_VERTS criterion begin set to ` TRUE'. It is also called during further triangulation, when the primitive's longest polygon edge is repeatedly split in order to create more triangles than a straighforward triangulation of the input polygons, has produced.

The edge which is split is denoted by the LtVref pair \newline next> of the polygon poly1, and \newline next> of the polygon poly2, if it exists.

If users find that the default callback, LiMeshingEdgeSplit, is not handling some aspect of edge splitting (possibly relating to user-specified properties) then they can write their own callback (perhaps utilising LiMeshingEdgeSplit).

/*
 * writing my own LtFuncMeshingEdgeSplit
 */
LtVert
my_edge_split_func (
      LtPrim   prim, 
      LtPoly   pol1, 
      LtVref   v1, 
      LtPoly   pol2, 
      LtVref   v2, 
      LtDouble alpha
)
{
   LtVert   result;

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

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

   return ( result );
}