Skip to main content

ImageBlend

ImageBlend [/A=alpha /W=alphaWave ] srcWaveA, srcWaveB [, destWave ]

The ImageBlend operation takes two RGB images (3D waves) in srcWaveA and srcWaveB and computes the alpha blending so that

destWave = srcWaveA * (1 - alpha ) + srcWaveB * alpha

for each color component. As of Igor Pro 10 the optional destWave parameter is deprecated and you should use the /DEST flag to specify the output destination destBlendW. If you do not specify the destination, ImageBlend saves the output in the wave M_alphaBlend in the current data folder.

The source and destination waves must be of the same data types and the same dimensions. The alphaWave, if used, must be a single precision (SP) float wave and it must have the same number of rows and columns as the source waves.

Flags

/A=alphaSpecifies a single alpha value for the whole image
/DEST=destBlendW
Specifies the output wave created by the operation. It is a replacement for using the optional destWave argument at the end of the command, but it also allows destBlendW to be a free wave.
It is an error to specify the same wave as both srcWave and destWave.
When used in a function, the ImageBlend operation by default creates a real wave reference for the destination wave. See Automatic Creation of Wave References for details.
/DEST flag was added in Igor Pro 10.00.
/FREECreates the wave destBlendW as a free wave. Note that /FREE does not affect the destWave specified by the deprecated optional last command parameter.
/FREE is allowed only in functions and only if destBlendW is a simple name or wave reference structure field.
See Free Waves for more discussion.
The /FREE flag was added in Igor Pro 10.00.
/W=alphaWaveSingle precision wave that specifies an alpha value for each pixel.

See Also

ImageComposite, Image Processing