FFmpeg  4.0
libdc1394.c
Go to the documentation of this file.
1 /*
2  * IIDC1394 grab interface (uses libdc1394 and libraw1394)
3  * Copyright (c) 2004 Roman Shaposhnik
4  * Copyright (c) 2008 Alessandro Sappia
5  *
6  * This file is part of FFmpeg.
7  *
8  * FFmpeg is free software; you can redistribute it and/or
9  * modify it under the terms of the GNU Lesser General Public
10  * License as published by the Free Software Foundation; either
11  * version 2.1 of the License, or (at your option) any later version.
12  *
13  * FFmpeg is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16  * Lesser General Public License for more details.
17  *
18  * You should have received a copy of the GNU Lesser General Public
19  * License along with FFmpeg; if not, write to the Free Software
20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21  */
22 
23 #include <dc1394/dc1394.h>
24 
25 #include "libavutil/imgutils.h"
26 #include "libavutil/internal.h"
27 #include "libavutil/log.h"
28 #include "libavutil/mathematics.h"
29 #include "libavutil/opt.h"
30 #include "libavutil/parseutils.h"
31 #include "libavutil/pixdesc.h"
32 
33 #include "libavformat/avformat.h"
34 #include "libavformat/internal.h"
35 
36 typedef struct dc1394_data {
37  AVClass *class;
38  dc1394_t *d;
39  dc1394camera_t *camera;
40  dc1394video_frame_t *frame;
42  int frame_rate; /**< frames per 1000 seconds (fps * 1000) */
43  char *video_size; /**< String describing video size, set by a private option. */
44  char *pixel_format; /**< Set by a private option. */
45  char *framerate; /**< Set by a private option. */
46 
47  int size;
49 } dc1394_data;
50 
51 static const struct dc1394_frame_format {
52  int width;
53  int height;
57  { 320, 240, AV_PIX_FMT_UYVY422, DC1394_VIDEO_MODE_320x240_YUV422 },
58  { 640, 480, AV_PIX_FMT_GRAY8, DC1394_VIDEO_MODE_640x480_MONO8 },
59  { 640, 480, AV_PIX_FMT_UYYVYY411, DC1394_VIDEO_MODE_640x480_YUV411 },
60  { 640, 480, AV_PIX_FMT_UYVY422, DC1394_VIDEO_MODE_640x480_YUV422 },
61  { 0, 0, 0, 0 } /* gotta be the last one */
62 };
63 
64 static const struct dc1394_frame_rate {
67 } dc1394_frame_rates[] = {
68  { 1875, DC1394_FRAMERATE_1_875 },
69  { 3750, DC1394_FRAMERATE_3_75 },
70  { 7500, DC1394_FRAMERATE_7_5 },
71  { 15000, DC1394_FRAMERATE_15 },
72  { 30000, DC1394_FRAMERATE_30 },
73  { 60000, DC1394_FRAMERATE_60 },
74  {120000, DC1394_FRAMERATE_120 },
75  {240000, DC1394_FRAMERATE_240 },
76  { 0, 0 } /* gotta be the last one */
77 };
78 
79 #define OFFSET(x) offsetof(dc1394_data, x)
80 #define DEC AV_OPT_FLAG_DECODING_PARAM
81 static const AVOption options[] = {
82  { "video_size", "A string describing frame size, such as 640x480 or hd720.", OFFSET(video_size), AV_OPT_TYPE_STRING, {.str = "qvga"}, 0, 0, DEC },
83  { "pixel_format", "", OFFSET(pixel_format), AV_OPT_TYPE_STRING, {.str = "uyvy422"}, 0, 0, DEC },
84  { "framerate", "", OFFSET(framerate), AV_OPT_TYPE_STRING, {.str = "ntsc"}, 0, 0, DEC },
85  { NULL },
86 };
87 
88 static const AVClass libdc1394_class = {
89  .class_name = "libdc1394 indev",
90  .item_name = av_default_item_name,
91  .option = options,
92  .version = LIBAVUTIL_VERSION_INT,
94 };
95 
96 
98  const struct dc1394_frame_format **select_fmt, const struct dc1394_frame_rate **select_fps)
99 {
100  dc1394_data* dc1394 = c->priv_data;
101  AVStream* vst;
102  const struct dc1394_frame_format *fmt;
103  const struct dc1394_frame_rate *fps;
104  enum AVPixelFormat pix_fmt;
105  int width, height;
107  int ret = 0;
108 
109  if ((pix_fmt = av_get_pix_fmt(dc1394->pixel_format)) == AV_PIX_FMT_NONE) {
110  av_log(c, AV_LOG_ERROR, "No such pixel format: %s.\n", dc1394->pixel_format);
111  ret = AVERROR(EINVAL);
112  goto out;
113  }
114 
115  if ((ret = av_parse_video_size(&width, &height, dc1394->video_size)) < 0) {
116  av_log(c, AV_LOG_ERROR, "Could not parse video size '%s'.\n", dc1394->video_size);
117  goto out;
118  }
119  if ((ret = av_parse_video_rate(&framerate, dc1394->framerate)) < 0) {
120  av_log(c, AV_LOG_ERROR, "Could not parse framerate '%s'.\n", dc1394->framerate);
121  goto out;
122  }
123  dc1394->frame_rate = av_rescale(1000, framerate.num, framerate.den);
124 
125  for (fmt = dc1394_frame_formats; fmt->width; fmt++)
126  if (fmt->pix_fmt == pix_fmt && fmt->width == width && fmt->height == height)
127  break;
128 
129  for (fps = dc1394_frame_rates; fps->frame_rate; fps++)
130  if (fps->frame_rate == dc1394->frame_rate)
131  break;
132 
133  if (!fps->frame_rate || !fmt->width) {
134  av_log(c, AV_LOG_ERROR, "Can't find matching camera format for %s, %dx%d@%d:1000fps\n", av_get_pix_fmt_name(pix_fmt),
135  width, height, dc1394->frame_rate);
136  ret = AVERROR(EINVAL);
137  goto out;
138  }
139 
140  /* create a video stream */
141  vst = avformat_new_stream(c, NULL);
142  if (!vst) {
143  ret = AVERROR(ENOMEM);
144  goto out;
145  }
146  avpriv_set_pts_info(vst, 64, 1, 1000);
149  vst->codecpar->width = fmt->width;
150  vst->codecpar->height = fmt->height;
151  vst->codecpar->format = fmt->pix_fmt;
152  vst->avg_frame_rate = framerate;
153 
154  dc1394->current_frame = 0;
155  dc1394->stream_index = vst->index;
156  dc1394->size = av_image_get_buffer_size(fmt->pix_fmt,
157  fmt->width, fmt->height, 1);
158 
159  vst->codecpar->bit_rate = av_rescale(dc1394->size * 8,
160  fps->frame_rate, 1000);
161  *select_fps = fps;
162  *select_fmt = fmt;
163 out:
164  return ret;
165 }
166 
168 {
169  dc1394_data* dc1394 = c->priv_data;
170  dc1394camera_list_t *list;
171  int res, i;
172  const struct dc1394_frame_format *fmt = NULL;
173  const struct dc1394_frame_rate *fps = NULL;
174 
175  if (dc1394_read_common(c, &fmt, &fps) != 0)
176  return -1;
177 
178  /* Now let us prep the hardware. */
179  dc1394->d = dc1394_new();
180  if (dc1394_camera_enumerate(dc1394->d, &list) != DC1394_SUCCESS || !list) {
181  av_log(c, AV_LOG_ERROR, "Unable to look for an IIDC camera.\n");
182  goto out;
183  }
184 
185  if (list->num == 0) {
186  av_log(c, AV_LOG_ERROR, "No cameras found.\n");
187  dc1394_camera_free_list(list);
188  goto out;
189  }
190 
191  /* FIXME: To select a specific camera I need to search in list its guid */
192  dc1394->camera = dc1394_camera_new (dc1394->d, list->ids[0].guid);
193 
194  if (!dc1394->camera) {
195  av_log(c, AV_LOG_ERROR, "Unable to open camera with guid 0x%"PRIx64"\n",
196  list->ids[0].guid);
197  dc1394_camera_free_list(list);
198  goto out;
199  }
200 
201  if (list->num > 1) {
202  av_log(c, AV_LOG_INFO, "Working with the first camera found\n");
203  }
204 
205  /* Freeing list of cameras */
206  dc1394_camera_free_list (list);
207 
208  /* Select MAX Speed possible from the cam */
209  if (dc1394->camera->bmode_capable>0) {
210  dc1394_video_set_operation_mode(dc1394->camera, DC1394_OPERATION_MODE_1394B);
211  i = DC1394_ISO_SPEED_800;
212  } else {
213  i = DC1394_ISO_SPEED_400;
214  }
215 
216  for (res = DC1394_FAILURE; i >= DC1394_ISO_SPEED_MIN && res != DC1394_SUCCESS; i--) {
217  res=dc1394_video_set_iso_speed(dc1394->camera, i);
218  }
219  if (res != DC1394_SUCCESS) {
220  av_log(c, AV_LOG_ERROR, "Couldn't set ISO Speed\n");
221  goto out_camera;
222  }
223 
224  if (dc1394_video_set_mode(dc1394->camera, fmt->frame_size_id) != DC1394_SUCCESS) {
225  av_log(c, AV_LOG_ERROR, "Couldn't set video format\n");
226  goto out_camera;
227  }
228 
229  if (dc1394_video_set_framerate(dc1394->camera,fps->frame_rate_id) != DC1394_SUCCESS) {
230  av_log(c, AV_LOG_ERROR, "Couldn't set framerate %d \n",fps->frame_rate);
231  goto out_camera;
232  }
233  if (dc1394_capture_setup(dc1394->camera, 10, DC1394_CAPTURE_FLAGS_DEFAULT)!=DC1394_SUCCESS) {
234  av_log(c, AV_LOG_ERROR, "Cannot setup camera \n");
235  goto out_camera;
236  }
237 
238  if (dc1394_video_set_transmission(dc1394->camera, DC1394_ON) !=DC1394_SUCCESS) {
239  av_log(c, AV_LOG_ERROR, "Cannot start capture\n");
240  goto out_camera;
241  }
242  return 0;
243 
244 out_camera:
245  dc1394_capture_stop(dc1394->camera);
246  dc1394_video_set_transmission(dc1394->camera, DC1394_OFF);
247  dc1394_camera_free (dc1394->camera);
248 out:
249  dc1394_free(dc1394->d);
250  return -1;
251 }
252 
254 {
255  struct dc1394_data *dc1394 = c->priv_data;
256  int res;
257 
258  /* discard stale frame */
259  if (dc1394->current_frame++) {
260  if (dc1394_capture_enqueue(dc1394->camera, dc1394->frame) != DC1394_SUCCESS)
261  av_log(c, AV_LOG_ERROR, "failed to release %d frame\n", dc1394->current_frame);
262  }
263 
264  res = dc1394_capture_dequeue(dc1394->camera, DC1394_CAPTURE_POLICY_WAIT, &dc1394->frame);
265  if (res == DC1394_SUCCESS) {
266  pkt->data = (uint8_t *)dc1394->frame->image;
267  pkt->size = dc1394->frame->image_bytes;
268  pkt->pts = dc1394->current_frame * 1000000 / dc1394->frame_rate;
269  pkt->flags |= AV_PKT_FLAG_KEY;
270  pkt->stream_index = dc1394->stream_index;
271  } else {
272  av_log(c, AV_LOG_ERROR, "DMA capture failed\n");
273  return AVERROR_INVALIDDATA;
274  }
275 
276  return pkt->size;
277 }
278 
279 static int dc1394_close(AVFormatContext * context)
280 {
281  struct dc1394_data *dc1394 = context->priv_data;
282 
283  dc1394_video_set_transmission(dc1394->camera, DC1394_OFF);
284  dc1394_capture_stop(dc1394->camera);
285  dc1394_camera_free(dc1394->camera);
286  dc1394_free(dc1394->d);
287 
288  return 0;
289 }
290 
292  .name = "libdc1394",
293  .long_name = NULL_IF_CONFIG_SMALL("dc1394 v.2 A/V grab"),
294  .priv_data_size = sizeof(struct dc1394_data),
295  .read_header = dc1394_read_header,
296  .read_packet = dc1394_read_packet,
297  .read_close = dc1394_close,
298  .flags = AVFMT_NOFILE,
299  .priv_class = &libdc1394_class,
300 };
packed YUV 4:2:2, 16bpp, Cb Y0 Cr Y1
Definition: pixfmt.h:77
#define NULL
Definition: coverity.c:32
static int dc1394_read_common(AVFormatContext *c, const struct dc1394_frame_format **select_fmt, const struct dc1394_frame_rate **select_fps)
Definition: libdc1394.c:97
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
Definition: error.h:59
static enum AVPixelFormat pix_fmt
int av_parse_video_rate(AVRational *rate, const char *arg)
Parse str and store the detected values in *rate.
Definition: parseutils.c:179
AVOption.
Definition: opt.h:246
int av_parse_video_size(int *width_ptr, int *height_ptr, const char *str)
Parse str and put in width_ptr and height_ptr the detected values.
Definition: parseutils.c:148
dc1394video_frame_t * frame
Definition: libdc1394.c:40
const char * fmt
Definition: avisynth_c.h:769
misc image utilities
#define LIBAVUTIL_VERSION_INT
Definition: version.h:85
void avpriv_set_pts_info(AVStream *s, int pts_wrap_bits, unsigned int pts_num, unsigned int pts_den)
Set the time base and wrapping info for a given stream.
Definition: utils.c:4811
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: avcodec.h:3884
AVInputFormat ff_libdc1394_demuxer
Definition: libdc1394.c:291
int num
Numerator.
Definition: rational.h:59
int index
stream index in AVFormatContext
Definition: avformat.h:874
static const struct dc1394_frame_format dc1394_frame_formats[]
int size
Definition: avcodec.h:1431
const char * av_default_item_name(void *ptr)
Return the context name.
Definition: log.c:191
static int dc1394_read_header(AVFormatContext *c)
Definition: libdc1394.c:167
static AVPacket pkt
Format I/O context.
Definition: avformat.h:1342
char * framerate
Set by a private option.
Definition: libdc1394.c:45
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
Definition: log.h:72
uint8_t
int width
Video only.
Definition: avcodec.h:3950
AVOptions.
AVStream * avformat_new_stream(AVFormatContext *s, const AVCodec *c)
Add a new stream to a media file.
Definition: utils.c:4441
dc1394_t * d
Definition: libdc1394.c:38
#define height
uint8_t * data
Definition: avcodec.h:1430
#define av_log(a,...)
int64_t bit_rate
The average bitrate of the encoded data (in bits per second).
Definition: avcodec.h:3913
#define AV_PKT_FLAG_KEY
The packet contains a keyframe.
Definition: avcodec.h:1462
int av_image_get_buffer_size(enum AVPixelFormat pix_fmt, int width, int height, int align)
Return the size in bytes of the amount of data required to store an image with the given parameters...
Definition: imgutils.c:431
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
Definition: log.h:176
#define AVERROR(e)
Definition: error.h:43
#define NULL_IF_CONFIG_SMALL(x)
Return NULL if CONFIG_SMALL is true, otherwise the argument without modification. ...
Definition: internal.h:186
static const struct dc1394_frame_rate dc1394_frame_rates[]
int stream_index
Definition: libdc1394.c:48
enum AVMediaType codec_type
General type of the encoded data.
Definition: avcodec.h:3880
uint16_t width
Definition: gdv.c:47
AVRational avg_frame_rate
Average framerate.
Definition: avformat.h:946
int flags
A combination of AV_PKT_FLAG values.
Definition: avcodec.h:1436
common internal API header
int64_t av_rescale(int64_t a, int64_t b, int64_t c)
Rescale a 64-bit integer with rounding to nearest.
Definition: mathematics.c:129
#define OFFSET(x)
Definition: libdc1394.c:79
enum AVPixelFormat pix_fmt
Definition: libdc1394.c:54
Stream structure.
Definition: avformat.h:873
char * pixel_format
Set by a private option.
Definition: libdc1394.c:44
#define AV_LOG_INFO
Standard information.
Definition: log.h:187
static const AVOption options[]
Definition: libdc1394.c:81
static const AVClass libdc1394_class
Definition: libdc1394.c:88
Describe the class of an AVClass context structure.
Definition: log.h:67
Rational number (pair of numerator and denominator).
Definition: rational.h:58
misc parsing utilities
Main libavformat public API header.
int frame_rate
frames per 1000 seconds (fps * 1000)
Definition: libdc1394.c:42
Y , 8bpp.
Definition: pixfmt.h:70
#define AVFMT_NOFILE
Demuxer will use avio_open, no opened file should be provided by the caller.
Definition: avformat.h:465
char * video_size
String describing video size, set by a private option.
Definition: libdc1394.c:43
static double c[64]
int den
Denominator.
Definition: rational.h:60
dc1394camera_t * camera
Definition: libdc1394.c:39
static int dc1394_read_packet(AVFormatContext *c, AVPacket *pkt)
Definition: libdc1394.c:253
void * priv_data
Format private data.
Definition: avformat.h:1370
#define DEC
Definition: libdc1394.c:80
FILE * out
Definition: movenc.c:54
const char * name
A comma separated list of short names for the format.
Definition: avformat.h:647
AVCodecParameters * codecpar
Codec parameters associated with this stream.
Definition: avformat.h:1020
enum AVPixelFormat av_get_pix_fmt(const char *name)
Return the pixel format corresponding to name.
Definition: pixdesc.c:2291
const char * av_get_pix_fmt_name(enum AVPixelFormat pix_fmt)
Return the short name for a pixel format, NULL in case pix_fmt is unknown.
Definition: pixdesc.c:2279
int stream_index
Definition: avcodec.h:1432
packed YUV 4:1:1, 12bpp, Cb Y0 Y1 Cr Y2 Y3
Definition: pixfmt.h:78
AVPixelFormat
Pixel format.
Definition: pixfmt.h:60
This structure stores compressed data.
Definition: avcodec.h:1407
int64_t pts
Presentation timestamp in AVStream->time_base units; the time at which the decompressed packet will b...
Definition: avcodec.h:1423
int current_frame
Definition: libdc1394.c:41
static int dc1394_close(AVFormatContext *context)
Definition: libdc1394.c:279