=============================================================================

G�oMaestro v1.121 (December 10, 2003)

=============================================================================

Changes from v1.120:

--------------------

* bug fix

Feel free to send any comment or bug report at hepta@zogotounga.net

Stef

G�oMaestro home page (download, manual, tutorials and compositions):

http://www.zogotounga.net/GM/GM0.html

KeyKit:
http://thompsonresidence.com/keykit

=============================================================================
History of changes:
-------------------

v1.120 (January 12, 2003)

*****************************************************************************
* This version provides minor but required implementation changes,
* so that it can be used with KeyKit version 7.2
*
* older versions of GeoMaestro are only to be used with KeyKit up to 7.1
*****************************************************************************

v1.119 (November 14, 2002)

* bug fixes
* new command in Batteur syntax: FILT
* Toys: variable ToySmurf is similar to Snarf, for full Toys

v1.118 (October 21, 2002)

* bug fixes
* new projectors: Radar, RadarScan
* improvements in Batteur syntax
* more functions in lib/curves.k (Moritz...)

v1.117 (July 13, 2002)

* bug fix

v1.116 (June 26, 2002)

v1.115 (June 26, 2002)
* Main GUI: mouse mode "radial distortion" is renamed "ang. distortion"
... the old name was confusing, as the distortions are actually angular
* Compositor: large changes in the implementation for mark management
 the marks are now updated at evaluation, so the [REF] button becomes
devoted only to embedded tools.
a new parameter LIGNEMARKS allows a better customization of automatic
creation of marks when importing a (�) box
* More demos..

v1.114 (June 22, 2002)

* bug fix
* new tool: wincluder, to #include some code automatically when restoring
a page

v1.113 (June 21, 2002)

* The Tokyo Art.Bit demo system is now part of the distribution
... see http://www.zogotounga.net/GM/GMdemo.html

v1.112 (June 6, 2002)

* bug fixes
* new Compositor plug-in EditCScore
* many improvments in Csound score handling:
- a lot of new functions (see the HTML function reference, topic "csound")
- some old functions have a better implementation
- seamless usage of "score.srt" for score explicitation (SortScore)
.. requires that CSOUNDBINARY is correctly set
- batch interfacing with Emacs for complex manipulations
* the Compositor "Snarf window" now also displays the last evaluated score
.. this is toggled on and off through the parameter DisplayLastEvalScore
.. the drawing function is defined through LastEvalScoreDisplayFunction
* new display option for the Compositor: if OpaqueBoxes is set to 1, the boxes
are not transparent any more; when they overlap, only the top one is fully
displayed.
* new directory in the distribution tree: /data/emptyme, whose path is
stored in variable TEMPDIR. this is a place for temporary files that can
be deleted at any time with no harm.
* Compositor: time-line mode has been enhanced; new parameter: TLOKeyName

v1.111 (May 30, 2002)

* new projector: PHelice
* various small enhancements...

v1.110 (May 26, 2002)

* bug fixes
* new projectors: PWeb, RBox2, CBox2

v1.109 (May 10, 2002)

* bug fixes
* GUIs: improved the redraw procedures (now faster and smoother)

v1.108 (April 13, 2002)

* bug fixes
* new projector: Rayons
v1.107 (April 12, 2002)
* bug fixes
* new projectors MetaPhrase, MetaPhraseAB, CDeMul, RollOnPiste
* all meta-projectors now accept un extra optional closure argument
* main GUI: extension of the * syntax for [display]

v1.106 (March 23, 2002)

* bug fix
* new parameter PickAndDragExtremities (def. 0) defining the behaviour of
the "Pick & Drag" mouse mode on segments
* new parameter DisplayAreaCenter (def. 1) allowing the display of the graphic
area center (the rotation center)

v1.105 (March 22, 2002)

v1.104 (March 21, 2002)
* bug fixes

v1.103 (March 15, 2002)

* The array RegGUIbackgrounds makes it easier to define custom background
drawings in the main GUI.
(see an exemple in tutorial 4, from the HTML doc)

v1.102 (March 14, 2002)

* bug fix

v1.101 (March 4, 2002)

* wscore: makes it possible to override the built-in phrase window object
in order to provide a nicer (although slower) and more informative
phrase display

v1.100 (February 17, 2002)

* bug fixes

v1.099 (February 17, 2002)

* bug fixes, new functions
* added "layers" to Compositor plug-in RepWithEcho

v1.098 (January 12, 2002)

* bug fixes
* Projector Batteur() has been improved (better macro handling).
* more basic geometrical transformations for pistes are coded in lib/curves.k

v1.097 (December 23, 2001)

* bug fixes
* the strings defining distortion functions may now be pieces of KeyKit code, as an

alternative to function names

ex: Volume[1]="{return(0)}" is now equivalent to Volume[1]="NoChange"
... see the HTML manual for syntax and details
(tutorial 5 and projection page)
* GUI plug-in ChooseDF has been updated and now uses the above scheme
* Compositor: audio processing in (&) boxes has been improved: see function
AudioF()
and file lib/filtres.k
(this is not document yet; probably also subject to future changes)
* Compositor: new plug-ins ToyMorphing, RepWithAudio, MoveMark
* Main GUI: new plug-in DrumNote
* Projector Batteur() has been vastly improved. Also, a Toy configuration file
(toys/Batteur.tyk) allows an easy standalone usage of the Batteur() algorithm.
See toys/Batteur.toy for an example.

v1.096 (December 7, 2001)

v1.095 (December 4, 2001)
v1.094 (December 2, 2001)
* bug fixes

v1.093 (November 24, 2001)

* bug fixes
* New projector: OscBeat
* New toys: PR235 family, Zoziaux
* Compositor: new [OP] button allowing arbitrary operations on the boxes
(similar to the [operation] button in the main GUI)
* A whole bunch of Csound related function
* Improved orc/score handling by the Compositor.

v1.091 (October 28, 2001)

* bug fixes
* the customizations in userlib/GUIuserreg.k now get added to the distribution
settings,
instead of overriding them as before.

v1.090 (October 21, 2001)

* A new class of GUIs is now provided: the Toys
- on the user side, it becomes very easy to explore algorithms defined with
GeoMaestro,
even for someone devoid of any understanding of the system.
- on the programmer side, writing a simple configuration page is enough to create
a
brand new standalone KeyKit tool.
A few example Toys and TYKs are provided for now, much more are to come in the
future
This is a major extension of the system, so please read the related page in the
HTML manual.
* Display of projection supports is now possible even when NoInterInLignes is 0
(an extra [show] button appears in the main GUI)

v1.089 (October 8, 2001)

* bug fixes
* new projector: PolyMorph

v1.088 (October 8, 2001)

* bug fix
v1.087 (October 8, 2001)
***********************************************************************************
*****
* WARNING: the installation procedure changed, fitting the new scheme in KeyKit 7.1
*
* ... see the HTML manual for details:
* http://www.zogotounga.net/GM/GMinstall.html
***********************************************************************************
*****
* bug fixes
* Compositor: new internal format for filenames, allowing portability of file
references
(as long as only specific system directories such as DATA are used)
... see the "hints and tips" page in the HTML manual for more about this
* Compositor: new plug-ins EditPhrase, GroupWrap ... see the HTML manual for
more
* New projector: EarJump
* the extensible GUIs menus now support sub-menus
* the macro commands gFLIP and cFLIP change the position of the block of buttons,
respectively for the main GUI and for the Compositor
you may also set GUICommandPanelIsAtRight to 0 to have the default be left-hand

v1.086 (September 7, 2001)

* bug fixes
* new projectors: ADrummer, ADMorph
* new parameter: ProjInLignes
similar to AnimInLignes in that it allows extra information to be stored in
rendered lignes,
making it faster to recalculate them when only nodurs and distortion functions
are changed
(the geometry of the projection being supposedly unchanged)
when ProjInLignes is 1, the [redo] button in the main GUI allows both full re-
projection
and fast recalculation; see the HTML manual for details.
* Compositor: "autofroz" can now be any number; the box will be frozen when
IterationN reaches
that value (this feature is intended to be used when working with iterative echo
boxes)
* Compositor: improved internal [UNDO] routines (faster and much less memory-
consuming)
* Compositor: new plug-ins RepWithEcho, SwapBoxes, SplitBox
* new tool: ArrayParameters (class wParam)
modelled after the Customization tool, this one allows fast and simple handling
of complex
array parameters (such as the ones used by the projectors Bulle and ADrummer).
See the
HTML manual for more, at the "Extra KeyKit tools" page.

Emacs users:
* the lib/tcpip.k file contains code for interfacing with Emacs via TCP/IP.
this makes it possible to have a KeyKit console in an Emacs buffer (quite
powerful !)
also, code can be evaluated by KeyKit directly from the buffer you're editing
under Emacs,
simply by selecting a region (there's an entry for that in the keykit-mode menu).
 ... all of this is detailled in the keykit-mode page of the HTML manual

v1.085 (July 17, 2001)

* bug fixes
* Compositor: you can now provide your own functions for drawing phrases and Csound
scores inside a box. Use the "phdisplay" and "scodisplay" fields for a given
box, and
the PhraseDisplayInBox and ScoreDisplayInBox parameters for default settings.
(see function StdScoreDisplay() in lib/lib_compo.k for an example)

v1.084 (July 15, 2001)

* Bug fixes
* New types of boxes for the Compositor:
(#) converts its children to a .wav file
(0) black hole (silenting all its children)
(&&) specific echo boxes for iterative evaluation (handling loops in boxes
structure)
* Compositor: more Csound effects available through (x) boxes
* Compositor: "autofreeze" feature
* The object pointers LastGMGUI, LastGMGUIf, LastGMCOMPO, LastGMCOMPOf and GMwrp
now get back to
their previous value when the corresponding GUI is deleted. Should have done this
before.

v1.083 (June 30, 2001)

* Bug fix
* Compositor: new mouse mode "freeze box"

v1.082 (June 29, 2001)

v1.081 (June 18, 2001)
v1.080 (June 15, 2001)
v1.079 (June 2, 2001)
* Bug fixes

v1.078 (June 1, 2001)

* Bug fixes
* RealTimeProjection is a new parameter; when set to 1 (default is 0), all
projectors send
rendered notes to MIDI out as soon as they can (which, for some of them, means
immediately).
More about this in the manual (there's a new page dedicated to realtime stuff, to
be completed
one of these days).
* Compositor: improved the time line mode (that's when ScaleToTimeLine is 1)
.. see the manual for details
* Compositor: new plug-ins SyncTo and TLOffset
* Easy customization system for GeoMaestro and KeyKit: check the Customization
tool.
(documented in the "KeyKit tools" page of the GeoMaestro manual)

v1.077 (Avril 25, 2001)

* bug fixes
* GUI: [display] syntax now provides %, =, {{, {p, {i, {c and {s
 ... see the manual for details
* GUI: at last, segments can be selected and handled like the other geometrical
objects
* new projectors: Segments and Circles

v1.076 (Avril 25, 2001)

* Compositor: (x) box improved, internal changes in audio implementation
... some audio processing with (&) boxes is already possible but this will
not be
documented any time soon.
* GUI: - new plug-ins Anonymous, to create points, segments and circles without the
hassle to
give them a name, and HideObject, to remove objects from the display
- do a man("ShowObjectsNames()") ...
* new utility for the on-line documentation system: functopic()
(do a man("functopic") ...)

v1.075 (Avril 17, 2001)

* GUI: new mouse mode "pick & drag", for easy and fast manipulation of events and
objects
(also, the mouse modes have been re-ordered)
* GUIs: the plug-in system now allows the use of pop-up menus (graphic preset 20)
... see the new CtrlEvent and EditEvent plug-ins as examples
* Compositor: the plug-ins EditRef and EditBox have been replaced by the single
(and more
powerful) EditFields, also using a pop-up menu

v1.074 (Avril 7, 2001)

* bug fixes

v1.073 (Avril 5, 2001)

* bug fixes
* projection computing is about 5 times faster
* improved display of lignes; improved UNDO management for lignes
* new parameter AutoSave: if 1, saves as MIDI files the last projection or box
evaluation,
in the directory defined by MDOP
* new parameter EvalKeyName: a box having this name (default is "GO!") will be the
target for
the buttons [Eval], [Audio], [0], [F], [Score] and [Check], regardless of the
current box
index
* new projectors LinInv & SpirInv

v1.072 (March 29, 2001)

* bug fixes
* main GUI: thanks to a new button, one click is now enough to repeat the last
[display] command
* the main GUI now displays ArcC supports (instead of full circles)
* new projectors: Goutte and Bulle, both based on ArcC
* more info in the wrapper tool upper bar
* KeyKit utilities:
- the functions man() and funclist() browse the #include libraries
example: man("makenote"), funclist("note")
 - seecode() opens the text editor on the file found by the last man() call

v1.071 (March 26, 2001)

* bug fixes
* new projector: ArcC
* Compositor: improved (&) boxes
* Compositor: new plug-in CallScala for microtonal and alternate-tuning stuff

v1.070 (March 24, 2001)

* bug fixes
* new functions SaveVAR(), LoadVAR() and MergeVAR()
* you can now use the "PROJECTORS" item in the registered projectors menu button to
call for
any projector, including non registered ones.
* extra optional parameter for all projectors: df, so that a given projector can
impose its own
distortion settings on the scene (partially or completely, see the manual for
more)
* distortion functions in the Mer array can now work in two modes: merging or
replacing
(again, see the manual for more; also tutorial 5 when it is finished)
* the projector Batteur has been improved (more reference points, DEFINE statements
in program)
* included wctrl (Ctrl Shaper) and wpbshaper (Pitch Bend Shaper), two stand-alone
tools for
editing controllers and pitch bend messages
(not documented)

v1.069 (March 19, 2001)

* bug fixes

v1.068 (March 17, 2001)

* bug fixes
* New functions interfacing with CMask in lib/cmask_utils.k
* (Compositor) better UNDO management; better redraw method
* (Compositor) new (G) boxes

v1.067 (March 9, 2001)

* bug fixes
* [STO] in both GUIs is more solid:
once a state has been STOred, you will need to [UNDO] twice to erase it and go
back before
... this makes it a better and safer way to keep in memory an interesting
development stage.
* Compositor: new (x) boxes

v1.066 (March 7, 2001)

* main GUI: much better management for parameters in distortion functions
(see at the end of the GUI page in the manual for details)
* the Compositor can now embed KeyKit tools in (T) boxes
... see the manual for more.
* both GUIs now handle control keys: Ctrl, Shift and Control-^, so there are now 8
mouse modes
 directly available.
* a phrase window displaying the Snarf content has been added to the GUIs (quite
useful !)
-> use the macro tSW to toggle its display on/off (default is SnarfWindowIsOn =
1)

v1.065 (February 28, 2001)

* several bug fixes in the Compositor Tool
* (Compositor) new parameter: CsoundOrchestra (if not "", overrides Ev["orc"])
* (Compositor) echo boxes with two sources now handle operations on the csound
scores;
they also merge the audio mixes from both sources (previously, only one source
had
its audio and score fields echoed)
* the functions used to scale the boxes (stretching or expanding the musical data)
can now be
fully customized (see the Compositor page in the manual for more)
* new Compositor plug-in: EditBox
... gives access to the internal description of a box (to be used with care)

v1.064 (February 26, 2001)

* bug fixes
* Compositor: plain scores can be imported in the tool as (C) score boxes (so far,
scores had
to be part of a ligne).
Also, the function written by the [HardC] button now also returns the evaluated
score,
along with the phrase.
* new parameter: ScaleToTimeLine (default value 0)
... if set to 1, the [SCA] button in the compositor not only adjust the length of
the boxes,
but also their x-position, so that all boxes are represented in the usual time-
line way.

v1.063 (February 24, 2001)

* a couple more utilities to handle Csound scores (see Csound page in the manual)
also, faster handling of large scores and many small improvments

v1.062 (February 21, 2001)

* new function for an easy mapping MIDI -> Csound score: MidiCS()
(see manual, Csound page, for details)

* new parameter for the GUI: DisplayedText

(its default value is "none", you can set it at the console with the macro
"tis0")
if "nodur", the event nodur is displayed beside its symbol (macro "tisN")
if "index", the event ch/n index is displayed (macro "tisI")
if "score", the first line of the event score is displayed (macro "tisS1")
if "score n", the line number n of the score is displayed (macro "tisS(n)")
if "label", the event label is displayed (macro "tisL")
if "custom", the return value of the function DisplayedTextIs(ch,n), if it
exists,
is displayed (macro "tisC")
v1.061 (February 16, 2001)
* the Compositor tool now renders the main Csound score if an associated orchestra
is
referenced in Ev["orc"]. No more need to dump the score with a "score header" box
(although this is still useful, since it allows for the simultaneous use of several
orchestras)
... see manual: Compositor page and EditScore plug-in reference, for details

* I should have done this before but I completely overlooked it... now it's done:
distortion functions have one more parameter: theta, the angle of the
projection
logically, there is now a new mouse mode, "radial distortion", to display the
distortions
along a circle centered on the event.

v1.060 (February 15, 2001)

* many large and small improvments in Csound scores management
.. see the manual for details (Csound page, and also tutorial 6)
.. (code lives in lib/csound_utils.k, lib/lib_csound.k and
userlib/tutorial_6.k)

v1.059 (February 12, 2001)

* added a "Piste -> events" selection transfert mode;
see the GUI page in the manual and/or tutorial 7 for more

v1.058 (February 10, 2001)

* bug fixes
... a big one: the projection mechanism was subject to confusion between left
and right !
(this bug was there from the beginning, so any music depending on side-based
distortion will
definitely don't sound the same when recalculated... sorry about that)
* new parameter: CheckMode (when 1, projection are not calculated; useful to
quickly check the
geometrical structure of a rendered ligne prior to generating a musical
phrase)

v1.057 (February 9, 2001)

* new projectors: RBox, CBox

v1.056 (February 7, 2001)

* bug fixes
* regions now have a relative mode: their location can be attached to the listening
point
on the projection support.
See the manual for more... (functions reference page, chapter Regions handling)
* EcouteC() and all its derivated projectors now accept an angle value (float
ranging from 0 to
2*Pi) as a starting point parameter
* new projectors: Polygon, TPol, MultiP (see projectors reference in the manual)

v1.055 (February 5, 2001)

* GUI: The management of pistes has been improved: they can be selected and moved
as a single
object (previously they were considered as a bunch of points). See the manual for
more (when
it's updated !)
* GUI: new syntax for [display]: "*Var" will display all objects in the array Var
For example, if P is a piste, [display] "*P" will display all points in the piste,
while
[display] "P" would display the piste itself.

v1.054 (February 2, 2001)

* new GUI mouse modes: "Conph to event" and "Recorded to event"
(work the same as "Snarf to event"; Conph is the last phrase send to MIDI Out from
the console)

v1.053 (January 28, 2001)

* bug fixes
* new GUI plug-in: EvToSnarf

v1.052 (December 13, 2000)

* "phrase" set of distortion functions added to the ChooseDF plug-in
* new projector (a fairly complex one): Batteur, a 2D rythmic sequencer
(not documented yet, except for a basic introduction in french in
lib/batteur.k)

v1.051 (December 8, 2000)

* bug fixes
* new projectors: Arc, MetaPars

v1.050 (December 5, 2000)

* bug fixes

v1.049 (December 4, 2000)

* bug fixes
* Compositor: echo boxes can now accept a second source box for algorithmic
processing
on phrase (Csounds scores and audio still being echoed from the first source
only)
* New parameter: DisplayBoxIndex (default is 1) which does what it says...

v1.048 (December 1, 2000)

* GUI: slight change in the "Snarf to event" mouse mode: if you click on an already
existing
event, its nodur is replaced by Snarf (no new event is created).
You can switch back to the old behaviour by setting Snarf2Ev_Replace to 0
(macro: tSE)
* Compositor: new button [tc] for tagging current box
new button [0] to send evaluated phrase in current box to Midi Out
new type of box: (&) echo (to be documented soon...)

v1.047 (November 27, 2000)

* fixes for linux: some buttons were too small to be used properly, this is fixed
 also, some circles (and notably points) were not displayed: this is also
fixed
(I just tried GeoMaestro on linux today :) )

v1.046 (November 26, 2000)

* bug fixes
* wrapper tool: no more macro "tt" to toggle the tools, use "gTT" instead (or click
[toggle])
(tt is likely to be used somewhere else in a KeyKit function, so we don't want
to make it
a macro)

v1.045 (November 24, 2000)

* bug fixes
* The wrapper tool has been improved: it now features [save] and [read] buttons
(*.gmt files)
so that compositions can be saved/read independently from KeyKit pages. It also has
a status
line providing some info about the different modes for the GUIs that were kind of
hidden
before (for the main GUI: snap mode, current channel, grouping mode, plug-in; for
the
compositor: visible tags mode).

v1.044 (November 23, 2000)

* bug fixes
* Compositor: again, a few more plug-ins... the documentation is now available in
the
compositor tool page of the manual.
* You can now change on the fly the value of NbCan (the number of channels in a
scene)
with the function UpdateNbCan()

v1.043 (November 21, 2000)

* bug fixes
* Compositor: a few more plug-ins, still not documented

v1.042 (November 20, 2000)

* bug fixes
* Compositor: a plug-in system similar to the main GUI one has been implemented
(see lib/lib_cplugs.k and lib/VolEnvlp.k for example code)
... for now, we have a couple of undocumented plug-ins for editing basic volume
envelopes
in (ph)/(�) boxes, and for checking and creating marks in any type of box.

v1.041 (November 18, 2000)

v1.040 (November 14, 2000)
* bug fixes

v1.039 (November 10, 2000)

* bug fixes
* have a look at the userlib/GUIuserreg.k file in the distribution (it is
commented)
... it makes it simpler to upgrade the system without loosing your customizations
* Compositor: set LIGNEDEPTH (default 2) to adjust the way marks are created when
importing
a ligne box. LIGNEDEPTH = 0 will only create marks from SYSEXTEXT messages in
the phrase,
otherwise it sets the nesting depth to go through when examining the ligne
structure.

v1.038 (November 8, 2000)

* New distortion functions array: Time
... use it to create time offsets depending on distance and side
(its behaviour is exactly similar to Volume, Pit and Dur)
* Changes in the ChooseDF and DistMap plug-ins so that they manage the Time array

v1.037 (November 7, 2000)

All changes refers to the compositor tool:
* New mouse mode: "evaluation limits" to render only part of a composition
* It's now possible to mute boxes
* New parameters for audio rendering: FastMix, IgnoreMix and MIX_LOG
* MIDI parts in a composition can be rendered by alternate synthetizers, using
synth (s) boxes
(similar to score header (h) boxes)
... see the manual ("Compositor Tool" page) for details

v1.036 (October 29, 2000)

* bug fixes
* GUI: it is now possible to define one's own permanent graphic background for the
events area,
by writing a GUIbackground() function.
See the manual (at the end of the "advanced GUI features" page) for more
* EcouteC now generates an "inter" field, so that corresponding marks appear in a
compositor box.
* Compositor: "set box length" has been merged to the "grab box" mode: it you grab
the box around
its right end, you will set its length; much more convenient than having two
modes.
* Compositor: when importing a ligne, the SYSEXTEXT "m .." messages from its "ph"
fields are
used to generate marks (previously this was only the case when importing a
phrase)
* Compositor: more colors for custom marks: use "c5" for blue and "c2" for red

v1.035 (October 27, 2000)

* bug fixes
* the internal format of regions has changed (in some cases it was not compatible
with the
usage of the FastRedraw feature)
--> X_, Y_ and C_ have been replaced with Xx_, Yy_ and Cc_
if you want to use older region variables, upgrade them with the function
NewRegF():
RegVar = NewRegF(RegVar)

v1.034 (October 25, 2000)

* bug fixes
* the Mer array has been added to the Volume, Pit, Dur, Pan ones. Its functions
return a phrase
which is merged to the distorting nodur, allowing effects that were
impossible to program
with the other arrays. It also makes it easy to use controllers in
distortions algorithms.
* "RestorePAC" is a distortion function for the Mer array. See the "Using the
GeoMaestro
channels" topic in the manual "Hints and Tips" page for more.
* GUI: new plug-in "DistMap"; see the plug-ins reference page in the manual
* GUI: new parameter RegFill (possible values 0,1,2 or 3) for different types of
region display
(default is RegFill = 0, for points, which was the display option so far)
* Compositor: new parameter SILENCEMARKS setting the maximum length for a silent
box to have
automatic marks (in earlier versions it was hard-coded to 30 seconds)

v1.033 (October 20, 2000)

* bug fixes
* ChooseDF is a plug-in giving access to a large library of distortion functions;
lots of empty
slots, for more functions in the future. No documentation yet (should be in
the forthcoming
tutorial 5 on distortion functions)

v1.032 (October 19, 2000)

* bug fixes
* New projector: EarWalk (see the reference page in the manual)
* New plug-in: SinusDF
... both should be illustrated in the forthcoming tutorial 5

v1.031 (October 16, 2000)

* bug fixes
* A new tool appears in the userlib/localtools1.lst ("-- GeoGUIs --" in the Tools1
menu):
... this is a wrapper allowing a nice integration of the main GUI and the
Compositor in one
single tool. You can toggle between the two tools by typing "tt" at the
console.
This provides an alternative to having the tools on two different pages,
which can be
quite tedious.
* The distortion function "NoPan" now really deserves its name: no pan controller
is created.
The older version (issuing pan controller 63, at the center) has been renamed
"CPan"

v1.030 (October 15, 2000)

* bug fixes
* Compositor: "link offset" and "time scale" stamps are useful variations on basic
links and
time stamps.
v1.029 (October 13, 2000)
* bug fixes

v1.028 (October 12, 2000)

* the Compositor Tool is now done, with certainly a number of bugs to be
discovered..
(see the manual for documentation)

v1.027 (October 8, 2000)

v1.026 (October 6, 2000)
* big developments in the Compositor Tool, but they're not documented yet..

v1.025 (September 30, 2000)

* bug fixes
* the default values for the three optional projector arguments can now be changed
... they are stored in DefDuration, DefT0 and DefRegion

v1.024 (September 30, 2000)

* bug fixes

v1.023 (September 29, 2000)

* bug fixes
* the GUI is now using a specific kind of kvalbuttons whose pull-off menus are
correctly
restored when reading a page (it was not the case up to now)
... if you want to have pull-off buttons get restored as well, it is necessary to
hack the
KeyKit distribution: see the "install" page of the manual

v1.022 (September 27, 2000)

* The GUI can be manipulated from the console with the help of macros
(see lib/macros.k)
* First introduction of the Compositor tool in a very early stage of development
* New tool (not documented): the Snarf Box
... you can use it to manage a collection of phrases
buttons usage:
[>] set Snarf to the corresponding item (phrase)
[+] add Snarf to the collection (give a name to the phrase)
[-] remove this item from the collection
[R] rename this item
[V] import a phrase variable (or a KeyKit expression) in the collection
[X] export this item to a variable
[read] .. a collection (*.sb)
[save] .. the collection (*.sb)

v1.021 (September 25, 2000)

* bug fixes
* Csound scores: see the Csound page in the manual
[operation], [active], [inactive] support the O_ keyword for events "score"
fields
v1.020 (September 22, 2000)
* bug fixes

v1.019 (September 20, 2000)

* bug fixes
* changes in the "ModNodur" plug-in, to make it best fit to the pianoroll from
tutorial 4

v1.018 (September 17, 2000)

* bug fixes
* GUI: new mouse modes "show distortions" and "hear distortions"

v1.017 (September 15, 2000)

* bug fixes
* GUI: the UNDO system has been improved a lot: it is faster and much more flexible

(also, added the parameter EvUNDO and optional UNDO capabilities for plug-in
generators)

v1.016 (September 12, 2000)

* bug fixes (the GUI is much more stable and pleasant to use when things get large,
if the
correct parameters are chosen; see below...)
* GUI: you can now abort calculations when doing and redoing projections
* GUI: new button [A] for displaying the duration, volume or pitch of events
* 5 new projectors:
** RandConnect
arguments: piste, number of segments
usage: calls Ecoute() on random segments from the piste (ordering of the
points is ignored)
** SpiralAB
(see the manual, when it's updated...)
** RandTree
** FractalAB
** FractalV
(these 3 are generating fractal patterns of Ecoute() segments; see the manual
for more)
* GUI: the FullUNDO parameter has been replaced with a set of more definite
parameters:
NoUNDO (if 1, the UNDO feature is not activated, so the GUI is not slown
down at all)
LigneUNDO (if 0, the lignes are not saved, you must [redo] them when UNDO-
ing)
DispUNDO (if 0, display operations can not be UNDOne, useful if big lignes
are displayed)
* A few functions have been written at the end of initialisations.k, to be used as
presets
for example, PowerUser() sets all parameters for an intensive use of the GUI,
while
FastMode() simply speeds up the display, etc...

v1.015 (September 8, 2000)

* bug fixes
* new parameter: AutoSnarph, which set weither or not phrases from "hear ev/seg"
and "hear ev/cir"
are automatically Snarphed.
* new projector: EcPiste (not documented yet)
argument: a piste
usage: calls Ecoute() along the piste, linking consecutive points

v1.014 (September 7, 2000)

* bug fixes
* GUI: two new plug-ins are provided in lib/alt_tuning_utils.k
they make it possible to use alternate names for MIDI notes
(useful in microtonal composition, for example)
... see the comments in the file itself for more

v1.013 (September 4, 2000)

* bug fixes
* drum sets are now supported by the ACPATCHES system, so the understanding of
TiMidity
configuration files is now comprehensive. See the manual ("advanced features"
part) for more
* new tool: wdrumpick, useful to use Kboom-like tools with alternative drum sets
* GUI: new mouse mode: "Snarf to event", makes it faster to import notes or phrases
from another
tool into the Ev scene

v1.012 (August 28, 2000)

* bug fixes

* initialisation can be completed as you like by writing a KeyKit function called

GeoPostInit()
(very much like the liblocal/postrc.k of KeyKit, which you can also use, of
course)

* easy use of TiMidity configuration files (*.cfg) for creating a patchmap

("dir", "source" and "bank" keywords are supported, "drumset" is NOT supported
yet)
usage: set ACPATCHES = n in your liblocal/prerc.k and write the corresponding
ACpatchmap{n}.txt file like this:
#timidity
#cfg C:/timidity/timidity.cfg
#banks 10,20,21,22

"#cfg" is followed by the filename of the .cfg file to consider

"#banks" sets the banks that will be selected in the patchmap
(if it is not present, all banks are selected)
you can combine several "#cfg" statements, but the corresponding "#banks"
statement
must live in the line following the "#cfg" one, otherwise it will be ignored

the names of the patches in the map will be looked for in that order:
- if the line preceding the patch definition start with "#n", whatever
follows is used
- if the line defining the patch contains a "#", whatever follows is used as
name
- otherwise, the last part of the patch filename is used
 If you don't understand a single word of what is said here, please have a look at
the "install"
part of the manual, ACPATCHES is discussed there. Note that there's a bug in
KeyKit6.6b that
must be corrected in order for this feature to work properly (it's also discussed
there)

* New global parameters:

HearWithTimidity, RenderAsWave and EditRenderedWave
These settings allow a fine interaction between GeoMaestro/KeyKit and
TiMidity
.. for example, it is possible to have TiMidity render a ligne as wave (or
any other
supported format) simply when clicking the [hear] button. You can also have
an audio
editor (say, Cool Edit) opens automatically at this point.
See the manual ("advanced GUI features") for more (not today ! I didn't write
it yet...)

v1.011 (August 26, 2000)

* bug fixes
* a few improvements here and there
* Notepad(): if given a second (integer) argument n, displays only the n first
levels
of an array structure

v1.010 (August 24, 2000)

* bug fixes
* better use of the temporary Ma-Mb segment in the GUI
(see GUI documentation about "hear ev/seg" mouse mode, and also tutorial 1)
* GUI: new mouse modes "hear ev/circle" and "new circle"
* GUI: dynamic circles are now available
(syntax: "C~R" for circle with center C containing R)

v1.009 (August 17, 2000)

* bug fixes

v1.008 (August 15, 2000)

* bug fixes (and new bugs ! do not use this version please)
* GUI: it is now possible to include comments flags to the Ev scene ([C] button)
* GUI: string arguments in projector calls are now allowed
* new (not documented yet) projectors: LSeq, LCer, MetaRails, TDiam
* new function (not documented yet): AddLignes

v1.007 (August 11, 2000)

* bug fixes

v1.006 (August 10, 2000)

* bug fixes
* GUI: a polar grid is now available
its center is the point CentrePolaire, init value (0,0)
 (see tutorial 3, when it's finished (not today!))
* GUI: re-ordering of the mouse button menus
New item: "copy(r) selection" (the copy modes now reflect the move/rotate
modes)
* GUI: new button [*] for displaying stacked events aliases, see GUI page in manual

(stacked events are bunches of events having the same (x,y) coordinates)
* GUI: simpler and more powerful syntax for "phrase to segment" and "phrase to
circle" modes

v1.005 (August 5, 2000)

* bug fixes
* GUI: the DISP array now stores history for [display]; use the ":" syntax (see
below)
* History management: added ":?" command which shows the content of the history
So now we have:
"::" recalls last
":"n recalls index n
":?" show history array
The history arrays are:
FIF for [active] and [inactive]
FKK for [operation]
DISP for [display] (new !)
FT for Distort01() (this function is currently only available at the
console)

v1.004 (August 4, 2000)

* bug fixes
* GUI: bang() method implemented (at last!); the bang action is [hear]
and the new parameter TocTocToc sets the amount of time before [hear] starts

(previously it was always 1 second)

* GUI: [STO] now also displays the system settings
* GUI: parameters such as AnimInLignes, FastRedraw, TocTocToc, etc... are now
dumped
with the tool
* GUI: numeric infos available at the console when moving or copying selection

v1.003 (August 3, 2000)

* bug fixes
* GUI: regions can now be displayed (as clouds of random points)
* GUI: a new and very useful parameter in initialisations.k : FastRedraw

v1.002 (July 31, 2000)

* bug fixes
* use of Dirseparator for portability to Mac
* GUI: "rotate selection" now accept numeric parameters (just click once)
* GUI: [hear] can now also displays an animation and detailed information on
projections
--> see the "AnimInLignes" and "FullUNDO" parameters in initialisations.k

v1.001 (July 26, 2000)

* bug fixes
* GUI: relative + absolute referencing in the RL array (x� syntax)
* GUI: grouping feature and changes in the export modes for the [RL] button

v1.0 (July 24, 2000) First public release