Looped waveform of a sample

Generate a looped waveform of a PTSample object.

Usage

# S4 method for class 'PTSample'
loopSample(sample, times, n_samples)

Arguments

sample

A PTSample object that needs to be looped.

times

A positive integer value indicating the number of times a sample loop should be repeated. This argument is ignored if n_samples is specified.

n_samples

A positive integer value indicating the desired length of the looped waveform in number of samples. This argument overrules the times argument.

Value

Returns a waveform represented by a numeric vector of values ranging from 0 up to 255. Has a length of n_samples when that argument is specified.

Details

For playing routines, it can be useful to generate repeats of a sample loop. This method returns the waveform of a PTSample where the loop is repeated times`' times or has a length of n_samples`'.

See also

Other loop.methods: loopLength(), loopStart(), loopState()

Other sample.operations: PTSample-class, PTSample-method, fineTune(), loopLength(), loopStart(), loopState(), name, playSample(), read.sample(), sampleLength(), volume(), waveform(), write.sample()

Author

Pepijn de Vries

Examples

data("mod.intro")

## Loop sample number 4 10 times:
wform <- loopSample(PTSample(mod.intro, 4), times = 10)
plot(wform, type = "l")


## Loop sample number 4, such that its
## final length is 5000 samples:
wform <- loopSample(PTSample(mod.intro, 4), n_samples = 5000)
plot(wform, type = "l")