path: root/docs/html/guide/topics/renderscript/reference/rs_object_info.jd

page.title=RenderScript Object Characteristics Functions

@jd:body

<div class='renderscript'>
<h2>Overview</h2>
<p> The functions below can be used to query the characteristics of an Allocation, Element,
or Sampler object.  These objects are created from Java.  You can't create them from a
script.
</p>

<p> <h5>Allocations:</h5>
</p>

<p> Allocations are the primary method used to pass data to and from RenderScript kernels.
</p>

<p> They are a structured collection of cells that can be used to store bitmaps, textures,
arbitrary data points, etc.
</p>

<p> This collection of cells may have many dimensions (X, Y, Z, Array0, Array1, Array2, Array3),
faces (for cubemaps), and level of details (for mipmapping).
</p>

<p> See the <a href='http://developer.android.com/reference/android/renderscript/Allocation.html'>android.renderscript.Allocation</a> for details on to create Allocations.
</p>

<p> <h5>Elements:</h5>
</p>

<p> The term "element" is used a bit ambiguously in RenderScript, as both type information
for the cells of an Allocation and the instantiation of that type.  For example:<ul>
<li><a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> is a handle to a type specification, and</li>
<li>In functions like <a href='rs_allocation_data.html#android_rs:rsGetElementAt'>rsGetElementAt</a>(), "element" means the instantiation of the type,
    i.e. a cell of an Allocation.</li></ul>
</p>

<p> The functions below let you query the characteristics of the type specificiation.
</p>

<p> An Element can specify a simple data types as found in C, e.g. an integer, float, or
boolean.  It can also specify a handle to a RenderScript object.  See <a href='rs_object_types.html#android_rs:rs_data_type'>rs_data_type</a> for
a list of basic types.
</p>

<p> Elements can specify fixed size vector (of size 2, 3, or 4) versions of the basic types.
Elements can be grouped together into complex Elements, creating the equivalent of
C structure definitions.
</p>

<p> Elements can also have a kind, which is semantic information used to interpret pixel
data.  See <a href='rs_object_types.html#android_rs:rs_data_kind'>rs_data_kind</a>.
</p>

<p> When creating Allocations of common elements, you can simply use one of the many predefined
Elements like <a href='http://developer.android.com/reference/android/renderscript/Element.html#F32_2(android.renderscript.RenderScript)'>F32_2</a>.
</p>

<p> To create complex Elements, use the <a href='http://developer.android.com/reference/android/renderscript/Element.Builder.html'>Element.Builder</a> Java class.
</p>

<p> <h5>Samplers:</h5>
</p>

<p> Samplers objects define how Allocations can be read as structure within a kernel.
See <a href='http://developer.android.com/reference/android/renderscript/Sampler.html'>android.renderscript.S</a>.
</p>
<h2>Summary</h2>
<table class='jd-sumtable'><tbody>
  <tr><th colspan='2'>Functions</th></tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsAllocationGetDimFaces'>rsAllocationGetDimFaces</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Presence of more than one face
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsAllocationGetDimLOD'>rsAllocationGetDimLOD</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Presence of levels of detail
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsAllocationGetDimX'>rsAllocationGetDimX</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Size of the X dimension
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsAllocationGetDimY'>rsAllocationGetDimY</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Size of the Y dimension
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsAllocationGetDimZ'>rsAllocationGetDimZ</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Size of the Z dimension
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsAllocationGetElement'>rsAllocationGetElement</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Get the object that describes the cell of an Allocation
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsClearObject'>rsClearObject</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Release an object
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsElementGetBytesSize'>rsElementGetBytesSize</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Size of an Element
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsElementGetDataKind'>rsElementGetDataKind</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Kind of an Element
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsElementGetDataType'>rsElementGetDataType</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Data type of an Element
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsElementGetSubElement'>rsElementGetSubElement</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Sub-element of a complex Element
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsElementGetSubElementArraySize'>rsElementGetSubElementArraySize</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Array size of a sub-element of a complex Element
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsElementGetSubElementCount'>rsElementGetSubElementCount</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Number of sub-elements
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsElementGetSubElementName'>rsElementGetSubElementName</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Name of a sub-element
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsElementGetSubElementNameLength'>rsElementGetSubElementNameLength</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Length of the name of a sub-element
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsElementGetSubElementOffsetBytes'>rsElementGetSubElementOffsetBytes</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Offset of the instantiated sub-element
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsElementGetVectorSize'>rsElementGetVectorSize</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Vector size of the Element
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsIsObject'>rsIsObject</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Check for an empty handle
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsSamplerGetAnisotropy'>rsSamplerGetAnisotropy</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Anisotropy of the Sampler
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsSamplerGetMagnification'>rsSamplerGetMagnification</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Sampler magnification value
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsSamplerGetMinification'>rsSamplerGetMinification</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Sampler minification value
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsSamplerGetWrapS'>rsSamplerGetWrapS</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Sampler wrap S value
    </td>
  </tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsSamplerGetWrapT'>rsSamplerGetWrapT</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      Sampler wrap T value
    </td>
  </tr>
</tbody></table>
<table class='jd-sumtable'><tbody>
  <tr><th colspan='2'>Deprecated Functions</th></tr>
  <tr class='alt-color api apilevel-1'>
    <td class='jd-linkcol'>
      <a href='rs_object_info.html#android_rs:rsGetAllocation'>rsGetAllocation</a>
    </td>
    <td class='jd-descrcol' width='100%'>
      <b>Deprecated</b>.  Return the Allocation for a given pointer
    </td>
  </tr>
</tbody></table>
<h2>Functions</h2>
<a name='android_rs:rsAllocationGetDimFaces'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsAllocationGetDimFaces</span>
    <span class='normal'>: Presence of more than one face</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> rsAllocationGetDimFaces(<a href='rs_object_types.html#android_rs:rs_allocation'>rs_allocation</a> a);
</td>
        <td>        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Returns</h5>
    <table class='jd-tagtable'><tbody>
    <tr><td>Returns 1 if more than one face is present, 0 otherwise.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> If the Allocation is a cubemap, this function returns 1 if there's more than one face
present.  In all other cases, it returns 0.
</p>

<p> Use <a href='rs_for_each.html#android_rs:rsGetDimHasFaces'>rsGetDimHasFaces</a>() to get the dimension of a currently running kernel.
</p>
  </div>
</div>

<a name='android_rs:rsAllocationGetDimLOD'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsAllocationGetDimLOD</span>
    <span class='normal'>: Presence of levels of detail</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> rsAllocationGetDimLOD(<a href='rs_object_types.html#android_rs:rs_allocation'>rs_allocation</a> a);
</td>
        <td>        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Returns</h5>
    <table class='jd-tagtable'><tbody>
    <tr><td>Returns 1 if more than one LOD is present, 0 otherwise.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Query an Allocation for the presence of more than one Level Of Detail.  This is useful
for mipmaps.
</p>

<p> Use <a href='rs_for_each.html#android_rs:rsGetDimLod'>rsGetDimLod</a>() to get the dimension of a currently running kernel.
</p>
  </div>
</div>

<a name='android_rs:rsAllocationGetDimX'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsAllocationGetDimX</span>
    <span class='normal'>: Size of the X dimension</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> rsAllocationGetDimX(<a href='rs_object_types.html#android_rs:rs_allocation'>rs_allocation</a> a);
</td>
        <td>        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Returns</h5>
    <table class='jd-tagtable'><tbody>
    <tr><td>X dimension of the Allocation.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Returns the size of the X dimension of the Allocation.
</p>

<p> Use <a href='rs_for_each.html#android_rs:rsGetDimX'>rsGetDimX</a>() to get the dimension of a currently running kernel.
</p>
  </div>
</div>

<a name='android_rs:rsAllocationGetDimY'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsAllocationGetDimY</span>
    <span class='normal'>: Size of the Y dimension</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> rsAllocationGetDimY(<a href='rs_object_types.html#android_rs:rs_allocation'>rs_allocation</a> a);
</td>
        <td>        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Returns</h5>
    <table class='jd-tagtable'><tbody>
    <tr><td>Y dimension of the Allocation.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Returns the size of the Y dimension of the Allocation.  If the Allocation has less
than two dimensions, returns 0.
</p>

<p> Use <a href='rs_for_each.html#android_rs:rsGetDimY'>rsGetDimY</a>() to get the dimension of a currently running kernel.
</p>
  </div>
</div>

<a name='android_rs:rsAllocationGetDimZ'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsAllocationGetDimZ</span>
    <span class='normal'>: Size of the Z dimension</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> rsAllocationGetDimZ(<a href='rs_object_types.html#android_rs:rs_allocation'>rs_allocation</a> a);
</td>
        <td>        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Returns</h5>
    <table class='jd-tagtable'><tbody>
    <tr><td>Z dimension of the Allocation.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Returns the size of the Z dimension of the Allocation.  If the Allocation has less
than three dimensions, returns 0.
</p>

<p> Use <a href='rs_for_each.html#android_rs:rsGetDimZ'>rsGetDimZ</a>() to get the dimension of a currently running kernel.
</p>
  </div>
</div>

<a name='android_rs:rsAllocationGetElement'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsAllocationGetElement</span>
    <span class='normal'>: Get the object that describes the cell of an Allocation</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> rsAllocationGetElement(<a href='rs_object_types.html#android_rs:rs_allocation'>rs_allocation</a> a);
</td>
        <td>        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Parameters</h5>
    <table class='jd-tagtable'><tbody>
    <tr><th>a</th><td>Allocation to get data from.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Returns</h5>
    <table class='jd-tagtable'><tbody>
    <tr><td>Element describing Allocation layout.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Get the Element object describing the type, kind, and other characteristics of a cell
of an Allocation.  See the rsElement* functions below.
</p>
  </div>
</div>

<a name='android_rs:rsClearObject'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsClearObject</span>
    <span class='normal'>: Release an object</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td>void rsClearObject(<a href='rs_object_types.html#android_rs:rs_allocation'>rs_allocation</a>* dst);
</td>
        <td>        </td>
      </tr>
      <tr>
        <td>void rsClearObject(<a href='rs_object_types.html#android_rs:rs_element'>rs_element</a>* dst);
</td>
        <td>        </td>
      </tr>
      <tr>
        <td>void rsClearObject(<a href='rs_graphics.html#android_rs:rs_font'>rs_font</a>* dst);
</td>
        <td>    When compiling for 32 bits. Removed from <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 23 and higher</a>
        </td>
      </tr>
      <tr>
        <td>void rsClearObject(<a href='rs_graphics.html#android_rs:rs_mesh'>rs_mesh</a>* dst);
</td>
        <td>    When compiling for 32 bits. Removed from <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 23 and higher</a>
        </td>
      </tr>
      <tr>
        <td>void rsClearObject(<a href='rs_graphics.html#android_rs:rs_program_fragment'>rs_program_fragment</a>* dst);
</td>
        <td>    When compiling for 32 bits. Removed from <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 23 and higher</a>
        </td>
      </tr>
      <tr>
        <td>void rsClearObject(<a href='rs_graphics.html#android_rs:rs_program_raster'>rs_program_raster</a>* dst);
</td>
        <td>    When compiling for 32 bits. Removed from <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 23 and higher</a>
        </td>
      </tr>
      <tr>
        <td>void rsClearObject(<a href='rs_graphics.html#android_rs:rs_program_store'>rs_program_store</a>* dst);
</td>
        <td>    When compiling for 32 bits. Removed from <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 23 and higher</a>
        </td>
      </tr>
      <tr>
        <td>void rsClearObject(<a href='rs_graphics.html#android_rs:rs_program_vertex'>rs_program_vertex</a>* dst);
</td>
        <td>    When compiling for 32 bits. Removed from <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 23 and higher</a>
        </td>
      </tr>
      <tr>
        <td>void rsClearObject(<a href='rs_object_types.html#android_rs:rs_sampler'>rs_sampler</a>* dst);
</td>
        <td>        </td>
      </tr>
      <tr>
        <td>void rsClearObject(<a href='rs_object_types.html#android_rs:rs_script'>rs_script</a>* dst);
</td>
        <td>        </td>
      </tr>
      <tr>
        <td>void rsClearObject(<a href='rs_object_types.html#android_rs:rs_type'>rs_type</a>* dst);
</td>
        <td>        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Tells the run time that this handle will no longer be used to access the the related
object.  If this was the last handle to that object, resource recovery may happen.
</p>

<p> After calling this function, *dst will be set to an empty handle.  See <a href='rs_object_info.html#android_rs:rsIsObject'>rsIsObject</a>().
</p>
  </div>
</div>

<a name='android_rs:rsElementGetBytesSize'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsElementGetBytesSize</span>
    <span class='normal'>: Size of an Element</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> rsElementGetBytesSize(<a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> e);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Returns the size in bytes that an instantiation of this Element will occupy.
</p>
  </div>
</div>

<a name='android_rs:rsElementGetDataKind'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsElementGetDataKind</span>
    <span class='normal'>: Kind of an Element</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_object_types.html#android_rs:rs_data_kind'>rs_data_kind</a> rsElementGetDataKind(<a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> e);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Returns the Element's data kind.  This is used to interpret pixel data.
</p>

<p> See <a href='rs_object_types.html#android_rs:rs_data_kind'>rs_data_kind</a>.
</p>
  </div>
</div>

<a name='android_rs:rsElementGetDataType'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsElementGetDataType</span>
    <span class='normal'>: Data type of an Element</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_object_types.html#android_rs:rs_data_type'>rs_data_type</a> rsElementGetDataType(<a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> e);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Returns the Element's base data type.  This can be a type similar to C/C++ (e.g.
RS_TYPE_UNSIGNED_8), a handle (e.g. RS_TYPE_ALLOCATION and RS_TYPE_ELEMENT), or a
more complex numerical type (e.g. RS_TYPE_UNSIGNED_5_6_5 and RS_TYPE_MATRIX_4X4).
See <a href='rs_object_types.html#android_rs:rs_data_type'>rs_data_type</a>.
</p>

<p> If the Element describes a vector, this function returns the data type of one of its items.
Use <a href='rs_object_info.html#android_rs:rsElementGetVectorSize'>rsElementGetVectorSize</a> to get the size of the vector.
</p>

<p> If the Element describes a structure, RS_TYPE_NONE is returned.  Use the rsElementGetSub*
functions to explore this complex Element.
</p>
  </div>
</div>

<a name='android_rs:rsElementGetSubElement'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsElementGetSubElement</span>
    <span class='normal'>: Sub-element of a complex Element</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> rsElementGetSubElement(<a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> e, <a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> index);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Parameters</h5>
    <table class='jd-tagtable'><tbody>
    <tr><th>e</th><td>Element to query.</td></tr>
    <tr><th>index</th><td>Index of the sub-element to return.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Returns</h5>
    <table class='jd-tagtable'><tbody>
    <tr><td>Sub-element at the given index.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> For Elements that represents a structure, this function returns the sub-element at the
specified index.
</p>

<p> If the Element is not a structure or the index is greater or equal to the number of
sub-elements, an invalid handle is returned.
</p>
  </div>
</div>

<a name='android_rs:rsElementGetSubElementArraySize'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsElementGetSubElementArraySize</span>
    <span class='normal'>: Array size of a sub-element of a complex Element</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> rsElementGetSubElementArraySize(<a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> e, <a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> index);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Parameters</h5>
    <table class='jd-tagtable'><tbody>
    <tr><th>e</th><td>Element to query.</td></tr>
    <tr><th>index</th><td>Index of the sub-element.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Returns</h5>
    <table class='jd-tagtable'><tbody>
    <tr><td>Array size of the sub-element.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> For complex Elements, sub-elements can be statically sized arrays.  This function
returns the array size of the sub-element at the index.  This sub-element repetition
is different than fixed size vectors.
</p>
  </div>
</div>

<a name='android_rs:rsElementGetSubElementCount'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsElementGetSubElementCount</span>
    <span class='normal'>: Number of sub-elements</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> rsElementGetSubElementCount(<a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> e);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Parameters</h5>
    <table class='jd-tagtable'><tbody>
    <tr><th>e</th><td>Element to get data from.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Returns</h5>
    <table class='jd-tagtable'><tbody>
    <tr><td>Number of sub-elements.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Elements can be simple, such as an int or a float, or a structure with multiple
sub-elements.  This function returns zero for simple Elements and the number of
sub-elements for complex Elements.
</p>
  </div>
</div>

<a name='android_rs:rsElementGetSubElementName'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsElementGetSubElementName</span>
    <span class='normal'>: Name of a sub-element</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> rsElementGetSubElementName(<a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> e, <a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> index, char* name, <a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> nameLength);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Parameters</h5>
    <table class='jd-tagtable'><tbody>
    <tr><th>e</th><td>Element to get data from.</td></tr>
    <tr><th>index</th><td>Index of the sub-element.</td></tr>
    <tr><th>name</th><td>Address of the array to store the name into.</td></tr>
    <tr><th>nameLength</th><td>Length of the provided name array.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Returns</h5>
    <table class='jd-tagtable'><tbody>
    <tr><td>Number of characters copied, excluding the null terminator.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> For complex Elements, this function returns the name of the sub-element at the
specified index.
</p>
  </div>
</div>

<a name='android_rs:rsElementGetSubElementNameLength'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsElementGetSubElementNameLength</span>
    <span class='normal'>: Length of the name of a sub-element</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> rsElementGetSubElementNameLength(<a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> e, <a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> index);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Parameters</h5>
    <table class='jd-tagtable'><tbody>
    <tr><th>e</th><td>Element to get data from.</td></tr>
    <tr><th>index</th><td>Index of the sub-element.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Returns</h5>
    <table class='jd-tagtable'><tbody>
    <tr><td>Length of the sub-element name including the null terminator.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> For complex Elements, this function returns the length of the name of the sub-element
at the specified index.
</p>
  </div>
</div>

<a name='android_rs:rsElementGetSubElementOffsetBytes'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsElementGetSubElementOffsetBytes</span>
    <span class='normal'>: Offset of the instantiated sub-element</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> rsElementGetSubElementOffsetBytes(<a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> e, <a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> index);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Parameters</h5>
    <table class='jd-tagtable'><tbody>
    <tr><th>e</th><td>Element to get data from.</td></tr>
    <tr><th>index</th><td>Index of the sub-element.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Returns</h5>
    <table class='jd-tagtable'><tbody>
    <tr><td>Offset in bytes.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> This function returns the relative position of the instantiation of the specified
sub-element within the instantiation of the Element.
</p>

<p> For example, if the Element describes a 32 bit float followed by a 32 bit integer,
the offset return for the first will be 0 and the second 4.
</p>
  </div>
</div>

<a name='android_rs:rsElementGetVectorSize'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsElementGetVectorSize</span>
    <span class='normal'>: Vector size of the Element</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_value_types.html#android_rs:uint32_t'>uint32_t</a> rsElementGetVectorSize(<a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> e);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Parameters</h5>
    <table class='jd-tagtable'><tbody>
    <tr><th>e</th><td>Element to get data from.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata'>    <h5 class='jd-tagtitle'>Returns</h5>
    <table class='jd-tagtable'><tbody>
    <tr><td>Length of the element vector.</td></tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Returns the Element's vector size.  If the Element does not represent a vector,
1 is returned.
</p>
  </div>
</div>

<a name='android_rs:rsGetAllocation'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsGetAllocation</span>
    <span class='normal'>: Return the Allocation for a given pointer</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_object_types.html#android_rs:rs_allocation'>rs_allocation</a> rsGetAllocation(const void* p);
</td>
        <td>        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
    <p><b>Deprecated.</b>  This function is deprecated and will be removed from the SDK in a future release.</p>
<p> Returns the Allocation for a given pointer.  The pointer should point within a valid
allocation.  The results are undefined if the pointer is not from a valid Allocation.
</p>
  </div>
</div>

<a name='android_rs:rsIsObject'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsIsObject</span>
    <span class='normal'>: Check for an empty handle</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td>bool rsIsObject(<a href='rs_object_types.html#android_rs:rs_allocation'>rs_allocation</a> v);
</td>
        <td>        </td>
      </tr>
      <tr>
        <td>bool rsIsObject(<a href='rs_object_types.html#android_rs:rs_element'>rs_element</a> v);
</td>
        <td>        </td>
      </tr>
      <tr>
        <td>bool rsIsObject(<a href='rs_graphics.html#android_rs:rs_font'>rs_font</a> v);
</td>
        <td>    When compiling for 32 bits. Removed from <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 23 and higher</a>
        </td>
      </tr>
      <tr>
        <td>bool rsIsObject(<a href='rs_graphics.html#android_rs:rs_mesh'>rs_mesh</a> v);
</td>
        <td>    When compiling for 32 bits. Removed from <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 23 and higher</a>
        </td>
      </tr>
      <tr>
        <td>bool rsIsObject(<a href='rs_graphics.html#android_rs:rs_program_fragment'>rs_program_fragment</a> v);
</td>
        <td>    When compiling for 32 bits. Removed from <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 23 and higher</a>
        </td>
      </tr>
      <tr>
        <td>bool rsIsObject(<a href='rs_graphics.html#android_rs:rs_program_raster'>rs_program_raster</a> v);
</td>
        <td>    When compiling for 32 bits. Removed from <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 23 and higher</a>
        </td>
      </tr>
      <tr>
        <td>bool rsIsObject(<a href='rs_graphics.html#android_rs:rs_program_store'>rs_program_store</a> v);
</td>
        <td>    When compiling for 32 bits. Removed from <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 23 and higher</a>
        </td>
      </tr>
      <tr>
        <td>bool rsIsObject(<a href='rs_graphics.html#android_rs:rs_program_vertex'>rs_program_vertex</a> v);
</td>
        <td>    When compiling for 32 bits. Removed from <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 23 and higher</a>
        </td>
      </tr>
      <tr>
        <td>bool rsIsObject(<a href='rs_object_types.html#android_rs:rs_sampler'>rs_sampler</a> v);
</td>
        <td>        </td>
      </tr>
      <tr>
        <td>bool rsIsObject(<a href='rs_object_types.html#android_rs:rs_script'>rs_script</a> v);
</td>
        <td>        </td>
      </tr>
      <tr>
        <td>bool rsIsObject(<a href='rs_object_types.html#android_rs:rs_type'>rs_type</a> v);
</td>
        <td>        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Returns true if the handle contains a non-null reference.
</p>

<p> This function does not validate that the internal pointer used in the handle
points to an actual valid object; it only checks for null.
</p>

<p> This function can be used to check the Element returned by <a href='rs_object_info.html#android_rs:rsElementGetSubElement'>rsElementGetSubElement</a>()
or see if <a href='rs_object_info.html#android_rs:rsClearObject'>rsClearObject</a>() has been called on a handle.
</p>
  </div>
</div>

<a name='android_rs:rsSamplerGetAnisotropy'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsSamplerGetAnisotropy</span>
    <span class='normal'>: Anisotropy of the Sampler</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td>float rsSamplerGetAnisotropy(<a href='rs_object_types.html#android_rs:rs_sampler'>rs_sampler</a> s);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Get the Sampler's anisotropy.
</p>

<p> See <a href='http://developer.android.com/reference/android/renderscript/Sampler.html'>android.renderscript.S</a>.
</p>
  </div>
</div>

<a name='android_rs:rsSamplerGetMagnification'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsSamplerGetMagnification</span>
    <span class='normal'>: Sampler magnification value</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_object_types.html#android_rs:rs_sampler_value'>rs_sampler_value</a> rsSamplerGetMagnification(<a href='rs_object_types.html#android_rs:rs_sampler'>rs_sampler</a> s);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Get the Sampler's magnification value.
</p>

<p> See <a href='http://developer.android.com/reference/android/renderscript/Sampler.html'>android.renderscript.S</a>.
</p>
  </div>
</div>

<a name='android_rs:rsSamplerGetMinification'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsSamplerGetMinification</span>
    <span class='normal'>: Sampler minification value</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_object_types.html#android_rs:rs_sampler_value'>rs_sampler_value</a> rsSamplerGetMinification(<a href='rs_object_types.html#android_rs:rs_sampler'>rs_sampler</a> s);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Get the Sampler's minification value.
</p>

<p> See <a href='http://developer.android.com/reference/android/renderscript/Sampler.html'>android.renderscript.S</a>.
</p>
  </div>
</div>

<a name='android_rs:rsSamplerGetWrapS'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsSamplerGetWrapS</span>
    <span class='normal'>: Sampler wrap S value</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_object_types.html#android_rs:rs_sampler_value'>rs_sampler_value</a> rsSamplerGetWrapS(<a href='rs_object_types.html#android_rs:rs_sampler'>rs_sampler</a> s);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Get the Sampler's wrap S value.
</p>

<p> See <a href='http://developer.android.com/reference/android/renderscript/Sampler.html'>android.renderscript.S</a>.
</p>
  </div>
</div>

<a name='android_rs:rsSamplerGetWrapT'></a>
<div class='jd-details'>
  <h4 class='jd-details-title'>
    <span class='sympad'>rsSamplerGetWrapT</span>
    <span class='normal'>: Sampler wrap T value</span>
  </h4>
  <div class='jd-details-descr'>
    <table class='jd-tagtable'><tbody>
      <tr>
        <td><a href='rs_object_types.html#android_rs:rs_sampler_value'>rs_sampler_value</a> rsSamplerGetWrapT(<a href='rs_object_types.html#android_rs:rs_sampler'>rs_sampler</a> s);
</td>
        <td>    Added in <a href='http://developer.android.com/guide/topics/manifest/uses-sdk-element.html#ApiLevels'>API level 16</a>
        </td>
      </tr>
    </tbody></table>
  </div>
  <div class='jd-tagdata jd-tagdescr'>
<p> Get the sampler's wrap T value.
</p>

<p> See <a href='http://developer.android.com/reference/android/renderscript/Sampler.html'>android.renderscript.S</a>.
</p>
  </div>
</div>

</div>