8bitfiles.net/archives/archives.tar/archives/genie-commodore-file-library/MusGraph/SIDWORKS.ARC/SIDWRKS.DOC.P

Text File | 2019-04-13 | 8KB | 197 lines

                      sID wORKS sHOP

                      bY tECH mILLER
                  (tECH mILLR ON q-lINK)




introduction:

    sID wORKS sHOP IS THE eNHANCE sID uTILITY 'i' HAVE BEEN WAITING
FOR!  tHE eNHANCE sID eDITOR IS A GREAT TOOL FOR WRITING AND ENTERING
MUSIC INTO A .MUS FILE.  hOWEVER, IT IS QUITE CUMBERSOME WHEN IT
COMES TO GETTING THE SOUND OF THAT VOICE JUST RIGHT.  yOU HAVE TO
BOUNCE BACK AND FORTH TIME AFTER TIME.....  tHIS UTILITY SHOULD EASE
THAT BURDEN.  pLUS YOU HAVE THE ABILITY TO SAVE VOICE 'PARAMETERS'
FOR FUTURE USE OR REFERENCE.


overview:

    tHE sID wORKS sHOP IS A SINGLE VOICE SID REGISTER UTILITY THAT
EMULATES MOST 'EFFECTS' FOUND ON THE eNHANCE sID eDITOR.  iT ALLOWS
FOR THE SETUP AND ADJUSTMENT OF THE NORMAL a-d-s-r REGISTERS, THE
FILTER REGISTERS AND ALL THE OTHER STANDARDS.  iT ALSO ALLOWS THE
ASSIGNMENT AND ADJUSTMENT OF SPECIAL EFFECT REGISTER, IE. pORTAMENTO,
vIBRATO, fILTER/pULSE sWEEP, AND A COUPLE OF OTHERS.  tHE UTILITY HAS
PROVISIONS FOR AUTOMATIC RANDOM SETTING OF ALL THE REGISTERS,
TWEEKING/TUNING OF THE REGISTERS, DRIVING A PRINTER, AND
SAVING/LOADING OF VOICE PARAMETERS.
tHERE ARE TWO MODES OF 'TEST LISTENING' AVAILABLE SO EVALUATIONS CAN
BE MADE EASILY.  aND ALL THIS FOR THE LOW, LOW PRICE OF..... free!

    nOW YOU CAN EASILY ADJUST AND HEAR THE SOUND YOU WILL USE IN THE
sID eDITOR.  yOU CAN EASILY CREATE RANDOM SOUNDS (SOME OF WHICH ARE
QUITE SURPRISING) AND EXPAND YOUR PARAMETER LIBRARY  QUICKLY.  eNOUGH
JIBBER JABBER...


main menu:

    mOST OF THE FEATURES ARE SELF EVIDENT.  oNE IS NOT LISTED ON THE
SCREEN.  aLL OF THESE WILL BE BRIEFLY DESCRIBED.

f1:
    pRESSING f1 WILL DISPLAY ALL THE CURRENT SID PARAMETERS ON THE
SCREEN, ALONG WITH THE APPROXIMATE PLAYING TIME OF THE SOUND IN
JIFFIES.

f2:
    tHIS KEY WILL RANDOMLY SET ALL SID REGISTERS TO A VALUE BETWEEN 0
AND THE MAXIMUM VALUE OF THE REGISTER.

f3:
    f3 WILL PLAY A SHORT SONG WITH QUARTER, HALF AND WHOLE NOTES.
tHIS SONG IS A SOUND ENVIRONMENT SIMILAR TO THE EDITOR.

f4:
    tHIS KEY WILL CAUSE A PRINTER DUMP TO OCCUR.  a SOUND NAME WILL
BE PROMPTED, THEN PRINTER PRESENCE TESTED.  tHIS PRINTER DRIVER USES
FORM FEED CHARACTERS (chr$(12)) AND SO IS NOT 100% 1525 COMPATIBLE.





f5:
    aLLOWS ADJUSTMENT OF THE REGISTERS.  uSE THE CURSOR KEYS TO MOVE.
 tHE +/- KEYS TO INCREMENT/DECREMENT, f1/f3 FOR FAST INC/DEC.  f8 KEY
WILL RETURN TO THE main menu.

f6:
    lOADS A SOUND PARAMETER FROM THE DISK THE PROGRAM WAS LOAD FROM.
tHE PARAMETER NAME WILL BE ASKED FOR.

f7:
    sAVES THE CURRENT SOUND PARAMETER OF THE DEFAULT DISK DRIVE.
aGAIN, THE PROGRAM WILL ASK FOR A FILE NAME.

f8:
    f8 TERMINATES THE PROGRAM.  bEFORE IT ENDS, THE PROGRAM
DISENGAGES THE INTERRUPT ROUTINES, SO JUST HIT THE NORMAL KEY, DON'T
BREAK OUT!

space:
    tHIS KEY IS NOT NOTED ON THE MAIN MENU!  tHIS KEY WILL PLAY 3
NOTES.  aLL THREE WILL HAVE THE FULL ATTACK, DECAY, AND RELEASE
TIMES.  eACH WILL HAVE SLIGHTLY DIFFERENT SUSTAIN TIMES.  tHIS OPTION
WILL ALLOW YOU TO HEAR THE ENTIRE SOUND!  but... iT TAKES TIME, AND
THERE IS NO WAY TO STOP IT, SHORT OF RUN/STOP - RESTORE.  sO BE
AWARE!


notes, comments:

f2:  sINCE THE REGISTERS ARE RANDOMLY SET, IT IS POSSIBLE TO GET A
SOUND THAT IS INAUDIBLE.  iF THIS HAPPENS TRY ADJUSTING OR TURNING
OFF THE FILTER.  aDJUSTING THE SUSTAIN.  oR JUST HITTING f2 AGAIN.
uSE f5 TO ADJUST THE REGISTERS.

f3:  pLAY SONG.  tHE VOICE SETUP CAN DRASTICALLY AFFECT THE SOUND OF
THIS SONG.  aT TIMES IT MAY SEEM OUT OF TUNE OR SEQUENCE.  iT'S
NOT... iT'S JUST THE VOICE YOU HAVE SELECTED!    wHEN PLAYING THE
TUNE, IF ANY KEY IS PRESSED, THE TUNE WILL TERMINATE ON THE NEXT
NOTE.

f4:  tHE PRINTER i USE IS A sEKOSHIA sp1000.  i WROTE THIS VERSION TO
BE COMPATIBLE WITH THAT PRINTER.  tHE DRIVER USES THE chr$(12)(FORM
FEED) TO FEED TO THE TOP OF THE PAGE.  aNY PRINTER THAT ACCEPTS THE
FORM FEED CHARACTER SHOULD BE DIRECTLY COMPATIBLE.  1525 PRINTERS AND
THE LIKE SHOULD STILL PRINT, JUST NOT AS PRETTY.  tHE NEXT VERSION
SHOULD BE MORE COMPATIBLE.  tHE PROGRAM WILL PRINT TEN VOICE
PARAMETERS PER PAGE, THEN FORM FEED.

f5:  wHEN IN THE ADJUSTMENT SCREEN THE CURSOR KEYS MOVE THE SELECT
WINDOW AROUND, THE +/- KEYS INCREMENT/DECREMENT BY ONE.  tHE f1/f3
KEYS INCREMENT/DECREMENT BY TEN.  aLL KEYS REPEAT IF YOU HOLD THEM
DOWN.  f8 KEY WILL RETURN TO MAIN MENU.  eACH REGISTER HAS A MAX
VALUE.  tHE INCREMENT WILL NOT INCREMENT PAST THIS MAX VALUE.

f8:  tHE f8 KEY SELECTS QUIT.  aT THE END OF THE PROGRAM IT ASK YOU
TO PRESS THE RETURN KEY.  aFTER THE RETURN KEY IS PRESSED, THE
INTERRUPT ROUTINES ARE DISABLED, AND KEY REPEAT RESTORED TO NORMAL.
bE VERY CAREFUL ABOUT EXITING OTHER WAYS!  iF YOU HIT THE RUN/STOP
KEY DURING PROGRAM EXECUTION, MAKE SURE YOU RUN/STOP RESTORE BEFORE
RE-RUNNING THE PROGRAM.  tHE INTERRUPTS MUST BE DISABLED BEFORE THE
PROGRAM IS RUN TO AVOID LOCK-UP.





    cERTAIN EFFECTS CAN CANCEL EACH OTHER OUT.  pOR WITH A LARGE
NUMBER WILL TEND TO BE LESS NOTICEABLE.  iF pOR IS A SMALL NUMBER AND
VIBRATO IS ACTIVE, WITH p&v OFF, YOU MAY NOT HEAR ANY VIBRATO.  tHIS
IS BECAUSE pOR NEVER COMPLETES IT'S CYCLE.  tHE SWEEP FUNCTIONS WRAP
AROUND... JUST LIKE THE sID eDITOR.  pNT CAN DRASTICALLY CHANGE A
SOUND.  pNT ADJUST THE TIME AT WHICH THE RELEASE PHASE IS TRIGGERED.
tHE LARGER pNT THE LESS TIME ATTACK/DECAY WILL HAVE.  pNT CAN MAKE A
VOICE SOUND LOWER IN VOLUME AS WELL.
wHEN pOR IS OFF (AT ZERO) p&v IS AUTOMATICALLY TURNED ON.  sINCE pOR
IS OFF IT WILL NEVER REACH THE END OF IT'S CYCLE, SO IF p&v IS OFF,
THE VIBRATO CYCLE WILL NEVER OCCUR.  sOME EFFECTS VALUES ARE SO LARGE
OR SMALL THEY ACT AS IF THE EFFECT WAS INACTIVE.  iN CASES LIKE THAT,
FEEL FREE TO DRIVE THE EFFECTS VALUE TO ZERO (TURN IT OFF).  fOR
COMPLETE DEFINITION OF THE REGISTER FUNCTIONS, SEE eNHANCED sID
eDITOR MANUAL.  mOST POINTERS THEY GIVE ALSO APPLY TO THIS UTILITY.


tech notes:


    tHE MACHINE LANGUAGE PART OF THIS PROGRAM HAS BEEN APPENDED TO
THE END OF THE BASIC PROGRAM.  a MOVE UTILITY WAS APPENDED BETWEEN
THE m/l AND basic PROGRAMS.  iF YOU MAKE ANY CHANGES IN THE BASIC
THAT CHANGE THE LENGTH OF THE PROGRAM, THE LINKED m/l IS LIKELY TO BE
DISTURBED.  tHIS MAY CAUSE THE PROGRAM TO CRASH.  tHE BASIC PART IS
heavily COMMENTED.  tHE MACHINE LANGUAGE PORTION, AFTER IT IS MOVED
INTO PLACE, OCCUPIES MEMORY STARTING AT 49152 (c000).  tHE REGISTERS
AND m/l VARIABLES ARE LOCATED BETWEEN 49220 (c044) AND 49324 (c0ac)
INCLUSIVE.  tHEN END OF THE m/l SECTION, AFTER MOVING, IS 49927
(c307).


closing:

    aT THIS TIME THERE IS NO DIRECTORY, AND NO WAY TO CHANGE THE
DEFAULT DISK DEVICE.  sO YOU ARE BLIND, AND ARE STUCK WITH THE DRIVE
YOU LOAD THE sID wORKS sHOP FROM.  fOR THIS REASON, i SUGGEST YOU
MAKE A SEPARATE DISK WITH NOTHING BUT sID wORKS sHOP, AND SOUND
PARAMETERS ON IT.  oCCASIONALLY DUMP THE DIRECTORY TO YOUR PRINTER,
AND KEEP THIS PRINT OUT WITH THE DISK.  tHE NEXT VERSION SHOULD HAVE
SOME USEFUL FEATURES, SUCH AS, DIRECTORY, DEVICE CHANGE (PRINTER AND
DRIVE), AUTOMATED REPLACE, AND A COUPLE OF OTHER FEATURES.



    iT'S NOT TOO PRETTY.... bUT IT DOES A GOOD JOB!  hAVE FUN WITH
IT, AND DROP ME A LINE IF YOU HAVE ANY COMMENTS!

................. tech 3/30/90

(tECH mILLR ON q-lINK)



eNHANCED sIDPLAYER/eDITOR IS WRITTEN BY cRAIG cHAMBERLAIN, AND (c)
cOPYRIGHT BY compute! pUBLICATIONS (1986).

tHE PROGRAM LINKER USED (ml64load.obj) IS WRITTEN BY jOHN l.

tHE FAST LOAD/BOOT (sizzle!) IS WRITTEN BY rAY rOBERTS AND pHIL
bACON.

tHANK yOU TO ALL THAT HAVE CONTRIBUTED!