ProTrackR2 (version 0.1.1)

pt2_render: Render ProTracker modules and other objects to a playable format

Description

Renders a 16bit pulse-code modulation waveform from a ProTracker module. The rendered format can be played on a modern machine.

Usage

pt2_render(x, duration = NA, options = pt2_render_options(), ...)
# S3 method for pt2mod
pt2_render(
  x,
  duration = NA,
  options = pt2_render_options(),
  position = 0L,
  ...
)
# S3 method for pt2samp
pt2_render(x, duration = 5, options = pt2_render_options(), note = "C-3", ...)
# S3 method for pt2patlist
pt2_render(x, duration = NA, options = pt2_render_options(), samples, ...)
# S3 method for pt2pat
pt2_render(x, duration = NA, options = pt2_render_options(), samples, ...)
# S3 method for pt2celllist
pt2_render(x, duration = 5, options = pt2_render_options(), samples, ...)
# S3 method for pt2cell
pt2_render(x, duration = 5, options = pt2_render_options(), samples, ...)

Value

Rendered audio inheriting the audio::audioSample() class.

Arguments

x

The object to be rendered

duration

Duration of the rendered output in seconds. When set to NA the duration of the module is calculated and used for rendering.

options

A list of options used for rendering the audio. Use pt2_render_options() to obtain default options, or modify them.

...

Ignored

position

Starting position in the pattern sequence table (pt2_pattern_table()). Should be a non negative value smaller than the mule length (pt2_length()).

note

Note to be played when x is a pt2samp class object. Defaults to "C-3".

samples

When rendering or playing patterns (or elements of it), samples are needed to interpret the pattern. Pass the samples as a sample list (class pt2samplist).

Author

Pepijn de Vries

Examples

mod <- pt2_read_mod(pt2_demo())
aud <- pt2_render(mod)
aud_samp <- pt2_render(mod$samples[[1]])