A USERS GUIDE TO…
VCXX TOY KEYS
FOR THE COMMODORE VIC-20
BY: RYAN LISTON (includes VIZNUTS PWP PULSE WAVE CODE)
2021
download:TOY KEYS.zip
TARGET:
COMMODORE VIC-20
EXPANSION:
ANY OR NONE
DESCRIPTION:
A simple playable toy keyboard with voice selection, pulse wave selection and a simple attack/release envelope.
FEATURES:
15 Voice variations
15 selectable pulse wave forms
3 octave keyboard
Attack/release envelope
*CVXX Toy Keys is tuned for true interval note values. This is tuned approx. 3/7 flat to standard western tuning but presnts more accurate space between notes.
PACKAGE
VCXX Toy Keys is distributed as a compressed file package (VCXX TOY KEYS.zip or VCXX TOY KEYS.7z.) The package contains files for easy direct usage with Vice, Sdiec, and Tapuino. It also contains file for the user to create their own disk, tape or cart if so desired for personal use. TOY KEYS is intended as a community release. While it is intended for tape I wanted to make it easy for the user to use as they wish in whatever media they wish.
PACKAGE CONTESNTS
TOY KEYS.d64 : Disk image
TOY KEYS.tap : Tape image
tkart.prg : Cartridge loader @ $A000
tkart.bin : Rom image place @ $A000
tkart : Cartridge loader for sdiec @ $A000
toy keys.prg : Loader for disk format
tk.prg : Toy keys program @ $1200
toy keys/ts : prg files for sdiec
tape load.prg : loader for tape format
tape make.prg : Writes TS.prg to tape format
tape load/tape make : Tape writer files for sdiec
TAPE MAKE.d64 : Tape writer disk image
TOY KEYS.wav/TOY KEYS.mp3 : audio format
DEV KIT : file containing full source code and dev files.
TOY KEYS USERS GUIDE.pdf : users guide
SETUP
*VCXX Toy Keys is designed to run with any memory expansin. Do not force load.
Disk : 1. insert disk
2. load “*”,8
3. run
Tape : 1. insert tape
2. press shift+run/stop
3. press play on tape
S2diec: : 1. copy TOY KEYS and TS to a sd card
2. insert sd into sdiec
3. load “TOY KEYS”,8
4. run
Cart loader : 1. load “TKART”,8,1
2. sys 64802
Audio format : 1. record TOY KEYS.wav or TOY KEYS.mp3 to a cassette
2. (see tape)
Using the tape maker 1. load “TAPE LOAD”,8
2. save “TOY KEYS”
3. press play+record on tape
4. load “TAPE MAKE”,8
5. run
*you will receive a syntax error. This is due to the tape maker over writing and corrupting the original basic code. This is ok.
VOICE CONTROLS
Press return to toggle between the editor and the player.
VOLUME (VOL) : L=volume up. Shift+l=volume down.
Volume sets the peek gain of the envelope. 15 is max. 0 is off.
WAVE FORM (WAV) : :=wave up. Shift+:=wave down.
0=the Vics normal square wave. 1-15=pusle waves provided by Viznuts pwp pulse wave technique.
The selected wave form is applied across all active voices except for the noise channel.
VOICE (VOC) : ;=voice up. Shift+;=voice down
VOC selects between different combonations of the Vics 4 voice channels
0=all voices off
1=bass
2=tenor
3=tenor+bass
4=alto
5=alto+bass
6=alto+tenor
7=alto+tenor+bass
8=noise
9=noise+bass
10=noise+tenor
11=noise+tenor+bass
12=noise+alto
13=noise+alto+bass
14=noise+alto+tenor
15=noise+alto+tenor+bass
A/R ENVELOPE
ATTACK (ATT) : ,=attack up. Shift+,=attack down (0-99)
Attack determines the amount of time it takes for the volume to reach the peak gain (VOL) when a key is pressed.
RELEASE (REL) : .=release up. Shift+.=release down (0-99)
Release determines the amount of time it takes for the volume to reach 0 after a key is released.
The envelope does not re-trigger when a new key is pressed. If a new key is pressed the new note triggers but the envelope continues
When volume=0 and a key is pressed the attack slope is triggered. Volume increases by 1 every int(att/vol) ticks of the jiffy clock until volume=vol.
If a key is still held down after the attack slope has ended then the note will hold at peak gain until released.
When a key is released the release slope is triggered. Volume decreases by 1 every int(rel/vol) ticks of the jiffy clock until volume=0. If a new key is pressed befor volume=0 then the attack slope will be triggered from the current volume level.
KEYBOARD LAYOUT
C1=Z C#1=S D1=X D#1=D
E1=C F1=V F#1=G G1=B
G#1=H A1=N A#1=J B1=M
C2=Q C#2=2 D2=W D#2=3
E2=E F2=R F#2=5 G2=T
G#2=6 A2=Y A#2=7 B2=U
C3=I C#3=9 D3=O D#3=0
E3=P F3=@ F#3=- G3=*
G#3=(pound) A3=(arrow up) A#3=(clr/home) B3=(insert/delete)
vol=l/shift+l wav=:/shift+: voc=;/shift+;
att=,/shift+, rel=./shift+.