IIXC_Page::ColorBalance Method

From PDF XChange PDF SDK
Jump to: navigation, search
m (Automatic page editing by robot)
m (Automatic page editing by robot)
 
(3 intermediate revisions by the same user not shown)
Line 2: Line 2:
 
[[Category:Editor]]
 
[[Category:Editor]]
 
{{#customTitle:IIXC_Page::ColorBalance Method}}
 
{{#customTitle:IIXC_Page::ColorBalance Method}}
{{#parentPage:PXV:IIXC_Page#Methods|ColorBalance Method|method}}
+
{{#parentPage:PXV:IIXC_Page#Methods|ColorBalance|method}}
  
 
The '''ColorBalance''' method changes the overall mixture of colors in the image page for generalized color correction based on defined values for each of the valid channels available - Red, Green and Blue.
 
The '''ColorBalance''' method changes the overall mixture of colors in the image page for generalized color correction based on defined values for each of the valid channels available - Red, Green and Blue.
Line 10: Line 10:
 
                     [in, defaultvalue(0)]    LONG  nGValue,
 
                     [in, defaultvalue(0)]    LONG  nGValue,
 
                     [in, defaultvalue(0)]    LONG  nBValue,
 
                     [in, defaultvalue(0)]    LONG  nBValue,
                     [in, defaultvalue(NULL)]  RECT*  pRect);</pre>
+
                     [in, defaultvalue(NULL)]  RECT*  stRect);</pre>
  
 
== Parameters ==
 
== Parameters ==
Line 19: Line 19:
 
;nBValue
 
;nBValue
 
:[in, defaultvalue(0)]  Specifies the level of blue color in the image.
 
:[in, defaultvalue(0)]  Specifies the level of blue color in the image.
;pRect
+
;stRect
 
:[in, defaultvalue(NULL)]  Pointer to RECT structure which defines the rectangular area where function should be applied. If this parameter is NULL, the entire page will be processed.
 
:[in, defaultvalue(NULL)]  Pointer to RECT structure which defines the rectangular area where 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 each pixel in such images does not contain a color, but an index into a color table (or 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 each pixel in such images does not contain a color, but an index into a color table (or palette) which is common for the entire page.}}

Latest revision as of 03:16, 15 June 2015

The ColorBalance method changes the overall mixture of colors in the image page for generalized color correction based on defined values for each of the valid channels available - Red, Green and Blue.

Syntax

HRESULT ColorBalance([in, defaultvalue(0)]     LONG   nRValue,
                     [in, defaultvalue(0)]     LONG   nGValue,
                     [in, defaultvalue(0)]     LONG   nBValue,
                     [in, defaultvalue(NULL)]  RECT*  stRect);

Parameters

nRValue
[in, defaultvalue(0)] Specifies the level of red color in the image.
nGValue
[in, defaultvalue(0)] Specifies the level of green color in the image.
nBValue
[in, defaultvalue(0)] Specifies the level of blue color in the image.
stRect
[in, defaultvalue(NULL)] Pointer to RECT structure which defines the rectangular area where 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 each pixel in such images does not contain a color, but an index into a color table (or palette) which is common for the entire page.

Return Value

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

See Also

IIXC_Page