no need to export private list/arrays of generic controls' implementations

[wxWidgets.git] / interface / palette.h

diff --git a/interface/palette.h b/interface/palette.h
index b408669179c10fc09825768c14fe553dde1ce36a..6c8d61c460a7e3040495b957dd70fedc7d03c6ac 100644 (file)
--- a/interface/palette.h
+++ b/interface/palette.h
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        palette.h
 /////////////////////////////////////////////////////////////////////////////
 // Name:        palette.h

-// Purpose:     documentation for wxPalette class
+// Purpose:     interface of wxPalette

 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license


@@ -9,29 +9,27 @@
 /**
     @class wxPalette
     @wxheader{palette.h}
 /**
     @class wxPalette
     @wxheader{palette.h}

-    
+

     A palette is a table that maps pixel values to RGB colours. It allows the
     colours of a low-depth bitmap, for example, to be mapped to the available
     colours in a display. The notion of palettes is becoming more and more
     obsolete nowadays and only the MSW port is still using a native palette.
     All other ports use generic code which is basically just an array of
     A palette is a table that maps pixel values to RGB colours. It allows the
     colours of a low-depth bitmap, for example, to be mapped to the available
     colours in a display. The notion of palettes is becoming more and more
     obsolete nowadays and only the MSW port is still using a native palette.
     All other ports use generic code which is basically just an array of

-    colours. 
-    
+    colours.
+

     It is likely that in the future the only use for palettes within wxWidgets
     will be for representing colour indeces from images (such as GIF or PNG).
     The image handlers for these formats have been modified to create a palette
     if there is such information in the original image file (usually 256 or less
     colour images). See wxImage for more information.
     It is likely that in the future the only use for palettes within wxWidgets
     will be for representing colour indeces from images (such as GIF or PNG).
     The image handlers for these formats have been modified to create a palette
     if there is such information in the original image file (usually 256 or less
     colour images). See wxImage for more information.

-    
+

     @library{wxcore}
     @category{gdi}
     @library{wxcore}
     @category{gdi}

-    
+

     @stdobjects
     @stdobjects

-    Objects:
-    wxNullPalette
-    
-    @seealso
-    wxDC::SetPalette, wxBitmap
+    ::Objects:, ::wxNullPalette,
+
+    @see wxDC::SetPalette, wxBitmap

 */
 class wxPalette : public wxGDIObject
 {
 */
 class wxPalette : public wxGDIObject
 {


@@ -40,29 +38,25 @@ public:
     /**
         Creates a palette from arrays of size @e n, one for each
         red, blue or green component.
     /**
         Creates a palette from arrays of size @e n, one for each
         red, blue or green component.

-        
-        @param palette 
-        A pointer or reference to the palette to copy.
-        
-        @param n 
-        The number of indices in the palette.
-        
-        @param red 
-        An array of red values.
-        
-        @param green 
-        An array of green values.
-        
-        @param blue 
-        An array of blue values.
-        
-        @sa Create()
+
+        @param palette
+            A pointer or reference to the palette to copy.
+        @param n
+            The number of indices in the palette.
+        @param red
+            An array of red values.
+        @param green
+            An array of green values.
+        @param blue
+            An array of blue values.
+
+        @see Create()

     */
     wxPalette();
     */
     wxPalette();

-        wxPalette(const wxPalette& palette);
-        wxPalette(int n, const unsigned char* red,
-                  const unsigned char* green,
-                  const unsigned char* blue);
+    wxPalette(const wxPalette& palette);
+    wxPalette(int n, const unsigned char* red,
+              const unsigned char* green,
+              const unsigned char* blue);

     //@}
 
     /**
     //@}
 
     /**


@@ -75,22 +69,19 @@ public:
     /**
         Creates a palette from arrays of size @e n, one for each
         red, blue or green component.
     /**
         Creates a palette from arrays of size @e n, one for each
         red, blue or green component.

-        
-        @param n 
-        The number of indices in the palette.
-        
-        @param red 
-        An array of red values.
-        
-        @param green 
-        An array of green values.
-        
-        @param blue 
-        An array of blue values.
-        
+
+        @param n
+            The number of indices in the palette.
+        @param red
+            An array of red values.
+        @param green
+            An array of green values.
+        @param blue
+            An array of blue values.
+

         @returns @true if the creation was successful, @false otherwise.
         @returns @true if the creation was successful, @false otherwise.

-        
-        @sa wxPalette()
+
+        @see wxPalette()

     */
     bool Create(int n, const unsigned char* red,
                 const unsigned char* green,
     */
     bool Create(int n, const unsigned char* red,
                 const unsigned char* green,


@@ -99,57 +90,66 @@ public:
     /**
         Returns number of entries in palette.
     */
     /**
         Returns number of entries in palette.
     */

-    int GetColoursCount();
+    int GetColoursCount() const;

 
     /**
         Returns a pixel value (index into the palette) for the given RGB values.
 
     /**
         Returns a pixel value (index into the palette) for the given RGB values.

-        
-        @param red 
-        Red value.
-        
-        @param green 
-        Green value.
-        
-        @param blue 
-        Blue value.
-        
+
+        @param red
+            Red value.
+        @param green
+            Green value.
+        @param blue
+            Blue value.
+

         @returns The nearest palette index or wxNOT_FOUND for unexpected errors.
         @returns The nearest palette index or wxNOT_FOUND for unexpected errors.

-        
-        @sa GetRGB()
+
+        @see GetRGB()

     */
     int GetPixel(unsigned char red, unsigned char green,
     */
     int GetPixel(unsigned char red, unsigned char green,

-                 unsigned char blue);
+                 unsigned char blue) const;

 
     /**
         Returns RGB values for a given palette index.
 
     /**
         Returns RGB values for a given palette index.

-        
-        @param pixel 
-        The palette index.
-        
-        @param red 
-        Receives the red value.
-        
-        @param green 
-        Receives the green value.
-        
-        @param blue 
-        Receives the blue value.
-        
+
+        @param pixel
+            The palette index.
+        @param red
+            Receives the red value.
+        @param green
+            Receives the green value.
+        @param blue
+            Receives the blue value.
+

         @returns @true if the operation was successful.
         @returns @true if the operation was successful.

-        
-        @sa GetPixel()
+
+        @see GetPixel()

     */
     */

-#define bool GetRGB(int pixel, const unsigned char* red,
+    bool GetRGB(int pixel, const unsigned char* red,

                 const unsigned char* green,
                 const unsigned char* green,

-                const unsigned char* blue)     /* implementation is private */
+                const unsigned char* blue) const;

 
     /**
         Returns @true if palette data is present.
     */
 
     /**
         Returns @true if palette data is present.
     */

-#define bool IsOk()     /* implementation is private */
+    bool IsOk() const;

 
     /**
         Assignment operator, using @ref overview_trefcount "reference counting".
     */
     wxPalette operator =(const wxPalette& palette);
 };
 
     /**
         Assignment operator, using @ref overview_trefcount "reference counting".
     */
     wxPalette operator =(const wxPalette& palette);
 };

+
+
+/**
+    FIXME
+*/
+wxPalette Objects:
+;
+
+/**
+    FIXME
+*/
+wxPalette wxNullPalette;
+
+