13.3 Changing the default behavior via environment variable PYCHART_OPTIONS
Description: Changing the default behavior via environment variable PYCHART_OPTIONS
Keywords: pychart

##
13.3 Changing the default behavior via environment variable PYCHART_OPTIONS

The variables in the `theme` module can also be set via environment variable `PYCHART_OPTIONS`. The value of this variable, if set, should be a sequence of `var=val`, separated by space. For instance, the below example tells PyChart to write to file foo.pdf and use Times-Roman as the default font.

    % PYCHART_OPTIONS="output=foo.pdf font-family=Times"
    % export PYCHART_OPTIONS

The summary of attributes that can be set via `PYCHART_OPTIONS` follows.

font-family=name:
  family Same as setting `theme.default_font_family` variable.

font-size=size:
  size Same as setting `theme.default_font_size` variable.

line-width=points:
  Same as setting `theme.default_line_width` variable.

scale=n:
  Same as setting `theme.scale_factor` variable.

color=[yes|no]:
  Same as setting `theme.use_color` variable.

debug-level=N:
  Same as setting `theme.debug_level` variable.

bbox=LEFT,BOTTOM,RIGHT,TOP:
  This option sets `theme.bounding_box` and/or `theme.delta_bounding_box`. The value of this option is a sequence of four values, separated by commas. Each value is of the form, `+`num, `-`num, or num. `+`num and `-`num adds to or subtracts from the bounding-box value computed by PyChart (the unit is PostScript points; See Section 4.) num sets the bounding box at that value. For example,

      bbox=-10,0,+10,100

  Extends the bounding box 10 points to both left and right, and sets the vertical stretch from 0 to 100.