Como modificar os pixels de uma fonte de bitmap

Este tópico demonstra como modificar os pixels de uma fonte de bitmap usando os componentes IWICBitmap e IWICBitmapLock .

Para modificar os pixels de uma fonte de bitmap

1. Crie um objeto IWICImagingFactory para criar objetos WIC (Componente de Imagem do Windows).

   // Create WIC factory
   hr = CoCreateInstance(
       CLSID_WICImagingFactory,
       NULL,
       CLSCTX_INPROC_SERVER,
       IID_PPV_ARGS(&m_pIWICFactory)
       );
   

2. Use o método CreateDecoderFromFilename para criar um IWICBitmapDecoder de um arquivo de imagem.

   HRESULT hr = S_OK;
   
   IWICBitmapDecoder *pIDecoder = NULL;
   IWICBitmapFrameDecode *pIDecoderFrame  = NULL;
   
   hr = m_pIWICFactory->CreateDecoderFromFilename(
      L"turtle.jpg",                  // Image to be decoded
      NULL,                           // Do not prefer a particular vendor
      GENERIC_READ,                   // Desired read access to the file
      WICDecodeMetadataCacheOnDemand, // Cache metadata when needed
      &pIDecoder                      // Pointer to the decoder
      );
   

3. Obtenha o primeiro IWICBitmapFrameDecode da imagem.

   // Retrieve the first bitmap frame.
   if (SUCCEEDED(hr))
   {
      hr = pIDecoder->GetFrame(0, &pIDecoderFrame);
   }
   

   O formato de arquivo JPEG dá suporte apenas a um único quadro. Como o arquivo neste exemplo é um arquivo JPEG, o primeiro quadro (0) é usado. Para formatos de imagem que têm vários quadros, consulte Como recuperar os quadros de uma imagem para acessar cada quadro da imagem.

4. Crie um IWICBitmap do quadro de imagem obtido anteriormente.

   IWICBitmap *pIBitmap = NULL;
   IWICBitmapLock *pILock = NULL;
   
   UINT uiWidth = 10;
   UINT uiHeight = 10;
   
   WICRect rcLock = { 0, 0, uiWidth, uiHeight };
   
   // Create the bitmap from the image frame.
   if (SUCCEEDED(hr))
   {
      hr = m_pIWICFactory->CreateBitmapFromSource(
         pIDecoderFrame,          // Create a bitmap from the image frame
         WICBitmapCacheOnDemand,  // Cache bitmap pixels on first access
         &pIBitmap);              // Pointer to the bitmap
   }
   

5. Obtenha um IWICBitmapLock para um retângulo especificado do IWICBitmap.

   if (SUCCEEDED(hr))
   {
      // Obtain a bitmap lock for exclusive write.
      // The lock is for a 10x10 rectangle starting at the top left of the
      // bitmap.
      hr = pIBitmap->Lock(&rcLock, WICBitmapLockWrite, &pILock);
   

6. Processe os dados de pixel que agora estão bloqueados pelo objeto IWICBitmapLock .

      if (SUCCEEDED(hr))
      {
         UINT cbBufferSize = 0;
         BYTE *pv = NULL;
   
         // Retrieve a pointer to the pixel data.
         if (SUCCEEDED(hr))
         {
            hr = pILock->GetDataPointer(&cbBufferSize, &pv);
         }
   
         // Pixel manipulation using the image data pointer pv.
         // ...
   
         // Release the bitmap lock.
         SafeRelease(&pILock);
      }
   }
   

   Para desbloquear o IWICBitmap, chame IUnknown::Release em todos os objetos IWICBitmapLock associados ao IWICBitmap.

7. Limpe os objetos criados.

   SafeRelease(&pIBitmap);
   SafeRelease(&pIDecoder);
   SafeRelease(&pIDecoderFrame);
   

Consulte Também

Guia de programação

Referência

Amostras