@DATABASE THXLib.guide @NODE MAIN AMOSPro THX Extension Version 0.6 (C) 1996 by Thomas "Dobble U" Nokielski @{" Changes & bug fixes " LINK "LatestNews"} Latest News @{" Introduction " LINK "THX-Intro"} About THX.Lib @{" Install " LINK "THX-Install"} How to install @{" Commands " LINK "THX-CMDs"} The commands @{" Error Messages " LINK "THX-ErrorMSGs"} When somethings doesn't work @{" Known Bugs " LINK "THX-Bugs"} What doesn't work? @{" History " LINK "THX-History"} History @{" Contact addresses " LINK "THX-ADDRs"} How to get in contact with me? @{" About THX Sound System " LINK "About THX"} What's the "THX Sound System"? @ENDNODE @NODE "LatestNews" "Changes & bug fixes" This version is only a little bug fix. As I noticed if you use THX Extension, the "Track Play" command didn't work. This is fixed. I have disassembled the THX replayer and noticed that the registers will not be saved on the stack so THX Extension do it now. Also some customized error messages were replaced by the default ones of AMOSPro. Changes since last release: - Replaced a MOVE.L by a MOVE.B in the string copy routine. ;) - Now all banks will be reserved with an equal length (removes probs with the compiler). - The VBL routine of the music extension was overwritten >>> fixed. - "Thx Volume" accepts only values between 0 and 63, now. I noticed that the music became louder when using "Thx Volume 99". @ENDNODE @NODE "THX-Intro" "About THX.Lib" This is an AMOSPro-Extension for the great "THX-Sound-System" by Abyss! USE AT YOUR OWN RISK! I don't assume any resposibility for any damages or lost data! @ENDNODE @NODE "THX-Install" "How to install" - copy the file "AMOSPRO_THX.lib" into the "APSystem" directory. - Start the AMOSPro-Interpreter-Config - click on "Load Default Configuration" - click on "Set Loaded Extensions" - click on entry number 20 - enter AMOSPro_THX.lib - click on "Ok" - click on "Exit" in the upper left corner - click on "Save Configuration" - click on "Quit" - run the AMOSPro editor. If you start AMOSPro then and you got a guru showing AMOSPro THX Extension initialisation failed!!! No free VBL found! this means, the THX Extension didn't found a free entry in the VBL jump table of AMOSPro. Remove an extension that uses VBL interrupts in this case (don't remove THX Extension!!! ;) ) If you got any problems with this extension please contact me. To remove just redo the points above with erasing entry 20. @ENDNODE @NODE "THX-CMDs" "The commands" @{" Thx Play " LINK "THX-CMDs-Thx Play"} @{" Thx Stop " LINK "THX-CMDs-Thx Stop"} @{" Thx Load " LINK "THX-CMDs-Thx Load"} @{" Thx Volume " LINK "THX-CMDs-Thx Volume"} @{" Thx Subsongs " LINK "THX-CMDs-Thx Subsongs"} @{" Thx End " LINK "THX-CMDs-Thx End"} @ENDNODE @NODE "THX-CMDs-Thx Play" "Thx Play" Thx Play {bank},{subsong} Plays subsong {subsong} of THX-Module stored in bank {bank}. @ENDNODE @NODE "THX-CMDs-Thx Stop" "Thx Stop" Thx Stop Stops current THX module @ENDNODE @NODE "THX-CMDs-Thx Load" "Thx Load" Thx Load "{name}",{bank} Reserves the bank {bank} and loads the THX-Module {name} into it. EXAMPLE: Thx Load "DF0:songs/thx.inside",10 @ENDNODE @NODE "THX-CMDs-Thx Volume" "Thx Volume" Thx Volume {volume} Sets main volume. {volume} is a value between 0 (silence) and 63. @ENDNODE @NODE "THX-CMDs-Thx Subsongs" "Thx Subsongs" a=Thx Subsongs({bank}) Returns the number of subsongs used in the THX-Module in bank {bank}. This function only works if no THX module is currently replaying (see below). If {bank} is lower/equal zero, the number of subsongs of the module currently playing or was played before is returnd. @ENDNODE @NODE "THX-CMDs-Thx End" "Thx End" a=Thx End Returns 255 if module has reached end, else 0. The replayer will restart the module automatically (use e.g. with jingles etc.). @ENDNODE @NODE "THX-ErrorMSGs" "Error Messages" "@{B}Can't initialize module@{UB}" This is an error you wan't seen anytime ;). There seems to be a bug in the initialisation routine of the THX replayer. It always returns a non-zero value instead as in the docs described. (Hey Martin, what about to distribute a source code of the replayer routine, instead of a binary?). "@{B}File not found@{UB}" What to say? "@{B}Out of memory@{UB}" same "@{B}Incorrect file length@{UB}" (old) "@{B}I/O error@{UB}" DOS returned another filelength that was expected. "@{B}Illegal value@{UB}" (old) "@{B}Illegal function call@{UB}" You wrote something like Thx Volume 100 or Thx Volume -12 etc. "@{B}Bank not reserved@{UB}" You tried to access a bank which is not defined. "@{B}THX is in play-mode@{UB}" You tried to get the number of subsongs of a module while another one is currently playing. Sorry, this is because I have to initialize the module before accessing to this value so the replay routine could crash. "@{B}Module not initialized@{UB}" You tried to get the number of subsongs of the module that is currently playing or was played before, but it is/was not. @ENDNODE @NODE "THX-Bugs" "Known bugs" Maybe you know there's a bank check routine in every AMOS Extension to check if a used bank has changed or erased. THIS ROUTINE IS EMPTY! So if you erase a bank which is currently used by the THX replay routine AMOS will crash! There is also no routine to check, if the bank you access contains a THX module. With some modules the sprite display crashes sometimes. @ENDNODE @NODE "THX-History" "History" V0.1ß (18-Aug-96) (released) ----- first released version - Thx Play {bank},{subsong} - Thx Stop V0.2 ---- just some changes to make the source more readable. V0.3 ---- - Thx Load "{name}",{bank} V0.4 (30-Aug-96) (released) ---- - Thx Volume - Thx Subsongs - Thx End V0.5 (1-Sep-96) ---- - If an AMOSPro bank is unequal, the compiler stops with error "Not an AMOS- Program". So "Thx Load" checks the file size for an equal length, if it is not, it adds one byte at the bank reservation. (Thanks to Chris Hodges). - Bug found: The string in "Thx Load" was copied with long instead of byte size. ;) V0.6 (6-Sep-96) ---- - Removed a bug in the VBL routine so that the "Track Play" command now works. - replaced some custom error messages by default ones. - "Thx Volume" now accepts only values between 0 and 63. @ENDNODE @NODE "THX-ADDRs" "How to get in contact with me?" Please read chapter "Known bugs" before sending any bug reports. Thomas Nokielski Nachodstr. 17 10779 Berlin Germany VQ: +49-30-217-76-71 eMail: DOBBLE_U@INSIDE-MEDIA.DE (preferred) You can also get in contact with me if you need musics for your game/diskmag/ demo/etc. PT and THX format ;). @ENDNODE @NODE "About THX" "What's the THX Sound System?" · · __ _ __ __ : __________/\___________ ______/\________________¦_ _ __\/__ _ _ / / /_//_/~________/ _\_ ¬\_/~ ¬Y~ ¬\_/ \______/~ ______/ \/ 7: \__ ¬|! \__ _|_____ !|_____ ¬|_____ ¬| |! | .|· | ¬|~ ¬| ·|~ ¬| :|~ ¬| :| _ __ _ _ _l____| :|_________|: _____|: _____|! _____;_ __ __ _ __ : `----' `----' `----' `----' :-Sd · . Abyss - The deepest experience presents T H X The Highest eXperience Sound System v1.00 Copyright: THX Sound System is (c) in 1995/1996 by Abyss Credits: Designed by Pink/Abyss! Programmed by Dexter/Abyss! -see below for addresses! Disclaimer: I DO NOT TAKE ANY RESPONSIBILTY FOR ANYTHING THAT COULD BE CAUSED BY THIS PROGRAM ! Description: Just another tracker? Definitely NO! Just another synth-tracker? Definitely NO! What the hell is this then? "THX Sound System is an editor providing you with the ability to compose VERY EASY, VERY FAST and MOST c64-LIKE as possible! 'Well, that can be done also with MusicLine Editor' you may say. Correct, but you would need MORE time to set up every single Instrument and the tunes' would be LONGER than the ones produced with THX (Also the replayer needs MORE rastertime!). It would also be MORE complicated to use one of those 'I can do everything' tracker, as you then also would have to do really MORE (like setting all those 'I don't know for what they are' values), but in THX everything is made very EASY and UNDERSTANDABLE. So if you're in favour of those REAL c64 tunes, you'll be able to do them on your own with this fabulous tool. AND: No f***in' registration fees! IT'S ALL FOR FREE! If you want to get all the major updates before they're released, just send me 10.- DM or 10.- US$ and you'll get your major updates WITHOUT great delays" -Mike Levie/Quantum Channel For further information take a look at 'THX Sound System.help' Systems: All Amigas with 68020+ and Workbench 2.0/3.0 - NO AGA required! Language: Coded in 100% SYSTEM-FRIENDLY Assembler, no f***in' hardware hacks, should also run with graphic-boards and dbl-pal monitors 1st Release: 27.12.1995 Release Date: 01.08.1996 Greets&THanX: Florian Vorberger, Twice/Lego, Geggin/Censor Design, Offa/TBL, Equalizer/TBL, Jan-Evert Slypen, Gryzor, Tommy, Ramosa, Peter Kunath and everybody who wrote me/sent me tunes! Information: IF YOU HAVE ANY USEFUL IDEAS/SUGGESTIONS, FOUND OUT ANY BUGS OR NEED SOME HELP THEN >> DO NOT << HESITATE TO CONTACT ME IMMEDIATELY... Addresses: For THX coding/gui/replayer related stuff contact Dexter at: Dexter/Abyss! Martin Wodok Rattenberger Str. 28 81373 Muenchen GERMANY e-mail me at: 100.17637@germanynet.de (NEW ADDRESS!) or just call me at: ++49-(0)89/760 39 01 don't worry, i may call you back, i just prefer phonecalls For THX music stuff contact Pink at: Pink/Abyss! Manfred Linzner Rupert-Mayer-Str. 6 81379 Muenchen GERMANY e-mail: Manfred.Linzner@munich.netsurf.de http://www.thx.com or try http://www.geocities.com/SiliconValley/8849 -+- Program is freely distributable -+- -+- as long as there won't be charged anything -+- -+- over $2 including package and shipping -+- -+- but it may not be put on any cd without my permission -+- @ENDNODE