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.

image\sqrblit.gif 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 Main Class Library help file in the LEADTOOLS/HELP directory.

 

Artistic Effects

 

LDialogImageEffect::DoModalAddBitmaps

LBitmapBase::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

LDialogDocument::DoModalRemoveRedeye

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

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

DoModalRemoveRedEye

SetRemoveRedEyeParams

GetRemoveRedEyeParams

 

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.