如何向现有 pdf 添加带有 link 注释的叠加文本？
How to add overlay text with link annotations to existing pdf?
我想在叠加文本中添加 link。我读过使用 Anchor 仅适用于从头开始制作的文档，但不适用于现有的 pdf。我的代码正在向每个页面添加覆盖文本。我的目标是使该文本的一部分可点击。我不知道如何制作作为短语一部分的 link 注释。
这是我的代码：
int n = reader.getNumberOfPages();
// step 4: we add content
PdfImportedPage page;
PdfCopy.PageStamp stamp;
for (int j = 0; j < n; )
{
++j;
page = writer.getImportedPage(reader, j);
if (i == 1) {
stamp = writer.createPageStamp(page);
Rectangle mediabox = reader.getPageSize(j);
Rectangle crop = new Rectangle(mediabox);
writer.setCropBoxSize(crop);
// add overlay text
Paragraph p = new Paragraph();
p.setAlignment(Element.ALIGN_CENTER);
FONT_URL_OVERLAY.setColor(0, 191, 255);
// get current user
EPerson loggedin = context.getCurrentUser();
String eperson = null;
if (loggedin != null)
{
eperson = loggedin.getFullName();
}
else eperson = "Anonymous";
Phrase downloaded = new Phrase();
Chunk site = new Chunk("My Website",FONT_URL_OVERLAY);
site.setAction(new PdfAction("http://www.mywebsite.com"));
downloaded.add(new Chunk("Downloaded by [" + eperson + "] from ", FONT_OVERLAY));
downloaded.add(site);
downloaded.add(new Chunk(" on ", FONT_OVERLAY));
downloaded.add(new Chunk(new SimpleDateFormat("MMMM d, yyyy").format(new Date()), FONT_OVERLAY));
downloaded.add(new Chunk(" at ", FONT_OVERLAY));
downloaded.add(new Chunk(new SimpleDateFormat("h:mm a z").format(new Date()), FONT_OVERLAY));
p.add(downloaded);
ColumnText.showTextAligned(stamp.getOverContent(), Element.ALIGN_CENTER, p,
crop.getLeft(10), crop.getHeight() / 2 + crop.getBottom(), 90);
stamp.alterContents();
}
writer.addPage(page);
}
所以我的叠加层看起来像这样：
Downloaded by [Anonymous] from My Website on February 17, 2015 at 1:20 AM CST
如何将 我的网站 转换为 link 注释？在 SO 中搜索这里，我找到了这个 post，但我不知道如何将添加 link 注释应用到我的覆盖文本的一部分。
提前致谢。
编辑：如何向现有 pdf 添加带 link 注释的旋转覆盖文本？
感谢 Bruno Lowagie 不厌其烦地回答我的问题。虽然我最初问的是如何在现有 pdf 的叠加文本中添加 link 注释，但他还在他的回答的评论部分解决了我关于在旋转叠加文本时正确设置坐标的问题。
您使用的 ColumnText.showAligned() 足以添加一行没有任何特殊功能的文本，但如果您希望锚点起作用，则需要以不同的方式使用 ColumnText。
这显示在 AddLinkAnnotation2 示例中：
public void manipulatePdf(String src, String dest) throws IOException, DocumentException {
PdfReader reader = new PdfReader(src);
PdfStamper stamper = new PdfStamper(reader, new FileOutputStream(dest));
PdfContentByte canvas = stamper.getOverContent(1);
Font bold = new Font(FontFamily.HELVETICA, 12, Font.BOLD);
Chunk chunk = new Chunk("The Best iText Questions on Whosebug", bold);
chunk.setAnchor("http://pages.itextpdf.com/ebook-Whosebug-questions.html");
Phrase p = new Phrase("Download ");
p.add(chunk);
p.add(" and discover more than 200 questions and answers.");
ColumnText ct = new ColumnText(canvas);
ct.setSimpleColumn(36, 700, 559, 750);
ct.addText(p);
ct.go();
stamper.close();
reader.close();
}
在这种情况下，我们为 ColumnText 对象定义一个矩形，我们将 Phrase 添加到列中，然后我们 go().
如果您检查结果，link_annotation2.pdf，您会注意到您可以单击粗体字词。
ColumnText.showTextAligned() 中没有支持此功能的计划。这是一种方便的方法，可以用作上面显示的少数几行的快捷方式，但有一些已知的限制：行不换行，交互性被忽略，...
更新 1： 在评论部分，您问了一个关于旋转内容和 link.
的附加问题
旋转内容并不困难。甚至有不止一种方法可以做到这一点。旋转 link 并非易事，因为 link 是一种注释，注释不是内容的一部分。
我们先来看看AddLinkAnnotation3:
public void manipulatePdf(String src, String dest) throws IOException, DocumentException {
PdfReader reader = new PdfReader(src);
PdfStamper stamper = new PdfStamper(reader, new FileOutputStream(dest));
AffineTransform transform = AffineTransform.getRotateInstance(Math.PI / 6);
stamper.getWriter().setPageEvent(new AddAnnotation(stamper, transform));
PdfContentByte canvas = stamper.getOverContent(1);
Font bold = new Font(FontFamily.HELVETICA, 12, Font.BOLD);
Chunk chunk = new Chunk("The Best iText Questions on Whosebug", bold);
chunk.setGenericTag("http://pages.itextpdf.com/ebook-Whosebug-questions.html");
Phrase p = new Phrase("Download ");
p.add(chunk);
p.add(" and discover more than 200 questions and answers.");
canvas.saveState();
canvas.concatCTM(transform);
ColumnText ct = new ColumnText(canvas);
ct.setSimpleColumn(300, 0, 800, 400);
ct.addText(p);
ct.go();
canvas.restoreState();
stamper.close();
reader.close();
}
在这个例子中，我们定义了一个30度的变换（Math.PI / 6）：
AffineTransform transform = AffineTransform.getRotateInstance(Math.PI / 6);
我们在渲染列时使用这个转换：
canvas.saveState();
canvas.concatCTM(transform);
// render column
canvas.restoreState();
这会旋转内容，但我们还没有添加任何注释。相反，我们定义一个页面事件：
stamper.getWriter().setPageEvent(new AddAnnotation(stamper, transform));
我们引入了一个通用标签：
chunk.setGenericTag("http://pages.itextpdf.com/ebook-Whosebug-questions.html");
为了添加注释，我们在页面事件实现中使用了一些魔法：
public class AddAnnotation extends PdfPageEventHelper {
protected PdfStamper stamper;
protected AffineTransform transform;
public AddAnnotation(PdfStamper stamper, AffineTransform transform) {
this.stamper = stamper;
this.transform = transform;
}
@Override
public void onGenericTag(PdfWriter writer, Document document, Rectangle rect, String text) {
float[] pts = {rect.getLeft(), rect.getBottom(), rect.getRight(), rect.getTop()};
transform.transform(pts, 0, pts, 0, 2);
float[] dstPts = {pts[0], pts[1], pts[2], pts[3]};
rect = new Rectangle(dstPts[0], dstPts[1], dstPts[2], dstPts[3]);
PdfAnnotation annot = PdfAnnotation.createLink(writer, rect, PdfAnnotation.HIGHLIGHT_INVERT, new PdfAction(text));
stamper.addAnnotation(annot, 1);
}
}
我们创建了一个注释，但在此之前，我们对矩形进行了转换。这确保了文本适合需要可点击的文本的矩形，但是......这可能不是你所期望的：
您可能想要旋转矩形，这是可能的，但这更多的是数学。例如：您可以创建一个更适合的多边形：ITextShape Clickable Polygon or path
幸运的是，您不需要 30 度角，您想要将文本旋转 90 度角。在那种情况下，您不会看到上面屏幕截图中显示的奇怪效果。
public class AddAnnotation extends PdfPageEventHelper {
protected PdfStamper stamper;
protected AffineTransform transform;
public AddAnnotation(PdfStamper stamper, AffineTransform transform) {
this.stamper = stamper;
this.transform = transform;
}
@Override
public void onGenericTag(PdfWriter writer, Document document, Rectangle rect, String text) {
float[] pts = {rect.getLeft(), rect.getBottom(), rect.getRight(), rect.getTop()};
transform.transform(pts, 0, pts, 0, 2);
float[] dstPts = {pts[0], pts[1], pts[2], pts[3]};
rect = new Rectangle(dstPts[0], dstPts[1], dstPts[2], dstPts[3]);
PdfAnnotation annot = PdfAnnotation.createLink(writer, rect, PdfAnnotation.HIGHLIGHT_INVERT, new PdfAction(text));
annot.setBorder(new PdfBorderArray(0, 0, 0));
stamper.addAnnotation(annot, 1);
}
}
如您所见，我添加了一行来删除边框（边框默认存在，除非您重新定义 PdfBorderArray）。
其余代码也几乎相同。我们现在定义一个角度 Math.PI / 2（90 度）。
public void manipulatePdf(String src, String dest) throws IOException, DocumentException {
PdfReader reader = new PdfReader(src);
PdfStamper stamper = new PdfStamper(reader, new FileOutputStream(dest));
AffineTransform transform = AffineTransform.getRotateInstance(Math.PI / 2);
stamper.getWriter().setPageEvent(new AddAnnotation(stamper, transform));
PdfContentByte canvas = stamper.getOverContent(1);
Font bold = new Font(FontFamily.HELVETICA, 12, Font.BOLD);
Chunk chunk = new Chunk("The Best iText Questions on Whosebug", bold);
chunk.setGenericTag("http://pages.itextpdf.com/ebook-Whosebug-questions.html");
Phrase p = new Phrase("Download ");
p.add(chunk);
p.add(" and discover more than 200 questions and answers.");
canvas.saveState();
canvas.concatCTM(transform);
ColumnText ct = new ColumnText(canvas);
ct.setSimpleColumn(36, -559, 806, -36);
ct.addText(p);
ct.go();
canvas.restoreState();
stamper.close();
reader.close();
}
请注意，页面的左下角是轴心点，因此我们需要调整添加列的坐标，否则您将旋转页面可见区域之外的所有内容。
更新二：
在另一条评论中，您询问了在旋转坐标系中添加文本时需要使用的坐标。
我画了这张图：
在顶部，您在页面中间添加了 MIDDLE 一词，但这不是它会出现的位置：您将所有内容旋转 90 度，因此 MIDDLE 一词将旋转到 外面您的页面（进入阴影区域）。这个词会出现在 PDF 中，但您永远看不到它。
如果您查看我的代码，您会发现我使用了这些坐标：
ct.setSimpleColumn(36, -559, 806, -36);
这在可见区域之外（低于实际页面尺寸），但是当我将所有内容旋转 90 度时，它会旋转到可见区域.
如果你看我的图，你可以看到坐标为(0, 0)、(0, -595)、(842, -598)和(842, 0)的页面旋转了90度，因此与坐标为 (0, 0)、(595, 0)、(595, 842) 和 (0, 842) 的页面重合。这就是我们在高中时都学过的数学类型 ;-)
您正在 crop.getLeft(10), crop.getHeight() / 2 + crop.getBottom() 位置添加文本。如果你知道文本会旋转 90 度，你应该使用 crop.getHeight() / 2 + crop.getBottom(), -crop.getLeft().
理解原因的最好方法是画图。
我想在叠加文本中添加 link。我读过使用 Anchor 仅适用于从头开始制作的文档，但不适用于现有的 pdf。我的代码正在向每个页面添加覆盖文本。我的目标是使该文本的一部分可点击。我不知道如何制作作为短语一部分的 link 注释。
这是我的代码：
int n = reader.getNumberOfPages();
// step 4: we add content
PdfImportedPage page;
PdfCopy.PageStamp stamp;
for (int j = 0; j < n; )
{
++j;
page = writer.getImportedPage(reader, j);
if (i == 1) {
stamp = writer.createPageStamp(page);
Rectangle mediabox = reader.getPageSize(j);
Rectangle crop = new Rectangle(mediabox);
writer.setCropBoxSize(crop);
// add overlay text
Paragraph p = new Paragraph();
p.setAlignment(Element.ALIGN_CENTER);
FONT_URL_OVERLAY.setColor(0, 191, 255);
// get current user
EPerson loggedin = context.getCurrentUser();
String eperson = null;
if (loggedin != null)
{
eperson = loggedin.getFullName();
}
else eperson = "Anonymous";
Phrase downloaded = new Phrase();
Chunk site = new Chunk("My Website",FONT_URL_OVERLAY);
site.setAction(new PdfAction("http://www.mywebsite.com"));
downloaded.add(new Chunk("Downloaded by [" + eperson + "] from ", FONT_OVERLAY));
downloaded.add(site);
downloaded.add(new Chunk(" on ", FONT_OVERLAY));
downloaded.add(new Chunk(new SimpleDateFormat("MMMM d, yyyy").format(new Date()), FONT_OVERLAY));
downloaded.add(new Chunk(" at ", FONT_OVERLAY));
downloaded.add(new Chunk(new SimpleDateFormat("h:mm a z").format(new Date()), FONT_OVERLAY));
p.add(downloaded);
ColumnText.showTextAligned(stamp.getOverContent(), Element.ALIGN_CENTER, p,
crop.getLeft(10), crop.getHeight() / 2 + crop.getBottom(), 90);
stamp.alterContents();
}
writer.addPage(page);
}
所以我的叠加层看起来像这样：
Downloaded by [Anonymous] from My Website on February 17, 2015 at 1:20 AM CST
如何将 我的网站 转换为 link 注释？在 SO 中搜索这里，我找到了这个 post，但我不知道如何将添加 link 注释应用到我的覆盖文本的一部分。
提前致谢。
编辑：如何向现有 pdf 添加带 link 注释的旋转覆盖文本？
感谢 Bruno Lowagie 不厌其烦地回答我的问题。虽然我最初问的是如何在现有 pdf 的叠加文本中添加 link 注释，但他还在他的回答的评论部分解决了我关于在旋转叠加文本时正确设置坐标的问题。
您使用的 ColumnText.showAligned() 足以添加一行没有任何特殊功能的文本，但如果您希望锚点起作用，则需要以不同的方式使用 ColumnText。
这显示在 AddLinkAnnotation2 示例中：
public void manipulatePdf(String src, String dest) throws IOException, DocumentException {
PdfReader reader = new PdfReader(src);
PdfStamper stamper = new PdfStamper(reader, new FileOutputStream(dest));
PdfContentByte canvas = stamper.getOverContent(1);
Font bold = new Font(FontFamily.HELVETICA, 12, Font.BOLD);
Chunk chunk = new Chunk("The Best iText Questions on Whosebug", bold);
chunk.setAnchor("http://pages.itextpdf.com/ebook-Whosebug-questions.html");
Phrase p = new Phrase("Download ");
p.add(chunk);
p.add(" and discover more than 200 questions and answers.");
ColumnText ct = new ColumnText(canvas);
ct.setSimpleColumn(36, 700, 559, 750);
ct.addText(p);
ct.go();
stamper.close();
reader.close();
}
在这种情况下，我们为 ColumnText 对象定义一个矩形，我们将 Phrase 添加到列中，然后我们 go().
如果您检查结果，link_annotation2.pdf，您会注意到您可以单击粗体字词。
ColumnText.showTextAligned() 中没有支持此功能的计划。这是一种方便的方法，可以用作上面显示的少数几行的快捷方式，但有一些已知的限制：行不换行，交互性被忽略，...
更新 1： 在评论部分，您问了一个关于旋转内容和 link.
的附加问题旋转内容并不困难。甚至有不止一种方法可以做到这一点。旋转 link 并非易事，因为 link 是一种注释，注释不是内容的一部分。
我们先来看看AddLinkAnnotation3:
public void manipulatePdf(String src, String dest) throws IOException, DocumentException {
PdfReader reader = new PdfReader(src);
PdfStamper stamper = new PdfStamper(reader, new FileOutputStream(dest));
AffineTransform transform = AffineTransform.getRotateInstance(Math.PI / 6);
stamper.getWriter().setPageEvent(new AddAnnotation(stamper, transform));
PdfContentByte canvas = stamper.getOverContent(1);
Font bold = new Font(FontFamily.HELVETICA, 12, Font.BOLD);
Chunk chunk = new Chunk("The Best iText Questions on Whosebug", bold);
chunk.setGenericTag("http://pages.itextpdf.com/ebook-Whosebug-questions.html");
Phrase p = new Phrase("Download ");
p.add(chunk);
p.add(" and discover more than 200 questions and answers.");
canvas.saveState();
canvas.concatCTM(transform);
ColumnText ct = new ColumnText(canvas);
ct.setSimpleColumn(300, 0, 800, 400);
ct.addText(p);
ct.go();
canvas.restoreState();
stamper.close();
reader.close();
}
在这个例子中，我们定义了一个30度的变换（Math.PI / 6）：
AffineTransform transform = AffineTransform.getRotateInstance(Math.PI / 6);
我们在渲染列时使用这个转换：
canvas.saveState();
canvas.concatCTM(transform);
// render column
canvas.restoreState();
这会旋转内容，但我们还没有添加任何注释。相反，我们定义一个页面事件：
stamper.getWriter().setPageEvent(new AddAnnotation(stamper, transform));
我们引入了一个通用标签：
chunk.setGenericTag("http://pages.itextpdf.com/ebook-Whosebug-questions.html");
为了添加注释，我们在页面事件实现中使用了一些魔法：
public class AddAnnotation extends PdfPageEventHelper {
protected PdfStamper stamper;
protected AffineTransform transform;
public AddAnnotation(PdfStamper stamper, AffineTransform transform) {
this.stamper = stamper;
this.transform = transform;
}
@Override
public void onGenericTag(PdfWriter writer, Document document, Rectangle rect, String text) {
float[] pts = {rect.getLeft(), rect.getBottom(), rect.getRight(), rect.getTop()};
transform.transform(pts, 0, pts, 0, 2);
float[] dstPts = {pts[0], pts[1], pts[2], pts[3]};
rect = new Rectangle(dstPts[0], dstPts[1], dstPts[2], dstPts[3]);
PdfAnnotation annot = PdfAnnotation.createLink(writer, rect, PdfAnnotation.HIGHLIGHT_INVERT, new PdfAction(text));
stamper.addAnnotation(annot, 1);
}
}
我们创建了一个注释，但在此之前，我们对矩形进行了转换。这确保了文本适合需要可点击的文本的矩形，但是......这可能不是你所期望的：
您可能想要旋转矩形，这是可能的，但这更多的是数学。例如：您可以创建一个更适合的多边形：ITextShape Clickable Polygon or path
幸运的是，您不需要 30 度角，您想要将文本旋转 90 度角。在那种情况下，您不会看到上面屏幕截图中显示的奇怪效果。
public class AddAnnotation extends PdfPageEventHelper {
protected PdfStamper stamper;
protected AffineTransform transform;
public AddAnnotation(PdfStamper stamper, AffineTransform transform) {
this.stamper = stamper;
this.transform = transform;
}
@Override
public void onGenericTag(PdfWriter writer, Document document, Rectangle rect, String text) {
float[] pts = {rect.getLeft(), rect.getBottom(), rect.getRight(), rect.getTop()};
transform.transform(pts, 0, pts, 0, 2);
float[] dstPts = {pts[0], pts[1], pts[2], pts[3]};
rect = new Rectangle(dstPts[0], dstPts[1], dstPts[2], dstPts[3]);
PdfAnnotation annot = PdfAnnotation.createLink(writer, rect, PdfAnnotation.HIGHLIGHT_INVERT, new PdfAction(text));
annot.setBorder(new PdfBorderArray(0, 0, 0));
stamper.addAnnotation(annot, 1);
}
}
如您所见，我添加了一行来删除边框（边框默认存在，除非您重新定义 PdfBorderArray）。
其余代码也几乎相同。我们现在定义一个角度 Math.PI / 2（90 度）。
public void manipulatePdf(String src, String dest) throws IOException, DocumentException {
PdfReader reader = new PdfReader(src);
PdfStamper stamper = new PdfStamper(reader, new FileOutputStream(dest));
AffineTransform transform = AffineTransform.getRotateInstance(Math.PI / 2);
stamper.getWriter().setPageEvent(new AddAnnotation(stamper, transform));
PdfContentByte canvas = stamper.getOverContent(1);
Font bold = new Font(FontFamily.HELVETICA, 12, Font.BOLD);
Chunk chunk = new Chunk("The Best iText Questions on Whosebug", bold);
chunk.setGenericTag("http://pages.itextpdf.com/ebook-Whosebug-questions.html");
Phrase p = new Phrase("Download ");
p.add(chunk);
p.add(" and discover more than 200 questions and answers.");
canvas.saveState();
canvas.concatCTM(transform);
ColumnText ct = new ColumnText(canvas);
ct.setSimpleColumn(36, -559, 806, -36);
ct.addText(p);
ct.go();
canvas.restoreState();
stamper.close();
reader.close();
}
请注意，页面的左下角是轴心点，因此我们需要调整添加列的坐标，否则您将旋转页面可见区域之外的所有内容。
更新二：
在另一条评论中，您询问了在旋转坐标系中添加文本时需要使用的坐标。
我画了这张图：
在顶部，您在页面中间添加了 MIDDLE 一词，但这不是它会出现的位置：您将所有内容旋转 90 度，因此 MIDDLE 一词将旋转到 外面您的页面（进入阴影区域）。这个词会出现在 PDF 中，但您永远看不到它。
如果您查看我的代码，您会发现我使用了这些坐标：
ct.setSimpleColumn(36, -559, 806, -36);
这在可见区域之外（低于实际页面尺寸），但是当我将所有内容旋转 90 度时，它会旋转到可见区域.
如果你看我的图，你可以看到坐标为(0, 0)、(0, -595)、(842, -598)和(842, 0)的页面旋转了90度，因此与坐标为 (0, 0)、(595, 0)、(595, 842) 和 (0, 842) 的页面重合。这就是我们在高中时都学过的数学类型 ;-)
您正在 crop.getLeft(10), crop.getHeight() / 2 + crop.getBottom() 位置添加文本。如果你知道文本会旋转 90 度，你应该使用 crop.getHeight() / 2 + crop.getBottom(), -crop.getLeft().
理解原因的最好方法是画图。