Linux Video Capture: Add V4L2VideoCaptureDelegate{Single,Multi}Plane.

media/video/capture/video_capture_device.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 //
 // VideoCaptureDevice is the abstract base class for realizing video capture
 // device support in Chromium. It provides the interface for OS dependent
 // implementations.
 // The class is created and functions are invoked on a thread owned by
 // VideoCaptureManager. Capturing is done on other threads, depending on the OS
 // specific implementation.
@@ skipping 23 matching lines @@
   // VideoCaptureDevice::GetDeviceNames to do this for you and if you need to
   // cache your own copy of a name, you can do so via the copy constructor.
   // The reason for this is that a device name might contain platform specific
   // settings that are relevant only to the platform specific implementation of
   // VideoCaptureDevice::Create.
   class MEDIA_EXPORT Name {
    public:
     Name();
     Name(const std::string& name, const std::string& id);
 
-#if defined(OS_WIN)
+#if defined(OS_LINUX)
+    // Linux/CrOS targets Capture Api type: it can only be set on construction.
+    enum CaptureApiType {
+      V4L2_SINGLE_PLANE,
+      V4L2_MULTI_PLANE,
+      API_TYPE_UNKNOWN
+    };
+#elif defined(OS_WIN)
     // Windows targets Capture Api type: it can only be set on construction.
     enum CaptureApiType {
       MEDIA_FOUNDATION,
       DIRECT_SHOW,
       DIRECT_SHOW_WDM_CROSSBAR,
       API_TYPE_UNKNOWN
     };
-#endif
-#if defined(OS_MACOSX)
+#elif defined(OS_MACOSX)
     // Mac targets Capture Api type: it can only be set on construction.
     enum CaptureApiType {
       AVFOUNDATION,
       QTKIT,
       DECKLINK,
       API_TYPE_UNKNOWN
     };
     // For AVFoundation Api, identify devices that are built-in or USB.
     enum TransportType {
       USB_OR_BUILT_IN,
       OTHER_TRANSPORT
     };
 #endif
-#if defined(OS_WIN) || defined(OS_MACOSX)
+#if defined(OS_WIN) || defined(OS_MACOSX) || defined(OS_LINUX)
     Name(const std::string& name,
          const std::string& id,
          const CaptureApiType api_type);
 #endif
 #if defined(OS_MACOSX)
     Name(const std::string& name,
          const std::string& id,
          const CaptureApiType api_type,
          const TransportType transport_type);
 #endif
@@ skipping 17 matching lines @@
     // These operators are needed due to storing the name in an STL container.
     // In the shared build, all methods from the STL container will be exported
     // so even though they're not used, they're still depended upon.
     bool operator==(const Name& other) const {
       return other.id() == unique_id_;
     }
     bool operator<(const Name& other) const {
       return unique_id_ < other.id();
     }
 
-#if defined(OS_WIN) || defined(OS_MACOSX)
+#if defined(OS_WIN) || defined(OS_MACOSX) || defined(OS_LINUX)
     CaptureApiType capture_api_type() const {
       return capture_api_class_.capture_api_type();
     }
     const char* GetCaptureApiTypeString() const;
 #endif
 #if defined(OS_WIN)
     // Certain devices need an ID different from the |unique_id_| for
     // capabilities retrieval.
     const std::string& capabilities_id() const {
       return capabilities_id_;
@@ skipping 10 matching lines @@
       return is_blacklisted_;
     }
     void set_is_blacklisted(bool is_blacklisted) {
       is_blacklisted_ = is_blacklisted;
     }
 #endif  // if defined(OS_WIN)
 
    private:
     std::string device_name_;
     std::string unique_id_;
-#if defined(OS_WIN) || defined(OS_MACOSX)
+#if defined(OS_WIN) || defined(OS_MACOSX) || defined(OS_LINUX)
     // This class wraps the CaptureApiType to give it a by default value if not
     // initialized.
     class CaptureApiClass {
      public:
       CaptureApiClass(): capture_api_type_(API_TYPE_UNKNOWN) {}
       CaptureApiClass(const CaptureApiType api_type)
           : capture_api_type_(api_type) {}
       CaptureApiType capture_api_type() const {
         DCHECK_NE(capture_api_type_, API_TYPE_UNKNOWN);
         return capture_api_type_;
@@ skipping 41 matching lines @@
 
     // Captured a new video frame, data for which is pointed to by |data|.
     //
     // The format of the frame is described by |frame_format|, and is assumed to
     // be tightly packed. This method will try to reserve an output buffer and
     // copy from |data| into the output buffer. If no output buffer is
     // available, the frame will be silently dropped.
     virtual void OnIncomingCapturedData(const uint8* data,
                                         int length,
                                         const VideoCaptureFormat& frame_format,
-                                        int rotation,  // Clockwise.
+                                        int clockwise_rotation,
                                         const base::TimeTicks& timestamp) = 0;
 
+    // Captured a 3 planar YUV frame. Planes are possibly disjoint.
+    // |frame_format| must indicate I420.
+    virtual void OnIncomingCapturedYuvData(
+        const uint8* y_data,
+        const uint8* u_data,
+        const uint8* v_data,
+        size_t y_stride,
+        size_t u_stride,
+        size_t v_stride,
+        const VideoCaptureFormat& frame_format,
+        int clockwise_rotation,
+        const base::TimeTicks& timestamp) = 0;
+
     // Reserve an output buffer into which contents can be captured directly.
     // The returned Buffer will always be allocated with a memory size suitable
     // for holding a packed video frame with pixels of |format| format, of
     // |dimensions| frame dimensions. It is permissible for |dimensions| to be
     // zero; in which case the returned Buffer does not guarantee memory
     // backing, but functions as a reservation for external input for the
     // purposes of buffer throttling.
     //
     // The output buffer stays reserved for use until the Buffer object is
     // destroyed.
@@ skipping 45 matching lines @@
   int GetPowerLineFrequencyForLocation() const;
 
  protected:
   static const int kPowerLine50Hz = 50;
   static const int kPowerLine60Hz = 60;
 };
 
 }  // namespace media
 
 #endif  // MEDIA_VIDEO_CAPTURE_VIDEO_CAPTURE_DEVICE_H_