node@ "edit"

NEW EDITING FEATURES

Replace Notes

The Replace Notes window, opened through the Edit menu, is an extension to
the Change Notes feature of the Transpose window (although the Swap feature
is not provided, only Change). Both the note and its instrument number and
player command can be changed. Programmable key-like "transparency" is also
supported.

You provide OctaMED with a "source" note and a "destination" note. Then,
OctaMED replaces all source notes found in a particular area of the song
with the destination note. For example, you can replace all C-2 10C32's in
the current track with C-2 10C48 if you like.

Setting the source and destination notes

Set the source and destination notes in the Source and Dest boxes, both
initially xxxxxxxx. This means that all parts of the note are "transparent"
(see the following section). As well as the note name and octave number,
you also set the note's instrument number and player command.
(In the help guide, a note with its five digits is called a "full note".)

You set the Source and Dest boxes in exactly the same way as in the
Programmable Keys window. To set a note, hold down the left mouse button
over the note in the box (initially the first three 'x's), then press the
note's key and release the mouse button.

For example, to set the Source note to G-2: Position the mouse over the
note in the Source box. Now hold down the left mouse button, and press T.
Assuming that Oct is set to 12 (Main Control window), the note becomes G-2.
To set the note to ---, use the Del key.

To set an instrument digit or player command digit, hold the left mouse
button over the digit, then type the digit and release the mouse button.

To reset Source or Dest to xxxxxxxx, use the Res buttons. The Swap button
swaps the Source and Dest notes. This can be used as an "undo" feature: To
reverse the effect of (for example) clicking Block, click Swap then click
Block again.

Transparent notes/digits

When setting a note or digit, try pressing Return instead of pressing the
note's key or typing the digit. The note or digit is now "transparent", and
is shown as 'x'.

Transparent notes or digits are ignored by OctaMED. So if the Source box
contains xxx x0C32, OctaMED will replace all 0C32 player commands,
regardless of their note and instrument number. Similarly, if the Source
box contains G-3 4xxxx, then OctaMED will replace all G-3's played by
instrument 04, regardless of what their command digits are.

Transparency in the Dest box has a slightly different meaning. If the Dest
box contains xxx x0C32, then the player command of all Source notes will
become 0C32: the note and instrument number will remain unchanged.
Similarly, if the Dest box contains G-3 4xxxx, all Source notes will become
G-3 and will be played by instrument 04: their command digits will remain
unaffected.

Both sets of notes and digits are all transparent by default, as this is
considered the most useful default setting.

Replacing the notes

In the lower half of the window, the six buttons replace the given notes
in one of six different areas. These areas are as in the Transpose window,
aside from Note which replaces just the Tracker editor's current note.

For example, clicking Block replaces the Source note with the Dest note
throughout the current block. Sel. Tracks replaces throughout the
"selected" tracks (a track is selected by clicking on its S gadget at the
top of the Tracker editor).

Examples

Transparency and the choice of six areas make this window pretty powerful.
Here are a few examples to help you get the hang of it.

1) Throughout the entire song, change all G-2 notes to C-3.

   Source: G-2 xxxxx
   Dest:   C-3 xxxxx
   Click:  Song

   (The Transpose window's Change Notes function can also do this.

    Notice that if the Source and Dest digits were set to 00000, only G-2
    notes having no instrument or player command - very unlikely! - would
    be affected. The xxxxx makes OctaMED ignore the digits.)

2) Throughout the track that the Tracker editor's cursor is currently on,
   change all instrument 02 to 06. (So any notes played by instrument 02
   on the current track will instead be played by instrument 06.)

   Source: xxx 2xxxx
   Dest:   xxx 6xxxx
   Click:  Track

   (The Transpose window's Change Instrument function can also do this.)

3) Throughout the current block, change all 04 command types to 14 (normal
   vibrato to Protracker-compatible vibrato).

   Source: xxx x04xx
   Dest:   xxx x14xx
   Click:  Block

   (Dest could also be xxx x1xxx, because the second command type digit of
    Source notes is already 4.)

4) Throughout the Tracker editor's marked range, clear all command digits.

   Source: xxx xxxxx  (This means "any note or digits")
   Dest:   xxx x0000
   Click:  Range

   (Sets the command digits of all notes in the range to 0000, leaving the
    notes and instrument numbers untouched)


Changes to Generic Slide

Player commands interpret their command level in one of three different
ways, depending on the type. Some, like 0C (set volume), take both digits
together as a single positive value. Others, like 04 (vibrato), take each
digit separately as different values. With vibrato, the 1st command level
digit represents speed, the 2nd depth.

Still others, like MIDI command 03, take both digits together as a "signed"
value. So command 03's level can range from -128 to 127 (decimal), instead
of the normal 0 to 255.

Previously, Generic Slide always assumed the command level to be a single
positive value. Now it's a bit more intelligent!

1) Command types taking a signed number now slide in a signed way. For
   example (in MIDI mode):

   Initial values     Old Gen. Slide    New Gen. Slide

     --- 003FD          --- 003FD         --- 003FD
     --- 00000          --- 003AA         --- 003FF
     --- 00000          --- 00356         --- 00301
     --- 00303          --- 00303         --- 00303

2) Command types interpreting each digit separately have the digits slid
   independently of each other. For example:

   Initial values     Old Gen. Slide    New Gen. Slide

     --- 00457          --- 00457         --- 00457
     --- 00000          --- 00444         --- 0044A
     --- 00000          --- 00432         --- 0042C
     --- 0041F          --- 0041F         --- 0041F

   So in this example, level digit 1 (speed) slides downwards from 5 to 1,
   while digit 2 (depth) slides up from 7 to F. Previously, this wasn't
   possible.

Making a slide with Mix mode command 20 (relative sample offset) ensures
that command 2000 is never added, because this reverses the sample. Also,
stereo separation slides (command 2FDx) are created properly.


Other new features

The Transpose window has a new cycle gadget, Out-of-range Notes. It
determines what OctaMED should do with notes that are to be transposed out
of range; that is, notes to be made lower than C-1 and higher than F#B, as
a result of a transposition. Change Octave transposes the note name but
leaves the octave number unaffected. Leave Intact leaves the whole note
unaffected. Deleted removes the whole note.

Also in Transpose, the Change button in the Change Instruments section now
works if Instruments Slots is on. It moves the source instrument to the
destination instrument slot.

All Cmd Pages is a new switch, in the Block, Track and Edit menus, that
affects cutting and copying. When on (default), Cut and Copy affect all
command pages. When off, only notes in the current command page are cut or
copied.

OctaMED's behaviour when pasting command pages has also changed. If there is
only one page in the copy buffer, it is pasted to the current page. If there
are several, they are pasted to their respective positions, starting from
page 1. Selecting Paste from the Block menu increases the number of pages in
the current block, if the block contains fewer pages than the copy buffer,
to accommodate the extra pages.

Re-mark Range in the Edit menu brings back the most recently marked range in
the Tracker editor.
                           @{" Contents  " link "Main" 0}


@endnode