The Photoshop texture file converter is a file format plug-in to
Adobe Photoshop 
to open or save texture files. The plug-in will also work with
Jasc PaintShop Pro 
. The following are the available input and output formats:
- .bmp
- .dds
- .dib
- .hdr
- .jpg
- .pfm
- .png
- .tga
See
D3DXIMAGE_FILEFORMAT for more information on these texture file formats.
Requirements
Minimum Operating System | Microsoft Windows 2000 |
---|
Required Applications | |
---|
Installation
The texture converter plug-in is automatically installed when you install the DirectX 9.0 software development kit (SDK). The installer checks for valid versions of Photoshop or PaintShop Pro and copies the D3DXTextureFormat.8bi file to the application plug-in folder.
User's Guide
The texture plug-in allows you to open or save files in Photoshop in any of the nine texture file formats listed above. Similar procedures can be used in PaintShop Pro.
Opening a Texture File
Follow these steps to open a texture file.
- In the Photoshop File menu, select Open... or Open As....
- In the Files of type list at the bottom of the dialog box, select the following format:
D3DXTextureFormat(*.BMP;*.DDS;*.DIB;*.HDR;*.JPG;*.PFM;*.PNG;*.PPM;*.TGA)
- Select the file you want to open, and either double-click the file icon or click the Open button. The texture file is now available to edit in Photoshop.
If more than one mip level is available in the mipmap, the following dialog box will appear.

The Open entire file option is the default selection. If this option is selected, all mip levels are joined together in a single Photoshop 2-D image display.

You can then edit any or all of the mip levels in Photoshop. Alternately, you can select Open a particular mip level if you want to edit only one mip level in Photoshop, for example the 128x32 pixel level shown here.

If the file to be opened is a cube or volume texture, a similar dialog box will appear that lets you select a view of all cube faces or volume slices simultaneously, or one at a time. Mip levels of a cube or volume texture are not available for display with this plug-in.
Note It is not recommended that you open a texture file by right-clicking it and selecting Open With and then Adobe Photoshop.
Warning When you use the plug-in with PaintShop Pro to open a texture file that contains an alpha channel, PaintShop Pro will multiply each of the RGB channels by the alpha channel and then will discard the alpha channel. If the input texture has an XRGB surface format (
D3DFMT_X8R8G8B8,
D3DFMT_X1R5G5B5,
D3DFMT_X4R4G4B4, or
D3DFMT_X8B8G8R8), this behavior results in an empty texture being saved.
Saving a Simple Texture File
Complete the following steps to save a texture file to any supported format except .dds.
- In the Photoshop File menu, select Save As....
- In the Files of type list at the bottom of the dialog box, select the following format:
D3DXTextureFormat(*.BMP;*.DDS;*.DIB;*.HDR;*.JPG;*.PFM;*.PNG;*.PPM;*.TGA)
- Select the directory location where you want to save the file.
- Type in the name of the file to save, along with the three-letter file extension (any supported format listed above except .dds). You may overwrite your original file.
- Click the Save button.
- The following dialog box will appear.

Select the pixel format from the list of available formats at the bottom of the dialog box. No other save options will be available in this dialog.
- Click OK to save the file.
Saving a DDS File
Follow these steps to save a texture file to .dds format.
- In the Photoshop File menu, select Save As....
- In the Files of type list at the bottom of the dialog box, select the following format:
D3DXTextureFormat(*.BMP;*.DDS;*.DIB;*.HDR;*.JPG;*.PFM;*.PNG;*.PPM;*.TGA)
- Select the directory location where you want to save the file.
- Type in the name of the file to save, along with the .dds file extension.
- Click the Save button. The following dialog box will appear.

- Make selections for the type of texture to save.
- If you select the Cube map or Volume texture, then you can also click the checkbox to duplicate the image on all cube faces or volume slices.
- If you select a Volume texture, then in the Depth box type in the number of volume slices you want the volume texture to contain.
- If you select Cube map but your texture file format is not square, a warning message will appear noting that the image will be cropped to be a square format.
- From the list of available mip levels, select the number of mip levels you want the new texture file to contain.
- From the list of available formats, select the pixel format in which to save the file.
- Click OK to save the file.
Note To avoid generating invalid results, the plug-in does not allow saving a full volume as a cube, or a full cube as a volume.
Resizing and Saving a Texture File
If you change the image size of an individual mip level in Photoshop and then try to save the file using Save from the Photoshop File menu, an error message will appear and the file will not be saved. You should instead try one of the following procedures:
- Open the file with the Open a particular mip level option and then change the image size in Photoshop. Use Save As... from the Photoshop File menu, and the new saved file will be properly resized.
- Open the file with the Open entire file option and then change the image size in Photoshop. If you use Save As... to save to the original file type, all mip levels will be resized proportionally in your new saved file.
- Open the file with the Open entire file option and then change the image size in Photoshop. If you use Save As... to save to a different file type, in your new saved file the entire image displayed in Photoshop will become the new top-level texture, front cube face, or top volume slice.