INTRODUCTION YOU ARE NOW IN CONTROL OF THE MOST POWERFUL EVOLUTION IN CHARACTER GRAPHIC PROGRAMS FOR THE C-64. AS SUCH, WE ASK FOR A SMALL SHAREWARE CONTRIBUTION OF $5.00 OR MORE IF YOU USE THIS PROGRAM. SEND YOUR CHECK OR MONEY ORDER (NO CASH PLEASE) TO: BRYCE L. TOMLINSON C/O BIG OL' 64 5227 NE 23RD PORTLAND, OR 97211 YOUR SUPPORT IS GREATLY APPRECIATED, AND WILL PROVIDE ENCOURAGEMENT FOR BIGGER AND BETTER VERSIONS OF KALEIDOSCOPE. IF ENOUGH CONTRIBUTIONS ARE SENT, I WILL PRINT SOFT-BACK MANUALS FOR REGISTERED OWNERS. I WOULD LIKE TO EXPRESS SPECIAL THANKS TO THE FOLLOWING PEOPLE FOR THEIR WONDERFUL HELP AND SUPPORT IN THE PRODUCTION OF THIS PROGRAM: ERIK "MINDWALKER" AYER: FANTASTIC M/L PROGRAMMER, (WROTE STAMP ROUTINES FOR THIS PROGRAM!) AND TRUSTY SIDEKICK KEN "CAPTAIN KENBY" NAKATSU: SUPER IDEA MAN, FINDER-OF-ALL-BUGS, AND BEST OF ALL, A GOOD FRIEND WHEN I NEEDED ONE. GEORGE "DA GNOME" SMITH: GRAPHICS ENTHUSIAST, IDEA MAN, AND HARDCORE GUINEA PIG. KATHY (RAY) SMITH: ANOTHER SUPER-ENTHUSIAST, IDEA PERSON, AND FAITHFUL FAN OF KALEIDOSCOPE. CHRIS NELSEN: CAPED CRUSADER, GUINEA PIG, MORAL SUPPORT. PAT "MAESTRO" YOUNG: MORAL SUPPORT AND SOMEONE TO PICK ON WHEN I DON'T HAVE ANYTHING ELSE TO DO WITH MY TIME (HAHAHA). JERRY "J.K." KOCH: WHOSE ACTIONS OF THEIVERY HAVE CONFIRMED THE MERIT OF THIS PROGRAM, FORCING IT INTO THE SHAREWARE MARKETPLACE. - - - - - - - - - - - - - - - - - - - - KALEIDOSCOPE V4.0 BY BRYCE L. TOMLINSON & ERIK AYER TO USE EDIT MODE: HIT "E" AT THE MAIN MENU, AND SELECT "1" FOR A NEW PICTURE, OR "2" TO EDIT FROM THE BUFFER (IF YOU HAVE ANYTHING IN THE BUFFER). LOADING AND SAVING FILES TO LOAD A PICTURE OR BUFFER: TO LOAD A FILE INTO THE SCREEN AREA, HIT "L", AND ANSWER ALL PROMPTS. TO LOAD A FILE INTO THE 75-LINE BUFFER, HOLD THE "CTRL" KEY AND HIT "L". THEN ANSWER ALL PROMPTS. TO SAVE A PICTURE OR BUFFER: HIT "S" TO SAVE THE SCREEN AREA, OR HOLD THE "CTRL" KEY AND HIT "S" TO SAVE THE BUFFER AREA. THEN ANSWER ALL PROMPTS. DISPLAYING A PICTURE OR BUFFER TO DISPLAY A SCREEN AREA, TYPE "D" AT THE MAIN MENU. TO DISPLAY THE BUFFER AREA, HOLD THE "CTRL" KEY AND HIT "D". APPENDING TO A FILE ON DISK TO APPEND THE SCREEN AREA ONTO A FILE ON DISK, TYPE "A" AT THE MAIN MENU. TO APPEND THE BUFFER AREA ONTO A FILE ON DISK, HOLD THE "CTRL" KEY AND HIT "A". THEN FOLLOW ALL PROMPTS. MOVING THE SCREEN AREA INTO THE 75-LINE BUFFER AREA TO MOVE THE CONTENTS OF THE SCREEN AREA INTO THE BUFFER, YOU WILL HAVE TO USE THE "TRANSFER MENU" BY HITTING "T" AT THE MAIN MENU. THIS COMMAND WILL NOT FUNCTION UNLESS THERE IS SOMETHING IN THE SCREEN AREA. AFTER YOU ARE AT THE TRANSFER MENU, YOU CAN TYPE "R" TO ERASE THE BUFFER (IF THERE IS ANYTHING IN IT) AND REPLACE THE CONTENTS OF IT WITH THE SCREEN AREA'S CONTENTS. OR TYPE "A" TO APPEND THE SCREEN AREA TO THE END OF THE BUFFER (IF THERE IS ANYTHING IN THE BUFFER). YOU CAN ALSO HIT "P" TO "PLACE" THE CONTENTS OF THE SCREEN AREA SOMEWHERE ELSE IN THE BUFFER (ANYWHERE FROM LINE #1 TO #75). IF YOU USE THE "PLACE" COMMAND, YOU CAN LIST THE BUFFER CONTENTS OUT BY LINE NUMBER, AND THEN TYPE IN THE STARTING LINE NUMBER TO DUMP THE SCREEN AREA INTO. TO RETURN TO THE MAIN MENU, TYPE "A". STARTING OVER FROM SCRATCH YOU CAN ERASE THE ENTIRE CONTENTS OF THE SCREEN AREA, AND START OVER. TO DO THIS, HIT "R" TO "REDO" THE SCREEN. THEN FOLLOW SAME INSTRUCTIONS FOR THE "EDIT" COMMAND. TO ABORT WITH SCREEN AREA INTACT, HIT "A". VIEWING A DISK DIRECTORY AT ANY OF THE 3 MENUS--DOS, EDIT MENU, AND MAIN MENU, YOU CAN VIEW A DIRECTORY BY SIMPLY HITTING THE "$" KEY. USING THE BUILT-IN DOS SHELL FROM EITHER THE MAIN MENU OR THE EDIT MENU, YOU CAN ACCESS THE BUILT-IN DOS MENU BY HITTING THE "@" KEY. AT THIS POINT, YOU HAVE THE ABILITY TO SEND A DISK COMMAND BY HITTING "@" AGAIN. YOU CAN VIEW A DIRECTORY, TOO (SEE ABOVE). FROM HERE YOU CAN ALSO CHANGE THE DEVICE THAT THE PROGRAM IS ACCESSING AS A DISK DRIVE (8-11). TO DO THIS, HIT "#" AND TELL THE COMPUTER WHAT DEVICE YOU WANT. ONE MORE HANDY THING THAT KALEIDOSCOPE CAN DO IS TO CHANGE THE DEVICE VIA A NUMBER INSTALLED ON THE BOOT DISK. YOU CAN DO THIS BY HITTING "C". THEN TELL IT WHICH DEVICE NUMBER TO USE, AND FOLLOW ITS INSTRUCTIONS. THERE IS ALSO A BUILT-IN SEQUENTIAL FILE READER, WHICH YOU CAN USE TO VIEW DOC FILES, GRAPHICS, OR FONTS (CBM GRAPHIC FONTS) WITH. USE THIS BY HITTING THE "/" KEY. TO ABORT FROM THE DOS MENU, HIT RETURN. GETTING DOWN TO BUSINESS. ONCE YOU ARE IN EDIT MODE, THAT IS WHERE ALL THE FUN STARTS. HERE IS WHERE KALEIDOSCOPE SHOWS OFF ALL ITS NEATO FEATURES (SOME THAT DON'T SHOW UP IN *ANY* OTHER PROGRAMS!) AFTER YOU HAVE FOLLOWED ALL THE PROPER PROMPTS TO GET INTO EDIT MODE, YOU WILL SEE EITHER THE PICTURE THAT YOU PULLED FROM THE BUFFER (IF IN FACT YOU DID PULL ONE OUT) OR YOU WILL SEE A BLANK SCREEN WITH THE CURSOR AT THE HOME POSITION AND THE STATUS BAR SAYING CHEERFULLY "EDIT MODE". FROM THIS POINT, YOU HAVE 8 DIRECT-ACCESS FUNCTION KEYS: F1: "SNAPSHOT" THE IMAGE AND GO TO EDIT MENU (EXPLAINED FURTHER ON IN THIS FILE). F2: TURN TRAIL MODE ON/OFF (EXPLAINED LATER) F3: UNDO- HIT *TWICE* TO ERASE ALL EDITING DONE SINCE THE LAST TIME YOU HIT 'F1' FROM EDIT MODE. HAVING TO HIT THE KEY TWICE IS A SAFEGUARD AGAINST THOSE WITHOUT NIMBLE FINGERS. (NO OFFENSE INTENDED-OF COURSE) F4: SET/ERASE TAB- CHECK INDICATOR AT BOTTOM OF SCREEN FOR AN ARROW ON THAT COLUMN INDICATING A TAB STOP. F5: TAB TO NEXT COLUMN TO THE RIGHT WITH TAB STOP. IF THERE IS NO TAB STOPS, IT STOPS AUTOMATICALLY AT RIGHTMOST COLUMN. F6: ABORT TO MAIN MENU. THIS WILL LEAVE THE SCREEN AREA BUFFER INTACT **ONLY IF PREVIOUSLY STORED WITH 'S' STORE COMMAND!** F7: QUICK HELP SCREEN. ALLOWS USER TO QUICKLY REMIND HIM/HERSELF OF WHAT FUNCTION KEYS DO WHAT. F8: TURN RAINBOW MODE ON/OFF- WHEN YOU TURN RAINBOW ON, EVERYTHING YOU TYPE COMES OUT IN MULTIPLE CYCLING COLORS. WORKS WITH BACKGROUND, TRAIL, AND BORDER MODES. ALSO SEE "^R" COMMAND IN "EDIT MENU" SECTION. EDIT MENU FROM HERE, YOU CAN ACCESS THE MANY AWESOME OPTIONS THAT MANIPULATE THE GRAPHICS YOU CREATE. HERE ARE THE OPTIONS AVAILABLE FROM THE EDIT MENU, AND A BRIEF SUMMARY OF EACH: "E": GO BACK TO EDIT MODE. CONTINUE MANUAL WORK ON SUBJECT. "C": COPY IMAGE. USE CURSOR AND RETURN KEYS TO DESIGNATE AREA TO COPY. THEN USE CURSOR KEYS TO MOVE IMAGE AROUND ON SCREEN, AND USE RETURN KEY TO STAMP. CONTINUE STAMPING AS MUCH AS YOU LIKE. SPACEBAR SWITCHES UNDERLAY/OVERLAY/COPY MODE (ONLY KALEIDOSCOPE HAS IT!) AND F1 STORES PICTURE. IF YOU MESS UP, JUST HIT F3 AND KALEIDOSCOPE "UNDO"S ALL THE STAMPING. "M": MOVE MODE. USE THE SAME AS COPY MODE, EXCEPT IT ERASES THE ORIGINAL. "*": MERGE MODE. ALLOWS COPYING FROM A FILE ON DISK OR TAPE. TYPE IN THE FILENAME, THEN HOLD SPACEBAR TO SCROLL TO WHAT YOU WANT TO MERGE. HIT "F1" TO START COPYING, AND USE THE SAME AS COPY MODE. THERE ARE MANY FILES INCLUDED IN THIS KALEIDOSCOPE PACKAGE, INCLUDING A BUNCH OF NEAT FONTS AND SOME GREAT CLIP ART BY SOME OF THE BEST ARTISTS HERE IN PDX (NAMELY ME & KEN!) "<-": MIRROR MODE. ONE OF KALEIDOSCOPE'S MORE ADVANCED FEATURES. ALLOWS YOU TO MAKE A "REFLECTION" OF THE IMAGE. USE IT THE SAME WAY AS YOU WOULD USE THE COPY, EXCEPT YOU HAVE THE OPTION TO FLIP IT HORIZONTALLY OR VERTICALLY. "I": INVERT IMAGE. MUCH LIKE THE MIRROR IMAGE FUNCTION, EXCEPT THAT THE IMAGE NEED NOT BE MOVED. THIS IS USEFUL FOR CASES IN WHICH YOU SIMPLY WANT TO FLIP AN IMAGE, WITHOUT COPYING IT. "CTRL-E": ERASE AREA. USE THE CURSOR AND RETURN KEYS TO DESIGNATE AREA, AND KALEIDOSCOPE WILL ERASE IT. "R": REVERSE AN AREA. THIS FUNCTION ALLOWS YOU TO LITERALLY REVERSE AN IMAGE. USE CURSOR AND RETURN KEYS TO DESIGNATE AREA, AND ALL CHARACTERS IN THAT AREA WILL BECOME REVERSED. "CTRL-C": COLOR CHANGE/SEEK. CHOOSE "S" TO SEEK A COLOR AND CHANGE IT TO ANOTHER, OR TYPE "C" TO CHANGE ALL COLORS IN AN AREA TO ONE DESIGNATED COLOR. USE CURSOR AND RETURN KEYS TO DESIGNATE AN AREA AND KALEIDOSCOPE WILL CHANGE THE COLORS. THEN USE F1 TO RE-PICK A COLOR OR JUST HIT "Y" IF IT'S OK THE WAY IT IS. TO USE THE COLOR "P" PICK OPTION, HIT "P" AT THE COLOR PROMPTS, AND MOVE THE CURSOR TO THE SPOT ON THE SCREEN (OR THE COLOR BAR AT THE BOTTOM). WHEN THE BORDER COLOR CHANGES TO THE COLOR YOU WANT TO CHANGE TO (OR FROM), HIT RETURN. "B": BACKGROUND. THIS ALLOWS YOU TO MAKE A BACKGROUND CONSISTING OF ONE PARTICULAR CHARACTER, IN ONE COLOR (UNLESS USED IN CONJUNCTION WITH RAINBOW MODE). TYPE IN THE CHARACTER AND COLOR, AND THEN HIT RETURN. THEN USE THE CURSOR AND RETURN KEYS TO DESIGNATE THE AREA. AFTERWARDS, KALEIDOSCOPE WILL FILL ALL EMPTY SPACES WITH THE CHARACTER YOU DESIGNATE. "CTRL-B": BORDER MODE. DESIGNATE A CHARACTER (LIKE IN BACKGROUND) AND HIT RETURN. THEN USE CURSORS AND RETURN TO DESIGNATE AREA. KALEIDOSCOPE WILL PLOT A SQUARE BORDER IN THAT CHARACTER AND COLOR. "X": CHARACTER SEEK/CHANGE. THIS IS ANOTHER USEFUL AND UNIQUE FEATURE THAT (SO FAR) BELONGS SOLELY TO KALEIDOSCOPE. DESIGNATE THE CHARACTER TO SEEK, AND THEN THE CHARACTER TO CHANGE TO. THEN USE THE CURSORS AND RETURN TO DESIGNATE AREA TO SEARCH. THEN KALEIDOSCOPE DOES ALL THE DIRTY WORK OF CHANGING THE CHARACTERS. "CTRL-P": PAINT MODE. SELECT COLOR TO PAINT WITH, THEN MOVE THE CURSOR TO THE SPOT ON THE SCREEN TO START CHANGING COLORS. HIT SPACEBAR, AND MOVE THE CURSOR AROUND TO PAINT SPECIFIC AREAS. TO CHANGE COLOR BEING USED, HIT F7. TO UNDO, HIT F3. TO STORE THE IMAGE AS IT STANDS, HIT F1. "T": SET TRAIL MODE CHARACTER. USE THIS TO DESIGNATE A SPECIFIC CHARACTER (AND COLOR) TO USE WITH TRAIL MODE. WHEN YOU GET TO EDIT MODE, HIT F2 TO ENABLE TRAIL MODE. THEN CURSOR AROUND TO LEAVE A "TRAIL" OF YOUR CHARACTER. HIT F2 AGAIN TO DISABLE. CAN BE USED IN CONJUNCTION WITH RAINBOW MODE. "P": PIXEL EDIT. QUARTER-CHARACTER RESOLUTION EDIT MODE, ALLOWS FOR QUICK DRAWING WITH CURSORS AND SPACEBAR OR JOYSTICK IN PORT 2. USE CTRL AND C= COLOR CODES TO CHANGE COLOR, JUST LIKE IN REGULAR EDIT MODE. HIT F3 TO UNDO, OR F1 TO STORE. "CTRL-R": TURN RAINBOW MODE ON/OFF FROM EDIT MENU. THIS ENABLES QUICK ACCESS FOR USE WITH BACKGROUND, BORDER, AND TRAIL, AS WELL AS TELLS YOU WHETHER RAINBOW IS ENABLED OR NOT BEFORE YOU MAKE FURTHER CHANGES. "CTRL-S": CHANGE SCREEN COLOR IN EDIT MODE. THIS ALLOWS YOU TO CHANGE THE SCREEN COLOR THAT YOU USE WHEN EDITING. USE THE COLOR KEYS AND RETURN TO DESIGNATE. NOTE: THIS DOES *NOT* SAVE IN THE FINISHED FILE. "@": DOS SUBMENU. SEE DOCUMENTATION EARLIER IN THIS FILE. "$": VIEW DIRECTORY (ALSO SEE EARLIER DOCUMENTATION). "S": STORE SCREEN INTO SCREEN BUFFER AREA. THIS WILL STORE YOUR FINISHED PICTURE INTO THE 23-LINE SCREEN BUFFER, THEN RETURN YOU TO THE MAIN MENU. ANSWER PROPER PROMPTS, THEN KALEIDOSCOPE DOES THE REST. "A": ABORT TO MAIN MENU. THIS WILL ERASE NOT ONLY THE SCREEN YOU ARE WORKING ON, BUT THE ONE IN THE BUFFER--UNLIKE THE F6 COMMAND FROM WITHIN EDIT MODE. ************************************* ************************************* THAT'S ALL, FOLKS... I HOPE THIS DOCUMENTATION IS HELPFUL. IF YOU NEED MORE HELP, BE SURE TO SEND IN YOUR SHAREWARE CONTRIBUTION OF $5.00 OR MORE TO THE LISTED ADDRESS. I SCRATCH YOUR BACK... PLEASE SCRATCH MINE.