NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io · #3782 most downloaded on crates.io
Rust bindings for GStreamer Video library
Last release 16 days ago
21 Sep 2026
Ships fairly regularly
a new release about every 6 weeks
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
77 releases · first in 2017
Don't use potentially uninitialized data in gst_analytics when adding metadata fails.
gst_analytics when adding
metadata fails.gst::cpuid_supports_riscv_v() behind the correct version feature flag.gst::debug_log_default().gst_base::BaseParse virtual methods.gst::TocSetter subclassing support.gst_vulkan.AnalyticsMetaRefExt, AnalyticsMetaRefMutExt and AnalyticsMtdExt are now
part of the gst_analytics prelude.system-deps 9.gst_utils::StreamProducer when dropping frames while
waiting for a keyframe.Add missing gating on gst_allocators::FdAllocatorExtManual in prelude.
gst_allocators::FdAllocatorExtManual in prelude.prepare_allocator virtual methods and set_allocator in gst_base and
gst_video base classes.gst::Pad and element subclassing.One column per quarter.
Only enable gst_allocators::FdAllocator on UNIX platforms.
gst_allocators::FdAllocator on UNIX platforms.gst::Pad as parent class for gst_audio::AudioAggregatorPad.gst_audio::AudioAggregatorPad::audio_info().gst_base::BaseParse::sink_caps() vfunc.Display impl for gst::PadFlags.gst-mpegts and gst-tag.Read+Seek impl for gst::TypeFind.gst_video::dma_drm_fourcc_to_string() doesn't do a NULL pointer dereference on invalid fourccs anymore.
gst_video::dma_drm_fourcc_to_string() doesn't do a NULL pointer
dereference on invalid fourccs anymore.gst::Bus::timed_pop_filtered() timeout semantics are consistent with the C
implementation now.gst_validate::setup_test_file() return value ownership semantics.gst::Object::set_parent() behaviour and mark it as unsafe, and add a
corresponding unsafe unset_parent().gst_app::AppSink with drop-out-of-segment
property.gst_audio::AudioChannelPosition implements Display now.Vec<u8> in a Memory or Buffer and
retrieving it again later with its original type.gst::Memory::default_alignment() for returning the default memory
alignment.Allocator::alloc() on the Rust wrapped memory allocator.gst::segtrap_is_enabled() / segtrap_set_enabled().gst::MiniObject::mark_may_be_leaked().gst_utils::StreamProducer event types API for forwarding upstream events.gst_tag::image_data_to_image_sample().gst_tag got implementations for all the tags provided by the library.gst::Memory / gst::Buffer APIs that are rarely used.Updated to gtk-rs-core 0.22 APIs.
Updated with final GStreamer 1.28.0 APIs and upcoming 1.30 APIs.
Updated minimum supported Rust version to 1.92.
Cleanup of gst::Meta transform APIs.
Change gst_app::AppSrc max-time configuration to be non-optional.
GES Asset APIs take generic type parameters now.
gst_video::convert_sample() timeout parameter is optional now.
gst::Allocator subclassing API was fixed to be actually usable.
Nothing published for this version
Nothing published for this version
Add bindings for gst::segtrap_is_enabled() and segtrap_set_enabled().
gst::segtrap_is_enabled() and segtrap_set_enabled().gst::MiniObject::mark_may_be_leaked().gst::DynamicTypeFactory.gst_tag::image_data_to_image_sample().gst_tag.gst::Memory / gst::Buffer method bindings.gst::MessageType.gst::Query, Message and Event types.gst_video::dma_drm_fourcc_to_string().gst::Bus::timed_pop_filtered() timeout semantics.gst_validate::setup_test_file().out-of-segment via the gst_app::AppSink builder.gst::GhostPad builder.Fix gst::Allocator subclassing API. This was not actually usable before and as such the fixing required a couple of breaking changes.
Buffer::try_into_inner() and Memory::try_into_inner() to extract a
wrapped Rust value (e.g. a Vec<u8>).Memory::default_alignment(), implement alloc() for the Rust allocator
and add gst::rust_allocator() for getting a reference to the allocator.auto module in gstreamer-tag so that TagImageType is actually
accessible.gst::Allocator subclassing API. This was not actually usable before
and as such the fixing required a couple of breaking changes.gst_analytics::AnalyticsBatchMeta and gst_validate to the latest API.gst_video::is_dma_drm_caps() helper function.
gst_video::is_dma_drm_caps() helper function.gst_tag::TagImageType enum.gst::ControlBinding property_name() and property_pspec() accessors.gst_controller::TimedValueControlSource::list_control_points() 1.28.ges::TimelineElement accepts any Into<glib::Value> in
set_child_property() now.Allow using DMA_DRM and ENCODED formats with gst_video::VideoMeta and VideoInfo APIs by improving / relaxing parameter validation.
DMA_DRM and ENCODED formats with gst_video::VideoMeta and
VideoInfo APIs by improving / relaxing parameter validation.gst::IdStr by full path in gst::id_str!() macro.gst::MiniObject::downcast_ref() and downcast_mut() that operate on the
non-ref type.gst::format types.Default impl for gst_app enums.gst_utils::StreamProducer posts an element message whenever buffers are
dropped.gst_utils::StreamProducer has new API to configure the appsrc limits and
to configure sync=false on the appsink.Removed incomplete offset/stride checks in gst_video::VideoInfo builder.
gst_video::VideoInfo builder.gst::Memory::from_slice() and related API as
MAY_BE_LEAKED as it's a singleton and otherwise shows up in the leaks
tracer, for example.gst_video::VideoMeta::add_from_info() that takes a VideoInfo
instead of individual parameters.API deprecated in previous releases was removed.
gst::Structure fields and fields of related API are using gst::IdStr
when built against GStreamer 1.26 and use a local implementation of that
as fallback on older versions to offer the same API.gst_validate action and action type API.gst_play::PlayMessage API to be easier to use correctly.bool result from gst::BufferList::foreach() as return values are
more flexibly handled via mutable variables captured by the closure.gst::Element::foreach_pad() returns ControlFlow instead of bool from
callback now.Vecs from more functions.gst::event::SelectStreams builder API for convenient.#[must_use] annotations to all iterator structs.gst_video::VideoInfo and gst_audio::AudioInfo references from
more functions instead of copies.gst::Clock functions to not return Options anymore.gst_sdp::SDPMedia::set_media_from_caps() to a method.gst_allocators allocator API was moved to extension traits and
renamed to not have the same name as a method of the parent class.gst_app::AppSink and
AppSrc, gst::Bin and gst::Pipeline builders.gstreamer-mse library.gstreamer-d3d12 library.gst_webrtc::DataChannel duplicated signal API was removed.Lower debug message level when allocation queries in subclasses fail.
gst_audio tests.appsink when releasing a gst_utils::StreamProducer.gst::ElementImpl::parent_request_new_pad().gst_utils::StreamProducer when discarding a
buffer.gst::ByteSliceExt over all AsRef<[u8]> instead of just &[u8] and
&mut [u8].gst::Allocator::memory_type() getter.gst::AllocationParams and implement Copy, PartialEq and Eq.gst_audio::AudioInfo and gst_video::VideoInfo
builder from an existing value.gst_video::VideoAlignment and implement Default.Default, Copy and Clone for gst::BufferPoolAcquireParams and add
setters.gst::ChildProxy::set_child_property_from_str() convenience API.gst::BufferList::drain() for iterating over a buffer list while draining it.gst_utils::StreamProducer::wait_for_keyframe() configuration.gst_utils::ConsumptionLink getter for the stream producer.gst_tag language code API.Properly validate gst::IntRange::with_step() step size
gst::IntRange::with_step() step sizegst::Buffer serde serializationgst_utils::StreamProducer.gst_video::VideoMeta::add_full().Results instead of bools in new gst_play API.TracerImpl::USE_STRUCTURE_PARAMS with GStreamer < 1.26.gst_analytics::ODMtd.TopSurroundRight and TopSurroundLeft audio channels.gst_audio::reorder_channels_with_reorder_map().gst_video::VideoFrame::plane_data() does not return a truncated buffer for the alpha plane in A420 and similar formats anymore.
gst_video::VideoFrame::plane_data() does not return a truncated buffer for
the alpha plane in A420 and similar formats anymore.FnMut closures are now correctly passed via a mutable reference to FFI code.gst_video::VideoFormat::from_mask() was corrected.gst_analytics::Tensor API.gst::DebugCategory::as_ptr() and Hash impl, gst::DebugMessage::as_ptr().&mut [u8] in addition to &[u8], gst::Buffer, etc.glib::Types.Bind gst::Pad::proxy_query_caps() to the correct C function.
gst::Pad::proxy_query_caps() to the correct C function.gst_utils::StreamProducer appsrc latency upon appsink latency event.gst_app::AppSinkBuilder::processing_deadline().gst::Iterator constructors for convenience.Lifetime of gst::TagList::index() return value is correctly bound to &self now.
gst::TagList::index() return value is correctly bound to &self now.gst::Structure name / field names have 'static lifetime.NULL if HANDLED is returned and the item is an
event, buffer or buffer list.#[link] attribute to the extern "C" sections to
allow linking against gstreamer-full and make static linking easier.#[must_use] to gst_video::VideoTimeCode::add_interval().gst::PadProbeInfo.gst::EventViewMut and gst::Event::view_mut(), and a few setters for
event fields.gst::MessageViewMut and gst::Message::view_mut(), and a few setters
for message fields.Similar for imp and id. The old syntax is still supported but deprecated. The new syntax works better with tooling, especially rustfmt.
gst::Meta tags into separate modules and improve API around them.gst::Meta transform functions and make the API more generic, and
as part of that add support the video meta transform.gst_rtp::RtpHeaderExtension::write() function.gst_net::PtpClock::new() constructor fallible.gst_rtsp_server::RTSPToken API to be consistent with
gst::Structure, specifically add a builder.from_glib_ptr_borrow() functions to work with references instead of
raw pointers for improved safety.panic=abort.gst::BufferList APIs to work with ranges instead of index+length.usize instead of u32 for various indices in gst::Buffer,
gst::Caps, gst::Structure and related APIs.gst::Clock calibration-related API uses plain u64 instead of
gst::ClockTime for the clock rate.gst::debug! and related macros use obj = x instead of obj: x for
specifying the target object now. Similar for imp and id. The old syntax
is still supported but deprecated. The new syntax works better with tooling,
especially rustfmt.gst_webrtc::WebRTCSessionDescription fields.gst::StructureBuilder::field_if_some() and the same for related builders
to only set a value if Some(x) is provided.gst::StructureBuilder::field_from_iter() and field_if_not_empty() for
various builders.gst::PadBuilder API for selecting an automatically generated name.log crate around the GStreamer debug log system. This
allows the macros from the log crate to be output via the GStreamer debug
log system.gst_video::Navigation event.gst_pbutils missing/install plugins API.gst_editing_services::FrameCompositionMeta.ges::UriClipAsset::new().Nothing published for this version
When logging with an id and a formatted log message this would previously panic.
A couple of clippy warnings and compiler warnings about unused imports with latest rustc.
SelectStreams event.BufferList and Caps APIs
where these assertions were missing to avoid assertions in C.StreamProducer::set_forward_preroll() API to configure if the preroll
buffer should be directly forwarded or not yet.Implement From / ToValue for gst_audio::AudioConverterConfig and gst_video::VideoConverterConfig.
From<glib::Value> / ToValue for gst_audio::AudioConverterConfig and
gst_video::VideoConverterConfig.Update GStreamer gir files and add more new 1.24 API.
AnalyticsODLocation struct fields public.MetaRefMut::upcast_mut() returns a mutable reference now.Various deprecated APIs that were deprecated in previous releases.
gst::Rank is not implemented as an enum but as a struct with associated
constants now.gst::Buffer::from_slice() and Memory::from_slice()
implementations that have one heap allocation fewer.gst::Buffer and gst::Memory functions take ranges now instead of
offset/size parameters.gst_gl::GLContext::thread_add(), GLFrameBuffer::draw_to_texture().gst_gl::GLVideoFrame type that replaces gst_video::VideoFrame for
GL-specific API, and comes with mostly the same interface.gst::Buffer:dump() and dump_range() together with the same API on
gst::Memory for hex-dumping the whole buffer/memory content.Clone on gst::MetaRef.gst::Buffer::map_range_readable() and its writable variant.gst_video::VideoFrame and
gst_audio::AudioBuffer plane data.gstreamer-rtsp-server.AudioBuffer / VideoFrame.gst_rtp::RTPSourceMeta bindings.gst::macos_main() bindings.gst::ReferenceTimestampMeta reference getter.gst::loggable_error! macro.gstreamer-gl-* crates can build docs again on stable.gst::Pad::caps() property getter. Use current_caps() instead which does
the same thing.AudioBuffer / VideoFrame as
that allowed invalidating the buffer map.Update GStreamer gir files to latest (upcoming) 1.24 APIs.
gst::MetaRef::has_tags() and tags() API actually works and works based
on the tags of the concrete meta instance.gst::MetaRef::tags() returns strings with arbitrary lifetimes now because
they're statically stored anyway.gst_utils::StreamProducer when sending
force-keyunit events.gst_video::VBIEncoder and VBIParser.gst::PadProbeData types on PadProbeInfo.Default impl for gst::AllocationParams.From / TryFrom implementations between formatted types (e.g.
gst::Bytes) and usize.gst::MetaRef::copy() to copy metas from one buffer to another.gst::ElementImpl::catch_panic_future() to wrap a Future in such a way
that panics are converted to GStreamer error messages and the element is
marked as unusable.gst_gl::GLDisplay::handle() to get a raw display handle.Update GStreamer gir files to latest (upcoming) 1.24 APIs.
gst_utils::StreamProducer when sending
force-keyunit events.max-time / max-bytes setters to gst_app::AppSink builder.gst::CustomMeta::register_simple().Minimum supported Rust version is updated to 1.70.0.
gst::Bin::add_many(), remove_many() and gst::Element::link_many(),
unlink_many() are more generic now.gst_base::Aggregator::src_pad() returns an AggregatorPad.gst::Bus::add_watch() now returns a guard value that automatically removes
the watch when it goes out of scope.gst::Bin, Pipeline and Pad constructors don't take the optional name
parameter anymore but it can instead be provided via the builder API.gst::Pad and GhostPad builders inherit name from the pad template (or
target) if possible and no other name is provided explicitly.StreamProducer consumers.gst::ClockTime.Display implementations for error/warning/info messages.Debug implementations for messages, events and queries and
gst_pbutils::DiscovererInfo related structs.gst::Meta tags.Fix wait-for-eos property name string in appsink.
wait-for-eos property name string in appsink.BaseTransform subclassing bindings.Send+Sync.DiscovererInfo::debug() and on related structs.GESFormatter.Work around gst_webrtc::WebRTCICE::add_candidate() API breakage in 1.24.
gst_webrtc::WebRTCICE::add_candidate() API breakage in 1.24.gst_audio::AudioBuffer and gst_video::VideoFrame by a
factor of two by not storing an unnecessary copy of the audio/video info.gst::ParamSpecArray uses the correct glib::Type now.
gst::ParamSpecArray uses the correct glib::Type now.GstRTSPClient.gst_utils::StreamProducer::forward_eos() default value.glib::HasParamSpec impl for gst::ClockTime
glib::HasParamSpec impl for gst::ClockTimeDefault impl for gst_play::Playgst_audio::AudioCapsBuilder / gst_video::VideoCapsBuilderFix memory leaks when converting a gst_audio::AudioBuffer or gst_video::VideoFrame to a gst::Buffer or FFI type.
gst_audio::AudioBuffer or
gst_video::VideoFrame to a gst::Buffer or FFI type.Make gst_gL::GLDisplay::create_context() other_context parameter optional.
gst_gL::GLDisplay::create_context() other_context parameter optional.gst::Signed<T> and T and signed integer types.gst::Object::lock().FromIterator, Extend and From impls for creating Caps,
Structure, Buffer, BufferList, CapsFeatures and other types.PartialEq impls between owned/borrowed miniobjects/structures.gst::Array and gst::List.v1_22 feature.gst_gl::GLDisplay methods.gst::TagSetter::add() to add_tags() to avoid name conflict with
Bin::add().glib::GStr and related API in caps, structure, tags and
logging API to reduce temporary string allocations.gst_audio::AudioInfo
from 832 to 320 bytes.gst_utils::StreamProducer API to forward buffers by default and
allow temporarily discarding via new set_discard() function.Clear video frame values when mapping as GL texture to avoid out of bounds reads when trying to access the GL texture as raw video frame.
Handled from BufferList pad probes.Subclassing bindings for gst_audio::AudioFilter.
gst_audio::AudioFilter.FromIterator and Extend for Caps.
FromIterator<Caps> and Extend<Caps> for Caps.PartialEq impls between owned/borrowed miniobjects/structures.Subclassing support for gst::Allocator.
gst::Allocator.gst_gl::GLBaseMemory::context() to retrieve the GL context used by the
memory.gst::Allocator::register() does not cause use-after free with
GStreamer < 1.20.5 anymore.gstreamer-editing-services-sys as they
are useless and change with every update.Builders for element construction. gst::ElementFactory::make() returns a builder now that allows to easily set the name or any other property at const
Builders for element construction. gst::ElementFactory::make() returns a
builder now that allows to easily set the name or any other property at
construction time. The old API is available as make_with_name().
Builders for Bin and Pipeline as well as a Default trait
implementation to simplify object construction.
Builders for appsrc and appsink, which allow type-safe construction of
both elements while also allowing to easily set all their properties at
construction time.
Builders for the GStreamer-specific fraction/array param/property specs.
Infrastructure for casting between gst::Memory subtypes/supertypes, and
make use of it for GL memory.
Bindings for the gstreamer-allocator library with support for file
descriptor-based and DMABUF memory.
Complete bindings for gst_video Navigation events.
Constructors for error/warning/info messages with a pre-built glib::Error.
This also leads to some minor simplification of the existing API.
Accessors for static pads of various base classes for making accessing them cheaper and less error-prone than getting them by name.
Builder for pad templates.
Static PTP clock API for statistics, initialization and deinitialization.
New gstreamer-utils crate that currently contains only a StreamProducer
API. This allows building 1:N bridges between live pipelines via appsink /
appsrc elements.
Bindings for the new gstreamer-play library that was added in 1.20.
gst::Caps::new_empty_simple() to create caps without fields and just a
name.
gst_audio::AudioCapsBuilder and gst_video::VideoCapsBuilder for building
(possibly) unfixed raw audio/videos caps with typed setters for the various
fields. This makes it impossible to mix up types and e.g. use an u32
instead of an i32 for the width of video caps.
gst::Buffer::ptr_eq() to compare buffers by pointer instead of doing a
deep comparison, and also ptr_eq() on all other miniobject types.
Accessors for gst_webrtc::WebRTCICECandidateStats fields.
Bindings for the gstreamer-validate API.
Subclassing bindings for gst_audio::AudioVisualizer base class for easily
writing audio visualization elements.
gst_pbutils::EncodingProfile API for element properties.
Support for returning buffer lists from BaseSrc / PushSrc subclasses.
Support for implementing gst::Bin::do_latency().
Minimal bindings for the gstreamer-mpegts library.
Signature for gst_base::Aggregator::connect_samples_selected() to remove
unnecessary generic parameter and make it straightforward to use.
Various APIs had optional parameters/return types corrected to match the C API more closely.
Logging does not evaluate its arguments anymore if the debug category is not enabled or below the current threshold.
Registering custom metas is now possible without transform function.
gst::subclass::ElementImpl::request_new_pad() signature uses a &str
instead of an owned String now.
fragile dependency and instead use the same functionality from glib.
gst_audio::AudioAggregator ignore_inactive_pads property, which was
duplicated from the Aggregator base class.
Compatible with the 0.16 gtk-rs release.
Updated minimum supported GStreamer version from 1.8 to 1.14.
Updated to the latest GStreamer 1.22 APIs while still supporting up to GStreamer 1.14. Any new 1.22 APIs might still change until the stable 1.22 release.
Updated minimum supported Rust version to 1.63.
In EventView / QueryView, getters that return references now return
references that can outlive the view and are only bound by the lifetime of
the corresponding event/query.
In addition Query, Event and Message views are implemented more
consistently now, which makes them easier to use and as a side effect allows
to pass e.g. more strongly typed queries to functions that only accept a
single query type.
Various improvements to gst::ClockTime, gst::format::Bytes, gst::format::Signed
and related types and their usage in the API, which should make its use from
applications easier and less error-prone. Check the gst::format
module-level documentation for details.
gst::StreamsSelected event builder takes the selected streams as iterator
instead of slice.
For consistency with other macros the gst prefix of the logging macros was
also removed.
Various iterator implementations were added and the existing ones were optimized by implementing more specialized traits and custom implementations for a couple of iterator functions.
GStreamer initialization safety checks were optimized.
gst::Bus::post() takes ownership of the passed messages like the C API.
Better and easier to read Debug impls for Caps, TagList,
Structure and Promise.
ser_de feature was renamed to serde.
gst::Tracer implementations get result enums passed as Results now
instead of single enums.
gst::Pad, ProxyPad, GhostPad default functions are all associated
functions instead of methods now to avoid conflicts between multiple types
with the same method.
Pad tasks are catching panics from the task function and if the parent of
the pad is an element then the panic is converted into an error message and
the task is simply stopped. Otherwise the panic is rethrown.
Bindings for VideoAggregator and the VideoAggregatorPads.
VideoAggregator and the VideoAggregatorPads.AudioAggregator and the AudioAggregatorPads.TaskPool.VideoFormatInfo, VideoInfo and
VideoFrame.Require GStreamer 1.20.0 at least when building with v1_20. Earlier versions were already going to fail due to API mismatches before.
v1_20. Earlier
versions were already going to fail due to API mismatches before.gst::BufferPool subclassing support.Debug impl for gst::MiniObject.gst_rtsp_server::RTSPOnvifServer and related API, including subclassing
support.MiniObjectRef::downcast_ref() and similar functions return the correct
type now. While this is an API change, the previous API would've never
worked.Update gir files to GStreamer 1.20.0 release.
gst_video::VideoCodecFrame::input_buffer_owned() for getting an owned
reference.README.mds are correct again.Default implementation for gst_video::VideoOverlayComposition when targeting GStreamer 1.20.
Default implementation for gst_video::VideoOverlayComposition when
targeting GStreamer 1.20.gst_video::VideoOverlayComposition::add_rectangle() in addition to the
addition of all rectangles via an iterator during construction.gst_rtp::RTPHeaderExtension.gst_webrtc::WebRTCError for programmatically handling WebRTC errors.gst_rtp::RTPHeaderExtension has gst::Element set as parent class now.gst_rtp crate root.Send-able closures.fragile is no longer a dependency and instead the corresponding GLib API
is used.Message::view() also handles the redirect message now.
Message::view() also handles the redirect message now.Message and Query view variants that return references now borrow again
from the underlying query and not the view enum, allowing to use them in a
wider scope.VideoTimeCode, Structure and CapsFeatures are marked
as #[repr(transparent)] now to ensure that their memory representation is
exactly the underlying raw pointer.gst_rtp::RtpHeaderExtension::read() and write().
gst_rtp::RtpHeaderExtension::read() and write().gst::ElementMetadata has a const constructor now.gst_rtp::RtpBuffer API works on buffer references instead of plain buffers
for statically enforcing writability and usage in more places.gst_video::VideoCodecAlphaMeta and gst::CustomMeta.gst::MiniObject for generically passing around mini objects instead of
their concrete types.gst_app::AppSink new-event callback and pull_object() function.gst_pbutils::PbUtilsCapsDescriptionFlags and
pb_utils_get_caps_description_flags().gst_rtp::RtpBuffer::remove_extension_data().gst_video::VideoDecoder subframe API.gst_webrtc::WebRTCSCTPTransport.gst::ElementFactory create_with_properties() / make_with_properties().gst_video::VideoContentLightLevel and VideoMasteringDisplayInfo for HDR
signalling.GES API.gst::AllocationParams and support in the allocation query.propose_allocation() and decide_allocation() support in the various base
classes.Iterator implementation for gst_video::VideoOverlayComposition.Extend, IntoIterator and FromIterator implementations for Buffer,
Caps, BufferList, CapsFeatures, StreamCollection and Structure for
more natural Rust APIs.instant-rate-change events/messages bindings.Option<gst::ClockTime> and related
types.gst_video::ColorBalance.gst::MetaFlags.gst_base::Aggregator::set_position().gst::ElementFactory and
gst::DeviceProviderFactory metadata.gst_rtp::RtpBuffer::set_padding(), get_padding() and payload_mut().#[must_use] to many types and functions.gst::Event, gst::Message and gst::Structure has_name().gst_video::Navigation subclassing support and API improvements.gst::Structure and gst::Caps foreach(), map_in_place() and
filter_map_in_place().gst_gl::GLBufferPool and various GL constants and functions.gst_pbutils codec utils APIs.gst_base::BaseTransform::prepare_output_buffer() correctly reflects buffer
writability.gst::Sample::segment() returns a reference instead of a copy of the
segment.gst::Object::set_property_from_str() returns a Result now instead of silently
failing like the C version.gst_base::PushSrc::create.None in gst_player::Player::set_uri().[[f32; 4]; 4] instead of [f32; 16] for affine transformation matrix.gst::Pad::sticky_event() statically gets the event of the requested type
instead of requiring to match on it afterwards.gst_pbutils EncodingProfile API to be harder to misuse and less
confusing.gst::Array, gst::List, gst::IntRange and gst::Fraction API
improvements that should reduce some friction.NUL-terminated C strings in debug log API instead of
having multiple allocations per message.glib::SList and glib::List now to avoid copying
into a Vec if only iteration is needed.gst::ChildProxy API is more consistent with object property API.gst::Buffer::foreach(), gst::Pad::sticky_events_foreach() and
gst::BufferList::foreach() APIs.propose_allocation() and
decide_allocation().Compilation of gstreamer-audio on big-endian platforms.
gstreamer-audio on big-endian platforms.Gap event GapFlags.Structure::serialize() / Caps::serialize().…of request_pad() and in accordance with the deprecation in GStreamer 1.20.
#[repr(transparent)] where it is more correct and remove unneeded
#[repr(C)] annotations.gst::Message Debug impl.gst_rtsp_server::RTSPServer::attach() is fallible.gst::ElementFactoryListType is a proper bitflags type now instead of
generic u64.gst::PluginFeature::load() returns the same type as the one passed in.gst::PromiseFuture can no longer be freed while still
in scope.GError**s in subclassing code if they're not NULL.gst_player::PlayerVideoRenderer.gst::PARAM_FLAG_CONTROLLABLE and related bindings.gst_video::VideoOrientation and VideoOrientationMethod bindings.gst_check::Harness::pull_until_eos() bindings.ges::TransitionClip and OperationClip.gst_gl::GLMemory and related APIs.gst_gl::GLFilter and gst_gl::BaseSrc.gst::TagList::remove().gst::CapsFeatures and gst::Structure API based on glib::Quarks instead
of strings.gst_video::VideoFilter.gst_app::LeakyType,
gst_video::VideoDecoderRequestSyncPointFlags,
gst_rtp::RTPHeaderExtension, gst_audio::AudioLevelMeta,
gst_webrtc::WebRTCKind and various other new flags/enum types.gst_rtsp_server::RTSPMountPoints.gst_app::AppSink and AppSrc inherit from
gst_base::BaseSink and BaseSrc to avoid exposing API that is meant for
subclasses to applications.gst_app::AppSrc and AppSink signals that are also covered by the
callbacks. The callbacks are more flexible and have lower overhead.gst_base::BaseSink and BaseTransform
properties.gst_ prefix.get_ prefix anymore and GObject property
accessors don't include the _property_ part in the middle of their
function names anymore. Applications developers should use
fix-getters-calls to ease
migration of their applications.
Use fix-getters-def if you also
want your get functions definition to comply with the API standards applied
in this release.gst::ClockID bindings are refactored to use different types for
single-shot and periodic clock ids, which makes misuse harder.gst::ProxyPad extension trait uses trait functions instead of associated
functions now for usability reasons.Result<gst::FlowSuccess, gst::FlowError> for overriding flow returns
from pad probes.gst_video::VideoInfo::align() returns a Result instead of a bool.() in gst_sdp APIs.Display impl for gst::ClockTime provides better human-readable strings.gst::Element::link_filtered() and link_pads_filtered() takes a
non-optional caps now. That's easier to use and for not providing caps the
non-filtered variants of the functions exist.gst::Element::get_request_pad() is replaced by request_pad_simple() as a
simpler version of request_pad() and in accordance with the deprecation in
GStreamer 1.20.gst::ClockTime and APIs working on it were changed to make possibility of
using GST_CLOCK_TIME_NONE expressed in the type system.
Option<gst::ClockTime> can be None while gst::ClockTime is always a
valid time.Usage of the logging system with a GStreamer library with the logging system compiled out does not crash any longer.
gst_video::VideoTimeCode API when converting between
validated and unvalidated timecodes.gst::Element::get_current_state() and get_pending_state() convenience APIs.gst_audio::AudioConverterConfig for setting the configuration on e.g. the
audiomixer element. The low-level AudioConverter API is still not
included in the bindings.VideoTimeCodeInterval's Ord and PartialEq implementations compare against the correct fields now.
VideoTimeCodeInterval's Ord and PartialEq implementations compare
against the correct fields now.SDPMessage::medias_mut() iterator does not crash any longer.PartialEq and Eq implementations on VideoAlignment.VideoMeta and get_plane_height() / get_plane_size().VideoInfo::align_full().Make sure to use $crate in more macros to allow them to work without anything special in scope already.
$crate in more macros to allow them to work without
anything special in scope already.Display impl.Debug impl for gst_video::VideoTimeCode to print the correct type
name.v1_18.PadProbeReturn::Handled for events.EventRef::get_structure_mut() getter that allows changing the events'
structures.PhantomData markers and use repr(transparent) instead
of repr(C) where it is more correct.Correctly implement ExactSizeIterator on the AudioFormat and VideoFormat iterators. Previously they returned the overall size instead of the remaining
ExactSizeIterator on the AudioFormat and
VideoFormat iterators. Previously they returned the overall size instead
of the remaining size, and they didn't implement Iterator::size_hint().ExactSizeIterator on the buffer gst::Meta iterator. The
overall length is not known easily and the implementation would've simply
panicked in the past.gst::ClockID::wait_async_stream() for async integration for clock waiting.From / TryFrom impls for converting between gst::ClockTime and
std::time::Duration.Reset vfuncs if calling BaseTransformClass::configure() multiple times.
BaseTransformClass::configure() multiple times.gst::debug_remove_default_log_function() to actually remove the
default log function.gst_video::VideoFrame /
VideoFrameRef.gst::Pad::ProbeInfo code. This reduces
the code generated for each pad probe considerably.Updated bindings to 1.17.2, adding experimental 1.18 support. This can be opted-in via the "v1_18" feature flag but there might still be API changes i
gst::MemoryRef::dump() for dumping contents of a memory.gst::Bus::stream() instead of a custom constructor on the BusStream.Seqnum, GroupId and MetaSeqnum. These are
now proper wrapper types instead of plain integers, which makes misuse
harder.TryFrom impls for conversion between glib::DateTime and
gst::DateTime.get_allocator() functions to gst_base::{Aggregator, BaseTransform, BaseSrc}, and allow overriding BaseSrc::alloc().gst_base::PushSrc.gst::BufferCursor API that allows to handle a buffer as Read,
Write and Seek and accesses the underlying memories of the buffer
individually without mapping them all together.gst::Plugin::get_plugin_name().gst_video::VideoAFDMeta and VideoBarMeta.gst_audio::AudioFormat and
gst_video::VideoFormat.gst_video::VideoSink.gst::Pad can be constructed via the builder pattern and gst::PadBuilder
now, which allows to safely set the pad functions and various other fields
during construction. The PadBuilder works on any gst::Pad subclass and
also has special support for GhostPads by allowing to set pad functions of
the proxy pad.gst::Message, gst::Event and gst::Query type constructors are now on
the specific target type instead of various new_XXX() functions on the
basic type. E.g. gst::message::Eos::new().gst_audio::AudioSrc/Sink::reset().gst_base::BaseParse::stop().gst::Element::post_message().gst::BufferList::foreach() and foreach_mut().gst::Buffer::foreach_meta() and foreach_meta_mut().glib::Object as target object for logging instead of just
gst::Object.gst_pbutils::EncodingContainerProfile. They
are supposed to be used only with the other encoding profiles.&'static str for various gst::StructureRef functions where the
string is backed by a glib::Quark.gst::DateTime functions to actually return Options.gst::Pad getrange
function, allow passing one in into get_range() and pull_range() and
provide the corresponding API on gst_base::BaseSrc too.Decoder base classes is optional and can return
None.gst_video::ValidVideoTimeCode::add_interval() always returns a valid
timecode again.gst::Promise with None and also handle that correctly
in the callback. This is allowed by the API.gst::init().gst::Pad function setters are marked unsafe now as changing the functions
is not thread-safe.gst::Object::set_name() as changing the name after construction
generally causes problems and is potentially unsafe.gst::Pad::set_pad_template() as changing the pad template after
construction is generally unsafe.gst::Pad::stream_lock() borrows the pad now instead of taking a new
reference.Jitter and Buffer queries were removed from the bindings.
These are not implemented in C and only have a type registered.LAST, NONE variants of enums and flags were removed as these
only make sense in C.NonZeroU64/U32 for various ID types to allow further optimizations.thiserror crate for deriving error types.lazy_static to once_cell.gst::Caps::append() from taking
the object by value to modifying it internally. This makes them easier to
use and only applies to functions that are defined on the non-reference type
and take ownership of the values passed in.mem::ManuallyDrop instead of mem::forget() everywhere.mem::transmute() calls with safer alternatives.gst:StreamCollection API was changed to the builder pattern for
construction as the collection must not be changed after construction.gst::ProxyPad default functions are plain functions on ProxyPad now
instead of trait functions to allow easier usage of them.TryFrom impls.gst_video::VideoMeta::add() returns a Result now instead of panicking.new_with_XXX() and new_from_XXX()
to the more idiomatic with_XXX() and from_XXX().gst::GstRc type
anymore, instead everything is directly implemented on the concrete types.
As part of this the gst::MiniObject trait was also removed as it was
unneeded now.Allow multiple filter types per process with gst::Iterator::filter().
gst::Iterator::filter().VideoInfo is valid when creating a VideoFrame.NULL pointer when getting the format
from an invalid VideoInfo or AudioInfo.VideoFrameRefs.gst::ProtectionMeta, gst_video::VideoAffineTransformationMeta,
VideoCropMeta and VideoRegionOfInterestMeta bindings.gst_rtp::RTPBuffer methods.gst_audio::audio_buffer_truncate(), AudioMeta and AudioBuffer
bindings.Assert that the data passed to VideoCaptionMeta::add() is not empty.
VideoCaptionMeta::add() is not empty.Stream / Sink adapters. This would keep them alive unnecessarily
and would prevent the Stream / Sink to ever "finish" on its own.None reply in the change function of gst::Promise.
This is apparently valid. For backwards compatibility reasons this is
currently replaced with an empty structure but in 0.16 the API will
explicitly handle None.gst::Stream::debug() and gst::StreamCollection::debug() for converting
into a structured string with the actual contents of each.gst::Structure::from_iter() and gst::Caps::from_iter() to create
structures/caps from iterators.gst::Event support for getting/setting the gst::Stream in the
StreamStart event.gst_video::calculate_display_ratio() and ::guess_framerate().gst::CapsFeatures in gst_video.TryFrom/From impls for converting between gst::Structure and
gst_video::VideoConverterConfig.glib::Value trait impls for SDPMessage, StructureRef,
CapsFeatureRef and all borrowed variants of miniobjects to be able to
work with the borrowed, non-owned variants when handling glib::Values.Revert: Allow logging any glib::Object and not just gst::Object. This broke API in subtle ways and needs to wait until 0.16
glib::Object and not just gst::Object. This
broke API in subtle ways and needs to wait until 0.16% in log output with %% to prevent accidental C formattingBufferRef::peek_memory_mut() to give a mutable reference to a given memorygst_audio::AudioClippingMetagst::Plugin::get_plugin_name() was addedgst::Element::get_current_clock_time() and
`gst::Element::get_current_running_time() helper functionsgst::State and StateChange API for calculating next/previous state and
convert from/to the components of a state changemem::ManuallyDrop instead of mem::forget everywhereUniqueFlowCombiner::clear() should take a mutable reference.
UniqueFlowCombiner::clear() should take a mutable reference.AudioStreamAlign doesn't require mutable references for getters anymore.gst_video_info_set_format() and
gst_video_info_align() with GStreamer < 1.11.1 as it returned void back
then. We'd otherwise use some random value.VideoInfo::align() is available since 1.8.AppSrc, AppSink callbacks and Bus sync
handler. Before 1.16.3 this was not thread-safe and caused crashes. When
running with older versions changing them causes a panic now and unsetting
the bus sync handler has not effect. With newer versions it works correctly.Clone impls for BufferPoolConfig and PlayerConfig.VideoConverter bindings.Futures variant for gst::Promise constructor.Futures variant for gst_video::convert_sample_async().submit_input_buffer(), generate_output(), before_transform(),
copy_metadata() and transform_meta() virtual method support for
BaseTransform.AppSink Stream adapter and AppSrc Sink adapter for integrating
both into Rust async contexts.VideoFrame / VideoFrameRef functions to
allow usage in more generic contexts.Use static inner lifetime for VideoCodecState so that it can be stored safely on the heap.
VideoCodecState<Readable> so that it can be
stored safely on the heap.BinFlags on gst::Bin.gst::Caps::builder_full() for building caps with multiple structures
conveniently.gst::Element::call_async_future() for asynchronously spawning a closure
and returning a Future for awaiting its return value.PadFlags on gst::Pad now provide the correct
behaviour.gst::Bus Stream to close a
small race condition that could cause it to not be woken up.gst::ChildProxy implementers do not have to provide child_added() and
child_removed() functions anymore but these are optional now.Debug impls for various generic types where to Debug
impl should not depend on their type parameters also implementing Debug.StructureRef::get_optional() for returning None if the field does not exist instead of Err
StructureRef::get_optional() for returning None if the field does not
exist instead of Errgstreamer-rtp library, mostly RTPBufferPreset, TagSetter, Clock, SystemClock subclassesTypefind::get_length()BaseSrcImpl::get_times()AudioSink and AudioSrcSend/Sync impl for various typesVideoEncoder/VideoDecoder proxy_getcaps() can't return Noneis_video_overlay_prepare_window_handle_message() functionFnMut for the appsink callbacks instead of FnPromise change function returns the actual reply to the promise now
instead of just passing the promise itselfIterator::filter()BinImpl::add() takes ownership of floating referencesDeviceImpl::create_element() preserves floating flagBinImpl::remove() takes a strong reference of the element now as the last
reference might be owned by the bin and otherwise we would potentially have
a use-after-free afterwardsBaseParseFrame and VideoCodecFrame take a &mut self now for various
functions that actually change the frameNone to VideoEncoder::finish_frame()to_string() methods were moved into the Display trait impl and
for some types to_str() was added to return a &'static strSample constructor uses the builder pattern nowVideoMeta::add_full() is simplified and requires parametersBasetransformImpl::set_caps() returns a Result instead of boolOption now as these can be
None in practice although not allowed by the SDP specOptions were changed to return Results if
None actually signalled an error instead of just a missing valueSupport subclassing of gst::Device, gst::DeviceProvider, gst_audio::AudioDecoder and ::AudioEncoder
gst::Device, gst::DeviceProvider,
gst_audio::AudioDecoder and ::AudioEncoderElement::set_clock and ::provide_clock virtual methodsElementClass::add_metadata was addedgst_video::VideoDecoder and ::VideoEncoder got support for get_caps,
negotiate, src/sink_query/event and the drain virtual methodsElement::num_pads, ::num_src_pads and ::num_sink_pads functionsgst_video::VideoDecoder and ::VideoEncoder got get_allocator bindingsgst::Iterator implements IntoIterator now for providing
std::iter::Iterator<Item=<Result<T, IteratorError>> adapter#[macro_use] but
explicit importsDebug for gst::Iterator to allow it for any T
instead of T: DebugDevice::create_element has correct reference count handling nowNotNegotiated in the video codec base classes if setting the output
state fails instead of ErrorBindings for adding/removing custom log functions
calculate_linear_regression()Element::release_pad() virtual method implementationsYour coding agent can read these notes before it upgrades. Set up the MCP server →