2 * filter to ouput only 1 every n frame, or only the I (key)frame
8 * if you call the filter with I (uppercase) as the parameter
9 * ... -vf framestep=I ...
10 * then ONLY the keyframes are outputted.
11 * For DVD it means, generally, one every 15 frames (IBBPBBPBBPBBPBB), for avi it means
12 * every scene change or every keyint value (see -lavcopts).
14 * if you call the filter with the i (lowercase)
15 * ... -vf framestep=i ...
16 * then a I! followed by a cr is printed when a key frame (eg Intra frame) is
17 * found, leaving the current line of mplayer/mencoder, where you got the
18 * time, in seconds, and frame of the key. Use this information to split the
21 * After the i or alone you can put a positive number and only one frame every
22 * x (the number you set) is passed on the filter chain, limiting the output
26 * ... -vf framestep=i20 ...
27 * Dump one every 20 frames, printing on the console when a I-Frame is encounter.
29 * ... -vf framestep=25
30 * Dump one every 25 frames.
32 * If you call the filter without parameter it does nothing (except using memory
33 * and resource of your system,. of course).
35 * This filter doesn' t work like the option -sstep seconds.
37 * The -sstep seek to the new position, without decoding all frames but,
38 * expecially on avi file coded whith mpeg4 (lavc or xvid or divx), the
39 * seek is not always too much precise.
41 * This filter simply discard the unwanted frames, so you are very precise in
42 * counting the frame but sometime you use a lot of CPU for nothing.
44 * As usual it depends on what you're doing.
46 * copyright (c) 2003 Daniele Forghieri ( guru@digitalfantasy.it )
48 * This file is part of MPlayer.
50 * MPlayer is free software; you can redistribute it and/or modify
51 * it under the terms of the GNU General Public License as published by
52 * the Free Software Foundation; either version 2 of the License, or
53 * (at your option) any later version.
55 * MPlayer is distributed in the hope that it will be useful,
56 * but WITHOUT ANY WARRANTY; without even the implied warranty of
57 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
58 * GNU General Public License for more details.
60 * You should have received a copy of the GNU General Public License along
61 * with MPlayer; if not, write to the Free Software Foundation, Inc.,
62 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
72 #include "cpudetect.h"
74 #include "img_format.h"
78 /* Uncomment if you want to print some info on the format */
79 // #define DUMP_FORMAT_DATA
85 /* Frame output step, 0 = all */
87 /* Only I-Frame (2), print on I-Frame (1) */
92 static int put_image(struct vf_instance
* vf
, mp_image_t
*mpi
, double pts
)
95 struct vf_priv_s
*priv
;
100 /* Print the 'I' if is a intra frame. The \n advance the current line so you got the
101 * current file time (in second) and the frame number on the console ;-)
103 if (priv
->dump_iframe
) {
104 if (mpi
->pict_type
== 1) {
105 mp_msg(MSGT_VFILTER
, MSGL_INFO
, "I!\n");
109 /* decide if frame must be shown */
110 if (priv
->dump_iframe
== 2) {
112 skip
= mpi
->pict_type
== 1 ? 0 : 1;
115 /* Only 1 every frame_step */
117 if ((priv
->frame_step
!= 0) && ((priv
->frame_cur
% priv
->frame_step
) != 0)) {
121 /* Increment current frame */
125 /* Get image, export type (we don't modify tghe image) */
126 dmpi
=vf_get_image(vf
->next
, mpi
->imgfmt
,
127 MP_IMGTYPE_EXPORT
, 0,
129 /* Copy only the pointer ( MP_IMGTYPE_EXPORT ! ) */
130 dmpi
->planes
[0] = mpi
->planes
[0];
131 dmpi
->planes
[1] = mpi
->planes
[1];
132 dmpi
->planes
[2] = mpi
->planes
[2];
134 dmpi
->stride
[0] = mpi
->stride
[0];
135 dmpi
->stride
[1] = mpi
->stride
[1];
136 dmpi
->stride
[2] = mpi
->stride
[2];
138 dmpi
->width
= mpi
->width
;
139 dmpi
->height
= mpi
->height
;
141 /* Chain to next filter / output ... */
142 return vf_next_put_image(vf
, dmpi
, pts
);
149 static void uninit(struct vf_instance
* vf
)
151 /* Free private data */
155 /* Main entry funct for the filter */
156 static int open(vf_instance_t
*vf
, char* args
)
160 vf
->put_image
= put_image
;
162 vf
->default_reqs
= VFCAP_ACCEPT_STRIDE
;
163 vf
->priv
= p
= calloc(1, sizeof(struct vf_priv_s
));
169 #ifdef DUMP_FORMAT_DATA
176 /* Dump only KEY (ie INTRA) frame */
181 /* Print a 'I!' when a i-frame is encounter */
187 p
->frame_step
= atoi(args
);
188 if (p
->frame_step
<= 0) {
189 mp_tmsg(MSGT_VFILTER
, MSGL_WARN
, "[VF_FRAMESTEP] Error parsing argument.\n");
198 const vf_info_t vf_info_framestep
= {
199 "Dump one every n / key frames",