Allocation

The Allocation will be used as a texture source by one or more graphics programs.

The Allocation will be used as a SurfaceTexture consumer. This usage will cause the Allocation to be created as read-only.

The Allocation will be used as a SurfaceTexture producer. The dimensions and format of the SurfaceTexture will be forced to those of the Allocation.

The Allocation will be bound to and accessed by scripts.

The Allocation's backing store will be inherited from another object (usually a Bitmap); copying to or from the original source Bitmap will cause a synchronization rather than a full copy. syncAll(int) may also be used to synchronize the Allocation and the source Bitmap.

This is set by default for allocations created with createFromBitmap(RenderScript, Bitmap) in API version 18 and higher.

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.

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.

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.

Copy part of an Allocation into this Allocation.

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.

Copy an array into part of this Allocation. This method does not guarantee that the Allocation is compatible with the input buffer.

Copy an array into part of this Allocation. This method does not guarantee that the Allocation is compatible with the input buffer.

Copy an array into part of this Allocation. This method does not guarantee that the Allocation is compatible with the input buffer.

Copy an array into part of this Allocation. This method does not guarantee that the Allocation is compatible with the input buffer.

Copy from an array into a rectangular region in this Allocation. The array is assumed to be tightly packed.

Copy from an array into a rectangular region in this Allocation. The array is assumed to be tightly packed.

Copy from an array into a rectangular region in this Allocation. The array is assumed to be tightly packed.

Copy from an array into a rectangular region in this Allocation. The array is assumed to be tightly packed.

Copy a Bitmap into an Allocation. The height and width of the update will use the height and width of the Bitmap.

Copy a rectangular region from an Allocation into a rectangular region in this Allocation.

Copy into this Allocation from an array. This variant is type checked and will generate exceptions if the Allocation's Element is not an 8 bit integer type.

Copy into this Allocation from an array. This variant is type checked and will generate exceptions if the Allocation's Element is not a 32 bit integer type.

Copy into this Allocation from an array. This variant is type checked and will generate exceptions if the Allocation's Element is not a 32 bit float type.

Copy an array of RS objects to the Allocation.

Copy an Allocation from an Allocation. The types of both allocations must be identical.

Copy into an Allocation from a Bitmap. The height, width, and format of the bitmap must match the existing allocation.

If the Bitmap is the same as the Bitmap used to create the Allocation with createFromBitmap(RenderScript, Bitmap) and USAGE_SHARED is set on the Allocation, this will synchronize the Allocation with the latest data from the Bitmap, potentially avoiding the actual copy.

Copy into this Allocation from an array. This variant is type checked and will generate exceptions if the Allocation's Element is not a 16 bit integer type.

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.

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.

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.

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.

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 Element type.

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 Element type.

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 Element type.

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 Element type.

Copy from the Allocation into a Bitmap. The bitmap must match the dimensions of the Allocation.

Creates a non-mipmapped cubemap Allocation for use as a graphics texture from a 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.

Creates a cubemap Allocation from a 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.

Creates a cubemap Allocation from 6 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.

Creates a non-mipmapped cubemap Allocation for use as a sampler input from 6 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.

Creates an Allocation from a Bitmap.

Creates an Allocation from a Bitmap.

This Allocation will be created with USAGE_SHARED, and USAGE_SCRIPT.

Creates a non-mipmapped Allocation to use as a graphics texture from the Bitmap referenced by resource ID.

This allocation will be created with USAGE_SCRIPT and USAGE_GRAPHICS_TEXTURE.

Creates an Allocation from the Bitmap referenced by resource ID.

Creates an Allocation containing string data encoded in UTF-8 format.

Creates an Allocation with a specified number of given elements

Creates an Allocation with a specified number of given elements

Creates an Allocation with the size specified by the type and no mipmaps generated by default

Creates an Allocation for use by scripts with a given Type and no mipmaps

Creates a new Allocation with the given Type, mipmap flag, and usage flags.

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 syncAll(Allocation.USAGE_SCRIPT) is required.

Get the size of the Allocation in bytes.

Get the Element of the Type of the Allocation.

Get the Type of the Allocation.

Get the usage flags of the Allocation.

Receive the latest input into the Allocation. This operation is only valid if USAGE_IO_INPUT is set on the Allocation.

Send a buffer to the output stream. The contents of the Allocation will be undefined after this operation. This operation is only valid if USAGE_IO_OUTPUT is set on the Allocation.

This is only intended to be used by auto-generated code reflected from the RenderScript script files and should not be used by developers.

This is only intended to be used by auto-generated code reflected from the RenderScript script files.

Propagate changes from one usage of the Allocation to the other usages of the Allocation.

Invoked when the garbage collector has detected that this instance is no longer reachable. The default implementation does nothing, but this method can be overridden to free resources.

Note that objects that override finalize are significantly more expensive than objects that don't. Finalizers may be run a long time after the object is no longer reachable, depending on memory pressure, so it's a bad idea to rely on them for cleanup. Note also that finalizers are run on a single VM-wide finalizer thread, so doing blocking work in a finalizer is a bad idea. A finalizer is usually only necessary for a class that has a native peer and needs to call a native method to destroy that peer. Even then, it's better to provide an explicit close method (and implement Closeable), and insist that callers manually dispose of instances. This works well for something like files, but less well for something like a BigInteger where typical calling code would have to deal with lots of temporaries. Unfortunately, code that creates lots of temporaries is the worst kind of code from the point of view of the single finalizer thread.

If you must use finalizers, consider at least providing your own ReferenceQueue and having your own thread process that queue.

Unlike constructors, finalizers are not automatically chained. You are responsible for calling super.finalize() yourself.

Uncaught exceptions thrown by finalizers are ignored and do not terminate the finalizer thread. See Effective Java Item 7, "Avoid finalizers" for more.