Instrument Mode

From AGL : Help Wiki
Jump to: navigation, search

Instrument Mode is based inside of AudioGL's Project View.

The Instrument Mode is the highest level of the program, allowing you to break parts of your song into different instruments.



The instrument system is an abstraction layer which exists over top of AudioGL's modular synthesizer. When a group of modules are placed into an instrument, they can be considered a separate instrument in your song, or they can just be a group of modules which seem to belong together.

The instrument system does not remove any of the flexibility of the underlying modular synthesizer. If you place a group of modules into an instrument, you still have the ability to connect them to any of the other modules in your project. This is why the instrument system is referred to as an "abstraction layer."

Placing modules into instruments gives you the ability to store those modules and the sequences they contain. You can easily take pieces of one song, and import them into a different project.

Tips and Tricks

  • When you drag an intrument rectangle over top of any modules in your project, those modules will be added to the instrument. To remove modules from an instrument, switch to Module Mode and drag the modules outside of the instrument rectangle.

  • In AudioGL Beta, instruments are not designed to overlap. If you have overlapping instruments in your project, there will be some confusion untoward which modules belong to which instrument.

  • If you do not want to use preset instruments, you should still use the instrument system. It will help you organize your project.

  • Always name your instruments.

Future Development

The instrument system is under heavy development. Here are some features that are underway.

  • Default sequencers, inputs, and outputs. These defaults will be user-assignable.

  • The default system translates directly into an auto-connect system. Default outputs will be automatically connected to the default inputs of other instruments.

Loading a Preset Instrument

To add a preset instrument to your song:

  1. Click on a Preset in the Instrument Pane.
  2. Drag the Preset into the Project View.
  3. Release the mouse button. You can Pan, Zoom, and Rotate the Project View, to find a good position for the preset.
  4. You will see a rectangle under your mouse cursor, which shows how large the instrument is. Find some free space in your song, and place the instrument there by clicking your mouse again.
  5. To connect your instrument, switch to Module Mode.

Creating a New Instrument

To group a series of pre-existing modules into an instrument:

  1. Hold down the Secondary Function, and drag the mouse cursor.
  2. A Rectangle will be forming under the mouse cursor. When you are happy with the size of the instrument rectangle, release the Secondary Function.
  3. The instrument has now been created. Any modules which are inside the rectangle will be added to the instrument automatically. To add more modules into the instrument, you can either resize the rectangle, or click on it and drag it over top of the modules you want to add.

Renaming an Instrument

It is important to name your instruments. When you name an instrument, the modules contained in the instrument will be indexed under that name. See the tree view article for details.

  1. Click on the instrument rectangle.
  2. The instrument name is displayed on the top left corner of the rectangle. Hover the mouse over the text.
  3. Use the Open/Start Function on the text.
  4. Rename the instrument, and click outside of the text to finalize it.

Saving an Instrument

This is how you save an instrument. After you save the instrument, it will be listed on the Instrument List.

  1. Click on the instrument rectangle.
  2. Click on the Save Instrument Button.
  3. Give the Instrument a preset name. This name will be used to place your instrument on the Instrument List.
  4. Click the save button. AudioGL should report that the instrument was saved successfully.
  5. Close the popup menu.

If you want to manage your instruments externally, you can find them in AudioGL's program directory, in the folder named "Instruments."

Deleting an Instrument

This is how you delete an instrument from your project:

  1. Click on the instrument rectangle using the Quaternary Function.

Moving an Instrument

This is how you move an instrument:

  1. Click on the instrument rectangle and drag it to a new position.
  2. Be careful where you move your instrument. When you place an instrument over top of a module, that module will be added to the instrument.

Resizing an Instrument

This is how you resize an instrument:

  1. Click on the instrument rectangle.
  2. You will see small white rectangles on the corners of the instrument rectangle. Click on them and drag the mouse.
  3. If you zoom out, the white rectangles will appear to be very small. This is a bug. The rectangles are still there, and you can resize the instrument by clicking on the corners of the instrument rectangle.


Function Action
Open/Start Edit instrument Names. Open Sequencer Editor.
Primary Select, Move, Resize.
Primary Alternate You cannot select multiple instruments at this time.
Secondary Create new instrument. Click and drag the mouse.
Tertiary Not used.
Quaternary Delete instrument under the mouse cursor.
Quinary Not used.
Senary Not used.
Personal tools