Plane method (Main Control)
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:
The following figure shows the same bitmap, after the effect has been applied:
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