IIXC_Page::TableFilter Method

From Tracker Software PDF SDK
Jump to: navigation, search
Line 3: Line 3:
 
{{#parentPage:PXV:IIXC_Page|TableFilter Method|method}}
 
{{#parentPage:PXV:IIXC_Page|TableFilter Method|method}}
  
{{ToReview}}
 
  
 
The method applies a general table filter to an image page or its specified rectangular area.
 
The method applies a general table filter to an image page or its specified rectangular area.
Line 15: Line 14:
 
== Parameters ==
 
== Parameters ==
 
;pRect
 
;pRect
:[in]  Pointer to the RECT structure which defines the rectangular area where the function should be applied. If this parameter is NULL, the entire page will be processed.
+
:[in]  Pointer to the RECT structure which defines the rectangular area where the function should be applied. If this parameter is <tt>NULL</tt>, the entire page will be processed.
{{note|Please note that partial processing of an area of a page is not supported for all image formats. For example, it is not supported for indexed images, because each pixel in such images contains not a color, but an index into a color table (palette) which is common for the entire page.}}
+
{{note|Please note that partial processing of an area of a page is not supported for all image formats. For example, it is not supported for indexed images, because pixels in such images do not contain a color, but an index into a color table (or palette) which is common for the entire page.}}
 
;B_Table
 
;B_Table
 
:[in, optional]  Specifies the blue table.
 
:[in, optional]  Specifies the blue table.

Revision as of 13:19, 18 May 2015


The method applies a general table filter to an image page or its specified rectangular area.

Syntax

HRESULT TableFilter([in]            RECT*   pRect,
                    [in, optional]  UCHAR*  B_Table,
                    [in, optional]  UCHAR*  G_Table,
                    [in, optional]  UCHAR*  R_Table);

Parameters

pRect
[in] Pointer to the RECT structure which defines the rectangular area where the function should be applied. If this parameter is NULL, the entire page will be processed.
Note:
Please note that partial processing of an area of a page is not supported for all image formats. For example, it is not supported for indexed images, because pixels in such images do not contain a color, but an index into a color table (or palette) which is common for the entire page.
B_Table
[in, optional] Specifies the blue table.
G_Table
[in, optional] Specifies the green table.
R_Table
[in, optional] Specifies the red table.

Return Value

Returns S_OK if operation was successful or error code in other cases.

Remarks

Each table should have the size of 256.

For each pixel in the image its color value is changed according values passed through the tables. i.e. pixel's color value is (5, 120, 17). New color for this pixel will be the color with the component values taken from the tables with indexes (5, 120, 17). So the final color value for the selected pixel will be: (B_Table[5], G_Table[120], R_Table[17]).

See Also

IIXC_Page
IIXC_Page::FilterMedian
IIXC_Page::FilterMosaic
IIXC_Page::FilterNoise
IIXC_Page::StdMatrixFilter