CHANGES.md

@@ -5,12 +5,7 @@ Changes in PDFio
 v1.2.0 (Month DD, YYYY)
 -----------------------
 
-- Added `pdfioFileCreateNumberObj` and `pdfioFileCreateStringObj` functions
-  (Issue #14)
 - Added `pdfioContentTextMeasure` function (Issue #17)
-- Added `pdfioContentTextNewLineShow` and `pdfioContentTextNewLineShowf`
-  functions (Issue #24)
-- Renamed `pdfioContentTextNextLine` to `pdfioContentTextNewLine`.
 - Now use autoconf to configure the PDFio sources (Issue #54)
 
 

doc/pdfio.3

@@ -1,4 +1,4 @@
-.TH pdfio 3 "pdf read/write library" "2023-12-05" "pdf read/write library"
+.TH pdfio 3 "pdf read/write library" "2023-12-04" "pdf read/write library"
 .SH NAME
 pdfio \- pdf read/write library
 .SH Introduction
@@ -1808,49 +1808,14 @@ bool  pdfioContentTextMoveTo (
     double ty
 );
 .fi
-.SS pdfioContentTextNewLine
+.SS pdfioContentTextNextLine
 Move to the next line.
 .PP
 .nf
-bool  pdfioContentTextNewLine (
+bool  pdfioContentTextNextLine (
     pdfio_stream_t *st
 );
 .fi
-.SS pdfioContentTextNewLineShow
-Move to the next line and show text.
-.PP
-.nf
-bool  pdfioContentTextNewLineShow (
-    pdfio_stream_t *st,
-    double ws,
-    double cs,
-    bool unicode,
-    const char *s
-);
-.fi
-.PP
-This function moves to the next line and then shows some text with optional
-word and character spacing in a PDF content stream. The "unicode" argument
-specifies that the current font maps to full Unicode.  The "s" argument
-specifies a UTF-8 encoded string.
-.SS pdfioContentTextNewLineShowf
-Show formatted text.
-.PP
-.nf
-bool  pdfioContentTextNewLineShowf (
-    pdfio_stream_t *st,
-    double ws,
-    double cs,
-    bool unicode,
-    const char *format,
-    ...
-);
-.fi
-.PP
-This function moves to the next line and shows some formatted text with
-optional word and character spacing in a PDF content stream. The "unicode"
-argument specifies that the current font maps to full Unicode.  The "format"
-argument specifies a UTF-8 encoded \fBprintf\fR-style format string.
 .SS pdfioContentTextShow
 Show text.
 .PP
@@ -2325,18 +2290,6 @@ Note: Currently PNG support is limited to grayscale, RGB, or indexed files
 without interlacing or alpha.  Transparency (masking) based on color/index
 .IP 5
 is supported.
-.SS pdfioFileCreateNumberObj
-Create a new object in a PDF file containing a number.
-.PP
-.nf
-pdfio_obj_t * pdfioFileCreateNumberObj (
-    pdfio_file_t *pdf,
-    double number
-);
-.fi
-.PP
-This function creates a new object with a number value in a PDF file.
-You must call \fIpdfioObjClose\fR to write the object to the file.
 .SS pdfioFileCreateObj
 Create a new object in a PDF file.
 .PP
@@ -2401,18 +2354,6 @@ pdfio_stream_t * pdfioFileCreatePage (
     pdfio_dict_t *dict
 );
 .fi
-.SS pdfioFileCreateStringObj
-Create a new object in a PDF file containing a string.
-.PP
-.nf
-pdfio_obj_t * pdfioFileCreateStringObj (
-    pdfio_file_t *pdf,
-    const char *string
-);
-.fi
-.PP
-This function creates a new object with a string value in a PDF file.
-You must call \fIpdfioObjClose\fR to write the object to the file.
 .SS pdfioFileCreateTemporary
 
 .PP

doc/pdfio.html

@@ -345,9 +345,7 @@ span.string {
 <li><a href="#pdfioContentTextMeasure">pdfioContentTextMeasure</a></li>
 <li><a href="#pdfioContentTextMoveLine">pdfioContentTextMoveLine</a></li>
 <li><a href="#pdfioContentTextMoveTo">pdfioContentTextMoveTo</a></li>
-<li><a href="#pdfioContentTextNewLine">pdfioContentTextNewLine</a></li>
+<li><a href="#pdfioContentTextNextLine">pdfioContentTextNextLine</a></li>
-<li><a href="#pdfioContentTextNewLineShow">pdfioContentTextNewLineShow</a></li>
-<li><a href="#pdfioContentTextNewLineShowf">pdfioContentTextNewLineShowf</a></li>
 <li><a href="#pdfioContentTextShow">pdfioContentTextShow</a></li>
 <li><a href="#pdfioContentTextShowJustified">pdfioContentTextShowJustified</a></li>
 <li><a href="#pdfioContentTextShowf">pdfioContentTextShowf</a></li>
@@ -385,11 +383,9 @@ span.string {
 <li><a href="#pdfioFileCreateICCObjFromFile">pdfioFileCreateICCObjFromFile</a></li>
 <li><a href="#pdfioFileCreateImageObjFromData">pdfioFileCreateImageObjFromData</a></li>
 <li><a href="#pdfioFileCreateImageObjFromFile">pdfioFileCreateImageObjFromFile</a></li>
-<li><a href="#pdfioFileCreateNumberObj">pdfioFileCreateNumberObj</a></li>
 <li><a href="#pdfioFileCreateObj">pdfioFileCreateObj</a></li>
 <li><a href="#pdfioFileCreateOutput">pdfioFileCreateOutput</a></li>
 <li><a href="#pdfioFileCreatePage">pdfioFileCreatePage</a></li>
-<li><a href="#pdfioFileCreateStringObj">pdfioFileCreateStringObj</a></li>
 <li><a href="#pdfioFileCreateTemporary">pdfioFileCreateTemporary</a></li>
 <li><a href="#pdfioFileFindObj">pdfioFileFindObj</a></li>
 <li><a href="#pdfioFileGetAuthor">pdfioFileGetAuthor</a></li>
@@ -2059,10 +2055,10 @@ bool pdfioContentTextMoveTo(<a href="#pdfio_stream_t">pdfio_stream_t</a> *st, do
 </tbody></table>
 <h4 class="returnvalue">Return Value</h4>
 <p class="description"><code>true</code> on success, <code>false</code> on failure</p>
-<h3 class="function"><a id="pdfioContentTextNewLine">pdfioContentTextNewLine</a></h3>
+<h3 class="function"><a id="pdfioContentTextNextLine">pdfioContentTextNextLine</a></h3>
 <p class="description">Move to the next line.</p>
 <p class="code">
-bool pdfioContentTextNewLine(<a href="#pdfio_stream_t">pdfio_stream_t</a> *st);</p>
+bool pdfioContentTextNextLine(<a href="#pdfio_stream_t">pdfio_stream_t</a> *st);</p>
 <h4 class="parameters">Parameters</h4>
 <table class="list"><tbody>
 <tr><th>st</th>
@@ -2070,56 +2066,6 @@ bool pdfioContentTextNewLine(<a href="#pdfio_stream_t">pdfio_stream_t</a> *st);<
 </tbody></table>
 <h4 class="returnvalue">Return Value</h4>
 <p class="description"><code>true</code> on success, <code>false</code> on failure</p>
-<h3 class="function"><a id="pdfioContentTextNewLineShow">pdfioContentTextNewLineShow</a></h3>
-<p class="description">Move to the next line and show text.</p>
-<p class="code">
-bool pdfioContentTextNewLineShow(<a href="#pdfio_stream_t">pdfio_stream_t</a> *st, double ws, double cs, bool unicode, const char *s);</p>
-<h4 class="parameters">Parameters</h4>
-<table class="list"><tbody>
-<tr><th>st</th>
-<td class="description">Stream</td></tr>
-<tr><th>ws</th>
-<td class="description">Word spacing or <code>0.0</code> for none</td></tr>
-<tr><th>cs</th>
-<td class="description">Character spacing or <code>0.0</code> for none</td></tr>
-<tr><th>unicode</th>
-<td class="description">Unicode text?</td></tr>
-<tr><th>s</th>
-<td class="description">String to show</td></tr>
-</tbody></table>
-<h4 class="returnvalue">Return Value</h4>
-<p class="description"><code>true</code> on success, <code>false</code> on failure</p>
-<h4 class="discussion">Discussion</h4>
-<p class="discussion">This function moves to the next line and then shows some text with optional
-word and character spacing in a PDF content stream. The &quot;unicode&quot; argument
-specifies that the current font maps to full Unicode.  The &quot;s&quot; argument
-specifies a UTF-8 encoded string.</p>
-<h3 class="function"><a id="pdfioContentTextNewLineShowf">pdfioContentTextNewLineShowf</a></h3>
-<p class="description">Show formatted text.</p>
-<p class="code">
-bool pdfioContentTextNewLineShowf(<a href="#pdfio_stream_t">pdfio_stream_t</a> *st, double ws, double cs, bool unicode, const char *format, ...);</p>
-<h4 class="parameters">Parameters</h4>
-<table class="list"><tbody>
-<tr><th>st</th>
-<td class="description">Stream</td></tr>
-<tr><th>ws</th>
-<td class="description">Word spacing or <code>0.0</code> for none</td></tr>
-<tr><th>cs</th>
-<td class="description">Character spacing or <code>0.0</code> for none</td></tr>
-<tr><th>unicode</th>
-<td class="description">Unicode text?</td></tr>
-<tr><th>format</th>
-<td class="description"><code>printf</code>-style format string</td></tr>
-<tr><th>...</th>
-<td class="description">Additional arguments as needed</td></tr>
-</tbody></table>
-<h4 class="returnvalue">Return Value</h4>
-<p class="description"><code>true</code> on success, <code>false</code> on failure</p>
-<h4 class="discussion">Discussion</h4>
-<p class="discussion">This function moves to the next line and shows some formatted text with
-optional word and character spacing in a PDF content stream. The &quot;unicode&quot;
-argument specifies that the current font maps to full Unicode.  The &quot;format&quot;
-argument specifies a UTF-8 encoded <code>printf</code>-style format string.</p>
 <h3 class="function"><a id="pdfioContentTextShow">pdfioContentTextShow</a></h3>
 <p class="description">Show text.</p>
 <p class="code">
@@ -2179,9 +2125,9 @@ bool pdfioContentTextShowf(<a href="#pdfio_stream_t">pdfio_stream_t</a> *st, boo
 </tbody></table>
 <h4 class="returnvalue">Return Value</h4>
 <p class="description">Show formatted text.</p>
-<p class="discussion">This function shows some formatted text in a PDF content stream. The
+<p class="discussion">This function shows some text in a PDF content stream. The &quot;unicode&quot; argument
-&quot;unicode&quot; argument specifies that the current font maps to full Unicode.
+specifies that the current font maps to full Unicode.  The &quot;format&quot; argument
-The &quot;format&quot; argument specifies a UTF-8 encoded <code>printf</code>-style format string.</p>
+specifies a UTF-8 encoded <code>printf</code>-style format string.</p>
 <h3 class="function"><a id="pdfioDictCopy">pdfioDictCopy</a></h3>
 <p class="description">Copy a dictionary to a PDF file.</p>
 <p class="code">
@@ -2773,22 +2719,6 @@ image on the page.<br>
 Note: Currently PNG support is limited to grayscale, RGB, or indexed files
 without interlacing or alpha.  Transparency (masking) based on color/index
 is supported.</blockquote>
-<h3 class="function"><a id="pdfioFileCreateNumberObj">pdfioFileCreateNumberObj</a></h3>
-<p class="description">Create a new object in a PDF file containing a number.</p>
-<p class="code">
-<a href="#pdfio_obj_t">pdfio_obj_t</a> *pdfioFileCreateNumberObj(<a href="#pdfio_file_t">pdfio_file_t</a> *pdf, double number);</p>
-<h4 class="parameters">Parameters</h4>
-<table class="list"><tbody>
-<tr><th>pdf</th>
-<td class="description">PDF file</td></tr>
-<tr><th>number</th>
-<td class="description">Number value</td></tr>
-</tbody></table>
-<h4 class="returnvalue">Return Value</h4>
-<p class="description">New object</p>
-<h4 class="discussion">Discussion</h4>
-<p class="discussion">This function creates a new object with a number value in a PDF file.
-You must call <a href="#pdfioObjClose"><code>pdfioObjClose</code></a> to write the object to the file.</p>
 <h3 class="function"><a id="pdfioFileCreateObj">pdfioFileCreateObj</a></h3>
 <p class="description">Create a new object in a PDF file.</p>
 <p class="code">
@@ -2867,22 +2797,6 @@ stored as indirect object references.</blockquote>
 </tbody></table>
 <h4 class="returnvalue">Return Value</h4>
 <p class="description">Contents stream</p>
-<h3 class="function"><a id="pdfioFileCreateStringObj">pdfioFileCreateStringObj</a></h3>
-<p class="description">Create a new object in a PDF file containing a string.</p>
-<p class="code">
-<a href="#pdfio_obj_t">pdfio_obj_t</a> *pdfioFileCreateStringObj(<a href="#pdfio_file_t">pdfio_file_t</a> *pdf, const char *string);</p>
-<h4 class="parameters">Parameters</h4>
-<table class="list"><tbody>
-<tr><th>pdf</th>
-<td class="description">PDF file</td></tr>
-<tr><th>string</th>
-<td class="description">String</td></tr>
-</tbody></table>
-<h4 class="returnvalue">Return Value</h4>
-<p class="description">New object</p>
-<h4 class="discussion">Discussion</h4>
-<p class="discussion">This function creates a new object with a string value in a PDF file.
-You must call <a href="#pdfioObjClose"><code>pdfioObjClose</code></a> to write the object to the file.</p>
 <h3 class="function"><a id="pdfioFileCreateTemporary">pdfioFileCreateTemporary</a></h3>
 <p class="description"></p>
 <p class="code">

pdfio-content.c

@@ -1187,97 +1187,17 @@ pdfioContentTextMoveTo(
 
 
 //
-// 'pdfioContentTextNewLine()' - Move to the next line.
+// 'pdfioContentTextNextLine()' - Move to the next line.
 //
 
 bool					// O - `true` on success, `false` on failure
-pdfioContentTextNewLine(
+pdfioContentTextNextLine(
     pdfio_stream_t *st)			// I - Stream
 {
   return (pdfioStreamPuts(st, "T*\n"));
 }
 
 
-//
-// 'pdfioContentTextNewLineShow()' - Move to the next line and show text.
-//
-// This function moves to the next line and then shows some text with optional
-// word and character spacing in a PDF content stream. The "unicode" argument
-// specifies that the current font maps to full Unicode.  The "s" argument
-// specifies a UTF-8 encoded string.
-//
-
-bool					// O - `true` on success, `false` on failure
-pdfioContentTextNewLineShow(
-    pdfio_stream_t *st,			// I - Stream
-    double         ws,			// I - Word spacing or `0.0` for none
-    double         cs,			// I - Character spacing or `0.0` for none
-    bool           unicode,		// I - Unicode text?
-    const char     *s)			// I - String to show
-{
-  bool	newline = false;		// New line?
-  char	op;				// Text operator
-
-
-  // Write word and/or character spacing as needed...
-  if (ws > 0.0 || cs > 0.0)
-  {
-    // Use " operator to show text with word and character spacing...
-    if (!pdfioStreamPrintf(st, "%g %g", ws, cs))
-      return (false);
-
-    op = '\"';
-  }
-  else
-  {
-    // Use ' operator to show text with the defaults...
-    op = '\'';
-  }
-
-  // Write the string...
-  if (!write_string(st, unicode, s, &newline))
-    return (false);
-
-  // Draw it...
-  if (newline)
-    return (pdfioStreamPrintf(st, "%c T*\n", op));
-  else
-    return (pdfioStreamPrintf(st, "%c\n", op));
-}
-
-
-//
-// 'pdfioContentTextNewLineShowf()' - Show formatted text.
-//
-// This function moves to the next line and shows some formatted text with
-// optional word and character spacing in a PDF content stream. The "unicode"
-// argument specifies that the current font maps to full Unicode.  The "format"
-// argument specifies a UTF-8 encoded `printf`-style format string.
-//
-
-bool					// O - `true` on success, `false` on failure
-pdfioContentTextNewLineShowf(
-    pdfio_stream_t *st,			// I - Stream
-    double         ws,			// I - Word spacing or `0.0` for none
-    double         cs,			// I - Character spacing or `0.0` for none
-    bool           unicode,		// I - Unicode text?
-    const char     *format,		// I - `printf`-style format string
-    ...)				// I - Additional arguments as needed
-{
-  char		buffer[8192];		// Text buffer
-  va_list	ap;			// Argument pointer
-
-
-  // Format the string...
-  va_start(ap, format);
-  vsnprintf(buffer, sizeof(buffer), format, ap);
-  va_end(ap);
-
-  // Show it...
-  return (pdfioContentTextNewLineShow(st, ws, cs, unicode, buffer));
-}
-
-
 //
 // 'pdfioContentTextShow()' - Show text.
 //
@@ -1310,9 +1230,9 @@ pdfioContentTextShow(
 //
 // 'pdfioContentTextShowf()' - Show formatted text.
 //
-// This function shows some formatted text in a PDF content stream. The
+// This function shows some text in a PDF content stream. The "unicode" argument
-// "unicode" argument specifies that the current font maps to full Unicode.
+// specifies that the current font maps to full Unicode.  The "format" argument
-// The "format" argument specifies a UTF-8 encoded `printf`-style format string.
+// specifies a UTF-8 encoded `printf`-style format string.
 //
 
 bool

pdfio-content.h

@@ -118,9 +118,7 @@ extern bool		pdfioContentTextEnd(pdfio_stream_t *st) _PDFIO_PUBLIC;
 extern double		pdfioContentTextMeasure(pdfio_obj_t *font, const char *s, double size) _PDFIO_PUBLIC;
 extern bool		pdfioContentTextMoveLine(pdfio_stream_t *st, double tx, double ty) _PDFIO_PUBLIC;
 extern bool		pdfioContentTextMoveTo(pdfio_stream_t *st, double tx, double ty) _PDFIO_PUBLIC;
-extern bool		pdfioContentTextNewLine(pdfio_stream_t *st) _PDFIO_PUBLIC;
+extern bool		pdfioContentTextNextLine(pdfio_stream_t *st) _PDFIO_PUBLIC;
-extern bool		pdfioContentTextNewLineShow(pdfio_stream_t *st, double ws, double cs, bool unicode, const char *s) _PDFIO_PUBLIC;
-extern bool		pdfioContentTextNewLineShowf(pdfio_stream_t *st, double ws, double cs, bool unicode, const char *format, ...) _PDFIO_PUBLIC _PDFIO_FORMAT(5,6);
 extern bool		pdfioContentTextShow(pdfio_stream_t *st, bool unicode, const char *s) _PDFIO_PUBLIC;
 extern bool		pdfioContentTextShowf(pdfio_stream_t *st, bool unicode, const char *format, ...) _PDFIO_PUBLIC _PDFIO_FORMAT(3,4);
 extern bool		pdfioContentTextShowJustified(pdfio_stream_t *st, bool unicode, size_t num_fragments, const double *offsets, const char * const *fragments) _PDFIO_PUBLIC;

pdfio-file.c

@@ -334,32 +334,6 @@ pdfioFileCreateArrayObj(
 }
 
 
-//
-// 'pdfioFileCreateNumberObj()' - Create a new object in a PDF file containing a number.
-//
-// This function creates a new object with a number value in a PDF file.
-// You must call @link pdfioObjClose@ to write the object to the file.
-//
-
-pdfio_obj_t *				// O - New object
-pdfioFileCreateNumberObj(
-    pdfio_file_t *pdf,			// I - PDF file
-    double       number)		// I - Number value
-{
-  _pdfio_value_t	value;		// Object value
-
-
-  // Range check input...
-  if (!pdf)
-    return (NULL);
-
-  value.type         = PDFIO_VALTYPE_NUMBER;
-  value.value.number = number;
-
-  return (_pdfioFileCreateObj(pdf, NULL, &value));
-}
-
-
 //
 // 'pdfioFileCreateObj()' - Create a new object in a PDF file.
 //
@@ -665,32 +639,6 @@ pdfioFileCreatePage(pdfio_file_t *pdf,	// I - PDF file
 }
 
 
-//
-// 'pdfioFileCreateStringObj()' - Create a new object in a PDF file containing a string.
-//
-// This function creates a new object with a string value in a PDF file.
-// You must call @link pdfioObjClose@ to write the object to the file.
-//
-
-pdfio_obj_t *				// O - New object
-pdfioFileCreateStringObj(
-    pdfio_file_t *pdf,			// I - PDF file
-    const char   *string)		// I - String
-{
-  _pdfio_value_t	value;		// Object value
-
-
-  // Range check input...
-  if (!pdf)
-    return (NULL);
-
-  value.type         = PDFIO_VALTYPE_STRING;
-  value.value.string = string;
-
-  return (_pdfioFileCreateObj(pdf, NULL, &value));
-}
-
-
 //
 // 'pdfioFileCreateTemporary()' - Create a temporary PDF file.
 //

pdfio.h

@@ -180,12 +180,10 @@ extern bool		pdfioDictSetStringf(pdfio_dict_t *dict, const char *key, const char
 extern bool		pdfioFileClose(pdfio_file_t *pdf) _PDFIO_PUBLIC;
 extern pdfio_file_t	*pdfioFileCreate(const char *filename, const char *version, pdfio_rect_t *media_box, pdfio_rect_t *crop_box, pdfio_error_cb_t error_cb, void *error_data) _PDFIO_PUBLIC;
 extern pdfio_obj_t	*pdfioFileCreateArrayObj(pdfio_file_t *pdf, pdfio_array_t *array) _PDFIO_PUBLIC;
-extern pdfio_obj_t	*pdfioFileCreateNumberObj(pdfio_file_t *pdf, double number) _PDFIO_PUBLIC;
 extern pdfio_obj_t	*pdfioFileCreateObj(pdfio_file_t *pdf, pdfio_dict_t *dict) _PDFIO_PUBLIC;
 extern pdfio_file_t	*pdfioFileCreateOutput(pdfio_output_cb_t output_cb, void *output_ctx, const char *version, pdfio_rect_t *media_box, pdfio_rect_t *crop_box, pdfio_error_cb_t error_cb, void *error_data) _PDFIO_PUBLIC;
 // TODO: Add number, array, string, etc. versions of pdfioFileCreateObject?
 extern pdfio_stream_t	*pdfioFileCreatePage(pdfio_file_t *pdf, pdfio_dict_t *dict) _PDFIO_PUBLIC;
-extern pdfio_obj_t	*pdfioFileCreateStringObj(pdfio_file_t *pdf, const char *s) _PDFIO_PUBLIC;
 extern pdfio_file_t	*pdfioFileCreateTemporary(char *buffer, size_t bufsize, const char *version, pdfio_rect_t *media_box, pdfio_rect_t *crop_box, pdfio_error_cb_t error_cb, void *error_data) _PDFIO_PUBLIC;
 extern pdfio_obj_t	*pdfioFileFindObj(pdfio_file_t *pdf, size_t number) _PDFIO_PUBLIC;
 extern const char	*pdfioFileGetAuthor(pdfio_file_t *pdf) _PDFIO_PUBLIC;

pdfio1.def

@@ -141,9 +141,7 @@ pdfioContentTextEnd
 pdfioContentTextMeasure
 pdfioContentTextMoveLine
 pdfioContentTextMoveTo
-pdfioContentTextNewLine
+pdfioContentTextNextLine
-pdfioContentTextNewLineShow
-pdfioContentTextNewLineShowf
 pdfioContentTextShow
 pdfioContentTextShowJustified
 pdfioContentTextShowf
@@ -181,11 +179,9 @@ pdfioFileCreateFontObjFromFile
 pdfioFileCreateICCObjFromFile
 pdfioFileCreateImageObjFromData
 pdfioFileCreateImageObjFromFile
-pdfioFileCreateNumberObj
 pdfioFileCreateObj
 pdfioFileCreateOutput
 pdfioFileCreatePage
-pdfioFileCreateStringObj
 pdfioFileCreateTemporary
 pdfioFileFindObj
 pdfioFileGetAuthor