gstreamer

Fixed

• Only enable gst_allocators::FdAllocator on UNIX platforms.
• Add gst::Pad as parent class for gst_audio::AudioAggregatorPad.
• Fix inverted logic in gst_audio::AudioAggregatorPad::audio_info().

Changed

• Various new Rust 1.94 / 1.95 clippy warnings.

Added

• gst_base::BaseParse::sink_caps() vfunc.
• Bindings for various new 1.30 APIs.
• Display impl for gst::PadFlags.
• Various new API to gst-mpegts and gst-tag.
• Read+Seek impl for gst::TypeFind.

Fixed

• Fix setting user-set pad name being overwritten in gst::GhostPad builder.

Added

• Add some missing message types to gst::MessageType.
• Add some more acccessors to gst::Query, Message and Event types.

Fixed

• 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.
• Fix gst::Object::set_parent() behaviour and mark it as unsafe, and add a corresponding unsafe unset_parent().
• Allow construction of gst_app::AppSink with drop-out-of-segment property.

Added

• Initial bindings for the gstreamer-vulkan library, including XCB and Wayland API support.
• gst_audio::AudioChannelPosition implements Display now.
• Support for wrapping e.g. a 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.
• Implement 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.
• Various missing gst::Memory / gst::Buffer APIs that are rarely used.

Changed

• 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.

Added

• Add bindings for gst::segtrap_is_enabled() and segtrap_set_enabled().
• Add gst::MiniObject::mark_may_be_leaked().
• Add bindings for gst::DynamicTypeFactory.
• Add bindings for gst_tag::image_data_to_image_sample().
• Add bindings for all tags from gst_tag.
• Add various missing gst::Memory / gst::Buffer method bindings.
• Add some missing message types to gst::MessageType.
• Add some more acccessors to gst::Query, Message and Event types.

Fixed

• Add assertions for invalid fourcc/modifiers in gst_video::dma_drm_fourcc_to_string().
• Fix gst::Bus::timed_pop_filtered() timeout semantics.
• Fix return value ownership transfer in gst_validate::setup_test_file().
• Fix setting out-of-segment via the gst_app::AppSink builder.
• Fix setting user-set pad name being overwritten in gst::GhostPad builder.

Changed

• Update to latest 1.28 and upcoming 1.30 APIs.

Added

• Add Buffer::try_into_inner() and Memory::try_into_inner() to extract a wrapped Rust value (e.g. a Vec<u8>).
• Add Memory::default_alignment(), implement alloc() for the Rust allocator and add gst::rust_allocator() for getting a reference to the allocator.

Fixed

• Export auto module in gstreamer-tag so that TagImageType is actually accessible.
• Fix gst::Allocator subclassing API. This was not actually usable before and as such the fixing required a couple of breaking changes.
• Fix docs build on docs.rs.

Changed

• Update gst_analytics::AnalyticsBatchMeta and gst_validate to the latest API.
• Fix various new clippy / compiler warnings.
• Various cleanups to wrapped memory implementation.

Added

• gst_video::is_dma_drm_caps() helper function.
• gst_tag::TagImageType enum.
• gst::ControlBinding property_name() and property_pspec() accessors.
• Remove some unused imports and dead code warnings on macOS.
• New gst_controller::TimedValueControlSource::list_control_points() 1.28.

Changed

• ges::TimelineElement accepts any Into<glib::Value> in set_child_property() now.

Fixed

• Allow using DMA_DRM and ENCODED formats with gst_video::VideoMeta and VideoInfo APIs by improving / relaxing parameter validation.
• Refer to gst::IdStr by full path in gst::id_str!() macro.

Added

• gst::MiniObject::downcast_ref() and downcast_mut() that operate on the non-ref type.
• More documentation and convenience constructors for 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.

Changed

• Update to latest GStreamer 1.28 APIs.

Fixed

• Removed incomplete offset/stride checks in gst_video::VideoInfo builder.
• Various new 1.89 clippy warnings
• Mark allocator used by 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.
• Don't unnecessarily check if validate is initialized to build action types.

Added

• Added gst_video::VideoMeta::add_from_info() that takes a VideoInfo instead of individual parameters.

Changed

• Compatible with gtk-rs-core 0.21 / gtk4-rs 0.10.
• Update GStreamer gir files to latest (upcoming) 1.28 APIs.
• Minimum support Rust version is updated from 1.71.1 to 1.83.
• 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.
• Rework of gst_validate action and action type API.
• Rework of gst_play::PlayMessage API to be easier to use correctly.
• Remove 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.
• Return iterators instead of Vecs from more functions.
• Make gst::event::SelectStreams builder API for convenient.
• Add #[must_use] annotations to all iterator structs.
• Return gst_video::VideoInfo and gst_audio::AudioInfo references from more functions instead of copies.
• Change some gst::Clock functions to not return Options anymore.
• Change gst_sdp::SDPMedia::set_media_from_caps() to a method.
• Various gst_allocators allocator API was moved to extension traits and renamed to not have the same name as a method of the parent class.

Added

• Allow setting generic properties as part of the gst_app::AppSink and AppSrc, gst::Bin and gst::Pipeline builders.
• Bindings for the gstreamer-mse library.
• Bindings for the gstreamer-d3d12 library.

Removed

• API deprecated in previous releases was removed.
• gst_webrtc::DataChannel duplicated signal API was removed.

Fixed

• Provide existing messages immediately from a gst::Bus stream when creating it instead of only providing them on the next message.

Added

• gst::QueryType enum and accessor for it from queries.

Changed

• Don't unnecessarily store buffer twice in gst_gl::GLVideoFrame.
• Don't store memory twice in gst::memory::MemoryMap and MappedMemory.

Fixed

• Lower debug message level when allocation queries in subclasses fail.
• Catch panics from typefinders implemented in Rust.
• Use correctly aligned arrays in gst_audio tests.
• Drop pad probes and callbacks from appsink when releasing a gst_utils::StreamProducer.
• Leak in gst::ElementImpl::parent_request_new_pad().
• Request a new keyframe from gst_utils::StreamProducer when discarding a buffer.

Added

• Implement gst::ByteSliceExt over all AsRef<[u8]> instead of just &[u8] and &mut [u8].
• gst::Allocator::memory_type() getter.
• Setters for gst::AllocationParams and implement Copy, PartialEq and Eq.
• New API for creating a gst_audio::AudioInfo and gst_video::VideoInfo builder from an existing value.
• Setters for gst_video::VideoAlignment and implement Default.
• Implement 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.
• Bindings for gst_tag language code API.

Changed

• Update various dependencies.
• Update to GStreamer 1.26.1 gir files.

Fixed

• Properly validate gst::IntRange::with_step() step size
• Fix gst::Buffer serde serialization
• Forward gap events by default in gst_utils::StreamProducer.
• Correctly account for alternate interlace mode in gst_video::VideoMeta::add_full().
• Return Results instead of bools in new gst_play API.

Added

• Support for TracerImpl::USE_STRUCTURE_PARAMS with GStreamer < 1.26.
• Bindings for gst_analytics::ODMtd.
• Bindings for TopSurroundRight and TopSurroundLeft audio channels.
• Bindings for AV1 and H266 codec helpers API.
• Bindings for gst_audio::reorder_channels_with_reorder_map().

Changed

• Updated GStreamer gir files for latest 1.26 APIs.
• Documentation links URL was updated.

Fixed

• 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.
• Order of arguments in gst_video::VideoFormat::from_mask() was corrected.

Added

• Bindings for 1.26 gst_analytics::Tensor API.
• gst::DebugCategory::as_ptr() and Hash impl, gst::DebugMessage::as_ptr().
• Support for hex-dumping &mut [u8] in addition to &[u8], gst::Buffer, etc.
• Functions to work with meta glib::Types.

Changed

• Updated GStreamer gir files for latest 1.26 APIs.

Fixed

• Bind gst::Pad::proxy_query_caps() to the correct C function.
• Update gst_utils::StreamProducer appsrc latency upon appsink latency event.
• Fix type of gst_app::AppSinkBuilder::processing_deadline().

Added

• Various new gst::Iterator constructors for convenience.

Changed

• Updated GStreamer gir files for latest 1.26 APIs.

Fixed

• Lifetime of gst::TagList::index() return value is correctly bound to &self now.
• Don't assume gst::Structure name / field names have 'static lifetime.
• Set pad probe data to NULL if HANDLED is returned and the item is an event, buffer or buffer list.
• Don't unnecessarily add #[link] attribute to the extern "C" sections to allow linking against gstreamer-full and make static linking easier.

Changed

• Add #[must_use] to gst_video::VideoTimeCode::add_interval().

Added

• Add API to take events/buffers from a gst::PadProbeInfo.
• Add gst::EventViewMut and gst::Event::view_mut(), and a few setters for event fields.
• Add gst::MessageViewMut and gst::Message::view_mut(), and a few setters for message fields.

Fixed

• Support gst_utils::StreamProducer API on platforms without 64 bit atomics.
• Fix off-by-one in gst::BufferList::remove() range end handling.
• Pass an empty tag array instead of NULL in gst::CustomMeta::register_simple().
• Fix various new clippy warnings.

Added

• Add getters for gst::format::Percent.

Changed

• Compatible with gtk-rs-core 0.20 / gtk4-rs 0.9.
• Update GStreamer gir files to latest (upcoming) 1.26 APIs.
• Minimum support Rust version is updated from 1.70 to 1.71.1.
• Move gst::Meta tags into separate modules and improve API around them.
• Improve gst::Meta transform functions and make the API more generic, and as part of that add support the video meta transform.
• Pass an immutable instead of mutable output buffer reference to gst_rtp::RtpHeaderExtension::write() function.
• Make gst_net::PtpClock::new() constructor fallible.
• Change gst_rtsp_server::RTSPToken API to be consistent with gst::Structure, specifically add a builder.
• Change from_glib_ptr_borrow() functions to work with references instead of raw pointers for improved safety.
• Improve code generation when building with panic=abort.
• Change gst::BufferList APIs to work with ranges instead of index+length.
• Use various 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.

Added

• Mutable access to the 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.
• Adapter for the 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.
• Bindings for the double click gst_video::Navigation event.
• Bindings for gst_pbutils missing/install plugins API.
• Setters for gst_editing_services::FrameCompositionMeta.
• ges::UriClipAsset::new().

Fixed

• When logging with an id and a formatted log message this would previously panic.
• A couple of clippy warnings.

Fixed

• A couple of clippy warnings and compiler warnings about unused imports with latest rustc.
• Memory leak in builder for the SelectStreams event.
• Add parameter validity assertions to various BufferList and Caps APIs where these assertions were missing to avoid assertions in C.

Added

• StreamProducer::set_forward_preroll() API to configure if the preroll buffer should be directly forwarded or not yet.

Changed

• Remove nonsensical gstreamer-video test that fails with latest GStreamer main.
• Update to itertools 0.13.

Added

• Implement From<glib::Value> / ToValue for gst_audio::AudioConverterConfig and gst_video::VideoConverterConfig.

Changed

• Fixed various 1.77 clippy warnings.

Changed

• Change ges::CompositionMeta position fields to f64s in correspondence with the C API.
• Change gst_analytics::AnalyticsMtdRef::obj_type() to an Option in correspondence with the C API.

Added

• gst::Fraction::new_raw() and from_integer() const constructors.

Changed

• Update GStreamer gir files and add more new 1.24 API.

Fixed

• Add gst::Object as parent class for various gst_rtp types.
• Handle all already queued messages in gst::BusStream instead of just new messages.

Added

• Add gst::CustomMeta::is_registered().

Changed

• Update GStreamer gir files and add more new 1.24 API.

Fixed

• Make AnalyticsODLocation struct fields public.
• MetaRefMut::upcast_mut() returns a mutable reference now.

Changed

• Compatible with gtk-rs-core 0.19 / gtk4-rs 0.8.
• Update GStreamer gir files to latest (upcoming) 1.24 APIs.
• Various standalone functions were moved to separate modules or methods.
• gst::Rank is not implemented as an enum but as a struct with associated constants now.
• Optimized gst::Buffer::from_slice() and Memory::from_slice() implementations that have one heap allocation fewer.
• Various gst::Buffer and gst::Memory functions take ranges now instead of offset/size parameters.

Added

• Bindings for gst_gl::GLContext::thread_add(), GLFrameBuffer::draw_to_texture().
• New gst_gl::GLVideoFrame type that replaces gst_video::VideoFrame for GL-specific API, and comes with mostly the same interface.
• Basic gstreamer-tag bindings.
• gst::Buffer:dump() and dump_range() together with the same API on gst::Memory for hex-dumping the whole buffer/memory content.
• Implement Clone on gst::MetaRef.
• Bindings for gst::Buffer::map_range_readable() and its writable variant.
• Array-based accessor for gst_video::VideoFrame and gst_audio::AudioBuffer plane data.
• Support for handling custom authentication in gstreamer-rtsp-server.
• Accessors for various base class struct fields.
• Owned buffer getter for AudioBuffer / VideoFrame.
• gst_rtp::RTPSourceMeta bindings.
• gst::macos_main() bindings.
• gstreamer-analytics bindings.

Fixed

• API typo in owned gst::ReferenceTimestampMeta reference getter.
• Allow variable expansion in gst::loggable_error! macro.
• gstreamer-gl-* crates can build docs again on stable.

Removed

• gst::Pad::caps() property getter. Use current_caps() instead which does the same thing.
• Various deprecated APIs that were deprecated in previous releases.
• Getter for a mutable buffer reference from AudioBuffer / VideoFrame as that allowed invalidating the buffer map.

Fixed

Added

• Update GStreamer gir files to latest (upcoming) 1.24 APIs.
• Add an example for writing subclasses with virtual methods.
• Add gst::ClockTime::absdiff() and same for similar types.

Fixed

• In Play example, set bus to flushing before dropping Play instance.
• Add missing docsrs configuration for correct documentation generation.
• Make gst_pbutils::element_properties module public.
• Add missing gst_audio::AudioFilterImpl::parent_allowed_caps().
• Fix assertions in gst::Memory copy/share/resize functions.

Changed

• Update to itertool 0.12, pretty-hex 0.4.

Changed

• Update GStreamer gir files to latest (upcoming) 1.24 APIs.
• Update to latest gir code generator from the gtk-rs 0.18 branch.

Fixed

• Big endian video format order is correct again.
• 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.
• Fix another potential deadlock in gst_utils::StreamProducer when sending force-keyunit events.

Added

• Bindings for gst_video::VBIEncoder and VBIParser.
• Accessors for the different 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.

Changed

• Update GStreamer gir files to latest (upcoming) 1.24 APIs.

Fixed

• Use correct media links in the tutorials code.
• Fix a couple of new 1.72/1.73 clippy warnings.
• Fix description of gstreamer-validate crate.
• Copyright/license files for the gstreamer-gl were added.
• Ordering of raw video formats follows the rules of latest libgstvideo now.
• Fix potential deadlock in gst_utils::StreamProducer when sending force-keyunit events.

Added

• max-time / max-bytes setters to gst_app::AppSink builder.
• gst::CustomMeta::register_simple().

Changed

• Minimum supported Rust version is updated to 1.70.0.
• Compatible with gtk-rs-core 0.18.
• 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.
• The preroll samples and selected sticky events are forwarded to StreamProducer consumers.

Added

• Support for the upcoming GStreamer 1.24 APIs.
• Support for inline variable names in format strings for error/warning/info messages.
• Methods for converting between floating point seconds and gst::ClockTime.
• Various additions to the gst-validate bindings.
• Display implementations for error/warning/info messages.
• More useful Debug implementations for messages, events and queries and gst_pbutils::DiscovererInfo related structs.
• API for listing/checking gst::Meta tags.

Fixed

• Fix wait-for-eos property name string in appsink.
• Fix various memory leaks in BaseTransform subclassing bindings.
• Mark some GES APIs as Send+Sync.

Added

• Implement DiscovererInfo::debug() and on related structs.

• Add subclassing bindings for GESFormatter.

Added

• Getter for the gst_rtsp_server::RTSPContext URI field.

Fixed

• gst_pbutils::DiscovererStreamInfo::stream_id() can return NULL. This is mapped to the empty string for this release to keep backwards compatibility.
• gst_pbutils::DiscovererStreamInfo iterator methods can be called on any subclass directly now without casting.
• Debug logs use the actual function name against instead of the name of a closure generated by the log macros.

Changed

• Minor performance improvements to debug logging.

Added

• glib::HasParamSpec impl for miniobjects to allow using them with the properties derive macro.
• Default impl for gst_player::Player.

Fixed

• gst::ParamSpecArray uses the correct glib::Type now.
• Work around accidental ABI breakage in 1.18 gst-rtsp-server GstRTSPClient.

Added

• Document gst_utils::StreamProducer::forward_eos() default value.

Added

• glib::HasParamSpec impl for gst::ClockTime
• Default impl for gst_play::Play
• Constructors for non-raw gst_audio::AudioCapsBuilder / gst_video::VideoCapsBuilder

Fixed

• Make gst_gL::GLDisplay::create_context() other_context parameter optional.
• Make allocation query caps optional.

Added

• Conversions between gst::Signed<T> and T and signed integer types.
• Bindings for the object lock via gst::Object::lock().
• Various FromIterator, Extend and From impls for creating Caps, Structure, Buffer, BufferList, CapsFeatures and other types.
• PartialEq impls between owned/borrowed miniobjects/structures.
• API for appending items to gst::Array and gst::List.

Changed

• Compatible with the 0.17 gtk-rs release.
• Updated minimum supported Rust version to 1.64.
• Require GStreamer 1.22.0 or newer when enabling the v1_22 feature.
• Require the object lock to be taken for various gst_gl::GLDisplay methods.
• Renamed gst::TagSetter::add() to add_tags() to avoid name conflict with Bin::add().
• Mark various un-extendable enums as exhaustive.
• Make use of glib::GStr and related API in caps, structure, tags and logging API to reduce temporary string allocations.
• Various code optimizations to reduce generated code size and allow more optimal code to be generated.
• Reduce size of various types, including reduction of gst_audio::AudioInfo from 832 to 320 bytes.
• Use actual function name instead of module name in log output.
• Change gst_utils::StreamProducer API to forward buffers by default and allow temporarily discarding via new set_discard() function.

Changed

• Update GStreamer .gir files to 1.22.0 release.

Fixed

• Marked gst::MessageType as non-exhaustive.

Added

• Added bindings for gst::Message::structure_mut().
• Added subclassing support for gst_allocators::FdAllocator and DmabufAllocator.

Fixed

• Work around the possibility that the caps in the allocation query can be NULL by returning any caps for now. This will be handled properly with a minimal API change in the 0.20 release.

Fixed

• The AppSrc and AppSink builders now assert that GStreamer is initialized before creating an instance.

Fixed

• 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.
• Allow returning Handled from BufferList pad probes.

Changed

• Update GStreamer .gir files to latest 1.21 git.

Added

• Subclassing bindings for gst_audio::AudioFilter.

Fixed

• Various new clippy warnings.

Changed

• Update GStreamer .gir files to 1.21.3 release.

Added

• FromIterator<Caps> and Extend<Caps> for Caps.
• PartialEq impls between owned/borrowed miniobjects/structures.

Fixed

• Sticky event ordering for instant-rate-change.

Changed

• Updated GStreamer .gir files to post 1.22.2 release.

Added

• Subclassing support for gst::Allocator.
• gst_gl::GLBaseMemory::context() to retrieve the GL context used by the memory.

Changed

• Updated GStreamer .gir files to 1.22.2 release.

Fixed

• gst::Allocator::register() does not cause use-after free with GStreamer < 1.20.5 anymore.
• Don't generate version constants in gstreamer-editing-services-sys as they are useless and change with every update.

Changed

• Fixed various new clippy warnings.

Changed

• Make it possible to use objects not just as reference in the logging macros.

Added

• 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.

Fixed

• 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.

Removed

• 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.

Changed

• 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.

Added

• Bindings for RTPBasePayload and RTPBaseDepayload.
• Accessors for RTPBuffer buffer.
• Bindings for RTPBuffer length calculation API.
• More complete gst::Task bindings.

Fixed

• Export gst::subclass::TaskPoolFunction.

Added

• Bindings for VideoAggregator and the VideoAggregatorPads.
• Bindings for AudioAggregator and the AudioAggregatorPads.
• Bindings for TaskPool.
• Various helper functions for VideoFormatInfo, VideoInfo and VideoFrame.

Fixed

• Require Send and not Sync for the values of an gst::Array / gst::List.

Changed

• Simplify and speed up log message string construction

Changed

• Require GStreamer 1.20.0 at least when building with v1_20. Earlier versions were already going to fail due to API mismatches before.

Added

• gst::BufferPool subclassing support.
• Debug impl for gst::MiniObject.
• gst_rtsp_server::RTSPOnvifServer and related API, including subclassing support.

Fixed

• Handle empty slices correctly at the FFI layer.
• MiniObjectRef::downcast_ref() and similar functions return the correct type now. While this is an API change, the previous API would've never worked.

Added

• 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.
• Subclassing support for gst_rtp::RTPHeaderExtension.
• gst_webrtc::WebRTCError for programmatically handling WebRTC errors.

Fixed

• gst_rtp::RTPHeaderExtension has gst::Element set as parent class now.
• Global functions are re-exported from the gst_rtp crate root.

Changed

• GIO-style async operations in GES no longer need Send-able closures.

Removed

• fragile is no longer a dependency and instead the corresponding GLib API is used.

Added

• glib::FromValue for mini object references.
• Bindings for gst::DebugCategory::get_line().

Fixed

• 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.

Changed

• All miniobjects, VideoTimeCode, Structure and CapsFeatures are marked as #[repr(transparent)] now to ensure that their memory representation is exactly the underlying raw pointer.

Added

• 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.
• Lots of missing 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.
• Support for arithmetic operations on Option<gst::ClockTime> and related types.
• gst_video::ColorBalance.
• gst::MetaFlags.
• gst_base::Aggregator::set_position().
• Convenience getters for 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.

Fixed

• gst_base::BaseTransform::prepare_output_buffer() correctly reflects buffer writability.

Changed

• Compatible with the 0.15 gtk-rs release.
• Updated to the latest GStreamer 1.20 APIs while still supporting up to GStreamer 1.8. Any new 1.20 APIs might still change until the stable 1.20 release.
• Update all code to the Rust 2021 edition. This causes no user-facing changes.
• 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.
• Allow handling passed in buffers in gst_base::PushSrc::create.
• Allow passing in None in gst_player::Player::set_uri().
• Use [[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.
• Clean up gst_pbutils EncodingProfile API to be harder to misuse and less confusing.
• Various gst::Array, gst::List, gst::IntRange and gst::Fraction API improvements that should reduce some friction.
• Directly generate NUL-terminated C strings in debug log API instead of having multiple allocations per message.
• Various functions return 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.
• Improved gst::Buffer::foreach(), gst::Pad::sticky_events_foreach() and gst::BufferList::foreach() APIs.
• Don't post error messages from propose_allocation() and decide_allocation().

Added

• Add constructor for device provider metadata.

Fixed

• gst::Value::deserialize() takes the target type as parameter now. This is technically an API change but the function would've never worked previously.

Added

• The release date-time parameter to gst::plugin_define! is optional now like in the C version of the macro.
• Bindings to gst::Tracer and gst::TracerFactory for allowing to implement custom tracers in Rust.
• Bindings for the new gst::Value::deserialize_with_psec() function from GStreamer 1.20.
• serde Serialize/Deserialize impls for gst::PadDirection, gst::PadPresence, gst::URIType and gst::Rank.

Fixed

• Various new clippy warnings.
• Compilation of gstreamer-audio on big-endian platforms.

Added

• Support for 1.20 Gap event GapFlags.
• Support for 1.20 Structure::serialize() / Caps::serialize().