com.visioglobe.libVisioDevKit

Class VgITextureManager

java.lang.Object

com.visioglobe.libVisioDevKit.VgITextureManager

public class VgITextureManager
extends java.lang.Object

The VgITextureManager class is used to create VgITexture given a VgBinaryBuffer. The VgITextureManager class is in charge of passing the VgBinaryBuffer data to the graphics engine and creates internal objects that allows usage of the returned texture. The below code snippet demonstrates how a VgITexture can be created. n* mVgApplication; r* lTextureManager = lEngine->editTextureManager(); (*lBuffer);

Interface:

VgEngine::VgITextureManager

Date:

25/02/2010

Method Summary

Methods

Modifier and Type	Method and Description
VgITextureRefPtr	createTexture(VgBinaryBufferConstRefPtr pBuffer)
VgITextureRefPtr	createTexture(VgBinaryBufferConstRefPtr pBuffer, boolean pGenerateMipmaps) Creates a Texture from a VgBinaryBuffer.
void	delete()
VgITextureRefPtr	getTexture(java.lang.String pTextureName) Returns a named texture from the registered textures.
static VgBinaryBufferRefPtr	prepareTextureBuffer(long pWidth, long pHeight, VgPixelFormat pPixelFormat, SWIGTYPE_p_p_unsigned_char pOutData)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

delete

public void delete()

createTexture

public VgITextureRefPtr createTexture(VgBinaryBufferConstRefPtr pBuffer,
                             boolean pGenerateMipmaps)

Creates a Texture from a VgBinaryBuffer.

Parameters:

pBuffer - The buffer from where the texture will be loaded.

pGenerateMipmaps - Indicates whether mipmaps should be auto-generated.

Remark:

Once the VgBinaryBuffer is used to create a VgITexture, it should not be modified afterwards. The graphic's context should be active when this call is made., Under iOS, if the VgBinaryBuffer contains a png file. It must not be compressed (Uncheck "Compress PNG Files" under XCode), and the internal png reader does not handle Apple proprietary png extensions.

Paragraph:

Textures should be square and the width and height should be a power of two to avoid having problems on certain devices.

createTexture

public VgITextureRefPtr createTexture(VgBinaryBufferConstRefPtr pBuffer)

prepareTextureBuffer

public static VgBinaryBufferRefPtr prepareTextureBuffer(long pWidth,
                                        long pHeight,
                                        VgPixelFormat pPixelFormat,
                                        SWIGTYPE_p_p_unsigned_char pOutData)

getTexture

public VgITextureRefPtr getTexture(java.lang.String pTextureName)

Returns a named texture from the registered textures. This method is mainly used to get back textures from the ones declared in vg_config.xml in the \ section.

Parameters:

pTextureName - The name of the texture. In vg_config this is the 'id' attribute of the 'texture' tag.

Returns:

A referenced pointer on the texture if any, null if none. Check the isValid method before use.