RegGMFX()
return an array defining all csound effects to be available within the
Compositor as (x) boxes
each effect is actually an instrument coded in a specific csound
orchestra; the "orc" index contains the orchestra name (with no path)
all other indexes are the instrument numbers for registered effects.
an array is associated to each of those index, with the following
fields:
"x" a string appearing at the console, describing the effect
"ishct" a keyword providing a shortcut to replace the plain effect
number when importing a (x) box. this will also be the box
name by default.
"p4",
"p5",
... (optional) labels for the corresponding settable parameters.
"defp4",
"defp5",
... (optional, but if a "pi" is present then "defpi" is required)
default values for the settable parameters.
"scoh" score (in GeoMaestro format) calling the instrument/effect
usually there's only one line, but this is not required
the p2 field(s) must be replaced by $Start.
the p3 field(s) must be replaced with $Dur.
all settable pi parameters must be replaced with $pi.
"scot" (optional) score (in GeoMaestro format) defining all required
tables. each effect should use different table numbers !
"dec" (optional) the effect decay time (in seconds)
this may be either a float or a string. if a string, it will
be evaluated as KeyKit code after replacement of all "$pi."
with the parameters values: this make it possible to have the
decay time be a function of the parameters.
... see the default RegGMFX() and the corresponding GMFX.orc file if you
intend to add your own effects...
Related topics: csound custom
RegIndex(arr, regexp {, mode})
if mode is 1 (defaults), returns array arr minus all items whose
indexes are not a string matching regexp (a regular expression)
else returns array arr minus all items whose indexes are matching
ex:
RegIndex(["beuh"=1,"bouh"=2","nope"=3],"b..h")
returns ["beuh"=1,"bouh"=2]
while
RegIndex(["beuh"=1,"bouh"=2","nope"=3],"b..h",0)
returns ["nope"=3]
Related topics: array
RegisterPortablePath(fname, varname)
creates a new global variable called varname (a string)
whose value is the path of the file or folder fname (a string)
this path will be recognized by RelativeNameExpression
returns the value of PortablePathes, the array of registered pathes
See:
RelativeNameExpression
Related topics: programming file custom
RelativeNameExpression(fname)
returns an expression (a string) which, when evaluated with FName(),
returns fname
the idea is to use DATA, BASE, etc... to represent the path if possible,
thus making the code portable between installations and systems.
(the recognized variables are registered in array PortablePathes)
See:
FName
RegisterPortablePath
Related topics: programming string file
RemVAR(listvar)
register in GVARS all variables in the string listvar; they must be global variables
with a name starting with an upper-case letter
ex: RemVAR("A,B,SomeVariable")
note: the variables returned by NoRemVARforthis() will not be registered
Related topics: GVARS
RemoveArrayParameter(name)
Unregister the array parameter called name (a string) from
the ArrayParameters tool
See:
DefParam
DefArrayParameter
RegArraysOfType
Related topics: custom
RemoveEv(ch,n)
removes Ev[ch][n] from the Ev array
Related topics: programming event
RemoveInstr(sco, ...)
returns sco minus all lines containing i-statements for instruments given as argument
See:
KeepOnlyInstr
FilterInstr
Related topics: csound
RenameO(name, newname)
creates a copy of object name called newname, displays it in the GUI
while removing the "old" one (it is not undefined, though)
-> name and newname must be strings !
Related topics: GUI object
RepLigne(lig {, duration {, t0 {, region {, df}}}})
redo all projections making the ligne lig, and returns a ligne
usually you would instead simply recall the projector(s) that created lig in the
first place, but this is not always possible (for example if random operations are
used in the process)
note: the inner "inter" structure is flatten by the use of DeconLigne()/ReconLigne()
See:
DeconLigne
ReconLigne
Related topics: ligne
RepeatFor(ph, d {, mode})
repeats phrase ph until the duration d is reached.
if mode is 0 (default), the resulting phrase is cut at d, as does repleng()
if mode is 1, ph is repeated until there is not enough room for another repeat,
so in most cases there will silence at the end of the resulting phrase
in both cases, the length of the returned phrase is exactly d
See:
repeat
repleng
RepeatScoreFor
RepeatScore(sco, n)
returns a score based from sco, with its i-statement repeated n times
each repeatition happens with a cumulative time offset of sco length
Related topics: csound
RepeatScoreFor(sco, d {, mode})
repeats score sco until the duration d is reached.
if mode is 0 (default), the resulting score is cut at d
if mode is 1, sco is repeated until there is not enough room for another repeat,
so in most cases the resulting score will have a smaller duration than d
See:
RepeatFor
ReplaceWithAudio(nb {, noredrawflag})
wrap the box nb in an echo structure, so that the box is silenced and
replaced by the echo of its audio rendering (through a (#) box)
further manipulation of the "ref" field of the echo box allows treatment
of the musical data from box nb, considered as audio.
if noredrawflag is 0 (the default), the compositor is redrawed
returns an array with fields "b" (the echo box) and "i" (its index)
See:
ReplaceWithEcho
Related topics: compositor
ReplaceWithEcho(nb {, noredrawflag})
wrap the box nb in an echo structure, so that the box is silenced and
replaced by its echo
further manipulation of the "ref" field of the echo box allows treatment
of the musical data from box nb.
if noredrawflag is 0 (the default), the compositor is redrawed
returns an array with fields "b" (the echo box) and "i" (its index)
See:
ReplaceWithAudio
Related topics: compositor
ReverseScore(sco {, kflag})
returns a score based on sco where all p2s have been reverted:
p2 -> (last p2 in sco) - p2
length is preserved
if kflag is 1, performs on sco itself, otherwise on arraycopy(sco)
Related topics: csound
RevertToUsualPhraseWindows()
cancels the effect of OverridePhraseWindowWithScore
See:
OverridePhraseWindowWithScore
wscore
Related topics: GUI custom
Rose(t, ra, nf {, toffset})
... to be used with ParaPiste ...
defines a rose curve relatively to CentrePolaire:
-> r = ra*sin(nf*t)
-> theta = t
-> toffset is added to t
See:
ParaPiste
PolarPiste
Related topics: piste math
RoseP(t, ro, ra, nf {, toffset})
... to be used with ParaPiste ...
defines a rose curve relatively to CentrePolaire:
-> r = ro + ra*sin(nf*t)
-> theta = t
-> toffset is added to t
See:
ParaPiste
PolarPiste
Related topics: piste math
RotP(a, b, th)
returns the point obtained by rotating point a around point b
by an angle th
Related topics: point angle