All functions   Mac OS X   Windows   Crossplatform   Components   New in version: 1.0   1.1   1.2   1.3   1.4   1.5   1.6   1.7   1.8   2.0  

GMImage.LevelChannel

Component: GraphicsMagick
Mac OS X: Works
Windows: Works

MBS( "GMImage.LevelChannel"; ImageRef; ChannelType; blackPoint; whitePoint; midPoint )

Parameters

Parameter Description Example value
ImageRef The image reference (a number returned from the GMImage.New functions) 1
ChannelType One of the following values: RedChannel = 1 (RGB Red channel), CyanChannel = 2 (CMYK Cyan channel), GreenChannel = 3 (RGB Green channel), MagentaChannel = 4 (CMYK Magenta channel), BlueChannel = 5 (RGB Blue channel), YellowChannel = 6 (CMYK Yellow channel), OpacityChannel = 7 (Opacity channel), BlackChannel = 8 (CMYK Black (K) channel), MatteChannel = 9 (Same as Opacity channel (deprecated)), AllChannels = 10 (Color channels), GrayChannel = 11 (Color channels represent an intensity.) 1
blackPoint The black point. 0
whitePoint The white point. 1.0
midPoint Optional, the middle point. 1.0

Result

Returns "OK" on success.

Description

Level image. Adjust the levels of the image by scaling the colors falling between specified white and black points to the full available quantum range. The parameters provided represent the black, mid (gamma), and white points. The black point specifies the darkest color in the image. Colors darker than the black point are set to zero. Mid point (gamma) specifies a gamma correction to apply to the image. White point specifies the lightest color in the image. Colors brighter than the white point are set to the maximum quantum value. The black and white point have the valid range 0 to MaxRGB while mid (gamma) has a useful range of 0 to ten.

Feedback: Report problem or ask question.