media/base/video_capture_types.h

   1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4
   5 #ifndef MEDIA_BASE_VIDEO_CAPTURE_TYPES_H_
   6 #define MEDIA_BASE_VIDEO_CAPTURE_TYPES_H_
   7
   8 #include <vector>
   9
  10 #include "media/base/media_export.h"
  11 #include "ui/gfx/geometry/size.h"
  12
  13 namespace media {
  14
  15 // TODO(wjia): this type should be defined in a common place and
  16 // shared with device manager.
  17 typedef int VideoCaptureSessionId;
  18
  19 // Color formats from camera. This list is sorted in order of preference.
  20 enum VideoPixelFormat {
  21   PIXEL_FORMAT_I420,
  22   PIXEL_FORMAT_YV12,
  23   PIXEL_FORMAT_NV12,
  24   PIXEL_FORMAT_NV21,
  25   PIXEL_FORMAT_UYVY,
  26   PIXEL_FORMAT_YUY2,
  27   PIXEL_FORMAT_RGB24,
  28   PIXEL_FORMAT_RGB32,
  29   PIXEL_FORMAT_ARGB,
  30   PIXEL_FORMAT_MJPEG,
  31   PIXEL_FORMAT_TEXTURE,  // Capture format as a GL texture.
  32   PIXEL_FORMAT_GPUMEMORYBUFFER,
  33   PIXEL_FORMAT_UNKNOWN,  // Color format not set.
  34   PIXEL_FORMAT_MAX,
  35 };
  36
  37 // Policies for capture devices that has source content with dynamic resolution.
  38 enum ResolutionChangePolicy {
  39   // Capture device outputs a fixed resolution all the time. The resolution of
  40   // the first frame is the resolution for all frames.
  41   // It is implementation specific for the capture device to scale, letter-box
  42   // and pillar-box. The only guarantee is that resolution will never change.
  43   RESOLUTION_POLICY_FIXED,
  44
  45   // Capture device outputs frames with dynamic resolution. The width and height
  46   // will not exceed the maximum dimensions specified. The typical scenario is
  47   // the frames will have the same aspect ratio as the original content and
  48   // scaled down to fit inside the limit.
  49   RESOLUTION_POLICY_DYNAMIC_WITHIN_LIMIT,
  50
  51   RESOLUTION_POLICY_LAST,
  52 };
  53
  54 // Some drivers use rational time per frame instead of float frame rate, this
  55 // constant k is used to convert between both: A fps -> [k/k*A] seconds/frame.
  56 const int kFrameRatePrecision = 10000;
  57
  58 // Video capture format specification.
  59 // This class is used by the video capture device to specify the format of every
  60 // frame captured and returned to a client. It is also used to specify a
  61 // supported capture format by a device.
  62 class MEDIA_EXPORT VideoCaptureFormat {
  63  public:
  64   VideoCaptureFormat();
  65   VideoCaptureFormat(const gfx::Size& frame_size,
  66                      float frame_rate,
  67                      VideoPixelFormat pixel_format);
  68
  69   std::string ToString() const;
  70   static std::string PixelFormatToString(VideoPixelFormat format);
  71
  72   // Returns the required buffer size to hold an image of a given
  73   // VideoCaptureFormat with no padding and tightly packed.
  74   size_t ImageAllocationSize() const;
  75
  76   // Checks that all values are in the expected range. All limits are specified
  77   // in media::Limits.
  78   bool IsValid() const;
  79
  80   gfx::Size frame_size;
  81   float frame_rate;
  82   VideoPixelFormat pixel_format;
  83 };
  84
  85 typedef std::vector<VideoCaptureFormat> VideoCaptureFormats;
  86
  87 // Parameters for starting video capture.
  88 // This class is used by the client of a video capture device to specify the
  89 // format of frames in which the client would like to have captured frames
  90 // returned.
  91 class MEDIA_EXPORT VideoCaptureParams {
  92  public:
  93   VideoCaptureParams();
  94
  95   // Requests a resolution and format at which the capture will occur.
  96   VideoCaptureFormat requested_format;
  97
  98   // Policy for resolution change.
  99   ResolutionChangePolicy resolution_change_policy;
 100 };
 101
 102 }  // namespace media
 103
 104 #endif  // MEDIA_BASE_VIDEO_CAPTURE_TYPES_H_