Move code removing "-psn_xxx" command line arguments to common code.

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

diff --git a/interface/wx/mediactrl.h b/interface/wx/mediactrl.h
index 72b7bd1fbaea4511d7a9237b2d444ea89e5839c1..b2e7042e6e9b04a7e37f78fc5d7723d9180aa8a3 100644 (file)
--- a/interface/wx/mediactrl.h
+++ b/interface/wx/mediactrl.h
@@ -1,9 +1,8 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        mediactrl.h
 /////////////////////////////////////////////////////////////////////////////
 // Name:        mediactrl.h

-// Purpose:     interface of wxMediaEvent
+// Purpose:     interface of wxMediaEvent, wxMediaCtrl

 // Author:      wxWidgets team
 // 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,
 
     /** 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. */
     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.
 
     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.
 
     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
     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
     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,
     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().
 
     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
     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
     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.
     - @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
       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.
     */
         @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,
                 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 wxValidator& validator = wxDefaultValidator,

-                const wxString& name = wxPanelNameStr);
+                const wxString& name = "mediaCtrl");

 
     /**
         Creates this control.
 
     /**
         Creates this control.


@@ -284,11 +283,11 @@ public:
         @param name
             Window name.
     */
         @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,
                 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 wxValidator& validator = wxDefaultValidator,

-                const wxString& name = wxPanelNameStr);
+                const wxString& name = "mediaCtrl");

 
     /**
         Obtains the best size relative to the original/natural size of the
 
     /**
         Obtains the best size relative to the original/natural size of the


@@ -304,7 +303,7 @@ public:
 
         @return zero on failure.
     */
 
         @return zero on failure.
     */

-    double GetPlaybackrate();
+    double GetPlaybackRate();

 
     /**
         Obtains the state the playback of the media is in -
 
     /**
         Obtains the state the playback of the media is in -


@@ -315,7 +314,7 @@ public:
         @row2col{wxMEDIASTATE_PLAYING, The movie is currently playing.}
         @endTable
     */
         @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.
 
     /**
         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
 
     /**
         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);
         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.
     */
     /**
         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.
     */
 
     /**
         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.
 
     /**
         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.
     */
         @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.
 
     /**
         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.
 
         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.
 
         Currently only implemented on the QuickTime and DirectShow backends.
         The function returns @true on success.