Struct Source 

pub struct Source {
    pub name: String,
    pub address: SourceAddress,
}

Represents an NDI source discovered on the network.

Equality and hashing compare the complete name and address, including the address variant; they do not imply persistent device identity.

Sources contain a human-readable name and network address. The name typically includes the machine name and source name (e.g., “MACHINE (Source)”).

Examples

use grafton_ndi::{Source, SourceAddress};

let source = Source {
    name: "LAPTOP (Camera 1)".to_string(),
    address: SourceAddress::Ip("192.168.1.100:5960".to_string()),
};

println!("Source: {}", source); // Displays: LAPTOP (Camera 1)@192.168.1.100:5960

Fields

name: String

The NDI source name (e.g., “MACHINE (Source Name)”).

address: SourceAddress

The network address for connecting to this source.

Implementations

impl Source

pub fn matches_host(&self, host: &str) -> bool

Check if this source matches a given host or IP address.

This checks the complete address host, or for hostname queries the machine component of an SDK MACHINE (Source Name) label.

Arguments

• host - The hostname or IP address to match against

Examples

use grafton_ndi::{Source, SourceAddress};

let source = Source {
    name: "CAMERA1 (Chan1, 192.168.0.107)".to_string(),
    address: SourceAddress::Ip("192.168.0.107:5960".to_string()),
};

assert!(source.matches_host("192.168.0.107"));
assert!(source.matches_host("CAMERA1"));
assert!(!source.matches_host("192.168.1.1"));

pub fn ip_address(&self) -> Option<&str>

Extract the host from conventional host/port or URL syntax.

Brackets around IPv6 literals are removed. SDK addresses are opaque; unrecognized syntax returns None.

For IP-based sources, this returns the IP portion without the port. For URL-based sources, this extracts the hostname portion.

Returns

Some(ip) if an IP or hostname is found, None otherwise.

Examples

use grafton_ndi::{Source, SourceAddress};

let source = Source {
    name: "CAMERA1".to_string(),
    address: SourceAddress::Ip("192.168.1.100:5960".to_string()),
};

assert_eq!(source.ip_address(), Some("192.168.1.100"));

pub fn host(&self) -> Option<&str>

Extract the hostname or IP without port.

This is an alias for ip_address() for better API discoverability.

Examples

use grafton_ndi::{Source, SourceAddress};

let source = Source {
    name: "CAMERA1".to_string(),
    address: SourceAddress::Ip("192.168.1.100:5960".to_string()),
};

assert_eq!(source.host(), Some("192.168.1.100"));

Trait Implementations

impl Clone for Source

fn clone(&self) -> Source

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Source

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

Formats the value using the given formatter.

impl Default for Source

fn default() -> Source

Returns the “default value” for a type.

impl Display for Source

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

Formats the value using the given formatter.

impl Eq for Source

impl Hash for Source

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

Feeds this value into the given Hasher.

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 PartialEq for Source

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Source