IWiaSegmentationFilter：:D etectRegions 方法

  • 项目

确定平面板上布局的图像的子区域，以便每个子区域都可以获取到单独的图像项中。

语法

HRESULT DetectRegions(
  [in] LONG      lFlags,
  [in] IStream   *pInputStream,
  [in] IWiaItem2 *pWiaItem2
);

参数

lFlags [in]

类型： LONG

当前未使用。 应设置为零。

pInputStream [in]

类型： IStream*

指定指向 IStream 预览图像的指针。

pWiaItem2 [in]

类型： IWiaItem2*

指定指向为其获取 pInputStream 的 IWiaItem2 项的指针。 分段筛选器为此项创建子项。

返回值

类型： HRESULT

如果此方法成功，则返回 S_OK。 否则，它将返回 HRESULT 错误代码。

备注

此方法确定 pInputStream 表示的图像的子区域。 对于它检测到的每个子区域，它会为 pWiaItem2 参数中指定的 IWiaItem2 项创建一个子项。 对于每个子项，分段筛选器必须使用以下 扫描程序 WIA 项属性常量为要扫描的区域的边界矩形设置值。

如果驱动程序支持倾斜，则更高级的筛选器可能还需要其他 扫描程序 WIA 项属性常量 ，例如 WIA_IPS_DESKEW_X 和 WIA_IPS_DESKEW_Y。

如果应用程序多次调用 IWiaSegmentationFilter：:D etectRegions ，则应用程序必须首先删除上次调用 IWiaSegmentationFilter：:D etectRegions 所创建的子项。

如果应用程序将任何属性更改为 pWiaItem2，在将图像获取到 pInputStream 和调用 IWiaSegmentationFilter：:D etectRegions 之间，原始属性 (即，必须还原项目在获取流) 时具有的属性。 这可以通过 GetPropertyStream 和 SetPropertyStream 完成。

如果应用程序调用多次将同一流传递到分段筛选器中，则应用程序必须重置 IStream 。 应用程序还必须在初始下载后和调用 IWiaSegmentationFilter：:D etectRegions 之前重置流。

示例

分段对传递到 DetectSubregions pImageStream 的流 () 执行区域检测。 请参阅此示例中使用的 GetExtension for CreateSegmentationFilter 方法。

HRESULT
DetectSubregions(
   IN IStream   *pImageStream,
   IN IWiaItem2 *pWiaItem2)
{
   HRESULT                 hr                  = S_OK;
   IWiaSegmentationFilter* pSegmentationFilter = NULL;

   if (!pWiaItem2 || !pImageStream)
   {
      hr = E_INVALIDARG;
   }

   if (SUCCEEDED(hr))
   {
      hr = CreateSegmentationFilter(pWiaItem2, &pSegmentationFilter);
   }

   if (SUCCEEDED(hr))
   {
      hr = pSegmentationFilter->DetectRegions(0,pImageStream, pWiaItem2); 
   }

   if (pSegmentationFilter)
   {
      pSegmentationFilter->Release();
      pSegmentationFilter = NULL;
   }

   return hr;
}

DownloadPreviewImage 通过调用预览组件的 GetNewPreview 方法从扫描程序下载图像数据。 如果应用程序用户想要调用分段筛选器，它会调用 DetectSubregions，该筛选器会在 pWiaItem2 下为其检测到的每个区域创建一个子项。 有关此示例中使用的 DetectSubregions 方法，请参阅 IWiaSegmentationFilter：:D etectRegions 。

在此示例中，应用程序用户通过单击检查框进行设置m_bUseSegmentationFilter。 如果应用程序支持此功能，它应首先通过调用 CheckExtension 检查驱动程序具有分段筛选器。 有关 CheckImgFilter 方法示例，请参阅 GetNewPreview ，该示例演示如何执行此操作。

HRESULT
DownloadPreviewImage(
   IN IWiaItem2 *pWiaFlatbedItem2)
{
   HRESULT hr              = S_OK;
   BOOL    bHasImgFilter   = FALSE;

   IWiaTransferCallback *pAppWiaTransferCallback = NULL;

   hr = CheckImgFilter(pWiaFlatbedItem2, &bHasImgFilter)

   if (SUCCEEDED(hr))
   {
      if (bHasImgFilter)
      {
         IWiaPreview *pWiaPreview = NULL;

         // In this example, the AppWiaTransferCallback class implements 
         // the IWiaTransferCallback interface.  
         // The constructor of AppWiaTransferCallback sets the reference count 
         // to 1.
         pAppWiaTransferCallback = new AppWiaTransferCallback();

         hr = pAppWiaTransferCallback ? S_OK : E_OUTOFMEMORY;

         if (SUCCEEDED(hr))
         {
            // Acquire image from scanner
            hr = m_pWiaPreview->GetNewPreview(pWiaFlatbedItem2,
                                              0,
                                              pAppWiaTransferCallback);    
         }

         //
         // Check the application UI for whether the user wants
         // to use the segmentation filter indicated by the value 
         // of m_bUseSegmentationFilter.
         //
         // m_FlatbedPreviewStream is the stream that
         // AppWiaTransferCallback::GetNextStream returned for the
         // flatbed item.
         // This stream is where the image data is stored after
         // the successful return of GetNewPreview.
         // The stream is passed into the segmentation filter
         // for region detection.
         if (SUCCEEDED(hr) && m_bUseSegmentationFilter)
         {
            DetectSubregions(m_FlatbedPreviewStream, pWiaFlatbedItem2);
         }

         if (pAppWiaTransferCallback)
         {
            // If the call to GetNewPreview was successful, the
            // preview component calls AddRef on the callback so
            // this call doesn't delete the object.

            pAppWiaTransferCallback->Release();
         }

      }
      else
      {
         // Do not create an instance of preview component if the driver 
         // does not come with an image-processing filter.
         // You can use a segmentation filter, however, if the driver
         // comes with one (omitted here).
      }
   }

   return hr;
}

要求

要求 值
最低受支持的客户端
 Windows Vista [仅限桌面应用]
最低受支持的服务器
 Windows Server 2008 [仅限桌面应用]
标头
Wia.h
IDL
Wia.idl