Implement monitoring of file descriptors in wxMotif event loop.

[wxWidgets.git] / interface / wx / animate.h

diff --git a/interface/wx/animate.h b/interface/wx/animate.h
index 0c071c5a56feb8006705769e2b7972d259d6ba5d..77d5ecf423bcd835258ab1810a4ab41d7c1f2953 100644 (file)
--- a/interface/wx/animate.h
+++ b/interface/wx/animate.h
@@ -3,7 +3,7 @@
 // Purpose:     interface of wxAnimation* classes
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Purpose:     interface of wxAnimation* classes
 // Author:      wxWidgets team
 // RCS-ID:      $Id$

-// Licence:     wxWindows license
+// Licence:     wxWindows licence

 /////////////////////////////////////////////////////////////////////////////
 
 /**
 /////////////////////////////////////////////////////////////////////////////
 
 /**


@@ -23,6 +23,11 @@ enum wxAnimationType
     wxANIMATION_TYPE_ANY
 };
 
     wxANIMATION_TYPE_ANY
 };
 

+
+#define wxAC_NO_AUTORESIZE       (0x0010)
+#define wxAC_DEFAULT_STYLE       (wxBORDER_NONE)
+
+

 /**
     @class wxAnimationCtrl
 
 /**
     @class wxAnimationCtrl
 


@@ -49,7 +54,7 @@ enum wxAnimationType
 
     @nativeimpl{wxgtk,wxmsw}
 
 
     @nativeimpl{wxgtk,wxmsw}
 

-    <!-- @appearance{animationctrl.png} -->
+    @appearance{animationctrl}

 
     @see wxAnimation, @sample{animate}
 */
 
     @see wxAnimation, @sample{animate}
 */


@@ -70,7 +75,7 @@ public:
     /**
         Creates the control with the given @a anim animation.
 
     /**
         Creates the control with the given @a anim animation.
 

-        After control creation you must explicitely call Play() to start to play
+        After control creation you must explicitly call Play() to start to play

         the animation. Until that function won't be called, the first frame
         of the animation is displayed.
 
         the animation. Until that function won't be called, the first frame
         of the animation is displayed.
 


@@ -181,6 +186,12 @@ public:
     An animation is a sequence of frames of the same size.
     Sound is not supported by wxAnimation.
 
     An animation is a sequence of frames of the same size.
     Sound is not supported by wxAnimation.
 

+    Note that on wxGTK wxAnimation is capable of loading the formats supported
+    by the internally-used @c gdk-pixbuf library (typically this means only
+    @c wxANIMATION_TYPE_GIF).
+    On other platforms wxAnimation is always capable of loading both GIF and ANI
+    formats (i.e. both @c wxANIMATION_TYPE_GIF and @c wxANIMATION_TYPE_ANI).
+

     @library{wxadv}
     @category{gdi}
 
     @library{wxadv}
     @category{gdi}
 


@@ -189,9 +200,14 @@ public:
 
     @see wxAnimationCtrl, @sample{animate}
 */
 
     @see wxAnimationCtrl, @sample{animate}
 */

-class wxAnimation : public wxGDIObject
+class wxAnimation : public wxObject

 {
 public:
 {
 public:

+    /**
+       Default ctor.
+    */
+    wxAnimation();
+    

     /**
         Copy ctor.
     */
     /**
         Copy ctor.
     */


@@ -203,7 +219,7 @@ public:
         @param name
             The name of the file to load.
         @param type
         @param name
             The name of the file to load.
         @param type

-            See LoadFile for more info.
+            See LoadFile() for more info.

     */
     wxAnimation(const wxString& name,
                 wxAnimationType type = wxANIMATION_TYPE_ANY);
     */
     wxAnimation(const wxString& name,
                 wxAnimationType type = wxANIMATION_TYPE_ANY);


@@ -222,11 +238,17 @@ public:
 
     /**
         Returns the i-th frame as a wxImage.
 
     /**
         Returns the i-th frame as a wxImage.

+
+        This method is not implemented in the native wxGTK implementation of
+        this class and always returns an invalid image there.

     */
     virtual wxImage GetFrame(unsigned int i) const;
 
     /**
         Returns the number of frames for this animation.
     */
     virtual wxImage GetFrame(unsigned int i) const;
 
     /**
         Returns the number of frames for this animation.

+
+        This method is not implemented in the native wxGTK implementation of
+        this class and always returns 0 there.

     */
     virtual unsigned int GetFrameCount() const;
 
     */
     virtual unsigned int GetFrameCount() const;
 


@@ -245,11 +267,10 @@ public:
 
         @param stream
             The stream to use to load the animation.
 
         @param stream
             The stream to use to load the animation.

+            Under wxGTK may be any kind of stream; under other platforms
+            this must be a seekable stream.

         @param type
         @param type

-            One of the following values:
-             @li wxANIMATION_TYPE_GIF: loads an animated GIF file;
-             @li wxANIMATION_TYPE_ANI: load an ANI file;
-             @li wxANIMATION_TYPE_ANY: tries to autodetect the filetype.
+            One of the ::wxAnimationType enumeration values.

 
         @return @true if the operation succeeded, @false otherwise.
     */
 
         @return @true if the operation succeeded, @false otherwise.
     */


@@ -262,7 +283,7 @@ public:
         @param name
             A filename.
         @param type
         @param name
             A filename.
         @param type

-            One of the wxAnimationType values; wxANIMATION_TYPE_ANY
+            One of the ::wxAnimationType values; wxANIMATION_TYPE_ANY

             means that the function should try to autodetect the filetype.
 
         @return @true if the operation succeeded, @false otherwise.
             means that the function should try to autodetect the filetype.
 
         @return @true if the operation succeeded, @false otherwise.