// Take a look at the license at the top of the repository in the LICENSE file. #[macro_export] macro_rules! mini_object_wrapper( ($name:ident, $ref_name:ident, $ffi_name:path, $get_type:expr) => { pub struct $name { obj: std::ptr::NonNull<$ffi_name>, } #[repr(transparent)] pub struct $ref_name($ffi_name); impl $name { pub unsafe fn from_glib_none(ptr: *const $ffi_name) -> Self { skip_assert_initialized!(); assert!(!ptr.is_null()); $crate::ffi::gst_mini_object_ref(ptr as *mut $crate::ffi::GstMiniObject); $name { obj: std::ptr::NonNull::new_unchecked(ptr as *mut $ffi_name), } } pub unsafe fn from_glib_full(ptr: *const $ffi_name) -> Self { skip_assert_initialized!(); assert!(!ptr.is_null()); $name { obj: std::ptr::NonNull::new_unchecked(ptr as *mut $ffi_name), } } pub unsafe fn from_glib_borrow(ptr: *const $ffi_name) -> $crate::glib::translate::Borrowed { skip_assert_initialized!(); assert!(!ptr.is_null()); $crate::glib::translate::Borrowed::new($name { obj: std::ptr::NonNull::new_unchecked(ptr as *mut $ffi_name), }) } pub unsafe fn replace_ptr(&mut self, ptr: *mut $ffi_name) { assert!(!ptr.is_null()); self.obj = std::ptr::NonNull::new_unchecked(ptr); } pub fn make_mut(&mut self) -> &mut $ref_name { unsafe { if self.is_writable() { return &mut *(self.obj.as_mut() as *mut $ffi_name as *mut $ref_name); } let ptr = $crate::ffi::gst_mini_object_make_writable( self.as_mut_ptr() as *mut $crate::ffi::GstMiniObject ); self.replace_ptr(ptr as *mut $ffi_name); assert!(self.is_writable()); &mut *(self.obj.as_mut() as *mut $ffi_name as *mut $ref_name) } } pub fn get_mut(&mut self) -> Option<&mut $ref_name> { if self.is_writable() { Some(unsafe { &mut *(self.obj.as_mut() as *mut $ffi_name as *mut $ref_name) }) } else { None } } pub fn is_writable(&self) -> bool { unsafe { $crate::glib::translate::from_glib($crate::ffi::gst_mini_object_is_writable( self.as_ptr() as *const $crate::ffi::GstMiniObject )) } } pub unsafe fn into_ptr(self) -> *mut $ffi_name { let s = std::mem::ManuallyDrop::new(self); s.as_mut_ptr() } } impl Clone for $name { fn clone(&self) -> Self { unsafe { $name::from_glib_none(self.as_ptr()) } } } impl Drop for $name { fn drop(&mut self) { unsafe { $crate::ffi::gst_mini_object_unref(self.as_mut_ptr() as *mut $crate::ffi::GstMiniObject); } } } impl std::ops::Deref for $name { type Target = $ref_name; fn deref(&self) -> &Self::Target { unsafe { &*(self.obj.as_ref() as *const $ffi_name as *const $ref_name) } } } impl AsRef<$ref_name> for $name { fn as_ref(&self) -> &$ref_name { &*self } } impl std::borrow::Borrow<$ref_name> for $name { fn borrow(&self) -> &$ref_name { &*self } } impl $crate::glib::types::StaticType for $name { fn static_type() -> $crate::glib::types::Type { $ref_name::static_type() } } impl<'a> $crate::glib::translate::ToGlibPtr<'a, *const $ffi_name> for $name { type Storage = &'a Self; fn to_glib_none(&'a self) -> $crate::glib::translate::Stash<'a, *const $ffi_name, Self> { $crate::glib::translate::Stash(unsafe { self.as_ptr() }, self) } fn to_glib_full(&self) -> *const $ffi_name { unsafe { $crate::ffi::gst_mini_object_ref(self.as_mut_ptr() as *mut $crate::ffi::GstMiniObject); self.as_ptr() } } } impl<'a> $crate::glib::translate::ToGlibPtr<'a, *mut $ffi_name> for $name { type Storage = &'a Self; fn to_glib_none(&'a self) -> $crate::glib::translate::Stash<'a, *mut $ffi_name, Self> { $crate::glib::translate::Stash(unsafe { self.as_mut_ptr() }, self) } fn to_glib_full(&self) -> *mut $ffi_name { unsafe { $crate::ffi::gst_mini_object_ref(self.as_mut_ptr() as *mut $crate::ffi::GstMiniObject); self.as_mut_ptr() } } } impl<'a> $crate::glib::translate::ToGlibPtrMut<'a, *mut $ffi_name> for $name { type Storage = &'a mut Self; fn to_glib_none_mut(&'a mut self) -> $crate::glib::translate::StashMut<*mut $ffi_name, Self> { self.make_mut(); $crate::glib::translate::StashMut(unsafe { self.as_mut_ptr() }, self) } } impl<'a> $crate::glib::translate::ToGlibContainerFromSlice<'a, *mut *mut $ffi_name> for $name { #[allow(clippy::type_complexity)] type Storage = ( Vec<$crate::glib::translate::Stash<'a, *mut $ffi_name, Self>>, Option>, ); fn to_glib_none_from_slice(t: &'a [$name]) -> (*mut *mut $ffi_name, Self::Storage) { skip_assert_initialized!(); let v: Vec<_> = t.iter().map(|s| $crate::glib::translate::ToGlibPtr::to_glib_none(s)).collect(); let mut v_ptr: Vec<_> = v.iter().map(|s| s.0).collect(); v_ptr.push(std::ptr::null_mut() as *mut $ffi_name); (v_ptr.as_ptr() as *mut *mut $ffi_name, (v, Some(v_ptr))) } fn to_glib_container_from_slice(t: &'a [$name]) -> (*mut *mut $ffi_name, Self::Storage) { skip_assert_initialized!(); let v: Vec<_> = t.iter().map(|s| $crate::glib::translate::ToGlibPtr::to_glib_none(s)).collect(); let v_ptr = unsafe { let v_ptr = $crate::glib::ffi::g_malloc0(std::mem::size_of::<*mut $ffi_name>() * t.len() + 1) as *mut *mut $ffi_name; for (i, s) in v.iter().enumerate() { std::ptr::write(v_ptr.add(i), s.0); } v_ptr }; (v_ptr, (v, None)) } fn to_glib_full_from_slice(t: &[$name]) -> *mut *mut $ffi_name { skip_assert_initialized!(); unsafe { let v_ptr = $crate::glib::ffi::g_malloc0(std::mem::size_of::<*mut $ffi_name>() * t.len() + 1) as *mut *mut $ffi_name; for (i, s) in t.iter().enumerate() { std::ptr::write(v_ptr.add(i), $crate::glib::translate::ToGlibPtr::to_glib_full(s)); } v_ptr } } } impl<'a> $crate::glib::translate::ToGlibContainerFromSlice<'a, *const *mut $ffi_name> for $name { #[allow(clippy::type_complexity)] type Storage = ( Vec<$crate::glib::translate::Stash<'a, *mut $ffi_name, $name>>, Option>, ); fn to_glib_none_from_slice(t: &'a [$name]) -> (*const *mut $ffi_name, Self::Storage) { skip_assert_initialized!(); let (ptr, stash) = $crate::glib::translate::ToGlibContainerFromSlice::<'a, *mut *mut $ffi_name>::to_glib_none_from_slice(t); (ptr as *const *mut $ffi_name, stash) } fn to_glib_container_from_slice(_: &'a [$name]) -> (*const *mut $ffi_name, Self::Storage) { skip_assert_initialized!(); // Can't have consumer free a *const pointer unimplemented!() } fn to_glib_full_from_slice(_: &[$name]) -> *const *mut $ffi_name { skip_assert_initialized!(); // Can't have consumer free a *const pointer unimplemented!() } } impl $crate::glib::translate::FromGlibPtrNone<*const $ffi_name> for $name { unsafe fn from_glib_none(ptr: *const $ffi_name) -> Self { Self::from_glib_none(ptr) } } impl $crate::glib::translate::FromGlibPtrNone<*mut $ffi_name> for $name { unsafe fn from_glib_none(ptr: *mut $ffi_name) -> Self { Self::from_glib_none(ptr) } } impl $crate::glib::translate::FromGlibPtrFull<*const $ffi_name> for $name { unsafe fn from_glib_full(ptr: *const $ffi_name) -> Self { Self::from_glib_full(ptr) } } impl $crate::glib::translate::FromGlibPtrFull<*mut $ffi_name> for $name { unsafe fn from_glib_full(ptr: *mut $ffi_name) -> Self { Self::from_glib_full(ptr) } } impl $crate::glib::translate::FromGlibPtrBorrow<*const $ffi_name> for $name { unsafe fn from_glib_borrow(ptr: *const $ffi_name) -> $crate::glib::translate::Borrowed { Self::from_glib_borrow(ptr) } } impl $crate::glib::translate::FromGlibPtrBorrow<*mut $ffi_name> for $name { unsafe fn from_glib_borrow(ptr: *mut $ffi_name) -> $crate::glib::translate::Borrowed { Self::from_glib_borrow(ptr) } } impl $crate::glib::translate::FromGlibContainerAsVec<*mut $ffi_name, *mut *mut $ffi_name> for $name { unsafe fn from_glib_none_num_as_vec(ptr: *mut *mut $ffi_name, num: usize) -> Vec { if num == 0 || ptr.is_null() { return Vec::new(); } let mut res = Vec::with_capacity(num); for i in 0..num { res.push($crate::glib::translate::from_glib_none(std::ptr::read(ptr.add(i)))); } res } unsafe fn from_glib_container_num_as_vec(ptr: *mut *mut $ffi_name, num: usize) -> Vec { let res = $crate::glib::translate::FromGlibContainerAsVec::from_glib_none_num_as_vec(ptr, num); $crate::glib::ffi::g_free(ptr as *mut _); res } unsafe fn from_glib_full_num_as_vec(ptr: *mut *mut $ffi_name, num: usize) -> Vec { if num == 0 || ptr.is_null() { return Vec::new(); } let mut res = Vec::with_capacity(num); for i in 0..num { res.push($crate::glib::translate::from_glib_full(std::ptr::read(ptr.add(i)))); } $crate::glib::ffi::g_free(ptr as *mut _); res } } impl $crate::glib::translate::FromGlibPtrArrayContainerAsVec<*mut $ffi_name, *mut *mut $ffi_name> for $name { unsafe fn from_glib_none_as_vec(ptr: *mut *mut $ffi_name) -> Vec { $crate::glib::translate::FromGlibContainerAsVec::from_glib_none_num_as_vec(ptr, glib::translate::c_ptr_array_len(ptr)) } unsafe fn from_glib_container_as_vec(ptr: *mut *mut $ffi_name) -> Vec { $crate::glib::translate::FromGlibContainerAsVec::from_glib_container_num_as_vec(ptr, glib::translate::c_ptr_array_len(ptr)) } unsafe fn from_glib_full_as_vec(ptr: *mut *mut $ffi_name) -> Vec { $crate::glib::translate::FromGlibContainerAsVec::from_glib_full_num_as_vec(ptr, glib::translate::c_ptr_array_len(ptr)) } } impl $crate::glib::translate::FromGlibContainerAsVec<*mut $ffi_name, *const *mut $ffi_name> for $name { unsafe fn from_glib_none_num_as_vec(ptr: *const *mut $ffi_name, num: usize) -> Vec { $crate::glib::translate::FromGlibContainerAsVec::from_glib_none_num_as_vec(ptr as *mut *mut _, num) } unsafe fn from_glib_container_num_as_vec(_: *const *mut $ffi_name, _: usize) -> Vec { // Can't free a *const unimplemented!() } unsafe fn from_glib_full_num_as_vec(_: *const *mut $ffi_name, _: usize) -> Vec { // Can't free a *const unimplemented!() } } impl $crate::glib::translate::FromGlibPtrArrayContainerAsVec<*mut $ffi_name, *const *mut $ffi_name> for $name { unsafe fn from_glib_none_as_vec(ptr: *const *mut $ffi_name) -> Vec { $crate::glib::translate::FromGlibPtrArrayContainerAsVec::from_glib_none_as_vec(ptr as *mut *mut _) } unsafe fn from_glib_container_as_vec(_: *const *mut $ffi_name) -> Vec { // Can't free a *const unimplemented!() } unsafe fn from_glib_full_as_vec(_: *const *mut $ffi_name) -> Vec { // Can't free a *const unimplemented!() } } impl<'a> $crate::glib::value::FromValueOptional<'a> for $name { unsafe fn from_value_optional(v: &'a glib::Value) -> Option { let ptr = $crate::glib::gobject_ffi::g_value_get_boxed($crate::glib::translate::ToGlibPtr::to_glib_none(v).0); $crate::glib::translate::from_glib_none(ptr as *const $ffi_name) } } impl $crate::glib::value::SetValue for $name { unsafe fn set_value(v: &mut glib::Value, s: &Self) { $crate::glib::gobject_ffi::g_value_set_boxed($crate::glib::translate::ToGlibPtrMut::to_glib_none_mut(v).0, s.as_ptr() as $crate::glib::ffi::gpointer); } } impl $crate::glib::value::SetValueOptional for $name { unsafe fn set_value_optional(v: &mut glib::Value, s: Option<&Self>) { if let Some(s) = s { $crate::glib::gobject_ffi::g_value_set_boxed($crate::glib::translate::ToGlibPtrMut::to_glib_none_mut(v).0, s.as_ptr() as $crate::glib::ffi::gpointer); } else { $crate::glib::gobject_ffi::g_value_set_boxed($crate::glib::translate::ToGlibPtrMut::to_glib_none_mut(v).0, std::ptr::null_mut()); } } } impl $crate::glib::translate::GlibPtrDefault for $name { type GlibType = *mut $ffi_name; } impl $ref_name { pub unsafe fn as_ptr(&self) -> *const $ffi_name { self as *const Self as *const $ffi_name } pub unsafe fn as_mut_ptr(&self) -> *mut $ffi_name { self as *const Self as *mut $ffi_name } pub unsafe fn from_ptr<'a>(ptr: *const $ffi_name) -> &'a Self { assert!(!ptr.is_null()); &*(ptr as *const Self) } pub unsafe fn from_mut_ptr<'a>(ptr: *mut $ffi_name) -> &'a mut Self { assert!(!ptr.is_null()); assert_ne!( $crate::ffi::gst_mini_object_is_writable(ptr as *mut $crate::ffi::GstMiniObject), $crate::glib::ffi::GFALSE ); &mut *(ptr as *mut Self) } pub fn copy(&self) -> $name { unsafe { $name::from_glib_full($crate::ffi::gst_mini_object_copy( self.as_ptr() as *const $crate::ffi::GstMiniObject ) as *const $ffi_name) } } } impl $crate::glib::types::StaticType for $ref_name { fn static_type() -> $crate::glib::types::Type { unsafe { $crate::glib::translate::from_glib($get_type()) } } } impl $crate::glib::translate::GlibPtrDefault for $ref_name { type GlibType = *mut $ffi_name; } impl<'a> $crate::glib::value::FromValueOptional<'a> for &'a $ref_name { unsafe fn from_value_optional(v: &'a glib::Value) -> Option { let ptr = glib::gobject_ffi::g_value_get_boxed($crate::glib::translate::ToGlibPtr::to_glib_none(v).0); if ptr.is_null() { None } else { Some(&*(ptr as *const $ref_name)) } } } // Can't have SetValue/SetValueOptional impls as otherwise one could use it to get // immutable references from a mutable reference without borrowing via the value impl ToOwned for $ref_name { type Owned = $name; fn to_owned(&self) -> $name { self.copy() } } unsafe impl Sync for $ref_name {} unsafe impl Send for $ref_name {} unsafe impl Sync for $name {} unsafe impl Send for $name {} } );