The pdf2text.c example code extracts non-Unicode text from a PDF file by scanning each page for strings and text drawing commands. Since it doesn't look at the font encoding or support Unicode text, it is really only useful to extract plain ASCII text from a PDF file. And since it writes text in the order it appears in the page stream, it may not come out in the same order as appears on the page.
The pdfioStreamGetToken function is used to read individual tokens from the page streams. Tokens starting with the open parenthesis are text strings, while PDF operators are left as-is. We use some simple logic to make sure that we include spaces between text strings and add newlines for the text operators that start a new line in a text block:
pdfio_stream_t *st; // Page stream
+bool first = true; // First string on line?
+char buffer[1024]; // Token buffer
+
+// Read PDF tokens from the page stream...
+while (pdfioStreamGetToken(st, buffer, sizeof(buffer)))
+{
+ if (buffer[0] == '(')
+ {
+ // Text string using an 8-bit encoding
+ if (first)
+ first = false;
+ else if (buffer[1] != ' ')
+ putchar(' ');
+
+ fputs(buffer + 1, stdout);
+ }
+ else if (!strcmp(buffer, "Td") || !strcmp(buffer, "TD") || !strcmp(buffer, "T*") ||
+ !strcmp(buffer, "\'") || !strcmp(buffer, "\""))
+ {
+ // Text operators that advance to the next line in the block
+ putchar('\n');
+ first = true;
+ }
+}
+
+if (!first)
+ putchar('\n');
+The image2pdf.c example code creates a PDF file containing a JPEG or PNG image file and optional caption on a single page. The create_pdf_image_file function creates the PDF file, embeds a base font and the named JPEG or PNG image file, and then creates a page with the image centered on the page with any text centered below:
#include <pdfio.h>
#include <pdfio-content.h>
@@ -2000,7 +2033,7 @@ dd->y -= margin_top + lineheight;
char targetlink[129]; // Targeted link
targetlink[0] = '#';
- make_target_name(targetlink + 1, frag->text, sizeof(targetlink) - 1);
+ make_target_name(targetlink + 1, frag->text, s¾zeof(targetlink) - 1);
l->url = pdfioStringCreate(dd->pdf, targetlink);
}
@@ -2053,7 +2086,7 @@ dd->y -= margin_top + lineheight;
for (col = 0; col < num_cols; col ++)
{
- ddì>y = row_y;
+ dd->y = row_y;
format_block(dd, row->cells[col], deffont, SIZE_TABLE, cols[col].left,
cols[col].right, /*leader*/NULL);
diff --git a/doc/pdfio.md b/doc/pdfio.md
index aad6da6..6e75a6d 100644
--- a/doc/pdfio.md
+++ b/doc/pdfio.md
@@ -922,8 +922,56 @@ main(int argc, // I - Number of command-line arguments
```
-Create PDF File With Text and Image
------------------------------------
+Extract Text from PDF File
+--------------------------
+
+The `pdf2text.c` example code extracts non-Unicode text from a PDF file by
+scanning each page for strings and text drawing commands. Since it doesn't
+look at the font encoding or support Unicode text, it is really only useful to
+extract plain ASCII text from a PDF file. And since it writes text in the order
+it appears in the page stream, it may not come out in the same order as appears
+on the page.
+
+The [`pdfioStreamGetToken`](@@) function is used to read individual tokens from
+the page streams. Tokens starting with the open parenthesis are text strings,
+while PDF operators are left as-is. We use some simple logic to make sure that
+we include spaces between text strings and add newlines for the text operators
+that start a new line in a text block:
+
+```c
+pdfio_stream_t *st; // Page stream
+bool first = true; // First string on line?
+char buffer[1024]; // Token buffer
+
+// Read PDF tokens from the page stream...
+while (pdfioStreamGetToken(st, buffer, sizeof(buffer)))
+{
+ if (buffer[0] == '(')
+ {
+ // Text string using an 8-bit encoding
+ if (first)
+ first = false;
+ else if (buffer[1] != ' ')
+ putchar(' ');
+
+ fputs(buffer + 1, stdout);
+ }
+ else if (!strcmp(buffer, "Td") || !strcmp(buffer, "TD") || !strcmp(buffer, "T*") ||
+ !strcmp(buffer, "\'") || !strcmp(buffer, "\""))
+ {
+ // Text operators that advance to the next line in the block
+ putchar('\n');
+ first = true;
+ }
+}
+
+if (!first)
+ putchar('\n');
+```
+
+
+Create a PDF File With Text and an Image
+----------------------------------------
The `image2pdf.c` example code creates a PDF file containing a JPEG or PNG
image file and optional caption on a single page. The `create_pdf_image_file`
diff --git a/examples/pdf2text.c b/examples/pdf2text.c
index 4bad097..c1a8f40 100644
--- a/examples/pdf2text.c
+++ b/examples/pdf2text.c
@@ -57,11 +57,13 @@ main(int argc, // I - Number of command-line arguments
if ((st = pdfioPageOpenStream(obj, j, true)) == NULL)
continue;
+ // Read PDF tokens from the page stream...
first = true;
while (pdfioStreamGetToken(st, buffer, sizeof(buffer)))
{
if (buffer[0] == '(')
{
+ // Text string using an 8-bit encoding
if (first)
first = false;
else if (buffer[1] != ' ')
@@ -71,6 +73,7 @@ main(int argc, // I - Number of command-line arguments
}
else if (!strcmp(buffer, "Td") || !strcmp(buffer, "TD") || !strcmp(buffer, "T*") || !strcmp(buffer, "\'") || !strcmp(buffer, "\""))
{
+ // Text operators that advance to the next line in the block
putchar('\n');
first = true;
}