2021-05-30 03:21:45 +02:00
<!DOCTYPE html>
< html lang = "en-US" >
< head >
2021-05-30 13:10:44 +02:00
< title > PDFio Programming Manual v0.1< / title >
2021-05-30 03:21:45 +02:00
< meta http-equiv = "Content-Type" content = "text/html;charset=utf-8" >
< meta name = "generator" content = "codedoc v3.7" >
< meta name = "author" content = "Michael R Sweet" >
< meta name = "language" content = "en-US" >
< meta name = "copyright" content = "Copyright © 2021 by Michael R Sweet" >
2021-05-30 03:27:49 +02:00
< meta name = "version" content = "0.1" >
2021-05-30 03:21:45 +02:00
< style type = "text/css" > < ! - -
body {
background: white;
color: black;
font-family: sans-serif;
font-size: 12pt;
}
a {
color: black;
}
a:link, a:visited {
color: #00f;
}
a:link:hover, a:visited:hover, a:active {
color: #c0c;
}
body, p, h1, h2, h3, h4, h5, h6 {
font-family: sans-serif;
line-height: 1.4;
}
h1, h2, h3, h4, h5, h6 {
font-weight: bold;
page-break-inside: avoid;
}
h1 {
font-size: 250%;
margin: 0;
}
h2 {
font-size: 250%;
margin-top: 1.5em;
}
h3 {
font-size: 200%;
margin-bottom: 0.5em;
margin-top: 1.5em;
}
h4 {
font-size: 150%;
margin-bottom: 0.5em;
margin-top: 1.5em;
}
h5 {
font-size: 125%;
margin-bottom: 0.5em;
margin-top: 1.5em;
}
h6 {
font-size: 110%;
margin-bottom: 0.5em;
margin-top: 1.5em;
}
img.title {
width: 256px;
}
div.header h1, div.header p {
text-align: center;
}
div.contents, div.body, div.footer {
page-break-before: always;
}
.class, .enumeration, .function, .struct, .typedef, .union {
border-bottom: solid 2px gray;
}
.description {
margin-top: 0.5em;
}
.function {
margin-bottom: 0;
}
blockquote {
border: solid thin gray;
box-shadow: 3px 3px 5px rgba(127,127,127,0.25);
margin: 1em 0;
padding: 10px;
page-break-inside: avoid;
}
p code, li code, p.code, pre, ul.code li {
font-family: monospace;
hyphens: manual;
-webkit-hyphens: manual;
}
p.code, pre, ul.code li {
background: rgba(127,127,127,0.25);
border: thin dotted gray;
padding: 10px;
page-break-inside: avoid;
}
pre {
white-space: pre-wrap;
}
a:link, a:visited {
text-decoration: none;
}
span.info {
background: black;
border: solid thin black;
color: white;
font-size: 80%;
font-style: italic;
font-weight: bold;
white-space: nowrap;
}
h1 span.info, h2 span.info, h3 span.info, h4 span.info {
border-top-left-radius: 10px;
border-top-right-radius: 10px;
float: right;
padding: 3px 6px;
}
ul.code, ul.contents, ul.subcontents {
list-style-type: none;
margin: 0;
padding-left: 0;
}
ul.code li {
margin: 0;
}
ul.contents > li {
margin-top: 1em;
}
ul.contents li ul.code, ul.contents li ul.subcontents {
padding-left: 2em;
}
table {
border-collapse: collapse;
border-spacing: 0;
}
td {
border: solid 1px gray;
padding: 5px 10px;
vertical-align: top;
}
td.left {
text-align: left;
}
td.center {
text-align: center;
}
td.right {
text-align: right;
}
th {
border-bottom: solid 2px gray;
padding: 1px 5px;
text-align: center;
vertical-align: bottom;
}
tr:nth-child(even) {
background: rgba(127,127,127,0.25);
}
table.list {
border-collapse: collapse;
width: 100%;
}
table.list th {
border-bottom: none;
border-right: 2px solid gray;
font-family: monospace;
font-weight: normal;
padding: 5px 10px 5px 2px;
text-align: right;
vertical-align: top;
}
table.list td {
border: none;
padding: 5px 2px 5px 10px;
text-align: left;
vertical-align: top;
}
h2.title, h3.title {
border-bottom: solid 2px gray;
}
/* Syntax highlighting */
span.comment {
color: darkgreen;
}
span.directive {
color: purple;
}
span.number {
color: brown;
}
span.reserved {
color: darkcyan;
}
span.string {
color: magenta;
}
/* Dark mode overrides */
@media (prefers-color-scheme: dark) {
body {
background: black;
color: #ccc;
}
a {
color: #ccc;
}
a:link, a:visited {
color: #66f;
}
a:link:hover, a:visited:hover, a:active {
color: #f06;
}
}
/* Show contents on left side in web browser */
@media screen and (min-width: 800px) {
div.contents {
border-right: solid thin gray;
bottom: 0px;
box-shadow: 3px 3px 5px rgba(127,127,127,0.5);
font-size: 10pt;
left: 0px;
overflow: scroll;
padding: 1%;
position: fixed;
top: 0px;
width: 18%;
}
div.contents h2.title {
margin-top: 0px;
}
div.header, div.body, div.footer {
margin-left: 20%;
padding: 1% 2%;
}
}
/* Center title page content vertically */
@media print {
div.header {
padding-top: 33%;
}
}
-->< / style >
< / head >
< body >
< div class = "header" >
2021-05-30 13:10:44 +02:00
< p > < img class = "title" src = "pdfio-512.png" > < / p >
< h1 class = "title" > PDFio Programming Manual v0.1< / h1 >
2021-05-30 03:21:45 +02:00
< p > Michael R Sweet< / p >
< p > Copyright © 2021 by Michael R Sweet< / p >
< / div >
< div class = "contents" >
< h2 class = "title" > Contents< / h2 >
< ul class = "contents" >
2021-06-07 14:34:30 +02:00
< li > < a href = "#introduction" > Introduction< / a > < ul class = "subcontents" >
< li > < a href = "#requirements" > Requirements< / a > < / li >
< li > < a href = "#installing-pdfio" > Installing pdfio< / a > < / li >
< li > < a href = "#visual-studio-project" > Visual Studio Project< / a > < / li >
< li > < a href = "#xcode-project" > Xcode Project< / a > < / li >
< li > < a href = "#detecting-pdfio" > Detecting PDFio< / a > < / li >
< li > < a href = "#header-files" > Header Files< / a > < / li >
< / ul > < / li >
< li > < a href = "#api-overview" > API Overview< / a > < ul class = "subcontents" >
< li > < a href = "#pdf-files" > PDF Files< / a > < / li >
< li > < a href = "#pdf-values" > PDF Values< / a > < / li >
< li > < a href = "#pdf-objects" > PDF Objects< / a > < / li >
< li > < a href = "#pdf-streams" > PDF Streams< / a > < / li >
< / ul > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#FUNCTIONS" > Functions< / a > < ul class = "subcontents" >
< li > < a href = "#pdfioArrayAppendArray" > pdfioArrayAppendArray< / a > < / li >
< li > < a href = "#pdfioArrayAppendBinary" > pdfioArrayAppendBinary< / a > < / li >
< li > < a href = "#pdfioArrayAppendBoolean" > pdfioArrayAppendBoolean< / a > < / li >
< li > < a href = "#pdfioArrayAppendDict" > pdfioArrayAppendDict< / a > < / li >
< li > < a href = "#pdfioArrayAppendName" > pdfioArrayAppendName< / a > < / li >
< li > < a href = "#pdfioArrayAppendNumber" > pdfioArrayAppendNumber< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioArrayAppendObj" > pdfioArrayAppendObj< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioArrayAppendString" > pdfioArrayAppendString< / a > < / li >
< li > < a href = "#pdfioArrayCopy" > pdfioArrayCopy< / a > < / li >
< li > < a href = "#pdfioArrayCreate" > pdfioArrayCreate< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioArrayCreateCalibratedColorFromMatrix" > pdfioArrayCreateCalibratedColorFromMatrix< / a > < / li >
< li > < a href = "#pdfioArrayCreateCalibratedColorFromPrimaries" > pdfioArrayCreateCalibratedColorFromPrimaries< / a > < / li >
< li > < a href = "#pdfioArrayCreateICCBasedColor" > pdfioArrayCreateICCBasedColor< / a > < / li >
< li > < a href = "#pdfioArrayCreateIndexedColor" > pdfioArrayCreateIndexedColor< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioArrayGetArray" > pdfioArrayGetArray< / a > < / li >
< li > < a href = "#pdfioArrayGetBinary" > pdfioArrayGetBinary< / a > < / li >
< li > < a href = "#pdfioArrayGetBoolean" > pdfioArrayGetBoolean< / a > < / li >
< li > < a href = "#pdfioArrayGetDict" > pdfioArrayGetDict< / a > < / li >
< li > < a href = "#pdfioArrayGetName" > pdfioArrayGetName< / a > < / li >
< li > < a href = "#pdfioArrayGetNumber" > pdfioArrayGetNumber< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioArrayGetObj" > pdfioArrayGetObj< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioArrayGetSize" > pdfioArrayGetSize< / a > < / li >
< li > < a href = "#pdfioArrayGetString" > pdfioArrayGetString< / a > < / li >
< li > < a href = "#pdfioArrayGetType" > pdfioArrayGetType< / a > < / li >
< li > < a href = "#pdfioContentClip" > pdfioContentClip< / a > < / li >
< li > < a href = "#pdfioContentDrawImage" > pdfioContentDrawImage< / a > < / li >
< li > < a href = "#pdfioContentFill" > pdfioContentFill< / a > < / li >
< li > < a href = "#pdfioContentFillAndStroke" > pdfioContentFillAndStroke< / a > < / li >
< li > < a href = "#pdfioContentMatrixConcat" > pdfioContentMatrixConcat< / a > < / li >
< li > < a href = "#pdfioContentMatrixRotate" > pdfioContentMatrixRotate< / a > < / li >
< li > < a href = "#pdfioContentMatrixScale" > pdfioContentMatrixScale< / a > < / li >
< li > < a href = "#pdfioContentMatrixTranslate" > pdfioContentMatrixTranslate< / a > < / li >
< li > < a href = "#pdfioContentPathClose" > pdfioContentPathClose< / a > < / li >
< li > < a href = "#pdfioContentPathCurve" > pdfioContentPathCurve< / a > < / li >
< li > < a href = "#pdfioContentPathCurve13" > pdfioContentPathCurve13< / a > < / li >
< li > < a href = "#pdfioContentPathCurve23" > pdfioContentPathCurve23< / a > < / li >
< li > < a href = "#pdfioContentPathLineTo" > pdfioContentPathLineTo< / a > < / li >
< li > < a href = "#pdfioContentPathMoveTo" > pdfioContentPathMoveTo< / a > < / li >
< li > < a href = "#pdfioContentPathRect" > pdfioContentPathRect< / a > < / li >
< li > < a href = "#pdfioContentRestore" > pdfioContentRestore< / a > < / li >
< li > < a href = "#pdfioContentSave" > pdfioContentSave< / a > < / li >
< li > < a href = "#pdfioContentSetDashPattern" > pdfioContentSetDashPattern< / a > < / li >
< li > < a href = "#pdfioContentSetFillColorDeviceCMYK" > pdfioContentSetFillColorDeviceCMYK< / a > < / li >
< li > < a href = "#pdfioContentSetFillColorDeviceGray" > pdfioContentSetFillColorDeviceGray< / a > < / li >
< li > < a href = "#pdfioContentSetFillColorDeviceRGB" > pdfioContentSetFillColorDeviceRGB< / a > < / li >
< li > < a href = "#pdfioContentSetFillColorGray" > pdfioContentSetFillColorGray< / a > < / li >
< li > < a href = "#pdfioContentSetFillColorRGB" > pdfioContentSetFillColorRGB< / a > < / li >
< li > < a href = "#pdfioContentSetFillColorSpace" > pdfioContentSetFillColorSpace< / a > < / li >
< li > < a href = "#pdfioContentSetFlatness" > pdfioContentSetFlatness< / a > < / li >
< li > < a href = "#pdfioContentSetLineCap" > pdfioContentSetLineCap< / a > < / li >
< li > < a href = "#pdfioContentSetLineJoin" > pdfioContentSetLineJoin< / a > < / li >
< li > < a href = "#pdfioContentSetLineWidth" > pdfioContentSetLineWidth< / a > < / li >
< li > < a href = "#pdfioContentSetMiterLimit" > pdfioContentSetMiterLimit< / a > < / li >
< li > < a href = "#pdfioContentSetStrokeColorDeviceCMYK" > pdfioContentSetStrokeColorDeviceCMYK< / a > < / li >
< li > < a href = "#pdfioContentSetStrokeColorDeviceGray" > pdfioContentSetStrokeColorDeviceGray< / a > < / li >
< li > < a href = "#pdfioContentSetStrokeColorDeviceRGB" > pdfioContentSetStrokeColorDeviceRGB< / a > < / li >
< li > < a href = "#pdfioContentSetStrokeColorGray" > pdfioContentSetStrokeColorGray< / a > < / li >
< li > < a href = "#pdfioContentSetStrokeColorRGB" > pdfioContentSetStrokeColorRGB< / a > < / li >
< li > < a href = "#pdfioContentSetStrokeColorSpace" > pdfioContentSetStrokeColorSpace< / a > < / li >
< li > < a href = "#pdfioContentSetTextCharacterSpacing" > pdfioContentSetTextCharacterSpacing< / a > < / li >
< li > < a href = "#pdfioContentSetTextFont" > pdfioContentSetTextFont< / a > < / li >
< li > < a href = "#pdfioContentSetTextLeading" > pdfioContentSetTextLeading< / a > < / li >
< li > < a href = "#pdfioContentSetTextMatrix" > pdfioContentSetTextMatrix< / a > < / li >
< li > < a href = "#pdfioContentSetTextRenderingMode" > pdfioContentSetTextRenderingMode< / a > < / li >
< li > < a href = "#pdfioContentSetTextRise" > pdfioContentSetTextRise< / a > < / li >
< li > < a href = "#pdfioContentSetTextWordSpacing" > pdfioContentSetTextWordSpacing< / a > < / li >
< li > < a href = "#pdfioContentSetTextXScaling" > pdfioContentSetTextXScaling< / a > < / li >
< li > < a href = "#pdfioContentStroke" > pdfioContentStroke< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioContentTextBegin" > pdfioContentTextBegin< / a > < / li >
< li > < a href = "#pdfioContentTextEnd" > pdfioContentTextEnd< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioContentTextMoveLine" > pdfioContentTextMoveLine< / a > < / li >
< li > < a href = "#pdfioContentTextMoveTo" > pdfioContentTextMoveTo< / a > < / li >
< li > < a href = "#pdfioContentTextNextLine" > pdfioContentTextNextLine< / a > < / li >
< li > < a href = "#pdfioContentTextShow" > pdfioContentTextShow< / a > < / li >
< li > < a href = "#pdfioContentTextShowJustified" > pdfioContentTextShowJustified< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioContentTextShowf" > pdfioContentTextShowf< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioDictCopy" > pdfioDictCopy< / a > < / li >
< li > < a href = "#pdfioDictCreate" > pdfioDictCreate< / a > < / li >
< li > < a href = "#pdfioDictGetArray" > pdfioDictGetArray< / a > < / li >
< li > < a href = "#pdfioDictGetBinary" > pdfioDictGetBinary< / a > < / li >
< li > < a href = "#pdfioDictGetBoolean" > pdfioDictGetBoolean< / a > < / li >
< li > < a href = "#pdfioDictGetDict" > pdfioDictGetDict< / a > < / li >
< li > < a href = "#pdfioDictGetName" > pdfioDictGetName< / a > < / li >
< li > < a href = "#pdfioDictGetNumber" > pdfioDictGetNumber< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioDictGetObj" > pdfioDictGetObj< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioDictGetRect" > pdfioDictGetRect< / a > < / li >
< li > < a href = "#pdfioDictGetString" > pdfioDictGetString< / a > < / li >
< li > < a href = "#pdfioDictGetType" > pdfioDictGetType< / a > < / li >
< li > < a href = "#pdfioDictSetArray" > pdfioDictSetArray< / a > < / li >
< li > < a href = "#pdfioDictSetBinary" > pdfioDictSetBinary< / a > < / li >
< li > < a href = "#pdfioDictSetBoolean" > pdfioDictSetBoolean< / a > < / li >
< li > < a href = "#pdfioDictSetDict" > pdfioDictSetDict< / a > < / li >
< li > < a href = "#pdfioDictSetName" > pdfioDictSetName< / a > < / li >
< li > < a href = "#pdfioDictSetNull" > pdfioDictSetNull< / a > < / li >
< li > < a href = "#pdfioDictSetNumber" > pdfioDictSetNumber< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioDictSetObj" > pdfioDictSetObj< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioDictSetRect" > pdfioDictSetRect< / a > < / li >
< li > < a href = "#pdfioDictSetString" > pdfioDictSetString< / a > < / li >
< li > < a href = "#pdfioDictSetStringf" > pdfioDictSetStringf< / a > < / li >
< li > < a href = "#pdfioFileClose" > pdfioFileClose< / a > < / li >
< li > < a href = "#pdfioFileCreate" > pdfioFileCreate< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioFileCreateBaseFontObj" > pdfioFileCreateBaseFontObj< / a > < / li >
< li > < a href = "#pdfioFileCreateFontObj" > pdfioFileCreateFontObj< / a > < / li >
< li > < a href = "#pdfioFileCreateICCProfileObj" > pdfioFileCreateICCProfileObj< / a > < / li >
< li > < a href = "#pdfioFileCreateImageObj" > pdfioFileCreateImageObj< / a > < / li >
< li > < a href = "#pdfioFileCreateObj" > pdfioFileCreateObj< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioFileCreatePage" > pdfioFileCreatePage< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioFileFindObj" > pdfioFileFindObj< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioFileGetID" > pdfioFileGetID< / a > < / li >
< li > < a href = "#pdfioFileGetName" > pdfioFileGetName< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioFileGetNumObjs" > pdfioFileGetNumObjs< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioFileGetNumPages" > pdfioFileGetNumPages< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioFileGetObj" > pdfioFileGetObj< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioFileGetPage" > pdfioFileGetPage< / a > < / li >
< li > < a href = "#pdfioFileGetVersion" > pdfioFileGetVersion< / a > < / li >
< li > < a href = "#pdfioFileOpen" > pdfioFileOpen< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioImageGetBytesPerLine" > pdfioImageGetBytesPerLine< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioImageGetHeight" > pdfioImageGetHeight< / a > < / li >
< li > < a href = "#pdfioImageGetWidth" > pdfioImageGetWidth< / a > < / li >
< li > < a href = "#pdfioObjClose" > pdfioObjClose< / a > < / li >
< li > < a href = "#pdfioObjCopy" > pdfioObjCopy< / a > < / li >
< li > < a href = "#pdfioObjCreateStream" > pdfioObjCreateStream< / a > < / li >
< li > < a href = "#pdfioObjGetArray" > pdfioObjGetArray< / a > < / li >
< li > < a href = "#pdfioObjGetDict" > pdfioObjGetDict< / a > < / li >
< li > < a href = "#pdfioObjGetGeneration" > pdfioObjGetGeneration< / a > < / li >
< li > < a href = "#pdfioObjGetLength" > pdfioObjGetLength< / a > < / li >
< li > < a href = "#pdfioObjGetNumber" > pdfioObjGetNumber< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioObjGetSubtype" > pdfioObjGetSubtype< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioObjGetType" > pdfioObjGetType< / a > < / li >
< li > < a href = "#pdfioObjOpenStream" > pdfioObjOpenStream< / a > < / li >
< li > < a href = "#pdfioPageCopy" > pdfioPageCopy< / a > < / li >
2021-06-07 14:34:30 +02:00
< li > < a href = "#pdfioPageDictAddColorSpace" > pdfioPageDictAddColorSpace< / a > < / li >
2021-05-30 03:21:45 +02:00
< li > < a href = "#pdfioPageDictAddFont" > pdfioPageDictAddFont< / a > < / li >
< li > < a href = "#pdfioPageDictAddImage" > pdfioPageDictAddImage< / a > < / li >
< li > < a href = "#pdfioStreamClose" > pdfioStreamClose< / a > < / li >
< li > < a href = "#pdfioStreamConsume" > pdfioStreamConsume< / a > < / li >
< li > < a href = "#pdfioStreamGetToken" > pdfioStreamGetToken< / a > < / li >
< li > < a href = "#pdfioStreamPeek" > pdfioStreamPeek< / a > < / li >
< li > < a href = "#pdfioStreamPrintf" > pdfioStreamPrintf< / a > < / li >
< li > < a href = "#pdfioStreamPuts" > pdfioStreamPuts< / a > < / li >
< li > < a href = "#pdfioStreamRead" > pdfioStreamRead< / a > < / li >
< li > < a href = "#pdfioStreamWrite" > pdfioStreamWrite< / a > < / li >
< li > < a href = "#pdfioStringCreate" > pdfioStringCreate< / a > < / li >
< li > < a href = "#pdfioStringCreatef" > pdfioStringCreatef< / a > < / li >
< / ul > < / li >
< li > < a href = "#TYPES" > Data Types< / a > < ul class = "subcontents" >
< li > < a href = "#pdf_value_t" > pdf_value_t< / a > < / li >
< li > < a href = "#pdfio_array_t" > pdfio_array_t< / a > < / li >
< li > < a href = "#pdfio_dict_t" > pdfio_dict_t< / a > < / li >
< li > < a href = "#pdfio_error_cb_t" > pdfio_error_cb_t< / a > < / li >
< li > < a href = "#pdfio_file_t" > pdfio_file_t< / a > < / li >
< li > < a href = "#pdfio_filter_t" > pdfio_filter_t< / a > < / li >
< li > < a href = "#pdfio_obj_t" > pdfio_obj_t< / a > < / li >
< li > < a href = "#pdfio_rect_t" > pdfio_rect_t< / a > < / li >
< li > < a href = "#pdfio_stream_t" > pdfio_stream_t< / a > < / li >
< li > < a href = "#pdfio_valtype_t" > pdfio_valtype_t< / a > < / li >
< / ul > < / li >
< li > < a href = "#STRUCTURES" > Structures< / a > < ul class = "subcontents" >
< li > < a href = "#pdfio_rect_s" > pdfio_rect_s< / a > < / li >
< / ul > < / li >
< li > < a href = "#ENUMERATIONS" > Enumerations< / a > < ul class = "subcontents" >
< li > < a href = "#pdfio_filter_e" > pdfio_filter_e< / a > < / li >
< li > < a href = "#pdfio_valtype_e" > pdfio_valtype_e< / a > < / li >
< / ul > < / li >
< / ul >
< / div >
< div class = "body" >
< h2 class = "title" id = "introduction" > Introduction< / h2 >
2021-05-30 13:10:44 +02:00
< p > PDFio is a simple C library for reading and writing PDF files. The primary goals of pdfio are:< / p >
2021-05-30 03:21:45 +02:00
< ul >
< li > < p > Read any PDF file with or without encryption or linearization< / p >
< / li >
< li > < p > Write PDF files without encryption or linearization< / p >
< / li >
< li > < p > Extract or embed useful metadata (author, creator, page information, etc.)< / p >
< / li >
< li > < p > " Filter" PDF files, for example to extract a range of pages or to embed fonts that are missing from a PDF< / p >
< / li >
< li > < p > Provide access to objects used for each page< / p >
< / li >
< / ul >
2021-05-30 13:10:44 +02:00
< p > PDFio is < em > not< / em > concerned with rendering or viewing a PDF file, although a PDF RIP or viewer could be written using it.< / p >
2021-06-07 14:34:30 +02:00
< p > PDFio is Copyright © 2021 by Michael R Sweet and is licensed under the Apache License Version 2.0 with an (optional) exception to allow linking against GPL2/LGPL2 software. See the files " LICENSE" and " NOTICE" for more information.< / p >
< h3 class = "title" id = "requirements" > Requirements< / h3 >
< p > PDFio requires the following to build the software:< / p >
< ul >
< li > < p > A C99 compiler such as Clang, GCC, or MS Visual C< / p >
< / li >
< li > < p > A POSIX-compliant < code > make< / code > program< / p >
< / li >
< li > < p > ZLIB (< a href = "https://www.zlib.net" > https://www.zlib.net< / a > ) 1.0 or higher< / p >
< / li >
< / ul >
< p > IDE files for Xcode (macOS/iOS) and Visual Studio (Windows) are also provided.< / p >
< h3 class = "title" id = "installing-pdfio" > Installing pdfio< / h3 >
< p > PDFio comes with a portable makefile that will work on any POSIX-compliant system with ZLIB installed. To make it, run:< / p >
< pre > < code > make all
< / code > < / pre >
< p > To test it, run:< / p >
< pre > < code > make test
< / code > < / pre >
< p > To install it, run:< / p >
< pre > < code > make install
< / code > < / pre >
< p > If you want a shared library, run:< / p >
< pre > < code > make all-shared
make install-shared
< / code > < / pre >
< p > The default installation location is " /usr/local" . Pass the < code > prefix< / code > variable to make to install it to another location:< / p >
< pre > < code > make install prefix=/some/other/directory
< / code > < / pre >
< p > The makefile installs the pdfio header to " ${prefix}/include" , the library to " ${prefix}/lib" , the < code > pkg-config< / code > file to " ${prefix}/lib/pkgconfig" , the man page to " ${prefix}/share/man/man3" , and the documentation to " ${prefix}/share/doc/pdfio" .< / p >
< p > The makefile supports the following variables that can be specified in the make command or as environment variables:< / p >
< ul >
< li > < p > < code > AR< / code > : the library archiver (default " ar" )< / p >
< / li >
< li > < p > < code > ARFLAGS< / code > : options for the library archiver (default " cr" )< / p >
< / li >
< li > < p > < code > CC< / code > : the C compiler (default " cc" )< / p >
< / li >
< li > < p > < code > CFLAGS< / code > : options for the C compiler (default " " )< / p >
< / li >
< li > < p > < code > CODESIGN_IDENTITY< / code > : the identity to use when code signing the shared library on macOS (default " Developer ID" )< / p >
< / li >
< li > < p > < code > COMMONFLAGS< / code > : options for the C compiler and linker (typically architecture and optimization options, default is " -Os -g" )< / p >
< / li >
< li > < p > < code > CPPFLAGS< / code > : options for the C preprocessor (default " " )< / p >
< / li >
< li > < p > < code > DESTDIR" and " DSTROOT< / code > : specifies a root directory when installing (default is " " , specify only one)< / p >
< / li >
< li > < p > < code > DSOFLAGS< / code > : options for the C compiler when linking the shared library (default " " )< / p >
< / li >
< li > < p > < code > LDFLAGS< / code > : options for the C compiler when linking the test programs (default " " )< / p >
< / li >
< li > < p > < code > LIBS< / code > : library options when linking the test programs (default " -lz" )< / p >
< / li >
< li > < p > < code > RANLIB< / code > : program that generates a table-of-contents in a library (default " ranlib" )< / p >
< / li >
< li > < p > < code > prefix< / code > : specifies the installation directory (default " /usr/local" )< / p >
< / li >
< / ul >
< h3 class = "title" id = "visual-studio-project" > Visual Studio Project< / h3 >
< blockquote >
< p > Note: I haven't yet added this...< / p >
< / blockquote >
< p > The Visual Studio solution (" pdfio.sln" ) is provided for Windows developers generates both a static library and DLL.< / p >
< h3 class = "title" id = "xcode-project" > Xcode Project< / h3 >
< p > There is also an Xcode project (" pdfio.xcodeproj" ) you can use on macOS which generates a static library that will be installed under " /usr/local" with:< / p >
< pre > < code > sudo xcodebuild install
< / code > < / pre >
< p > You can reproduce this with the makefile using:< / p >
< pre > < code > sudo make 'COMMONFLAGS=" -Os -mmacosx-version-min=10.14 -arch x86_64 -arch arm64" ' install
< / code > < / pre >
< h3 class = "title" id = "detecting-pdfio" > Detecting PDFio< / h3 >
< p > PDFio can be detected using the < code > pkg-config< / code > command, for example:< / p >
< pre > < code > if pkg-config --exists pdfio; then
...
fi
< / code > < / pre >
< p > In a makefile you can add the necessary compiler and linker options with:< / p >
< pre > < code class = "language-make" > CFLAGS += `pkg-config --cflags pdfio`
LIBS += `pkg-config --libs pdfio`
< / code > < / pre >
< h3 class = "title" id = "header-files" > Header Files< / h3 >
< p > PDFio provides a primary header file that is always used:< / p >
< pre > < code class = "language-c" > < span class = "directive" > #include < pdfio.h> < / span >
< / code > < / pre >
< p > PDFio also provides content helper functions that are defined in a separate header file:< / p >
< pre > < code class = "language-c" > < span class = "directive" > #include < pdfio-content.h> < / span >
< / code > < / pre >
< h2 class = "title" id = "api-overview" > API Overview< / h2 >
< p > PDFio exposes several types:< / p >
< ul >
< li > < p > < code > pdfio_file_t< / code > : A PDF file (for reading or writing)< / p >
< / li >
< li > < p > < code > pdfio_array_t< / code > : An array of values< / p >
< / li >
< li > < p > < code > pdfio_dict_t< / code > : A dictionary of key/value pairs in a PDF file, object, etc.< / p >
< / li >
< li > < p > < code > pdfio_obj_t< / code > : An object in a PDF file< / p >
< / li >
< li > < p > < code > pdfio_stream_t< / code > : An object stream< / p >
< / li >
< / ul >
< h3 class = "title" id = "pdf-files" > PDF Files< / h3 >
< h3 class = "title" id = "pdf-values" > PDF Values< / h3 >
< h3 class = "title" id = "pdf-objects" > PDF Objects< / h3 >
< h3 class = "title" id = "pdf-streams" > PDF Streams< / h3 >
2021-05-30 03:21:45 +02:00
< h2 class = "title" > < a id = "FUNCTIONS" > Functions< / a > < / h2 >
< h3 class = "function" > < a id = "pdfioArrayAppendArray" > pdfioArrayAppendArray< / a > < / h3 >
< p class = "description" > Add an array value to an array.< / p >
< p class = "code" >
bool pdfioArrayAppendArray(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, < a href = "#pdfio_array_t" > pdfio_array_t< / a > *value);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / 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 = "pdfioArrayAppendBinary" > pdfioArrayAppendBinary< / a > < / h3 >
< p class = "description" > Add a binary string value to an array.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
bool pdfioArrayAppendBinary(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, const unsigned char *value, size_t valuelen);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< tr > < th > valuelen< / th >
< td class = "description" > Length of value< / td > < / tr >
< / 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 = "pdfioArrayAppendBoolean" > pdfioArrayAppendBoolean< / a > < / h3 >
< p class = "description" > Add a boolean value to an array.< / p >
< p class = "code" >
bool pdfioArrayAppendBoolean(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, bool value);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / 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 = "pdfioArrayAppendDict" > pdfioArrayAppendDict< / a > < / h3 >
< p class = "description" > Add a dictionary to an array.< / p >
< p class = "code" >
bool pdfioArrayAppendDict(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, < a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *value);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / 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 = "pdfioArrayAppendName" > pdfioArrayAppendName< / a > < / h3 >
< p class = "description" > Add a name to an array.< / p >
< p class = "code" >
bool pdfioArrayAppendName(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, const char *value);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / 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 = "pdfioArrayAppendNumber" > pdfioArrayAppendNumber< / a > < / h3 >
< p class = "description" > Add a number to an array.< / p >
< p class = "code" >
bool pdfioArrayAppendNumber(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, double value);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > < code > true< / code > on success, < code > false< / code > on failure< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioArrayAppendObj" > pdfioArrayAppendObj< / a > < / h3 >
2021-05-30 03:21:45 +02:00
< p class = "description" > Add an indirect object reference to an array.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
bool pdfioArrayAppendObj(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, < a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *value);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / 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 = "pdfioArrayAppendString" > pdfioArrayAppendString< / a > < / h3 >
< p class = "description" > Add a string to an array.< / p >
< p class = "code" >
bool pdfioArrayAppendString(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, const char *value);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / 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 = "pdfioArrayCopy" > pdfioArrayCopy< / a > < / h3 >
< p class = "description" > Copy an array.< / p >
< p class = "code" >
< a href = "#pdfio_array_t" > pdfio_array_t< / a > *pdfioArrayCopy(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, < a href = "#pdfio_array_t" > pdfio_array_t< / a > *a);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > a< / th >
< td class = "description" > Original array< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > New array or < code > NULL< / code > on error< / p >
< h3 class = "function" > < a id = "pdfioArrayCreate" > pdfioArrayCreate< / a > < / h3 >
< p class = "description" > Create an empty array.< / p >
< p class = "code" >
< a href = "#pdfio_array_t" > pdfio_array_t< / a > *pdfioArrayCreate(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > New array or < code > NULL< / code > on error< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioArrayCreateCalibratedColorFromMatrix" > pdfioArrayCreateCalibratedColorFromMatrix< / a > < / h3 >
< p class = "description" > Create a calibrated color space array using a CIE XYZ transform matrix.< / p >
< p class = "code" >
< a href = "#pdfio_array_t" > pdfio_array_t< / a > *pdfioArrayCreateCalibratedColorFromMatrix(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, size_t num_colors, double gamma, const double matrix[3][3], const double white_point[3]);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > num_colors< / th >
< td class = "description" > Number of colors (1 or 3)< / td > < / tr >
< tr > < th > gamma< / th >
< td class = "description" > Gamma value< / td > < / tr >
< tr > < th > matrix[3][3]< / th >
< td class = "description" > XYZ transform< / td > < / tr >
< tr > < th > white_point[3]< / th >
< td class = "description" > White point< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Color space array< / p >
< h3 class = "function" > < a id = "pdfioArrayCreateCalibratedColorFromPrimaries" > pdfioArrayCreateCalibratedColorFromPrimaries< / a > < / h3 >
< p class = "description" > Create a calibrated color sapce array using CIE xy primary chromacities.< / p >
< p class = "code" >
< a href = "#pdfio_array_t" > pdfio_array_t< / a > *pdfioArrayCreateCalibratedColorFromPrimaries(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, size_t num_colors, double gamma, double wx, double wy, double rx, double ry, double gx, double gy, double bx, double by);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > num_colors< / th >
< td class = "description" > Number of colors (1 or 3)< / td > < / tr >
< tr > < th > gamma< / th >
< td class = "description" > Gama value< / td > < / tr >
< tr > < th > wx< / th >
< td class = "description" > White point X chromacity< / td > < / tr >
< tr > < th > wy< / th >
< td class = "description" > White point Y chromacity< / td > < / tr >
< tr > < th > rx< / th >
< td class = "description" > Red X chromacity< / td > < / tr >
< tr > < th > ry< / th >
< td class = "description" > Red Y chromacity< / td > < / tr >
< tr > < th > gx< / th >
< td class = "description" > Green X chromacity< / td > < / tr >
< tr > < th > gy< / th >
< td class = "description" > Green Y chromacity< / td > < / tr >
< tr > < th > bx< / th >
< td class = "description" > Blue X chromacity< / td > < / tr >
< tr > < th > by< / th >
< td class = "description" > Blue Y chromacity< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Color space array< / p >
< h3 class = "function" > < a id = "pdfioArrayCreateICCBasedColor" > pdfioArrayCreateICCBasedColor< / a > < / h3 >
< p class = "description" > Create an ICC-based color space array.< / p >
< p class = "code" >
< a href = "#pdfio_array_t" > pdfio_array_t< / a > *pdfioArrayCreateICCBasedColor(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, < a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *icc_object);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > icc_object< / th >
< td class = "description" > ICC profile object< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Color array< / p >
< h3 class = "function" > < a id = "pdfioArrayCreateIndexedColor" > pdfioArrayCreateIndexedColor< / a > < / h3 >
< p class = "description" > Create an indexed color space array.< / p >
< p class = "code" >
< a href = "#pdfio_array_t" > pdfio_array_t< / a > *pdfioArrayCreateIndexedColor(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, size_t num_colors, const unsigned char *colors);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > num_colors< / th >
< td class = "description" > Number of colors< / td > < / tr >
< tr > < th > colors< / th >
< td class = "description" > RGB values for colors< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Color array< / p >
2021-05-30 03:21:45 +02:00
< h3 class = "function" > < a id = "pdfioArrayGetArray" > pdfioArrayGetArray< / a > < / h3 >
< p class = "description" > Get an array value from an array.< / p >
< p class = "code" >
< a href = "#pdfio_array_t" > pdfio_array_t< / a > *pdfioArrayGetArray(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, size_t n);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > n< / th >
< td class = "description" > Index< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioArrayGetBinary" > pdfioArrayGetBinary< / a > < / h3 >
< p class = "description" > Get a binary string value from an array.< / p >
< p class = "code" >
unsigned char *pdfioArrayGetBinary(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, size_t n, size_t *length);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > n< / th >
< td class = "description" > Index< / td > < / tr >
< tr > < th > length< / th >
< td class = "description" > Length of string< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioArrayGetBoolean" > pdfioArrayGetBoolean< / a > < / h3 >
< p class = "description" > Get a boolean value from an array.< / p >
< p class = "code" >
bool pdfioArrayGetBoolean(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, size_t n);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > n< / th >
< td class = "description" > Index< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioArrayGetDict" > pdfioArrayGetDict< / a > < / h3 >
< p class = "description" > Get a dictionary value from an array.< / p >
< p class = "code" >
< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *pdfioArrayGetDict(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, size_t n);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > n< / th >
< td class = "description" > Index< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioArrayGetName" > pdfioArrayGetName< / a > < / h3 >
< p class = "description" > Get a name value from an array.< / p >
< p class = "code" >
const char *pdfioArrayGetName(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, size_t n);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > n< / th >
< td class = "description" > Index< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioArrayGetNumber" > pdfioArrayGetNumber< / a > < / h3 >
< p class = "description" > Get a number from an array.< / p >
< p class = "code" >
double pdfioArrayGetNumber(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, size_t n);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > n< / th >
< td class = "description" > Index< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioArrayGetObj" > pdfioArrayGetObj< / a > < / h3 >
2021-05-30 03:21:45 +02:00
< p class = "description" > Get an indirect object reference from an array.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *pdfioArrayGetObj(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, size_t n);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > n< / th >
< td class = "description" > Index< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioArrayGetSize" > pdfioArrayGetSize< / a > < / h3 >
< p class = "description" > Get the length of an array.< / p >
< p class = "code" >
size_t pdfioArrayGetSize(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Length of array< / p >
< h3 class = "function" > < a id = "pdfioArrayGetString" > pdfioArrayGetString< / a > < / h3 >
< p class = "description" > Get a string value from an array.< / p >
< p class = "code" >
const char *pdfioArrayGetString(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, size_t n);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > n< / th >
< td class = "description" > Index< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioArrayGetType" > pdfioArrayGetType< / a > < / h3 >
< p class = "description" > Get a value type from an array.< / p >
< p class = "code" >
< a href = "#pdfio_valtype_t" > pdfio_valtype_t< / a > pdfioArrayGetType(< a href = "#pdfio_array_t" > pdfio_array_t< / a > *a, size_t n);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > a< / th >
< td class = "description" > Array< / td > < / tr >
< tr > < th > n< / th >
< td class = "description" > Index< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value type< / p >
< h3 class = "function" > < a id = "pdfioContentClip" > pdfioContentClip< / a > < / h3 >
< p class = "description" > Clip output to the current path.< / p >
< p class = "code" >
bool pdfioContentClip(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, bool even_odd);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > even_odd< / th >
< td class = "description" > Even/odd fill vs. non-zero winding rule< / td > < / tr >
< / 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 = "pdfioContentDrawImage" > pdfioContentDrawImage< / a > < / h3 >
< p class = "description" > Draw an image object.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
bool pdfioContentDrawImage(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, const char *name, double x, double y, double width, double height);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > name< / th >
< td class = "description" > Image name< / td > < / tr >
< tr > < th > x< / th >
< td class = "description" > X offset of image< / td > < / tr >
< tr > < th > y< / th >
< td class = "description" > Y offset of image< / td > < / tr >
2021-06-07 14:34:30 +02:00
< tr > < th > width< / th >
2021-05-30 03:21:45 +02:00
< td class = "description" > Width of image< / td > < / tr >
2021-06-07 14:34:30 +02:00
< tr > < th > height< / th >
2021-05-30 03:21:45 +02:00
< td class = "description" > Height of image< / 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" > The object name must be part of the page dictionary resources, typically
using the < a href = "#pdfioPageDictAddImage" > < code > pdfioPageDictAddImage< / code > < / a > function.< / p >
< h3 class = "function" > < a id = "pdfioContentFill" > pdfioContentFill< / a > < / h3 >
< p class = "description" > Fill the current path.< / p >
< p class = "code" >
bool pdfioContentFill(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, bool even_odd);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > even_odd< / th >
< td class = "description" > Even/odd fill vs. non-zero winding rule< / td > < / tr >
< / 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 = "pdfioContentFillAndStroke" > pdfioContentFillAndStroke< / a > < / h3 >
< p class = "description" > Fill and stroke the current path.< / p >
< p class = "code" >
bool pdfioContentFillAndStroke(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, bool even_odd);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > even_odd< / th >
< td class = "description" > Even/odd fill vs. non-zero winding< / td > < / tr >
< / 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 = "pdfioContentMatrixConcat" > pdfioContentMatrixConcat< / a > < / h3 >
< p class = "description" > Concatenate a matrix to the current graphics
state.< / p >
< p class = "code" >
bool pdfioContentMatrixConcat(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, pdfio_matrix_t m);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > m< / th >
< td class = "description" > Transform matrix< / td > < / tr >
< / 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 = "pdfioContentMatrixRotate" > pdfioContentMatrixRotate< / a > < / h3 >
< p class = "description" > Rotate the current transform matrix.< / p >
< p class = "code" >
bool pdfioContentMatrixRotate(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double degrees);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > degrees< / th >
< td class = "description" > Rotation angle in degrees counter-clockwise< / td > < / tr >
< / 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 = "pdfioContentMatrixScale" > pdfioContentMatrixScale< / a > < / h3 >
< p class = "description" > Scale the current transform matrix.< / p >
< p class = "code" >
bool pdfioContentMatrixScale(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double sx, double sy);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > sx< / th >
< td class = "description" > X scale< / td > < / tr >
< tr > < th > sy< / th >
< td class = "description" > Y scale< / td > < / tr >
< / 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 = "pdfioContentMatrixTranslate" > pdfioContentMatrixTranslate< / a > < / h3 >
< p class = "description" > Translate the current transform matrix.< / p >
< p class = "code" >
bool pdfioContentMatrixTranslate(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double tx, double ty);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > tx< / th >
< td class = "description" > X offset< / td > < / tr >
< tr > < th > ty< / th >
< td class = "description" > Y offset< / td > < / tr >
< / 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 = "pdfioContentPathClose" > pdfioContentPathClose< / a > < / h3 >
< p class = "description" > Close the current path.< / p >
< p class = "code" >
bool pdfioContentPathClose(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< / 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 = "pdfioContentPathCurve" > pdfioContentPathCurve< / a > < / h3 >
< p class = "description" > Add a Bezier curve with two control points.< / p >
< p class = "code" >
bool pdfioContentPathCurve(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double x1, double y1, double x2, double y2, double x3, double y3);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > x1< / th >
< td class = "description" > X position 1< / td > < / tr >
< tr > < th > y1< / th >
< td class = "description" > Y position 1< / td > < / tr >
< tr > < th > x2< / th >
< td class = "description" > X position 2< / td > < / tr >
< tr > < th > y2< / th >
< td class = "description" > Y position 2< / td > < / tr >
< tr > < th > x3< / th >
< td class = "description" > X position 3< / td > < / tr >
< tr > < th > y3< / th >
< td class = "description" > Y position 3< / td > < / tr >
< / 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 = "pdfioContentPathCurve13" > pdfioContentPathCurve13< / a > < / h3 >
< p class = "description" > Add a Bezier curve with an initial control point.< / p >
< p class = "code" >
bool pdfioContentPathCurve13(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double x1, double y1, double x3, double y3);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > x1< / th >
< td class = "description" > X position 1< / td > < / tr >
< tr > < th > y1< / th >
< td class = "description" > Y position 1< / td > < / tr >
< tr > < th > x3< / th >
< td class = "description" > X position 3< / td > < / tr >
< tr > < th > y3< / th >
< td class = "description" > Y position 3< / td > < / tr >
< / 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 = "pdfioContentPathCurve23" > pdfioContentPathCurve23< / a > < / h3 >
< p class = "description" > Add a Bezier curve with a trailing control point.< / p >
< p class = "code" >
bool pdfioContentPathCurve23(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double x2, double y2, double x3, double y3);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > x2< / th >
< td class = "description" > X position 2< / td > < / tr >
< tr > < th > y2< / th >
< td class = "description" > Y position 2< / td > < / tr >
< tr > < th > x3< / th >
< td class = "description" > X position 3< / td > < / tr >
< tr > < th > y3< / th >
< td class = "description" > Y position 3< / td > < / tr >
< / 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 = "pdfioContentPathLineTo" > pdfioContentPathLineTo< / a > < / h3 >
< p class = "description" > Add a straight line to the current path.< / p >
< p class = "code" >
bool pdfioContentPathLineTo(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double x, double y);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > x< / th >
< td class = "description" > X position< / td > < / tr >
< tr > < th > y< / th >
< td class = "description" > Y position< / td > < / tr >
< / 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 = "pdfioContentPathMoveTo" > pdfioContentPathMoveTo< / a > < / h3 >
< p class = "description" > Start a new subpath.< / p >
< p class = "code" >
bool pdfioContentPathMoveTo(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double x, double y);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > x< / th >
< td class = "description" > X position< / td > < / tr >
< tr > < th > y< / th >
< td class = "description" > Y position< / td > < / tr >
< / 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 = "pdfioContentPathRect" > pdfioContentPathRect< / a > < / h3 >
< p class = "description" > Add a rectangle to the current path.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
bool pdfioContentPathRect(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double x, double y, double width, double height);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
2021-06-07 14:34:30 +02:00
< tr > < th > x< / th >
< td class = "description" > X offset< / td > < / tr >
< tr > < th > y< / th >
< td class = "description" > Y offset< / td > < / tr >
< tr > < th > width< / th >
< td class = "description" > Width< / td > < / tr >
< tr > < th > height< / th >
< td class = "description" > Height< / td > < / tr >
2021-05-30 03:21:45 +02:00
< / 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 = "pdfioContentRestore" > pdfioContentRestore< / a > < / h3 >
< p class = "description" > Restore a previous graphics state.< / p >
< p class = "code" >
bool pdfioContentRestore(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< / 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 = "pdfioContentSave" > pdfioContentSave< / a > < / h3 >
< p class = "description" > Save the current graphics state.< / p >
< p class = "code" >
bool pdfioContentSave(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< / 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 = "pdfioContentSetDashPattern" > pdfioContentSetDashPattern< / a > < / h3 >
< p class = "description" > Set the stroke pattern.< / p >
< p class = "code" >
bool pdfioContentSetDashPattern(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, int phase, int on, int off);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > phase< / th >
< td class = "description" > Phase (offset within pattern)< / td > < / tr >
< tr > < th > on< / th >
< td class = "description" > On length< / td > < / tr >
< tr > < th > off< / th >
< td class = "description" > Off length< / td > < / tr >
< / 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 = "pdfioContentSetFillColorDeviceCMYK" > pdfioContentSetFillColorDeviceCMYK< / a > < / h3 >
< p class = "description" > Set device CMYK fill color.< / p >
< p class = "code" >
bool pdfioContentSetFillColorDeviceCMYK(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double c, double m, double y, double k);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > c< / th >
< td class = "description" > Cyan value (0.0 to 1.0)< / td > < / tr >
< tr > < th > m< / th >
< td class = "description" > Magenta value (0.0 to 1.0)< / td > < / tr >
< tr > < th > y< / th >
< td class = "description" > Yellow value (0.0 to 1.0)< / td > < / tr >
< tr > < th > k< / th >
< td class = "description" > Black value (0.0 to 1.0)< / td > < / tr >
< / 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 = "pdfioContentSetFillColorDeviceGray" > pdfioContentSetFillColorDeviceGray< / a > < / h3 >
< p class = "description" > Set the device gray fill color.< / p >
< p class = "code" >
bool pdfioContentSetFillColorDeviceGray(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double g);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > g< / th >
< td class = "description" > Gray value (0.0 to 1.0)< / td > < / tr >
< / 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 = "pdfioContentSetFillColorDeviceRGB" > pdfioContentSetFillColorDeviceRGB< / a > < / h3 >
< p class = "description" > Set the device RGB fill color.< / p >
< p class = "code" >
bool pdfioContentSetFillColorDeviceRGB(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double r, double g, double b);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > r< / th >
< td class = "description" > Red value (0.0 to 1.0)< / td > < / tr >
< tr > < th > g< / th >
< td class = "description" > Green value (0.0 to 1.0)< / td > < / tr >
< tr > < th > b< / th >
< td class = "description" > Blue value (0.0 to 1.0)< / td > < / tr >
< / 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 = "pdfioContentSetFillColorGray" > pdfioContentSetFillColorGray< / a > < / h3 >
< p class = "description" > Set the calibrated gray fill color.< / p >
< p class = "code" >
bool pdfioContentSetFillColorGray(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double g);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > g< / th >
< td class = "description" > Gray value (0.0 to 1.0)< / td > < / tr >
< / 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 = "pdfioContentSetFillColorRGB" > pdfioContentSetFillColorRGB< / a > < / h3 >
< p class = "description" > Set the calibrated RGB fill color.< / p >
< p class = "code" >
bool pdfioContentSetFillColorRGB(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double r, double g, double b);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > r< / th >
< td class = "description" > Red value (0.0 to 1.0)< / td > < / tr >
< tr > < th > g< / th >
< td class = "description" > Green value (0.0 to 1.0)< / td > < / tr >
< tr > < th > b< / th >
< td class = "description" > Blue value (0.0 to 1.0)< / td > < / tr >
< / 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 = "pdfioContentSetFillColorSpace" > pdfioContentSetFillColorSpace< / a > < / h3 >
< p class = "description" > Set the fill colorspace.< / p >
< p class = "code" >
bool pdfioContentSetFillColorSpace(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, const char *name);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > name< / th >
< td class = "description" > Color space name< / td > < / tr >
< / 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 = "pdfioContentSetFlatness" > pdfioContentSetFlatness< / a > < / h3 >
< p class = "description" > Set the flatness tolerance.< / p >
< p class = "code" >
bool pdfioContentSetFlatness(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double flatness);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > flatness< / th >
< td class = "description" > Flatness value (0.0 to 100.0)< / td > < / tr >
< / 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 = "pdfioContentSetLineCap" > pdfioContentSetLineCap< / a > < / h3 >
< p class = "description" > Set the line ends style.< / p >
< p class = "code" >
bool pdfioContentSetLineCap(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, pdfio_linecap_t lc);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > lc< / th >
< td class = "description" > Line cap value< / td > < / tr >
< / 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 = "pdfioContentSetLineJoin" > pdfioContentSetLineJoin< / a > < / h3 >
< p class = "description" > Set the line joining style.< / p >
< p class = "code" >
bool pdfioContentSetLineJoin(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, pdfio_linejoin_t lj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > lj< / th >
< td class = "description" > Line join value< / td > < / tr >
< / 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 = "pdfioContentSetLineWidth" > pdfioContentSetLineWidth< / a > < / h3 >
< p class = "description" > Set the line width.< / p >
< p class = "code" >
bool pdfioContentSetLineWidth(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double width);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > width< / th >
< td class = "description" > Line width value< / td > < / tr >
< / 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 = "pdfioContentSetMiterLimit" > pdfioContentSetMiterLimit< / a > < / h3 >
< p class = "description" > Set the miter limit.< / p >
< p class = "code" >
bool pdfioContentSetMiterLimit(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double limit);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > limit< / th >
< td class = "description" > Miter limit value< / td > < / tr >
< / 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 = "pdfioContentSetStrokeColorDeviceCMYK" > pdfioContentSetStrokeColorDeviceCMYK< / a > < / h3 >
< p class = "description" > Set the device CMYK stroke color.< / p >
< p class = "code" >
bool pdfioContentSetStrokeColorDeviceCMYK(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double c, double m, double y, double k);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > c< / th >
< td class = "description" > Cyan value (0.0 to 1.0)< / td > < / tr >
< tr > < th > m< / th >
< td class = "description" > Magenta value (0.0 to 1.0)< / td > < / tr >
< tr > < th > y< / th >
< td class = "description" > Yellow value (0.0 to 1.0)< / td > < / tr >
< tr > < th > k< / th >
< td class = "description" > Black value (0.0 to 1.0)< / td > < / tr >
< / 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 = "pdfioContentSetStrokeColorDeviceGray" > pdfioContentSetStrokeColorDeviceGray< / a > < / h3 >
< p class = "description" > Set the device gray stroke color.< / p >
< p class = "code" >
bool pdfioContentSetStrokeColorDeviceGray(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double g);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > g< / th >
< td class = "description" > Gray value (0.0 to 1.0)< / td > < / tr >
< / 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 = "pdfioContentSetStrokeColorDeviceRGB" > pdfioContentSetStrokeColorDeviceRGB< / a > < / h3 >
< p class = "description" > Set the device RGB stroke color.< / p >
< p class = "code" >
bool pdfioContentSetStrokeColorDeviceRGB(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double r, double g, double b);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > r< / th >
< td class = "description" > Red value (0.0 to 1.0)< / td > < / tr >
< tr > < th > g< / th >
< td class = "description" > Green value (0.0 to 1.0)< / td > < / tr >
< tr > < th > b< / th >
< td class = "description" > Blue value (0.0 to 1.0)< / td > < / tr >
< / 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 = "pdfioContentSetStrokeColorGray" > pdfioContentSetStrokeColorGray< / a > < / h3 >
< p class = "description" > Set the calibrated gray stroke color.< / p >
< p class = "code" >
bool pdfioContentSetStrokeColorGray(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double g);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > g< / th >
< td class = "description" > Gray value (0.0 to 1.0)< / td > < / tr >
< / 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 = "pdfioContentSetStrokeColorRGB" > pdfioContentSetStrokeColorRGB< / a > < / h3 >
< p class = "description" > Set the calibrated RGB stroke color.< / p >
< p class = "code" >
bool pdfioContentSetStrokeColorRGB(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double r, double g, double b);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > r< / th >
< td class = "description" > Red value (0.0 to 1.0)< / td > < / tr >
< tr > < th > g< / th >
< td class = "description" > Green value (0.0 to 1.0)< / td > < / tr >
< tr > < th > b< / th >
< td class = "description" > Blue value (0.0 to 1.0)< / td > < / tr >
< / 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 = "pdfioContentSetStrokeColorSpace" > pdfioContentSetStrokeColorSpace< / a > < / h3 >
< p class = "description" > Set the stroke color space.< / p >
< p class = "code" >
bool pdfioContentSetStrokeColorSpace(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, const char *name);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > name< / th >
< td class = "description" > Color space name< / td > < / tr >
< / 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 = "pdfioContentSetTextCharacterSpacing" > pdfioContentSetTextCharacterSpacing< / a > < / h3 >
< p class = "description" > Set the spacing between characters.< / p >
< p class = "code" >
bool pdfioContentSetTextCharacterSpacing(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double spacing);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > spacing< / th >
< td class = "description" > Character spacing< / td > < / tr >
< / 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 = "pdfioContentSetTextFont" > pdfioContentSetTextFont< / a > < / h3 >
< p class = "description" > Set the text font and size.< / p >
< p class = "code" >
bool pdfioContentSetTextFont(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, const char *name, double size);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > name< / th >
< td class = "description" > Font name< / td > < / tr >
< tr > < th > size< / th >
< td class = "description" > Font size< / td > < / tr >
< / 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 = "pdfioContentSetTextLeading" > pdfioContentSetTextLeading< / a > < / h3 >
< p class = "description" > Set text leading (line height) value.< / p >
< p class = "code" >
bool pdfioContentSetTextLeading(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double leading);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > leading< / th >
< td class = "description" > Leading (line height) value< / td > < / tr >
< / 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 = "pdfioContentSetTextMatrix" > pdfioContentSetTextMatrix< / a > < / h3 >
< p class = "description" > Set the text transform matrix.< / p >
< p class = "code" >
bool pdfioContentSetTextMatrix(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, pdfio_matrix_t m);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > m< / th >
< td class = "description" > Transform matrix< / td > < / tr >
< / 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 = "pdfioContentSetTextRenderingMode" > pdfioContentSetTextRenderingMode< / a > < / h3 >
< p class = "description" > Set the text rendering mode.< / p >
< p class = "code" >
bool pdfioContentSetTextRenderingMode(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, pdfio_textrendering_t mode);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > mode< / th >
< td class = "description" > Text rendering mode< / td > < / tr >
< / 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 = "pdfioContentSetTextRise" > pdfioContentSetTextRise< / a > < / h3 >
< p class = "description" > Set the text baseline offset.< / p >
< p class = "code" >
bool pdfioContentSetTextRise(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double rise);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > rise< / th >
< td class = "description" > Y offset< / td > < / tr >
< / 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 = "pdfioContentSetTextWordSpacing" > pdfioContentSetTextWordSpacing< / a > < / h3 >
< p class = "description" > Set the inter-word spacing.< / p >
< p class = "code" >
bool pdfioContentSetTextWordSpacing(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double spacing);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > spacing< / th >
< td class = "description" > Spacing between words< / td > < / tr >
< / 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 = "pdfioContentSetTextXScaling" > pdfioContentSetTextXScaling< / a > < / h3 >
< p class = "description" > Set the horizontal scaling value.< / p >
< p class = "code" >
bool pdfioContentSetTextXScaling(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double percent);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > percent< / th >
< td class = "description" > Horizontal scaling in percent< / td > < / tr >
< / 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 = "pdfioContentStroke" > pdfioContentStroke< / a > < / h3 >
< p class = "description" > Stroke the current path.< / p >
< p class = "code" >
bool pdfioContentStroke(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > < code > true< / code > on success, < code > false< / code > on failure< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioContentTextBegin" > pdfioContentTextBegin< / a > < / h3 >
< p class = "description" > Begin a text block.< / p >
< p class = "code" >
bool pdfioContentTextBegin(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< / 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 = "pdfioContentTextEnd" > pdfioContentTextEnd< / a > < / h3 >
< p class = "description" > End a text block.< / p >
< p class = "code" >
bool pdfioContentTextEnd(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > < code > true< / code > on success, < code > false< / code > on failure< / p >
2021-05-30 03:21:45 +02:00
< h3 class = "function" > < a id = "pdfioContentTextMoveLine" > pdfioContentTextMoveLine< / a > < / h3 >
< p class = "description" > Move to the next line and offset.< / p >
< p class = "code" >
bool pdfioContentTextMoveLine(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double tx, double ty);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > tx< / th >
< td class = "description" > X offset< / td > < / tr >
< tr > < th > ty< / th >
< td class = "description" > Y offset< / td > < / tr >
< / 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 = "pdfioContentTextMoveTo" > pdfioContentTextMoveTo< / a > < / h3 >
< p class = "description" > Offset within the current line.< / p >
< p class = "code" >
bool pdfioContentTextMoveTo(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, double tx, double ty);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > tx< / th >
< td class = "description" > X offset< / td > < / tr >
< tr > < th > ty< / th >
< td class = "description" > Y offset< / td > < / tr >
< / 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 = "pdfioContentTextNextLine" > pdfioContentTextNextLine< / a > < / h3 >
< p class = "description" > Move to the next line.< / p >
< p class = "code" >
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 >
< td class = "description" > Stream< / td > < / tr >
< / 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 = "pdfioContentTextShow" > pdfioContentTextShow< / a > < / h3 >
< p class = "description" > Show text.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
bool pdfioContentTextShow(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, const char *s);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / 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 >
< h3 class = "function" > < a id = "pdfioContentTextShowJustified" > pdfioContentTextShowJustified< / a > < / h3 >
< p class = "description" > Show justified text.< / p >
< p class = "code" >
bool pdfioContentTextShowJustified(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, size_t num_fragments, const double *offsets, const char *const *fragments);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > num_fragments< / th >
< td class = "description" > Number of text fragments< / td > < / tr >
< tr > < th > offsets< / th >
< td class = "description" > Text offsets before fragments< / td > < / tr >
< tr > < th > fragments< / th >
< td class = "description" > Text fragments< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > < code > true< / code > on success, < code > false< / code > on failure< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioContentTextShowf" > pdfioContentTextShowf< / a > < / h3 >
< p class = "description" > < / p >
< p class = "code" >
bool pdfioContentTextShowf(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, 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 > 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" > Show formatted text.< / p >
2021-05-30 03:21:45 +02:00
< h3 class = "function" > < a id = "pdfioDictCopy" > pdfioDictCopy< / a > < / h3 >
< p class = "description" > Copy a dictionary to a PDF file.< / p >
< p class = "code" >
< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *pdfioDictCopy(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, < a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > dict< / th >
< td class = "description" > Original dictionary< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > New dictionary< / p >
< h3 class = "function" > < a id = "pdfioDictCreate" > pdfioDictCreate< / a > < / h3 >
< p class = "description" > Create a dictionary to hold key/value pairs.< / p >
< p class = "code" >
< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *pdfioDictCreate(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > New dictionary< / p >
< h3 class = "function" > < a id = "pdfioDictGetArray" > pdfioDictGetArray< / a > < / h3 >
< p class = "description" > Get a key array value from a dictionary.< / p >
< p class = "code" >
< a href = "#pdfio_array_t" > pdfio_array_t< / a > *pdfioDictGetArray(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioDictGetBinary" > pdfioDictGetBinary< / a > < / h3 >
< p class = "description" > Get a key binary string value from a dictionary.< / p >
< p class = "code" >
unsigned char *pdfioDictGetBinary(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key, size_t *length);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< tr > < th > length< / th >
< td class = "description" > Length of value< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioDictGetBoolean" > pdfioDictGetBoolean< / a > < / h3 >
< p class = "description" > Get a key boolean value from a dictionary.< / p >
< p class = "code" >
bool pdfioDictGetBoolean(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioDictGetDict" > pdfioDictGetDict< / a > < / h3 >
< p class = "description" > Get a key dictionary value from a dictionary.< / p >
< p class = "code" >
< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *pdfioDictGetDict(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioDictGetName" > pdfioDictGetName< / a > < / h3 >
< p class = "description" > Get a key name value from a dictionary.< / p >
< p class = "code" >
const char *pdfioDictGetName(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioDictGetNumber" > pdfioDictGetNumber< / a > < / h3 >
< p class = "description" > Get a key number value from a dictionary.< / p >
< p class = "code" >
double pdfioDictGetNumber(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioDictGetObj" > pdfioDictGetObj< / a > < / h3 >
2021-05-30 03:21:45 +02:00
< p class = "description" > Get a key indirect object value from a dictionary.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *pdfioDictGetObj(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioDictGetRect" > pdfioDictGetRect< / a > < / h3 >
< p class = "description" > Get a key rectangle value from a dictionary.< / p >
< p class = "code" >
< a href = "#pdfio_rect_t" > pdfio_rect_t< / a > *pdfioDictGetRect(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key, < a href = "#pdfio_rect_t" > pdfio_rect_t< / a > *rect);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< tr > < th > rect< / th >
< td class = "description" > Rectangle< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Rectangle< / p >
< h3 class = "function" > < a id = "pdfioDictGetString" > pdfioDictGetString< / a > < / h3 >
< p class = "description" > Get a key string value from a dictionary.< / p >
< p class = "code" >
const char *pdfioDictGetString(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value< / p >
< h3 class = "function" > < a id = "pdfioDictGetType" > pdfioDictGetType< / a > < / h3 >
< p class = "description" > Get a key value type from a dictionary.< / p >
< p class = "code" >
< a href = "#pdfio_valtype_t" > pdfio_valtype_t< / a > pdfioDictGetType(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Value type< / p >
< h3 class = "function" > < a id = "pdfioDictSetArray" > pdfioDictSetArray< / a > < / h3 >
< p class = "description" > Set a key array in a dictionary.< / p >
< p class = "code" >
bool pdfioDictSetArray(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key, < a href = "#pdfio_array_t" > pdfio_array_t< / a > *value);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / 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 = "pdfioDictSetBinary" > pdfioDictSetBinary< / a > < / h3 >
< p class = "description" > Set a key binary string in a dictionary.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
bool pdfioDictSetBinary(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key, const unsigned char *value, size_t valuelen);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< tr > < th > valuelen< / th >
< td class = "description" > Length of value< / td > < / tr >
< / 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 = "pdfioDictSetBoolean" > pdfioDictSetBoolean< / a > < / h3 >
< p class = "description" > Set a key boolean in a dictionary.< / p >
< p class = "code" >
bool pdfioDictSetBoolean(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key, bool value);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / 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 = "pdfioDictSetDict" > pdfioDictSetDict< / a > < / h3 >
< p class = "description" > Set a key dictionary in a dictionary.< / p >
< p class = "code" >
bool pdfioDictSetDict(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key, < a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *value);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / 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 = "pdfioDictSetName" > pdfioDictSetName< / a > < / h3 >
< p class = "description" > Set a key name in a dictionary.< / p >
< p class = "code" >
bool pdfioDictSetName(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key, const char *value);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / 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 = "pdfioDictSetNull" > pdfioDictSetNull< / a > < / h3 >
< p class = "description" > Set a key null in a dictionary.< / p >
< p class = "code" >
bool pdfioDictSetNull(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< / 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 = "pdfioDictSetNumber" > pdfioDictSetNumber< / a > < / h3 >
< p class = "description" > Set a key number in a dictionary.< / p >
< p class = "code" >
bool pdfioDictSetNumber(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key, double value);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > < code > true< / code > on success, < code > false< / code > on failure< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioDictSetObj" > pdfioDictSetObj< / a > < / h3 >
2021-05-30 03:21:45 +02:00
< p class = "description" > Set a key indirect object reference in a dictionary.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
bool pdfioDictSetObj(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key, < a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *value);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / 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 = "pdfioDictSetRect" > pdfioDictSetRect< / a > < / h3 >
< p class = "description" > Set a key rectangle in a dictionary.< / p >
< p class = "code" >
bool pdfioDictSetRect(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key, < a href = "#pdfio_rect_t" > pdfio_rect_t< / a > *value);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / 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 = "pdfioDictSetString" > pdfioDictSetString< / a > < / h3 >
< p class = "description" > Set a key literal string in a dictionary.< / p >
< p class = "code" >
bool pdfioDictSetString(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key, const char *value);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / td > < / tr >
< tr > < th > value< / th >
< td class = "description" > Value< / td > < / tr >
< / 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 = "pdfioDictSetStringf" > pdfioDictSetStringf< / a > < / h3 >
< p class = "description" > Set a key formatted string in a dictionary.< / p >
< p class = "code" >
bool pdfioDictSetStringf(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *key, const char *format, ...);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Dictionary< / td > < / tr >
< tr > < th > key< / th >
< td class = "description" > Key< / 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 >
< h3 class = "function" > < a id = "pdfioFileClose" > pdfioFileClose< / a > < / h3 >
< p class = "description" > Close a PDF file and free all memory used for it.< / p >
< p class = "code" >
bool pdfioFileClose(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > < code > true< / code > on success and < code > false< / code > on failure< / p >
< h3 class = "function" > < a id = "pdfioFileCreate" > pdfioFileCreate< / a > < / h3 >
< p class = "description" > Create a PDF file.< / p >
< p class = "code" >
< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdfioFileCreate(const char *filename, const char *version, < a href = "#pdfio_rect_t" > pdfio_rect_t< / a > *media_box, < a href = "#pdfio_rect_t" > pdfio_rect_t< / a > *crop_box, < a href = "#pdfio_error_cb_t" > pdfio_error_cb_t< / a > error_cb, void *error_data);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > filename< / th >
< td class = "description" > Filename< / td > < / tr >
< tr > < th > version< / th >
< td class = "description" > PDF version number or < code > NULL< / code > for default (2.0)< / td > < / tr >
< tr > < th > media_box< / th >
< td class = "description" > Default MediaBox for pages< / td > < / tr >
< tr > < th > crop_box< / th >
< td class = "description" > Default CropBox for pages< / td > < / tr >
< tr > < th > error_cb< / th >
< td class = "description" > Error callback or < code > NULL< / code > for default< / td > < / tr >
< tr > < th > error_data< / th >
< td class = "description" > Error callback data, if any< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > PDF file or < code > NULL< / code > on error< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioFileCreateBaseFontObj" > pdfioFileCreateBaseFontObj< / a > < / h3 >
< p class = "description" > Create one of the base 14 PDF fonts.< / p >
< p class = "code" >
< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *pdfioFileCreateBaseFontObj(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, const char *name);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > name< / th >
< td class = "description" > Font name< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Font object< / p >
< h4 class = "discussion" > Discussion< / h4 >
< p class = "discussion" > This function creates one of the base 14 PDF fonts. The " name" parameter
specifies the font nane:
< / p > < ul >
< li > < code > Courier< / code >
< / li >
< li > < code > Courier-Bold< / code >
< / li >
< li > < code > Courier-BoldItalic< / code >
< / li >
< li > < code > Courier-Italic< / code >
< / li >
< li > < code > Helvetica< / code >
< / li >
< li > < code > Helvetica-Bold< / code >
< / li >
< li > < code > Helvetica-BoldOblique< / code >
< / li >
< li > < code > Helvetica-Oblique< / code >
< / li >
< li > < code > Symbol< / code >
< / li >
< li > < code > Times-Bold< / code >
< / li >
< li > < code > Times-BoldItalic< / code >
< / li >
< li > < code > Times-Italic< / code >
< / li >
< li > < code > Times-Roman< / code >
< / li >
< li > < code > ZapfDingbats< / code > < / li >
< / ul >
< h3 class = "function" > < a id = "pdfioFileCreateFontObj" > pdfioFileCreateFontObj< / a > < / h3 >
2021-05-30 03:21:45 +02:00
< p class = "description" > Add a font object to a PDF file.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *pdfioFileCreateFontObj(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, const char *filename, bool unicode);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > filename< / th >
< td class = "description" > Filename< / td > < / tr >
2021-06-07 14:34:30 +02:00
< tr > < th > unicode< / th >
< td class = "description" > Unicode font?< / td > < / tr >
2021-05-30 03:21:45 +02:00
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
2021-06-07 14:34:30 +02:00
< p class = "description" > Font object< / p >
< h3 class = "function" > < a id = "pdfioFileCreateICCProfileObj" > pdfioFileCreateICCProfileObj< / a > < / h3 >
2021-05-30 03:21:45 +02:00
< p class = "description" > Add an ICC profile object to a PDF file.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *pdfioFileCreateICCProfileObj(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, const char *filename);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > filename< / th >
< td class = "description" > Filename< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Object< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioFileCreateImageObj" > pdfioFileCreateImageObj< / a > < / h3 >
2021-05-30 03:21:45 +02:00
< p class = "description" > Add an image object to a PDF file.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *pdfioFileCreateImageObj(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, const char *filename, bool interpolate);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > filename< / th >
< td class = "description" > Filename< / td > < / tr >
< tr > < th > interpolate< / th >
< td class = "description" > Interpolate image data?< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Object< / p >
< h4 class = "discussion" > Discussion< / h4 >
< p class = "discussion" > Currently only GIF, JPEG, and PNG files are supported.< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioFileCreateObj" > pdfioFileCreateObj< / a > < / h3 >
2021-05-30 03:21:45 +02:00
< p class = "description" > Create a new object in a PDF file.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *pdfioFileCreateObj(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, < a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > dict< / th >
< td class = "description" > Object dictionary< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > New object< / p >
< h3 class = "function" > < a id = "pdfioFileCreatePage" > pdfioFileCreatePage< / a > < / h3 >
< p class = "description" > Create a page in a PDF file.< / p >
< p class = "code" >
< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *pdfioFileCreatePage(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, < a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > dict< / th >
< td class = "description" > Page dictionary< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Contents stream< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioFileFindObj" > pdfioFileFindObj< / a > < / h3 >
2021-05-30 03:21:45 +02:00
< p class = "description" > Find an object using its object number.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *pdfioFileFindObj(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, size_t number);< / p >
2021-05-30 03:21:45 +02:00
< 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" > Object number (1 to N)< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Object or < code > NULL< / code > if not found< / p >
< h4 class = "discussion" > Discussion< / h4 >
2021-06-07 14:34:30 +02:00
< p class = "discussion" > This differs from < a href = "#pdfioFileGetObj" > < code > pdfioFileGetObj< / code > < / a > which takes an index into the
2021-05-30 03:21:45 +02:00
list of objects while this function takes the object number.< / p >
< h3 class = "function" > < a id = "pdfioFileGetID" > pdfioFileGetID< / a > < / h3 >
< p class = "description" > Get the PDF file's ID strings.< / p >
< p class = "code" >
< a href = "#pdfio_array_t" > pdfio_array_t< / a > *pdfioFileGetID(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Array with binary strings< / p >
< h3 class = "function" > < a id = "pdfioFileGetName" > pdfioFileGetName< / a > < / h3 >
< p class = "description" > Get a PDF's filename.< / p >
< p class = "code" >
const char *pdfioFileGetName(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Filename< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioFileGetNumObjs" > pdfioFileGetNumObjs< / a > < / h3 >
2021-05-30 03:21:45 +02:00
< p class = "description" > Get the number of objects in a PDF file.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
size_t pdfioFileGetNumObjs(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Number of objects< / p >
< h3 class = "function" > < a id = "pdfioFileGetNumPages" > pdfioFileGetNumPages< / a > < / h3 >
< p class = "description" > Get the number of pages in a PDF file.< / p >
< p class = "code" >
size_t pdfioFileGetNumPages(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Number of pages< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioFileGetObj" > pdfioFileGetObj< / a > < / h3 >
2021-05-30 03:21:45 +02:00
< p class = "description" > Get an object from a PDF file.< / p >
< p class = "code" >
2021-06-07 14:34:30 +02:00
< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *pdfioFileGetObj(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, size_t n);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > n< / th >
< td class = "description" > Object index (starting at 0)< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Object< / p >
< h3 class = "function" > < a id = "pdfioFileGetPage" > pdfioFileGetPage< / a > < / h3 >
< p class = "description" > Get a page object from a PDF file.< / p >
< p class = "code" >
< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *pdfioFileGetPage(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, size_t n);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > n< / th >
< td class = "description" > Page index (starting at 0)< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Object< / p >
< h3 class = "function" > < a id = "pdfioFileGetVersion" > pdfioFileGetVersion< / a > < / h3 >
< p class = "description" > Get the PDF version number for a PDF file.< / p >
< p class = "code" >
const char *pdfioFileGetVersion(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Version number or < code > NULL< / code > < / p >
< h3 class = "function" > < a id = "pdfioFileOpen" > pdfioFileOpen< / a > < / h3 >
< p class = "description" > Open a PDF file for reading.< / p >
< p class = "code" >
< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdfioFileOpen(const char *filename, < a href = "#pdfio_error_cb_t" > pdfio_error_cb_t< / a > error_cb, void *error_data);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > filename< / th >
< td class = "description" > Filename< / td > < / tr >
< tr > < th > error_cb< / th >
< td class = "description" > Error callback or < code > NULL< / code > for default< / td > < / tr >
< tr > < th > error_data< / th >
< td class = "description" > Error callback data, if any< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > PDF file< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioImageGetBytesPerLine" > pdfioImageGetBytesPerLine< / a > < / h3 >
< p class = "description" > Get the number of bytes to read for each line.< / p >
< p class = "code" >
size_t pdfioImageGetBytesPerLine(< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > obj< / th >
< td class = "description" > Image object< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Number of bytes per line< / p >
2021-05-30 03:21:45 +02:00
< h3 class = "function" > < a id = "pdfioImageGetHeight" > pdfioImageGetHeight< / a > < / h3 >
< p class = "description" > Get the height of an image object.< / p >
< p class = "code" >
double pdfioImageGetHeight(< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > obj< / th >
< td class = "description" > Image object< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Height in lines< / p >
< h3 class = "function" > < a id = "pdfioImageGetWidth" > pdfioImageGetWidth< / a > < / h3 >
< p class = "description" > Get the width of an image object.< / p >
< p class = "code" >
double pdfioImageGetWidth(< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > obj< / th >
< td class = "description" > Image object< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Width in columns< / p >
< h3 class = "function" > < a id = "pdfioObjClose" > pdfioObjClose< / a > < / h3 >
< p class = "description" > Close an object, writing any data as needed to the PDF
file.< / p >
< p class = "code" >
bool pdfioObjClose(< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > obj< / th >
< td class = "description" > Object< / td > < / tr >
< / 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 = "pdfioObjCopy" > pdfioObjCopy< / a > < / h3 >
< p class = "description" > Copy an object to another PDF file.< / p >
< p class = "code" >
< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *pdfioObjCopy(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, < a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *srcobj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > srcobj< / th >
< td class = "description" > Object to copy< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > New object or < code > NULL< / code > on error< / p >
< h3 class = "function" > < a id = "pdfioObjCreateStream" > pdfioObjCreateStream< / a > < / h3 >
< p class = "description" > Create an object (data) stream for writing.< / p >
< p class = "code" >
< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *pdfioObjCreateStream(< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj, < a href = "#pdfio_filter_t" > pdfio_filter_t< / a > filter);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > obj< / th >
< td class = "description" > Object< / td > < / tr >
< tr > < th > filter< / th >
< td class = "description" > Type of compression to apply< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Stream or < code > NULL< / code > on error< / p >
< h3 class = "function" > < a id = "pdfioObjGetArray" > pdfioObjGetArray< / a > < / h3 >
< p class = "description" > Get the array associated with an object.< / p >
< p class = "code" >
< a href = "#pdfio_array_t" > pdfio_array_t< / a > *pdfioObjGetArray(< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > obj< / th >
< td class = "description" > Object< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Array or < code > NULL< / code > on error< / p >
< h3 class = "function" > < a id = "pdfioObjGetDict" > pdfioObjGetDict< / a > < / h3 >
< p class = "description" > Get the dictionary associated with an object.< / p >
< p class = "code" >
< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *pdfioObjGetDict(< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > obj< / th >
< td class = "description" > Object< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Dictionary or < code > NULL< / code > on error< / p >
< h3 class = "function" > < a id = "pdfioObjGetGeneration" > pdfioObjGetGeneration< / a > < / h3 >
< p class = "description" > Get the object's generation number.< / p >
< p class = "code" >
unsigned short pdfioObjGetGeneration(< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > obj< / th >
< td class = "description" > Object< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Generation number (0 to 65535)< / p >
< h3 class = "function" > < a id = "pdfioObjGetLength" > pdfioObjGetLength< / a > < / h3 >
< p class = "description" > Get the length of the object's (data) stream.< / p >
< p class = "code" >
size_t pdfioObjGetLength(< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > obj< / th >
< td class = "description" > Object< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Length in bytes or < code > 0< / code > for none< / p >
< h3 class = "function" > < a id = "pdfioObjGetNumber" > pdfioObjGetNumber< / a > < / h3 >
< p class = "description" > Get the object's number.< / p >
< p class = "code" >
size_t pdfioObjGetNumber(< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > obj< / th >
< td class = "description" > Object< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Object number (1 to 9999999999)< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioObjGetSubtype" > pdfioObjGetSubtype< / a > < / h3 >
< p class = "description" > Get an object's subtype.< / p >
< p class = "code" >
const char *pdfioObjGetSubtype(< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > obj< / th >
< td class = "description" > Object< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Object subtype< / p >
2021-05-30 03:21:45 +02:00
< h3 class = "function" > < a id = "pdfioObjGetType" > pdfioObjGetType< / a > < / h3 >
< p class = "description" > Get an object's type.< / p >
< p class = "code" >
const char *pdfioObjGetType(< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > obj< / th >
< td class = "description" > Object< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Object type< / p >
< h3 class = "function" > < a id = "pdfioObjOpenStream" > pdfioObjOpenStream< / a > < / h3 >
< p class = "description" > Open an object's (data) stream for reading.< / p >
< p class = "code" >
< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *pdfioObjOpenStream(< a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj, bool decode);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > obj< / th >
< td class = "description" > Object< / td > < / tr >
< tr > < th > decode< / th >
< td class = "description" > Decode/decompress data?< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Stream or < code > NULL< / code > on error< / p >
< h3 class = "function" > < a id = "pdfioPageCopy" > pdfioPageCopy< / a > < / h3 >
< p class = "description" > Copy a page to a PDF file.< / p >
< p class = "code" >
bool pdfioPageCopy(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, < a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *srcpage);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > srcpage< / th >
< td class = "description" > Source page< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > < code > true< / code > on success, < code > false< / code > on failure< / p >
2021-06-07 14:34:30 +02:00
< h3 class = "function" > < a id = "pdfioPageDictAddColorSpace" > pdfioPageDictAddColorSpace< / a > < / h3 >
< p class = "description" > Add a color space to the page dictionary.< / p >
2021-05-30 03:21:45 +02:00
< p class = "code" >
2021-06-07 14:34:30 +02:00
bool pdfioPageDictAddColorSpace(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *name, < a href = "#pdfio_array_t" > pdfio_array_t< / a > *data);< / p >
2021-05-30 03:21:45 +02:00
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Page dictionary< / td > < / tr >
< tr > < th > name< / th >
< td class = "description" > Color space name< / td > < / tr >
2021-06-07 14:34:30 +02:00
< tr > < th > data< / th >
< td class = "description" > Color space array< / td > < / tr >
2021-05-30 03:21:45 +02:00
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > < code > true< / code > on success, < code > false< / code > on failure< / p >
2021-06-07 14:34:30 +02:00
< h4 class = "discussion" > Discussion< / h4 >
< p class = "discussion" > This function adds a named color space to the page dictionary.< br >
< br >
The names " DefaultCMYK" , " DefaultGray" , and " DefaultRGB" specify the default
device color space used for the page.< br >
< br >
The " data" array contains a calibrated, indexed, or ICC-based color space
array that was created using the
< a href = "#pdfioArrayCreateCalibratedColorFromMatrix" > < code > pdfioArrayCreateCalibratedColorFromMatrix< / code > < / a > ,
< a href = "#pdfioArrayCreateCalibratedColorFromPrimaries" > < code > pdfioArrayCreateCalibratedColorFromPrimaries< / code > < / a > ,
< a href = "#pdfioArrayCreateICCBasedColor" > < code > pdfioArrayCreateICCBasedColor< / code > < / a > , or
< a href = "#pdfioArrayCreateIndexedColor" > < code > pdfioArrayCreateIndexedColor< / code > < / a > functions.< / p >
2021-05-30 03:21:45 +02:00
< h3 class = "function" > < a id = "pdfioPageDictAddFont" > pdfioPageDictAddFont< / a > < / h3 >
< p class = "description" > Add a font object to the page dictionary.< / p >
< p class = "code" >
bool pdfioPageDictAddFont(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *name, < a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Page dictionary< / td > < / tr >
< tr > < th > name< / th >
< td class = "description" > Font name< / td > < / tr >
< tr > < th > obj< / th >
< td class = "description" > Font object< / td > < / tr >
< / 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 = "pdfioPageDictAddImage" > pdfioPageDictAddImage< / a > < / h3 >
< p class = "description" > Add an image object to the page dictionary.< / p >
< p class = "code" >
bool pdfioPageDictAddImage(< a href = "#pdfio_dict_t" > pdfio_dict_t< / a > *dict, const char *name, < a href = "#pdfio_obj_t" > pdfio_obj_t< / a > *obj);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > dict< / th >
< td class = "description" > Page dictionary< / td > < / tr >
< tr > < th > name< / th >
< td class = "description" > Image name< / td > < / tr >
< tr > < th > obj< / th >
< td class = "description" > Image object< / td > < / tr >
< / 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 = "pdfioStreamClose" > pdfioStreamClose< / a > < / h3 >
< p class = "description" > Close a (data) stream in a PDF file.< / p >
< p class = "code" >
bool pdfioStreamClose(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< / 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 = "pdfioStreamConsume" > pdfioStreamConsume< / a > < / h3 >
< p class = "description" > Consume bytes from the stream.< / p >
< p class = "code" >
bool pdfioStreamConsume(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, size_t bytes);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > bytes< / th >
< td class = "description" > Number of bytes to consume< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > < code > true< / code > on success, < code > false< / code > on EOF< / p >
< h3 class = "function" > < a id = "pdfioStreamGetToken" > pdfioStreamGetToken< / a > < / h3 >
< p class = "description" > Read a single PDF token from a stream.< / p >
< p class = "code" >
bool pdfioStreamGetToken(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, char *buffer, size_t bufsize);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > buffer< / th >
< td class = "description" > String buffer< / td > < / tr >
< tr > < th > bufsize< / th >
< td class = "description" > Size of string buffer< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > < code > true< / code > on success, < code > false< / code > on EOF< / p >
< h3 class = "function" > < a id = "pdfioStreamPeek" > pdfioStreamPeek< / a > < / h3 >
< p class = "description" > Peek at data in a stream.< / p >
< p class = "code" >
ssize_t pdfioStreamPeek(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, void *buffer, size_t bytes);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > buffer< / th >
< td class = "description" > Buffer< / td > < / tr >
< tr > < th > bytes< / th >
< td class = "description" > Size of buffer< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Bytes returned or < code > -1< / code > on error< / p >
< h3 class = "function" > < a id = "pdfioStreamPrintf" > pdfioStreamPrintf< / a > < / h3 >
< p class = "description" > Write a formatted string to a stream.< / p >
< p class = "code" >
bool pdfioStreamPrintf(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, 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 > 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 >
< h3 class = "function" > < a id = "pdfioStreamPuts" > pdfioStreamPuts< / a > < / h3 >
< p class = "description" > Write a literal string to a stream.< / p >
< p class = "code" >
bool pdfioStreamPuts(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, 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 > s< / th >
< td class = "description" > Literal string< / td > < / tr >
< / 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 = "pdfioStreamRead" > pdfioStreamRead< / a > < / h3 >
< p class = "description" > Read data from a stream.< / p >
< p class = "code" >
ssize_t pdfioStreamRead(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, void *buffer, size_t bytes);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > buffer< / th >
< td class = "description" > Buffer< / td > < / tr >
< tr > < th > bytes< / th >
< td class = "description" > Bytes to read< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Number of bytes read or < code > -1< / code > on error< / p >
2021-06-07 14:34:30 +02:00
< h4 class = "discussion" > Discussion< / h4 >
< p class = "discussion" > This function reads data from a stream. When reading decoded image data
from a stream, you < em > must< / em > read whole scanlines. The
< a href = "#pdfioImageGetBytesPerLine" > < code > pdfioImageGetBytesPerLine< / code > < / a > function can be used to determine the
proper read length.< / p >
2021-05-30 03:21:45 +02:00
< h3 class = "function" > < a id = "pdfioStreamWrite" > pdfioStreamWrite< / a > < / h3 >
< p class = "description" > Write data to a stream.< / p >
< p class = "code" >
bool pdfioStreamWrite(< a href = "#pdfio_stream_t" > pdfio_stream_t< / a > *st, const void *buffer, size_t bytes);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > st< / th >
< td class = "description" > Stream< / td > < / tr >
< tr > < th > buffer< / th >
< td class = "description" > Data to write< / td > < / tr >
< tr > < th > bytes< / th >
< td class = "description" > Number of bytes to write< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > < code > true< / code > on success or < code > false< / code > on failure< / p >
< h3 class = "function" > < a id = "pdfioStringCreate" > pdfioStringCreate< / a > < / h3 >
< p class = "description" > Create a durable literal string.< / p >
< p class = "code" >
char *pdfioStringCreate(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, const char *s);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > s< / th >
< td class = "description" > Nul-terminated string< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Durable string pointer or < code > NULL< / code > on error< / p >
< h4 class = "discussion" > Discussion< / h4 >
< p class = "discussion" > This function creates a literal string associated with the PDF file
" pwg" . The " s" string points to a nul-terminated C string.< br >
< br >
< code > NULL< / code > is returned on error, otherwise a < code > char *< / code > that is valid until
< code > pdfioFileClose< / code > is called.< / p >
< h3 class = "function" > < a id = "pdfioStringCreatef" > pdfioStringCreatef< / a > < / h3 >
< p class = "description" > Create a durable formatted string.< / p >
< p class = "code" >
char *pdfioStringCreatef(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, const char *format, ...);< / p >
< h4 class = "parameters" > Parameters< / h4 >
< table class = "list" > < tbody >
< tr > < th > pdf< / th >
< td class = "description" > PDF file< / td > < / tr >
< tr > < th > format< / th >
< td class = "description" > < code > printf< / code > -style format string< / td > < / tr >
< tr > < th > ...< / th >
< td class = "description" > Additional args as needed< / td > < / tr >
< / tbody > < / table >
< h4 class = "returnvalue" > Return Value< / h4 >
< p class = "description" > Durable string pointer or < code > NULL< / code > on error< / p >
< h4 class = "discussion" > Discussion< / h4 >
< p class = "discussion" > This function creates a formatted string associated with the PDF file
" pwg" . The " format" string contains < code > printf< / code > -style format characters.< br >
< br >
< code > NULL< / code > is returned on error, otherwise a < code > char *< / code > that is valid until
< code > pdfioFileClose< / code > is called.< / p >
< h2 class = "title" > < a id = "TYPES" > Data Types< / a > < / h2 >
< h3 class = "typedef" > < a id = "pdf_value_t" > pdf_value_t< / a > < / h3 >
< p class = "description" > PDF value of any type< / p >
< p class = "code" >
typedef struct _pdfio_value_s pdf_value_t;
< / p >
< h3 class = "typedef" > < a id = "pdfio_array_t" > pdfio_array_t< / a > < / h3 >
< p class = "description" > Array of PDF values< / p >
< p class = "code" >
typedef struct _pdfio_array_s pdfio_array_t;
< / p >
< h3 class = "typedef" > < a id = "pdfio_dict_t" > pdfio_dict_t< / a > < / h3 >
< p class = "description" > Key/value dictionary< / p >
< p class = "code" >
typedef struct _pdfio_dict_s pdfio_dict_t;
< / p >
< h3 class = "typedef" > < a id = "pdfio_error_cb_t" > pdfio_error_cb_t< / a > < / h3 >
< p class = "description" > Error callback< / p >
< p class = "code" >
typedef bool (*pdfio_error_cb_t)(< a href = "#pdfio_file_t" > pdfio_file_t< / a > *pdf, const char *message, void *data);
< / p >
< h3 class = "typedef" > < a id = "pdfio_file_t" > pdfio_file_t< / a > < / h3 >
< p class = "description" > PDF file< / p >
< p class = "code" >
typedef struct _pdfio_file_s pdfio_file_t;
< / p >
< h3 class = "typedef" > < a id = "pdfio_filter_t" > pdfio_filter_t< / a > < / h3 >
< p class = "description" > Compression/decompression filters for streams< / p >
< p class = "code" >
typedef enum < a href = "#pdfio_filter_e" > pdfio_filter_e< / a > pdfio_filter_t;
< / p >
< h3 class = "typedef" > < a id = "pdfio_obj_t" > pdfio_obj_t< / a > < / h3 >
< p class = "description" > Numbered object in PDF file< / p >
< p class = "code" >
typedef struct _pdfio_obj_s pdfio_obj_t;
< / p >
< h3 class = "typedef" > < a id = "pdfio_rect_t" > pdfio_rect_t< / a > < / h3 >
< p class = "description" > PDF rectangle< / p >
< p class = "code" >
typedef struct < a href = "#pdfio_rect_s" > pdfio_rect_s< / a > pdfio_rect_t;
< / p >
< h3 class = "typedef" > < a id = "pdfio_stream_t" > pdfio_stream_t< / a > < / h3 >
< p class = "description" > Object data stream in PDF file< / p >
< p class = "code" >
typedef struct _pdfio_stream_s pdfio_stream_t;
< / p >
< h3 class = "typedef" > < a id = "pdfio_valtype_t" > pdfio_valtype_t< / a > < / h3 >
< p class = "description" > PDF value types< / p >
< p class = "code" >
typedef enum < a href = "#pdfio_valtype_e" > pdfio_valtype_e< / a > pdfio_valtype_t;
< / p >
< h2 class = "title" > < a id = "STRUCTURES" > Structures< / a > < / h2 >
< h3 class = "struct" > < a id = "pdfio_rect_s" > pdfio_rect_s< / a > < / h3 >
< p class = "description" > PDF rectangle< / p >
< p class = "code" > struct pdfio_rect_s {< br >
        double x1;< br >
        double x2;< br >
        double y1;< br >
        double y2;< br >
};< / p >
< h4 class = "members" > Members< / h4 >
< table class = "list" > < tbody >
< tr > < th > x1 < / th >
< td class = "description" > Lower-left X coordinate< / td > < / tr >
< tr > < th > x2 < / th >
< td class = "description" > Upper-right X coordinate< / td > < / tr >
< tr > < th > y1 < / th >
< td class = "description" > Lower-left Y coordinate< / td > < / tr >
< tr > < th > y2 < / th >
< td class = "description" > Upper-right Y coordinate< / td > < / tr >
< / tbody > < / table >
< h2 class = "title" > < a id = "ENUMERATIONS" > Constants< / a > < / h2 >
< h3 class = "enumeration" > < a id = "pdfio_filter_e" > pdfio_filter_e< / a > < / h3 >
< p class = "description" > Compression/decompression filters for streams< / p >
< h4 class = "constants" > Constants< / h4 >
< table class = "list" > < tbody >
< tr > < th > PDFIO_FILTER_ASCII85 < / th > < td class = "description" > ASCII85Decode filter (reading only)< / td > < / tr >
< tr > < th > PDFIO_FILTER_ASCIIHEX < / th > < td class = "description" > ASCIIHexDecode filter (reading only)< / td > < / tr >
< tr > < th > PDFIO_FILTER_CCITTFAX < / th > < td class = "description" > CCITTFaxDecode filter< / td > < / tr >
< tr > < th > PDFIO_FILTER_CRYPT < / th > < td class = "description" > Encryption filter< / td > < / tr >
< tr > < th > PDFIO_FILTER_DCT < / th > < td class = "description" > DCTDecode (JPEG) filter< / td > < / tr >
< tr > < th > PDFIO_FILTER_FLATE < / th > < td class = "description" > FlateDecode filter< / td > < / tr >
< tr > < th > PDFIO_FILTER_JBIG2 < / th > < td class = "description" > JBIG2Decode filter< / td > < / tr >
< tr > < th > PDFIO_FILTER_JPX < / th > < td class = "description" > JPXDecode filter (reading only)< / td > < / tr >
< tr > < th > PDFIO_FILTER_LZW < / th > < td class = "description" > LZWDecode filter (reading only)< / td > < / tr >
< tr > < th > PDFIO_FILTER_NONE < / th > < td class = "description" > No filter< / td > < / tr >
< tr > < th > PDFIO_FILTER_RUNLENGTH < / th > < td class = "description" > RunLengthDecode filter (reading only)< / td > < / tr >
< / tbody > < / table >
< h3 class = "enumeration" > < a id = "pdfio_valtype_e" > pdfio_valtype_e< / a > < / h3 >
< p class = "description" > PDF value types< / p >
< h4 class = "constants" > Constants< / h4 >
< table class = "list" > < tbody >
< tr > < th > PDFIO_VALTYPE_ARRAY < / th > < td class = "description" > Array< / td > < / tr >
< tr > < th > PDFIO_VALTYPE_BINARY < / th > < td class = "description" > Binary data< / td > < / tr >
< tr > < th > PDFIO_VALTYPE_BOOLEAN < / th > < td class = "description" > Boolean< / td > < / tr >
< tr > < th > PDFIO_VALTYPE_DATE < / th > < td class = "description" > Date/time< / td > < / tr >
< tr > < th > PDFIO_VALTYPE_DICT < / th > < td class = "description" > Dictionary< / td > < / tr >
< tr > < th > PDFIO_VALTYPE_INDIRECT < / th > < td class = "description" > Indirect object (N G obj)< / td > < / tr >
< tr > < th > PDFIO_VALTYPE_NAME < / th > < td class = "description" > Name< / td > < / tr >
< tr > < th > PDFIO_VALTYPE_NONE < / th > < td class = "description" > No value, not set< / td > < / tr >
< tr > < th > PDFIO_VALTYPE_NULL < / th > < td class = "description" > Null object< / td > < / tr >
< tr > < th > PDFIO_VALTYPE_NUMBER < / th > < td class = "description" > Number (integer or real)< / td > < / tr >
< tr > < th > PDFIO_VALTYPE_STRING < / th > < td class = "description" > String< / td > < / tr >
< / tbody > < / table >
< / div >
< / body >
< / html >