// This file was generated by gir (https://github.com/gtk-rs/gir)
// from gir-files (https://github.com/gtk-rs/gir-files)
// DO NOT EDIT

use glib;
use glib::translate::*;
use glib::GString;
use gst_pbutils_sys;
use std;
use std::ptr;
use EncodingProfile;

glib_wrapper! {
    /// Collection of `EncodingProfile` for a specific target or use-case.
    ///
    /// When being stored/loaded, targets come from a specific category, like
    /// `GST_ENCODING_CATEGORY_DEVICE`.
    ///
    /// # Implements
    ///
    /// [`glib::object::ObjectExt`](../glib/object/trait.ObjectExt.html)
    pub struct EncodingTarget(Object<gst_pbutils_sys::GstEncodingTarget, EncodingTargetClass>);

    match fn {
        get_type => || gst_pbutils_sys::gst_encoding_target_get_type(),
    }
}

impl EncodingTarget {
    /// Creates a new `EncodingTarget`.
    ///
    /// The name and category can only consist of lowercase ASCII letters for the
    /// first character, followed by either lowercase ASCII letters, digits or
    /// hyphens ('-').
    ///
    /// The `category` `<emphasis>`should`</emphasis>` be one of the existing
    /// well-defined categories, like `GST_ENCODING_CATEGORY_DEVICE`, but it
    /// `<emphasis>`can`</emphasis>` be a application or user specific category if
    /// needed.
    /// ## `name`
    /// The name of the target.
    /// ## `category`
    /// The name of the category to which this `target`
    /// belongs. For example: `GST_ENCODING_CATEGORY_DEVICE`.
    /// ## `description`
    /// A description of `EncodingTarget` in the
    /// current locale.
    /// ## `profiles`
    /// A `glib::List` of
    /// `EncodingProfile`.
    ///
    /// # Returns
    ///
    /// The newly created `EncodingTarget` or `None` if
    /// there was an error.
    pub fn new(
        name: &str,
        category: &str,
        description: &str,
        profiles: &[EncodingProfile],
    ) -> EncodingTarget {
        assert_initialized_main_thread!();
        unsafe {
            from_glib_full(gst_pbutils_sys::gst_encoding_target_new(
                name.to_glib_none().0,
                category.to_glib_none().0,
                description.to_glib_none().0,
                profiles.to_glib_none().0,
            ))
        }
    }

    ///
    /// # Returns
    ///
    /// The category of the `self`. For example:
    /// `GST_ENCODING_CATEGORY_DEVICE`.
    pub fn get_category(&self) -> GString {
        unsafe {
            from_glib_none(gst_pbutils_sys::gst_encoding_target_get_category(
                self.to_glib_none().0,
            ))
        }
    }

    ///
    /// # Returns
    ///
    /// The description of the `self`.
    pub fn get_description(&self) -> GString {
        unsafe {
            from_glib_none(gst_pbutils_sys::gst_encoding_target_get_description(
                self.to_glib_none().0,
            ))
        }
    }

    ///
    /// # Returns
    ///
    /// The name of the `self`.
    pub fn get_name(&self) -> GString {
        unsafe {
            from_glib_none(gst_pbutils_sys::gst_encoding_target_get_name(
                self.to_glib_none().0,
            ))
        }
    }

    /// ## `name`
    /// the name of the profile to retrieve
    ///
    /// # Returns
    ///
    /// The matching `EncodingProfile`, or `None`.
    pub fn get_profile(&self, name: &str) -> Option<EncodingProfile> {
        unsafe {
            from_glib_full(gst_pbutils_sys::gst_encoding_target_get_profile(
                self.to_glib_none().0,
                name.to_glib_none().0,
            ))
        }
    }

    ///
    /// # Returns
    ///
    /// A list of
    /// `EncodingProfile`(s) this `self` handles.
    pub fn get_profiles(&self) -> Vec<EncodingProfile> {
        unsafe {
            FromGlibPtrContainer::from_glib_none(gst_pbutils_sys::gst_encoding_target_get_profiles(
                self.to_glib_none().0,
            ))
        }
    }

    /// Saves the `self` to a default user-local directory.
    ///
    /// # Returns
    ///
    /// `true` if the target was correctly saved, else `false`.
    pub fn save(&self) -> Result<(), glib::Error> {
        unsafe {
            let mut error = ptr::null_mut();
            let _ = gst_pbutils_sys::gst_encoding_target_save(self.to_glib_none().0, &mut error);
            if error.is_null() {
                Ok(())
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    /// Saves the `self` to the provided file location.
    /// ## `filepath`
    /// the location to store the `self` at.
    ///
    /// # Returns
    ///
    /// `true` if the target was correctly saved, else `false`.
    pub fn save_to_file<P: AsRef<std::path::Path>>(&self, filepath: P) -> Result<(), glib::Error> {
        unsafe {
            let mut error = ptr::null_mut();
            let _ = gst_pbutils_sys::gst_encoding_target_save_to_file(
                self.to_glib_none().0,
                filepath.as_ref().to_glib_none().0,
                &mut error,
            );
            if error.is_null() {
                Ok(())
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    /// Searches for the `EncodingTarget` with the given name, loads it
    /// and returns it.
    ///
    /// If the category name is specified only targets from that category will be
    /// searched for.
    /// ## `name`
    /// the name of the `EncodingTarget` to load (automatically
    /// converted to lower case internally as capital letters are not
    /// valid for target names).
    /// ## `category`
    /// the name of the target category, like
    /// `GST_ENCODING_CATEGORY_DEVICE`. Can be `None`
    ///
    /// # Returns
    ///
    /// The `EncodingTarget` if available, else `None`.
    pub fn load(name: &str, category: Option<&str>) -> Result<EncodingTarget, glib::Error> {
        assert_initialized_main_thread!();
        unsafe {
            let mut error = ptr::null_mut();
            let ret = gst_pbutils_sys::gst_encoding_target_load(
                name.to_glib_none().0,
                category.to_glib_none().0,
                &mut error,
            );
            if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            }
        }
    }

    /// Opens the provided file and returns the contained `EncodingTarget`.
    /// ## `filepath`
    /// The file location to load the `EncodingTarget` from
    ///
    /// # Returns
    ///
    /// The `EncodingTarget` contained in the file, else
    /// `None`
    pub fn load_from_file<P: AsRef<std::path::Path>>(
        filepath: P,
    ) -> Result<EncodingTarget, glib::Error> {
        assert_initialized_main_thread!();
        unsafe {
            let mut error = ptr::null_mut();
            let ret = gst_pbutils_sys::gst_encoding_target_load_from_file(
                filepath.as_ref().to_glib_none().0,
                &mut error,
            );
            if error.is_null() {
                Ok(from_glib_full(ret))
            } else {
                Err(from_glib_full(error))
            }
        }
    }
}

unsafe impl Send for EncodingTarget {}
unsafe impl Sync for EncodingTarget {}