Skip to content

Set Cents Pitchbend


This allows to alter the global pitch of an object dynamically, in cents.

(set-cents-pitchbend ... )

Syntax and Default Values

The (set-cents-pitchbend... ) function can be called using the following Lisp syntax:

(set-cents-pitchbend object_reference controller)


The (set-cents-pitchbend ... ) function requires two arguments:

  • object_reference: name of the object whose pitchbend will be altered.
  • controller: a 1-dimensional controller used to set the pitchbend. This can be either dynamic or constant.


This function bends the pitch for all mode frequencies accordingly, and is very efficient CPU-wise. It can be a very convincing alternative to physical parameters (dimension, young modulus etc.) for varying pitch, especially in real time.

Like the spectral diffraction, the cents pitch bend is a « pseudo-physical » parameter in Modalys. Unlike « real » physical parameters, pseudo-physical parameters have a direct action on the object spectrum, i.e. on the modal frequencies and loss, without having to recalculate everything each time.

;;; static pitchbend:
(setq my-string (make-object 'mono-string))
(set-cents-pitchbend my-string -25) ;;; down by a quarter tone
;;; dynamic pitchbend:
(setq my-string (make-object 'mono-string))
(setq my-bend (make-controller 'envelope 1
                       (list (list 0.00 .0)
                              (list 2.0 -100.))))
(set-cents-pitchbend my-string my-bend) ;;; glissando down a whole over 2 sec.


There are no special options for this function.