Added in API level 17
Deprecated in API level 31

ScriptIntrinsicConvolve3x3


public final class ScriptIntrinsicConvolve3x3
extends ScriptIntrinsic

java.lang.Object
   ↳ android.renderscript.BaseObj
     ↳ android.renderscript.Script
       ↳ android.renderscript.ScriptIntrinsic
         ↳ android.renderscript.ScriptIntrinsicConvolve3x3


This class was deprecated in API level 31.
Renderscript has been deprecated in API level 31. Please refer to the migration guide for the proposed alternatives.

Intrinsic for applying a 3x3 convolve to an allocation.

Summary

Public methods

static ScriptIntrinsicConvolve3x3 create(RenderScript rs, Element e)

Supported elements types are Element.U8, Element.U8_2(RenderScript), Element.U8_3, Element.U8_4, Element.F32, Element.F32_2, Element.F32_3(RenderScript), and Element.F32_4.

void forEach(Allocation aout)

Apply the filter to the input and save to the specified allocation.

void forEach(Allocation aout, Script.LaunchOptions opt)

Apply the filter to the input and save to the specified allocation.

Script.FieldID getFieldID_Input()

Get a FieldID for the input field of this intrinsic.

Script.KernelID getKernelID()

Get a KernelID for this intrinsic kernel.

void setCoefficients(float[] v)

Set the coefficients for the convolve.

void setInput(Allocation ain)

Set the input of the 3x3 convolve.

Inherited methods

Public methods

create

Added in API level 17
public static ScriptIntrinsicConvolve3x3 create (RenderScript rs, 
                Element e)

Supported elements types are Element.U8, Element.U8_2(RenderScript), Element.U8_3, Element.U8_4, Element.F32, Element.F32_2, Element.F32_3(RenderScript), and Element.F32_4.

The default coefficients are:

[ 0, 0, 0 ]

[ 0, 1, 0 ]

[ 0, 0, 0 ]

Parameters
rs RenderScript: The RenderScript context

e Element: Element type for intputs and outputs

Returns
ScriptIntrinsicConvolve3x3 ScriptIntrinsicConvolve3x3

forEach

Added in API level 17
public void forEach (Allocation aout)

Apply the filter to the input and save to the specified allocation.

Parameters
aout Allocation: Output allocation. Must match creation element type.

forEach

Added in API level 21
Deprecated in API level 31
public void forEach (Allocation aout, 
                Script.LaunchOptions opt)

Apply the filter to the input and save to the specified allocation.

Parameters
aout Allocation: Output allocation. Must match creation element type.

opt Script.LaunchOptions: LaunchOptions for clipping

getFieldID_Input

Added in API level 17
public Script.FieldID getFieldID_Input ()

Get a FieldID for the input field of this intrinsic.

Returns
Script.FieldID Script.FieldID The FieldID object.

getKernelID

Added in API level 17
public Script.KernelID getKernelID ()

Get a KernelID for this intrinsic kernel.

Returns
Script.KernelID Script.KernelID The KernelID object.

setCoefficients

Added in API level 17
public void setCoefficients (float[] v)

Set the coefficients for the convolve.

The convolve layout is:

[ 0, 1, 2 ]

[ 3, 4, 5 ]

[ 6, 7, 8 ]

Parameters
v float: The array of coefficients to set

setInput

Added in API level 17
public void setInput (Allocation ain)

Set the input of the 3x3 convolve. Must match the element type supplied during create.

Parameters
ain Allocation: The input allocation.