com.jme3.scene.plugins.blender.textures

Class TextureHelper

java.lang.Object

com.jme3.scene.plugins.blender.AbstractBlenderHelper

com.jme3.scene.plugins.blender.textures.TextureHelper

public class TextureHelper
extends AbstractBlenderHelper

A class that is used in texture calculations.

Field Summary

Fields

Modifier and Type	Field and Description
static int	TEX_BLEND
static int	TEX_CLOUDS
static int	TEX_DISTNOISE
static int	TEX_ENVMAP
static int	TEX_IMAGE
static int	TEX_MAGIC
static int	TEX_MARBLE
static int	TEX_MUSGRAVE
static int	TEX_NOISE
static int	TEX_NONE
static int	TEX_OCEAN
static int	TEX_PLUGIN
static int	TEX_POINTDENSITY
static int	TEX_STUCCI
static int	TEX_VORONOI
static int	TEX_VOXELDATA
static int	TEX_WOOD
static VertexBuffer.Type[]	TEXCOORD_TYPES

Fields inherited from class com.jme3.scene.plugins.blender.AbstractBlenderHelper

blenderContext, blenderVersion, fixUpAxis, upAxisRotationQuaternion

Constructor Summary

Constructors

Constructor and Description
TextureHelper(java.lang.String blenderVersion, BlenderContext blenderContext) This constructor parses the given blender version and stores the result.

Method Summary

Modifier and Type	Method and Description
java.awt.geom.AffineTransform	createAffineTransform(Vector2f[] source, Vector2f[] dest, int[] sourceSize, int[] targetSize) This method creates the affine transform that is used to transform a triangle defined by one UV coordinates into a triangle defined by different UV's.
int	getPixelPosition(float pos, int size) This method returns the proper pixel position on the image.
Image	getSubimage(Image image, int minX, int minY, int maxX, int maxY) This method returns subimage of the give image.
Texture	getTexture(Structure textureStructure, Structure mTex, BlenderContext blenderContext) This class returns a texture read from the file or from packed blender data.
Texture	loadImageAsTexture(Structure imageStructure, int imaflag, BlenderContext blenderContext) This class returns a texture read from the file or from packed blender data.
protected Texture	loadImageFromFile(java.lang.String name, int imaflag, BlenderContext blenderContext) This method loads the texture from outside the blend file using the AssetManager that the blend file was loaded with.
java.util.List<CombinedTexture>	readTextureData(Structure structure, float[] diffuseColorArray, boolean skyTexture) Reads the texture data from the given material or sky structure.

Methods inherited from class com.jme3.scene.plugins.blender.AbstractBlenderHelper

applyProperties, loadLibrary, loadProperties

Methods inherited from class java.lang.Object

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

Field Detail

TEX_NONE

public static final int TEX_NONE

See Also:

Constant Field Values

TEX_CLOUDS

public static final int TEX_CLOUDS

See Also:

Constant Field Values

TEX_WOOD

public static final int TEX_WOOD

See Also:

Constant Field Values

TEX_MARBLE

public static final int TEX_MARBLE

See Also:

Constant Field Values

TEX_MAGIC

public static final int TEX_MAGIC

See Also:

Constant Field Values

TEX_BLEND

public static final int TEX_BLEND

See Also:

Constant Field Values

TEX_STUCCI

public static final int TEX_STUCCI

See Also:

Constant Field Values

TEX_NOISE

public static final int TEX_NOISE

See Also:

Constant Field Values

TEX_IMAGE

public static final int TEX_IMAGE

See Also:

Constant Field Values

TEX_PLUGIN

public static final int TEX_PLUGIN

See Also:

Constant Field Values

TEX_ENVMAP

public static final int TEX_ENVMAP

See Also:

Constant Field Values

TEX_MUSGRAVE

public static final int TEX_MUSGRAVE

See Also:

Constant Field Values

TEX_VORONOI

public static final int TEX_VORONOI

See Also:

Constant Field Values

TEX_DISTNOISE

public static final int TEX_DISTNOISE

See Also:

Constant Field Values

TEX_POINTDENSITY

public static final int TEX_POINTDENSITY

See Also:

Constant Field Values

TEX_VOXELDATA

public static final int TEX_VOXELDATA

See Also:

Constant Field Values

TEX_OCEAN

public static final int TEX_OCEAN

See Also:

Constant Field Values

TEXCOORD_TYPES

public static final VertexBuffer.Type[] TEXCOORD_TYPES

Constructor Detail

TextureHelper

public TextureHelper(java.lang.String blenderVersion,
                     BlenderContext blenderContext)

This constructor parses the given blender version and stores the result. It creates noise generator and texture generators.

Parameters:

blenderVersion - the version read from the blend file

blenderContext - the blender context

Method Detail

getTexture

public Texture getTexture(Structure textureStructure,
                          Structure mTex,
                          BlenderContext blenderContext)
                   throws BlenderFileException

This class returns a texture read from the file or from packed blender data. The returned texture has the name set to the value of its blender type.

Parameters:

textureStructure - texture structure filled with data

blenderContext - the blender context

Returns:

the texture that can be used by JME engine

Throws:

BlenderFileException - this exception is thrown when the blend file structure is somehow invalid or corrupted

loadImageAsTexture

public Texture loadImageAsTexture(Structure imageStructure,
                                  int imaflag,
                                  BlenderContext blenderContext)
                           throws BlenderFileException

This class returns a texture read from the file or from packed blender data.

Parameters:

imageStructure - image structure filled with data

imaflag - the image flag

blenderContext - the blender context

Returns:

the texture that can be used by JME engine

Throws:

BlenderFileException - this exception is thrown when the blend file structure is somehow invalid or corrupted

createAffineTransform

public java.awt.geom.AffineTransform createAffineTransform(Vector2f[] source,
                                                           Vector2f[] dest,
                                                           int[] sourceSize,
                                                           int[] targetSize)

This method creates the affine transform that is used to transform a triangle defined by one UV coordinates into a triangle defined by different UV's.

Parameters:

source - source UV coordinates

dest - target UV coordinates

sourceSize - the width and height of the source image

targetSize - the width and height of the target image

Returns:

affine transform to transform one triangle to another

getPixelPosition

public int getPixelPosition(float pos,
                            int size)

This method returns the proper pixel position on the image.

Parameters:

pos - the relative position (value of range [0, 1] (both inclusive))

size - the size of the line the pixel lies on (width, height or depth)

Returns:

the integer index of the pixel on the line of the specified width

getSubimage

public Image getSubimage(Image image,
                         int minX,
                         int minY,
                         int maxX,
                         int maxY)

This method returns subimage of the give image. The subimage is constrained by the rectangle coordinates. The source image is unchanged.

Parameters:

image - the image to be subimaged

minX - minimum X position

minY - minimum Y position

maxX - maximum X position

maxY - maximum Y position

Returns:

a part of the given image

loadImageFromFile

protected Texture loadImageFromFile(java.lang.String name,
                                    int imaflag,
                                    BlenderContext blenderContext)

This method loads the texture from outside the blend file using the AssetManager that the blend file was loaded with. It returns a texture with a full assetKey that references the original texture so it later doesn't need to be packed when the model data is serialized. It searches the AssetManager for the full path if the model file is a relative path and will attempt to truncate the path if it is an absolute file path until the path can be found in the AssetManager. If the texture can not be found, it will issue a load attempt for the initial path anyway so the failed load can be reported by the AssetManagers callback methods for failed assets.

Parameters:

name - the path to the image

imaflag - the image flag

blenderContext - the blender context

Returns:

the loaded image or null if the image cannot be found

readTextureData

public java.util.List<CombinedTexture> readTextureData(Structure structure,
                                                       float[] diffuseColorArray,
                                                       boolean skyTexture)
                                                throws BlenderFileException

Reads the texture data from the given material or sky structure.

Parameters:

structure - the structure of material or sky

diffuseColorArray - array of diffuse colors

skyTexture - indicates it we're going to read sky texture or not

Returns:

a list of combined textures

Throws:

BlenderFileException - an exception is thrown when problems with reading the blend file occur