Skip to content

Attach Mode Controllers

Description

This allows the modes of a given object to be dynamically altered in frequency, loss, and amplitude.

[However, this seems to be broken, currently....]

(attach-mode-controllers ... )

Syntax and Default Values

The (attach-mode-controllers ... ) function can be called using the following Lisp syntax:

(attach-mode-controllers object_reference 
         (list    (list mode-number0 freq-cont0 loss-cont0 amp-cont0) 
                  (list mode-number1 freq-cont1 loss-cont1 amp-cont1) 
                  . . . ))

Parameters

The (attach-mode-controllers ... ) function takes the following arguments:

  • object_reference: name of the object on which the access will be located.
  • mode_numberN: the mode number whose loss coefficient will be altered (starting from mode 0)
  • freq_contN: frequency controller for mode N
  • loss_contN: loss coefficient controller for mode N
  • amp_contN: amplitude controller for mode N

The mode-number must lie between zero and the number of modes in the object minus one.

Each mode whose parameters you want to control should have a list containing the mode number followed by one to three controllers. All of these lists are grouped into one single list as the second argument to the function. [If you don't want to attach a controller to a given parameter you can use the constant #f instead of a controller.]

Discussion

This function seems to currently be broken. It causes no errors, but has no effect on the object.

This function is not yet implemented for Hybrids; an error message will be displayed if object is of hybrid type.

Options

Retro-Compatibility

Modalys also has an older syntax for this function:

(attach-controller ... )

See Also

The older function basically did the same thing without the convenience of the additional amplitude controller), so any older Modalys scripts using it should be updated to use the new syntax.