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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- Created by texi2html 1.64 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
Olaf Bachmann <obachman@mathematik.uni-kl.de>
and many others.
Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
-->
<HTML>
<HEAD>
<TITLE>Crystal Space: map2cs.cfg</TITLE>
<META NAME="description" CONTENT="Crystal Space: map2cs.cfg">
<META NAME="keywords" CONTENT="Crystal Space: map2cs.cfg">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="texi2html 1.64">
</HEAD>
<BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
<A NAME="SEC145"></A>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_63.html#SEC144"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_65.html#SEC148"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_55.html#SEC136"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_63.html#SEC144"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_68.html#SEC154"> >> </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="index.html#SEC_Top">Top</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_toc.html#SEC_Contents">Contents</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_285.html#SEC711">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<HR SIZE=1>
<H3> 4.3.1 Reference for `<TT>map2cs.cfg</TT>' </H3>
<!--docid::SEC145::-->
<P>
The `<TT>map2cs.cfg</TT>' file is the most important way to configure
`<TT>map2cs</TT>' I will explain all possible settings here.
</P><P>
A sample `<TT>map2cs.cfg</TT>' will look like this:
</P><P>
<TABLE><tr><td> </td><td class=example><pre>[texturesettings]
defaulttexture = a_4hewn
wad1 = E:\Sierra\Half-Life\valve\halflife.wad
wad2 = E:\Sierra\Half-Life\valve\xeno.wad
wad3 = E:\Sierra\Half-Life\valve\liquids.wad
wad4 = E:\Sierra\Half-Life\valve\texpack.wad
zip1 = E:\Cryst\skybox.zip
zip2 = E:\Cryst\skybox2.zip
pk1 = D:\Games\Quake III Arena\baseq3\pak0.pk3
pk2 = D:\Games\Quake III Arena\baseq3\mapmedia.pk3
[general]
scaling = 0.025
usebsp = 1
removehidden = 1
lightscale = 30
</pre></td></tr></table></P><P>
The following sections describe the various configuration file entries and the
associated values which may appear in each section.
</P><P>
<A NAME="SEC146"></A>
<H4> Texture Settings </H4>
<!--docid::SEC146::-->
<P>
<CODE>[texturesettings]</CODE>
</P><P>
<UL>
<LI>
<CODE>defaulttexture</CODE>
<P>
Specifies the name of the texture, that will be used, when the original
texture is not found. If the default texture will not be found, the resulting
map will not be useable. You need to manually edit the map file then. (I
don't recommend doing so, but there are users, who just want to do that.)
</P><P>
<LI>
<CODE>wad</CODE>
<P>
Specifies all possible wad files. You need to give the full path here. If
there are several wad files, you need to number them: `<SAMP>wad1</SAMP>',
`<SAMP>wad2</SAMP>', and so on. You can use any number of wad files with
`<TT>map2cs</TT>'. The wad files need to be WAD3 format, which means the
format used by Hald-Life, not the format used by Quake 1 or 2!
</P><P>
<LI>
<CODE>pk</CODE>
<P>
Specifies all possible pk3 files. These files are the archives, that Quake3
uses. You can create a pk3 file for use with `<TT>map2cs</TT>', if you create a
zip archive, in which you create a subdirectory called textures. Put all your
textures below that, and use TGA or JPG as texture formats. When
you rename that zip file to pk3, you have a valid Quake3 texture archive. (At
least it is a valid archive for `<TT>map2cs</TT>'.)
</P><P>
<LI>
<CODE>zip</CODE>
<P>
Specifies all possible zip files. You need to give the full path here. If
there are several zip files, you need to number them: `<SAMP>zip1</SAMP>',
`<SAMP>zip2</SAMP>', and so on.. The zip files need to contain the textures in the
main directory of the zip file (or a subdirectory equivalent to the name used
in the map file). `<TT>map2cs</TT>' will look for the following formats in the
zip file (in this order): TGA, JPG, JPEG, BMP, WAL.
</UL>
<P>
<A NAME="SEC147"></A>
<H4> General Settings </H4>
<!--docid::SEC147::-->
<P>
<CODE>[general]</CODE>
</P><P>
<UL>
<A NAME="map2cs.cfg scaling"></A>
<LI>
<CODE>scaling</CODE>
<P>
Quake uses a scale of 1 unit equals 1 inch. Crystal Space uses 1 unit equals
1 meter, so obviously, we need some scaling. 0.025 is a very good factor to
scale quake maps, but if you need a different factor, just use another value.
</P><P>
<LI>
<CODE>usebsp</CODE>
<P>
Set this to true, to enable BSP-tree generation in all sectors. That
should normally be 1 in all cases. You can set it to 0 for testing puprosed
though.
</P><P>
<LI>
<CODE>removehidden</CODE>
<P>
Set this to 1 is you want MAP2CS to remove hidden surfaces. This is very
useful for complex maps, because you have no chance to create maps without
having hidden surfaces, but by removing these surfaces `<TT>map2cs</TT>' must
sometimes split a polygon inte smaller pieces, so polygon count can even raise
but this setting. I recommend using it anyway, because it will reduce
required fillrate. Also the engine can possibly cull away parts of the larger
polygon which will speed up things. I recommend setting this to 1 for release
maps and setting it to 0 for fast testings, because removal of hidden surfaces
is pretty slow.
</P><P>
<A NAME="map2cs.cfg lightscale"></A>
<LI>
<CODE>lightscale</CODE>
<P>
This is a difficult setting. Because Quake and Crystal Space lighting differs
very much there is no real translation. I assume 15 is a good value, some map
will appear too bright then. In these cases set this value lower. If there
is not enough light, increase the value.
</UL>
<A NAME="map2cs Classnames and Keys"></A>
<HR SIZE=1>
<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_63.html#SEC144"> < </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_65.html#SEC148"> > </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_55.html#SEC136"> << </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_63.html#SEC144"> Up </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_68.html#SEC154"> >> </A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="index.html#SEC_Top">Top</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_toc.html#SEC_Contents">Contents</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_285.html#SEC711">Index</A>]</TD>
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="cs_abt.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<BR>
<FONT SIZE="-1">
This document was generated
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
</BODY>
</HTML>
|
