如何剪裁位图源

本主题演示如何使用 IWICBitmapClipper 组件获取 IWICBitmapSource 的矩形部分。

剪裁位图源

1. 创建 IWICImagingFactory 对象，以 (WIC) 对象创建 Windows 映像组件。

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

2. 使用 CreateDecoderFromFilename 方法从图像文件创建 IWICBitmapDecoder 。

   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. 获取图像的第一个 IWICBitmapFrameDecode 。

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

   JPEG 文件格式仅支持单个帧。 由于此示例中的文件是 JPEG 文件，因此使用第一个帧 (0) 。 有关具有多个帧的图像格式，请参阅 如何检索图像的帧 以访问图像的每个帧。

4. 创建用于图像剪辑的 IWICBitmapClipper 。

   IWICBitmapClipper *pIClipper = NULL;
   
   if (SUCCEEDED(hr))
   {
      hr = m_pIWICFactory->CreateBitmapClipper(&pIClipper);
   }
   

5. 使用位图帧的给定矩形内的图像数据初始化剪辑器对象。

   // Create the clipping rectangle.
   WICRect rcClip = { 0, 0, uiWidth/2, uiHeight/2 };
   
   // Initialize the clipper with the given rectangle of the frame's image data.
   if (SUCCEEDED(hr))
   {
      hr = pIClipper->Initialize(pIDecoderFrame, &rcClip);
   }
   

6. 绘制或处理已剪裁的图像。

   下图演示了图像剪辑。 左侧的原始图像为 200 x 130 像素。 右侧的图像是裁剪为定义为 {20,20,100,100}的矩形的原始图像。

   

另请参阅

编程指南

引用

示例