Customizing Appearance of Graphical Report Output
The default graphical configuration is managed by templates, and is the same as the graphical configuration for the reports run through the GUI. You can use the command-line options to request a specific predefined template. See Command-Line Reference.
There are several options that allow you to customize the text style and colors used in graphical report output. Colors should be specified in hexadecimal RGB format (for example, 00AAFF). Do not use plain words; however, the colors from SAMreport are accepted. SAMreport colors are mapped as shown in the following table.
|
SAMreport Color |
Hexadecimal Format |
|
black |
000000 |
|
red |
FE0000 |
|
green |
008200 |
|
blue |
0000FE |
|
cyan |
00FEFE |
|
magenta |
FE00FE |
|
yellow |
FEFE00 |
|
white |
FFFFFF |
The default title of a graphical report depends on the type of report. You can set the title of a graph, but note that all individual output graphs in a set will have the same title. If you want to set the title to something other than the default report title, type:
-title title
Background color of the graphical report can be set by typing:
-bgcolor color
Several font characteristics can be set for all text in a graphical report. Some options require that additional options are set.
|
Option |
Description |
Constraints |
|
–fontface <fontname> |
Sets the name of the font to use for text in the report. Specify one of the fonts accessible by the Java VM. |
If you set one of these options, you must also set the other. |
|
–fontsize <points> |
Sets the size of the font in points for text in the report. |
|
|
–fontbold |
Make text bold in the report |
If set, must also set -fontface, -fontsize. |
|
-fontitalic |
Make text italicized in the report. |
If set, must also set -fontface, -fontsize. |
The color of all text in a graphical report can be set by typing:
-textcolor color
The color(s) of data elements are specified in an order dependent on the type of report. In a Usage Over Time or a High Water Mark report, the first color is used for the line indicating usage; the second color is used for the line indicating available licenses. In a barchart, the specified color(s) are assigned to bars in the order they appear in the report. One or more colors are specified by typing:
-datacolor color[,color]*
The style of data lines can be set for one or both data lines in a graphical report. The first style is used for the line indicating usage; the second style is used for the line indicating available licenses.
-datastyle n[,n]*
|
-1 |
Solid line. If datastyle is not set at all, the lines will be solid. |
|
0 |
|
|
1 |
|
|
2 |
The width of all lines in the graph (data lines and axes) can be set by typing:
-linewidth pixels