Lines Matching refs:Texture
44 import com.jme3.texture.Image;
45 import com.jme3.texture.Image.Format;
46 import com.jme3.texture.Texture;
47 import com.jme3.texture.Texture2D;
61 * <b><code>TextureAtlas</code></b> allows combining multiple textures to one texture atlas.
66 * a Texture to be used further in materials.</p>
69 * textures (other map names) have to reference a texture of the master map to position the texture
70 * on the secondary map. This is necessary as the maps share texture coordinates and thus need to be
76 * <p>The textures are referenced by their <b>asset key name</b> and for each texture the location
77 * inside the atlas is stored. A texture with an existing key name is never added more than once
78 * to the atlas. You can access the information for each texture or geometry texture via helper methods.</p>
80 * <p>The TextureAtlas also allows you to change the texture coordinates of a mesh or geometry
81 * to point at the new locations of its texture inside the atlas (if the texture exists inside the atlas).</p>
83 * <p>Note that models that use texture coordinates outside the 0-1 range (repeating/wrapping textures)
85 * other textures instead of repeating the texture.</p>
88 * All methods that allow adding textures return false if the texture could not be added due to the
90 * as the main (e.g. DiffuseMap) texture.</p>
99 * Create a texture atlas and change the texture coordinates of one geometry:
108 * //create material and set texture
111 * //change one geometry to use atlas, apply texture coordinates and replace material.
144 Texture diffuse = getMaterialTexture(geometry, "DiffuseMap");
145 Texture normal = getMaterialTexture(geometry, "NormalMap");
146 Texture specular = getMaterialTexture(geometry, "SpecularMap");
169 * Add a texture for a specific map name
170 * @param texture A texture to add to the atlas.
171 * @param mapName A freely chosen map name that can be later retrieved as a Texture. The first map name supplied will be the master map.
174 public boolean addTexture(Texture texture, String mapName) {
175 if (texture == null) {
176 throw new IllegalStateException("Texture cannot be null!");
178 String name = textureName(texture);
179 if (texture.getImage() != null && name != null) {
180 return addImage(texture.getImage(), name, mapName, null);
182 throw new IllegalStateException("Texture has no asset key name!");
187 * Add a texture for a specific map name at the location of another existing texture on the master map.
188 * @param texture A texture to add to the atlas.
189 * @param mapName A freely chosen map name that can be later retrieved as a Texture.
190 * @param masterTexture The master texture for determining the location, it has to exist in tha master map.
192 public void addTexture(Texture texture, String mapName, Texture masterTexture) {
195 throw new IllegalStateException("Supplied master map texture has no asset key name!");
197 addTexture(texture, mapName, sourceTextureName);
202 * Add a texture for a specific map name at the location of another existing texture (on the master map).
203 * @param texture A texture to add to the atlas.
204 * @param mapName A freely chosen map name that can be later retrieved as a Texture.
207 public void addTexture(Texture texture, String mapName, String sourceTextureName) {
208 if (texture == null) {
209 throw new IllegalStateException("Texture cannot be null!");
211 String name = textureName(texture);
212 if (texture.getImage() != null && name != null) {
213 addImage(texture.getImage(), name, mapName, sourceTextureName);
215 throw new IllegalStateException("Texture has no asset key name!");
219 private String textureName(Texture texture) {
220 if (texture == null) {
223 AssetKey key = texture.getKey();
237 + " Textures for new maps have to use a texture from the master map for their location.");
241 //have location for texture
243 logger.log(Level.WARNING, "Same texture " + name + " is used in different maps! (" + mapName + " and " + mapNameMap.get(name) + "). Location will be based on location in " + mapNameMap.get(name) + "!");
260 throw new IllegalStateException("Cannot find master map texture for " + name + ".");
369 * Get the <code>TextureAtlasTile</code> for the given Texture
370 * @param texture The texture to retrieve the <code>TextureAtlasTile</code> for.
373 public TextureAtlasTile getAtlasTile(Texture texture) {
374 String sourceTextureName = textureName(texture);
382 * Get the <code>TextureAtlasTile</code> for the given Texture
383 * @param assetName The texture to retrieve the <code>TextureAtlasTile</code> for.
391 * Creates a new atlas texture for the given map name.
395 public Texture getAtlasTexture(String mapName) {
402 tex.setMagFilter(Texture.MagFilter.Bilinear);
403 tex.setMinFilter(Texture.MinFilter.BilinearNearestMipMap);
404 tex.setWrap(Texture.WrapMode.Clamp);
411 * Applies the texture coordinates to the given geometry
413 * @param geom The geometry to change the texture coordinate buffer on.
414 * @return true if texture has been found and coords have been changed, false otherwise.
421 * Applies the texture coordinates to the given output mesh
423 * @param geom The geometry to change the texture coordinate buffer on.
426 * @return true if texture has been found and coords have been changed, false otherwise.
436 throw new IllegalStateException("Geometry mesh has no texture coordinate buffer.");
439 Texture tex = getMaterialTexture(geom, "DiffuseMap");
455 throw new IllegalStateException("Geometry has no proper texture.");
460 * Create a texture atlas for the given root node, containing DiffuseMap, NormalMap and SpecularMap.
471 logger.log(Level.WARNING, "Texture atlas size too small, cannot add all textures");
480 * textures into one texture of the given size.
483 * @param atlasSize A size for the atlas texture, it has to be large enough to hold all single textures.
484 * @return A new geometry that uses the generated texture atlas and merges all meshes of the root spatial, null if the atlas cannot be created because not all textures fit.
503 Texture diffuseMap = atlas.getAtlasTexture("DiffuseMap");
504 Texture normalMap = atlas.getAtlasTexture("NormalMap");
505 Texture specularMap = atlas.getAtlasTexture("SpecularMap");
543 private static Texture getMaterialTexture(Geometry geometry, String mapName) {
549 Texture texture = param.getTextureValue();
550 if (texture == null) {
553 return texture;
631 * Get the transformed texture coordinate for a given input location.
632 * @param previousLocation The old texture coordinate.
633 * @return The new texture coordinate inside the atlas.
648 * Transforms a whole texture coordinates buffer.
649 * @param inBuf The input texture buffer.
664 //TODO: add proper texture wrapping for atlases..
