CorelScript.EffectBumpMap method - Developer Area

Developer Area requires membership for participation - click to join

API Documentation > Corel PHOTO-PAINT > X7.4 > CorelScript > ICorelScript

CorelScript.EffectBumpMap method

Syntax:

void EffectBumpMap(_bstr_t FileName, int Mode, int TileWidth, int TileHeight, int Floor, int Ceiling, int ScaleFactor, int Highlight, VARIANT_BOOL Invert, VARIANT_BOOL Smooth, int AmbientBrightness, int AmbientColorModel, int AmbientColor1, int AmbientColor2, int AmbientColor3, int AmbientColor4, int DirectionalBrightness, int DirectionalColorModel, int DirectionalColor1, int DirectionalColor2, int DirectionalColor3, int DirectionalColor4, int Direction, int Declination);

Parameters:

Name	Type	Description
FileName	_bstr_t	Specifies the name of the file
Mode	int	Specifies the mode:
TileWidth	int	Specifies the width of each tile to stretch the bump map. A value of 0 automatically uses the width of the bump map.
TileHeight	int	Specifies the height of each tile to stretch the bump map. A value of 0 automatically uses the height of the bumpmap.
Floor	int	Specifies the minimum value allowed in the bump map, clipping all values below this amount. Valid values range from 0 to 255.
Ceiling	int	Specifies the maximum value allowed in the bump map, clipping all values above this amount. Valid values range from 0 to 255.
ScaleFactor	int	Specifies the percentage by which to scale the values in the bump map. Valid values range from 0 to 200.
Highlight	int	Specifies the amount of specular highlight. Valid values range from 0 to 100; low values simulate a dull surface, while high values simulate a shiny surface.
Invert	VARIANT_BOOL	Specifies whether to invert the bump-map values:
Smooth	VARIANT_BOOL	Specifies whether to blur the bump map:
AmbientBrightness	int	Specifies the brightness of the ambient light, which comes from all directions and illuminates all pixels equally (regardless of their surface gradients). Valid values range from 0 to 100.
AmbientColorModel	int	Specifies the color model to use for the ambient light:
AmbientColor1	int	Specifies the first color component of the ambient light. Valid values range from 0 to 255.
AmbientColor2	int	Specifies the second color component of the ambient light. Valid values range from 0 to 255.
AmbientColor3	int	Specifies the third color component of the ambient light. Valid values range from 0 to 255.
AmbientColor4	int	Specifies the fourth color component of the ambient light. Valid values range from 0 to 255.
DirectionalBrightness	int	Specifies the brightness of the directional light, which illuminates each pixel by an amount dependent on its surface gradient. Valid values range from 0 to 100.
DirectionalColorModel	int	Specifies the color model to use for the direction light: 3 = CMYK 5 = RGB 9 = grayscale
DirectionalColor1	int	Specifies the first color component of the directional light. Valid values range from 0 to 255.
DirectionalColor2	int	Specifies the second color component of the directional light. Valid values range from 0 to 255.
DirectionalColor3	int	Specifies the third color component of the directional light. Valid values range from 0 to 255.
DirectionalColor4	int	Specifies the fourth color component of the directional light. Valid values range from 0 to 255.
Direction	int	Specifies the angle, clockwise, describing the direction the directional light is travelling in the plane of the image. Valid values range from 0 to 359.
Declination	int	Specifies the angle, clockwise, describing the direction the directional light is travelling. Valid values range from 0 to 359.

Remarks:

The EffectBumpMap method applies the Bump-map effect to an image, adding texture and patterns to the image by embedding its surface with a relief based on the pixel values of a bump-map image.

Version Information:

Corel PHOTO-PAINT:

X7.4, X7, X7.6, X8, 2017, 2018, 2019, 2019.2, 2020, 2021, 2020.1, 2021.5, 2022-v24, 2022-v24.1, 2022-v24.2, 2023-v24.3, 2023-v24.5, 2024-v25