@DATABASE TP2PT.Guide @AUTHOR "TouchStone of Essence" @(c) "Copyright ©'94 Essence" @$VER: TP2PT.Guide V0.3 (01-11-94) @FONT topaz.font 8 @WORDWRAP @WIDTH 80 @HEIGHT 20 @NODE MAIN "TrackerPacker_2_ProTracker-Converter" ______·_________________:_____·___________ \ _ Y ___/ ___/ _ Y _ Y ___/ _ T§ T ___|___ T___ T ___| | | |__| ___| | | T | | | | | T | | T T | T | | | | | | | | | | | | | | | l_____l_____l_____l_____l__| |_____l_____j : · : · | | : · · l__j · @{u}is proud to present another small joop-tool@{uu} --< @{b}TrackerPacker_2_ProTracker_v0.3@{ub} >-- @{i}coded by TouchStone of Essence / idea by Jazz of HauJobb@{ui} @{ "[ Introduction ]" LINK Intro } @{ "[ Disclaimer ]" LINK Disclaim } @{ "[ How to use ]" LINK Usage } @{ "[ Bugs ]" LINK Bugs } @{ "[ Greetings ]" LINK Greetings } @{ "[ History ]" LINK History } @{ "[ Addresses ]" LINK Addresses } @{ "[ Last words ]" LINK Last } @ENDNODE @NODE Intro "TP2PT : Introduction" Well, some days before Jazz / HjB asked me if I'm able to code a small converter which transforms TrackerPacker-Modules in the standard ProTracker-Format. "Of course", I said and so I started coding this small tool. So you see, for what you can use it : converting TrackerPacker-modules into ProTracker-Modules (I used the ProTracker-File- Format described in the PT_2.3a-Docs). Jeah, that's it, or? Hmm, the tool is coded in 100% pure assembler and is (I hope) very fast and small. It should work under 2.x and 3.x, but I'm not able to test it on every OS... so, if you find bugs send me a (detailed?) bug-report. For all those interested coders... Contact me, if you want to have the documented file-format and depack-algorithm of TrackerPacker_v3.0... @{b}IMPORTANT@{ub} : The converter works _ONLY_ with TrackerPacker Version 3.0! TP-Modules of older versions can't be converted! I think version 3.0 is well known and much used. Near 80% of the TP-Modules are v3.0, so there should be not much problems... Working on it :)... @{ "[ bACK tO tHE mAIN-mENU ]" LINK Main } @ENDNODE @NODE Disclaim "TP2PT : Disclaimer" The TP2PT-Package is © 1994 by TouchStone of Essence! You can copy this package as a whole and not only as parts of it! It's forbidden to _SELL_ this package or parts of it. Not for commercial use without the permission of the creator. *NOT* for _military_ use (with or without permission)... The TrackerPacker is © 1994 by CRAZY CRACK of Complex @{ "[ bACK tO tHE mAIN-mENU ]" LINK Main } @ENDNODE @NODE Usage "TP2PT : How to use it" Syntax TP2PT [NOCHECK] [OFFSET=] : The name of the TrackerPacker-module. Remember : Only TP3-Files will be converted! This file can be in the current directory or you can give a path, too... : Here you can give a new filename for the converted (ProTracker-) file. NOCHECK : From v0.3 on, the TP2PT-converter checks the module. If there is *NO* keyword ('CPLX_TP3') a requester pops up. With this keyword, you can switch this off. OFFSET=: If there is no keyword on the beginning, you can give here a position in the file from where the converter should convert ( will *NOT* be checked if it's illegal!!!). If someone skipped the keywords, the OFFSET should be 0. Elsewhere it should be 8 (default!)... Try! After starting the command, you'll see something in the CLI/Shell-Window. Here you find a demonstration-output of an ordinary PT/TP-Module from my module-directory... @{b}1>@{ub} TP2PT music.tp4 ram:mod.suxx @{u} TP2PT_v0.3 @{uu} @{i}written by TouchStone of Essence (31-10-94)@{ui} @{b}Old Lenght :@{ub} 11974 ('music.tp4') @{b}Song-Name :@{ub} 'total tankard' @{b}Samples :@{ub} 5 ($5) @{b}Smpl01Data :@{ub} 63 words (RStart : 0, RLen : 63, Vol : 64, Fine : -1) @{b}Smpl02Data :@{ub} 19 words (RStart : 3, RLen : 16, Vol : 64, Fine : ±0) @{b}Smpl03Data :@{ub} 27 words (RStart : 11, RLen : 16, Vol : 64, Fine : ±0) @{b}Smpl04Data :@{ub} 2894 words (RStart : 0, RLen : 1, Vol : 64, Fine : ±0) @{b}Smpl05Data :@{ub} 1780 words (RStart : 453, RLen : 1327, Vol : 64, Fine : ±0) @{b}Patterns :@{ub} 6 (0-5) @{b}New Lenght :@{ub} 16794 ('ram:mod.suxx') @{i}OpErAtIoN CoMpLeTeD !@{ui} I think there is no explanation for the values and informations above needed. You find detailed informations about the samples and patterns. Don't know what to say about this... @{ "[ bACK tO tHE mAIN-mENU ]" LINK Main } @ENDNODE @NODE Bugs "TP2PT : Bugs ???" Well, I hope there will be no bugs in the code, but who knows? If there are some mistakes in the code, please contact me and send me a small but detailed bugreport (thanks :)... I know there are some mistakes in this documentation (not only the language :), so don't be worried about this... Normaly, there will be no loss of data from the original (ProTracker-Module). So if you have a PT-Mod with a size of 123456 bytes, and you'll convert it into a TP-Mod and after this back into the PT-Format, the result will be (normaly) 123456 bytes long. Of course there are some exceptions : e.g. if one sample is 1020 words long, RStart is 10 and RLenght is 1000, there are 10 words, that you'll never hear. TrackerPacker skip this 10 words to win space. If you convert this TP-Mod into a PT-Mod, the new file is 10 words (20 bytes) smaller than the original file! Even if the lenght of the file is the same, the data inside can be arranged in an other way than in the original ProTracker-Module. But why? The reasons for this can be... · Of course there are *NO* Sample-Names. Only the Song-Name will be saved into a TP-Module. All Sample-Names will be skipped to win some bytes... · The samples can be new arranged. If there was in the orginial PT-Mod the first and second sample empty and the third and forth samples was full with data, the result in the new PT-Mod will be, that the first and second sample will held the sample-data of the old third and forth one (who understood this ? :). Ok, this will be no problem, because all notes will get the corect sample-value. · The effects 5 (Tone Portamento + Volumne Slide), 6 (Vibrato + Volume Slide) and A (Volume Slide) are a bit crazy arranged in the ProTracker, because you can give in *ONE* line two _absolutly_ different commands! You can slide the tone up AND down in the same time (how is this possible?). Ok, you can type e.g. A45, this means that you will slide the tone 4 steps up and 5 steps down in the same line. This is, of course, pure shit and so the new PT-Module will held the effect A40 (UP has the higher priority. If the commando was A06 the result after the convertations will be A06, of course :). The same with 5 (Portamento) and 6 (Vibrato)... · The commands 8xx and E8x are UNUSED. They will be filtred out and won't exist in the converted PT-file... · If there are too big values in C (Set Volume) or D (Pattern break) the effect will be skiped and won't exist on the converted PT-file... All this is the result of the TrackerPacker and not of the converter. The converter tries to convert EVERY data into the original format, but this is sometimes impossible (as you see)... But remember : There will be _NO_ loss of quality in the module! It will sound exactly the same as the original ProTracker-Module! @{ "[ bACK tO tHE mAIN-mENU ]" LINK Main } @ENDNODE @NODE Greetings "TP2PT : Greetings" ···[ @{b}TouchStone@{ub} sends some warm handshakes to ]··· @{FG HIGHLIGHT}Jazz ........... HauJobb : Na, sagt dir das Tool zu? Ich denke mal es ist gut genug um ein paar Mods zu konvertieren... @{FG FILL}Cooper .......... Elicma : Hey, was geht ab? Kauf dir endlich nen' A1200 und verschrotte den PC (hehe :)... @{FG HIGHLIGHT}Bilbo Baggins ... Motion : Danke für die Luri-Door! Bis jetzt gab es ne' echt geniale Beteiligung bei den Ding... @{FG FILL}Orbit ............. TRSI : Wann hört man denn mal wieder was von dir ??? Oder bist du zwischenzeitlich zum PC abgewandert ??? Würde mich doch stark wundern ! @{FG HIGHLIGHT}Cockroach ........ Color : Nah, wer ist der bessere Programmieren, hehe :) Ok, danke für die *SUPER* Telefon-Gespräche... Bis zur Party IV... @{FG FILL}Trooper ......... Analog : Yep, nice BBS-Intro, isn't it??? Ok, see you somewhere... @{FG HIGHLIGHT}Sagor .......... Hoodlum : Haha, always nice chats... Leider wirds nur immer so teuer, aber wenn stört das schon, wenn man blöd rumlabern kann? Grüße auch an Bianca.. @{FG FILL}ChipRam ........ Digital : Na, was macht das Leben? Wie wäre es mal wieder mit nem' kleinen Coder-Meeting bei mir? @{FG HIGHLIGHT}Byte-Dealer .... Sceptic : Ich hoffe du hast das BBS-Intro inzwischen bekommen, oder was? Also es tut mir leid, das es so lange gedauert hat, aber man hat ja noch andere Vergnügen (?! :)... @{FG TEXT}and to all other Essence and HauJobb-Members ···[ @{b}Jazz@{ub} sends this message around the globe ]··· fIRST of aLL i wOulD lIKE 2 tHANK tHE aLMIGHTY tOUCHSTONE fOR cODING tHIS uSER-FrIENDLY aND mOST-wANTED-Tool!!! tHANX PaL! yOUR VeltinS pACKAGE iS sAVE !! ;) I don't uNDERSTAND whY aRGON (?) diDN't InCLUDe a DePACK rOUTINE foR thE pACKED mODULES.. bUT tOUCHSTONE dID a GreAT jOb, eh?? o.K. Big Hellos fly to...: @{FG HIGHLIGHT}(-all in hauJobb..-:"hI tO oUR nEW mEMBER >sEAL (fORMER Tek)--") @{FG FILL}(-all in eSSENCE..-:"I kNOW yOUR tRACKMO wILL bE gREAT..."----") @{FG HIGHLIGHT}(-all in AbySS....-:"jUST wAIT fOR cHIPMANIA ^ nEXT gENERATION") @{FG FILL}(-rAHIEM../dIGITAL-:"wHAT dO yOU sAY tO tHIS hAPPY cONVERTER??") @{FG HIGHLIGHT}(-cHIPRAM./wiZZcat-:"mODULE sWaPpIN' iS aLWAYZ fuN.. sEEYAsoOn") @{FG FILL}(-cYCLONE/HJB.OPP.-:"aMAZING aNSI-StyLE..!! The Message: 64!--") @{FG HIGHLIGHT}(-agNUS-Dei/equinox:"sORRY fOR lOOSING mY dIZ iN tHE '64 cONF.") @{FG FILL}(-pEACHY/mASQUE....:"wHAT aBOUT bLACK zONE?? wOC rELEASE,OR..?") @{FG HIGHLIGHT}(-sLAYER/InDePenD..:"jUST kEEP iT moVIN'... tRADE & jOIN sOON.") @{FG FILL}(-dASCON/eSSENCE...:"nICE tO mEET yA aT tHE dOOMSDAY PADDY!!!.") @{FG TEXT}aND oF cOURSE tO aLL i've fORGOTTEN iN a bIG hURRY!!!!.. -( sEE yA aT tHE pARTY iV! )- ___/\__ _/\____/\____ .--------------------------/ / _ \___ /___ /--------------------------. :::::::::::::::::::::::/\_/ / / / ___/ ___/:::::::::::::h:a:u:J:o:b:b:: ::h:a:u:J:o:b:b:::::::/ / / / / / / /e×i:::::::::::::::::::::::::: `--------------------/___ /__/ /___ /___ /-----------------------------' \/ \/ \/ \/ @{ "[ bACK tO tHE mAIN-mENU ]" LINK Main } @ENDNODE @NODE Addresses "TP2PT : Addresses" If you want to contact the coder of this small tool to get informations about this or the other @{b}joop@{ub}-tools, you can leave me a message on the @{b}Experience@{ub} (@{i}+49[0]2932-1258@{ui}). This time I don't give a mail-address, but ask some dudes and you'll get it from them (or contact @{b}Essence@{ub} :)... @{ "[ bACK tO tHE mAIN-mENU ]" LINK Main } @ENDNODE @NODE History "TP2PT : History" @{b}v0.1@{ub} - first startable version @{b}v0.2@{ub} - fixed bug in the D-Command (pattern break) fixed a small sample-bug now you can see informations in the CLI/Shell written the AmigaGuide(tm)-Documentation now corect sample-saving now using ReadArgs() for the command-line @{b}v0.3@{ub} - major bug fixed : samplenumbers higher than $f produces errors bug fixed : small error in the frequence-list new feature : the converter checks if the module is TP3 (choosable) new keyword : 'OS=OFFSET' @{ "[ bACK tO tHE mAIN-mENU ]" LINK Main } @ENDNODE @NODE Last "TP2PT : Last words" Well, now I have some space left to write a bit... Hmm, first I want to say, that we (in Essence) need your support for our diskmag r.O.m.! Send us articles (everything which handles with computer-stuff) or use the ProPoller-Tool to make us happy. This tool is something like a vote-tool, and you can find it in the Experience-BBS... In this BBS you can download the latest rOm-Issue @{b}FOR FREE@{ub}, too, so get it. For all of you, who want to support us, but don't want to loose so much time : Call the Lost Carrier BBS (aSK-fOR the number :) and you can answer a question in the luri-door... Ok, that it for rOm (addresses below!)... ···[ sUPPORT rOM ]··· mOP·Essence aNDY·Essence dODGER·Essence Noel Baldacchino Andreas Dubois Daniel Koschera bei Lenden 39 Maitland Street Starenweg 9 Wilh.-Buschstrasse 20 Hamrun, HMR 06 89584 Ehingen 41541 Dormagen Zons Malta Germany Germany _______________________________ ________. \__________ __ ______ __ V __ | cHRISTINE·Spoon | _/ _/ \_ \ \_/ | sHADE·TRSI | _ \_ \_ | | Christine Hansen | \ / / | | Andreas Haakens Tojmestervej 12,2th|_______\ /___________/___| | Hurdalsveien 2400 KBH, NV Rewarding\ /Orthographical | ·aBn·|2074,Eidsvoll Verk Denmark \/ :________: Norway Masterpiece or give this boards a call (rOm for free!).. The Experience (HauJobb) ('Rom' as User and Password) Matrix BBS (Fear) +49[0]911/7568117 _ __ ___ ___________ ___ __ _ .øø. . ØØØ ØØÅ. T·h·E ÆØØ° °ØØØØÅ. ÆØØ° ¤ØØØØæ__ jØØ°_____________________ ___ _______________________________ __/ _____/ø ,ØØ_/ ___ T ___________ T _]/ ______ _ __/ ______/ _____/ \_ |°¤ØØøØØ\_ ¯¯ j | \_ ¯¯ _j \_ | | T \_ | \_ | t§ | T¯¯¯7ØØØØø| T¯¯T T¯¯¯7 T T | T¯¯¯7 | | T¯¯¯7 T¯¯¯7 | | | ØØØØ| | | | | | | | | | | | | | | | | ¦ |JØØF~| |. | ¦ | | | | ¦ | ¦ | ¦ | ¦ | l_______jÆØØ' l___jØÅl_______j___l___j___l_______j___l___l_______j_______j .ØØØ ~¤ØØØL jØØF ¬¤ØØ. + 4 9 [ o ] 2 9 3 2 · 1 2 5 8 JØؤ ¬¯ ÆØØ' ØØØ bOZZ : jaZz / Hjb ·|· cRU : dRf / hjB ØØØ °Ø¤ ·oFFICIAL·eSSENCE·dISTRIBUTION·sITE·aND·rOM-dISKMAG·sUPPORT·&·fREE·lEECH· @ENDNODE