E ROSEGARDEN, MISCELLANEOUS, Musical Notation Editor and Midi Sequencer    Rosegarden 2.1 ==============  ? This is the Rosegarden Editor and Sequencer suite, release 2.1.   ? See COPYRIGHT for information about copyrights, and COPYING for < information about redistribution and (the lack of) warranty.  < See INSTALL for details of how to install this distribution.  2 Chris Cannam, cannam@zands.com        October 1997  F Rosegarden V 2.1 port under OpenVMS                       January 1998# ===================================   M Rosegarden provides a Musical Notation Editor and a Midi Sequencer on various   Unixes and now on VMS systems !!   Usage: ------H Rosegarden is composed of 3 executables, Rosegarden.exe (also called theK Topbox), Editor.exe and Sequencer.exe . Rosegarden.exe lets you execute the E Musical Notation Editor, the Sequencer and access to the Help system.   N The kit contains binaries for VAX and Alpha, built under VAX VMS 6.1 and Alpha VMS 6.2   M You need to copy ROSEGARDEN.DAT ressource file under your SYS$LOGIN directory 3 or under SYS$COMMON:[DECW$DEFAULTS.USER] directory.   5 On VAX, you need to rename *.EXE_VAX files into *.EXE   N Now, run SETUP_VMS.COM procedure to define logicals and the rosegarden symbol.   You invoke Rosegarden by:    $ rosegarden  K You can also run the Editor and the Sequencer as stand-alone programs using E roseditor and rosesequencer command. However, the help system is only 2 available through rosegarden "topbox" application.  I The Sequencer can be used as an X11 interface for Timidity, the nice Midi M player you must use on VMS. Timidity for VMS can be found at my site (and its  mirrors) at urls:   A  http://www2.cenaath.cena.dgac.fr/ftp/decwindows/timidity-02i.zip   7 You also need instrument samples (also called patches):   J  http://www2.cenaath.cena.dgac.fr/ftp/decwindows/timidity_base_samples.zip  Q  http://www2.cenaath.cena.dgac.fr/ftp/decwindows/timidity_instruments_samples.zip K  http://www2.cenaath.cena.dgac.fr/ftp/decwindows/timidity_drums_samples.zip I  http://www2.cenaath.cena.dgac.fr/ftp/decwindows/timidity_wow_samples.zip I  http://www2.cenaath.cena.dgac.fr/ftp/decwindows/timidity_new_samples.zip   K Unzip the patches archives in the same order. The best configurations files J (using selected and tested patches from the sets) are in the last one. TheN total size of patches is about 15 Mo (the price to pay for a good quality midi4 software only player) but the result is really nice.   Rebuild: ------- I You need an X11R5 XAW and XMU library. You can find it at my site and its  mirrors at urls:  C   http://www2.cenaath.cena.dgac.fr/ftp/decwindows/x11r5_xaw_xmu.zip 1   ftp://ftp2.cnam.fr/decwindows/x11r5_xaw_xmu.zip 4   ftp://ftp.wku.edu/vms/decwindows/x11r5_xaw_xmu.zip  M The definition of X11R5 logical names is done into MAKE_*.COM files. You must D customize accordingly to your own installation. By default, I invoke [X11R5]LOGICALS.COM procedure    To rebuild on VAX, you type:   $ @setup_vms $ @make_vax    To rebuild on Alpha, you type:   $ @setup_vms
 $ @make_alpha   H At the end of the build, the 3 executables EDITOR.EXE, SEQUENCER.EXE and( TOPBOX.EXE are moved to [.BIN] directory  D If you just want to relink, you'll find LINK_AXP.COM (for Alpha) andK LINK_DECC.COM (for VAX) procedures into [.EDITOR.SRC], [.SEQUENCER.SRC] and  [.TOPBOX.SRC] directories.   Modifications and adaptations: ----------------------------- L The BUFFER_INITIAL_SIZE for Midifiles is now 400 Kbytes to handle big files. (in [.MIDI.INCLUDE]MIDIFILE.H)  J Sub processes are spawned via LIB$SPAWN in NOWAIT state. An AST routine isE used to handle sub process termination. (I don't use C/Unix signals).   L Subprocesses are used by TOPBOX to execute the Editor and the Sequencer. TheJ Sequencer also uses a subprocess to play midi files via an external player (timidity on VMS).  L The ressource file for VMS is ROSEGARDEN.DAT . Note that you need to provideM either a command name or an "mc file_specification" for Editor and Sequenceer & executables (because I use lib$spawn):   !!! Paths, edit these   = Rosegarden*editorName:          mc ROSEGARDEN_DIR:[bin]editor @ Rosegarden*sequencerName:       mc ROSEGARDEN_DIR:[bin]sequencerI Rosegarden*helpFile:            ROSEGARDEN_DIR:[common.help]rosehelp.info K Rosegarden*midiFmPatchFile:     ROSEGARDEN_DIR:[common.synth-patches]std.sb M Rosegarden*midiFmDrumPFile:     ROSEGARDEN_DIR:[common.synth-patches]drums.sb @ Rosegarden*sequencerName:       mc ROSEGARDEN_DIR:[bin]sequencerI Rosegarden*helpFile:            ROSEGARDEN_DIR:[common.help]rosehelp.info K Rosegarden*midiFmPatchFile:     ROSEGARDEN_DIR:[common.synth-patches]std.sb M Rosegarden*midiFmDrumPFile:     ROSEGARDEN_DIR:[common.synth-patches]drums.sb   F You need to put your preferred Timidity options in the ressource file:  5 !!! this is for the sequencer's "Play through Slave":   7 Rosegarden*externalPlayer:      timidity "-a" "-s32000"      Bugs/Limitations:  ----------------K This port has some limitations, mainly in the Interlock system and the file  browser:  ? The file browser is ok with files but not yet with directories.   O The Interlock library is not ported on VMS. The Editor and the Sequencer cannot M communicate without explicit action on the both sides (for example you export O to a midi file in the editor and you read that file in the sequencer. Not a big H deal). If someone has some spare time to implement Interlock library ...  O The Help system is only available in Rosagarden aplication (the topbox) and not ! into the Editor or the Sequencer.   ( Filters in TCL are not tested under VMS.   Enjoy !!   Patrick Moreau pmoreau@cena.dgac.fr moreau_p@decus.fr 