Plane method (Main Control)

C++ Builder example

Delphi example

 

Builder Syntax

int Plane(const TPoint &ptCenter, unsigned uZValue, int nDistance, unsigned uPlaneOffset, int nRepeat, int nPydAngle, unsigned uStretch, unsigned uStartBright, unsigned uEndBright, unsigned uBrightLength, unsigned crBright, unsigned crFill, unsigned uFlags);

Delphi Syntax

Function Plane (ptCenter: TPoint; uZValue: L_UINT; nDistance: L_INT; uPlaneOffset: L_UINT; nRepeat: L_INT; nPydAngle: L_INT; uStretch: L_UINT; uStartBright: L_UINT; uEndBright: L_UINT; uBrightLength: L_UINT; crBright: COLORREF; crFill: COLORREF; uFlags: L_UINT): L_INT;

Overview

Refer to Applying Artistic Effects

Remarks

(Raster Pro and above toolkits) Places the bitmap on parallel planes along the Z-axis.

This method shows the effect of placing bitmaps on planes along the Z-axis. These bitmaps may be placed above, below, to the left or to the right of the Z-axis. An external light source of the specified color and brightness may be shined on the bitmaps. The brightness may vary along the z-axis according to the uBrightLength value.

By changing ptCenterPoint and the viewing screen Z-offset, you can simulate moving along the axis.

If the bitmap has a region, the effect will be applied on the region dimensions only.

This method supports 12 and 16-bit grayscale and 48 and 64-bit color images. Support for 12 and 16-bit grayscale and 48 and 64-bit color images is available only in the Document/Medical toolkits.

For an example, see the following figure:

image\Plane_before.gif

The following figure shows the same bitmap, after the effect has been applied:

image\Plane_after.gif

To obtain this effect, the following settings were used with the method:

ptCenter(x,y)= (320,256)

uZValue = 0

nDistance= 256

uPlaneOffset= 256

nRepeat= -1

nPydAngle= 0

uStretch= 100

uStartBright= 0

uEndBright= 0

uBrightLength= 50

crBright= RGB(255,255,255)

crFill= RGB(0,0,0)

uFlags= PLANE_FILL_CLR|PLANE_DOWN

This method does not support signed data images. It returns the error code ERROR_SIGNED_DATA_NOT_SUPPORTED if a signed data image is passed to this method.

See Also

Elements:

AddNoise method, Emboss method, Mosaic method, MotionBlur method, Oilify method, Posterize method, RemoveRedeye method, Solarize method, Underlay method, BumpMap method, Cubism method, DrawStar method, FreePlaneBend method, FreeRadBend method, GlassEffect method, GlowFilter method, LensFlare method, Light method, Ocean method, PlaneBend method, Dry method, SampleTarget method, Tunnel method, Bending method, Cylindrical method, FreeHandShear method, FreeHandWave method, Impressionist method, Pixelate method, Polar Method, Punch method, RadialBlur method, RadWave method, Ripple method, Spherize method, Swirl method, Wave method, Wind method, ZoomBlur method, ZoomWave method

Topics:

Raster Images: Doing Geometric Transformations

 

Raster Images: Artisitic Effects

 

Using Color Values in LEADTOOLS