# Antescofo Workflow¶

In this chapter, we will see how to work with Antescofo, from the edition of the score to the interactions with Max, PureData or other softwares through OSC.

## Editing the Score¶

The first step in the development of an Antescofo Application is probably the authoring of the augmented score. An augmented score is a text program and can be edited with any text editor (like Sublime, TextWrangler or Emacs but not with a text processor like Office/Word).

Older versions of Antescofo comes with a companion application: Ascograph. Ascograph is a graphical tool that can be used to edit and then to control a running instance of Antescofo through OSC messages. This tools is now deprecated because it cannot handle the full range of the language. Ascograph can still be used on very simple Antescofo score but is usage is no longuer supported. Most of the command available in Ascograph to drive a running Antescofo instance in Max are also available, e.g. from the Sublime editor, using the dedicated mode. Take also a look at function @bach_score which makes possible to export an Antescofo score to Bach in order to visualize the piano roll of the musical events and to follow in real-time the progression in the score. See the bachscograph patch proposed by Serge Lemouton.

### Importing Scores to Antescofo (import of Midi files and of MusicXML files)¶

Very often, the musical events to follow have already been specified through a score editor (Finale, Sibelius ...), or exist as a MIDI score.

It is possible to automatically import MIDI or MusicXML scores to Antescofo format to spare the burden of rewriting the followed part. This feature is available by drag and drop a MIDI or MusicXML file into a dedicated web page: https://antescofo-converter.ircam.fr/

For multiple instrument score, care should be taken to extract required part in a separate MIDI or MusicXML file. The result is an Antescofo score that can then be modified at will.

The conversion can be also produced by a standalone application (termoinal mode) which offers additional options.

Users employing these features should pay attention to the following points:

### Importing MIDI scores to Antescofo¶

The major problem with MIDI format is the absence of grace notes, trills, and glissandi. Such events will be shown as a series of raw event elements in the score.

Another major issue with MIDI import is the fact that in most cases, timing of note-offs are not decoded correctly (based on where the MIDI is coming from). Bad offset timing creates additional event with linked pitches (negative notes) with short durations. To avoid this, we recommend users to quantize their MIDI files using available software. The Antescofo importer does not quantize durations.

### Importing MusicXML scores to Antescofo¶

MusicXML is now the standard inter-exchange score format file between various score editing and visualisation software. It includes high-level vocabulary for events such as trills, grace notes and glissandi which can be converted to equivalent events. However, decoding and encoding MusicXML is not necessarily unique for the same score created by different software!

The Antescofo MusicXML import is optimized for MusicXML exports from FINALE software. Before converting MusicXML score to Antescofo, users are invited to take into account the following points and to correct their score accordingly, especially for complex contemporary music scores:

• Avoid using Layers: Merge all voices into one staff/voice before converting to MusicXML and dragging to the web converter. XML parsers sometimes generate errors and suppress some events when conflicts are detected between layers.

• Avoid using Graphical Elements in score editors. For example, Trills can only be translated to if they are non-graphical.

• Avoid Hidden elements in your scores (used mostly to create beautiful layouts) as they can lead to unwanted results during conversion. Verify that durations in your score correspond to what you see and that they are not defined as hidden in the score.

• Verify your Trill elements after conversion as with some editors they can vary.

This feature is still experimental and we encourage users encountering problems to contact us through the Online User Group.

## Deprecated : Using AscoGraph¶

The information given here is given only for those that are still able to use ascograph on simple Antescofo score. Ascograph is no longer supported.

An Antescofo score is a simple text file and can be edited by any text editor like Sublime, Emacs, Atom, etc.

Max users can also use the Antescofo Max Object Autowatch attribute. This means that if the loaded score is modified elsewhere, it'll be automatically reloaded in the Max object. Obviously, you'd want to turn this attribute off during live concerts! Autowatch is currently not available for PureData objects.

For the people that prefer use their own beloved text editor, we have created some syntax highlightings for Sublime Text, TextWrangler and... emacs ! You have just to download them in our Forum. The [plugin]((https://discussion.forum.ircam.fr/t/antescofo-v0-92-and-sublimte-text-editor/2021) for Sublime offers also some keyboard shortcuts to control a runing Antescofo instance (through OSC messages).

The automatic indentation provided by editors like Sublime for Antescofo score is basic. It is always possible to send a printfwd message to the antescofo object. This command will write a file with an automatically indented version of the score together with various additional information (depending on the current verbosity). This file can be loaded again in Antescofo. Notice however that macros are expanded in this score and that the initial comments are not reported.