Guide pratique pour charger une bitmap à partir d’une ressource (Direct2D)

Comme décrit dans Comment charger une bitmap à partir d’un fichier, Direct2D utilise le composant WiC (Windows Imaging Component) pour charger des bitmaps. Pour charger une bitmap à partir d’une ressource, utilisez des objets WIC pour charger l’image et la convertir dans un format compatible Direct2D . ensuite, utilisez la méthode CreateBitmapFromWicBitmap pour créer un ID2D1Bitmap.

1. Dans le fichier de définition de ressource d’application, définissez la ressource. L’exemple suivant définit une ressource nommée « SampleImage ».

   // THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
   // ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
   // THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
   // PARTICULAR PURPOSE.
   //
   // Copyright (c) Microsoft Corporation. All rights reserved
   #include "windows.h"
   
   SampleImage Image "sampleImage.jpg"
   

Cette ressource sera ajoutée au fichier de ressources de l’application lors de la génération de l’application.

2. Chargez l’image à partir du fichier de ressources de l’application.

   HRESULT DemoApp::LoadResourceBitmap(
       ID2D1RenderTarget *pRenderTarget,
       IWICImagingFactory *pIWICFactory,
       PCWSTR resourceName,
       PCWSTR resourceType,
       UINT destinationWidth,
       UINT destinationHeight,
       ID2D1Bitmap **ppBitmap
       )
   {
       IWICBitmapDecoder *pDecoder = NULL;
       IWICBitmapFrameDecode *pSource = NULL;
       IWICStream *pStream = NULL;
       IWICFormatConverter *pConverter = NULL;
       IWICBitmapScaler *pScaler = NULL;
   
       HRSRC imageResHandle = NULL;
       HGLOBAL imageResDataHandle = NULL;
       void *pImageFile = NULL;
       DWORD imageFileSize = 0;
   
       // Locate the resource.
       imageResHandle = FindResourceW(HINST_THISCOMPONENT, resourceName, resourceType);
       HRESULT hr = imageResHandle ? S_OK : E_FAIL;
       if (SUCCEEDED(hr))
       {
           // Load the resource.
           imageResDataHandle = LoadResource(HINST_THISCOMPONENT, imageResHandle);
   
           hr = imageResDataHandle ? S_OK : E_FAIL;
       }
   

3. Verrouillez la ressource et calculez la taille de l’image.

       if (SUCCEEDED(hr))
       {
           // Lock it to get a system memory pointer.
           pImageFile = LockResource(imageResDataHandle);
   
           hr = pImageFile ? S_OK : E_FAIL;
       }
       if (SUCCEEDED(hr))
       {
           // Calculate the size.
           imageFileSize = SizeofResource(HINST_THISCOMPONENT, imageResHandle);
   
           hr = imageFileSize ? S_OK : E_FAIL;
   
       }
   

4. Utilisez la méthode IWICImagingFactory::CreateStream pour créer un objet IWICStream .

       if (SUCCEEDED(hr))
       {
             // Create a WIC stream to map onto the memory.
           hr = pIWICFactory->CreateStream(&pStream);
       }
       if (SUCCEEDED(hr))
       {
           // Initialize the stream with the memory pointer and size.
           hr = pStream->InitializeFromMemory(
               reinterpret_cast<BYTE*>(pImageFile),
               imageFileSize
               );
       }
   

5. Utilisez la méthode IWICImagingFactory::CreateDecoderFromStream pour créer un IWICBitmapDecoder.

       if (SUCCEEDED(hr))
       {
           // Create a decoder for the stream.
           hr = pIWICFactory->CreateDecoderFromStream(
               pStream,
               NULL,
               WICDecodeMetadataCacheOnLoad,
               &pDecoder
               );
       }
   

6. Récupérez un cadre de l’image et stockez-le dans un objet IWICBitmapFrameDecode .

       if (SUCCEEDED(hr))
       {
           // Create the initial frame.
           hr = pDecoder->GetFrame(0, &pSource);
       }
   

7. Avant que Direct2D puisse utiliser l’image, elle doit être convertie au format de pixel 32bppPBGRA. Pour convertir le format d’image, utilisez la méthode IWICImagingFactory::CreateFormatConverter pour créer un objet IWICFormatConverter, puis utilisez la méthode Initialize de l’objet IWICFormatConverter pour effectuer la conversion.

        if (SUCCEEDED(hr))
        {
            // Convert the image format to 32bppPBGRA
            // (DXGI_FORMAT_B8G8R8A8_UNORM + D2D1_ALPHA_MODE_PREMULTIPLIED).
            hr = pIWICFactory->CreateFormatConverter(&pConverter);
        }

       if (SUCCEEDED(hr))
        {           
        hr = pConverter->Initialize(
            pSource,
            GUID_WICPixelFormat32bppPBGRA,
            WICBitmapDitherTypeNone,
            NULL,
            0.f,
            WICBitmapPaletteTypeMedianCut
            );

8. Enfin, utilisez la méthode CreateBitmapFromWicBitmap pour créer un objet ID2D1Bitmap qui peut être dessiné par une cible de rendu et utilisé avec d’autres objets Direct2D.

       if (SUCCEEDED(hr))
       {
           //create a Direct2D bitmap from the WIC bitmap.
           hr = pRenderTarget->CreateBitmapFromWicBitmap(
               pConverter,
               NULL,
               ppBitmap
               );
   
       }
   
       SafeRelease(&pDecoder);
       SafeRelease(&pSource);
       SafeRelease(&pStream);
       SafeRelease(&pConverter);
       SafeRelease(&pScaler);
   
       return hr;
   }
   

Un certain code a été omis dans cet exemple.

Rubriques connexes

Guide pratique pour charger une bitmap à partir d’un fichier