GFWD Editor
  1. Choose the Tools menu.
  2. Choose the GFWD Editor... item from the Tools menu.

The GFWD Editor was added to NoteAbilityPro so that action messages could be embedded in the score and exported as part of an antescofo score-following file. This feature is only of interest for composer wanted to advanced score-following using the antescofo~ object developed at IRCAM.

There are 4 objects available in the Image Palette that are connected to GFWD messages. They are located near the end of the Image Palette icons and appear as below:

The blue GFWD tool is used to add simple GFWD messages to the score. The green GFWD tool is used to add complex GFWD messages which will be encapsulated in a hidden window. The LFWD tool is used to create LFWD actions (i.e. repeating loops) and the KILL tool is used to cancel LFWD messages.

For details on the syntax of GFWD and LFWD messages, the user should refer to the help files for the antescofo~ object developed at IRCAM.

The most direct way to invoke the GFWD editor is to choose the green GFWD tool, click on the score and type a single word that will be a reference for the GFWD message. Once you type return, the GFWD Editor will appear where you can imbed the actual GFWD code.

Once you close the GFWD Editor panel, the GFWD object in the score will be altered to show the duration of the embedded events in the GFWD message.

The LFWD messages are created in a similar way to the green GFWD messages except that the reference name entered in the score must end with a "*n" designation which indicates the length of the loop in beats. For example "short*2.0" as a LFWD name would indicate that the loop should be repeated 2.0 beats. The LWFD loop will continue until there is a KILL object with the same name as the LFWD name (without the *n addition). In other words, we need a KILL object named "short" in order to stop the loop.

With both the green GFWD and the LFWD objects, you can view and edit the embedded message by clicking on the button on the score. When you do this a floating window appears with your code in it. Click on the button again to hide the window.

It is also possible to add additional GFWD or LFWD messages, macros, and functions by clicking on the buttons on the GFWD Editor panel. If you are adding these messages, you will need to include both a reference name (on the left side of the panel) and the code associated to that reference (on the right side of the panel.) Once these have been entered, you can create connections to the code by returning to the score and typing the reference name in a new GFWD or LFWD object.

If you want to save the entire contents of the GFWD panel, you can click on the Save File button. If you want to load an existing GFWD file, click on the Load File button.

Neither the blue GFWD images nor the KILL images use the GFWD editor - these can be entered directly on the score. In the case of the blue GFWD object, the code is entered directly in the text box below the GFWD image. The Kill objects only contain the name of the LFWD they are stopping. Below are all four objects as they appear in a score.

The antescofo code generated by these embedded messages will be:

GFWD 39.50 test
	playNote 60
	0.5 playNote 62
	0.5 playNote 64
	0.5 playNote 65
GFWD 0.25 event0 
	playNote 91
	2.0 playNote 92 
LFWD 2.25 short 1.000
	playNote 60
	0.5 playNote 62
KILLFWD 4.25 short

See also

© Keith A. Hamel 1998-2005 - All Rights Reserved