Documentation updates for Animation classes

This commit is contained in:
Robin Dunn
2020-03-30 15:26:52 -07:00
parent 1608fde659
commit f13c3dc1ec

View File

@@ -65,7 +65,7 @@ public:
all the parameters. all the parameters.
*/ */
wxGenericAnimationCtrl(wxWindow* parent, wxWindowID id, wxGenericAnimationCtrl(wxWindow* parent, wxWindowID id,
const wxGenericAnimation& anim = wxNullAnimation, const wxGenericAnimation& anim = wxNullGenericAnimation,
const wxPoint& pos = wxDefaultPosition, const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize, const wxSize& size = wxDefaultSize,
long style = wxAC_DEFAULT_STYLE, long style = wxAC_DEFAULT_STYLE,
@@ -97,7 +97,7 @@ public:
creation failed. creation failed.
*/ */
bool Create(wxWindow* parent, wxWindowID id, bool Create(wxWindow* parent, wxWindowID id,
const wxGenericAnimation& anim = wxNullAnimation, const wxGenericAnimation& anim = wxNullGenericAnimation,
const wxPoint& pos = wxDefaultPosition, const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize, const wxSize& size = wxDefaultSize,
long style = wxAC_DEFAULT_STYLE, long style = wxAC_DEFAULT_STYLE,
@@ -235,14 +235,56 @@ public:
wxAnimationCtrl(); wxAnimationCtrl();
wxAnimationCtrl(wxWindow *parent, wxAnimationCtrl(wxWindow *parent,
wxWindowID id, wxWindowID id,
const wxGenericAnimation& anim = wxNullAnimation, const wxAnimation& anim = wxNullAnimation,
const wxPoint& pos = wxDefaultPosition, const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize, const wxSize& size = wxDefaultSize,
long style = wxAC_DEFAULT_STYLE, long style = wxAC_DEFAULT_STYLE,
const wxString& name = wxAnimationCtrlNameStr); const wxString& name = wxAnimationCtrlNameStr);
bool Create(wxWindow *parent, wxWindowID id,
const wxAnimation& anim = wxNullAnimation,
const wxPoint& pos = wxDefaultPosition,
const wxSize& size = wxDefaultSize,
long style = wxAC_DEFAULT_STYLE,
const wxString& name = wxAnimationCtrlNameStr);
void SetAnimation(const wxAnimation &anim);
wxAnimation GetAnimation() const;
}; };
/**
@class wxAnimationBase
Abstract base class for native and generic animation classes.
@See wxGenericAnimation, wxAnimation
*/
class wxAnimationBase : public wxObject
{
public:
wxAnimationBase();
virtual bool IsOk() const;
virtual int GetDelay(unsigned int frame) const = 0;
virtual unsigned int GetFrameCount() const = 0;
virtual wxImage GetFrame(unsigned int frame) const = 0;
virtual wxSize GetSize() const = 0;
virtual bool LoadFile(const wxString& name,
wxAnimationType type = wxANIMATION_TYPE_ANY) = 0;
virtual bool Load(wxInputStream& stream,
wxAnimationType type = wxANIMATION_TYPE_ANY) = 0;
virtual wxPoint GetFramePosition(unsigned int frame) const = 0;
virtual wxSize GetFrameSize(unsigned int frame) const = 0;
virtual wxAnimationDisposal GetDisposalMethod(unsigned int frame) const = 0;
virtual wxColour GetTransparentColour(unsigned int frame) const = 0;
virtual wxColour GetBackgroundColour() const = 0;
};
/** /**
@class wxGenericAnimation @class wxGenericAnimation
@@ -268,7 +310,7 @@ public:
@see wxAnimationCtrl, @sample{animate} @see wxAnimationCtrl, @sample{animate}
*/ */
class wxGenericAnimation : public wxObject class wxGenericAnimation : public wxAnimationBase
{ {
public: public:
/** /**
@@ -276,11 +318,6 @@ public:
*/ */
wxGenericAnimation(); wxGenericAnimation();
/**
Copy ctor.
*/
// wxAnimation(const wxAnimation& anim);
/** /**
Loads an animation from a file. Loads an animation from a file.
@@ -424,11 +461,28 @@ public:
then this is the animation class that should be used with @c wxAnimationCtrl. then this is the animation class that should be used with @c wxAnimationCtrl.
Otherwise it is virtually the same as @c wxGenericAnimation. Otherwise it is virtually the same as @c wxGenericAnimation.
*/ */
class wxAnimation : public wxGenericAnimation class wxAnimation : public wxAnimationBase
{ {
public: public:
wxAnimation(); wxAnimation();
wxAnimation(const wxString &name, wxAnimationType type = wxANIMATION_TYPE_ANY); wxAnimation(const wxString &name, wxAnimationType type = wxANIMATION_TYPE_ANY);
virtual int GetDelay(unsigned int frame) const;
virtual unsigned int GetFrameCount() const;
virtual wxImage GetFrame(unsigned int frame) const;
virtual wxSize GetSize() const;
virtual bool LoadFile(const wxString& name,
wxAnimationType type = wxANIMATION_TYPE_ANY);
virtual bool Load(wxInputStream& stream,
wxAnimationType type = wxANIMATION_TYPE_ANY);
virtual wxPoint GetFramePosition(unsigned int frame) const;
virtual wxSize GetFrameSize(unsigned int frame) const;
virtual wxAnimationDisposal GetDisposalMethod(unsigned int frame) const;
virtual wxColour GetTransparentColour(unsigned int frame) const;
virtual wxColour GetBackgroundColour() const;
}; };
@@ -439,5 +493,6 @@ public:
/** /**
An empty animation object. An empty animation object.
*/ */
wxGenericAnimation wxNullAnimation; wxAnimation wxNullAnimation;
wxGenericAnimation wxNullGenericAnimation;