File: README.bni

package info (click to toggle)
bnetd 0.4.25-6
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 4,516 kB
  • ctags: 7,224
  • sloc: ansic: 67,547; sh: 3,142; makefile: 796; python: 304; perl: 211; awk: 73
file content (105 lines) | stat: -rw-r--r-- 2,747 bytes parent folder | download | duplicates (4)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

		BNI Utils 
		Version 0.4
		by Marco Ziech <mmz@gmx.net>
		http://mrtyphoon.virtualave.net

Overview
========
These utilities are for handling BNI files. BNI files are used in the 
bnet for storing the icons of the diffrent games. See BNIHEADER for more
information about th structure of BNI files.
In these utilities are programs for
	* extracting
	* building
	* listing & checking
BNI files.   


LICENSE
=======
See LICENSE (GPL)


Installation
============

Just type 'make'.

bnilist <bnifile>
-------
	This program simply prints out the contents of a BNI-file and does
	some sanity checks.
	Example:
		$ bnilist icons.bni

bni2tga <bnifile>
-------
	This program reads the big tga out of the bni file and writes
	it to stdout.
	Example:
		$ bni2tga icons.bni > icons.tga

bniextract <bnifile> <directory>
----------
	This program extracts the contents of the BNI file to the
	specified directory. If this directory doesn't exist it will
	be created.
	Example:
		$ bniextract icons.bni icons

bnibuild <directory> <bnifile>
--------	 
	This program writes the content of a with bniextract created 
	directory to a BNI file. With this program you can create your 
	own BNI files (if you want ;-).
	Example:
		$ bnibuild icons icons.bni

Contents of directories created by bniextract
=============================================
Directories created by bniextract should contain every icon in its own
TGA file and the bniindex.lst file. The format of th bniindex.lst file
is explained below. If the "icon id" of the icon is 0 the TGA file is 
named by the "tag" of the icon (4 chars). If "icon id" is non-zero the 
name of the TGA file is the "icon id" in hex filled up with zeros to 
8 characters.


Fields in the bniindex.lst file, created by bniextract
======================================================
Every line contains ...
<EntryName> <Field1> <Field2> ... <FieldN>

Comments are not allowed ...


Field: 	unknown1 <hex int>
	This field sets the unknown1 value to the given value. (0x10)

Field: 	unknown2 <hex int>
	This field sets the unknown2 value to the given value. (0x01)

Field: 	icon !<char[4] tag> <dec int x> <dec int y> <hex int flags>
	icon #<hex int id> <dec int x> <dec int y> <hex int flags>

	This field describes one icon entry.

Example: unknown1 00000010
	This field is the unknown1 value 0x00000010.
	 
Example: unknown2 00000001
	This field is the unknown1 value 0x00000001.

Example: icon !DRTL 28 14 00000000
	This field describes an icon with an empty id field and with "DRTL"
	in the tag field.

Example: icon #00000001 28 14 00000000
	This field describes an icon with no tag field and with 0x00000001
	in the id field.

LEGAL NOTES
===========
	All trademarks are property of their registered owners.