diff --git a/docs/plugins/Makefile.am b/docs/plugins/Makefile.am index f5f0d97f9f..49b811af4d 100644 --- a/docs/plugins/Makefile.am +++ b/docs/plugins/Makefile.am @@ -155,6 +155,7 @@ EXTRA_HFILES = \ $(top_srcdir)/gst/udp/gstmultiudpsink.h \ $(top_srcdir)/gst/udp/gstudpsrc.h \ $(top_srcdir)/gst/videocrop/gstvideocrop.h \ + $(top_srcdir)/gst/videocrop/gstaspectratiocrop.h \ $(top_srcdir)/gst/videofilter/gstgamma.h \ $(top_srcdir)/gst/videofilter/gstvideobalance.h \ $(top_srcdir)/gst/videofilter/gstvideoflip.h \ diff --git a/docs/plugins/gst-plugins-good-plugins-docs.sgml b/docs/plugins/gst-plugins-good-plugins-docs.sgml index 1a9c2ea09f..7a81eaf209 100644 --- a/docs/plugins/gst-plugins-good-plugins-docs.sgml +++ b/docs/plugins/gst-plugins-good-plugins-docs.sgml @@ -16,13 +16,14 @@ + + - diff --git a/docs/plugins/gst-plugins-good-plugins-sections.txt b/docs/plugins/gst-plugins-good-plugins-sections.txt index 332c36d4bb..398effddc0 100644 --- a/docs/plugins/gst-plugins-good-plugins-sections.txt +++ b/docs/plugins/gst-plugins-good-plugins-sections.txt @@ -1348,6 +1348,21 @@ GST_VIDEO_CROP_CLASS GST_TYPE_VIDEO_CROP +
+element-aspectratiocrop +aspectratiocrop +GstAspectRatioCrop + +GstAspectRatioCropClass +AspectRatioCropPixelFormat +GstAspectRatioCropImageDetails +GST_IS_ASPECT_RATIO_CROP +GST_IS_ASPECT_RATIO_CROP_CLASS +GST_ASPECT_RATIO_CROP +GST_ASPECT_RATIO_CROP_CLASS +GST_TYPE_ASPECT_RATIO_CROP +
+
element-videoflip videoflip diff --git a/docs/plugins/gst-plugins-good-plugins.args b/docs/plugins/gst-plugins-good-plugins.args index 5d646289db..f352ceb0e0 100644 --- a/docs/plugins/gst-plugins-good-plugins.args +++ b/docs/plugins/gst-plugins-good-plugins.args @@ -19798,3 +19798,13 @@ 0 + +GstAspectRatioCrop::aspect-ratio +GstFraction + +rw +aspect-ratio +Target aspect-ratio of video. + + + diff --git a/docs/plugins/gst-plugins-good-plugins.hierarchy b/docs/plugins/gst-plugins-good-plugins.hierarchy index 914c4d8425..edae7e4392 100644 --- a/docs/plugins/gst-plugins-good-plugins.hierarchy +++ b/docs/plugins/gst-plugins-good-plugins.hierarchy @@ -11,32 +11,79 @@ GObject GstElement GstBin GstPipeline - GstHalAudioSink - GstHalAudioSrc GstGConfVideoSink GstGConfVideoSrc GstSwitchSink GstGConfAudioSink GstGConfAudioSrc - GstRTSPSrc + GstHalAudioSink + GstHalAudioSrc + GstAspectRatioCrop + GstRgVolume GstAutoVideoSink GstAutoVideoSrc GstAutoAudioSink GstAutoAudioSrc - GstRgVolume - GstCairoTextOverlay + GstRTSPSrc + GstTagLibMux + GstId3v2Mux + GstApev2Mux + GstPngDec + GstPngEnc + GstBaseSrc + GstPushSrc + GstSoupHTTPSrc + GstBaseAudioSrc + GstAudioSrc + GstPulseSrc + GstOssSrc + GstDV1394Src + GstHDV1394Src + GstV4l2Src + GstXImageSrc + GstMultiFileSrc + GstUDPSrc + GstBaseSink + GstBaseAudioSink + GstAudioSink + GstEsdSink + GstPulseSink + GstOssSink + GstAASink + GstVideoSink + GstGdkPixbufSink + GstCACASink + GstShout2send + GstTest + GstMultiFileSink + GstMultiUDPSink + GstUDPSink + GstDynUDPSink + GstPulseMixer + GstJpegEnc + GstJpegDec + GstSmokeEnc + GstSmokeDec + GstWavpackParse + GstWavpackDec + GstWavpackEnc + GstFlacEnc + GstFlacDec + GstFlacTag + GstDVDemux + GstDVDec + GstSpeexEnc + GstSpeexDec + GstGdkPixbuf GstBaseTransform - GstCairoTimeOverlay GstPixbufScale + GstCairoTimeOverlay GstVideoBox - GstAlpha - GstAlphaColor GstVideoFilter - GstNavigationtest - GstVideoBalance GstVideoFlip + GstVideoBalance GstGamma - GstSMPTEAlpha + GstNavigationtest GstEdgeTV GstAgingTV GstDiceTV @@ -45,13 +92,10 @@ GObject GstVertigoTV GstRevTV GstQuarkTV - GstBreakMyData - GstNavSeek - GstProgressReport - GstTagInject - GstLevel + GstSMPTEAlpha + GstVideoCrop + GstAudioPanorama GstAudioFilter - GstSpectrum GstAudioInvert GstAudioKaraoke GstAudioAmplify @@ -69,88 +113,38 @@ GObject GstIirEqualizerNBands GstIirEqualizer3Bands GstIirEqualizer10Bands - GstAudioPanorama + GstSpectrum GstRgAnalysis GstRgLimiter - GstVideoCrop - GstBaseSrc - GstPushSrc - GstSoupHTTPSrc - GstBaseAudioSrc - GstAudioSrc - GstPulseSrc - GstOssSrc - GstDV1394Src - GstHDV1394Src - GstXImageSrc - GstV4l2Src - GstUDPSrc - GstMultiFileSrc - GstBaseSink - GstCACASink - GstBaseAudioSink - GstAudioSink - GstPulseSink - GstEsdSink - GstOssSink - GstAASink - GstVideoSink - GstGdkPixbufSink - GstShout2send - GstTest - GstMultiUDPSink - GstUDPSink - GstDynUDPSink - GstMultiFileSink - GstPulseMixer - GstTagLibMux - GstId3v2Mux - GstApev2Mux - GstJpegEnc - GstJpegDec - GstSmokeEnc - GstSmokeDec - GstDVDemux - GstDVDec + GstBreakMyData + GstNavSeek + GstProgressReport + GstTagInject + GstAlphaColor + GstAlpha + GstLevel GstCmmlEnc GstCmmlDec - GstFlacEnc - GstFlacDec - GstFlacTag - GstPngDec - GstPngEnc - GstGdkPixbuf - GstWavpackParse - GstWavpackDec - GstWavpackEnc - GstSpeexEnc - GstSpeexDec + GstCairoTextOverlay GstOssMixerElement - GstRTPDec - GstICYDemux - GstWavParse - GstEbmlRead - GstMatroskaDemux - GstMatroskaMux - GstFlxDec - GstVideoMixer - GstTagDemux - GstApeDemux - GstID3Demux - GstRndBufferSize - GstEFence - GstGoom - GstGoom2k1 GstMultipartDemux GstMultipartMux - GstMuLawEnc - GstMuLawDec + GstFlxDec + GstAuParse GstALawEnc GstALawDec - GstCutter - GstQTDemux + GstMuLawEnc + GstMuLawDec + GstVideoMixer + GstRndBufferSize + GstEFence + GstTagDemux + GstID3Demux + GstApeDemux + GstGoom2k1 + GstWavEnc + GstRTPDepay GstBaseRTPDepayload - GstRtpXQTDepay GstRtpAC3Depay GstRTPDVDepay GstRTPiLBCDepay @@ -177,16 +171,7 @@ GObject GstRtpTheoraDepay GstRtpVorbisDepay GstRtpVRawDepay - GstAviDemux - GstAviMux - GstAviSubtitle - GstSMPTE - GstInterleave - GstDeinterleave - GstMonoscope - GstWavEnc - GstAuParse - GstRTPDepay + GstRtpXQTDepay GstBaseRTPPayload GstRTPDVPay GstBaseRTPAudioPayload @@ -213,6 +198,21 @@ GObject GstRtpVorbisPay GstRtpVRawPay GstAsteriskh263 + GstEbmlRead + GstMatroskaDemux + GstMatroskaMux + GstCutter + GstICYDemux + GstAviDemux + GstAviMux + GstAviSubtitle + GstRTPDec + GstWavParse + GstQTDemux + GstSMPTE + GstInterleave + GstDeinterleave + GstGoom GstBus GstTask GstClock @@ -224,10 +224,10 @@ GObject GstSignalObject GstMixerTrack GstMixerOptions + GdkPixbuf GstCmmlTagStream GstCmmlTagHead GstCmmlTagClip - GdkPixbuf GstTunerNorm GstTunerChannel GstColorBalanceChannel @@ -235,10 +235,10 @@ GInterface GTypePlugin GstChildProxy GstURIHandler + GstTagSetter GstImplementsInterface GstPropertyProbe GstMixer - GstTagSetter GstTuner GstColorBalance GstVideoOrientation diff --git a/docs/plugins/gst-plugins-good-plugins.interfaces b/docs/plugins/gst-plugins-good-plugins.interfaces index 85f94c9ffe..b5c5bbbd2c 100644 --- a/docs/plugins/gst-plugins-good-plugins.interfaces +++ b/docs/plugins/gst-plugins-good-plugins.interfaces @@ -1,23 +1,22 @@ GstBin GstChildProxy GstPipeline GstChildProxy -GstHalAudioSink GstChildProxy -GstHalAudioSrc GstChildProxy GstGConfVideoSink GstChildProxy GstGConfVideoSrc GstChildProxy GstSwitchSink GstChildProxy GstGConfAudioSink GstChildProxy GstGConfAudioSrc GstChildProxy -GstRTSPSrc GstChildProxy GstURIHandler +GstHalAudioSink GstChildProxy +GstHalAudioSrc GstChildProxy +GstAspectRatioCrop GstChildProxy +GstRgVolume GstChildProxy GstAutoVideoSink GstChildProxy GstAutoVideoSrc GstChildProxy GstAutoAudioSink GstChildProxy GstAutoAudioSrc GstChildProxy -GstRgVolume GstChildProxy -GstVideoBalance GstImplementsInterface GstColorBalance -GstIirEqualizer GstChildProxy -GstIirEqualizerNBands GstChildProxy -GstIirEqualizer3Bands GstChildProxy GstPreset -GstIirEqualizer10Bands GstChildProxy GstPreset +GstRTSPSrc GstChildProxy GstURIHandler +GstTagLibMux GstTagSetter +GstId3v2Mux GstTagSetter +GstApev2Mux GstTagSetter GstSoupHTTPSrc GstURIHandler GstPulseSrc GstImplementsInterface GstPropertyProbe GstMixer GstOssSrc GstImplementsInterface GstMixer @@ -29,13 +28,15 @@ GstPulseSink GstImplementsInterface GstPropertyProbe GstShout2send GstTagSetter GstUDPSink GstURIHandler GstPulseMixer GstImplementsInterface GstPropertyProbe GstMixer -GstTagLibMux GstTagSetter -GstId3v2Mux GstTagSetter -GstApev2Mux GstTagSetter GstFlacEnc GstTagSetter GstFlacTag GstTagSetter GstSpeexEnc GstTagSetter +GstVideoBalance GstImplementsInterface GstColorBalance +GstIirEqualizer GstChildProxy +GstIirEqualizerNBands GstChildProxy +GstIirEqualizer3Bands GstChildProxy GstPreset +GstIirEqualizer10Bands GstChildProxy GstPreset GstOssMixerElement GstImplementsInterface GstMixer -GstMatroskaMux GstTagSetter GstVideoMixer GstChildProxy +GstMatroskaMux GstTagSetter GstAviMux GstTagSetter diff --git a/docs/plugins/gst-plugins-good-plugins.prerequisites b/docs/plugins/gst-plugins-good-plugins.prerequisites index eb1fa169b2..a54c8fe892 100644 --- a/docs/plugins/gst-plugins-good-plugins.prerequisites +++ b/docs/plugins/gst-plugins-good-plugins.prerequisites @@ -1,7 +1,7 @@ GstChildProxy GstObject +GstTagSetter GstObject GstElement GstImplementsInterface GstObject GstElement GstMixer GstObject GstImplementsInterface GstElement -GstTagSetter GstObject GstElement GstTuner GstObject GstImplementsInterface GstElement GstColorBalance GstObject GstImplementsInterface GstElement GstVideoOrientation GstObject GstImplementsInterface GstElement diff --git a/docs/plugins/inspect/plugin-videocrop.xml b/docs/plugins/inspect/plugin-videocrop.xml index f1ebfe2524..42085b81af 100644 --- a/docs/plugins/inspect/plugin-videocrop.xml +++ b/docs/plugins/inspect/plugin-videocrop.xml @@ -3,12 +3,33 @@ Crops video into a user-defined region ../../gst/videocrop/.libs/libgstvideocrop.so libgstvideocrop.so - 0.10.11.1 + 0.10.13.1 LGPL gst-plugins-good GStreamer Good Plug-ins CVS/prerelease Unknown package origin + + aspectratiocrop + aspectratiocrop + Filter/Effect/Video + Crops video into a user-defined aspect-ratio + Thijs Vermeir <thijsvermeir@gmail.com> + + + src + source + always +
video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)-16777216, green_mask=(int)16711680, blue_mask=(int)65280, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)16711680, green_mask=(int)65280, blue_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)65280, green_mask=(int)16711680, blue_mask=(int)-16777216, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)255, green_mask=(int)65280, blue_mask=(int)16711680, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)-16777216, green_mask=(int)16711680, blue_mask=(int)65280, alpha_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)16711680, green_mask=(int)65280, blue_mask=(int)255, alpha_mask=(int)-16777216, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)65280, green_mask=(int)16711680, blue_mask=(int)-16777216, alpha_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)255, green_mask=(int)65280, blue_mask=(int)16711680, alpha_mask=(int)-16777216, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)24, depth=(int)24, endianness=(int)4321, red_mask=(int)16711680, green_mask=(int)65280, blue_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)24, depth=(int)24, endianness=(int)4321, red_mask=(int)255, green_mask=(int)65280, blue_mask=(int)16711680, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)AYUV, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)YUY2, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)YVYU, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)UYVY, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)Y800, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)I420, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)YV12, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)16, depth=(int)16, endianness=(int)1234, red_mask=(int)63488, green_mask=(int)2016, blue_mask=(int)31, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)16, depth=(int)15, endianness=(int)1234, red_mask=(int)31744, green_mask=(int)992, blue_mask=(int)31, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]
+ + + sink + sink + always +
video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)-16777216, green_mask=(int)16711680, blue_mask=(int)65280, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)16711680, green_mask=(int)65280, blue_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)65280, green_mask=(int)16711680, blue_mask=(int)-16777216, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)24, endianness=(int)4321, red_mask=(int)255, green_mask=(int)65280, blue_mask=(int)16711680, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)-16777216, green_mask=(int)16711680, blue_mask=(int)65280, alpha_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)16711680, green_mask=(int)65280, blue_mask=(int)255, alpha_mask=(int)-16777216, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)65280, green_mask=(int)16711680, blue_mask=(int)-16777216, alpha_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)32, depth=(int)32, endianness=(int)4321, red_mask=(int)255, green_mask=(int)65280, blue_mask=(int)16711680, alpha_mask=(int)-16777216, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)24, depth=(int)24, endianness=(int)4321, red_mask=(int)16711680, green_mask=(int)65280, blue_mask=(int)255, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)24, depth=(int)24, endianness=(int)4321, red_mask=(int)255, green_mask=(int)65280, blue_mask=(int)16711680, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)AYUV, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)YUY2, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)YVYU, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)UYVY, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)Y800, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)I420, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-yuv, format=(fourcc)YV12, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)16, depth=(int)16, endianness=(int)1234, red_mask=(int)63488, green_mask=(int)2016, blue_mask=(int)31, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]; video/x-raw-rgb, bpp=(int)16, depth=(int)15, endianness=(int)1234, red_mask=(int)31744, green_mask=(int)992, blue_mask=(int)31, width=(int)[ 1, 2147483647 ], height=(int)[ 1, 2147483647 ], framerate=(fraction)[ 0/1, 2147483647/1 ]
+ + + videocrop Crop diff --git a/gst/videocrop/gstaspectratiocrop.c b/gst/videocrop/gstaspectratiocrop.c index 2c0407b88e..2cdd51ca68 100644 --- a/gst/videocrop/gstaspectratiocrop.c +++ b/gst/videocrop/gstaspectratiocrop.c @@ -17,6 +17,21 @@ * Boston, MA 02111-1307, USA. */ +/** + * SECTION:element-aspectratiocrop + * @see_also: #GstVideoCrop + * + * This element crops video frames to a specified aspect-ratio. + * + * If the aspect-ratio is already correct, the element will operate in pass-through mode. + * + * + * Example launch line + * |[gst-launch -v videotestsrc ! video/x-raw-rgb,height=640,width=480 ! aspectratiocrop aspect-ratio=16/9 ! ximagesink]| + * This pipeline generates a videostream in 4/3 and crops it to 16/9. + * + */ + #ifdef HAVE_CONFIG_H #include "config.h" #endif