| Both sides previous revision
Previous revision
Next revision
|
Previous revision
|
dev:development [2008/05/01 11:43]
cannam |
dev:development [2023/05/06 20:05] (current)
tedfelix [Old Stuff] |
| |
| ======Development====== | ======Development====== |
| |
| A place to gather miscellaneous development notes. | A place to gather miscellaneous development notes. |
| |
| * **See also: [[Contributing|HOWTO contribute]]** | ===== doxygen ===== |
| * **See also: [[Future Plans]] | |
| * **See also: [[http://rosegarden.sourceforge.net/code_doc|Doxygen code documentation]]** | |
| * **See also: [[EclipseCDT|Eclipse/CDT with Rosegarden]]** | |
| * **See also: [[UnitTesting]]** | |
| |
| | Generate and view doxygen code documentation from the rosegarden directory as follows: |
| |
| ====Explanatory Snippets==== | doxygen |
| | xdg-open build/doc/html/index.html |
| |
| 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. | Or substitute your favorite browser for ''xdg-open''. |
| |
| See also the [[http://sourceforge.net/mailarchive/forum.php?forum_name=rosegarden-devel|rosegarden-devel archives]]. | //These used to be available online at http://rosegarden.sourceforge.net/code_doc but that is no longer maintained.// |
| |
| ===Basics=== | ===== From the Main Page ===== |
| |
| * [[Manipulating the document]] | ==== Development ==== |
| | * [[dev:new_developers|Welcome For New Developers]] |
| | * [[dev:Coding Style]] |
| | * [[dev:file_format_version|File Format Version]] |
| | * [[dev:layout_code|Rosegarden Coding Style: Qt Layouts]] |
| | * [[dev:config_groups_config_groups|QSettings Config Groups]] |
| | * [[dev:unittesting|Unit Testing]] |
| | * [[dev:rg_qt4_dialogs|Blurb about dialog buttons rescued from an otherwise obsolete set of pages]] |
| | * [[dev:Dealing with Latencies]] |
| | * [[dev:svn To git Transition]] |
| |
| ===GUI=== | ==== Work In Progress ==== |
| | * [[dev:linked_segments|Linked Segments Branch]] |
| | * [[dev:notation_cleanup|Notation Cleanup Branch]] |
| | * [[dev:tnp|TrackButtons Notification Project]] |
| | * [[dev:percussion|Percussion Notation]] |
| |
| * [[Loading the Studio or other partial documents from XML]] | ==== Ideas ==== |
| * [[Keeping GUI elements updated]] | * [[dev:Summer Code]] -- suggestions for pieces of work that new developers might like to get started with |
| | * [[dev:midi_control_interface_draft| Draft for better MIDI-Controler support]] |
| | * [[dev:Future Plans|Future Plans]] |
| |
| ===Sequencer=== | ==== Metrics ==== |
| |
| * [[Instruments and Devices]] | * License structure: Currently GPL2+ and 1 Artistic license. |
| | * [[https://www.openhub.net/p/rosegarden|Rosegarden on OpenHub]] |
| | * [[https://www.openhub.net/p/rosegarden/contributors/summary|Contributors]] |
| | * [[https://www.openhub.net/p/rosegarden/map|World map of registered users and developers]] |
| | * [[https://www.openhub.net/p/rosegarden/commits/summary|Commits]] |
| |
| ===Translations=== | ===== Old Stuff ===== |
| |
| * [[Making strings translatable]] | * [[dev:Code Consistency]] |
| | * [[http://www.linuxtech.net/downloads/rosegarden_1.7.3_mandriva_rpm.html|Rosegarden 1.7.3 rpm for Mandriva Linux 2008.1]] |
| | * [[http://www.linuxtech.net/musicgear/synth_korg_05rw.html|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. |
| | * [[http://www.linuxtech.net/musicgear/synth_yamaha_rm50.html|complete Yamaha RM50 rgd device definition file]] |
| |
| | =====Explanatory Snippets===== |
| |
| ====Discussions about Future Work==== | 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. |
| |
| These are either topics that have come up on the mailing list, or things that originally appeared as open-ended feature requests on our trackers. | See also the [[http://sourceforge.net/mailarchive/forum.php?forum_name=rosegarden-devel|rosegarden-devel archives]]. |
| |
| See also [[Summer_Code|Summer code]]. | ====Basics==== |
| |
| ===Notation=== | * [[Manipulating the document]] |
| | * [[MIDI dataflows]] |
| | * [[Control Changes]] |
| | * [[Update Notifications]] - Keeping the UI in sync with underlying data. |
| |
| These need to be simmered down into a single unified Theory of Notation Editing. | ====GUI==== |
| |
| * [[Notation editor improvement thoughts]] | * [[Loading the Studio or other partial documents from XML]] |
| * [[Score layout, not just notation layout]] | * [[Keeping GUI elements updated]] |
| * [[Notation layout, staff types etc]] | |
| |
| ===Sequencer=== | ====Sequencer==== |
| |
| * [[Making a noise by default]] | * [[How A Note Becomes A Sound]] |
| | * [[Instruments and Devices]] |
| |
| ===Other=== | ====Translations==== |
| |
| * [[Ramblings about scripting]] | * [[Making strings translatable]] |
| * [[A Vision]] | |
| |
| | =====Documents in Subversion===== |
| | |
| ====Documents in Subversion==== | |
| |
| There are several plain-text documents found in the Rosegarden source code repository ([[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/|browse]]). | There are several plain-text documents found in the Rosegarden source code repository ([[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/|browse]]). |
| These ones are either vaguely interesting, or at least not hopelessly out of date: | These ones are either vaguely interesting, or at least not hopelessly out of date: |
| |
| ===Basics=== | **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/ ** |
| | |
| | ====Basics==== |
| | |
| | * [[Overall code structure]] |
| | * [[dev:creating_events.txt|Creating Events and their properties]] |
| | * [[dev:how_a_note_becomes_a_sound|How a note becomes a sound]] |
| | * [[dev:units.txt|Pitch and time units for Events]] |
| | * [[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/code/iterators.txt?view=markup|Iterating over Events in segments and compositions]] (Need to rescue from svn. See NOTE above.) |
| | * [[dev:xml_format| XML format]] |
| | ====Notation==== |
| |
| * [[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/code/guidelines.txt?view=markup|Code formatting guidelines]] | * [[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/data_struct/tuplets.txt?view=markup|Triplet/tuplet event storage properties]] (Need to rescue from svn. See NOTE above.) |
| * [[Overall code structure]] (out of date with respect to code file locations and build structure) | * [[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/data_struct/sets.txt?view=markup|Notation event grouping terminology]] (Need to rescue from svn. See NOTE above.) |
| * [[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/code/creating_events.txt?view=markup|Creating Events and their properties]] | * [[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/code/notation_layout.txt?view=markup|Notation layout procedure]] (Need to rescue from svn. See NOTE above.) |
| * [[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/data_struct/units.txt?view=markup|Pitch and time units for Events]] | |
| * [[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/code/iterators.txt?view=markup|Iterating over Events in segments and compositions]] | |
| |
| ===GUI=== | ====Sequencer==== |
| |
| * [[http://%5b%5bhttp//rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/design/Menu-Standards.txt?view=markup%5D%5D|Menu layout explanation]] | * [[Recording from multiple MIDI ports]] (but not onto multiple tracks simultaneously - this document predates that work) (was branches/obsolete/docs/code/multiport_recording.txt) |
| * [[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/code/toolbars_management.txt?view=markup|Saving toolbar state]] | |
| |
| ===Notation=== | ===== Obsolete Pages ===== |
| |
| * [[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/data_struct/tuplets.txt?view=markup|Triplet/tuplet event storage properties]] | ==== Subversion ==== |
| * [[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/data_struct/sets.txt?view=markup|Notation event grouping terminology]] | |
| * [[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/code/notation_layout.txt?view=markup|Notation layout procedure]] | |
| |
| ===Sequencer=== | * <del>[[dev:subversion|Subversion Quick Start]]</del> - //Obsolete// |
| | * <del>[[:Development from SVN|Installing a Development Version from Subversion]]</del> - //Obsolete// |
| | * <del>[[dev:Using git with svn]]</del> - //Obsolete// |
| | * <del>[[dev:Branching|Working with Branches]]</del> - //Obsolete// |
| |
| * [[http://rosegarden.svn.sourceforge.net/viewvc/rosegarden/trunk/docs/code/multiport_recording.txt?view=markup|Recording from multiple MIDI ports]] (but not onto multiple tracks simultaneously - this document predates that work) | ==== Miscellaneous ==== |
| |
| | * <del>[[dev:eclipsecdt|Using Eclipse/CDT with Rosegarden]]</del> - //Obsolete// |
| | * <del>[[dev:Working with Multiple Installed Build Versions]]</del> - //Obsolete// |
| |
