-
Notifications
You must be signed in to change notification settings - Fork 51
/
Readme.txt
353 lines (271 loc) · 8.92 KB
/
Readme.txt
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
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
===========================================
===========================================
VTFLib BY: NEIL JEDRZEJEWSKI & RYAN GREGG
===========================================
===========================================
===========================
Library/Author Information:
===========================
Title:
VTFLib
Date:
July 25th, 2011
Authors:
Neil Jedrzejewski & Ryan Gregg
Build:
1.3.2
Email:
jed@wunderboy.org (Neil Jedrzejewski)
ryansgregg@hotmail.com (Ryan Gregg)
Website:
http://www.wunderboy.org/ (Neil Jedrzejewski)
http://nemesis.thewavelength.net/ (Ryan Gregg)
Written In:
C/C++
==========
Structure:
==========
The library contains five folders:
Bin
- Contains library and example program binaries.
Lib
- Contains library C and C++ Header and Inline Files.
Sln
- Contains Visual Studio solutions.
VTFCmd
- Contains C example program source code.
VTFEdit
- Contains C++ .NET example program source code.
VTFLib
- Contains C++ library source code.
The project files are for Visual Studio .NET 2003 and 2005; no .NET extensions
are used except in VTFEdit. Visual Studio 6.0 project files have also been
included, but nvDXTLib does not come with the correct .lib files to link with.
nvDXTLib is required for VTF creation and can be downloaded from:
http://developer.nvidia.com/object/dds_utilities_legacy.html
=============
VTFCmd Usage:
=============
Correct vtfcmd usage:
-file <path> (Input file path.)
-folder <path> (Input directory search string.)
-output <path> (Output directory.)
-prefix <string> (Output file prefix.)
-postfix <string> (Output file postfix.)
-version <string> (Ouput version.)
-format <string> (Ouput format to use on non-alpha textures.)
-alphaformat <string> (Ouput format to use on alpha textures.)
-flag <string> (Output flags to set.)
-resize (Resize the input to a power of 2.)
-rmethod <string> (Resize method to use.)
-rfilter <string> (Resize filter to use.)
-rsharpen <string> (Resize sharpen filter to use.)
-rwidth <integer> (Resize to specific width.)
-rheight <integer> (Resize to specific height.)
-rclampwidth <integer> (Maximum width to resize to.)
-rclampheight <integer> (Maximum height to resize to.)
-gamma (Gamma correct image.)
-gcorrection <single> (Gamma correction to use.)
-nomipmaps (Don't generate mipmaps.)
-mfilter <string> (Mipmap filter to use.)
-msharpen <string> (Mipmap sharpen filter to use.)
-normal (Convert input file to normal map.)
-nkernel <string> (Normal map generation kernel to use.)
-nheight <string> (Normal map height calculation to use.)
-nalpha <string> (Normal map alpha result to set.)
-nscale <single> (Normal map scale to use.)
-nwrap (Wrap the normal map for tiled textures.)
-bumpscale <single> (Engine bump mapping scale to use.)
-nothumbnail (Don't generate thumbnail image.)
-noreflectivity (Don't calculate reflectivity.)
-shader <string> (Create a material for the texture.)
-param <string> <string> (Add a parameter to the material.)
-recurse (Process directories recursively.)
-exportformat <string> (Convert VTF files to the format of this extension.)
-silent (Silent mode.)
-pause (Pause when done.)
-help (Display vtfcmd help.)
Example vtfcmd usage:
vtfcmd.exe -file "C:\texture1.bmp" -file "C:\texture2.bmp" -format "dxt1"
vtfcmd.exe -file "C:\texture.bmp" -format "bgr888" -normal -postfix "normal_"
vtfcmd.exe -folder "C:\input\*.tga" -output "C:\output" -recurse -pause
vtfcmd.exe -folder "C:\output\*.vtf" -output "C:\input" -exportformat "jpg"
==============
Documentation:
==============
Documentation on VTFLib can be found here:
http://www.wunderboy.org/3d_games/utils/vtflib_docs.php
==================
Library Changelog:
==================
v1.3.2
- Improved support for version 7.5 of the VTF format.
v1.3.1
- Added support for version 7.5 of the VTF format.
v1.3.0
- Added support for x64.
- Removed Visual Studio 2003 solution.
- Removed Visual Studio 6 solution.
- Upgraded NVDXT library to 8.31.1127.
v1.2.7
- Added support for version 7.4 of the VTF format.
- Added custom author information resource.
v1.2.6
- Added support for version 7.3 of the VTF format.
- Added loose VMT parsing mode.
- Added Visual Studio 2005 solution.
- Added Visual Studio 6 solution.
- Improved various error messages.
v1.2.5
- Tightly packed all structures to ease importing.
- Upgraded NVDXT library to 8.31.0225.
v1.2.4
- Added recognition for new HDR formats.
- Added optimal convertion paths for common convertions.
- Improved .vmt parsing.
v1.2.3
- Added linear shifting and gamma correction to tone mapping.
v1.2.2
- Added support for zero mipmap textures.
- Fixed volume texture image data offsets.
- Fixed volume texture reflectivity calculation.
v1.2.1
- Added tone mapping.
- Rewrote all format conversion code.
v1.2.0
- Added partial support for version 7.2 of the VTF format.
- Fixed RGBA16161616F encoding and decoding.
v1.1.3
- Improved .vmt parsing.
v1.1.2
- Upgraded NVDXT library to 7.83.0629.
v1.1.1
- Extended CVTFFile class.
v1.1.0
- Added .vtf and .vmt proc load and save code.
- Added .vtf signature check.
v1.0.2
- Added .vtf resize code.
- Improved reflectivity compution code.
- Improved NVDXT library error detection.
v1.0.1
- Added C .vmt saving routines.
- Added additional C .vmt transversal routines.
- Rewrote .vmt parser to be more lenient.
v1.0.0
- Original build.
=================
VTFCmd Changelog:
=================
v1.1.1
- Improved support for version 7.5 of the VTF format.
v1.1.1
- Added support for version 7.5 of the VTF format.
v1.1.0
- Added support for x64.
v1.0.10
- Added support for version 7.4 of the VTF format.
v1.0.9
- Added support for version 7.3 of the VTF format.
- Added export format option.
- Improved help.
v1.0.8
- Added .vtf alpha format, clamp resize, no mipmap and version options.
- Improved drag-and-drop suport.
v1.0.7
- Added the ability to convert .vtf files to .tga.
v1.0.6
- Added partial support for version 7.2 of the VTF format.
v1.0.5
- Added drag-and-drop support.
v1.0.4
- Fixed -recurse option bug.
- Improved output.
v1.0.3
- Added .vtf normal map wrap option.
v1.0.2
- Added .vtf resize option.
v1.0.1
- Added .vmt creation option.
- Fixed folder wildcard bug.
v1.0.0
- Original build.
==================
VTFEdit Changelog:
==================
v1.3.3
- Updated to HLLib v2.4.2.
- Improved support for version 7.5 of the VTF format.
v1.3.2
- Updated to HLLib v2.4.0.
v1.3.1
- Added support for version 7.5 of the VTF format.
v1.3.0
- Added support for x64.
- Updated to HLLib v2.3.0.
v1.2.5
- Added support for version 7.4 of the VTF format.
- Added custom author information resource.
- Updated to HLLib v2.0.8.
v1.2.4
- Added support for version 7.3 of the VTF format.
- Added VTF version option.
- Added VMT parsing strictness option.
- Added resource creation tab.
- Added resource info tab.
- Added configurable batch export format.
- Added png export format.
v1.2.3
- Added workaround for threading state bug.
- Updated to HLLib v2.0.6.
v1.2.2
- Added drag and drop support.
- Updated to HLLib v2.0.2.
v1.2.1
- Fixed several export bugs.
v1.2.0
- Added linear shifting and gamma correction to tone mapping.
- Fixed thread apartment state bug.
v1.1.9
- Added "Export All" option.
- Added several advanced VTF creation options.
- Added "from .vtf" support to batch conversion tool.
v1.1.8
- Added tone mapping control.
v1.1.7
- Added partial support for version 7.2 of the VTF format.
v1.1.6
- Added file system watching.
- Added .vmt text editing capabilities.
- Improved .vmt parsing.
- Fixed some minor menu bugs.
v1.1.5
- Added batch conversion tool.
- Added no alpha and alpha format option.
- Improved WAD conversion tool.
v1.1.4
- Added .vmt creation tool.
- Added default .vmt creation option.
v1.1.3
- Added .vtf file info group.
- Fixed .vtf tile setting bug.
- Improved interface.
v1.1.2
- Added .vtf tile feature.
- Added .vtf normal map wrap option.
v1.1.1
- Added convert WAD dialog.
- Added .vtf resize option.
- Fixed toolbar save button bug.
v1.1.0
- Added a toolbar.
- Added a file system browser tab.
- Added .vtf paste as new option.
- Added .vtf zooming feature.
- Added .vtf alpha channel mask.
v1.0.0
- Original build.
==============================
Program Copyright-Permissions:
==============================
See the lgpl.txt (VTFLib) and gpl.txt (VTFCmd & VTFEdit) files contained in the distribution.