From e882f9ab729acfcf9901c4e0de941923508973cc Mon Sep 17 00:00:00 2001 From: Gina Peter Banyard Date: Mon, 26 Jan 2026 14:23:15 +0000 Subject: [PATCH 1/2] ps: fix XML to remove useless wrapping para tags via script --- reference/ps/functions/ps-add-bookmark.xml | 92 ++- reference/ps/functions/ps-add-launchlink.xml | 120 ++-- reference/ps/functions/ps-add-locallink.xml | 142 +++-- reference/ps/functions/ps-add-note.xml | 180 +++--- reference/ps/functions/ps-add-pdflink.xml | 160 +++--- reference/ps/functions/ps-add-weblink.xml | 124 ++--- reference/ps/functions/ps-arc.xml | 116 ++-- reference/ps/functions/ps-arcn.xml | 116 ++-- reference/ps/functions/ps-begin-page.xml | 72 ++- reference/ps/functions/ps-begin-pattern.xml | 136 +++-- reference/ps/functions/ps-begin-template.xml | 80 ++- reference/ps/functions/ps-circle.xml | 86 ++- reference/ps/functions/ps-clip.xml | 36 +- reference/ps/functions/ps-close-image.xml | 58 +- reference/ps/functions/ps-close.xml | 38 +- .../ps/functions/ps-closepath-stroke.xml | 36 +- reference/ps/functions/ps-closepath.xml | 38 +- reference/ps/functions/ps-continue-text.xml | 56 +- reference/ps/functions/ps-curveto.xml | 132 +++-- reference/ps/functions/ps-delete.xml | 36 +- reference/ps/functions/ps-end-page.xml | 36 +- reference/ps/functions/ps-end-pattern.xml | 36 +- reference/ps/functions/ps-end-template.xml | 36 +- reference/ps/functions/ps-fill-stroke.xml | 40 +- reference/ps/functions/ps-fill.xml | 38 +- reference/ps/functions/ps-findfont.xml | 116 ++-- reference/ps/functions/ps-get-buffer.xml | 36 +- reference/ps/functions/ps-get-parameter.xml | 286 +++++----- reference/ps/functions/ps-get-value.xml | 526 +++++++++--------- reference/ps/functions/ps-hyphenate.xml | 80 ++- reference/ps/functions/ps-include-file.xml | 42 +- reference/ps/functions/ps-lineto.xml | 80 ++- reference/ps/functions/ps-makespotcolor.xml | 72 ++- reference/ps/functions/ps-moveto.xml | 68 ++- reference/ps/functions/ps-new.xml | 14 +- reference/ps/functions/ps-open-file.xml | 56 +- reference/ps/functions/ps-open-image-file.xml | 106 ++-- reference/ps/functions/ps-open-image.xml | 187 +++---- .../ps/functions/ps-open-memory-image.xml | 42 +- reference/ps/functions/ps-place-image.xml | 110 ++-- reference/ps/functions/ps-rect.xml | 104 ++-- reference/ps/functions/ps-restore.xml | 36 +- reference/ps/functions/ps-rotate.xml | 100 ++-- reference/ps/functions/ps-save.xml | 36 +- reference/ps/functions/ps-scale.xml | 70 ++- .../ps/functions/ps-set-border-color.xml | 86 ++- reference/ps/functions/ps-set-border-dash.xml | 70 ++- .../ps/functions/ps-set-border-style.xml | 72 ++- reference/ps/functions/ps-set-info.xml | 102 ++-- reference/ps/functions/ps-set-parameter.xml | 70 ++- reference/ps/functions/ps-set-text-pos.xml | 82 ++- reference/ps/functions/ps-set-value.xml | 154 +++-- reference/ps/functions/ps-setcolor.xml | 145 +++-- reference/ps/functions/ps-setdash.xml | 68 ++- reference/ps/functions/ps-setflat.xml | 44 +- reference/ps/functions/ps-setfont.xml | 70 ++- reference/ps/functions/ps-setgray.xml | 54 +- reference/ps/functions/ps-setlinecap.xml | 64 +-- reference/ps/functions/ps-setlinejoin.xml | 62 +-- reference/ps/functions/ps-setlinewidth.xml | 56 +- reference/ps/functions/ps-setmiterlimit.xml | 60 +- .../ps/functions/ps-setoverprintmode.xml | 42 +- reference/ps/functions/ps-setpolydash.xml | 74 ++- reference/ps/functions/ps-shading-pattern.xml | 72 ++- reference/ps/functions/ps-shading.xml | 124 ++--- reference/ps/functions/ps-shfill.xml | 56 +- reference/ps/functions/ps-show-boxed.xml | 158 +++--- reference/ps/functions/ps-show-xy.xml | 86 ++- reference/ps/functions/ps-show.xml | 60 +- reference/ps/functions/ps-show2.xml | 60 +- reference/ps/functions/ps-string-geometry.xml | 90 ++- reference/ps/functions/ps-stringwidth.xml | 90 ++- reference/ps/functions/ps-stroke.xml | 40 +- reference/ps/functions/ps-symbol-name.xml | 74 ++- reference/ps/functions/ps-symbol-width.xml | 90 ++- reference/ps/functions/ps-symbol.xml | 54 +- reference/ps/functions/ps-translate.xml | 108 ++-- 77 files changed, 3137 insertions(+), 3607 deletions(-) diff --git a/reference/ps/functions/ps-add-bookmark.xml b/reference/ps/functions/ps-add-bookmark.xml index 8ef8002e22a1..4c829f0be4b7 100644 --- a/reference/ps/functions/ps-add-bookmark.xml +++ b/reference/ps/functions/ps-add-bookmark.xml @@ -1,7 +1,7 @@ - + ps_add_bookmark Add bookmark to current page @@ -26,45 +26,43 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - text - - - The text used for displaying the bookmark. - - - - - parent - - - A bookmark previously created by this function which - is used as the parent of the new bookmark. - - - - - open - - - If open is unequal to zero the bookmark will - be shown open by the pdf viewer. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + text + + + The text used for displaying the bookmark. + + + + + parent + + + A bookmark previously created by this function which + is used as the parent of the new bookmark. + + + + + open + + + If open is unequal to zero the bookmark will + be shown open by the pdf viewer. + + + + @@ -79,16 +77,13 @@ &reftitle.seealso; - - - ps_add_launchlink - ps_add_pdflink - ps_add_weblink - - + + ps_add_launchlink + ps_add_pdflink + ps_add_weblink + - - diff --git a/reference/ps/functions/ps-add-launchlink.xml b/reference/ps/functions/ps-add-launchlink.xml index ff860b67f92a..8769b88960a3 100644 --- a/reference/ps/functions/ps-add-launchlink.xml +++ b/reference/ps/functions/ps-add-launchlink.xml @@ -1,7 +1,7 @@ - + ps_add_launchlink Adds link which launches file @@ -30,59 +30,57 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - llx - - - The x-coordinate of the lower left corner. - - - - - lly - - - The y-coordinate of the lower left corner. - - - - - urx - - - The x-coordinate of the upper right corner. - - - - - ury - - - The y-coordinate of the upper right corner. - - - - - filename - - - The path of the program to be started, when the link is clicked on. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + llx + + + The x-coordinate of the lower left corner. + + + + + lly + + + The y-coordinate of the lower left corner. + + + + + urx + + + The x-coordinate of the upper right corner. + + + + + ury + + + The y-coordinate of the upper right corner. + + + + + filename + + + The path of the program to be started, when the link is clicked on. + + + + @@ -94,16 +92,13 @@ &reftitle.seealso; - - - ps_add_locallink - ps_add_pdflink - ps_add_weblink - - + + ps_add_locallink + ps_add_pdflink + ps_add_weblink + - - diff --git a/reference/ps/functions/ps-add-locallink.xml b/reference/ps/functions/ps-add-locallink.xml index 99ca817bd315..be9b20b0ccb8 100644 --- a/reference/ps/functions/ps-add-locallink.xml +++ b/reference/ps/functions/ps-add-locallink.xml @@ -1,7 +1,7 @@ - + ps_add_locallink Adds link to a page in the same document @@ -35,70 +35,68 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - llx - - - The x-coordinate of the lower left corner. - - - - - lly - - - The y-coordinate of the lower left corner. - - - - - urx - - - The x-coordinate of the upper right corner. - - - - - ury - - - The y-coordinate of the upper right corner. - - - - - page - - - The number of the page displayed when clicking on the link. - - - - - dest - - - The parameter dest determines how the document - is being viewed. It can be fitpage, - fitwidth, fitheight, or - fitbbox. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + llx + + + The x-coordinate of the lower left corner. + + + + + lly + + + The y-coordinate of the lower left corner. + + + + + urx + + + The x-coordinate of the upper right corner. + + + + + ury + + + The y-coordinate of the upper right corner. + + + + + page + + + The number of the page displayed when clicking on the link. + + + + + dest + + + The parameter dest determines how the document + is being viewed. It can be fitpage, + fitwidth, fitheight, or + fitbbox. + + + + @@ -110,16 +108,13 @@ &reftitle.seealso; - - - ps_add_launchlink - ps_add_pdflink - ps_add_weblink - - + + ps_add_launchlink + ps_add_pdflink + ps_add_weblink + - - diff --git a/reference/ps/functions/ps-add-note.xml b/reference/ps/functions/ps-add-note.xml index 36d345428afd..f6bada5cbcdd 100644 --- a/reference/ps/functions/ps-add-note.xml +++ b/reference/ps/functions/ps-add-note.xml @@ -1,7 +1,7 @@ - + ps_add_note Adds note to current page @@ -33,88 +33,86 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - llx - - - The x-coordinate of the lower left corner. - - - - - lly - - - The y-coordinate of the lower left corner. - - - - - urx - - - The x-coordinate of the upper right corner. - - - - - ury - - - The y-coordinate of the upper right corner. - - - - - contents - - - The text of the note. - - - - - title - - - The title of the note as displayed in the header of the note. - - - - - icon - - - The icon shown if the note is folded. This parameter can be set - to comment, insert, - note, paragraph, - newparagraph, key, or - help. - - - - - open - - - If open is unequal to zero the note will - be shown unfolded after opening the document with a pdf viewer. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + llx + + + The x-coordinate of the lower left corner. + + + + + lly + + + The y-coordinate of the lower left corner. + + + + + urx + + + The x-coordinate of the upper right corner. + + + + + ury + + + The y-coordinate of the upper right corner. + + + + + contents + + + The text of the note. + + + + + title + + + The title of the note as displayed in the header of the note. + + + + + icon + + + The icon shown if the note is folded. This parameter can be set + to comment, insert, + note, paragraph, + newparagraph, key, or + help. + + + + + open + + + If open is unequal to zero the note will + be shown unfolded after opening the document with a pdf viewer. + + + + @@ -126,17 +124,14 @@ &reftitle.seealso; - - - ps_add_pdflink - ps_add_launchlink - ps_add_locallink - ps_add_weblink - - + + ps_add_pdflink + ps_add_launchlink + ps_add_locallink + ps_add_weblink + - - diff --git a/reference/ps/functions/ps-add-pdflink.xml b/reference/ps/functions/ps-add-pdflink.xml index c5243bf37a5c..3be415ab3d72 100644 --- a/reference/ps/functions/ps-add-pdflink.xml +++ b/reference/ps/functions/ps-add-pdflink.xml @@ -1,7 +1,7 @@ - + ps_add_pdflink Adds link to a page in a second pdf document @@ -36,79 +36,77 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - llx - - - The x-coordinate of the lower left corner. - - - - - lly - - - The y-coordinate of the lower left corner. - - - - - urx - - - The x-coordinate of the upper right corner. - - - - - ury - - - The y-coordinate of the upper right corner. - - - - - filename - - - The name of the pdf document to be opened when clicking on - this link. - - - - - page - - - The page number of the destination pdf document - - - - - dest - - - The parameter dest determines how the document - is being viewed. It can be fitpage, - fitwidth, fitheight, or - fitbbox. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + llx + + + The x-coordinate of the lower left corner. + + + + + lly + + + The y-coordinate of the lower left corner. + + + + + urx + + + The x-coordinate of the upper right corner. + + + + + ury + + + The y-coordinate of the upper right corner. + + + + + filename + + + The name of the pdf document to be opened when clicking on + this link. + + + + + page + + + The page number of the destination pdf document + + + + + dest + + + The parameter dest determines how the document + is being viewed. It can be fitpage, + fitwidth, fitheight, or + fitbbox. + + + + @@ -120,16 +118,13 @@ &reftitle.seealso; - - - ps_add_launchlink - ps_add_locallink - ps_add_weblink - - + + ps_add_launchlink + ps_add_locallink + ps_add_weblink + - - diff --git a/reference/ps/functions/ps-add-weblink.xml b/reference/ps/functions/ps-add-weblink.xml index 16078990f7ba..4b38e7d53d35 100644 --- a/reference/ps/functions/ps-add-weblink.xml +++ b/reference/ps/functions/ps-add-weblink.xml @@ -1,7 +1,7 @@ - + ps_add_weblink Adds link to a web location @@ -19,7 +19,7 @@ stringurl - Places a hyperlink at the given position pointing to a web page. The + Places a hyperlink at the given position pointing to a web page. The hyperlink's source position is a rectangle with its lower left corner at (llx, lly) and its upper right corner at (urx, @@ -31,60 +31,58 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - llx - - - The x-coordinate of the lower left corner. - - - - - lly - - - The y-coordinate of the lower left corner. - - - - - urx - - - The x-coordinate of the upper right corner. - - - - - ury - - - The y-coordinate of the upper right corner. - - - - - url - - - The url of the hyperlink to be opened when clicking on - this link, e.g. http://www.php.net. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + llx + + + The x-coordinate of the lower left corner. + + + + + lly + + + The y-coordinate of the lower left corner. + + + + + urx + + + The x-coordinate of the upper right corner. + + + + + ury + + + The y-coordinate of the upper right corner. + + + + + url + + + The url of the hyperlink to be opened when clicking on + this link, e.g. http://www.php.net. + + + + @@ -96,16 +94,13 @@ &reftitle.seealso; - - - ps_add_launchlink - ps_add_locallink - ps_add_pdflink - - + + ps_add_launchlink + ps_add_locallink + ps_add_pdflink + - - diff --git a/reference/ps/functions/ps-arc.xml b/reference/ps/functions/ps-arc.xml index 0d0bc013af1e..1c936e4fa922 100644 --- a/reference/ps/functions/ps-arc.xml +++ b/reference/ps/functions/ps-arc.xml @@ -1,7 +1,7 @@ - + ps_arc Draws an arc counterclockwise @@ -31,59 +31,57 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - x - - - The x-coordinate of the circle's middle point. - - - - - y - - - The y-coordinate of the circle's middle point. - - - - - radius - - - The radius of the circle - - - - - alpha - - - The start angle given in degrees. - - - - - beta - - - The end angle given in degrees. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + x + + + The x-coordinate of the circle's middle point. + + + + + y + + + The y-coordinate of the circle's middle point. + + + + + radius + + + The radius of the circle + + + + + alpha + + + The start angle given in degrees. + + + + + beta + + + The end angle given in degrees. + + + + @@ -95,14 +93,11 @@ &reftitle.seealso; - - - ps_arcn - - + + ps_arcn + - - diff --git a/reference/ps/functions/ps-arcn.xml b/reference/ps/functions/ps-arcn.xml index 0a6e8346713f..2653fa98b823 100644 --- a/reference/ps/functions/ps-arcn.xml +++ b/reference/ps/functions/ps-arcn.xml @@ -1,7 +1,7 @@ - + ps_arcn Draws an arc clockwise @@ -31,59 +31,57 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - x - - - The x-coordinate of the circle's middle point. - - - - - y - - - The y-coordinate of the circle's middle point. - - - - - radius - - - The radius of the circle - - - - - alpha - - - The starting angle given in degrees. - - - - - beta - - - The end angle given in degrees. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + x + + + The x-coordinate of the circle's middle point. + + + + + y + + + The y-coordinate of the circle's middle point. + + + + + radius + + + The radius of the circle + + + + + alpha + + + The starting angle given in degrees. + + + + + beta + + + The end angle given in degrees. + + + + @@ -95,14 +93,11 @@ &reftitle.seealso; - - - ps_arc - - + + ps_arc + - - diff --git a/reference/ps/functions/ps-begin-page.xml b/reference/ps/functions/ps-begin-page.xml index 084c18edf18d..737a705dc654 100644 --- a/reference/ps/functions/ps-begin-page.xml +++ b/reference/ps/functions/ps-begin-page.xml @@ -1,7 +1,7 @@ - + ps_begin_page Start a new page @@ -64,35 +64,33 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - width - - - The width of the page in pixel, e.g. 596 for A4 format. - - - - - height - - - The height of the page in pixel, e.g. 842 for A4 format. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + width + + + The width of the page in pixel, e.g. 596 for A4 format. + + + + + height + + + The height of the page in pixel, e.g. 842 for A4 format. + + + + @@ -104,16 +102,13 @@ &reftitle.seealso; - - - ps_end_page - ps_findfont - ps_set_info - - + + ps_end_page + ps_findfont + ps_set_info + - - diff --git a/reference/ps/functions/ps-begin-pattern.xml b/reference/ps/functions/ps-begin-pattern.xml index 15d85e9f9d78..fd4097077eb5 100644 --- a/reference/ps/functions/ps-begin-pattern.xml +++ b/reference/ps/functions/ps-begin-pattern.xml @@ -1,7 +1,7 @@ - + ps_begin_pattern Start a new pattern @@ -28,61 +28,59 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - width - - - The width of the pattern in pixel. - - - - - height - - - The height of the pattern in pixel. - - - - - x-step - - - The distance in pixel of placements of the pattern in - horizontal direction. - - - - - y-step - - - The distance in pixel of placements of the pattern in - vertical direction. - - - - - painttype - - - Must be 1 or 2. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + width + + + The width of the pattern in pixel. + + + + + height + + + The height of the pattern in pixel. + + + + + x-step + + + The distance in pixel of placements of the pattern in + horizontal direction. + + + + + y-step + + + The distance in pixel of placements of the pattern in + vertical direction. + + + + + painttype + + + Must be 1 or 2. + + + + @@ -94,10 +92,9 @@ &reftitle.examples; - - - Creating and using a pattern - + + Creating and using a pattern + ]]> - - - + + &reftitle.seealso; - - - ps_end_pattern - ps_setcolor - ps_shading_pattern - - + + ps_end_pattern + ps_setcolor + ps_shading_pattern + - - diff --git a/reference/ps/functions/ps-begin-template.xml b/reference/ps/functions/ps-begin-template.xml index b131a6767321..b364dd45e8f1 100644 --- a/reference/ps/functions/ps-begin-template.xml +++ b/reference/ps/functions/ps-begin-template.xml @@ -1,7 +1,7 @@ - + ps_begin_template Start a new template @@ -27,35 +27,33 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - width - - - The width of the template in pixel. - - - - - height - - - The height of the template in pixel. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + width + + + The width of the template in pixel. + + + + + height + + + The height of the template in pixel. + + + + @@ -67,10 +65,9 @@ &reftitle.examples; - - - Creating and using a template - + + Creating and using a template + ]]> - - - + + &reftitle.seealso; - - - ps_end_template - - + + ps_end_template + - - diff --git a/reference/ps/functions/ps-circle.xml b/reference/ps/functions/ps-circle.xml index 530ba9a240a2..605da8bb27f5 100644 --- a/reference/ps/functions/ps-circle.xml +++ b/reference/ps/functions/ps-circle.xml @@ -1,7 +1,7 @@ - + ps_circle Draws a circle @@ -30,43 +30,41 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - x - - - The x-coordinate of the circle's middle point. - - - - - y - - - The y-coordinate of the circle's middle point. - - - - - radius - - - The radius of the circle - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + x + + + The x-coordinate of the circle's middle point. + + + + + y + + + The y-coordinate of the circle's middle point. + + + + + radius + + + The radius of the circle + + + + @@ -78,15 +76,12 @@ &reftitle.seealso; - - - ps_arc - ps_arcn - - + + ps_arc + ps_arcn + - - diff --git a/reference/ps/functions/ps-clip.xml b/reference/ps/functions/ps-clip.xml index 5d293e96db11..f17f3bbe2ece 100644 --- a/reference/ps/functions/ps-clip.xml +++ b/reference/ps/functions/ps-clip.xml @@ -1,7 +1,7 @@ - + ps_clip Clips drawing to current path @@ -21,19 +21,17 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + @@ -45,14 +43,11 @@ &reftitle.seealso; - - - ps_closepath - - + + ps_closepath + - - diff --git a/reference/ps/functions/ps-close-image.xml b/reference/ps/functions/ps-close-image.xml index 608452b68383..29fefb975505 100644 --- a/reference/ps/functions/ps-close-image.xml +++ b/reference/ps/functions/ps-close-image.xml @@ -1,7 +1,7 @@ - + ps_close_image Closes image and frees memory @@ -22,29 +22,27 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - imageid - - - Resource identifier of the image as returned by - ps_open_image or - ps_open_image_file. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + imageid + + + Resource identifier of the image as returned by + ps_open_image or + ps_open_image_file. + + + + @@ -56,15 +54,12 @@ &reftitle.seealso; - - - ps_open_image - ps_open_image_file - - + + ps_open_image + ps_open_image_file + - - diff --git a/reference/ps/functions/ps-close.xml b/reference/ps/functions/ps-close.xml index b9d02100786c..823e9cd4f0c6 100644 --- a/reference/ps/functions/ps-close.xml +++ b/reference/ps/functions/ps-close.xml @@ -1,7 +1,7 @@ - + ps_close Closes a PostScript document @@ -29,19 +29,17 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + @@ -53,15 +51,12 @@ &reftitle.seealso; - - - ps_open_file - ps_delete - - + + ps_open_file + ps_delete + - - diff --git a/reference/ps/functions/ps-closepath-stroke.xml b/reference/ps/functions/ps-closepath-stroke.xml index 19d9c632222e..a05999041724 100644 --- a/reference/ps/functions/ps-closepath-stroke.xml +++ b/reference/ps/functions/ps-closepath-stroke.xml @@ -1,7 +1,7 @@ - + ps_closepath_stroke Closes and strokes path @@ -21,19 +21,17 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + @@ -45,14 +43,11 @@ &reftitle.seealso; - - - ps_closepath - - + + ps_closepath + - - diff --git a/reference/ps/functions/ps-closepath.xml b/reference/ps/functions/ps-closepath.xml index b3638daa344b..178329002e32 100644 --- a/reference/ps/functions/ps-closepath.xml +++ b/reference/ps/functions/ps-closepath.xml @@ -1,7 +1,7 @@ - + ps_closepath Closes path @@ -21,19 +21,17 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + @@ -45,15 +43,12 @@ &reftitle.seealso; - - - ps_clip - ps_closepath_stroke - - + + ps_clip + ps_closepath_stroke + - - diff --git a/reference/ps/functions/ps-continue-text.xml b/reference/ps/functions/ps-continue-text.xml index 2bf1aded0d62..9d7b1adef7f7 100644 --- a/reference/ps/functions/ps-continue-text.xml +++ b/reference/ps/functions/ps-continue-text.xml @@ -1,7 +1,7 @@ - + ps_continue_text Continue text in next line @@ -25,27 +25,25 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - text - - - The text to output. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + text + + + The text to output. + + + + @@ -57,16 +55,13 @@ &reftitle.seealso; - - - ps_show - ps_show_xy - ps_show_boxed - - + + ps_show + ps_show_xy + ps_show_boxed + - - diff --git a/reference/ps/functions/ps-curveto.xml b/reference/ps/functions/ps-curveto.xml index 453127f2702e..fb5a0fe84cc7 100644 --- a/reference/ps/functions/ps-curveto.xml +++ b/reference/ps/functions/ps-curveto.xml @@ -1,7 +1,7 @@ - + ps_curveto Draws a curve @@ -27,67 +27,65 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - x1 - - - x-coordinate of first control point. - - - - - y1 - - - y-coordinate of first control point. - - - - - x2 - - - x-coordinate of second control point. - - - - - y2 - - - y-coordinate of second control point. - - - - - x3 - - - x-coordinate of third control point. - - - - - y3 - - - y-coordinate of third control point. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + x1 + + + x-coordinate of first control point. + + + + + y1 + + + y-coordinate of first control point. + + + + + x2 + + + x-coordinate of second control point. + + + + + y2 + + + y-coordinate of second control point. + + + + + x3 + + + x-coordinate of third control point. + + + + + y3 + + + y-coordinate of third control point. + + + + @@ -99,14 +97,11 @@ &reftitle.seealso; - - - ps_lineto - - + + ps_lineto + - - diff --git a/reference/ps/functions/ps-delete.xml b/reference/ps/functions/ps-delete.xml index 40ec9eefcd74..136c654637b7 100644 --- a/reference/ps/functions/ps-delete.xml +++ b/reference/ps/functions/ps-delete.xml @@ -1,7 +1,7 @@ - + ps_delete Deletes all resources of a PostScript document @@ -25,19 +25,17 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + @@ -49,14 +47,11 @@ &reftitle.seealso; - - - ps_close - - + + ps_close + - - diff --git a/reference/ps/functions/ps-end-page.xml b/reference/ps/functions/ps-end-page.xml index 496fc9dc6e4c..c4b9280e90e8 100644 --- a/reference/ps/functions/ps-end-page.xml +++ b/reference/ps/functions/ps-end-page.xml @@ -1,7 +1,7 @@ - + ps_end_page End a page @@ -23,19 +23,17 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + @@ -47,14 +45,11 @@ &reftitle.seealso; - - - ps_begin_page - - + + ps_begin_page + - - diff --git a/reference/ps/functions/ps-end-pattern.xml b/reference/ps/functions/ps-end-pattern.xml index 6ee2ab204205..78fe161bf7fb 100644 --- a/reference/ps/functions/ps-end-pattern.xml +++ b/reference/ps/functions/ps-end-pattern.xml @@ -1,7 +1,7 @@ - + ps_end_pattern End a pattern @@ -22,19 +22,17 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + @@ -46,14 +44,11 @@ &reftitle.seealso; - - - ps_begin_pattern - - + + ps_begin_pattern + - - diff --git a/reference/ps/functions/ps-end-template.xml b/reference/ps/functions/ps-end-template.xml index 72fadedca6b7..b46b162f7595 100644 --- a/reference/ps/functions/ps-end-template.xml +++ b/reference/ps/functions/ps-end-template.xml @@ -1,7 +1,7 @@ - + ps_end_template End a template @@ -21,19 +21,17 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + @@ -45,14 +43,11 @@ &reftitle.seealso; - - - ps_begin_template - - + + ps_begin_template + - - diff --git a/reference/ps/functions/ps-fill-stroke.xml b/reference/ps/functions/ps-fill-stroke.xml index c81d44da87d8..899acf2c401d 100644 --- a/reference/ps/functions/ps-fill-stroke.xml +++ b/reference/ps/functions/ps-fill-stroke.xml @@ -1,7 +1,7 @@ - + ps_fill_stroke Fills and strokes the current path @@ -11,7 +11,7 @@ &reftitle.description; boolps_fill_stroke - resourcepsdoc + resourcepsdoc Fills and draws the path constructed with previously called drawing @@ -21,19 +21,17 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + @@ -45,15 +43,12 @@ &reftitle.seealso; - - - ps_fill - ps_stroke - - + + ps_fill + ps_stroke + - - diff --git a/reference/ps/functions/ps-fill.xml b/reference/ps/functions/ps-fill.xml index b263334d975c..aa884fdf5d22 100644 --- a/reference/ps/functions/ps-fill.xml +++ b/reference/ps/functions/ps-fill.xml @@ -1,7 +1,7 @@ - + ps_fill Fills the current path @@ -21,19 +21,17 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + @@ -45,15 +43,12 @@ &reftitle.seealso; - - - ps_fill_stroke - ps_stroke - - + + ps_fill_stroke + ps_stroke + - - diff --git a/reference/ps/functions/ps-findfont.xml b/reference/ps/functions/ps-findfont.xml index 288334c5bb07..ff01c98334db 100644 --- a/reference/ps/functions/ps-findfont.xml +++ b/reference/ps/functions/ps-findfont.xml @@ -1,7 +1,7 @@ - + ps_findfont Loads a font @@ -48,58 +48,56 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - fontname - - - The name of the font. - - - - - encoding - - - ps_findfont will try to load the file passed in - the parameter encoding. Encoding files are of - the same syntax as those used by dvips(1). They - contain a font encoding vector (which is currently not used but must be - present) and a list of extra ligatures to extend the list of ligatures - derived from the afm file. - - - encoding can be &null; or the empty string if - the default encoding (TeXBase1) shall be used. - - - If the encoding is set to builtin then there - will be no reencoding and the font specific encoding will be used. This - is very useful with symbol fonts. - - - - - embed - - - If set to a value >0 the font will be embedded into the document. This - requires the font outline (.pfb file) to be present. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + fontname + + + The name of the font. + + + + + encoding + + + ps_findfont will try to load the file passed in + the parameter encoding. Encoding files are of + the same syntax as those used by dvips(1). They + contain a font encoding vector (which is currently not used but must be + present) and a list of extra ligatures to extend the list of ligatures + derived from the afm file. + + + encoding can be &null; or the empty string if + the default encoding (TeXBase1) shall be used. + + + If the encoding is set to builtin then there + will be no reencoding and the font specific encoding will be used. This + is very useful with symbol fonts. + + + + + embed + + + If set to a value >0 the font will be embedded into the document. This + requires the font outline (.pfb file) to be present. + + + + @@ -112,15 +110,12 @@ &reftitle.seealso; - - - ps_begin_page - ps_setfont - - + + ps_begin_page + ps_setfont + - - diff --git a/reference/ps/functions/ps-get-buffer.xml b/reference/ps/functions/ps-get-buffer.xml index 1c37fb54b348..f4a2c154eb26 100644 --- a/reference/ps/functions/ps-get-buffer.xml +++ b/reference/ps/functions/ps-get-buffer.xml @@ -1,7 +1,7 @@ - + ps_get_buffer Fetches the full buffer containig the generated PS data @@ -25,31 +25,26 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + &reftitle.seealso; - - - ps_open_file - - + + ps_open_file + - - diff --git a/reference/ps/functions/ps-get-parameter.xml b/reference/ps/functions/ps-get-parameter.xml index 39cd9947fbaa..e15e86ffe831 100644 --- a/reference/ps/functions/ps-get-parameter.xml +++ b/reference/ps/functions/ps-get-parameter.xml @@ -1,7 +1,7 @@ - + ps_get_parameter Gets certain parameters @@ -25,149 +25,145 @@ The parameter name can have the following values. - - - - fontname - - - The name of the currently active font or the font whose - identifier is passed in parameter modifier. - - - - - fontencoding - - - The encoding of the currently active font. - - - - - dottedversion - - - The version of the underlying pslib library in the format - <major>.<minor>.<subminor> - - - - - scope - - - The current drawing scope. Can be object, document, null, page, - pattern, path, template, prolog, font, glyph. - - - - - ligaturedisolvechar - - - The character which dissolves a ligature. If your are using a font - which contains the ligature `ff' and `|' is the char to dissolve the - ligature, then `f|f' will result in two `f' instead of the ligature `ff'. - - - - - imageencoding - - - The encoding used for encoding images. Can be either - hex or 85. hex encoding - uses two bytes in the postscript file each byte in the image. - 85 stand for Ascii85 encoding. - - - - - linenumbermode - - - Set to paragraph if lines are numbered - within a paragraph or box if they are - numbered within the surrounding box. - - - - - linebreak - - - Only used if text is output with ps_show_boxed. - If set to &true; a carriage return will add a line - break. - - - - - parbreak - - - Only used if text is output with ps_show_boxed. - If set to &true; a carriage return will start - a new paragraph. - - - - - hyphenation - - - Only used if text is output with ps_show_boxed. - If set to &true; the paragraph will be hyphenated - if a hypen dictionary is set and exists. - - - - - hyphendict - - - Filename of the dictionary used for hyphenation pattern. - - - - - + + + fontname + + + The name of the currently active font or the font whose + identifier is passed in parameter modifier. + + + + + fontencoding + + + The encoding of the currently active font. + + + + + dottedversion + + + The version of the underlying pslib library in the format + <major>.<minor>.<subminor> + + + + + scope + + + The current drawing scope. Can be object, document, null, page, + pattern, path, template, prolog, font, glyph. + + + + + ligaturedisolvechar + + + The character which dissolves a ligature. If your are using a font + which contains the ligature `ff' and `|' is the char to dissolve the + ligature, then `f|f' will result in two `f' instead of the ligature `ff'. + + + + + imageencoding + + + The encoding used for encoding images. Can be either + hex or 85. hex encoding + uses two bytes in the postscript file each byte in the image. + 85 stand for Ascii85 encoding. + + + + + linenumbermode + + + Set to paragraph if lines are numbered + within a paragraph or box if they are + numbered within the surrounding box. + + + + + linebreak + + + Only used if text is output with ps_show_boxed. + If set to &true; a carriage return will add a line + break. + + + + + parbreak + + + Only used if text is output with ps_show_boxed. + If set to &true; a carriage return will start + a new paragraph. + + + + + hyphenation + + + Only used if text is output with ps_show_boxed. + If set to &true; the paragraph will be hyphenated + if a hypen dictionary is set and exists. + + + + + hyphendict + + + Filename of the dictionary used for hyphenation pattern. + + + + &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - name - - - Name of the parameter. - - - - - modifier - - - An identifier needed if a parameter of a resource is requested, - e.g. the size of an image. In such a case the resource id is - passed. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + name + + + Name of the parameter. + + + + + modifier + + + An identifier needed if a parameter of a resource is requested, + e.g. the size of an image. In such a case the resource id is + passed. + + + + @@ -179,14 +175,11 @@ &reftitle.seealso; - - - ps_set_parameter - - + + ps_set_parameter + - - diff --git a/reference/ps/functions/ps-get-value.xml b/reference/ps/functions/ps-get-value.xml index 798acdcb17ef..bb9b6557f747 100644 --- a/reference/ps/functions/ps-get-value.xml +++ b/reference/ps/functions/ps-get-value.xml @@ -1,7 +1,7 @@ - + ps_get_value Gets certain values @@ -21,269 +21,265 @@ The parameter name can have the following values. - - - - fontsize - - - The size of the currently active font or the font whose - identifier is passed in parameter modifier. - - - - - font - - - The currently active font itself. - - - - - imagewidth - - - The width of the image whose id is passed in the parameter - modifier. - - - - - imageheight - - - The height of the image whose id is passed in the parameter - modifier. - - - - - capheight - - - The height of a capital M in the currently active font or the font - whose identifier is passed in parameter - modifier. - - - - - ascender - - - The ascender of the currently active font or the font - whose identifier is passed in parameter - modifier. - - - - - descender - - - The descender of the currently active font or the font - whose identifier is passed in parameter - modifier. - - - - - italicangle - - - The italicangle of the currently active font or the font - whose identifier is passed in parameter - modifier. - - - - - underlineposition - - - The underlineposition of the currently active font or the font - whose identifier is passed in parameter - modifier. - - - - - underlinethickness - - - The underlinethickness of the currently active font or the font - whose identifier is passed in parameter - modifier. - - - - - textx - - - The current x-position for text output. - - - - - texty - - - The current y-position for text output. - - - - - textrendering - - - The current mode for text rendering. - - - - - textrise - - - The space by which text is risen above the base line. - - - - - leading - - - The distance between text lines in points. - - - - - wordspacing - - - The space between words as a multiple of the width of a space char. - - - - - charspacing - - - The space between chars. If charspacing is != 0.0 ligatures will - always be dissolved. - - - - - hyphenminchars - - - Minimum number of chars hyphenated at the end of a word. - - - - - parindent - - - Indention of the first n line in a paragraph. - - - - - numindentlines - - - Number of line in a paragraph to indent if parindent != 0.0. - - - - - parskip - - - Distance between paragraphs. - - - - - linenumberspace - - - Overall space in front of each line for the line number. - - - - - linenumbersep - - - Space between the line and the line number. - - - - - major - - - The major version number of pslib. - - - - - minor - - - The minor version number of pslib. - - - - - subminor, revision - - - The subminor version number of pslib. - - - - - + + + fontsize + + + The size of the currently active font or the font whose + identifier is passed in parameter modifier. + + + + + font + + + The currently active font itself. + + + + + imagewidth + + + The width of the image whose id is passed in the parameter + modifier. + + + + + imageheight + + + The height of the image whose id is passed in the parameter + modifier. + + + + + capheight + + + The height of a capital M in the currently active font or the font + whose identifier is passed in parameter + modifier. + + + + + ascender + + + The ascender of the currently active font or the font + whose identifier is passed in parameter + modifier. + + + + + descender + + + The descender of the currently active font or the font + whose identifier is passed in parameter + modifier. + + + + + italicangle + + + The italicangle of the currently active font or the font + whose identifier is passed in parameter + modifier. + + + + + underlineposition + + + The underlineposition of the currently active font or the font + whose identifier is passed in parameter + modifier. + + + + + underlinethickness + + + The underlinethickness of the currently active font or the font + whose identifier is passed in parameter + modifier. + + + + + textx + + + The current x-position for text output. + + + + + texty + + + The current y-position for text output. + + + + + textrendering + + + The current mode for text rendering. + + + + + textrise + + + The space by which text is risen above the base line. + + + + + leading + + + The distance between text lines in points. + + + + + wordspacing + + + The space between words as a multiple of the width of a space char. + + + + + charspacing + + + The space between chars. If charspacing is != 0.0 ligatures will + always be dissolved. + + + + + hyphenminchars + + + Minimum number of chars hyphenated at the end of a word. + + + + + parindent + + + Indention of the first n line in a paragraph. + + + + + numindentlines + + + Number of line in a paragraph to indent if parindent != 0.0. + + + + + parskip + + + Distance between paragraphs. + + + + + linenumberspace + + + Overall space in front of each line for the line number. + + + + + linenumbersep + + + Space between the line and the line number. + + + + + major + + + The major version number of pslib. + + + + + minor + + + The minor version number of pslib. + + + + + subminor, revision + + + The subminor version number of pslib. + + + + &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - name - - - Name of the value. - - - - - modifier - - - The parameter modifier specifies the resource - for which the value is to be retrieved. This can be the id of a font or - an image. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + name + + + Name of the value. + + + + + modifier + + + The parameter modifier specifies the resource + for which the value is to be retrieved. This can be the id of a font or + an image. + + + + @@ -295,14 +291,11 @@ &reftitle.seealso; - - - ps_set_value - - + + ps_set_value + - - diff --git a/reference/ps/functions/ps-hyphenate.xml b/reference/ps/functions/ps-hyphenate.xml index 306de72fcf9b..73b7d56934cc 100644 --- a/reference/ps/functions/ps-hyphenate.xml +++ b/reference/ps/functions/ps-hyphenate.xml @@ -1,7 +1,7 @@ - + ps_hyphenate Hyphenates a word @@ -29,30 +29,28 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - text - - - text should not contain any non alpha - characters. Possible positions for breaks are returned in an array of - interger numbers. Each number is the position of the char in - text after which a hyphenation can take place. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + text + + + text should not contain any non alpha + characters. Possible positions for breaks are returned in an array of + interger numbers. Each number is the position of the char in + text after which a hyphenation can take place. + + + + @@ -65,10 +63,9 @@ &reftitle.examples; - - - Hyphennate a text - + + Hyphennate a text + ]]> - - &example.outputs; - + + &example.outputs; + - - - + + &reftitle.seealso; - - - - ps_show_boxed - locale(1) - - + + + ps_show_boxed + locale(1) + - - diff --git a/reference/ps/functions/ps-include-file.xml b/reference/ps/functions/ps-include-file.xml index 3c9b9cf71778..dd99104075d8 100644 --- a/reference/ps/functions/ps-include-file.xml +++ b/reference/ps/functions/ps-include-file.xml @@ -1,6 +1,6 @@ - + ps_include_file Reads an external file with raw PostScript code @@ -20,26 +20,24 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - file - - - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + file + + + + + + @@ -50,7 +48,6 @@ - - diff --git a/reference/ps/functions/ps-lineto.xml b/reference/ps/functions/ps-lineto.xml index 4b4870db50dc..396d27d58e5a 100644 --- a/reference/ps/functions/ps-lineto.xml +++ b/reference/ps/functions/ps-lineto.xml @@ -1,7 +1,7 @@ - + ps_lineto Draws a line @@ -24,35 +24,33 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - x - - - x-coordinate of the end point of the line. - - - - - y - - - y-coordinate of the end point of the line. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + x + + + x-coordinate of the end point of the line. + + + + + y + + + y-coordinate of the end point of the line. + + + + @@ -64,10 +62,9 @@ &reftitle.examples; - - - Drawing a rectangle - + + Drawing a rectangle + ]]> - - - + + &reftitle.seealso; - - - ps_moveto - - + + ps_moveto + - - diff --git a/reference/ps/functions/ps-makespotcolor.xml b/reference/ps/functions/ps-makespotcolor.xml index 10bcfe6c6cb1..8c1cde64e68c 100644 --- a/reference/ps/functions/ps-makespotcolor.xml +++ b/reference/ps/functions/ps-makespotcolor.xml @@ -1,7 +1,7 @@ - + ps_makespotcolor Create spot color @@ -27,27 +27,25 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - name - - - Name of the spot color, e.g. Pantone 5565. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + name + + + Name of the spot color, e.g. Pantone 5565. + + + + @@ -59,10 +57,9 @@ &reftitle.examples; - - - Creating and using a spot color - + + Creating and using a spot color + ]]> - - - This example creates the spot color "PANTONE 5565 C" which - is a darker green (olive) and fills a rectangle with 50% intensity. - - - + + + This example creates the spot color "PANTONE 5565 C" which + is a darker green (olive) and fills a rectangle with 50% intensity. + + &reftitle.seealso; - - - ps_setcolor - - + + ps_setcolor + - - diff --git a/reference/ps/functions/ps-moveto.xml b/reference/ps/functions/ps-moveto.xml index 2d92d0c74bfe..2f8bc8c52a95 100644 --- a/reference/ps/functions/ps-moveto.xml +++ b/reference/ps/functions/ps-moveto.xml @@ -1,7 +1,7 @@ - + ps_moveto Sets current point @@ -25,35 +25,33 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - x - - - x-coordinate of the point to move to. - - - - - y - - - y-coordinate of the point to move to. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + x + + + x-coordinate of the point to move to. + + + + + y + + + y-coordinate of the point to move to. + + + + @@ -65,14 +63,11 @@ &reftitle.seealso; - - - ps_lineto - - + + ps_lineto + - - diff --git a/reference/ps/functions/ps-new.xml b/reference/ps/functions/ps-new.xml index 53ee4ef7ced3..d2e3da94a478 100644 --- a/reference/ps/functions/ps-new.xml +++ b/reference/ps/functions/ps-new.xml @@ -1,7 +1,7 @@ - + ps_new Creates a new PostScript document object @@ -11,7 +11,7 @@ &reftitle.description; resourcefalseps_new - + Creates a new document instance. It does not create the file on disk or in @@ -36,14 +36,11 @@ &reftitle.seealso; - - - ps_delete - - + + ps_delete + - - diff --git a/reference/ps/functions/ps-open-file.xml b/reference/ps/functions/ps-open-file.xml index 3faa89323da4..19af01914b86 100644 --- a/reference/ps/functions/ps-open-file.xml +++ b/reference/ps/functions/ps-open-file.xml @@ -1,7 +1,7 @@ - + ps_open_file Opens a file for output @@ -22,29 +22,27 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - filename - - - The name of the postscript file. - If filename is not passed the document will be - created in memory and all output will go straight to the browser. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + filename + + + The name of the postscript file. + If filename is not passed the document will be + created in memory and all output will go straight to the browser. + + + + @@ -56,14 +54,11 @@ &reftitle.seealso; - - - ps_close - - + + ps_close + - - diff --git a/reference/ps/functions/ps-open-image-file.xml b/reference/ps/functions/ps-open-image-file.xml index 148d53dc22b8..bb01f2e11830 100644 --- a/reference/ps/functions/ps-open-image-file.xml +++ b/reference/ps/functions/ps-open-image-file.xml @@ -1,7 +1,7 @@ - + ps_open_image_file Opens image from file @@ -24,52 +24,50 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - type - - - The type of the image. Possible values are png, - jpeg, or eps. - - - - - filename - - - The name of the file containing the image data. - - - - - stringparam - - - Not used. - - - - - intparam - - - Not used. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + type + + + The type of the image. Possible values are png, + jpeg, or eps. + + + + + filename + + + The name of the file containing the image data. + + + + + stringparam + + + Not used. + + + + + intparam + + + Not used. + + + + @@ -82,16 +80,13 @@ &reftitle.seealso; - - - ps_open_image - ps_place_image - ps_close_image - - + + ps_open_image + ps_place_image + ps_close_image + - - diff --git a/reference/ps/functions/ps-open-image.xml b/reference/ps/functions/ps-open-image.xml index 9aafc5aa84ff..fe78e4f2dde0 100644 --- a/reference/ps/functions/ps-open-image.xml +++ b/reference/ps/functions/ps-open-image.xml @@ -1,7 +1,7 @@ - + ps_open_image Reads an image for later placement @@ -34,92 +34,90 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - type - - - The type of the image. Possible values are png, - jpeg, or eps. - - - - - source - - - Not used. - - - - - data - - - The image data. - - - - - length - - - The length of the image data. - - - - - width - - - The width of the image. - - - - - height - - - The height of the image. - - - - - components - - - The number of components for each pixel. This can be - 1 (gray scale images), 3 (rgb images), or 4 (cmyk, rgba images). - - - - - bpc - - - Number of bits per component (quite often 8). - - - - - params - - - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + type + + + The type of the image. Possible values are png, + jpeg, or eps. + + + + + source + + + Not used. + + + + + data + + + The image data. + + + + + length + + + The length of the image data. + + + + + width + + + The width of the image. + + + + + height + + + The height of the image. + + + + + components + + + The number of components for each pixel. This can be + 1 (gray scale images), 3 (rgb images), or 4 (cmyk, rgba images). + + + + + bpc + + + Number of bits per component (quite often 8). + + + + + params + + + + + + @@ -132,17 +130,13 @@ &reftitle.seealso; - - - ps_open_image_file - ps_place_image - ps_close_image - - + + ps_open_image_file + ps_place_image + ps_close_image + - - - diff --git a/reference/ps/functions/ps-open-memory-image.xml b/reference/ps/functions/ps-open-memory-image.xml index f34fabf29625..a48cf0ec23c7 100644 --- a/reference/ps/functions/ps-open-memory-image.xml +++ b/reference/ps/functions/ps-open-memory-image.xml @@ -1,6 +1,6 @@ - + ps_open_memory_image Takes an GD image and returns an image for placement in a PS document @@ -20,30 +20,27 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - gd - - - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + gd + + + + + + - - diff --git a/reference/ps/functions/ps-place-image.xml b/reference/ps/functions/ps-place-image.xml index dd4ed8d32808..dcc2a563665f 100644 --- a/reference/ps/functions/ps-place-image.xml +++ b/reference/ps/functions/ps-place-image.xml @@ -1,7 +1,7 @@ - + ps_place_image Places image on the page @@ -26,55 +26,53 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - imageid - - - The resource identifier of the image as returned by - ps_open_image or - ps_open_image_file. - - - - - x - - - x-coordinate of the lower left corner of the image. - - - - - y - - - y-coordinate of the lower left corner of the image. - - - - - scale - - - The scaling factor for the image. A scale of 1.0 will result - in a resolution of 72 dpi, because each pixel is equivalent to - 1 point. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + imageid + + + The resource identifier of the image as returned by + ps_open_image or + ps_open_image_file. + + + + + x + + + x-coordinate of the lower left corner of the image. + + + + + y + + + y-coordinate of the lower left corner of the image. + + + + + scale + + + The scaling factor for the image. A scale of 1.0 will result + in a resolution of 72 dpi, because each pixel is equivalent to + 1 point. + + + + @@ -86,15 +84,12 @@ &reftitle.seealso; - - - ps_open_image - ps_open_image_file - - + + ps_open_image + ps_open_image_file + - - diff --git a/reference/ps/functions/ps-rect.xml b/reference/ps/functions/ps-rect.xml index 5fc6f1ea50b2..4d408ab1c1b6 100644 --- a/reference/ps/functions/ps-rect.xml +++ b/reference/ps/functions/ps-rect.xml @@ -1,7 +1,7 @@ - + ps_rect Draws a rectangle @@ -29,51 +29,49 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - x - - - x-coordinate of the lower left corner of the rectangle. - - - - - y - - - y-coordinate of the lower left corner of the rectangle. - - - - - width - - - The width of the image. - - - - - height - - - The height of the image. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + x + + + x-coordinate of the lower left corner of the rectangle. + + + + + y + + + y-coordinate of the lower left corner of the rectangle. + + + + + width + + + The width of the image. + + + + + height + + + The height of the image. + + + + @@ -85,16 +83,13 @@ &reftitle.seealso; - - - ps_arc - ps_cirle - ps_lineto - - + + ps_arc + ps_cirle + ps_lineto + - - diff --git a/reference/ps/functions/ps-restore.xml b/reference/ps/functions/ps-restore.xml index 590e3d2dfe93..f156fd9ce762 100644 --- a/reference/ps/functions/ps-restore.xml +++ b/reference/ps/functions/ps-restore.xml @@ -1,7 +1,7 @@ - + ps_restore Restore previously save context @@ -24,19 +24,17 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + @@ -48,14 +46,11 @@ &reftitle.seealso; - - - ps_save - - + + ps_save + - - diff --git a/reference/ps/functions/ps-rotate.xml b/reference/ps/functions/ps-rotate.xml index 6d954e21aa2c..343771c58a0d 100644 --- a/reference/ps/functions/ps-rotate.xml +++ b/reference/ps/functions/ps-rotate.xml @@ -1,7 +1,7 @@ - + ps_rotate Sets rotation factor @@ -21,27 +21,25 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - rot - - - Angle of rotation in degree. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + rot + + + Angle of rotation in degree. + + + + @@ -53,10 +51,9 @@ &reftitle.examples; - - - Rotation of the coordinate system - + + Rotation of the coordinate system + ]]> - - - The above example illustrates a very common way of rotating a - graphic (in this case just a rectangle) by simply rotating the - coordinate system. Since the graphic's coordinate system assumes - (0,0) to be the origin, the page coordinate system is also translated - to place the graphics not on the edge of the page. Pay attention - to the order of ps_translate and - ps_rotate. In the above case the rectancle is - rotated around the point (100, 100) in the untranslated coordinate - system. Switching the two statements has a completely - different result. - - - In order to output the following text at the original position, all - modifications of the coordinate system are encapsulated in - ps_save and ps_restore. - - - + + + The above example illustrates a very common way of rotating a + graphic (in this case just a rectangle) by simply rotating the + coordinate system. Since the graphic's coordinate system assumes + (0,0) to be the origin, the page coordinate system is also translated + to place the graphics not on the edge of the page. Pay attention + to the order of ps_translate and + ps_rotate. In the above case the rectancle is + rotated around the point (100, 100) in the untranslated coordinate + system. Switching the two statements has a completely + different result. + + + In order to output the following text at the original position, all + modifications of the coordinate system are encapsulated in + ps_save and ps_restore. + + &reftitle.seealso; - - - ps_scale - ps_translate - - + + ps_scale + ps_translate + - - diff --git a/reference/ps/functions/ps-save.xml b/reference/ps/functions/ps-save.xml index f9f170d845d6..029994642358 100644 --- a/reference/ps/functions/ps-save.xml +++ b/reference/ps/functions/ps-save.xml @@ -1,7 +1,7 @@ - + ps_save Save current context @@ -22,19 +22,17 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + @@ -46,14 +44,11 @@ &reftitle.seealso; - - - ps_restore - - + + ps_restore + - - diff --git a/reference/ps/functions/ps-scale.xml b/reference/ps/functions/ps-scale.xml index 5f7bfdb1d42e..4004301508dd 100644 --- a/reference/ps/functions/ps-scale.xml +++ b/reference/ps/functions/ps-scale.xml @@ -1,7 +1,7 @@ - + ps_scale Sets scaling factor @@ -22,35 +22,33 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - x - - - Scaling factor in horizontal direction. - - - - - y - - - Scaling factor in vertical direction. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + x + + + Scaling factor in horizontal direction. + + + + + y + + + Scaling factor in vertical direction. + + + + @@ -62,15 +60,12 @@ &reftitle.seealso; - - - ps_rotate - ps_translate - - + + ps_rotate + ps_translate + - - diff --git a/reference/ps/functions/ps-set-border-color.xml b/reference/ps/functions/ps-set-border-color.xml index 9bfc127ef2f9..c7d0decbfdbc 100644 --- a/reference/ps/functions/ps-set-border-color.xml +++ b/reference/ps/functions/ps-set-border-color.xml @@ -1,7 +1,7 @@ - + ps_set_border_color Sets color of border for annotations @@ -28,43 +28,41 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - red - - - The red component of the border color. - - - - - green - - - The green component of the border color. - - - - - blue - - - The blue component of the border color. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + red + + + The red component of the border color. + + + + + green + + + The green component of the border color. + + + + + blue + + + The blue component of the border color. + + + + @@ -76,15 +74,12 @@ &reftitle.seealso; - - - ps_set_border_dash - ps_set_border_style - - + + ps_set_border_dash + ps_set_border_style + - - diff --git a/reference/ps/functions/ps-set-border-dash.xml b/reference/ps/functions/ps-set-border-dash.xml index 5d0d7eae9206..33eb89674944 100644 --- a/reference/ps/functions/ps-set-border-dash.xml +++ b/reference/ps/functions/ps-set-border-dash.xml @@ -1,7 +1,7 @@ - + ps_set_border_dash Sets length of dashes for border of annotations @@ -28,35 +28,33 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - black - - - The length of the dash. - - - - - white - - - The length of the gap between dashes. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + black + + + The length of the dash. + + + + + white + + + The length of the gap between dashes. + + + + @@ -68,15 +66,12 @@ &reftitle.seealso; - - - ps_set_border_color - ps_set_border_style - - + + ps_set_border_color + ps_set_border_style + - - diff --git a/reference/ps/functions/ps-set-border-style.xml b/reference/ps/functions/ps-set-border-style.xml index e1c439a6edf1..59a2b69448ed 100644 --- a/reference/ps/functions/ps-set-border-style.xml +++ b/reference/ps/functions/ps-set-border-style.xml @@ -1,7 +1,7 @@ - + ps_set_border_style Sets border style of annotations @@ -27,36 +27,34 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - style - - - style can be solid or - dashed. - - - - - width - - - The line width of the border. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + style + + + style can be solid or + dashed. + + + + + width + + + The line width of the border. + + + + @@ -68,15 +66,12 @@ &reftitle.seealso; - - - ps_set_border_color - ps_set_border_dash - - + + ps_set_border_color + ps_set_border_dash + - - diff --git a/reference/ps/functions/ps-set-info.xml b/reference/ps/functions/ps-set-info.xml index 691470c1fa03..8549bb9f2faf 100644 --- a/reference/ps/functions/ps-set-info.xml +++ b/reference/ps/functions/ps-set-info.xml @@ -1,7 +1,7 @@ - + ps_set_info Sets information fields of document @@ -36,53 +36,51 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - key - - - The name of the information field to set. The values which can be - set are Keywords, Subject, - Title, Creator, - Author, BoundingBox, and - Orientation. Be aware that some of them has a - meaning to PostScript viewers. - - - - - value - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + key + + + The name of the information field to set. The values which can be + set are Keywords, Subject, + Title, Creator, + Author, BoundingBox, and + Orientation. Be aware that some of them has a + meaning to PostScript viewers. + + + + + value + + + The value of the information field. The field + Orientation can be set to either + Portrait or Landscape. The + BoundingBox is a string consisting of four numbers. + The first two numbers are the coordinates of the lower left corner of + the page. The last two numbers are the coordinates of the upper + right corner. + + - The value of the information field. The field - Orientation can be set to either - Portrait or Landscape. The - BoundingBox is a string consisting of four numbers. - The first two numbers are the coordinates of the lower left corner of - the page. The last two numbers are the coordinates of the upper - right corner. + Up to version 0.2.6 of pslib, the BoundingBox and Orientation + will be overwritten by ps_begin_page, + unless ps_findfont has been called before. - - - Up to version 0.2.6 of pslib, the BoundingBox and Orientation - will be overwritten by ps_begin_page, - unless ps_findfont has been called before. - - - - - - + + + + @@ -94,15 +92,12 @@ &reftitle.seealso; - - - ps_findfont - ps_begin_page - - + + ps_findfont + ps_begin_page + - - diff --git a/reference/ps/functions/ps-set-parameter.xml b/reference/ps/functions/ps-set-parameter.xml index dd263eb897e2..022d4a0d4ed2 100644 --- a/reference/ps/functions/ps-set-parameter.xml +++ b/reference/ps/functions/ps-set-parameter.xml @@ -1,7 +1,7 @@ - + ps_set_parameter Sets certain parameters @@ -23,35 +23,33 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - name - - - For a list of possible names see ps_get_parameter. - - - - - value - - - The value of the parameter. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + name + + + For a list of possible names see ps_get_parameter. + + + + + value + + + The value of the parameter. + + + + @@ -63,15 +61,12 @@ &reftitle.seealso; - - - ps_get_parameters - ps_set_value - - + + ps_get_parameters + ps_set_value + - - diff --git a/reference/ps/functions/ps-set-text-pos.xml b/reference/ps/functions/ps-set-text-pos.xml index dd42dd48f27c..5399856dc3c5 100644 --- a/reference/ps/functions/ps-set-text-pos.xml +++ b/reference/ps/functions/ps-set-text-pos.xml @@ -1,7 +1,7 @@ - + ps_set_text_pos Sets position for text output @@ -30,35 +30,33 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - x - - - x-coordinate of the new text position. - - - - - y - - - y-coordinate of the new text position. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + x + + + x-coordinate of the new text position. + + + + + y + + + y-coordinate of the new text position. + + + + @@ -70,10 +68,9 @@ &reftitle.examples; - - - Placing text at a given position - + + Placing text at a given position + ]]> - - - + + &reftitle.seealso; - - - ps_set_value - ps_show - - + + ps_set_value + ps_show + - - diff --git a/reference/ps/functions/ps-set-value.xml b/reference/ps/functions/ps-set-value.xml index be58ad777cfa..8255ad5198f4 100644 --- a/reference/ps/functions/ps-set-value.xml +++ b/reference/ps/functions/ps-set-value.xml @@ -1,7 +1,7 @@ - + ps_set_value Sets certain values @@ -23,77 +23,75 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - name - - - The name can be one of the following: - - - textrendering - - - The way how text is shown. - - - - - textx - - - The x coordinate for text output. - - - - - texty - - - The y coordinate for text output. - - - - - wordspacing - - - The distance between words relative to the width of a space. - - - - - leading - - - The distance between lines in pixels. - - - - - - - - - value - - - The value of the parameter. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + name + + + The name can be one of the following: + + + textrendering + + + The way how text is shown. + + + + + textx + + + The x coordinate for text output. + + + + + texty + + + The y coordinate for text output. + + + + + wordspacing + + + The distance between words relative to the width of a space. + + + + + leading + + + The distance between lines in pixels. + + + + + + + + + value + + + The value of the parameter. + + + + @@ -105,15 +103,12 @@ &reftitle.seealso; - - - ps_get_value - ps_set_parameter - - + + ps_get_value + ps_set_parameter + - - diff --git a/reference/ps/functions/ps-setcolor.xml b/reference/ps/functions/ps-setcolor.xml index 8e4c79710816..00d65ceebac4 100644 --- a/reference/ps/functions/ps-setcolor.xml +++ b/reference/ps/functions/ps-setcolor.xml @@ -1,7 +1,7 @@ - + ps_setcolor Sets current color @@ -26,78 +26,76 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - type - - - The parameter type can be - both, fill, or - fillstroke. - - - - - colorspace - - - The colorspace should be one of gray, - rgb, cmyk, - spot, pattern. Depending on the - colorspace either only the first, the first three or all parameters - will be used. - - - - - c1 - - - Depending on the colorspace this is either the red component (rgb), - the cyan component (cmyk), the gray value (gray), the identifier of - the spot color or the identifier of the pattern. - - - - - c2 - - - Depending on the colorspace this is either the green component (rgb), - the magenta component (cmyk). - - - - - c3 - - - Depending on the colorspace this is either the blue component (rgb), - the yellow component (cmyk). - - - - - c4 - - - This must only be set in cmyk colorspace and specifies the black - component. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + type + + + The parameter type can be + both, fill, or + fillstroke. + + + + + colorspace + + + The colorspace should be one of gray, + rgb, cmyk, + spot, pattern. Depending on the + colorspace either only the first, the first three or all parameters + will be used. + + + + + c1 + + + Depending on the colorspace this is either the red component (rgb), + the cyan component (cmyk), the gray value (gray), the identifier of + the spot color or the identifier of the pattern. + + + + + c2 + + + Depending on the colorspace this is either the green component (rgb), + the magenta component (cmyk). + + + + + c3 + + + Depending on the colorspace this is either the blue component (rgb), + the yellow component (cmyk). + + + + + c4 + + + This must only be set in cmyk colorspace and specifies the black + component. + + + + @@ -118,7 +116,6 @@ - - + ps_setdash Sets appearance of a dashed line @@ -22,35 +22,33 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - on - - - The length of the dash. - - - - - off - - - The length of the gap between dashes. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + on + + + The length of the dash. + + + + + off + + + The length of the gap between dashes. + + + + @@ -62,14 +60,11 @@ &reftitle.seealso; - - - ps_setpolydash - - + + ps_setpolydash + - - diff --git a/reference/ps/functions/ps-setflat.xml b/reference/ps/functions/ps-setflat.xml index 0e07c0e42ce0..f4b038f38258 100644 --- a/reference/ps/functions/ps-setflat.xml +++ b/reference/ps/functions/ps-setflat.xml @@ -1,7 +1,7 @@ - + ps_setflat Sets flatness @@ -21,27 +21,25 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - value - - - The value must be between 0.2 and 1. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + value + + + The value must be between 0.2 and 1. + + + + @@ -51,7 +49,6 @@ - - diff --git a/reference/ps/functions/ps-setfont.xml b/reference/ps/functions/ps-setfont.xml index 5c2d452d2dc2..a1e99952d5bc 100644 --- a/reference/ps/functions/ps-setfont.xml +++ b/reference/ps/functions/ps-setfont.xml @@ -1,7 +1,7 @@ - + ps_setfont Sets font to use for following output @@ -24,35 +24,33 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - fontid - - - The font identifier as returned by ps_findfont. - - - - - size - - - The size of the font. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + fontid + + + The font identifier as returned by ps_findfont. + + + + + size + + + The size of the font. + + + + @@ -64,15 +62,12 @@ &reftitle.seealso; - - - ps_findfont - ps_set_text_pos for an example. - - + + ps_findfont + ps_set_text_pos for an example. + - - diff --git a/reference/ps/functions/ps-setgray.xml b/reference/ps/functions/ps-setgray.xml index 20e59e6d4f6c..3406e3112d11 100644 --- a/reference/ps/functions/ps-setgray.xml +++ b/reference/ps/functions/ps-setgray.xml @@ -1,7 +1,7 @@ - + ps_setgray Sets gray value @@ -18,31 +18,29 @@ Sets the gray value for all following drawing operations. - + &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - gray - - - The value must be between 0 (white) and 1 (black). - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + gray + + + The value must be between 0 (white) and 1 (black). + + + + @@ -54,14 +52,11 @@ &reftitle.seealso; - - - ps_setcolor - - + + ps_setcolor + - - diff --git a/reference/ps/functions/ps-setlinecap.xml b/reference/ps/functions/ps-setlinecap.xml index 4fec1ecf2c01..3450aa37878f 100644 --- a/reference/ps/functions/ps-setlinecap.xml +++ b/reference/ps/functions/ps-setlinecap.xml @@ -1,7 +1,7 @@ - + ps_setlinecap Sets appearance of line ends @@ -18,33 +18,31 @@ Sets how line ends look like. - + &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - type - - - The type of line ends. Possible values are - PS_LINECAP_BUTT, - PS_LINECAP_ROUND, or - PS_LINECAP_SQUARED. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + type + + + The type of line ends. Possible values are + PS_LINECAP_BUTT, + PS_LINECAP_ROUND, or + PS_LINECAP_SQUARED. + + + + @@ -56,16 +54,13 @@ &reftitle.seealso; - - - ps_setlinejoin - ps_setlinewidth - ps_setmiterlimit - - + + ps_setlinejoin + ps_setlinewidth + ps_setmiterlimit + - - diff --git a/reference/ps/functions/ps-setlinejoin.xml b/reference/ps/functions/ps-setlinejoin.xml index f645a31597d0..8aca1b331d2f 100644 --- a/reference/ps/functions/ps-setlinejoin.xml +++ b/reference/ps/functions/ps-setlinejoin.xml @@ -1,7 +1,7 @@ - + ps_setlinejoin Sets how contected lines are joined @@ -21,30 +21,28 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - type - - - The way lines are joined. Possible values are - PS_LINEJOIN_MITER, - PS_LINEJOIN_ROUND, or - PS_LINEJOIN_BEVEL. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + type + + + The way lines are joined. Possible values are + PS_LINEJOIN_MITER, + PS_LINEJOIN_ROUND, or + PS_LINEJOIN_BEVEL. + + + + @@ -56,16 +54,13 @@ &reftitle.seealso; - - - ps_setlinecap - ps_setlinewidth - ps_setmiterlimit - - + + ps_setlinecap + ps_setlinewidth + ps_setmiterlimit + - - diff --git a/reference/ps/functions/ps-setlinewidth.xml b/reference/ps/functions/ps-setlinewidth.xml index 1d6a667f1b7e..a3aceb1bb8d1 100644 --- a/reference/ps/functions/ps-setlinewidth.xml +++ b/reference/ps/functions/ps-setlinewidth.xml @@ -1,7 +1,7 @@ - + ps_setlinewidth Sets width of a line @@ -21,27 +21,25 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - width - - - The width of lines in points. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + width + + + The width of lines in points. + + + + @@ -53,16 +51,13 @@ &reftitle.seealso; - - - ps_setlinecap - ps_setlinejoin - ps_setmiterlimit - - + + ps_setlinecap + ps_setlinejoin + ps_setmiterlimit + - - diff --git a/reference/ps/functions/ps-setmiterlimit.xml b/reference/ps/functions/ps-setmiterlimit.xml index 17fe1f6914a5..315f7d7edfcb 100644 --- a/reference/ps/functions/ps-setmiterlimit.xml +++ b/reference/ps/functions/ps-setmiterlimit.xml @@ -1,7 +1,7 @@ - + ps_setmiterlimit Sets the miter limit @@ -24,29 +24,27 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - value - - - The maximum ratio between the miter length and the line width. Larger - values (> 10) will result in very long spikes when two lines meet - in a small angle. Keep the default unless you know what you are doing. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + value + + + The maximum ratio between the miter length and the line width. Larger + values (> 10) will result in very long spikes when two lines meet + in a small angle. Keep the default unless you know what you are doing. + + + + @@ -58,16 +56,13 @@ &reftitle.seealso; - - - ps_setlinecap - ps_setlinejoin - ps_setlinewidth - - + + ps_setlinecap + ps_setlinejoin + ps_setlinewidth + - - diff --git a/reference/ps/functions/ps-setoverprintmode.xml b/reference/ps/functions/ps-setoverprintmode.xml index a8adec213324..cd923ae9d025 100644 --- a/reference/ps/functions/ps-setoverprintmode.xml +++ b/reference/ps/functions/ps-setoverprintmode.xml @@ -1,6 +1,6 @@ - + ps_setoverprintmode Sets overprint mode @@ -20,26 +20,24 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - mode - - - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + mode + + + + + + @@ -49,7 +47,6 @@ - - diff --git a/reference/ps/functions/ps-setpolydash.xml b/reference/ps/functions/ps-setpolydash.xml index a48b24805e3d..2606e812f5b3 100644 --- a/reference/ps/functions/ps-setpolydash.xml +++ b/reference/ps/functions/ps-setpolydash.xml @@ -1,7 +1,7 @@ - + ps_setpolydash Sets appearance of a dashed line @@ -23,28 +23,26 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - arr - - - arr is a list of length elements alternately for - the black and white portion. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + arr + + + arr is a list of length elements alternately for + the black and white portion. + + + + @@ -56,10 +54,9 @@ &reftitle.examples; - - - Drawing a dashed line - + + Drawing a dashed line + ]]> - - - This example draws a line with a 10 and 2 points long line, and - gaps of 5 points inbetween. - - - + + + This example draws a line with a 10 and 2 points long line, and + gaps of 5 points inbetween. + + &reftitle.seealso; - - - ps_setdash - - + + ps_setdash + - - diff --git a/reference/ps/functions/ps-shading-pattern.xml b/reference/ps/functions/ps-shading-pattern.xml index ca47ee5fd561..1c675198ae07 100644 --- a/reference/ps/functions/ps-shading-pattern.xml +++ b/reference/ps/functions/ps-shading-pattern.xml @@ -1,7 +1,7 @@ - + ps_shading_pattern Creates a pattern based on a shading @@ -24,36 +24,34 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - shadingid - - - The identifier of a shading previously created with - ps_shading. - - - - - optlist - - - This argument is not currently used. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + shadingid + + + The identifier of a shading previously created with + ps_shading. + + + + + optlist + + + This argument is not currently used. + + + + @@ -65,15 +63,12 @@ &reftitle.seealso; - - - ps_shading - ps_shfill - - + + ps_shading + ps_shfill + - - diff --git a/reference/ps/functions/ps-shading.xml b/reference/ps/functions/ps-shading.xml index 6e611f556d88..c006a278d89b 100644 --- a/reference/ps/functions/ps-shading.xml +++ b/reference/ps/functions/ps-shading.xml @@ -1,7 +1,7 @@ - + ps_shading Creates a shading for later use @@ -35,62 +35,60 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - type - - - The type of shading can be either radial or - axial. Each shading starts with the current fill - color and ends with the given color values passed in the parameters - c1 to c4 - (see ps_setcolor for their meaning). - - - - - x0, x1, y0, y1 - - - The coordinates x0, y0, - x1, y1 are the start and - end point of the shading. If the type of shading is - radial the two points are the middle points of - a starting and ending circle. - - - - - c1, c2, c3, c4 - - - See ps_setcolor for their meaning. - - - - - optlist - - - If the shading is of type radial the - optlist must also contain the parameters - r0 and r1 with the radius of the - start and end circle. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + type + + + The type of shading can be either radial or + axial. Each shading starts with the current fill + color and ends with the given color values passed in the parameters + c1 to c4 + (see ps_setcolor for their meaning). + + + + + x0, x1, y0, y1 + + + The coordinates x0, y0, + x1, y1 are the start and + end point of the shading. If the type of shading is + radial the two points are the middle points of + a starting and ending circle. + + + + + c1, c2, c3, c4 + + + See ps_setcolor for their meaning. + + + + + optlist + + + If the shading is of type radial the + optlist must also contain the parameters + r0 and r1 with the radius of the + start and end circle. + + + + @@ -102,15 +100,12 @@ &reftitle.seealso; - - - ps_shading_pattern - ps_shfill - - + + ps_shading_pattern + ps_shfill + - - diff --git a/reference/ps/functions/ps-shfill.xml b/reference/ps/functions/ps-shfill.xml index 394cdbd843d9..b8863826c598 100644 --- a/reference/ps/functions/ps-shfill.xml +++ b/reference/ps/functions/ps-shfill.xml @@ -1,7 +1,7 @@ - + ps_shfill Fills an area with a shading @@ -24,28 +24,26 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - shadingid - - - The identifier of a shading previously created with - ps_shading. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + shadingid + + + The identifier of a shading previously created with + ps_shading. + + + + @@ -57,15 +55,12 @@ &reftitle.seealso; - - - ps_shading - ps_shading_pattern - - + + ps_shading + ps_shading_pattern + - - diff --git a/reference/ps/functions/ps-show-boxed.xml b/reference/ps/functions/ps-show-boxed.xml index ed7887b6969b..a107588dd596 100644 --- a/reference/ps/functions/ps-show-boxed.xml +++ b/reference/ps/functions/ps-show-boxed.xml @@ -1,7 +1,7 @@ - + ps_show_boxed Output text in a box @@ -46,80 +46,78 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - text - - - The text to be output into the given box. - - - - - left - - - x-coordinate of the lower left corner of the box. - - - - - bottom - - - y-coordinate of the lower left corner of the box. - - - - - width - - - Width of the box. - - - - - height - - - Height of the box. - - - - - hmode - - - The parameter hmode can be justify, - fulljustify, right, left, or center. - The difference of justify and fulljustify just affects the last line of the box. In - fulljustify mode the last line will be left and right justified unless - this is also the last line of paragraph. In justify mode it will always - be left justified. - - - - - feature - - - - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + text + + + The text to be output into the given box. + + + + + left + + + x-coordinate of the lower left corner of the box. + + + + + bottom + + + y-coordinate of the lower left corner of the box. + + + + + width + + + Width of the box. + + + + + height + + + Height of the box. + + + + + hmode + + + The parameter hmode can be justify, + fulljustify, right, left, or center. + The difference of justify and fulljustify just affects the last line of the box. In + fulljustify mode the last line will be left and right justified unless + this is also the last line of paragraph. In justify mode it will always + be left justified. + + + + + feature + + + + + + + Used parameters @@ -288,14 +286,11 @@ &reftitle.seealso; - - - ps_continue_text - - + + ps_continue_text + - - diff --git a/reference/ps/functions/ps-show-xy.xml b/reference/ps/functions/ps-show-xy.xml index 2ff14292bca2..f1752b56b779 100644 --- a/reference/ps/functions/ps-show-xy.xml +++ b/reference/ps/functions/ps-show-xy.xml @@ -1,7 +1,7 @@ - + ps_show_xy Output text at given position @@ -23,43 +23,41 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - text - - - The text to be output. - - - - - x - - - x-coordinate of the lower left corner of the box surrounding the text. - - - - - y - - - y-coordinate of the lower left corner of the box surrounding the text. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + text + + + The text to be output. + + + + + x + + + x-coordinate of the lower left corner of the box surrounding the text. + + + + + y + + + y-coordinate of the lower left corner of the box surrounding the text. + + + + @@ -71,15 +69,12 @@ &reftitle.seealso; - - - ps_continue_text - ps_show - - + + ps_continue_text + ps_show + - - diff --git a/reference/ps/functions/ps-show.xml b/reference/ps/functions/ps-show.xml index de397b263ec1..d22d31194d98 100644 --- a/reference/ps/functions/ps-show.xml +++ b/reference/ps/functions/ps-show.xml @@ -1,7 +1,7 @@ - + ps_show Output text @@ -50,7 +50,7 @@ ligatures (parameter) - Setting this parameter to "false" will turn off the use of ligatures. + Setting this parameter to "false" will turn off the use of ligatures. Ligatures are turned on by default. @@ -75,7 +75,7 @@ strikeout (parameter) - + Setting this parameter to "true" will turn on striking out. Striking out is turned off by default. @@ -87,27 +87,25 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - text - - - The text to be output. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + text + + + The text to be output. + + + + @@ -119,16 +117,13 @@ &reftitle.seealso; - - - ps_continue_text - ps_show_xy - ps_setfont - - + + ps_continue_text + ps_show_xy + ps_setfont + - - diff --git a/reference/ps/functions/ps-show2.xml b/reference/ps/functions/ps-show2.xml index a00dd68c00bf..0e76925f1e1f 100644 --- a/reference/ps/functions/ps-show2.xml +++ b/reference/ps/functions/ps-show2.xml @@ -1,6 +1,6 @@ - + ps_show2 Output a text at current position @@ -21,35 +21,33 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - text - - - The text to be output. - - - - - len - - - The maximum number of characters to print. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + text + + + The text to be output. + + + + + len + + + The maximum number of characters to print. + + + + @@ -59,7 +57,6 @@ - - diff --git a/reference/ps/functions/ps-string-geometry.xml b/reference/ps/functions/ps-string-geometry.xml index f052af4a2a23..26b81eeb130e 100644 --- a/reference/ps/functions/ps-string-geometry.xml +++ b/reference/ps/functions/ps-string-geometry.xml @@ -1,7 +1,7 @@ - + ps_string_geometry Gets geometry of a string @@ -25,45 +25,43 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - text - - - The text for which the geometry is to be calculated. - - - - - fontid - - - The identifier of the font to be used. If not font is specified - the current font will be used. - - - - - size - - - The size of the font. If no size is specified the current size - is used. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + text + + + The text for which the geometry is to be calculated. + + + + + fontid + + + The identifier of the font to be used. If not font is specified + the current font will be used. + + + + + size + + + The size of the font. If no size is specified the current size + is used. + + + + @@ -78,15 +76,12 @@ &reftitle.seealso; - - - ps_continue_text - ps_stringwidth - - + + ps_continue_text + ps_stringwidth + - - diff --git a/reference/ps/functions/ps-stringwidth.xml b/reference/ps/functions/ps-stringwidth.xml index 5572b113003f..b309c8e4650e 100644 --- a/reference/ps/functions/ps-stringwidth.xml +++ b/reference/ps/functions/ps-stringwidth.xml @@ -1,12 +1,12 @@ - + ps_stringwidth Gets width of a string - + &reftitle.description; @@ -27,45 +27,43 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - text - - - The text for which the width is to be calculated. - - - - - fontid - - - The identifier of the font to be used. If not font is specified - the current font will be used. - - - - - size - - - The size of the font. If no size is specified the current size - is used. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + text + + + The text for which the width is to be calculated. + + + + + fontid + + + The identifier of the font to be used. If not font is specified + the current font will be used. + + + + + size + + + The size of the font. If no size is specified the current size + is used. + + + + @@ -77,14 +75,11 @@ &reftitle.seealso; - - - ps_string_geometry - - + + ps_string_geometry + - - diff --git a/reference/ps/functions/ps-stroke.xml b/reference/ps/functions/ps-stroke.xml index 865b995873ec..51f001751ded 100644 --- a/reference/ps/functions/ps-stroke.xml +++ b/reference/ps/functions/ps-stroke.xml @@ -1,7 +1,7 @@ - + ps_stroke Draws the current path @@ -21,19 +21,17 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + @@ -45,16 +43,13 @@ &reftitle.seealso; - - - ps_closepath_stroke - ps_fill - ps_fill_stroke - - + + ps_closepath_stroke + ps_fill + ps_fill_stroke + - - diff --git a/reference/ps/functions/ps-symbol-name.xml b/reference/ps/functions/ps-symbol-name.xml index 4807c2df2fc5..b0e32cc8ce72 100644 --- a/reference/ps/functions/ps-symbol-name.xml +++ b/reference/ps/functions/ps-symbol-name.xml @@ -1,7 +1,7 @@ - + ps_symbol_name Gets name of a glyph @@ -23,37 +23,35 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - ord - - - The parameter ord is the position of the glyph - in the font encoding vector. - - - - - fontid - - - The identifier of the font to be used. If not font is specified - the current font will be used. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + ord + + + The parameter ord is the position of the glyph + in the font encoding vector. + + + + + fontid + + + The identifier of the font to be used. If not font is specified + the current font will be used. + + + + @@ -65,15 +63,12 @@ &reftitle.seealso; - - - ps_symbol - ps_symbol_width - - + + ps_symbol + ps_symbol_width + - - diff --git a/reference/ps/functions/ps-symbol-width.xml b/reference/ps/functions/ps-symbol-width.xml index 84872d6af29f..b9e805a112fd 100644 --- a/reference/ps/functions/ps-symbol-width.xml +++ b/reference/ps/functions/ps-symbol-width.xml @@ -1,7 +1,7 @@ - + ps_symbol_width Gets width of a glyph @@ -25,45 +25,43 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - ord - - - The position of the glyph in the font encoding vector. - - - - - fontid - - - The identifier of the font to be used. If not font is specified - the current font will be used. - - - - - size - - - The size of the font. If no size is specified the current size - is used. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + ord + + + The position of the glyph in the font encoding vector. + + + + + fontid + + + The identifier of the font to be used. If not font is specified + the current font will be used. + + + + + size + + + The size of the font. If no size is specified the current size + is used. + + + + @@ -75,15 +73,12 @@ &reftitle.seealso; - - - ps_symbol - ps_symbol_name - - + + ps_symbol + ps_symbol_name + - - diff --git a/reference/ps/functions/ps-symbol.xml b/reference/ps/functions/ps-symbol.xml index 978e94dc2b8d..c5927b291e74 100644 --- a/reference/ps/functions/ps-symbol.xml +++ b/reference/ps/functions/ps-symbol.xml @@ -1,7 +1,7 @@ - + ps_symbol Output a glyph @@ -23,27 +23,25 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - ord - - - The position of the glyph in the font encoding vector. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + ord + + + The position of the glyph in the font encoding vector. + + + + @@ -55,15 +53,12 @@ &reftitle.seealso; - - - ps_symbol_name - ps_symbol_width - - + + ps_symbol_name + ps_symbol_width + - - diff --git a/reference/ps/functions/ps-translate.xml b/reference/ps/functions/ps-translate.xml index 5c4521bfec63..fd55022c2e30 100644 --- a/reference/ps/functions/ps-translate.xml +++ b/reference/ps/functions/ps-translate.xml @@ -1,7 +1,7 @@ - + ps_translate Sets translation @@ -22,35 +22,33 @@ &reftitle.parameters; - - - - psdoc - - - Resource identifier of the postscript file - as returned by ps_new. - - - - - x - - - x-coordinate of the origin of the translated coordinate system. - - - - - y - - - y-coordinate of the origin of the translated coordinate system. - - - - - + + + psdoc + + + Resource identifier of the postscript file + as returned by ps_new. + + + + + x + + + x-coordinate of the origin of the translated coordinate system. + + + + + y + + + y-coordinate of the origin of the translated coordinate system. + + + + @@ -62,10 +60,9 @@ &reftitle.examples; - - - Translation of the coordinate system - + + Translation of the coordinate system + ]]> - - The above example demonstrates two possible ways to place - a graphic (in this case just a rectangle) at any position on the page, - while the graphic itself uses its own coordinate system. The trick is - to change the origin of the current coordinate system before drawing - the rectangle. The translation has to be undone after the graphic has - been drawn. - - - On the second page a slightly different and more elegant approach is - applied. Instead of undoing the translation with a second call of - ps_translate the graphics context is saved before - modifying the coordinate system and restored after drawing the rectangle. - - - + + The above example demonstrates two possible ways to place + a graphic (in this case just a rectangle) at any position on the page, + while the graphic itself uses its own coordinate system. The trick is + to change the origin of the current coordinate system before drawing + the rectangle. The translation has to be undone after the graphic has + been drawn. + + + On the second page a slightly different and more elegant approach is + applied. Instead of undoing the translation with a second call of + ps_translate the graphics context is saved before + modifying the coordinate system and restored after drawing the rectangle. + + &reftitle.seealso; - - - ps_scale - ps_rotate - - + + ps_scale + ps_rotate + - - From 260b84a3e301ec1e6c07b181f76132953db3401d Mon Sep 17 00:00:00 2001 From: Gina Peter Banyard Date: Mon, 26 Jan 2026 14:23:15 +0000 Subject: [PATCH 2/2] ps : fix XML by converting para to simpara tags via script --- reference/ps/book.xml | 17 +-- reference/ps/configure.xml | 8 +- reference/ps/functions/ps-add-bookmark.xml | 24 ++-- reference/ps/functions/ps-add-launchlink.xml | 32 ++--- reference/ps/functions/ps-add-locallink.xml | 40 +++--- reference/ps/functions/ps-add-note.xml | 44 +++--- reference/ps/functions/ps-add-pdflink.xml | 44 +++--- reference/ps/functions/ps-add-weblink.xml | 32 ++--- reference/ps/functions/ps-arc.xml | 32 ++--- reference/ps/functions/ps-arcn.xml | 32 ++--- reference/ps/functions/ps-begin-page.xml | 36 ++--- reference/ps/functions/ps-begin-pattern.xml | 32 ++--- reference/ps/functions/ps-begin-template.xml | 20 +-- reference/ps/functions/ps-circle.xml | 24 ++-- reference/ps/functions/ps-clip.xml | 12 +- reference/ps/functions/ps-close-image.xml | 16 +-- reference/ps/functions/ps-close.xml | 20 +-- .../ps/functions/ps-closepath-stroke.xml | 12 +- reference/ps/functions/ps-closepath.xml | 12 +- reference/ps/functions/ps-continue-text.xml | 16 +-- reference/ps/functions/ps-curveto.xml | 36 ++--- reference/ps/functions/ps-delete.xml | 12 +- reference/ps/functions/ps-end-page.xml | 12 +- reference/ps/functions/ps-end-pattern.xml | 12 +- reference/ps/functions/ps-end-template.xml | 12 +- reference/ps/functions/ps-fill-stroke.xml | 12 +- reference/ps/functions/ps-fill.xml | 12 +- reference/ps/functions/ps-findfont.xml | 40 +++--- reference/ps/functions/ps-get-buffer.xml | 8 +- reference/ps/functions/ps-get-parameter.xml | 68 +++++----- reference/ps/functions/ps-get-value.xml | 128 +++++++++--------- reference/ps/functions/ps-hyphenate.xml | 20 +-- reference/ps/functions/ps-include-file.xml | 16 +-- reference/ps/functions/ps-lineto.xml | 20 +-- reference/ps/functions/ps-makespotcolor.xml | 20 +-- reference/ps/functions/ps-moveto.xml | 20 +-- reference/ps/functions/ps-new.xml | 8 +- reference/ps/functions/ps-open-file.xml | 16 +-- reference/ps/functions/ps-open-image-file.xml | 28 ++-- reference/ps/functions/ps-open-image.xml | 48 +++---- .../ps/functions/ps-open-memory-image.xml | 12 +- reference/ps/functions/ps-place-image.xml | 28 ++-- reference/ps/functions/ps-rect.xml | 28 ++-- reference/ps/functions/ps-restore.xml | 12 +- reference/ps/functions/ps-rotate.xml | 24 ++-- reference/ps/functions/ps-save.xml | 12 +- reference/ps/functions/ps-scale.xml | 20 +-- .../ps/functions/ps-set-border-color.xml | 24 ++-- reference/ps/functions/ps-set-border-dash.xml | 20 +-- .../ps/functions/ps-set-border-style.xml | 20 +-- reference/ps/functions/ps-set-info.xml | 32 ++--- reference/ps/functions/ps-set-parameter.xml | 20 +-- reference/ps/functions/ps-set-text-pos.xml | 24 ++-- reference/ps/functions/ps-set-value.xml | 36 ++--- reference/ps/functions/ps-setcolor.xml | 40 +++--- reference/ps/functions/ps-setdash.xml | 20 +-- reference/ps/functions/ps-setflat.xml | 16 +-- reference/ps/functions/ps-setfont.xml | 20 +-- reference/ps/functions/ps-setgray.xml | 16 +-- reference/ps/functions/ps-setlinecap.xml | 16 +-- reference/ps/functions/ps-setlinejoin.xml | 16 +-- reference/ps/functions/ps-setlinewidth.xml | 16 +-- reference/ps/functions/ps-setmiterlimit.xml | 16 +-- .../ps/functions/ps-setoverprintmode.xml | 16 +-- reference/ps/functions/ps-setpolydash.xml | 20 +-- reference/ps/functions/ps-shading-pattern.xml | 20 +-- reference/ps/functions/ps-shading.xml | 32 ++--- reference/ps/functions/ps-shfill.xml | 16 +-- reference/ps/functions/ps-show-boxed.xml | 94 ++++++------- reference/ps/functions/ps-show-xy.xml | 24 ++-- reference/ps/functions/ps-show-xy2.xml | 12 +- reference/ps/functions/ps-show.xml | 44 +++--- reference/ps/functions/ps-show2.xml | 20 +-- reference/ps/functions/ps-string-geometry.xml | 24 ++-- reference/ps/functions/ps-stringwidth.xml | 24 ++-- reference/ps/functions/ps-stroke.xml | 12 +- reference/ps/functions/ps-symbol-name.xml | 20 +-- reference/ps/functions/ps-symbol-width.xml | 24 ++-- reference/ps/functions/ps-symbol.xml | 16 +-- reference/ps/functions/ps-translate.xml | 28 ++-- reference/ps/reference.xml | 8 +- reference/ps/setup.xml | 13 +- 82 files changed, 998 insertions(+), 1010 deletions(-) diff --git a/reference/ps/book.xml b/reference/ps/book.xml index ae6d2cba9413..980cf08fbafe 100644 --- a/reference/ps/book.xml +++ b/reference/ps/book.xml @@ -1,37 +1,35 @@ - - + PostScript document creation PS - + &reftitle.intro; - + This module allows to create PostScript documents. It has many similarities with the pdf extension. Actually the API is almost identical and one can in many cases just replace the prefix of each function from pdf_ to ps_. This also works for functions which has no meaning in the PostScript document (like adding hyperlinks) but will have an effect if the document is converted to PDF. - - Documents created by this extension are sometimes even superior + + Documents created by this extension are sometimes even superior to documents created with the pdf extension, because pslib's text rendering functions can handle kerning, hyphenation and ligatures which results in much better output of boxed text. - + - + &reference.ps.setup; &reference.ps.constants; &reference.ps.reference; - - diff --git a/reference/ps/configure.xml b/reference/ps/configure.xml index 63b384c73267..b2074fe2762f 100644 --- a/reference/ps/configure.xml +++ b/reference/ps/configure.xml @@ -1,14 +1,12 @@ -
+
&reftitle.install; - + &pecl.info; &url.pecl.package;ps. - +
- - - + ps_show_xy2 Output text at position @@ -16,19 +16,18 @@ floatxcoor floatycoor - + &warn.undocumented.func; - + &reftitle.returnvalues; - + &return.success; - + - - diff --git a/reference/ps/functions/ps-show.xml b/reference/ps/functions/ps-show.xml index d22d31194d98..6c72476f6c00 100644 --- a/reference/ps/functions/ps-show.xml +++ b/reference/ps/functions/ps-show.xml @@ -14,72 +14,72 @@ resourcepsdoc stringtext - + Output a text at the current text position. The text position can be set by storing the x and y coordinates into the values textx and texty with the function ps_set_value. The function will issue an error if a font was not set before with ps_setfont. - - + + ps_show evaluates the following parameters and values as set by ps_set_parameter and ps_set_value. - + charspacing (value) - + Distance between two consecutive glyphs. If this value is unequal to zero then all ligatures will be resolved. Values less than zero are allowed. - + kerning (parameter) - + Setting this parameter to "false" will turn off kerning. Kerning is turned on by default. - + ligatures (parameter) - + Setting this parameter to "false" will turn off the use of ligatures. Ligatures are turned on by default. - + underline (parameter) - + Setting this parameter to "true" will turn on underlining. Underlining is turned off by default. - + overline (parameter) - + Setting this parameter to "true" will turn on overlining. Overlining is turned off by default. - + strikeout (parameter) - + Setting this parameter to "true" will turn on striking out. Striking out is turned off by default. - + @@ -91,18 +91,18 @@ psdoc - + Resource identifier of the postscript file as returned by ps_new. - + text - + The text to be output. - + @@ -110,9 +110,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/ps/functions/ps-show2.xml b/reference/ps/functions/ps-show2.xml index 0e76925f1e1f..b7c445e133a9 100644 --- a/reference/ps/functions/ps-show2.xml +++ b/reference/ps/functions/ps-show2.xml @@ -14,9 +14,9 @@ stringtext intlen - + Output text at the current position. Do not print more than len characters. - + @@ -25,26 +25,26 @@ psdoc - + Resource identifier of the postscript file as returned by ps_new. - + text - + The text to be output. - + len - + The maximum number of characters to print. - + @@ -52,9 +52,9 @@ &reftitle.returnvalues; - + &return.success; - + - - + PS &Functions;
Contact Information - + If you have comments, bugfixes, enhancements for either this extension or pslib then please drop me a mail steinm@php.net. Any help is very welcome. - +
@@ -20,7 +19,6 @@ &reference.ps.entities.functions; - - - + &reftitle.setup;
&reftitle.required; - + You need at least pslib >= 0.1.12. The ps library (pslib) is available at &url.pslib;. - +
@@ -21,15 +20,14 @@
&reftitle.resources; - + This extension defines a PostScript document resource returned by ps_new. - +
- -