09.12.2012 Views

The Kyma Language for Sound Design, Version 4.5

The Kyma Language for Sound Design, Version 4.5

The Kyma Language for Sound Design, Version 4.5

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Positioning the Fields<br />

Field Layout shows you what the <strong>Sound</strong> editor <strong>for</strong> <strong>Sound</strong>s of this class will look like. When you select<br />

a parameter, its field is highlighted in gray.<br />

To change the position of a field, type the coordinates of a new rectangle in the Field Rectangle text<br />

editor and then press Enter.<br />

<strong>The</strong> <strong>for</strong>mat <strong>for</strong> specifying rectangle coordinates is as follows:<br />

upperLeftX @ upperLeftY corner: lowerRightX @ lowerRightY<br />

where the parameter fields are laid out in a square whose corner points are as shown below:<br />

0 @ 0<br />

0 @ 1<br />

539<br />

1 @ 0<br />

1 @ 1<br />

<strong>The</strong> x and y values are not in absolute units like centimeters or pixels; they just indicate a position relative<br />

to a maximum x and y of 1 @ 1.<br />

Whenever you type in a new rectangle, you should adjust each of the other parameter field positions as<br />

necessary to avoid any overlapping fields.<br />

Class Description and Comments<br />

Expand<br />

Each class has a Class Description, a paragraph or two describing how <strong>Sound</strong>s of that class behave.<br />

In addition to an overall class description, each parameter has its own Comment. A parameter comment<br />

provides later users of <strong>Sound</strong>s of this class with instructions <strong>for</strong> how to enter a value <strong>for</strong> the parameter,<br />

any restrictions on its range of legal values, and an indication of how it relates to the other parameters<br />

and to the class as a whole.<br />

<strong>The</strong> Edit menu is active in the class editor <strong>for</strong> editing the class description and the parameter comments.<br />

When the Expand box is checked, the new class will expand be<strong>for</strong>e any trans<strong>for</strong>mations are applied to it<br />

(see Controlling Expansion on page 545 <strong>for</strong> more in<strong>for</strong>mation).<br />

Closing the Class Editor<br />

Debugging<br />

<strong>The</strong> first time you close the editor on a new <strong>Sound</strong> class, you will be asked whether you want to save an<br />

instance of the new class. Click Yes unless you would like to start over from scratch. An instance of the<br />

new class is created using default values <strong>for</strong> each of the parameters. To change those values, double-click<br />

on the <strong>Sound</strong> and edit it.<br />

When you close the class editor window after subsequent editing of that <strong>Sound</strong> class, you will be asked if<br />

you want to save the changes made to the class. Choose Yes to save the changes, No to discard the<br />

changes, or Cancel to return to the class editor without closing.<br />

When a <strong>Sound</strong> that you have constructed has some unexpected behavior, it can be helpful to expand it, so<br />

that you can see how <strong>Kyma</strong> is really interpreting your <strong>Sound</strong>. <strong>The</strong> Expand operation from the Action<br />

menu expands a <strong>Sound</strong> one level only. You can then select specific inputs <strong>for</strong> further expansion.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!