vis.export.from.coloredmeshes: Export high-quality brainview image with horizontal colorbar.

In neuroconductor/fsbrain: Managing and Visualizing Brain Surface Data

Description

This function serves as an easy (but slightly inflexible) way to export a high-quality, tight-layout, horizontal colorbar figure to disk.

Usage

vis.export.from.coloredmeshes(
  coloredmeshes,
  colorbar_legend = NULL,
  img_only = TRUE,
  horizontal = TRUE,
  silent = TRUE,
  quality = 1L,
  output_img = "fsbrain_arranged.png",
  image.plot_extra_options = NULL,
  large_legend = TRUE,
  view_angles = get.view.angle.names(angle_set = "t4"),
  style = "default"
)

Arguments

coloredmeshes	list of coloredmesh. A coloredmesh is a named list as returned by the 'coloredmesh.from*' functions (like coloredmesh.from.morph.native). It has the entries 'mesh' of type tmesh3d, a 'col', which is a color specification for such a mesh. The 'vis*' functions (like vis.subject.morph.native) all return a list of coloredmeshes.
colorbar_legend	character string or NULL, the title for the colorbar.
img_only	logical, whether to return only the resulting image
horizontal	logical, whether to plot the colorbar horizontally
silent	logical, whether to suppress messages
quality	integer, an arbitrary quality. This is the resolution per tile before trimming, divided by 1000, in pixels. Example: 1L means 1000x1000 pixels per tile before trimming. Currently supported values: 1L..2L. Note that the resolution you can get is also limited by your screen resolution.
output_img	string, path to the output file. Defaults to "fsbrain_arranged.png"
image.plot_extra_options	named list, custom options for fields::image.plot. Overwrites those derived from the quality setting. If in doubt, leave this alone.
large_legend	logical, whether to plot extra large legend text, affects the font size of the colorbar_legend and the tick labels.
view_angles	list of strings. See get.view.angle.names for all valid strings.
style	the rendering style, see material3d or use a predefined style like 'default' or 'shiny'.

Value

magick image instance or named list, depending on the value of 'img_only'. If the latter, the list contains the fields 'rev_vl', 'rev_cb', and 'rev_ex', which are the return values of the functions vislayout.from.coloredmeshes, coloredmesh.plot.colorbar.separate, and combine.colorbar.with.brainview.image, respectively.

Note

This function also exports the resulting image to disk in PNG format, in the current working directory, named 'fsbrain_merged.png'. Note that your screen resolution has to be high enough to generate the final image.

Examples

## Not run: 
    rand_data = rnorm(327684, 5, 1.5);
    cm = vis.data.on.fsaverage(morph_data_both=rand_data, rglactions=list('no_vis'=T));
    vis.export.from.coloredmeshes(cm, colorbar_legend='Random data');

## End(Not run)

neuroconductor/fsbrain documentation built on Sept. 16, 2020, 2:30 p.m.