Development

A place to gather miscellaneous development notes.

• See also: Doxygen code documentation (NOTE: This is broken. Not sure that we generate doxygen docs anymore. To generate doxygen docs, run doxygen in the rosegarden dir. The docs will appear in /tmp/html/index.html per the OUTPUT_DIRECTORY value in Doxyfile.)

• Welcome For New Developers
• Coding Style
• File Format Version
• Rosegarden Coding Style: Qt Layouts
• QSettings Config Groups
• Unit Testing
• Blurb about dialog buttons rescued from an otherwise obsolete set of pages
• Dealing with Latencies
• svn To git Transition

• Linked Segments Branch
• Notation Cleanup Branch
• TrackButtons Notification Project
• Percussion Notation

• Summer Code – suggestions for pieces of work that new developers might like to get started with
• Draft for better MIDI-Controler support
• Future Plans

• License structure: Currently GPL2+ and 1 Artistic license.
• Rosegarden on OpenHub
  • Contributors
  • World map of registered users and developers
  • Commits

• Code Consistency
• Rosegarden 1.7.3 rpm for Mandriva Linux 2008.1
• complete Korg 05R/W rgd device definition file - This is already shipped with rg, although the shipped version is slightly different in terms of the “ipbposition” of some of the controllers. Otherwise they are identical. This link can be archived someplace for reference off the front page.

These are short explanations that have come up on the Rosegarden developers' mailing list at one time or another, sometimes with a bit more detail added in the wiki.

See also the rosegarden-devel archives.

• Manipulating the document
• MIDI dataflows
• Control Changes
• Update Notifications - Keeping the UI in sync with underlying data.

• Loading the Studio or other partial documents from XML
• Keeping GUI elements updated

• How A Note Becomes A Sound
• Instruments and Devices

• Making strings translatable

There are several plain-text documents found in the Rosegarden source code repository (browse).

These ones are either vaguely interesting, or at least not hopelessly out of date:

NOTE I didn't realize this page simply linked to SVN. These documents are no longer available. We should just move them into the wiki and update them as we go, but I am not going to finish that anytime soon. The documents that have not yet been rescued can be found in http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/branches/obsolete/docs/

• Overall code structure
• Creating Events and their properties
• How a note becomes a sound
• Pitch and time units for Events
• Iterating over Events in segments and compositions (Need to rescue from svn. See NOTE above.)
• XML format

• Triplet/tuplet event storage properties (Need to rescue from svn. See NOTE above.)
• Notation event grouping terminology (Need to rescue from svn. See NOTE above.)
• Notation layout procedure (Need to rescue from svn. See NOTE above.)

• Recording from multiple MIDI ports (but not onto multiple tracks simultaneously - this document predates that work) (was branches/obsolete/docs/code/multiport_recording.txt)

• Subversion Quick Start - Obsolete
• Installing a Development Version from Subversion - Obsolete
• Using git with svn - Obsolete
• Working with Branches - Obsolete

• Using Eclipse/CDT with Rosegarden - Obsolete
• Working with Multiple Installed Build Versions - Obsolete