2 * VFW capture interface
3 * Copyright (c) 2006-2008 Ramiro Polla
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
22 #include "libavformat/internal.h"
23 #include "libavutil/log.h"
24 #include "libavutil/opt.h"
25 #include "libavutil/parseutils.h"
30 /* Some obsolete versions of MinGW32 before 4.0.0 lack this. */
32 #define HWND_MESSAGE ((HWND) -3)
41 unsigned int curbufsize
;
42 unsigned int frame_num
;
43 char *video_size
; /**< A string describing video size, set by a private option. */
44 char *framerate
; /**< Set by a private option. */
47 static enum AVPixelFormat
vfw_pixfmt(DWORD biCompression
, WORD biBitCount
)
49 switch(biCompression
) {
50 case MKTAG('U', 'Y', 'V', 'Y'):
51 return AV_PIX_FMT_UYVY422
;
52 case MKTAG('Y', 'U', 'Y', '2'):
53 return AV_PIX_FMT_YUYV422
;
54 case MKTAG('I', '4', '2', '0'):
55 return AV_PIX_FMT_YUV420P
;
57 switch(biBitCount
) { /* 1-8 are untested */
59 return AV_PIX_FMT_MONOWHITE
;
61 return AV_PIX_FMT_RGB4
;
63 return AV_PIX_FMT_RGB8
;
65 return AV_PIX_FMT_RGB555
;
67 return AV_PIX_FMT_BGR24
;
69 return AV_PIX_FMT_RGB32
;
72 return AV_PIX_FMT_NONE
;
75 static enum AVCodecID
vfw_codecid(DWORD biCompression
)
77 switch(biCompression
) {
78 case MKTAG('d', 'v', 's', 'd'):
79 return AV_CODEC_ID_DVVIDEO
;
80 case MKTAG('M', 'J', 'P', 'G'):
81 case MKTAG('m', 'j', 'p', 'g'):
82 return AV_CODEC_ID_MJPEG
;
84 return AV_CODEC_ID_NONE
;
87 #define dstruct(pctx, sname, var, type) \
88 av_log(pctx, AV_LOG_DEBUG, #var":\t%"type"\n", sname->var)
90 static void dump_captureparms(AVFormatContext
*s
, CAPTUREPARMS
*cparms
)
92 av_log(s
, AV_LOG_DEBUG
, "CAPTUREPARMS\n");
93 dstruct(s
, cparms
, dwRequestMicroSecPerFrame
, "lu");
94 dstruct(s
, cparms
, fMakeUserHitOKToCapture
, "d");
95 dstruct(s
, cparms
, wPercentDropForError
, "u");
96 dstruct(s
, cparms
, fYield
, "d");
97 dstruct(s
, cparms
, dwIndexSize
, "lu");
98 dstruct(s
, cparms
, wChunkGranularity
, "u");
99 dstruct(s
, cparms
, fUsingDOSMemory
, "d");
100 dstruct(s
, cparms
, wNumVideoRequested
, "u");
101 dstruct(s
, cparms
, fCaptureAudio
, "d");
102 dstruct(s
, cparms
, wNumAudioRequested
, "u");
103 dstruct(s
, cparms
, vKeyAbort
, "u");
104 dstruct(s
, cparms
, fAbortLeftMouse
, "d");
105 dstruct(s
, cparms
, fAbortRightMouse
, "d");
106 dstruct(s
, cparms
, fLimitEnabled
, "d");
107 dstruct(s
, cparms
, wTimeLimit
, "u");
108 dstruct(s
, cparms
, fMCIControl
, "d");
109 dstruct(s
, cparms
, fStepMCIDevice
, "d");
110 dstruct(s
, cparms
, dwMCIStartTime
, "lu");
111 dstruct(s
, cparms
, dwMCIStopTime
, "lu");
112 dstruct(s
, cparms
, fStepCaptureAt2x
, "d");
113 dstruct(s
, cparms
, wStepCaptureAverageFrames
, "u");
114 dstruct(s
, cparms
, dwAudioBufferSize
, "lu");
115 dstruct(s
, cparms
, fDisableWriteCache
, "d");
116 dstruct(s
, cparms
, AVStreamMaster
, "u");
119 static void dump_videohdr(AVFormatContext
*s
, VIDEOHDR
*vhdr
)
122 av_log(s
, AV_LOG_DEBUG
, "VIDEOHDR\n");
123 dstruct(s
, vhdr
, lpData
, "p");
124 dstruct(s
, vhdr
, dwBufferLength
, "lu");
125 dstruct(s
, vhdr
, dwBytesUsed
, "lu");
126 dstruct(s
, vhdr
, dwTimeCaptured
, "lu");
127 dstruct(s
, vhdr
, dwUser
, "lu");
128 dstruct(s
, vhdr
, dwFlags
, "lu");
129 dstruct(s
, vhdr
, dwReserved
[0], "lu");
130 dstruct(s
, vhdr
, dwReserved
[1], "lu");
131 dstruct(s
, vhdr
, dwReserved
[2], "lu");
132 dstruct(s
, vhdr
, dwReserved
[3], "lu");
136 static void dump_bih(AVFormatContext
*s
, BITMAPINFOHEADER
*bih
)
138 av_log(s
, AV_LOG_DEBUG
, "BITMAPINFOHEADER\n");
139 dstruct(s
, bih
, biSize
, "lu");
140 dstruct(s
, bih
, biWidth
, "ld");
141 dstruct(s
, bih
, biHeight
, "ld");
142 dstruct(s
, bih
, biPlanes
, "d");
143 dstruct(s
, bih
, biBitCount
, "d");
144 dstruct(s
, bih
, biCompression
, "lu");
145 av_log(s
, AV_LOG_DEBUG
, " biCompression:\t\"%.4s\"\n",
146 (char*) &bih
->biCompression
);
147 dstruct(s
, bih
, biSizeImage
, "lu");
148 dstruct(s
, bih
, biXPelsPerMeter
, "lu");
149 dstruct(s
, bih
, biYPelsPerMeter
, "lu");
150 dstruct(s
, bih
, biClrUsed
, "lu");
151 dstruct(s
, bih
, biClrImportant
, "lu");
154 static int shall_we_drop(AVFormatContext
*s
)
156 struct vfw_ctx
*ctx
= s
->priv_data
;
157 static const uint8_t dropscore
[] = {62, 75, 87, 100};
158 const int ndropscores
= FF_ARRAY_ELEMS(dropscore
);
159 unsigned int buffer_fullness
= (ctx
->curbufsize
*100)/s
->max_picture_buffer
;
161 if(dropscore
[++ctx
->frame_num
%ndropscores
] <= buffer_fullness
) {
162 av_log(s
, AV_LOG_ERROR
,
163 "real-time buffer %d%% full! frame dropped!\n", buffer_fullness
);
170 static LRESULT CALLBACK
videostream_cb(HWND hwnd
, LPVIDEOHDR vdhdr
)
174 AVPacketList
**ppktl
, *pktl_next
;
176 s
= (AVFormatContext
*) GetWindowLongPtr(hwnd
, GWLP_USERDATA
);
179 dump_videohdr(s
, vdhdr
);
184 WaitForSingleObject(ctx
->mutex
, INFINITE
);
186 pktl_next
= av_mallocz(sizeof(AVPacketList
));
190 if(av_new_packet(&pktl_next
->pkt
, vdhdr
->dwBytesUsed
) < 0) {
195 pktl_next
->pkt
.pts
= vdhdr
->dwTimeCaptured
;
196 memcpy(pktl_next
->pkt
.data
, vdhdr
->lpData
, vdhdr
->dwBytesUsed
);
198 for(ppktl
= &ctx
->pktl
; *ppktl
; ppktl
= &(*ppktl
)->next
);
201 ctx
->curbufsize
+= vdhdr
->dwBytesUsed
;
203 SetEvent(ctx
->event
);
204 ReleaseMutex(ctx
->mutex
);
208 ReleaseMutex(ctx
->mutex
);
212 static int vfw_read_close(AVFormatContext
*s
)
214 struct vfw_ctx
*ctx
= s
->priv_data
;
218 SendMessage(ctx
->hwnd
, WM_CAP_SET_CALLBACK_VIDEOSTREAM
, 0, 0);
219 SendMessage(ctx
->hwnd
, WM_CAP_DRIVER_DISCONNECT
, 0, 0);
220 DestroyWindow(ctx
->hwnd
);
223 CloseHandle(ctx
->mutex
);
225 CloseHandle(ctx
->event
);
229 AVPacketList
*next
= pktl
->next
;
230 av_free_packet(&pktl
->pkt
);
238 static int vfw_read_header(AVFormatContext
*s
)
240 struct vfw_ctx
*ctx
= s
->priv_data
;
241 AVCodecContext
*codec
;
245 BITMAPINFO
*bi
= NULL
;
250 AVRational framerate_q
;
252 if (!strcmp(s
->filename
, "list")) {
253 for (devnum
= 0; devnum
<= 9; devnum
++) {
254 char driver_name
[256];
255 char driver_ver
[256];
256 ret
= capGetDriverDescription(devnum
,
257 driver_name
, sizeof(driver_name
),
258 driver_ver
, sizeof(driver_ver
));
260 av_log(s
, AV_LOG_INFO
, "Driver %d\n", devnum
);
261 av_log(s
, AV_LOG_INFO
, " %s\n", driver_name
);
262 av_log(s
, AV_LOG_INFO
, " %s\n", driver_ver
);
268 ctx
->hwnd
= capCreateCaptureWindow(NULL
, 0, 0, 0, 0, 0, HWND_MESSAGE
, 0);
270 av_log(s
, AV_LOG_ERROR
, "Could not create capture window.\n");
274 /* If atoi fails, devnum==0 and the default device is used */
275 devnum
= atoi(s
->filename
);
277 ret
= SendMessage(ctx
->hwnd
, WM_CAP_DRIVER_CONNECT
, devnum
, 0);
279 av_log(s
, AV_LOG_ERROR
, "Could not connect to device.\n");
280 DestroyWindow(ctx
->hwnd
);
281 return AVERROR(ENODEV
);
284 SendMessage(ctx
->hwnd
, WM_CAP_SET_OVERLAY
, 0, 0);
285 SendMessage(ctx
->hwnd
, WM_CAP_SET_PREVIEW
, 0, 0);
287 ret
= SendMessage(ctx
->hwnd
, WM_CAP_SET_CALLBACK_VIDEOSTREAM
, 0,
288 (LPARAM
) videostream_cb
);
290 av_log(s
, AV_LOG_ERROR
, "Could not set video stream callback.\n");
294 SetWindowLongPtr(ctx
->hwnd
, GWLP_USERDATA
, (LONG_PTR
) s
);
296 st
= avformat_new_stream(s
, NULL
);
299 return AVERROR(ENOMEM
);
302 /* Set video format */
303 bisize
= SendMessage(ctx
->hwnd
, WM_CAP_GET_VIDEOFORMAT
, 0, 0);
306 bi
= av_malloc(bisize
);
309 return AVERROR(ENOMEM
);
311 ret
= SendMessage(ctx
->hwnd
, WM_CAP_GET_VIDEOFORMAT
, bisize
, (LPARAM
) bi
);
315 dump_bih(s
, &bi
->bmiHeader
);
317 ret
= av_parse_video_rate(&framerate_q
, ctx
->framerate
);
319 av_log(s
, AV_LOG_ERROR
, "Could not parse framerate '%s'.\n", ctx
->framerate
);
323 if (ctx
->video_size
) {
324 ret
= av_parse_video_size(&bi
->bmiHeader
.biWidth
, &bi
->bmiHeader
.biHeight
, ctx
->video_size
);
326 av_log(s
, AV_LOG_ERROR
, "Couldn't parse video size.\n");
332 /* For testing yet unsupported compressions
333 * Copy these values from user-supplied verbose information */
334 bi
->bmiHeader
.biWidth
= 320;
335 bi
->bmiHeader
.biHeight
= 240;
336 bi
->bmiHeader
.biPlanes
= 1;
337 bi
->bmiHeader
.biBitCount
= 12;
338 bi
->bmiHeader
.biCompression
= MKTAG('I','4','2','0');
339 bi
->bmiHeader
.biSizeImage
= 115200;
340 dump_bih(s
, &bi
->bmiHeader
);
343 ret
= SendMessage(ctx
->hwnd
, WM_CAP_SET_VIDEOFORMAT
, bisize
, (LPARAM
) bi
);
345 av_log(s
, AV_LOG_ERROR
, "Could not set Video Format.\n");
349 biCompression
= bi
->bmiHeader
.biCompression
;
350 biBitCount
= bi
->bmiHeader
.biBitCount
;
352 /* Set sequence setup */
353 ret
= SendMessage(ctx
->hwnd
, WM_CAP_GET_SEQUENCE_SETUP
, sizeof(cparms
),
358 dump_captureparms(s
, &cparms
);
360 cparms
.fYield
= 1; // Spawn a background thread
361 cparms
.dwRequestMicroSecPerFrame
=
362 (framerate_q
.den
*1000000) / framerate_q
.num
;
363 cparms
.fAbortLeftMouse
= 0;
364 cparms
.fAbortRightMouse
= 0;
365 cparms
.fCaptureAudio
= 0;
366 cparms
.vKeyAbort
= 0;
368 ret
= SendMessage(ctx
->hwnd
, WM_CAP_SET_SEQUENCE_SETUP
, sizeof(cparms
),
374 codec
->time_base
= av_inv_q(framerate_q
);
375 codec
->codec_type
= AVMEDIA_TYPE_VIDEO
;
376 codec
->width
= bi
->bmiHeader
.biWidth
;
377 codec
->height
= bi
->bmiHeader
.biHeight
;
378 codec
->pix_fmt
= vfw_pixfmt(biCompression
, biBitCount
);
379 if(codec
->pix_fmt
== AV_PIX_FMT_NONE
) {
380 codec
->codec_id
= vfw_codecid(biCompression
);
381 if(codec
->codec_id
== AV_CODEC_ID_NONE
) {
382 av_log(s
, AV_LOG_ERROR
, "Unknown compression type. "
383 "Please report verbose (-v 9) debug information.\n");
385 return AVERROR_PATCHWELCOME
;
387 codec
->bits_per_coded_sample
= biBitCount
;
389 codec
->codec_id
= AV_CODEC_ID_RAWVIDEO
;
390 if(biCompression
== BI_RGB
) {
391 codec
->bits_per_coded_sample
= biBitCount
;
392 codec
->extradata
= av_malloc(9 + FF_INPUT_BUFFER_PADDING_SIZE
);
393 if (codec
->extradata
) {
394 codec
->extradata_size
= 9;
395 memcpy(codec
->extradata
, "BottomUp", 9);
402 avpriv_set_pts_info(st
, 32, 1, 1000);
404 ctx
->mutex
= CreateMutex(NULL
, 0, NULL
);
406 av_log(s
, AV_LOG_ERROR
, "Could not create Mutex.\n" );
409 ctx
->event
= CreateEvent(NULL
, 1, 0, NULL
);
411 av_log(s
, AV_LOG_ERROR
, "Could not create Event.\n" );
415 ret
= SendMessage(ctx
->hwnd
, WM_CAP_SEQUENCE_NOFILE
, 0, 0);
417 av_log(s
, AV_LOG_ERROR
, "Could not start capture sequence.\n" );
429 static int vfw_read_packet(AVFormatContext
*s
, AVPacket
*pkt
)
431 struct vfw_ctx
*ctx
= s
->priv_data
;
432 AVPacketList
*pktl
= NULL
;
435 WaitForSingleObject(ctx
->mutex
, INFINITE
);
438 *pkt
= ctx
->pktl
->pkt
;
439 ctx
->pktl
= ctx
->pktl
->next
;
442 ResetEvent(ctx
->event
);
443 ReleaseMutex(ctx
->mutex
);
445 if(s
->flags
& AVFMT_FLAG_NONBLOCK
) {
446 return AVERROR(EAGAIN
);
448 WaitForSingleObject(ctx
->event
, INFINITE
);
453 ctx
->curbufsize
-= pkt
->size
;
458 #define OFFSET(x) offsetof(struct vfw_ctx, x)
459 #define DEC AV_OPT_FLAG_DECODING_PARAM
460 static const AVOption options
[] = {
461 { "video_size", "A string describing frame size, such as 640x480 or hd720.", OFFSET(video_size
), AV_OPT_TYPE_STRING
, {.str
= NULL
}, 0, 0, DEC
},
462 { "framerate", "", OFFSET(framerate
), AV_OPT_TYPE_STRING
, {.str
= "ntsc"}, 0, 0, DEC
},
466 static const AVClass vfw_class
= {
467 .class_name
= "VFW indev",
468 .item_name
= av_default_item_name
,
470 .version
= LIBAVUTIL_VERSION_INT
,
471 .category
= AV_CLASS_CATEGORY_DEVICE_VIDEO_INPUT
474 AVInputFormat ff_vfwcap_demuxer
= {
476 .long_name
= NULL_IF_CONFIG_SMALL("VfW video capture"),
477 .priv_data_size
= sizeof(struct vfw_ctx
),
478 .read_header
= vfw_read_header
,
479 .read_packet
= vfw_read_packet
,
480 .read_close
= vfw_read_close
,
481 .flags
= AVFMT_NOFILE
,
482 .priv_class
= &vfw_class
,