OpenMusic 6 – User ManualOM Objects > OM Basic Objects > Array > Class-Array Tools

Class-Array Tools Overview

The values of array components can be manipulated with a set of functions. Some functions also allow to add components to an array.

These functions are available in the Functions/Basic Tools/Data Structures menu. Their conception is still in progress.

Uses

These tools are especially designed for advanced sound synthesis control applications such as the OMChroma project. These applications aim to extend and complete components at synthesis time, as a post processing operation. They might not be very useful in other cases as far as we know.

Returning Values


	The get-comp function returns the value of the nth component of an array. It has two inputs and one output. "self" : takes a class-array. "comp-number" : takes a component number.
	The comp-list function returns a list of values belonging to the fields of a component. It has one input and output. "self" takes the value returned by get-comp .
	The comp-field function returns the value of the nth field of a given component. It has one input and output. "self" takes the value returned by get-comp . "line-id" takes a line reference – string or number.

Example

Here,

get-comp returns the value of the second component , or column, of the class-array
comp-list returns the list of values belonging to the second column of the class- array : a chord and two ordinates
comp-field returns the value of the first field , or line, corresponding to the second column : a chord.

Remember that numbering starts at 0, consequently, 0 = 1st element, 1 = 2nd element...

Defining Values and Components : Preview


	The fill-comp function sets – "fills" – or changes the values of a component.
	The new-comp function allows to create a new component.

previous pagenext page

About...(c) Ircam - Centre Pompidou