Using Special Effects When Painting

You can specify a special effect to be applied when painting an image, and you can specify a transitional effect that occurs before the image is painted. Other aspects of painting (such as zooming) are automated or controlled as explained in Displaying an Image.

The following property lets you specify a special effect when painting an image:

PaintEffect property

The following properties let you implement a transitional effect that paints before the image paints:

TransitionStyle property

TransitionEffect property

The TransitionStyle property determines whether a transitional effect is used, and it determines whether the transition is based on pattern properties or gradient color properties. Refer to Gradients and Patterns for related properties.

If the PaintEffect or TransitionEffect is an option from the Wave class of Effects, the EffectCycles and EffectSpeed properties can be used to indicate the number of repetitions and the speed of the wave effect.

The following properties let you specify the speed and granularity of the effect:

EffectDelay property

TransitionDelay property

EffectGrain property

The following properties and event let you control the number of passes when painting an image or transition. If you specify more than one pass, a pattern brush paints some of the pixels on each pass, and the painting is complete when you finish all of the passes.

PaintEffectMaxPasses property

PaintTransitionMaxPasses property

PaintTransitionPass property

PaintNotificationDelay property

PaintNotification event

The PaintEffectPass property indicates the current pass during a paint effect.

The first PaintNotification event occurs before the first pass and after each pass when painting a transition or an image. Therefore, you can use the event to change other properties between passes, or after the transition paints and before the image paints.

The following properties let you specify a transparent color (a color that is not painted):

BitmapEnableTransparency property

BitmapTransparentColor property

The following properties let you specify a wand (a band of color that is used at the leading edge of some effects):

WandColor property

WandSize property