Please note that the contents of this offline web site may be out of date. To access the most recent documentation visit the online version .
Note that links that point to online resources are green in color and will open in a new window.
We would love it if you could give us feedback about this material by filling this form (You have to be online to fill it)
Android APIs
public class

ETC1Util

extends Object
java.lang.Object
   ↳ android.opengl.ETC1Util

Class Overview

Utility methods for using ETC1 compressed textures.

Summary

Nested Classes
class ETC1Util.ETC1Texture A utility class encapsulating a compressed ETC1 texture. 
Public Constructors
ETC1Util ()
Public Methods
static ETC1Util.ETC1Texture compressTexture ( Buffer input, int width, int height, int pixelSize, int stride)
Helper function that compresses an image into an ETC1Texture.
static ETC1Util.ETC1Texture createTexture ( InputStream input)
Create a new ETC1Texture from an input stream containing a PKM formatted compressed texture.
static boolean isETC1Supported ()
Check if ETC1 texture compression is supported by the active OpenGL ES context.
static void loadTexture (int target, int level, int border, int fallbackFormat, int fallbackType, InputStream input)
Convenience method to load an ETC1 texture whether or not the active OpenGL context supports the ETC1 texture compression format.
static void loadTexture (int target, int level, int border, int fallbackFormat, int fallbackType, ETC1Util.ETC1Texture texture)
Convenience method to load an ETC1 texture whether or not the active OpenGL context supports the ETC1 texture compression format.
static void writeTexture ( ETC1Util.ETC1Texture texture, OutputStream output)
Helper function that writes an ETC1Texture to an output stream formatted as a PKM file.
[Expand]
Inherited Methods
From class java.lang.Object

Public Constructors

public ETC1Util ()

Added in API level 8

Public Methods

public static ETC1Util.ETC1Texture compressTexture ( Buffer input, int width, int height, int pixelSize, int stride)

Added in API level 8

Helper function that compresses an image into an ETC1Texture.

Parameters
input a native order direct buffer containing the image data
width the width of the image in pixels
height the height of the image in pixels
pixelSize the size of a pixel in bytes (2 or 3)
stride the width of a line of the image in bytes
Returns
  • the ETC1 texture.

public static ETC1Util.ETC1Texture createTexture ( InputStream input)

Added in API level 8

Create a new ETC1Texture from an input stream containing a PKM formatted compressed texture.

Parameters
input an input stream containing a PKM formatted compressed texture.
Returns
  • an ETC1Texture read from the input stream.
Throws
IOException

public static boolean isETC1Supported ()

Added in API level 8

Check if ETC1 texture compression is supported by the active OpenGL ES context.

Returns
  • true if the active OpenGL ES context supports ETC1 texture compression.

public static void loadTexture (int target, int level, int border, int fallbackFormat, int fallbackType, InputStream input)

Added in API level 8

Convenience method to load an ETC1 texture whether or not the active OpenGL context supports the ETC1 texture compression format.

Parameters
target the texture target.
level the texture level
border the border size. Typically 0.
fallbackFormat the format to use if ETC1 texture compression is not supported. Must be GL_RGB.
fallbackType the type to use if ETC1 texture compression is not supported. Can be either GL_UNSIGNED_SHORT_5_6_5, which implies 16-bits-per-pixel, or GL_UNSIGNED_BYTE, which implies 24-bits-per-pixel.
input the input stream containing an ETC1 texture in PKM format.
Throws
IOException

public static void loadTexture (int target, int level, int border, int fallbackFormat, int fallbackType, ETC1Util.ETC1Texture texture)

Added in API level 8

Convenience method to load an ETC1 texture whether or not the active OpenGL context supports the ETC1 texture compression format.

Parameters
target the texture target.
level the texture level
border the border size. Typically 0.
fallbackFormat the format to use if ETC1 texture compression is not supported. Must be GL_RGB.
fallbackType the type to use if ETC1 texture compression is not supported. Can be either GL_UNSIGNED_SHORT_5_6_5, which implies 16-bits-per-pixel, or GL_UNSIGNED_BYTE, which implies 24-bits-per-pixel.
texture the ETC1 to load.

public static void writeTexture ( ETC1Util.ETC1Texture texture, OutputStream output)

Added in API level 8

Helper function that writes an ETC1Texture to an output stream formatted as a PKM file.

Parameters
texture the input texture.
output the stream to write the formatted texture data to.
Throws
IOException