175 lines
9.3 KiB
HTML
175 lines
9.3 KiB
HTML
<head>
|
|
<title>jpg(1) - Plan 9 from User Space</title>
|
|
<meta content="text/html; charset=utf-8" http-equiv=Content-Type>
|
|
</head>
|
|
<body bgcolor=#ffffff>
|
|
<table border=0 cellpadding=0 cellspacing=0 width=100%>
|
|
<tr height=10><td>
|
|
<tr><td width=20><td>
|
|
<tr><td width=20><td><b>JPG(1)</b><td align=right><b>JPG(1)</b>
|
|
<tr><td width=20><td colspan=2>
|
|
<br>
|
|
<p><font size=+1><b>NAME </b></font><br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
jpg, gif, png, ppm, bmp, yuv, ico, togif, toppm, topng, toico
|
|
– view and convert pictures<br>
|
|
|
|
</table>
|
|
<p><font size=+1><b>SYNOPSIS </b></font><br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
<tt><font size=+1>jpg</font></tt> [ <tt><font size=+1>−39cdefFkJrtv</font></tt> ] [ <i>file ...</i> ]<br>
|
|
<tt><font size=+1>gif</font></tt> [ <tt><font size=+1>−39cdektv</font></tt> ] [ <i>file ...</i> ]<br>
|
|
<tt><font size=+1>png</font></tt> [ <tt><font size=+1>−39cdektv</font></tt> ] [ <i>file ...</i> ]<br>
|
|
<tt><font size=+1>ppm</font></tt> [ <tt><font size=+1>−39cdektv</font></tt> ] [ <i>file ...</i> ]<br>
|
|
<tt><font size=+1>bmp</font></tt> [ <i>file</i> ]<br>
|
|
<tt><font size=+1>yuv</font></tt> [ <i>file</i> ]
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
<tt><font size=+1>togif</font></tt> [ <tt><font size=+1>−c</font></tt> <i>comment</i> ] [ <tt><font size=+1>−l</font></tt> <i>loopcount</i> ] [ <tt><font size=+1>−d</font></tt> <i>msec</i> ] [ <tt><font size=+1>−t</font></tt> <i>transindex</i>
|
|
] [ <i>file ...</i> [ <tt><font size=+1>−d</font></tt> <i>msec</i> ] <i>file ...</i> ]<br>
|
|
<tt><font size=+1>toppm</font></tt> [ <tt><font size=+1>−c</font></tt> <i>comment</i> ] [ <i>file</i> ]<br>
|
|
<tt><font size=+1>topng</font></tt> [ <tt><font size=+1>−c</font></tt> <i>comment</i> ] [ [ <tt><font size=+1>−g</font></tt> <i>gamma</i> ] [ <i>file</i> ]
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
<tt><font size=+1>ico</font></tt> [ <i>file</i> ]<br>
|
|
<tt><font size=+1>toico</font></tt> [ <i>file ...</i> ]<br>
|
|
|
|
</table>
|
|
<p><font size=+1><b>DESCRIPTION </b></font><br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
These programs read, display, and write image files in public
|
|
formats. <i>Jpg</i>, <i>gif</i>, <i>png</i>, <i>ppm</i>, <i>bmp</i>, and <i>yuv</i>. read files in the corresponding
|
|
formats and, by default, display them in the current window; options
|
|
cause them instead to convert the images to Plan 9 image format
|
|
and write them to standard output. <i>Togif</i>,
|
|
<i>Toppm</i>, and <i>topng</i> read Plan 9 images files, convert them to GIF,
|
|
PPM, or PNG, and write them to standard output.
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
The default behavior of <i>jpg</i>, <i>gif</i>, and <i>ppm</i> is to display the <i>file</i>,
|
|
or standard input if no file is named. Once a file is displayed,
|
|
typing a character causes the program to display the next image.
|
|
Typing a <tt><font size=+1>q</font></tt>, DEL, or control-D exits the program. For a more user-friendly
|
|
interface, use <a href="../man1/page.html"><i>page</i>(1)</a>, which invokes these
|
|
programs to convert the images to standard format, displays them,
|
|
and offers scrolling, panning, and menu-driven navigation among
|
|
the files.
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
These programs share many options:<br>
|
|
<tt><font size=+1>−e</font></tt> Disable Floyd-Steinberg error diffusion, which is used to improve
|
|
the appearance of images on color-mapped displays, typically with
|
|
8 bits per pixel. Primarily useful for debugging; if the display
|
|
has true RGB color, the image will be displayed in full glory.<br>
|
|
<tt><font size=+1>−k</font></tt> Convert and display the image as a black and white (really grey-scale)
|
|
image.<br>
|
|
<tt><font size=+1>−v</font></tt> Convert the image to an RGBV color-mapped image, even if the
|
|
display has true RGB color.<br>
|
|
<tt><font size=+1>−d</font></tt> Suppress display of the image; this is set automatically by
|
|
any of the following options:<br>
|
|
<tt><font size=+1>−c</font></tt> Convert the image to a Plan 9 representation, as defined by
|
|
<a href="../man7/image.html"><i>image</i>(7)</a>, and write it to standard output.<br>
|
|
<tt><font size=+1>−9</font></tt> Like <tt><font size=+1>−c</font></tt>, but produce an uncompressed image. This saves processing
|
|
time, particularly when the output is being piped to another program
|
|
such as <a href="../man1/page.html"><i>page</i>(1)</a>, since it avoids compression and decompression.<br>
|
|
<tt><font size=+1>−t</font></tt> Convert the image, if it is in color, to a true color RGB image.<br>
|
|
<tt><font size=+1>−3</font></tt> Like <tt><font size=+1>−t</font></tt>, but force the image to RGB even if it is originally
|
|
grey-scale.
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
<i>Jpg</i> has two extra options used to process the output of the LML
|
|
video card:<br>
|
|
<tt><font size=+1>−f</font></tt> Merge two adjacent images, which represent the two fields of
|
|
a video picture, into a single image.<br>
|
|
<tt><font size=+1>−F</font></tt> The input is a motion JPEG file, with multiple images representing
|
|
frames of the movie. Sets <tt><font size=+1>−f</font></tt>.
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
The <i>togif</i> and <i>toppm</i> programs go the other way: they convert from
|
|
Plan 9 images to GIF and PPM, and have no display capability.
|
|
Both accept an option <tt><font size=+1>−c</font></tt> to set the comment field of the resulting
|
|
file. If there is only one input picture, <i>togif</i> converts the image
|
|
to GIF format. If there are many <i>files</i>, though, it will
|
|
assemble them into an animated GIF file. The options control this
|
|
process:<br>
|
|
<tt><font size=+1>−l</font></tt><i>loopcount<br>
|
|
</i>
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
By default, the animation will loop forever; <i>loopcount</i> specifies
|
|
how many times to loop. A value of zero means loop forever and
|
|
a negative value means to stop after playing the sequence once.<br>
|
|
|
|
</table>
|
|
<tt><font size=+1>−d</font></tt><i>msec<br>
|
|
</i>
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
By default, the images are displayed as fast as they can be rendered.
|
|
This option specifies the time, in milliseconds, to pause while
|
|
displaying the next named <i>file</i>.
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
|
|
</table>
|
|
<i>Gif</i> translates files that contain a ‘transparency’ index by attaching
|
|
an alpha channel to the converted image.
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
<i>Ico</i> displays a Windows icon (.ico) file. If no file is specified,
|
|
<i>ico</i> reads from standard input. Icon files contain sets of icons
|
|
represeted by an image and a mask. Clicking the right button pops
|
|
up a menu that lets you write any icon’s image as a Plan 9 image
|
|
(<i>width</i>x<i>height</i>.image), write any icon’s mask as a Plan 9
|
|
image (<i>width</i>x<i>height</i>.mask), or exit. Selecting one of the write
|
|
menu items yields a sight cursor. Move the sight over the icon
|
|
and right click again to write.
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=5><td></table>
|
|
|
|
<i>Toico</i> takes a list of Plan 9 image files (or standard input) and
|
|
creates a single icon file. The masks in the icon file will be
|
|
the white space in the image. The icon file is written to standard
|
|
output.<br>
|
|
|
|
</table>
|
|
<p><font size=+1><b>SOURCE </b></font><br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
<tt><font size=+1>/usr/local/plan9/src/cmd/jpg<br>
|
|
</font></tt>
|
|
</table>
|
|
<p><font size=+1><b>SEE ALSO </b></font><br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
<a href="../man1/page.html"><i>page</i>(1)</a>, <a href="../man7/image.html"><i>image</i>(7)</a>.<br>
|
|
|
|
</table>
|
|
<p><font size=+1><b>BUGS </b></font><br>
|
|
|
|
<table border=0 cellpadding=0 cellspacing=0><tr height=2><td><tr><td width=20><td>
|
|
|
|
Writing an animated GIF using <i>togif</i> is a clumsy undertaking.<br>
|
|
|
|
</table>
|
|
|
|
<td width=20>
|
|
<tr height=20><td>
|
|
</table>
|
|
<!-- TRAILER -->
|
|
<table border=0 cellpadding=0 cellspacing=0 width=100%>
|
|
<tr height=15><td width=10><td><td width=10>
|
|
<tr><td><td>
|
|
<center>
|
|
<a href="../../"><img src="../../dist/spaceglenda100.png" alt="Space Glenda" border=1></a>
|
|
</center>
|
|
</table>
|
|
<!-- TRAILER -->
|
|
</body></html>
|