FileDocCategorySizeDatePackage
Allocation.javaAPI DocAndroid 5.1 API62258Thu Mar 12 22:22:56 GMT 2015android.support.v8.renderscript

Allocation

public class Allocation extends BaseObj

This class provides the primary method through which data is passed to and from RenderScript kernels. An Allocation provides the backing store for a given {@link android.support.v8.renderscript.Type}.

An Allocation also contains a set of usage flags that denote how the Allocation could be used. For example, an Allocation may have usage flags specifying that it can be used from a script as well as input to a {@link android.support.v8.renderscript.Sampler}. A developer must synchronize across these different usages using {@link android.support.v8.renderscript.Allocation#syncAll} in order to ensure that different users of the Allocation have a consistent view of memory. For example, in the case where an Allocation is used as the output of one kernel and as Sampler input in a later kernel, a developer must call {@link #syncAll syncAll(Allocation.USAGE_SCRIPT)} prior to launching the second kernel to ensure correctness.

An Allocation can be populated with the {@link #copyFrom} routines. For more complex Element types, the {@link #copyFromUnchecked} methods can be used to copy from byte arrays or similar constructs.

Developer Guides

For more information about creating an application that uses RenderScript, read the RenderScript developer guide.

Fields Summary
Type
mType
android.graphics.Bitmap
mBitmap
int
mUsage
Allocation
mAdaptedAllocation
int
mSize
boolean
mConstrainedLOD
boolean
mConstrainedFace
boolean
mConstrainedY
boolean
mConstrainedZ
boolean
mReadAllowed
boolean
mWriteAllowed
int
mSelectedY
int
mSelectedZ
int
mSelectedLOD
Type.CubemapFace
mSelectedFace
int
mCurrentDimX
int
mCurrentDimY
int
mCurrentDimZ
int
mCurrentCount
public static final int
USAGE_SCRIPT
The Allocation will be bound to and accessed by scripts.
public static final int
USAGE_GRAPHICS_TEXTURE
The Allocation will be used as a texture source by one or more graphics programs.
public static final int
USAGE_IO_INPUT
The Allocation will be used as a {@link android.graphics.SurfaceTexture} consumer. This usage will cause the Allocation to be created as read-only.
public static final int
USAGE_IO_OUTPUT
The Allocation will be used as a {@link android.graphics.SurfaceTexture} producer. The dimensions and format of the {@link android.graphics.SurfaceTexture} will be forced to those of the Allocation.
public static final int
USAGE_SHARED
The Allocation's backing store will be inherited from another object (usually a {@link android.graphics.Bitmap}); copying to or from the original source Bitmap will cause a synchronization rather than a full copy. {@link #syncAll} may also be used to synchronize the Allocation and the source Bitmap.

This is set by default for allocations created with {@link #createFromBitmap} in API version 18 and higher.

static BitmapFactory.Options
mBitmapOptions
Constructors Summary
Allocation(int id, RenderScript rs, Type t, int usage)

        super(id, rs);
        if ((usage & ~(USAGE_SCRIPT |
                       USAGE_GRAPHICS_TEXTURE |
                       USAGE_IO_INPUT |
                       USAGE_IO_OUTPUT |
                       USAGE_SHARED)) != 0) {
            throw new RSIllegalArgumentException("Unknown usage specified.");
        }

        if ((usage & USAGE_IO_INPUT) != 0) {
            mWriteAllowed = false;

            if ((usage & ~(USAGE_IO_INPUT |
                           USAGE_GRAPHICS_TEXTURE |
                           USAGE_SCRIPT)) != 0) {
                throw new RSIllegalArgumentException("Invalid usage combination.");
            }
        }

        mType = t;
        mUsage = usage;
        mSize = mType.getCount() * mType.getElement().getBytesSize();

        if (t != null) {
            updateCacheInfo(t);
        }
        if (RenderScript.sUseGCHooks == true) {
            try {
                RenderScript.registerNativeAllocation.invoke(RenderScript.sRuntime, mSize);
            } catch (Exception e) {
                Log.e(RenderScript.LOG_TAG, "Couldn't invoke registerNativeAllocation:" + e);
                throw new RSRuntimeException("Couldn't invoke registerNativeAllocation:" + e);
            }
        }
Methods Summary
public voidcopy1DRangeFrom(int off, int count, int[] d)
Copy an array into part of this Allocation. This variant is type checked and will generate exceptions if the Allocation type is not a 32 bit integer type.

param
off The offset of the first element to be copied.
param
count The number of elements to be copied.
param
d the source data array

        validateIsInt32();
        copy1DRangeFromUnchecked(off, count, d);
public voidcopy1DRangeFrom(int off, int count, short[] d)
Copy an array into part of this Allocation. This variant is type checked and will generate exceptions if the Allocation type is not a 16 bit integer type.

param
off The offset of the first element to be copied.
param
count The number of elements to be copied.
param
d the source data array

        validateIsInt16();
        copy1DRangeFromUnchecked(off, count, d);
public voidcopy1DRangeFrom(int off, int count, byte[] d)
Copy an array into part of this Allocation. This variant is type checked and will generate exceptions if the Allocation type is not an 8 bit integer type.

param
off The offset of the first element to be copied.
param
count The number of elements to be copied.
param
d the source data array

        validateIsInt8();
        copy1DRangeFromUnchecked(off, count, d);
public voidcopy1DRangeFrom(int off, int count, float[] d)
Copy an array into part of this Allocation. This variant is type checked and will generate exceptions if the Allocation type is not a 32 bit float type.

param
off The offset of the first element to be copied.
param
count The number of elements to be copied.
param
d the source data array.

        validateIsFloat32();
        copy1DRangeFromUnchecked(off, count, d);
public voidcopy1DRangeFrom(int off, int count, android.support.v8.renderscript.Allocation data, int dataOff)
Copy part of an Allocation into this Allocation.

param
off The offset of the first element to be copied.
param
count The number of elements to be copied.
param
data the source data allocation.
param
dataOff off The offset of the first element in data to be copied.

        mRS.nAllocationData2D(getIDSafe(), off, 0,
                              mSelectedLOD, mSelectedFace.mID,
                              count, 1, data.getID(mRS), dataOff, 0,
                              data.mSelectedLOD, data.mSelectedFace.mID);
public voidcopy1DRangeFromUnchecked(int off, int count, int[] d)
Copy an array into part of this Allocation. This method does not guarantee that the Allocation is compatible with the input buffer.

param
off The offset of the first element to be copied.
param
count The number of elements to be copied.
param
d the source data array

        int dataSize = mType.mElement.getBytesSize() * count;
        data1DChecks(off, count, d.length * 4, dataSize);
        mRS.nAllocationData1D(getIDSafe(), off, mSelectedLOD, count, d, dataSize);
public voidcopy1DRangeFromUnchecked(int off, int count, short[] d)
Copy an array into part of this Allocation. This method does not guarantee that the Allocation is compatible with the input buffer.

param
off The offset of the first element to be copied.
param
count The number of elements to be copied.
param
d the source data array

        int dataSize = mType.mElement.getBytesSize() * count;
        data1DChecks(off, count, d.length * 2, dataSize);
        mRS.nAllocationData1D(getIDSafe(), off, mSelectedLOD, count, d, dataSize);
public voidcopy1DRangeFromUnchecked(int off, int count, byte[] d)
Copy an array into part of this Allocation. This method does not guarantee that the Allocation is compatible with the input buffer.

param
off The offset of the first element to be copied.
param
count The number of elements to be copied.
param
d the source data array

        int dataSize = mType.mElement.getBytesSize() * count;
        data1DChecks(off, count, d.length, dataSize);
        mRS.nAllocationData1D(getIDSafe(), off, mSelectedLOD, count, d, dataSize);
public voidcopy1DRangeFromUnchecked(int off, int count, float[] d)
Copy an array into part of this Allocation. This method does not guarantee that the Allocation is compatible with the input buffer.

param
off The offset of the first element to be copied.
param
count The number of elements to be copied.
param
d the source data array

        int dataSize = mType.mElement.getBytesSize() * count;
        data1DChecks(off, count, d.length * 4, dataSize);
        mRS.nAllocationData1D(getIDSafe(), off, mSelectedLOD, count, d, dataSize);
public voidcopy2DRangeFrom(int xoff, int yoff, int w, int h, byte[] data)
Copy from an array into a rectangular region in this Allocation. The array is assumed to be tightly packed.

param
xoff X offset of the region to update in this Allocation
param
yoff Y offset of the region to update in this Allocation
param
w Width of the region to update
param
h Height of the region to update
param
data to be placed into the Allocation

        validateIsInt8();
        copy2DRangeFromUnchecked(xoff, yoff, w, h, data);
public voidcopy2DRangeFrom(int xoff, int yoff, int w, int h, short[] data)
Copy from an array into a rectangular region in this Allocation. The array is assumed to be tightly packed.

param
xoff X offset of the region to update in this Allocation
param
yoff Y offset of the region to update in this Allocation
param
w Width of the region to update
param
h Height of the region to update
param
data to be placed into the Allocation

        validateIsInt16();
        copy2DRangeFromUnchecked(xoff, yoff, w, h, data);
public voidcopy2DRangeFrom(int xoff, int yoff, int w, int h, int[] data)
Copy from an array into a rectangular region in this Allocation. The array is assumed to be tightly packed.

param
xoff X offset of the region to update in this Allocation
param
yoff Y offset of the region to update in this Allocation
param
w Width of the region to update
param
h Height of the region to update
param
data to be placed into the Allocation

        validateIsInt32();
        copy2DRangeFromUnchecked(xoff, yoff, w, h, data);
public voidcopy2DRangeFrom(int xoff, int yoff, int w, int h, float[] data)
Copy from an array into a rectangular region in this Allocation. The array is assumed to be tightly packed.

param
xoff X offset of the region to update in this Allocation
param
yoff Y offset of the region to update in this Allocation
param
w Width of the region to update
param
h Height of the region to update
param
data to be placed into the Allocation

        validateIsFloat32();
        copy2DRangeFromUnchecked(xoff, yoff, w, h, data);
public voidcopy2DRangeFrom(int xoff, int yoff, int w, int h, android.support.v8.renderscript.Allocation data, int dataXoff, int dataYoff)
Copy a rectangular region from an Allocation into a rectangular region in this Allocation.

param
xoff X offset of the region in this Allocation
param
yoff Y offset of the region in this Allocation
param
w Width of the region to update.
param
h Height of the region to update.
param
data source Allocation.
param
dataXoff X offset in source Allocation
param
dataYoff Y offset in source Allocation

        mRS.validate();
        validate2DRange(xoff, yoff, w, h);
        mRS.nAllocationData2D(getIDSafe(), xoff, yoff,
                              mSelectedLOD, mSelectedFace.mID,
                              w, h, data.getID(mRS), dataXoff, dataYoff,
                              data.mSelectedLOD, data.mSelectedFace.mID);
public voidcopy2DRangeFrom(int xoff, int yoff, android.graphics.Bitmap data)
Copy a {@link android.graphics.Bitmap} into an Allocation. The height and width of the update will use the height and width of the {@link android.graphics.Bitmap}.

param
xoff X offset of the region to update in this Allocation
param
yoff Y offset of the region to update in this Allocation
param
data the Bitmap to be copied

        mRS.validate();
        if (data.getConfig() == null) {
            Bitmap newBitmap = Bitmap.createBitmap(data.getWidth(), data.getHeight(), Bitmap.Config.ARGB_8888);
            Canvas c = new Canvas(newBitmap);
            c.drawBitmap(data, 0, 0, null);
            copy2DRangeFrom(xoff, yoff, newBitmap);
            return;
        }
        validateBitmapFormat(data);
        validate2DRange(xoff, yoff, data.getWidth(), data.getHeight());
        mRS.nAllocationData2D(getIDSafe(), xoff, yoff, mSelectedLOD, mSelectedFace.mID, data);
voidcopy2DRangeFromUnchecked(int xoff, int yoff, int w, int h, byte[] data)

        mRS.validate();
        validate2DRange(xoff, yoff, w, h);
        mRS.nAllocationData2D(getIDSafe(), xoff, yoff, mSelectedLOD, mSelectedFace.mID,
                              w, h, data, data.length);
voidcopy2DRangeFromUnchecked(int xoff, int yoff, int w, int h, short[] data)

        mRS.validate();
        validate2DRange(xoff, yoff, w, h);
        mRS.nAllocationData2D(getIDSafe(), xoff, yoff, mSelectedLOD, mSelectedFace.mID,
                              w, h, data, data.length * 2);
voidcopy2DRangeFromUnchecked(int xoff, int yoff, int w, int h, int[] data)

        mRS.validate();
        validate2DRange(xoff, yoff, w, h);
        mRS.nAllocationData2D(getIDSafe(), xoff, yoff, mSelectedLOD, mSelectedFace.mID,
                              w, h, data, data.length * 4);
voidcopy2DRangeFromUnchecked(int xoff, int yoff, int w, int h, float[] data)

        mRS.validate();
        validate2DRange(xoff, yoff, w, h);
        mRS.nAllocationData2D(getIDSafe(), xoff, yoff, mSelectedLOD, mSelectedFace.mID,
                              w, h, data, data.length * 4);
public voidcopy3DRangeFrom(int xoff, int yoff, int zoff, int w, int h, int d, byte[] data)

hide
Copy a rectangular region from the array into the allocation. The array is assumed to be tightly packed.
param
xoff X offset of the region to update in this Allocation
param
yoff Y offset of the region to update in this Allocation
param
zoff Z offset of the region to update in this Allocation
param
w Width of the region to update
param
h Height of the region to update
param
d Depth of the region to update
param
data to be placed into the allocation

        validateIsInt8();
        copy3DRangeFromUnchecked(xoff, yoff, zoff, w, h, d, data);
public voidcopy3DRangeFrom(int xoff, int yoff, int zoff, int w, int h, int d, short[] data)

hide

        validateIsInt16();
        copy3DRangeFromUnchecked(xoff, yoff, zoff, w, h, d, data);
public voidcopy3DRangeFrom(int xoff, int yoff, int zoff, int w, int h, int d, int[] data)

hide

        validateIsInt32();
        copy3DRangeFromUnchecked(xoff, yoff, zoff, w, h, d, data);
public voidcopy3DRangeFrom(int xoff, int yoff, int zoff, int w, int h, int d, float[] data)

hide

        validateIsFloat32();
        copy3DRangeFromUnchecked(xoff, yoff, zoff, w, h, d, data);
public voidcopy3DRangeFrom(int xoff, int yoff, int zoff, int w, int h, int d, android.support.v8.renderscript.Allocation data, int dataXoff, int dataYoff, int dataZoff)

hide
Copy a rectangular region into the allocation from another allocation.
param
xoff X offset of the region to update in this Allocation
param
yoff Y offset of the region to update in this Allocation
param
zoff Z offset of the region to update in this Allocation
param
w Width of the region to update.
param
h Height of the region to update.
param
d Depth of the region to update.
param
data source allocation.
param
dataXoff X offset of the region in the source Allocation
param
dataYoff Y offset of the region in the source Allocation
param
dataZoff Z offset of the region in the source Allocation

        mRS.validate();
        validate3DRange(xoff, yoff, zoff, w, h, d);
        mRS.nAllocationData3D(getIDSafe(), xoff, yoff, zoff, mSelectedLOD,
                              w, h, d, data.getID(mRS), dataXoff, dataYoff, dataZoff,
                              data.mSelectedLOD);
voidcopy3DRangeFromUnchecked(int xoff, int yoff, int zoff, int w, int h, int d, byte[] data)

hide

        mRS.validate();
        validate3DRange(xoff, yoff, zoff, w, h, d);
        mRS.nAllocationData3D(getIDSafe(), xoff, yoff, zoff, mSelectedLOD,
                              w, h, d, data, data.length);
voidcopy3DRangeFromUnchecked(int xoff, int yoff, int zoff, int w, int h, int d, short[] data)

hide

        mRS.validate();
        validate3DRange(xoff, yoff, zoff, w, h, d);
        mRS.nAllocationData3D(getIDSafe(), xoff, yoff, zoff, mSelectedLOD,
                              w, h, d, data, data.length * 2);
voidcopy3DRangeFromUnchecked(int xoff, int yoff, int zoff, int w, int h, int d, int[] data)

hide

        mRS.validate();
        validate3DRange(xoff, yoff, zoff, w, h, d);
        mRS.nAllocationData3D(getIDSafe(), xoff, yoff, zoff, mSelectedLOD,
                              w, h, d, data, data.length * 4);
voidcopy3DRangeFromUnchecked(int xoff, int yoff, int zoff, int w, int h, int d, float[] data)

hide

        mRS.validate();
        validate3DRange(xoff, yoff, zoff, w, h, d);
        mRS.nAllocationData3D(getIDSafe(), xoff, yoff, zoff, mSelectedLOD,
                              w, h, d, data, data.length * 4);
public voidcopyFrom(BaseObj[] d)
Copy an array of RS objects to the Allocation.

param
d Source array.

        mRS.validate();
        validateIsObject();
        if (d.length != mCurrentCount) {
            throw new RSIllegalArgumentException("Array size mismatch, allocation sizeX = " +
                                                 mCurrentCount + ", array length = " + d.length);
        }
        int i[] = new int[d.length];
        for (int ct=0; ct < d.length; ct++) {
            i[ct] = d[ct].getID(mRS);
        }
        copy1DRangeFromUnchecked(0, mCurrentCount, i);
public voidcopyFrom(int[] d)
Copy into this Allocation from an array. This variant is type checked and will generate exceptions if the Allocation's {@link android.support.v8.renderscript.Element} is not a 32 bit integer type.

param
d the source data array

        mRS.validate();
        if (mCurrentDimZ > 0) {
            copy3DRangeFrom(0, 0, 0, mCurrentDimX, mCurrentDimY, mCurrentDimZ, d);
        } else if (mCurrentDimY > 0) {
            copy2DRangeFrom(0, 0, mCurrentDimX, mCurrentDimY, d);
        } else {
            copy1DRangeFrom(0, mCurrentCount, d);
        }
public voidcopyFrom(short[] d)
Copy into this Allocation from an array. This variant is type checked and will generate exceptions if the Allocation's {@link android.support.v8.renderscript.Element} is not a 16 bit integer type.

param
d the source data array

        mRS.validate();
        if (mCurrentDimZ > 0) {
            copy3DRangeFrom(0, 0, 0, mCurrentDimX, mCurrentDimY, mCurrentDimZ, d);
        } else if (mCurrentDimY > 0) {
            copy2DRangeFrom(0, 0, mCurrentDimX, mCurrentDimY, d);
        } else {
            copy1DRangeFrom(0, mCurrentCount, d);
        }
public voidcopyFrom(byte[] d)
Copy into this Allocation from an array. This variant is type checked and will generate exceptions if the Allocation's {@link android.support.v8.renderscript.Element} is not an 8 bit integer type.

param
d the source data array

        mRS.validate();
        if (mCurrentDimZ > 0) {
            copy3DRangeFrom(0, 0, 0, mCurrentDimX, mCurrentDimY, mCurrentDimZ, d);
        } else if (mCurrentDimY > 0) {
            copy2DRangeFrom(0, 0, mCurrentDimX, mCurrentDimY, d);
        } else {
            copy1DRangeFrom(0, mCurrentCount, d);
        }
public voidcopyFrom(float[] d)
Copy into this Allocation from an array. This variant is type checked and will generate exceptions if the Allocation's {@link android.support.v8.renderscript.Element} is not a 32 bit float type.

param
d the source data array

        mRS.validate();
        if (mCurrentDimZ > 0) {
            copy3DRangeFrom(0, 0, 0, mCurrentDimX, mCurrentDimY, mCurrentDimZ, d);
        } else if (mCurrentDimY > 0) {
            copy2DRangeFrom(0, 0, mCurrentDimX, mCurrentDimY, d);
        } else {
            copy1DRangeFrom(0, mCurrentCount, d);
        }
public voidcopyFrom(android.graphics.Bitmap b)
Copy into an Allocation from a {@link android.graphics.Bitmap}. The height, width, and format of the bitmap must match the existing allocation.

If the {@link android.graphics.Bitmap} is the same as the {@link android.graphics.Bitmap} used to create the Allocation with {@link #createFromBitmap} and {@link #USAGE_SHARED} is set on the Allocation, this will synchronize the Allocation with the latest data from the {@link android.graphics.Bitmap}, potentially avoiding the actual copy.

param
b the source bitmap

        mRS.validate();
        if (b.getConfig() == null) {
            Bitmap newBitmap = Bitmap.createBitmap(b.getWidth(), b.getHeight(), Bitmap.Config.ARGB_8888);
            Canvas c = new Canvas(newBitmap);
            c.drawBitmap(b, 0, 0, null);
            copyFrom(newBitmap);
            return;
        }
        validateBitmapSize(b);
        validateBitmapFormat(b);
        mRS.nAllocationCopyFromBitmap(getID(mRS), b);
public voidcopyFrom(android.support.v8.renderscript.Allocation a)
Copy an Allocation from an Allocation. The types of both allocations must be identical.

param
a the source allocation

        mRS.validate();
        if (!mType.equals(a.getType())) {
            throw new RSIllegalArgumentException("Types of allocations must match.");
        }
        copy2DRangeFrom(0, 0, mCurrentDimX, mCurrentDimY, a, 0, 0);
public voidcopyFromUnchecked(int[] d)
Copy into this Allocation from an array. This method does not guarantee that the Allocation is compatible with the input buffer; it copies memory without reinterpretation.

param
d the source data array

        mRS.validate();
        if (mCurrentDimZ > 0) {
            copy3DRangeFromUnchecked(0, 0, 0, mCurrentDimX, mCurrentDimY, mCurrentDimZ, d);
        } else if (mCurrentDimY > 0) {
            copy2DRangeFromUnchecked(0, 0, mCurrentDimX, mCurrentDimY, d);
        } else {
            copy1DRangeFromUnchecked(0, mCurrentCount, d);
        }
public voidcopyFromUnchecked(short[] d)
Copy into this Allocation from an array. This method does not guarantee that the Allocation is compatible with the input buffer; it copies memory without reinterpretation.

param
d the source data array

        mRS.validate();
        if (mCurrentDimZ > 0) {
            copy3DRangeFromUnchecked(0, 0, 0, mCurrentDimX, mCurrentDimY, mCurrentDimZ, d);
        } else if (mCurrentDimY > 0) {
            copy2DRangeFromUnchecked(0, 0, mCurrentDimX, mCurrentDimY, d);
        } else {
            copy1DRangeFromUnchecked(0, mCurrentCount, d);
        }
public voidcopyFromUnchecked(byte[] d)
Copy into this Allocation from an array. This method does not guarantee that the Allocation is compatible with the input buffer; it copies memory without reinterpretation.

param
d the source data array

        mRS.validate();
        if (mCurrentDimZ > 0) {
            copy3DRangeFromUnchecked(0, 0, 0, mCurrentDimX, mCurrentDimY, mCurrentDimZ, d);
        } else if (mCurrentDimY > 0) {
            copy2DRangeFromUnchecked(0, 0, mCurrentDimX, mCurrentDimY, d);
        } else {
            copy1DRangeFromUnchecked(0, mCurrentCount, d);
        }
public voidcopyFromUnchecked(float[] d)
Copy into this Allocation from an array. This method does not guarantee that the Allocation is compatible with the input buffer; it copies memory without reinterpretation.

param
d the source data array

        mRS.validate();
        if (mCurrentDimZ > 0) {
            copy3DRangeFromUnchecked(0, 0, 0, mCurrentDimX, mCurrentDimY, mCurrentDimZ, d);
        } else if (mCurrentDimY > 0) {
            copy2DRangeFromUnchecked(0, 0, mCurrentDimX, mCurrentDimY, d);
        } else {
            copy1DRangeFromUnchecked(0, mCurrentCount, d);
        }
public voidcopyTo(android.graphics.Bitmap b)
Copy from the Allocation into a {@link android.graphics.Bitmap}. The bitmap must match the dimensions of the Allocation.

param
b The bitmap to be set from the Allocation.

        mRS.validate();
        validateBitmapFormat(b);
        validateBitmapSize(b);
        mRS.nAllocationCopyToBitmap(getID(mRS), b);
public voidcopyTo(byte[] d)
Copy from the Allocation into a byte array. The array must be at least as large as the Allocation. The allocation must be of an 8 bit integer {@link android.support.v8.renderscript.Element} type.

param
d The array to be set from the Allocation.

        validateIsInt8();
        mRS.validate();
        mRS.nAllocationRead(getID(mRS), d);
public voidcopyTo(short[] d)
Copy from the Allocation into a short array. The array must be at least as large as the Allocation. The allocation must be of an 16 bit integer {@link android.support.v8.renderscript.Element} type.

param
d The array to be set from the Allocation.

        validateIsInt16();
        mRS.validate();
        mRS.nAllocationRead(getID(mRS), d);
public voidcopyTo(int[] d)
Copy from the Allocation into a int array. The array must be at least as large as the Allocation. The allocation must be of an 32 bit integer {@link android.support.v8.renderscript.Element} type.

param
d The array to be set from the Allocation.

        validateIsInt32();
        mRS.validate();
        mRS.nAllocationRead(getID(mRS), d);
public voidcopyTo(float[] d)
Copy from the Allocation into a float array. The array must be at least as large as the Allocation. The allocation must be of an 32 bit float {@link android.support.v8.renderscript.Element} type.

param
d The array to be set from the Allocation.

        validateIsFloat32();
        mRS.validate();
        mRS.nAllocationRead(getID(mRS), d);
public static android.support.v8.renderscript.AllocationcreateCubemapFromBitmap(RenderScript rs, android.graphics.Bitmap b, android.support.v8.renderscript.Allocation$MipmapControl mips, int usage)
Creates a cubemap Allocation from a {@link android.graphics.Bitmap} containing the horizontal list of cube faces. Each face must be a square, have the same size as all other faces, and have a width that is a power of 2.

param
rs Context to which the allocation will belong.
param
b Bitmap with cubemap faces layed out in the following format: right, left, top, bottom, front, back
param
mips specifies desired mipmap behaviour for the cubemap
param
usage bit field specifying how the cubemap is utilized
return
allocation containing cubemap data

        rs.validate();

        int height = b.getHeight();
        int width = b.getWidth();

        if (width % 6 != 0) {
            throw new RSIllegalArgumentException("Cubemap height must be multiple of 6");
        }
        if (width / 6 != height) {
            throw new RSIllegalArgumentException("Only square cube map faces supported");
        }
        boolean isPow2 = (height & (height - 1)) == 0;
        if (!isPow2) {
            throw new RSIllegalArgumentException("Only power of 2 cube faces supported");
        }

        Element e = elementFromBitmap(rs, b);
        Type.Builder tb = new Type.Builder(rs, e);
        tb.setX(height);
        tb.setY(height);
        tb.setFaces(true);
        tb.setMipmaps(mips == MipmapControl.MIPMAP_FULL);
        Type t = tb.create();

        int id = rs.nAllocationCubeCreateFromBitmap(t.getID(rs), mips.mID, b, usage);
        if(id == 0) {
            throw new RSRuntimeException("Load failed for bitmap " + b + " element " + e);
        }
        return new Allocation(id, rs, t, usage);
public static android.support.v8.renderscript.AllocationcreateCubemapFromBitmap(RenderScript rs, android.graphics.Bitmap b)
Creates a non-mipmapped cubemap Allocation for use as a graphics texture from a {@link android.graphics.Bitmap} containing the horizontal list of cube faces. Each face must be a square, have the same size as all other faces, and have a width that is a power of 2.

param
rs Context to which the allocation will belong.
param
b bitmap with cubemap faces layed out in the following format: right, left, top, bottom, front, back
return
allocation containing cubemap data

        return createCubemapFromBitmap(rs, b, MipmapControl.MIPMAP_NONE,
                                       USAGE_GRAPHICS_TEXTURE);
public static android.support.v8.renderscript.AllocationcreateCubemapFromCubeFaces(RenderScript rs, android.graphics.Bitmap xpos, android.graphics.Bitmap xneg, android.graphics.Bitmap ypos, android.graphics.Bitmap yneg, android.graphics.Bitmap zpos, android.graphics.Bitmap zneg, android.support.v8.renderscript.Allocation$MipmapControl mips, int usage)
Creates a cubemap Allocation from 6 {@link android.graphics.Bitmap} objects containing the cube faces. Each face must be a square, have the same size as all other faces, and have a width that is a power of 2.

param
rs Context to which the allocation will belong.
param
xpos cubemap face in the positive x direction
param
xneg cubemap face in the negative x direction
param
ypos cubemap face in the positive y direction
param
yneg cubemap face in the negative y direction
param
zpos cubemap face in the positive z direction
param
zneg cubemap face in the negative z direction
param
mips specifies desired mipmap behaviour for the cubemap
param
usage bit field specifying how the cubemap is utilized
return
allocation containing cubemap data

        /*
        int height = xpos.getHeight();
        if (xpos.getWidth() != height ||
            xneg.getWidth() != height || xneg.getHeight() != height ||
            ypos.getWidth() != height || ypos.getHeight() != height ||
            yneg.getWidth() != height || yneg.getHeight() != height ||
            zpos.getWidth() != height || zpos.getHeight() != height ||
            zneg.getWidth() != height || zneg.getHeight() != height) {
            throw new RSIllegalArgumentException("Only square cube map faces supported");
        }
        boolean isPow2 = (height & (height - 1)) == 0;
        if (!isPow2) {
            throw new RSIllegalArgumentException("Only power of 2 cube faces supported");
        }

        Element e = elementFromBitmap(rs, xpos);
        Type.Builder tb = new Type.Builder(rs, e);
        tb.setX(height);
        tb.setY(height);
        tb.setFaces(true);
        tb.setMipmaps(mips == MipmapControl.MIPMAP_FULL);
        Type t = tb.create();
        Allocation cubemap = Allocation.createTyped(rs, t, mips, usage);

        AllocationAdapter adapter = AllocationAdapter.create2D(rs, cubemap);
        adapter.setFace(Type.CubemapFace.POSITIVE_X);
        adapter.copyFrom(xpos);
        adapter.setFace(Type.CubemapFace.NEGATIVE_X);
        adapter.copyFrom(xneg);
        adapter.setFace(Type.CubemapFace.POSITIVE_Y);
        adapter.copyFrom(ypos);
        adapter.setFace(Type.CubemapFace.NEGATIVE_Y);
        adapter.copyFrom(yneg);
        adapter.setFace(Type.CubemapFace.POSITIVE_Z);
        adapter.copyFrom(zpos);
        adapter.setFace(Type.CubemapFace.NEGATIVE_Z);
        adapter.copyFrom(zneg);

        return cubemap;
        */
        return null;
public static android.support.v8.renderscript.AllocationcreateCubemapFromCubeFaces(RenderScript rs, android.graphics.Bitmap xpos, android.graphics.Bitmap xneg, android.graphics.Bitmap ypos, android.graphics.Bitmap yneg, android.graphics.Bitmap zpos, android.graphics.Bitmap zneg)
Creates a non-mipmapped cubemap Allocation for use as a sampler input from 6 {@link android.graphics.Bitmap} objects containing the cube faces. Each face must be a square, have the same size as all other faces, and have a width that is a power of 2.

param
rs Context to which the allocation will belong.
param
xpos cubemap face in the positive x direction
param
xneg cubemap face in the negative x direction
param
ypos cubemap face in the positive y direction
param
yneg cubemap face in the negative y direction
param
zpos cubemap face in the positive z direction
param
zneg cubemap face in the negative z direction
return
allocation containing cubemap data

        return createCubemapFromCubeFaces(rs, xpos, xneg, ypos, yneg,
                                          zpos, zneg, MipmapControl.MIPMAP_NONE,
                                          USAGE_GRAPHICS_TEXTURE);
public static android.support.v8.renderscript.AllocationcreateFromBitmap(RenderScript rs, android.graphics.Bitmap b, android.support.v8.renderscript.Allocation$MipmapControl mips, int usage)
Creates an Allocation from a {@link android.graphics.Bitmap}.

param
rs Context to which the allocation will belong.
param
b Bitmap source for the allocation data
param
mips specifies desired mipmap behaviour for the allocation
param
usage bit field specifying how the allocation is utilized
return
Allocation containing bitmap data

        if (rs.isNative) {
            RenderScriptThunker rst = (RenderScriptThunker)rs;
            return AllocationThunker.createFromBitmap(rst, b, mips, usage);
        }
        rs.validate();

        // WAR undocumented color formats
        if (b.getConfig() == null) {
            if ((usage & USAGE_SHARED) != 0) {
                throw new RSIllegalArgumentException("USAGE_SHARED cannot be used with a Bitmap that has a null config.");
            }
            Bitmap newBitmap = Bitmap.createBitmap(b.getWidth(), b.getHeight(), Bitmap.Config.ARGB_8888);
            Canvas c = new Canvas(newBitmap);
            c.drawBitmap(b, 0, 0, null);
            return createFromBitmap(rs, newBitmap, mips, usage);
        }

        Type t = typeFromBitmap(rs, b, mips);

        // enable optimized bitmap path only with no mipmap and script-only usage
        if (mips == MipmapControl.MIPMAP_NONE &&
            t.getElement().isCompatible(Element.RGBA_8888(rs)) &&
            usage == (USAGE_SHARED | USAGE_SCRIPT | USAGE_GRAPHICS_TEXTURE)) {
            int id = rs.nAllocationCreateBitmapBackedAllocation(t.getID(rs), mips.mID, b, usage);
            if (id == 0) {
                throw new RSRuntimeException("Load failed.");
            }

            // keep a reference to the Bitmap around to prevent GC
            Allocation alloc = new Allocation(id, rs, t, usage);
            alloc.setBitmap(b);
            return alloc;
        }


        int id = rs.nAllocationCreateFromBitmap(t.getID(rs), mips.mID, b, usage);
        if (id == 0) {
            throw new RSRuntimeException("Load failed.");
        }
        return new Allocation(id, rs, t, usage);
public static android.support.v8.renderscript.AllocationcreateFromBitmap(RenderScript rs, android.graphics.Bitmap b)
Creates an Allocation from a {@link android.graphics.Bitmap}.

This Allocation will be created with {@link #USAGE_SHARED}, and {@link #USAGE_SCRIPT}.

param
rs Context to which the allocation will belong.
param
b bitmap source for the allocation data
return
Allocation containing bitmap data

        return createFromBitmap(rs, b, MipmapControl.MIPMAP_NONE,
                                USAGE_SHARED | USAGE_SCRIPT | USAGE_GRAPHICS_TEXTURE);
public static android.support.v8.renderscript.AllocationcreateFromBitmapResource(RenderScript rs, android.content.res.Resources res, int id, android.support.v8.renderscript.Allocation$MipmapControl mips, int usage)
Creates an Allocation from the Bitmap referenced by resource ID.

param
rs Context to which the allocation will belong.
param
res application resources
param
id resource id to load the data from
param
mips specifies desired mipmap behaviour for the allocation
param
usage bit field specifying how the allocation is utilized
return
Allocation containing resource data


        rs.validate();
        if ((usage & (USAGE_SHARED | USAGE_IO_INPUT | USAGE_IO_OUTPUT)) != 0) {
            throw new RSIllegalArgumentException("Unsupported usage specified.");
        }
        Bitmap b = BitmapFactory.decodeResource(res, id);
        Allocation alloc = createFromBitmap(rs, b, mips, usage);
        b.recycle();
        return alloc;
public static android.support.v8.renderscript.AllocationcreateFromBitmapResource(RenderScript rs, android.content.res.Resources res, int id)
Creates a non-mipmapped Allocation to use as a graphics texture from the {@link android.graphics.Bitmap} referenced by resource ID.

This allocation will be created with {@link #USAGE_SCRIPT} and {@link #USAGE_GRAPHICS_TEXTURE}.

param
rs Context to which the allocation will belong.
param
res application resources
param
id resource id to load the data from
return
Allocation containing resource data

        return createFromBitmapResource(rs, res, id,
                                        MipmapControl.MIPMAP_NONE,
                                        USAGE_SCRIPT | USAGE_GRAPHICS_TEXTURE);
public static android.support.v8.renderscript.AllocationcreateFromString(RenderScript rs, java.lang.String str, int usage)
Creates an Allocation containing string data encoded in UTF-8 format.

param
rs Context to which the allocation will belong.
param
str string to create the allocation from
param
usage bit field specifying how the allocaiton is utilized

        rs.validate();
        byte[] allocArray = null;
        try {
            allocArray = str.getBytes("UTF-8");
            Allocation alloc = Allocation.createSized(rs, Element.U8(rs), allocArray.length, usage);
            alloc.copyFrom(allocArray);
            return alloc;
        }
        catch (Exception e) {
            throw new RSRuntimeException("Could not convert string to utf-8.");
        }
public static android.support.v8.renderscript.AllocationcreateSized(RenderScript rs, Element e, int count, int usage)
Creates an Allocation with a specified number of given elements

param
rs Context to which the Allocation will belong.
param
e Element to use in the Allocation
param
count the number of Elements in the Allocation
param
usage bit field specifying how the Allocation is utilized
return
allocation

        if (rs.isNative) {
            RenderScriptThunker rst = (RenderScriptThunker)rs;
            return AllocationThunker.createSized(rs, e, count, usage);
        }
        rs.validate();
        Type.Builder b = new Type.Builder(rs, e);
        b.setX(count);
        Type t = b.create();

        int id = rs.nAllocationCreateTyped(t.getID(rs), MipmapControl.MIPMAP_NONE.mID, usage, 0);
        if (id == 0) {
            throw new RSRuntimeException("Allocation creation failed.");
        }
        return new Allocation(id, rs, t, usage);
public static android.support.v8.renderscript.AllocationcreateSized(RenderScript rs, Element e, int count)
Creates an Allocation with a specified number of given elements

param
rs Context to which the Allocation will belong.
param
e Element to use in the Allocation
param
count the number of Elements in the Allocation
return
allocation

        return createSized(rs, e, count, USAGE_SCRIPT);
public static android.support.v8.renderscript.AllocationcreateTyped(RenderScript rs, Type type, android.support.v8.renderscript.Allocation$MipmapControl mips, int usage)
Creates a new Allocation with the given {@link android.support.v8.renderscript.Type}, mipmap flag, and usage flags.

param
type RenderScript type describing data layout
param
mips specifies desired mipmap behaviour for the allocation
param
usage bit field specifying how the Allocation is utilized

     
        mBitmapOptions.inScaled = false;
    
        if (rs.isNative) {
            RenderScriptThunker rst = (RenderScriptThunker)rs;
            return AllocationThunker.createTyped(rst, type, mips, usage);
        }
        rs.validate();
        if (type.getID(rs) == 0) {
            throw new RSInvalidStateException("Bad Type");
        }
        int id = rs.nAllocationCreateTyped(type.getID(rs), mips.mID, usage, 0);
        if (id == 0) {
            throw new RSRuntimeException("Allocation creation failed.");
        }
        return new Allocation(id, rs, type, usage);
public static android.support.v8.renderscript.AllocationcreateTyped(RenderScript rs, Type type, int usage)
Creates an Allocation with the size specified by the type and no mipmaps generated by default

param
rs Context to which the allocation will belong.
param
type renderscript type describing data layout
param
usage bit field specifying how the allocation is utilized
return
allocation

        return createTyped(rs, type, MipmapControl.MIPMAP_NONE, usage);
public static android.support.v8.renderscript.AllocationcreateTyped(RenderScript rs, Type type)
Creates an Allocation for use by scripts with a given {@link android.support.v8.renderscript.Type} and no mipmaps

param
rs Context to which the Allocation will belong.
param
type RenderScript Type describing data layout
return
allocation

        return createTyped(rs, type, MipmapControl.MIPMAP_NONE, USAGE_SCRIPT);
private voiddata1DChecks(int off, int count, int len, int dataSize)

        mRS.validate();
        if(off < 0) {
            throw new RSIllegalArgumentException("Offset must be >= 0.");
        }
        if(count < 1) {
            throw new RSIllegalArgumentException("Count must be >= 1.");
        }
        if((off + count) > mCurrentCount) {
            throw new RSIllegalArgumentException("Overflow, Available count " + mCurrentCount +
                                               ", got " + count + " at offset " + off + ".");
        }
        if(len < dataSize) {
            throw new RSIllegalArgumentException("Array too small for allocation type.");
        }
static ElementelementFromBitmap(RenderScript rs, android.graphics.Bitmap b)

        final Bitmap.Config bc = b.getConfig();
        if (bc == Bitmap.Config.ALPHA_8) {
            return Element.A_8(rs);
        }
        if (bc == Bitmap.Config.ARGB_4444) {
            return Element.RGBA_4444(rs);
        }
        if (bc == Bitmap.Config.ARGB_8888) {
            return Element.RGBA_8888(rs);
        }
        if (bc == Bitmap.Config.RGB_565) {
            return Element.RGB_565(rs);
        }
        throw new RSInvalidStateException("Bad bitmap type: " + bc);
protected voidfinalize()

        if (RenderScript.sUseGCHooks == true) {
            RenderScript.registerNativeFree.invoke(RenderScript.sRuntime, mSize);
        }
        super.finalize();
public voidgenerateMipmaps()
Generate a mipmap chain. This is only valid if the Type of the Allocation includes mipmaps.

This function will generate a complete set of mipmaps from the top level LOD and place them into the script memory space.

If the Allocation is also using other memory spaces, a call to {@link #syncAll syncAll(Allocation.USAGE_SCRIPT)} is required.

        mRS.nAllocationGenerateMipmaps(getID(mRS));
public intgetBytesSize()
Get the size of the Allocation in bytes.

return
size of the Allocation in bytes.

        if (mType.mDimYuv != 0) {
            return (int)Math.ceil(mType.getCount() * mType.getElement().getBytesSize() * 1.5);
        }
        return mType.getCount() * mType.getElement().getBytesSize();
public ElementgetElement()
Get the {@link android.support.v8.renderscript.Element} of the {@link android.support.v8.renderscript.Type} of the Allocation.

return
Element

        return mType.getElement();
private intgetIDSafe()

        if (mAdaptedAllocation != null) {
            return mAdaptedAllocation.getID(mRS);
        }
        return getID(mRS);
public TypegetType()
Get the {@link android.support.v8.renderscript.Type} of the Allocation.

return
Type

        return mType;
public intgetUsage()
Get the usage flags of the Allocation.

return
usage this Allocation's set of the USAGE_* flags OR'd together

        return mUsage;
public voidioReceive()
Receive the latest input into the Allocation. This operation is only valid if {@link #USAGE_IO_INPUT} is set on the Allocation.

        if ((mUsage & USAGE_IO_INPUT) == 0) {
            throw new RSIllegalArgumentException(
                "Can only receive if IO_INPUT usage specified.");
        }
        mRS.validate();
        mRS.nAllocationIoReceive(getID(mRS));
public voidioSend()
Send a buffer to the output stream. The contents of the Allocation will be undefined after this operation. This operation is only valid if {@link #USAGE_IO_OUTPUT} is set on the Allocation.

        if ((mUsage & USAGE_IO_OUTPUT) == 0) {
            throw new RSIllegalArgumentException(
                "Can only send buffer if IO_OUTPUT usage specified.");
        }
        mRS.validate();
        mRS.nAllocationIoSend(getID(mRS));
public voidioSendOutput()
Delete once code is updated.

hide

        ioSend();
private voidsetBitmap(android.graphics.Bitmap b)

        mBitmap = b;
public voidsetFromFieldPacker(int xoff, FieldPacker fp)
This is only intended to be used by auto-generated code reflected from the RenderScript script files and should not be used by developers.

param
xoff
param
fp

        mRS.validate();
        int eSize = mType.mElement.getBytesSize();
        final byte[] data = fp.getData();
        int data_length = fp.getPos();

        int count = data_length / eSize;
        if ((eSize * count) != data_length) {
            throw new RSIllegalArgumentException("Field packer length " + data_length +
                                               " not divisible by element size " + eSize + ".");
        }
        copy1DRangeFromUnchecked(xoff, count, data);
public voidsetFromFieldPacker(int xoff, int component_number, FieldPacker fp)
This is only intended to be used by auto-generated code reflected from the RenderScript script files.

param
xoff
param
component_number
param
fp

        mRS.validate();
        if (component_number >= mType.mElement.mElements.length) {
            throw new RSIllegalArgumentException("Component_number " + component_number + " out of range.");
        }
        if(xoff < 0) {
            throw new RSIllegalArgumentException("Offset must be >= 0.");
        }

        final byte[] data = fp.getData();
        int data_length = fp.getPos();
        int eSize = mType.mElement.mElements[component_number].getBytesSize();
        eSize *= mType.mElement.mArraySizes[component_number];

        if (data_length != eSize) {
            throw new RSIllegalArgumentException("Field packer sizelength " + data_length +
                                               " does not match component size " + eSize + ".");
        }

        mRS.nAllocationElementData1D(getIDSafe(), xoff, mSelectedLOD,
                                     component_number, data, data_length);
public voidsyncAll(int srcLocation)
Propagate changes from one usage of the Allocation to the other usages of the Allocation.

        switch (srcLocation) {
        case USAGE_SCRIPT:
        case USAGE_GRAPHICS_TEXTURE:
            break;
        default:
            throw new RSIllegalArgumentException("Source must be exactly one usage type.");
        }
        mRS.validate();
        mRS.nAllocationSyncAll(getIDSafe(), srcLocation);
static TypetypeFromBitmap(RenderScript rs, android.graphics.Bitmap b, android.support.v8.renderscript.Allocation$MipmapControl mip)

        Element e = elementFromBitmap(rs, b);
        Type.Builder tb = new Type.Builder(rs, e);
        tb.setX(b.getWidth());
        tb.setY(b.getHeight());
        tb.setMipmaps(mip == MipmapControl.MIPMAP_FULL);
        return tb.create();
private voidupdateCacheInfo(Type t)

        mCurrentDimX = t.getX();
        mCurrentDimY = t.getY();
        mCurrentDimZ = t.getZ();
        mCurrentCount = mCurrentDimX;
        if (mCurrentDimY > 1) {
            mCurrentCount *= mCurrentDimY;
        }
        if (mCurrentDimZ > 1) {
            mCurrentCount *= mCurrentDimZ;
        }
private voidvalidate2DRange(int xoff, int yoff, int w, int h)

        if (mAdaptedAllocation != null) {

        } else {

            if (xoff < 0 || yoff < 0) {
                throw new RSIllegalArgumentException("Offset cannot be negative.");
            }
            if (h < 0 || w < 0) {
                throw new RSIllegalArgumentException("Height or width cannot be negative.");
            }
            if (((xoff + w) > mCurrentDimX) || ((yoff + h) > mCurrentDimY)) {
                throw new RSIllegalArgumentException("Updated region larger than allocation.");
            }
        }
private voidvalidate3DRange(int xoff, int yoff, int zoff, int w, int h, int d)

        if (mAdaptedAllocation != null) {

        } else {

            if (xoff < 0 || yoff < 0 || zoff < 0) {
                throw new RSIllegalArgumentException("Offset cannot be negative.");
            }
            if (h < 0 || w < 0 || d < 0) {
                throw new RSIllegalArgumentException("Height or width cannot be negative.");
            }
            if (((xoff + w) > mCurrentDimX) || ((yoff + h) > mCurrentDimY) || ((zoff + d) > mCurrentDimZ)) {
                throw new RSIllegalArgumentException("Updated region larger than allocation.");
            }
        }
private voidvalidateBitmapFormat(android.graphics.Bitmap b)

        Bitmap.Config bc = b.getConfig();
        if (bc == null) {
            throw new RSIllegalArgumentException("Bitmap has an unsupported format for this operation");
        }
        switch (bc) {
        case ALPHA_8:
            if (mType.getElement().mKind != Element.DataKind.PIXEL_A) {
                throw new RSIllegalArgumentException("Allocation kind is " +
                                                     mType.getElement().mKind + ", type " +
                                                     mType.getElement().mType +
                                                     " of " + mType.getElement().getBytesSize() +
                                                     " bytes, passed bitmap was " + bc);
            }
            break;
        case ARGB_8888:
            if ((mType.getElement().mKind != Element.DataKind.PIXEL_RGBA) ||
                (mType.getElement().getBytesSize() != 4)) {
                throw new RSIllegalArgumentException("Allocation kind is " +
                                                     mType.getElement().mKind + ", type " +
                                                     mType.getElement().mType +
                                                     " of " + mType.getElement().getBytesSize() +
                                                     " bytes, passed bitmap was " + bc);
            }
            break;
        case RGB_565:
            if ((mType.getElement().mKind != Element.DataKind.PIXEL_RGB) ||
                (mType.getElement().getBytesSize() != 2)) {
                throw new RSIllegalArgumentException("Allocation kind is " +
                                                     mType.getElement().mKind + ", type " +
                                                     mType.getElement().mType +
                                                     " of " + mType.getElement().getBytesSize() +
                                                     " bytes, passed bitmap was " + bc);
            }
            break;
        case ARGB_4444:
            if ((mType.getElement().mKind != Element.DataKind.PIXEL_RGBA) ||
                (mType.getElement().getBytesSize() != 2)) {
                throw new RSIllegalArgumentException("Allocation kind is " +
                                                     mType.getElement().mKind + ", type " +
                                                     mType.getElement().mType +
                                                     " of " + mType.getElement().getBytesSize() +
                                                     " bytes, passed bitmap was " + bc);
            }
            break;

        }
private voidvalidateBitmapSize(android.graphics.Bitmap b)

        if((mCurrentDimX != b.getWidth()) || (mCurrentDimY != b.getHeight())) {
            throw new RSIllegalArgumentException("Cannot update allocation from bitmap, sizes mismatch");
        }
private voidvalidateIsFloat32()

        if (mType.mElement.mType == Element.DataType.FLOAT_32) {
            return;
        }
        throw new RSIllegalArgumentException(
            "32 bit float source does not match allocation type " + mType.mElement.mType);
private voidvalidateIsInt16()

        if ((mType.mElement.mType == Element.DataType.SIGNED_16) ||
            (mType.mElement.mType == Element.DataType.UNSIGNED_16)) {
            return;
        }
        throw new RSIllegalArgumentException(
            "16 bit integer source does not match allocation type " + mType.mElement.mType);
private voidvalidateIsInt32()

        if ((mType.mElement.mType == Element.DataType.SIGNED_32) ||
            (mType.mElement.mType == Element.DataType.UNSIGNED_32)) {
            return;
        }
        throw new RSIllegalArgumentException(
            "32 bit integer source does not match allocation type " + mType.mElement.mType);
private voidvalidateIsInt8()

        if ((mType.mElement.mType == Element.DataType.SIGNED_8) ||
            (mType.mElement.mType == Element.DataType.UNSIGNED_8)) {
            return;
        }
        throw new RSIllegalArgumentException(
            "8 bit integer source does not match allocation type " + mType.mElement.mType);
private voidvalidateIsObject()

        if ((mType.mElement.mType == Element.DataType.RS_ELEMENT) ||
            (mType.mElement.mType == Element.DataType.RS_TYPE) ||
            (mType.mElement.mType == Element.DataType.RS_ALLOCATION) ||
            (mType.mElement.mType == Element.DataType.RS_SAMPLER) ||
            (mType.mElement.mType == Element.DataType.RS_SCRIPT)) {
            return;
        }
        throw new RSIllegalArgumentException(
            "Object source does not match allocation type " + mType.mElement.mType);