Microsoft KB Archive/175543

From BetaArchive Wiki
< Microsoft KB Archive
Revision as of 12:30, 21 July 2020 by X010 (talk | contribs) (Text replacement - "&" to "&")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

HOWTO: Texture Rendered Upside Down in Direct3D Retained Mode

Q175543



The information in this article applies to:


  • Microsoft DirectX Software Development Kit, version 5.0





SUMMARY

In DirectX 3, a texture loaded from a .bmp file with the IDirect3DRM::LoadTexture method is rendered upside down. In DirectX version 5.0, you can use the new IDirect3DRM2 interface to load a .bmp file and have it displayed right side up.



MORE INFORMATION

This behavior in DirectX 3 needed to be preserved in DirectX 5.0 (in IDirect3DRM) for backward compatibility with older applications. In DirectX 5.0, you can call IDirect3DRM2::LoadTexture to load a .bmp file and have it rendered right side up.

If you are writing a DirectX 5.0 (or later) application that uses the IDirect3DRM interface, then you should call QueryInterface on IDirect3DRM to obtain the IDirect3DRM2 interface if you would like your .bmp files loaded with LoadTexture() to be displayed right side up. The texture must be placed in a DIRECT3DRMTEXTURE2 object. Here is an example in "C" which demonstrates this process:

   LPDIRECT3DRM2 lpD3DRM2;
   LPDIRECT3DRMTEXTURE2 tex = NULL;

   // Query the IDirect3DRM2 interface off of Direct3DRM.
   rval = lpD3DRM->lpVtbl->QueryInterface(lpD3DRM,
                &IID_IDirect3DRM2,(LPVOID*)&lpD3DRM2);
   if (rval != D3DRM_OK)
   {
      Msg("Failed to obtain the IDirect3DRM2 interface.\n");
      goto ret_with_error;
   }

   // Load the texture with the new interface
   rval = lpD3DRM2->lpVtbl->LoadTexture(lpD3DRM2, "test.bmp", &tex);
   if (rval != D3DRM_OK)
   {
      Msg("Failed to load test.bmp.\n");
      goto ret_with_error;
   }

   // Release the IDirect3DRM2 interface
   lpD3DRM2->lpVtbl->Release(lpD3DRM2); 

Additional query words:

Keywords : kbDirect3dRM KbDirectX kbSDKWin32 kbFAQ _IK
Issue type : kbhowto
Technology : kbSDKDirectXsearch kbAudDeveloper kbSDKDirectX500


Last Reviewed: June 26, 2001
© 2001 Microsoft Corporation. All rights reserved. Terms of Use.