X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/a61d25e6394cb952ce59bbfbc68db72a07069dd9..3aa5d53272727835f297450e153ed79dc132e48a:/docs/latex/wx/image.tex diff --git a/docs/latex/wx/image.tex b/docs/latex/wx/image.tex index 84845e8189..aa5589fcac 100644 --- a/docs/latex/wx/image.tex +++ b/docs/latex/wx/image.tex @@ -34,6 +34,7 @@ handler with \helpref{wxImage::AddHandler}{wximageaddhandler} or \twocolitem{\indexit{wxXPMHandler}}{For loading and saving.} \twocolitem{\indexit{wxICOHandler}}{For loading and saving.} \twocolitem{\indexit{wxCURHandler}}{For loading and saving.} +\twocolitem{\indexit{wxANIHandler}}{For loading and saving.} \end{twocollist} When saving in PCX format, {\bf wxPCXHandler} will count the number of @@ -122,6 +123,7 @@ Loads an image from an input stream. \twocolitem{\indexit{wxBITMAP\_TYPE\_XPM}}{Load a XPM bitmap file.} \twocolitem{\indexit{wxBITMAP\_TYPE\_ICO}}{Load a Windows icon file (ICO).} \twocolitem{\indexit{wxBITMAP\_TYPE\_CUR}}{Load a Windows cursor file (CUR).} +\twocolitem{\indexit{wxBITMAP\_TYPE\_ANI}}{Load a Windows animated cursor file (ANI).} \twocolitem{\indexit{wxBITMAP\_TYPE\_ANY}}{Will try to autodetect the format.} \end{twocollist}} @@ -143,8 +145,8 @@ initialized with \helpref{wxImage::AddHandler}{wximageaddhandler} or Note: you can use \helpref{GetOptionInt}{wximagegetoptionint} to get the hotspot for loaded cursor file: \begin{verbatim} - int hotspot_x = image.GetOptionInt(wxCUR_HOTSPOT_X); - int hotspot_y = image.GetOptionInt(wxCUR_HOTSPOT_Y); + int hotspot_x = image.GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_X); + int hotspot_y = image.GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_Y); \end{verbatim} @@ -203,6 +205,32 @@ Deletes all image handlers. This function is called by wxWindows on exit. +\membersection{wxImage::ComputeHistogram}\label{wximagecomputehistogram} + +\constfunc{unsigned long}{ComputeHistogram}{\param{wxImageHistogram\& }{histogram}} + +Computes the histogram of the image. {\it histogram} is a reference to +wxImageHistogram object. wxImageHistogram is a specialization of +\helpref{wxHashMap}{wxhashmap} "template" and is defined as follows: + +\begin{verbatim} +class WXDLLEXPORT wxImageHistogramEntry +{ +public: + wxImageHistogramEntry() : index(0), value(0) {} + unsigned long index; + unsigned long value; +}; + +WX_DECLARE_EXPORTED_HASH_MAP(unsigned long, wxImageHistogramEntry, + wxIntegerHash, wxIntegerEqual, + wxImageHistogram); +\end{verbatim} + +\wxheading{Return value} + +Returns number of colours in the histogram. + \membersection{wxImage::ConvertToBitmap}\label{wximageconverttobitmap} \constfunc{wxBitmap}{ConvertToBitmap}{\void} @@ -324,11 +352,11 @@ chararcters in RGBGBRGB... format. Returns the green intensity at the given coordinate. -\membersection{wxImage::GetImagesCount}\label{wximagegetimagescount} +\membersection{wxImage::GetImageCount}\label{wximagegetimagecount} -\func{static int}{GetImagesCount}{\param{const wxString\&}{ filename}, \param{long}{ type = wxBITMAP\_TYPE\_ANY}} +\func{static int}{GetImageCount}{\param{const wxString\&}{ filename}, \param{long}{ type = wxBITMAP\_TYPE\_ANY}} -\func{static int}{GetImagesCount}{\param{wxInputStream\&}{ stream}, \param{long}{ type = wxBITMAP\_TYPE\_ANY}} +\func{static int}{GetImageCount}{\param{wxInputStream\&}{ stream}, \param{long}{ type = wxBITMAP\_TYPE\_ANY}} If the image file contains more than one image and the image handler is capable of retrieving these individually, this function will return the number of @@ -352,6 +380,7 @@ available images. \twocolitem{\indexit{wxBITMAP\_TYPE\_XPM}}{Load a XPM bitmap file.} \twocolitem{\indexit{wxBITMAP\_TYPE\_ICO}}{Load a Windows icon file (ICO).} \twocolitem{\indexit{wxBITMAP\_TYPE\_CUR}}{Load a Windows cursor file (CUR).} +\twocolitem{\indexit{wxBITMAP\_TYPE\_ANI}}{Load a Windows animated cursor file (ANI).} \twocolitem{\indexit{wxBITMAP\_TYPE\_ANY}}{Will try to autodetect the format.} \end{twocollist}} @@ -534,6 +563,7 @@ Loads an image from an input stream. \twocolitem{{\bf wxBITMAP\_TYPE\_XPM}}{Load a XPM image file.} \twocolitem{{\bf wxBITMAP\_TYPE\_ICO}}{Load a Windows icon file (ICO).} \twocolitem{{\bf wxBITMAP\_TYPE\_CUR}}{Load a Windows cursor file (CUR).} +\twocolitem{\indexit{wxBITMAP\_TYPE\_ANI}}{Load a Windows animated cursor file (ANI).} \twocolitem{{\bf wxBITMAP\_TYPE\_ANY}}{Will try to autodetect the format.} \end{twocollist}} @@ -551,8 +581,8 @@ Depending on how wxWindows has been configured, not all formats may be available Note: you can use \helpref{GetOptionInt}{wximagegetoptionint} to get the hotspot for loaded cursor file: \begin{verbatim} - int hotspot_x = image.GetOptionInt(wxCUR_HOTSPOT_X); - int hotspot_y = image.GetOptionInt(wxCUR_HOTSPOT_Y); + int hotspot_x = image.GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_X); + int hotspot_y = image.GetOptionInt(wxIMAGE_OPTION_CUR_HOTSPOT_Y); \end{verbatim} @@ -607,15 +637,15 @@ TRUE if the handler was found and removed, FALSE otherwise. \membersection{wxImage::SaveFile}\label{wximagesavefile} -\func{bool}{SaveFile}{\param{const wxString\& }{name}, \param{int}{ type}} +\constfunc{bool}{SaveFile}{\param{const wxString\& }{name}, \param{int}{ type}} -\func{bool}{SaveFile}{\param{const wxString\& }{name}, \param{const wxString\&}{ mimetype}} +\constfunc{bool}{SaveFile}{\param{const wxString\& }{name}, \param{const wxString\&}{ mimetype}} Saves a image in the named file. -\func{bool}{SaveFile}{\param{wxOutputStream\& }{stream}, \param{int}{ type}} +\constfunc{bool}{SaveFile}{\param{wxOutputStream\& }{stream}, \param{int}{ type}} -\func{bool}{SaveFile}{\param{wxOutputStream\& }{stream}, \param{const wxString\&}{ mimetype}} +\constfunc{bool}{SaveFile}{\param{wxOutputStream\& }{stream}, \param{const wxString\&}{ mimetype}} Saves a image in the given stream. @@ -654,8 +684,8 @@ Note: you can use \helpref{GetOptionInt}{wximagegetoptionint} to set the hotspot before saving an image into a cursor file (default hotspot is in the centre of the image): \begin{verbatim} - image.SetOption(wxCUR_HOTSPOT_X, hotspotX); - image.SetOption(wxCUR_HOTSPOT_Y, hotspotY); + image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_X, hotspotX); + image.SetOption(wxIMAGE_OPTION_CUR_HOTSPOT_Y, hotspotY); \end{verbatim} @@ -943,9 +973,9 @@ Gets the name of this handler. Gets the file extension associated with this handler. -\membersection{wxImageHandler::GetImagesCount}\label{wximagehandlergetimagescount} +\membersection{wxImageHandler::GetImageCount}\label{wximagehandlergetimagecount} -\func{int}{GetImagesCount}{\param{wxInputStream\&}{ stream}} +\func{int}{GetImageCount}{\param{wxInputStream\&}{ stream}} If the image file contains more than one image and the image handler is capable of retrieving these individually, this function will return the number of