github.com/kaydxh/golang@v0.0.131/pkg/gocv/cgo/third_path/graphics-magick/share/doc/GraphicsMagick/www/identify.html (about)

     1  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
     2    "http://www.w3.org/TR/html4/loose.dtd">
     3  <html>
     4  <head>
     5  	<meta HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=us-ascii">
     6  	<title>GraphicsMagick GM Utility</title>
     7  	<style type=text/css>
     8  	<!--
     9  		@page { size: 8.5in 11in }
    10  		TD P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 12pt }
    11  		P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 12pt }
    12  		A:link { color: #00B04F }
    13  		A:visited { color: #007B37 }
    14  	-->
    15  	</style>
    16  
    17  </head>
    18  <body LANG="en-US" TEXT="#000000" LINK="#00B04F" VLINK="#007B37" BGCOLOR="#ffffff">
    19  <a name="top"></a>
    20  <table border=0 cellpadding=10 cellspacing=0 style="margin-top:-17px" width="100%"><tr><td>
    21  <br>&nbsp;<br>
    22  <table BORDER=0 WIDTH="100%"> 
    23  <tr> 
    24  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
    25  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
    26  height=14 width=15><b><font face="Helvetica, Arial"><font 
    27  color="#00B04F"><font size="+1">
    28  <a NAME="gm identify"></a>gm identify
    29  </font></font></font></b></td></tr></table>
    30  <table width="94%" border="0" cellspacing="0" cellpadding="8">
    31  <tr><td width="3%"><br></td><td>
    32  <table BORDER=0 WIDTH="100%"> 
    33  <tr> 
    34  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
    35  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
    36  height=14 width=15><b><font face="Helvetica, Arial"><font 
    37  color="#00B04F"><font size="+1">
    38  <a NAME="ident-top"></a>NAME
    39  </font></font></font></b></td></tr></table>
    40  <table width="94%" border="0" cellspacing="0" cellpadding="8">
    41  <tr><td width="3%"><br></td><td>
    42  identify - describe an image or image sequence.
    43  </td></tr></table>
    44  <table BORDER=0 WIDTH="100%"> 
    45  <tr> 
    46  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
    47  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
    48  height=14 width=15><b><font face="Helvetica, Arial"><font 
    49  color="#00B04F"><font size="+1">
    50  <a NAME="ident-contents"></a>Contents
    51  </font></font></font></b></td></tr></table>
    52  <table width="94%" border="0" cellspacing="0" cellpadding="8">
    53  <tr><td width="3%"><br></td><td>
    54  <dl>
    55  <dt>
    56  <a href="#ident-syno">Synopsis</a>
    57  </dt>
    58  <dt>
    59  <a href="#ident-desc">Description</a>
    60  </dt>
    61  <dt>
    62  <a href="#ident-opti">Options</a>
    63  </dt>
    64  </dl>
    65  </td></tr></table>
    66  <table BORDER=0 WIDTH="100%"> 
    67  <tr> 
    68  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
    69  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
    70  height=14 width=15><b><font face="Helvetica, Arial"><font 
    71  color="#00B04F"><font size="+1">
    72  <a NAME="ident-syno"></a>Synopsis
    73  </font></font></font></b></td></tr></table>
    74  <table width="94%" border="0" cellspacing="0" cellpadding="8">
    75  <tr><td width="3%"><br></td><td>
    76  <p>
    77  <strong>gm identify</strong> <em>file</em> [ <em>file</em> ... ]
    78  <br>&nbsp;<br>
    79  </td></tr></table>
    80  <table BORDER=0 WIDTH="100%"> 
    81  <tr> 
    82  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
    83  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
    84  height=14 width=15><b><font face="Helvetica, Arial"><font 
    85  color="#00B04F"><font size="+1">
    86  <a NAME="ident-desc"></a>Description
    87  </font></font></font></b></td></tr></table>
    88  <table width="94%" border="0" cellspacing="0" cellpadding="8">
    89  <tr><td width="3%"><br></td><td>
    90  <p>
    91  <strong>Identify</strong> describes the format and characteristics of one or
    92  more image files as internally supported by the software. It will also
    93  report if an image is incomplete or corrupt.  The information
    94  displayed includes the scene number, the file name, the width and
    95  height of the image, whether the image is colormapped or not, the
    96  number of colors in the image, the number of bytes in the image, the
    97  format of the image (JPEG, PNM, etc.), and finally the number of
    98  seconds in both user time and elapsed time it took to read and process
    99  the image.  If -verbose or +ping are provided as an option, the pixel
   100  read rate is also displayed. An example line output from
   101  <strong>identify</strong> follows:
   102  <pre>
   103      images/aquarium.miff 640x480 PseudoClass 256c
   104             308135b MIFF 0.000u 0:01
   105  </pre>
   106  <p>
   107  If <tt>-verbose</tt> is set, expect additional output including any image
   108  comment:
   109  <br>&nbsp;<br>
   110  <pre>
   111      Image: images/aquarium.miff
   112      class: PseudoClass
   113      colors: 256
   114      signature: eb5dca81dd93ae7e6ffae99a527eb5dca8...
   115      matte: False
   116      geometry: 640x480
   117         depth: 8
   118      bytes: 308135
   119      format: MIFF
   120      comments:
   121      Imported from MTV raster image: aquarium.mtv
   122  </pre>
   123  <p>
   124  For some formats, additional format-specific information about the file
   125  will be written if the <tt>-debug coder</tt> or <tt>-debug all</tt> option
   126  is used.
   127  </td></tr></table>
   128       <p>
   129  <i><a href="#top">Back to Contents</a></i> 
   130  &nbsp;</p>
   131  <table BORDER=0 WIDTH="100%"> 
   132  <tr> 
   133  <td ALIGN=LEFT bgcolor="#FFFFFF"><img 
   134  SRC="images/right_triangle.png"  ALT=">" BORDER=0 
   135  height=14 width=15><b><font face="Helvetica, Arial"><font 
   136  color="#00B04F"><font size="+1">
   137  <a NAME="ident-opti"></a>Identify options
   138  </font></font></font></b></td></tr></table>
   139  <table width="94%" border="0" cellspacing="0" cellpadding="8">
   140  <tr><td width="3%"><br></td><td>
   141  <p>
   142  Options are processed in command line order. Any option you specify on
   143  the command line remains in effect for the set of images immediately
   144  following, until the set is terminated by the appearance of any option
   145  or <strong>-noop</strong>.
   146  <p>
   147  For a more detailed description of each option, see
   148  Options, above.
   149  <a href="GraphicsMagick.html"><em>GraphicsMagick(1)</em></a>.
   150  <br>&nbsp;<br>
   151  <table BORDER=0 WIDTH="94%">
   152  <tr>
   153  <td width="3%"><br></td> 
   154  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   155  <img SRC="images/right_triangle_option.png"
   156  ALT=">" BORDER=0 height=14
   157  width=15><b><font face="Helvetica, Arial"
   158  ><font color="#00B04F"><font size="+1">
   159      <a href="GraphicsMagick.html#details-authenticate">-authenticate</a> <i>&lt;string&gt;</i>
   160  </font></font></font></b></td></tr></table>
   161  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>decrypt image with this password</td></tr></table>
   162  <table BORDER=0 WIDTH="94%">
   163  <tr>
   164  <td width="3%"><br></td> 
   165  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   166  <img SRC="images/right_triangle_option.png"
   167  ALT=">" BORDER=0 height=14
   168  width=15><b><font face="Helvetica, Arial"
   169  ><font color="#00B04F"><font size="+1">
   170      -debug <i>&lt;events&gt;</i>
   171  </font></font></font></b></td></tr></table>
   172  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>enable debug printout</td></tr></table>
   173  <table BORDER=0 WIDTH="94%">
   174  <tr>
   175  <td width="3%"><br></td> 
   176  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   177  <img SRC="images/right_triangle_option.png"
   178  ALT=">" BORDER=0 height=14
   179  width=15><b><font face="Helvetica, Arial"
   180  ><font color="#00B04F"><font size="+1">
   181      <a href="GraphicsMagick.html#details-define">-define</a> <i>&lt;key&gt;</i>{<i>=&lt;value&gt;</i>}<i>,...</i>
   182  </font></font></font></b></td></tr></table>
   183  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>add coder/decoder specific options</td></tr></table>
   184  <table BORDER=0 WIDTH="94%">
   185  <tr>
   186  <td width="3%"><br></td> 
   187  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   188  <img SRC="images/right_triangle_option.png"
   189  ALT=">" BORDER=0 height=14
   190  width=15><b><font face="Helvetica, Arial"
   191  ><font color="#00B04F"><font size="+1">
   192      <a href="GraphicsMagick.html#details-density">-density</a> <i>&lt;width&gt;x&lt;height&gt;</i>
   193  </font></font></font></b></td></tr></table>
   194  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>horizontal and vertical resolution in pixels of the image</td></tr></table>
   195  <table BORDER=0 WIDTH="94%">
   196  <tr>
   197  <td width="3%"><br></td> 
   198  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   199  <img SRC="images/right_triangle_option.png"
   200  ALT=">" BORDER=0 height=14
   201  width=15><b><font face="Helvetica, Arial"
   202  ><font color="#00B04F"><font size="+1">
   203      <a href="GraphicsMagick.html#details-depth">-depth</a> <i>&lt;value&gt;</i>
   204  </font></font></font></b></td></tr></table>
   205  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>depth of the image</td></tr></table>
   206  <table BORDER=0 WIDTH="94%">
   207  <tr>
   208  <td width="3%"><br></td> 
   209  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   210  <img SRC="images/right_triangle_option.png"
   211  ALT=">" BORDER=0 height=14
   212  width=15><b><font face="Helvetica, Arial"
   213  ><font color="#00B04F"><font size="+1">
   214      <a href="GraphicsMagick.html#details-format">-format</a> <i>&lt;string&gt;</i>
   215  </font></font></font></b></td></tr></table>
   216  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>output formatted image characteristics</td></tr></table>
   217  <table BORDER=0 WIDTH="94%">
   218  <tr>
   219  <td width="3%"><br></td> 
   220  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   221  <img SRC="images/right_triangle_option.png"
   222  ALT=">" BORDER=0 height=14
   223  width=15><b><font face="Helvetica, Arial"
   224  ><font color="#00B04F"><font size="+1">
   225      -help
   226  </font></font></font></b></td></tr></table>
   227  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>print usage instructions</td></tr></table>
   228  <table BORDER=0 WIDTH="94%">
   229  <tr>
   230  <td width="3%"><br></td> 
   231  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   232  <img SRC="images/right_triangle_option.png"
   233  ALT=">" BORDER=0 height=14
   234  width=15><b><font face="Helvetica, Arial"
   235  ><font color="#00B04F"><font size="+1">
   236      <a href="GraphicsMagick.html#details-interlace">-interlace</a> <i>&lt;type&gt;</i>
   237  </font></font></font></b></td></tr></table>
   238  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>the type of interlacing scheme</td></tr></table>
   239  <table BORDER=0 WIDTH="94%">
   240  <tr>
   241  <td width="3%"><br></td> 
   242  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   243  <img SRC="images/right_triangle_option.png"
   244  ALT=">" BORDER=0 height=14
   245  width=15><b><font face="Helvetica, Arial"
   246  ><font color="#00B04F"><font size="+1">
   247      <a href="GraphicsMagick.html#details-limit">-limit</a> <i>&lt;type&gt; &lt;value&gt;</i>
   248  </font></font></font></b></td></tr></table>
   249  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>Disk, File, Map, Memory, Pixels, Width, Height or Threads resource limit</td></tr></table>
   250  <table BORDER=0 WIDTH="94%">
   251  <tr>
   252  <td width="3%"><br></td> 
   253  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   254  <img SRC="images/right_triangle_option.png"
   255  ALT=">" BORDER=0 height=14
   256  width=15><b><font face="Helvetica, Arial"
   257  ><font color="#00B04F"><font size="+1">
   258      <a href="GraphicsMagick.html#details-log">-log</a> <i>&lt;string&gt;</i>
   259  </font></font></font></b></td></tr></table>
   260  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>Specify format for debug log</td></tr></table>
   261  <table BORDER=0 WIDTH="94%">
   262  <tr>
   263  <td width="3%"><br></td> 
   264  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   265  <img SRC="images/right_triangle_option.png"
   266  ALT=">" BORDER=0 height=14
   267  width=15><b><font face="Helvetica, Arial"
   268  ><font color="#00B04F"><font size="+1">
   269      -ping
   270  </font></font></font></b></td></tr></table>
   271  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>efficiently determine image characteristics</td></tr></table>
   272  <table BORDER=0 WIDTH="94%">
   273  <tr>
   274  <td width="3%"><br></td> 
   275  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   276  <img SRC="images/right_triangle_option.png"
   277  ALT=">" BORDER=0 height=14
   278  width=15><b><font face="Helvetica, Arial"
   279  ><font color="#00B04F"><font size="+1">
   280      <a href="GraphicsMagick.html#details-sampling-factor">-sampling-factor</a> <i>&lt;horizontal_factor&gt;x&lt;vertical_factor&gt;</i>
   281  </font></font></font></b></td></tr></table>
   282  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>chroma subsampling factors</td></tr></table>
   283  <table BORDER=0 WIDTH="94%">
   284  <tr>
   285  <td width="3%"><br></td> 
   286  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   287  <img SRC="images/right_triangle_option.png"
   288  ALT=">" BORDER=0 height=14
   289  width=15><b><font face="Helvetica, Arial"
   290  ><font color="#00B04F"><font size="+1">
   291      <a href="GraphicsMagick.html#details-size">-size</a> <i>&lt;width&gt;x&lt;height&gt;</i>{<i>+offset</i>}<i></i>
   292  </font></font></font></b></td></tr></table>
   293  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>width and height of the image</td></tr></table>
   294  <table BORDER=0 WIDTH="94%">
   295  <tr>
   296  <td width="3%"><br></td> 
   297  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   298  <img SRC="images/right_triangle_option.png"
   299  ALT=">" BORDER=0 height=14
   300  width=15><b><font face="Helvetica, Arial"
   301  ><font color="#00B04F"><font size="+1">
   302      <a href="GraphicsMagick.html#details-verbose">-verbose</a>
   303  </font></font></font></b></td></tr></table>
   304  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>print detailed information about the image</td></tr></table>
   305  <table BORDER=0 WIDTH="94%">
   306  <tr>
   307  <td width="3%"><br></td> 
   308  <td ALIGN=LEFT BGCOLOR="#FFFFFF">
   309  <img SRC="images/right_triangle_option.png"
   310  ALT=">" BORDER=0 height=14
   311  width=15><b><font face="Helvetica, Arial"
   312  ><font color="#00B04F"><font size="+1">
   313      <a href="GraphicsMagick.html#details-version">-version</a>
   314  </font></font></font></b></td></tr></table>
   315  <table width="90%" border="0" cellspacing="0"              cellpadding="8">              <tr><td width="6%"><br></td><td>print GraphicsMagick version string</td></tr></table>
   316  <p>
   317  For a more detailed description of each option, see
   318  Options, above.
   319  <a href="GraphicsMagick.html"><em>GraphicsMagick(1)</em></a>.
   320  <br>&nbsp;<br>
   321  </td></tr></table>
   322       <p>
   323  <i><a href="#top">Back to Contents</a></i> 
   324  &nbsp;</p>