To apply UV coordinates to a mesh in the Java/.NET APIs, use the hdrcVertexCallListContext.lockTextureCoords() method to obtain an array of float objects. Each pair of entries in the array corresponds to a single vertex in the hdrcVertexCallListContext vertex array. Each pair of float variables represent the U and V coordinates respectively in a UV coordinate pair. The value for the UV coordinates must be between 1 and 0. Once the texture coordinates have been set, use the hdrcVertexCallListContext.unlockTextureCoords() method to apply the coordinates to the hdrcVertexCallListContext object. The hdrcVertexCallListContext.lock/unlockTextureCoordsModified() methods takes as input parameters the range of values in the array that have been changed. The range of values is inclusive of the starting value and exclusive of the ending value. For example, if the array to be modified has 10 elements and all have been modified, the starting value is 0 and the ending value is 10. Only elements 0 through 9 are valid.

// Get the number of vertices in this object

int vertexCount; 

vertexCount = vertexCallList.getNumVertices();

// Set UV coordinate values.

float[] uvCoords = vertexCallList.lockTextureCoords(0, vertexCount);

for(int i = 0; i < numVerts; i++) {

    uvCoords[i].x = 0;

    uvCoords[i].y = 1;

}

pVertexCallList.unlockTextureCoords(true, 0, numVerts);

Once the UV coordinates for an hdrcVertexCallListContext object have been configured, a texture bitmap must be applied. The first step in applying a bitmap image is to create an hdrcTextureMapContext object. This is done with the hdrcServerContext,createTextureMap() method. After the hdrcTextureMapContext object is created, the image file is loaded with the hdrcTextureMapContext.loadTextureMap() method. This method takes the file name of an image file to be loaded. This function supports a wide range of image formats. After the image has been loaded, it is applied to the hdrcVertexCallListContext object with the hdrcVertexCallListContext.setTextureMap() method. Each hdrcVertexCallListContext object can have only one texture source applied at a time. Use null as the source texture to clear the texture map.

// Create an hdrcTextureMapContext object.

hdrcTextureMapContext textureMap = serverContext.createTextureMap();

// Load an image file into the hdrcTextureMapContext object.

textureMap.loadTextureMap("C:/data/image.jpg");

// Apply the texture to a hdcrVertexCallListContext object.

// The hdrcVertexCallListContext object must have UV coordinates assigned.

vertexCallList.setTextureMap(textureMap);

An hdrcRenderEngineContext object (in addition to rendering image files) can render an image that is used to generate a texture image source. When used as the texture source, the hdrcRenderEngineContext can have a completely different transfer function, and other render parameter settings, than the engine that renders the image displayed on the user's screen.

The only restriction is that the texture source engine and the on-screen engine must be of the same type. For example, if the application is using a render engine of the type RT_PARALLEL to render on-screen images, then only render engines of type RT_PARALLEL may be used as texture mapping sources with that engine. All adaptive render engine types may be used as texture sources: see the chapter on Rendering Modes for more information. Prior to using an engine as a texture source, the RENDER_PARAMS structure for the engine must be initialized and an initial image rendered, or the engine's image buffer will have nothing to use as a texture image.

hdrcRenderQueue objects cannot be used as a texture source.

The ITextureMapContext object is created and applied as discussed in the section on File Based Texture Mapping.

// Create a hdrcRenderEngineContext object.

hdrcRenderEngineContext pRenderEngine = serverContext.createRenderEngine(hdrcDefines.RENDER_ENGINE_ID_PAR);

// Configure the IRenderEngineContext object.

RENDER_PARAMS rp = new RENDER_PARAMS();

serverContext.loadPreset("C:/data/preset.xml", rp);

renderEngine.setRenderParams(rp);

// Render an initial image

renderEngine.render(imgReq, imgRes);

// Create an hdrcTextureMapContext object.

hdrcTextureMapContext textureMap = serverContext.createTextureMap();

// Set the hdrcRenderEngineContext object as the texture source.

vertexCallList.setTextureMapEngine(renderEngine);

// When necessary, the texture source engine should be updated as follows.

// This approach will result in much better performance than a synchronous render.

RENDER_PARAMS newRP = new RENDER_PARAMS();

userCode.ConfigureNewRenderParams(newRP);

renderEngine.setRenderToTextureParams(newRP)

Texture mapped object lighting can be controlled with the hdrcVertexCallListContext::setTextureLighting() method. This method takes a single boolean parameter. Set this value to true if lighting is desired, set to false if no lighting is desired.

// Turn lighting on for texture mapped object.

pVertexCallList->SetTextureLighting(true);

the Java/.NET API supports the loading of textured OBJ files using the hdrcPolygonUtilContext,loadOBJ() method. The OBJ file format supports mesh data that includes UV coordinates. Using this mechanism, the application can load texture mapped OBJ files from any third party modeling application. The hdrcVertexCallListContext object that is created from the OBJ file includes the UV coordinates present in the OBJ file. The texture map for the OBJ file must be applied separately with the hdrcVertexCallListContext.setTextureMap() method. Only a single texture map may be applied to a hdrcVertexCallListContext object at a time. See Mesh File Import for more information on loading OBJ files.