View source for Advanced Music Creator

=== Advanced Music Creator v1.0 INFONOTE&nbsp;  ===

====== (Joshua's Infonote, heavily paraphrased for coherence, by Arun)  ======



With this software you are able to place up to 7 different tunes into one playerfile, e.g. if you are composing for a game you can slip the intromusic, your game-music and your game-over music into one file and only one player is used. 

You are not limited any more to the three-voice-patterns. Each track has its own list, where you enter the number of blocks (a block of notes etc.) you want to play on the track. It means you can play every block on every channel! 

The player’s coding of the AMC features a complete ADSR-routine. What does that mean for you? The volume-course of a sound is now controlled by Attack, Decay, Sustain and Release. In case you don’t know what this means, here’s a small excursion: 

ATTACK: This defines the time, used for swelling the sound-volume from zero to the maximum (at the beginning of each note). 

DECAY: After the volume has reached its maximum, this parameter defines the time, while the sound-volume falls down from the maximum to that volume, defined by the sustain-parameter. 

SUSTAIN: Within the sustain-phase the sound-volume is held at this volume. 

RELEASE: Within the release-phase the volume of the sound is reduced to zero. The length of time it takes to do so is defined by the release-parameter. 

A final note: As you know, the playing rate of music is one time per frame (50 times a second). But with Joshua’s composer you can now break this standard and create musics played two or four times a frame, known as double- and quadrospeed. You can realise nice effects like scratching or digi-like drums. 

The first time you start AMC, perhaps you will be a little shocked by the design. But that’s all you need for composing, and of course a little more... 

<br> 

<u>The TrackEdit</u> 

Most of the screen is used for the three track-tables, one for each channel. With the cursor-keys you can move the cursor through the tracks, the current cursor-position within a track is displayed in the upper left-hand corner. You can enter the following into the track-tables: 

00-7F A block of notes, commands...<br>80-BF Loop the following block XX-80 times<br>C0-FB Transpose the following blocks XX-C0 halftones up<br>FC Fade volume to the maximum, the following byte defines the fading-speed, lower means faster<br>FD Fade volume to zero, speed defined as like as byte $FC<br>FE Stop track<br>FF Init track – the following byte defines the new track-position 

As you can see, in AMC all values are in hex. 

Useful Keys in the TrackEdit: 

CLR Copy area from the current cursor-position to the last position ($FF) to buffer<br>CTRL + CLR Copy and clear from current cursor-position<br>CTRL + COPY Paster buffer to the current cursor-position<br>TAB Jump to SoundEdit (see below)<br>ESC Jump to DiscMenu<br>CTRL + TAB Jump to TuneEdit<br>CTRL + ESC Edit song-infotext<br>CTRL + RET Jump to BlockEdit 

<br> 

<u>The BlockEdit</u> 

The current number of the block you are editing is displayed in the upper-right corner. The value right of it displays the current cursor-position within the block. 

In a block you define your notes like C-0, F#4 or A-7, as you want them to be played in the track. To enter a note press the letter representing the note, i.e. “C” or “A”, if you hold SHIFT down you’ll get the note a halftone higher, e.g. “D”+SHIFT for D#. Then the cursor moves over the octave numeral, and you can change it. To enter commands, press [full-stop] at the first column, then the first letter of the command you want, as there are: 

.SND #XX Define sound-number for the following notes.<br>XX=$00-$1F 

.DUR #XX Define duration (the time to wait before a note is to be played) for the following notes.<br>XX=$00-$77 

.VOL #XX Define the volume for the following notes.<br>XX=$00-$0F 

.WAV #XX Change hardenvelope-waveform.<br>XX=$00-$0F 

.FRQ #XX Change hardenvelope-frequency<br>XX=$00-$FF 

.OFF Reset the attack-bit-mask – it means the sound will be released.<br>A nice effect occurs if you use .OFF commands without new notes in betweem them: the attack-bit-mask will be complemented (0 will be 1, 1 will be 0).<br>You can use this for echo-effects or others. 

.TIE Skip initialising sound on each note – only the note frequencies will be set. A second .TIE will turn skipping off. 

.GLD XX YY ZZZ<br>Slide from the current playing frequency to the note ZZZ.<br>XX is the speed (the adding-byte), YY the duration ($00 means add every frame). 

●END● Stop this block and go to next track-position. 

Function-keys in the BlockEdit: 

CLR Same as in TrackEdit<br>CTRL + CLR Same as in TrackEdit<br>CTRL + COPY Same as in TrackEdit 

TAB Jump to SoundEdit (same as in TrackEdit) 

CTRL + RET Return to TrackEdit<br>ESC Return to TrackEdit 

<br><u>The SoundEdit</u> 

In this new screen you can design your sounds. In the upper-left corner the current sound-number is displayed. At the top of the screen you can define the general parameters: 

ATTACK/DECAY XY X means attack,<br>Y means decay-value.<br>SUSTAIN/RELEASE XY X means sustain,<br>Y means release. 

WAVETABLE XX The number of the wavetable (see below)<br>XX=00-1F 

HARDENVTABLE XX XX-80 determines which hardenv-table is being used.<br>XX=80-8F<br>XX=00-0F means no hardenv is being used! 

VIBRATO-DELAY XX The number of frames to wait, before vibrato starts 

VIBRATO-LEVEL XX The add-byte. 

VIBRATO-COUNT XX The number of addings before the add-byte becomes negative value 

FIRST-WAVEBYTE XX See below! 

Function keys in the SoundEdit: 

CLR Same as in Track- and BlockEdit<br>CTRL+CLR Same as in Track- and BlockEdit<br>CTRL+COPY Same as in Track- and BlockEdit 

TAB or ESC Return to Track- or BlockEdit 

CTRL + RET When the cursor is at the hardenvtable-value you enter this table, otherwise you enter the wavetable-edit. 

<u><br>About wavetables, wavebytes and ADSR</u> 

As you read in the introduction, the volume is no longer controlled by valuetables where every volume-byte, frame by frame, is defined, as you find in actual music editors like SoundTrakker and others. 

In AMC the volume is completely controlled by the player. Here the ‘wavebyte’ has a function: 

Bit 7 Turn hardenv on current voice on/off 

Bit 6 The ‘attack-bit’: when it’s 1, the player drives the attack-decay-sustain-phase; when it’s 0 the release phase. 

Bit 5 When it’s 1, the ADSR is initialised and volume set to zero 

Bits 4-0 The noise-frequency $01-$1F; $00 means turns noise off. 

This wavebyte you can define frame-by-frame in the left column of the wavetable. Every right column is the arpeggio-byte; this value is added to the current note, e.g. 00, 03, 09 for a minor chord.<br>When you set bit 7 in the arpeggiobyte, the note-value will be taken directly, irrespective of the current note, allowing many new effects. 

An example: 

00: 41 FF ATTACK + NOISE, NOTE $7F<br>01: 40 00 ATTACK NOTE +0<br>02: 40 00<br>03: 00 00 RELEASE NOTE +0<br>04: 00 03 +3<br>05: 00 07 +7<br>06: FF 03 JUMP TO $03 (continuous chord) 

The first arpeggiobyte $FF means set XX-80 directly, in that case $7F.<br>However, values greater than $5F will not be audible, so the tone is switched off in the first frame. Why? Look at the wavebyte: $41. It means attack volume and noise turned on to $01, and, as you should know, noises are best without a tone on the same channel.<br>You can also see the special byte $FF in position $06: it means jump to ... 

So what does the FIRST WAVEBYTE mean?<br>Because of the slow PSG-addressing I decided to play no tables in the every first frame of a new note, because it would take too much rastertime. Regarding the unplayed wavetable in this frame, the player got the wavebyte through this ‘first wavebyte’!<br>Usually you should set it to $20 (init ADSR), then you will get the best dynamic, because if the sound on the actual track has not already finished, it will be by the $20. 

The hardenv-table is nearly the same as the wavetable, except: it will only be recognised on Track 3! 

The left-byte functions: 

Bit 7 Set hardfrq in the following way:<br>Add to the current note the right byte (so it’s an arpeggiobyte) and recalc it to hardenv.<br>So the player does convert the note-frequency to the hardwave-env-frequency! 

Bit 6 Add the right-byte to the current hardenv-frequency; the amount of addition is defined by the right byte in the next row. 

Bit 4 Send bits 0-3 as the waveform to the PSG 

Bits 0-3 When bit 4 is 1 these bits define the waveform. 

Example: 

00: 98 00 Set wave $8, get frq from note<br>01: 40 01 Add +1 to the freq<br>02: 00 01 2 times<br>03: 40 FF Add –1 to the freq<br>04: 00 01 2 times<br>05: FF 01 Jump to 01 

$01 means 2 times because it’s $00-sensitive, so $02 means 3 times, and so on... 

<u></u> 

<u></u>

<u>TuneEdit:</u> 

The meaning of the values: 

TUNE The current tune you are editing. Don’t forget: each tune has its own tracks, but the sounds and blocks will be the same! 

VOICE Bit 0: Track 3 on/off<br>Bit 1: Track 2 on/off<br>Bit 2: Track 1 on/off 

SPEED Defines the speed of the current tune. 

VOLUME Same for the volume. Set it to $0 when you want to start a tune with fading-in. 

<u></u> 

<u></u>

<u>DiskMenu</u> 

You enter the DiskMenu by pressing ESC in the tracktables. From there you can inspect the content of your disks (known as directories) and delete the actual song. Of course you can always load and save your song. 

When you have finished your music you can save it with the player (no converter is required). 

First you will be asked for the location-address of the player, then you have to enter the save-filename, and so on... 

The music can be played like this: 

First init it with<br>LD A, TUNENUMBER<br>CALL ADRES+0 

Then CALL ADRES+3 

If you want to fade out the song by a call you can use the following: 

LD A, SPEED<br>CALL ADRES+6 

<br> 

<u>General Function Keys</u> 

These keys can be used at any place: 

F7 Play current tune<br>F4 Stop playing<br>F1 Continue playing<br>F0 Fast forward<br>F9 Singlespeed<br>F6 Doublespeed<br>F3 Quadrospeed 

You can sign your music with some text, by pressing CTRL+ESC in the tracktables. This text will also be saved if you save the music with the player!<br><br>