home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / NETWORK / netpbm_docs.lzh / NETPBM / DOCS / pbmtext.1 < prev    next >
Text File  |  1996-11-18  |  2KB  |  77 lines
  1. .TH pbmtext 1 "26 October 1993"
  2. .IX pbmtext
  3. .SH NAME
  4. pbmtext - render text into a bitmap
  5. .SH SYNOPSIS
  6. .B pbmtext
  7. .RB [ \-font
  8. .IR fontfile ]
  9. .RB [ \-builtin
  10. .IR fontname ]
  11. .RI [ text ]
  12. .SH DESCRIPTION
  13. .PP
  14. Takes the specified text, either a single line from the command
  15. line or multiple lines from standard input, and renders it
  16. into a bitmap.
  17. .IX text
  18. .SH OPTIONS
  19. .PP
  20. By default, pbmtext uses a built-in font called bdf
  21. (about a 10 point Times-Roman font).
  22. You can use a fixed width font by specifying \-builtin fixed.
  23. .PP
  24. You can also specify your own font with the
  25. .B -font
  26. flag.
  27. The
  28. .I fontfile
  29. is either a BDF file from the X window system or a PBM file.
  30. .PP
  31. If the
  32. .I fontfile
  33. is a PBM file, it is created in a very specific way.
  34. In your window system of choice, display the following text
  35. in the desired (fixed-width) font:
  36. .nf
  37.  
  38.     M ",/^_[`jpqy| M
  39.  
  40.     /  !"#$%&'()*+ /
  41.     < ,-./01234567 <
  42.     > 89:;<=>?@ABC >
  43.     @ DEFGHIJKLMNO @
  44.     _ PQRSTUVWXYZ[ _
  45.     { \\]^_`abcdefg {
  46.     } hijklmnopqrs }
  47.     ~ tuvwxyz{|}~  ~
  48.  
  49.     M ",/^_[`jpqy| M
  50.  
  51. .fi
  52. Do a screen grab or window dump of that text, using for instance
  53. .IR xwd ,
  54. .IR xgrabsc ,
  55. or
  56. .IR screendump .
  57. Convert the result into a pbm file.
  58. If necessary, use
  59. .I pnmcut
  60. to remove everything except the text.
  61. Finally, run it through
  62. .I pnmcrop
  63. .IX pnmcrop
  64. to make sure the edges are right up against the text.
  65. .I pbmtext
  66. can figure out the sizes and spacings from that.
  67. .SH "SEE ALSO"
  68. pbm(5), pnmcut(1), pnmcrop(1)
  69. .SH AUTHOR
  70. Copyright (C) 1993 by Jef Poskanzer and George Phillips
  71. .\" Permission to use, copy, modify, and distribute this software and its
  72. .\" documentation for any purpose and without fee is hereby granted, provided
  73. .\" that the above copyright notice appear in all copies and that both that
  74. .\" copyright notice and this permission notice appear in supporting
  75. .\" documentation.  This software is provided "as is" without express or
  76. .\" implied warranty.
  77.