diff options
Diffstat (limited to 'DOCS/tech')
-rw-r--r-- | DOCS/tech/slave.txt | 38 |
1 files changed, 20 insertions, 18 deletions
diff --git a/DOCS/tech/slave.txt b/DOCS/tech/slave.txt index 6187affab5..d95ef41d84 100644 --- a/DOCS/tech/slave.txt +++ b/DOCS/tech/slave.txt @@ -20,6 +20,10 @@ Most slave mode commands are equivalent to command line options, though not necessarily under the same name. Detailed descriptions can be found in the man page. +NOTE: the following paragraph is mostly obsolete; tricky pause handling +was required in old MPlayer versions where all commands unpaused by default. +Now running commands does not require leaving pause state any more, and +the prefixes described here should not be required in normal use. All commands can be prefixed with one of "pausing ", "pausing_keep ", or "pausing_toggle ". "pausing " tells MPlayer to pause as soon as possible after processing the command. "pausing_keep " tells MPlayer to do so only if @@ -36,11 +40,6 @@ since other values do not make much sense for them. Various tips and tricks (please help expand it!): -- Try using something like - pausing_keep_force pt_step 1 - get_property pause - to switch to the next file. It avoids audio playback starting to play - the old file for a short time before switching to the new one. - To ensure the user can't control MPlayer "behind your back" use something like -input nodefault-bindings -noconfig all @@ -183,9 +182,6 @@ screenshot <value> 0 Take a single screenshot. 1 Start/stop taking screenshot of each frame. -gui_[about|loadfile|loadsubtitle|play|playlist|preferences|skinbrowser|stop] - GUI actions - key_down_event <value> Inject <value> key code event into MPlayer. @@ -241,7 +237,8 @@ panscan <-1.0 - 1.0> | <0.0 - 1.0> <abs> absolute range. pause - Pause/unpause the playback. + Pause/unpause the playback (use "set_property pause X" to set a particular + value regardless of whether the player is already paused or not). frame_step Play one frame, then pause again. @@ -355,7 +352,8 @@ sub_select [value] Display subtitle with index [value]. Turn subtitle display off if [value] is -1 or greater than the highest available subtitle index. Cycle through the available subtitles if [value] is omitted or less - than -1. Supported subtitle sources are -sub options on the command + than -1 (forward or backward respectively). + Supported subtitle sources are -sub options on the command line, VOBsubs, DVD subtitles, and Ogg and Matroska text streams. This command is mainly for cycling all subtitles, if you want to set a specific subtitle, use sub_file, sub_vob, or sub_demux. @@ -365,26 +363,30 @@ sub_source [source] SUB_SOURCE_SUBS (0) for file subs SUB_SOURCE_VOBSUB (1) for VOBsub files SUB_SOURCE_DEMUX (2) for subtitle embedded in the media file or DVD subs. - If [source] is -1, will turn off subtitle display. If [source] less than -1, - will cycle between the first subtitle of each currently available sources. + If [source] is -1, will turn off subtitle display. + If [value] is omitted or less than -1, will cycle between the first subtitle + of each currently available source (forward or backward respectively). sub_file [value] Display subtitle specifid by [value] for file subs. The [value] is corresponding to ID_FILE_SUB_ID values reported by '-identify'. - If [value] is -1, will turn off subtitle display. If [value] less than -1, - will cycle all file subs. + If [value] is -1, will turn off subtitle display. + If [value] is omitted or less than -1, will cycle all file subs + (forward or backward respectively). sub_vob [value] Display subtitle specifid by [value] for vobsubs. The [value] is corresponding to ID_VOBSUB_ID values reported by '-identify'. - If [value] is -1, will turn off subtitle display. If [value] less than -1, - will cycle all vobsubs. + If [value] is -1, will turn off subtitle display. + If [value] is omitted or less than -1, will cycle all vobsubs + (forward or backward respectively). sub_demux [value] Display subtitle specifid by [value] for subtitles from DVD or embedded in media file. The [value] is corresponding to ID_SUBTITLE_ID values reported by '-identify'. If [value] is -1, will turn off subtitle display. - If [value] less than -1, will cycle all DVD subs or embedded subs. + If [value] is omitted or less than -1, will cycle all DVD subs or embedded subs + (forward or backward respectively). sub_scale <value> [abs] Adjust the subtitle size by +/- <value> or set it to <value> when [abs] @@ -520,7 +522,7 @@ speed float 0.01 100 X X X as -speed loop int -1 X X X as -loop hr_seek string X X X as -hr-seek pts_association_mode string X X X as -pts-association-mode -pause flag 0 1 X 1 if paused, use with pausing_keep_force +pause flag 0 1 X 1 if paused filename string X file playing wo path path string X file playing demuxer string X demuxer used |