Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

RedHat 9 (Linux i386) - man page for ppmlabel (redhat section 1)

ppmlabel(1)			     General Commands Manual			      ppmlabel(1)

NAME
       ppmlabel - add text to a portable pixmap

SYNOPSIS
       ppmlabel [-angle angle] [-background transparent | colour] [-colour colour] [-file
		filename] [-size textsize] [-text 'text string'] [-x column] [-y row] ...
		[ppmfile]

DESCRIPTION
       ppmlabel  uses  the  text  drawing facilities of ppmdraw to add text to a portable pixmap.
       The location, size, baseline angle, colour of the text and background colour (if any)  are
       controlled  by  command	line arguments.  The text can be specified on the command line or
       read from files.  Any number of separate text strings can be added by  one  invocation  of
       ppmlabel, limited only by the maximum length of the command line.

       If no ppmfile is specified, ppmdraw reads its input pixmap from standard input.

OPTIONS
       The  arguments  on the ppmlabel command line are not options in the strict sense; they are
       commands which control the placement and appearance of the text being added to  the  input
       pixmap.	They are executed left to right, and any number of arguments may appear.

       All flags can be abbreviated to their shortest unique prefix.

       -angle angle
		 Sets the angle of the baseline of subsequent text.  angle is specified as an in-
		 tegral number of degrees, measured counterclockwise from the  row  axis  of  the
		 pixmap.

       -background transparent | colour
		 If  the  argument  is ``transparent'', text is drawn over the existing pixels in
		 the pixmap.  If a colour is given (see the -colour switch below for  information
		 on how to specify colours), rectangles enclosing subsequent text are filled with
		 that colour.

       -colour colour
		 Sets the colour for subsequent text.  The colour can be specified in five ways:

		 o	A name, assuming that a pointer to an X11-style  colour  names	file  was
			compiled in.

		 o	An  X11-style  hexadecimal specifier: rgb:r/g/b, where r g and b are each
			1- to 4-digit hexadecimal numbers.

		 o	An X11-style decimal specifier: rgbi:r/g/b, where r g and b are  floating
			point numbers between 0 and 1.

		 o	For  backwards	compatibility, an old-X11-style hexadecimal number: #rgb,
			#rrggbb, #rrrgggbbb, or #rrrrggggbbbb.

		 o	For backwards compatibility, a triplet of numbers  separated  by  commas:
			r,g,b, where r g and b are floating point numbers between 0 and 1.  (This
			style was added before MIT came up with the similar rgbi style.)

       -file filename
		 Reads text from the file filename and draws it on successive lines.

       -size textsize
		 Sets the height of the tallest characters above the baseline to textsize pixels.

       -text 'text string'
		 Draws the given text string (which must be quoted if it contains  spaces).   The
		 location  for	subsequent  text  is advanced by 1.75 times the current textsize,
		 which allows drawing multiple lines of text in a reasonable manner without spec-
		 ifying the position of each line.

       -x column Sets  the  column at which subsequent text will be left justified.  Depending on
		 the shape of the first character, the actual text may begin a few pixels to  the
		 right of this point.

       -y row	 Sets  the  row which will form the baseline of subsequent text.  Characters with
		 descenders, such as ``y'', will extend below this line.

BUGS
       Text strings are restricted to 7 bit ASCII.  The text font used by ppmdraw doesn't include
       definitions for 8 bit ISO 8859/1 characters.

       When  drawing multiple lines of text with a non-transparent background, it should probably
       fill the space between the lines with the background colour.  This is tricky to get  right
       when the text is rotated to a non-orthogonal angle.

SEE ALSO
       ppmmake(1), ppm(5)

AUTHOR
			Copyright (C) 1995 by John Walker (kelvin@fourmilab.ch)
				WWW home page: http://www.fourmilab.ch/

       Permission  to  use,  copy, modify, and distribute this software and its documentation for
       any purpose and without fee is hereby granted, without  any  conditions	or  restrictions.
       This software is provided ``as is'' without express or implied warranty.

					   14 June 1995 			      ppmlabel(1)


All times are GMT -4. The time now is 09:56 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password