Besides the recJs script recording format, which has its own editor, most scripts are bound to configuration items like plots, ports and charts.

The associated element dialogs contain text fields for inserting and editing the script.

You can use the built-in script editor instead of the text field in the dialog. Click on "Edit in the eclipse script editor" to open a new Eclipse editor. Once you save the content, the configuration element is updated.

Log and exception messages of the script execution are sent to the impulse console view.

The typical goal of a script is to read the content of source signals and create any kind of output signal. A typical script for the Signal Script Production looks like this:

// input: an array of all input signals
// in0: primary input of type ISamplePointer,IReadableSamples
// in1..: additional inputs of type ISamplePointer,IReadableSamples
// out: output signal of type IFloatSamplesWriter
// console: console output of type MessageConsoleStream
// iter: iterator of type ISamplesIterator
// progress: progess control of type  IScriptProgress

while ( iter.hasNext()) {
    var current <:Long:> = iter.next(out);
    out.write(current, false, input[0].floatValue() +  input[1].floatValue());
}

SamplesIterator instance iter allows to iterate over events of multiple source signals. 'iter.next()' returns the current domain value (e.g current time). All input variable can be accessed as signal pointers: For each event found, the iterator set the pointers to the current position, e.g. floatValue() returns the float value at that position.

There are 2 important interfaces for reading the signal data, IReadableSamplesand ISamplesPointer.

The IReadableSamples interface defines the basic reader interface. It has methods like:

• getCount()
• valueAt(int idx)
• intValueAt(int idx)
• ...

So you can get the total number of available samples and use one of the accessor methods to get the value at a given index.

The ISamplesPointer interface allows to modify an index and read the value at the current index. You find functions like:

• setIndex(int idx)
• goPrev()
• goNext()
• val()
• intValue();

If an input has a an additional dimension (struct members or arrays) you might read the value object and use the member accessors:

• structAt(n).intValueOf("max")
• intValueOf("max")

If you use a SamplesIterator, all pointers are updated by the iterator automatically. There is no need to use 'goNext()','goPrev()',... implicitly.

while ( iter.hasNext()) {
   .... in0.intValue() ....  }

Each signal type comes with a writer interface.

The float signal of the above example uses the IFloatSamplesWriter interface (integer:  IIntegerSamplesWriter, text: ITextSamplesWriter, ...).

A simple write includes the parameters for domain position, a tag flag and one or more parameters describing the value.

public interface IFloatSamplesWriter extends INumberSamplesWriter {

	// default interface
    boolean write(long units, double value);
    boolean write(long units, boolean tag, float value);
    boolean write(long units, boolean tag, double value);
    boolean write(long units, boolean tag, BigDecimal value);
    boolean write(long units, boolean tag, Number value);
    boolean write(long units, boolean tag, float[] value);
    boolean write(long units, boolean tag, double[] value);  
	// named interface for scripts   
    boolean writeFloat(long units, boolean tag, float value);
    boolean writeDouble(long units, boolean tag, double value);
    boolean writeBig(long units, boolean tag, BigDecimal value);
    boolean writeFloatArray(long units, boolean tag, float[] value);
    boolean writeFloatArgs(long units, boolean tag, float... value);    
    boolean writeDoubleArray(long units, boolean tag, double[] value);
    boolean writeDoubleArgs(long units, boolean tag, double... value);
}

The parameters have the following meaning:

units

Domain position as no of domain units (e.g, domain base:ns, units = 1000 -> domain position = 1us)

tag

Possiblity to tag a sample.

value

The given value in different formats (float/double/BigDecimal)