share/html/online/xpm.html

   1 <title>xpm file format</title>
   2 <LINK rel=stylesheet href="style.css" type="text/css">
   3 <BODY text="#000000" bgcolor="#FFFFFF" link="#0000EF" vlink="#650065" alink="#FF0000">
   4 <h2>xpm file format</h2>
   5 <CENTER><TABLE BORDER=0 CELLSPACING=0 CELLPADDING=0 COLS=2 WIDTH="98%">
   6 <TR>
   7 <TD><font size=-1><A HREF="../online.html">Main Table of Contents</A></font></TD>
   8 <TD ALIGN=RIGHT><B>VERSION 4.6</B></TR>
   9 <TR><TD><font size=-1><A HREF="http://www.gromacs.org">GROMACS homepage</A></font></TD>
  10 <TD ALIGN=RIGHT><B>Sat 19 Jan 2013</B></TR></TABLE></CENTER><HR>
  11 <H3>Description</H3>
  12 The GROMACS xpm file format is compatible with the XPixMap format
  13 and is used for storing matrix data.
  14 Thus GROMACS xpm files can be viewed directly with programs like XV.
  15 Alternatively, they can be imported into GIMP and scaled to 300 DPI,
  16 using strong antialiasing for font and graphics.
  17 The first matrix data line in an xpm file corresponds to the last matrix
  18 row.
  19 In addition to the XPixMap format, GROMACS xpm files may contain
  20 extra fields. The information in these fields is used when converting
  21 an xpm file to EPS with
  22 <A HREF="xpm2ps.html">xpm2ps</a>.
  23 The optional extra field are:
  24 <ul>
  25 <li>
  26 Before the <tt>gv_xpm</tt> declaration:  <tt>title</tt>, <tt>legend</tt>,
  27 <tt>x-label</tt>, <tt>y-label</tt> and <tt>type</tt>,
  28 all followed by a string.
  29 The <tt>legend</tt> field determines the legend title.
  30 The <tt>type</tt> field must be followed by <tt>"continuous"</tt> or
  31 <tt>"discrete"</tt>,
  32 this determines which type of legend will be drawn in an EPS file,
  33 the default type is continuous.
  34 <li>
  35 The xpm colormap entries may be followed by a string, which is a label for
  36 that color.
  37 <li>
  38 Between the colormap and the matrix data, the fields
  39 <tt>x-axis</tt> and/or <tt>y-axis</tt>
  40 may be present followed by the tick-marks for that axis.
  41 </ul>
  42 The example GROMACS xpm file below contains all the extra fields.
  43 The C-comment delimiters and the colon in the extra fields are optional.
  44 <pre>
  45 /* XPM */
  46 /* This matrix is generated by g_rms. */
  47 /* title:   "Backbone RMSD matrix" */
  48 /* legend:  "RMSD (nm)" */
  49 /* x-label: "Time (ps)" */
  50 /* y-label: "Time (ps)" */
  51 /* type:    "Continuous" */
  52 static char * gv_xpm[] = {
  53 "13 13   6 1",
  54 "A  c #FFFFFF " /* "0" */,
  55 "B  c #CCCCCC " /* "0.0399" */,
  56 "C  c #999999 " /* "0.0798" */,
  57 "D  c #666666 " /* "0.12" */,
  58 "E  c #333333 " /* "0.16" */,
  59 "F  c #000000 " /* "0.2" */,
  60 /* x-axis:  0 40 80 120 160 200 240 280 320 360 400 440 480 */
  61 /* y-axis:  0 40 80 120 160 200 240 280 320 360 400 440 480 */
  62 "FEDDDDCCCCCBA",
  63 "FEDDDCCCCBBAB",
  64 "FEDDDCCCCBABC",
  65 "FDDDDCCCCABBC",
  66 "EDDCCCCBACCCC",
  67 "EDCCCCBABCCCC",
  68 "EDCCCBABCCCCC",
  69 "EDCCBABCCCCCD",
  70 "EDCCABCCCDDDD",
  71 "ECCACCCCCDDDD",
  72 "ECACCCCCDDDDD",
  73 "DACCDDDDDDEEE",
  74 "ADEEEEEEEFFFF"
  75 </pre>
  76 <hr>
  77 <div ALIGN=RIGHT>
  78 <font size="-1"><a href="http://www.gromacs.org">http://www.gromacs.org</a></font><br>
  79 </div>
  80 </body>