public static final class ScriptGroup.Builder
extends Object
java.lang.Object | |
↳ | android.renderscript.ScriptGroup.Builder |
This class was deprecated in API level 23.
Use ScriptGroup.Builder2
instead.
Helper class to build a ScriptGroup. A ScriptGroup is created in two steps.
First, all kernels to be used by the ScriptGroup should be added.
Second, add connections between kernels. There are two types of connections: kernel to kernel and kernel to field. Kernel to kernel allows a kernel's output to be passed to another kernel as input. Kernel to field allows the output of one kernel to be bound as a script global. Kernel to kernel is higher performance and should be used where possible.
A ScriptGroup must contain a single directed acyclic graph (DAG); it cannot contain cycles. Currently, all kernels used in a ScriptGroup must come from different Script objects. Additionally, all kernels in a ScriptGroup must have at least one input, output, or internal connection.
Once all connections are made, a call to create()
will return the ScriptGroup object.
Public constructors |
|
---|---|
ScriptGroup.Builder(RenderScript rs) Create a Builder for generating a ScriptGroup. |
Public methods |
|
---|---|
ScriptGroup.Builder |
addConnection(Type t, Script.KernelID from, Script.FieldID to) Adds a connection to the group. |
ScriptGroup.Builder |
addConnection(Type t, Script.KernelID from, Script.KernelID to) Adds a connection to the group. |
ScriptGroup.Builder |
addKernel(Script.KernelID k) Adds a Kernel to the group. |
ScriptGroup |
create() Creates the Script group. |
Inherited methods |
|
---|---|
![]() java.lang.Object
|
ScriptGroup.Builder (RenderScript rs)
Create a Builder for generating a ScriptGroup.
Parameters | |
---|---|
rs |
RenderScript : The RenderScript context. |
ScriptGroup.Builder addConnection (Type t, Script.KernelID from, Script.FieldID to)
Adds a connection to the group.
Parameters | |
---|---|
t |
Type : The type of the connection. This is used to determine the kernel launch sizes on the source side of this connection. |
from |
Script.KernelID : The source for the connection. |
to |
Script.FieldID : The destination of the connection. |
Returns | |
---|---|
ScriptGroup.Builder |
Builder Returns this |
ScriptGroup.Builder addConnection (Type t, Script.KernelID from, Script.KernelID to)
Adds a connection to the group.
Parameters | |
---|---|
t |
Type : The type of the connection. This is used to determine the kernel launch sizes for both sides of this connection. |
from |
Script.KernelID : The source for the connection. |
to |
Script.KernelID : The destination of the connection. |
Returns | |
---|---|
ScriptGroup.Builder |
Builder Returns this |
ScriptGroup.Builder addKernel (Script.KernelID k)
Adds a Kernel to the group.
Parameters | |
---|---|
k |
Script.KernelID : The kernel to add. |
Returns | |
---|---|
ScriptGroup.Builder |
Builder Returns this. |
ScriptGroup create ()
Creates the Script group.
Returns | |
---|---|
ScriptGroup |
ScriptGroup The new ScriptGroup |