gstreamer-app-sys

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.

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

• 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

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

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.

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

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

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

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.

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

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

Fixed

• Use #[repr(transparent)] where it is more correct and remove unneeded #[repr(C)] annotations.
• Don't provide direct access to the logged object in logging functions as the object might currently be finalized and might be unsafe to access.
• Moved X11/EGL/Wayland-specific GL APIs into their own crates instead of having them inside gstreamer-gl and behind feature flags. This simplifies conditional usage of them in applications.
• Various nullability issues: parameters and return values that should've been or shouldn't have been nullable were fixed.
• Print source object correctly in 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.
• Value returned by gst::PromiseFuture can no longer be freed while still in scope.
• Only assign to GError**s in subclassing code if they're not NULL.

Added

• Bindings for the GStreamer Controller library and the corresponding core API.
• Subclassing support for gst_player::PlayerVideoRenderer.
• gst::PARAM_FLAG_CONTROLLABLE and related bindings.
• gst_video::VideoOrientation and VideoOrientationMethod bindings.
• Support for removing pad probes from inside the pad probe callback.
• gst_check::Harness::pull_until_eos() bindings.
• ges::TransitionClip and OperationClip.
• Bindings for gst_gl::GLMemory and related APIs.
• Subclassing support for gst_gl::GLFilter and gst_gl::BaseSrc.
• gst::TagList::remove().
• gst::CapsFeatures and gst::Structure API based on glib::Quarks instead of strings.
• Subclassing support for gst_video::VideoFilter.
• Bindings for various new 1.20 APIs: gst_app::LeakyType, gst_video::VideoDecoderRequestSyncPointFlags, gst_rtp::RTPHeaderExtension, gst_audio::AudioLevelMeta, gst_webrtc::WebRTCKind and various other new flags/enum types.
• Subclassing support for gst_rtsp_server::RTSPMountPoints.

Removed

• Deprecated APIs in 0.16.
• Don't declare that 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.
• Duplicated getters/setters for gst_base::BaseSink and BaseTransform properties.

Changed

• Compatible with the 0.14 gtk-rs release.
• Updated to the new 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.
• FFI and safe high-level bindings are in the same repository now and use the same version numbers.
• The .gir files are shared with gtk-rs and the GStreamer-specific ones are in a separate git submodule.
• Update all code to the Rust 2018 edition. As part of this, most macros lost their gst_ prefix.
• Re-export dependency crates from the different preludes.
• Getter functions don't have a 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.
• Lots of changes to the subclassing API. Check the various elements in gst-plugins-rs for examples.
• Major improvements to the documentation infrastructure and generated documentation.
• 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.
• Use Result<gst::FlowSuccess, gst::FlowError> for overriding flow returns from pad probes.
• gst_video::VideoInfo::align() returns a Result instead of a bool.
• Use actual error types instead of () 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.
• Replace various manual bindings with auto-generated ones.
• 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.

Fixed

• Export FlowError/FlowSuccess, ClockError/ClockSuccess, PadLinkError/PadLinkSuccess too

Added

• Bindings for (outputting to) the GStreamer logging system
• Bindings for the GStreamer base library
• Bindings for all the Pad functions to override pad behaviour, and pad task functions
• Bindings for StaticCaps and StaticPadTemplate
• Bindings for deep-notify signal on Object
• Support for directly creating Error/Warning/Info Messages and posting them from an element with context information (file, line, module, etc.) similar to the C GST_ELEMENT_ERROR macro
• Support for setting custom fields in Messages/Events during construction
• Support for creating Buffers out of anything that is AsRef<[u8]> or AsMut<[u8]>
• Support for using the Read trait on Adapter
• Functions for getting all sink/src/all pads of an Element, and all children of a Bin
• Builder for Caps and Structures in addition to the existing functions
• AppSrc/AppSink implement BaseSrc/BaseSink and URIHandler
• Rust ports of the basic tutorials 1 to 8 from https://gstreamer.freedesktop.org/documentation/tutorials/
• "Getting started" and "Installation" sections to the README.md
• "dox" feature for generating documentation for all available configurations

Fixed

• StackTraceFlags are only available since 1.12
• Worked around macOS requiring a NSRunLoop running on the main thread in all examples and tutorials, to be able to show a window or anything else

Changed

• ClockTime is now a wrapper around Option<u64> to handle the CLOCK_TIME_NONE case better. This wrapper implements all the arithmetic and other traits as needed and ensures that no accidental calculations with CLOCK_TIME_NONE can happen
• "Values with format", like in Duration/Position/Convert queries or Seek events now return a FormatValue type. This contains the actual Format together with the value and does any required conversions. This also makes it harder to accidentally mix e.g. values in bytes and time
• PadProbeId does not implement Clone/Copy anymore
• Property notify watches return a custom type instead of ulong
• Error/Warning/Info Messages can only be created with specific kinds of glib::Error now. Using arbitrary ones does not work
• Iterator bindings were completely rewritten and provide the item type as a generic type parameter now, greatly simplifying its usage
• All glib::Values are now glib::SendValue instead, e.g. in Caps and Structures, as their content must be possible to send to different threads safely
• Message::get_src() can return None
• Allow None as Caps in AppSrc/AppSink
• Allow everything implementing Into<Option<&str>> to be used as a pad name
• Moved copy() from GstRc directly to MiniObject
• Success/Error enums (like FlowReturn, PadLinkReturn, StateChangeReturn) now implement an into_result() function that splits them into a Result with the good and bad cases. Also mark them as #[must_use] to make it harder to accidentally ignore errors.
• Error enums implement the Error trait
• Many examples use the failure crate for error handling now, cleaning up the error handling code quite a bit
• Lots of other code cleanup, compiler/clippy warning cleanup, etc.

Added

• Implement Send+Sync for Query, Message and Event, and their corresponding Ref types.

Fixed

• Constructor for gst_player::Player now works properly with GStreamer 1.12 when passing a video renderer or signal dispatcher. There was a reference counting bug.
• Instead of returning &'static references from functions, return references with a generic, unbound lifetime instead. See https://github.com/rust-lang/rust/pull/42417#issue-233404573
• Various "unused external crate" warnings and clippy warnings everywhere.

Changed

• Remove Cargo.lock from GIT, it's not very useful for library crates.
• Run everything through latest rustfmt-nightly.
• Use while-let (instead of loop and if-let) and CLOCK_TIME_NONE (instead of u64::MAX) in the examples.

• Initial release of the autogenerated GStreamer bindings. Older versions (< 0.8.0) of the bindings can be found here. The API of the two is incompatible.