Changeset 5123 for pjproject/trunk/pjsip/include/pjsua2/media.hpp

Timestamp:

Jul 1, 2015 2:20:12 AM (9 years ago)

Author:

riza

Message:

Re #1863: Initial implementation of PJSUA2 Video Codec API and Video Device API.

• Codec management (enum codec, set prio, get param, set param)
• Device management (enum dev, dev count, dev info).

File:

• pjproject/trunk/pjsip/include/pjsua2/media.hpp (modified) (2 diffs)

pjproject/trunk/pjsip/include/pjsua2/media.hpp

@@ -90 +90 @@
 struct MediaFormatVideo : public MediaFormat
 {
-    unsigned            width;      /**< Video width.   */
-    unsigned            height;     /**< Video height.  */
+    unsigned            width;      /**< Video width.                   */
+    unsigned            height;     /**< Video height.                  */
     int                 fpsNum;     /**< Frames per second numerator.   */
     int                 fpsDenum;   /**< Frames per second denumerator. */
     pj_uint32_t         avgBps;     /**< Average bitrate.               */
     pj_uint32_t         maxBps;     /**< Maximum bitrate.               */
+
+    /**
+     * Construct from pjmedia_format.
+     */
+    void fromPj(const pjmedia_format &format);
+
+    /**
+     * Export to pjmedia_format.
+     */
+    pjmedia_format toPj() const;
 };
 
@@ -1588 +1598 @@
 };
 
+/**
+ * Video device information structure.
+ */
+struct VideoDevInfo
+{
+    /**
+     * The device name
+     */
+    string name;
+
+    /**
+     * The underlying driver name
+     */
+    string driver;
+
+    /**
+     * The supported direction of the video device, i.e. whether it supports
+     * capture only, render only, or both.
+     */
+    pjmedia_dir dir;
+
+    /** 
+     * Device capabilities, as bitmask combination of #pjmedia_vid_dev_cap 
+     */
+    unsigned caps;
+
+    /**
+     * Array of supported video formats. Some fields in each supported video
+     * format may be set to zero or of "unknown" value, to indicate that the
+     * value is unknown or should be ignored. When these value are not set
+     * to zero, it indicates that the exact format combination is being used.
+     */
+    MediaFormatVector fmt;
+
+    /**
+     * Construct from pjmedia_vid_dev_info.
+     */
+    void fromPj(const pjmedia_vid_dev_info &dev_info);
+
+    /**
+     * Destructor.
+     */
+    ~VideoDevInfo();
+};
+
+/** Array of video device info */
+typedef std::vector<VideoDevInfo*> VideoDevInfoVector;
+
+/**
+ * Video device manager.
+ */
+class VidDevManager {
+public:
+    /**
+     * Get the number of video devices installed in the system.
+     *
+     * @return          The number of devices.
+     */
+    unsigned getDevCount();
+
+    /**
+     * Retrieve the video device info for the specified device index.     
+     *
+     * @param dev_id    The video device id
+     * 
+     * @return          The list of video device info
+     */
+    VideoDevInfo getDevInfo(int dev_id) const throw(Error);
+
+    /**
+     * Enum all video devices installed in the system.
+     *
+     * @return          The list of video device info
+     */
+    const VideoDevInfoVector &enumDev() throw(Error);
+
+private:
+    VideoDevInfoVector videoDevList;
+
+    void clearVideoDevList();
+
+    /**
+     * Constructor.
+     */
+    VidDevManager();
+
+    /**
+     * Destructor.
+     */
+    ~VidDevManager();
+
+    friend class Endpoint;
+};
+
+
 /*************************************************************************
 * Codec management