xBill for Wingdows Extension Pack - The Specs
=============================================

Contents
1. The Directory Structure
2. File descriptions
3. What to check before publishing

=============================================

1. The Directory Structure

All directories are relative to the directory
where xbill.exe is located in!

epacks\	
	Extensionpackdirectory:
	create your directory, and
	name it, whatever you want

epacks\yourdir\
	Here go the following files:
	boutpack.bmp
	xbill.mid
	Any description file, or readme, or
	credits file your want. The xBill 
	program will just ignore it.

epacks\yourdir\bmp\
	Here go the Bitmaps for animated xBill,
	CPUs, OSes, Bucket, Toaster

epacks\yourdir\bmp\masks\
	Here go the Bitmap masks

epacks\yourdir\cur\
	Put your cursors here
	Handup, Handdown, Bucket and the OS
	cursors: Apple, BSD, HURD, LINUX,
	Next, OS2, REDHAT, SGI, SUN

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

2. File descriptions

BMP images may be Indexed or RGB type.

~ boutpack.bmp ~
	A 240x100 pixels BMP file, that will appear
	in the "Choose a Pack" Dialog. 
	Put whatever you want in it! What's your
	pack about?

~ xbill.mid ~
	If you want Background MIDI sound, add this
	file. Any MIDI possible.

~ Animations ~
	Each animationframe is a single BMPfile,
	that has to be BITBLTable. That means these
	Bitmaps must have a black background, and each
	picture needs a mask-file.
	This maskfile is just black and white:
	has to have a white background,
	and is black in the foreground.

Walking:
	left	billl_0.bmp     - billl_2.bmp	3 frames
		msk_billl_0.bmp - msk_billl_2.bmp
	Width: 24	Height: 38

	right	billr_0.bmp     - billr_2.bmp	3 frames
		msk_billr_0.bmp - msk_billr_2.bmp	
	Width: 24	Height: 38

Dying:
	billd_0.bmp     - billd_4.bmp 		5 frames
	msk_billd_0.bmp - msk_billd_4.bmp
	Width: 24	Height: 38

Installing OS:
	billa_0.bmp     - billa_12.bmp		13 frames
	msk_billa_0.bmp - msk_billa_12.bmp
	Width: 58	Height: 41


~ Cursors ~
	Hot Spots
		Hand_up, Hand_Down, Bucket	16x9
		OSes				16x16
	the original cursors are centered 32x32,
	so, if you align them to one side, adjust
	the hot spots as needed

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

3. What to check before publishing
	1 do the Cursors work right? check, and adjust
	  Hot Spot position if needed
	2 are all files included? those missing will be
	  replaced by the original ones, which will make
	  animations look real crappy if for instance a
	  mask file is missing and you changed Bill's out-
	  line
	3 is the directory structure right? if not, files
	  cannot be found
	4 did you include your credits picture (boutpack.bmp)?
	  if not, your extension pack will not appear in
	  the list!



=========================================================

I hope this makes everything clear. If you need additional
help, look at the default pack for an example.

Have fun!





