pitch: Pitch a Sample Object

View source: R/sound.R

pitchR Documentation

Pitch a Sample Object

Description

Change the pitch of a Sample object or a wav file.

Usage

pitch(s, semitones)

Arguments

s

a Sample object, or a string giving the name of a wav file.

semitones

a double giving the number of semitones to be pitched.

Details

Pitching +12 semitones (+1 octave) means to double the frequencies. Negative values of semitones are used to lower the frequencies.

Note that this transformation changes the actual data of the sample. Since pitching a sample is equivalent to playing it at a different speed, the length of the Sample object will also change.

Value

a Sample object.

Note

Future versions of this command may use a different algorithm to increase the quality of the returned sample.

Author(s)

Author: Matthias Heymann [aut], Stefan Langenberg [cre] (<https://orcid.org/0000-0001-5817-5469>)

Maintainer: Stefan Langenberg <langenberg@uni-bonn.de>

Examples

## Not run: 
s <- Sine(440,1)
# Now play it 12 semitones = 1 octave deeper,
# that is half the frequencies and twice the length,
# or played at half speed.
play(pitch(s,-12)) # is the same as...
play(Sine(220,2))

## End(Not run)

sound documentation built on May 29, 2024, 6:07 a.m.