<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with LaTeX2HTML 2008 (1.71)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>Key placement</TITLE>
<META NAME="description" CONTENT="Key placement">
<META NAME="keywords" CONTENT="gnuplot">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META NAME="Generator" CONTENT="LaTeX2HTML v2008">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="gnuplot.css">
<LINK REL="next" HREF="node218.html">
<LINK REL="previous" HREF="node216.html">
<LINK REL="up" HREF="node216.html">
<LINK REL="next" HREF="node218.html">
</HEAD>
<BODY >
<!--Navigation Panel-->
<A NAME="tex2html4338"
HREF="node218.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html4332"
HREF="node216.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html4326"
HREF="node216.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html4334"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html4336"
HREF="node467.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html4339"
HREF="node218.html">Key samples</A>
<B> Up:</B> <A NAME="tex2html4333"
HREF="node216.html">Key</A>
<B> Previous:</B> <A NAME="tex2html4327"
HREF="node216.html">Key</A>
<B> <A NAME="tex2html4335"
HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html4337"
HREF="node467.html">Index</A></B>
<BR>
<BR>
<!--End of Navigation Panel-->
<H3><A NAME="SECTION0402430100000000000000"></A>
<A NAME="commands_set_key_placement"></A><A NAME="set_key_placement"></A><A NAME="key_placement"></A>
<BR>
Key placement
</H3>
To understand positioning, the best concept is to think of a region, i.e.,
inside/outside, or one of the margins. Along with the region, keywords
<B>left/center/right</B> (l/c/r) and <B>top/center/bottom</B> (t/c/b) control where
within the particular region the key should be placed.
<P>
When in <B>inside</B> mode, the keywords <B>left</B> (l), <B>right</B> (r), <B>top</B> (t),
<B>bottom</B> (b), and <B>center</B> (c) push the key out toward the plot boundary as
illustrated:
<P>
<BR>
<PRE>
t/l t/c t/r
</PRE>
<BR>
<P>
<BR>
<PRE>
c/l c c/r
</PRE>
<BR>
<P>
<BR>
<PRE>
b/l b/c b/r
</PRE>
<BR>
<P>
When in <B>outside</B> mode, automatic placement is similar to the above
illustration, but with respect to the view, rather than the graph boundary.
That is, a border is moved inward to make room for the key outside of
the plotting area, although this may interfere with other labels and may
cause an error on some devices. The particular plot border that is moved
depends upon the position described above and the stacking direction. For
options centered in one of the dimensions, there is no ambiguity about which
border to move. For the corners, when the stack direction is <B>vertical</B>, the
left or right border is moved inward appropriately. When the stack direction
is <B>horizontal</B>, the top or bottom border is moved inward appropriately.
<P>
The margin syntax allows automatic placement of key regardless of stack
direction. When one of the margins <B>lmargin</B> (lm), <B>rmargin</B> (rm),
<B>tmargin</B> (tm), and <B>bmargin</B> (bm) is combined with a single, non-conflicting
direction keyword, the following illustrated positions may contain the key:
<P>
<BR>
<PRE>
l/tm c/tm r/tm
</PRE>
<BR>
<P>
<BR>
<PRE>
t/lm t/rm
</PRE>
<BR>
<P>
<BR>
<PRE>
c/lm c/rm
</PRE>
<BR>
<P>
<BR>
<PRE>
b/lm b/rm
</PRE>
<BR>
<P>
<BR>
<PRE>
l/bm c/bm r/bm
</PRE>
<BR>
<P>
Keywords <B>above</B> and <B>over</B> are synonymous with <B>tmargin</B>. For version
compatibility, <B>above</B> or <B>over</B> without an additional l/c/r or stack direction
keyword uses <B>center</B> and <B>horizontal</B>. Keywords <B>below</B> and <B>under</B> are
synonymous with <B>bmargin</B>. For compatibility, <B>below</B> or <B>under</B> without an
additional l/c/r or stack direction keyword uses <B>center</B> and <B>horizontal</B>. A
further compatibility issue is that <B>outside</B> appearing without an additional
t/b/c or stack direction keyword uses <B>top</B>, <B>right</B> and <B>vertical</B> (i.e., the
same as t/rm above).
<P>
The 4#4position5#5 can be a simple x,y,z as in previous versions, but these can
be preceded by one of five keywords (<B>first</B>, <B>second</B>, <B>graph</B>, <B>screen</B>,
<B>character</B>) which selects the coordinate system in which the position of
the first sample line is specified. See <B>coordinates (p. <A HREF="node18.html#coordinates"><IMG ALIGN="BOTTOM" BORDER="1" ALT="[*]" SRC="crossref.png"></A>)<A NAME="5057"></A></B> for more details.
The effect of <B>left</B>, <B>right</B>, <B>top</B>, <B>bottom</B>, and <B>center</B> when 4#4position5#5
is given is to align the key as though it were text positioned using the
label command, i.e., <B>left</B> means left align with key to the right of
4#4position5#5, etc.
<HR>
<!--Navigation Panel-->
<A NAME="tex2html4338"
HREF="node218.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
<A NAME="tex2html4332"
HREF="node216.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
<A NAME="tex2html4326"
HREF="node216.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
<A NAME="tex2html4334"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
<A NAME="tex2html4336"
HREF="node467.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A>
<BR>
<B> Next:</B> <A NAME="tex2html4339"
HREF="node218.html">Key samples</A>
<B> Up:</B> <A NAME="tex2html4333"
HREF="node216.html">Key</A>
<B> Previous:</B> <A NAME="tex2html4327"
HREF="node216.html">Key</A>
<B> <A NAME="tex2html4335"
HREF="node1.html">Contents</A></B>
<B> <A NAME="tex2html4337"
HREF="node467.html">Index</A></B>
<!--End of Navigation Panel-->
<ADDRESS>
2010-08-17
</ADDRESS>
</BODY>
</HTML>
