validate_token()

void MayaFlux::Buffers::validate_token

(

ProcessingToken

token

)

Validates that a processing token has a valid, non-conflicting configuration.

Parameters

token

Processing token to validate

Exceptions

std::invalid_argument

if the token contains mutually exclusive flags

This function ensures that processing tokens contain only compatible flag combinations. It validates three key mutual exclusions that are fundamental to the processing model:

Rate Mutual Exclusion: SAMPLE_RATE and FRAME_RATE cannot be combined as they represent fundamentally different temporal processing models that cannot be executed simultaneously within the same processing context.

Device Mutual Exclusion: CPU_PROCESS and GPU_PROCESS cannot be combined as they represent different execution environments that require different resource allocation and execution strategies.

Concurrency Mutual Exclusion: SEQUENTIAL and PARALLEL cannot be combined as they represent incompatible execution patterns that would create undefined behavior in processing chains.

This validation is essential for maintaining system stability and ensuring that processing tokens represent achievable execution configurations.

Definition at line 60 of file BufferUtils.cpp.

{
    if ((token & SAMPLE_RATE) && (token & FRAME_RATE)) {
        error<std::invalid_argument>(
            Journal::Component::Buffers,
            Journal::Context::BufferProcessing,
            std::source_location::current(),
            "SAMPLE_RATE and FRAME_RATE are mutually exclusive.");
    }
 
    if ((token & CPU_PROCESS) && (token & GPU_PPOCESS)) {
        error<std::invalid_argument>(Journal::Component::Buffers,
            Journal::Context::BufferProcessing,
            std::source_location::current(),
            "CPU_PROCESS and GPU_PROCESS are mutually exclusive.");
    }
 
    if ((token & SEQUENTIAL) && (token & PARALLEL)) {
        error<std::invalid_argument>(Journal::Component::Buffers,
            Journal::Context::BufferProcessing,
            std::source_location::current(),
            "SEQUENTIAL and PARALLEL are mutually exclusive.");
    }
}

References MayaFlux::Journal::BufferProcessing, MayaFlux::Journal::Buffers, CPU_PROCESS, FRAME_RATE, GPU_PPOCESS, PARALLEL, SAMPLE_RATE, SEQUENTIAL, and token.

Referenced by MayaFlux::is_domain_valid(), and MayaFlux::Buffers::BufferProcessor::set_processing_token().

Here is the caller graph for this function: