# cowplot 1.0.0 2019-07-11

## Breaking changes

In many ways, cowplot now behaves more appropriately and plays nicer with the R environment and other R packages. However, this means that several breaking changes were introduced:

• The default ggplot2 theme is no longer changed upon loading. You can add theme_set(theme_cowplot()) to your code to restore the old behavior.
• The package ggplot2 needs to be loaded separately from cowplot, it is not automatically attached.
• All themes now use parameters font_size and font_family. Previously, theme_nothing() and theme_map() used base_size and base_family.
• The function cowplot::ggsave() was renamed to cowplot::ggsave2(), so that the ggplot2 version of ggsave() is no longer masked by the cowplot version.

Other breaking changes:

• The defaults for save_plot() were changed somewhat. This may require adjustment if you have code depending on it.

## New features

• New functions rectangle_key_glyph() and circle_key_glyph() make it possible to generate customized legend glyphs.
• Improved alignment of plots. Plots can now be aligned in a greedy manner, which improves the appearance of aligned plots with axis labels of very different sizes.
• The new functions stamp(), stamp_good(), stamp_bad(), stamp_ugly(), stamp_wrong() allow labeling of plots as good, bad, ugly, wrong, etc.
• Added a function as_grob() that can convert base plots, lattice plots, and ggplot2 plots into grobs that can then be drawn using standard grid approaches.
• Much improved handling of base R plots, thanks to improvements in grid and gridGraphics. Requires R >= 3.6.0 and gridGraphics >= 0.4.
• Added a function set_null_device() to customize the null graphics device that is used in ggdraw(), plot_grid(), etc. There is no one null device that always works, so customization is needed.
• Added several new themes, including theme_minimal_grid(), theme_minimal_hgrid(), and theme_minimal_vgrid(). Also, theme_cowplot() is now also available as theme_half_open().
• Expanded functions for extracting plot components from ggplots via get_plot_component() and several wrapper functions for getting titles, axes, panels, and so on. This also lets get_panel() extract from plots with more than one panel. get_panel_component() allows you to further extract components like geoms from the plot panel (@malcolmbarrett, #111).

## Minor changes

• Minor tweaks to various legend layout parameters so that legends look better as the underlying theme font size is changed.
• Various minor fixes to theme_cowplot() and derived themes.
• Change background_grid() defaults so they match the new grid themes.
• Renamed plot_to_gtable() to as_gtable().
• All functions now understand both spellings of color/colour.
• get_legend() now returns NULL if there is no legend, instead of raising an error.

# cowplot 0.9.4 2019-01-08

• Fix CRAN check errors

# cowplot 0.9.3 2018-07-15

• Fix regression tests to work with ggplot2 3.0.0

# cowplot 0.9.2 2017-12-17

• Rewritten cowplot::ggsave function that calls ggplot2::ggsave
• More robust handling of R graphics device weirdness/plots popping up in the wrong places

# cowplot 0.9.1 2017-11-16

• Make examples and vignettes fail gracefully when magick package is not installed

# cowplot 0.9.0 2017-11-16

• Added a theme for maps, theme_map(). Code provided by Spencer Fox, https://github.com/sjfox.
• Added axis_canvas() function and related functions to make marginal plots and plot annotations simpler
• Now export the plot_to_gtable function which converts most anything into a gtable for further use with cowplot
• Added inherit.aes = FALSE to draw functions where needed
• Added examples to various draw functions
• Added draw_image() function to draw images onto plots

# cowplot 0.8.0 2017-07-30

• The function plot_grid can now also handle base-R (graphics) plots. Code provided by https://github.com/flying-sheep.
• More sophisticated plot alignments of complex plots are now possible. Code provided by Spencer Fox, https://github.com/sjfox.
• Plot labels can now be styled. In particular, they follow the theme settings, e.g. if the theme uses a different font than default. This closes issue #37.
• The positioning of plot labels in plot_grid can now be controlled with additional position parameters label_x and label_y. This closes issue #32.
• Problems with elements from globally set themes leaking into the plot-grid background have been fixed. This closes issues #60, #63, #66.

# cowplot 0.7.0 2016-10-28

• This version of cowplot has been prepared for the upcoming release of ggplot2 2.2.0. As a result of this upcoming switch, the function switch_axis_position() has been removed. Alternative axes will be natively supported by ggplot2 2.2.0.
• As of this version, cowplot requires R >= 3.3.0. This dependency was added because R 3.3 fixes a critical problem with lists of units.

# cowplot 0.6.2 2016-04-20

• Updated plot_grid vignette so the tutorial on aligning plots of different types works again. This stopped working at some point and was removed from 0.6.1.

# cowplot 0.6.1 2016-03-06

• Added new convenience function draw_figure_label() to label figures with labels such as “Figure 1”.
• Fixes in switch_axis_position() so that rotated axis labels work.
• Fix missing axis lines in ggplot2 2.1

# cowplot 0.6.0 2015-12-19

Major changes:

• Now requires ggplot2 version 2.0.0 or higher. Use cowplot 0.5.0 with older versions of ggplot2.
• Because of the dependency on ggplot2 2.0.0, the default design is changed. No more bold face for axis labels
• Add auto-generation of labels in plot_grid()
• Add vignettes describing plot annotations and shared legends among plots

# cowplot 0.5.0 2015-07-01

Major changes:

• Fix label positioning in plot_grid() so it is not affected by the scale parameter
• Add draw_label() function which can draw both text and plotmath expressions
• Add parameters hjust and vjust to plot_grid() to allow fine-tuning of label position

Other changes:

• Improve vignettes

# cowplot 0.4.0 2015-06-14

Major changes:

• Added a function switch_axis_position() which can move/copy the x and/or y axis of a plot to the other side
• plot_grid() can now align graphs
• plot_grid() can now make grids with varying column widths and row heights

Other changes:

• Various improvements in the documentation
• Code has been separated into multiple files for easier maintenance

# cowplot 0.3.1 2015-06-04

Fix Vignette title

# cowplot 0.3.0 2015-06-03

First complete implementation ready for initial release