MipDip10.txt
--------------------------------------------------------------------------------
MipDip10 - Quake Mip Textures ripper and modifier.

by Mads Dydensborg
   madsdyd@diku.dk

DISCLAIMER : I TAKE NO RESPONSIBLITY FOR PROBLEMS CAUSED BY THIS PROGRAM. IT 
             MIGHT NOT PROVE USABLE FOR ANY PURPOSE. BE CAREFULL. BACK UP NOW.
             Quake and DOOM are trademarks of id Software Inc. This program
             should not be associated with id in any way. id software will not
             answer any questions related to this program.
--------------------------------------------------------------------------------

1. About
2. Requirements
3. Installation
4. Terminology 
5. Use
6. Note from the author
7. Legal issues
8. History

--------------------------------------------------------------------------------
1. About

MipDip10 is a Windows(TM) 95 program, that lets you

- load Quake BSP map files and view the Mip Textures.
- Save each Mip Texture, either as a MIP file or a BMP.
- Load new pictures into a given MIP Texture, either from a BMP or a MIP file.
- Copy and Paste to and from the Clipboard as BMP.
- Resample submips.
- Save a modified BSP file, including the texture changes.

In short, most of what you'll be likely to want to do with MIP's at the moment, 
except adding MIPs to the BSP file or modify the size of mips.
 
MipDip is designed to work with the Quake Test 1 release from ID software.

--------------------------------------------------------------------------------
2. Requirements

MipDip runs under Windows(TM) 95, and likes memory.
It has been successfully run on a Pentium p133, 32MB, 16M Colour, and a 485dx50, 
16MB, 65k colour. So any machine capable of running Quake, should be able to run
MipDip.

To use MipDip, your ID1.PAK file should have been unpacked. Several utilities 
exists, that can do this for you, e.g. Unpack.exe or Qube.exe

--------------------------------------------------------------------------------
3. Installation

The following files are supplied with this version of MipDip :

MipDip101.exe  -  The executable
MipDip10.txt  -  This file
MipDip10.pal  -  A (JASC) palette file for use with your paint program
Palette.BMP   -  A bitmap file containing one pixel and the palette entries
Paint.pal     -  The palette file in Windows Paint format

Unpack the zip file to a directory of your choice, and run MipDip10.exe 

--------------------------------------------------------------------------------
4. Terminology
 
I use the following terms :
a MIP TEXTURE, is a picture file containing in all 4 pictures, that are the
               almost the same visually, but have different sizes.
a SUBMIP       is one of the smaller pictures.

This is probably some stupid terms, but I don't know the right ones.

--------------------------------------------------------------------------------
5. Use

To use MipDip, you first have to load a BSP file. This should be one of the
following : test1.zip, test2.zip, test3.zip, or derivates of one of these.

After loading a file, MipDip will show the first Mip Texture on screen. You can
select other Mip Textures from the list box, that contains the names of all
the Mip files in the BSP file.

Each submip is numbered 1 to 4. Default is showing number 1, but you can click
any check boxes to show more then one submip on screen.

You can zoom in/out with the 'Zoom Level' box.

To actually perform some actions on the Mip files, you should right click one
of the submips, and select an action from the pop-up menu.

Actions are :
  Save
  Load      (Will perform some format checking, but don't pressure it.)
  Copy
  Paste     (If clipboard contains a BMP file)
  Resample
  About     (Well, I had to put it somewhere, didn't I)

All options should be self explaining, except maybe Resample. Resample will 
construct sub mip 2,3 and 4 from sub mip 1, by doing a linear mean color 
sample. At least, thats what I belive it's termed. This is not an anti-
aliasing process, but only meant for test purposes.
(If you don't like this sampling, and knows anything about color sampling, 
then I'll be glad to hear. I just, you know fiddled around a bit, and it 
looks okay.)

About COPY : 
  If you check the ClipBoard viewer, you'll see, that the BMP contains a
  palette, which is the Quake palette. Unfortunately, this palette seems
  to be ignored if you paste the BMP into a paint application or similar.
  I believe that this is because it gets pasted as a DIB BMP (sic).
  I've included 2 palette files, that many paint programs can read,
  and this you can attach to the bitmap in your paint program if you like.
  I've also included a small bitmap, with the correct palette.
  The BMP shows correct in all situations on my system, but then again :
  Yours are entirely different, and who knows...

When ever you fell like it, you can press the Save button on the form, to 
save a modified version of the BSP file. There is no UNDO buttons anywhere,
so it might be a very good idea if you save once in a while.

That's it, basically. The remaining few buttons concern display, and they 
should be easy to use.

Have fun! 

--------------------------------------------------------------------------------
6. Note from the author

THANKS TO THE FOLLOWING
- ID SOFTWARE : 
  For releasing the Quake test, which has been the funniest thing to play 
  around with, since. well, since DOOM actually. 
  Also of course, for releasing this test, even though they knew people like 
  me would be too soft in our heads to not release programs like this! ;-)

- The creator of 'The Most Unofficial Quake Technical Specification' :
  For creating some extremely informative stuff, so even non-techies like me, 
  can make some useful(?) utilities. 
  Thanks to : Olivier Montanuy, Brian Martin and Raphaël Quinet.

- BORLAND(R)
  For creating DELPHI(TM), and DELPHI2(TM), which is the most useful program-
  ming environment and compiler I've ever used! And maybe the software product
  where you get most value for your money. The best money I've ever spent on 
  software.

BMP's
A week ago, I didn't know anything about Windows bitmaps, their palettes, and
the absolute hell it is to make sure they work together. As a result, I can't
absolutly promise you, that MipDip will work perfect on your system. But it
does nothing fancy really, so it should work.

SHOW
As mentioned above : 'I donnu noting' (Manuel from Faulty Towers, right ;-)
My routine to create Windows BMP is... what do you say... 'slow?' 
Nah... 'Really slow?'... Nah, that's not right either... 'Extremly slow?'.
Yep! Thats it! It's extremly slow. On my p133, it can take up to 1 second to 
create a resample.. 
If you know how to speed up bitmap creating in Delphi, then please email me.
(Cause I would really like to know.)

BUGS 
A program without a bug, seems to be utopia. MipDip seems to work okay though,
but may get a bit confused, if you fiddle to much with the Zoom Level, show button
and the list box very quickly. If the display seems wrong, press Refresh.
The program doesn't really know how to validate that you give it a BSP file,
so you can fool it into loading something comletly different.
This, of course, you shouldn't do...
And, I know : The interface could be better. But it all started as a little
test toy, and I don't feel like writing a help file and stuff right now.

FEEDBACK
If you have any comments, bug reports, suggestions, or anything else you would
like to let me know, I can be reached via email : madsdyd@diku.dk 
I would REALLY appreciate any comment from you! Thats the most I'll ever get
I think, and it will only take you 5 minuttes to comment on the program.
Please..(beg beg pant pant ;-)

Gee... That was fun.
'And now to something completely different :'
Anybody knows how to write a multitasking pre-emptive micro kernel for 
a Motorola 68000? 
No? Well, why don't I get started then.

Have fun.
 
Mads Dydensborg  (email (again?) : madsdyd@diku.dk)
21/3-1996.

--------------------------------------------------------------------------------
7. Legal issues

Wauv : You read this far??? Amazing.

Well, the following is mostly to comfort my own bad conciseness. Part 3.d of
the Quake Software license, may be used against this program. So if you chose 
to use this software, use it 
a)  only on the Quake test 1.
b)  as an appetizer for the fun and enjoyment we all will have with Quake when 
   it comes out!

DO BUY QUAKE (When it comes out). Don't be a freeloader! 
This program should encourage you to buy and use Quake, when it gets released!

I hope you will.

Oh? About this program? Well you can distribute it freely as long as you don't
charge anybody any money for it and include this file unmodified.
And please don't do anything stupid with it.
And you might want to give me credit if you use this program as part of a
set of tools, or whatever.
And don't be a jerk ;-)

--------------------------------------------------------------------------------
8. History

   21. March 1996. First release. Version 1.0
   26. March 1996. Release 1.01. Fixes GDI leak. Very small change otherwise.

--------------------------------------------------------------------------------

End of document.


Go away. Go put a yellow sky on Test3, or put you favoritte holiday picture on
test2, or something..... :-)
