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

Parse EntityGroup Remaining Data #1139

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

dukesook
Copy link
Contributor

@dukesook dukesook commented Mar 6, 2024

Some EntityToGroupBoxes have additional data at the end of the box (see ISO/IEC 14496-12 section 8.18.3.2). Currently, the libheif Box_grpl class doesn't parse any additional data. This pull request resolves this issue by moving the EntityGroup struct to its own class which allows for other boxes to inherit from it and specify how to parse their own remaining data.

For use cases, see ISO/IEC 23008-12 section 6.8 Entity and Sample Groups which mention the following entity groups:

Equivalent Boxes (eqiz)
Burst Images (brst)
Time-synchronized group (tsyn)
Auto to Image group (iaug)
etc...
Personally, I'm interested in the Image Pyramid Entity Group (pymd) which will be added to HEIF version 3.
Sample Files:
C007.heic
Contains a grpl box with an "altr" EntityGroup. The altr box doesn't have additional data at the end of the box, so it can simply reuse the defined EntityGroup class. No Box_altr is required.

multilayer003.heic
Contains a grpl box with an "ster" EntityGroup. The ster box has an additional flag so the Box_ster parse_remaining() function accounts for this.

With this new group list architecture, libheif is better suited for handling Entity Groups with remaining data
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.

None yet

1 participant