dsprobotics flowstone user guide

8/18/2019 DSPRobotics FlowStone User Guide

1/287

USER GUIDE

V E R S I O N 3 . 0 . 8


2/287

C O N T E N T S

CHAPTER 1 1 Introduction 10

ABOUT THIS GUIDE.....................................................................................11

WHAT IS FLOWSTONE?.......................................................................................12

HOW IT WORKS..................................................................................................12

CHAPTER 2 2 User Interface 14

TOOLBO...................................................................................................1!

COMPONENT BROWSER.......................................................................................16

FILTER P ANE......................................................................................................17

FILTER BUTTONS ...............................................................................................17

SEARCH BOX.....................................................................................................18

QUICK FIN.......................................................................................................18

CLEAR ALL FILTERS............................................................................................1!

F AVOURITES.......................................................................................................1!

ISPLA" SCALE..................................................................................................1!

LOCAL TOOLBOX.................................................................................................20

TAG BAR...................................................................................................22

EITIN# T A#S....................................................................................................22

T A##IN# COMPONENTS.......................................................................................23

USIN# T A#S......................................................................................................2$

"A#IGATOR................................................................................................2$

%UMPIN#............................................................................................................2&

P ANNIN#............................................................................................................26

BOOKMARKS.......................................................................................................26

S%HE&ATI% 'I"DO'...................................................................................2(

'OOMIN#...........................................................................................................27

SCROLLIN#........................................................................................................28P ANNIN#............................................................................................................28

RESETTIN# 'OOM AN P AN.................................................................................28

CHAPTER 3 ) %o*+onents , Lin-s 2

%O&/O"E"TS.............................................................................................)4

AIN# A COMPONENT........................................................................................3$

SELECTIONS AN THE ACTION P ANEL....................................................................38

MOVIN# COMPONENTS........................................................................................38

N AMIN# COMPONENTS.........................................................................................3!

ELETIN# COMPONENTS......................................................................................$0

RESI'IN#...........................................................................................................$0

MULTIPLE SELECTIONS........................................................................................$1

CONNECTOR L ABELS...........................................................................................$2

CUT( COP" AN P ASTE.......................................................................................$2

LI"S........................................................................................................4)

) ** )


3/287

C O N T E N T S

CREATIN# A LINK................................................................................................$3

ALLOWE LINKS..................................................................................................$$

MOVIN# A LINK...................................................................................................$$

ELETIN# A LINK................................................................................................$&

LINK ORER.......................................................................................................$6

BENIN# LINKS..................................................................................................$7

RESOLVIN# CONTROL POINTS..............................................................................$8

STRAI#HT LINKS.................................................................................................$!

AUTO LINKIN#....................................................................................................&0SMART LINKIN#..................................................................................................&1

REMOVIN# MULTIPLE LINKS..................................................................................&2

SWAPPIN# LINKS................................................................................................&2

WIRELESS LINKS.................................................................................................&3

FOLLOW WIRELESS.............................................................................................&$

CHAPTER $ 4 &odues $(

E DI33ERE"%ES......................................................................................$

APPEARANCE......................................................................................................&!

FRONT P ANEL....................................................................................................60

PROPERTIES.......................................................................................................60

TOOLBOX...........................................................................................................61

BASI% O/ERATIO"S....................................................................................!2

MOVIN# INTO A MOULE......................................................................................62

INPUTS AN OUTPUTS.........................................................................................63

TEMPLATE CONNECTORS.....................................................................................6$

INPUT AN OUTPUT N AMES..................................................................................6$

M AKE MOULE...................................................................................................6&

PROPERTIES.......................................................................................................6&

WIRELESS MOULES...........................................................................................66

3RO"T /A"EL............................................................................................!(

ENABLIN# THE FRONT P ANEL...............................................................................67

EITIN# THE FRONT P ANEL..................................................................................68

SELECTIN#.........................................................................................................6!

MOVIN#.............................................................................................................70

RESI'IN#...........................................................................................................70

%UMPIN#............................................................................................................71

SUB)P ANEL EITIN#...........................................................................................72

HIIN# ITEM BOUNARIES....................................................................................73

RAW ORER....................................................................................................73

OUT OF VIEW ITEMS............................................................................................73

#ROUPE ITEMS.................................................................................................7&

CLIENT AREA.....................................................................................................7&

HIIN# THE FRONT P ANEL...................................................................................76

VISIBILIT" IN P ARENT MOULE P ANELS..................................................................76

/RO/ERTIES...............................................................................................(

ENABLIN# THE PROPERTIES P ANEL.......................................................................78

AIN# PROPERT" ITEMS....................................................................................7!

CONTROL T"PES................................................................................................80

EITIN# THE PROPERTIES P ANEL..........................................................................82

) *** )


4/287

C O N T E N T S

RESI'IN#...........................................................................................................82

CUSTOMI'IN#.....................................................................................................82

S "%HRO"ISI"G..........................................................................................4

P ASTE S"NCHRONISE..........................................................................................8$

S"NCHRONISE ALL..............................................................................................8&

S"NCHRONISE P AINTER.......................................................................................8&

REMOVIN# S"NCHRONISATION..............................................................................86

FININ# S"NCHRONISE MOULES.......................................................................86

3O%US &ODE.............................................................................................(

FOCUS ON A MOULE..........................................................................................87

FOCUS ON THE PREVIOUS MOULE........................................................................87

CHAPTER & $ Data T5+es , Si6na 3o7

STREA& DATA............................................................................................0

I#ITAL SI#NAL PROCESSIN# IN A NUTSHELL.........................................................!0

MONO...............................................................................................................!1

POL".................................................................................................................!1

WHEN TO USE POL" OR MONO............................................................................!1STREAM CONNECTORS........................................................................................!3

POL" AN MONO SECTIONS IN AUIO APPLICATIONS...............................................!$

BOOLEAN CONNECTORS.......................................................................................!&

POL" INT...........................................................................................................!&

SSE.................................................................................................................!&

MONO $............................................................................................................!6

PERFORMANCE...................................................................................................!6

TRIGGERED DATA.......................................................................................(

HOW IT WORKS..................................................................................................!7

WHAT IT+S USE FOR..........................................................................................!8

TRI##ERE ATA T"PES.....................................................................................!8

E#E"T DATA............................................................................................101HOW IT WORKS................................................................................................101

EVENT ATA T"PES..........................................................................................102

%O"#ERTI"G BET'EE" DATA T /ES..........................................................10)

STRIN# ,- BOOLEAN........................................................................................103

INT ,- BOOLEAN..............................................................................................10$

STRIN# ,- FLOAT ,- INT..................................................................................10$

INTFLOAT - POL"MONO..................................................................................10&

MII ,- STRIN#..............................................................................................106

STRIN# SHORTCUTS..........................................................................................107

CHAPTER 6 ! E8+ortin6 110

%REATI"G STA"DALO"E A//LI%ATIO"S......................................................111

LIBRAR" EPENENCIES....................................................................................113

%REATI"G /LUGI"S...................................................................................114

) */ )


5/287

C O N T E N T S

INPUTS AN OUTPUTS........................................................................................11$

CREATE VSTVSTI IALO#...............................................................................11&

STORIN# VST EXPORT PREFERENCES................................................................117

PRESETS.........................................................................................................117

TIMIN# INFO.....................................................................................................118

CHAPTER 7 ( Ad9anced GUI Editin6 11

&ODULE GUI...........................................................................................120

MOULE #UI COMPONENT................................................................................120

M#UI CONNECTORS.........................................................................................121

#UI CONNECTOR T"PES...................................................................................122

COORINATE S"STEM........................................................................................123

DRA'I"G.................................................................................................124

RAWIN# ON A P ANEL.......................................................................................12$

RAWIN# ORER..............................................................................................12&

CHAININ# #UI COMPONENTS.............................................................................126

&OUSE HA"DLI"G....................................................................................12(

MOUSE AREA...................................................................................................127MOUSE CLICKS.................................................................................................127

MOUSE RA##IN#............................................................................................128

MOUSE MOVES................................................................................................12!

RA# ACCUMULATE..........................................................................................12!

REDRA'I"G.............................................................................................1)1

RERAW CONTROL ..........................................................................................131

PRECISION RERAWS........................................................................................131

CHAPTER 8 Ru:5 %o*+onent 1))

I"TRODU%TIO"..........................................................................................1)4

OVERVIEW.......................................................................................................13$

I"/UTS A"D OUT/UTS...............................................................................1)$

AIN# OR REMOVIN#......................................................................................13&

CHAN#IN# T"PE...............................................................................................13&

INSERTIN#( ELETIN# AN MOVIN#.....................................................................136

N AMIN# ..........................................................................................................136

%ODE EDITOR BASI%S...............................................................................1)(

THE OUTPUT P ANE...........................................................................................137

THE RUB"EIT CLASS......................................................................................13!

INPUT ATA.....................................................................................................13!

OUTPUT ATA..................................................................................................1$1

THE E#E"T &ETHOD..................................................................................14)

METHO EFINITION.........................................................................................1$3

CONNECTOR REFERENCIN#................................................................................1$$

EFFECT ON COE EXECUTION............................................................................1$&

) / )


6/287


7/287

C O N T E N T S

IN PLACE EIT CONTROLS.................................................................................206

ROP LISTS.....................................................................................................207

MESSA#E BOXES..............................................................................................208

SOU"DS...................................................................................................210

PLA"IN#..........................................................................................................210

W AITIN# FOR COMPLETION.................................................................................210

LOOPIN#..........................................................................................................211

STOPPIN#........................................................................................................211

UTILIT &ETHODS.....................................................................................212

%ODE S"I//ETS.......................................................................................21)

AIN# COE SNIPPETS....................................................................................213

EFAULT COE................................................................................................213

S AVIN# SNIPPETS.............................................................................................21$

OR#ANISIN# SNIPPETS......................................................................................21$

ETER"AL DLLS......................................................................................21$

THE WIN32API EXTENSION...............................................................................21&

CREATIN# A FUNCTION OB%ECT .........................................................................21&

M AKIN# THE C ALL.............................................................................................217

&IDI.......................................................................................................21

REAIN# MII OB%ECTS ..................................................................................21!

CREATIN# MII OB%ECTS..................................................................................221

3RA&ES...................................................................................................22)

MONO TO FRAME..............................................................................................223

THE FRAME CLASS...........................................................................................22$

FRAME TO MONO.............................................................................................22&

FRAME S"NC...................................................................................................226

PROCESSIN# FRAMES IN A LL..........................................................................227

RUB TI&EOUT.........................................................................................22

#LOBAL TIMEOUT..............................................................................................22!

LOCAL

TIMEOUT

................................................................................................22!

RUB LI&ITATIO"S....................................................................................2)0

SIN#LE INTERPRETER........................................................................................230

STANAR RUB" LIBRARIES...............................................................................230

ECLARATION ORER........................................................................................231

ECLARATION PERSISTENCE...............................................................................231

#EMS..............................................................................................................231

RUB DLL..............................................................................................2))

CHAN#ES.........................................................................................................233

BUILIN# THE LL...........................................................................................23$

CHAPTER ! DS/ %ode %o*+onent 2)$

DS/ %ODI"G...........................................................................................2)!

THE SP COE COMPONENT............................................................................236

INPUTS AN OUTPUTS........................................................................................236

) /** )


8/287

C O N T E N T S

S"NTAX COLOURIN#..........................................................................................237

EITOR............................................................................................................238

LOCAL V ARIABLES.............................................................................................238

ASSI#NMENTS..................................................................................................23!

EXPRESSIONS...................................................................................................2$0

CONITIONAL STATEMENTS................................................................................2$1

COMMENTS......................................................................................................2$1

AD#A"%ED 3EATURES...............................................................................242 ARRA"S...........................................................................................................2$2

MEM INPUT......................................................................................................2$3

HOP................................................................................................................2$3

LOOP..............................................................................................................2$3

STA#ES...........................................................................................................2$&

EBU##IN#.....................................................................................................2$7

ASSE&BLER.............................................................................................24

S"NTAX...........................................................................................................2$!

OPCOES........................................................................................................2$!

CHAPTER 10 10 DLL %o*+onent 2$1

I"TRODU%TIO"..........................................................................................2$2

THE %O&/O"E"T......................................................................................2$)

EFININ# INPUTS AN OUTPUTS.........................................................................2&3

CONNECTOR T"PES..........................................................................................2&$

THE DLL.................................................................................................2$!

ATA T"PES....................................................................................................2&6

INTS................................................................................................................2&7

FLOATS...........................................................................................................2&8

BOOLEANS.......................................................................................................2&8

STRIN#S..........................................................................................................2&8

FLOAT ARRA"S.................................................................................................2&!

INT ARRA"S.....................................................................................................260

BITMAPS..........................................................................................................262

FRAMES...........................................................................................................263

HELPERS.........................................................................................................26$

EXAMPLE 1 FLOAT A..................................................................................26&

EXAMPLE 2 STRIN# UPPERCASE......................................................................266

EXAMPLE 3 AUIO ELA"...............................................................................267

%O""E%TI"G............................................................................................2!

A NOTE ABOUT OUTPUTS...................................................................................26!

DEBUGGI"G..............................................................................................2(1

EBU##IN# USIN# VISUAL STUIO......................................................................271

COE TEST EBU# C"CLE..........................................................................272

SHARI"G..................................................................................................2(4

SHARE THE LL SEPARATEL"............................................................................27$

EMBE THE LL...............................................................................................27$

PROS AN CONS OF EMBEIN#........................................................................27&

) /*** )


9/287

C O N T E N T S

EXPORTIN#......................................................................................................27&

CHAPTER 11 11 O+tions 2(!

THE O/TIO"S DIALOG...............................................................................2((

APPLICATION....................................................................................................278

N AVI#ATOR......................................................................................................280

TOOLBOX.........................................................................................................281

SCHEMATIC......................................................................................................282

MOULES........................................................................................................283

EXPORT...........................................................................................................28$

AVANCE.......................................................................................................28&

) * )


10/287

Introduction ABOUT THIS #UIE AN SOFTWARE OVERVIEW


11/287

INTROUCTION

A:out T;is Guide

T*4 59 :;4 =>*9>= =>4@;*:*


12/287

CHAPTER 1

What is FlowStone?

F9/>9 9>**9* < @;>> >@9 > D*= * > >:= 4 @>9 *=>:>=> >>@9> ::9*@* ::9*@* > 4>= 5.

How It Works

C:99( F9; 4*5:9>. T> 4 :;4 4> ;>

:>4 4 = >>> @5 >; * 9*D4. A 9*D 4;4

@4 ; < ;*. H/>;( * 4 @4>4( = *4 94< :44>= ;= < 4; J5 ;.

) 12 )


13/287

INTROUCTION

C 9*= @99 4@>5*@.

I ; < 99 /> 4:>@*9 :> 4:>@*9 :>4 =>*>= >*; 5*@.

@;@*/> ;9 * *+4

;> >/*9 54 ;> *=*/*=9 ::9*@**; 4> @ > > >:= 4

4=9 >>@9> ::9*@*


14/287

CHAPTER 2

User Interface A FIRST LOOK AROUN

) 1$ )


15/287

USER INTERFACE

B> * 4* > 4 >= < D * 4>; *>;@>. L>+4

4; D* 9 9: > *4 =*4:9>= 44 ;

> 4>44( *4 *4 4>=


16/287

CHAPTER 2

Too:o8

T> 9;>= ;

$&0 @ *5>.

O @ * >;> ;> =;>=4 < : >;> ;> 4>/>;9 5>@*454 * :9@>

< 5D> *4 >@>:*4.

Component Browser

E8+orin6

T> 5* :; 9( :;>44* >

P#UP = P#N D>4 @;4>> *>54.

Instant He+

" >9:


17/287

USER INTERFACE

Filter Pane

T> *9>; :> ::>;4 > ( > S>;@ B F*9>; B99 9D 4> *

> > < 4>@* *9>; = 4@ >

5@>9 4>= *4 > F/4 *9>; 4 3 ; @ @ *5>. T*4 99


18/287

CHAPTER 2

T5+e 3iters

T> 4>@; :>4. "> ;>.

C9*@D = > @ < 4= :>.

" *9>; > 45> *5>. T< =< *4( 9>@>= :>4. S< * 9>@

I = F94 5:9>( ;@ :;>44* CTRLF

Quick Find

A; < *@D9 9 @ > Q*@D F*= >;>. T*4 ;>9*>4 .

S*5:9 5 > 5 @;4 9>@>= @ 4 * ;

< 5@ > 5> * :>=. A>; @ @ 4>;@ > = >4

@9>;>= 4 :4> @ />; *@D < 9 @ 4>= * @=.

) 18 )


19/287

USER INTERFACE

Clear All Filters

T< @9>; ALL > *9>;4 J*@9=* > 4>;@ *>; ;*)@9*@D *9>; :> 44 >

ESC D> 4@9> 4* > 49*=>; >


20/287

CHAPTER 2

"ocal #ool$ox

S*5>4 >; < =@4 < > ;>95>= > /4 ;;


21/287

USER INTERFACE

N > 94 > 9 > @ ;( >@>; @> 4@>5*@ > 4=>4 < *9=( 5D> 9 >/>;* 4@>5*@. T> 4=> @ > D>

4@>5*@ = > 4D>= < ;>@;>> > 94 9 4@>5*@ = 4*99 4/> * * > 9


22/287

CHAPTER 2

Ta6 Bar

T> ;.

) 22 )

#dit tags "dds a tag

Delete the tag


23/287

USER INTERFACE

Editin6 and Deetin6 Ta6s

T< >=* ( 4*5:9 =)@9*@D * 4 > @9*@D 44 ;>; < **4.

T4 @ > =>9>>= @9*@D* .

%reatin6 a Se+arator

I 95 *< D4. T< =< *4 >

4>:;D : >@ 4>. A==* 4>:;4. %4 == 4

4> ;>> 4;@ 4* @;@>;4 *> ))). T> 4>:; *= ; > * >=* 5.

#a&&in& Components

O@> 4 4 == >5 < @


24/287

CHAPTER 2

'sin& #a&s

N; > = = > ; P>.

I > :;>/*4>9>@>=. T< *9>; 5

(


25/287

USER INTERFACE

"a9i6ator

T> N/*;> * 5*@. T*4 *4 >;>5>9 4>9 > 4>/>;9 9>;4 @4> > S@>5*@ W*= N/* 5>; D>4 < =< *4 J:; T/>9. T> P#UP = P#N D>4

*99 5 *>;;@.

) 2& )


26/287

CHAPTER 2

Pannin&

T> @;;> 5 * > @* *4 *9*>=. I4*=> > ;>@9> ;>:;>4>* > : 4@>5*@ *= @99>= > V*> R>@9>. "5*@.

Bookmarks

"


27/287

USER INTERFACE

Sc;e*atic 'indo7

T> 4@>5*@ *=;> >/>;* @4 >;. C =;>= >;> ;


28/287

CHAPTER 2

e5:oard

S*5:9 :;>44 > J =. K>>: > 4:@>

; = 4@>5*@ ;; >>= < ;>4> > 9 :4> ; V*> 5> 44* > HOME


29/287

COMPONENTS LINKS

3

Components &LinksTHE BASIC ELEMENTS OF A SCHEMATIC

) 2! )


30/287

CHAPTER 3

C > ;*@D4 = 5 >4> 4*@ >9>5>4 *4 >44>*9 *;= > @: +99 < ; *4

* 5 =>*9 *4 *5>.

Components

C @*5*@. E@ :>;99 =>*>= 4D. T>

;> ;>:;>4>>= ;>@9; 9= C@;

9>)= 4 J ;> @99>= I: C@4> :; > @;*>= 4D.

T> @@ ;> @99>= O: C@4> :; *5:9> > S;* R>:9@> @4 3 *:4G > 4;*( > ::9@>5> *4 < > 5=> = > > 4;* < > *4>;>=. T> 5=

4;*.

) 30 )


31/287

COMPONENTS LINKS

"inks

L*D4 =>*> 4 ; *: @@( = ;@ 9*D *4 ==>= >;. I ; @4>4 > = *4 4 5>;>=.

) 31 )


32/287

CHAPTER 3

In+inite Feed$ack

L*D4 @ > @@>= ;> >>=@D :4. H/>;( * 4

@*;@54@>4 *4 5 @;>> ***> >>=@D 9 4 *99 ;>>>+ >

>@>= 9*DJ4. A ; 9*D *4 4= =4>= .

F; 9*D4 @ < @*= J 4;*@>= 9>;

< :;>/> > 4 9>> 4;>5( :>=@D *4 94

99= * >4> @4>4.

A =4>= 9*> *=*@>4 > ***> 9 < ;* 4 @>4 ;>

;*>;>=. A == 9*> *=*@>4 > =*;>@*. ;* < 9> 4 = *4 >*

>;>=.

F; 9*D4 ;> ;>9*/>9 ;;>. H/>;( > > =< @ > >4*9 9= >@4>

>/>; 5 @;> >9= * ;>= = *> 4;*:>=

; = = 4* >;> *4 >;;.

I ;;@ />99 > < > ; 9*DJ4.

) 32 )


33/287

COMPONENTS LINKS

Handin6 3ro=en Lin-s

S<


34/287

CHAPTER 3

%o*+onents

Addin& a Component

Dra66in6 3ro* t;e Too:o8

T< == @5*@( 4*5:9 < < >


35/287

COMPONENTS LINKS

Addin6 fro* t;e >ri6;t?cic-> &enu

"5*@ )

4/* :>=* 4 @4 @; ::>; * > 5>; * > 4@D ;*)@9*@D @ > 5>; >= 4 =; >5 @;.

) 3& )

Stac! indicator


36/287

CHAPTER 3

e5:oard S;ortcuts

A4 @ 5*9*; * > 4 ;> *4 @>;* 4599 ;>9 ;4. I ; < 4/> @


37/287

COMPONENTS LINKS

Disa:ed %o*+onents

O 4 =**= < >; 45 ;@ 4. H** ;>; > * > 9>@>= @ 4@>5*@.

) 37 )

S'mbol indicates that thecomponent cannot be added atthe current location in theschematic


38/287

CHAPTER 3

Selections and the Action Panel

T< 4>9>@ @

@*9. T*4 @; >> @ N :>=* :> @>= ) 5 4> 9>;.

T> @ @*9 @ 94< > */= ; 5>

; = > @ 5>. T< > > @ 5>( ;*)@9*@D

@99 4 > 4>9>@>= @= * @9>@>= *99 94< > @;>= :; 4>9>@*9>@.

2. C9*@D = 5

@;4 < M.

3. ; < > =>4*;>= :4>

> 5 4 > => >;>. W* @9>@>= 4> > @;44 <

5 * :( = .

) 38 )


39/287

COMPONENTS LINKS

-amin& Components

" @. T*4 *4 4 9>9 @ > 4>= < ;>5*= ; N 5>. A9>;*/>9 9>@ > @44 CTRLR.

A >=* ; > @ > 5> >;> > :;>44 ENTER( TAB =* 5> > @*9 = ;*)@9*@D


40/287

CHAPTER 3

eletin& Components

>9>* @;>5>9 >4. T> *@D>4 < =< *4 *4 < 4>9>@ * > :;>44 > EL

D>. "44 > X 9>>.

*esi.in&

S @ ;>4*>= <

5D> >5 *>; ;. S

@ />;*@99 4 >99.

I @ ;>4*>=( > ;>4*>

@ @*

@4 >

@; 4>9>@*4*>(

5

;>4*> @ < > ;>4*> @;4.

) $0 )


41/287

COMPONENTS LINKS

,ultiple Selections

"9>@ 59*:9> @ 45> *5>. T*4 *4 4>9 * 9 < 4 < @;>> 59*:9> 4>9>@* *;4 *4 < @>=( @9*@D* 5 * ; 4>9>@*; < 5D> 59*:9> 4>9>@*9>@. T*4 */4 =;* @9> <

>@9 99 > @@.

To dra6 seect@

1. C9*@D 5*@ < > @@.

2. H 5 = 5 = ;*. "> == ;>@9>

::>; 4 @@>= 4 5 4< > > 4>9>@*4> >


42/287

CHAPTER 3

Connector "a$els

M *4+ >>;;>=.

C94 ;> 499 />; 45*=>; @ @@(

==**; < > 9> = ;* @= >9>5>4 4@D : >

95>4.

) $2 )


43/287

COMPONENTS LINKS

Lin-s

I *4 4>@*9. "> 9*D ; = = 9*D.

Creatin& a "ink

L*D4 54 4; *: @@=

== 9*> ;>:;>4>* >

:*9 9*D.

3. K>>: =;* *9 4 ; >

*: @@

:*9 9*D *99 4: <

> @@

> 9*D @ > =.

$. R>9>4> > 5 > > 9*D.

) $3 )


44/287

CHAPTER 3

Allowed "inks

S*5>4 * *4 9*D >>> :*; 4 >

5 @;4 < 4>;9 9*D4 @ > 5=> >> @@ :>. H/>;( >;> ;> 4>/>;9 >@>:*( F9 @@>= 4<

@ F95 @@

=>4@;*:* >@>:* ; & C;* B>>> T:>4 103.

,ovin& a "ink

" >= == @= : >

9*D =.

3. ; > 9*D < ; *: @@9>4> > 5


45/287

COMPONENTS LINKS

eletin& a "ink

T>;> ;> 4>/>;9 4 < =>9>> 9*D. ".

%4 5 * ; *: @@4@;*>= =


46/287

CHAPTER 3

"ink 0rder

W> >;> ;> 5 9*D4 >=* > 45> *: @@ ; 9*D4 @ >@ >

>/* :44* S;* = < 4;*@@ *;4 4;* < ;;*/> *99 /> > 4>@=>= < *.

T> ; = ; 5;D>;. T*4 *4 4>;*>4 ;:>=*@9; < > 9*D

*4 >= : *;4 9*D * > ; 4 < 5;D>;( > 4>@; *

*;= 4 < 4 >@.

%;an6in6 t;e Order

I4 4>9 < > 9> < @> > ; ; *99 >@ >

;.

) $6 )


47/287

COMPONENTS LINKS

Bendin& "inks

I @ 4@>5*@ * 5

@4 4;* 9*> 4;>; =

>4*>; < ;>=. A99 < =< *4 @9*@D 9*D = :99 * *< :9@>.

E@ >= >4 @=* @> @ P.

T< ;>5 99 > @ 4;* 9*> *( 4>9>@ S;*> L*D

; @ 5>.

) $7 )


48/287


49/287

COMPONENTS LINKS

Strai&ht "inks

I 4@>5*@4 * 9

> 9*D4 = .

" 9*> > * = > 9*D J4

=>4@;*>= >;9*>; = >> =>4*>= 4 =.

I 9;>= ==>= @ >> @;/>= = @>@D


50/287

CHAPTER 3

Auto "inkin&

T< >9: /> >

A;>. W>

*4 >;> *4 4*@>= 9*D >>> <

@@=

*;>= *: @@ >4> @= == 9*> *99 ::>;.

T*4 4>44 >;> > 9*D @;>>=. I :4> ;5>.

I @;>>= : > 4>4>= 9*D

@9*@D* > ;* 5 ;> ;> 4>/>;9 =4>= 4>9>@* S@>5*@ ; O:*.

" > *5> >>> 4>4** 9*D *4 4>4>=. I ;*)@9*@D 5> 9*D >

> < 9*D* < 4 9*D4 = ;> ;.

) &0 )


51/287

COMPONENTS LINKS

Smart "inkin&

I >= < 9*D 4>/>;9 @; *@D9 > > 45; 9*D* >;>.

S*5:9 :*>; @9*@D > L*D C.

T> 4 *99 5D> >4 >44 = >;. I

> @*9 > 5 :; ; > 4

*99 *=*@> > 9*D4 @;>>=.

S5; 9*D* *4 4>9 * 4>/>;9 @


52/287

CHAPTER 3

*emovin& ,ultiple "inks

"5 99 > 9*D4 * 4>9>@*@* />; 4>9 > 9;>

4>@*= <

=*4@@

Swappin& "inks

S*5>4 :9@> @5*@ * ; @ 5 > > @:>; < 9>;


53/287

COMPONENTS LINKS

Wireless "inks

W*;>9>44 9*D4 :; 5>@*45 ;;@ *> :4*@9 9*D. T> ;> 4 9*D> *;>9>44 > ;>9


54/287

CHAPTER 3

W*;>9>44 9*D4 44 =4 4 ; 4 > > *;>9>44 9 45> 9>9 =

@@.

T> 45> *;>9>44 *;>9>44 *:4 = /*@>)/>;4 4< 9

@;* =>4@;*>= .

T>;> *4 ; *;>9>44 @= M W*;>9>44 O:. T*4 *4 4>= < 5D>

*;>9>44 5. S>> > M4 4>@*:* 5*@4 *= > /> =G > @ >

*> =**@9 < /> > F44 >;>.

T< 4> *4 4*5:9 4>9>@ W*;>9>44 I: 9>44 O: = >*>; ;*)@9*@D = 4>9>@ F44 ; 5> 44 > TAB D>. T> 4@>5*@ *99 5: < > *;4 @@* *;>9>44

O: : 9*D *99 94< > *=*@>= N/*


55/287

COMPONENTS LINKS

T> @@* *;>9>44 @ *9*>= = 9>9 >9 ;> = > *=> *4 @;;>9 *9*>=.

" ;*)@9*@D 5: 4@>5*@ = 4>9>@ N> W*;>9>44 C99 @ 4 W*;>9>44

@9 /> 4=;= = M*M.

W> < 4>> > M W*;>9>44 O @= M *4 @@* =< *4

4>9>@ > @44 > TAB D>.

T> 4@>5*@ 5:4 < > *;4 W*;>9>44 I: @ @ 4>>

; *9* *4 *4 @


56/287

CHAPTER 3

T> 4@>5*@ 4 : ; 4@>5*@ < *4 @ *;>9>44 @@*@4> > 4>9>@>= M W*;>9>44 O: > @@*;9 4>> > ;>@>*/>; *4 *4*=> > T< 0)1 5 *4*=> P;>4>.

I > @ < >99 < < > 4>@9>44 I: = > @D < > 4. A*( >@4>

>;> 44 O: > 4 *4 4 :;> 5.

T< 4


57/287

MOULES

4

ModulesM ANA#IN# COMPLEXIT"

) &7 )


58/287

CHAPTER $

"@99 ; *;4 =

54. A :;*5**/> 4 :;>=>*>= >/*=.

A 5 ; = 4 *4 >/**>= 4@>5*@. ";9 >/* 5= < =< /*;99 * 5 @ ; ;5*@ = > >5: 5 *4 4 ;> @*9 ==**>= 4 */>;>=

;*9>. B :;>44* *4 *+4 4@>5*@ = ;;>

=>*> > 5+4 >/* />; 4*5:9> * @: > ;> >;>5>9 :;9. T> @ > 4>= < :;** ;>4>= * = *. T> ;> >44>*9 />; 4*5:9>4 5*@4.

) &8 )


59/287

MOULES

e5 Differences

A:; ; @ 5 4 *+4 5*@ >;> ;> > ; D> =*>;>@>4 >>>

M4 = P;*5**/>4. T*4 4>@*;>@>4. M =>*94 ;> */> * 44>>

4>@*;>*>= ;4 > > 94 :;*5**/> 4 =;D ;> ; * =; ==**4 9>44 @:*9**>4.

M 4> 9>;.

) &! )


60/287

CHAPTER $

Front Panel

A 5 @ /> ;9. T*4 *4 49 = :;4 *>;@*/>

4;@> 5+4 4@>5*@.

Properties

I ; > *4>= 4 :>9. A* > :;;*>4 :>9 *4 =>*>= >

5+4 4@>5*@.

) 60 )


61/287

MOULES

#ool$ox

T> *9 D> =*>;>@> >>> 5 = :;*5**/> *4 5 @ > =;>= < >


62/287

CHAPTER $

Basic O+erations

"/>;* < 5 . "9>> *( 5> *( 5 *

;@. T> D> =*>;>@> >>> 5 = @5*@.

,ovin& into a ,odule

W* 5 5 4 < =< > 45>

*. M@>:**>;G

1. C9*@D > M *< M

9>@ M *< M ;

@ 5>

$. W* > 5 4>9>@>=( :;>44

> P#UP D>

T> S@>5*@ W*= < 4 54 5*@( > N/* < ;>9>@ *4.

T< 5 @D *>; ; *)@9*@D = 4>9>@ M < P;> 44 > P#N

D>. "5*@ N/*


63/287

MOULES

Inputs and 0utputs

T< > *9 > ;4. T< 4/>

@;5*>4 > ;

*:4 5 *4>9. B 4::* >

/>;*@9 : ;9>4 ::9 < >


64/287

CHAPTER $

#emplate Connectors

T> @@ @99 T>5:9> C@4> /> < =>*>= :>. T>;> ;>< 4 < >5:9> @@ ; :> >:9*@*9 ;*)@9*@D* @@.

Input and 0utput -ames

I >4> *99 > =*4:9>= > 9>@ = 5 9.

I >/> 5 @> * @9>5 *:


65/287

MOULES

,ake ,odule

"= < 4>@* 54

* ; < 5> > *@;>4* @*. "4*9 4* > MD> M >;>.S*5:9 4>9>@ 5>; MD> M 9>@*@*9>@ MD> M.

T> 4 *99 @;>> > 5 = :9@> > 4>9>@>= @ J> 9=. A 5 *: >= @ 9*D @@4 <

> 4>9>@* > @@>= < > *:4 = 5 *4>= 4>9>@* 5>*= >;9*>; 54 @ /> :;;*>4. T>4> >@

5 9 5 4 :;;*>4 > :;;*>4

4 ; P * > @>;>.

W> :;;*>4 5 *99 >:= < 4 :;;*>4 :>9. W* >:>9 ;>> < 5D> @>4 :>9 *99 > ;>5* *9 9 =*4:9

:>;5>9


66/287

CHAPTER $

Wireless ,odules

M *>= 5 9>44. I4>= 44 O: @9>44 @4 *;>9>44 5. T> 5 *99

>/> I > 45> 4 W*;>9>44 O: @49*4* *;>9>44 9*D4 * 5@*

W*;>9>44 I: @;;@.

A4 * W*;>9>44 O:4 5@ *4 =>>;5*>= > :> 9>44 54 @ > *=>**>= > *;>9>44 45;4 5 ; ;> > < 9*D4 /> >> >49*4>=. H/>;( * 9>44

O:4 ** > 5 /> >49*4>= @@*9>44 I:4 > *;>9>44

45


67/287

MOULES

3ront /ane

E/>; 5 4 > 4 < 5*@ = > ;> > 5>@*45 *@ ;

*>;@> J#UI 9 > ;9 *4 =*49>=. T< >9> *( 4>9>@

> 5 > @9*@D > G J#UI @ E9>

F;9.

I 4*> > 5 > ;9 *99 ;>4*> @@


68/287

CHAPTER $

%ditin& the Front Panel

W> D;4 = ; @ >4>

*>54 *99 *49 ::>; ;9. H/>;( >/>;* *99 > 4@D>= : * > @;.

I ; < ;;> > *>54 >= < 9 ;9. F*;4 4>9>@ > 5 > @9*@D >

:=9 :>9

*9> > 5 *4 4>9>@>=. W> > 5 >@4 =>4>9>@>= * *99 ;> 4 * > :>9 4

9=.

) 68 )


69/287

MOULES

Selectin&

"9>@ *>54 * > ;9 * > 49 @9*@D* 5. I @*> ;*= 4;>4 = :*>94

@9*@D* 4>9>@*.

) 6! )


70/287

CHAPTER $

,ovin&

H/* 4>9>@>= *>54 5 >5 =;* >5 ;9 > : *4 ;9 *>54. T*4 45> 4 9>@ > *>5 4*>. T> @*4*>

@.

N >@4> >@ *>5 * > ;9 *4 @99 > ;9 ;> 9;

= *>;;@( ;>4** *>5 *99 ;>4*> > @4: 4@>5*@.

) 70 )


71/287

MOULES

(umpin&

I 5 *4 ;>:;>4>>= ;9 *>5 > 99 >= <

=< *4


72/287

CHAPTER $

Su$1Panel %ditin&

E@ ;9 *>5 *4 5 * *4


73/287

MOULES

Hidin& Item Boundaries

W> >=** ;9( >@ *>5 4 *4 = * ;>@9>. I >=** 4

:>9 *>5 > 4 54D* ::9*>= 4 >99.

S*5>4 >4> *4 @ > * > * >@9 . P;>44 *4 D> * <

;>; *4 < 4 *==> > *>5 J* *4 4>9>@>=.

H/>;( 4*9 >>> 444* > X D>

59*:9> *5>4.

raw 0rder

I 4>/>;9 *>54 ;9: * >@ ; > >;5*> *@ 4 ::>; . R*)@9*@D 9>@>= *>5 J54 = :

*99 ::>;.

" @>; < ;* 4>9>@*


74/287

CHAPTER $

T< > > *>54 @D *< /*> 4*5:9 ;*)@9*@D 5 = 4>9>@ B;* P>9 I>54 I<

V*>. T*4 5> ;.

) 7$ )


75/287

MOULES

3rouped Items

S*5>4 ;9 *>54 ;> ;= >;. T*4 *4 =>>;5*>= > > 54 ;>

@=. W>+99 9D ; *>54. T> 54

>/> =*>;>9 ; ;> @= < ::>; * > 45>

=; ; ;>9*/> < >@ ;. F5:9>( * = *>5 * > ;

; *>54 * > ; > > 5>; ;.

) 7& )


76/287

CHAPTER $

W> > ;9 *4 9= > *@D =;D ;> ; ; :>9 >=>. T*4 =>*>4

> @9*> ;>. " ;4 ; > 4*> @9*> ;>. W> >=> *4

5= ; @4 > >=>

>@4 =>@>= ; 5 > > 5 ;>4*>4 9>44 * *4

= < =< 4 ;9

5**5** > 5. F*;4 4>9>@ > 5 > @9*@D T M**5*> @ M**5*> F;9.

T> 5 *99 ::>; 4 * * < ;9 >;> :;>4>. " > 5

* < 4 ;9 * ; 45> @*;> ;> 4 @*;@54@>4 =>; *@

5 ;94. F5:9>( 4* D*9 *>54.

) 76 )


77/287

MOULES

" 5 4>9>@* > 5 = @9*@D* >> @*9 J@ S P>9. T> >> 5 *99 4 5 ;94.

T> S P>9 ;*@*


78/287

CHAPTER $

/ro+erties

W>+/> 9;>= 4>> 44 = @> > :;;*>4 >;> *

> *;4 :9@>? I *4 4>@* :;;*>4 :>9 99 >= < =< *4 4>9>@ > 5 = @9*@D > /


79/287

MOULES

Addin& Propert! Items

T> *>54 :;; :>9 >@ 5: ** > 5

;> ;> 4* =*>;> :>4 9>= 4 :>9. T> ;>G I( F99>@; B9> 4> @@ P;;. "> 4599 * 9>>; P * > 5*==9> ::>; * > 4>>= @9.

) 7! )


80/287

CHAPTER $

I 9 < > @ 4>= ;9 < *=>* > @9 > > :;; @= @4 4 @4>4 * P;;*>4

:>9. T>;> ;> 4 ;>> =*>;> :>4 = E=* @ /> 9>9 *@ D>4 *+4

> ; 9>9 @@D 4 > > ; 9>9 B


81/287

MOULES

T> T;*>; B4>>= *4 D> ; 9>9

44*>= < > T;*>; B S>9>@@* ;= 4

=;4 > > @


82/287

CHAPTER $

%ditin& the Properties Panel

T< >=* > :9( >@9 > 45> 4 @9 > 45> 4 ;9. "9>@ *>54( =; = => *>54

; >5. S>> > 4>@* 4*> :;;*>4 :>9 @ > =4>= *=>:>=>9 4*> 5. W> >

:>9 *4 ;>4** 5 *99 :;;*>4 :>9. W> 4 :>9 > 5 *99 ;>; < *+4 .

Customi.in&

" 4;*@>= < > ;>> @4@;*>= >;9*>;. B>@4> > :>9 >; ;9


83/287

MOULES

T> >5:9> >9


84/287

CHAPTER $

S5nc;ronisin6

" 5 4@>;>= ; >>*4 = > * * 5 ; :9@>4.

H/>;( ::>4 > > >/*99( ;*9 = < @> 99 = @ 4>9>@>=. W> 4@>= 5 *4

4>9>@>= > > 4@ @4 4@>= * *4

. T> @ > 45:;>4>4 59*:9*@*;.

) 8$ )


85/287

MOULES

S!nchronise All

I = @4 * 4@ > =+4 >4 < : >5 99 * 4@ >; > /> >> @;>>=. %4 ;*)@9*@D 9>@ S@; A99. A99 > 54 5@ > 5 = *99 > : *<

4@( ;>;=9>44 ;> > ;>4*=> * 5*@.

N * >> 9>;>= * > > @ ;@*/> 4@* > /> > S@; P*>; >;>. T*4 *4 5

4 *< *@ 99

@;4 < > 4@; :*>; @;4 ; 5 4@ *

*4 99 >= < =< *4 @9*@D 5 *4 *=>*@9 = 4< @ > 4@>= > 5 ; *99 94 9> < *=*@> >

;*>=>=.

" ; > S@; P*>; *4 4*@>= ; 5 S@;

P*>; 9( ESC D>. I ;=**

;* S@; P*>; *4 =*>9 4*@ =** 5.

) 8& )


86/287

CHAPTER $

*emovin& S!nchronisation

" < 4 4.

T>;> ;> ;>> 4 < =< *4. " > S@; P*>; 4 =>4@;*>= . F99

*@D < ;>5 4@* 9>@ U)4@; A99.

T*4 *99 ;>5 4@* ; 4@>= * > =.

"5 4@* 4*5:9 4>9>@ > 5= :;>44 > TAB D>.

T> 4 *99 5: < > > 5 *4 * 4@. C :;>44* < @@9> ;

54 ;> 4@;=. E/>99 ; @D < > 5 = *.

" ; 4@>= 54 * >


87/287

MOULES

3ocus &ode

I *9=* ::9*@*:4 /*> * /> 4 4> *

* >=** *>;@> >* * > . ";> @99>= F ::9*@* 9>@ F* F @9 44 > ESCAPE D>.

Focus on the previous ,odule

"/*> @ *5>. "9>@* F 5> 9>@* F 94 = 5 *99 > 4>9>@>= * *4 @4> ;>;=9>44

4>9>@>= * > 4@>5*@ > *5>.

F


88/287

CHAPTER &

5

Data Types &Signal FlowCONNECTOR T"PES EXPLAINE

) 88 )


89/287

ATA T"PES SI#NAL FLOW

F9 :>4 4 *+4 ;> :>4 99 99 *< > =*>;> @>4G S;>5( T;*>;>= .

Strea* = @;4 99 =**9 =*< = @ 4*94 ;> 9@* 45:9* ;>

= 4< @5 *99 94< :>;;> . W>;> 4;>5 = *4 @. U499 > >/> *4 4>; *>;@* *>;@> @;= ;.

E9ent = *4 4*5*9; < ;*>;>= = * * 94: < 4 >/>. H/>;( > *

*@ * 9 =*>;>.

N * > /4 5 ; ;> >

>@>:*;>= = :>4.

) 8! )


90/287

CHAPTER &

Strea* Data

I *>;>4>= * =*< ::9*@* >= < 5 =. S;>54 =>9*/>; * = ;> =**9 4*94 *@ :;44 * >

4. T*4 *4 D 4>@* .

i&ital Si&nal Processin& in a -utshell

W *4 SP? W>99 9>4 4; * si6na *@ > *99 =>*> 4 > @; ; *5>. T*4 @ * ; >5:>;;> .

I > 4*9 *4 :44>= *< ;9 4 9*D> 5*@; * >>=4 <

> @;>= ;4;* > 5*=>

4*9 ;>:>>=9 ; =*4@;>> *5> *>;/94. E@ 5>4;>5> *4 @99>= 45:9> = > ;>49 *4

4;>5 ;4 *@ *4 > di6ita 4*9.

T> :;44 *4 @99>= 45:9* = > ;> *@ 4;> *4 @99>= > 45:9* ;>. T>

54 :>; 4>@:;>4>>=

4 ;>>@ $$.1 K *>; ;>4 ;> 94< 4>= < > *>; 9* 4*94.

T> +rocessin6 :; 4;>5 ;4 ;>:;>4> > =**9 4*9

= @;* >5 *< ; 4;>5 ;4 ::9* 4 @;> 4 *4 * @ :;44 >4> 45:9>4 *=*/*=99 45:9* ;>. M

::9*@* < :;44 @@*; * ;5>

* ; < D>>: @: 4> @@>:9> 9>/>94. T*4 ;>4;*@* :;44* :4 4

>;> *4 ;>*;>5> < :;44 */> 45:9> 4>= 45:9> :;>@>=>= *. T*4

4**= >>=@D = 4*9> 45:9> >>=@D *4 @:*9*


91/287


T>;> ;> < 5* 4;>5 = :>4G /o5 = &ono. P>;>= ;;* =*< * *4 > 4*9 45:9* ;>. A 4> />9 4*9 :44* ; ;> 4*94 :44* ;4: < MII 4.

T> 5>; >;5*>= > 5>; * :9>=. I >;> ;> < 4*94 >

>;> *4 < @: *. H/>; > >;> ;> F94 SSE( 4> />; $ .

Poly connector - represents multi-channel audio signals. Each channel is an independent

fast moving stream of floating point data that fluctuates at sampling rate. The data is

multi-channel because there is one channel for each note that you play.

When to 'se Pol! or ,ono

"


92/287

CHAPTER &

P; > :;44* ::9*>= @59*/>9 @ / JP


93/287


Stream Connectors

"> 54 @ > 4>= * P;4* :> @@


94/287

CHAPTER &

Pol! and ,ono Sections In Audio Applications

T< > = < 9 :@* @>:*; < 9


95/287


Boolean Connectors

T>;> ;> B*/9>4 P4. T> ;> >

@ *>>; >*/9> P. I *4 4>= #;: < P *=>* *5>. F94 99 4> :;44*

4;>5 =. T> ;>49 *4 >@*/>9 :;44 : < $ @>94 > 45> *5>

45> @: @


96/287

CHAPTER &

,ono 4

I 99 < > > >4 :>; M 4 > =*>;>@>< :>;.

M@* F94 SSE *4 :;44 @

= @: @ =/> /> > P@D =

U:@D @4> 99


97/287


Tri66ered Data

How it Works

T;*>;>= = /> ;4+ @>. U*9 *4

::>4 4>@*= = ;>5* * 4>= 4>.

W> >/> =4 44> @99>= T;*>; *4 4> >@>=. A >@>44; ;>@9@9* >

:>;= = ;*>; *4 4> 5*@.

T> >5:9> >9 >5:9> ;4 >* ==>= >;. W> * F9/>4 >+/> >> 9D* ;

9;; >*4.

N =;* > ;>@9@9*4 /9>4. T*4 * *4>9 @ @4> 9;; 44>4 < > 9>.

) !7 )


98/287

CHAPTER &

What it5s 'sed For

T;*>;>= = 4 < 5* @*. S>@9 =>*9>= = @ 4>;

*>;@> >9>5>4 *@ >= < ;>4: ;@ * >5.

A4 >>;9 ;9> > 4 SP *4 =9>= > S;>5 = = > 49; SP = 4>; *>;@> *4

=9>= > T;*>;>= =.

#ri&&ered ata #!pes

T> /;*;>= = :>4 @ > ;= *< 4>/>;9 @>4 4>= :*; :;:.

/ri*ar5 T5+es

T>4> ;> > 5 ;>:;>4> 4*5:9> = 9*D> 5>;4 = >.

Float - a #$ bit floating point number

Int - a #$ bit signed integer in the range $%&'&(#)&( to $%&'&(#)&(

String an alphanumeric string of characters of unlimited length

oolean one of two values* true or false

Trigger - not really a data type +there is no data, but used to pass trigger messages

Arra5 T5+es

T>4> :>4 ;>:;>4> ;>4*9> ;;4 4. A ;; *4 4 ;>= 9*4 54 45> :>. A;; :>4 /> + :>; *4>= .

Float "rray array of #$ bit floating point numbers

Int "rray array of #$ bit signed integer in the range $%&'&(#)&( to $%&'&(#)&(

String "rray array of characters strings

) !8 )


99/287


GUI Data T5+es

T>4> ;> 4>= =** 4< = < D #UI @= < > @. N5>;4 ;> @4( 4;*4 ;> @4( ;;4 ;>

@4. O4*=> > 45> :>G VALUE 4< > >> R @ @@


100/287

CHAPTER &

S+ecia T5+es

T>;> ;> =9 4 4= *;


101/287


E9ent Data

How it Works

L*D> ;*>;>= =( E/> = . U*9 *4 ::>4 4>@* = ;>5* * 4>= 4>.

W> >/> =4 44> @99>= E/> *4 4> ;> ;> < *5:;>@>4. F*;4

> E/> @;;*>4 = * *. T> T;*>; 44>5 4 =(@ @99 @D J< > 9> < @9@9> >*; /9>4. E/>4 @;; = * >5. O@>

>/> ;;*/>4 @;> *4 < @99* @D.

T> 4>@;>@> *4 E/>4 ;> 4@>=9>=. W> >/> *4 *;4 @;>>= * *4 */> *5>

45: = *99 >>@>= > *5> *4 ;>@>=. T*4 5>4 @* >@9

> /> < ;>4 99 * > 4;>5 = 4< =9> >/>4 < @*4> 45:9>.

C;;>9 > E/> = 4 < > R @> > R C@*


102/287

CHAPTER &

%vent ata #!pes

O4*=> R C4 > E/> 44>5( R V9>.

I R 99 = *4 @;>= < > @. N5>;4 ;> @4( 4;*4 ;> @4( ;;4 ;>

@4. O4*=> > 45> :>G VALUE 4< > >> R @ @@99 =*4@44 *4 * 5 =>*9 * > R C@*


103/287


%on9ertin6 Bet7een Data T5+es

I 54 > 9*D4 >>> @@ :>. H/>;( F9;9 @;4*>> = :>4 *@ ;>5>9

=.

I 54 > 9*D4 >>> @@ :>. H/>;( F9;9 @;4*>> = :>4 *@ ;>5>9

=.

Strin& 67 Boolean

" ;


104/287

CHAPTER &

Int 67 Boolean

B 94< *>;@>9>. '>;< ;>:;>4>4 94> /9>( ; /9> *4 @;>=

< > ;>.

Strin& 67 Float 67 Int

"> 4;*4( 9


105/287


Int8Float 7 Pol!8,ono

A F9= < P 4*94 5** @/>9. "; @@ P


106/287

CHAPTER &

,II 67 Strin&

T*4 *4 *> >5.

A4 *4 *4+ @;4*= < + MII < S;* 9*D4 9*D*.

3oat Arra5 C Strin6

"4*9 @; >>> 4;* = 9


107/287


Strin& Shortcuts

T> S;* = @ 4>= 4 4 =>*>= * 4*9> > 4;*.

Area

T< @;>> ;> 4> > ;> = */> > @; ;> = =

*/> > *= = >* ;>. A99 =*5>4* * ;*= 4;>4 ;> ;> < 4 < 4:>@* @


108/287

CHAPTER &

T> @ 45> 4 @** @ . T> *@D>44

*4 94. T> 49> @ > > 49> :;5>>; 9; 49> *99 > 445>=.

) 108 )


109/287


Strin63or*at

S;*F 4:>@**>= 4* > (;9*. T> 49> @ >

@


110/287

CHAPTER 6

6

$%portingCREATIN# STANALONE APPLICATIONS AN PLU#INS

) 110 )


111/287

EXPORTIN#

%reatin6 Standaone A++ications

F9 4>= < @;>> @> ::9*@* S=9 ; :.

T> C;>> S=9 A::9*@*


112/287

CHAPTER 6

A++ication Icon

" =>9 *@ U4> >9 /*> *@ 4 *99 4> *4 4 @D *4 *=>9 = 44>54.

Incude conte8t *enu for =oo* and e8it

T*4 ;5*>4 >>; > =>9 ;* @9*@D 5> *4 :;>4> * := >>. T*4 5>

99;4 >> < @> 9( 5 < 99 4@;>> = >* > ::9*@* E4@:> D> 4 5>4 ** >;>= >>. I4 4>9 >;>


113/287

EXPORTIN#

T>4> =45>4 @ 49 >>4

;> 4>= ;> SSE @:*9**>4.

%reate 7a9eta:e .dat fies for faster oadin6

T> S9>4. T>4> ;> >>;>= >= : > >> 9.

Incude &IDI and Audio &enu

F>4 * =>9 5> 99;4 < 4>9>@ MII

*: = A=*< >9 >>;>= ::9*@*5: < > =>9 =*< =;*/>; > > >>

9@>4.

C9*@D C;>> = ** > 4>@ @;>>= * > ;> 9= > L@ O C*=>@ > : :; :;>):@D>= *499>;4 9*;;*>4 . " ;>> < =*4;*> >4> *

> ;> :;=. F :>G

:G .=4:;


114/287

CHAPTER 6

%reatin6 /u6ins

F9::>=> VST :9*4. VST *4 *=4;

4=;= >= S>*>;. A VST :9* *4 /*;9 =**9 >>@

:;44 4>= * VST @ ::9*@* 5>@*45 * :9* * F9; 4*5:9>. A99 >= *4 5 * @@>:9> @= *:4 = >/>;* 4 * >>> *4 :

< = MII *: = < 5= 4>;>< =*< = 4>= ;@4 @ /;. "> MII >>@ *@ D>4 MII *: = MII @ >= < 54* ; VST ;> > :9* ;44 > @


115/287

EXPORTIN#

Create 2S#82S#i ialo&

T< @;>> VST :9*( 4*5:9 @9*@D > VST VSTVST* ; S@>5*@ 5>.

W> VST 4>>= * > C;>> VSTVST* =*9


116/287

CHAPTER 6

/u6?in "a*e

T> :9)* 5> *4 > 5> =99 *99 > >>;>= = > 5> *99 > 4>= > >

:9)* *4 9*4>= * 4 *99 4> > 5 9>9. I >;> *4 < 9>9 >

=*9 =.

T;is +u6?in is an

T> :9* :> *99 > 4> = @@ *99 > 4>9>@>=.

#endor , #ersion

T> />= *4 ; *> I


117/287

EXPORTIN#

T< @;>> > :9* @9*@D > C;>>


118/287

CHAPTER 6

U4> > P;>4> M>; :;;*>4 < 4> > ; 4 = >>; >

:;>4> = *4 < > 9= 4>4 ;> 9= @>4 < >5 ;> 9 :;4 < >:= :9*4 4 >99 4 *4*=> SMD>;.

#imin& In+o

S VST :9*4 =>:>= =.

T:*@9 >5:9>4 ;> > 45:9* ;>( >5:< = >>; > >@>; *4 :9*. " @@>44 < 4@ * @G

S5:9> R>( T>5: S*;>( >9 C4*


119/287

AVANCE #UI EITIN#

7

"danced 'UI$ditingTHE #UI COMPONENTS AN HOW TO USE THEM

) 11! )


120/287

CHAPTER 7

&odue GUI

I > M4 @:>; > 9>;>= 9> 5+4 ;9( == *>54 < * = 5

>5 ; 4>= 49*=>;4( D4 ; >54>9/>4 54

>*; ;94 ;> @= 4* #UI @; > > @; =>*9


121/287

AVANCE #UI EITIN#

C;>> > 5 > =; > 5 < 5D> > :>9 *>; ;. " # > ;>5= ; @*9.

,3'I Connectors

A99 #UI * ;> >994 * V * > 5*==9>.

T> M#UI 4 V*> = < *4 *99 >*>; =; ;9 5 5>44>4 ; < F9= < > > 4*> ;9 * *4 *4 >>=>=.

F 5 = < D=. W>99 @; *4 * 9>; 4>@*


122/287

CHAPTER 7

3'I Connector #!pes

T> #UI @ 4> 4. E@ :> 4 *4 99 * @9>=.

W> 4 >4> *;4 * > @:>; 4G

#iew transports all drawing and mouse information

"rea an are defined by coordinates of top-left corner! a width and a height

Mouse mouse events +left button updown! mouse move etc.,

Colour in argb format +a/ is the transparency level,

Pen for drawing lines defined by colour! thickness and style

Font font information comprising typeface! si0e and style

String Format alignment information for drawing te1t

itmap #$bit image

Point "rray an array of points +floating point pairs,

itmap "rray an array of bitmaps

) 122 )


123/287

AVANCE #UI EITIN#

Coordinate S!stem

F94 ;*= 44>5 < :5 *4 4>= > /4 5* ; @ > 4@;>>

4>4 :*>94 = >4> > ;*= =>;* >@*>4( F9 >;>


124/287

CHAPTER 7

Dra7in6

T*4 4>@*4@;*>4 #UI @ *;; = @@* > V*>

V*> *: :;*5**/>.

A99 > =;* :;*5**/>4 @ > 9>@* > #UI *9>; ;;> ;> :;*5**/>4 4( ;>@9>4( >( *5:4 = 5.

T> >5:9> >9@9>. W>/> 4>= 9*9> 4@*

> A;> ;>@9>. T*4 5D>4 4> ((*= = >*

=>*> > A;>. T> @= 4* > @


125/287

AVANCE #UI EITIN#

rawin& 0rder

O> =;* 5 >9>5> 9>5>4 ;9: > >

*4 94 * > 9*D ; *99 > =*4:9>= 94 = >;> ; > 9>5>.

T> >5:9> >9@9> *4 4>@> L*D4@9> *99 >;> > =;


126/287

CHAPTER 7

Chainin& 3'I Components

M 5>4 @ > @;>>=.

T> >5:9> >9@ 9*D ; *4 4

;>= ;>@9> *4 D> *;4 @. I *4 >5:9> > ;>= ;>@9> =; =>; > 9> *@

> =>; > .

) 126 )


127/287

AVANCE #UI EITIN#

&ouse Handin6

T*4 4>@*4@;*>4 5 *>;@* M @

*;@>*/> 5 5>44>4 * :; .

T*4 *4 = 4* > M A;> @ >5:9> >9@>*/> 5 5>44>4.T*4 *4 *=*@>= @> * @;4 5 :; :44>4 ; > 5 ;>.

,ouse Clicks

T< ;: 5 @9*@D4 >= M L)

B


128/287

CHAPTER 7

W>>/>; 5 ;> ;*>; *99 > 4> < > T;*>;


129/287

AVANCE #UI EITIN#

,ouse ,oves

" 5 4 * 54 ; 5 ;>. T*4 *4 = 4* > M M

@ *4 >= < >9> 5 5 5>44>4 ::;M#UI @44>4 ;> =*49>= =>9 < ;>=@> >@>44;

:>; ;>=4.

T; ;>:9@* > M ; @ :;>/*5:9> * M M @ 4*>; < 4> ;

A@@59> @ @ 5@ 9> /;*>*>4G X( " = X".

T> " ; A@@59> 5>4 :;5>>; /;*>4 ; :;*@9; ;>. W>

5( > ; :;> = *4 5**>= > @>; *4 :=>= @@ " : @*.

) 12! )


130/287

CHAPTER 7

I 9: *4*=> > B*5: K > K


131/287

AVANCE #UI EITIN#

Redra7in6

*edraw Control

I :;; 9>5> =;* 5 ;* =;*( @>4 < > ;>9>@>= *55>=*>9 * > 5 ;9.

T< 99 =;* >5:9> > 4>= > 4*5:9>4 D*= =; ) > 4 = >

:>9 < ;>;>4. T*4 4 = 4* > R>=; @ 5 > > R>=; @ > @@>*/>4 ;*>; * 4>=4 5>44> @D : ; V*> 9*D4 < > *;4 M#UI * *=4. W>

> M#UI ;>@>*/>4 > 5>44> * ;>=;4 >/>;* =;* > :>9 >@ *5> @ > 49 > ;> *4 9;> J; ;>4** > 5 *

> >5:9> 4< *4 />; * ) @4 49*4.

O> :>9 *4 @* *5> 4< *4 5@ 5 >*@*> < ;>=;

* 4 @>=. F /> > R>=; A;> @ 45> 4 > R>=; @@>: * =;4 > ;> *:.

) 131 )


132/287

CHAPTER 7

W>/> 5= > =; ;>@9> >5:9> 4< * 4>4 > R>=; A;> @ ;>@9> ;> < > R>=; A;> @@4> >

;> > > 94 5 5 5 >>= < > ;>=; >= *4 > @= ;> > ;>@9>4.

F5:9> >/> @;>>= 5 =9>4 > 4 = *4 @ ;>. T*4 4>4 A;> S5:9> = H>: > *4 >>=>=.

) 132 )


133/287

RUB" COMPONENT

8

(u)yComponent A WORL OF POSSIBILITIES

) 133 )


134/287

CHAPTER 8

Introduction

T> R @ 5*9> @ F9( * 99 *5> :;>@*4> >/> 44>5 = *

*>;>4 99 * F9;>= = :>4( 5 >/>4 = ;:*@4.

T> R @ 4>= *4( 4>;

*>;@*=>;*. I ;>99 =4 : 445> 4*@ D=> R 9> *@ *4 =

* *4 *=>. I ;>>;>@> > ;>@= > =* O: P>. T*4 ;> 4;;44>4( = @

= @>= = /9>4. " > ;>9*/> 4*> E=*4 =;*

> 4>:; OO 4>= < :;>/> > R @ ;* >/9>=. T*4 @ > 4>9 *

@ 5* @4> *4*9* *9> * *4 >* :>= * J*9> 95:9>.

) 13$ )

0n/0,, Button

ode #ditor

0utput Pane


135/287

RUB" COMPONENT

In+uts and Out+uts

T> R @;@> * 5;>= = :>4 * F99 >

@ 5>; 4 =>; > > :>


136/287

CHAPTER 8

Insertin&/ eletin& and ,ovin&

I @;= ;*)@9*@D* 4 5>; * > @4> 9 @ > 4>= ** >;>@> < *:.

T>;> ;> < 4 < == @@94. F*;4 N > 5> * > ;>49* >=* R>; D>.

A; < 5> @@9>@ > R @

5 >; > @@9 =*. A I)B>5 @;4; >; *

> > 5> = * ;>;.

I 59*:9> 9>94 4*5:9 >>> > 9>94 *4>= R>;

D>. I @@= 4 9>9 > 45> 5>=* *.

) 136 )

) ==4 > @@9 = 9>>4 > @@ @@ >=* ;> 5> > @@


137/287

RUB" COMPONENT

%ode Editor Basics

T> @ >=*;> 99 > @*4. T*4 *4 >;> * *

:;44 > *: = = 4>= ;>494 < > >=*. I 4:: ;*@ *@9=* @( @ JCTRLX( CTRLC = CTRLV( 9 4@;>= < 999>*4 >@. T> 94 < @>4 =;* :;*@9; 4>44*>> @9*@D* * > @; ::9*@*5( *4 *99 >>> >=*4.

" 4* > P#UP = P#N D>4. CTRLHOME *99 < < > > 4* CTRLH. H*9* 4>9>@* * > @ /> 4>= > @ R *4 >>=9> 9> < *5:9>5> 5>; 4 = D> /> 94< =>*>= @@* * F9 ;>4 @*4 ;4=* *4.

#he 0utput Pane

B> > > *< > * ;*( *@D .

T> @ >=*;;= * > .

F5:9>( /9*= 5>5*@9 >:;>44* R @

>/9>= ;>49 *4 4 .

) 137 )


138/287

CHAPTER 8

T> >5:9> 4 ;>49 * */9*= >:;>44*;;;;44>

*4>=. N *;4 >;;@;>= *4 =*4:9>=.

A4 >( > >;;44> *4 =*4:9>= * ;>= < =*>;>*> * ;/9>= >;;44>4 @ =*;>@9 ; R *>;:;>>;. T> @ 4*5>4 4>>5

;>9>= < > >;;;( > R C/9>4 :* 4< *

>;; *9 * * />; 94 >/9>=

>:;>44* > >5:9>4 >9


139/287

RUB" COMPONENT

I > @ > *;4 >:;>44*/9>=( 4>@:;>44*

4>@ 94 = 4< *4 >4 4> < > .

I > @ 45> * ::>4. H/>;( * ; < 4 *;4

>:;>44*>= > >/9>= >/> 44*>= *4 ;>49 < /;*9> J = > 4>= *4 *

> 4>@:;>44* = < > 5 >@** 4.

#he *u$!%dit Class

E@ R @:;>4>>= *4@> RE=* @944. T*4 *4 @944 > />

=>*>= * F9:;>4> > R @ /> =>*>= 5> /;*9>4 99 :; > *>;@> >>> *4@> RE=* @944 ;>:;>4>4

@ >5:9> > > *4@> ;>:;>4>* ." > *4@> /;*9> t;is *4>= @>= ** > @ RE=* @

;>:;>4>4 *.

Input ata

;;*/>4 R @ /;*9> @99>= ins. T*4 *4 R

;; = * 44 > 94 /9> < ;;*/> >@ *:.

" @=*


140/287

CHAPTER 8

T< @@>44 > /9> *: 4> > R A;; >9>5> ;>>;>@> F. V9>4 ;> >;< *=>>= 4<

< > > /9> > 4>@ insF1.

I4 *> @ ==>= ; *4@> /;*9> @99>= in

;>>;>@>4 *4 *;4 *: /9> =*;>@9.

In+ut La:es

I 9>9 /;*9> ** /;*9> *4 *4@> /;*9> * 54 > :;>@>=>= * > 45


141/287

RUB" COMPONENT

0utput ata

A4 >99 4 ;>@>*/* = ; ;>:;>4>4 *.

" sef.out+ut = > 45> ;>49.

F4 4 4< 5

;54>9/>4 4 = *>;*>= 5>/*5:9> < @**>= = 4< > ;>49 *4 4> < > *;4 out+ut 5> /9> @ > > *=>


142/287

CHAPTER 8

Stora6e of Out+uts

%4 4 > *: = 4 4= * R A;; > =< > 45> />; 94

/9> 4> < = outs.

"@ > @4 45> 4 *:4 ;;. T*4 @ > 4>9

> =>*.

" > @4 outs ;;. T*4 @ > 4>9 * /9>

/> ;. T> /9> @ > > ;>= ; @ />; 4>9 * >/>4 = ;* * ;> = = * /*

;*>;>= = 9; ;>. T> >5:9> 4* 4>= < ;>= > ;=9>44 ;> /9> *4*=> > R @


143/287

RUB" COMPONENT

T;e >/> &et;od

A4 > 5>*= >;9*>;( > R C/9>4 >>@>= = > 94 ;>49 *4

=*4:9>= * > O: :>.

O4*=> >=*@> >>/>; = ;;*/>4 *:. T*4 99 R @5>9 4>9 ::>4 * 4:@>*/>= *:

=*>;>9 ;@>*/>= ;?

,ethod e+inition

F= = =9* *> e9ent 5>@*9 5>*/>4 = *:.

T> e9ent 5> : < 3 *: :;5>>;4G

▪ i ) ;>>;>@>4 > *: *@ > = ;;*/>=

▪ 9 ) /9> ;;*/>= > *:

▪ t ) *5> *@ > = ;;*/>= J4@>5*@ *5> * 4>@


144/287

CHAPTER 8

I ;>@> > = =.

T> e9ent 5> @99>= > = ;;*/>4 *:4. ";4 >/>; ( i(9 = t.

H/>;( > 5> 54 94 > e9ent 4 4 F9 99* ;5*@9 ;* :>;= RE=*C@;

*>>; ;>49.

I >= < 44 > *=*/*=9 *=>


145/287

RUB" COMPONENT

%++ect on Code %xecution

I @ *> 5>>@>

> *: @>4. T> >5:9> >9 ;>@>*/>=.

P;* ;>5** @ >>@>= >>/>; *:4

@>= 4 ;>49* * > 45 *:4 >* 4> < > ;( * > e9ent

5> F9>@>4 *4 5>= = *4 ; @.

) 1$& )


146/287

CHAPTER 8

Sc;eduin6 E9ents

"@99 ; T:>4 = S*9 F9@* ;*>;>= = *@ *4 4>

*55>=*>9( >/> = @ > 4@>=9>= < > 4> 4 *5> * > ;>.

T< =< *4 4@>5*@ 4 @9 @99:4>= *5>( * ;>9 @*4

> > 4@>5*@ *4 9= >=. T> @94> *5> 4.

Schedulin& an %vent

T< 4@>=9> >/> >= < :; *5> 45: > = = < >=4< > 4::9*>= 4 *;= *: :;5>>; > > out+ut 5> *5> 45: *99 95 ; @;;> *5>. " > *5> * <

=*>;> 4 =>:>=* ;> > @99 ; 5> * *> * *

*: ;>>;>@>( /9> = *5> *:4 > > *5> :44>= < *5> *:

:;5>>;.

T> >/> *99 > 4> < > >/>4 >> = *99 4> 4*>= > @9 >/> *5> 45: *4 ;>@>=.

T> >5:9> >9/> ; >/> 5> *5> *:

:;5>>;.

) 1$6 )


147/287

RUB" COMPONENT

Sendin& to an Input

"= >/>4 @D < > 45> R @=* >5 < *:. T*4 *4 4>9 *

> ;>:>* >/> ;@;4*/> ;* > in+ut 5> 45> 4 > out+ut 5>;>@> ;>>;4 < > *: = > >/> < *4>=.

T> >5:9> @;>>4 @; 54 * 4>@:4 = @4 *=.

N ( 4 9*D> = < *=>*

>;> = /9>


148/287

CHAPTER 8

Clearin& %vents

O@> = >/> * 4 >/>4 >> = *4 *9 *4 *5> @4 < > >>@>=.

I 4@>=9* >/>4 ::> 4 *5> * > ;> 4*5>4 =9> >/>4 < :;>@*4> *5

dsprobotics flowstone user guide

Documents