IIXC_Page::ColorBalance Method

From PDF XChange PDF SDK
Jump to: navigation, search
m (Automatic page editing by robot)
 
(7 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
__NOTOC__
 
[[Category:Editor]]
 
[[Category:Editor]]
 
{{#customTitle:IIXC_Page::ColorBalance Method}}
 
{{#customTitle:IIXC_Page::ColorBalance Method}}
{{#parentPage:PXV:IIXC_Page|ColorBalance Method|method}}
+
{{#parentPage:PXV:IIXC_Page#Methods|ColorBalance|method}}
  
{{ToReview}}
+
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 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 ==
 
== Syntax ==
Line 11: 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 20: 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 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 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 ==
 
== Return Value ==
Line 28: Line 27:
  
 
== See Also ==
 
== See Also ==
:[[PXV:IIXC_Page|IIXC_Page]]
+
[[PXV:IIXC_Page|IIXC_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