ocio 0.3.1

A pure Rust port of OpenColorIO, the color management framework for visual effects and animation.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112

// SPDX-License-Identifier: BSD-3-Clause
// Copyright Contributors to the OpenColorIO Project.
// Copyright (c) 2026 Philippe Llerena.

//! Marker no-ops used to track the files and looks involved in a processor
//! (port of `NoOps.cpp`). They are removed by the optimizer.

use super::{Op, OpVec, Pixel};
use std::any::Any;
use std::sync::Arc;

/// What a marker records.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum MarkerKind {
    /// A file used by a `FileTransform`.
    File,
    /// A look applied by a `LookTransform`.
    Look,
}

/// A no-op carrying metadata for `ProcessorMetadata`.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct MarkerNoOp {
    /// Whether this marks a file or a look.
    pub kind: MarkerKind,
    /// The file name or the look name.
    pub value: String,
}

impl Op for MarkerNoOp {
    fn name(&self) -> &'static str {
        match self.kind {
            MarkerKind::File => "FileNoOp",
            MarkerKind::Look => "LookNoOp",
        }
    }
    fn apply(&self, _pixels: &mut [Pixel]) {}
    fn is_no_op(&self) -> bool {
        true
    }
    fn is_no_op_type(&self) -> bool {
        true
    }
    fn has_channel_crosstalk(&self) -> bool {
        false
    }
    fn cache_id(&self) -> String {
        String::new()
    }
    fn as_any(&self) -> &dyn Any {
        self
    }
    fn clone_box(&self) -> Box<dyn Op> {
        Box::new(self.clone())
    }
}

/// Append a file marker.
pub fn create_file_no_op(ops: &mut OpVec, fname: &str) {
    ops.push(Arc::new(MarkerNoOp {
        kind: MarkerKind::File,
        value: fname.to_string(),
    }));
}

/// Append a look marker.
pub fn create_look_no_op(ops: &mut OpVec, look: &str) {
    ops.push(Arc::new(MarkerNoOp {
        kind: MarkerKind::Look,
        value: look.to_string(),
    }));
}

/// A no-op carrying format metadata for the processor (OCIO stores it on
/// the op list, e.g. the CLF/CTF `ProcessList` information).
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct MetadataNoOp {
    /// The format metadata carried by the op.
    pub metadata: crate::format_metadata::FormatMetadata,
}

impl Op for MetadataNoOp {
    fn name(&self) -> &'static str {
        "MetadataNoOp"
    }
    fn apply(&self, _pixels: &mut [Pixel]) {}
    fn is_no_op(&self) -> bool {
        true
    }
    fn is_no_op_type(&self) -> bool {
        true
    }
    fn has_channel_crosstalk(&self) -> bool {
        false
    }
    fn cache_id(&self) -> String {
        String::new()
    }
    fn as_any(&self) -> &dyn Any {
        self
    }
    fn clone_box(&self) -> Box<dyn Op> {
        Box::new(self.clone())
    }
}

/// Append a metadata marker.
pub fn create_metadata_no_op(ops: &mut OpVec, metadata: &crate::format_metadata::FormatMetadata) {
    ops.push(Arc::new(MetadataNoOp {
        metadata: metadata.clone(),
    }));
}