.....::::: ....... ................... .....
::::: ::::: ::::: :::: ...... ::::: :::::::: .....::::: :::::
::::: ::::: ::::: ::::. ::::: ::::: :::::::: ::::: ::::: :::::
::::: ::::: ::::: ::::: ::::: ::::: :::::::: ::::: ::::: ::::: :::::
::::: ::::: ::::: ::::: ::::: ::::: :::::::: ::::: ::::: ::::: :::::
::::: ::::: ::::: ::::: ::::: ::::: :::::::: ::::: ::::: ::::: :::::
::::: ::::: ::::: ::::: ::::: ::::: :::::::: ::::: ::::: ::::: :::::
.::::: ::::: ::::: ::::: ::::: ::::: :::::::: ::::: ::::: ::::: :::::.
`-' ::::: `-' ::::: `-' `-'
- -- ------------------ -- - present - -- ------------------------ -- -
The Module Master v1.0
----------------------
Author : Chip-Ram / Digital
Typ : Tool / Editor
Status : Public Domain
Requirements : OS2.x/3.x , 512kb & ReqTools.library v38 (included!)
Chapter 1: About The Module Master
------------------------------------------------
1. What is The Module Master ?
------------------------------
Module Master (MM from now on) is a simple OS2.x/3.x gui-driven
editor tool, which makes editing sample- and filenamestrings
of standard Sound/Noise/Protracker-Modules an easy task.
Originally I wrote this tool only for my own, because I am
collecting modules since 6 months and I often have to edit a
module, because of corrupt samplestrings or missing composer-
names.
Moreover I often get modules which have differences in the
filename and the in-module stored modulename and so I always
had to load such a module into Protracker to fix this.
Well, this is why MM was coded.
You can easily select a module, edit both the sample- and module-
names or just rename the filename on disk to the name stored in
the module.
MM is not meant to break the tools-charts, either use it or drop it!
2. Who should use it ?
----------------------
Well, MM is aimly dedicated to all people, who collect modules
and want to own a tidy and well-sorted collection.
Here MM is a really must, because it is the only way to edit hugh
amounts of modules in a short period of time.
Useful or not, decide on your own! Nobody forces you to use MM!
Chapter 2: How to use The Module Master
-----------------------------------------------------
1. [Load Moduleheader] & [Save Moduleheader] - gadgets
------------------------------------------------------
Well, usage of MM is really simple.
Click the [Load Moduleheader] - gadget and select any module.
MM will check out, whether it is a module (checks for M.K.) or not.
If not, you can confirm editing the desired module, but be sure you
are editing a real module.
NOTE: MM accepts only PT-modules without any errorrequester.
That's because I only check for the M.K.-mark.
If you have an old ST-module or StarTrekker-module, you can
force MM continuing by confirming the requester.
Next MM checks whether the module is powerpacked or not.
At the current version of MM powerpacked modules will not be accepted
and so MM aborts loading.
If there has not occured any error, you will find the stringgadgets
filled with the samplestrings and the modulename below them.
The filename will be shown on the right side in the [Filename]-field.
Now you can start editing samplestrings by simply clicking into the
stringgadgets and start typing your changes. Same with the modulename.
If you want saving your changes, just click the [Save Moduleheader]-
gadget and confirm the appearing requester. That's all.
2. [Modulename -> Filename] - gadget
------------------------------------
In case the filename differs from the modulename, you can replace both
the filename by the modulename and the modulename by the filename.
Clicking the [Modulename -> Filename] gadget will simply rename the
file on disk by the in-module stored name, i.e. :
Modulename : biomechanoid
Filename : mod.module_by_groo
Clicking the [Modulename -> Filename] gadget will rename the file
'mod.module_by_groo' to 'mod.biomechanoid'. That's all.
NOTE: Clicking the [Modulename -> Filename] gadget will NOT change
anything IN the module. It will simply rename a file on disk.
So it is not necessary to click the [Save Moduleheader] gadget
to keep these changes!!
3. [Filename -> Modulename] - gadget
------------------------------------
Clicking the [Filename -> Modulename] gadget will copy the filename
supplied by the filerequester directly into the module.
The 'mod.'-prefix will be cut out automatically. This is useful, when
you get a module, which has a correct filename but holds a wrong
modulename inside its header.
Again a little example:
Modulename : _yyþ_______x_Dd_ (should indicate any crap in the header!)
Filename : mod.elysion
Clicking the [Filename -> Modulename] gadget will replace the crap in
the moduleheader by 'elysion'.
After saving the moduleheader and loading this module into any tracker
you will notice the correct modulename in the moduleheader.
NOTE: Because of the fact, that some text is copied into the module-
header, you HAVE to click the [Save Moduleheader] gadget to keep
these changes in future!
Chapter 3: General informations
----------------------------------------------------
1. Public Domain notice
-----------------------
MM is public domain. This means you can copy and spread it as much
as you want. No profit may be made out of it by any pd-library sel-
ling any version of MM.
2. Future changes
-----------------
This is version 1.0 of MM, so there are not that much functions
included yet.
In future version, you will find even more functions i.e. the
possibility of inserting a bbs-banner. Furthermore powerpacker
will be supported. This means the selected module will be unpacked,
edited and packed with the same ratio it was packed before.
Future versions will get a preferences editor, so you can create your
own batchpatterns i.e. replacing modulename by filename in all selected
files without clicking the same gadgets again and again.
MM will be enabled to act from CLI, too.
Furthermore you will get the possibilty to save the moduleheader with
strings upper/lower-cased.
Version 2.0 will enable you to edit a mask of what strings should be
removed or be replaced, i.e. :
You want to remove the string 'converted with prowizard' in any
selected modules.
Chapter 4: At the end
-------------------------------------------------
1. The credits
--------------
The Module Master V1.0 was coded by Chip-Ram of Digital.
The icon spread with Module Master V1.0 was found in a 500 wb-icons
archive, so I think it's pd, too.
ReqTools.library was coded by Nico François.
2. The author
-------------
Send bug-reports to me at this address :
Also for module & demoswapping
Chip-Ram
------------------
Jens Georg
Ostpreußenweg 11
58239 Schwerte
United Germany
+49-(0)230417549
or find me somewhere in internet ....
3. The greetings
----------------
First off all I want to thank Touchstone / Essence for his great
advices and incredible help to get The Module Master V1.0 to that
what you can find in here.
Furthermore greetings to my best (and TRUE) friends in scene:
----------------------------------------------------------------
- Pride / Stellar
- Curt Cool / Depth
- Rahiem / Digital
- Gfx-Twins (Cevin) / Digital
- Flite / Sceptic & Haujobb
- Jazz / Haujobb
- Tint / Digital SF
4. FileId.Diz
-------------
________ /\_ ______/\_ ___________ ____
\ ______\/\/ / ____/ /_\ _______ /_/ _ /
\//. / / / /__/ / / /_ / / //
// / / // / / / / // / ./__
/ / /. / / / / / / / /
/____ /__/\_____/__/___/ /___/ /\_____/
\/...:::PRESENTS TODAY:::/__/.. Sk!n
The Module Master v1.0 by Chip-Ram/Digital.
Easily edit sampletexts and modulenames.
Requires OS 2.x / 3.x & 640x256p screen.
|
