8. Preferences



8.1. File Preferences
The user preferences for Sequitur are accessed by selecting File -> Preferences... from a song window.

The preferences window

8.1.1. Remember Open Songs
By checking the Remember open songs box, when Sequitur is launched it re-opens all the songs that were opened when it was last exited. This preference is on by default.

8.1.2. Choose Skin
The Choose skin preference allows you to select Sequitur's current appearance. Skins must be placed either in the Skins/ folder located in the same folder that contains the Sequitur application, or in the home/config/settings/AngryRedPlanet/Sequitur/Skins/ folder. You must close and restart Sequitur for new skin to be active.

8.1.3. Open New Songs
The Open New Songs preference controls songs that are created when you select File -> New from a song window:

8.1.4. Open From Query
The Open From Query preference is a flexible utility that uses native BeOS queries or folders to extend the File -> Open... menu item in the song window. For each correct Open From Query entry you create, a new Open menu item is added to the File menu. When you select this new Open menu item, the results of the query (or the contents of the folder) are listed in a submenu. If you have MIDI files that you access frequently, this preference can be very useful for saving you the extra steps of invoking and navigating through an Open file dialog.

The simplest way to add a new Open From Query item is to find an existing folder that contains MIDI files and drop it into the Open From Query table. This will construct an entry with the same name as the folder. You can change the name by selecting the new entry and pressing the Change button.

You can also add an entry based on a BeOS query. To do this, you will first need a query that returns MIDI files. To create a new query, first select Find... from the BeOS menu. Instructions on using the Find... window can be found in the User's Guide of your BeOS documentation (here if your documentation is installed). The goal with the query you are writing is to have something that quickly returns the MIDI files you are interested in. Remember to pay attention to how fast the query runs: This query will be performed each time you access it from the song window. Once you have written a query and run it to make sure it performs quickly enough, BeOS places a new file with that query in the home/queries/ folder. (To be safe, you should probably move this file to someplace where you won't lose it.)

Take the query file you've just created and drop it onto the empty Open From Query table. This creates a single entry where the On column is Yes, the Name columns is the name of the query file, and the Query column is the query file you dropped. Double-click this entry and type in a name -- let's use "music" -- in the Open From Query window. This name will be used to identify this entry in the song window's File menu.

With your Open From Query entry set up, press OK in the Preference window and select the File menu from a song window. You should see an addition item under Open... named Open music. Whenever you select this item, your query will be performed and the results will be displayed in a submenu.

Why is this useful? One way in which it can be used is to embed portions of your file system into the File menu. For example, if you have one folder that contains all of your MIDI files -- say it's called "music", and it's the only folder on your hard drive named "music" -- then writing a query for folders named "music" will answer this single folder. If you then turn this query into an Open From Query preference, whenever you select the File -> Open music menu item, your music folder and all its subfolders will be available for navigation from within the File menu. Selecting a MIDI file while navigating this menu will open the file. This can be very helpful if you keep switching between a variety of songs.


8.2. Edit Preferences
There is a single edit preference, used to set the number of undo steps. Setting this value to 0 turns off undo.


8.3. Playback Preferences
There is a single playback preference, Track windows follow playback position. When this preference is on, track windows will follow the current song position as the song is playing (although note that track windows will not follow if playback was invoked from a track window, they will only follow when playback is invoked from a song window). This preference is off by default.


8.4. Creating a Skin
Sequitur is designed for flexibility. In addition to a flexible MIDI composition architecture, Sequitur's graphics and colors can be customized. A default skin, Skins/ExampleSkin, is provided to use as a template. An additional skin, Skins/Technicolour, demonstrates that you only need the graphics and colours that you change in the skin; any you don't include will default to the originals.

To make a skin, follow these steps: