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/avformat.h"
28 /* Defines for VFW missing from MinGW.
29 * Remove this when MinGW incorporates them. */
30 #define HWND_MESSAGE ((HWND)-3)
34 /* End of missing MinGW defines */
42 unsigned int curbufsize
;
43 unsigned int frame_num
;
46 static enum PixelFormat
vfw_pixfmt(DWORD biCompression
, WORD biBitCount
)
48 switch(biCompression
) {
49 case MKTAG('Y', 'U', 'Y', '2'):
50 return PIX_FMT_YUYV422
;
51 case MKTAG('I', '4', '2', '0'):
52 return PIX_FMT_YUV420P
;
54 switch(biBitCount
) { /* 1-8 are untested */
56 return PIX_FMT_MONOWHITE
;
62 return PIX_FMT_RGB555
;
72 static enum CodecID
vfw_codecid(DWORD biCompression
)
74 switch(biCompression
) {
75 case MKTAG('d', 'v', 's', 'd'):
76 return CODEC_ID_DVVIDEO
;
81 #define dstruct(pctx, sname, var, type) \
82 av_log(pctx, AV_LOG_DEBUG, #var":\t%"type"\n", sname->var)
84 static void dump_captureparms(AVFormatContext
*s
, CAPTUREPARMS
*cparms
)
86 av_log(s
, AV_LOG_DEBUG
, "CAPTUREPARMS\n");
87 dstruct(s
, cparms
, dwRequestMicroSecPerFrame
, "lu");
88 dstruct(s
, cparms
, fMakeUserHitOKToCapture
, "d");
89 dstruct(s
, cparms
, wPercentDropForError
, "u");
90 dstruct(s
, cparms
, fYield
, "d");
91 dstruct(s
, cparms
, dwIndexSize
, "lu");
92 dstruct(s
, cparms
, wChunkGranularity
, "u");
93 dstruct(s
, cparms
, fUsingDOSMemory
, "d");
94 dstruct(s
, cparms
, wNumVideoRequested
, "u");
95 dstruct(s
, cparms
, fCaptureAudio
, "d");
96 dstruct(s
, cparms
, wNumAudioRequested
, "u");
97 dstruct(s
, cparms
, vKeyAbort
, "u");
98 dstruct(s
, cparms
, fAbortLeftMouse
, "d");
99 dstruct(s
, cparms
, fAbortRightMouse
, "d");
100 dstruct(s
, cparms
, fLimitEnabled
, "d");
101 dstruct(s
, cparms
, wTimeLimit
, "u");
102 dstruct(s
, cparms
, fMCIControl
, "d");
103 dstruct(s
, cparms
, fStepMCIDevice
, "d");
104 dstruct(s
, cparms
, dwMCIStartTime
, "lu");
105 dstruct(s
, cparms
, dwMCIStopTime
, "lu");
106 dstruct(s
, cparms
, fStepCaptureAt2x
, "d");
107 dstruct(s
, cparms
, wStepCaptureAverageFrames
, "u");
108 dstruct(s
, cparms
, dwAudioBufferSize
, "lu");
109 dstruct(s
, cparms
, fDisableWriteCache
, "d");
110 dstruct(s
, cparms
, AVStreamMaster
, "u");
113 static void dump_videohdr(AVFormatContext
*s
, VIDEOHDR
*vhdr
)
116 av_log(s
, AV_LOG_DEBUG
, "VIDEOHDR\n");
117 dstruct(s
, vhdr
, lpData
, "p");
118 dstruct(s
, vhdr
, dwBufferLength
, "lu");
119 dstruct(s
, vhdr
, dwBytesUsed
, "lu");
120 dstruct(s
, vhdr
, dwTimeCaptured
, "lu");
121 dstruct(s
, vhdr
, dwUser
, "lu");
122 dstruct(s
, vhdr
, dwFlags
, "lu");
123 dstruct(s
, vhdr
, dwReserved
[0], "lu");
124 dstruct(s
, vhdr
, dwReserved
[1], "lu");
125 dstruct(s
, vhdr
, dwReserved
[2], "lu");
126 dstruct(s
, vhdr
, dwReserved
[3], "lu");
130 static void dump_bih(AVFormatContext
*s
, BITMAPINFOHEADER
*bih
)
132 av_log(s
, AV_LOG_DEBUG
, "BITMAPINFOHEADER\n");
133 dstruct(s
, bih
, biSize
, "lu");
134 dstruct(s
, bih
, biWidth
, "ld");
135 dstruct(s
, bih
, biHeight
, "ld");
136 dstruct(s
, bih
, biPlanes
, "d");
137 dstruct(s
, bih
, biBitCount
, "d");
138 dstruct(s
, bih
, biCompression
, "lu");
139 av_log(s
, AV_LOG_DEBUG
, " biCompression:\t\"%.4s\"\n",
140 (char*) &bih
->biCompression
);
141 dstruct(s
, bih
, biSizeImage
, "lu");
142 dstruct(s
, bih
, biXPelsPerMeter
, "lu");
143 dstruct(s
, bih
, biYPelsPerMeter
, "lu");
144 dstruct(s
, bih
, biClrUsed
, "lu");
145 dstruct(s
, bih
, biClrImportant
, "lu");
148 static int shall_we_drop(struct vfw_ctx
*ctx
)
150 AVFormatContext
*s
= ctx
->s
;
151 const uint8_t dropscore
[] = {62, 75, 87, 100};
152 const int ndropscores
= FF_ARRAY_ELEMS(dropscore
);
153 unsigned int buffer_fullness
= (ctx
->curbufsize
*100)/s
->max_picture_buffer
;
155 if(dropscore
[++ctx
->frame_num
%ndropscores
] <= buffer_fullness
) {
156 av_log(ctx
->s
, AV_LOG_ERROR
,
157 "real-time buffer %d%% full! frame dropped!\n", buffer_fullness
);
164 static LRESULT CALLBACK
videostream_cb(HWND hwnd
, LPVIDEOHDR vdhdr
)
167 AVPacketList
**ppktl
, *pktl_next
;
169 ctx
= (struct vfw_ctx
*) GetWindowLongPtr(hwnd
, GWLP_USERDATA
);
171 dump_videohdr(ctx
->s
, vdhdr
);
173 if(shall_we_drop(ctx
))
176 WaitForSingleObject(ctx
->mutex
, INFINITE
);
178 pktl_next
= av_mallocz(sizeof(AVPacketList
));
182 if(av_new_packet(&pktl_next
->pkt
, vdhdr
->dwBytesUsed
) < 0) {
187 pktl_next
->pkt
.pts
= vdhdr
->dwTimeCaptured
;
188 memcpy(pktl_next
->pkt
.data
, vdhdr
->lpData
, vdhdr
->dwBytesUsed
);
190 for(ppktl
= &ctx
->pktl
; *ppktl
; ppktl
= &(*ppktl
)->next
);
193 ctx
->curbufsize
+= vdhdr
->dwBytesUsed
;
195 SetEvent(ctx
->event
);
196 ReleaseMutex(ctx
->mutex
);
200 ReleaseMutex(ctx
->mutex
);
204 static int vfw_read_close(AVFormatContext
*s
)
206 struct vfw_ctx
*ctx
= s
->priv_data
;
209 SendMessage(ctx
->hwnd
, WM_CAP_SET_CALLBACK_VIDEOSTREAM
, 0, 0);
210 SendMessage(ctx
->hwnd
, WM_CAP_DRIVER_DISCONNECT
, 0, 0);
211 DestroyWindow(ctx
->hwnd
);
214 CloseHandle(ctx
->mutex
);
216 CloseHandle(ctx
->event
);
221 static int vfw_read_header(AVFormatContext
*s
, AVFormatParameters
*ap
)
223 struct vfw_ctx
*ctx
= s
->priv_data
;
224 AVCodecContext
*codec
;
236 if(!ap
->time_base
.den
) {
237 av_log(s
, AV_LOG_ERROR
, "A time base must be specified.\n");
243 ctx
->hwnd
= capCreateCaptureWindow(NULL
, 0, 0, 0, 0, 0, HWND_MESSAGE
, 0);
245 av_log(s
, AV_LOG_ERROR
, "Could not create capture window.\n");
249 /* If atoi fails, devnum==0 and the default device is used */
250 devnum
= atoi(s
->filename
);
252 ret
= SendMessage(ctx
->hwnd
, WM_CAP_DRIVER_CONNECT
, devnum
, 0);
254 av_log(s
, AV_LOG_ERROR
, "Could not connect to device.\n");
255 DestroyWindow(ctx
->hwnd
);
256 return AVERROR(ENODEV
);
259 SendMessage(ctx
->hwnd
, WM_CAP_SET_OVERLAY
, 0, 0);
260 SendMessage(ctx
->hwnd
, WM_CAP_SET_PREVIEW
, 0, 0);
262 ret
= SendMessage(ctx
->hwnd
, WM_CAP_SET_CALLBACK_VIDEOSTREAM
, 0,
263 (LPARAM
) videostream_cb
);
265 av_log(s
, AV_LOG_ERROR
, "Could not set video stream callback.\n");
269 SetWindowLongPtr(ctx
->hwnd
, GWLP_USERDATA
, (LONG_PTR
) ctx
);
271 st
= av_new_stream(s
, 0);
274 return AVERROR_NOMEM
;
277 /* Set video format */
278 bisize
= SendMessage(ctx
->hwnd
, WM_CAP_GET_VIDEOFORMAT
, 0, 0);
281 bi
= av_malloc(bisize
);
284 return AVERROR_NOMEM
;
286 ret
= SendMessage(ctx
->hwnd
, WM_CAP_GET_VIDEOFORMAT
, bisize
, (LPARAM
) bi
);
290 dump_bih(s
, &bi
->bmiHeader
);
292 width
= ap
->width
? ap
->width
: bi
->bmiHeader
.biWidth
;
293 height
= ap
->height
? ap
->height
: bi
->bmiHeader
.biHeight
;
294 bi
->bmiHeader
.biWidth
= width
;
295 bi
->bmiHeader
.biHeight
= height
;
298 /* For testing yet unsupported compressions
299 * Copy these values from user-supplied verbose information */
300 bi
->bmiHeader
.biWidth
= 320;
301 bi
->bmiHeader
.biHeight
= 240;
302 bi
->bmiHeader
.biPlanes
= 1;
303 bi
->bmiHeader
.biBitCount
= 12;
304 bi
->bmiHeader
.biCompression
= MKTAG('I','4','2','0');
305 bi
->bmiHeader
.biSizeImage
= 115200;
306 dump_bih(s
, &bi
->bmiHeader
);
309 ret
= SendMessage(ctx
->hwnd
, WM_CAP_SET_VIDEOFORMAT
, bisize
, (LPARAM
) bi
);
311 av_log(s
, AV_LOG_ERROR
, "Could not set Video Format.\n");
315 biCompression
= bi
->bmiHeader
.biCompression
;
316 biBitCount
= bi
->bmiHeader
.biBitCount
;
320 /* Set sequence setup */
321 ret
= SendMessage(ctx
->hwnd
, WM_CAP_GET_SEQUENCE_SETUP
, sizeof(cparms
),
326 dump_captureparms(s
, &cparms
);
328 cparms
.fYield
= 1; // Spawn a background thread
329 cparms
.dwRequestMicroSecPerFrame
=
330 (ap
->time_base
.num
*1000000) / ap
->time_base
.den
;
331 cparms
.fAbortLeftMouse
= 0;
332 cparms
.fAbortRightMouse
= 0;
333 cparms
.fCaptureAudio
= 0;
334 cparms
.vKeyAbort
= 0;
336 ret
= SendMessage(ctx
->hwnd
, WM_CAP_SET_SEQUENCE_SETUP
, sizeof(cparms
),
342 codec
->time_base
= ap
->time_base
;
343 codec
->codec_type
= CODEC_TYPE_VIDEO
;
344 codec
->width
= width
;
345 codec
->height
= height
;
346 codec
->pix_fmt
= vfw_pixfmt(biCompression
, biBitCount
);
347 if(codec
->pix_fmt
== PIX_FMT_NONE
) {
348 codec
->codec_id
= vfw_codecid(biCompression
);
349 if(codec
->codec_id
== CODEC_ID_NONE
) {
350 av_log(s
, AV_LOG_ERROR
, "Unknown compression type. "
351 "Please report verbose (-v 9) debug information.\n");
353 return AVERROR_PATCHWELCOME
;
355 codec
->bits_per_coded_sample
= biBitCount
;
357 codec
->codec_id
= CODEC_ID_RAWVIDEO
;
358 if(biCompression
== BI_RGB
)
359 codec
->bits_per_coded_sample
= biBitCount
;
362 av_set_pts_info(st
, 32, 1, 1000);
364 ctx
->mutex
= CreateMutex(NULL
, 0, NULL
);
366 av_log(s
, AV_LOG_ERROR
, "Could not create Mutex.\n" );
369 ctx
->event
= CreateEvent(NULL
, 1, 0, NULL
);
371 av_log(s
, AV_LOG_ERROR
, "Could not create Event.\n" );
375 ret
= SendMessage(ctx
->hwnd
, WM_CAP_SEQUENCE_NOFILE
, 0, 0);
377 av_log(s
, AV_LOG_ERROR
, "Could not start capture sequence.\n" );
391 static int vfw_read_packet(AVFormatContext
*s
, AVPacket
*pkt
)
393 struct vfw_ctx
*ctx
= s
->priv_data
;
394 AVPacketList
*pktl
= NULL
;
397 WaitForSingleObject(ctx
->mutex
, INFINITE
);
400 *pkt
= ctx
->pktl
->pkt
;
401 ctx
->pktl
= ctx
->pktl
->next
;
404 ResetEvent(ctx
->event
);
405 ReleaseMutex(ctx
->mutex
);
407 if(s
->flags
& AVFMT_FLAG_NONBLOCK
) {
408 return AVERROR(EAGAIN
);
410 WaitForSingleObject(ctx
->event
, INFINITE
);
415 ctx
->curbufsize
-= pkt
->size
;
420 AVInputFormat vfwcap_demuxer
= {
422 NULL_IF_CONFIG_SMALL("VFW video capture"),
423 sizeof(struct vfw_ctx
),
428 .flags
= AVFMT_NOFILE
,