Using Imaging Common Dialogs

The Imaging Common Dialog libraries provide a set of common dialog boxes that combine Windows Common Dialog functionality with imaging functionality contained in LEADTOOLS. For a list of required DLL's, refer to Files To Be Included With Your Application. Imaging Common Dialogs are provided for numerous image processing, effects and filtering functions.

Reusable dialogs for the most common LEADTOOLS imaging functions and effects are now provided.
A Thumbnail Preview option for the image processing dialogs allows the end user to preview the proposed change to the image, before actually affecting the original image.
An optional Help callback function lets you provide custom help information for each dialog.
A user interface control for the dialogs is provided through flags in the structure passed to each dialog function.
An option to have the Imaging Common Dialog process the image automatically is provided.

These dialogs provide input parameters needed for the several LEADTOOLS imaging functions. The table below gives the function that displays the dialog on the left and the image processing function associated with it on the right, if one exists. For more information on the Image Processing functions, refer to the LEADTOOLS Raster C++ Class Library help file in the LEADTOOLS/HELP directory.

Artistic Effects
LDialogImageEffect::DoModalAddBitmaps	LBitmap::Add
LDialogImage::DoModalAddBorder	LBitmap::AddBorder
LDialogImage::DoModalAddFrame	LBitmap::AddFrame
LDialogImageEffect::DoModalAddNoise	LBitmap::AddNoise
LDialogImageEffect::DoModalBending	LBitmap::Bending
LDialogImageEffect::DoModalCylindrical	LBitmap::Cylindrical
LDialogImageEffect::DoModalFreeHandWave	LBitmap::FreeHandWave
LDialogImageEffect::DoModalImpressionist	LBitmap::Impressionist
LDialogImageEffect::DoModalMosaic	LBitmap::Mosaic
LDialogImageEffect::DoModalMotionBlur	LBitmap::MotionBlur
LDialogImageEffect::DoModalOilify	LBitmap::Oilify
LDialogImageEffect::DoModalPicturize	LBitmap::Picturize
LDialogImageEffect::DoModalPixelate	LBitmap::Pixelate
LDialogImageEffect::DoModalPolar	LBitmap::Polar
LDialogColor::DoModalPosterize	LBitmap::Posterize
LDialogImageEffect::DoModalPunch	LBitmap::Punch
LDialogImageEffect::DoModalRadialBlur	LBitmap::RadialBlur
LDialogImageEffect::DoModalRadialWave	LBitmap::RadWave
	LBitmap::RemoveRedEye
LDialogImageEffect::DoModalRipple	LBitmap::Ripple
LDialogColor::DoModalSolarize	LBitmap::Solarize
LDialogImageEffect::DoModalSpherize	LBitmap::Spherize
LDialogImageEffect::DoModalStitch
LDialogImageEffect::DoModalSwirl	LBitmap::Swirl
LDialogImageEffect::DoModalUnderlay	LBitmapBase::Underlay
LDialogImageEffect::DoModalWave	LBitmap::Wave
LDialogImageEffect::DoModalWaveShear	LBitmap::FreeHandShear
LDialogImageEffect::DoModalWind	LBitmap::Wind
LDialogImageEffect::DoModalZoomBlur	LBitmap::ZoomBlur
LDialogImageEffect::DoModalZoomWave	LBitmap::ZoomWave

Color Manipulation
LDialogColor::DoModalBalanceColors	LBitmap::BalanceColors
LDialogColor::DoModalBrightness	LBitmap::ChangeIntensity
LDialogColor::DoModalColor
LDialogColor::DoModalColoredGray	LBitmap::ConvertToColoredGray
LDialogColor::DoModalColorRes	LBitmapBase::ColorRes
LDialogColor::DoModalContrast	LBitmap::ChangeContrast
LDialogColor::DoModalCustomizePalette
LDialogColor::DoModalGammaAdjustment
LDialogColor::DoModalGrayScale	LBitmapBase::GrayScale
LDialogColor::DoModalHalftone	LBitmap::HalfTone
LDialogColor::DoModalHistoContrast	LBitmap::HistoContrast
LDialogImage::DoModalHistogram
LDialogColor::DoModalHue	LBitmap::ChangeHue
LDialogColor::DoModalIntensityDetect	LBitmap::IntensityDetect
LDialogColor::DoModalLocalHistoEqualize	LBitmap::LocalHistoEqualize
LDialogImageEffect::DoModalMultiply	LBitmap::Multiply
LDialogColor::DoModalRemapHue	LBitmap::RemapHue
LDialogColor::DoModalRemapIntensity	LBitmap::RemapIntensity
LDialogColor::DoModalSaturation	LBitmap::ChangeSaturation

Converting Files
LDialogFile::DoModalFileConversion
Document Clean up
LDialogDocument::DoModalBorderRemove	LBitmap::BorderRemove
LDialogDocument::DoModalDotRemove	LBitmap::DotRemove
LDialogDocument::DoModalHolePunchRemove	LBitmap::HolePunchRemove
LDialogDocument::DoModalInvertedText	LBitmap::InvertedText
LDialogDocument::DoModalLineRemove	LBitmap::LineRemove
LDialogDocument::DoModalSmooth	LBitmap::Smooth

Filtering
LDialogImageEffect::DoModalContourFilter	LBitmap::ContourFilter
LDialogImageEffect::DoModalDilationFilter	LBitmap::BinaryFilter
LDialogImageEffect::DoModalEdgeDetector	LBitmap::EdgeDetector
LDialogImageEffect::DoModalEmboss	LBitmap::Emboss
LDialogImageEffect::DoModalErosionFilter	LBitmap::BinaryFilter
LDialogImageEffect::DoModalGradientFilter	LBitmap::SpatialFilter
LDialogImageEffect::DoModalLaplacianFilter	LBitmap::SpatialFilter
LDialogImageEffect::DoModalLineSegmentFilter	LBitmap::SpatialFilter
LDialogImageEffect::DoModalMaxFilter	LBitmap::MaxFilter
LDialogImageEffect::DoModalMinFilter	LBitmap::MinFilter
LDialogImageEffect::DoModalPrewittFilter	LBitmap::SpatialFilter
LDialogImageEffect::DoModalShiftDifferenceFilter	LBitmap::SpatialFilter
LDialogImageEffect::DoModalSobelFilter	LBitmap::SpatialFilter

Geometric Transformations
LDialogImage::DoModalAutoTrim	LBitmap::AutoTrim
LDialogImage::DoModalCanvasResize
LDialogImage::DoModalResize
LDialogImage::DoModalRotate	LBitmapBase::Rotate
LDialogImage::DoModalShear	LBitmapBase::Shear

HTML/Web
LDialogWeb::DoModalHTMLMapper
LDialogWeb::DoModalGIFWebTuner	LBitmapBase::ColorRes , LBitmapBase::Fill , LBitmapBase::Save
LDialogWeb::DoModalJPEGWebTuner	LBitmapBase::Save
LDialogWeb::DoModalPNGWebTuner	LBitmapBase::ColorRes , LBitmapBase::Fill , LBitmapBase::Save

Printing
LDialogFile::DoModalPrintPreview
LDialogFile::DoModalPrintStitchedImages

Sharpening or Blurring an Image
LDialogImageEffect::DoModalAntiAlias	LBitmap::AntiAlias
LDialogImageEffect::DoModalAverage	LBitmap::AverageFilter
LDialogImageEffect::DoModalGaussianBlur	LBitmap::GaussianFilter
LDialogImageEffect::DoModalMedian	LBitmap::MedianFilter
LDialogImageEffect::DoModalSharpen	LBitmap::Sharpen
LDialogImageEffect::DoModalUnsharpMask	LBitmap::UnsharpMask

Special Effects
LDialogEffect::DoModalGetEffect	LPaintEffect::PaintBitmap
LDialogEffect::DoModalGetGradient	LPaintEffect::DrawGradient
LDialogEffect::DoModalGetShape	LPaintEffect::Draw3dShape
LDialogEffect::DoModalGetText	LPaintEffect::Draw3dText
LDialogEffect::DoModalGetTransition	LPaintEffect::PaintTransition

In addition to the dialog functions provided for image processing, LEADTOOLS also provides Imaging Common Dialog functions for general use and dialog maintenance. These are given below.

Dialog Maintenance and General Use

LDialogBase::EnableGdiPlus

LDialogFile::DoModalFilesAssociation

LDialogBase::Free

LDialogFile::DoModalGetDirectory

LDialogBase::GetString

LDialogBase::GetStringLen

LDialogBase::Initialize

LDialogFile::DoModalOpen

LDialogFile::DoModalSave

LDialogBase::SetFont

LDialogBase::SetString

LDialogBase::IsAutoProcessEnabled

LDialogBase::IsPreviewEnabled

LDialogBase::IsToolbarEnabled

LDialogBase::DialogHelpCallBack

LDialogBase::EnableAutoProcess

LDialogBase::EnablePreview

LDialogBase::EnableToolbar

Each of the XXXDoModalXXX functions listed above displays a dialog through which the user can enter parameters for various image processing or other functions. These dialogs may be initialized prior to calling the XXXDoModalXXX function by calling a corresponding GetXXXParams function. Likewise, once the user has made his or her selections in the dialog, those new values can be retrieved using a corresponding SetXXXParams function. The table below lists the corresponding GetXXXParams and SetXXXParams function for each DoModalXXX function listed above:

LDialogColor:

Dialog Function	Function To Set Parameters	Function To Get User Selections
DoModalBalanceColors	SetBalanceColorsParams	GetBalanceColorsParams
DoModalBrightness	SetBrightnessParams	GetBrightnessParams
DoModalColor	SetColorParams	GetColorParams
DoModalColoredGray	SetColoredGrayParams	GetColoredGrayParams
DoModalColorRes	SetColorResParams	GetColorResParams
DoModalContrast	SetContrastParams	GetContrastParams
DoModalCustomizePalette	SetCustomizePaletteParams	GetCustomizePaletteParams
DoModalGammaAdjustment	SetGammaAdjustmentParams	GetGammaAdjustmentParams
DoModalGrayScale	SetGrayScaleParams	GetGrayScaleParams
DoModalHalfTone	SetHalfToneParams	GetHalfToneParams
DoModalHistoContrast	SetHistoContrastParams	GetHistoContrastParams
DoModalHue	SetHueParams	GetHueParams
DoModalIntensityDetect	SetIntensityDetectParams	GetIntensityDetectParams
DoModalLocalHistoEqualize	SetLocalHistoEqualizeParams	GetLocalHistoEqualizeParams
DoModalPosterize	SetPosterizeParams	GetPosterizeParams
DoModalRemapHue	SetRemapHueParams	GetRemapHueParams
DoModalRemapIntensity	SetRemapIntensityParams	GetRemapIntensityParams
DoModalSaturation	SetSaturationParams	GetSaturationParams
DoModalSolarize	SetSolarizeParams	GetSolarizeParams

LDialogDocument:

Dialog Function	Function To Set Parameters	Function To Get User Selections
DoModalSmooth	SetSmoothParams	GetSmoothParams
DoModalLineRemove	SetLineRemoveParams	GetLineRemoveParams
DoModalBorderRemove	SetBorderRemoveParams	GetBorderRemoveParams
DoModalInvertedText	SetInvertedTextParams	GetInvertedTextParams
DoModalDotRemove	SetDotRemoveParams	GetDotRemoveParams
DoModalHolePunchRemove	SetHolePunchRemoveParams	GetHolePunchRemoveParams

LDialogFile:

Dialog Function	Function To Set Parameters	Function To Get User Selections
DoModalFileConversion	SetFileConversionParams	GetFileConversionParams
DoModalFilesAssociation	SetFilesAssociationParams	GetFilesAssociationParams
DoModalGetDirectory	SetDirectoryParams	GetDirectoryParams
DoModalOpen	SetOpenParams	GetOpenParams
DoModalPrintPreview	SetPrintPreviewParams	GetPrintPreviewParams
DoModalPrintStitchedImages	SetPrintStitchedImagesParams	GetPrintStitchedImagesParams
DoModalSave	SetSaveParams	GetSaveParams

LDialogEffect:

Dialog Function	Function To Set Parameters	Function To Get User Selections
DoModalGetEffect	SetEffectParams	GetEffectParams
DoModalGetGradient	SetGradientParams	GetGradientParams
DoModalGetShape	SetShapeParams	GetShapeParams
DoModalGetText	SetTextParams	GetTextParams
DoModalGetTransition	SetTransitionParams	GetTransitionParams

LDialogImage:

Dialog Function	Function To Set Parameters	Function To Get User Selections
DoModalAddBorder	SetAddBorderParams	GetAddBorderParams
DoModalAddFrame	SetAddFrameParams	GetAddFrameParams
DoModalAutoTrim	SetAutoTrimParams	GetAutoTrimParams
DoModalCanvasResize	SetCanvasResizeParams	GetCanvasResizeParams
DoModalHistogram	SetHistogramParams	GetHistogramParams
DoModalResize	SetResizeParams	GetResizeParams
DoModalRotate	SetRotateParams	GetRotateParams
DoModalShear	SetShearParams	GetShearParams

LDialogImageEffect:

Dialog Function	Function To Set Parameters	Function To Get User Selections
DoModalAddBitmaps	SetAddBitmapsParams	GetAddBitmapsParams
DoModalAddNoise	SetAddNoiseParams	GetAddNoiseParams
DoModalAntiAlias	SetAntiAliasParams	GetAntiAliasParams
DoModalAverage	SetAverageParams	GetAverageParams
DoModalBending	SetBendingParams	GetBendingParams
DoModalContourFilter	SetContourFilterParams	GetContourFilterParams
DoModalCylindrical	SetCylindricalParams	GetCylindricalParams
DoModalDilationFilter	SetDilationFilterParams	GetDilationFilterParams
DoModalEdgeDetector	SetEdgeDetectorParams	GetEdgeDetectorParams
DoModalEmboss	SetEmbossParams	GetEmbossParams
DoModalErosionFilter	SetErosionFilterParams	GetErosionFilterParams
DoModalFreeHandWave	SetFreeHandWaveParams	GetFreeHandWaveParams
DoModalGaussianBlur	SetGaussianBlurParams	GetGaussianBlurParams
DoModalGradientFilter	SetGradientFilterParams	GetGradientFilterParams
DoModalImpressionist	SetImpressionistParams	GetImpressionistParams
DoModalLaplacianFilter	SetLaplacianFilterParams	GetLaplacianFilterParams
DoModalLineSegmentFilter	SetLineSegmentFilterParams	GetLineSegmentFilterParams
DoModalMaxFilter	SetMaxFilterParams	GetMaxFilterParams
DoModalMedian	SetMedianParams	GetMedianParams
DoModalMinFilter	SetMinFilterParams	GetMinFilterParams
DoModalMosaic	SetMosaicParams	GetMosaicParams
DoModalMotionBlur	SetMotionBlurParams	GetMotionBlurParams
DoModalMultiply	SetMultiplyParams	GetMultiplyParams
DoModalOilify	SetOilifyParams	GetOilifyParams
DoModalPicturize	SetPicturizeParams	GetPicturizeParams
DoModalPixelate	SetPixelateParams	GetPixelateParams
DoModalPolar	SetPolarParams	GetPolarParams
DoModalPrewittFilter	SetPrewittFilterParams	GetPrewittFilterParams
DoModalPunch	SetPunchParams	GetPunchParams
DoModalRadialBlur	SetRadialBlurParams	GetRadialBlurParams
DoModalRadialWave	SetRadialWaveParams	GetRadialWaveParams
DoModalRipple	SetRippleParams	GetRippleParams
DoModalSharpen	SetSharpenParams	GetSharpenParams
DoModalShiftDifferenceFilter	SetShiftDifferenceFilterParams	GetShiftDifferenceFilterParams
DoModalSobelFilter	SetSobelFilterParams	GetSobelFilterParams
DoModalSpherize	SetSpherizeParams	GetSpherizeParams
DoModalStitch	SetStitchParams	GetStitchParams
DoModalSwirl	SetSwirlParams	GetSwirlParams
DoModalUnderlay	SetUnderlayParams	GetUnderlayParams
DoModalUnsharpMask	SetUnsharpMaskParams	GetUnsharpMaskParams
DoModalWave	SetWaveParams	GetWaveParams
DoModalWaveShear	SetWaveShearParams	GetWaveShearParams
DoModalWind	SetWindParams	GetWindParams
DoModalZoomBlur	SetZoomBlurParams	GetZoomBlurParams
DoModalZoomWave	SetZoomWaveParams	GetZoomWaveParams

LDialogWeb:

Dialog Function	Function To Set Parameters	Function To Get User Selections
DoModalGIFWebTuner	SetGIFWebTunerParams	GetGIFWebTunerParams
DoModalHTMLMapper	SetHTMLMapperParams	GetHTMLMapperParams
DoModalJPEGWebTuner	SetJPEGWebTunerParams	GetJPEGWebTunerParams
DoModalPNGWebTuner	SetPNGWebTunerParams	GetPNGWebTunerParams

Implementing help for LEADTOOLS dialogs is achieved by setting a pointer to a help callback function in the structure passed to all functions in LDialogXXX classes. The callback function will be called to provide the appropriate help for the corresponding dialog if the user clicks on the Help Button. For more information concerning implementing the help callback function, refer to LDialogBase::DialogHelpCallBack Callback Function.