From ftm
(2 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
This is a list of the currently supported Functions. For a clear explanation of the differences between Functions and Methods, please refer to the help file of ftm.mess, under the patcher functions & methods. | This is a list of the currently supported Functions. For a clear explanation of the differences between Functions and Methods, please refer to the help file of ftm.mess, under the patcher functions & methods. | ||
− | sin <num: value> - standard math function | + | * sin <num: value> - standard math function |
− | cos <num: value> - standard math function | + | * cos <num: value> - standard math function |
− | tan <num: value> - standard math function | + | * tan <num: value> - standard math function |
− | asin <num: value> - standard math function | + | * asin <num: value> - standard math function |
− | acos <num: value> - standard math function | + | * acos <num: value> - standard math function |
− | atan <num: value> - standard math function | + | * atan <num: value> - standard math function |
− | sinh <num: value> - standard math function | + | * sinh <num: value> - standard math function |
− | cosh <num: value> - standard math function | + | * cosh <num: value> - standard math function |
− | tanh <num: value> - standard math function | + | * tanh <num: value> - standard math function |
− | abs <num: value> - standard math function - get absolute value | + | * abs <num: value> - standard math function - get absolute value |
− | log <num: value> - standard math function | + | * log <num: value> - standard math function |
− | logabs <num: value> - standard math function - logarithm of absolute value | + | * logabs <num: value> - standard math function - logarithm of absolute value |
− | log10 <num: value> - standard math function | + | * log10 <num: value> - standard math function |
− | exp <num: value> - standard math function | + | * exp <num: value> - standard math function |
− | sqrt <num: value> - standard math function | + | * sqrt <num: value> - standard math function |
− | trunc <num: value> - standard math function - truncate to integer value | + | * trunc <num: value> - standard math function - truncate to integer value |
− | round <num: value> - standard math function - round to integer value nearest to current value | + | * round <num: value> - standard math function - round to integer value nearest to current value |
− | ceil <num: value> - standard math function - round to smallest integral value not less than current value | + | * ceil <num: value> - standard math function - round to smallest integral value not less than current value |
− | floor <num: value> - standard math function - round to largest integral value not less than current value | + | * floor <num: value> - standard math function - round to largest integral value not less than current value |
− | lin2db <num: value> - standard math function - convert linear amplitude value to value in decibel | + | * lin2db <num: value> - standard math function - convert linear amplitude value to value in decibel |
− | db2lin <num: value> - standard math function - convert value in decibel to linear amplitude value | + | * db2lin <num: value> - standard math function - convert value in decibel to linear amplitude value |
− | lin2cent <num: value> - standard math function - convert linear value to value in cent | + | * lin2cent <num: value> - standard math function - convert linear value to value in cent |
− | cent2lin <num: value> - standard math function - convert value in cent to linear value | + | * cent2lin <num: value> - standard math function - convert value in cent to linear value |
− | new <sym: class name> [<any: instantiation arguments> ...] - create object of given class | + | * new <sym: class name> [<any: instantiation arguments> ...] - create object of given class |
− | int <num: arg> - convert to integer value | + | * int <num: arg> - convert to integer value |
− | i alias for 'int' | + | * i alias for 'int' |
− | float <num: arg> - convert to floating-point value | + | * float <num: arg> - convert to floating-point value |
− | f alias for 'float' | + | * f alias for 'float' |
− | symbol <sym: arg> - convert to symbol | + | * symbol <sym: arg> - convert to symbol |
− | s alias for 'symbol' | + | * s alias for 'symbol' |
− | list [<obj|any: list args>...] - convert objects to list | + | * list [<obj|any: list args>...] - convert objects to list |
− | listhead [<any: list args> ...] - get list head | + | * listhead [<any: list args> ...] - get list head |
− | listtail [<any: list args> ...] - get list tail | + | * listtail [<any: list args> ...] - get list tail |
− | listlen [<any: list args> ...] - get list size | + | * listlen [<any: list args> ...] - get list size |
− | listnth <num: index> [<any: args> >...] - get nth list element (indices starting from 1) | + | * listnth <num: index> [<any: args> >...] - get nth list element (indices starting from 1) |
− | listelem <num: index> [<any: args> >...] - get list element | + | * listelem <num: index> [<any: args> >...] - get list element |
− | listsub <num: index> <num: len> [<any: args> >...] - get sub-list | + | * listsub <num: index> <num: len> [<any: args> >...] - get sub-list |
− | l alias for 'list' | + | * l alias for 'list' |
− | lhead alias for 'listhead' | + | * lhead alias for 'listhead' |
− | ltail alias for 'listtail' | + | * ltail alias for 'listtail' |
− | llen alias for 'listlen' | + | * llen alias for 'listlen' |
− | lnth alias for 'listnth' | + | * lnth alias for 'listnth' |
− | lelem alias for 'listelem' | + | * lelem alias for 'listelem' |
− | lsub alias for 'listsub' | + | * lsub alias for 'listsub' |
− | unique - generate unique integer number | + | * unique - generate unique integer number |
− | random [<num: min>] <num: max> - generate (float) random number (min <= x < max) | + | * random [<num: min>] <num: max> - generate (float) random number (min <= x < max) |
− | clip <num: value> [<num: lower boundary>] <num: upper boundary> - clip value | + | * clip <num: value> [<num: lower boundary>] <num: upper boundary> - clip value |
− | pow <num: base> <num: exponent> - power | + | * pow <num: base> <num: exponent> - power |
− | mod <num: num> <num: denum> - float modulo function | + | * mod <num: num> <num: denum> - float modulo function |
− | min [<num: arg> ...] - find minimum | + | * min [<num: arg> ...] - find minimum |
− | max [<num: arg> ...] - find maximum | + | * max [<num: arg> ...] - find maximum |
− | mag [<num: arg> ...] - magnitude (sqrt of sum of squares) | + | * mag [<num: arg> ...] - magnitude (sqrt of sum of squares) |
− | arg <num: real part> <num: imaginary part> - argument angle | + | * arg <num: real part> <num: imaginary part> - argument angle |
− | hz2midi <num: value in Hz> [<num: tuning frequency (for note # 69, def 440.)>] - convert to MIDI note number | + | * hz2midi <num: value in Hz> [<num: tuning frequency (for note # 69, def 440.)>] - convert to MIDI note number |
− | midi2hz <num: MIDI note number> [<num: tuning frequency (for note # 69, def 440.)>] - convert to frequency in Hz | + | * midi2hz <num: MIDI note number> [<num: tuning frequency (for note # 69, def 440.)>] - convert to frequency in Hz |
− | cat <any: item>... - concatenate to a single symbol | + | * cat <any: item>... - concatenate to a single symbol |
− | basename <sym: filepath> - get filename part of filepath (last component) | + | * basename <sym: filepath> - get filename part of filepath (last component) |
− | dirname <sym: filepath> - get directory part of filepath (or '.' if no path) | + | * dirname <sym: filepath> - get directory part of filepath (or '.' if no path) |
− | extension <sym: filepath> - get extension part of filepath (after the last '.') | + | * extension <sym: filepath> - get extension part of filepath (after the last '.') |
− | stripext <sym: filepath> - remove extension from filepath (including the '.') | + | * stripext <sym: filepath> - remove extension from filepath (including the '.') |
− | not <num: linear value> - integer negation | + | * not <num: linear value> - integer negation |
− | if <num: condition> <any: true value> <any: false value> - choose between two values (both conditional values are evaluated) | + | * if <num: condition> <any: true value> <any: false value> - choose between two values (both conditional values are evaluated) |
− | case <num: index> [<any: value for index 1, 2 etc.> ...] - choose between multiple values (all conditional values are evaluated) | + | * case <num: index> [<any: value for index 1, 2 etc.> ...] - choose between multiple values (all conditional values are evaluated) |
− | typeof <any: arg> - get class/type name of value or object | + | * typeof <any: arg> - get class/type name of value or object |
− | classof <any: arg> - get class/type of value or object | + | * classof <any: arg> - get class/type of value or object |
− | getid <obj: reference> - get object id | + | * getid <obj: reference> - get object id |
− | getobj <symbol: id> - get object by id | + | * getobj <symbol: id> - get object by id |
− | obj <symbol: id> - get object by id | + | * obj <symbol: id> - get object by id |
− | class <sym: class name> - get class/type by name | + | * class <sym: class name> - get class/type by name |
− | print print value or object | + | * print print value or object |
− | aa <sym|any: arg> [<any: replacement if arg is #1, #2, etc> [<replacement if arg is 0>]] - replace abstraction argument by default value | + | * aa <sym|any: arg> [<any: replacement if arg is #1, #2, etc> [<replacement if arg is 0>]] - replace abstraction argument by default value |
− | info <'classes'|'class'|'functions'> [<any: args>] [<mat: container>] - get info (post to console window or store into container if given) | + | * info <'classes'|'class'|'functions'> [<any: args>] [<mat: container>] - get info (post to console window or store into container if given) |
− | checkversion <num: major version> [<num: minor version> [<num: release>]] - check whether the running FTM corresponds to given version and release | + | * checkversion <num: major version> [<num: minor version> [<num: release>]] - check whether the running FTM corresponds to given version and release |
− | ftm <sym: FTM system function> <list: arguments> | + | * ftm <sym: FTM system function> <list: arguments> |
− | FTM alias for 'ftm' | + | * FTM alias for 'ftm' |
− | ftm version - get FTM version as symbol | + | * ftm version - get FTM version as symbol |
− | ftm exprerrcheck <0|'none'|1|'loose'|2|'normal'|3|'strict'> - set expression evaluation error checking level | + | * ftm exprerrcheck <0|'none'|1|'loose'|2|'normal'|3|'strict'> - set expression evaluation error checking level |
− | ftm exprerrcheck - get FTM expression evaluation error checking level | + | * ftm exprerrcheck - get FTM expression evaluation error checking level |
− | ftm exterrors - post current errors of FTM externals | + | * ftm exterrors - post current errors of FTM externals |
− | version - get FTM version as symbol (deprecated) | + | * version - get FTM version as symbol (deprecated) |
+ | |||
+ | [[Category:FTM Documentation]] [[Category:Functions]] |
Latest revision as of 09:36, 6 July 2010
This is a list of the currently supported Functions. For a clear explanation of the differences between Functions and Methods, please refer to the help file of ftm.mess, under the patcher functions & methods.
- sin <num: value> - standard math function
- cos <num: value> - standard math function
- tan <num: value> - standard math function
- asin <num: value> - standard math function
- acos <num: value> - standard math function
- atan <num: value> - standard math function
- sinh <num: value> - standard math function
- cosh <num: value> - standard math function
- tanh <num: value> - standard math function
- abs <num: value> - standard math function - get absolute value
- log <num: value> - standard math function
- logabs <num: value> - standard math function - logarithm of absolute value
- log10 <num: value> - standard math function
- exp <num: value> - standard math function
- sqrt <num: value> - standard math function
- trunc <num: value> - standard math function - truncate to integer value
- round <num: value> - standard math function - round to integer value nearest to current value
- ceil <num: value> - standard math function - round to smallest integral value not less than current value
- floor <num: value> - standard math function - round to largest integral value not less than current value
- lin2db <num: value> - standard math function - convert linear amplitude value to value in decibel
- db2lin <num: value> - standard math function - convert value in decibel to linear amplitude value
- lin2cent <num: value> - standard math function - convert linear value to value in cent
- cent2lin <num: value> - standard math function - convert value in cent to linear value
- new <sym: class name> [<any: instantiation arguments> ...] - create object of given class
- int <num: arg> - convert to integer value
- i alias for 'int'
- float <num: arg> - convert to floating-point value
- f alias for 'float'
- symbol <sym: arg> - convert to symbol
- s alias for 'symbol'
- list [<obj|any: list args>...] - convert objects to list
- listhead [<any: list args> ...] - get list head
- listtail [<any: list args> ...] - get list tail
- listlen [<any: list args> ...] - get list size
- listnth <num: index> [<any: args> >...] - get nth list element (indices starting from 1)
- listelem <num: index> [<any: args> >...] - get list element
- listsub <num: index> <num: len> [<any: args> >...] - get sub-list
- l alias for 'list'
- lhead alias for 'listhead'
- ltail alias for 'listtail'
- llen alias for 'listlen'
- lnth alias for 'listnth'
- lelem alias for 'listelem'
- lsub alias for 'listsub'
- unique - generate unique integer number
- random [<num: min>] <num: max> - generate (float) random number (min <= x < max)
- clip <num: value> [<num: lower boundary>] <num: upper boundary> - clip value
- pow <num: base> <num: exponent> - power
- mod <num: num> <num: denum> - float modulo function
- min [<num: arg> ...] - find minimum
- max [<num: arg> ...] - find maximum
- mag [<num: arg> ...] - magnitude (sqrt of sum of squares)
- arg <num: real part> <num: imaginary part> - argument angle
- hz2midi <num: value in Hz> [<num: tuning frequency (for note # 69, def 440.)>] - convert to MIDI note number
- midi2hz <num: MIDI note number> [<num: tuning frequency (for note # 69, def 440.)>] - convert to frequency in Hz
- cat <any: item>... - concatenate to a single symbol
- basename <sym: filepath> - get filename part of filepath (last component)
- dirname <sym: filepath> - get directory part of filepath (or '.' if no path)
- extension <sym: filepath> - get extension part of filepath (after the last '.')
- stripext <sym: filepath> - remove extension from filepath (including the '.')
- not <num: linear value> - integer negation
- if <num: condition> <any: true value> <any: false value> - choose between two values (both conditional values are evaluated)
- case <num: index> [<any: value for index 1, 2 etc.> ...] - choose between multiple values (all conditional values are evaluated)
- typeof <any: arg> - get class/type name of value or object
- classof <any: arg> - get class/type of value or object
- getid <obj: reference> - get object id
- getobj <symbol: id> - get object by id
- obj <symbol: id> - get object by id
- class <sym: class name> - get class/type by name
- print print value or object
- aa <sym|any: arg> [<any: replacement if arg is #1, #2, etc> [<replacement if arg is 0>]] - replace abstraction argument by default value
- info <'classes'|'class'|'functions'> [<any: args>] [<mat: container>] - get info (post to console window or store into container if given)
- checkversion <num: major version> [<num: minor version> [<num: release>]] - check whether the running FTM corresponds to given version and release
- ftm <sym: FTM system function> <list: arguments>
- FTM alias for 'ftm'
- ftm version - get FTM version as symbol
- ftm exprerrcheck <0|'none'|1|'loose'|2|'normal'|3|'strict'> - set expression evaluation error checking level
- ftm exprerrcheck - get FTM expression evaluation error checking level
- ftm exterrors - post current errors of FTM externals
- version - get FTM version as symbol (deprecated)