Что такое целочисленный индекс страницы?
Целочисленный индекс страницы обозначает индекс с нулевой базой (0-based index) который используется для отслеживания страниц в PDF-файле. Первая страница имеет целочисленный индекс страницы ноль.
Эта система индексирования в основном используется внутренними структурами данных PDF и отличается от идентификаторов фрагментов (Fragment Identifiers) , которые используют систему счета, начинающуюся с 1.
Почему существуют две системы нумерации одновременно
Целочисленный индекс страницы является внутренней деталью реализации: так дерево страниц внутри файла ссылается на свои страницы. Он начинается с нуля, потому что это смещение в массиве, а не человекоориентированный номер. То, что читатель видит на экране, устроено иначе. Это определяется метками страниц, которые могут использовать римские цифры, буквы или комбинации глава-страница и при этом не обязаны начинаться с единицы или идти по порядку.
Когда разница имеет значение
Две системы отличаются на единицу, и эта разница часто становится источником ошибок «на единицу» при автоматизации работы с PDF. идентификатор фрагмента например параметр page в URL, считает с единицы, как это делает человек, тогда как внутренний индекс считает с нуля.
Когда инструмент спрашивает, какую страницу нужно разделить, повернуть или удалить, почти всегда речь идет о человекоориентированной нумерации. Когда библиотека сообщает номер страницы, сначала проверьте, какую из двух систем она использует, прежде чем полагаться на это значение.