X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/55ccdb93e4ae4b606a4068cb37492c1ec3ed77a6..c944775f72435d2c0493113e05445898ab8baf1b:/docs/latex/wx/image.tex diff --git a/docs/latex/wx/image.tex b/docs/latex/wx/image.tex index a15f1a6f7b..8a7721ff5d 100644 --- a/docs/latex/wx/image.tex +++ b/docs/latex/wx/image.tex @@ -36,10 +36,12 @@ means that the pixel is 100\% opaque. Unlike RGB data, not all images have an alpha channel and before using \helpref{GetAlpha}{wximagegetalpha} you should check if this image contains -an alpha channel with \helpref{HasAlpha}{wximagehasalpha}. Note that currently only -images loaded from PNG files with transparency information will have an alpha -channel but alpha support will be added to the other formats as well (as well -as support for saving images with alpha channel which also isn't implemented). +an alpha channel with \helpref{HasAlpha}{wximagehasalpha}. Note that currently +only the PNG format has full alpha channel support so only the images loaded +from PNG files can have alpha and, if you initialize the image alpha channel +yourself using \helpref{SetAlpha}{wximagesetalpha}, you should save it in PNG +format to avoid losing it. + \wxheading{Available image handlers} @@ -80,6 +82,10 @@ PNM format, {\bf wxPNMHandler} will always save as raw RGB. +\wxheading{Library} + +\helpref{wxCore}{librarieslist} + \wxheading{See also} \helpref{wxBitmap}{wxbitmap}, @@ -474,7 +480,7 @@ It is usually a good idea to prepend a description before passing the result to Example: \begin{verbatim} - wxFileDialog FileDlg( this, "Choose Image", ::wxGetCwd(), "", _("Image Files ") + wxImage::GetImageExtWildcard(), wxOPEN ); + wxFileDialog FileDlg( this, "Choose Image", ::wxGetCwd(), "", _("Image Files ") + wxImage::GetImageExtWildcard(), wxFD_OPEN ); \end{verbatim} \wxheading{See also} @@ -775,7 +781,8 @@ the user. \wxheading{See also} \helpref{wxImageHandler}{wximagehandler}, -\helpref{wxInitAllImageHandlers}{wxinitallimagehandlers} +\helpref{wxInitAllImageHandlers}{wxinitallimagehandlers}, +\helpref{wxQuantize}{wxquantize} \membersection{wxImage::InsertHandler}\label{wximageinserthandler} @@ -939,6 +946,12 @@ Returns a mirrored copy of the image. The parameter {\it horizontally} indicates the orientation. +\membersection{wxImage::Paste}\label{wximagepaste} + +\func{void}{Paste}{\param{const wxImage\& }{image}, \param{int }{x}, \param{int }{y}} + +Copy the data of the given \arg{image} to the specified position in this image. + \membersection{wxImage::Replace}\label{wximagereplace} \func{void}{Replace}{\param{unsigned char}{ r1}, \param{unsigned char}{ g1}, \param{unsigned char}{ b1}, @@ -1153,8 +1166,10 @@ Returns a resized version of this image without scaling it by adding either a bo with the given colour or cropping as necessary. The image is pasted into a new image with the given {\it size} and background colour at the position {\it pos} relative to the upper left of the new image. If {\it red = green = blue = -1} -then use either the current mask colour if set or find, use, and set a -suitable mask colour for any newly exposed areas. +then the areas of the larger image not covered by this image are made +transparent by filling them with the image mask colour (which will be allocated +automatically if it isn't currently set). Otherwise, the areas will be filled +with the colour with the specified RGB components. \wxheading{See also} @@ -1326,6 +1341,10 @@ created by IJG.) +\wxheading{Library} + +\helpref{wxCore}{librarieslist} + \wxheading{See also} \helpref{wxImage}{wximage},