1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/msw/mediactrl_qt.cpp
3 // Purpose: QuickTime Media Backend for Windows
4 // Author: Ryan Norton <wxprojects@comcast.net>
5 // Modified by: Robin Dunn (moved QT code from mediactrl.cpp)
9 // Copyright: (c) Ryan Norton
10 // Licence: wxWindows licence
11 /////////////////////////////////////////////////////////////////////////////
14 //===========================================================================
16 //===========================================================================
18 //---------------------------------------------------------------------------
19 // Pre-compiled header stuff
20 //---------------------------------------------------------------------------
22 // For compilers that support precompilation, includes "wx.h".
23 #include "wx/wxprec.h"
31 #include "wx/mediactrl.h"
35 #include "wx/dcclient.h"
37 #include "wx/math.h" // log10 & pow
40 #include "wx/msw/private.h" // user info and wndproc setting/getting
41 #include "wx/dynlib.h"
43 //---------------------------------------------------------------------------
44 // Externals (somewhere in src/msw/app.cpp and src/msw/window.cpp)
45 //---------------------------------------------------------------------------
46 extern "C" WXDLLIMPEXP_BASE HINSTANCE
wxGetInstance(void);
48 extern WXDLLIMPEXP_CORE wxChar
*wxCanvasClassName
;
50 extern WXDLLIMPEXP_CORE
const wxChar
*wxCanvasClassName
;
53 LRESULT WXDLLIMPEXP_CORE APIENTRY _EXPORT
wxWndProc(HWND hWnd
, UINT message
,
54 WPARAM wParam
, LPARAM lParam
);
56 //---------------------------------------------------------------------------
57 // Killed MSVC warnings
58 //---------------------------------------------------------------------------
59 //disable "cast truncates constant value" for VARIANT_BOOL values
60 //passed as parameters in VC5 and up
62 #pragma warning (disable:4310)
66 //---------------------------------------------------------------------------
69 // We don't include Quicktime headers here and define all the types
70 // ourselves because looking for the quicktime libaries etc. would
71 // be tricky to do and making this a dependency for the MSVC projects
72 // would be unrealistic.
74 // Thanks to Robert Roebling for the wxDL macro/library idea
75 //---------------------------------------------------------------------------
77 //---------------------------------------------------------------------------
79 //---------------------------------------------------------------------------
80 //#include <qtml.h> // Windoze QT include
81 //#include <QuickTimeComponents.h> // Standard QT stuff
82 #include "wx/dynlib.h"
84 //---------------------------------------------------------------------------
86 //---------------------------------------------------------------------------
87 typedef struct MovieRecord
* Movie
;
88 typedef wxInt16 OSErr
;
89 typedef wxInt32 OSStatus
;
92 typedef unsigned char Str255
[256];
93 #define StringPtr unsigned char*
94 #define newMovieActive 1
95 #define newMovieAsyncOK (1 << 8)
99 #define OSType unsigned long
100 #define CGrafPtr struct GrafPort *
101 #define TimeScale long
102 #define TimeBase struct TimeBaseRecord *
103 typedef struct ComponentInstanceRecord
* ComponentInstance
;
104 #define kMovieLoadStatePlayable 10000
106 #define MovieController ComponentInstance
108 #ifndef URLDataHandlerSubType
109 #if defined(__WATCOMC__) || defined(__MINGW32__)
110 // use magic numbers for compilers which complain about multicharacter integers
111 const OSType URLDataHandlerSubType
= 1970433056;
112 const OSType VisualMediaCharacteristic
= 1702454643;
114 const OSType URLDataHandlerSubType
= 'url ';
115 const OSType VisualMediaCharacteristic
= 'eyes';
123 Str255 name
; // Str63 on mac, Str255 on msw
143 TimeScale scale
; // units per second
165 mcScaleMovieToFit
= 2,
171 //---------------------------------------------------------------------------
173 //---------------------------------------------------------------------------
175 class WXDLLIMPEXP_MEDIA wxQuickTimeLibrary
178 ~wxQuickTimeLibrary()
180 if (m_dll
.IsLoaded())
185 bool IsOk() const {return m_ok
;}
188 wxDynamicLibrary m_dll
;
192 wxDL_VOIDMETHOD_DEFINE( StartMovie
, (Movie m
), (m
) )
193 wxDL_VOIDMETHOD_DEFINE( StopMovie
, (Movie m
), (m
) )
194 wxDL_METHOD_DEFINE( bool, IsMovieDone
, (Movie m
), (m
), false)
195 wxDL_VOIDMETHOD_DEFINE( GoToBeginningOfMovie
, (Movie m
), (m
) )
196 wxDL_METHOD_DEFINE( OSErr
, GetMoviesError
, (), (), -1)
197 wxDL_METHOD_DEFINE( OSErr
, EnterMovies
, (), (), -1)
198 wxDL_VOIDMETHOD_DEFINE( ExitMovies
, (), () )
199 wxDL_METHOD_DEFINE( OSErr
, InitializeQTML
, (long flags
), (flags
), -1)
200 wxDL_VOIDMETHOD_DEFINE( TerminateQTML
, (), () )
202 wxDL_METHOD_DEFINE( OSErr
, NativePathNameToFSSpec
,
203 (char* inName
, FSSpec
* outFile
, long flags
),
204 (inName
, outFile
, flags
), -1)
206 wxDL_METHOD_DEFINE( OSErr
, OpenMovieFile
,
207 (const FSSpec
* fileSpec
, short * resRefNum
, wxInt8 permission
),
208 (fileSpec
, resRefNum
, permission
), -1 )
210 wxDL_METHOD_DEFINE( OSErr
, CloseMovieFile
,
211 (short resRefNum
), (resRefNum
), -1)
213 wxDL_METHOD_DEFINE( OSErr
, NewMovieFromFile
,
214 (Movie
* theMovie
, short resRefNum
, short * resId
,
215 StringPtr resName
, short newMovieFlags
,
216 bool * dataRefWasChanged
),
217 (theMovie
, resRefNum
, resId
, resName
, newMovieFlags
,
218 dataRefWasChanged
), -1)
220 wxDL_VOIDMETHOD_DEFINE( SetMovieRate
, (Movie m
, Fixed rate
), (m
, rate
) )
221 wxDL_METHOD_DEFINE( Fixed
, GetMovieRate
, (Movie m
), (m
), 0)
222 wxDL_VOIDMETHOD_DEFINE( MoviesTask
, (Movie m
, long maxms
), (m
, maxms
) )
223 wxDL_VOIDMETHOD_DEFINE( BlockMove
,
224 (const char* p1
, const char* p2
, long s
), (p1
,p2
,s
) )
225 wxDL_METHOD_DEFINE( Handle
, NewHandleClear
, (long s
), (s
), NULL
)
227 wxDL_METHOD_DEFINE( OSErr
, NewMovieFromDataRef
,
228 (Movie
* m
, short flags
, short * id
,
229 Handle dataRef
, OSType dataRefType
),
230 (m
,flags
,id
,dataRef
,dataRefType
), -1 )
232 wxDL_VOIDMETHOD_DEFINE( DisposeHandle
, (Handle h
), (h
) )
233 wxDL_VOIDMETHOD_DEFINE( GetMovieNaturalBoundsRect
, (Movie m
, Rect
* r
), (m
,r
) )
234 wxDL_METHOD_DEFINE( void*, GetMovieIndTrackType
,
235 (Movie m
, long index
, OSType type
, long flags
),
236 (m
,index
,type
,flags
), NULL
)
237 wxDL_VOIDMETHOD_DEFINE( CreatePortAssociation
,
238 (void* hWnd
, void* junk
, long morejunk
), (hWnd
, junk
, morejunk
) )
239 wxDL_METHOD_DEFINE(void*, GetNativeWindowPort
, (void* hWnd
), (hWnd
), NULL
)
240 wxDL_VOIDMETHOD_DEFINE(SetMovieGWorld
, (Movie m
, CGrafPtr port
, void* whatever
),
241 (m
, port
, whatever
) )
242 wxDL_VOIDMETHOD_DEFINE(DisposeMovie
, (Movie m
), (m
) )
243 wxDL_VOIDMETHOD_DEFINE(SetMovieBox
, (Movie m
, Rect
* r
), (m
,r
))
244 wxDL_VOIDMETHOD_DEFINE(SetMovieTimeScale
, (Movie m
, long s
), (m
,s
))
245 wxDL_METHOD_DEFINE(long, GetMovieDuration
, (Movie m
), (m
), 0)
246 wxDL_METHOD_DEFINE(TimeBase
, GetMovieTimeBase
, (Movie m
), (m
), 0)
247 wxDL_METHOD_DEFINE(TimeScale
, GetMovieTimeScale
, (Movie m
), (m
), 0)
248 wxDL_METHOD_DEFINE(long, GetMovieTime
, (Movie m
, void* cruft
), (m
,cruft
), 0)
249 wxDL_VOIDMETHOD_DEFINE(SetMovieTime
, (Movie m
, TimeRecord
* tr
), (m
,tr
) )
250 wxDL_METHOD_DEFINE(short, GetMovieVolume
, (Movie m
), (m
), 0)
251 wxDL_VOIDMETHOD_DEFINE(SetMovieVolume
, (Movie m
, short sVolume
), (m
,sVolume
) )
252 wxDL_VOIDMETHOD_DEFINE(SetMovieTimeValue
, (Movie m
, long s
), (m
,s
))
253 wxDL_METHOD_DEFINE(ComponentInstance
, NewMovieController
, (Movie m
, const Rect
* mr
, long fl
), (m
,mr
,fl
), 0)
254 wxDL_VOIDMETHOD_DEFINE(DisposeMovieController
, (ComponentInstance ci
), (ci
))
255 wxDL_METHOD_DEFINE(int, MCSetVisible
, (ComponentInstance m
, int b
), (m
, b
), 0)
257 wxDL_VOIDMETHOD_DEFINE(PrePrerollMovie
, (Movie m
, long t
, Fixed r
, WXFARPROC p1
, void* p2
), (m
,t
,r
,p1
,p2
) )
258 wxDL_VOIDMETHOD_DEFINE(PrerollMovie
, (Movie m
, long t
, Fixed r
), (m
,t
,r
) )
259 wxDL_METHOD_DEFINE(Fixed
, GetMoviePreferredRate
, (Movie m
), (m
), 0)
260 wxDL_METHOD_DEFINE(long, GetMovieLoadState
, (Movie m
), (m
), 0)
261 wxDL_METHOD_DEFINE(void*, NewRoutineDescriptor
, (WXFARPROC f
, int l
, void* junk
), (f
, l
, junk
), 0)
262 wxDL_VOIDMETHOD_DEFINE(DisposeRoutineDescriptor
, (void* f
), (f
))
263 wxDL_METHOD_DEFINE(void*, GetCurrentArchitecture
, (), (), 0)
264 wxDL_METHOD_DEFINE(int, MCDoAction
, (ComponentInstance ci
, long f
, void* p
), (ci
,f
,p
), 0)
265 wxDL_VOIDMETHOD_DEFINE(MCSetControllerBoundsRect
, (ComponentInstance ci
, Rect
* r
), (ci
,r
))
266 wxDL_VOIDMETHOD_DEFINE(DestroyPortAssociation
, (CGrafPtr g
), (g
))
267 wxDL_VOIDMETHOD_DEFINE(NativeEventToMacEvent
, (MSG
* p1
, EventRecord
* p2
), (p1
,p2
))
268 wxDL_VOIDMETHOD_DEFINE(MCIsPlayerEvent
, (ComponentInstance ci
, EventRecord
* p2
), (ci
, p2
))
269 wxDL_METHOD_DEFINE(int, MCSetMovie
, (ComponentInstance ci
, Movie m
, void* p1
, Point w
),
271 wxDL_VOIDMETHOD_DEFINE(MCPositionController
,
272 (ComponentInstance ci
, Rect
* r
, void* junk
, void* morejunk
), (ci
,r
,junk
,morejunk
))
273 wxDL_VOIDMETHOD_DEFINE(MCSetActionFilterWithRefCon
,
274 (ComponentInstance ci
, WXFARPROC cb
, void* ref
), (ci
,cb
,ref
))
275 wxDL_VOIDMETHOD_DEFINE(MCGetControllerInfo
, (MovieController mc
, long* flags
), (mc
,flags
))
276 wxDL_VOIDMETHOD_DEFINE(BeginUpdate
, (CGrafPtr port
), (port
))
277 wxDL_VOIDMETHOD_DEFINE(UpdateMovie
, (Movie m
), (m
))
278 wxDL_VOIDMETHOD_DEFINE(EndUpdate
, (CGrafPtr port
), (port
))
279 wxDL_METHOD_DEFINE( OSErr
, GetMoviesStickyError
, (), (), -1)
282 bool wxQuickTimeLibrary::Initialize()
284 // Turn off the wxDynamicLibrary logging as we're prepared to handle the
288 m_ok
= m_dll
.Load(wxT("qtmlClient.dll"));
292 wxDL_METHOD_LOAD( m_dll
, StartMovie
);
293 wxDL_METHOD_LOAD( m_dll
, StopMovie
);
294 wxDL_METHOD_LOAD( m_dll
, IsMovieDone
);
295 wxDL_METHOD_LOAD( m_dll
, GoToBeginningOfMovie
);
296 wxDL_METHOD_LOAD( m_dll
, GetMoviesError
);
297 wxDL_METHOD_LOAD( m_dll
, EnterMovies
);
298 wxDL_METHOD_LOAD( m_dll
, ExitMovies
);
299 wxDL_METHOD_LOAD( m_dll
, InitializeQTML
);
300 wxDL_METHOD_LOAD( m_dll
, TerminateQTML
);
301 wxDL_METHOD_LOAD( m_dll
, NativePathNameToFSSpec
);
302 wxDL_METHOD_LOAD( m_dll
, OpenMovieFile
);
303 wxDL_METHOD_LOAD( m_dll
, CloseMovieFile
);
304 wxDL_METHOD_LOAD( m_dll
, NewMovieFromFile
);
305 wxDL_METHOD_LOAD( m_dll
, GetMovieRate
);
306 wxDL_METHOD_LOAD( m_dll
, SetMovieRate
);
307 wxDL_METHOD_LOAD( m_dll
, MoviesTask
);
308 wxDL_METHOD_LOAD( m_dll
, BlockMove
);
309 wxDL_METHOD_LOAD( m_dll
, NewHandleClear
);
310 wxDL_METHOD_LOAD( m_dll
, NewMovieFromDataRef
);
311 wxDL_METHOD_LOAD( m_dll
, DisposeHandle
);
312 wxDL_METHOD_LOAD( m_dll
, GetMovieNaturalBoundsRect
);
313 wxDL_METHOD_LOAD( m_dll
, GetMovieIndTrackType
);
314 wxDL_METHOD_LOAD( m_dll
, CreatePortAssociation
);
315 wxDL_METHOD_LOAD( m_dll
, DestroyPortAssociation
);
316 wxDL_METHOD_LOAD( m_dll
, GetNativeWindowPort
);
317 wxDL_METHOD_LOAD( m_dll
, SetMovieGWorld
);
318 wxDL_METHOD_LOAD( m_dll
, DisposeMovie
);
319 wxDL_METHOD_LOAD( m_dll
, SetMovieBox
);
320 wxDL_METHOD_LOAD( m_dll
, SetMovieTimeScale
);
321 wxDL_METHOD_LOAD( m_dll
, GetMovieDuration
);
322 wxDL_METHOD_LOAD( m_dll
, GetMovieTimeBase
);
323 wxDL_METHOD_LOAD( m_dll
, GetMovieTimeScale
);
324 wxDL_METHOD_LOAD( m_dll
, GetMovieTime
);
325 wxDL_METHOD_LOAD( m_dll
, SetMovieTime
);
326 wxDL_METHOD_LOAD( m_dll
, GetMovieVolume
);
327 wxDL_METHOD_LOAD( m_dll
, SetMovieVolume
);
328 wxDL_METHOD_LOAD( m_dll
, SetMovieTimeValue
);
329 wxDL_METHOD_LOAD( m_dll
, NewMovieController
);
330 wxDL_METHOD_LOAD( m_dll
, DisposeMovieController
);
331 wxDL_METHOD_LOAD( m_dll
, MCSetVisible
);
332 wxDL_METHOD_LOAD( m_dll
, PrePrerollMovie
);
333 wxDL_METHOD_LOAD( m_dll
, PrerollMovie
);
334 wxDL_METHOD_LOAD( m_dll
, GetMoviePreferredRate
);
335 wxDL_METHOD_LOAD( m_dll
, GetMovieLoadState
);
336 wxDL_METHOD_LOAD( m_dll
, MCDoAction
);
337 wxDL_METHOD_LOAD( m_dll
, MCSetControllerBoundsRect
);
338 wxDL_METHOD_LOAD( m_dll
, NativeEventToMacEvent
);
339 wxDL_METHOD_LOAD( m_dll
, MCIsPlayerEvent
);
340 wxDL_METHOD_LOAD( m_dll
, MCSetMovie
);
341 wxDL_METHOD_LOAD( m_dll
, MCSetActionFilterWithRefCon
);
342 wxDL_METHOD_LOAD( m_dll
, MCGetControllerInfo
);
343 wxDL_METHOD_LOAD( m_dll
, BeginUpdate
);
344 wxDL_METHOD_LOAD( m_dll
, UpdateMovie
);
345 wxDL_METHOD_LOAD( m_dll
, EndUpdate
);
346 wxDL_METHOD_LOAD( m_dll
, GetMoviesStickyError
);
351 class WXDLLIMPEXP_MEDIA wxQTMediaBackend
: public wxMediaBackendCommonBase
355 virtual ~wxQTMediaBackend();
357 virtual bool CreateControl(wxControl
* ctrl
, wxWindow
* parent
,
362 const wxValidator
& validator
,
363 const wxString
& name
);
366 virtual bool Pause();
369 virtual bool Load(const wxURI
& location
,
371 { return wxMediaBackend::Load(location
, proxy
); }
373 virtual bool Load(const wxString
& fileName
);
374 virtual bool Load(const wxURI
& location
);
376 virtual wxMediaState
GetState();
378 virtual bool SetPosition(wxLongLong where
);
379 virtual wxLongLong
GetPosition();
380 virtual wxLongLong
GetDuration();
382 virtual void Move(int x
, int y
, int w
, int h
);
383 wxSize
GetVideoSize() const;
385 virtual double GetPlaybackRate();
386 virtual bool SetPlaybackRate(double dRate
);
388 virtual double GetVolume();
389 virtual bool SetVolume(double);
394 static void PPRMProc (Movie theMovie
, OSErr theErr
, void* theRefCon
);
396 // TODO: Last param actually long - does this work on 64bit machines?
397 static Boolean
MCFilterProc(MovieController theController
,
398 short action
, void *params
, LONG_PTR refCon
);
400 static LRESULT CALLBACK
QTWndProc(HWND
, UINT
, WPARAM
, LPARAM
);
402 virtual bool ShowPlayerControls(wxMediaCtrlPlayerControls flags
);
404 wxSize m_bestSize
; // Original movie size
405 Movie m_movie
; // QT Movie handle/instance
406 bool m_bVideo
; // Whether or not we have video
407 bool m_bPlaying
; // Whether or not movie is playing
408 wxTimer
* m_timer
; // Load or Play timer
409 wxQuickTimeLibrary m_lib
; // DLL to load functions from
410 ComponentInstance m_pMC
; // Movie Controller
411 wxEvtHandler
* m_evthandler
;
413 friend class wxQTMediaEvtHandler
;
415 DECLARE_DYNAMIC_CLASS(wxQTMediaBackend
)
418 // helper to hijack background erasing for the QT window
419 class WXDLLIMPEXP_MEDIA wxQTMediaEvtHandler
: public wxEvtHandler
422 wxQTMediaEvtHandler(wxQTMediaBackend
*qtb
, WXHWND hwnd
)
427 m_qtb
->m_ctrl
->Connect(m_qtb
->m_ctrl
->GetId(),
428 wxEVT_ERASE_BACKGROUND
,
429 wxEraseEventHandler(wxQTMediaEvtHandler::OnEraseBackground
),
433 void OnEraseBackground(wxEraseEvent
& event
);
436 wxQTMediaBackend
*m_qtb
;
439 DECLARE_NO_COPY_CLASS(wxQTMediaEvtHandler
)
443 //===========================================================================
445 //===========================================================================
448 //---------------------------------------------------------------------------
451 // TODO: Use a less kludgy way to pause/get state/set state
452 // FIXME: Greg Hazel reports that sometimes files that cannot be played
453 // with this backend are treated as playable anyway - not verified though.
454 //---------------------------------------------------------------------------
456 IMPLEMENT_DYNAMIC_CLASS(wxQTMediaBackend
, wxMediaBackend
)
458 // Time between timer calls - this is the Apple recommendation to the TCL
460 #define MOVIE_DELAY 20
462 //---------------------------------------------------------------------------
465 // QT, esp. QT for Windows is very picky about how you go about
466 // async loading. If you were to go through a Windows message loop
467 // or a MoviesTask or both and then check the movie load state
468 // it would still return 1000 (loading)... even (pre)prerolling doesn't
469 // help. However, making a load timer like this works
470 //---------------------------------------------------------------------------
471 class wxQTLoadTimer
: public wxTimer
474 wxQTLoadTimer(Movie movie
, wxQTMediaBackend
* parent
, wxQuickTimeLibrary
* pLib
) :
475 m_movie(movie
), m_parent(parent
), m_pLib(pLib
) {}
479 m_pLib
->MoviesTask(m_movie
, 0);
480 // kMovieLoadStatePlayable
481 if (m_pLib
->GetMovieLoadState(m_movie
) >= 10000)
483 m_parent
->FinishLoad();
489 Movie m_movie
; //Our movie instance
490 wxQTMediaBackend
* m_parent
; //Backend pointer
491 wxQuickTimeLibrary
* m_pLib
; //Interfaces
495 // --------------------------------------------------------------------------
496 // wxQTPlayTimer - Handle Asyncronous Playing
498 // 1) Checks to see if the movie is done, and if not continues
499 // streaming the movie
500 // 2) Sends the wxEVT_MEDIA_STOP event if we have reached the end of
502 // --------------------------------------------------------------------------
503 class wxQTPlayTimer
: public wxTimer
506 wxQTPlayTimer(Movie movie
, wxQTMediaBackend
* parent
,
507 wxQuickTimeLibrary
* pLib
) :
508 m_movie(movie
), m_parent(parent
), m_pLib(pLib
) {}
513 // OK, a little explaining - basically originally
514 // we only called MoviesTask if the movie was actually
515 // playing (not paused or stopped)... this was before
516 // we realized MoviesTask actually handles repainting
517 // of the current frame - so if you were to resize
518 // or something it would previously not redraw that
519 // portion of the movie.
521 // So now we call MoviesTask always so that it repaints
524 m_pLib
->MoviesTask(m_movie
, 0);
527 // Handle the stop event - if the movie has reached
528 // the end, notify our handler
530 // m_bPlaying == !(Stopped | Paused)
532 if (m_parent
->m_bPlaying
)
534 if (m_pLib
->IsMovieDone(m_movie
))
536 if ( m_parent
->SendStopEvent() )
539 wxASSERT(m_pLib
->GetMoviesError() == noErr
);
541 m_parent
->QueueFinishEvent();
548 Movie m_movie
; // Our movie instance
549 wxQTMediaBackend
* m_parent
; //Backend pointer
550 wxQuickTimeLibrary
* m_pLib
; //Interfaces
554 //---------------------------------------------------------------------------
555 // wxQTMediaBackend::QTWndProc
557 // Forwards events to the Movie Controller so that it can
558 // redraw itself/process messages etc..
559 //---------------------------------------------------------------------------
560 LRESULT CALLBACK
wxQTMediaBackend::QTWndProc(HWND hWnd
, UINT nMsg
,
561 WPARAM wParam
, LPARAM lParam
)
563 wxQTMediaBackend
* pThis
= (wxQTMediaBackend
*)wxGetWindowUserData(hWnd
);
573 EventRecord theEvent
;
574 pThis
->m_lib
.NativeEventToMacEvent(&msg
, &theEvent
);
575 pThis
->m_lib
.MCIsPlayerEvent(pThis
->m_pMC
, &theEvent
);
577 return pThis
->m_ctrl
->MSWWindowProc(nMsg
, wParam
, lParam
);
580 //---------------------------------------------------------------------------
581 // wxQTMediaBackend Destructor
583 // Sets m_timer to NULL signifying we havn't loaded anything yet
584 //---------------------------------------------------------------------------
585 wxQTMediaBackend::wxQTMediaBackend()
586 : m_movie(NULL
), m_bPlaying(false), m_timer(NULL
), m_pMC(NULL
)
591 //---------------------------------------------------------------------------
592 // wxQTMediaBackend Destructor
594 // 1) Cleans up the QuickTime movie instance
595 // 2) Decrements the QuickTime reference counter - if this reaches
596 // 0, QuickTime shuts down
597 // 3) Decrements the QuickTime Windows Media Layer reference counter -
598 // if this reaches 0, QuickTime shuts down the Windows Media Layer
599 //---------------------------------------------------------------------------
600 wxQTMediaBackend::~wxQTMediaBackend()
609 m_lib
.DisposeMovieController(m_pMC
);
613 // destroy wxQTMediaEvtHandler we pushed on it
616 m_ctrl
->RemoveEventHandler(m_evthandler
);
620 m_lib
.DestroyPortAssociation(
621 (CGrafPtr
)m_lib
.GetNativeWindowPort(m_ctrl
->GetHWND()));
623 //Note that ExitMovies() is not necessary, but
624 //the docs are fuzzy on whether or not TerminateQTML is
626 m_lib
.TerminateQTML();
630 //---------------------------------------------------------------------------
631 // wxQTMediaBackend::CreateControl
633 // 1) Intializes QuickTime
634 // 2) Creates the control window
635 //---------------------------------------------------------------------------
636 bool wxQTMediaBackend::CreateControl(wxControl
* ctrl
, wxWindow
* parent
,
641 const wxValidator
& validator
,
642 const wxString
& name
)
644 if (!m_lib
.Initialize())
647 int nError
= m_lib
.InitializeQTML(0);
648 if (nError
!= noErr
) //-2093 no dll
650 wxFAIL_MSG(wxString::Format(wxT("Couldn't Initialize Quicktime-%i"), nError
));
657 // By default wxWindow(s) is created with a border -
658 // so we need to get rid of those
660 // Since we don't have a child window like most other
661 // backends, we don't need wxCLIP_CHILDREN
662 if ( !ctrl
->wxControl::Create(parent
, id
, pos
, size
,
663 (style
& ~wxBORDER_MASK
) | wxBORDER_NONE
,
669 m_ctrl
= wxStaticCast(ctrl
, wxMediaCtrl
);
671 // Create a port association for our window so we
672 // can use it as a WindowRef
673 m_lib
.CreatePortAssociation(m_ctrl
->GetHWND(), NULL
, 0L);
675 // Part of a suggestion from Greg Hazel
676 // to repaint movie when idle
677 m_evthandler
= new wxQTMediaEvtHandler(this, m_ctrl
->GetHWND());
678 m_ctrl
->PushEventHandler(m_evthandler
);
684 //---------------------------------------------------------------------------
685 // wxQTMediaBackend::Load (file version)
687 // 1) Get an FSSpec from the Windows path name
689 // 3) Obtain the movie instance from the movie resource
690 // 4) Close the movie resource
692 //---------------------------------------------------------------------------
693 bool wxQTMediaBackend::Load(const wxString
& fileName
)
698 short movieResFile
= 0; //= 0 because of annoying VC6 warning
701 OSErr err
= m_lib
.NativePathNameToFSSpec(
702 (char*) (const char*) fileName
.mb_str(),
704 bool result
= (err
== noErr
);
708 err
= m_lib
.OpenMovieFile(&sfFile
, &movieResFile
, fsRdPerm
);
709 result
= (err
== noErr
);
714 short movieResID
= 0;
717 err
= m_lib
.NewMovieFromFile(
723 NULL
); // wasChanged
724 result
= (err
== noErr
/*&& m_lib.GetMoviesStickyError() == noErr*/);
726 // check m_lib.GetMoviesStickyError() because it may not find the
727 // proper codec and play black video and other strange effects,
728 // not to mention mess up the dynamic backend loading scheme
729 // of wxMediaCtrl - so it just does what the QuickTime player does
732 m_lib
.CloseMovieFile(movieResFile
);
740 //---------------------------------------------------------------------------
741 // wxQTMediaBackend::PPRMProc (static)
743 // Called when done PrePrerolling the movie.
744 // Note that in 99% of the cases this does nothing...
745 // Anyway we set up the loading timer here to tell us when the movie is done
746 //---------------------------------------------------------------------------
747 void wxQTMediaBackend::PPRMProc (Movie theMovie
,
748 OSErr
WXUNUSED_UNLESS_DEBUG(theErr
),
751 wxASSERT( theMovie
);
752 wxASSERT( theRefCon
);
753 wxASSERT( theErr
== noErr
);
755 wxQTMediaBackend
* pBE
= (wxQTMediaBackend
*) theRefCon
;
757 long lTime
= pBE
->m_lib
.GetMovieTime(theMovie
,NULL
);
758 Fixed rate
= pBE
->m_lib
.GetMoviePreferredRate(theMovie
);
759 pBE
->m_lib
.PrerollMovie(theMovie
, lTime
, rate
);
760 pBE
->m_timer
= new wxQTLoadTimer(pBE
->m_movie
, pBE
, &pBE
->m_lib
);
761 pBE
->m_timer
->Start(MOVIE_DELAY
);
764 //---------------------------------------------------------------------------
765 // wxQTMediaBackend::Load (URL Version)
767 // 1) Build an escaped URI from location
768 // 2) Create a handle to store the URI string
769 // 3) Put the URI string inside the handle
770 // 4) Make a QuickTime URL data ref from the handle with the URI in it
771 // 5) Clean up the URI string handle
772 // 6) Do some prerolling
774 //---------------------------------------------------------------------------
775 bool wxQTMediaBackend::Load(const wxURI
& location
)
780 wxString theURI
= location
.BuildURI();
782 Handle theHandle
= m_lib
.NewHandleClear(theURI
.length() + 1);
785 m_lib
.BlockMove(theURI
.mb_str(), *theHandle
, theURI
.length() + 1);
787 // create the movie from the handle that refers to the URI
788 OSErr err
= m_lib
.NewMovieFromDataRef(&m_movie
, newMovieActive
|
790 /* | newMovieIdleImportOK */,
792 URLDataHandlerSubType
);
794 m_lib
.DisposeHandle(theHandle
);
801 timeNow
= m_lib
.GetMovieTime(m_movie
, NULL
);
802 wxASSERT(m_lib
.GetMoviesError() == noErr
);
804 playRate
= m_lib
.GetMoviePreferredRate(m_movie
);
805 wxASSERT(m_lib
.GetMoviesError() == noErr
);
807 // Note that the callback here is optional,
808 // but without it PrePrerollMovie can be buggy
809 // (see Apple ml). Also, some may wonder
810 // why we need this at all - this is because
811 // Apple docs say QuickTime streamed movies
812 // require it if you don't use a Movie Controller,
813 // which we don't by default.
815 m_lib
.PrePrerollMovie(m_movie
, timeNow
, playRate
,
816 (WXFARPROC
)wxQTMediaBackend::PPRMProc
,
825 //---------------------------------------------------------------------------
826 // wxQTMediaBackend::FinishLoad
828 // 1) Create the movie timer
829 // 2) Get real size of movie for GetBestSize/sizers
830 // 3) Set the movie time scale to something usable so that seeking
831 // etc. will work correctly
832 // 4) Set our Movie Controller to display the movie if it exists,
833 // otherwise set the bounds of the Movie
834 // 5) Refresh parent window
835 //---------------------------------------------------------------------------
836 void wxQTMediaBackend::FinishLoad()
838 // Create the playing/streaming timer
839 m_timer
= new wxQTPlayTimer(m_movie
, (wxQTMediaBackend
*) this, &m_lib
);
842 m_timer
->Start(MOVIE_DELAY
, wxTIMER_CONTINUOUS
);
844 // get the real size of the movie
846 memset(&outRect
, 0, sizeof(Rect
)); // suppress annoying VC6 warning
847 m_lib
.GetMovieNaturalBoundsRect (m_movie
, &outRect
);
848 wxASSERT(m_lib
.GetMoviesError() == noErr
);
850 m_bestSize
.x
= outRect
.right
- outRect
.left
;
851 m_bestSize
.y
= outRect
.bottom
- outRect
.top
;
853 // Handle the movie GWorld
857 thePoint
.h
= thePoint
.v
= 0;
858 m_lib
.MCSetMovie(m_pMC
, m_movie
,
859 m_lib
.GetNativeWindowPort(m_ctrl
->GetHandle()),
861 m_lib
.MCSetVisible(m_pMC
, true);
866 m_lib
.SetMovieGWorld(m_movie
,
867 (CGrafPtr
) m_lib
.GetNativeWindowPort(m_ctrl
->GetHWND()),
871 // Set the movie to millisecond precision
872 m_lib
.SetMovieTimeScale(m_movie
, 1000);
873 wxASSERT(m_lib
.GetMoviesError() == noErr
);
878 //---------------------------------------------------------------------------
879 // wxQTMediaBackend::Play
881 // 1) Start the QT movie
882 // 2) Start the movie loading timer
884 // NOTE: This will still return success even when
885 // the movie is still loading, and as mentioned in wxQTLoadTimer
886 // I don't know of a way to force this to be sync - so if its
887 // still loading the function will return true but the movie will
888 // still be in the stopped state
889 //---------------------------------------------------------------------------
890 bool wxQTMediaBackend::Play()
892 m_lib
.StartMovie(m_movie
);
895 return m_lib
.GetMoviesError() == noErr
;
898 //---------------------------------------------------------------------------
899 // wxQTMediaBackend::Pause
902 // 2) Stop the movie timer
903 //---------------------------------------------------------------------------
904 bool wxQTMediaBackend::Pause()
907 m_lib
.StopMovie(m_movie
);
909 return m_lib
.GetMoviesError() == noErr
;
912 //---------------------------------------------------------------------------
913 // wxQTMediaBackend::Stop
916 // 2) Stop the movie timer
917 // 3) Seek to the beginning of the movie
918 //---------------------------------------------------------------------------
919 bool wxQTMediaBackend::Stop()
923 m_lib
.StopMovie(m_movie
);
924 if (m_lib
.GetMoviesError() == noErr
)
925 m_lib
.GoToBeginningOfMovie(m_movie
);
927 return m_lib
.GetMoviesError() == noErr
;
930 //---------------------------------------------------------------------------
931 // wxQTMediaBackend::GetPlaybackRate
933 // Get the movie playback rate from ::GetMovieRate
934 //---------------------------------------------------------------------------
935 double wxQTMediaBackend::GetPlaybackRate()
937 return ( ((double)m_lib
.GetMovieRate(m_movie
)) / 0x10000);
940 //---------------------------------------------------------------------------
941 // wxQTMediaBackend::SetPlaybackRate
943 // Convert dRate to Fixed and Set the movie rate through SetMovieRate
944 //---------------------------------------------------------------------------
945 bool wxQTMediaBackend::SetPlaybackRate(double dRate
)
947 m_lib
.SetMovieRate(m_movie
, (Fixed
) (dRate
* 0x10000));
949 return m_lib
.GetMoviesError() == noErr
;
952 //---------------------------------------------------------------------------
953 // wxQTMediaBackend::SetPosition
955 // 1) Create a time record struct (TimeRecord) with appropriate values
956 // 2) Pass struct to SetMovieTime
957 //---------------------------------------------------------------------------
958 bool wxQTMediaBackend::SetPosition(wxLongLong where
)
960 // NB: For some reason SetMovieTime does not work
961 // correctly with the Quicktime Windows SDK (6)
962 // From Muskelkatermann at the wxForum
963 // http://www.solidsteel.nl/users/wxwidgets/viewtopic.php?t=2957
964 // RN - note that I have not verified this but there
965 // is no harm in calling SetMovieTimeValue instead
967 TimeRecord theTimeRecord
;
968 memset(&theTimeRecord
, 0, sizeof(TimeRecord
));
969 theTimeRecord
.value
.lo
= where
.GetLo();
970 theTimeRecord
.scale
= m_lib
.GetMovieTimeScale(m_movie
);
971 theTimeRecord
.base
= m_lib
.GetMovieTimeBase(m_movie
);
972 m_lib
.SetMovieTime(m_movie
, &theTimeRecord
);
974 m_lib
.SetMovieTimeValue(m_movie
, where
.GetLo());
977 return (m_lib
.GetMoviesError() == noErr
);
980 //---------------------------------------------------------------------------
981 // wxQTMediaBackend::GetPosition
983 // 1) Calls GetMovieTime to get the position we are in in the movie
984 // in milliseconds (we called
985 //---------------------------------------------------------------------------
986 wxLongLong
wxQTMediaBackend::GetPosition()
988 return m_lib
.GetMovieTime(m_movie
, NULL
);
991 //---------------------------------------------------------------------------
992 // wxQTMediaBackend::GetVolume
994 // Gets the volume through GetMovieVolume - which returns a 16 bit short -
996 // +--------+--------+
998 // +--------+--------+
1000 // (1) first 8 bits are value before decimal
1001 // (2) second 8 bits are value after decimal
1003 // Volume ranges from -1.0 (gain but no sound), 0 (no sound and no gain) to
1004 // 1 (full gain and sound)
1005 //---------------------------------------------------------------------------
1006 double wxQTMediaBackend::GetVolume()
1008 short sVolume
= m_lib
.GetMovieVolume(m_movie
);
1009 wxASSERT(m_lib
.GetMoviesError() == noErr
);
1011 if (sVolume
& (128 << 8)) //negative - no sound
1014 return sVolume
/ 256.0;
1017 //---------------------------------------------------------------------------
1018 // wxQTMediaBackend::SetVolume
1020 // Sets the volume through SetMovieVolume - which takes a 16 bit short -
1022 // +--------+--------+
1024 // +--------+--------+
1026 // (1) first 8 bits are value before decimal
1027 // (2) second 8 bits are value after decimal
1029 // Volume ranges from -1.0 (gain but no sound), 0 (no sound and no gain) to
1030 // 1 (full gain and sound)
1031 //---------------------------------------------------------------------------
1032 bool wxQTMediaBackend::SetVolume(double dVolume
)
1034 m_lib
.SetMovieVolume(m_movie
, (short) (dVolume
* 256));
1035 return m_lib
.GetMoviesError() == noErr
;
1038 //---------------------------------------------------------------------------
1039 // wxQTMediaBackend::GetDuration
1041 // Calls GetMovieDuration
1042 //---------------------------------------------------------------------------
1043 wxLongLong
wxQTMediaBackend::GetDuration()
1045 return m_lib
.GetMovieDuration(m_movie
);
1048 //---------------------------------------------------------------------------
1049 // wxQTMediaBackend::GetState
1051 // Determines the current state:
1052 // if we are at the beginning, then we are stopped
1053 //---------------------------------------------------------------------------
1054 wxMediaState
wxQTMediaBackend::GetState()
1057 return wxMEDIASTATE_PLAYING
;
1058 else if ( !m_movie
|| wxQTMediaBackend::GetPosition() == 0 )
1059 return wxMEDIASTATE_STOPPED
;
1061 return wxMEDIASTATE_PAUSED
;
1064 //---------------------------------------------------------------------------
1065 // wxQTMediaBackend::Cleanup
1067 // Diposes of the movie timer, Disassociates the Movie Controller with
1068 // movie and hides it if it exists, and stops and disposes
1070 //---------------------------------------------------------------------------
1071 void wxQTMediaBackend::Cleanup()
1081 m_lib
.StopMovie(m_movie
);
1086 thePoint
.h
= thePoint
.v
= 0;
1087 m_lib
.MCSetVisible(m_pMC
, false);
1088 m_lib
.MCSetMovie(m_pMC
, NULL
, NULL
, thePoint
);
1091 m_lib
.DisposeMovie(m_movie
);
1095 //---------------------------------------------------------------------------
1096 // wxQTMediaBackend::ShowPlayerControls
1098 // Creates a movie controller for the Movie if the user wants it
1099 //---------------------------------------------------------------------------
1100 bool wxQTMediaBackend::ShowPlayerControls(wxMediaCtrlPlayerControls flags
)
1104 // restore old wndproc
1105 wxSetWindowProc((HWND
)m_ctrl
->GetHWND(), wxWndProc
);
1106 m_lib
.DisposeMovieController(m_pMC
);
1109 // movie controller height
1113 if (flags
&& m_movie
)
1116 wxRect wxrect
= m_ctrl
->GetClientRect();
1118 // make room for controller
1119 if (wxrect
.width
< 320)
1122 rect
.top
= (short)wxrect
.y
;
1123 rect
.left
= (short)wxrect
.x
;
1124 rect
.right
= (short)(rect
.left
+ wxrect
.width
);
1125 rect
.bottom
= (short)(rect
.top
+ wxrect
.height
);
1129 m_pMC
= m_lib
.NewMovieController(m_movie
, &rect
, mcTopLeftMovie
|
1130 // mcScaleMovieToFit |
1133 m_lib
.MCDoAction(m_pMC
, 32, (void*)true); // mcActionSetKeysEnabled
1134 m_lib
.MCSetActionFilterWithRefCon(m_pMC
,
1135 (WXFARPROC
)wxQTMediaBackend::MCFilterProc
, (void*)this);
1136 m_bestSize
.y
+= 16; // movie controller height
1138 // By default the movie controller uses its own colour palette
1139 // for the movie which can be bad on some files, so turn it off.
1140 // Also turn off its frame / border for the movie
1141 // Also take care of a couple of the interface flags here
1143 m_lib
.MCDoAction(m_pMC
, 39/*mcActionGetFlags*/, (void*)&mcFlags
);
1146 // (1<< 0) /*mcFlagSuppressMovieFrame*/ |
1147 (1<< 3) /*mcFlagsUseWindowPalette*/
1148 | ((flags
& wxMEDIACTRLPLAYERCONTROLS_STEP
)
1149 ? 0 : (1<< 1) /*mcFlagSuppressStepButtons*/)
1150 | ((flags
& wxMEDIACTRLPLAYERCONTROLS_VOLUME
)
1151 ? 0 : (1<< 2) /*mcFlagSuppressSpeakerButton*/)
1152 // | (1<< 4) /*mcFlagDontInvalidate*/ // if we take care of repainting ourselves
1155 m_lib
.MCDoAction(m_pMC
, 38/*mcActionSetFlags*/, wxUIntToPtr(mcFlags
));
1157 // intercept the wndproc of our control window
1158 wxSetWindowProc((HWND
)m_ctrl
->GetHWND(), wxQTMediaBackend::QTWndProc
);
1160 // set the user data of our window
1161 wxSetWindowUserData((HWND
)m_ctrl
->GetHWND(), this);
1165 NotifyMovieSizeChanged();
1167 return m_lib
.GetMoviesError() == noErr
;
1170 //---------------------------------------------------------------------------
1171 // wxQTMediaBackend::MCFilterProc (static)
1173 // Callback for when the movie controller recieves a message
1174 //---------------------------------------------------------------------------
1175 Boolean
wxQTMediaBackend::MCFilterProc(MovieController
WXUNUSED(theController
),
1177 void * WXUNUSED(params
),
1180 // NB: potential optimisation
1184 wxQTMediaBackend
* pThis
= (wxQTMediaBackend
*)refCon
;
1189 // don't process idle events
1193 // play button triggered - MC will set movie to opposite state
1194 // of current - playing ? paused : playing
1196 pThis
->m_bPlaying
= !(pThis
->m_bPlaying
);
1198 // NB: Sometimes it doesn't redraw properly -
1199 // if you click on the button but don't move the mouse
1200 // the button will not change its state until you move
1201 // mcActionDraw and Refresh/Update combo do nothing
1202 // to help this unfortunately
1212 //---------------------------------------------------------------------------
1213 // wxQTMediaBackend::GetVideoSize
1215 // Returns the actual size of the QT movie
1216 //---------------------------------------------------------------------------
1217 wxSize
wxQTMediaBackend::GetVideoSize() const
1222 //---------------------------------------------------------------------------
1223 // wxQTMediaBackend::Move
1225 // Sets the bounds of either the Movie or Movie Controller
1226 //---------------------------------------------------------------------------
1227 void wxQTMediaBackend::Move(int WXUNUSED(x
), int WXUNUSED(y
), int w
, int h
)
1231 // make room for controller
1237 Rect theRect
= {0, 0, (short)h
, (short)w
};
1238 m_lib
.MCSetControllerBoundsRect(m_pMC
, &theRect
);
1242 Rect theRect
= {0, 0, (short)h
, (short)w
};
1243 m_lib
.SetMovieBox(m_movie
, &theRect
);
1246 wxASSERT(m_lib
.GetMoviesError() == noErr
);
1250 //---------------------------------------------------------------------------
1251 // wxQTMediaBackend::OnEraseBackground
1253 // Suggestion from Greg Hazel to repaint the movie when idle
1256 // TODO: We may be repainting too much here - under what exact circumstances
1257 // do we need this? I think Move also repaints correctly for the Movie
1258 // Controller, so in that instance we don't need this either
1259 //---------------------------------------------------------------------------
1260 void wxQTMediaEvtHandler::OnEraseBackground(wxEraseEvent
& evt
)
1262 wxQuickTimeLibrary
& m_pLib
= m_qtb
->m_lib
;
1266 // repaint movie controller
1267 m_pLib
.MCDoAction(m_qtb
->m_pMC
, 2 /*mcActionDraw*/,
1268 m_pLib
.GetNativeWindowPort(m_hwnd
));
1270 else if ( m_qtb
->m_movie
)
1272 // no movie controller
1273 CGrafPtr port
= (CGrafPtr
)m_pLib
.GetNativeWindowPort(m_hwnd
);
1275 m_pLib
.BeginUpdate(port
);
1276 m_pLib
.UpdateMovie(m_qtb
->m_movie
);
1277 wxASSERT(m_pLib
.GetMoviesError() == noErr
);
1278 m_pLib
.EndUpdate(port
);
1283 // let the system repaint the window
1288 //---------------------------------------------------------------------------
1290 //---------------------------------------------------------------------------
1292 // in source file that contains stuff you don't directly use
1293 #include "wx/html/forcelnk.h"
1294 FORCE_LINK_ME(wxmediabackend_qt
)
1296 #endif // wxUSE_MEDIACTRL && wxUSE_ACTIVEX