k y m a • t w e a k y — the kyma collective

Prototype Reference Guide

• PrototypesReferenceGuide: Kyma Prototype Reference Guide

%META:FILEATTACHMENT{name="PrototypesReference.pdf" attr="h" comment="Kyma Prototype Reference Guide" date="1205120025" path="Prototypes Reference.pdf" size="704588" user="BenPhenix" version="1.1"}%

In the Smalltalk Quick Reference, under "Messages sent to Dates"

In the Smalltalk Quick Reference, under "Messages sent to Dates"

-- KevinCole - 07 Jun 2005

-- KevinCole - 07 Jun 2005

Addenda

CapyTalk Expressions

See the CapyTalkExpressions section for information on new CapyTalk expressions and usage tips.

CapyTalk Expressions

Access parameter envelopes of PSI files

'houseBass02.psi' amplitudeEnvelopeWithTimeIndex: (1 repeatingFullRamp: 'houseBass02.psi' sampleFileDuration)

'houseBass02.psi' frequencyEnvelopeWithTimeIndex: (1 repeatingFullRamp: 'houseBass02.psi' sampleFileDuration)

'houseBass02.psi' formantEnvelopeWithTimeIndex: (1 repeatingFullRamp: 'houseBass02.psi' sampleFileDuration)

'houseBass02.psi' bandwidthEnvelopeWithTimeIndex: (1 repeatingFullRamp: 'houseBass02.psi' sampleFileDuration)

Random trigger expressions

Other CapyTalk expressions

Other additions and changes

Corrections, Omissions, and Clarifications

Please read the the What's New lists for a full update on things that have changed since the publication of the book.

Page 254: Puzzle solutions

Page 254: Puzzle solutions

Page 316: View

Page 316: View

Omissions

Clarifications

Page 34: What do the yellow triangles mean?

Page 34: What do the yellow triangles mean?

Use one Sound as an input to another

Use one Sound as an input to another

Effects_dopper_shift

Effects_dopper_shift

Dropping a Sound onto the line between two other Sounds

Dropping a Sound onto the line between two other Sounds

Other additions and changes

Please read the the What's New lists for a full update on things that have changed since the publication of the book.

brownianTriggerStart:deviation	Deviation is the maximum change on each step	!sw01 brownianTrigger: !StartDur s deviation: !Dev s	starts at !StartDur with random step size of +/- !Dev s

brownianTriggerStart:deviation:	Deviation is the maximum change on each step	!sw01 brownianTrigger: !StartDur s deviation: !Dev s	starts at !StartDur with random step size of +/- !Dev s

normalTriggerCenter:deviation	Deviation is maximum change on each step	!sw01 normalTrigger: !NormDur s deviation: !Dev s	time intervals within +/- !Dev s of !NormDur, most of them close to !NormDur

normalTriggerCenter:deviation:	Deviation is maximum change on each step	!sw01 normalTrigger: !NormDur s deviation: !Dev s	time intervals within +/- !Dev s of !NormDur, most of them close to !NormDur

randomTriggerCenter:deviation	Center is the average value, deviation is the maximum change on each step	!sw01 randomTrigger: !AveDur s deviation: !Dev s	random deviations +/- !Dev s around the average !AveDur s

randomTriggerCenter:deviation:	Center is the average value, deviation is the maximum change on each step	!sw01 randomTrigger: !AveDur s deviation: !Dev s	random deviations +/- !Dev s around the average !AveDur s

Wiimote/OSCulator Documentation

Wacom Tablet Documentation

Random trigger expressions (generate 1 ms positive triggers at random time intervals. First argument is the average or starting time interval between triggers. The receiver can be either a gate (event value) or a constant (1 for always ON). When the gate is turned off and back on again, a trigger is emitted and all argument values are resampled. Minimum time interval is 2 ms. Maximum time interval is twice the average for the symmetric distributions or 24 * natural log of 2 * average for the exponential distribution).

Access parameter envelopes of PSI files

'houseBass02.psi' amplitudeEnvelopeWithTimeIndex: (1 repeatingFullRamp: 'houseBass02.psi' sampleFileDuration)

'houseBass02.psi' frequencyEnvelopeWithTimeIndex: (1 repeatingFullRamp: 'houseBass02.psi' sampleFileDuration)

'houseBass02.psi' formantEnvelopeWithTimeIndex: (1 repeatingFullRamp: 'houseBass02.psi' sampleFileDuration)

'houseBass02.psi' bandwidthEnvelopeWithTimeIndex: (1 repeatingFullRamp: 'houseBass02.psi' sampleFileDuration)

Random trigger expressions

Other CapyTalk expressions

ceiling	the nearest integer that is greater than rcvr	6.1 ceiling, -6.7 ceiling	7, -5

ceiling	the nearest integer that is greater than rcvr	6.1 ceiling, -6.7 ceiling	7, -6

Random trigger expressions (generate 1 ms positive triggers at random time intervals. First argument is the average or starting time interval between triggers. The receiver can be either a gate (event value) or a constant (1 for always ON). When the gate is turned off and back on again, a trigger is emitted and all argument values are resampled. Minimum time interval is 2 ms. Maximum time interval is twice the average for the symmetric distributions or 24 * natural log of 2 * average for the exponential distribution).

Message	Description	Example	Value
brownianTrigger:	Generates triggers at time intervals determined by a random walk starting from the argument	!sw01 brownianTrigger: !StartDur s	starts at !StartDur and deviates from there
brownianTriggerStart:deviation	Deviation is the maximum change on each step	!sw01 brownianTrigger: !StartDur s deviation: !Dev s	starts at !StartDur with random step size of +/- !Dev s
normalTrigger:	Generates triggers at time intervals drawn from a normal distribution centered around the argument	!sw01 normalTrigger: !NormDur s	!NormDur is the normal duration so most time intervals between triggers will be close to normal
normalTriggerCenter:deviation	Deviation is maximum change on each step	!sw01 normalTrigger: !NormDur s deviation: !Dev s	time intervals within +/- !Dev s of !NormDur, most of them close to !NormDur
randExpTrigger:	Generates triggers at time intervals drawn from an exponential distribution	!sw01 randExpTrigger: !StartDur s	half of the time intervals are less than !AveDur and half are between !AveDur and (24 * {2 ln} * !AveDur )
randomTrigger:	Generates triggers at time intervals drawn from a uniform distribution	!sw01 randomTrigger: !AveDur s	random deviations around the average time interval !AveDur s
randomTriggerCenter:deviation	Center is the average value, deviation is the maximum change on each step	!sw01 randomTrigger: !AveDur s deviation: !Dev s	random deviations +/- !Dev s around the average !AveDur s

Addenda

TAU Documentation

CapyTalk Expressions

Message	Description	Example	Value
alignWith:	Delays the rcvr trigger to align with the argument trigger	!KeyDown alignWith: (1 bpm: !BPM)	delays incoming !KeyDown to align with next beat
ceiling	the nearest integer that is greater than rcvr	6.1 ceiling, -6.7 ceiling	7, -5
floor	the nearest integer that is less than rcvr	3.9 floor, -3.1 floor	3, -4
hasChangedInLast:	true when rcvr has changed in the interval of time given by the argument	!Fader hasChangedInLast: 5 s	true (1) if you have moved !Fader in last 5 s. After that, becomes false
setReset:	an SR flipflop is true (1) when rcvr is true and false (0) when argument is true (1)	!s setReset: !r	true when !s is true, false when !r is true
suffix3:	appends a number (the argument) with 3, 4, or more leading zeroes	!Fader suffix4: 7	!Fader00007
switchedOn	trigger on rising edge of rcvr	!Gate switchedOn	1 ms long trigger when !Gate was a 0 and becomes a 1
switchedOff	trigger on falling edge of rcvr	!Gate switchedOff	1 ms long trigger when !Gate was a 1 and becomes a 0
tick	Generates a gate (50% duty cycle) once per time interval given in rcvr	0.1 s tick	generates a gate once every 0.1 seconds

Other additions and changes

Please read the the What's New lists for a full update on things that have changed since the publication of the book.

Page 316: View

<aRectangle> displayDisplayStrokedOn: <aGraphicsContext>

to

<aRectangle> displayStrokedOn: <aGraphicsContext>

In the Smalltalk Quick Reference, under "Messages sent to Dates"

monthIndex

Answer the month in which the receiver falls.

-- KevinCole - 07 Jun 2005

Please insert your comments in page order

Errata

Page 254: Puzzle solutions

'rustDrum129p5.aif' sampleDuration s / 4

to

'rustDrum129p5.aif' sampleFileDuration s / 4

Omissions

Clarifications

Right - I got that much, however say I'm editing 2 Sound Files, called 'em (imaginatively) A and B. Both A and B have yellow traingles next to them and I want to keep changes to A but discard those for B. With the focus on the window for A, I ctrl-S to save, but in the browser the yellow traingles still exist for both. If I go to refresh the browser it asks me whether I want to save or discard changes. I think I've already saved A, but being a newbie, I'm nervous about it. This happend to me as I was working through the tutorials and editing both my own Sound File (A) and one from Kyma's "factory presets" (B).

-- SimonAmarasingham - 11 Jan 2004

Sure - you could forward reference to "Inserting a Sound into the Signal Flow Path" on page 101

-- SimonAmarasingham - 11 Jan 2004

Page 45: Invites me to "use one sound as an input to another" which I was dying to do, but I had no idea how to. (At this point I haven't read the Timeline stuff - I skipped to Part 2 from page 45, so I could find out about making sounds.)

(PDF Page 45): Invites me to "use one sound as an input to another" which I was dying to do, but I had no idea how to. (At this point I haven't read the Timeline stuff - I skipped to Part 2 from page 45, so I could find out about making sounds.)

Which page was this? Do you think a forward reference would be helpful there?

-- CarlaScaletti - 09 Jan 2004

Page 99: Effects_doppler_shift is different on disk compared with the description and screen shots in the manual

(PDF Page 99): Effects_doppler_shift is different on disk compared with the description and screen shots in the manual

Page 102: When I was building a sound from scratch, and I dropped TwoFormantElement? between Noise(white) and the speaker (as instructed) I ended up with something completely different than the screen shot. I later realized that my problem was that I should not be dropping the TwoFormantElement? on the plus sign, but on the line between the plus sign and Noise(white). Since it doesn't work to drop it just anywhere between Noise(white) and the speaker (nothing happens), the plus sign (a) seemed to be the thing that wanted to have things dropped on it and (b) the only thing I could find - at least at first - that would work. Of my notes so far, I would rate this particular thing as the highest priority to clarify.

(PDF Page 102): When I was building a sound from scratch, and I dropped TwoFormantElement? between Noise(white) and the speaker (as instructed) I ended up with something completely different than the screen shot. I later realized that my problem was that I should not be dropping the TwoFormantElement? on the plus sign, but on the line between the plus sign and Noise(white). Since it doesn't work to drop it just anywhere between Noise(white) and the speaker (nothing happens), the plus sign (a) seemed to be the thing that wanted to have things dropped on it and (b) the only thing I could find - at least at first - that would work. Of my notes so far, I would rate this particular thing as the highest priority to clarify.

%META:TOPICINFO{author="CarlaScaletti" date="1073670960" format="1.0" version="1.1"}% %META:TOPICPARENT{name="WebHome"}% Please insert your comments in page order

Page 34: What do the yellow triangles mean?

-- SimonAmarasingham - 09 Jan 2004

Individual Sounds are grouped into Sound files and saved on disk. When you make a change to a Sound, the Browser shows a yellow triangle next to it to indicate that it is changed in RAM but that the changes haven't been saved to the disk yet. There is no way to save just that one Sound to the disk; you have to save the entire Sound file. In the Browser, this would be all the Sounds in the indented list below the Sound File name. -- CarlaScaletti - 09 Jan 2004

Use one Sound as an input to another

-- SimonAmarasingham - 09 Jan 2004

Effects_dopper_shift

-- SimonAmarasingham - 09 Jan 2004

Dropping a Sound onto the line between two other Sounds

-- SimonAmarasingham - 09 Jan 2004