IIXC_Page::Histogramm Method

From PDF XChange PDF SDK
Jump to: navigation, search
(Automatic page editing by robot)
 
m (Automatic page editing by robot)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
__NOTOC__
 
[[Category:Editor]]
 
[[Category:Editor]]
 
{{#customTitle:IIXC_Page::Histogramm Method}}
 
{{#customTitle:IIXC_Page::Histogramm Method}}
 +
{{#parentPage:PXV:IIXC_Page#Methods|Histogramm|method}}
  
The method of interface of PDF-XChange Editor SDK.
+
The '''Histogramm''' method returns histogram(s) for one or more color channels for the entire page or a selected rectangular area.
  
 
== Syntax ==
 
== Syntax ==
<pre class="brush:cpp;gutter:false">HRESULT Histogramm([in, out] ULONG* pRed, [in, out] ULONG* pGreen, [in, out] ULONG* pBlue, [in, out] ULONG* pGray, [in, optional] RECT* pRect);</pre>
+
<pre class="brush:cpp;gutter:false">HRESULT Histogramm([in, out] ULONG* nRed,
 +
                  [in, out] ULONG* nGreen,
 +
                  [in, out] ULONG* nBlue,
 +
                  [in, out] ULONG* nGray,
 +
                  [in]       RECT*   stRect);</pre>
  
 
== Parameters ==
 
== Parameters ==
;''pRed''
+
;nRed
:[in, out]  Pointer to ULONG.
+
:[in, out]  Pointer to an array of ULONGs that receives the histogram for the red channel.
;''pGreen''
+
;nGreen
:[in, out]  Pointer to ULONG.
+
:[in, out]  Pointer to an array of ULONGs that receives the histogram for the green channel.
;''pBlue''
+
;nBlue
:[in, out]  Pointer to ULONG.
+
:[in, out]  Pointer to an array of ULONGs that receives the histogram for the blue channel.
;''pGray''
+
;nGray
:[in, out]  Pointer to ULONG.
+
:[in, out]  Pointer to an array of ULONGs that receives the histogram for the gray channel.
;''pRect''
+
;stRect
:[in, optional]  Pointer to RECT.
+
:[in]  Pointer to RECT structure which defines the rectangular area for which color histograms will be calculated. If this parameter is NULL, the entire page will be used.
  
 
== Return Value ==
 
== Return Value ==
 
Returns S_OK if operation was successful or error code in other cases.
 
Returns S_OK if operation was successful or error code in other cases.
 +
 +
== Remarks ==
 +
All UINT arrays passed to the function must have at least 256 items. If one or more histograms isn't needed, the corresponding parameter can be set to NULL.
  
 
== See Also ==
 
== See Also ==
See also [[PXV:IIXC_Page|IIXC_Page]].
+
[[PXV:IIXC_Page|IIXC_Page]]

Latest revision as of 03:16, 15 June 2015

The Histogramm method returns histogram(s) for one or more color channels for the entire page or a selected rectangular area.

Syntax

HRESULT Histogramm([in, out]  ULONG*  nRed,
                   [in, out]  ULONG*  nGreen,
                   [in, out]  ULONG*  nBlue,
                   [in, out]  ULONG*  nGray,
                   [in]       RECT*   stRect);

Parameters

nRed
[in, out] Pointer to an array of ULONGs that receives the histogram for the red channel.
nGreen
[in, out] Pointer to an array of ULONGs that receives the histogram for the green channel.
nBlue
[in, out] Pointer to an array of ULONGs that receives the histogram for the blue channel.
nGray
[in, out] Pointer to an array of ULONGs that receives the histogram for the gray channel.
stRect
[in] Pointer to RECT structure which defines the rectangular area for which color histograms will be calculated. If this parameter is NULL, the entire page will be used.

Return Value

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

Remarks

All UINT arrays passed to the function must have at least 256 items. If one or more histograms isn't needed, the corresponding parameter can be set to NULL.

See Also

IIXC_Page