Sketch of OpenEXR Read/Write Flowchart

[scoopxyz]

Strawman Flowcharts

I think some more thought and refinement would need to be given to this, but this represents what roughly came to mind during the CIF meeting.

Seeing it laid out like this, I'm not sure if it's directly usable. If we would want to present something like this, each node would need a reference to a larger paragraph with more details (maybe hyperlink?)...

At worst, it's an example of how to use Mermaid diagrams with GH Flavored Markdown.

Writing OpenEXR Flowchart

graph TD;
A[Start] --> B{Known Color Space?};
B--True -->F{Read Metadata From Src?};
F--True -->G{Was CS Altered?}
G--True -->H[Write New ID]
G--False -->K{Is ACES2065-1 Img?}
B--False -->C{Discoverable?};
C--True -->D[Omit ID]
C--False -->E['Unknown']
F--False -->T{Is App OCIO Managed?}
T--True -->M
T--False -->Q
K--True -->L[Write ACES2065-1 ID]
K--False -->M{OCIO CS Exists?}
M--True -->N{Has InteropId?}
N--True -->O[Write InteropID]
N--False -->P[Follow CIF Guidelines]
M--False -->Q{Other CMS?}
Q--True -->P
Q--False -->S{Does User Know?}
S--True -->U[Write User ID]
S--False-->V[Omit ID]

Loading

Reading OpenEXR Flowchart

graph TD;
A[Start] --> B{acesImageContainer present?}
B--True -->C[Use 'lin_ap0_scene']
B--False -->D{Is colorInteropID present?}
D--True -->E{Is CIID `data`?}
E--True -->F[Don't Color Manage]
E--False -->G{Is CIID `unknown`?}
G--True -->H[Use OCIO FileRules]
G--False -->J[Use colorInteropId]
D--False -->K{Are FileRules Available?}
K--True -->L[Use OCIO FileRules]
K--False -->M[Ask User to Resolve]

Loading

[scoopxyz]

I'll probably do a second pass on this later to make it more accurate/legible...

[scoopxyz]

I struggled to find the Google Doc for a bit so putting the link here:
https://docs.google.com/document/d/1MTH1bq2L67ifvdDf64Amhzg4AbkIM5LG6yPHrB96Vwo/edit?tab=t.0#heading=h.mha6je2dcitz

[scoopxyz]

Writing OpenEXR Flowchart

graph TD;
A[Image Buffer] --> B{Is color?};
B--True-->C{Is CS known?}
B--False-->D[Assign CIID 'data']
C--True-->E{Is CIID known?}
C--False-->F[Assign CIID 'unknown']
E--True-->G{Was CS altered in-app?}
E--False-->H{Resolve CIID from CMS}
H--True-->G
H--False-->I[Generate name-spaced CIID]
I-->G
G--True-->J[Update CIID]
G--False-->K{Is destination SMPTE ST 2065-4?}
J-->K
K--True-->L[Test CIID == 'lin_ap0_scene']
L-->M
K--False-->M[Write CIID]
D-->M
F-->M

Loading

Reading OpenEXR Flowchart

graph TD;
A[Start] --> B{acesImageContainer flag?}
B--True -->C[CIID = 'lin_ap0_scene']
C-->J
B--False -->D{Is CIID present?}
D--True -->E{Is CIID `data`?}
E--True -->F[Don't Color Manage]
E--False -->G{Is CIID `unknown`?}
G--False -->J{Resolve CIID to CS}
D--False -->K{Resolve Context to CS}
G--True -->K
K--False -->M[Ask user to resolve]
K--True -->L[Use CS]
J--True-->N[Use CS]
J--False-->O[App-specific behavior]

Loading

[scoopxyz]

@doug-walker I've updated this flow chart based on my understanding and original comments.

Mermaid allows for some styling options, so I think it would be tidied up, but more interested in overall flow and content at the moment.

[doug-walker]

Thank you @scoopxyz ! We will discuss this at the CIF meeting on Feb. 23rd.

[scoopxyz]

Updated a bit with the notes I'd made and just looking at it with fresh eyes. Feedback welcomed.