LBitmap::GlassEffect

#include "ltwrappr.h"

virtual L_INT LBitmap::GlassEffect(uCellWidth, uCellHeight, uFlags)

L_UINT uCellWidth;	/* cell width */
L_UINT uCellHeight;	/* cell height */
L_UINT uFlags;	/* flags */

Divides the bitmap into rectangular cells and makes it look as if it is being viewed through glass blocks.

Parameter	Description
uCellWidth	Value that represents the width of a cell in pixels or the number of cells present across the width of the bitmap, based on the flags set in uFlags. The valid range is between 2 and half the bitmap width.
uCellHeight	Value that represents the height of a cell in pixels or the number of cells present across the height of the bitmap, based on the flags set in uFlags. The valid range is between 2 and half the bitmap height.
uFlags	Flags that indicate what type of data is in the uCellWidth and uCellHeight parameters. You can use a bitwise OR (\|) to specify one flag from each group.
	The following are the flags that indicate the type of data in the uCellWidth parameter:
	Value	Meaning
	GLASS_WFRQ	[0x0001] The parameter uCellWidth is the number of cells along the width of the bitmap.
	GLASS_WPER	[0x0002] The parameter uCellWidth is the width of the cell in pixels.
	The following are the flags that indicate the type of data in the uCellHeight parameter:
	Value	Meaning
	GLASS_HFRQ	[0x0010] The parameter uCellHeight is the number of cells along the height of the bitmap.
	GLASS_HPER	[0x0020] The parameter uCellWidth is the height of the cell in pixels.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

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

This function 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.

To update a status bar or detect a user interrupt during execution of this function, refer to LBase::EnableStatusCallback.

This function 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 function.

This function does not support 32-bit grayscale images. It returns the error code ERROR_GRAY32_UNSUPPORTED if a 32-bit grayscale image is passed to this function.

Required DLLs and Libraries

LTIMGSFX

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:	LBitmap::AdjustTint. LBitmap::ColorHalfTone, LBitmap::BricksTexture, LBitmap::Canvas, LBitmap::Clouds, LBitmap::ColoredBalls, LBitmap::DiffuseGlow, LBitmap::DisplaceMap, LBitmap::Fragment, LBitmap::HalfTonePattern, LBitmap::MaskConvolution, LBitmap::MosaicTiles, LBitmap::Offset, LBitmap::Perspective, LBitmap::PlasmaFilter, LBitmap::Pointillist, LBitmap::RomanMosaic, LBitmap::Vignette, LBitmap::ZigZag, LBitmap::Sharpen, LBitmap::Posterize, LBitmap::Emboss, LBitmap::AverageFilter, LBitmap::MedianFilter, LBitmap::AddNoise, LBitmap::IntensityDetect, LBitmap::SpatialFilter, LBitmap::BinaryFilter, LBitmap::MaxFilter, LBitmap::MinFilter, LBitmap::Oilify, LBitmap::Solarize, LBitmap::WindowLevel, LBitmap::Mosaic, LBitmap::MotionBlur, LBitmap::RemoveRedeye, LBitmapBase::Underlay, LBitmap::BumpMap, LBitmap::Cubism, LBitmap::DrawStar, LBitmap::Dry, LBitmap::FreePlaneBend, LBitmap::FreeRadBend, LBitmap::GlowFilter, LBitmap::LensFlare, LBitmap::Light, LBitmap::Ocean, LBitmap::PlaneBend, LBitmap::Plane, LBitmap::SampleTarget, LBitmap::Tunnel, LBitmap::Bending, LBitmap::Cylindrical, LBitmap::FreeHandShear, LBitmap::FreeHandWave, LBitmap::Impressionist, LBitmap::Pixelate, LBitmap::Polar, LBitmap::Punch, LBitmap::RadialBlur, LBitmap::RadWave, LBitmap::Ripple, LBitmap::Spherize, LBitmap::Swirl, LBitmap::Wave, LBitmap::Wind, LBitmap::ZoomBlur, LBitmap::ZoomWave
Topics:	Raster Image Functions: Artistic Effects
	Applying Artistic Effects
	Raster Image Functions: Correcting Colors

Example

The following example applies a glass effect to it:

L_INT LBitmap__GlassEffectExample(LAnimationWindow *BitmapWindow) 
{
   
   return BitmapWindow->GlassEffect(20,10, GLASS_WFRQ | GLASS_HPER ); 
}