Struct DomainSet 

pub struct DomainSet(/* private fields */);

A set of MemoryDomainKinds a producer can emit or a consumer can accept, packed into a bitmask. The allocation query negotiates a single concrete domain by intersecting the producer’s capability set with the consumer’s acceptance set and picking the most-preferred survivor (preferred). A single-domain producer/consumer (the default) is just only, so the negotiation reduces to today’s exact-match behavior; a multi-domain element (a decoder that can deliver to System or stay resident on the GPU) names every domain it can satisfy.

Implementations

impl DomainSet

pub const EMPTY: Self

The empty set: no domain. The intersection result that signals an irreconcilable conflict (producer and consumer share no domain).

pub const ALL: Self

Every domain. The default input acceptance of an element (it imposes no domain requirement on its upstream), so the converter auto-plug only acts on elements that declare a narrower input_domains.

pub fn iter(self) -> impl Iterator<Item = MemoryDomainKind>

Iterate the member domains in preference order (GPU-resident first).

pub const fn only(k: MemoryDomainKind) -> Self

The singleton set holding just k. The default capability/acceptance of every element, derived from its single output_memory().

pub const fn with(self, k: MemoryDomainKind) -> Self

This set with k added.

pub const fn contains(self, k: MemoryDomainKind) -> bool

Whether k is a member.

pub const fn intersect(self, other: Self) -> Self

The set of domains in both self and other (the domains a producer and consumer can agree on).

pub const fn union(self, other: Self) -> Self

The set of domains in either self or other.

pub const fn is_empty(self) -> bool

Whether the set holds no domain.

pub fn preferred(self) -> Option<MemoryDomainKind>

The most-preferred member per [DOMAIN_PREFERENCE] (GPU-resident before System), or None if the set is empty. The single concrete domain the negotiation settles on.

Trait Implementations

impl Clone for DomainSet

fn clone(&self) -> DomainSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for DomainSet

impl Debug for DomainSet

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

Formats the value using the given formatter.

impl Eq for DomainSet

impl PartialEq for DomainSet

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DomainSet