Skip to content

Set Frequency (of All Modes)

Description

This allows the frequency of all the modes of an object to be altered dynamically.

(set-frequency ... )

Syntax and Default Values

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

(set-frequency object_reference controller)

Parameters

The (set-frequency ... ) function requires two arguments:

  • object_reference: name of the object whose mode frequencies will be altered.
  • controller: a multi-dimensional controller used to set the frequency of the object's modes.

The number of dimensions in the controller should correspond to the number of modes in the object, or the remaining mode frequencies will be set to zero.

Discussion

This function is used to set all the modes individual frequencies to new values:

(setq my-string (make-object 'mono-string (modes 4)))
(set-frequency my-string (const 1000 2000 3000 3146))
This function is not yet implemented for Hybrids; an error message will be displayed if object is of hybrid type.

Options

There are no special options for this function.