1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
// Copyright (C) 2017 Sebastian Dröge <sebastian@centricular.com>
//
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
// option. This file may not be copied, modified, or distributed
// except according to those terms.

use ffi;
use glib::translate::*;
use glib_ffi;
use gobject_ffi;

use std::mem;
use std::ptr;

glib_wrapper! {
    /// Opaque structure.
    pub struct ParseContext(Boxed<ffi::GstParseContext>);

    match fn {
        copy => |ptr| {
            gobject_ffi::g_boxed_copy(ffi::gst_parse_context_get_type(), ptr as *mut _) as *mut ffi::GstParseContext
        },
        free => |ptr| {
            gobject_ffi::g_boxed_free(ffi::gst_parse_context_get_type(), ptr as *mut _)
        },
        get_type => || ffi::gst_parse_context_get_type(),
    }
}

impl ParseContext {
    /// Allocates a parse context for use with `gst_parse_launch_full` or
    /// `gst_parse_launchv_full`.
    ///
    /// Free-function: gst_parse_context_free
    ///
    /// # Returns
    ///
    /// a newly-allocated parse context. Free
    ///  with `ParseContext::free` when no longer needed.
    pub fn new() -> Self {
        unsafe { from_glib_full(ffi::gst_parse_context_new()) }
    }

    /// Retrieve missing elements from a previous run of `gst_parse_launch_full`
    /// or `gst_parse_launchv_full`. Will only return results if an error code
    /// of `ParseError::NoSuchElement` was returned.
    ///
    /// # Returns
    ///
    /// a
    ///  `None`-terminated array of element factory name strings of missing
    ///  elements. Free with `g_strfreev` when no longer needed.
    pub fn get_missing_elements(&self) -> Vec<String> {
        unsafe {
            FromGlibPtrContainer::from_glib_full(ffi::gst_parse_context_get_missing_elements(
                mut_override(self.to_glib_none().0),
            ))
        }
    }
}

impl Default for ParseContext {
    fn default() -> Self {
        Self::new()
    }
}