X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/4fa0a5b44341885a0886f2ae6723d2441bd1f62f..649a48a216a3f373344826253ba43819555a60ee:/docs/latex/wx/image.tex diff --git a/docs/latex/wx/image.tex b/docs/latex/wx/image.tex index 574391e7c1..5f2dd48af5 100644 --- a/docs/latex/wx/image.tex +++ b/docs/latex/wx/image.tex @@ -18,7 +18,7 @@ creation of a \helpref{wxMask}{wxmask} object associated to the bitmap object. \wxheading{Available image handlers} The following image handlers are available. {\bf wxBMPHandler} is always -installed by default. To use other image formats, install the appropiate +installed by default. To use other image formats, install the appropriate handler with \helpref{wxImage::AddHandler}{wximageaddhandler} or \helpref{wxInitAllImageHandlers}{wxinitallimagehandlers}. @@ -349,7 +349,10 @@ Returns the blue intensity at the given coordinate. Returns the image data as an array. This is most often used when doing direct image manipulation. The return value points to an array of -chararcters in RGBGBRGB... format. +characters in RGBRGBRGB$\ldots$ format. + +You should not delete the returned pointer nor pass it to +\helpref{wxImage::SetData}{wximagesetdata}. \membersection{wxImage::GetGreen}\label{wximagegetgreen} @@ -810,6 +813,13 @@ Sets the image data without performing checks. The data given must have the size (width*height*3) or results will be unexpected. Don't use this method if you aren't sure you know what you are doing. +The data must have been allocated with malloc(), NOT with operator new. + +After this call the pointer to the data is owned by the wxImage object, +that will be responsible for deleting it. +Do not pass to this function a pointer obtained through +\helpref{wxImage::GetData}{wximagegetdata}. + \membersection{wxImage::SetMask}\label{wximagesetmask} \func{void}{SetMask}{\param{bool}{ hasMask = TRUE}} @@ -901,7 +911,7 @@ Returns 'this' object. \membersection{wxImage::operator $==$} -\func{bool}{operator $==$}{\param{const wxImage\& }{image}} +\constfunc{bool}{operator $==$}{\param{const wxImage\& }{image}} Equality operator. This operator tests whether the internal data pointers are equal (a fast test). @@ -916,7 +926,7 @@ Returns TRUE if the images were effectively equal, FALSE otherwise. \membersection{wxImage::operator $!=$} -\func{bool}{operator $!=$}{\param{const wxImage\& }{image}} +\constfunc{bool}{operator $!=$}{\param{const wxImage\& }{image}} Inequality operator. This operator tests whether the internal data pointers are unequal (a fast test).