

   mtext {base}                                 R Documentation

   WWrriittee TTeexxtt iinnttoo tthhee MMaarrggiinnss ooff aa PPlloott

   DDeessccrriippttiioonn::

        `text' is written in one of the four margins (`side')
        of the plot.  `line' measures the distance outwardly in
        character size units.

   UUssaaggee::

        mtext(text, side = 3, line = 0, outer = FALSE, at = NULL, adj = NA, ...)

   AArrgguummeennttss::

       text: character string to be written.

       side: on which side of the plot (1=bottom, 2=left,
             3=top, 4=right).

       line: on which MARgin line, starting at 0 counting out-
             wards.

      outer: use outer margins if available.

         at: give location in user-coordinates.  If
             `length(at)==0' (default), the location will cor-
             respond to `par("adj")'.

        adj: length = 1 or 2 : adjustment in x- (and optionally
             y-) direction.  If `adj' isn't finite (default), a
             default is setup, using `par("las")' (and not
             `par("adj")'!

        ...: Further graphical parameters; currently supported
             are:

        cex: character expansion factor (default = 1).

        col: color to use.

       font: font for text.

   SSiiddee EEffffeeccttss::

        The given text is written onto the current plot.

   SSeeee AAllssoo::

        `title', `text', `plot'; `plotmath' for details on
        mathematical annotation.

   EExxaammpplleess::

        plot(1:10, (-4:5)^2, main="Parabola Points", xlab="xlab")
        mtext("10 of them")
        for(s in 1:4)
            mtext(paste("mtext(.., line= -1, {side, col, font} = ",s,
                  ", cex = ", (1+s)/2, ")"), line = -1,
                  side=s, col=s, font=s, cex= (1+s)/2)
        mtext("mtext(.., line= -2)", line = -2)
        mtext("mtext(.., line= -2, adj = 0)", line = -2, adj =0)
        ##--- log axis :
        plot(1:10, exp(1:10), log='y', main="log='y'", xlab="xlab")
        for(s in 1:4) mtext(paste("mtext(..,side=",s,")"), side=s)

