diff options
author | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2022-06-04 18:35:21 +0000 |
---|---|---|
committer | giraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8> | 2022-06-04 18:35:21 +0000 |
commit | c764cea8014b4108173e10a76b16d68b276401f3 (patch) | |
tree | d97a19c822180371f9639a749dcf7a49e130f20a | |
parent | 22988d8d10f646a31999f65712326d27c089b65a (diff) | |
download | netpbm-mirror-c764cea8014b4108173e10a76b16d68b276401f3.tar.gz netpbm-mirror-c764cea8014b4108173e10a76b16d68b276401f3.tar.xz netpbm-mirror-c764cea8014b4108173e10a76b16d68b276401f3.zip |
miscellaneous update
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@4348 9d0c8265-081b-0410-96cb-a4ca84ce46f8
-rw-r--r-- | pamtoqoi.html | 62 | ||||
-rw-r--r-- | pbmtextps.html | 21 | ||||
-rw-r--r-- | pnmcat.html | 12 | ||||
-rw-r--r-- | qoitopam.html | 62 |
4 files changed, 146 insertions, 11 deletions
diff --git a/pamtoqoi.html b/pamtoqoi.html new file mode 100644 index 00000000..e9241aad --- /dev/null +++ b/pamtoqoi.html @@ -0,0 +1,62 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN"> +<html><head><title>Pamtoqoi User Manual</title></head> +<body> +<h1>pamtoqoi</h1> +Updated: 21 May 2022 + +<a href="#index">Table Of Contents</a> + +<h2>NAME</h2> +pamtoqoi - Convert Netpbm image to QOI format (Quite OK Image format) + + +<h2 id="synopsis">SYNOPSIS</h2> +<b>pamtoqoi</b> + +<p>All options can be abbreviated to their shortest unique prefix. +You may use two hyphens instead of one. You may separate an option +name and its value with white space instead of an equals sign. + + +<h2 id="description">DESCRIPTION</h2> + +<p>This program is part of <a href="index.html">Netpbm</a>. + +<p><b>pamtoqoi</b> reads a Netpbm image from standard input and converts it to +a QOI image written to standard output. + +<p>For the QOI specification and details, see +<a href="http://qoiformat.org">the QOI web site</a>. + +<p>Use <a href="qoitopam.html"><b>qoitopam</b></a> to convert a QOI +image to Netpbm format. + + +<h2 id="options">OPTIONS</h2> + +<p>The only options are those common to all programs based on libnetpbm +(most notably <b>-quiet</b>, see <a href="index.html#commonoptions"> +Common Options</a>). + + +<h2 id="seealso">SEE ALSO</h2> + +<b><a href="qoitopam.html">qoitopam</a></b>, +<b><a href="pam.html">pam</a></b> + + +<h2 id="history">HISTORY</h2> + +<p><b>pamtoqoi</b> was new in Netpbm 10.99 (June 2022). + +<hr> +<h2 id="index">Table Of Contents</h2> +<ul> +<li><a href="#synopsis">SYNOPSIS</a> +<li><a href="#description">DESCRIPTION</a> +<li><a href="#options">OPTIONS</a> +<li><a href="#seealso">SEE ALSO</a> +<li><a href="#history">HISTORY</a> +</ul> +</body> +</html> diff --git a/pbmtextps.html b/pbmtextps.html index 7cc77c8a..f64124a7 100644 --- a/pbmtextps.html +++ b/pbmtextps.html @@ -2,7 +2,7 @@ <html><head><title>Pbmtextps User Manual</title></head> <body> <h1>pbmtextps</h1> -Updated: 15 June 2016 +Updated: 04 June 2022 <br> <a href="#index">Table Of Contents</a> @@ -63,9 +63,10 @@ to reach a specified distance below the text baseline. <p><b>-ascent</b> and <b>-descent</b> are more useful than <b>-topmargin</b> and <b>-bottomargin</b> when you render two pieces of text (in separate invocations of <b>pbmtextps</b>) that you will concatenate horizontally. -With <b>-ascent</b> and <b>-descent</b>, the two images will be the same -height with the text baseline in the same place. With <b>-topmargin</b> -and <b>-bottommargin</b>, that may not be the case. +With <b>-ascent</b> and <b>-descent</b>, as long as you specify a value +greater than the height or detph of every character in the font, the two +images will be the same height with the text baseline in the same place. +With <b>-topmargin</b> and <b>-bottommargin</b>, that may not be the case. <p>Example: @@ -74,10 +75,20 @@ and <b>-bottommargin</b>, that may not be the case. $ pbmtextps -font=Times-Roman -descent=20 \ "The soup is called" > a1.pbm $ pbmtextps -font=Itallic -descent=20 "Goulash." > a2.pbm - $ pnmcat -lr -jb a1.pbm a2.pbm > out.pbm + $ pnmcat -leftright -jbottom a1.pbm a2.pbm > out.pbm </kbd> </pre> +<p>If you're using <b>-descent</b> to line up the segments of text you are + concatenating horizontally with <b>pnmcat</b>, use the <b>-jbottom</b> + (justify to bottom) option on <b>pnmcat</b> as in the example above. If you + use <b>-ascent</b>, use <b>-jtop</b> instead. + +<p>Similarly, if you render two lines of text (in separate invocations of + <b>pbmtextps</b>) that you will concatenate vertically, <b>-ascent</b> and + <b>-descent</b> with sufficiently large values will ensure your baselines + are uniformly spaced. + <p>If you have <b>-ascent</b>, there is probably no point in specifying <b>-topmargin</b> too, but if you do, the effect is cumulative. The same is true of <b>-descent</b> and <b>-bottommargin</b>. diff --git a/pnmcat.html b/pnmcat.html index 4c4b510b..b8cbfc6e 100644 --- a/pnmcat.html +++ b/pnmcat.html @@ -73,17 +73,17 @@ command line options: <h3 id="justification">Justification</h3> <dl compact> -<dt><b>-jleft</b>, <b>-jcenter</b>, <b>-jright</b> +<dt><b>jtop</b>, <b>jbottom</b>, <b>-jleft</b>, <b>-jright</b>, + <b>-jcenter</b>, <dd> If the PNM images are not all the same height when you're concatenating left to right or width when you're concatenating top to bottom, the smaller ones have to be justified with the largest. By default, <b>pnmcat</b> centers them, but you can specify justification to one side or the other with one of - the -<b>-j</b><i>xxx</i> options. So, <b>-topbottom -jleft</b> would stack the -PNMs on top of each other, flush with the left edge. <b>-leftright --jbottom</b> would line up the images left to right with their bottom edges -aligned as if sitting on a table. + the <b>-j</b><i>xxx</i> options. So, <b>-topbottom -jleft</b> would stack + the PNMs on top of each other, flush with the left edge. <b>-leftright + -jbottom</b> would line up the images left to right with their bottom edges + aligned as if sitting on a table. </dl> <h3 id="margincolor">Margin Color</h3> diff --git a/qoitopam.html b/qoitopam.html new file mode 100644 index 00000000..8ad4af1a --- /dev/null +++ b/qoitopam.html @@ -0,0 +1,62 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN"> +<html><head><title>Qoitopam User Manual</title></head> +<body> +<h1>qoitopam</h1> +Updated: 21 May 2022 + +<a href="#index">Table Of Contents</a> + +<h2>NAME</h2> +pamtoqoi - Convert QOI format (Quite OK Image format) to Netpbm. + + +<h2 id="synopsis">SYNOPSIS</h2> +<b>qoitopam</b> + +<p>All options can be abbreviated to their shortest unique prefix. +You may use two hyphens instead of one. You may separate an option +name and its value with white space instead of an equals sign. + + +<h2 id="description">DESCRIPTION</h2> + +<p>This program is part of <a href="index.html">Netpbm</a>. + +<p><b>qoitopam</b> reads a QOI image from standard input and converts it to a +Netpbm image written to standard output. + +<p>For the QOI specification and details, see +<a href="http://qoiformat.org">the QOI web site</a>. + +<p>Use <a href="pamtoqoi.html"><b>pamtoqoi</b></a> to convert a Netpbm +image to QOI format. + + +<h2 id="options">OPTIONS</h2> + +<p>The only options are those common to all programs based on libnetpbm +(most notably <b>-quiet</b>, see <a href="index.html#commonoptions"> +Common Options</a>). + + +<h2 id="seealso">SEE ALSO</h2> + +<b><a href="pamtoqoi.html">pamtoqoi</a></b>, +<b><a href="pam.html">pam</a></b> + + +<h2 id="history">HISTORY</h2> + +<p><b>pamtoqoi</b> was new in Netpbm 10.99 (June 2022). + +<hr> +<h2 id="index">Table Of Contents</h2> +<ul> +<li><a href="#synopsis">SYNOPSIS</a> +<li><a href="#description">DESCRIPTION</a> +<li><a href="#options">OPTIONS</a> +<li><a href="#seealso">SEE ALSO</a> +<li><a href="#history">HISTORY</a> +</ul> +</body> +</html> |