Introduction

The LEADTOOLS DigitalPaint C API features are a must for anyone who wants to add digital painting functionality to an application. With LEADTOOLS Digital Paint, a developer can create an entire image editing or design application, or simply add pieces of those types of functionality into an existing application. This C API is included with LEADTOOLS Raster, Vector, Medical, and Document Imaging products.

The LEADTOOLS DigitalPaint C API Digital Paint includes both low-level and high-level functions for painting. With the low-level functions, you can programmatically control the painting. With the high-level functions (known as Automated Mode), you can simply turn on Automation, and allow the user to pick the painting tool. With Automation, the user's mouse events are automatically processed, and the coding is done for you.

The output can be painted to a device context (DC), a bitmap, or both. In addition, the LEADTOOLS DigitalPaint C API provides the option of color restriction, using an optional restriction palette.

Key Features:

The LEADTOOLS DigitalPaint C API consists of five groups of paint functions. These groups are:

Brush

The LEADTOOLS DigitalPaint brush group includes features that normally could be found only in artistic painting applications. The resulting paintbrush will be translated and scaled automatically for the device context and/or the bitmap, using user-defined transformation settings. Brush options include:

Color brush

Image/pattern brush

Diameter

Hardness/Sharpness of brush edges

Spacing - frequency of touches

Density

Opacity

Fade out - allow the brush to fade during the stroke

Texture - apply a bitmapped texture to the brush

Shape

The LEADTOOLS DigitalPaint shape group removes some of the Windows C API programming when drawing shapes. In addition, shapes may be painted with varying degrees of opacity, or with paper texture, gradient background, etc. The resulting shapes will be translated and scaled automatically for the device context and/or the bitmap, using user-defined transformation settings. Shapes include:

Line

Rectangle

Rounded rectangle

Ellipse

Polygon

Polybezier

Region

Use the LEADTOOLS DigitalPaint region functionality to create regions for restricting image operations. Regions can range from simple to very complex (many of which are not supported by natively in Windows without LEADTOOLS). Additionally, functionality to resize or scale a region, which is not supported directly by Windows, is included with the LEADTOOLS Digital Paint C API. The resulting regions will be translated and scaled automatically for the device context (DC) and/or the bitmap, using user-defined transformation settings. The following regions can be created:

Rectangle

Rounded rectangle

Ellipse

Polygon

Curves

Surface - a region starting at a specified point and continues in all directions that contains a specified color and tolerance

Border - a region starting at a specified point and continues in all directions until finding a specified color and tolerance

Color - a region that contains a specified color and tolerance

Fill

The LEADTOOLS DigitalPaint fill group gives the user the most complete area filling solutions for both fill method and fill features. The resulting filled area will be translated and scaled automatically for the device context (DC) and/or the bitmap, using user-defined transformation settings. Fill options and types include:

Solid

Gradient

Background tiled image

Opacity

Texture

Surface - Fills an area starting at a specified point and continues in all directions that contain a specified color and some tolerance.

Border - Fills an area starting at a specified point and continues in all directions until finding a specified color and some tolerance.

Color replace - Replaces every pixel using the current fill settings.

Text

The LEADTOOLS DigitalPaint text group includes comprehensive text drawing features that could normally only be found in a painting application. The resulting text will be translated and scaled automatically for the device context (DC) and/or the bitmap, using user-defined transformation settings. Text options include:

Font

Border

Tiled background bitmap

Alignment

Opacity

Texture

Note: LEADTOOLS DigitalPaint products do not copy data passed to a DigitalPaint function by the user. Rather, they use data directly. Therefore, the data supplied by the user must remain valid for as long as the data is needed. For example, if a palette handle is passed to a DigitalPaint function, the toolkit uses this handle to access the palette. The toolkit does NOT make a copy of the handle or the palette. Therefore, if the palette handle provided by the use is destroyed, the toolkit's palette handle is also destroyed and the toolkit will have an invalid palette handle.

Windows Common Dialogs

Includes a set of ready to use dialog boxes for gathering information for use in setting the various paint options. These allow you to quickly add code to your application for getting input from the end-user. Additionally, it gives your application a consistent Windows look and feel, making your application easier to use and learn.

Supported Environments:

The toolkit comes in Win32 and x64 editions that can support development of software applications for any of the following environments: