Marblecore Imaging Library Documentation

Documentation Introduction

Welcome to the Marblecore Imaging documentation pages

Marblecore Imaging is a powerfull and easy to use fully packed imaging processing library with integral and thorough 32-bit alpha channel transparency support. It handles all popular image formats (like PNG, JPEG, GIF, BMP and more), supports lots of high quality effects, has all necessary drawing functions, supplies tons of professional filters, delivers great color transformations, supports masking and histogram functionality and much, much more. Best of all it has full 32-bit alpha transparency support throughout the whole library. Finally a library which handles alpha transparency as it should be, just like those professional desktop image editing software.

It can be used in all popular programming languages and comes in two implementation flavors. A Class Library to use the library in .NET enabled languages (like C# and Visual Basic) and an ATL COM object to use the component in scripting languages like ASP, JScript, VBScript and CScript (Windows Script Host). Take a look at the getting started section for a quick guide on how to implement and use the component.

To start using Marblecore Imaging right away, go to the download page and download the full featured library. To obtain a license for professional use, see the buy page. If you already applied for a license read the getting started page for more information on how to use. Below is a summary of all available methods and properties grouped on similarity. Click on a method or property to view more information and in most cases an example image of the output.

Getting started

Getting started with the Class Library | Getting started with the ATL/COM | Getting started with licenses | Working with streams

Basic operations (14)

NameTypeDescription
CreateMethodCreates a new image with the specified width and height. By default a new 32-bit image will be created which supports alpha transparency. You can disable transparency to create a 24-bit image. When you want to save a 32-bit image to a format which not supports 32-bit images (like JPEG or GIF) the library will automatically convert your image to a 24-bit image. The specified background color will be used for the conversion.
DeserializeMethodDeserializes a memory stream to the bitmap. If no image is currently loaded, a new image is created. You have to supply a stream which is created using the Serialize method. If you want to load a normal image from a stream, use the LoadFromStream method instead.
LoadFromBase64MethodLoads an image from a base64 encoded string. To see a list of supported file formats see the Format enumeration.
LoadFromFileMethodLoads the specified image file in memory. You need to specify the full path to the image. To see a list of supported file formats see the Format enumeration.
LoadFromSerializedStreamMethodLoads an image from a serialized memory stream. You have to supply a stream which is created using the Serialize method.
LoadFromStreamMethodLoads an image from a normal memory stream. To see a list of supported file formats see the Format enumeration.
LoadFromURLMethodLoads an image file from the specified URL in memory. To see a list of supported file formats see the Format enumeration.
ResetMethodRestores the object to the inital state.
SaveToBase64MethodSaves the current image (in the specified format) and returns the binary image data as a string encoded using the base64 encoding scheme. This method can be used to embed images directly in HTML web pages.
SaveToFileMethodSaves the current working image to a file using the specified path. If no path is specified and the LoadFile method is used to load the current image, the image is saved to its original path.
SaveToHBitmapMethodReturns a HBITMAP for the current image which can be used to draw the image with high speed to a canvas like a Windows Form. This method is not available in the ATL version of the image component.
SaveToHBitmapPreMultipliedMethodReturns a HBITMAP for the current image where the RGB values are pre multiplied. Use this method to draw the image with high speed to a canvas like a Windows Form. This method is not available in the ATL version of the image component.
SaveToStreamMethodSaves the current image (in the specified format) and returns the stream. The stream data contains all binary information which is normally saved to a physic file when you save the image to a file using the SaveToFile method. You can use the stream to save the image to a file using your own custom function. You can also use the stream to transfer image objects within your application, so you don't have to save the image to (temporary) files. If you just want to transfer image data from one image object to another image object, use the Serialize, Deserialize and LoadFromSerializedStream functions. Those methods give better performance for internal image data transfers.
SerializeMethodSerializes the current bitmap to a memory stream. This stream is a binary representation of the image object. You can use this function to transfer images from an image object to another image object. The stream cannot be used to save an image to a file, because the stream does not contain a valid image format like JPEG, PNG or BMP. If you want to do that, use the SaveToStream method instead.

Captcha (2)

NameTypeDescription
CaptchaCreateMethodCreates a captcha for the specified captcha phrase. The image canvas will be cleared and replaced by the captcha. You can call this function directly without opening or creating an image first.
CaptchaPhraseMethodCreates a new captcha phrase with the specified string length.

Color adjustments (10)

NameTypeDescription
AdjustBrightnessMethodAdjusts the brightness of the image by a certain amount.
AdjustColorBalanceMethodAdjust the RGB channels of the image.
AdjustColorLevelMethodAdjust the color level of the selected channel of the image.
AdjustContrastMethodAdjusts the contrast of the image by a certain amount.
AdjustGammaMethodPerforms gamma correction on the image by a certain amount.
AdjustHueMethodAdjusts the hue of the image by a certain amount.
AdjustHueSaturationMethodAdjusts the hue and/or saturation of the image by a certain amount.
AdjustLightnessMethodAdjusts the hue of the image by a certain amount.
AdjustRGBMethodAdjust the RGB channels of the image.
AdjustSaturationMethodAdjusts the saturation of the image by a certain amount.

Color conversion (3)

NameTypeDescription
GetColorFromCMYKMethodReturns the RGB color identifier based on the CMYK color components. Please be aware that no color profile is used for this conversion.
GetColorFromHTMLMethodReturns the RGB color identifier for the given HTML color.
GetColorFromRGBMethodReturns the RGB color identifier based on the red, green and blue component.

Color transformations (13)

NameTypeDescription
AutoColorEnhanceMethodAutomatically enhances the colors of the image.
AutoColorLevelMethodAutomatically adjust the color level of the image.
AutoContrastMethodAutomatically adjust the contrast of the image.
ChannelMethodRetrieves a specific channel of the image.
ColorOverlayMethodApplies a color overlay on the image.
ColorToneMethodApplies a color tone effect to the image.
DesaturateMethodDesaturates the image.
DitherMethodConverts the image to a 1-bit monochrome image using the Floyd-Steinberg error diffusion algorithm.
GrayscaleMethodConverts the image to grayscale by removing all color information.
InvertMethodInverts all pixel data in the current image.
RedEyeCorrectionMethodRemoves red eyes from the image.
SepiaMethodApplies a sepia effect to the image.
TintMethodApplies a tint effect to the image.

Drawing (44)

NameTypeDescription
DrawArcMethodDraws an arc on the specified position with the specified width and height on the image using the specified color, style and opacity.
DrawArrowMethodDraws a line with a begin and/or end cap on the image using the specified color, line width, line style and opacity.
DrawBackgroundMethodDraws a background behind a transparent image.
DrawBezierMethodDraws a Bézier spline on the specified position on the image using the specified color, style and opacity.
DrawCheckerboardMethodDraws a checkboard background. The checkerboard is drawed on the background of the image. So the source image is layered over the checkerboard background.
DrawCurveMethodDraws a filled cardinal spline curve with border on the specified position on the image using the specified color, style and opacity.
DrawCurveBorderMethodDraws a cardinal spline curve border on the specified position on the image using the specified color, style and opacity.
DrawCurveFilledMethodDraws a filled cardinal spline curve on the specified position on the image using the specified color, style and opacity.
DrawCurveGradientMethodDraws a gradient filled cardinal spline curve on the specified position on the image using the specified color, style and opacity.
DrawEllipseMethodDraws a filled ellipse frame on the specified position with the specified width and height on the image using the specified color, style and opacity.
DrawEllipseBorderMethodDraws an ellipse frame on the specified position with the specified width and height on the image using the specified color, style and opacity.
DrawEllipseFilledMethodDraws a filled ellipse on the specified position with the specified width and height.
DrawEllipseGradientMethodDraws a gradient filled ellipse on the specified position with the specified width and height.
DrawFloodFillMethodFills a region on the current image canvas with a specific color beginning on the specified position.
DrawLineMethodDraws a line on the image using the specified color, line width, line style and opacity.
DrawPieMethodDraws a filled pie frame on the specified position with the specified width and height on the image using the specified color, style and opacity.
DrawPieBorderMethodDraws a pie frame on the specified position with the specified width and height on the image using the specified color, style and opacity.
DrawPieFilledMethodDraws a filled pie on the specified position with the specified width and height.
DrawPieGradientMethodDraws a gradient filled pie on the specified position with the specified width and height.
DrawPixelMethodDraws a pixel on the specified position on the image using the specified color and opacity and using interpolation.
DrawPolygonMethodDraws a filled polygon with border on the specified position on the image using the specified color, style and opacity.
DrawPolygonBorderMethodDraws a polygon border on the specified position on the image using the specified color, style and opacity.
DrawPolygonFilledMethodDraws a filled polygon on the specified position on the image using the specified color, style and opacity.
DrawPolygonGradientMethodDraws a gradient filled polygon on the specified position on the image using the specified color, style and opacity.
DrawRectangleMethodDraws a filled rectangle frame on the specified position with the specified width and height on the image using the specified color, style and opacity.
DrawRectangleBorderMethodDraws a rectangle frame on the specified position with the specified width and height on the image using the specified color, style and opacity.
DrawRectangleFilledMethodDraws a filled rectangle on the specified position with the specified width and height.
DrawRectangleGradientMethodDraws a gradient filled rectangle on the specified position with the specified width and height.
DrawRectangleTransparentMethodDraws a gradient filled rectangle on the specified position with the specified width and height.
DrawRhombusMethodDraws a filled rhombus frame on the specified position with the specified width and height on the image using the specified color, style and opacity.
DrawRhombusBorderMethodDraws a rhombus frame on the specified position with the specified width and height on the image using the specified color, style and opacity.
DrawRhombusFilledMethodDraws a filled rhombus on the specified position with the specified width and height.
DrawRhombusGradientMethodDraws a gradient filled rhombus on the specified position with the specified width and height.
DrawRoundRectangleMethodDraws a filled round rectangle frame on the specified position with the specified width and height on the image using the specified color, style and opacity.
DrawRoundRectangleBorderMethodDraws a round rectangle frame on the specified position with the specified width and height on the image using the specified color, style and opacity.
DrawRoundRectangleFilledMethodDraws a filled round rectangle on the specified position with the specified width and height.
DrawRoundRectangleGradientMethodDraws a gradient filled round rectangle on the specified position with the specified width and height.
DrawTriangleMethodDraws a filled triangle frame on the specified position with the specified width and height on the image using the specified color, style and opacity.
DrawTriangleBorderMethodDraws a triangle frame on the specified position with the specified width and height on the image using the specified color, style and opacity.
DrawTriangleFilledMethodDraws a filled triangle on the specified position with the specified width and height.
DrawTriangleGradientMethodDraws a gradient filled triangle on the specified position with the specified width and height.
GetPixelColorMethodRetrieves the pixel value of the specified pixel.
LineToMethodDraws a line from the current cursor position to the given left and top position. After drawing the line, the current cursor position is updated to the coordinate specified by nLeft and nTop.
MoveToMethodMoves the current cursor position.

Effects (9)

NameTypeDescription
EffectBorderMethodDraws a border around the image. The border is always a rectangle around the image.
EffectButtonMethodApplies a button effect on the image.
EffectColorOverlayMethodApplies a color overlay on the image.
EffectInnerBevelMethodApplies an inner bevel effect on the image.
EffectInnerGlowMethodCreates an inner glow on the image canvas.
EffectMaskMethodCreates a mask of the image.
EffectOuterGlowMethodCreates an outer glow behind the image canvas.
EffectShadowMethodCreates a shadow behind the image canvas.
EffectSoftenBorderMethodSoftens the borders of the image.

EXIF properties (72)

NameTypeDescription
GetExifMethodReturns the EXIF value for the specified tag (if available).
GetExifCameraMakerFromFileMethodRetrieves the maker of the camera which was used for creating the specified file.
GetExifCameraModelFromFileMethodRetrieves the model of the camera which was used for creating the specified file.
GetExifCompressedBitsPerPixelFromFileMethodRetrieves the compressed bits per pixel from the specified file.
GetExifCompressionFromFileMethodRetrieves the compression of the image.
GetExifCopyrightFromFileMethodRetrieves the copyright tag from the specified file.
GetExifDateTakenFromFileMethodRetrieves the date and time from the specified file.
GetExifExposureBiasFromFileMethodRetrieves the exposure bias value of the specified file.
GetExifExposureTimeFromFileMethodRetrieves the exposure time of the specified file.
GetExifFlashEnergyFromFileMethodRetrieves the flash energy of the specified file.
GetExifFlashModeFromFileMethodRetrieves the flash mode of the specified file.
GetExifFocalLengthFromFileMethodRetrieves the focal length of the specified file.
GetExifFromFileMethodReturns the EXIF value for the specified tag (if available) from the specified file.
GetExifFromInfoMethodReturns the EXIF value for the file analyzed with GetInfoFromFile.
GetExifFStopFromFileMethodRetrieves the f-stop value of the specified file.
GetExifHorizontalResolutionFromFileMethodRetrieves the horizontal resolution from the specified file.
GetExifISOSpeedFromFileMethodRetrieves the ISO speed of the specified file.
GetExifLightSourceFromFileMethodRetrieves the light source of the specified file.
GetExifMaxApertureFromFileMethodRetrieves the max aperture of the specified file.
GetExifMeteringModeFromFileMethodRetrieves the metering mode of the specified file.
GetExifOrientationFromFileMethodRetrieves the orientation of the specified file.
GetExifProgramModeFromFileMethodRetrieves the program mode of the specified file.
GetExifResolutionUnitFromFileMethodRetrieves the resolution unit from the specified file.
GetExifSubjectDistanceFromFileMethodRetrieves the subject distance of the specified file.
GetExifVersionFromFileMethodRetrieves the exif version of the specified file.
GetExifVerticalResolutionFromFileMethodRetrieves the vertical resolution from the specified file.
ExifCameraMakerProperty (readonly)Retrieves the maker of the camera which was used for creating the image.
ExifCameraMakerFromInfoProperty (readonly)Retrieves the maker of the camera which was used for creating the file analyzed with GetInfoFromFile.
ExifCameraModelProperty (readonly)Retrieves the model of the camera which was used for creating the image.
ExifCameraModelFromInfoProperty (readonly)Retrieves the model of the camera which was used for creating the file analyzed with GetInfoFromFile.
ExifCompressedBitsPerPixelProperty (readonly)Retrieves the compressed bits per pixel from the image.
ExifCompressedBitsPerPixelFromInfoProperty (readonly)Retrieves the compressed bits per pixel from the file analyzed with GetInfoFromFile.
ExifCompressionProperty (readonly)Retrieves the compression of the image.
ExifCompressionFromInfoProperty (readonly)Retrieves the compression of the file analyzed with GetInfoFromFile.
ExifCopyrightProperty (readonly)Retrieves the copyright tag from the image.
ExifCopyrightFromInfoProperty (readonly)Retrieves the copyright tag from the file analyzed with GetInfoFromFile.
ExifDateTakenProperty (readonly)Retrieves the date and time from the image.
ExifDateTakenFromInfoProperty (readonly)Retrieves the date and time from the file analyzed with GetInfoFromFile.
ExifExposureBiasProperty (readonly)Retrieves the exposure bias value of the image.
ExifExposureBiasFromInfoProperty (readonly)Retrieves the exposure bias value of the file analyzed with GetInfoFromFile.
ExifExposureTimeProperty (readonly)Retrieves the exposure time of the image.
ExifExposureTimeFromInfoProperty (readonly)Retrieves the exposure time of the file analyzed with GetInfoFromFile.
ExifFlashEnergyProperty (readonly)Retrieves the flash energy of the image.
ExifFlashEnergyFromInfoProperty (readonly)Retrieves the flash energy of the file analyzed with GetInfoFromFile.
ExifFlashModeProperty (readonly)Retrieves the flash mode of the image.
ExifFlashModeFromInfoProperty (readonly)Retrieves the flash mode of the file analyzed with GetInfoFromFile.
ExifFocalLengthProperty (readonly)Retrieves the focal length of the image.
ExifFocalLengthFromInfoProperty (readonly)Retrieves the focal length of the file analyzed with GetInfoFromFile.
ExifFStopProperty (readonly)Retrieves the f-stop value of the image.
ExifFStopFromInfoProperty (readonly)Retrieves the f-stop value of the file analyzed with GetInfoFromFile.
ExifHorizontalResolutionProperty (readonly)Retrieves the horizontal resolution from the image.
ExifHorizontalResolutionFromInfoProperty (readonly)Retrieves the horizontal resolution from the file analyzed with GetInfoFromFile.
ExifISOSpeedProperty (readonly)Retrieves the ISO speed of the image.
ExifISOSpeedFromInfoProperty (readonly)Retrieves the ISO speed of the file analyzed with GetInfoFromFile.
ExifLightSourceProperty (readonly)Retrieves the light source of the image.
ExifLightSourceFromInfoProperty (readonly)Retrieves the light source of the file analyzed with GetInfoFromFile.
ExifMaxApertureProperty (readonly)Retrieves the max aperture of the image.
ExifMaxApertureFromInfoProperty (readonly)Retrieves the max aperture of the file analyzed with GetInfoFromFile.
ExifMeteringModeProperty (readonly)Retrieves the metering mode of the image.
ExifMeteringModeFromInfoProperty (readonly)Retrieves the metering mode of the file analyzed with GetInfoFromFile.
ExifOrientationProperty (readonly)Retrieves the orientation of the image.
ExifOrientationFromInfoProperty (readonly)Retrieves the orientation of the file analyzed with GetInfoFromFile.
ExifProgramModeProperty (readonly)Retrieves the program mode of the image.
ExifProgramModeFromInfoProperty (readonly)Retrieves the program mode of the file analyzed with GetInfoFromFile.
ExifResolutionUnitProperty (readonly)Retrieves the resolution unit from the image.
ExifResolutionUnitFromInfoProperty (readonly)Retrieves the resolution unit from the file analyzed with GetInfoFromFile.
ExifSubjectDistanceProperty (readonly)Retrieves the subject distance of the image.
ExifSubjectDistanceFromInfoProperty (readonly)Retrieves the subject distance of the file analyzed with GetInfoFromFile.
ExifVersionProperty (readonly)Retrieves the exif version of the image.
ExifVersionFromInfoProperty (readonly)Retrieves the exif version of the file analyzed with GetInfoFromFile.
ExifVerticalResolutionProperty (readonly)Retrieves the vertical resolution from the image.
ExifVerticalResolutionFromInfoProperty (readonly)Retrieves the vertical resolution from the file analyzed with GetInfoFromFile.

File operations (11)

NameTypeDescription
FileConvertMethodConverts an image file to another format.
FileCropMethodPerforms a crop transformation on the specified image file.
FileExpandMethodExpands the specified file to the given width and height using the specified image alignment.
FileFlipHorizontalMethodPerforms a horizontal flip on the specified image file.
FileFlipVerticalMethodPerforms a vertical flip on the specified image file.
FileResizeMethodResizes the specified image file.
FileRotateMethodPerforms a free rotation on the specified image file.
FileRotateLeftMethodPerforms a 90 degree left rotation on the specified image file.
FileRotateRightMethodPerforms a 90 degree right rotation on the specified image file.
FileShrinkMethodShrinks (crops) the specified file to the given width and height using the specified image alignment.
FileThumbnailMethodResizes the specified image file to fit within the specified width and height while maintaining aspect ratio.

File properties (18)

NameTypeDescription
GetFileExtensionFromFileMethodRetrieves the file extension of the specified file path.
GetFileExtensionFromFormatMethodReturns the suggested file extension for the specified format.
GetFileFolderFromFileMethodRetrieves the folder part of the specified file path.
GetFileFromFormatMethodReturns a unique file name for the specified format.
GetFileNameFromFileMethodRetrieves the file name without extenstion from the specified file path.
GetFileWithoutFolderFromFileMethodRetrieves the filename with extension from the specified file path.
FileExtensionProperty (readonly)Returns the file extension of the current loaded image.
FileExtensionFromInfoProperty (readonly)Retrieves the file extension of the file analyzed with GetInfoFromFile.
FileFolderProperty (readonly)Returns the path of the folder wherere the current loaded image is located.
FileFolderFromInfoProperty (readonly)Retrieves the folder part of the the file analyzed with GetInfoFromFile.
FileNameProperty (readonly)Returns the file name without extension of the current loaded image.
FileNameFromInfoProperty (readonly)Retrieves the file name without extenstion from the file analyzed with GetInfoFromFile.
FilePathProperty (readonly)Returns the path of the current loaded image.
FilePathForWebProperty (readonly)Returns the optimized path for the current loaded image.
FilePathFromInfoProperty (readonly)Returns the file path of the analyzed file. This is a copy of the supplied file name in the GetInfoFromFile method.
FileWithoutFolderProperty (readonly)Returns the file name with extension of the current loaded image.
FileWithoutFolderForWebProperty (readonly)Returns the file with optimized extenstion for the current loaded image.
FileWithoutFolderFromInfoProperty (readonly)Retrieves the filename with extension from the file analyzed with GetInfoFromFile.

Filters (48)

NameTypeDescription
FilterBlindsMethodApplies a blinds effect to the image.
FilterBlurAverageMethodApplies an average blur effect on the image.
FilterBlurGaussianMethodApplies a gaussian blur effect on the image.
FilterBlurRadialMethodApplies a radial blur effect on the image.
FilterBlurSmoothMethodApplies a smooth blur effect to the image.
FilterBlurZoomMethodApplies a zoom blur effect on the image.
FilterCheckerboardMethodDraws a checkboard grid on the image.
FilterCustomMethodApplies a custom filter using a 5x5 matrix, division scale and offset to the image.
FilterCustomFromFileMethodApplies a custom filter file (.acf) to the image.
FilterCustomFromURLMethodApplies a custom filter file (.acf) at the specified URL to the image.
FilterCylinderMethodApplies a cylinder distortion effect to the image.
FilterDespeckleMethodApplies a despeckle filter to the image.
FilterEdgeDetectMethodApplies an edge detection effect on the image.
FilterEmbossMethodApplies an emboss effect to the image.
FilterFractalTraceMethodApplies a fractal trace distortion effect to the image.
FilterHalftoneMethodApplies halftone effect (Limb Pattern M3 algorithm) to the image.
FilterIllusionMethodApplies an illusion distortion effect to the image.
FilterLensMethodApplies a lens distortion effect to the image.
FilterLensFlareMethodApplies a lens flare effect to the image.
FilterMeanRemovalMethodApplies a mean removal (more extreme sharpen) effect on the image.
FilterMedianMethodApplies a median filter to the image.
FilterNoiseMethodAdds noise to the image.
FilterOffsetMethodApplies an offset effect to the image.
FilterOilPaintMethodApplies an oil paint effect to the image.
FilterPinchMethodApplies a pinch distortion effect to the image.
FilterPixelateMethodApplies a pixel effect to the image.
FilterPosterizeMethodPosterize the image.
FilterRippleMethodApplies a ripple distortion effect to the image.
FilterSharpenMethodApplies a sharpen effect to the image.
FilterSharpenEdgesMethodApplies a sharpen edges effect to the image.
FilterSharpenMoreMethodApplies a sharpen more effect to the image.
FilterShiftMethodApplies a shift distortion effect to the image.
FilterSoftGlowMethodApplies a soft glow effect to the image.
FilterSolarizeMethodSolarize the image.
FilterSplashMethodAdds splash effect to the image.
FilterStripeMethodApplies a stripe distortion effect to the image.
FilterTextureFromBase64MethodApplies a texture using the specified texture image.
FilterTextureFromFileMethodApplies a texture using the specified texture image.
FilterTextureFromSerializedStreamMethodApplies a texture using the specified texture image which needs to be supplied as a serialized stream. You have to supply a stream which is created using the Serialize method.
FilterTextureFromStreamMethodApplies a texture using the specified texture image which need to be supplied as a file stream.
FilterTextureFromURLMethodApplies a texture using the specified texture image.
FilterThresholdMethodApplies a threshold effect to the image.
FilterTileReflectMethodApplies a tile reflect effect to the image.
FilterUnsharpMaskMethodApplies a sharpen (unsharp mask) effect on the image.
FilterVideoMethodApplies a video effect to the image.
FilterWaveMethodApplies a wave distortion effect to the image.
FilterWhirlMethodApplies a whirl distortion effect to the image.
FilterWhirlPinchMethodApplies a whirl and pinch distortion effect to the image.

Fonts (15)

NameTypeDescription
LoadFontMethodLoads or unloads a custom TrueType font file and sets all font properties at once.
ReleaseFontMethodReleases a custom loaded font file.
ResetFontMethodResets all font properties to the default values.
SetFontMethodSets all font properties within one function call.
FontAlignmentPropertyRetrieves the current font alignment.
FontAntiAliasingPropertyRetrieves the current font anti-aliasing state.
FontBoldPropertyRetrieves the current font bold state.
FontColorPropertyRetrieves the current font color.
FontFacePropertyRetrieves the current font face.
FontItalicPropertyRetrieves the current font italic state.
FontOpacityPropertyRetrieves the current font opacity.
FontRotationPropertyRetrieves the current font rotation in degrees.
FontSizePropertyRetrieves the current font size.
FontStrikeoutPropertyRetrieves the current font srikeout state.
FontUnderlinePropertyRetrieves the current font underline state.

Histogram (15)

NameTypeDescription
GetHistogramAverageMethodRetrieves the average color value for the specified channel of the histogram range.
GetHistogramCountMethodRetrieves the number of pixels for the specified color channel in the specified histogram range.
GetHistogramMeanMethodRetrieves the mean (average of left and right boundary of range) of the histogram range.
GetHistogramPercentileMethodRetrieves the percentage of colors in the specified channel from the total number of pixels of the histogram range.
GetHistogramPixelsMethodRetrieves the number of pixels in the specified histogram range.
InsertHistogramMethodInserts the histogram graph of the image on the specified position in the image.
LoadHistogramFromBase64MethodLoads the histogram graph from the specified Base64 string.
LoadHistogramFromFileMethodLoads the histogram graph of the specified image file.
LoadHistogramFromSerializedStreamMethodLoads the histogram graph of the specified serialized bitmap.
LoadHistogramFromStreamMethodLoads the histogram graph of the specified image stream.
LoadHistogramFromURLMethodLoads the histogram graph of the specified URL.
SaveHistogramToFileMethodSaves the histogram of the loaded image to the specified file.
SaveHistogramToImageMethodRetrieves the histogram graph of the image and replaces the image with the histogram image.
SaveHistogramToSerializedStreamMethodSaves the histogram of the loaded image to a serialized memory stream. This stream is a binary representation of the histogram image object. You can use this function to transfer histogram images from an image object to another image object. The stream cannot be used to save an image to a file, because the stream does not contain a valid image format like JPEG, PNG or BMP. If you want to do that, use the SaveHistogramToStream method instead.
SaveHistogramToStreamMethodSaves the histogram of the loaded image to a stream. The stream data contains all binary information which is normally saved to a physic file when you save the histogram image to a file using the SaveHistogramToFile method. You can use the stream to save the image to a file using your own custom function. You can also use the stream to transfer image objects within your application, so you don't have to save the image to (temporary) files. If you just want to transfer histogram image data from one image object to another image object, use the SaveHistogramToSerializedStream method. This gives better performance for internal image data transfers.

Insert (5)

NameTypeDescription
InsertFromBase64MethodInserts a image from a Base64 encoded string into the current loaded image at the specified position.
InsertFromFileMethodInserts an image file into the current loaded image at the specified position.
InsertFromSerializedStreamMethodInserts a image from a serialized stream into the current loaded image at the specified position. You have to supply a stream which is created using the Serialize method.
InsertFromStreamMethodInserts a image from a stream into the current loaded image at the specified position.
InsertFromURLMethodInserts the image at the specified URL into the current loaded image at the specified position.
NameTypeDescription
LicenseVerifyMethodVerifies the specified license.
LicenseCodeProperty (readonly)Returns the license code.
LicenseDateCreatedProperty (readonly)Returns the license create date as an integer which represents the seconds elapsed since midnight (00:00:00), January 1, 1970, UTC.
LicenseDateExpiredProperty (readonly)Returns the license expiry date as an integer which represents the seconds elapsed since midnight (00:00:00), January 1, 1970, UTC.
LicenseDateRenewedProperty (readonly)Returns the license renewal date as an integer which represents the seconds elapsed since midnight (00:00:00), January 1, 1970, UTC.
LicenseExpiredProperty (readonly)Returns if the license is expired.
LicenseNameProperty (readonly)Returns the license name.
LicenseProductProperty (readonly)Returns the product name.
LicenseProductKeyProperty (readonly)Returns the product key.
LicenseProductVersionProperty (readonly)Returns the current product version.
LicensePublisherProperty (readonly)Returns the name of the license publisher.
LicenseReferenceProperty (readonly)Returns the license reference.
LicenseValidProperty (readonly)Returns if the license is valid.

Lossless transformations (6)

NameTypeDescription
LosslessCropMethodPerforms a lossless crop on the specified JPEG file. To perform this lossless operation the width and height of the cropped rectangle must be adjusted so that the image dimensions are a multiple of the iMCU size (usually 8 or 16 pixels). Therefore the output width or height can be slightly greater than the requested image size.
LosslessFlipHorizontalMethodPerforms a lossless horizontal flip along the vertical axis on the specified JPEG file.
LosslessFlipVerticalMethodPerforms a lossless vertical flip along the horizontal axis on the specified JPEG file.
LosslessRotateMethodPerforms a lossless 180 degree rotation on the specified JPEG file.
LosslessRotateLeftMethodPerforms a lossless 90 degree counter clockwise rotation on the specified JPEG file.
LosslessRotateRightMethodPerforms a lossless 90 degree clockwise rotation on the specified JPEG file.

Masking (6)

NameTypeDescription
MaskMethodCreates a mask of the image.
MaskOverlayFromBase64MethodMask the alpha channel of the specified Base64 string over the image. The mask image needs to be a 32 bits image.
MaskOverlayFromFileMethodMask the alpha channel of the specified file over the image. The mask image needs to be a 32 bits image.
MaskOverlayFromSerializedStreamMethodMask the alpha channel of the specified serialized stream over the image. The mask image needs to be a 32 bits image. You have to supply a stream which is created using the Serialize method.
MaskOverlayFromStreamMethodMask the alpha channel of the specified stream over the image. The mask image needs to be a 32 bits image.
MaskOverlayFromURLMethodMask the alpha channel of the specified URL over the image. The mask image needs to be a 32 bits image.

Pen (7)

NameTypeDescription
SetPenMethodSets all pen properties within one function call.
PenAntiAliasingPropertyRetrieves the current pen anti-aliasing state.
PenCapPropertyRetrieves the current pen dash cap.
PenColorPropertyRetrieves the current pen color.
PenOpacityPropertyRetrieves the current pen opacity.
PenStylePropertyRetrieves the current pen style.
PenWidthPropertyRetrieves the current pen width.

Properties (66)

NameTypeDescription
GetBase64StringMethodReturns a copy of the current bitmap as a Base64 encoded string.
GetBitsPerPixelFromFileMethodReturns the number of bits per pixel of the specified file.
GetFormatAsStringFromFileMethodReturns the suggested output format of the specified file as a string.
GetFormatFromFileMethodReturns the suggested output format of the specified file.
GetFormatFromStringMethodReturns the Format for the specified format identifier.
GetFramesFromFileMethodReturns the number of frames (or pages) of the specified file.
GetGUIDMethodReturns an unique GUID identifier on each call which can be used for generating unique filenames.
GetHasMultipleFramesFromFileMethodReturns if the specified file has multiple image frames (or pages).
GetHeightFromFileMethodReturns the height of the specified file.
GetInfoFromFileMethodRetrieves image information from the specified file and fills the following properties: FormatFromInfo, FormatAsStringFromInfo, WidthFromInfo, HeightFromInfo, MegaPixelsFromInfo, BitsPerPixelFromInfo, FramesFromInfo, IsSupportedFromInfo, IsCMYKFromInfo, IsAnimatedFromInfo, HasMultipleFramesFromInfo, MIMEFromInfo, GetExifFromInfo, ExifDateTakenFromInfo, ExifCopyrightFromInfo, ExifHorizontalResolutionFromInfo, ExifVerticalResolutionFromInfo, ExifCompressionFromInfo, ExifResolutionUnitFromInfo, ExifCompressedBitsPerPixelFromInfo, ExifOrientationFromInfo, ExifCameraMakerFromInfo, ExifCameraModelFromInfo, ExifFStopFromInfo, ExifExposureTimeFromInfo, ExifExposureBiasFromInfo, ExifISOSpeedFromInfo, ExifFocalLengthFromInfo, ExifMaxApertureFromInfo, ExifMeteringModeFromInfo, ExifSubjectDistanceFromInfo, ExifFlashModeFromInfo, ExifFlashEnergyFromInfo, ExifLightSourceFromInfo, ExifProgramModeFromInfo, ExifVersionFromInfo, FilePathFromInfo, FileFolderFromInfo, FileNameFromInfo, FileExtensionFromInfo and FileWithoutFolderFromInfo.
GetInfoFromURLMethodRetrieves image information from the specified URL.
GetIsAnimatedFromFileMethodReturns if the specified file is an animated image.
GetIsCMYKFromFileMethodReturns if the specified file is a CMYK image.
GetIsSupportedFromFileMethodReturns if the format of the specified file supports writing.
GetMegaPixelsFromFileMethodRetrieves the number of megapixels of the specified file.
GetMIMEFromFileMethodReturns the MIME string for the specified file.
GetMIMEFromFormatMethodReturns the MIME string for the specified format.
GetWidthFromFileMethodReturns the width of the specified file.
SetBackgroundColorMethodSets the current background color.
SetFormatMethodSets the output image format for the current image.
SetFormatDefaultMethodSets the default output image format for incompatible images.
SetPixelMethodSets the pixel on the specified position on the image to the specified color and opacity.
SetTransparencyMethodEnables or disables transparency for the image and sets the transparency- or backgroundcolor.
BackgroundColorProperty (readonly)Returns the current background color.
BackgroundOpacityProperty (readonly)Returns the current background opacity.
BitsPerPixelProperty (readonly)Returns the number of bits per pixel of the current image.
BitsPerPixelFromInfoProperty (readonly)Returns the number of bits per pixel of the file analyzed with GetInfoFromFile.
ColorCountProperty (readonly)Returns the number of colors used in the current image.
CursorXPropertyRetrieves the current horizontal cursor position.
CursorYPropertyRetrieves the current vertical cursor position.
FormatProperty (readonly)Returns the suggested output image format of the current image.
FormatAsStringProperty (readonly)Returns the suggested output format of the current image as a string.
FormatAsStringFromInfoProperty (readonly)Returns the suggested output format of the file analyzed with GetInfoFromFile as a string.
FormatDefaultProperty (readonly)Returns the default output image format for incompatible images.
FormatFromInfoProperty (readonly)Returns the suggested output format for the file analyzed with GetInfoFromFile.
FormatOriginalProperty (readonly)Returns the format of the original image.
FormatOriginalAsStringProperty (readonly)Returns the original format of the current image as a string.
FrameProperty (readonly)Returns the current loaded frame (or page).
FramesProperty (readonly)Returns the number of frames (or pages) in the current image.
FramesFromInfoProperty (readonly)Returns the number of frames (or pages) for the file analyzed with GetInfoFromFile.
HasMultipleFramesProperty (readonly)Returns if the current image has multiple image frames (or pages).
HasMultipleFramesFromInfoProperty (readonly)Returns if the file analyzed with GetInfoFromFile has multiple image frames (or pages).
HeightProperty (readonly)Returns the height of the current image.
HeightFromInfoProperty (readonly)Returns the height of the file analyzed with GetInfoFromFile.
IsAnimatedProperty (readonly)Returns if the current image is animated.
IsAnimatedFromInfoProperty (readonly)Returns if the file analyzed with GetInfoFromFile is an animated image.
IsCMYKProperty (readonly)Returns if the current image is a CMYK image.
IsCMYKFromInfoProperty (readonly)Returns if the file analyzed with GetInfoFromFile is a CMYK image.
IsConvertedProperty (readonly)Returns if the current image format is different then the original image format.
IsJPEGProperty (readonly)Returns if the current image is a JPEG image.
IsLoadedProperty (readonly)Returns if an image is loaded.
IsSupportedProperty (readonly)Returns if the current image format can be saved without format conversion.
IsSupportedFromInfoProperty (readonly)Returns if the format of the file analyzed with GetInfoFromFile supports writing.
IsSupportedOriginalProperty (readonly)Returns if the original image format can be saved without format conversion.
IsTransparentProperty (readonly)Returns if the current image has a transparent background.
JPEGProgressivePropertyRetrieves if JPEG progressive encoding is enabled.
JPEGQualityPropertyRetrieves the JPEG quality percentage.
MegaPixelsProperty (readonly)Retrieves the number of megapixels of the image.
MegaPixelsFromInfoProperty (readonly)Retrieves the number of megapixels of the file analyzed with GetInfoFromFile.
MIMEProperty (readonly)Returns the MIME string for the current image.
MIMEFromInfoProperty (readonly)Returns the MIME string for the file analyzed with GetInfoFromFile.
PixelCountProperty (readonly)Returns the total number of pixels in the current image.
TransparencyProperty (readonly)Returns the transparent background color if any.
WebFilterPropertyRetrieves the state of the web filter.
WidthProperty (readonly)Returns the width of the current image.
WidthFromInfoProperty (readonly)Returns the width of the file analyzed with GetInfoFromFile.

Text drawing (16)

NameTypeDescription
DrawTextInGradientMethodDraws text on the current image canvas and fills the text with a gradient color.
DrawTextInGradientUsingWarpMethodDraws text with warp effect on the current image canvas and fills the text with a gradient color.
DrawTextInGradientWithBorderMethodDraws text with border on the current image canvas and fills the text with a gradient color.
DrawTextInGradientWithBorderAndShadowMethodDraws text with border and shadow on the current image canvas and fills the text with a gradient color.
DrawTextInGradientWithBorderAndShadowUsingWarpMethodDraws text with border, shadow and warp effect on the current image canvas and fills the text with a gradient color.
DrawTextInGradientWithBorderUsingWarpMethodDraws text with border and warp effect on the current image canvas and fills the text with a gradient color.
DrawTextInGradientWithShadowMethodDraws text with shadow on the current image canvas and fills the text with a gradient color.
DrawTextInGradientWithShadowUsingWarpMethodDraws text with shadow and warp effect on the current image canvas and fills the text with a gradient color.
DrawTextNormalMethodDraws text on the current image canvas.
DrawTextUsingWarpMethodDraws text with warp effect on the current image canvas.
DrawTextWithBorderMethodDraws bordered text on the current image canvas.
DrawTextWithBorderUsingWarpMethodDraws bordered text with warp effect on the current image canvas.
DrawTextWithShadowMethodDraws text with shadow on the current image canvas.
DrawTextWithShadowUsingWarpMethodDraws text with shadow and warp effect on the current image canvas.
GetTextHeightMethodMeasures the height of the supplied text string.
GetTextWidthMethodMeasures the width of the supplied text string.

Transformations (16)

NameTypeDescription
ClearMethodClears the contents of the image.
CropMethodPerforms a crop on the current image.
ExpandMethodExpands the image to the given width and height using the specified image alignment.
FlipHorizontalMethodFlip the image horizontally along the vertical axis.
FlipVerticalMethodFlip the image vertically along the horizontal axis.
OpacityMethodAdjusts the opacity of the image.
ResizeMethodResizes the image.
RotateMethodRotates the image with the specified number of degrees with high precision and quality (rotate by shear).
RotateLeftMethodPerforms a 90 degree counter clockwise rotation on the image.
RotateRightMethodPerforms a 90 degree clockwise rotation on the image.
RoundEdgesMethodRounds the edges of the image or specified rectangle.
ShearMethodPerforms a shear transformation on the current image.
ShrinkMethodShrinks (crops) the image to the given width and height using the specified image alignment.
SkewMethodPerforms a skew transformation on the current image.
StraightenMethodStraightens the image with the specified number of degrees (with a maximum of 45 degrees) with high precision and quality to align the horizon of an image. Use this method for horizon correction.
ThumbnailMethodCreates a thumbnail of the image with an optional thumbnail effect.

Enumerations (20)

EnumerationDescription
AlignmentSpecifies the different horizontal alignment options mostly used for text alignment.
AnchorSpecifies the anchor position which will be used for the transformation.
CapSpecifies the caps for ending lines which are drawed.
ChannelSpecifies the color channel to use.
ColorTypeSpecifies the color type to use for the effect.
DashSpecifies the dash style to use when drawing dotted lines.
FillSpecifies the filling technique to use.
FormatSpecifies the imaging format to use. Some formats are only available if the web filter is disabled. This filter prevents the library from loading images which are not suitable for web purposes. Some formats are only available for reading and cannot be used to save files in that particular format.
GradientSpecifies the gradient direction to use for drawing.
MaskSpecifies the mask mode.
OffsetSpecifies options for the offset filter effect.
OrientationSpecifies the orientation of the drawing cursor.
PenSpecifies the pen style to use then drawing lines.
ResampleSpecifies the resample alogorithm which should be used when the image is resized. For more information take a look at: http://en.wikipedia.org/wiki/Resampling_(bitmap).
ResizeSpecifies the resize method to use when resizing the image. This option enables or disables maintaining the aspect ratio.
RotationSpecifies the rotation method which is used. When an image is rotated the resulting image will be slightly (depending on the rotating angle) bigger than the original. The values below specify how the engine should handle this image growth.
StateRepresents a boolean value (true or false) or uses the default value (default).
ThumbnailSpecifies the thumbnail effect to use. There are built-in effects which can be applied when a thumbnail is created. These effects can be usefull to create elegant and sophisticated thumbnail views of images.
ToneSpecifies the color tones to use.
VideoSpecifies options for the video filter.

See also

Methods | Properties | Enumerations