gmtlogo(1)

1GMTLOGO(1)                            GMT                           GMTLOGO(1)
2
3
4

NAME

6       gmtlogo - Adding a GMT graphics logo overlay to an illustration
7

SYNOPSIS

9       gmtlogo   [    -D[g|j|J|n|x]refpoint+wwidth[+jjustify][+odx[/dy]]  ]  [
10       -F[+cclear‐
11       ances][+gfill][+i[[gap/]pen]][+p[pen]][+r[radius]][+s[[dx/dy/][shade]]]
12       ] [  -Jparameters ] [  -Jz|Zparameters ] [  -K ] [  -O  ]  [   -P  ]  [
13       -Rwest/east/south/north[/zmin/zmax][+r] ] [  -U[stamp] ] [  -V[level] ]
14       [  -Xx_offset ] [  -Yy_offset ] [ -ttransp ]
15
16       Note: No space is allowed between the option flag  and  the  associated
17       arguments.
18

DESCRIPTION

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

REQUIRED ARGUMENTS

26       None.
27

OPTIONAL ARGUMENTS

29       -D[g|j|J|n|x]refpoint+wwidth[+jjustify][+odx[/dy]]
30              Sets reference point on the map for the image using one of  four
31              coordinate  systems: (1) Use -Dg for map (user) coordinates, (2)
32              use -Dj or -DJ for setting refpoint via a  2-char  justification
33              code  that  refers  to the (invisible) map domain rectangle, (3)
34              use -Dn for normalized (0-1) coordinates, or  (4)  use  -Dx  for
35              plot  coordinates (inches, cm, etc.).  All but -Dx requires both
36              -R and -J to be specified.  Use +wwidth to set the width of  the
37              GMT  logo  in  plot coordinates (inches, cm, etc.).  By default,
38              the anchor point on the scale is assumed to be the  bottom  left
39              corner (BL), but this can be changed by appending +j followed by
40              a 2-char justification code justify (see pstext).  Note: If  -Dj
41              is used then justify defaults to the same as refpoint, if -DJ is
42              used then justify defaults to the mirror opposite  of  refpoint.
43              Add +o to offset the color scale by dx/dy away from the refpoint
44              point in the direction implied  by  justify  (or  the  direction
45              implied by -Dj or -DJ).
46
47       -F[+cclear‐
48       ances][+gfill][+i[[gap/]pen]][+p[pen]][+r[radius]][+s[[dx/dy/][shade]]]
49              Without further options, draws a rectangular border  around  the
50              GMT  logo  using  MAP_FRAME_PEN;  specify  a  different pen with
51              +ppen.  Add +gfill to fill the GMT logo box [no  fill].   Append
52              +cclearance   where  clearance  is  either  gap,  xgap/ygap,  or
53              lgap/rgap/bgap/tgap where these items are uniform,  separate  in
54              x- and y-direction, or individual side spacings between GMT logo
55              and border.  Append +i to draw  a  secondary,  inner  border  as
56              well.  We  use  a  uniform  gap  between  borders  of 2p and the
57              MAP_DEFAULTS_PEN unless other values are specified. Append +r to
58              draw  rounded  rectangular  borders  instead,  with  a 6p corner
59              radius. You can override this radius by appending another value.
60              Finally,  append  +s to draw an offset background shaded region.
61              Here, dx/dy indicates the shift relative to the foreground frame
62              [4p/-4p]  and  shade  sets  the  fill  style  to use for shading
63              [gray50].
64
65       -O (more ...)
66              Append to existing PostScript plot.
67
68       -P (more ...)
69              Select "Portrait" plot orientation.
70
71       -Rxmin/xmax/ymin/ymax[+r][+uunit] (more ...)
72              Specify the region of interest.
73
74       For perspective view p, optionally append /zmin/zmax. (more ...)
75
76       -U[[just]/dx/dy/][c|label] (more ...)
77              Draw GMT time stamp logo on plot.
78
79       -V[level] (more ...)
80              Select verbosity level [c].
81
82       -X[a|c|f|r][x-shift[u]]
83
84       -Y[a|c|f|r][y-shift[u]] (more ...)
85              Shift plot origin.
86
87       -t[transp] (more ...)
88              Set PDF transparency level in percent.
89
90       -^ or just -
91              Print a short message about the  syntax  of  the  command,  then
92              exits (NOTE: on Windows just use -).
93
94       -+ or just +
95              Print  an extensive usage (help) message, including the explana‐
96              tion of any module-specific  option  (but  not  the  GMT  common
97              options), then exits.
98
99       -? or no arguments
100              Print a complete usage (help) message, including the explanation
101              of all options, then exits.
102

EXAMPLES

104       To plot the GMT logo of a 2 inch width as a stand-alone plot, use
105
106              gmt logo -P -Dx0/0+w2i > logo.ps
107
108       To append a GMT logo overlay in the upper right corner of  the  current
109       map,  but  scaled  up to be 3 inches wide and offset by 0.1 inches from
110       the border, try
111
112              gmt logo -O -K -R -J -DjTR+o0.1i/0.1i+w3i >> bigmap.ps
113

COPYRIGHT

118       2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
119
120
121
122
1235.4.5                            Feb 24, 2019                       GMTLOGO(1)