diff -r 000000000000 -r 0e761a78d257 gst_plugins_base/gst-libs/gst/video/video.c --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/gst_plugins_base/gst-libs/gst/video/video.c Thu Dec 17 08:53:32 2009 +0200 @@ -0,0 +1,1328 @@ +/* GStreamer + * Copyright (C) <1999> Erik Walthinsen + * Library <2002> Ronald Bultje + * Copyright (C) 2007 David A. Schleef + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Library General Public + * License as published by the Free Software Foundation; either + * version 2 of the License, or (at your option) any later version. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Library General Public License for more details. + * + * You should have received a copy of the GNU Library General Public + * License along with this library; if not, write to the + * Free Software Foundation, Inc., 59 Temple Place - Suite 330, + * Boston, MA 02111-1307, USA. + */ + +#ifdef HAVE_CONFIG_H +# include "config.h" +#endif + +#include "video.h" + +/** + * SECTION:gstvideo + * @short_description: Support library for video operations + * + * + * + * This library contains some helper functions and includes the + * videosink and videofilter base classes. + * + * + */ + +static GstVideoFormat gst_video_format_from_rgb32_masks (int red_mask, + int green_mask, int blue_mask); +static GstVideoFormat gst_video_format_from_rgba32_masks (int red_mask, + int green_mask, int blue_mask, int alpha_mask); +static GstVideoFormat gst_video_format_from_rgb24_masks (int red_mask, + int green_mask, int blue_mask); + + +/* This is simply a convenience function, nothing more or less */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +const GValue * +gst_video_frame_rate (GstPad * pad) +{ + const GValue *fps; + gchar *fps_string; + + const GstCaps *caps = NULL; + GstStructure *structure; + + /* get pad caps */ + caps = GST_PAD_CAPS (pad); + if (caps == NULL) { + g_warning ("gstvideo: failed to get caps of pad %s:%s", + GST_DEBUG_PAD_NAME (pad)); + return NULL; + } + + structure = gst_caps_get_structure (caps, 0); + if ((fps = gst_structure_get_value (structure, "framerate")) == NULL) { + g_warning ("gstvideo: failed to get framerate property of pad %s:%s", + GST_DEBUG_PAD_NAME (pad)); + return NULL; + } + if (!GST_VALUE_HOLDS_FRACTION (fps)) { + g_warning + ("gstvideo: framerate property of pad %s:%s is not of type Fraction", + GST_DEBUG_PAD_NAME (pad)); + return NULL; + } + + fps_string = gst_value_serialize (fps); + GST_DEBUG ("Framerate request on pad %s:%s: %s", + GST_DEBUG_PAD_NAME (pad), fps_string); + g_free (fps_string); + + return fps; +} +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + + +gboolean +gst_video_get_size (GstPad * pad, gint * width, gint * height) +{ + const GstCaps *caps = NULL; + GstStructure *structure; + gboolean ret; + + g_return_val_if_fail (pad != NULL, FALSE); + g_return_val_if_fail (width != NULL, FALSE); + g_return_val_if_fail (height != NULL, FALSE); + + caps = GST_PAD_CAPS (pad); + + if (caps == NULL) { + g_warning ("gstvideo: failed to get caps of pad %s:%s", + GST_DEBUG_PAD_NAME (pad)); + return FALSE; + } + + structure = gst_caps_get_structure (caps, 0); + ret = gst_structure_get_int (structure, "width", width); + ret &= gst_structure_get_int (structure, "height", height); + + if (!ret) { + g_warning ("gstvideo: failed to get size properties on pad %s:%s", + GST_DEBUG_PAD_NAME (pad)); + return FALSE; + } + + GST_DEBUG ("size request on pad %s:%s: %dx%d", + GST_DEBUG_PAD_NAME (pad), width ? *width : -1, height ? *height : -1); + + return TRUE; +} + +/** + * gst_video_calculate_display_ratio: + * @dar_n: Numerator of the calculated display_ratio + * @dar_d: Denominator of the calculated display_ratio + * @video_width: Width of the video frame in pixels + * @video_height: Height of the video frame in pixels + * @video_par_n: Numerator of the pixel aspect ratio of the input video. + * @video_par_d: Denominator of the pixel aspect ratio of the input video. + * @display_par_n: Numerator of the pixel aspect ratio of the display device + * @display_par_d: Denominator of the pixel aspect ratio of the display device + * + * Given the Pixel Aspect Ratio and size of an input video frame, and the + * pixel aspect ratio of the intended display device, calculates the actual + * display ratio the video will be rendered with. + * + * Returns: A boolean indicating success and a calculated Display Ratio in the + * dar_n and dar_d parameters. + * The return value is FALSE in the case of integer overflow or other error. + * + * Since: 0.10.7 + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +gboolean +gst_video_calculate_display_ratio (guint * dar_n, guint * dar_d, + guint video_width, guint video_height, + guint video_par_n, guint video_par_d, + guint display_par_n, guint display_par_d) +{ + gint num, den; + + GValue display_ratio = { 0, }; + GValue tmp = { 0, }; + GValue tmp2 = { 0, }; + + g_return_val_if_fail (dar_n != NULL, FALSE); + g_return_val_if_fail (dar_d != NULL, FALSE); + + g_value_init (&display_ratio, GST_TYPE_FRACTION); + g_value_init (&tmp, GST_TYPE_FRACTION); + g_value_init (&tmp2, GST_TYPE_FRACTION); + + /* Calculate (video_width * video_par_n * display_par_d) / + * (video_height * video_par_d * display_par_n) */ + gst_value_set_fraction (&display_ratio, video_width, video_height); + gst_value_set_fraction (&tmp, video_par_n, video_par_d); + + if (!gst_value_fraction_multiply (&tmp2, &display_ratio, &tmp)) + goto error_overflow; + + gst_value_set_fraction (&tmp, display_par_d, display_par_n); + + if (!gst_value_fraction_multiply (&display_ratio, &tmp2, &tmp)) + goto error_overflow; + + num = gst_value_get_fraction_numerator (&display_ratio); + den = gst_value_get_fraction_denominator (&display_ratio); + + g_value_unset (&display_ratio); + g_value_unset (&tmp); + g_value_unset (&tmp2); + + g_return_val_if_fail (num > 0, FALSE); + g_return_val_if_fail (den > 0, FALSE); + + *dar_n = num; + *dar_d = den; + + return TRUE; +error_overflow: + g_value_unset (&display_ratio); + g_value_unset (&tmp); + g_value_unset (&tmp2); + return FALSE; +} + +/** + * gst_video_format_parse_caps: + * @caps: the #GstCaps to parse + * @format: the #GstVideoFormat of the video represented by @caps (output) + * @width: the width of the video represented by @caps (output) + * @height: the height of the video represented by @caps (output) + * + * Determines the #GstVideoFormat of @caps and places it in the location + * pointed to by @format. Extracts the size of the video and places it + * in the location pointed to by @width and @height. If @caps does not + * represent one of the raw video formats listed in #GstVideoFormat, the + * function will fail and return FALSE. + * + * Since: 0.10.16 + * + * Returns: TRUE if @caps was parsed correctly. + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +gboolean +gst_video_format_parse_caps (GstCaps * caps, GstVideoFormat * format, + int *width, int *height) +{ + GstStructure *structure; + gboolean ok = TRUE; + + if (!gst_caps_is_fixed (caps)) + return FALSE; + + structure = gst_caps_get_structure (caps, 0); + + if (format) { + if (gst_structure_has_name (structure, "video/x-raw-yuv")) { + guint32 fourcc; + + ok &= gst_structure_get_fourcc (structure, "format", &fourcc); + + *format = gst_video_format_from_fourcc (fourcc); + if (*format == GST_VIDEO_FORMAT_UNKNOWN) { + ok = FALSE; + } + } else if (gst_structure_has_name (structure, "video/x-raw-rgb")) { + int depth; + int bpp; + int endianness; + int red_mask; + int green_mask; + int blue_mask; + int alpha_mask; + gboolean have_alpha; + + ok &= gst_structure_get_int (structure, "depth", &depth); + ok &= gst_structure_get_int (structure, "bpp", &bpp); + ok &= gst_structure_get_int (structure, "endianness", &endianness); + ok &= gst_structure_get_int (structure, "red_mask", &red_mask); + ok &= gst_structure_get_int (structure, "green_mask", &green_mask); + ok &= gst_structure_get_int (structure, "blue_mask", &blue_mask); + have_alpha = gst_structure_get_int (structure, "alpha_mask", &alpha_mask); + + if (depth == 24 && bpp == 32 && endianness == G_BIG_ENDIAN) { + *format = gst_video_format_from_rgb32_masks (red_mask, green_mask, + blue_mask); + if (*format == GST_VIDEO_FORMAT_UNKNOWN) { + ok = FALSE; + } + } else if (depth == 32 && bpp == 32 && endianness == G_BIG_ENDIAN && + have_alpha) { + *format = gst_video_format_from_rgba32_masks (red_mask, green_mask, + blue_mask, alpha_mask); + if (*format == GST_VIDEO_FORMAT_UNKNOWN) { + ok = FALSE; + } + } else if (depth == 24 && bpp == 24 && endianness == G_BIG_ENDIAN) { + *format = gst_video_format_from_rgb24_masks (red_mask, green_mask, + blue_mask); + if (*format == GST_VIDEO_FORMAT_UNKNOWN) { + ok = FALSE; + } + } else { + ok = FALSE; + } + } else { + ok = FALSE; + } + } + + if (width) { + ok &= gst_structure_get_int (structure, "width", width); + } + + if (height) { + ok &= gst_structure_get_int (structure, "height", height); + } + + return ok; +} + +/** + * gst_video_parse_caps_framerate: + * @caps: + * @fps_n: pointer to numerator of frame rate (output) + * @fps_d: pointer to denominator of frame rate (output) + * + * Extracts the frame rate from @caps and places the values in the locations + * pointed to by @fps_n and @fps_d. Returns TRUE if the values could be + * parsed correctly, FALSE if not. + * + * This function can be used with #GstCaps that have any media type; it + * is not limited to formats handled by #GstVideoFormat. + * + * Since: 0.10.16 + * + * Returns: TRUE if @caps was parsed correctly. + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +gboolean +gst_video_parse_caps_framerate (GstCaps * caps, int *fps_n, int *fps_d) +{ + GstStructure *structure; + + if (!gst_caps_is_fixed (caps)) + return FALSE; + + structure = gst_caps_get_structure (caps, 0); + + return gst_structure_get_fraction (structure, "framerate", fps_n, fps_d); +} + +/** + * gst_video_parse_caps_pixel_aspect_ratio: + * @caps: + * @par_n: pointer to numerator of pixel aspect ratio (output) + * @par_d: pointer to denominator of pixel aspect ratio (output) + * + * Extracts the pixel aspect ratio from @caps and places the values in + * the locations pointed to by @par_n and @par_d. Returns TRUE if the + * values could be parsed correctly, FALSE if not. + * + * This function can be used with #GstCaps that have any media type; it + * is not limited to formats handled by #GstVideoFormat. + * + * Since: 0.10.16 + * + * Returns: TRUE if @caps was parsed correctly. + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +gboolean +gst_video_parse_caps_pixel_aspect_ratio (GstCaps * caps, int *par_n, int *par_d) +{ + GstStructure *structure; + + if (!gst_caps_is_fixed (caps)) + return FALSE; + + structure = gst_caps_get_structure (caps, 0); + + if (!gst_structure_get_fraction (structure, "pixel-aspect-ratio", + par_n, par_d)) { + *par_n = 1; + *par_d = 1; + } + return TRUE; +} + +/** + * gst_video_format_new_caps: + * @format: the #GstVideoFormat describing the raw video format + * @width: width of video + * @height: height of video + * @framerate_n: numerator of frame rate + * @framerate_d: denominator of frame rate + * @par_n: numerator of pixel aspect ratio + * @par_d: denominator of pixel aspect ratio + * + * Creates a new #GstCaps object based on the parameters provided. + * + * Since: 0.10.16 + * + * Returns: a new #GstCaps object, or NULL if there was an error + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +GstCaps * +gst_video_format_new_caps (GstVideoFormat format, int width, int height, + int framerate_n, int framerate_d, int par_n, int par_d) +{ + if (gst_video_format_is_yuv (format)) { + return gst_caps_new_simple ("video/x-raw-yuv", + "format", GST_TYPE_FOURCC, gst_video_format_to_fourcc (format), + "width", G_TYPE_INT, width, + "height", G_TYPE_INT, height, + "framerate", GST_TYPE_FRACTION, framerate_n, framerate_d, + "pixel-aspect-ratio", GST_TYPE_FRACTION, par_n, par_d, NULL); + } + if (gst_video_format_is_rgb (format)) { + GstCaps *caps; + int red_mask; + int blue_mask; + int green_mask; + int alpha_mask; + int depth; + int bpp; + gboolean have_alpha; + unsigned int mask; + + switch (format) { + case GST_VIDEO_FORMAT_RGBx: + case GST_VIDEO_FORMAT_BGRx: + case GST_VIDEO_FORMAT_xRGB: + case GST_VIDEO_FORMAT_xBGR: + bpp = 32; + depth = 24; + have_alpha = FALSE; + break; + case GST_VIDEO_FORMAT_RGBA: + case GST_VIDEO_FORMAT_BGRA: + case GST_VIDEO_FORMAT_ARGB: + case GST_VIDEO_FORMAT_ABGR: + bpp = 32; + depth = 32; + have_alpha = TRUE; + break; + case GST_VIDEO_FORMAT_RGB: + case GST_VIDEO_FORMAT_BGR: + bpp = 24; + depth = 24; + have_alpha = FALSE; + break; + default: + return NULL; + } + if (bpp == 32) { + mask = 0xff000000; + } else { + mask = 0xff0000; + } + red_mask = + mask >> (8 * gst_video_format_get_component_offset (format, 0, width, + height)); + green_mask = + mask >> (8 * gst_video_format_get_component_offset (format, 1, width, + height)); + blue_mask = + mask >> (8 * gst_video_format_get_component_offset (format, 2, width, + height)); + + caps = gst_caps_new_simple ("video/x-raw-rgb", + "bpp", G_TYPE_INT, bpp, + "depth", G_TYPE_INT, depth, + "endianness", G_TYPE_INT, G_BIG_ENDIAN, + "red_mask", G_TYPE_INT, red_mask, + "green_mask", G_TYPE_INT, green_mask, + "blue_mask", G_TYPE_INT, blue_mask, + "width", G_TYPE_INT, width, + "height", G_TYPE_INT, height, + "framerate", GST_TYPE_FRACTION, framerate_n, framerate_d, + "pixel-aspect-ratio", GST_TYPE_FRACTION, par_n, par_d, NULL); + if (have_alpha) { + alpha_mask = + mask >> (8 * gst_video_format_get_component_offset (format, 3, width, + height)); + gst_caps_set_simple (caps, "alpha_mask", G_TYPE_INT, alpha_mask, NULL); + } + return caps; + } + return NULL; +} + +/** + * gst_video_format_from_fourcc: + * @fourcc: a FOURCC value representing raw YUV video + * + * Converts a FOURCC value into the corresponding #GstVideoFormat. + * If the FOURCC cannot be represented by #GstVideoFormat, + * #GST_VIDEO_FORMAT_UNKNOWN is returned. + * + * Since: 0.10.16 + * + * Returns: the #GstVideoFormat describing the FOURCC value + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +GstVideoFormat +gst_video_format_from_fourcc (guint32 fourcc) +{ + switch (fourcc) { + case GST_MAKE_FOURCC ('I', '4', '2', '0'): + return GST_VIDEO_FORMAT_I420; + case GST_MAKE_FOURCC ('Y', 'V', '1', '2'): + return GST_VIDEO_FORMAT_YV12; + case GST_MAKE_FOURCC ('Y', 'U', 'Y', '2'): + return GST_VIDEO_FORMAT_YUY2; + case GST_MAKE_FOURCC ('U', 'Y', 'V', 'Y'): + return GST_VIDEO_FORMAT_UYVY; + case GST_MAKE_FOURCC ('A', 'Y', 'U', 'V'): + return GST_VIDEO_FORMAT_AYUV; + case GST_MAKE_FOURCC ('Y', '4', '1', 'B'): + return GST_VIDEO_FORMAT_Y41B; + case GST_MAKE_FOURCC ('Y', '4', '2', 'B'): + return GST_VIDEO_FORMAT_Y42B; + default: + return GST_VIDEO_FORMAT_UNKNOWN; + } +} + +/** + * gst_video_format_to_fourcc: + * @format: a #GstVideoFormat video format + * + * Converts a #GstVideoFormat value into the corresponding FOURCC. Only + * a few YUV formats have corresponding FOURCC values. If @format has + * no corresponding FOURCC value, 0 is returned. + * + * Since: 0.10.16 + * + * Returns: the FOURCC corresponding to @format + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +guint32 +gst_video_format_to_fourcc (GstVideoFormat format) +{ + switch (format) { + case GST_VIDEO_FORMAT_I420: + return GST_MAKE_FOURCC ('I', '4', '2', '0'); + case GST_VIDEO_FORMAT_YV12: + return GST_MAKE_FOURCC ('Y', 'V', '1', '2'); + case GST_VIDEO_FORMAT_YUY2: + return GST_MAKE_FOURCC ('Y', 'U', 'Y', '2'); + case GST_VIDEO_FORMAT_UYVY: + return GST_MAKE_FOURCC ('U', 'Y', 'V', 'Y'); + case GST_VIDEO_FORMAT_AYUV: + return GST_MAKE_FOURCC ('A', 'Y', 'U', 'V'); + case GST_VIDEO_FORMAT_Y41B: + return GST_MAKE_FOURCC ('Y', '4', '1', 'B'); + case GST_VIDEO_FORMAT_Y42B: + return GST_MAKE_FOURCC ('Y', '4', '2', 'B'); + default: + return 0; + } +} + +/** + * gst_video_format_from_rgb32_masks: + * @red_mask: red bit mask + * @green_mask: green bit mask + * @blue_mask: blue bit mask + * + * Converts red, green, blue bit masks into the corresponding + * #GstVideoFormat. + * + * Since: 0.10.16 + * + * Returns: the #GstVideoFormat corresponding to the bit masks + */ +static GstVideoFormat +gst_video_format_from_rgb32_masks (int red_mask, int green_mask, int blue_mask) +{ + if (red_mask == 0xff000000 && green_mask == 0x00ff0000 && + blue_mask == 0x0000ff00) { + return GST_VIDEO_FORMAT_RGBx; + } + if (red_mask == 0x0000ff00 && green_mask == 0x00ff0000 && + blue_mask == 0xff000000) { + return GST_VIDEO_FORMAT_BGRx; + } + if (red_mask == 0x00ff0000 && green_mask == 0x0000ff00 && + blue_mask == 0x000000ff) { + return GST_VIDEO_FORMAT_xRGB; + } + if (red_mask == 0x000000ff && green_mask == 0x0000ff00 && + blue_mask == 0x00ff0000) { + return GST_VIDEO_FORMAT_xBGR; + } + + return GST_VIDEO_FORMAT_UNKNOWN; +} + +static GstVideoFormat +gst_video_format_from_rgba32_masks (int red_mask, int green_mask, int blue_mask, + int alpha_mask) +{ + if (red_mask == 0xff000000 && green_mask == 0x00ff0000 && + blue_mask == 0x0000ff00 && alpha_mask == 0x000000ff) { + return GST_VIDEO_FORMAT_RGBA; + } + if (red_mask == 0x0000ff00 && green_mask == 0x00ff0000 && + blue_mask == 0xff000000 && alpha_mask == 0x000000ff) { + return GST_VIDEO_FORMAT_BGRA; + } + if (red_mask == 0x00ff0000 && green_mask == 0x0000ff00 && + blue_mask == 0x000000ff && alpha_mask == 0xff000000) { + return GST_VIDEO_FORMAT_ARGB; + } + if (red_mask == 0x000000ff && green_mask == 0x0000ff00 && + blue_mask == 0x00ff0000 && alpha_mask == 0xff000000) { + return GST_VIDEO_FORMAT_ABGR; + } + + return GST_VIDEO_FORMAT_UNKNOWN; +} + +static GstVideoFormat +gst_video_format_from_rgb24_masks (int red_mask, int green_mask, int blue_mask) +{ + if (red_mask == 0xff0000 && green_mask == 0x00ff00 && blue_mask == 0x0000ff) { + return GST_VIDEO_FORMAT_RGB; + } + if (red_mask == 0x0000ff && green_mask == 0x00ff00 && blue_mask == 0xff0000) { + return GST_VIDEO_FORMAT_BGR; + } + + return GST_VIDEO_FORMAT_UNKNOWN; +} + +/** + * gst_video_format_is_rgb: + * @format: a #GstVideoFormat + * + * Since: 0.10.16 + * + * Returns: TRUE if @format represents RGB video + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +gboolean +gst_video_format_is_rgb (GstVideoFormat format) +{ + switch (format) { + case GST_VIDEO_FORMAT_I420: + case GST_VIDEO_FORMAT_YV12: + case GST_VIDEO_FORMAT_YUY2: + case GST_VIDEO_FORMAT_UYVY: + case GST_VIDEO_FORMAT_AYUV: + case GST_VIDEO_FORMAT_Y41B: + case GST_VIDEO_FORMAT_Y42B: + return FALSE; + case GST_VIDEO_FORMAT_RGBx: + case GST_VIDEO_FORMAT_BGRx: + case GST_VIDEO_FORMAT_xRGB: + case GST_VIDEO_FORMAT_xBGR: + case GST_VIDEO_FORMAT_RGBA: + case GST_VIDEO_FORMAT_BGRA: + case GST_VIDEO_FORMAT_ARGB: + case GST_VIDEO_FORMAT_ABGR: + case GST_VIDEO_FORMAT_RGB: + case GST_VIDEO_FORMAT_BGR: + return TRUE; + default: + return FALSE; + } +} + +/** + * gst_video_format_is_yuv: + * @format: a #GstVideoFormat + * + * Since: 0.10.16 + * + * Returns: TRUE if @format represents YUV video + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +gboolean +gst_video_format_is_yuv (GstVideoFormat format) +{ + switch (format) { + case GST_VIDEO_FORMAT_I420: + case GST_VIDEO_FORMAT_YV12: + case GST_VIDEO_FORMAT_YUY2: + case GST_VIDEO_FORMAT_UYVY: + case GST_VIDEO_FORMAT_AYUV: + case GST_VIDEO_FORMAT_Y41B: + case GST_VIDEO_FORMAT_Y42B: + return TRUE; + case GST_VIDEO_FORMAT_RGBx: + case GST_VIDEO_FORMAT_BGRx: + case GST_VIDEO_FORMAT_xRGB: + case GST_VIDEO_FORMAT_xBGR: + case GST_VIDEO_FORMAT_RGBA: + case GST_VIDEO_FORMAT_BGRA: + case GST_VIDEO_FORMAT_ARGB: + case GST_VIDEO_FORMAT_ABGR: + case GST_VIDEO_FORMAT_RGB: + case GST_VIDEO_FORMAT_BGR: + return FALSE; + default: + return FALSE; + } +} + +/** + * gst_video_format_has_alpha: + * @format: a #GstVideoFormat + * + * Since: 0.10.16 + * + * Returns: TRUE if @format has an alpha channel + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +gboolean +gst_video_format_has_alpha (GstVideoFormat format) +{ + switch (format) { + case GST_VIDEO_FORMAT_I420: + case GST_VIDEO_FORMAT_YV12: + case GST_VIDEO_FORMAT_YUY2: + case GST_VIDEO_FORMAT_UYVY: + case GST_VIDEO_FORMAT_Y41B: + case GST_VIDEO_FORMAT_Y42B: + return FALSE; + case GST_VIDEO_FORMAT_AYUV: + case GST_VIDEO_FORMAT_RGBA: + case GST_VIDEO_FORMAT_BGRA: + case GST_VIDEO_FORMAT_ARGB: + case GST_VIDEO_FORMAT_ABGR: + return TRUE; + case GST_VIDEO_FORMAT_RGBx: + case GST_VIDEO_FORMAT_BGRx: + case GST_VIDEO_FORMAT_xRGB: + case GST_VIDEO_FORMAT_xBGR: + case GST_VIDEO_FORMAT_RGB: + case GST_VIDEO_FORMAT_BGR: + return FALSE; + default: + return FALSE; + } +} + +/** + * gst_video_format_get_row_stride: + * @format: a #GstVideoFormat + * @component: the component index + * @width: the width of video + * + * Calculates the row stride (number of bytes from one row of pixels to + * the next) for the video component with an index of @component. For + * YUV video, Y, U, and V have component indices of 0, 1, and 2, + * respectively. For RGB video, R, G, and B have component indicies of + * 0, 1, and 2, respectively. Alpha channels, if present, have a component + * index of 3. The @width parameter always represents the width of the + * video, not the component. + * + * Since: 0.10.16 + * + * Returns: row stride of component @component + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +int +gst_video_format_get_row_stride (GstVideoFormat format, int component, + int width) +{ + switch (format) { + case GST_VIDEO_FORMAT_I420: + case GST_VIDEO_FORMAT_YV12: + if (component == 0) { + return GST_ROUND_UP_4 (width); + } else { + return GST_ROUND_UP_4 (GST_ROUND_UP_2 (width) / 2); + } + case GST_VIDEO_FORMAT_YUY2: + case GST_VIDEO_FORMAT_UYVY: + return GST_ROUND_UP_4 (width * 2); + case GST_VIDEO_FORMAT_AYUV: + case GST_VIDEO_FORMAT_RGBx: + case GST_VIDEO_FORMAT_BGRx: + case GST_VIDEO_FORMAT_xRGB: + case GST_VIDEO_FORMAT_xBGR: + case GST_VIDEO_FORMAT_RGBA: + case GST_VIDEO_FORMAT_BGRA: + case GST_VIDEO_FORMAT_ARGB: + case GST_VIDEO_FORMAT_ABGR: + return width * 4; + case GST_VIDEO_FORMAT_RGB: + case GST_VIDEO_FORMAT_BGR: + return GST_ROUND_UP_4 (width * 3); + case GST_VIDEO_FORMAT_Y41B: + if (component == 0) { + return GST_ROUND_UP_4 (width); + } else { + return GST_ROUND_UP_8 (width) / 4; + } + case GST_VIDEO_FORMAT_Y42B: + if (component == 0) { + return GST_ROUND_UP_4 (width); + } else { + return GST_ROUND_UP_8 (width) / 2; + } + default: + return 0; + } +} + +/** + * gst_video_format_get_pixel_stride: + * @format: a #GstVideoFormat + * @component: the component index + * + * Calculates the pixel stride (number of bytes from one pixel to the + * pixel to its immediate left) for the video component with an index + * of @component. See @gst_video_format_get_row_stride for a description + * of the component index. + * + * Since: 0.10.16 + * + * Returns: pixel stride of component @component + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +int +gst_video_format_get_pixel_stride (GstVideoFormat format, int component) +{ + switch (format) { + case GST_VIDEO_FORMAT_I420: + case GST_VIDEO_FORMAT_YV12: + case GST_VIDEO_FORMAT_Y41B: + case GST_VIDEO_FORMAT_Y42B: + return 1; + case GST_VIDEO_FORMAT_YUY2: + case GST_VIDEO_FORMAT_UYVY: + if (component == 0) { + return 2; + } else { + return 4; + } + case GST_VIDEO_FORMAT_AYUV: + case GST_VIDEO_FORMAT_RGBx: + case GST_VIDEO_FORMAT_BGRx: + case GST_VIDEO_FORMAT_xRGB: + case GST_VIDEO_FORMAT_xBGR: + case GST_VIDEO_FORMAT_RGBA: + case GST_VIDEO_FORMAT_BGRA: + case GST_VIDEO_FORMAT_ARGB: + case GST_VIDEO_FORMAT_ABGR: + return 4; + case GST_VIDEO_FORMAT_RGB: + case GST_VIDEO_FORMAT_BGR: + return 3; + default: + return 0; + } +} + +/** + * gst_video_format_get_component_width: + * @format: a #GstVideoFormat + * @component: the component index + * @width: the width of video + * + * Calculates the width of the component. See + * @gst_video_format_get_row_stride for a description + * of the component index. + * + * Since: 0.10.16 + * + * Returns: width of component @component + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +int +gst_video_format_get_component_width (GstVideoFormat format, int component, + int width) +{ + switch (format) { + case GST_VIDEO_FORMAT_I420: + case GST_VIDEO_FORMAT_YV12: + case GST_VIDEO_FORMAT_YUY2: + case GST_VIDEO_FORMAT_UYVY: + if (component == 0) { + return width; + } else { + return GST_ROUND_UP_2 (width) / 2; + } + case GST_VIDEO_FORMAT_Y41B: /* CHECKME: component_width for Y41B */ + if (component == 0) { + return width; + } else { + return GST_ROUND_UP_8 (width) / 4; + } + case GST_VIDEO_FORMAT_Y42B: /* CHECKME: component_width for Y42B */ + if (component == 0) { + return width; + } else { + return GST_ROUND_UP_8 (width) / 2; + } + case GST_VIDEO_FORMAT_AYUV: + case GST_VIDEO_FORMAT_RGBx: + case GST_VIDEO_FORMAT_BGRx: + case GST_VIDEO_FORMAT_xRGB: + case GST_VIDEO_FORMAT_xBGR: + case GST_VIDEO_FORMAT_RGBA: + case GST_VIDEO_FORMAT_BGRA: + case GST_VIDEO_FORMAT_ARGB: + case GST_VIDEO_FORMAT_ABGR: + case GST_VIDEO_FORMAT_RGB: + case GST_VIDEO_FORMAT_BGR: + return width; + default: + return 0; + } +} + +/** + * gst_video_format_get_component_height: + * @format: a #GstVideoFormat + * @component: the component index + * @height: the height of video + * + * Calculates the height of the component. See + * @gst_video_format_get_row_stride for a description + * of the component index. + * + * Since: 0.10.16 + * + * Returns: height of component @component + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +int +gst_video_format_get_component_height (GstVideoFormat format, int component, + int height) +{ + switch (format) { + case GST_VIDEO_FORMAT_I420: + case GST_VIDEO_FORMAT_YV12: + if (component == 0) { + return height; + } else { + return GST_ROUND_UP_2 (height) / 2; + } + case GST_VIDEO_FORMAT_Y41B: + case GST_VIDEO_FORMAT_Y42B: + case GST_VIDEO_FORMAT_YUY2: + case GST_VIDEO_FORMAT_UYVY: + case GST_VIDEO_FORMAT_AYUV: + case GST_VIDEO_FORMAT_RGBx: + case GST_VIDEO_FORMAT_BGRx: + case GST_VIDEO_FORMAT_xRGB: + case GST_VIDEO_FORMAT_xBGR: + case GST_VIDEO_FORMAT_RGBA: + case GST_VIDEO_FORMAT_BGRA: + case GST_VIDEO_FORMAT_ARGB: + case GST_VIDEO_FORMAT_ABGR: + case GST_VIDEO_FORMAT_RGB: + case GST_VIDEO_FORMAT_BGR: + return height; + default: + return 0; + } +} + +/** + * gst_video_format_get_component_offset: + * @format: a #GstVideoFormat + * @component: the component index + * @width: the width of video + * @height: the height of video + * + * Calculates the offset (in bytes) of the first pixel of the component + * with index @component. For packed formats, this will typically be a + * small integer (0, 1, 2, 3). For planar formats, this will be a + * (relatively) large offset to the beginning of the second or third + * component planes. See @gst_video_format_get_row_stride for a description + * of the component index. + * + * Since: 0.10.16 + * + * Returns: offset of component @component + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +int +gst_video_format_get_component_offset (GstVideoFormat format, int component, + int width, int height) +{ + switch (format) { + case GST_VIDEO_FORMAT_I420: + if (component == 0) + return 0; + if (component == 1) + return GST_ROUND_UP_4 (width) * GST_ROUND_UP_2 (height); + if (component == 2) { + return GST_ROUND_UP_4 (width) * GST_ROUND_UP_2 (height) + + GST_ROUND_UP_4 (GST_ROUND_UP_2 (width) / 2) * + (GST_ROUND_UP_2 (height) / 2); + } + return 0; + case GST_VIDEO_FORMAT_YV12: /* same as I420, but components 1+2 swapped */ + if (component == 0) + return 0; + if (component == 2) + return GST_ROUND_UP_4 (width) * GST_ROUND_UP_2 (height); + if (component == 1) { + return GST_ROUND_UP_4 (width) * GST_ROUND_UP_2 (height) + + GST_ROUND_UP_4 (GST_ROUND_UP_2 (width) / 2) * + (GST_ROUND_UP_2 (height) / 2); + } + return 0; + case GST_VIDEO_FORMAT_YUY2: + if (component == 0) + return 0; + if (component == 1) + return 1; + if (component == 2) + return 3; + return 0; + case GST_VIDEO_FORMAT_UYVY: + if (component == 0) + return 1; + if (component == 1) + return 0; + if (component == 2) + return 2; + return 0; + case GST_VIDEO_FORMAT_AYUV: + if (component == 0) + return 1; + if (component == 1) + return 2; + if (component == 2) + return 3; + if (component == 3) + return 0; + return 0; + case GST_VIDEO_FORMAT_RGBx: + case GST_VIDEO_FORMAT_RGBA: + if (component == 0) + return 0; + if (component == 1) + return 1; + if (component == 2) + return 2; + if (component == 3) + return 3; + return 0; + case GST_VIDEO_FORMAT_BGRx: + case GST_VIDEO_FORMAT_BGRA: + if (component == 0) + return 2; + if (component == 1) + return 1; + if (component == 2) + return 0; + if (component == 3) + return 3; + return 0; + case GST_VIDEO_FORMAT_xRGB: + case GST_VIDEO_FORMAT_ARGB: + if (component == 0) + return 1; + if (component == 1) + return 2; + if (component == 2) + return 3; + if (component == 3) + return 0; + return 0; + case GST_VIDEO_FORMAT_xBGR: + case GST_VIDEO_FORMAT_ABGR: + if (component == 0) + return 3; + if (component == 1) + return 2; + if (component == 2) + return 1; + if (component == 3) + return 0; + return 0; + case GST_VIDEO_FORMAT_RGB: + if (component == 0) + return 0; + if (component == 1) + return 1; + if (component == 2) + return 2; + return 0; + case GST_VIDEO_FORMAT_BGR: + if (component == 0) + return 2; + if (component == 1) + return 1; + if (component == 2) + return 0; + return 0; + case GST_VIDEO_FORMAT_Y41B: + if (component == 0) + return 0; + if (component == 1) + return GST_ROUND_UP_4 (width) * height; + if (component == 2) + return (GST_ROUND_UP_4 (width) + (GST_ROUND_UP_8 (width) / 4)) * height; + return 0; + case GST_VIDEO_FORMAT_Y42B: + if (component == 0) + return 0; + if (component == 1) + return GST_ROUND_UP_4 (width) * height; + if (component == 2) + return (GST_ROUND_UP_4 (width) + (GST_ROUND_UP_8 (width) / 2)) * height; + return 0; + default: + return 0; + } +} + +/** + * gst_video_format_get_size: + * @format: a #GstVideoFormat + * @width: the width of video + * @height: the height of video + * + * Calculates the total number of bytes in the raw video format. This + * number should be used when allocating a buffer for raw video. + * + * Since: 0.10.16 + * + * Returns: size (in bytes) of raw video format + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +int +gst_video_format_get_size (GstVideoFormat format, int width, int height) +{ + int size; + + switch (format) { + case GST_VIDEO_FORMAT_I420: + case GST_VIDEO_FORMAT_YV12: + size = GST_ROUND_UP_4 (width) * GST_ROUND_UP_2 (height); + size += GST_ROUND_UP_4 (GST_ROUND_UP_2 (width) / 2) * + (GST_ROUND_UP_2 (height) / 2) * 2; + return size; + case GST_VIDEO_FORMAT_YUY2: + case GST_VIDEO_FORMAT_UYVY: + return GST_ROUND_UP_4 (width * 2) * height; + case GST_VIDEO_FORMAT_AYUV: + case GST_VIDEO_FORMAT_RGBx: + case GST_VIDEO_FORMAT_BGRx: + case GST_VIDEO_FORMAT_xRGB: + case GST_VIDEO_FORMAT_xBGR: + case GST_VIDEO_FORMAT_RGBA: + case GST_VIDEO_FORMAT_BGRA: + case GST_VIDEO_FORMAT_ARGB: + case GST_VIDEO_FORMAT_ABGR: + return width * 4 * height; + case GST_VIDEO_FORMAT_RGB: + case GST_VIDEO_FORMAT_BGR: + return GST_ROUND_UP_4 (width * 3) * height; + case GST_VIDEO_FORMAT_Y41B: + /* simplification of ROUNDUP4(w)*h + 2*((ROUNDUP8(w)/4)*h */ + return (GST_ROUND_UP_4 (width) + (GST_ROUND_UP_8 (width) / 2)) * height; + case GST_VIDEO_FORMAT_Y42B: + /* simplification of ROUNDUP4(w)*h + 2*(ROUNDUP8(w)/2)*h: */ + return (GST_ROUND_UP_4 (width) + GST_ROUND_UP_8 (width)) * height; + default: + return 0; + } +} + +/** + * gst_video_format_convert: + * @format: a #GstVideoFormat + * @width: the width of video + * @height: the height of video + * @fps_n: frame rate numerator + * @fps_d: frame rate denominator + * @src_format: #GstFormat of the @src_value + * @src_value: value to convert + * @dest_format: #GstFormat of the @dest_value + * @dest_value: pointer to destination value + * + * Converts among various #GstFormat types. This function handles + * GST_FORMAT_BYTES, GST_FORMAT_TIME, and GST_FORMAT_DEFAULT. For + * raw video, GST_FORMAT_DEFAULT corresponds to video frames. This + * function can be to handle pad queries of the type GST_QUERY_CONVERT. + * + * Since: 0.10.16 + * + * Returns: TRUE if the conversion was successful. + */ +#ifdef __SYMBIAN32__ +EXPORT_C +#endif + +gboolean +gst_video_format_convert (GstVideoFormat format, int width, int height, + int fps_n, int fps_d, + GstFormat src_format, gint64 src_value, + GstFormat dest_format, gint64 * dest_value) +{ + gboolean ret = FALSE; + int size; + + size = gst_video_format_get_size (format, width, height); + + GST_DEBUG ("converting value %" G_GINT64_FORMAT " from %s to %s", + src_value, gst_format_get_name (src_format), + gst_format_get_name (dest_format)); + + if (src_format == dest_format) { + *dest_value = src_value; + ret = TRUE; + goto done; + } + + if (src_value == -1) { + *dest_value = -1; + ret = TRUE; + goto done; + } + + /* bytes to frames */ + if (src_format == GST_FORMAT_BYTES && dest_format == GST_FORMAT_DEFAULT) { + if (size != 0) { + *dest_value = gst_util_uint64_scale_int (src_value, 1, size); + } else { + GST_ERROR ("blocksize is 0"); + *dest_value = 0; + } + ret = TRUE; + goto done; + } + + /* frames to bytes */ + if (src_format == GST_FORMAT_DEFAULT && dest_format == GST_FORMAT_BYTES) { + *dest_value = gst_util_uint64_scale_int (src_value, size, 1); + ret = TRUE; + goto done; + } + + /* time to frames */ + if (src_format == GST_FORMAT_TIME && dest_format == GST_FORMAT_DEFAULT) { + if (fps_d != 0) { + *dest_value = gst_util_uint64_scale (src_value, + fps_n, GST_SECOND * fps_d); + } else { + GST_ERROR ("framerate denominator is 0"); + *dest_value = 0; + } + ret = TRUE; + goto done; + } + + /* frames to time */ + if (src_format == GST_FORMAT_DEFAULT && dest_format == GST_FORMAT_TIME) { + if (fps_n != 0) { + *dest_value = gst_util_uint64_scale (src_value, + GST_SECOND * fps_d, fps_n); + } else { + GST_ERROR ("framerate numerator is 0"); + *dest_value = 0; + } + ret = TRUE; + goto done; + } + + /* time to bytes */ + if (src_format == GST_FORMAT_TIME && dest_format == GST_FORMAT_BYTES) { + if (fps_d != 0) { + *dest_value = gst_util_uint64_scale (src_value, + fps_n * size, GST_SECOND * fps_d); + } else { + GST_ERROR ("framerate denominator is 0"); + *dest_value = 0; + } + ret = TRUE; + goto done; + } + + /* bytes to time */ + if (src_format == GST_FORMAT_BYTES && dest_format == GST_FORMAT_TIME) { + if (fps_n != 0 && size != 0) { + *dest_value = gst_util_uint64_scale (src_value, + GST_SECOND * fps_d, fps_n * size); + } else { + GST_ERROR ("framerate denominator and/or blocksize is 0"); + *dest_value = 0; + } + ret = TRUE; + } + +done: + + GST_DEBUG ("ret=%d result %" G_GINT64_FORMAT, ret, *dest_value); + + return ret; +}