manpagez: man pages & more
man gmtlogo(1)
Home | html | info | man
gmtlogo(1)                            GMT                           gmtlogo(1)




NAME

       gmtlogo - Adding a GMT graphics logo overlay to an illustration


SYNOPSIS

       gmtlogo   [    -D[g|j|J|n|x]refpoint+wwidth[+jjustify][+odx[/dy]]  ]  [
       -F[+cclear-
       ances][+gfill][+i[[gap/]pen]][+p[pen]][+r[radius]][+s[[dx/dy/][shade]]]
       ] [  -Jparameters ] [  -Jz|Zparameters ] [  -K ] [  -O  ]  [   -P  ]  [
       -Rwest/east/south/north[/zmin/zmax][+r] ] [  -U[stamp] ] [  -V[level] ]
       [  -Xx_offset ] [  -Yy_offset ] [ -ttransp ]

       Note: No space is allowed between the option flag  and  the  associated
       arguments.


DESCRIPTION

       This  module plots the GMT logo on a map. By default, the GMT logo is 2
       inches wide and 1 inch high and will be positioned relative to the cur-
       rent  plot  origin.  Use  various options to change this and to place a
       transparent or opaque rectangular map panel behind the GMT logo.


REQUIRED ARGUMENTS

       None.


OPTIONAL ARGUMENTS

       -D[g|j|J|n|x]refpoint+wwidth[+jjustify][+odx[/dy]]
              Sets reference point on the map for the image using one of  four
              coordinate  systems: (1) Use -Dg for map (user) coordinates, (2)
              use -Dj or -DJ for setting refpoint via a  2-char  justification
              code  that  refers  to the (invisible) map domain rectangle, (3)
              use -Dn for normalized (0-1) coordinates, or  (4)  use  -Dx  for
              plot  coordinates (inches, cm, etc.).  All but -Dx requires both
              -R and -J to be specified.  Use +wwidth to set the width of  the
              GMT  logo  in  plot coordinates (inches, cm, etc.).  By default,
              the anchor point on the scale is assumed to be the  bottom  left
              corner (BL), but this can be changed by appending +j followed by
              a 2-char justification code justify (see pstext).  Note: If  -Dj
              is used then justify defaults to the same as refpoint, if -DJ is
              used then justify defaults to the mirror opposite  of  refpoint.
              Add +o to offset the color scale by dx/dy away from the refpoint
              point in the direction implied  by  justify  (or  the  direction
              implied by -Dj or -DJ).

       -F[+cclear-
       ances][+gfill][+i[[gap/]pen]][+p[pen]][+r[radius]][+s[[dx/dy/][shade]]]
              Without  further  options, draws a rectangular border around the
              GMT logo using  MAP_FRAME_PEN;  specify  a  different  pen  with
              +ppen.   Add  +gfill to fill the GMT logo box [no fill].  Append
              +cclearance  where  clearance  is  either  gap,  xgap/ygap,   or
              lgap/rgap/bgap/tgap  where  these items are uniform, separate in
              x- and y-direction, or individual side spacings between GMT logo
              and  border.   Append  +i  to  draw a secondary, inner border as
              well. We use a  uniform  gap  between  borders  of  2p  and  the
              MAP_DEFAULTS_PEN unless other values are specified. Append +r to
              draw rounded rectangular  borders  instead,  with  a  6p  corner
              radius. You can override this radius by appending another value.
              Finally, append +s to draw an offset background  shaded  region.
              Here, dx/dy indicates the shift relative to the foreground frame
              [4p/-4p] and shade sets  the  fill  style  to  use  for  shading
              [gray50].

       -O (more a|)
              Append to existing PostScript plot.

       -P (more a|)
              Select aPortraita plot orientation.

       -Rxmin/xmax/ymin/ymax[+r][+uunit] (more a|)
              Specify the region of interest.

       For perspective view p, optionally append /zmin/zmax. (more a|)

       -U[[just]/dx/dy/][c|label] (more a|)
              Draw GMT time stamp logo on plot.

       -V[level] (more a|)
              Select verbosity level [c].

       -X[a|c|f|r][x-shift[u]]

       -Y[a|c|f|r][y-shift[u]] (more a|)
              Shift plot origin.

       -t[transp] (more a|)
              Set PDF transparency level in percent.

       -^ or just -
              Print  a  short  message  about  the syntax of the command, then
              exits (NOTE: on Windows just use -).

       -+ or just +
              Print an extensive usage (help) message, including the  explana-
              tion  of  any  module-specific  option  (but  not the GMT common
              options), then exits.

       -? or no arguments
              Print a complete usage (help) message, including the explanation
              of all options, then exits.


EXAMPLES

       To plot the GMT logo of a 2 inch width as a stand-alone plot, use

              gmt logo -P -Dx0/0+w2i > logo.ps

       To  append  a GMT logo overlay in the upper right corner of the current
       map, but scaled up to be 3 inches wide and offset by  0.1  inches  from
       the border, try

              gmt logo -O -K -R -J -DjTR+o0.1i/0.1i+w3i >> bigmap.ps


SEE ALSO

       gmt(1), pslegend(1), psimage(1), psscale(1)


COPYRIGHT

       2017, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe



5.4.2                            Jun 24, 2017                       gmtlogo(1)

gmt5 5.4.2 - Generated Wed Jun 28 16:28:05 CDT 2017
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.