]> git.saurik.com Git - wxWidgets.git/commitdiff
Added wxQuantize, wxTipWindow, wxSplashScreen docs
authorJulian Smart <julian@anthemion.co.uk>
Mon, 9 Oct 2000 14:31:03 +0000 (14:31 +0000)
committerJulian Smart <julian@anthemion.co.uk>
Mon, 9 Oct 2000 14:31:03 +0000 (14:31 +0000)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@8499 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

docs/latex/wx/bitmap.tex
docs/latex/wx/category.tex
docs/latex/wx/classes.tex
docs/latex/wx/helpprov.tex
docs/latex/wx/hprovcnt.tex
docs/latex/wx/hprovsmp.tex
docs/latex/wx/quantize.tex [new file with mode: 0644]
docs/latex/wx/splash.tex [new file with mode: 0644]
docs/latex/wx/tipwin.tex [new file with mode: 0644]

index b639c4d397a0177ec9c3a3b570c96db903cacd8c..76b74824e16cf81297ad167d3050276b4d8c1eda 100644 (file)
@@ -10,7 +10,7 @@ either monochrome or colour.
 \helpref{wxGDIObject}{wxgdiobject}\\
 \helpref{wxObject}{wxobject}
 
 \helpref{wxGDIObject}{wxgdiobject}\\
 \helpref{wxObject}{wxobject}
 
-\wxheading{Include files}
+\wxheading{Include file}
 
 <wx/bitmap.h>
 
 
 <wx/bitmap.h>
 
index dc38e4f0012ff0f8eabeec1a508506f6c4e19d9e..37611eab9d50f703cd9b41ec7a9f2260f396bb1d 100644 (file)
@@ -14,12 +14,14 @@ Frames may contain windows, and dialog boxes may directly contain controls.
 \begin{twocollist}\itemsep=0pt
 \twocolitem{\helpref{wxDialog}{wxdialog}}{Dialog box}
 \twocolitem{\helpref{wxFrame}{wxframe}}{Normal frame}
 \begin{twocollist}\itemsep=0pt
 \twocolitem{\helpref{wxDialog}{wxdialog}}{Dialog box}
 \twocolitem{\helpref{wxFrame}{wxframe}}{Normal frame}
-\twocolitem{\helpref{wxMDIParentFrame}{wxmdiparentframe}}{MDI parent frame}
 \twocolitem{\helpref{wxMDIChildFrame}{wxmdichildframe}}{MDI child frame}
 \twocolitem{\helpref{wxMDIChildFrame}{wxmdichildframe}}{MDI child frame}
+\twocolitem{\helpref{wxMDIParentFrame}{wxmdiparentframe}}{MDI parent frame}
 \twocolitem{\helpref{wxMiniFrame}{wxminiframe}}{A frame with a small title bar}
 \twocolitem{\helpref{wxMiniFrame}{wxminiframe}}{A frame with a small title bar}
-\twocolitem{\helpref{wxWizard}{wxwizard}}{A wizard dialog.}
+\twocolitem{\helpref{wxSplashScreen}{wxsplashscreen}}{Splash screen class}
 \twocolitem{\helpref{wxTabbedDialog}{wxtabbeddialog}}{Tabbed dialog
 (deprecated, use wxNotebook instead)}
 \twocolitem{\helpref{wxTabbedDialog}{wxtabbeddialog}}{Tabbed dialog
 (deprecated, use wxNotebook instead)}
+\twocolitem{\helpref{wxTipWindow}{wxtipwindow}}{Shows text in a small window}
+\twocolitem{\helpref{wxWizard}{wxwizard}}{A wizard dialog}
 \end{twocollist}
 
 See also {\bf Common dialogs}.
 \end{twocollist}
 
 See also {\bf Common dialogs}.
@@ -510,6 +512,7 @@ used internally by the HTML classes.
 \twocolitem{\helpref{wxFontMapper}{wxfontmapper}}{Font mapping, finding suitable font for given encoding}
 \twocolitem{\helpref{wxEncodingConverter}{wxencodingconverter}}{Encoding conversions}
 \twocolitem{\helpref{wxCalendarDateAttr}{wxcalendardateattr}}{Used with \helpref{wxCalendarCtrl}{wxcalendarctrl}}
 \twocolitem{\helpref{wxFontMapper}{wxfontmapper}}{Font mapping, finding suitable font for given encoding}
 \twocolitem{\helpref{wxEncodingConverter}{wxencodingconverter}}{Encoding conversions}
 \twocolitem{\helpref{wxCalendarDateAttr}{wxcalendardateattr}}{Used with \helpref{wxCalendarCtrl}{wxcalendarctrl}}
+\twocolitem{\helpref{wxQuantize}{wxquantize}}{Class to perform quantization, or colour reduction}
 \end{twocollist}
 
 {\large {\bf Database classes}}
 \end{twocollist}
 
 {\large {\bf Database classes}}
index 9503bd0952997e80e5243f0cc420f9e651a492a7..351e869f6f3f31a5874c2a583a361f6da3c52b00 100644 (file)
 \input propval.tex
 \input propview.tex
 \input protocol.tex
 \input propval.tex
 \input propview.tex
 \input protocol.tex
+\input quantize.tex
 \input query.tex
 \input qylayevt.tex
 \input radiobox.tex
 \input query.tex
 \input qylayevt.tex
 \input radiobox.tex
 \input spinbutt.tex
 \input spinctrl.tex
 \input spinevt.tex
 \input spinbutt.tex
 \input spinctrl.tex
 \input spinevt.tex
+\input splash.tex
 \input splitevt.tex
 \input splitter.tex
 \input statbmp.tex
 \input splitevt.tex
 \input splitter.tex
 \input statbmp.tex
 \input time.tex
 \input timer.tex
 \input tipprov.tex
 \input time.tex
 \input timer.tex
 \input tipprov.tex
+\input tipwin.tex
 \input toolbar.tex
 \input tooltip.tex
 \input treectrl.tex
 \input toolbar.tex
 \input tooltip.tex
 \input treectrl.tex
index ba99934fa42341c9cb71fa224e380a0e09b092d6..e338064bfdb8392066bc17b0f47de757b7697696 100644 (file)
@@ -10,6 +10,10 @@ wxHelpProvider::Set().
 
 No base class
 
 
 No base class
 
+\wxheading{Include files}
+
+<wx/cshelp.h>
+
 \wxheading{See also}
 
 \helpref{wxContextHelp}{wxcontexthelp}, \helpref{wxContextHelpButton}{wxcontexthelpbutton}, 
 \wxheading{See also}
 
 \helpref{wxContextHelp}{wxcontexthelp}, \helpref{wxContextHelpButton}{wxcontexthelpbutton}, 
index a1146f9ab706f91757d9b6eeb1c054537c9ddf5d..f5df37c824f4fe2932838bb340fec19f86b0a69c 100644 (file)
@@ -3,7 +3,8 @@
 wxHelpControllerHelpProvider is an implementation of wxHelpProvider which supports
 both context identifiers and plain text help strings. If the help text is an integer,
 it is passed to wxHelpController::DisplayContextPopup. Otherwise, it shows the string
 wxHelpControllerHelpProvider is an implementation of wxHelpProvider which supports
 both context identifiers and plain text help strings. If the help text is an integer,
 it is passed to wxHelpController::DisplayContextPopup. Otherwise, it shows the string
-in a tooltip as per wxSimpleHelpProvider.
+in a tooltip as per wxSimpleHelpProvider. If you use this with a wxCHMHelpController instance
+on windows, it will use the native style of tip window instead of \helpref{wxTipWindow}{wxtipwindow}.
 
 You can use the convenience function {\bf wxContextId} to convert an integer context
 id to a string for passing to \helpref{wxWindow::SetHelpText}{wxwindowsethelptext}.
 
 You can use the convenience function {\bf wxContextId} to convert an integer context
 id to a string for passing to \helpref{wxWindow::SetHelpText}{wxwindowsethelptext}.
@@ -13,6 +14,10 @@ id to a string for passing to \helpref{wxWindow::SetHelpText}{wxwindowsethelptex
 \helpref{wxSimpleHelpProvider}{wxsimplehelpprovider}\\
 \helpref{wxHelpProvider}{wxhelpprovider}
 
 \helpref{wxSimpleHelpProvider}{wxsimplehelpprovider}\\
 \helpref{wxHelpProvider}{wxhelpprovider}
 
+\wxheading{Include files}
+
+<wx/cshelp.h>
+
 \wxheading{See also}
 
 \helpref{wxHelpProvider}{wxhelpprovider}, \helpref{wxSimpleHelpProvider}{wxsimplehelpprovider}, 
 \wxheading{See also}
 
 \helpref{wxHelpProvider}{wxhelpprovider}, \helpref{wxSimpleHelpProvider}{wxsimplehelpprovider}, 
index 116d8d4692a6ee2802c89c9c5ae144ac66a6bb0c..25f77bec0ed855e56379f63b88fd17a87be15352 100644 (file)
@@ -8,6 +8,10 @@ control (if any) in a tooltip.
 
 \helpref{wxHelpProvider}{wxhelpprovider}
 
 
 \helpref{wxHelpProvider}{wxhelpprovider}
 
+\wxheading{Include files}
+
+<wx/cshelp.h>
+
 \wxheading{See also}
 
 \helpref{wxHelpProvider}{wxhelpprovider}, \helpref{wxHelpControllerHelpProvider}{wxhelpcontrollerhelpprovider}, 
 \wxheading{See also}
 
 \helpref{wxHelpProvider}{wxhelpprovider}, \helpref{wxHelpControllerHelpProvider}{wxhelpcontrollerhelpprovider}, 
diff --git a/docs/latex/wx/quantize.tex b/docs/latex/wx/quantize.tex
new file mode 100644 (file)
index 0000000..3306572
--- /dev/null
@@ -0,0 +1,49 @@
+\section{\class{wxQuantize}}\label{wxquantize}
+
+Performs quantization, or colour reduction, on a wxImage.
+
+Functions in this class are static and so a wxQuantize object need not be created.
+
+\wxheading{Derived from}
+
+\helpref{wxObject}{wxobject}
+
+\wxheading{Include files}
+
+<wx/quantize.h>
+
+\latexignore{\rtfignore{\wxheading{Members}}}
+
+\membersection{wxQuantize::wxQuantize}\label{wxquantizewxquantize}
+
+\func{}{wxQuantize}{\void}
+
+Constructor. You do not need to construct a wxQuantize object since its functions are static.
+
+\membersection{wxQuantize::Quantize}\label{wxquantizequantize}
+
+\func{bool}{Quantize}{\param{const wxImage\& }{src}, \param{wxImage\& }{dest}, \param{wxPalette** }{pPalette}, \param{int }{desiredNoColours = 236}, \param{unsigned char** }{eightBitData = 0}, \param{int }{flags = wxQUANTIZE\_INCLUDE\_WINDOWS\_COLOURS|wxQUANTIZE\_FILL\_DESTINATION\_IMAGE|wxQUANTIZE\_RETURN\_8BIT\_DATA}}
+
+Reduce the colours in the source image and put the result into the
+destination image. Both images may be the same, to overwrite the source image.
+Specify an optional palette pointer to receive the resulting palette.
+This palette may be passed to ConvertImageToBitmap, for example.
+
+If you pass a palette pointer, you must free the palette yourself.
+
+\func{bool}{Quantize}{\param{const wxImage\& }{src}, \param{wxImage\& }{dest}, \param{int }{desiredNoColours = 236}, \param{unsigned char** }{eightBitData = 0}, \param{int }{flags = wxQUANTIZE\_INCLUDE\_WINDOWS\_COLOURS|wxQUANTIZE\_FILL\_DESTINATION\_IMAGE|wxQUANTIZE\_RETURN\_8BIT\_DATA}}
+
+This version sets a palette in the destination image so you don't
+have to manage it yourself.
+
+\membersection{wxQuantize::DoQuantize}\label{wxquantizedoquantize}
+
+\func{void}{DoQuantize}{\param{unsigned }{w}, \param{unsigned }{h}, \param{unsigned char** }{in\_rows}, \param{unsigned char** }{out\_rows}, \param{unsigned char* }{palette}, \param{int }{desiredNoColours}}
+
+Converts input bitmap(s) into 8bit representation with custom palette.
+
+in\_rows and out\_rows are arrays [0..h-1] of pointer to rows
+(in\_rows contains w * 3 bytes per row, out\_rows w bytes per row).
+
+Fills out\_rows with indexes into palette (which is also stored into palette variable).
+
diff --git a/docs/latex/wx/splash.tex b/docs/latex/wx/splash.tex
new file mode 100644 (file)
index 0000000..cd0193b
--- /dev/null
@@ -0,0 +1,83 @@
+\section{\class{wxSplashScreen}}\label{wxsplashscreen}
+
+wxSplashScreen shows a window with a thin border, displaying a bitmap describing your
+application. Show it in application initialisation, and then either explicitly destroy
+it or let it time-out.
+
+Example usage:
+
+\begin{verbatim}
+  wxBitmap bitmap;
+  if (bitmap.LoadFile("splash16.png", wxBITMAP_TYPE_PNG))
+  {
+      wxSplashScreen* splash = new wxSplashScreen(bitmap,
+          wxSPLASH_CENTRE_ON_SCREEN|wxSPLASH_TIMEOUT,
+          6000, NULL, -1, wxDefaultPosition, wxDefaultSize,
+          wxSIMPLE_BORDER|wxSTAY_ON_TOP);
+  }
+  wxYield();
+\end{verbatim}
+\wxheading{Derived from}
+
+\helpref{wxFrame}{wxframe}\\
+\helpref{wxWindow}{wxwindow}\\
+\helpref{wxEvtHandler}{wxevthandler}\\
+\helpref{wxObject}{wxobject}
+
+\wxheading{Include files}
+
+<wx/splash.h>
+
+\latexignore{\rtfignore{\wxheading{Members}}}
+
+\membersection{wxSplashScreen::wxSplashScreen}\label{wxsplashscreenwxsplashscreen}
+
+\func{}{wxSplashScreen}{\param{const wxBitmap\& }{bitmap}, \param{long }{splashStyle}, \param{int }{milliseconds}, \param{wxWindow* }{parent}, \param{wxWindowID }{id}, \param{const wxPoint\& }{pos = wxDefaultPosition}, \param{const wxSize\& }{size = wxDefaultSize}, \param{long }{style = wxSIMPLE\_BORDER}}
+
+Construct the splash screen passing a bitmap, a style, a timeout, a window id, optional position
+and size, and a window style.
+
+{\it splashStyle} is a bitlist of some of the following:
+
+\begin{itemize}\itemsep=0pt
+\item wxSPLASH\_CENTRE\_ON\_PARENT
+\item wxSPLASH\_CENTRE\_ON\_SCREEN
+\item wxSPLASH\_NO\_CENTRE
+\item wxSPLASH\_TIMEOUT
+\item wxSPLASH\_NO\_TIMEOUT
+\end{itemize}
+
+{\it milliseconds} is the timeout in milliseconds.
+
+\membersection{wxSplashScreen::\destruct{wxSplashScreen}}\label{wxsplashscreendtor}
+
+\func{}{\destruct{wxSplashScreen}}{\void}
+
+Destroys the splash screen.
+
+\membersection{wxSplashScreen::OnCloseWindow}\label{wxsplashscreenonclosewindow}
+
+\func{void}{OnCloseWindow}{\param{wxCloseEvent\& }{event}}
+
+Reimplement this event handler if you want to set an application variable on window destruction, for example.
+
+\membersection{wxSplashScreen::GetSplashStyle}\label{wxsplashscreengetsplashstyle}
+
+\constfunc{long}{GetSplashStyle}{\void}
+
+Returns the splash style (see \helpref{wxSplashScreen::wxSplashScreen}{wxsplashscreenwxsplashscreen} for
+details).
+
+\membersection{wxSplashScreen::GetSplashWindow}\label{wxsplashscreengetsplashwindow}
+
+\constfunc{wxSplashScreenWindow*}{GetSplashWindow}{\void}
+
+Returns the window used to display the bitmap.
+
+\membersection{wxSplashScreen::GetTimeout}\label{wxsplashscreengettimeout}
+
+\constfunc{int}{GetTimeout}{\void}
+
+Returns the timeout in milliseconds.
+
diff --git a/docs/latex/wx/tipwin.tex b/docs/latex/wx/tipwin.tex
new file mode 100644 (file)
index 0000000..602af2b
--- /dev/null
@@ -0,0 +1,34 @@
+\section{\class{wxTipWindow}}\label{wxtipwindow}
+
+Shows simple text in a popup tip window on creation. This is used by \helpref{wxSimpleHelpProvider}{wxsimplehelpprovider} to
+show popup help. The window automatically destroys itself when the user clicks on it or it loses
+the focus.
+
+You should not normally need to use it explicitly in your application since a help provider class
+will create it when required.
+
+\wxheading{Derived from}
+
+\helpref{wxFrame}{wxframe}\\
+\helpref{wxWindow}{wxwindow}\\
+\helpref{wxEvtHandler}{wxevthandler}\\
+\helpref{wxObject}{wxobject}
+
+\wxheading{Include files}
+
+<wx/tipwin.h>
+
+\latexignore{\rtfignore{\wxheading{Members}}}
+
+\membersection{wxTipWindow::wxTipWindow}\label{wxtipwindowwxtipwindow}
+
+\func{}{wxTipWindow}{\param{wxWindow* }{parent}, \param{const wxString\& }{text}, \param{wxCoord }{maxLength = 100}}
+
+Constructor. The tip is shown immediately the window is constructed.
+
+\membersection{wxTipWindow::Adjust}\label{wxtipwindowadjust}
+
+\func{void}{Adjust}{\param{const wxString\& }{text}, \param{wxCoord }{maxLength}}
+
+Calculates the client rect we need to display the text.
+