HELP
An object that outputs an Array 1D.

USE
Use Collector to create an Array 1D from
Scalar input data.  When all the data is in
the array, activate the XEQ pin.

LOCATION
Data ==> Collector

OBJECT MENU
* Clear - Clears the contents of the
Collector.

* Clear at PreRun - Clears the contents of
the Collector at PreRun.  Default is on
(checked).

* Clear at Activate - Clears the contents of
the Collector at activate.  Default is on
(checked).

NOTES
Because XEQ is required on the Collector you
cannot add another trigger pin or delete it.

The Collector continues to collect the
input data until the XEQ pin is triggered.

Enum inputs are converted to type Text
before being placed into an array.

The Collector has two inputs; one for the
data coming in (any shape and type); the
other tells the device when to execute.  The
device accepts multiple input data hits on
the first data input pin, and collects the
data until the XEQ pin is hit.  Then the
device copies the full set of data to its
output pin and propagates its output.  The
output data pin is never propagated until the
XEQ pin is hit.  Once the XEQ pin is hit and
the data copied to the output pin, the
Collector clears its internal buffer and the
next data hit will start over, collecting
data.

The Collector takes the data coming into
its Data pin and collects it up into an Array
1D.  Scalar or Array 1D data is appended to
the end; multi-dimensional arrays are
flattened into an Array 1D and then appended.
The output type is determined by the type of
the first data container coming in after each
XEQ or Clear.  All subsequent containers are
coerced to the type of the first one.  If
coercion fails, an error is reported.

For example, if the data in is a scalar
Real value 1.2, then a scalar Int32 value 34,
then XEQ is hit, it will output a Real Array
1D, two long, with the values [1.2 34.0].
Then, if it is hit with several Complex data
containers, it will output a Complex Array
1D.

The Collector starts out from an
Open/Merge/ menu pick with its internal
buffer cleared.  It clears its internal
buffer of collected data each time the XEQ
pin is hit.  It also optionally clears the
buffer at PreRun and Activate.  You also may
force this buffer to be cleared at other
times.  Choose the Clear option from the
object menu, or add a control input for Clear
and programmatically clear the Collector data
before XEQ is hit.  Subsequent hits on the
data input would start the collecting over
again.  The output is not propagated until
XEQ is hit.

If XEQ is hit, and the data input has not
been hit with non-nil data since the last
clear, the Collector will output a nil
signal.

SEE ALSO
Alloc Array, Concatenator, Get Values, Set
Values, and Sliding Collector.
