* * Since triangle fans and triangle strips do not support edge flags, the * begin callback is not called with GL_TRIANGLE_FAN or * GL_TRIANGLE_STRIP if a non-null edge flag callback is provided. * (If the callback is initialized to null, there is no impact on * performance). Instead, the fans and strips are converted to independent * triangles. * * @param boundaryEdge * Specifics which edges lie on the polygon boundary. * * @see net.java.games.jogl.GLU#gluTessCallback gluTessCallback * @see net.java.games.jogl.GLUtesselatorCallback#edgeFlagData edgeFlagData */ public void edgeFlag(boolean boundaryEdge); /** * The same as the {@link net.java.games.jogl.GLUtesselatorCallback#edgeFlag * edgeFlage} callback method except that it takes an additional reference * argument. This reference is identical to the opaque reference provided when * {@link net.java.games.jogl.GLU#gluTessBeginPolygon gluTessBeginPolygon} was * called. * * @param boundaryEdge * Specifics which edges lie on the polygon boundary. * @param polygonData * Specifics a reference to user-defined data. * * @see net.java.games.jogl.GLU#gluTessCallback gluTessCallback * @see net.java.games.jogl.GLUtesselatorCallback#edgeFlag edgeFlag */ public void edgeFlagData(boolean boundaryEdge, Object polygonData); /** * The vertex callback method is invoked between the * {@link net.java.games.jogl.GLUtesselatorCallback#begin begin} and * {@link net.java.games.jogl.GLUtesselatorCallback#end end} callback methods. * It is similar to {@link net.java.games.jogl.GL#glVertex3f glVertex3f}, and it * defines the vertices of the triangles created by the tessellation process. * The method takes a reference as its only argument. This reference is * identical to the opaque reference provided by the user when the vertex was * described (see {@link net.java.games.jogl.GLU#gluTessVertex * gluTessVertex}). * * @param vertexData * Specifics a reference to the vertices of the triangles created * byt the tessellatin process. * * @see net.java.games.jogl.GLU#gluTessCallback gluTessCallback * @see net.java.games.jogl.GLUtesselatorCallback#vertexData vertexData */ public void vertex(Object vertexData); /** * The same as the {@link net.java.games.jogl.GLUtesselatorCallback#vertex * vertex} callback method except that it takes an additional reference * argument. This reference is identical to the opaque reference provided when * {@link net.java.games.jogl.GLU#gluTessBeginPolygon gluTessBeginPolygon} was * called. * * @param vertexData * Specifics a reference to the vertices of the triangles created * byt the tessellatin process. * @param polygonData * Specifics a reference to user-defined data. * * @see net.java.games.jogl.GLU#gluTessCallback gluTessCallback * @see net.java.games.jogl.GLUtesselatorCallback#vertex vertex */ public void vertexData(Object vertexData, Object polygonData); /** * The end callback serves the same purpose as * {@link net.java.games.jogl.GL#glEnd glEnd}. It indicates the end of a * primitive and it takes no arguments. * * @see net.java.games.jogl.GLU#gluTessCallback gluTessCallback * @see net.java.games.jogl.GLUtesselatorCallback#begin begin * @see net.java.games.jogl.GLUtesselatorCallback#endData endData */ public void end(); /** * The same as the {@link net.java.games.jogl.GLUtesselatorCallback#end end} * callback method except that it takes an additional reference argument. This * reference is identical to the opaque reference provided when * {@link net.java.games.jogl.GLU#gluTessBeginPolygon gluTessBeginPolygon} was * called. * * @param polygonData * Specifics a reference to user-defined data. * * @see net.java.games.jogl.GLU#gluTessCallback gluTessCallback * @see net.java.games.jogl.GLUtesselatorCallback#beginData beginData * @see net.java.games.jogl.GLUtesselatorCallback#end end */ public void endData(Object polygonData); /** * The combine callback method is called to create a new vertex when * the tessellation detects an intersection, or wishes to merge features. The * method takes four arguments: an array of three elements each of type * double, an array of four references, an array of four elements each of * type float, and a reference to a reference.
* * The vertex is defined as a linear combination of up to four existing * vertices, stored in data. The coefficients of the linear combination * are given by weight; these weights always add up to 1. All vertex * pointers are valid even when some of the weights are 0. coords gives * the location of the new vertex.
* * The user must allocate another vertex, interpolate parameters using * data and weight, and return the new vertex pointer in * outData. This handle is supplied during rendering callbacks. The * user is responsible for freeing the memory some time after * {@link net.java.games.jogl.GLU#gluTessEndPolygon gluTessEndPolygon} is * called.
* * For example, if the polygon lies in an arbitrary plane in 3-space, and a * color is associated with each vertex, the GLU_TESS_COMBINE * callback might look like this: * *
* void myCombine(double[] coords, Object[] data,
* float[] weight, Object[] outData)
* {
* MyVertex newVertex = new MyVertex();
*
* newVertex.x = coords[0];
* newVertex.y = coords[1];
* newVertex.z = coords[2];
* newVertex.r = weight[0]*data[0].r +
* weight[1]*data[1].r +
* weight[2]*data[2].r +
* weight[3]*data[3].r;
* newVertex.g = weight[0]*data[0].g +
* weight[1]*data[1].g +
* weight[2]*data[2].g +
* weight[3]*data[3].g;
* newVertex.b = weight[0]*data[0].b +
* weight[1]*data[1].b +
* weight[2]*data[2].b +
* weight[3]*data[3].b;
* newVertex.a = weight[0]*data[0].a +
* weight[1]*data[1].a +
* weight[2]*data[2].a +
* weight[3]*data[3].a;
* outData = newVertex;
* }
*
* @param coords
* Specifics the location of the new vertex.
* @param data
* Specifics the vertices used to create the new vertex.
* @param weight
* Specifics the weights used to create the new vertex.
* @param outData
* Reference user the put the coodinates of the new vertex.
*
* @see net.java.games.jogl.GLU#gluTessCallback gluTessCallback
* @see net.java.games.jogl.GLUtesselatorCallback#combineData combineData
*/
public void combine(double[] coords, Object[] data,
float[] weight, Object[] outData);
/**
* The same as the {@link net.java.games.jogl.GLUtesselatorCallback#combine
* combine} callback method except that it takes an additional reference
* argument. This reference is identical to the opaque reference provided when
* {@link net.java.games.jogl.GLU#gluTessBeginPolygon gluTessBeginPolygon} was
* called.
*
* @param coords
* Specifics the location of the new vertex.
* @param data
* Specifics the vertices used to create the new vertex.
* @param weight
* Specifics the weights used to create the new vertex.
* @param outData
* Reference user the put the coodinates of the new vertex.
* @param polygonData
* Specifics a reference to user-defined data.
*
* @see net.java.games.jogl.GLU#gluTessCallback gluTessCallback
* @see net.java.games.jogl.GLUtesselatorCallback#combine combine
*/
public void combineData(double[] coords, Object[] data,
float[] weight, Object[] outData,
Object polygonData);
/**
* The error callback method is called when an error is encountered.
* The one argument is of type int; it indicates the specific error that
* occurred and will be set to one of GLU_TESS_MISSING_BEGIN_POLYGON,
* GLU_TESS_MISSING_END_POLYGON, GLU_TESS_MISSING_BEGIN_CONTOUR,
* GLU_TESS_MISSING_END_CONTOUR, GLU_TESS_COORD_TOO_LARGE,
* GLU_TESS_NEED_COMBINE_CALLBACK or GLU_OUT_OF_MEMORY.
* Character strings describing these errors can be retrieved with the
* {@link net.java.games.jogl.GLU#gluErrorString gluErrorString} call.* * The GLU library will recover from the first four errors by inserting the * missing call(s). GLU_TESS_COORD_TOO_LARGE indicates that some * vertex coordinate exceeded the predefined constant * GLU_TESS_MAX_COORD in absolute value, and that the value has been * clamped. (Coordinate values must be small enough so that two can be * multiplied together without overflow.) * GLU_TESS_NEED_COMBINE_CALLBACK indicates that the tessellation * detected an intersection between two edges in the input data, and the * GLU_TESS_COMBINE or GLU_TESS_COMBINE_DATA callback was not * provided. No output is generated. GLU_OUT_OF_MEMORY indicates that * there is not enough memory so no output is generated. * * @param errnum * Specifics the error number code. * * @see net.java.games.jogl.GLU#gluTessCallback gluTessCallback * @see net.java.games.jogl.GLUtesselatorCallback#errorData errorData */ public void error(int errnum); /** * The same as the {@link net.java.games.jogl.GLUtesselatorCallback#error * error} callback method except that it takes an additional reference * argument. This reference is identical to the opaque reference provided when * {@link net.java.games.jogl.GLU#gluTessBeginPolygon gluTessBeginPolygon} was * called. * * @param errnum * Specifics the error number code. * @param polygonData * Specifics a reference to user-defined data. * * @see net.java.games.jogl.GLU#gluTessCallback gluTessCallback * @see net.java.games.jogl.GLUtesselatorCallback#error error */ public void errorData(int errnum, Object polygonData); //void mesh(net.java.games.jogl.impl.tesselator.GLUmesh mesh); }