Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
RLESETBG(1)		    General Commands Manual		   RLESETBG(1)

NAME
       rlesetbg	- Set the background value in the RLE header.

SYNOPSIS
       rlesetbg	[ -{DO}	] [ -c bgcolor ...  ] [	-o outfile ] [ infile ]

DESCRIPTION
       rlesetbg	 sets  the  background	color  field in	the image header of an
       RLE(5) image (none of the actual	pixels are changed).  If infile	 isn't
       specified, the image is read from stdin.

       The  background	color  in the header is	used to	save space in the run-
       length encoded file.  Runs of background-colored	pixels longer  than  2
       pixels are simply not saved.  (Doing this for runs of 1 or 2 background
       pixels can make the saved image larger than if no encoding were	done.)
       Therefore,  changing the	background color with rlesetbg may still leave
       some pixels saved in the	original background color.  The	-D option will
       delete  the  background	color  altogether from the header; this	can be
       useful in certain circumstances,	but can	also lead to very strange  re-
       sults.

OPTIONS
       -D     Delete any background specification that might be	present.

       -O     Specifies	that the image has no background, it overlays existing
	      images.

       -c bgcolor ...
	      Specifies	the color values to  set  the  background  to.	 There
	      should be	at least as many values	as there are color channels in
	      the image.  Use -- or another option to  separate	 the  list  of
	      colors from infile.

       -o outfile
	      If  specified, the output	will be	written	to this	file.  If out-
	      file is "-", or if it is not specified, the output will be writ-
	      ten to the standard output stream.

AUTHORS
       John W. Peterson	and Rod	Bogart

SEE ALSO
       repos(1), urt(1), RLE(5).

BUGS
       This  should  really  be	 part of a single program that does all	header
       munging...

4th Berkeley Distribution      December	20, 1986		   RLESETBG(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | AUTHORS | SEE ALSO | BUGS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=rlesetbg&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help