X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ba1d7a6cec8d9569ce2e380d4a39ddcd4450c9b5..9e9574fe45b176ee74bba8fad7574cf9906145d1:/interface/wx/mediactrl.h diff --git a/interface/wx/mediactrl.h b/interface/wx/mediactrl.h index e572a1361e..b2e7042e6e 100644 --- a/interface/wx/mediactrl.h +++ b/interface/wx/mediactrl.h @@ -1,9 +1,8 @@ ///////////////////////////////////////////////////////////////////////////// // Name: mediactrl.h -// Purpose: interface of wxMediaEvent +// Purpose: interface of wxMediaEvent, wxMediaCtrl // Author: wxWidgets team -// RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// @@ -12,7 +11,7 @@ enum wxMediaCtrlPlayerControls /** No controls. return wxMediaCtrl to its default state. */ wxMEDIACTRLPLAYERCONTROLS_NONE = 0, - /** Step controls like fastfoward, step one frame etc. */ + /** Step controls like fastforward, step one frame etc. */ wxMEDIACTRLPLAYERCONTROLS_STEP = 1 << 0, /** Volume controls like the speaker icon, volume slider, etc. */ @@ -85,7 +84,7 @@ public: want to render, catch the @c EVT_MEDIA_LOADED event, and then call Play() to show the video/audio of the media in that event. - More complex operations are generally more heavily dependant on the capabilities + More complex operations are generally more heavily dependent on the capabilities of the backend. For example, QuickTime cannot set the playback rate of certain streaming media - while DirectShow is slightly more flexible in that regard. @@ -119,9 +118,9 @@ public: When wxMediaCtrl stops, either by the @c EVT_MEDIA_STOP not being vetoed, or by manually calling Stop(), where it actually stops is not at the beginning, rather, but at the beginning of the stream. That is, when it stops and play - is called, playback is gauranteed to start at the beginning of the media. + is called, playback is guaranteed to start at the beginning of the media. This is because some streams are not seekable, and when stop is called on - them they return to the beginning, thus wxMediaCtrl tries to keep consistant + them they return to the beginning, thus wxMediaCtrl tries to keep consistent for all types of media. Note that when changing the state of the media through Play() and other methods, @@ -134,11 +133,11 @@ public: By default, wxMediaCtrl will scale the size of the video to the requested amount passed to either its constructor or Create(). - After calling wxMediaCtrl::Load or performing an equivilant operation, + After calling wxMediaCtrl::Load or performing an equivalent operation, you can subsequently obtain the "real" size of the video (if there is any) by calling wxMediaCtrl::GetBestSize(). Note that the actual result on the display will be slightly different when wxMediaCtrl::ShowPlayerControls is - activated and the actual video size will be less then specified due to the + activated and the actual video size will be less than specified due to the extra controls provided by the native toolkit. In addition, the backend may modify wxMediaCtrl::GetBestSize() to include the size of the extra controls - so if you want the real size of the video @@ -184,7 +183,7 @@ public: - @b wxMEDIABACKEND_GSTREAMER, Use GStreamer. Unix Only. Requires GStreamer 0.8 along with at the very least the xvimagesink, xoverlay, and gst-play modules of gstreamer to function. - You need the correct modules to play the relavant files, for example the + You need the correct modules to play the relevant files, for example the mad module to play mp3s, etc. - @b wxMEDIABACKEND_WMP10, Uses Windows Media Player 10 (Windows only) - works on mobile machines with Windows Media Player 10 and desktop machines @@ -250,11 +249,11 @@ public: @param name Window name. */ - wxMediaCtrl(wxWindow* parent, wxWindowID id, const wxString& fileName = wxT(""), + wxMediaCtrl(wxWindow* parent, wxWindowID id, const wxString& fileName = wxEmptyString, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, - long style = 0, const wxString& szBackend = wxT(""), + long style = 0, const wxString& szBackend = wxEmptyString, const wxValidator& validator = wxDefaultValidator, - const wxString& name = wxPanelNameStr); + const wxString& name = "mediaCtrl"); /** Creates this control. @@ -284,18 +283,18 @@ public: @param name Window name. */ - bool Create(wxWindow* parent, wxWindowID id, const wxString& fileName = wxT(""), + bool Create(wxWindow* parent, wxWindowID id, const wxString& fileName = wxEmptyString, const wxPoint& pos = wxDefaultPosition, const wxSize& size = wxDefaultSize, - long style = 0, const wxString& szBackend = wxT(""), + long style = 0, const wxString& szBackend = wxEmptyString, const wxValidator& validator = wxDefaultValidator, - const wxString& name = wxPanelNameStr); + const wxString& name = "mediaCtrl"); /** Obtains the best size relative to the original/natural size of the video, if there is any. See @ref mediactrl_video_size for more information. */ - wxSize GetBestSize(); + wxSize GetBestSize() const; /** Obtains the playback rate, or speed of the media. @c 1.0 represents normal @@ -304,7 +303,7 @@ public: @return zero on failure. */ - double GetPlaybackrate(); + double GetPlaybackRate(); /** Obtains the state the playback of the media is in - @@ -315,7 +314,7 @@ public: @row2col{wxMEDIASTATE_PLAYING, The movie is currently playing.} @endTable */ - wxMediaCtrlState GetState(); + wxMediaState GetState(); /** Gets the volume of the media from a 0.0 to 1.0 range. @@ -337,7 +336,7 @@ public: /** Loads the location that uri refers to. Note that this is very - implementation-dependant, although HTTP URI/URLs are generally + implementation-dependent, although HTTP URI/URLs are generally supported, for example. Returns @false if loading fails. */ bool Load(const wxURI& uri); @@ -352,13 +351,13 @@ public: /** Same as Load(const wxURI& uri). Kept for wxPython compatibility. */ - bool LoadURI(const wxURI& uri); + bool LoadURI(const wxString& fileName); /** Same as Load(const wxURI& uri, const wxURI& proxy). Kept for wxPython compatibility. */ - bool LoadURIWithProxy(const wxURI& uri, const wxURI& proxy); + bool LoadURIWithProxy(const wxString& fileName, const wxString& proxy); /** Pauses playback of the movie. @@ -376,7 +375,7 @@ public: @todo Document the wxSeekMode parameter @a mode, and perhaps also the wxFileOffset and wxSeekMode themselves. */ - wxFileOffset Seek(wxFileOffset where, wxSeekMode mode); + wxFileOffset Seek(wxFileOffset where, wxSeekMode mode = wxFromStart); /** Sets the playback rate, or speed of the media, to that referred by @a dRate. @@ -407,7 +406,7 @@ public: default controls provided by the toolkit. The function takes a wxMediaCtrlPlayerControls enumeration, please see available show modes there. - For more see @ref mediactrl_player_controls. + For more info see @ref mediactrl_player_controls. Currently only implemented on the QuickTime and DirectShow backends. The function returns @true on success.