Recherche Google
OpenMusic 6 – User ManualThe OM Environment > Library > Packages
previous pagenext page

Packages

Package

A package represents a category of programming tools that encloses related functions and classes. It can be organized in sub packages.

Packages of the Library Window

Each package is represented by a small suitcase.

The OM Packages are the most numerous. They contain classes1 and functions2 predefined in OM. OM Packages are defined thematically.

For instance, the Score package contains classes that are literally dedicated to the score domain, such as chords, notes, polyphonies, and functions that can perform operations upon these classes.

These packages and their content are "protected" and cannot be modified by the user.

 The User Package can receive user-defined classes and functions, which can be dispatched in dedicated sub packages. These classes and functions can be modified.

  The User Libraries package encloses a set of additional libraries that can be added or loaded dynamically.

The Globals package is a special folder that contains user-defined global variables3. It cannot contain sub packages.

If a package is supposed to contain sub packages, it features an adjacent triangle that allows to open a package on List mode . When this triangle is clicked, the package unfolds and displays its inner sub packages – see below.

About Global Variables
About User Libraries

Packages Content

A package gives access to both functions and classes of a common "theme", or category of tools. Packages contents can be displayed in List mode, Package mode or Class Tree mode .

Opening Packages in List Mode

The List mode is the sole mode that allows to get a global view of a package whole organization in sub packages.

Classes and functions contained in the sub packages cannot be accessed, though.

The Midi and Audio packages are open in list mode. We can see their sub packages, but classes and functions cannot be accessed.
The Midi and Audio packages are open in list mode. We can see their sub packages, but classes and functions cannot be accessed.
Opening Packages in Package Mode

The Package mode allows to access the set of tools contained in a package as a whole : sub packages cannot be visualized.

  • Ctrl / right click on the suitcase and choose Open Package.
  • Double click on the lower part of the suitcase.

The window extends to display two side panels, respectively containing the package's functions and classes. Their content is refreshed at the selection of another package.

Opening Packages in Class Tree Mode

A " class tree " shows the inheritance between the classes of a common package.

  • Ctrl / right click on the suitcase and choose Open Class Tree
  • click on the upper part of the suitcase.

The class tree is displayed in a new window. Class trees of the User sub packages can be created and modified graphically.

More Information about Class Hierarchy and Inheritance

Using Classes and Functions from the Libary

Dropping Items in Patches

Tools can be dropped in patches from the library window.

Classes and Functions Editors
Openin the editor of a BPF.
Openin the editor of a BPF.

The tools of a package can sometimes be edited. Their content can be displayed in a class or a generic function editor, which opens with a double click on the class or function's icon.

More Information about the Class Editor and the Generic Function Editor
Getting Information

To obtain information about a select package, class or function of the library, use the Info window :

  • Ctrl / right click on an item and choose Get Info
  • select File / Get Info
  • press Cmd + i .

Information related to the items of the User package can be edited.

  1. Class

    A category of objects sharing common properties – characteristics and behaviour. A class specifies the internal structure and behaviour of an object. In OM, it is represented in a patch by a factory box that can produce an instance of a class.

    See also : Object, Instance

  2. Function

    A  portion of code within a larger program, which performs a specific task. Operates upon 0 or more parameters and returns a value.

  3. Global variable

    An instance of OM object that has been saved in order to be used in other programs. Global variables are visible from the Library window and stored as .omi files in the Globals folder of the workspace.

Class Trees, User Defined Material : Object Oriented Programming
previous pagenext page
About...(c) Ircam - Centre PompidouMade with Scenari