Skip to content

Commit

Permalink
merge branch 'aces-2.0-reorg' into dev
Browse files Browse the repository at this point in the history
- pushing local changes to doc so others can see where things are headed. more commits to follow to continue to flesh things out
  • Loading branch information
scottdyer committed May 29, 2024
2 parents 7a18292 + c8f8055 commit dc6f110
Show file tree
Hide file tree
Showing 364 changed files with 965 additions and 70 deletions.
22 changes: 10 additions & 12 deletions docs/guides/amf/index.md → docs/amf/guides/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,28 +10,18 @@ ACES Metadata File Implementation Guidelines and Best Practices
Scope
----------------


This document is a guide that recommends implementation guidelines and best
practices related to the usage of the ACES Metadata File (AMF) in various
workflows. These workflows may involve one or more tools that support the AMF
specification and this guide attempts to help both implementers and users in
order to facilitate interoperability.


References
----------------


The following standards, specifications, articles, presentations, and texts are referenced in this text:

* [Academy S-2019-001, ACES Metadata File (AMF)](https://aces.mp/S-2019-001)
* [IETF RFC 4122, A Universally Unique IDentifier (UUID) URN Namespace](https://standards.globalspec.com/std/1524451/RFC%204122)


Introduction
----------------


The Academy Color Encoding System (ACES) is a color processing framework that
enables the mix of various sources within a standardized color space in order to
produce one or more outputs.
Expand Down Expand Up @@ -64,7 +54,6 @@ and tools that support those workflows.
What is AMF
----------------


AMF is an XML specification that describes the configuration of an ACES color
pipeline, together with the various input transforms, look transforms and output
transforms.
Expand All @@ -87,7 +76,6 @@ be described as a "many to many" relationship.
Why is AMF needed
----------------


The ACES framework is expanding and becoming richer in terms of input, look, and
output transforms. AMF describes the exact list of these different transforms,
in the order in which they have been or should be applied to obtain the desired
Expand Down Expand Up @@ -999,6 +987,16 @@ A validation process can log any differences and present the results to the user
of the product/tool processing the EDL+AMF files.


References
----------------


The following standards, specifications, articles, presentations, and texts are referenced in this text:

* [Academy S-2019-001, ACES Metadata File (AMF)](https://aces.mp/S-2019-001)
* [IETF RFC 4122, A Universally Unique IDentifier (UUID) URN Namespace](https://standards.globalspec.com/std/1524451/RFC%204122)



<!-- Include section numbering -->
<style>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,20 +11,6 @@ Scope
This document specifies the ACES Metadata File (“AMF”), a ‘sidecar’ XML file intended to exchange themetadata required to recreate ACES viewing pipelines.This specification supersedes TB-2014-009 – Academy Color Encoding System (ACES) Clip-level MetadataFile Format Definition and Usage (“ACESclip”). TB-2014-009 is now considered obsolete.


References
----------
The following standards, specifications, articles, presentations, and texts are referenced in this text:

* [Academy S-2014-002, Academy Color Encoding System - Versioning System](https://www.dropbox.com/s/cnrak5pvu4agfk4/S-2014-002.pdf?dl=0)
* [SMPTE ST 2065-1:2021, Academy Color Encoding Specification (ACES)](https://doi.org/10.5594/SMPTE.ST2065-1.2021)
* [SMPTE ST 2065-4:2013, ACES Image Container File Layout](https://doi.org/10.5594/SMPTE.ST2065-4.2013)
* [Academy TB-2014-010, Design, Integration and Use of ACES Look Modification Transforms (LMTs)](https://www.dropbox.com/s/grjoi885tv78e70/TB-2014-010.pdf?dl=0)
* [ISO 8601:2004, Data elements and interchange formats – Information interchange – Representation of datesand times](https://www.iso.org/standard/40874.html)
* [ISO/IEC 11578:1996, Information technology – Open Systems Interconnection – Remote Procedure Call(RPC)](https://www.iso.org/standard/2229.html)
* [SMPTE ST 2067-50, Interoperable Master Format — Application #5 ACES](https://doi.org/10.5594/SMPTE.ST2067-50.2018)
* [SMPTE RDD 47, Interoperable Master Format — Isochronous Stream of XML Documents (ISXD) Plugin](https://doi.org/10.5594/SMPTE.RDD47.2018)
* [SMPTE ST.2067-9, Interoperable Master Format — Sidecar Composition Map](https://doi.org/10.5594/SMPTE.ST2067-9.2018)

Introduction
----------------
### Why is metadata needed for ACES?
Expand Down Expand Up @@ -63,13 +49,13 @@ AMFs can also serve as effective archival elements. When paired with finished AC
AMFs do not contain “timeline” metadata such as edit points. Timeline management files such as EditDecision Lists (EDLs) or Avid Log Exchange files (ALEs) may reference AMFs, attaching them to editingevents and thus enable standardized color management throughout all stages of production.

<figure align="center" markdown>
![amfDiagram](./images/amfDiagram.png){ width="350" }
![amfDiagram](./images/amfDiagram.png)
<figcaption align="center">
<b>Figure1 1.</b>Overall structure of an AMF in simplified form.
</figcaption>
</figure>

Use Case
Use Cases
----------------
ACES Metadata Files (AMFs) are intended to contain the minimum required metadata for transferring information about ACES viewing pipelines during production, post-production, and archival.

Expand Down Expand Up @@ -124,9 +110,9 @@ Data Model
----------------
This section describes the data intended for use within the ACES Metadata file.

All top level structures shall be tagged as being within the \texttt{aces} namespace with urn `urn:acesMetadata:acesMetadataFile:v1.0`
All top level structures shall be tagged as being within the `aces` namespace with urn `urn:acesMetadata:acesMetadataFile:v1.0`

### UML Diagram
`### UML Diagram
The following UML diagrams are segments of the complete UML diagram which is not included in this document due to space constraints. To view the entire UML diagram in SVG format visit \url{https://aces.mp/amf\_uml}.

#### acesMetadataFile
Expand All @@ -140,7 +126,6 @@ The following UML diagrams are segments of the complete UML diagram which is not
![amfDiagram ](./uml_diagrams/uml_amfInfo.svg)
</figure>


#### clipId
<figure align="center" markdown>
![amfDiagram ](./uml_diagrams/uml_clipId.svg)
Expand All @@ -151,7 +136,6 @@ The following UML diagrams are segments of the complete UML diagram which is not
![amfDiagram ](./uml_diagrams/uml_pipeline.svg)
</figure>


#### pipelineInfo
<figure align="center" markdown>
![amfDiagram ](./uml_diagrams/uml_piplineInfo.svg)
Expand All @@ -174,17 +158,30 @@ The following UML diagrams are segments of the complete UML diagram which is not


### Types

The following types are defined for use within the AMF XML file and are validated with the XSD schema included in Appendix A. The types are used as the basis to form the elements listed in section X in the schema.

\input{sec-types.tex}


### Elements (by type)

The following elements are defined for use with the AMF XML file and are validated with the XSD schema included in Appendix A.


References
----------
The following standards, specifications, articles, presentations, and texts are referenced in this text:

* [Academy S-2014-002, Academy Color Encoding System - Versioning System](https://www.dropbox.com/s/cnrak5pvu4agfk4/S-2014-002.pdf?dl=0)
* [SMPTE ST 2065-1:2021, Academy Color Encoding Specification (ACES)](https://doi.org/10.5594/SMPTE.ST2065-1.2021)
* [SMPTE ST 2065-4:2013, ACES Image Container File Layout](https://doi.org/10.5594/SMPTE.ST2065-4.2013)
* [Academy TB-2014-010, Design, Integration and Use of ACES Look Modification Transforms (LMTs)](https://www.dropbox.com/s/grjoi885tv78e70/TB-2014-010.pdf?dl=0)
* [ISO 8601:2004, Data elements and interchange formats – Information interchange – Representation of datesand times](https://www.iso.org/standard/40874.html)
* [ISO/IEC 11578:1996, Information technology – Open Systems Interconnection – Remote Procedure Call(RPC)](https://www.iso.org/standard/2229.html)
* [SMPTE ST 2067-50, Interoperable Master Format — Application #5 ACES](https://doi.org/10.5594/SMPTE.ST2067-50.2018)
* [SMPTE RDD 47, Interoperable Master Format — Isochronous Stream of XML Documents (ISXD) Plugin](https://doi.org/10.5594/SMPTE.RDD47.2018)
* [SMPTE ST.2067-9, Interoperable Master Format — Sidecar Composition Map](https://doi.org/10.5594/SMPTE.ST2067-9.2018)


<!-- Include section numbering -->
<style>
@import "../../stylesheets/sections.css"
Expand Down
File renamed without changes
File renamed without changes.
File renamed without changes.
File renamed without changes.
39 changes: 39 additions & 0 deletions docs/encodings/aces2065/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
ACES2065-1
====

## Summary
ACES2065-1 is linear data that is encoded relative to the AP0 color primaries and ACES white point.

ACES2065-1 is fully documented in [ST 2065-1:2021 - SMPTE Standard - Academy Color Encoding Specification (ACES)](https://doi.org/10.5594/SMPTE.ST2065-1.2021).

## Technical Specification
### Color primaries
The chromaticity values of the RGB primaries (known as AP0) shall be those found below:

<div align="center" markdown>
| | **R** | **G** | **B** | | **CIE x** | **CIE y** |
|-------|-------|-------|-------|---|-----------|-----------|
| Red | 1.0 | 0.0 | 0.0 | | 0.73470 | 0.26530 |
| Green | 0.0 | 1.0 | 0.0 | | 0.00000 | 1.000 |
| Blue | 0.0 | 0.0 | 1.0 | | 0.00010 | -0.077 |
</div>

<figcaption align="center">
AP0 RGB primaries chromaticity values
</figcaption>

### White point
The white point shall be:

<div align="center" markdown>
| | **R** | **G** | **B** | | **CIE x** | **CIE y** |
|-------|-------|-------|-------|---|-----------|-----------|
| White | 1.0 | 1.0 | 1.0 | | 0.32168 | 0.33767 |
</div>

<figcaption align="center">
AP0 RGB white point chromaticity values
</figcaption>


### Transfer Function
Loading

0 comments on commit dc6f110

Please sign in to comment.