IWiaSegmentationFilter interface
The IWiaSegmentationFilter interface detects sub-regions of an image stream and makes separate IWiaItem2 items for each.
Members
The IWiaSegmentationFilter interface inherits from the IUnknown interface. IWiaSegmentationFilter also has these types of members:
Methods
The IWiaSegmentationFilter interface has these methods.
| Method | Description |
|---|---|
| DetectRegions | Determines the sub-regions of an image laid out on the flatbed platen so that each of sub-region can be acquired into a separate image item. |
Remarks
An application should use IWiaItem2::GetExtension to create a new instance of the segmentation filter. An application typically calls this function before displaying its preview window.
When implementing this filter, use IWiaItem2::CreateChildItem to create the child items. The application should pass COPY_PARENT_PROPERTY_VALUES to the ICreationFlags parameter to ensure that properties such as image format and resolution is the same in the newly created child as in the parent item.
A segmentation filter must support all the image formats that the driver it is used with supports. The Microsoft provided filter supports bitmap (BMP), Graphics Interchange Format (GIF), JPEG, Portable Network Graphics (PNG), and Tagged Image File Format (TIFF).
The segmentation filter should be used only on film and flatbed scanner items. For film scanning, a scanner often comes with fixed frames in which case the driver created the child items and the application should not invoke the segmentation filter.
The IWiaSegmentationFilter interface, like all Component Object Model (COM) interfaces, inherits the IUnknown interface methods.
| IUnknown Methods | Description |
|---|---|
| IUnknown::QueryInterface | Returns pointers to supported interfaces. |
| IUnknown::AddRef | Increments reference count. |
| IUnknown::Release | Decrements reference count. |
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client |
Windows Vista [desktop apps only] |
| Minimum supported server |
Windows Server 2008 [desktop apps only] |
| Header |
|
| IDL |
|