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[+cclearances][+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 current 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[+cclearances][+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 ...)
              Append to existing PostScript plot.

       -P (more ...)
              Select "Portrait" plot orientation.

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

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

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

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

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

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

       -t[transp] (more ...)
              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  explanation  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, pslegend, psimage, psscale

COPYRIGHT

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