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

ScriptIntrinsicHistogram

extends ScriptIntrinsic
java.lang.Object
   ↳ android.renderscript.BaseObj
     ↳ android.renderscript.Script
       ↳ android.renderscript.ScriptIntrinsic
         ↳ android.renderscript.ScriptIntrinsicHistogram

Class Overview

Intrinsic Histogram filter.

Summary

Public Methods
static ScriptIntrinsicHistogram create ( RenderScript rs, Element e)
Create an intrinsic for calculating the histogram of an uchar or uchar4 image.
void forEach ( Allocation ain)
Process an input buffer and place the histogram into the output allocation.
void forEach_Dot ( Allocation ain)
Process an input buffer and place the histogram into the output allocation.
Script.FieldID getFieldID_Input ()
Get a FieldID for the input field of this intrinsic.
Script.KernelID getKernelID_Separate ()
Get a KernelID for this intrinsic kernel.
void setDotCoefficients (float r, float g, float b, float a)
Set the coefficients used for the RGBA to Luminocity calculation.
void setOutput ( Allocation aout)
Set the output of the histogram.
[Expand]
Inherited Methods
From class android.renderscript.Script
From class android.renderscript.BaseObj
From class java.lang.Object

Public Methods

public static ScriptIntrinsicHistogram create ( RenderScript rs, Element e)

Create an intrinsic for calculating the histogram of an uchar or uchar4 image. Supported elements types are U8_4(RenderScript) , U8_3(RenderScript) , U8_2(RenderScript) , U8(RenderScript)

Parameters
rs The RenderScript context
e Element type for inputs
Returns
  • ScriptIntrinsicHistogram

public void forEach ( Allocation ain)

Process an input buffer and place the histogram into the output allocation. The output allocation may be a narrower vector size than the input. In this case the vector size of the output is used to determine how many of the input channels are used in the computation. This is useful if you have an RGBA input buffer but only want the histogram for RGB. 1D and 2D input allocations are supported.

Parameters
ain The input image

public void forEach_Dot ( Allocation ain)

Process an input buffer and place the histogram into the output allocation. The dot product of the input channel and the coefficients from 'setDotCoefficients' are used to calculate the output values. 1D and 2D input allocations are supported.

Parameters
ain The input image

public Script.FieldID getFieldID_Input ()

Get a FieldID for the input field of this intrinsic.

Returns
  • Script.FieldID The FieldID object.

public Script.KernelID getKernelID_Separate ()

Get a KernelID for this intrinsic kernel.

Returns
  • Script.KernelID The KernelID object.

public void setDotCoefficients (float r, float g, float b, float a)

Set the coefficients used for the RGBA to Luminocity calculation. The default is {0.299f, 0.587f, 0.114f, 0.f}. Coefficients must be >= 0 and sum to 1.0 or less.

Parameters
r Red coefficient
g Green coefficient
b Blue coefficient
a Alpha coefficient

public void setOutput ( Allocation aout)

Set the output of the histogram. 32 bit integer types are supported.

Parameters
aout The output allocation