]> git.ipfire.org Git - thirdparty/freeswitch.git/commitdiff
FS-7500: add switch_core_video code
authorSeven Du <dujinfang@gmail.com>
Sun, 3 Aug 2014 19:13:24 +0000 (03:13 +0800)
committerMichael Jerris <mike@jerris.com>
Thu, 28 May 2015 17:46:42 +0000 (12:46 -0500)
src/include/switch_core_video.h [new file with mode: 0644]
src/switch_core_video.c [new file with mode: 0644]

diff --git a/src/include/switch_core_video.h b/src/include/switch_core_video.h
new file mode 100644 (file)
index 0000000..2534f3d
--- /dev/null
@@ -0,0 +1,237 @@
+/*
+ * FreeSWITCH Modular Media Switching Software Library / Soft-Switch Application
+ * Copyright (C) 2005-2014, Anthony Minessale II <anthm@freeswitch.org>
+ *
+ * Version: MPL 1.1
+ *
+ * The contents of this file are subject to the Mozilla Public License Version
+ * 1.1 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ * http://www.mozilla.org/MPL/
+ *
+ * Software distributed under the License is distributed on an "AS IS" basis,
+ * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+ * for the specific language governing rights and limitations under the
+ * License.
+ *
+ * The Original Code is FreeSWITCH Modular Media Switching Software Library / Soft-Switch Application
+ *
+ * The Initial Developer of the Original Code is
+ * Seven Du <dujinfang@gmail.com>
+ * Portions created by the Initial Developer are Copyright (C)
+ * the Initial Developer. All Rights Reserved.
+ *
+ * Contributor(s):
+ *
+ *
+ * switch_core_video.h -- Core Video header
+ *
+ */
+/*! \file switch_core_video.h
+       \brief video includes header
+
+       The things powered by libvpx are renamed into the switch_ namespace to provide a cleaner
+       look to things and helps me to document what parts of video I am using I'd like to take this
+       opportunity to thank libvpx for all the awesome stuff it does and for making my life much easier.
+
+*/
+#ifndef SWITCH_VIDEO_H
+#define SWITCH_VIDEO_H
+
+#include "vpx/vpx_image.h"
+#include "vpx/vpx_integer.h"
+
+SWITCH_BEGIN_EXTERN_C
+
+#define SWITCH_IMG_FMT_PLANAR    VPX_IMG_FMT_PLANAR
+#define SWITCH_IMG_FMT_UV_FLIP   VPX_IMG_FMT_UV_FLIP
+#define SWITCH_IMG_FMT_HAS_ALPHA VPX_IMG_FMT_HAS_ALPHA
+
+#ifndef VPX_IMG_FMT_HIGH         /* not available in libvpx 1.3.0 (see commit hash e97aea28) */
+#define VPX_IMG_FMT_HIGH         0x800  /**< Image uses 16bit framebuffer */
+#endif
+
+#define SWITCH_IMG_FMT_HIGH      VPX_IMG_FMT_HIGH
+
+/*!\brief List of supported image formats */
+typedef enum switch_img_fmt {
+       SWITCH_IMG_FMT_NONE,
+       SWITCH_IMG_FMT_RGB24,   /**< 24 bit per pixel packed RGB */
+       SWITCH_IMG_FMT_RGB32,   /**< 32 bit per pixel packed 0RGB */
+       SWITCH_IMG_FMT_RGB565,  /**< 16 bit per pixel, 565 */
+       SWITCH_IMG_FMT_RGB555,  /**< 16 bit per pixel, 555 */
+       SWITCH_IMG_FMT_UYVY,    /**< UYVY packed YUV */
+       SWITCH_IMG_FMT_YUY2,    /**< YUYV packed YUV */
+       SWITCH_IMG_FMT_YVYU,    /**< YVYU packed YUV */
+       SWITCH_IMG_FMT_BGR24,   /**< 24 bit per pixel packed BGR */
+       SWITCH_IMG_FMT_RGB32_LE, /**< 32 bit packed BGR0 */
+       SWITCH_IMG_FMT_ARGB,     /**< 32 bit packed ARGB, alpha=255 */
+       SWITCH_IMG_FMT_ARGB_LE,  /**< 32 bit packed BGRA, alpha=255 */
+       SWITCH_IMG_FMT_RGB565_LE,  /**< 16 bit per pixel, gggbbbbb rrrrrggg */
+       SWITCH_IMG_FMT_RGB555_LE,  /**< 16 bit per pixel, gggbbbbb 0rrrrrgg */
+       SWITCH_IMG_FMT_YV12    = SWITCH_IMG_FMT_PLANAR | SWITCH_IMG_FMT_UV_FLIP | 1, /**< planar YVU */
+       SWITCH_IMG_FMT_I420    = SWITCH_IMG_FMT_PLANAR | 2,
+       SWITCH_IMG_FMT_VPXYV12 = SWITCH_IMG_FMT_PLANAR | SWITCH_IMG_FMT_UV_FLIP | 3, /** < planar 4:2:0 format with vpx color space */
+       SWITCH_IMG_FMT_VPXI420 = SWITCH_IMG_FMT_PLANAR | 4,
+       SWITCH_IMG_FMT_I422    = SWITCH_IMG_FMT_PLANAR | 5,
+       SWITCH_IMG_FMT_I444    = SWITCH_IMG_FMT_PLANAR | 6,
+       SWITCH_IMG_FMT_444A    = SWITCH_IMG_FMT_PLANAR | SWITCH_IMG_FMT_HAS_ALPHA | 7,
+       SWITCH_IMG_FMT_I42016    = SWITCH_IMG_FMT_I420 | SWITCH_IMG_FMT_HIGH,
+       SWITCH_IMG_FMT_I42216    = SWITCH_IMG_FMT_I422 | SWITCH_IMG_FMT_HIGH,
+       SWITCH_IMG_FMT_I44416    = SWITCH_IMG_FMT_I444 | SWITCH_IMG_FMT_HIGH
+} switch_img_fmt_t; /**< alias for enum vpx_img_fmt */
+
+  /**\brief Image Descriptor */
+struct switch_image {
+       switch_img_fmt_t fmt; /**< Image Format */
+
+       /* Image storage dimensions */
+       unsigned int  w;           /**< Stored image width */
+       unsigned int  h;           /**< Stored image height */
+       unsigned int  bit_depth;   /**< Stored image bit-depth */
+
+       /* Image display dimensions */
+       unsigned int  d_w;   /**< Displayed image width */
+       unsigned int  d_h;   /**< Displayed image height */
+
+       /* Chroma subsampling info */
+       unsigned int  x_chroma_shift;   /**< subsampling order, X */
+       unsigned int  y_chroma_shift;   /**< subsampling order, Y */
+
+       /* Image data pointers. */
+#define SWITCH_PLANE_PACKED VPX_PLANE_PACKED
+#define SWITCH_PLANE_Y      VPX_PLANE_Y
+#define SWITCH_PLANE_U      VPX_PLANE_U
+#define SWITCH_PLANE_V      VPX_PLANE_V
+#define SWITCH_PLANE_ALPHA  VPX_PLANE_ALPHA
+
+       unsigned char *planes[4];  /**< pointer to the top left pixel for each plane */
+       int      stride[4];  /**< stride between rows for each plane */
+
+       int     bps; /**< bits per sample (for packed formats) */
+
+       /* The following member may be set by the application to associate data
+        * with this image.
+        */
+       void    *user_priv; /**< may be set by the application to associate data
+                                                *   with this image. */
+
+       /* The following members should be treated as private. */
+       unsigned char *img_data;       /**< private */
+       int      img_data_owner; /**< private */
+       int      self_allocd;    /**< private */
+
+       void    *fb_priv; /**< Frame buffer data associated with the image. */
+};
+
+/**\brief Representation of a rectangle on a surface */
+typedef struct switch_image_rect {
+       unsigned int x; /**< leftmost column */
+       unsigned int y; /**< topmost row */
+       unsigned int w; /**< width */
+       unsigned int h; /**< height */
+} switch_image_rect_t;
+
+/*!\brief Open a descriptor, allocating storage for the underlying image
+*
+* Returns a descriptor for storing an image of the given format. The
+* storage for the descriptor is allocated on the heap.
+*
+* \param[in]    img       Pointer to storage for descriptor. If this parameter
+*                         is NULL, the storage for the descriptor will be
+*                         allocated on the heap.
+* \param[in]    fmt       Format for the image
+* \param[in]    d_w       Width of the image
+* \param[in]    d_h       Height of the image
+* \param[in]    align     Alignment, in bytes, of the image buffer and
+*                         each row in the image(stride).
+*
+* \return Returns a pointer to the initialized image descriptor. If the img
+*         parameter is non-null, the value of the img parameter will be
+*         returned.
+*/
+SWITCH_DECLARE(switch_image_t *)switch_img_alloc(switch_image_t  *img,
+                                                switch_img_fmt_t fmt,
+                                                unsigned int d_w,
+                                                unsigned int d_h,
+                                                unsigned int align);
+
+/*!\brief Open a descriptor, using existing storage for the underlying image
+*
+* Returns a descriptor for storing an image of the given format. The
+* storage for descriptor has been allocated elsewhere, and a descriptor is
+* desired to "wrap" that storage.
+*
+* \param[in]    img       Pointer to storage for descriptor. If this parameter
+*                         is NULL, the storage for the descriptor will be
+*                         allocated on the heap.
+* \param[in]    fmt       Format for the image
+* \param[in]    d_w       Width of the image
+* \param[in]    d_h       Height of the image
+* \param[in]    align     Alignment, in bytes, of each row in the image.
+* \param[in]    img_data  Storage to use for the image
+*
+* \return Returns a pointer to the initialized image descriptor. If the img
+*         parameter is non-null, the value of the img parameter will be
+*         returned.
+*/
+SWITCH_DECLARE(switch_image_t *)switch_img_wrap(switch_image_t  *img,
+                                               switch_img_fmt_t fmt,
+                                               unsigned int d_w,
+                                               unsigned int d_h,
+                                               unsigned int align,
+                                               unsigned char      *img_data);
+
+
+/*!\brief Set the rectangle identifying the displayed portion of the image
+*
+* Updates the displayed rectangle (aka viewport) on the image surface to
+* match the specified coordinates and size.
+*
+* \param[in]    img       Image descriptor
+* \param[in]    x         leftmost column
+* \param[in]    y         topmost row
+* \param[in]    w         width
+* \param[in]    h         height
+*
+* \return 0 if the requested rectangle is valid, nonzero otherwise.
+*/
+SWITCH_DECLARE(int) switch_img_set_rect(switch_image_t  *img,
+                                  unsigned int  x,
+                                  unsigned int  y,
+                                  unsigned int  w,
+                                  unsigned int  h);
+
+
+/*!\brief Flip the image vertically (top for bottom)
+*
+* Adjusts the image descriptor's pointers and strides to make the image
+* be referenced upside-down.
+*
+* \param[in]    img       Image descriptor
+*/
+SWITCH_DECLARE(void) switch_img_flip(switch_image_t *img);
+
+/*!\brief Close an image descriptor
+*
+* Frees all allocated storage associated with an image descriptor.
+*
+* \param[in]    img       Image descriptor
+*/
+SWITCH_DECLARE(void) switch_img_free(switch_image_t *img);
+
+
+/** @} */
+
+SWITCH_END_EXTERN_C
+#endif
+/* For Emacs:
+ * Local Variables:
+ * mode:c
+ * indent-tabs-mode:t
+ * tab-width:4
+ * c-basic-offset:4
+ * End:
+ * For VIM:
+ * vim:set softtabstop=4 shiftwidth=4 tabstop=4 noet:
+ */
diff --git a/src/switch_core_video.c b/src/switch_core_video.c
new file mode 100644 (file)
index 0000000..885b24a
--- /dev/null
@@ -0,0 +1,81 @@
+/*
+ * FreeSWITCH Modular Media Switching Software Library / Soft-Switch Application
+ * Copyright (C) 2005-2014, Anthony Minessale II <anthm@freeswitch.org>
+ *
+ * Version: MPL 1.1
+ *
+ * The contents of this file are subject to the Mozilla Public License Version
+ * 1.1 (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ * http://www.mozilla.org/MPL/
+ *
+ * Software distributed under the License is distributed on an "AS IS" basis,
+ * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
+ * for the specific language governing rights and limitations under the
+ * License.
+ *
+ * The Original Code is FreeSWITCH Modular Media Switching Software Library / Soft-Switch Application
+ *
+ * The Initial Developer of the Original Code is
+ * Seven Du <dujinfang@gmail.com>
+ * Portions created by the Initial Developer are Copyright (C)
+ * the Initial Developer. All Rights Reserved.
+ *
+ * Contributor(s):
+ *
+ *
+ * switch_core_video.c -- Core Video
+ *
+ */
+
+#include <switch.h>
+
+
+SWITCH_DECLARE(switch_image_t *)switch_img_alloc(switch_image_t  *img,
+                                                switch_img_fmt_t fmt,
+                                                unsigned int d_w,
+                                                unsigned int d_h,
+                                                unsigned int align)
+{
+       return (switch_image_t *)vpx_img_alloc((vpx_image_t *)img, (vpx_img_fmt_t)fmt, d_w, d_h, align);
+}
+
+SWITCH_DECLARE(switch_image_t *)switch_img_wrap(switch_image_t  *img,
+                                               switch_img_fmt_t fmt,
+                                               unsigned int d_w,
+                                               unsigned int d_h,
+                                               unsigned int align,
+                                               unsigned char      *img_data)
+{
+       return (switch_image_t *)vpx_img_wrap((vpx_image_t *)img, (vpx_img_fmt_t)fmt, d_w, d_h, align, img_data);
+}
+
+SWITCH_DECLARE(int) switch_img_set_rect(switch_image_t  *img,
+                                  unsigned int  x,
+                                  unsigned int  y,
+                                  unsigned int  w,
+                                  unsigned int  h)
+{
+       return vpx_img_set_rect((vpx_image_t *)img, x, y, w, h);
+}
+
+SWITCH_DECLARE(void) switch_img_flip(switch_image_t *img)
+{
+       vpx_img_flip((vpx_image_t *)img);
+}
+
+SWITCH_DECLARE(void) switch_img_free(switch_image_t *img)
+{
+       vpx_img_free((vpx_image_t *)img);
+}
+
+/* For Emacs:
+ * Local Variables:
+ * mode:c
+ * indent-tabs-mode:t
+ * tab-width:4
+ * c-basic-offset:4
+ * End:
+ * For VIM:
+ * vim:set softtabstop=4 shiftwidth=4 tabstop=4 noet:
+ */