描述
返回此位图对象的指定颜色通道的一个或多个直方图。
C++ 语法
GpStatus WINGDIPAPI GdipBitmapGetHistogram( GpBitmap* bitmap, IN HistogramFormat format, IN UINT NumberOfEntries, OUT UINT *channel0, OUT UINT *channel1, OUT UINT *channel2, OUT UINT *channel3 ); |
PowerBASIC 语法
FUNCTION GdipBitmapCreateApplyEffect ( _ BYVAL bitmap AS DWORD, _ BYVAL format AS LONG, _ BYVAL NumberOfEntries AS DWORD, _ BYREF channel0 AS DWORD, _ BYREF channel1 AS DWORD, _ BYREF channel2 AS DWORD, _ BYREF channel3 AS DWORD _ ) AS LONG |
参数
bitmap
[in]指向位图对象的指针的地址。
format
[in]HistogramFormat枚举的元素，用于指定要创建直方图的通道。
NumberOfEntries
[in]整数，它指定在channel0，channel1，channel2和channel3指向的每个数组中的元素数（UINT类型）。在调用GdipBitmapGetHistogram之前，必须为这些数组分配内存。要确定所需的元素数量，请调用GdipBitmapGetHistogramSize.
channel0
[out]指向RECT结构的指针，指定所使用的输入位图的部分。
channel1
[out]如果有第二个直方图，则指向接收第二个直方图的UINT数组的指针。如果没有第二个直方图，则传递NULL。
channel2
[out]如果有第三个直方图，则指向接收第三个直方图的UINT数组的指针。如果没有第三个直方图，则传递NULL。
channel3
[out]如果有第四个直方图，则指向接收第四个直方图的UINT数组的指针。如果没有第四个直方图，则传递NULL。
返回值
如果函数成功，它返回Ok，它是状态枚举的一个元素。
如果函数失败，它返回状态枚举的其他元素之一。
备注
返回的直方图的数量取决于传递给format参数的HistogramFormat枚举元素。例如，如果格式等于HistogramFormatRGB，则返回三个直方图：红色，绿色和蓝色通道各一个。在这种情况下，CHANNEL0指向接收红色通道直方图的数组，通道1指向接收绿色通道直方图的数组，通道2指向接收蓝色通道直方图的数组。对于HistogramFormatRGB，通道3必须设置为NULL，因为没有第四个直方图。有关详细信息，请参阅HistogramFormat枚举。
要求
GDI+ 1.1