QPdfDocument::pageSize的单位是什么?

What are the units of QPdfDocument::pageSize?

QPdfDocument (5.15.2),在QtPDF模块(QtWebEngine的一部分),似乎还没有完全记录(大概因为它相当新,首次出现在 5.14)。

QPdfDocument::pageSize() 返回的大小单位是什么(不要费心去检查那些文档,那里没有)?

它似乎是一些合理的(虽然看似低分辨率)类像素单元,但我不确定它是如何推断文档的 DPI 的。此外,我只测试了从同一来源生成的一组有限的 PDF,所以我不确定我的观察结果有多正常,特别是考虑到它是 QSizeF 而不是 QSize(哪个提高了例如在其他尚未遇到的上下文中的其他非像素单元的可能性)。

最终我想做的是以物理单位(例如英寸)获取加载文档页面的页面大小,然后在给定用户指定的 DPI 的情况下确定以像素为单位的渲染输出大小。


我观察到的值的示例:

#include <QCoreApplication>
#include <QDebug>
#include <QtNetwork>
#include <QtPdf>

int main (int argc, char *argv[]) {

    QCoreApplication app(argc, argv);

    QUrl url("http://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf");
    QNetworkAccessManager internet;
    QNetworkReply *reply = internet.get(QNetworkRequest(url));

    QObject::connect(reply, &QNetworkReply::finished, [reply] () {
        QPdfDocument pdf;
        pdf.load(reply);
        qDebug() << reply->url() << ":";
        for (int k = 0; k < pdf.pageCount(); ++ k)
            qDebug() << k << pdf.pageSize(k);
        QCoreApplication::exit();
    });

    return app.exec();

}

输出:

QUrl("http://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf") :
0 QSizeF(595, 842)

看起来 implementation is done with PDFium. Qt calls FPDF_GetPageSizeByIndex and the docs 状态 height/width 是点:

// Function: FPDF_GetPageSizeByIndex
//          Get the size of the page at the given index.
// Parameters:
//          document    -   Handle to document. Returned by FPDF_LoadDocument.
//          page_index  -   Page index, zero for the first page.
//          width       -   Pointer to a double to receive the page width
//                          (in points).
//          height      -   Pointer to a double to receive the page height
//                          (in points).
// Return value:
//          Non-zero for success. 0 for error (document or page not found).
// Note:
//          Prefer FPDF_GetPageSizeByIndexF() above. This will be deprecated in
//          the future.
FPDF_EXPORT int FPDF_CALLCONV FPDF_GetPageSizeByIndex(FPDF_DOCUMENT document,
                                                      int page_index,
                                                      double* width,
                                                      double* height);

这在PDFium SDK manual中也有注明。