forked from walbourn/contentexporter
/
ReadMe.txt
178 lines (127 loc) · 7.24 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
ATG Samples Content Exporter
----------------------------
Copyright (c) Microsoft Corporation. All rights reserved.
November 9, 2016
The Samples Content Exporter was originally shipped as a sample in the legacy DirectX SDK. It makes use of the Autodesk FBX SDK
to import an FBX file and then export the data as an SDKMESH. The SDKMESH format is a runtime geometry format supported
by the DirectX Tool Kit and DXUT, and is used in the Windows 8 Store app sample Marble Maze.
The source is written for Visual Studio 2013 or 2015.
These components are designed to work without requiring any content from the DirectX SDK. For details,
see "Where is the DirectX SDK?" <http://msdn.microsoft.com/en-us/library/ee663275.aspx>.
ImportFBX\
Contains the main entry point for the command-line exporter tool and code for capturing data from FBX files.
ExportObjects\
Contains a library of support code for the exporter.
SDKMeshFileWriter\
Contains a library of code for writing out an .SDKMESH file from data captured as export objects.
XATGFileWriter
Contains a library of code for writing out a .XATG file from data captured as export objects.
DirectXMesh\
This contains the DirectXMesh geometry processing library that is used instead of legacy D3DX9 for computing
tangent frames and face adjacency.
http://go.microsoft.com/fwlink/?LinkID=324981
DirectXTex\
This contains the DirectXTex texture processing library that is used instead of legacy D3DX9 for loading textures,
generating mipmaps, and writing DDS files.
http://go.microsoft.com/fwlink/?LinkId=248926
UVAtlas
This contains the UVAtlas isochart library that is used instead of the legacy D3DX9 for creating a
isochart texture atlas.
http://go.microsoft.com/fwlink/?LinkID=512686
All content and source code for this package are subject to the terms of the MIT License.
<http://opensource.org/licenses/MIT>.
For the latest version of the Samples Content Exporter, more detailed documentation, bug reports and feature requests,
please visit the GitHub project.
http://go.microsoft.com/fwlink/?LinkId=226208
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the
Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.
https://opensource.microsoft.com/codeofconduct/
------------------
BUILD INSTRUCTIONS
------------------
Install the Autodesk FBX SDK 2015.1 or later (latest tested version is 2017.0.1) for Windows VS 2013 or VS 2015
http://autodesk.com/fbx
Ensure the environment variable FBX_SDK is set to point to the Autodesk FBX SDK (such as "C:\Program Files\Autodesk\FBX\FbxSdk\2017.0.1")
Open the ContentExporter_2013.sln or ContentExporter_2015.sln file from Visual Studio.
Build the solution
The resulting command-line tool is located under ImportFBX in Debug_201x or Release_201x as ContentExporter.exe
Usage: ContentExporter [options] <filename.fbx>
----------
DISCLAIMER
----------
.SDKMESH has a long-time samples runtime geometry format for Microsoft since the retiring of the legacy .X file format. It has a number of
limitations, and we don't recommend using it as a your production solution for meshes. It is, however, very useful for samples and itself
serves as an example of such file containers. The documentation on the format can be found in the DirectXMesh project wiki.
http://go.microsoft.com/fwlink/?LinkID=324981
---------------
RELEASE HISTORY
---------------
November 9, 2016
Renamed -fl switch to -featurelevel
Added -vertexcolortype switch to control vertex color format
Added rgba_snorm, rgba_10, r11g11b10, and rgba_s10 (Xbox One only) to -compressedvertextype
Updated DirectXTex, DirectXMesh libraries
Code cleanup
September 14, 2016
Updated DirectXTex, UVAtlas, DirectXMesh libraries
Added HDR file format support for textures
July 13, 2016
Updated DirectXTex, UVAtlas, DirectXMesh libraries
Added -normalmaps macro to set up for exporting meshes using normal mapping
April 27, 2016
Updated DirectXTex, UVAtlas, DirectXMesh libraries
Updated for Autodesk FBX SDK 2017
November 20, 2015
Added warning if using -materialcolors+ with black diffuse colors
November 5, 2015
Add warning if attempting to convert non-multiple-of-4 images to compressed DDS
Changed -forcetextureoverwite default to true
October 30, 2015
Updated with VS 2015 support using the Autodesk FBX SDK 2016.1 or later
Added new command-line option:
-flipz (default+) to control negation of z component for LH vs. RH view coordinates
Fixed -applyglobaltrans to transform exported normals
Updated DirectXTex, UVAtlas, DirectXMesh libraries
Minor code cleanup
July 29, 2015
Retired VS 2010 projects
July 8, 2015
Added command-line options:
-materialcolors (default+) to control export of material lambert/phong colors
-lightmaps macro to set up for exporting meshes using lightmap textures
Fixed problems with export of multiple uv sets and per-vertex colors
Added some more warnings related to uv sets
Updated DirectXTex, UVAtlas, DirectXMesh libraries
June 25, 2015
Added new command-line options:
-useemissivetexture[+|-] Use EmissiveMapTexture as SpecularMapTexture
-defaultspecmap [name] Sets the default specular map texture name
Changed defaults for -defaultdiffusemap and -defaultnormalmap to blank
The .SDKMESH writer now fills in the SpecularTexture string in the material
Change the log messages about applying the default texture names to log level 2 messages rather than warnings
May 6, 2015
Added command-line options:
-optimizemeshes (default-) applies a vertex cache optimization to the VB/IB controlled by -vcache/-restart
-cleanmeshes (default+ if using optimizemeshes, otherwise -) performs back-facing and/or bowtie cleanup
-applyglobaltrans (default-) applies the global transformation matrix on vertex data if not exporting animations
-tangentsindex (default 0) controls which set of texture coordinates are used when computing tangents & binormals
-gsadjacency (default-) controls how adjacency is computed for cleanup, optmization, and UV atlas operations
-texturebgra (default-) controls how uncompressed processed textures are written (BGRA vs. RGBA)
-exportcolors (default+) controls export of per vertex colors
Removed support for -compressednormaltype dec3n as there is no DXGI equivalent (i.e. legacy Direct3D 9 only)
Removed all dependencies on the legacy DirectX SDK and D3DX9
- Makes use of DirectXMath, DirectXMesh, DirectXTex, and UVAtlas instead
April 16, 2015
Updated with VS 2012 support using the Autodesk FBX SDK 2014.1 or later
Updated with VS 2013 support using the Autodesk FBX SDK 2015.1 or later
April 30, 2012
Updated support using the Autodesk FBX SDK 2011.3.1
Updated with VS 2010 toolset support
Last version to support VS 2008
DirectX SDK (June 2010)
Updated with VS 2010 support (still uses VS 2008 toolset) using the Autodesk FBX SDK 2010.2
DirectX SDK (February 2010)
Minor bug fixes
Last version to support VS 2005
DirectX SDK (March 2009)
Original release supporting VS 2005/2008 using the Autodesk FBX SDK 2009.1