Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Replace explicit input_image_item_index by token #248

Merged
merged 1 commit into from
Sep 24, 2024

Conversation

y-guyon
Copy link
Collaborator

@y-guyon y-guyon commented Sep 20, 2024

Clarify the comments of the SampleTransform syntax code snippet. Refactor Table 2 columns.


Preview | Diff

Clarify the comments of the SampleTransform syntax code snippet.
Refactor Table 2 columns.
<h5 id="sample-transform-constraints">Constraints</h5>

[=Sample Transform Derived Image Items=] use the postfix notation to evaluate the result of the whole expression for each reconstructed image item sample.

- The tokens shall be evaluated in the order they are defined in the metadata (the <code>SampleTransform</code> structure) of the [=Sample Transform Derived Image Item=].
- <code>token</code> shall be at most <code>[=reference_count=]</code> when evaluating a sample operand (when <math><mn>1</mn><mo>≤</mo><mi>token</mi><mo>≤</mo><mn>32</mn></math>).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we say somewhere that reference_count shall be <= 32?

Copy link
Collaborator Author

@y-guyon y-guyon Sep 20, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is not strictly necessary. One stronger constraint could be "all input image items have to be referenced by at least one sample operand token". But it does not bring much to implementations in my opinion, even with a "should", so I would rather avoid it. Files with unused input image items are pretty harmless, is it worth rejecting them?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

One benefit of this constraint would be an explicit limit of 32 input image items. The current wording is indirect.

@y-guyon y-guyon merged commit 81ad232 into AOMediaCodec:master Sep 24, 2024
@y-guyon y-guyon deleted the sato_token branch September 24, 2024 09:15
github-actions bot added a commit that referenced this pull request Sep 24, 2024
SHA: 81ad232
Reason: push, by y-guyon

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants