ShowIPContrastDlg Method

Description:

Shows the Image Processing: Brightness, Contrast and Gamma dialog. The Image Processing: Brightness, Contrast and Gamma dialog is as follows:

The sliders and drop-down list on the left side of the dialog are used to set the brightness, contrast and gamma-correction parameters for the image. The settings can be applied to a single (red, green or blue) channel, or to all 3 channels, simultaneously. The graph at the top of the dialog shows the intensity transform function as defined by the brightness, contrast and gamma-correction settings.

Note that there is no "undo" capability in this dialog: if the end-user clicks "OK" or "Apply", then the image referenced by thePageDisplay is modified. If your application needs to provide an "undo" capability, then you should make a copy of the IGPage Object associated with thePageDisplay before calling ShowIPContrastDlg. Then, if the end-user decides to "undo" the action, your program can simply replace the modified IGPage Object with the unmodified copy.

The user can click the "Preview Changes" checkbox to see the effect of the settings on the image in the preview area (they can leave the checkbox un-checked if the image is particularly large and therefore takes a long time to render).

Clicking the "OK" button will apply the settings to the image referenced by thePageDisplay, and then close the dialog. Note that you must specify the hWnd parameter in order for the end-user to see any changes to thePageDisplay image when they click "OK".

Clicking the "Apply" button will apply the settings to the image referenced by thePageDisplay, but leave the dialog on the screen - the preview will be redisplayed, showing the image with its new settings. Note that you must specify the hWnd parameter in order for the end-user to see any changes to thePageDisplay image when they click "Apply".

Clicking the "Cancel" button will close the dialog without making any changes.

Syntax:

      ShowIPContrastDlg (thePageDisplay As IGPageDisplay, hWnd As
Long)

Parameters:

Name	Description
thePageDisplay	Provide the IGPageDisplay Object that your program is using to handle display functions for your image.
hWnd	If your image is presented via IGPageViewCtl Control, then specify IGPageViewCtln.hWnd.

Return Value:

None

Bits Per Pixel:

N/A

Sample:

ig_guidlg.vb6.exe