Standard Importers and Processors
Describes the standard Content Pipeline importers and content processors of XNA Game Studio that support various common art-asset file formats.
Importers and content processors are implemented as assemblies. In addition to the standard ones provided by XNA Game Studio and listed below, you can also use custom importers and processors that you or other third parties develop. Use the Properties window to assign an appropriate importer and processor for each game asset you add to your game project (see Game Asset Properties for more information).
The table below describes the standard importers shipped with XNA Game Studio and the type of game asset each supports.
All standard importers are declared as part of the Microsoft.Xna.Framework.Content.Pipeline namespace.
|Name||Type Name||Output Type||Description|
|Autodesk FBX - XNA Framework||FbxImporter||NodeContent|
Imports game assets specified with the Autodesk FBX format (.fbx).
This importer is designed to work with assets exported with the 2006.11 version of the FBX exporter.
|Effect - XNA Framework||EffectImporter||EffectContent||Imports a game asset specified with the DirectX Effect file format (.fx).|
|Sprite Font Description - XNA Framework||FontDescriptionImporter||FontDescription||Imports a font description specified in a .spritefont file.|
|Texture - XNA Framework||TextureImporter||TextureContent||Imports a texture. The following types are supported: .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm, and .tga.|
|X File - XNA Framework||XImporter||NodeContent||Imports game assets specified with the DirectX X file format (.x). This importer expects the coordinate system to be left-handed.|
|XACT Project - XNA Framework||N/A||N/A|
Imports game audio specified in the Microsoft Cross-Platform Audio Creation Tool (XACT) format (.xap).
Associating an .xap file with XACT allows you to automatically open XACT when editing any .xap file. Associate the file in XNA Game Studio by right-clicking the .xap file in Solution Explorer, and clicking Open With. Once the dialog box is open, select the XACT-specific string, and then click Set As Default.If the XACT-specific option is not available, you must run XACT before this option appears. The application is available from the Microsoft XNA Game Studio group. From the Start Menu, click Tools, and then click Microsoft Cross-Platform Audio Creation Tool (XACT).
|XML Content - XNA Framework||XmlImporter||object||
Imports XML content used for editing the values of a custom object at runtime. For instance, you could pass XML code to this importer that looks for the specified property of a custom type and changes it to the specified value. You could then process the custom object with a processor or pass it to your game untouched using the No Processing Required processor.
This importer is designed for scenarios like importing an XML file that describes game data at runtime (similar to the Sprite Font Description importer) or importing terrain data in an XML file that is then passed to a processor that generates a random terrain grid using that data.
Standard Content Processors
XNA Game Studio ships with a variety of processors that support several common game asset types. Many of the standard processors, such as the TextureProcessor, support parameters for modifying the default behavior of the processor. For more information, see Parameterized Processors.
The following table describes the standard processors and the type of game asset each supports.
|Name||Type Name||Input Type||Output Type||Description|
|Effect - XNA Framework||EffectProcessor||EffectContent||CompiledEffect||Compiles the string in EffectContent to the appropriate platform.|
|Model - XNA Framework||ModelProcessor||NodeContent Class||ModelContent Class||
A parameterized processor that outputs models as a ModelContent Class object.
|No Processing Required||PassThroughProcessor||Object||Object||
Performs no processing on the file.
Select this processor if your content is already in a game-ready format (for example, an externally prepared DDS file) or a specialized XML format (.xml) designed for use with XNA Game Studio.
|Sprite Font Description - XNA Framework||FontDescriptionProcessor||FontDescription||SpriteFontContent||Converts a .spritefont file specifying a font description into a font.|
|Sprite Font Texture - XNA Framework||FontTextureProcessor||TextureContent||SpriteFontContent||
A parameterized processor that outputs a sprite font texture as a SpriteFontContent object.
|Sprite Font Texture - XNA Framework||FontTextureProcessor||Texture2DContent||SpriteFontContent||Converts a specially marked 2D bitmap file (.bmp) into a font. Pixels of Color.Magenta are converted to Color.TransparentBlack.|
|Texture - XNA Framework||TextureProcessor||TextureContent Class||TextureContent Class||
A parameterized processor that outputs textures as a TextureContent Class object.
|XACT Project - XNA Framework||N/A||N/A||N/A||Generates audio assets from an XACT project.|