clutter-rs 0.1.2

Rust bindings for the Clutter library
Documentation
use crate::{Actor, ActorMeta, Constraint, Path};
use glib::{
    object as gobject,
    object::{Cast, IsA, ObjectType as ObjectType_},
    signal::{connect_raw, SignalHandlerId},
    translate::*,
};
use std::boxed::Box as Box_;
use std::{fmt, mem::transmute};

glib_wrapper! {
    pub struct PathConstraint(Object<ffi::ClutterPathConstraint, ffi::ClutterPathConstraintClass, PathConstraintClass>) @extends Constraint, ActorMeta, gobject::InitiallyUnowned;

    match fn {
        get_type => || ffi::clutter_path_constraint_get_type(),
    }
}

impl PathConstraint {
    /// Creates a new `PathConstraint` with the given `path` and `offset`
    /// ## `path`
    /// a `Path`, or `None`
    /// ## `offset`
    /// the offset along the `Path`
    ///
    /// # Returns
    ///
    /// the newly created `PathConstraint`
    pub fn new<P: IsA<Path>>(path: Option<&P>, offset: f32) -> PathConstraint {
        unsafe {
            Constraint::from_glib_none(ffi::clutter_path_constraint_new(
                path.map(|p| p.as_ref()).to_glib_none().0,
                offset,
            ))
            .unsafe_cast()
        }
    }

    /// Retrieves the offset along the `Path` used by `self`.
    ///
    /// # Returns
    ///
    /// the offset
    pub fn get_offset(&self) -> f32 {
        unsafe { ffi::clutter_path_constraint_get_offset(self.to_glib_none().0) }
    }

    /// Retrieves a pointer to the `Path` used by `self`.
    ///
    /// # Returns
    ///
    /// the `Path` used by the
    ///  `PathConstraint`, or `None`. The returned `Path` is owned
    ///  by the constraint and it should not be unreferenced
    pub fn get_path(&self) -> Option<Path> {
        unsafe { from_glib_none(ffi::clutter_path_constraint_get_path(self.to_glib_none().0)) }
    }

    /// Sets the offset along the `Path` used by `self`.
    /// ## `offset`
    /// the offset along the path
    pub fn set_offset(&self, offset: f32) {
        unsafe {
            ffi::clutter_path_constraint_set_offset(self.to_glib_none().0, offset);
        }
    }

    /// Sets the `path` to be followed by the `PathConstraint`.
    ///
    /// The `self` will take ownership of the `Path` passed to this
    /// function.
    /// ## `path`
    /// a `Path`
    pub fn set_path<P: IsA<Path>>(&self, path: Option<&P>) {
        unsafe {
            ffi::clutter_path_constraint_set_path(
                self.to_glib_none().0,
                path.map(|p| p.as_ref()).to_glib_none().0,
            );
        }
    }

    /// The ::node-reached signal is emitted each time a
    /// `PathConstraint:offset` value results in the actor
    /// passing a `PathNode`
    /// ## `actor`
    /// the `Actor` using the `constraint`
    /// ## `index`
    /// the index of the node that has been reached
    pub fn connect_node_reached<F: Fn(&PathConstraint, &Actor, u32) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn node_reached_trampoline<
            F: Fn(&PathConstraint, &Actor, u32) + 'static,
        >(
            this: *mut ffi::ClutterPathConstraint,
            actor: *mut ffi::ClutterActor,
            index: libc::c_uint,
            f: glib_sys::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this), &from_glib_borrow(actor), index)
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"node-reached\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    node_reached_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    pub fn connect_property_offset_notify<F: Fn(&PathConstraint) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_offset_trampoline<F: Fn(&PathConstraint) + 'static>(
            this: *mut ffi::ClutterPathConstraint,
            _param_spec: glib_sys::gpointer,
            f: glib_sys::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::offset\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_offset_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }

    pub fn connect_property_path_notify<F: Fn(&PathConstraint) + 'static>(
        &self,
        f: F,
    ) -> SignalHandlerId {
        unsafe extern "C" fn notify_path_trampoline<F: Fn(&PathConstraint) + 'static>(
            this: *mut ffi::ClutterPathConstraint,
            _param_spec: glib_sys::gpointer,
            f: glib_sys::gpointer,
        ) {
            let f: &F = &*(f as *const F);
            f(&from_glib_borrow(this))
        }
        unsafe {
            let f: Box_<F> = Box_::new(f);
            connect_raw(
                self.as_ptr() as *mut _,
                b"notify::path\0".as_ptr() as *const _,
                Some(transmute::<_, unsafe extern "C" fn()>(
                    notify_path_trampoline::<F> as *const (),
                )),
                Box_::into_raw(f),
            )
        }
    }
}

impl fmt::Display for PathConstraint {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "PathConstraint")
    }
}