NAME

       gmtlogo - Adding a GMT graphics logo overlay to an illustration

SYNOPSIS

       gmtlogo        [        [g|j|J|n|x]refpoint+wwidth[+jjustify][+odx[/dy]]        ]        [
       [+cclearances][+gfill][+i[[gap/]*pen*]][+p[pen]][+r[radius]][+s[[dx/dy/][shade]]]   ]    [
       parameters  ]  [ z|Zparameters ] [  ] [  ] [  ] [ west/east/south/north[/zmin/zmax][r] ] [
       [just/dx/dy/][c|label] ] [ [level] ] [ x_offset ] [ y_offset ] [ -ccopies ] [ -t<transp> ]

       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 [gray50O.

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

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

       -R[unit]xmin/xmax/ymin/ymax[r] (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.

       -ccopies (more ...)
              Specify number of plot copies [Default is 1].

       -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
              use just -).

       -+ 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  options,  then
              exits.

       --version
              Print GMT version and exit.

       --show-datadir
              Print full path to GMT share directory and exit.

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

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