View source for FMX.Graphics.TBitmap.CreateFromBitmapAndMask

{{#lst:API:FMX.Graphics.TBitmap.CreateFromBitmapAndMask|api}}
<!--Start API Documentation-->
==Description==
{{#ifeq: {{PAGENAME}} | FMX.Graphics.TBitmap.CreateFromBitmapAndMask | |{{InheritsFrom|FMX.Graphics.TBitmap.CreateFromBitmapAndMask}}}}

<section begin=short />Constructs a [[FMX.Graphics.TBitmap|TBitmap]] object by applying a mask to an existing [[FMX.Graphics.TBitmap|TBitmap]] object.<section end=short />

The <code>Bitmap</code> parameter specifies the [[FMX.Graphics.TBitmap|TBitmap]] on which the mask is applied.

The <code>Mask</code> parameter is the applied mask.

The created [[FMX.Graphics.TBitmap|TBitmap]] has the value of the Alpha channel of each color pixel equal with the value of the Red channel in the <code>Mask</code>.

<blockquote>'''Tip:''' For a better result, use a grayscale image for <code>Mask</code>. It has an equal amount of green, red, and blue. </blockquote>

<blockquote>'''Tip:''' The mask and the base bitmap must have the same dimensions. Otherwise the new [[FMX.Graphics.TBitmap|TBitmap]] will have the dimensions equal to 0. </blockquote>

===See Also===
* [[FMX.Graphics.TBitmap.Create]]
* [[FMX.Graphics.TBitmap.CreateFromFile]]
* [[FMX.Graphics.TBitmap.CreateFromStream]]
* [[FMX.Graphics.TBitmap.Destroy]]
* [[System.TObject.Free]]

=== Code Examples ===
*[[samp_en:CreateFromBitmapAndMask (Delphi)|CreateFromBitmapAndMask (Delphi)]]

[[Category:API Documentation]]
[[Category:XE2]]
<!--End API Documentation-->