.build_options {ggplot} | R Documentation

## Set ggplot options

### Description

Set global options for ggplot.

### Usage

    .build_options(opt)

### Arguments

`opt` | list of options to get/set

### Details

These are aliased into every plot object, so that `p$grid.col` will return the default grid colour, unless it has been overriden for a particular plot object. You can change the global options using the function, or the options for a specific plot by setting the values directly on the object. See the examples for more details.

Colour settings:

- axis.colour: axis text and line colour ("black")
- background.colour: background text colour ("black"), used for title
- background.fill: background fill ("white")
- grid.colour: plot grid colour ("white")
- grid.fill: plot grid background fill ("grey90")

Strip settings

- strip.text: function with two arguments (variable, and value) used for generating strip labels
- strip.gp: graphic parameter settings for the strip
- strip.text.gp: graphic parameter settings for the strip text

Legend settings

- legend.position: position of legend: "none" to hide legend; "left", "right", "top", "bottom", for positioning outside of plot; c(x, y) for positioning on top of plot

Other settings:

- aspect.ratio: aspect ratio of facets. Set to `NULL` to allow to vary with device size

### Author(s)

Hadley Wickham <h.wickham@gmail.com>

### Examples

    ggopt(background.fill = "black", background.color ="white") # all new plots will use this
    p <- ggpoint(ggplot(tips, smoker ~ sex,aesthetics = list(y = tip, x = total_bill)))
    p
    p$background.fill = "white"
    p
    p$strip.text.gp <- gpar(col="red", fontsize=8)
    p$background.colour <- "pink"
    p$grid.colour <- "green"
    p$grid.fill <- "blue"
    p # a very ugly plot!
    ggopt(background.fill = "white", background.color ="black")

[Package ggplot version 0.4.2 Index]