Struct gstreamer_pbutils::EncodingTarget

pub struct EncodingTarget { /* private fields */ }

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

[trait@glib::ObjectExt]

GLib type: GObject with reference counted clone semantics.

Implementations

impl EncodingTarget

pub fn new( name: &str, category: &str, description: &str, profiles: &[EncodingProfile], ) -> Result<EncodingTarget, BoolError>

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 should be one of the existing well-defined categories, like GST_ENCODING_CATEGORY_DEVICE, but it can 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 GList of EncodingProfile.

Returns

The newly created EncodingTarget or None if there was an error.

pub fn category(&self) -> GString

Returns

The category of the self. For example: GST_ENCODING_CATEGORY_DEVICE.

pub fn description(&self) -> GString

Returns

The description of the self.

pub fn name(&self) -> GString

Returns

The name of the self.

pub fn path(&self) -> Option<PathBuf>

Returns

The path to the self file.

pub fn profile(&self, name: &str) -> Option<EncodingProfile>

name

the name of the profile to retrieve

Returns

The matching EncodingProfile, or None.

pub fn profiles(&self) -> Vec<EncodingProfile>

Returns

A list of EncodingProfile(s) this self handles.

pub fn save(&self) -> Result<(), Error>

Saves the self to a default user-local directory.

Returns

true if the target was correctly saved, else false.

pub fn save_to_file(&self, filepath: impl AsRef<Path>) -> Result<(), 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 load(name: &str, category: Option<&str>) -> Result<EncodingTarget, 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_from_file( filepath: impl AsRef<Path>, ) -> Result<EncodingTarget, 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

Trait Implementations

impl Clone for EncodingTarget

fn clone(&self) -> Self

Makes a clone of this shared reference.

This increments the strong reference count of the object. Dropping the object will decrement it again.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EncodingTarget

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for EncodingTarget

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl HasParamSpec for EncodingTarget

type ParamSpec = ParamSpecObject

type SetValue = EncodingTarget

Preferred value to be used as setter for the associated ParamSpec.

type BuilderFn = fn(_: &str) -> ParamSpecObjectBuilder<'_, EncodingTarget>

fn param_spec_builder() -> Self::BuilderFn

impl Hash for EncodingTarget

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Hashes the memory address of this object.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for EncodingTarget

fn cmp(&self, other: &Self) -> Ordering

Comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl ParentClassIs for EncodingTarget

type Parent = Object

impl<OT: ObjectType> PartialEq<OT> for EncodingTarget

fn eq(&self, other: &OT) -> bool

Equality for two GObjects.

Two GObjects are equal if their memory addresses are equal.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<OT: ObjectType> PartialOrd<OT> for EncodingTarget

fn partial_cmp(&self, other: &OT) -> Option<Ordering>

Partial comparison for two GObjects.

Compares the memory addresses of the provided objects.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl StaticType for EncodingTarget

fn static_type() -> Type

Returns the type identifier of Self.

impl Eq for EncodingTarget

impl Send for EncodingTarget

impl Sync for EncodingTarget