1The **-X** **-Y** options
2^^^^^^^^^^^^^^^^^^^^^^^^^
3
4**Syntax**
5
6.. _-X:
7
8**-X**\ [**a**\|\ **c**\|\ **f**\|\ **r**][*xshift*]
9    Shift plot origin. |Add_-XY|
10
11.. _-Y:
12
13**-Y**\ [**a**\|\ **c**\|\ **f**\|\ **r**][*yshift*]
14    Shift plot origin. |Add_-XY|
15
16**Description**
17
18The **-X** and **-Y** options shift the plot origin relative to the current origin by (*xshift*,\ *yshift*). Optionally,
19append the length unit (**c**, **i**, or **p**). Default is (:term:`MAP_ORIGIN_X`, :term:`MAP_ORIGIN_Y`) for new
20plots, which ensures that boundary annotations fit on the page. Subsequent overlays will be co-registered with the
21previous plot unless the origin is shifted using these options. The following modifiers are supported
22[default is **r**]:
23
24- Prepend **a** to shift the origin back to the original position after plotting.
25- Prepend **c** to center the plot on the center of the paper (optionally add a *shift*).
26- Prepend **f** to shift the origin relative to the fixed lower left.
27- Prepend **r** to move the origin relative to its current location.
28
29When **-X** or **-Y** are used without any further arguments, the values from the last use of that option in a previous
30GMT command will be used. Note that **-X** and **-Y** can also access the previous plot bounding box dimensions *w* and
31*h* and construct offsets that involves them.  For instance, to move the origin up 2 cm beyond the height of the
32previous plot, use **-Y**\ *h*\ +2c. To move the origin half the width to the right, use **-X**\ *w*\ /2. **Note**:
33the previous plot bounding box refers to the last object plotted, which may be an image, logo, legend, colorbar, etc.