NAME

Rivl_CreateFixedSignal - Generate a signal from a buffer

SYNOPSIS

#include <rivl.h>
Rivl_Signal
Rivl_CreateFixedSignal (interp, buf)

ARGUMENTS

Tcl_Interp *interp (in)
The Tcl interpreter.
Rivl_Buf buf (in)
The buffer containing the values that the new signal will consist of.

DESCRIPTION

Rivl_CreateFixedSignal returns a new signal whose values are drawn from buf. Sampling the new signal at a point (x,y) will yield the value at (x,y) in buf or zero if (x,y) is beyond the area defined by buf. Responsibility for buf's storage is transferred to Rivl_CreateFixedSignal; the caller should not free or modify buf after this procedure returns.

The value type of the new signal is taken from the type of buf. All other properties are left with default values and may be configured by the caller with Rivl_ConfigureSignal.

For examples of using Rivl_CreateFixedSignal, see the implementations of sig_construct and seq_to_ims.