Using the 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 DLLs, refer to Files To Be Included With Your Application. Imaging Common Dialogs are provided for numerous image processing, effects and filtering functions, and include the following features:

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.

Display Function Related Image Processing Function
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

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:

Dialog Function Function To Set Parameters Function To Get User Selections
LDialogColor
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
DoModalSmooth setsmoothparams getsmoothparams
DoModalLineRemove setlineremoveparams getlineremoveparams
DoModalBorderRemove setborderremoveparams getborderremoveparams
DoModalInvertedText setinvertedtextparams getinvertedtextparams
DoModalDotRemove setdotremoveparams getdotremoveparams
DoModalHolePunchRemove setholepunchremoveparams getholepunchremoveparams
LDialogFile
DoModalFileConversion setfileconversionparams getfileconversionparams
DoModalFilesAssociation setfilesassociationparams getfilesassociationparams
DoModalGetDirectory setdirectoryparams getdirectoryparams
DoModalOpen setopenparams getopenparams
DoModalPrintPreview setprintpreviewparams getprintpreviewparams
DoModalPrintStitchedImages setprintstitchedimagesparams getprintstitchedimagesparams
DoModalSave setsaveparams getsaveparams
LDialogEffect
DoModalGetEffect seteffectparams geteffectparams
DoModalGetGradient setgradientparams getgradientparams
DoModalGetShape setshapeparams getshapeparams
DoModalGetText settextparams gettextparams
DoModalGetTransition settransitionparams gettransitionparams
LDialogImage
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
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
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.

Supported Environments

The toolkit comes in Win32 and x64 editions. The environments supported depend upon the specific product, platform and function. For more information, refer to Supported Platforms / Operating Systems.

Help Version 22.0.2023.2.3
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Common Dialog C++ Class Library Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.