From d03e5ee5d96832f809c61e50ab88b75cbdf7324a Mon Sep 17 00:00:00 2001 From: Michael R Sweet Date: Wed, 4 Feb 2026 16:28:11 -0500 Subject: [PATCH] Update API version number references for consistency, mention GIF and WebP since v1.7. --- doc/pdfio.3 | 8 ++++++-- doc/pdfio.html | 36 +++++++++++++++++++----------------- pdfio-content.c | 10 ++++++---- pdfio-file.c | 6 +++--- pdfio-page.c | 20 ++++++++++---------- 5 files changed, 44 insertions(+), 36 deletions(-) diff --git a/doc/pdfio.3 b/doc/pdfio.3 index a54ca61..1c562c4 100644 --- a/doc/pdfio.3 +++ b/doc/pdfio.3 @@ -1,4 +1,4 @@ -.TH pdfio 3 "pdf read/write library" "2026-01-29" "pdf read/write library" +.TH pdfio 3 "pdf read/write library" "2026-02-04" "pdf read/write library" .SH NAME pdfio \- pdf read/write library .SH Introduction @@ -4215,7 +4215,11 @@ Note: PNG files containing transparency cannot be used when producing .IP 5 PDF/A files. Files containing animation yield the final frame of the .IP 5 -animation. +animation. GIF and (optional) WebP support first appeared in PDFio v1.7. +.IP 5 +WebP content is added as a Flate-compressed image with alpha mask as +.IP 5 +needed and is usually significantly larger than the original image. .SS pdfioFileCreateNameObj Create a new object in a PDF file containing a name. .PP diff --git a/doc/pdfio.html b/doc/pdfio.html index 7aa7f77..5058bfb 100644 --- a/doc/pdfio.html +++ b/doc/pdfio.html @@ -2835,7 +2835,7 @@ size_t pdfioArrayGetSize(pdfio_array_t *a);

Return Value

true on success, false otherwise

-

 PDFio 1.6 pdfioContentBeginMarked

+

 PDFio v1.6 pdfioContentBeginMarked

Start marked content with an optional dictionary.

bool pdfioContentBeginMarked(pdfio_stream_t *st, const char *tag, pdfio_dict_t *dict);

@@ -2901,7 +2901,7 @@ the document catalog. The caller is responsible for setting the

Discussion

The object name must be part of the page dictionary resources, typically using the pdfioPageDictAddImage function.

-

 PDFio 1.6 pdfioContentEndMarked

+

 PDFio v1.6 pdfioContentEndMarked

End marked content.

bool pdfioContentEndMarked(pdfio_stream_t *st);

@@ -4160,7 +4160,7 @@ have been iterated.

Return Value

true on success, false on failure

-

 PDFio 1.6 pdfioFileAddOutputIntent

+

 PDFio v1.6 pdfioFileAddOutputIntent

Add an OutputIntent to a file.

void pdfioFileAddOutputIntent(pdfio_file_t *pdf, const char *subtype, const char *condition, const char *cond_id, const char *reg_name, const char *info, pdfio_obj_t *profile);

@@ -4497,7 +4497,9 @@ interpolate when scaling the image on the page.

Note: PNG files containing transparency cannot be used when producing PDF/A files. Files containing animation yield the final frame of the -animation.
+animation. GIF and (optional) WebP support first appeared in PDFio v1.7. +WebP content is added as a Flate-compressed image with alpha mask as +needed and is usually significantly larger than the original image.

 PDFio v1.4 pdfioFileCreateNameObj

Create a new object in a PDF file containing a name.

@@ -4760,7 +4762,7 @@ list of objects while this function takes the object number.

Return Value

Author or NULL for none

-

 PDFio 1.3 pdfioFileGetCatalog

+

 PDFio v1.3 pdfioFileGetCatalog

Get the document catalog dictionary.

pdfio_dict_t *pdfioFileGetCatalog(pdfio_file_t *pdf);

@@ -4815,7 +4817,7 @@ time_t pdfioFileGetCreationDate(pdfio_file_t *pdf);<

Return Value

Keywords string or NULL for none

-

 PDFio 1.6 pdfioFileGetLanguage

+

 PDFio v1.6 pdfioFileGetLanguage

Get the language metadata for a PDF file.

const char *pdfioFileGetLanguage(pdfio_file_t *pdf);

@@ -5060,7 +5062,7 @@ ignore the return value of the error callback. value Value -

 PDFio 1.6 pdfioFileSetLanguage

+

 PDFio v1.6 pdfioFileSetLanguage

Set the language metadata for a PDF file.

void pdfioFileSetLanguage(pdfio_file_t *pdf, const char *value);

@@ -5425,7 +5427,7 @@ array that was created using the

Return Value

true on success, false on failure

-

 PDFio 1.7 pdfioPageGetArray

+

 PDFio v1.7 pdfioPageGetArray

Get an array value from the page dictionary.

pdfio_array_t *pdfioPageGetArray(pdfio_obj_t *page, const char *key);

@@ -5443,7 +5445,7 @@ array that was created using the specified object or one of its parents.

-

 PDFio 1.7 pdfioPageGetBinary

+

 PDFio v1.7 pdfioPageGetBinary

Get a binary value from the page dictionary.

unsigned char *pdfioPageGetBinary(pdfio_obj_t *page, const char *key, size_t *length);

@@ -5463,7 +5465,7 @@ specified object or one of its parents. specified object or one of its parents.

-

 PDFio 1.7 pdfioPageGetBoolean

+

 PDFio v1.7 pdfioPageGetBoolean

Get a boolean value from the page dictionary.

bool pdfioPageGetBoolean(pdfio_obj_t *page, const char *key);

@@ -5481,7 +5483,7 @@ specified object or one of its parents. specified object or one of its parents.

-

 PDFio 1.7 pdfioPageGetDate

+

 PDFio v1.7 pdfioPageGetDate

Get a date value from the page dictionary.

time_t pdfioPageGetDate(pdfio_obj_t *page, const char *key);

@@ -5499,7 +5501,7 @@ time_t pdfioPageGetDate(pdfio_obj_t *page, -

 PDFio 1.7 pdfioPageGetDict

+

 PDFio v1.7 pdfioPageGetDict

Get a dictionary value from the page dictionary.

pdfio_dict_t *pdfioPageGetDict(pdfio_obj_t *page, const char *key);

@@ -5517,7 +5519,7 @@ specified object or one of its parents. the specified object or one of its parents.

-

 PDFio 1.7 pdfioPageGetName

+

 PDFio v1.7 pdfioPageGetName

Get a name value from the page dictionary.

const char *pdfioPageGetName(pdfio_obj_t *page, const char *key);

@@ -5546,7 +5548,7 @@ size_t pdfioPageGetNumStreams(pdfio_obj_t *page);

Return Value

Number of streams

-

 PDFio 1.7 pdfioPageGetNumber

+

 PDFio v1.7 pdfioPageGetNumber

Get a number value from the page dictionary.

double pdfioPageGetNumber(pdfio_obj_t *page, const char *key);

@@ -5564,7 +5566,7 @@ size_t pdfioPageGetNumStreams(pdfio_obj_t *page);

specified object or one of its parents.

-

 PDFio 1.7 pdfioPageGetObj

+

 PDFio v1.7 pdfioPageGetObj

Get an indirect object value from the page dictionary.

pdfio_obj_t *pdfioPageGetObj(pdfio_obj_t *page, const char *key);

@@ -5582,7 +5584,7 @@ specified object or one of its parents. either in the specified object or one of its parents.

-

 PDFio 1.7 pdfioPageGetRect

+

 PDFio v1.7 pdfioPageGetRect

Get a rectangle value from the page dictionary.

pdfio_rect_t *pdfioPageGetRect(pdfio_obj_t *page, const char *key, pdfio_rect_t *rect);

@@ -5602,7 +5604,7 @@ either in the specified object or one of its parents. the specified object or one of its parents.

-

 PDFio 1.7 pdfioPageGetString

+

 PDFio v1.7 pdfioPageGetString

Get a string value from the page dictionary.

const char *pdfioPageGetString(pdfio_obj_t *page, const char *key);

diff --git a/pdfio-content.c b/pdfio-content.c index 1e5138e..b36b486 100644 --- a/pdfio-content.c +++ b/pdfio-content.c @@ -497,7 +497,7 @@ pdfioArrayCreateColorFromStandard( // the document catalog. The caller is responsible for setting the // "StructTreeRoot" dictionary when creating marked content. // -// @since PDFio 1.6@ +// @since PDFio v1.6@ // bool // O - `true` on success, `false` on failure @@ -580,7 +580,7 @@ pdfioContentDrawImage( // This function ends an area of marked content that was started using the // @link pdfioContentBeginMarked@ function. // -// @since PDFio 1.6@ +// @since PDFio v1.6@ // bool // O - `true` on success, `false` on failure @@ -1619,7 +1619,7 @@ pdfioContentTextShowJustified( // condition. If `NULL`, the PDF consumer will attempt to look up the correct // profile using the "cond_id" value. // -// @since PDFio 1.6@ +// @since PDFio v1.6@ // void @@ -2155,7 +2155,9 @@ pdfioFileCreateImageObjFromData( // // > Note: PNG files containing transparency cannot be used when producing // > PDF/A files. Files containing animation yield the final frame of the -// > animation. +// > animation. GIF and (optional) WebP support first appeared in PDFio v1.7. +// > WebP content is added as a Flate-compressed image with alpha mask as +// > needed and is usually significantly larger than the original image. // pdfio_obj_t * // O - Object diff --git a/pdfio-file.c b/pdfio-file.c index 2e0b292..2d6e792 100644 --- a/pdfio-file.c +++ b/pdfio-file.c @@ -852,7 +852,7 @@ pdfioFileGetAuthor(pdfio_file_t *pdf) // I - PDF file // // 'pdfioFileGetCatalog()' - Get the document catalog dictionary. // -// @since PDFio 1.3@ +// @since PDFio v1.3@ // pdfio_dict_t * // O - Catalog dictionary @@ -915,7 +915,7 @@ pdfioFileGetKeywords(pdfio_file_t *pdf) // I - PDF file // "lang-REGION". For example, the string "en-CA" specifies Canadian English // and the string "fr-CA" specifies Canadian French. // -// @since PDFio 1.6@ +// @since PDFio v1.6@ // const char * // O - Language or `NULL` for none @@ -1318,7 +1318,7 @@ pdfioFileSetKeywords( // "lang-REGION". For example, the string "en-CA" specifies Canadian English // and the string "fr-CA" specifies Canadian French. // -// @since PDFio 1.6@ +// @since PDFio v1.6@ // void diff --git a/pdfio-page.c b/pdfio-page.c index 7469d9b..eb24770 100644 --- a/pdfio-page.c +++ b/pdfio-page.c @@ -59,7 +59,7 @@ pdfioPageCopy(pdfio_file_t *pdf, // I - PDF file // This function looks up an array value in the page dictionary, either in the // specified object or one of its parents. // -// @since PDFio 1.7@ +// @since PDFio v1.7@ // pdfio_array_t * // O - Array or `NULL` if none @@ -83,7 +83,7 @@ pdfioPageGetArray(pdfio_obj_t *page, // I - Page object // This function looks up a binary value in the page dictionary, either in the // specified object or one of its parents. // -// @since PDFio 1.7@ +// @since PDFio v1.7@ // unsigned char * // O - Pointer to binary data or `NULL` if none @@ -115,7 +115,7 @@ pdfioPageGetBinary(pdfio_obj_t *page, // I - Page object // This function looks up a boolean value in the page dictionary, either in the // specified object or one of its parents. // -// @since PDFio 1.7@ +// @since PDFio v1.7@ // bool // O - Boolean value or `false` if none @@ -139,7 +139,7 @@ pdfioPageGetBoolean(pdfio_obj_t *page, // I - Page object // This function looks up a date value in the page dictionary, either in the // specified object or one of its parents. // -// @since PDFio 1.7@ +// @since PDFio v1.7@ // time_t // O - Date/time or `0` if none @@ -163,7 +163,7 @@ pdfioPageGetDate(pdfio_obj_t *page, // I - Page object // This function looks up a dictionary value in the page dictionary, either in // the specified object or one of its parents. // -// @since PDFio 1.7@ +// @since PDFio v1.7@ // pdfio_dict_t * // O - Dictionary or `NULL` if none @@ -187,7 +187,7 @@ pdfioPageGetDict(pdfio_obj_t *page, // I - Page object // This function looks up a name value in the page dictionary, either in the // specified object or one of its parents. // -// @since PDFio 1.7@ +// @since PDFio v1.7@ // const char * // O - Name string or `NULL` if none @@ -232,7 +232,7 @@ pdfioPageGetNumStreams( // This function looks up a number value in the page dictionary, either in the // specified object or one of its parents. // -// @since PDFio 1.7@ +// @since PDFio v1.7@ // double // O - Number value or `0.0` if none @@ -256,7 +256,7 @@ pdfioPageGetNumber(pdfio_obj_t *page, // I - Page object // This function looks up an indirect object value in the page dictionary, // either in the specified object or one of its parents. // -// @since PDFio 1.7@ +// @since PDFio v1.7@ // pdfio_obj_t * // O - Object or `NULL` if none @@ -280,7 +280,7 @@ pdfioPageGetObj(pdfio_obj_t *page, // I - Page object // This function looks up a rectangle value in the page dictionary, either in // the specified object or one of its parents. // -// @since PDFio 1.7@ +// @since PDFio v1.7@ // pdfio_rect_t * // O - Rectangle or `NULL` if none @@ -314,7 +314,7 @@ pdfioPageGetRect(pdfio_obj_t *page, // I - Page object // This function looks up a string value in the page dictionary, either in the // specified object or one of its parents. // -// @since PDFio 1.7@ +// @since PDFio v1.7@ // const char * // O - String value or `NULL` if none