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, Script.LaunchOptions opt)
Process an input buffer and place the histogram into the output allocation.
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.
void forEach_Dot(Allocation ain, Script.LaunchOptions opt)
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)

Added in API level 19

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, Script.LaunchOptions opt)

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
opt LaunchOptions for clipping

public void forEach (Allocation ain)

Added in API level 19

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)

Added in API level 19

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 void forEach_Dot (Allocation ain, Script.LaunchOptions opt)

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
opt LaunchOptions for clipping

public Script.FieldID getFieldID_Input ()

Added in API level 19

Get a FieldID for the input field of this intrinsic.

Returns
  • Script.FieldID The FieldID object.

public Script.KernelID getKernelID_Separate ()

Added in API level 19

Get a KernelID for this intrinsic kernel.

Returns
  • Script.KernelID The KernelID object.

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

Added in API level 19

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)

Added in API level 19

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

Parameters
aout The output allocation