/* pulse.s */
/***************************************************************************
pulse()
*****************************************************************************
This star generates a pulse train.
The first parameter, which defaults to NUMBER_SAMPLES_PER_VISIT, tells how many total samples
to send out.
The second parameter is the magnitude which defauls to one.
The following parameters specify the pulse delay, width and period:
np=period in samples
nw=pulse width in samples
nd=delay in samples
CONTROL PARAMETERS:
num_of_samples = total number of samples to output.
pace_rate = multiplies the number of samples received
on pace input (if connected) to determine
how many samples to output.
samples_first_time = the number of samples to put out on the
first call if pace input connected. It can
be zero. negative values = 0.
CONTROL DESCRIPTION:
If the pace input is not connected:
The num_of_samples parameter sets the maximum number of samples
that the star will output. If num_of_samples < 0, an indefinite
number of samples can be output.
The star will output a maximum of NUMBER_SAMPLES_PER_VISIT on each call.
If the pace input is connected:
The num_of_samples parameter sets the maximum number of samples
that the star will output. If num_samples_out < 0, an infinite
number of samples can be output.
The pace input paces the number of output samples on each call.
At each call of the star all samples are read from the pace input
and a running total of how many there have been is kept.
An output_target is computed at each pass = pace_input_total *
pace_rate. If pace_rate < 0, the absolute value is used.
On the first call:
output = lesser of (samples_first_time, num_of_samples)
On subsequent calls:
output = lesser of (NUMBER_SAMPLES_PER_VISIT, output_target)
output_target = samples_first_time +
pace_rate * pace_input_total - to that point
The total number of samples that will be output:
samples_out_total = lesser of (num_of_samples,
samples_first_time + pace_rate * pace_input_total)
Programmer: Sasan Ardalan
Date: Nov. 1987
pulse
This star generates a pulse train.
The first parameter, which defaults to NUMBER_SAMPLES_PER_VISIT, tells how many total samples
to send out.
The second parameter is the magnitude which defauls to one.
The following parameters specify the pulse delay, width and period:
np=period in samples
nw=pulse width in samples
nd=delay in samples
CONTROL PARAMETERS:
num_of_samples = total number of samples to output.
pace_rate = multiplies the number of samples received
on pace input (if connected) to determine
how many samples to output.
samples_first_time = the number of samples to put out on the
first call if pace input connected. It can
be zero. negative values = 0.
CONTROL DESCRIPTION:
If the pace input is not connected:
The num_of_samples parameter sets the maximum number of samples
that the star will output. If num_of_samples < 0, an indefinite
number of samples can be output.
The star will output a maximum of NUMBER_SAMPLES_PER_VISIT on each call.
If the pace input is connected:
The num_of_samples parameter sets the maximum number of samples
that the star will output. If num_samples_out < 0, an infinite
number of samples can be output.
The pace input paces the number of output samples on each call.
At each call of the star all samples are read from the pace input
and a running total of how many there have been is kept.
An output_target is computed at each pass = pace_input_total *
pace_rate. If pace_rate < 0, the absolute value is used.
On the first call:
output = lesser of (samples_first_time, num_of_samples)
On subsequent calls:
output = lesser of (NUMBER_SAMPLES_PER_VISIT, output_target)
output_target = samples_first_time +
pace_rate * pace_input_total - to that point
The total number of samples that will be output:
samples_out_total = lesser of (num_of_samples,
samples_first_time + pace_rate * pace_input_total)
Programmer: Sasan Ardalan
Date: Nov. 1987
*****************************************************************************/