ftm - User contributions [en]

If method

2009-05-05T08:45:53Z

Beller:

if <num: condition> <any: true value> <any: false value>

- choose between two values (both conditional values are evaluated)

The 'if' function (not method) should be pretty clear if you keep in mind the
two drawbacks:

1. it is a function, i.e. all arguments are evaluated before the 'if' gets to
decide which one to output, i.e. something like

(if ($1 != 1) ($myfmat mul 2) ($myfmat zero))

always multiplies and then zeros the myfmat!

2. The result of 'if' can only be one atom, not a list. If you want to output
one list or another, use tuples, with a subsequent ftm.list, or the
soon-to-be-official #untup feature of ftm.mess. This can be used with a 'route'
to send a list out to one or another connection.

(if ($mydict exists $1) {1 $mydict[$1]} {2 $1 42})
|
ftm.list
|
route 1 2

Find method

2009-05-05T08:42:39Z

Beller:

find <expr: expression> <any: arguments to expression...>

- leave indices where expression is true (use $x, $i and $self)

The find method of fmat replaces an fmat with the (unwrapped) indices of the
elements for which the given expression returned non-zero. The expression can
use the arguments to the find method following the expression as $1, $2, etc.,
and the predefined super-local variables $x (the value of the element being
tested), $i (its index), and $self (the reference to the fmat itself).
Otherwise, only global definitions are visible within the expression. (The
latter holds for any expression evaluation.)

Example: ($myfmat find $myexpr 1 20) with myexpr = '(($x >= $1) && ($i < $2))'
finds values greater than 1 in the first 20 indices and replaces $myfmat with
their indices.

Find method

2009-05-05T08:42:08Z

Beller:

find <expr: expression> <any: arguments to expression...> - leave indices
where expression is true (use $x, $i and $self)

The find method of fmat replaces an fmat with the (unwrapped) indices of the
elements for which the given expression returned non-zero. The expression can
use the arguments to the find method following the expression as $1, $2, etc.,
and the predefined super-local variables $x (the value of the element being
tested), $i (its index), and $self (the reference to the fmat itself).
Otherwise, only global definitions are visible within the expression. (The
latter holds for any expression evaluation.)

Example: ($myfmat find $myexpr 1 20) with myexpr = '(($x >= $1) && ($i < $2))'
finds values greater than 1 in the first 20 indices and replaces $myfmat with
their indices.

Documentation

2009-05-05T08:40:42Z

Beller: /* FTM Basics */

__NOTOC__
The FTM & Co [[Download | releases]] come with help patches and basic tutorials. In addition, there are these:

* [http://freesoftware.ircam.fr/wiki/index.php/FTM Old FAQ on freesoftware.ircam.fr]
* [[FAQ]]

== FTM Basics ==

* [[Tutorials]]
* [[Expressions]] ... all about expressions in FTM
* [[Message Box]] ... the ''ftm.mess'' external
* [[Object and Value Definitions]] ... the ''ftm.object'' external
* [[Gabor Timing]] ... might need some explantions
* [[find method]] ... the ''find'' method
* [[if method]] ... the ''if'' method

== FTM & Co Reference ==

* [[FTM Classes]] ... data structures such as fmat, dict, track, etc.
* [[FTM Modules]] ... set of basic FTM externals
* [[Gabor Modules]] ... externals of the [[Gabor]] package
* [[MnM Modules]] ... externals of the [[MnM]] package

== FTM Development ==

* The FTM header files are also included in the FTMlib framework that is part of the standard [[Download | FTM distributions]].

* [http://recherche.ircam.fr/equipes/temps-reel/ftm/api/ FTM API reference documentation] ... Doxygen API documentation generated from the FTM sources at the [http://sourceforge.net/projects/ftm/ FTM SourceForge project]

* [[SDK]] ... All you need to write externals using FTM

* [[Developer's Corner]] ... Tips and tricks how to write classes and externals using FTM

* [http://www.sourceforge.net/projects/ftm ftm-devel] ... Developer's mailing list on sourceforge