IIXC_Page::Histogramm Method

Revision as of 06:51, 12 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*  Red,
                   [in, out]  ULONG*  Green,
                   [in, out]  ULONG*  Blue,
                   [in, out]  ULONG*  Gray,
                   [in]       RECT*   Rect);

Parameters

Red

[in, out] Pointer to an array of ULONGs that receives the histogram for the red channel.

Green

[in, out] Pointer to an array of ULONGs that receives the histogram for the green channel.

Blue

[in, out] Pointer to an array of ULONGs that receives the histogram for the blue channel.

Gray

[in, out] Pointer to an array of ULONGs that receives the histogram for the gray channel.

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

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