/////////////////////////////////////////////////////////////////////////////// // Name: animate.cpp // Purpose: Implementation of wxAnimation classes // Author: Julian Smart and Guillermo Rodriguez Garcia // Modified by: // Created: 13/8/99 // RCS-ID: $Id$ // Copyright: (c) Julian Smart and Guillermo Rodriguez Garcia // Licence: wxWindows licence /////////////////////////////////////////////////////////////////////////////// #ifdef __GNUG__ #pragma implementation "animate.h" #endif #include "wx/wxprec.h" #ifdef __BORLANDC__ #pragma hdrstop #endif //__BORLANDC__ #include "wx/wfstream.h" #include "wx/image.h" #include "wx/gifdecod.h" #include "wx/animate/animate.h" /* * wxAnimationPlayer */ IMPLEMENT_CLASS(wxAnimationPlayer, wxObject) wxAnimationPlayer::wxAnimationPlayer(wxAnimationBase *animation, bool destroyAnimation) { m_animation = animation; m_destroyAnimation = destroyAnimation; m_currentFrame = 0; m_window = (wxWindow*) NULL; m_position = wxPoint(0, 0); m_looped = TRUE; m_isPlaying = FALSE; m_useBackgroundColour = FALSE; m_customBackgroundColour = wxColour(0, 0, 0); m_useCustomBackgroundColour = FALSE; m_useParentBackground = FALSE; m_timer.SetPlayer(this); } wxAnimationPlayer::~wxAnimationPlayer() { Stop(); ClearCache(); if (m_destroyAnimation) delete m_animation; } void wxAnimationPlayer::SetAnimation(wxAnimationBase* animation, bool destroyAnimation) { ClearCache(); if (m_destroyAnimation) delete m_animation; m_animation = animation; m_destroyAnimation = destroyAnimation; } // Play bool wxAnimationPlayer::Play(wxWindow& window, const wxPoint& pos, bool looped) { m_window = & window; if (!m_animation || !m_animation->IsValid()) return FALSE; wxSize sz = GetLogicalScreenSize(); wxRect rect(pos, sz); SaveBackground(rect); if (m_frames.Number() == 0) { if (!Build()) { wxLogWarning("wxAnimationPlayer::Play: could not build the image cache."); return FALSE; } } m_currentFrame = 0; // Create the backing store m_backingStore.Create(sz.x, sz.y); PlayFrame(); return TRUE; } // Build animation (list of wxImages). If not called before Play // is called, Play will call this automatically. bool wxAnimationPlayer::Build() { ClearCache(); if (m_animation) { int n = GetFrameCount(); int i; for (i = 0; i < n; i++) { wxBitmap* bitmap = NULL; wxImage* image = GetFrame(i); if (image) { // If the frame has transparency, // set the colour so converting to a bitmap // will create a mask wxColour transparentColour; if (GetTransparentColour(transparentColour)) image->SetMaskColour(transparentColour.Red(), transparentColour.Green(), transparentColour.Blue()); bitmap = new wxBitmap(* image); delete image; if (bitmap) m_frames.Append(bitmap); else return FALSE; } else return FALSE; } return TRUE; } else return FALSE; } // Stop the animation void wxAnimationPlayer::Stop() { m_timer.Stop(); m_isPlaying = FALSE; } // Draw the current view of the animation into this DC. // Call this from your OnPaint, for example. void wxAnimationPlayer::Draw(wxDC& dc) { dc.DrawBitmap(m_backingStore, m_position.x, m_position.y); } int wxAnimationPlayer::GetFrameCount() const { if (m_animation) return m_animation->GetFrameCount(); else return 0; } wxImage* wxAnimationPlayer::GetFrame(int i) const { if (m_animation) return m_animation->GetFrame(i); else return (wxImage*) NULL; } wxAnimationDisposal wxAnimationPlayer::GetDisposalMethod(int i) const { if (m_animation) return m_animation->GetDisposalMethod(i); else return wxANIM_UNSPECIFIED; } wxRect wxAnimationPlayer::GetFrameRect(int i) const { if (m_animation) return m_animation->GetFrameRect(i); else return wxRect(0, 0, 0, 0); } int wxAnimationPlayer::GetDelay(int i) const { if (m_animation) return m_animation->GetDelay(i); else return 0; } wxSize wxAnimationPlayer::GetLogicalScreenSize() const { if (m_animation) return m_animation->GetLogicalScreenSize(); else return wxSize(0, 0); } bool wxAnimationPlayer::GetBackgroundColour(wxColour& col) const { if (m_animation) return m_animation->GetBackgroundColour(col); else return FALSE; } bool wxAnimationPlayer::GetTransparentColour(wxColour& col) const { if (m_animation) return m_animation->GetTransparentColour(col); else return FALSE; } // Play the frame bool wxAnimationPlayer::PlayFrame(int frame, wxWindow& window, wxPoint& pos) { wxMemoryDC dc; dc.SelectObject(m_backingStore); // Draw the background: colour or area beneath animation wxColour col(255, 255, 255); if (UsingBackgroundColour()) { if (UsingCustomBackgroundColour()) col = GetCustomBackgroundColour(); else { GetBackgroundColour(col); } // Draw the background colour loaded from the animation // (or set by the user) DrawBackground(dc, wxPoint(0, 0), col); } else { // Draw background we saved dc.DrawBitmap(m_savedBackground, 0, 0); } // Draw all intermediate frames that haven't been removed from the // animation int i; for (i = 0; i < (frame - 1); i++) { if ((GetDisposalMethod(i) == wxANIM_DONOTREMOVE) || (GetDisposalMethod(i) == wxANIM_UNSPECIFIED)) { DrawFrame(i, dc, wxPoint(0, 0)); } } DrawFrame(frame, dc, wxPoint(0, 0)); dc.SelectObject(wxNullBitmap); // Draw from backing bitmap onto window wxClientDC clientDC(& window); Draw(clientDC); return TRUE; } bool wxAnimationPlayer::PlayFrame() { m_isPlaying = TRUE; PlayFrame(GetCurrentFrame(), * GetWindow(), GetPosition()); // Set the timer for the next frame m_timer.Start(GetDelay(GetCurrentFrame())); m_currentFrame ++; if (m_currentFrame == GetFrameCount()) { // Should a non-looped animation display the last frame? if (!m_looped) { m_timer.Stop(); m_isPlaying = FALSE; } else m_currentFrame = 0; } return TRUE; } // Clear the wxImage cache void wxAnimationPlayer::ClearCache() { wxNode* node = m_frames.First(); while (node) { wxNode* next = node->Next(); wxBitmap* bitmap = (wxBitmap*) node->Data(); delete bitmap; delete node; node = next; } } // Draw the background colour void wxAnimationPlayer::DrawBackground(wxDC& dc, const wxPoint& pos, const wxColour& colour) { wxASSERT_MSG( (m_animation != NULL), "Animation not present in wxAnimationPlayer"); wxASSERT_MSG( (m_frames.Number() != 0), "Animation cache not present in wxAnimationPlayer"); // Optimization: if the first frame fills the whole area, and is non-transparent, // don't bother drawing the background wxBitmap* firstBitmap = (wxBitmap*) m_frames.First()->Data() ; wxSize screenSize = GetLogicalScreenSize(); if (!firstBitmap->GetMask() && (firstBitmap->GetWidth() == screenSize.x) && (firstBitmap->GetHeight() == screenSize.y)) { return; } wxBrush brush(colour, wxSOLID); wxPen pen(colour, 1, wxSOLID); dc.SetBrush(brush); dc.SetPen(pen); dc.SetLogicalFunction(wxCOPY); dc.DrawRectangle(pos.x, pos.y, screenSize.x, screenSize.y); } // Save the pertinent area of the window so we can restore // it if drawing transparently void wxAnimationPlayer::SaveBackground(const wxRect& rect) { wxASSERT( GetWindow() ); if (!GetWindow()) return; m_savedBackground.Create(rect.width, rect.height); wxMemoryDC memDC; memDC.SelectObject(m_savedBackground); if (m_useParentBackground && GetWindow()->GetParent()) { wxWindow* parent = GetWindow()->GetParent(); wxClientDC dc(parent); // Translate the point to coordinates in the // parent's client area, going via screen coordinates wxPoint pt(rect.x, rect.y); wxPoint screenPt = GetWindow()->ClientToScreen(pt); wxPoint parentPt = parent->ScreenToClient(screenPt); memDC.Blit(0, 0, rect.width, rect.height, & dc, parentPt.x, parentPt.y); } else { wxClientDC dc(GetWindow()); memDC.Blit(0, 0, rect.width, rect.height, & dc, rect.x, rect.y); } memDC.SelectObject(wxNullBitmap); } // Draw this frame void wxAnimationPlayer::DrawFrame(int frame, wxDC& dc, const wxPoint& pos) { wxASSERT_MSG( (m_animation != NULL), "Animation not present in wxAnimationPlayer"); wxASSERT_MSG( (m_frames.Number() != 0), "Animation cache not present in wxAnimationPlayer"); wxASSERT_MSG( (m_frames.Nth(frame) != (wxNode*) NULL), "Image not present in wxAnimationPlayer::DrawFrame"); wxBitmap* bitmap = (wxBitmap*) m_frames.Nth(frame)->Data() ; wxRect rect = GetFrameRect(frame); dc.DrawBitmap(* bitmap, pos.x + rect.x, pos.y + rect.y, (bitmap->GetMask() != NULL)); } void wxAnimationTimer::Notify() { m_player->PlayFrame(); } /* * wxAnimationBase */ IMPLEMENT_ABSTRACT_CLASS(wxAnimationBase, wxObject) /* * wxGIFAnimation */ IMPLEMENT_CLASS(wxGIFAnimation, wxAnimationBase) wxGIFAnimation::wxGIFAnimation() { m_decoder = (wxGIFDecoder*) NULL; } wxGIFAnimation::~wxGIFAnimation() { delete m_decoder; } int wxGIFAnimation::GetFrameCount() const { wxASSERT_MSG( (m_decoder != (wxGIFDecoder*) NULL), "m_decoder must be non-NULL"); return m_decoder->GetNumberOfFrames(); } wxImage* wxGIFAnimation::GetFrame(int i) const { wxASSERT_MSG( (m_decoder != (wxGIFDecoder*) NULL), "m_decoder must be non-NULL"); m_decoder->GoFrame(i); wxImage* image = new wxImage; m_decoder->ConvertToImage(image); return image; } wxAnimationDisposal wxGIFAnimation::GetDisposalMethod(int i) const { wxASSERT_MSG( (m_decoder != (wxGIFDecoder*) NULL), "m_decoder must be non-NULL"); m_decoder->GoFrame(i); int disposalMethod = m_decoder->GetDisposalMethod(); return (wxAnimationDisposal) disposalMethod; } wxRect wxGIFAnimation::GetFrameRect(int i) const { wxASSERT_MSG( (m_decoder != (wxGIFDecoder*) NULL), "m_decoder must be non-NULL"); m_decoder->GoFrame(i); wxRect rect(m_decoder->GetLeft(), m_decoder->GetTop(), m_decoder->GetWidth(), m_decoder->GetHeight()); return rect; } int wxGIFAnimation::GetDelay(int i) const { wxASSERT_MSG( (m_decoder != (wxGIFDecoder*) NULL), "m_decoder must be non-NULL"); m_decoder->GoFrame(i); return m_decoder->GetDelay(); } wxSize wxGIFAnimation::GetLogicalScreenSize() const { wxASSERT_MSG( (m_decoder != (wxGIFDecoder*) NULL), "m_decoder must be non-NULL"); return wxSize(m_decoder->GetLogicalScreenWidth(), m_decoder->GetLogicalScreenHeight()); } bool wxGIFAnimation::GetBackgroundColour(wxColour& col) const { wxASSERT_MSG( (m_decoder != (wxGIFDecoder*) NULL), "m_decoder must be non-NULL"); int i = m_decoder->GetBackgroundColour(); if (i == -1) return FALSE; else { unsigned char* pal = m_decoder->GetPalette(); if (pal) { col = wxColour(pal[3*i + 0], pal[3*i + 1], pal[3*i + 2]); return TRUE; } else return FALSE; } } bool wxGIFAnimation::GetTransparentColour(wxColour& col) const { wxASSERT_MSG( (m_decoder != (wxGIFDecoder*) NULL), "m_decoder must be non-NULL"); int i = m_decoder->GetTransparentColour(); if (i == -1) return FALSE; else { unsigned char* pal = m_decoder->GetPalette(); if (pal) { col = wxColour(pal[3*i + 0], pal[3*i + 1], pal[3*i + 2]); return TRUE; } else return FALSE; } } bool wxGIFAnimation::IsValid() const { return ((m_decoder != NULL) && (m_decoder->IsAnimation())); } bool wxGIFAnimation::LoadFile(const wxString& filename) { if (m_decoder) delete m_decoder; m_decoder = NULL; if (wxFileExists(filename)) { wxFileInputStream stream(filename); m_decoder = new wxGIFDecoder(& stream, TRUE); if (m_decoder->ReadGIF() != wxGIF_OK) { delete m_decoder; m_decoder = NULL; return FALSE; } if (!m_decoder->IsAnimation()) { delete m_decoder; m_decoder = NULL; return FALSE; } else return TRUE; } else return FALSE; } /* * wxAnimationCtrlBase * Abstract base class for format-specific animation controls. * This class implements most of the functionality; all a derived * class has to do is create the appropriate animation class on demand. */ IMPLEMENT_ABSTRACT_CLASS(wxAnimationCtrlBase, wxControl) BEGIN_EVENT_TABLE(wxAnimationCtrlBase, wxControl) EVT_PAINT(wxAnimationCtrlBase::OnPaint) END_EVENT_TABLE() bool wxAnimationCtrlBase::Create(wxWindow *parent, wxWindowID id, const wxString& filename, const wxPoint& pos, const wxSize& size, long style, const wxString& name) { m_animation = NULL; m_filename = filename; if (!wxControl::Create(parent, id, pos, size, style, wxDefaultValidator, name)) return FALSE; SetBackgroundColour(parent->GetBackgroundColour()); m_animationPlayer.SetCustomBackgroundColour(GetBackgroundColour()); // Want to give the impression of transparency by painting // the parent background // if (parent) // m_animationPlayer.UseParentBackground(TRUE); m_animationPlayer.SetWindow(this); m_animationPlayer.SetPosition(wxPoint(0, 0)); m_animationPlayer.SetDestroyAnimation(FALSE); return TRUE; } wxAnimationCtrlBase::~wxAnimationCtrlBase() { if (m_animationPlayer.IsPlaying()) m_animationPlayer.Stop(); m_animationPlayer.SetAnimation(NULL, FALSE); delete m_animation; } bool wxAnimationCtrlBase::LoadFile(const wxString& filename) { if (m_animationPlayer.IsPlaying()) m_animationPlayer.Stop(); wxString filename1(filename); if (filename1.IsEmpty()) filename1 = m_filename; if (filename1.IsEmpty()) return FALSE; if (m_animation) { delete m_animation; m_animation = NULL; } m_animation = DoCreateAnimation(filename1); if (!m_animation) return FALSE; if (!m_animation->LoadFile(filename) || !m_animation->IsValid()) { delete m_animation; m_animation = NULL; return FALSE; } m_animationPlayer.SetAnimation(m_animation, FALSE); if (GetWindowStyle() & wxAN_FIT_ANIMATION) FitToAnimation(); return TRUE; } bool wxAnimationCtrlBase::Play(bool looped) { return m_animationPlayer.Play(*this, wxPoint(0, 0), looped); } wxSize wxAnimationCtrlBase::DoGetBestSize() const { if (m_animationPlayer.HasAnimation() && (GetWindowStyle() & wxAN_FIT_ANIMATION)) { return m_animationPlayer.GetLogicalScreenSize(); } else { return GetSize(); } } void wxAnimationCtrlBase::FitToAnimation() { if (!m_animationPlayer.HasAnimation()) return; wxSize sz = m_animationPlayer.GetLogicalScreenSize(); SetClientSize(sz); } void wxAnimationCtrlBase::OnPaint(wxPaintEvent& event) { wxPaintDC dc(this); if (GetPlayer().IsPlaying()) { GetPlayer().Draw(dc); } } /* * wxGIFAnimationCtrl * Provides a GIF animation class when required. */ IMPLEMENT_ABSTRACT_CLASS(wxGIFAnimationCtrl, wxAnimationCtrlBase) wxAnimationBase* wxGIFAnimationCtrl::DoCreateAnimation(const wxString& WXUNUSED(filename)) { return new wxGIFAnimation; }