summary refs log tree commit diff
path: root/pbmtextps.html
diff options
context:
space:
mode:
Diffstat (limited to 'pbmtextps.html')
-rw-r--r--pbmtextps.html21
1 files changed, 16 insertions, 5 deletions
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 \
           &quot;The soup is called&quot; &gt; a1.pbm
      $ pbmtextps -font=Itallic -descent=20 &quot;Goulash.&quot; &gt; a2.pbm
-     $ pnmcat -lr -jb a1.pbm a2.pbm &gt; out.pbm
+     $ pnmcat -leftright -jbottom a1.pbm a2.pbm &gt; 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>.