Struct Source 

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

Represents an NDI source discovered on the network.

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 method checks both the source name and address for a match, making it easy to find sources by hostname or IP.

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 IP address from this source if available.

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.