Skip to content

Specify overview IFD subfile type and IFD order#14

Open
jleben wants to merge 1 commit intocogeotiff:masterfrom
jleben:formalize-overviews
Open

Specify overview IFD subfile type and IFD order#14
jleben wants to merge 1 commit intocogeotiff:masterfrom
jleben:formalize-overviews

Conversation

@jleben
Copy link

@jleben jleben commented Nov 29, 2022

In order to recognize overviews as such, GDAL needs overview IFDs to have the NewSubfileType tag equal to 1, and that overview IFDs follow the full resolution image according to the order given by the pointers. This is also the minimal requirement that any COG processing software would need in order to identify overviews as such and to associate them with the full resolution image.

This pull request formalizes the above requirements.

In addition, this pull request changes the word "structure" to "layout" to emphasize the distinction between the layout of data in the file versus the logical order of IFDs given by the pointers.


The IFDs shall be linked by the pointers (the offset of the first IFD in the file header and the offset of the next IFD in each IFD) so that the full resolution image is first, followed by the overviews.

Each IFD representing an overview shall have the tag NewSubfileType (254) with a value of 1, indicating the "reduced resolution image" subfile type.
Copy link
Collaborator

Choose a reason for hiding this comment

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

IFDs representing a mask should have value 4
IFDs representing the overview of a mask should have value 5

Copy link
Author

Choose a reason for hiding this comment

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

Thanks, I'll study this suggestion and update the pull request.

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.

2 participants