sys/v4l2/gstv4l2bufferpool.c

   1 /* GStreamer
   2  *
   3  * Copyright (C) 2001-2002 Ronald Bultje <rbultje@ronald.bitfreak.net>
   4  *               2006 Edgard Lima <edgard.lima@gmail.com>
   5  *               2009 Texas Instruments, Inc - http://www.ti.com/
   6  *
   7  * gstv4l2bufferpool.c V4L2 buffer pool class
   8  *
   9  * This library is free software; you can redistribute it and/or
  10  * modify it under the terms of the GNU Library General Public
  11  * License as published by the Free Software Foundation; either
  12  * version 2 of the License, or (at your option) any later version.
  13  *
  14  * This library is distributed in the hope that it will be useful,
  15  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17  * Library General Public License for more details.
  18  *
  19  * You should have received a copy of the GNU Library General Public
  20  * License along with this library; if not, write to the
  21  * Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
  22  * Boston, MA 02110-1301, USA.
  23  */
  24
  25 #ifdef HAVE_CONFIG_H
  26 #  include <config.h>
  27 #endif
  28
  29 #ifndef _GNU_SOURCE
  30 # define _GNU_SOURCE            /* O_CLOEXEC */
  31 #endif
  32 #include <fcntl.h>
  33
  34 #include <sys/mman.h>
  35 #include <string.h>
  36 #include <unistd.h>
  37
  38 #include "gst/video/video.h"
  39 #include "gst/video/gstvideometa.h"
  40 #include "gst/video/gstvideopool.h"
  41 #include "gst/allocators/gstdmabuf.h"
  42
  43 #include <gstv4l2bufferpool.h>
  44
  45 #include "gstv4l2object.h"
  46 #include "gst/gst-i18n-plugin.h"
  47 #include <gst/glib-compat-private.h>
  48
  49 GST_DEBUG_CATEGORY_STATIC (v4l2bufferpool_debug);
  50 GST_DEBUG_CATEGORY_STATIC (CAT_PERFORMANCE);
  51 #define GST_CAT_DEFAULT v4l2bufferpool_debug
  52
  53 #define GST_V4L2_IMPORT_QUARK gst_v4l2_buffer_pool_import_quark ()
  54
  55
  56 /*
  57  * GstV4l2BufferPool:
  58  */
  59 #define gst_v4l2_buffer_pool_parent_class parent_class
  60 G_DEFINE_TYPE (GstV4l2BufferPool, gst_v4l2_buffer_pool, GST_TYPE_BUFFER_POOL);
  61
  62 enum _GstV4l2BufferPoolAcquireFlags
  63 {
  64   GST_V4L2_BUFFER_POOL_ACQUIRE_FLAG_RESURRECT =
  65       GST_BUFFER_POOL_ACQUIRE_FLAG_LAST,
  66   GST_V4L2_BUFFER_POOL_ACQUIRE_FLAG_LAST
  67 };
  68
  69 static void gst_v4l2_buffer_pool_release_buffer (GstBufferPool * bpool,
  70     GstBuffer * buffer);
  71
  72 static gboolean
  73 gst_v4l2_is_buffer_valid (GstBuffer * buffer, GstV4l2MemoryGroup ** out_group)
  74 {
  75   GstMemory *mem = gst_buffer_peek_memory (buffer, 0);
  76   gboolean valid = FALSE;
  77
  78   if (GST_BUFFER_FLAG_IS_SET (buffer, GST_BUFFER_FLAG_TAG_MEMORY))
  79     goto done;
  80
  81   if (gst_is_dmabuf_memory (mem))
  82     mem = gst_mini_object_get_qdata (GST_MINI_OBJECT (mem),
  83         GST_V4L2_MEMORY_QUARK);
  84
  85   if (mem && gst_is_v4l2_memory (mem)) {
  86     GstV4l2Memory *vmem = (GstV4l2Memory *) mem;
  87     GstV4l2MemoryGroup *group = vmem->group;
  88     gint i;
  89
  90     if (group->n_mem != gst_buffer_n_memory (buffer))
  91       goto done;
  92
  93     for (i = 0; i < group->n_mem; i++) {
  94       if (group->mem[i] != gst_buffer_peek_memory (buffer, i))
  95         goto done;
  96
  97       if (!gst_memory_is_writable (group->mem[i]))
  98         goto done;
  99     }
 100
 101     valid = TRUE;
 102     if (out_group)
 103       *out_group = group;
 104   }
 105
 106 done:
 107   return valid;
 108 }
 109
 110 static GstFlowReturn
 111 gst_v4l2_buffer_pool_copy_buffer (GstV4l2BufferPool * pool, GstBuffer * dest,
 112     GstBuffer * src)
 113 {
 114   const GstVideoFormatInfo *finfo = pool->caps_info.finfo;
 115
 116   GST_LOG_OBJECT (pool, "copying buffer");
 117
 118   if (finfo && (finfo->format != GST_VIDEO_FORMAT_UNKNOWN &&
 119           finfo->format != GST_VIDEO_FORMAT_ENCODED)) {
 120     GstVideoFrame src_frame, dest_frame;
 121
 122     GST_DEBUG_OBJECT (pool, "copy video frame");
 123
 124     /* we have raw video, use videoframe copy to get strides right */
 125     if (!gst_video_frame_map (&src_frame, &pool->caps_info, src, GST_MAP_READ))
 126       goto invalid_buffer;
 127
 128     if (!gst_video_frame_map (&dest_frame, &pool->caps_info, dest,
 129             GST_MAP_WRITE)) {
 130       gst_video_frame_unmap (&src_frame);
 131       goto invalid_buffer;
 132     }
 133
 134     gst_video_frame_copy (&dest_frame, &src_frame);
 135
 136     gst_video_frame_unmap (&src_frame);
 137     gst_video_frame_unmap (&dest_frame);
 138   } else {
 139     GstMapInfo map;
 140
 141     GST_DEBUG_OBJECT (pool, "copy raw bytes");
 142
 143     if (!gst_buffer_map (src, &map, GST_MAP_READ))
 144       goto invalid_buffer;
 145
 146     gst_buffer_fill (dest, 0, map.data, gst_buffer_get_size (src));
 147
 148     gst_buffer_unmap (src, &map);
 149     gst_buffer_resize (dest, 0, gst_buffer_get_size (src));
 150   }
 151
 152   gst_buffer_copy_into (dest, src,
 153       GST_BUFFER_COPY_FLAGS | GST_BUFFER_COPY_TIMESTAMPS, 0, -1);
 154
 155   GST_CAT_LOG_OBJECT (CAT_PERFORMANCE, pool, "slow copy into buffer %p", dest);
 156
 157   return GST_FLOW_OK;
 158
 159 invalid_buffer:
 160   {
 161     GST_ERROR_OBJECT (pool, "could not map buffer");
 162     return GST_FLOW_ERROR;
 163   }
 164 }
 165
 166 struct UserPtrData
 167 {
 168   GstBuffer *buffer;
 169   gboolean is_frame;
 170   GstVideoFrame frame;
 171   GstMapInfo map;
 172 };
 173
 174 static GQuark
 175 gst_v4l2_buffer_pool_import_quark (void)
 176 {
 177   static GQuark quark = 0;
 178
 179   if (quark == 0)
 180     quark = g_quark_from_string ("GstV4l2BufferPoolUsePtrData");
 181
 182   return quark;
 183 }
 184
 185 static void
 186 _unmap_userptr_frame (struct UserPtrData *data)
 187 {
 188   if (data->is_frame)
 189     gst_video_frame_unmap (&data->frame);
 190   else
 191     gst_buffer_unmap (data->buffer, &data->map);
 192
 193   if (data->buffer)
 194     gst_buffer_unref (data->buffer);
 195
 196   g_slice_free (struct UserPtrData, data);
 197 }
 198
 199 static GstFlowReturn
 200 gst_v4l2_buffer_pool_import_userptr (GstV4l2BufferPool * pool,
 201     GstBuffer * dest, GstBuffer * src)
 202 {
 203   GstFlowReturn ret = GST_FLOW_OK;
 204   GstV4l2MemoryGroup *group = NULL;
 205   GstMapFlags flags;
 206   const GstVideoFormatInfo *finfo = pool->caps_info.finfo;
 207   struct UserPtrData *data = NULL;
 208
 209   GST_LOG_OBJECT (pool, "importing userptr");
 210
 211   /* get the group */
 212   if (!gst_v4l2_is_buffer_valid (dest, &group))
 213     goto not_our_buffer;
 214
 215   if (V4L2_TYPE_IS_OUTPUT (pool->obj->type))
 216     flags = GST_MAP_READ;
 217   else
 218     flags = GST_MAP_WRITE;
 219
 220   data = g_slice_new0 (struct UserPtrData);
 221
 222   if (finfo && (finfo->format != GST_VIDEO_FORMAT_UNKNOWN &&
 223           finfo->format != GST_VIDEO_FORMAT_ENCODED)) {
 224     gsize size[GST_VIDEO_MAX_PLANES] = { 0, };
 225     gint i;
 226
 227     data->is_frame = TRUE;
 228
 229     if (!gst_video_frame_map (&data->frame, &pool->caps_info, src, flags))
 230       goto invalid_buffer;
 231
 232     for (i = 0; i < GST_VIDEO_FORMAT_INFO_N_PLANES (finfo); i++) {
 233       if (GST_VIDEO_FORMAT_INFO_IS_TILED (finfo)) {
 234         gint tinfo = GST_VIDEO_FRAME_PLANE_STRIDE (&data->frame, i);
 235         gint pstride;
 236         guint pheight;
 237
 238         pstride = GST_VIDEO_TILE_X_TILES (tinfo) <<
 239             GST_VIDEO_FORMAT_INFO_TILE_WS (finfo);
 240
 241         pheight = GST_VIDEO_TILE_Y_TILES (tinfo) <<
 242             GST_VIDEO_FORMAT_INFO_TILE_HS (finfo);
 243
 244         size[i] = pstride * pheight;
 245       } else {
 246         size[i] = GST_VIDEO_FRAME_PLANE_STRIDE (&data->frame, i) *
 247             GST_VIDEO_FRAME_COMP_HEIGHT (&data->frame, i);
 248       }
 249     }
 250
 251     /* In the single planar API, planes must be contiguous in memory and
 252      * therefore they must have expected size. ie: no padding.
 253      * To check these conditions, we check that plane 'i' start address
 254      * + plane 'i' size equals to plane 'i+1' start address */
 255     if (!V4L2_TYPE_IS_MULTIPLANAR (pool->obj->type)) {
 256       for (i = 0; i < (GST_VIDEO_FORMAT_INFO_N_PLANES (finfo) - 1); i++) {
 257         const struct v4l2_pix_format *pix_fmt = &pool->obj->format.fmt.pix;
 258         gpointer tmp;
 259         gint estride = gst_v4l2_object_extrapolate_stride (finfo, i,
 260             pix_fmt->bytesperline);
 261         guint eheight = GST_VIDEO_FORMAT_INFO_SCALE_HEIGHT (finfo, i,
 262             pix_fmt->height);
 263
 264         tmp = ((guint8 *) data->frame.data[i]) + estride * eheight;
 265         if (tmp != data->frame.data[i + 1])
 266           goto non_contiguous_mem;
 267       }
 268     }
 269
 270     if (!gst_v4l2_allocator_import_userptr (pool->vallocator, group,
 271             data->frame.info.size, finfo->n_planes, data->frame.data, size))
 272       goto import_failed;
 273   } else {
 274     gpointer ptr[1];
 275     gsize size[1];
 276
 277     data->is_frame = FALSE;
 278
 279     if (!gst_buffer_map (src, &data->map, flags))
 280       goto invalid_buffer;
 281
 282     ptr[0] = data->map.data;
 283     size[0] = data->map.size;
 284
 285     if (!gst_v4l2_allocator_import_userptr (pool->vallocator, group,
 286             data->map.size, 1, ptr, size))
 287       goto import_failed;
 288   }
 289
 290   data->buffer = gst_buffer_ref (src);
 291
 292   gst_mini_object_set_qdata (GST_MINI_OBJECT (dest), GST_V4L2_IMPORT_QUARK,
 293       data, (GDestroyNotify) _unmap_userptr_frame);
 294
 295   gst_buffer_copy_into (dest, src,
 296       GST_BUFFER_COPY_FLAGS | GST_BUFFER_COPY_TIMESTAMPS, 0, -1);
 297
 298   return ret;
 299
 300 not_our_buffer:
 301   {
 302     GST_ERROR_OBJECT (pool, "destination buffer invalid or not from our pool");
 303     return GST_FLOW_ERROR;
 304   }
 305 invalid_buffer:
 306   {
 307     GST_ERROR_OBJECT (pool, "could not map buffer");
 308     g_slice_free (struct UserPtrData, data);
 309     return GST_FLOW_ERROR;
 310   }
 311 non_contiguous_mem:
 312   {
 313     GST_ERROR_OBJECT (pool, "memory is not contiguous or plane size mismatch");
 314     _unmap_userptr_frame (data);
 315     return GST_FLOW_ERROR;
 316   }
 317 import_failed:
 318   {
 319     GST_ERROR_OBJECT (pool, "failed to import data");
 320     _unmap_userptr_frame (data);
 321     return GST_FLOW_ERROR;
 322   }
 323 }
 324
 325 static GstFlowReturn
 326 gst_v4l2_buffer_pool_import_dmabuf (GstV4l2BufferPool * pool,
 327     GstBuffer * dest, GstBuffer * src)
 328 {
 329   GstV4l2MemoryGroup *group = NULL;
 330   GstMemory *dma_mem[GST_VIDEO_MAX_PLANES] = { 0 };
 331   guint n_mem = gst_buffer_n_memory (src);
 332   gint i;
 333
 334   GST_LOG_OBJECT (pool, "importing dmabuf");
 335
 336   if (!gst_v4l2_is_buffer_valid (dest, &group))
 337     goto not_our_buffer;
 338
 339   if (n_mem > GST_VIDEO_MAX_PLANES)
 340     goto too_many_mems;
 341
 342   for (i = 0; i < n_mem; i++)
 343     dma_mem[i] = gst_buffer_peek_memory (src, i);
 344
 345   if (!gst_v4l2_allocator_import_dmabuf (pool->vallocator, group, n_mem,
 346           dma_mem))
 347     goto import_failed;
 348
 349   gst_mini_object_set_qdata (GST_MINI_OBJECT (dest), GST_V4L2_IMPORT_QUARK,
 350       gst_buffer_ref (src), (GDestroyNotify) gst_buffer_unref);
 351
 352   gst_buffer_copy_into (dest, src,
 353       GST_BUFFER_COPY_FLAGS | GST_BUFFER_COPY_TIMESTAMPS, 0, -1);
 354
 355   return GST_FLOW_OK;
 356
 357 not_our_buffer:
 358   {
 359     GST_ERROR_OBJECT (pool, "destination buffer invalid or not from our pool");
 360     return GST_FLOW_ERROR;
 361   }
 362 too_many_mems:
 363   {
 364     GST_ERROR_OBJECT (pool, "could not map buffer");
 365     return GST_FLOW_ERROR;
 366   }
 367 import_failed:
 368   {
 369     GST_ERROR_OBJECT (pool, "failed to import dmabuf");
 370     return GST_FLOW_ERROR;
 371   }
 372 }
 373
 374 static GstFlowReturn
 375 gst_v4l2_buffer_pool_prepare_buffer (GstV4l2BufferPool * pool,
 376     GstBuffer * dest, GstBuffer * src)
 377 {
 378   GstFlowReturn ret = GST_FLOW_OK;
 379   gboolean own_src = FALSE;
 380
 381   if (src == NULL) {
 382     if (pool->other_pool == NULL) {
 383       GST_ERROR_OBJECT (pool, "can't prepare buffer, source buffer missing");
 384       return GST_FLOW_ERROR;
 385     }
 386
 387     ret = gst_buffer_pool_acquire_buffer (pool->other_pool, &src, NULL);
 388     if (ret != GST_FLOW_OK) {
 389       GST_ERROR_OBJECT (pool, "failed to acquire buffer from downstream pool");
 390       goto done;
 391     }
 392
 393     own_src = TRUE;
 394   }
 395
 396   switch (pool->obj->mode) {
 397     case GST_V4L2_IO_MMAP:
 398     case GST_V4L2_IO_DMABUF:
 399       ret = gst_v4l2_buffer_pool_copy_buffer (pool, dest, src);
 400       break;
 401     case GST_V4L2_IO_USERPTR:
 402       ret = gst_v4l2_buffer_pool_import_userptr (pool, dest, src);
 403       break;
 404     case GST_V4L2_IO_DMABUF_IMPORT:
 405       ret = gst_v4l2_buffer_pool_import_dmabuf (pool, dest, src);
 406       break;
 407     default:
 408       break;
 409   }
 410
 411   if (own_src)
 412     gst_buffer_unref (src);
 413
 414 done:
 415   return ret;
 416 }
 417
 418 static GstFlowReturn
 419 gst_v4l2_buffer_pool_alloc_buffer (GstBufferPool * bpool, GstBuffer ** buffer,
 420     GstBufferPoolAcquireParams * params)
 421 {
 422   GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
 423   GstV4l2MemoryGroup *group = NULL;
 424   GstBuffer *newbuf = NULL;
 425   GstV4l2Object *obj;
 426   GstVideoInfo *info;
 427
 428   obj = pool->obj;
 429   info = &obj->info;
 430
 431   switch (obj->mode) {
 432     case GST_V4L2_IO_RW:
 433       newbuf =
 434           gst_buffer_new_allocate (pool->allocator, pool->size, &pool->params);
 435       break;
 436     case GST_V4L2_IO_MMAP:
 437       group = gst_v4l2_allocator_alloc_mmap (pool->vallocator);
 438       break;
 439     case GST_V4L2_IO_DMABUF:
 440       group = gst_v4l2_allocator_alloc_dmabuf (pool->vallocator,
 441           pool->allocator);
 442       break;
 443     case GST_V4L2_IO_USERPTR:
 444       group = gst_v4l2_allocator_alloc_userptr (pool->vallocator);
 445       break;
 446     case GST_V4L2_IO_DMABUF_IMPORT:
 447       group = gst_v4l2_allocator_alloc_dmabufin (pool->vallocator);
 448       break;
 449     default:
 450       newbuf = NULL;
 451       g_assert_not_reached ();
 452       break;
 453   }
 454
 455   if (group != NULL) {
 456     gint i;
 457     newbuf = gst_buffer_new ();
 458
 459     for (i = 0; i < group->n_mem; i++)
 460       gst_buffer_append_memory (newbuf, group->mem[i]);
 461   } else if (newbuf == NULL) {
 462     goto allocation_failed;
 463   }
 464
 465   /* add metadata to raw video buffers */
 466   if (pool->add_videometa)
 467     gst_buffer_add_video_meta_full (newbuf, GST_VIDEO_FRAME_FLAG_NONE,
 468         GST_VIDEO_INFO_FORMAT (info), GST_VIDEO_INFO_WIDTH (info),
 469         GST_VIDEO_INFO_HEIGHT (info), GST_VIDEO_INFO_N_PLANES (info),
 470         info->offset, info->stride);
 471
 472   *buffer = newbuf;
 473
 474   return GST_FLOW_OK;
 475
 476   /* ERRORS */
 477 allocation_failed:
 478   {
 479     GST_ERROR_OBJECT (pool, "failed to allocate buffer");
 480     return GST_FLOW_ERROR;
 481   }
 482 }
 483
 484 static gboolean
 485 gst_v4l2_buffer_pool_set_config (GstBufferPool * bpool, GstStructure * config)
 486 {
 487   GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
 488   GstV4l2Object *obj = pool->obj;
 489   GstCaps *caps;
 490   guint size, min_buffers, max_buffers;
 491   GstAllocator *allocator;
 492   GstAllocationParams params;
 493   gboolean can_allocate = FALSE;
 494   gboolean updated = FALSE;
 495   gboolean ret;
 496
 497   pool->add_videometa =
 498       gst_buffer_pool_config_has_option (config,
 499       GST_BUFFER_POOL_OPTION_VIDEO_META);
 500
 501   /* parse the config and keep around */
 502   if (!gst_buffer_pool_config_get_params (config, &caps, &size, &min_buffers,
 503           &max_buffers))
 504     goto wrong_config;
 505
 506   if (!gst_buffer_pool_config_get_allocator (config, &allocator, &params))
 507     goto wrong_config;
 508
 509   GST_DEBUG_OBJECT (pool, "config %" GST_PTR_FORMAT, config);
 510
 511   if (pool->allocator)
 512     gst_object_unref (pool->allocator);
 513   pool->allocator = NULL;
 514
 515   switch (obj->mode) {
 516     case GST_V4L2_IO_DMABUF:
 517       pool->allocator = gst_dmabuf_allocator_new ();
 518       can_allocate = GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, MMAP);
 519       break;
 520     case GST_V4L2_IO_MMAP:
 521       can_allocate = GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, MMAP);
 522       break;
 523     case GST_V4L2_IO_USERPTR:
 524       can_allocate =
 525           GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, USERPTR);
 526       break;
 527     case GST_V4L2_IO_DMABUF_IMPORT:
 528       can_allocate = GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, DMABUF);
 529       break;
 530     case GST_V4L2_IO_RW:
 531       if (allocator)
 532         pool->allocator = g_object_ref (allocator);
 533       pool->params = params;
 534       /* No need to change the configuration */
 535       goto done;
 536       break;
 537     default:
 538       g_assert_not_reached ();
 539       break;
 540   }
 541
 542   /* libv4l2 conversion code does not handle CREATE_BUFS, and may lead to
 543    * instability and crash, disable it for now */
 544   if (can_allocate && obj->fmtdesc->flags & V4L2_FMT_FLAG_EMULATED) {
 545     GST_WARNING_OBJECT (pool,
 546         "libv4l2 converter detected, disabling CREATE_BUFS");
 547     can_allocate = FALSE;
 548     GST_OBJECT_FLAG_UNSET (pool->vallocator,
 549         GST_V4L2_ALLOCATOR_FLAG_MMAP_CREATE_BUFS
 550         | GST_V4L2_ALLOCATOR_FLAG_USERPTR_CREATE_BUFS
 551         | GST_V4L2_ALLOCATOR_FLAG_DMABUF_CREATE_BUFS);
 552   }
 553
 554   if (min_buffers < GST_V4L2_MIN_BUFFERS) {
 555     updated = TRUE;
 556     min_buffers = GST_V4L2_MIN_BUFFERS;
 557     GST_INFO_OBJECT (pool, "increasing minimum buffers to %u", min_buffers);
 558   }
 559
 560   /* respect driver requirements */
 561   if (min_buffers < obj->min_buffers) {
 562     updated = TRUE;
 563     min_buffers = obj->min_buffers;
 564     GST_INFO_OBJECT (pool, "increasing minimum buffers to %u", min_buffers);
 565   }
 566
 567   if (max_buffers > VIDEO_MAX_FRAME || max_buffers == 0) {
 568     updated = TRUE;
 569     max_buffers = VIDEO_MAX_FRAME;
 570     GST_INFO_OBJECT (pool, "reducing maximum buffers to %u", max_buffers);
 571   }
 572
 573   if (min_buffers > max_buffers) {
 574     updated = TRUE;
 575     min_buffers = max_buffers;
 576     GST_INFO_OBJECT (pool, "reducing minimum buffers to %u", min_buffers);
 577   } else if (min_buffers != max_buffers) {
 578     if (!can_allocate) {
 579       updated = TRUE;
 580       max_buffers = min_buffers;
 581       GST_INFO_OBJECT (pool, "can't allocate, setting maximum to minimum");
 582     }
 583   }
 584
 585   if (!pool->add_videometa && obj->need_video_meta) {
 586     GST_INFO_OBJECT (pool, "adding needed video meta");
 587     updated = TRUE;
 588     gst_buffer_pool_config_add_option (config,
 589         GST_BUFFER_POOL_OPTION_VIDEO_META);
 590   }
 591
 592   /* Always update the config to ensure the configured size matches */
 593   gst_buffer_pool_config_set_params (config, caps, obj->info.size, min_buffers,
 594       max_buffers);
 595
 596   /* keep a GstVideoInfo with defaults for the when we need to copy */
 597   gst_video_info_from_caps (&pool->caps_info, caps);
 598
 599 done:
 600   ret = GST_BUFFER_POOL_CLASS (parent_class)->set_config (bpool, config);
 601
 602   /* If anything was changed documentation recommand to return FALSE */
 603   return !updated && ret;
 604
 605   /* ERRORS */
 606 wrong_config:
 607   {
 608     GST_ERROR_OBJECT (pool, "invalid config %" GST_PTR_FORMAT, config);
 609     return FALSE;
 610   }
 611 }
 612
 613 static GstFlowReturn
 614 gst_v4l2_buffer_pool_resurrect_buffer (GstV4l2BufferPool * pool)
 615 {
 616   GstBufferPoolAcquireParams params = { 0 };
 617   GstBuffer *buffer = NULL;
 618   GstFlowReturn ret;
 619
 620   GST_DEBUG_OBJECT (pool, "A buffer was lost, reallocating it");
 621
 622   /* block recursive calls to this function */
 623   g_signal_handler_block (pool->vallocator, pool->group_released_handler);
 624
 625   params.flags =
 626       (GstBufferPoolAcquireFlags) GST_V4L2_BUFFER_POOL_ACQUIRE_FLAG_RESURRECT |
 627       GST_BUFFER_POOL_ACQUIRE_FLAG_DONTWAIT;
 628   ret =
 629       gst_buffer_pool_acquire_buffer (GST_BUFFER_POOL (pool), &buffer, &params);
 630
 631   if (ret == GST_FLOW_OK)
 632     gst_buffer_unref (buffer);
 633
 634   g_signal_handler_unblock (pool->vallocator, pool->group_released_handler);
 635
 636   return ret;
 637 }
 638
 639 static gboolean
 640 gst_v4l2_buffer_pool_streamon (GstV4l2BufferPool * pool)
 641 {
 642   GstV4l2Object *obj = pool->obj;
 643
 644   if (pool->streaming)
 645     return TRUE;
 646
 647   switch (obj->mode) {
 648     case GST_V4L2_IO_MMAP:
 649     case GST_V4L2_IO_USERPTR:
 650     case GST_V4L2_IO_DMABUF:
 651     case GST_V4L2_IO_DMABUF_IMPORT:
 652       if (!V4L2_TYPE_IS_OUTPUT (pool->obj->type)) {
 653         /* For captures, we need to enqueue buffers before we start streaming,
 654          * so the driver don't underflow immediatly. As we have put then back
 655          * into the base class queue, resurrect them, then releasing will queue
 656          * them back. */
 657         while (gst_v4l2_buffer_pool_resurrect_buffer (pool) == GST_FLOW_OK)
 658           continue;
 659       }
 660
 661       if (obj->ioctl (pool->video_fd, VIDIOC_STREAMON, &obj->type) < 0)
 662         goto streamon_failed;
 663
 664       pool->streaming = TRUE;
 665
 666       GST_DEBUG_OBJECT (pool, "Started streaming");
 667       break;
 668     default:
 669       break;
 670   }
 671
 672   return TRUE;
 673
 674 streamon_failed:
 675   {
 676     GST_ERROR_OBJECT (pool, "error with STREAMON %d (%s)", errno,
 677         g_strerror (errno));
 678     return FALSE;
 679   }
 680 }
 681
 682 /* Call with streamlock held, or when streaming threads are down */
 683 static void
 684 gst_v4l2_buffer_pool_streamoff (GstV4l2BufferPool * pool)
 685 {
 686   GstBufferPoolClass *pclass = GST_BUFFER_POOL_CLASS (parent_class);
 687   GstV4l2Object *obj = pool->obj;
 688   gint i;
 689
 690   if (!pool->streaming)
 691     return;
 692
 693   switch (obj->mode) {
 694     case GST_V4L2_IO_MMAP:
 695     case GST_V4L2_IO_USERPTR:
 696     case GST_V4L2_IO_DMABUF:
 697     case GST_V4L2_IO_DMABUF_IMPORT:
 698
 699       if (obj->ioctl (pool->video_fd, VIDIOC_STREAMOFF, &obj->type) < 0)
 700         GST_WARNING_OBJECT (pool, "STREAMOFF failed with errno %d (%s)",
 701             errno, g_strerror (errno));
 702
 703       pool->streaming = FALSE;
 704
 705       GST_DEBUG_OBJECT (pool, "Stopped streaming");
 706
 707       if (pool->vallocator)
 708         gst_v4l2_allocator_flush (pool->vallocator);
 709       break;
 710     default:
 711       break;
 712   }
 713
 714   for (i = 0; i < VIDEO_MAX_FRAME; i++) {
 715     if (pool->buffers[i]) {
 716       GstBuffer *buffer = pool->buffers[i];
 717       GstBufferPool *bpool = GST_BUFFER_POOL (pool);
 718
 719       pool->buffers[i] = NULL;
 720
 721       if (V4L2_TYPE_IS_OUTPUT (pool->obj->type))
 722         gst_v4l2_buffer_pool_release_buffer (bpool, buffer);
 723       else                      /* Don't re-enqueue capture buffer on stop */
 724         pclass->release_buffer (bpool, buffer);
 725
 726       g_atomic_int_add (&pool->num_queued, -1);
 727     }
 728   }
 729 }
 730
 731 static gboolean
 732 gst_v4l2_buffer_pool_start (GstBufferPool * bpool)
 733 {
 734   GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
 735   GstBufferPoolClass *pclass = GST_BUFFER_POOL_CLASS (parent_class);
 736   GstV4l2Object *obj = pool->obj;
 737   GstStructure *config;
 738   GstCaps *caps;
 739   guint size, min_buffers, max_buffers;
 740   guint max_latency, min_latency, copy_threshold = 0;
 741   gboolean can_allocate = FALSE, ret = TRUE;
 742
 743   GST_DEBUG_OBJECT (pool, "activating pool");
 744
 745   if (pool->other_pool) {
 746     GstBuffer *buffer;
 747
 748     if (!gst_buffer_pool_set_active (pool->other_pool, TRUE))
 749       goto other_pool_failed;
 750
 751     if (gst_buffer_pool_acquire_buffer (pool->other_pool, &buffer, NULL) !=
 752         GST_FLOW_OK)
 753       goto other_pool_failed;
 754
 755     if (!gst_v4l2_object_try_import (obj, buffer)) {
 756       gst_buffer_unref (buffer);
 757       goto cannot_import;
 758     }
 759     gst_buffer_unref (buffer);
 760   }
 761
 762   config = gst_buffer_pool_get_config (bpool);
 763   if (!gst_buffer_pool_config_get_params (config, &caps, &size, &min_buffers,
 764           &max_buffers))
 765     goto wrong_config;
 766
 767   min_latency = MAX (GST_V4L2_MIN_BUFFERS, obj->min_buffers);
 768
 769   switch (obj->mode) {
 770     case GST_V4L2_IO_RW:
 771       can_allocate = TRUE;
 772 #ifdef HAVE_LIBV4L2
 773       /* This workaround a unfixable bug in libv4l2 when RW is emulated on top
 774        * of MMAP. In this case, the first read initialize the queues, but the
 775        * poll before that will always fail. Doing an empty read, forces the
 776        * queue to be initialized now. We only do this if we have a streaming
 777        * driver. */
 778       if (obj->device_caps & V4L2_CAP_STREAMING)
 779         obj->read (obj->video_fd, NULL, 0);
 780 #endif
 781       break;
 782     case GST_V4L2_IO_DMABUF:
 783     case GST_V4L2_IO_MMAP:
 784     {
 785       guint count;
 786
 787       can_allocate = GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, MMAP);
 788
 789       /* first, lets request buffers, and see how many we can get: */
 790       GST_DEBUG_OBJECT (pool, "requesting %d MMAP buffers", min_buffers);
 791
 792       count = gst_v4l2_allocator_start (pool->vallocator, min_buffers,
 793           V4L2_MEMORY_MMAP);
 794
 795       if (count < GST_V4L2_MIN_BUFFERS) {
 796         min_buffers = count;
 797         goto no_buffers;
 798       }
 799
 800       /* V4L2 buffer pool are often very limited in the amount of buffers it
 801        * can offer. The copy_threshold will workaround this limitation by
 802        * falling back to copy if the pipeline needed more buffers. This also
 803        * prevent having to do REQBUFS(N)/REQBUFS(0) everytime configure is
 804        * called. */
 805       if (count != min_buffers || pool->enable_copy_threshold) {
 806         GST_WARNING_OBJECT (pool,
 807             "Uncertain or not enough buffers, enabling copy threshold");
 808         min_buffers = count;
 809         copy_threshold = min_latency;
 810       }
 811
 812       break;
 813     }
 814     case GST_V4L2_IO_USERPTR:
 815     {
 816       guint count;
 817
 818       can_allocate =
 819           GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, USERPTR);
 820
 821       GST_DEBUG_OBJECT (pool, "requesting %d USERPTR buffers", min_buffers);
 822
 823       count = gst_v4l2_allocator_start (pool->vallocator, min_buffers,
 824           V4L2_MEMORY_USERPTR);
 825
 826       /* There is no rational to not get what we asked */
 827       if (count < min_buffers) {
 828         min_buffers = count;
 829         goto no_buffers;
 830       }
 831
 832       min_buffers = count;
 833       break;
 834     }
 835     case GST_V4L2_IO_DMABUF_IMPORT:
 836     {
 837       guint count;
 838
 839       can_allocate = GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, DMABUF);
 840
 841       GST_DEBUG_OBJECT (pool, "requesting %d DMABUF buffers", min_buffers);
 842
 843       count = gst_v4l2_allocator_start (pool->vallocator, min_buffers,
 844           V4L2_MEMORY_DMABUF);
 845
 846       /* There is no rational to not get what we asked */
 847       if (count < min_buffers) {
 848         min_buffers = count;
 849         goto no_buffers;
 850       }
 851
 852       min_buffers = count;
 853       break;
 854     }
 855     default:
 856       min_buffers = 0;
 857       copy_threshold = 0;
 858       g_assert_not_reached ();
 859       break;
 860   }
 861
 862   if (can_allocate)
 863     max_latency = max_buffers;
 864   else
 865     max_latency = min_buffers;
 866
 867   pool->size = size;
 868   pool->copy_threshold = copy_threshold;
 869   pool->max_latency = max_latency;
 870   pool->min_latency = min_latency;
 871   pool->num_queued = 0;
 872
 873   if (max_buffers != 0 && max_buffers < min_buffers)
 874     max_buffers = min_buffers;
 875
 876   gst_buffer_pool_config_set_params (config, caps, size, min_buffers,
 877       max_buffers);
 878   pclass->set_config (bpool, config);
 879   gst_structure_free (config);
 880
 881   /* now, allocate the buffers: */
 882   if (!pclass->start (bpool))
 883     goto start_failed;
 884
 885   if (!V4L2_TYPE_IS_OUTPUT (obj->type)) {
 886     if (g_atomic_int_get (&pool->num_queued) < min_buffers)
 887       goto queue_failed;
 888
 889     pool->group_released_handler =
 890         g_signal_connect_swapped (pool->vallocator, "group-released",
 891         G_CALLBACK (gst_v4l2_buffer_pool_resurrect_buffer), pool);
 892     ret = gst_v4l2_buffer_pool_streamon (pool);
 893   }
 894
 895   return ret;
 896
 897   /* ERRORS */
 898 wrong_config:
 899   {
 900     GST_ERROR_OBJECT (pool, "invalid config %" GST_PTR_FORMAT, config);
 901     gst_structure_free (config);
 902     return FALSE;
 903   }
 904 no_buffers:
 905   {
 906     GST_ERROR_OBJECT (pool,
 907         "we received %d buffer from device '%s', we want at least %d",
 908         min_buffers, obj->videodev, GST_V4L2_MIN_BUFFERS);
 909     gst_structure_free (config);
 910     return FALSE;
 911   }
 912 start_failed:
 913   {
 914     GST_ERROR_OBJECT (pool, "allocate failed");
 915     return FALSE;
 916   }
 917 other_pool_failed:
 918   {
 919     GST_ERROR_OBJECT (pool, "failed to activate the other pool %"
 920         GST_PTR_FORMAT, pool->other_pool);
 921     return FALSE;
 922   }
 923 queue_failed:
 924   {
 925     GST_ERROR_OBJECT (pool, "failed to queue buffers into the capture queue");
 926     return FALSE;
 927   }
 928 cannot_import:
 929   {
 930     GST_ERROR_OBJECT (pool, "cannot import buffers from downstream pool");
 931     return FALSE;
 932   }
 933 }
 934
 935 static gboolean
 936 gst_v4l2_buffer_pool_vallocator_stop (GstV4l2BufferPool * pool)
 937 {
 938   GstV4l2Return vret;
 939
 940   if (!pool->vallocator)
 941     return TRUE;
 942
 943   vret = gst_v4l2_allocator_stop (pool->vallocator);
 944
 945   if (vret == GST_V4L2_BUSY)
 946     GST_WARNING_OBJECT (pool, "some buffers are still outstanding");
 947
 948   return (vret == GST_V4L2_OK);
 949 }
 950
 951 static gboolean
 952 gst_v4l2_buffer_pool_stop (GstBufferPool * bpool)
 953 {
 954   GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
 955   gboolean ret;
 956
 957   if (pool->orphaned)
 958     return gst_v4l2_buffer_pool_vallocator_stop (pool);
 959
 960   GST_DEBUG_OBJECT (pool, "stopping pool");
 961
 962   if (pool->group_released_handler > 0) {
 963     g_signal_handler_disconnect (pool->vallocator,
 964         pool->group_released_handler);
 965     pool->group_released_handler = 0;
 966   }
 967
 968   if (pool->other_pool) {
 969     gst_buffer_pool_set_active (pool->other_pool, FALSE);
 970     gst_object_unref (pool->other_pool);
 971     pool->other_pool = NULL;
 972   }
 973
 974   gst_v4l2_buffer_pool_streamoff (pool);
 975
 976   ret = GST_BUFFER_POOL_CLASS (parent_class)->stop (bpool);
 977
 978   if (ret)
 979     ret = gst_v4l2_buffer_pool_vallocator_stop (pool);
 980
 981   return ret;
 982 }
 983
 984 gboolean
 985 gst_v4l2_buffer_pool_orphan (GstBufferPool ** bpool)
 986 {
 987   GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (*bpool);
 988   gboolean ret;
 989
 990   if (!GST_V4L2_ALLOCATOR_CAN_ORPHAN_BUFS (pool->vallocator))
 991     return FALSE;
 992
 993   if (g_getenv ("GST_V4L2_FORCE_DRAIN"))
 994     return FALSE;
 995
 996   GST_DEBUG_OBJECT (pool, "orphaning pool");
 997
 998   gst_buffer_pool_set_active (*bpool, FALSE);
 999   /*
1000    * If the buffer pool has outstanding buffers, it will not be stopped
1001    * by the base class when set inactive. Stop it manually and mark it
1002    * as orphaned
1003    */
1004   ret = gst_v4l2_buffer_pool_stop (*bpool);
1005   if (!ret)
1006     ret = gst_v4l2_allocator_orphan (pool->vallocator);
1007
1008   if (!ret)
1009     goto orphan_failed;
1010
1011   pool->orphaned = TRUE;
1012   gst_object_unref (*bpool);
1013   *bpool = NULL;
1014
1015 orphan_failed:
1016   return ret;
1017 }
1018
1019 static void
1020 gst_v4l2_buffer_pool_flush_start (GstBufferPool * bpool)
1021 {
1022   GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
1023
1024   GST_DEBUG_OBJECT (pool, "start flushing");
1025
1026   gst_poll_set_flushing (pool->poll, TRUE);
1027
1028   GST_OBJECT_LOCK (pool);
1029   pool->empty = FALSE;
1030   g_cond_broadcast (&pool->empty_cond);
1031   GST_OBJECT_UNLOCK (pool);
1032
1033   if (pool->other_pool)
1034     gst_buffer_pool_set_flushing (pool->other_pool, TRUE);
1035 }
1036
1037 static void
1038 gst_v4l2_buffer_pool_flush_stop (GstBufferPool * bpool)
1039 {
1040   GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
1041
1042   GST_DEBUG_OBJECT (pool, "stop flushing");
1043
1044   if (pool->other_pool)
1045     gst_buffer_pool_set_flushing (pool->other_pool, FALSE);
1046
1047   gst_poll_set_flushing (pool->poll, FALSE);
1048 }
1049
1050 static GstFlowReturn
1051 gst_v4l2_buffer_pool_poll (GstV4l2BufferPool * pool, gboolean wait)
1052 {
1053   gint ret;
1054   GstClockTime timeout;
1055
1056   if (wait)
1057     timeout = GST_CLOCK_TIME_NONE;
1058   else
1059     timeout = 0;
1060
1061   /* In RW mode there is no queue, hence no need to wait while the queue is
1062    * empty */
1063   if (pool->obj->mode != GST_V4L2_IO_RW) {
1064     GST_OBJECT_LOCK (pool);
1065
1066     if (!wait && pool->empty) {
1067       GST_OBJECT_UNLOCK (pool);
1068       goto no_buffers;
1069     }
1070
1071     while (pool->empty)
1072       g_cond_wait (&pool->empty_cond, GST_OBJECT_GET_LOCK (pool));
1073
1074     GST_OBJECT_UNLOCK (pool);
1075   }
1076
1077   if (!pool->can_poll_device) {
1078     if (wait)
1079       goto done;
1080     else
1081       goto no_buffers;
1082   }
1083
1084   GST_LOG_OBJECT (pool, "polling device");
1085
1086 again:
1087   ret = gst_poll_wait (pool->poll, timeout);
1088   if (G_UNLIKELY (ret < 0)) {
1089     switch (errno) {
1090       case EBUSY:
1091         goto stopped;
1092       case EAGAIN:
1093       case EINTR:
1094         goto again;
1095       case ENXIO:
1096         GST_WARNING_OBJECT (pool,
1097             "v4l2 device doesn't support polling. Disabling"
1098             " using libv4l2 in this case may cause deadlocks");
1099         pool->can_poll_device = FALSE;
1100         goto done;
1101       default:
1102         goto select_error;
1103     }
1104   }
1105
1106   if (gst_poll_fd_has_error (pool->poll, &pool->pollfd))
1107     goto select_error;
1108
1109   if (ret == 0)
1110     goto no_buffers;
1111
1112 done:
1113   return GST_FLOW_OK;
1114
1115   /* ERRORS */
1116 stopped:
1117   {
1118     GST_DEBUG_OBJECT (pool, "stop called");
1119     return GST_FLOW_FLUSHING;
1120   }
1121 select_error:
1122   {
1123     GST_ELEMENT_ERROR (pool->obj->element, RESOURCE, READ, (NULL),
1124         ("poll error %d: %s (%d)", ret, g_strerror (errno), errno));
1125     return GST_FLOW_ERROR;
1126   }
1127 no_buffers:
1128   return GST_FLOW_CUSTOM_SUCCESS;
1129 }
1130
1131 static GstFlowReturn
1132 gst_v4l2_buffer_pool_qbuf (GstV4l2BufferPool * pool, GstBuffer * buf,
1133     GstV4l2MemoryGroup * group)
1134 {
1135   const GstV4l2Object *obj = pool->obj;
1136   GstClockTime timestamp;
1137   gint index;
1138
1139   index = group->buffer.index;
1140
1141   if (pool->buffers[index] != NULL)
1142     goto already_queued;
1143
1144   GST_LOG_OBJECT (pool, "queuing buffer %i", index);
1145
1146   if (V4L2_TYPE_IS_OUTPUT (obj->type)) {
1147     enum v4l2_field field;
1148
1149     /* Except when field is set to alternate, buffer field is the same as
1150      * the one defined in format */
1151     if (V4L2_TYPE_IS_MULTIPLANAR (obj->type))
1152       field = obj->format.fmt.pix_mp.field;
1153     else
1154       field = obj->format.fmt.pix.field;
1155
1156     /* NB: At this moment, we can't have alternate mode because it not handled
1157      * yet */
1158     if (field == V4L2_FIELD_ALTERNATE) {
1159       if (GST_BUFFER_FLAG_IS_SET (buf, GST_VIDEO_FRAME_FLAG_TFF))
1160         field = V4L2_FIELD_TOP;
1161       else
1162         field = V4L2_FIELD_BOTTOM;
1163     }
1164
1165     group->buffer.field = field;
1166   }
1167
1168   if (GST_BUFFER_TIMESTAMP_IS_VALID (buf)) {
1169     timestamp = GST_BUFFER_TIMESTAMP (buf);
1170     GST_TIME_TO_TIMEVAL (timestamp, group->buffer.timestamp);
1171   }
1172
1173   GST_OBJECT_LOCK (pool);
1174   g_atomic_int_inc (&pool->num_queued);
1175   pool->buffers[index] = buf;
1176
1177   if (!gst_v4l2_allocator_qbuf (pool->vallocator, group))
1178     goto queue_failed;
1179
1180   pool->empty = FALSE;
1181   g_cond_signal (&pool->empty_cond);
1182   GST_OBJECT_UNLOCK (pool);
1183
1184   return GST_FLOW_OK;
1185
1186 already_queued:
1187   {
1188     GST_ERROR_OBJECT (pool, "the buffer %i was already queued", index);
1189     return GST_FLOW_ERROR;
1190   }
1191 queue_failed:
1192   {
1193     GST_ERROR_OBJECT (pool, "could not queue a buffer %i", index);
1194     /* Mark broken buffer to the allocator */
1195     GST_BUFFER_FLAG_SET (buf, GST_BUFFER_FLAG_TAG_MEMORY);
1196     g_atomic_int_add (&pool->num_queued, -1);
1197     pool->buffers[index] = NULL;
1198     GST_OBJECT_UNLOCK (pool);
1199     return GST_FLOW_ERROR;
1200   }
1201 }
1202
1203 static GstFlowReturn
1204 gst_v4l2_buffer_pool_dqbuf (GstV4l2BufferPool * pool, GstBuffer ** buffer,
1205     gboolean wait)
1206 {
1207   GstFlowReturn res;
1208   GstBuffer *outbuf = NULL;
1209   GstV4l2Object *obj = pool->obj;
1210   GstClockTime timestamp;
1211   GstV4l2MemoryGroup *group;
1212   GstVideoMeta *vmeta;
1213   gsize size;
1214   gint i;
1215
1216   if ((res = gst_v4l2_buffer_pool_poll (pool, wait)) < GST_FLOW_OK)
1217     goto poll_failed;
1218
1219   if (res == GST_FLOW_CUSTOM_SUCCESS) {
1220     GST_LOG_OBJECT (pool, "nothing to dequeue");
1221     goto done;
1222   }
1223
1224   GST_LOG_OBJECT (pool, "dequeueing a buffer");
1225
1226   res = gst_v4l2_allocator_dqbuf (pool->vallocator, &group);
1227   if (res == GST_FLOW_EOS)
1228     goto eos;
1229   if (res != GST_FLOW_OK)
1230     goto dqbuf_failed;
1231
1232   /* get our GstBuffer with that index from the pool, if the buffer was
1233    * outstanding we have a serious problem.
1234    */
1235   outbuf = pool->buffers[group->buffer.index];
1236   if (outbuf == NULL)
1237     goto no_buffer;
1238
1239   /* mark the buffer outstanding */
1240   pool->buffers[group->buffer.index] = NULL;
1241   if (g_atomic_int_dec_and_test (&pool->num_queued)) {
1242     GST_OBJECT_LOCK (pool);
1243     pool->empty = TRUE;
1244     GST_OBJECT_UNLOCK (pool);
1245   }
1246
1247   timestamp = GST_TIMEVAL_TO_TIME (group->buffer.timestamp);
1248
1249   size = 0;
1250   vmeta = gst_buffer_get_video_meta (outbuf);
1251   for (i = 0; i < group->n_mem; i++) {
1252     GST_LOG_OBJECT (pool,
1253         "dequeued buffer %p seq:%d (ix=%d), mem %p used %d, plane=%d, flags %08x, ts %"
1254         GST_TIME_FORMAT ", pool-queued=%d, buffer=%p", outbuf,
1255         group->buffer.sequence, group->buffer.index, group->mem[i],
1256         group->planes[i].bytesused, i, group->buffer.flags,
1257         GST_TIME_ARGS (timestamp), pool->num_queued, outbuf);
1258
1259     if (vmeta) {
1260       vmeta->offset[i] = size;
1261       size += gst_memory_get_sizes (group->mem[i], NULL, NULL);
1262     }
1263   }
1264
1265   /* Ignore timestamp and field for OUTPUT device */
1266   if (V4L2_TYPE_IS_OUTPUT (obj->type))
1267     goto done;
1268
1269   /* Check for driver bug in reporting feild */
1270   if (group->buffer.field == V4L2_FIELD_ANY) {
1271     /* Only warn once to avoid the spamming */
1272 #ifndef GST_DISABLE_GST_DEBUG
1273     if (!pool->has_warned_on_buggy_field) {
1274       pool->has_warned_on_buggy_field = TRUE;
1275       GST_WARNING_OBJECT (pool,
1276           "Driver should never set v4l2_buffer.field to ANY");
1277     }
1278 #endif
1279
1280     /* Use the value from the format (works for UVC bug) */
1281     group->buffer.field = obj->format.fmt.pix.field;
1282
1283     /* If driver also has buggy S_FMT, assume progressive */
1284     if (group->buffer.field == V4L2_FIELD_ANY) {
1285 #ifndef GST_DISABLE_GST_DEBUG
1286       if (!pool->has_warned_on_buggy_field) {
1287         pool->has_warned_on_buggy_field = TRUE;
1288         GST_WARNING_OBJECT (pool,
1289             "Driver should never set v4l2_format.pix.field to ANY");
1290       }
1291 #endif
1292
1293       group->buffer.field = V4L2_FIELD_NONE;
1294     }
1295   }
1296
1297   /* set top/bottom field first if v4l2_buffer has the information */
1298   switch (group->buffer.field) {
1299     case V4L2_FIELD_NONE:
1300       GST_BUFFER_FLAG_UNSET (outbuf, GST_VIDEO_BUFFER_FLAG_INTERLACED);
1301       GST_BUFFER_FLAG_UNSET (outbuf, GST_VIDEO_BUFFER_FLAG_TFF);
1302       break;
1303     case V4L2_FIELD_INTERLACED_TB:
1304       GST_BUFFER_FLAG_SET (outbuf, GST_VIDEO_BUFFER_FLAG_INTERLACED);
1305       GST_BUFFER_FLAG_SET (outbuf, GST_VIDEO_BUFFER_FLAG_TFF);
1306       break;
1307     case V4L2_FIELD_INTERLACED_BT:
1308       GST_BUFFER_FLAG_SET (outbuf, GST_VIDEO_BUFFER_FLAG_INTERLACED);
1309       GST_BUFFER_FLAG_UNSET (outbuf, GST_VIDEO_BUFFER_FLAG_TFF);
1310       break;
1311     case V4L2_FIELD_INTERLACED:
1312       GST_BUFFER_FLAG_SET (outbuf, GST_VIDEO_BUFFER_FLAG_INTERLACED);
1313       if (obj->tv_norm == V4L2_STD_NTSC_M ||
1314           obj->tv_norm == V4L2_STD_NTSC_M_JP ||
1315           obj->tv_norm == V4L2_STD_NTSC_M_KR) {
1316         GST_BUFFER_FLAG_UNSET (outbuf, GST_VIDEO_BUFFER_FLAG_TFF);
1317       } else {
1318         GST_BUFFER_FLAG_SET (outbuf, GST_VIDEO_BUFFER_FLAG_TFF);
1319       }
1320       break;
1321     default:
1322       GST_BUFFER_FLAG_UNSET (outbuf, GST_VIDEO_BUFFER_FLAG_INTERLACED);
1323       GST_BUFFER_FLAG_UNSET (outbuf, GST_VIDEO_BUFFER_FLAG_TFF);
1324       GST_FIXME_OBJECT (pool,
1325           "Unhandled enum v4l2_field %d - treating as progressive",
1326           group->buffer.field);
1327       break;
1328   }
1329
1330   if (GST_VIDEO_INFO_FORMAT (&obj->info) == GST_VIDEO_FORMAT_ENCODED) {
1331     if ((group->buffer.flags & V4L2_BUF_FLAG_KEYFRAME) ||
1332         GST_V4L2_PIXELFORMAT (obj) == V4L2_PIX_FMT_MJPEG ||
1333         GST_V4L2_PIXELFORMAT (obj) == V4L2_PIX_FMT_JPEG ||
1334         GST_V4L2_PIXELFORMAT (obj) == V4L2_PIX_FMT_PJPG)
1335       GST_BUFFER_FLAG_UNSET (outbuf, GST_BUFFER_FLAG_DELTA_UNIT);
1336     else
1337       GST_BUFFER_FLAG_SET (outbuf, GST_BUFFER_FLAG_DELTA_UNIT);
1338   }
1339
1340   if (group->buffer.flags & V4L2_BUF_FLAG_ERROR)
1341     GST_BUFFER_FLAG_SET (outbuf, GST_BUFFER_FLAG_CORRUPTED);
1342
1343   GST_BUFFER_TIMESTAMP (outbuf) = timestamp;
1344   GST_BUFFER_OFFSET (outbuf) = group->buffer.sequence;
1345   GST_BUFFER_OFFSET_END (outbuf) = group->buffer.sequence + 1;
1346
1347 done:
1348   *buffer = outbuf;
1349
1350   return res;
1351
1352   /* ERRORS */
1353 poll_failed:
1354   {
1355     GST_DEBUG_OBJECT (pool, "poll error %s", gst_flow_get_name (res));
1356     return res;
1357   }
1358 eos:
1359   {
1360     return GST_FLOW_EOS;
1361   }
1362 dqbuf_failed:
1363   {
1364     return GST_FLOW_ERROR;
1365   }
1366 no_buffer:
1367   {
1368     GST_ERROR_OBJECT (pool, "No free buffer found in the pool at index %d.",
1369         group->buffer.index);
1370     return GST_FLOW_ERROR;
1371   }
1372 }
1373
1374 static GstFlowReturn
1375 gst_v4l2_buffer_pool_acquire_buffer (GstBufferPool * bpool, GstBuffer ** buffer,
1376     GstBufferPoolAcquireParams * params)
1377 {
1378   GstFlowReturn ret;
1379   GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
1380   GstBufferPoolClass *pclass = GST_BUFFER_POOL_CLASS (parent_class);
1381   GstV4l2Object *obj = pool->obj;
1382
1383   GST_DEBUG_OBJECT (pool, "acquire");
1384
1385   /* If this is being called to resurrect a lost buffer */
1386   if (params && params->flags & GST_V4L2_BUFFER_POOL_ACQUIRE_FLAG_RESURRECT) {
1387     ret = pclass->acquire_buffer (bpool, buffer, params);
1388     goto done;
1389   }
1390
1391   switch (obj->type) {
1392     case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1393     case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1394       /* capture, This function should return a buffer with new captured data */
1395       switch (obj->mode) {
1396         case GST_V4L2_IO_RW:
1397         {
1398           /* take empty buffer from the pool */
1399           ret = pclass->acquire_buffer (bpool, buffer, params);
1400           break;
1401         }
1402         case GST_V4L2_IO_DMABUF:
1403         case GST_V4L2_IO_MMAP:
1404         case GST_V4L2_IO_USERPTR:
1405         case GST_V4L2_IO_DMABUF_IMPORT:
1406         {
1407           /* just dequeue a buffer, we basically use the queue of v4l2 as the
1408            * storage for our buffers. This function does poll first so we can
1409            * interrupt it fine. */
1410           ret = gst_v4l2_buffer_pool_dqbuf (pool, buffer, TRUE);
1411           break;
1412         }
1413         default:
1414           ret = GST_FLOW_ERROR;
1415           g_assert_not_reached ();
1416           break;
1417       }
1418       break;
1419
1420
1421     case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1422     case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1423       /* playback, This function should return an empty buffer */
1424       switch (obj->mode) {
1425         case GST_V4L2_IO_RW:
1426           /* get an empty buffer */
1427           ret = pclass->acquire_buffer (bpool, buffer, params);
1428           break;
1429
1430         case GST_V4L2_IO_MMAP:
1431         case GST_V4L2_IO_DMABUF:
1432         case GST_V4L2_IO_USERPTR:
1433         case GST_V4L2_IO_DMABUF_IMPORT:
1434           /* get a free unqueued buffer */
1435           ret = pclass->acquire_buffer (bpool, buffer, params);
1436           break;
1437
1438         default:
1439           ret = GST_FLOW_ERROR;
1440           g_assert_not_reached ();
1441           break;
1442       }
1443       break;
1444
1445     default:
1446       ret = GST_FLOW_ERROR;
1447       g_assert_not_reached ();
1448       break;
1449   }
1450 done:
1451   return ret;
1452 }
1453
1454 static void
1455 gst_v4l2_buffer_pool_release_buffer (GstBufferPool * bpool, GstBuffer * buffer)
1456 {
1457   GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
1458   GstBufferPoolClass *pclass = GST_BUFFER_POOL_CLASS (parent_class);
1459   GstV4l2Object *obj = pool->obj;
1460
1461   GST_DEBUG_OBJECT (pool, "release buffer %p", buffer);
1462
1463   /* If the buffer's pool has been orphaned, dispose of it so that
1464    * the pool resources can be freed */
1465   if (pool->orphaned) {
1466     GST_BUFFER_FLAG_SET (buffer, GST_BUFFER_FLAG_TAG_MEMORY);
1467     pclass->release_buffer (bpool, buffer);
1468     return;
1469   }
1470
1471   switch (obj->type) {
1472     case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1473     case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1474       /* capture, put the buffer back in the queue so that we can refill it
1475        * later. */
1476       switch (obj->mode) {
1477         case GST_V4L2_IO_RW:
1478           /* release back in the pool */
1479           pclass->release_buffer (bpool, buffer);
1480           break;
1481
1482         case GST_V4L2_IO_DMABUF:
1483         case GST_V4L2_IO_MMAP:
1484         case GST_V4L2_IO_USERPTR:
1485         case GST_V4L2_IO_DMABUF_IMPORT:
1486         {
1487           GstV4l2MemoryGroup *group;
1488           if (gst_v4l2_is_buffer_valid (buffer, &group)) {
1489             GstFlowReturn ret = GST_FLOW_OK;
1490
1491             gst_v4l2_allocator_reset_group (pool->vallocator, group);
1492             /* queue back in the device */
1493             if (pool->other_pool)
1494               ret = gst_v4l2_buffer_pool_prepare_buffer (pool, buffer, NULL);
1495             if (ret != GST_FLOW_OK ||
1496                 gst_v4l2_buffer_pool_qbuf (pool, buffer, group) != GST_FLOW_OK)
1497               pclass->release_buffer (bpool, buffer);
1498           } else {
1499             /* Simply release invalide/modified buffer, the allocator will
1500              * give it back later */
1501             GST_BUFFER_FLAG_SET (buffer, GST_BUFFER_FLAG_TAG_MEMORY);
1502             pclass->release_buffer (bpool, buffer);
1503           }
1504           break;
1505         }
1506         default:
1507           g_assert_not_reached ();
1508           break;
1509       }
1510       break;
1511
1512     case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1513     case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1514       switch (obj->mode) {
1515         case GST_V4L2_IO_RW:
1516           /* release back in the pool */
1517           pclass->release_buffer (bpool, buffer);
1518           break;
1519
1520         case GST_V4L2_IO_MMAP:
1521         case GST_V4L2_IO_DMABUF:
1522         case GST_V4L2_IO_USERPTR:
1523         case GST_V4L2_IO_DMABUF_IMPORT:
1524         {
1525           GstV4l2MemoryGroup *group;
1526           guint index;
1527
1528           if (!gst_v4l2_is_buffer_valid (buffer, &group)) {
1529             /* Simply release invalide/modified buffer, the allocator will
1530              * give it back later */
1531             GST_BUFFER_FLAG_SET (buffer, GST_BUFFER_FLAG_TAG_MEMORY);
1532             pclass->release_buffer (bpool, buffer);
1533             break;
1534           }
1535
1536           index = group->buffer.index;
1537
1538           if (pool->buffers[index] == NULL) {
1539             GST_LOG_OBJECT (pool, "buffer %u not queued, putting on free list",
1540                 index);
1541
1542             /* Remove qdata, this will unmap any map data in userptr */
1543             gst_mini_object_set_qdata (GST_MINI_OBJECT (buffer),
1544                 GST_V4L2_IMPORT_QUARK, NULL, NULL);
1545
1546             /* reset to default size */
1547             gst_v4l2_allocator_reset_group (pool->vallocator, group);
1548
1549             /* playback, put the buffer back in the queue to refill later. */
1550             pclass->release_buffer (bpool, buffer);
1551           } else {
1552             /* the buffer is queued in the device but maybe not played yet. We just
1553              * leave it there and not make it available for future calls to acquire
1554              * for now. The buffer will be dequeued and reused later. */
1555             GST_LOG_OBJECT (pool, "buffer %u is queued", index);
1556           }
1557           break;
1558         }
1559
1560         default:
1561           g_assert_not_reached ();
1562           break;
1563       }
1564       break;
1565
1566     default:
1567       g_assert_not_reached ();
1568       break;
1569   }
1570 }
1571
1572 static void
1573 gst_v4l2_buffer_pool_dispose (GObject * object)
1574 {
1575   GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (object);
1576
1577   if (pool->vallocator)
1578     gst_object_unref (pool->vallocator);
1579   pool->vallocator = NULL;
1580
1581   if (pool->allocator)
1582     gst_object_unref (pool->allocator);
1583   pool->allocator = NULL;
1584
1585   if (pool->other_pool)
1586     gst_object_unref (pool->other_pool);
1587   pool->other_pool = NULL;
1588
1589   G_OBJECT_CLASS (parent_class)->dispose (object);
1590 }
1591
1592 static void
1593 gst_v4l2_buffer_pool_finalize (GObject * object)
1594 {
1595   GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (object);
1596
1597   if (pool->video_fd >= 0)
1598     pool->obj->close (pool->video_fd);
1599
1600   gst_poll_free (pool->poll);
1601
1602   /* This can't be done in dispose method because we must not set pointer
1603    * to NULL as it is part of the v4l2object and dispose could be called
1604    * multiple times */
1605   gst_object_unref (pool->obj->element);
1606
1607   g_cond_clear (&pool->empty_cond);
1608
1609   /* FIXME have we done enough here ? */
1610
1611   G_OBJECT_CLASS (parent_class)->finalize (object);
1612 }
1613
1614 static void
1615 gst_v4l2_buffer_pool_init (GstV4l2BufferPool * pool)
1616 {
1617   pool->poll = gst_poll_new (TRUE);
1618   pool->can_poll_device = TRUE;
1619   g_cond_init (&pool->empty_cond);
1620   pool->empty = TRUE;
1621   pool->orphaned = FALSE;
1622 }
1623
1624 static void
1625 gst_v4l2_buffer_pool_class_init (GstV4l2BufferPoolClass * klass)
1626 {
1627   GObjectClass *object_class = G_OBJECT_CLASS (klass);
1628   GstBufferPoolClass *bufferpool_class = GST_BUFFER_POOL_CLASS (klass);
1629
1630   object_class->dispose = gst_v4l2_buffer_pool_dispose;
1631   object_class->finalize = gst_v4l2_buffer_pool_finalize;
1632
1633   bufferpool_class->start = gst_v4l2_buffer_pool_start;
1634   bufferpool_class->stop = gst_v4l2_buffer_pool_stop;
1635   bufferpool_class->set_config = gst_v4l2_buffer_pool_set_config;
1636   bufferpool_class->alloc_buffer = gst_v4l2_buffer_pool_alloc_buffer;
1637   bufferpool_class->acquire_buffer = gst_v4l2_buffer_pool_acquire_buffer;
1638   bufferpool_class->release_buffer = gst_v4l2_buffer_pool_release_buffer;
1639   bufferpool_class->flush_start = gst_v4l2_buffer_pool_flush_start;
1640   bufferpool_class->flush_stop = gst_v4l2_buffer_pool_flush_stop;
1641
1642   GST_DEBUG_CATEGORY_INIT (v4l2bufferpool_debug, "v4l2bufferpool", 0,
1643       "V4L2 Buffer Pool");
1644   GST_DEBUG_CATEGORY_GET (CAT_PERFORMANCE, "GST_PERFORMANCE");
1645 }
1646
1647 /**
1648  * gst_v4l2_buffer_pool_new:
1649  * @obj:  the v4l2 object owning the pool
1650  *
1651  * Construct a new buffer pool.
1652  *
1653  * Returns: the new pool, use gst_object_unref() to free resources
1654  */
1655 GstBufferPool *
1656 gst_v4l2_buffer_pool_new (GstV4l2Object * obj, GstCaps * caps)
1657 {
1658   GstV4l2BufferPool *pool;
1659   GstStructure *config;
1660   gchar *name, *parent_name;
1661   gint fd;
1662
1663   fd = obj->dup (obj->video_fd);
1664   if (fd < 0)
1665     goto dup_failed;
1666
1667   /* setting a significant unique name */
1668   parent_name = gst_object_get_name (GST_OBJECT (obj->element));
1669   name = g_strconcat (parent_name, ":", "pool:",
1670       V4L2_TYPE_IS_OUTPUT (obj->type) ? "sink" : "src", NULL);
1671   g_free (parent_name);
1672
1673   pool = (GstV4l2BufferPool *) g_object_new (GST_TYPE_V4L2_BUFFER_POOL,
1674       "name", name, NULL);
1675   g_object_ref_sink (pool);
1676   g_free (name);
1677
1678   gst_poll_fd_init (&pool->pollfd);
1679   pool->pollfd.fd = fd;
1680   gst_poll_add_fd (pool->poll, &pool->pollfd);
1681   if (V4L2_TYPE_IS_OUTPUT (obj->type))
1682     gst_poll_fd_ctl_write (pool->poll, &pool->pollfd, TRUE);
1683   else
1684     gst_poll_fd_ctl_read (pool->poll, &pool->pollfd, TRUE);
1685
1686   pool->video_fd = fd;
1687   pool->obj = obj;
1688   pool->can_poll_device = TRUE;
1689
1690   pool->vallocator = gst_v4l2_allocator_new (GST_OBJECT (pool), obj);
1691   if (pool->vallocator == NULL)
1692     goto allocator_failed;
1693
1694   gst_object_ref (obj->element);
1695
1696   config = gst_buffer_pool_get_config (GST_BUFFER_POOL_CAST (pool));
1697   gst_buffer_pool_config_set_params (config, caps, obj->info.size, 0, 0);
1698   /* This will simply set a default config, but will not configure the pool
1699    * because min and max are not valid */
1700   gst_buffer_pool_set_config (GST_BUFFER_POOL_CAST (pool), config);
1701
1702   return GST_BUFFER_POOL (pool);
1703
1704   /* ERRORS */
1705 dup_failed:
1706   {
1707     GST_ERROR ("failed to dup fd %d (%s)", errno, g_strerror (errno));
1708     return NULL;
1709   }
1710 allocator_failed:
1711   {
1712     GST_ERROR_OBJECT (pool, "Failed to create V4L2 allocator");
1713     gst_object_unref (pool);
1714     return NULL;
1715   }
1716 }
1717
1718 static GstFlowReturn
1719 gst_v4l2_do_read (GstV4l2BufferPool * pool, GstBuffer * buf)
1720 {
1721   GstFlowReturn res;
1722   GstV4l2Object *obj = pool->obj;
1723   gint amount;
1724   GstMapInfo map;
1725   gint toread;
1726
1727   toread = obj->info.size;
1728
1729   GST_LOG_OBJECT (pool, "reading %d bytes into buffer %p", toread, buf);
1730
1731   gst_buffer_map (buf, &map, GST_MAP_WRITE);
1732
1733   do {
1734     if ((res = gst_v4l2_buffer_pool_poll (pool, TRUE)) != GST_FLOW_OK)
1735       goto poll_error;
1736
1737     amount = obj->read (obj->video_fd, map.data, toread);
1738
1739     if (amount == toread) {
1740       break;
1741     } else if (amount == -1) {
1742       if (errno == EAGAIN || errno == EINTR) {
1743         continue;
1744       } else
1745         goto read_error;
1746     } else {
1747       /* short reads can happen if a signal interrupts the read */
1748       continue;
1749     }
1750   } while (TRUE);
1751
1752   GST_LOG_OBJECT (pool, "read %d bytes", amount);
1753   gst_buffer_unmap (buf, &map);
1754   gst_buffer_resize (buf, 0, amount);
1755
1756   return GST_FLOW_OK;
1757
1758   /* ERRORS */
1759 poll_error:
1760   {
1761     GST_DEBUG ("poll error %s", gst_flow_get_name (res));
1762     goto cleanup;
1763   }
1764 read_error:
1765   {
1766     GST_ELEMENT_ERROR (obj->element, RESOURCE, READ,
1767         (_("Error reading %d bytes from device '%s'."),
1768             toread, obj->videodev), GST_ERROR_SYSTEM);
1769     res = GST_FLOW_ERROR;
1770     goto cleanup;
1771   }
1772 cleanup:
1773   {
1774     gst_buffer_unmap (buf, &map);
1775     gst_buffer_resize (buf, 0, 0);
1776     return res;
1777   }
1778 }
1779
1780 /**
1781  * gst_v4l2_buffer_pool_process:
1782  * @bpool: a #GstBufferPool
1783  * @buf: a #GstBuffer, maybe be replaced
1784  *
1785  * Process @buf in @bpool. For capture devices, this functions fills @buf with
1786  * data from the device. For output devices, this functions send the contents of
1787  * @buf to the device for playback.
1788  *
1789  * Returns: %GST_FLOW_OK on success.
1790  */
1791 GstFlowReturn
1792 gst_v4l2_buffer_pool_process (GstV4l2BufferPool * pool, GstBuffer ** buf)
1793 {
1794   GstFlowReturn ret = GST_FLOW_OK;
1795   GstBufferPool *bpool = GST_BUFFER_POOL_CAST (pool);
1796   GstV4l2Object *obj = pool->obj;
1797
1798   GST_DEBUG_OBJECT (pool, "process buffer %p", buf);
1799
1800   if (GST_BUFFER_POOL_IS_FLUSHING (pool))
1801     return GST_FLOW_FLUSHING;
1802
1803   switch (obj->type) {
1804     case V4L2_BUF_TYPE_VIDEO_CAPTURE:
1805     case V4L2_BUF_TYPE_VIDEO_CAPTURE_MPLANE:
1806       /* capture */
1807       switch (obj->mode) {
1808         case GST_V4L2_IO_RW:
1809           /* capture into the buffer */
1810           ret = gst_v4l2_do_read (pool, *buf);
1811           break;
1812
1813         case GST_V4L2_IO_MMAP:
1814         case GST_V4L2_IO_DMABUF:
1815         {
1816           GstBuffer *tmp;
1817
1818           if ((*buf)->pool == bpool) {
1819             guint num_queued;
1820             gsize size = gst_buffer_get_size (*buf);
1821
1822             /* Legacy M2M devices return empty buffer when drained */
1823             if (size == 0 && GST_V4L2_IS_M2M (obj->device_caps))
1824               goto eos;
1825
1826             if (GST_VIDEO_INFO_FORMAT (&pool->caps_info) !=
1827                 GST_VIDEO_FORMAT_ENCODED && size < pool->size)
1828               goto buffer_truncated;
1829
1830             num_queued = g_atomic_int_get (&pool->num_queued);
1831             GST_TRACE_OBJECT (pool, "Only %i buffer left in the capture queue.",
1832                 num_queued);
1833
1834             /* If we have no more buffer, and can allocate it time to do so */
1835             if (num_queued == 0) {
1836               if (GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, MMAP)) {
1837                 ret = gst_v4l2_buffer_pool_resurrect_buffer (pool);
1838                 if (ret == GST_FLOW_OK)
1839                   goto done;
1840               }
1841             }
1842
1843             /* start copying buffers when we are running low on buffers */
1844             if (num_queued < pool->copy_threshold) {
1845               GstBuffer *copy;
1846
1847               if (GST_V4L2_ALLOCATOR_CAN_ALLOCATE (pool->vallocator, MMAP)) {
1848                 ret = gst_v4l2_buffer_pool_resurrect_buffer (pool);
1849                 if (ret == GST_FLOW_OK)
1850                   goto done;
1851               }
1852
1853               /* copy the buffer */
1854               copy = gst_buffer_copy_region (*buf,
1855                   GST_BUFFER_COPY_ALL | GST_BUFFER_COPY_DEEP, 0, -1);
1856               GST_LOG_OBJECT (pool, "copy buffer %p->%p", *buf, copy);
1857
1858               /* and requeue so that we can continue capturing */
1859               gst_buffer_unref (*buf);
1860               *buf = copy;
1861             }
1862
1863             ret = GST_FLOW_OK;
1864             /* nothing, data was inside the buffer when we did _acquire() */
1865             goto done;
1866           }
1867
1868           /* buffer not from our pool, grab a frame and copy it into the target */
1869           if ((ret = gst_v4l2_buffer_pool_dqbuf (pool, &tmp, TRUE))
1870               != GST_FLOW_OK)
1871             goto done;
1872
1873           /* An empty buffer on capture indicates the end of stream */
1874           if (gst_buffer_get_size (tmp) == 0) {
1875             gst_v4l2_buffer_pool_release_buffer (bpool, tmp);
1876
1877             /* Legacy M2M devices return empty buffer when drained */
1878             if (GST_V4L2_IS_M2M (obj->device_caps))
1879               goto eos;
1880           }
1881
1882           ret = gst_v4l2_buffer_pool_copy_buffer (pool, *buf, tmp);
1883
1884           /* an queue the buffer again after the copy */
1885           gst_v4l2_buffer_pool_release_buffer (bpool, tmp);
1886
1887           if (ret != GST_FLOW_OK)
1888             goto copy_failed;
1889           break;
1890         }
1891
1892         case GST_V4L2_IO_USERPTR:
1893         {
1894           struct UserPtrData *data;
1895           GstBuffer *tmp;
1896
1897           /* Replace our buffer with downstream allocated buffer */
1898           data = gst_mini_object_steal_qdata (GST_MINI_OBJECT (*buf),
1899               GST_V4L2_IMPORT_QUARK);
1900           tmp = gst_buffer_ref (data->buffer);
1901           _unmap_userptr_frame (data);
1902
1903           /* Now tmp is writable, copy the flags and timestamp */
1904           gst_buffer_copy_into (tmp, *buf,
1905               GST_BUFFER_COPY_FLAGS | GST_BUFFER_COPY_TIMESTAMPS, 0, -1);
1906
1907           gst_buffer_replace (buf, tmp);
1908           gst_buffer_unref (tmp);
1909           break;
1910         }
1911
1912         case GST_V4L2_IO_DMABUF_IMPORT:
1913         {
1914           GstBuffer *tmp;
1915
1916           /* Replace our buffer with downstream allocated buffer */
1917           tmp = gst_mini_object_steal_qdata (GST_MINI_OBJECT (*buf),
1918               GST_V4L2_IMPORT_QUARK);
1919
1920           gst_buffer_copy_into (tmp, *buf,
1921               GST_BUFFER_COPY_FLAGS | GST_BUFFER_COPY_TIMESTAMPS, 0, -1);
1922
1923           gst_buffer_replace (buf, tmp);
1924           gst_buffer_unref (tmp);
1925           break;
1926         }
1927
1928         default:
1929           g_assert_not_reached ();
1930           break;
1931       }
1932       break;
1933
1934     case V4L2_BUF_TYPE_VIDEO_OUTPUT:
1935     case V4L2_BUF_TYPE_VIDEO_OUTPUT_MPLANE:
1936       /* playback */
1937       switch (obj->mode) {
1938         case GST_V4L2_IO_RW:
1939           /* FIXME, do write() */
1940           GST_WARNING_OBJECT (pool, "implement write()");
1941           break;
1942
1943         case GST_V4L2_IO_USERPTR:
1944         case GST_V4L2_IO_DMABUF_IMPORT:
1945         case GST_V4L2_IO_DMABUF:
1946         case GST_V4L2_IO_MMAP:
1947         {
1948           GstBuffer *to_queue = NULL;
1949           GstBuffer *buffer;
1950           GstV4l2MemoryGroup *group;
1951           gint index;
1952
1953           if ((*buf)->pool != bpool)
1954             goto copying;
1955
1956           if (!gst_v4l2_is_buffer_valid (*buf, &group))
1957             goto copying;
1958
1959           index = group->buffer.index;
1960
1961           GST_LOG_OBJECT (pool, "processing buffer %i from our pool", index);
1962
1963           if (pool->buffers[index] != NULL) {
1964             GST_LOG_OBJECT (pool, "buffer %i already queued, copying", index);
1965             goto copying;
1966           }
1967
1968           /* we can queue directly */
1969           to_queue = gst_buffer_ref (*buf);
1970
1971         copying:
1972           if (to_queue == NULL) {
1973             GstBufferPoolAcquireParams params = { 0 };
1974
1975             GST_LOG_OBJECT (pool, "alloc buffer from our pool");
1976
1977             /* this can return EOS if all buffers are outstanding which would
1978              * be strange because we would expect the upstream element to have
1979              * allocated them and returned to us.. */
1980             params.flags = GST_BUFFER_POOL_ACQUIRE_FLAG_DONTWAIT;
1981             ret = gst_buffer_pool_acquire_buffer (bpool, &to_queue, &params);
1982             if (ret != GST_FLOW_OK)
1983               goto acquire_failed;
1984
1985             ret = gst_v4l2_buffer_pool_prepare_buffer (pool, to_queue, *buf);
1986             if (ret != GST_FLOW_OK) {
1987               gst_buffer_unref (to_queue);
1988               goto prepare_failed;
1989             }
1990
1991             /* retreive the group */
1992             gst_v4l2_is_buffer_valid (to_queue, &group);
1993           }
1994
1995           if ((ret = gst_v4l2_buffer_pool_qbuf (pool, to_queue, group))
1996               != GST_FLOW_OK)
1997             goto queue_failed;
1998
1999           /* if we are not streaming yet (this is the first buffer, start
2000            * streaming now */
2001           if (!gst_v4l2_buffer_pool_streamon (pool)) {
2002             /* don't check return value because qbuf would have failed */
2003             gst_v4l2_is_buffer_valid (to_queue, &group);
2004
2005             /* qbuf has stored to_queue buffer but we are not in
2006              * streaming state, so the flush logic won't be performed.
2007              * To avoid leaks, flush the allocator and restore the queued
2008              * buffer as non-queued */
2009             gst_v4l2_allocator_flush (pool->vallocator);
2010
2011             pool->buffers[group->buffer.index] = NULL;
2012
2013             gst_mini_object_set_qdata (GST_MINI_OBJECT (to_queue),
2014                 GST_V4L2_IMPORT_QUARK, NULL, NULL);
2015             gst_buffer_unref (to_queue);
2016             g_atomic_int_add (&pool->num_queued, -1);
2017             goto start_failed;
2018           }
2019
2020           /* Remove our ref, we will still hold this buffer in acquire as needed,
2021            * otherwise the pool will think it is outstanding and will refuse to stop. */
2022           gst_buffer_unref (to_queue);
2023
2024           /* release as many buffer as possible */
2025           while (gst_v4l2_buffer_pool_dqbuf (pool, &buffer, FALSE) ==
2026               GST_FLOW_OK) {
2027             if (buffer->pool == NULL)
2028               gst_v4l2_buffer_pool_release_buffer (bpool, buffer);
2029           }
2030
2031           if (g_atomic_int_get (&pool->num_queued) >= pool->min_latency) {
2032             /* all buffers are queued, try to dequeue one and release it back
2033              * into the pool so that _acquire can get to it again. */
2034             ret = gst_v4l2_buffer_pool_dqbuf (pool, &buffer, TRUE);
2035             if (ret == GST_FLOW_OK && buffer->pool == NULL)
2036               /* release the rendered buffer back into the pool. This wakes up any
2037                * thread waiting for a buffer in _acquire(). */
2038               gst_v4l2_buffer_pool_release_buffer (bpool, buffer);
2039           }
2040           break;
2041         }
2042         default:
2043           g_assert_not_reached ();
2044           break;
2045       }
2046       break;
2047     default:
2048       g_assert_not_reached ();
2049       break;
2050   }
2051 done:
2052   return ret;
2053
2054   /* ERRORS */
2055 copy_failed:
2056   {
2057     GST_ERROR_OBJECT (pool, "failed to copy buffer");
2058     return ret;
2059   }
2060 buffer_truncated:
2061   {
2062     GST_WARNING_OBJECT (pool,
2063         "Dropping truncated buffer, this is likely a driver bug.");
2064     gst_buffer_unref (*buf);
2065     *buf = NULL;
2066     return GST_V4L2_FLOW_CORRUPTED_BUFFER;
2067   }
2068 eos:
2069   {
2070     GST_DEBUG_OBJECT (pool, "end of stream reached");
2071     gst_buffer_unref (*buf);
2072     *buf = NULL;
2073     return GST_V4L2_FLOW_LAST_BUFFER;
2074   }
2075 acquire_failed:
2076   {
2077     if (ret == GST_FLOW_FLUSHING)
2078       GST_DEBUG_OBJECT (pool, "flushing");
2079     else
2080       GST_WARNING_OBJECT (pool, "failed to acquire a buffer: %s",
2081           gst_flow_get_name (ret));
2082     return ret;
2083   }
2084 prepare_failed:
2085   {
2086     GST_ERROR_OBJECT (pool, "failed to prepare data");
2087     return ret;
2088   }
2089 queue_failed:
2090   {
2091     GST_ERROR_OBJECT (pool, "failed to queue buffer");
2092     return ret;
2093   }
2094 start_failed:
2095   {
2096     GST_ERROR_OBJECT (pool, "failed to start streaming");
2097     return GST_FLOW_ERROR;
2098   }
2099 }
2100
2101 void
2102 gst_v4l2_buffer_pool_set_other_pool (GstV4l2BufferPool * pool,
2103     GstBufferPool * other_pool)
2104 {
2105   g_return_if_fail (!gst_buffer_pool_is_active (GST_BUFFER_POOL (pool)));
2106
2107   if (pool->other_pool)
2108     gst_object_unref (pool->other_pool);
2109   pool->other_pool = gst_object_ref (other_pool);
2110 }
2111
2112 void
2113 gst_v4l2_buffer_pool_copy_at_threshold (GstV4l2BufferPool * pool, gboolean copy)
2114 {
2115   GST_OBJECT_LOCK (pool);
2116   pool->enable_copy_threshold = copy;
2117   GST_OBJECT_UNLOCK (pool);
2118 }
2119
2120 gboolean
2121 gst_v4l2_buffer_pool_flush (GstBufferPool * bpool)
2122 {
2123   GstV4l2BufferPool *pool = GST_V4L2_BUFFER_POOL (bpool);
2124   gboolean ret = TRUE;
2125
2126   gst_v4l2_buffer_pool_streamoff (pool);
2127
2128   if (!V4L2_TYPE_IS_OUTPUT (pool->obj->type))
2129     ret = gst_v4l2_buffer_pool_streamon (pool);
2130
2131   return ret;
2132 }