mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-30 04:00:37 +00:00
72bb2d8637
Add fastpaths for all planar conversion and scaling. Improve gray and alpha handling. Add option to specify the chroma resampler method and set to linear as default.
203 lines
6.8 KiB
C
203 lines
6.8 KiB
C
/* Video conversion api function
|
|
* Copyright (C) 2014 Wim Taymans <wim.taymans@gmail.com>
|
|
*
|
|
* 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., 51 Franklin St, Fifth Floor,
|
|
* Boston, MA 02110-1301, USA.
|
|
*/
|
|
|
|
#ifndef __GST_VIDEO_CONVERTER_H__
|
|
#define __GST_VIDEO_CONVERTER_H__
|
|
|
|
#include <gst/video/video.h>
|
|
|
|
G_BEGIN_DECLS
|
|
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_RESAMPLER_METHOD:
|
|
*
|
|
* #GST_TYPE_RESAMPLER_METHOD, The resampler method to use for
|
|
* resampling. Other options for the resampler can be used, see
|
|
* the #GstResampler. Default is #GST_RESAMPLER_METHOD_CUBIC
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_RESAMPLER_METHOD "GstVideoConverter.resampler-method"
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_CHROMA_RESAMPLER_METHOD:
|
|
*
|
|
* #GST_TYPE_RESAMPLER_METHOD, The resampler method to use for
|
|
* chroma resampling. Other options for the resampler can be used, see
|
|
* the #GstResampler. Default is #GST_RESAMPLER_METHOD_LINEAR
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_CHROMA_RESAMPLER_METHOD "GstVideoConverter.chroma-resampler-method"
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_RESAMPLER_TAPS:
|
|
*
|
|
* #G_TYPE_UINT, The number of taps for the resampler.
|
|
* Default is 0: let the resampler choose a good value.
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_RESAMPLER_TAPS "GstVideoConverter.resampler-taps"
|
|
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_DITHER_METHOD:
|
|
*
|
|
* #GST_TYPE_VIDEO_DITHER_METHOD, The dither method to use when
|
|
* changing bit depth.
|
|
* Default is #GST_VIDEO_DITHER_BAYER.
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_DITHER_METHOD "GstVideoConverter.dither-method"
|
|
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_DITHER_QUANTIZATION:
|
|
*
|
|
* #G_TYPE_UINT, The quantization amount to dither to. Components will be
|
|
* quantized to multiples of this value.
|
|
* Default is 1
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_DITHER_QUANTIZATION "GstVideoConverter.dither-quantization"
|
|
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_SRC_X:
|
|
*
|
|
* #G_TYPE_INT, source x position to start conversion, default 0
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_SRC_X "GstVideoConverter.src-x"
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_SRC_Y:
|
|
*
|
|
* #G_TYPE_INT, source y position to start conversion, default 0
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_SRC_Y "GstVideoConverter.src-y"
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_SRC_WIDTH:
|
|
*
|
|
* #G_TYPE_INT, source width to convert, default source width
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_SRC_WIDTH "GstVideoConverter.src-width"
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_SRC_HEIGHT:
|
|
*
|
|
* #G_TYPE_INT, source height to convert, default source height
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_SRC_HEIGHT "GstVideoConverter.src-height"
|
|
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_DEST_X:
|
|
*
|
|
* #G_TYPE_INT, x position in the destination frame, default 0
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_DEST_X "GstVideoConverter.dest-x"
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_DEST_Y:
|
|
*
|
|
* #G_TYPE_INT, y position in the destination frame, default 0
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_DEST_Y "GstVideoConverter.dest-y"
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_DEST_WIDTH:
|
|
*
|
|
* #G_TYPE_INT, width in the destination frame, default destination width
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_DEST_WIDTH "GstVideoConverter.dest-width"
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_DEST_HEIGHT:
|
|
*
|
|
* #G_TYPE_INT, height in the destination frame, default destination height
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_DEST_HEIGHT "GstVideoConverter.dest-height"
|
|
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_FILL_BORDER:
|
|
*
|
|
* #G_TYPE_BOOLEAN, if the destination rectangle does not fill the complete
|
|
* destination image, render a border with
|
|
* #GST_VIDEO_CONVERTER_OPT_BORDER_ARGB. Otherwise the unusded pixels in the
|
|
* destination are untouched. Default %TRUE.
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_FILL_BORDER "GstVideoConverter.fill-border"
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_BORDER_ARGB:
|
|
*
|
|
* #G_TYPE_UINT, the border color to use if #GST_VIDEO_CONVERTER_OPT_FILL_BORDER
|
|
* is set to %TRUE. Default 0x00000000
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_BORDER_ARGB "GstVideoConverter.border-argb"
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_CHROMA_MODE:
|
|
*
|
|
* #G_TYPE_STRING, set the chroma resample mode subsampled formats.
|
|
*
|
|
* "full": do full chroma up and down sampling
|
|
* "upsample-only": only perform chroma upsampling
|
|
* "downsample-only": only perform chroma downsampling
|
|
* "none": disable chroma resampling
|
|
*
|
|
* Default "full"
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_CHROMA_MODE "GstVideoConverter.chroma-mode"
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_MATRIX_MODE:
|
|
*
|
|
* #G_TYPE_STRING, set the color matrix conversion mode for converting
|
|
* between Y'PbPr and non-linear RGB (R'G'B').
|
|
*
|
|
* "full": do conversion between color matrices
|
|
* "input-only": use the input color matrix to convert to and from R'G'B
|
|
* "output-only": use the output color matrix to convert to and from R'G'B
|
|
* "none": disable color matrix conversion.
|
|
*
|
|
* Default "full"
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_MATRIX_MODE "GstVideoConverter.matrix-mode"
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_GAMMA_MODE:
|
|
*
|
|
* #G_TYPE_STRING, set the gamma mode.
|
|
*
|
|
* "none": disable gamma handling
|
|
* "remap": convert between input and output gamma
|
|
*
|
|
* Default "none"
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_GAMMA_MODE "GstVideoConverter.gamma-mode"
|
|
/**
|
|
* GST_VIDEO_CONVERTER_OPT_PRIMARIES_MODE:
|
|
*
|
|
* #G_TYPE_STRING, set the primaries conversion mode.
|
|
*
|
|
* "none": disable conversion between primaries
|
|
* "merge-only": do conversion between primaries only when it can be merged
|
|
* with color matrix conversion.
|
|
* "fast": fast conversion between primaries
|
|
*
|
|
* Default "none"
|
|
*/
|
|
#define GST_VIDEO_CONVERTER_OPT_PRIMARIES_MODE "GstVideoConverter.primaries-mode"
|
|
|
|
typedef struct _GstVideoConverter GstVideoConverter;
|
|
|
|
GstVideoConverter * gst_video_converter_new (GstVideoInfo *in_info,
|
|
GstVideoInfo *out_info,
|
|
GstStructure *config);
|
|
void gst_video_converter_free (GstVideoConverter * convert);
|
|
|
|
gboolean gst_video_converter_set_config (GstVideoConverter * convert, GstStructure *config);
|
|
const GstStructure * gst_video_converter_get_config (GstVideoConverter * convert);
|
|
|
|
void gst_video_converter_frame (GstVideoConverter * convert,
|
|
const GstVideoFrame *src, GstVideoFrame *dest);
|
|
|
|
|
|
G_END_DECLS
|
|
|
|
#endif /* __GST_VIDEO_CONVERTER_H__ */
|