// Take a look at the license at the top of the repository in the LICENSE file. use glib::{prelude::*, translate::*}; use crate::{prelude::*, Pipeline, PipelineFlags}; impl Pipeline { // rustdoc-stripper-ignore-next /// Creates a new [`Pipeline`] object with a default name. /// /// Use [`Pipeline::with_name()`] to create a [`Pipeline`] with a specific name. /// Use [`Pipeline::builder()`] to get a [`PipelineBuilder`] and then define a specific name. #[doc(alias = "gst_pipeline_new")] pub fn new() -> Pipeline { assert_initialized_main_thread!(); unsafe { crate::Element::from_glib_none(ffi::gst_pipeline_new(std::ptr::null())).unsafe_cast() } } // rustdoc-stripper-ignore-next /// Creates a new [`Pipeline`] object with the specified name. /// /// Use [`Pipeline::builder()`] for additional configuration. #[doc(alias = "gst_pipeline_new")] pub fn with_name(name: &str) -> Pipeline { assert_initialized_main_thread!(); unsafe { crate::Element::from_glib_none(ffi::gst_pipeline_new(name.to_glib_none().0)) .unsafe_cast() } } // rustdoc-stripper-ignore-next /// Creates a new builder-pattern struct instance to construct [`Pipeline`] objects. /// /// This method returns an instance of [`PipelineBuilder`] which can be used to create [`Pipeline`] objects. pub fn builder() -> PipelineBuilder { PipelineBuilder::new() } } mod sealed { pub trait Sealed {} impl> Sealed for T {} } pub trait GstPipelineExtManual: sealed::Sealed + IsA + 'static { fn set_pipeline_flags(&self, flags: PipelineFlags) { unsafe { let ptr: *mut ffi::GstObject = self.as_ptr() as *mut _; let _guard = self.as_ref().object_lock(); (*ptr).flags |= flags.into_glib(); } } fn unset_pipeline_flags(&self, flags: PipelineFlags) { unsafe { let ptr: *mut ffi::GstObject = self.as_ptr() as *mut _; let _guard = self.as_ref().object_lock(); (*ptr).flags &= !flags.into_glib(); } } #[doc(alias = "get_pipeline_flags")] fn pipeline_flags(&self) -> PipelineFlags { unsafe { let ptr: *mut ffi::GstObject = self.as_ptr() as *mut _; let _guard = self.as_ref().object_lock(); from_glib((*ptr).flags) } } } impl> GstPipelineExtManual for O {} impl Default for Pipeline { fn default() -> Self { glib::object::Object::new() } } // rustdoc-stripper-ignore-next /// A [builder-pattern] type to construct [`Pipeline`] objects. /// /// [builder-pattern]: https://doc.rust-lang.org/1.0.0/style/ownership/builders.html #[must_use = "The builder must be built to be used"] pub struct PipelineBuilder { builder: glib::object::ObjectBuilder<'static, Pipeline>, } impl PipelineBuilder { fn new() -> Self { Self { builder: glib::Object::builder(), } } // rustdoc-stripper-ignore-next /// Build the [`Pipeline`]. #[must_use = "Building the object from the builder is usually expensive and is not expected to have side effects"] pub fn build(self) -> Pipeline { self.builder.build() } pub fn auto_flush_bus(self, auto_flush_bus: bool) -> Self { Self { builder: self.builder.property("auto-flush-bus", auto_flush_bus), } } pub fn auto_flush_bus_if_some(self, auto_flush_bus: Option) -> Self { if let Some(auto_flush_bus) = auto_flush_bus { self.auto_flush_bus(auto_flush_bus) } else { self } } pub fn delay(self, delay: u64) -> Self { Self { builder: self.builder.property("delay", delay), } } pub fn delay_if_some(self, delay: Option) -> Self { if let Some(delay) = delay { self.delay(delay) } else { self } } pub fn latency(self, latency: impl Into>) -> Self { if let Some(latency) = latency.into() { Self { builder: self.builder.property("latency", latency), } } else { self } } pub fn latency_if_some(self, latency: Option) -> Self { if let Some(latency) = latency { self.latency(latency) } else { self } } pub fn async_handling(self, async_handling: bool) -> Self { Self { builder: self.builder.property("async-handling", async_handling), } } pub fn async_handling_if_some(self, async_handling: Option) -> Self { if let Some(async_handling) = async_handling { self.async_handling(async_handling) } else { self } } pub fn message_forward(self, message_forward: bool) -> Self { Self { builder: self.builder.property("message-forward", message_forward), } } pub fn message_forward_if_some(self, message_forward: Option) -> Self { if let Some(message_forward) = message_forward { self.message_forward(message_forward) } else { self } } pub fn name(self, name: impl Into) -> Self { Self { builder: self.builder.property("name", name.into()), } } pub fn name_if_some(self, name: Option>) -> Self { if let Some(name) = name { self.name(name) } else { self } } }