plotSetFonts

Purpose

Sets the fonts for one or more elements of a graph.

Format

plotSetFonts(&myPlot, location, font_name [, font_size, font_color]])
Parameters:
  • &myPlot (struct pointer) – A plotControl structure pointer.
  • location (Nx1 string array) –

    Optional argument, which attributes the interpreter change applies to.

    Valid options:

    ”all”
    ”legend”
    ”legend_title”
    ”title”
    ”axes”
    ”xaxis”
    ”xtop”
    ”xbottom”
    ”yaxis”
    ”yleft”
    ”yright”
    ”zaxis”
    ”ticks” (numbers or tick labels)
    ”xticks”
    ”xtopticks”
    ”xbottomticks”
    ”yticks”
    ”yleftticks”
    ”yrightticks”
    ”zticks”
  • font (string) – Optional argument, font or font family name. If this is an empty string, the font family setting will be left unchanged.
  • fontSize (scalar) – Optional argument, font size in points.
  • fontColor (string) – Optional argument, named color or RGB value.

Examples

Set the font family and size for all text

This example will first set the font family and size for all text. It will then add a y-axis label using this font and finally add a title which uses the font family that was set, but alters the size.

new;

// Declare plotControl structure
struct plotControl myPlot;

// Initialize plotControl structure
myPlot = plotGetDefaults("hist");

// Set all text in the font to use "times" 12 pt font
plotSetFonts(&myPlot, "all", "times", 12);

// Add y-axis label using font specified above
plotSetYLabel(&myPlot, "Count");

// Since we pass in an empty string "" for
// the title font, it will be left alone
plotSetTitle(&myPlot, "Histgram of Random Normal Data", "", 14);

// Create data
x = rndn(1e5, 1);

// Plot a histogram of the x data spread over 20 bins
plotHist(myPlot, x, 20);

Set the font family, size and color for the x-axis and legend

// Declare plotControl structure
// and fill we default settings
struct plotControl myPlot;
myPlot = plotGetDefaults("scatter");

plotSetFonts(&myPlot, "xaxis legend", "arial", 14, "dimgray");

// Set the x-axis label
plotSetXLabel(&myPlot, "X variable");

// Plot some random normal data
plotScatter(myPlot, rndn(100, 1), rndn(100, 1));

Note

This function sets an attribute in a plotControl structure. It does not affect an existing graph, or a new graph drawn using the default settings that are accessible from the Tools > Preferences > Graphics menu.

See also

Functions plotSetLinePen(), plotSetYLabel(), plotSetXLabel(), plotSetTitle(), plotSetLegend()