L_RomanMosaicBitmap

Summary

Segments the image into rectangular or rounded rectangular tiles and fills them with a color chosen randomly from the colors of the tiles pixels.

Syntax

L_LTIMGSFX_API L_INT L_RomanMosaicBitmap(pBitmap, uTileWidth, uTileHeight, uBorder, uShadowAngle, uShadowThresh, crColor, uFlags)

Parameters

pBITMAPHANDLE pBitmap

Pointer to the bitmap handle that references the bitmap to which to apply the effect.

L_UINT uTileWidth

Value that indicates the width of the tile, in pixels. The meaning of the uTileWidth parameter differs according to the flags that are set in the uFlags member. Possible values are:

L_UINT uTileHeight

Value that indicates the height of the tile. The meaning of the uTileHeight parameter differs according to the flags that are set in the uFlags member. Possible values are:

L_UINT uBorder

Value that indicates the border width (space between the tiles), in pixels. The valid range is from 1 to 15.

L_UINT uShadowAngle

Angle value indicating the direction of the light source that produces the shadow. This member can be used if the RMN_SHADOWRGB flag or the RMN_SHADOWGRAY flag is set. Possible values are:

L_UINT uShadowThresh

Value that is used to determine which pixels will be affected by the shadow. Valid values range from 0 through 255. This member will be used if the MSCT_SHADOWRGB flag or the MSCT_SHADOWGRAY flag is set. Pixels with values above this threshold will be affected.

COLORREF crColor

The COLORREF value that specifies the fill color to be used in between the tiles. You can specify a COLORREF value, such as the return value of the Windows RGB macro, or you can use the PALETTEINDEX macro to specify a palette color.

L_UINT uFlags

Flags that indicate which type of tiles to draw, whether to apply shadows, and how to apply the shadows when shadowing is used. You can use a bit wise OR ( | ) to specify one flag from each group.

The following flags indicate which type of tiles to draw:

The following flags indicate how to apply the shadow on the tiles, and whether to use shadowing:

Returns

Comments

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.

Use this function to divide the bitmap into rectangular or rounded rectangular tiles and then fill each tile with a color chosen randomly from the colors of each tiles pixels.

For an example, click here

Use the L_MosaicBitmap function to impose a mosaic effect on a bitmap by dividing the bitmap into tiles of a specified size and changing the color of all pixels in each tile to the average color of pixels within the tile.

Use the L_PixelateBitmap function to divide the bitmap into rectangular or arc-shaped cells and then recreate the image by filling those cells with the minimum, maximum, or average pixel value, depending upon the effect that was selected.

Use the L_MosaicTilesBitmap function to make an image look like a mosaic made from tiles. Tiles can be rectangular or arc-shaped, depending upon the coordinate system used to draw the tiles.

Use the L_PointillistBitmap function to convert image colors into randomly placed dots to create a pointillist painting, using a background color to fill the area between dots.

This function can process the whole image or a region of the image. If a bitmap has a region, the effect is applied only to the region.

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 in the Document and Medical Imaging toolkits.

To update a status bar or detect a user interrupt during execution of this function, Refer to L_SetStatusCallback.

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.

View additional platform support for this Roman Mosaic 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.

Platforms

Win32, x64.

See Also

Functions

• L_AddBitmapNoise
• L_EmbossBitmap
• L_MosaicBitmap
• L_MotionBlurBitmap
• L_OilifyBitmap
• L_PosterizeBitmap
• L_RemoveRedeyeBitmap
• L_SolarizeBitmap
• L_UnderlayBitmap
• L_BendingBitmap
• L_CylindricalBitmap
• L_FreeHandShearBitmap
• L_FreeHandWaveBitmap
• L_ImpressionistBitmap
• L_PolarBitmap
• L_PunchBitmap
• L_RadialBlurBitmap
• L_RadWaveBitmap
• L_RippleBitmap
• L_SpherizeBitmap
• L_SwirlBitmap
• L_WaveBitmap
• L_WindBitmap
• L_ZoomBlurBitmap
• L_ZoomWaveBitmap
• L_BumpMapBitmap
• L_CubismBitmap
• L_DrawStarBitmap
• L_DryBitmap
• L_FreePlaneBendBitmap
• L_FreeRadBendBitmap
• L_GlassEffectBitmap
• L_GlowFilterBitmap
• L_LensFlareBitmap
• L_LightBitmap
• L_OceanBitmap
• L_PlaneBendBitmap
• L_PlaneBitmap
• L_SampleTargetBitmap
• L_TunnelBitmap
• L_PixelateBitmap
• L_MosaicTilesBitmap
• L_PointillistBitmap

Topics

• Raster Image Functions: Doing Geometric Transformations
• Processing an Image
• Applying Artistic Effects

Example

Apply the Roman Mosaic effect using rectangular tiles, with gray shadows

L_INT RomanMosaicBitmapExample(L_VOID) 
{ 
   L_INT nRet; 
   BITMAPHANDLE LeadBitmap;   /* Bitmap handle for the image */ 
 
   /* Load a bitmap at its own bits per pixel */ 
   nRet = L_LoadBitmap (MAKE_IMAGE_PATH(TEXT("Image2.jpg")), &LeadBitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGRORGRAY, NULL, NULL);  
   if(nRet !=SUCCESS) 
      return nRet; 
 
   nRet = L_RomanMosaicBitmap(&LeadBitmap, 15, 15, 5, SHADOW_E, 0, RGB(0,0,0), RMN_BOTH | RMN_SHADOWGRAY); 
   if(nRet !=SUCCESS) 
      return nRet; 
 
   nRet = L_SaveBitmap(MAKE_IMAGE_PATH(TEXT("Result.BMP")), &LeadBitmap, FILE_BMP, 24, 0, NULL); 
   if(nRet !=SUCCESS) 
      return nRet; 
 
   //free bitmap 
   if(LeadBitmap.Flags.Allocated) 
      L_FreeBitmap(&LeadBitmap); 
 
   return SUCCESS; 
}