ScriptGroup.Builder2

public static final class ScriptGroup.Builder2
extends Object

The builder class for creating script groups

A script group is created using closures (see class Closure). A closure is a function call to a kernel or invocable function. Each function argument or global variable accessed inside the function is bound to 1) a known value, 2) a script group input (see class Input), or 3) a future (see class Future). A future is the output of a closure, either the return value of the function or a global variable written by that function.

Closures are created using the addKernel(KernelID, Type, Object) or addInvoke(InvokeID, Object) methods. When a closure is created, futures from previously created closures can be used as its inputs. External script group inputs can be used as inputs to individual closures as well. An external script group input is created using the addInput() method. A script group is created by a call to the create(String, Future) method, which accepts an array of futures as the outputs for the script group.

Closures in a script group can be evaluated in any order as long as the following conditions are met: 1) a closure must be evaluated before any other closures that take its futures as inputs; 2) all closures added before an invoke closure must be evaluated before it; and 3) all closures added after an invoke closure must be evaluated after it. As a special case, the order that the closures are added is a legal evaluation order. However, other evaluation orders are possible, including concurrently evaluating independent closures.

Summary

Public constructors

public Builder2 (RenderScript rs)

Public methods

public ScriptGroup.Input addInput ()

public ScriptGroup.Closure addInvoke (Script.InvokeID invoke, 
                Object... argsAndBindings)

public ScriptGroup.Closure addKernel (Script.KernelID k, 
                Type returnType, 
                Object... argsAndBindings)

public ScriptGroup create (String name, 
                Future... outputs)