core: add option to start in paused state

The --paused option will start the player in paused state. That means it
will start out with a still image of the first frame.

This can be useful in combination with --ss to inspect a certain frame.

Caveat: this plays a small bit of audio at the start, which might be
perceived as an annoying artifact. This is because this is implemented
by frame stepping after initialization in order to decode and display
the first video frame.

cfg-mplayer.h

@@ -485,6 +485,9 @@ const m_option_t common_opts[] = {
     {"sb", &seek_to_byte, CONF_TYPE_POSITION, CONF_MIN, 0, 0, NULL},
     OPT_TIME("ss", seek_to_sec, 0),
 
+    // start paused
+    OPT_FLAG_ON("paused", start_paused, 0),
+
     // stop at given position
     {"endpos", &end_at, CONF_TYPE_TIME_SIZE, 0, 0, 0, NULL},
 

mplayer.c

@@ -5002,6 +5002,9 @@ goto_enable_cache:
         vo_control(mpctx->video_out,
                    mpctx->paused ? VOCTRL_PAUSE : VOCTRL_RESUME, NULL);
 
+    if (mpctx->opts.start_paused)
+        add_step_frame(mpctx);
+
     while (!mpctx->stop_play)
         run_playloop(mpctx);
 

options.h

@@ -67,6 +67,7 @@ typedef struct MPOpts {
     int doubleclick_time;
     int list_properties;
     double seek_to_sec;
+    int start_paused;
     int audio_id;
     int video_id;
     int sub_id;