man-pages/man1/identify-im6.q16.1.html
2021-03-31 01:06:50 +01:00

123 lines
11 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of identify-im6.q16</TITLE>
</HEAD><BODY>
<H1>identify-im6.q16</H1>
Section: User Commands (1)<BR>Updated: Date: 2009/01/10 01:00:00<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
identify - describes the format and characteristics of one or more image files.
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<DL COMPACT>
<DT id="1"><B>identify-im6.q16</B> [<I>options</I>] <I>input-file</I><DD>
</DL>
<A NAME="lbAD">&nbsp;</A>
<H2>OVERVIEW</H2>
The <B>identify-im6.q16</B> program is a member of the <A HREF="/cgi-bin/man/man2html?1+ImageMagick-ims6.q16">ImageMagick-ims6.q16</A>(1) suite of tools. It describes the format and characteristics of one or more image files. It also reports if an image is incomplete or corrupt. The information returned includes the image number, the file name, the width and height of the image, whether the image is colormapped or not, the number of colors in the image (by default off use <I>-define unique=true</I> option), the number of bytes in the image, the format of the image (JPEG, PNM, etc.), and finally the number of seconds it took to read and process the image. Many more attributes are available with the verbose option.
<P>
For more information about the identify command, point your browser to <A HREF="file:///usr/share/doc/imagemagick-6-common/html/www/identify.html">file:///usr/share/doc/imagemagick-6-common/html/www/identify.html</A> (on debian system you may install the imagemagick-6 package) or <A HREF="https://www.imagemagick.org/script/identify.php.">https://www.imagemagick.org/script/identify.php.</A>
<A NAME="lbAE">&nbsp;</A>
<H2>DESCRIPTION</H2>
Image Settings:
<BR>&nbsp;&nbsp;-alpha&nbsp;option&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;on,&nbsp;activate,&nbsp;off,&nbsp;deactivate,&nbsp;set,&nbsp;opaque,&nbsp;copy
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;transparent,&nbsp;extract,&nbsp;background,&nbsp;or&nbsp;shape
<BR>&nbsp;&nbsp;-antialias&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;remove&nbsp;pixel-aliasing
<BR>&nbsp;&nbsp;-authenticate&nbsp;value&nbsp;&nbsp;decrypt&nbsp;image&nbsp;with&nbsp;this&nbsp;password
<BR>&nbsp;&nbsp;-channel&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;apply&nbsp;option&nbsp;to&nbsp;select&nbsp;image&nbsp;channels
<BR>&nbsp;&nbsp;-clip&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;clip&nbsp;along&nbsp;the&nbsp;first&nbsp;path&nbsp;from&nbsp;the&nbsp;8BIM&nbsp;profile
<BR>&nbsp;&nbsp;-clip-mask&nbsp;filename&nbsp;&nbsp;associate&nbsp;a&nbsp;clip&nbsp;mask&nbsp;with&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-clip-path&nbsp;id&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;clip&nbsp;along&nbsp;a&nbsp;named&nbsp;path&nbsp;from&nbsp;the&nbsp;8BIM&nbsp;profile
<BR>&nbsp;&nbsp;-colorspace&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;alternate&nbsp;image&nbsp;colorspace
<BR>&nbsp;&nbsp;-crop&nbsp;geometry&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cut&nbsp;out&nbsp;a&nbsp;rectangular&nbsp;region&nbsp;of&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-define&nbsp;format:option
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;define&nbsp;one&nbsp;or&nbsp;more&nbsp;image&nbsp;format&nbsp;options
<BR>&nbsp;&nbsp;-define&nbsp;unique=true&nbsp;&nbsp;return&nbsp;the&nbsp;number&nbsp;of&nbsp;unique&nbsp;colors&nbsp;in&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-density&nbsp;geometry&nbsp;&nbsp;&nbsp;&nbsp;horizontal&nbsp;and&nbsp;vertical&nbsp;density&nbsp;of&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-depth&nbsp;value&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;image&nbsp;depth
<BR>&nbsp;&nbsp;-endian&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;endianness&nbsp;(MSB&nbsp;or&nbsp;LSB)&nbsp;of&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-extract&nbsp;geometry&nbsp;&nbsp;&nbsp;&nbsp;extract&nbsp;area&nbsp;from&nbsp;image
<BR>&nbsp;&nbsp;-features&nbsp;distance&nbsp;&nbsp;&nbsp;analyze&nbsp;image&nbsp;features&nbsp;(e.g.&nbsp;contrast,&nbsp;correlation)
<BR>&nbsp;&nbsp;-format&nbsp;&quot;string&quot;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;output&nbsp;formatted&nbsp;image&nbsp;characteristics
<BR>&nbsp;&nbsp;-fuzz&nbsp;distance&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;colors&nbsp;within&nbsp;this&nbsp;distance&nbsp;are&nbsp;considered&nbsp;equal
<BR>&nbsp;&nbsp;-gamma&nbsp;value&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;of&nbsp;gamma&nbsp;correction
<BR>&nbsp;&nbsp;-interlace&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;type&nbsp;of&nbsp;image&nbsp;interlacing&nbsp;scheme
<BR>&nbsp;&nbsp;-interpolate&nbsp;method&nbsp;&nbsp;pixel&nbsp;color&nbsp;interpolation&nbsp;method
<BR>&nbsp;&nbsp;-limit&nbsp;type&nbsp;value&nbsp;&nbsp;&nbsp;&nbsp;pixel&nbsp;cache&nbsp;resource&nbsp;limit
<BR>&nbsp;&nbsp;-list&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Color,&nbsp;Configure,&nbsp;Delegate,&nbsp;Format,&nbsp;Magic,&nbsp;Module,
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Resource,&nbsp;or&nbsp;Type
<BR>&nbsp;&nbsp;-mask&nbsp;filename&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;associate&nbsp;a&nbsp;mask&nbsp;with&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-matte&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;store&nbsp;matte&nbsp;channel&nbsp;if&nbsp;the&nbsp;image&nbsp;has&nbsp;one
<BR>&nbsp;&nbsp;-moments&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;report&nbsp;image&nbsp;moments
<BR>&nbsp;&nbsp;-monitor&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;monitor&nbsp;progress
<BR>&nbsp;&nbsp;-ping&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;efficiently&nbsp;determine&nbsp;image&nbsp;attributes
<BR>&nbsp;&nbsp;-precision&nbsp;value&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;maximum&nbsp;number&nbsp;of&nbsp;significant&nbsp;digits&nbsp;to&nbsp;print
<BR>&nbsp;&nbsp;-quiet&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;suppress&nbsp;all&nbsp;warning&nbsp;messages
<BR>&nbsp;&nbsp;-regard-warnings&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;pay&nbsp;attention&nbsp;to&nbsp;warning&nbsp;messages
<BR>&nbsp;&nbsp;-respect-parentheses&nbsp;settings&nbsp;remain&nbsp;in&nbsp;effect&nbsp;until&nbsp;parenthesis&nbsp;boundary
<BR>&nbsp;&nbsp;-sampling-factor&nbsp;geometry
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;horizontal&nbsp;and&nbsp;vertical&nbsp;sampling&nbsp;factor
<BR>&nbsp;&nbsp;-seed&nbsp;value&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;seed&nbsp;a&nbsp;new&nbsp;sequence&nbsp;of&nbsp;pseudo-random&nbsp;numbers
<BR>&nbsp;&nbsp;-set&nbsp;attribute&nbsp;value&nbsp;set&nbsp;an&nbsp;image&nbsp;attribute
<BR>&nbsp;&nbsp;-size&nbsp;geometry&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;width&nbsp;and&nbsp;height&nbsp;of&nbsp;image
<BR>&nbsp;&nbsp;-strip&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;strip&nbsp;image&nbsp;of&nbsp;all&nbsp;profiles&nbsp;and&nbsp;comments
<BR>&nbsp;&nbsp;-unique&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;display&nbsp;the&nbsp;number&nbsp;of&nbsp;unique&nbsp;colors&nbsp;in&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-units&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;the&nbsp;units&nbsp;of&nbsp;image&nbsp;resolution
<BR>&nbsp;&nbsp;-verbose&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;detailed&nbsp;information&nbsp;about&nbsp;the&nbsp;image
<BR>&nbsp;&nbsp;-virtual-pixel&nbsp;method
<BR>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;virtual&nbsp;pixel&nbsp;access&nbsp;method
<P>
Image Operators:
<BR>&nbsp;&nbsp;-grayscale&nbsp;method&nbsp;&nbsp;&nbsp;&nbsp;convert&nbsp;image&nbsp;to&nbsp;grayscale
<BR>&nbsp;&nbsp;-negate&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;replace&nbsp;each&nbsp;pixel&nbsp;with&nbsp;its&nbsp;complementary&nbsp;color&nbsp;
<P>
Miscellaneous Options:
<BR>&nbsp;&nbsp;-debug&nbsp;events&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;display&nbsp;copious&nbsp;debugging&nbsp;information
<BR>&nbsp;&nbsp;-help&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;program&nbsp;options
<BR>&nbsp;&nbsp;-list&nbsp;type&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;a&nbsp;list&nbsp;of&nbsp;supported&nbsp;option&nbsp;arguments
<BR>&nbsp;&nbsp;-log&nbsp;format&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;format&nbsp;of&nbsp;debugging&nbsp;information
<BR>&nbsp;&nbsp;-version&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;print&nbsp;version&nbsp;information
<P>
By default, the image format of `file' is determined by its magic number. To specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps). Specify 'file' as '-' for standard input or output.
<A NAME="lbAF">&nbsp;</A>
<H2>NOTE</H2>
Although some options appear to modify the file to be identified, the identify command is strictly <B>read only</B>. For instance, the crop option crops the in-memory image and then describes the result.
<P>
<A NAME="lbAG">&nbsp;</A>
<H2>SEE ALSO</H2>
<A HREF="/cgi-bin/man/man2html?1+ImageMagick-ims6.q16">ImageMagick-ims6.q16</A>(1)
<P>
<A NAME="lbAH">&nbsp;</A>
<H2>COPYRIGHT</H2>
<P>
<B>Copyright (C) 1999-2019 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see <A HREF="file:///usr/share/doc/imagemagick-6-common/html/www/license.html">file:///usr/share/doc/imagemagick-6-common/html/www/license.html</A> (on debian system you may install the imagemagick-6 package) or <A HREF="https://www.imagemagick.org/script/license.php">https://www.imagemagick.org/script/license.php</A></B>
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="2"><A HREF="#lbAB">NAME</A><DD>
<DT id="3"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="4"><A HREF="#lbAD">OVERVIEW</A><DD>
<DT id="5"><A HREF="#lbAE">DESCRIPTION</A><DD>
<DT id="6"><A HREF="#lbAF">NOTE</A><DD>
<DT id="7"><A HREF="#lbAG">SEE ALSO</A><DD>
<DT id="8"><A HREF="#lbAH">COPYRIGHT</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:17 GMT, March 31, 2021
</BODY>
</HTML>