[wxWidgets.git] / docs / latex / wx / mask.tex

\section{\class{wxMask}}\label{wxmask}

This class encapsulates a monochrome mask bitmap, where the masked area is black and
the unmasked area is white.

\wxheading{Derived from}

\helpref{wxObject}{wxobject}

\wxheading{Include files}

<wx/bitmap.h>

\wxheading{Remarks}

A mask may be associated with a \helpref{wxBitmap}{wxbitmap}. It is used in \helpref{wxDC::Blit}{wxdcblit} when
the source device context is a \helpref{wxMemoryDC}{wxmemorydc} with wxBitmap selected into it that
contains a mask.

\wxheading{See also}

\helpref{wxBitmap}{wxbitmap}, \helpref{wxDC::Blit}{wxdcblit}, \helpref{wxMemoryDC}{wxmemorydc}

\latexignore{\rtfignore{\wxheading{Members}}}

\membersection{wxMask::wxMask}\label{wxmaskconstr}

\func{}{wxMask}{\void}

Default constructor.

\func{}{wxMask}{\param{const wxBitmap\& }{bitmap}}

Constructs a mask from a monochrome bitmap.

\func{}{wxMask}{\param{const wxBitmap\& }{bitmap}, \param{const wxColour\& }{colour}}

Constructs a mask from a bitmap and a colour that indicates the background. Not
yet implemented for GTK.

\func{}{wxMask}{\param{const wxBitmap\& }{bitmap}, \param{int}{ index}}

Constructs a mask from a bitmap and a palette index that indicates the background. Not
yet implemented for GTK.

\wxheading{Parameters}

\docparam{bitmap}{A valid bitmap.}

\docparam{colour}{A colour specifying the transparency RGB values.}

\docparam{index}{Index into a palette, specifying the transparency colour.}

\membersection{wxMask::\destruct{wxMask}}

\func{}{\destruct{wxMask}}{\void}

Destroys the wxMask object and the underlying bitmap data.

\membersection{wxMask::Create}\label{wxmaskcreate}

\func{bool}{Create}{\param{const wxBitmap\& }{bitmap}}

Constructs a mask from a monochrome bitmap.

\func{bool}{Create}{\param{const wxBitmap\& }{bitmap}, \param{const wxColour\& }{colour}}

Constructs a mask from a bitmap and a colour that indicates the background. Not
yet implemented for GTK.

\func{bool}{Create}{\param{const wxBitmap\& }{bitmap}, \param{int}{ index}}

Constructs a mask from a bitmap and a palette index that indicates the background. Not
yet implemented for GTK.

\wxheading{Parameters}

\docparam{bitmap}{A valid bitmap.}

\docparam{colour}{A colour specifying the transparency RGB values.}

\docparam{index}{Index into a palette, specifying the transparency colour.}
Commit	Line	Data
a660d684 KB	1	\section{\class{wxMask}}\label{wxmask}
	2
	3	This class encapsulates a monochrome mask bitmap, where the masked area is black and
	4	the unmasked area is white.
	5
	6	\wxheading{Derived from}
	7
	8	\helpref{wxObject}{wxobject}
	9
954b8ae6 JS	10	\wxheading{Include files}
	11
	12	<wx/bitmap.h>
	13
a660d684 KB	14	\wxheading{Remarks}
	15
	16	A mask may be associated with a \helpref{wxBitmap}{wxbitmap}. It is used in \helpref{wxDC::Blit}{wxdcblit} when
	17	the source device context is a \helpref{wxMemoryDC}{wxmemorydc} with wxBitmap selected into it that
	18	contains a mask.
	19
	20	\wxheading{See also}
	21
	22	\helpref{wxBitmap}{wxbitmap}, \helpref{wxDC::Blit}{wxdcblit}, \helpref{wxMemoryDC}{wxmemorydc}
	23
	24	\latexignore{\rtfignore{\wxheading{Members}}}
	25
	26	\membersection{wxMask::wxMask}\label{wxmaskconstr}
	27
	28	\func{}{wxMask}{\void}
	29
	30	Default constructor.
	31
	32	\func{}{wxMask}{\param{const wxBitmap\& }{bitmap}}
	33
	34	Constructs a mask from a monochrome bitmap.
	35
	36	\func{}{wxMask}{\param{const wxBitmap\& }{bitmap}, \param{const wxColour\& }{colour}}
	37
91b8de8d RR	38	Constructs a mask from a bitmap and a colour that indicates the background. Not
91b8de8d RR	39	yet implemented for GTK.
a660d684 KB	40
	41	\func{}{wxMask}{\param{const wxBitmap\& }{bitmap}, \param{int}{ index}}
	42
91b8de8d RR	43	Constructs a mask from a bitmap and a palette index that indicates the background. Not
91b8de8d RR	44	yet implemented for GTK.
a660d684 KB	45
	46	\wxheading{Parameters}
	47
	48	\docparam{bitmap}{A valid bitmap.}
	49
	50	\docparam{colour}{A colour specifying the transparency RGB values.}
	51
	52	\docparam{index}{Index into a palette, specifying the transparency colour.}
	53
	54	\membersection{wxMask::\destruct{wxMask}}
	55
	56	\func{}{\destruct{wxMask}}{\void}
	57
	58	Destroys the wxMask object and the underlying bitmap data.
	59
	60	\membersection{wxMask::Create}\label{wxmaskcreate}
	61
	62	\func{bool}{Create}{\param{const wxBitmap\& }{bitmap}}
	63
	64	Constructs a mask from a monochrome bitmap.
	65
	66	\func{bool}{Create}{\param{const wxBitmap\& }{bitmap}, \param{const wxColour\& }{colour}}
	67
91b8de8d RR	68	Constructs a mask from a bitmap and a colour that indicates the background. Not
91b8de8d RR	69	yet implemented for GTK.
a660d684 KB	70
	71	\func{bool}{Create}{\param{const wxBitmap\& }{bitmap}, \param{int}{ index}}
	72
91b8de8d RR	73	Constructs a mask from a bitmap and a palette index that indicates the background. Not
91b8de8d RR	74	yet implemented for GTK.
a660d684 KB	75
	76	\wxheading{Parameters}
	77
	78	\docparam{bitmap}{A valid bitmap.}
	79
	80	\docparam{colour}{A colour specifying the transparency RGB values.}
	81
	82	\docparam{index}{Index into a palette, specifying the transparency colour.}
	83
	84