Android Open Source - min3d Texture Manager

• Back to OpenGL/library  ↑

From Project

Back to project page min3d.

License

The source code is released under:

MIT License

Java Source Code

package com.min3d.lib.core;
/*from w  w w.j a v  a2s.  co m*/
import android.graphics.Bitmap;
import android.util.Log;

import com.min3d.lib.Min3d;
import com.min3d.lib.Shared;

import java.util.HashMap;
import java.util.Set;

/**
 * TextureManager is responsible for managing textures for the whole environment. 
 * It maintains a list of id's that are mapped to the GL texture names (id's).
 * 
 * You add a Bitmap to the TextureManager, which adds a textureId to its list.
 * Then, you assign one or more TextureVo's to your Object3d's using id's that 
 * exist in the TextureManager.
 * 
 * Note that the _idToTextureName and _idToHasMipMap HashMaps used below
 * don't test for exceptions. 
 */
public class TextureManager 
{
  private HashMap<String, Integer> _idToTextureName;
  private HashMap<String, Boolean> _idToHasMipMap;
  private static int _counter = 1000001;
  private static int _atlasId = 0;
  
  
  public TextureManager()
  {
    reset();
  }

  public void reset()
  {
    // Delete any extant textures

    if (_idToTextureName != null) 
    {
      Set<String> s = _idToTextureName.keySet();
      Object[] a = s.toArray(); 
      for (int i = 0; i < a.length; i++) {
        int glId = getGlTextureId((String)a[i]);
        Shared.renderer().deleteTexture(glId);
      }
      // ...pain
    }
    
    _idToTextureName = new HashMap<String, Integer>();
    _idToHasMipMap = new HashMap<String, Boolean>();
  }

  /**
   * 'Uploads' a texture via OpenGL which is mapped to a textureId to the TextureManager, 
   * which can subsequently be used to assign textures to Object3d's. 
   * 
   * @return The textureId as added to TextureManager, which is identical to $id 
   */
  public String addTextureId(Bitmap $b, String $id, boolean $generateMipMap)
  {
    if (_idToTextureName.containsKey($id)) throw new Error("Texture id \"" + $id + "\" already exists."); 

    int glId = Shared.renderer().uploadTextureAndReturnId($b, $generateMipMap);

    String s = $id;
    _idToTextureName.put(s, glId);
    _idToHasMipMap.put(s, $generateMipMap);
  
    _counter++;
    
    // For debugging purposes (potentially adds a lot of chatter)
    // logContents();
    
    return s;
  }

  /**
   * Alternate signature for "addTextureId", with MIP mapping set to false by default.
   * Kept for API backward-compatibility. 
   */
  public String addTextureId(Bitmap $b, String $id)
  {
    return this.addTextureId($b, $id, false);
  }
  
  /**
   * 'Uploads' texture via OpenGL and returns an autoassigned textureId,
   * which can be used to assign textures to Object3d's. 
   */
  public String createTextureId(Bitmap $b, boolean $generateMipMap)
  {
    return addTextureId($b, (_counter+""), $generateMipMap);
  }
  
  /**
   * Deletes a textureId from the TextureManager,  
   * and deletes the corresponding texture from the GPU
   */
  public void deleteTexture(String $textureId)
  {
    int glId = _idToTextureName.get($textureId);
    Shared.renderer().deleteTexture(glId);
    _idToTextureName.remove($textureId);
    _idToHasMipMap.remove($textureId);
    
    // logContents();
    
    //xxx needs error check
  }

  /**
   * Returns a String Array of textureId's in the TextureManager 
   */
  public String[] getTextureIds()
  {
    Set<String> set = _idToTextureName.keySet();
    String[] a = new String[set.size()];
    set.toArray(a);
    return a;
  }
  
  /**
   * Used by Renderer
   * 
   */
  int getGlTextureId(String $textureId) /*package-private*/
  {
    return _idToTextureName.get($textureId);
  }
  
  /**
   * Used by Renderer
   */
  boolean hasMipMap(String $textureId) /*package-private*/
  {
    return _idToHasMipMap.get($textureId);
  }
  

  public boolean contains(String $textureId)
  {
    return _idToTextureName.containsKey($textureId);
  }
  
  
  private String arrayToString(String[] $a)
  {
    String s = "";
    for (int i = 0; i < $a.length; i++)
    {
      s += $a[i].toString() + " | ";
    }
    return s;
  }
  
  private void logContents()
  {
    Log.v(Min3d.TAG, "TextureManager contents updated - " + arrayToString( getTextureIds() ) );
  }
  
  public String getNewAtlasId() {
    return "atlas".concat(Integer.toString(_atlasId++));
  }
}

Java Source Code List

• Back to OpenGL/library  ↑