octoleo/qpdf
2
1
Fork 0
mirror of https://github.com/qpdf/qpdf.git synced 2024-12-22 19:08:59 +00:00
Code Issues Releases Wiki Activity

Add QPDFPageObjectHelper::getMatrixForFormXObjectPlacement

Browse Source
This commit is contained in:
Jay Berkenbilt 2021-02-18 09:14:05 -05:00
parent 0765872295
commit 5cec6b4c3d
4 changed files with 42 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
ChangeLog
View File

@ -1,5 +1,10 @@
2021-02-18 Jay Berkenbilt <ejb@ql.org> 2021-02-18 Jay Berkenbilt <ejb@ql.org>
* Add QPDFPageObjectHelper::getMatrixForFormXObjectPlacement,
which returns the transformation matrix required to map from a
form field's coordinate system into a specific rectangle within
the page.
* Add QUtil::path_basename to get last element of a path. * Add QUtil::path_basename to get last element of a path.
* Add examples/pdf-attach-file.cc to illustrate new file * Add examples/pdf-attach-file.cc to illustrate new file

11
include/qpdf/QPDFPageObjectHelper.hh
View File

@ -24,6 +24,7 @@
#include <qpdf/QPDFObjectHelper.hh> #include <qpdf/QPDFObjectHelper.hh>
#include <qpdf/QPDFAnnotationObjectHelper.hh> #include <qpdf/QPDFAnnotationObjectHelper.hh>
#include <qpdf/QPDFMatrix.hh>
#include <qpdf/DLL.h> #include <qpdf/DLL.h>
@ -306,6 +307,16 @@ class QPDFPageObjectHelper: public QPDFObjectHelper
bool allow_shrink = true, bool allow_shrink = true,
bool allow_expand = false); bool allow_expand = false);
// Return the transformation matrix that translates from the given
// form XObject's coordinate system into the given rectangular
// region on the page. The parameters have the same meaning as for
// placeFormXObject.
QPDF_DLL
QPDFMatrix getMatrixForFormXObjectPlacement(
QPDFObjectHandle fo, QPDFObjectHandle::Rectangle rect,
bool invert_transformations = true,
bool allow_shrink = true, bool allow_expand = false);
// If a page is rotated using /Rotate in the page's dictionary, // If a page is rotated using /Rotate in the page's dictionary,
// instead rotate the page by the same amount by altering the // instead rotate the page by the same amount by altering the
// contents and removing the /Rotate key. This method adjusts the // contents and removing the /Rotate key. This method adjusts the

23
libqpdf/QPDFPageObjectHelper.cc
View File

@ -947,10 +947,9 @@ QPDFPageObjectHelper::getFormXObjectForPage(bool handle_transformations)
return result; return result;
} }
std::string QPDFMatrix
QPDFPageObjectHelper::placeFormXObject( QPDFPageObjectHelper::getMatrixForFormXObjectPlacement(
QPDFObjectHandle fo, std::string const& name, QPDFObjectHandle fo, QPDFObjectHandle::Rectangle rect,
QPDFObjectHandle::Rectangle rect,
bool invert_transformations, bool invert_transformations,
bool allow_shrink, bool allow_expand) bool allow_shrink, bool allow_expand)
{ {
@ -971,7 +970,7 @@ QPDFPageObjectHelper::placeFormXObject(
QPDFObjectHandle bbox_obj = fdict.getKey("/BBox"); QPDFObjectHandle bbox_obj = fdict.getKey("/BBox");
if (! bbox_obj.isRectangle()) if (! bbox_obj.isRectangle())
{ {
return ""; return QPDFMatrix();
} }
QPDFMatrix wmatrix; // work matrix QPDFMatrix wmatrix; // work matrix
@ -1014,7 +1013,7 @@ QPDFPageObjectHelper::placeFormXObject(
if ((T.urx == T.llx) || (T.ury == T.lly)) if ((T.urx == T.llx) || (T.ury == T.lly))
{ {
// avoid division by zero // avoid division by zero
return ""; return QPDFMatrix();
} }
double rect_w = rect.urx - rect.llx; double rect_w = rect.urx - rect.llx;
double rect_h = rect.ury - rect.lly; double rect_h = rect.ury - rect.lly;
@ -1060,6 +1059,18 @@ QPDFPageObjectHelper::placeFormXObject(
cm.translate(tx, ty); cm.translate(tx, ty);
cm.scale(scale, scale); cm.scale(scale, scale);
cm.concat(tmatrix); cm.concat(tmatrix);
return cm;
}
std::string
QPDFPageObjectHelper::placeFormXObject(
QPDFObjectHandle fo, std::string const& name,
QPDFObjectHandle::Rectangle rect,
bool invert_transformations,
bool allow_shrink, bool allow_expand)
{
QPDFMatrix cm = getMatrixForFormXObjectPlacement(
fo, rect, invert_transformations, allow_shrink, allow_expand);
return ( return (
"q\n" + "q\n" +
cm.unparse() + " cm\n" + cm.unparse() + " cm\n" +

9
manual/qpdf-manual.xml
View File

@ -5283,6 +5283,15 @@ print "\n";
matrices. matrices.
</para> </para>
</listitem> </listitem>
<listitem>
<para>
Add
<function>QPDFPageObjectHelper::getMatrixForFormXObjectPlacement</function>
which returns the transformation matrix required to map from
a form field's coordinate system into a specific rectangle
within the page.
</para>
</listitem>
<listitem> <listitem>
<para> <para>
Add <function>QUtil::path_basename</function> to return the Add <function>QUtil::path_basename</function> to return the