Torrus Styling Profile Guide

Styling Profiles

Styling profiles allow for symbolic names to be used in place of hard coded values for line-color and line-style.

Schema Definitions

The following styles are defined in the default schema.

Required Styles (line-style, line-color)

           SingleGraph            HWBoundary             HWFailure
              HruleMin           HruleNormal              HruleMax
                 BpsIn                BpsOut

Generic Symbolic styles (line-color only)

                    in                   out

Symbolic, Symbolic names, for default use in graphs that have up to ten items (line-color only)

                   one                   two                 three
                  four                  five                   six
                 seven                 eight                  nine
                   ten

Symbolic names for combinatorial graphing (line-style, line-color)

                  red1                  red2                  red3
                  red4                green1                green2
                green3                green4                 blue1
                 blue2                 blue3                 blue4

Color definitions from the TT2 rgb example set (line-color only)

Defined in /usr/local/torrus/sup/styling/colornames.pl

                 black                grey25                grey50
                grey75                 white                   red
                 red25                 red50                 red75
                 green               green25               green50
               green75                  blue                blue25
                blue50                blue75                 blood
               scarlet                  rose                orange
                  leaf                   bud                  mint
                marine                   sky                 mauve
                 lilac

Color definitions for web html colors (line-color only)

Defined in /usr/local/torrus/sup/styling/colornames.pl

             aliceblue          antiquewhite                  aqua
            aquamarine                 azure                 beige
                bisque        blanchedalmond            blueviolet
                 brown             burlywood             cadetblue
            chartreuse             chocolate                 coral
        cornflowerblue              cornsilk               crimson
                  cyan              darkblue              darkcyan
         darkgoldenrod              darkgray             darkgreen
             darkkhaki           darkmagenta        darkolivegreen
            darkorange            darkorchid               darkred
            darksalmon          darkseagreen         darkslateblue
         darkslategray         darkturquoise            darkviolet
              deeppink           deepskyblue               dimgray
            dodgerblue             firebrick           floralwhite
           forestgreen               fuchsia             gainsboro
            ghostwhite                  gold             goldenrod
                  gray           greenyellow              honeydew
               hotpink             indianred                indigo
                 ivory                 khaki              lavender
         lavenderblush             lawngreen          lemonchiffon
             lightblue            lightcoral             lightcyan
  lightgoldenrodyellow            lightgreen             lightgrey
             lightpink           lightsalmon         lightseagreen
          lightskyblue        lightslategray        lightsteelblue
           lightyellow                  lime             limegreen
               magenta                maroon      mediumaquamarine
            mediumblue          mediumorchid          mediumpurple
        mediumseagreen       mediumslateblue     mediumspringgreen
       mediumturquoise       mediumvioletred          midnightblue
             mintcream             mistyrose              moccasin
           navajowhite                  navy               oldlace
                 olive             olivedrab             orangered
                orchid         palegoldenrod             palegreen
         paleturquoise         palevioletred            papayawhip
             peachpuff                  peru                  pink
                  plum            powderblue                purple
             rosybrown             royalblue           saddlebrown
                salmon            sandybrown              seagreen
              seashell                sienna                silver
               skyblue             slateblue             slategray
                  snow           springgreen             steelblue
                   tan                  teal               thistle
                tomato             turquoise                violet
                 wheat            whitesmoke                yellow

Schema Overlay

WARNING: Some styles are mandatory

Schema overlays allow the user to extend or override the styles defined in the default schema. The schema overlays are formatted in the form of a hash of hashes.

Extending the schema:

To add the styles, ##onefish, ##twofish, ##redfish, ##bluefish the following entries should be created in a descriptive file located in the styling directory.

fish-schema.pl

  $Torrus::Renderer::graphStyles{'onefish'}{'color'} = '##darkred';
  $Torrus::Renderer::graphStyles{'onefish'}{'line'} = 'LINE1';

  $Torrus::Renderer::graphStyles{'twofish'}{'color'} = '##red';
  $Torrus::Renderer::graphStyles{'twofish'}{'line'} = 'LINE2';

  $Torrus::Renderer::graphStyles{'redfish'}{'color'} = '##yellow';

  $Torrus::Renderer::graphStyles{'bluefish'}{'color'} = '##deeppink';

Other methods of adding to the hash of hashes are also acceptable.

Overriding Styles:

To override specific styles in the existing schema, ##in, ##out, entries similar to the following should be created in a Perl file, preferably located in the local configuration directory.

in_out-override-schema.pl
```
  $Torrus::Renderer::graphStyles{'in'}{'color'} = '##yellow';
  $Torrus::Renderer::graphStyles{'out'}{'color'} = '##maroon';
```
Other methods of adding to the hash of hashes are also acceptable.
Applying your Overlay
1. In the torrus-siteconfig.pl file, add the variable
  
  $Torrus::Renderer::stylingProfileOverlay = $Torrus::Global::cfgSiteDir . '/in_out-override-schema.pl';
2. Restart apache
You may have to wait for the image cache to clear before the changes take effect.

Schema Replacement

To replace a schema, create a new schema using torrus-schema.pl as a guide. Remember some styles are mandatory.

1. Applying your Schema

In the torrus-siteconfig.pl file, add the variable

  $Torrus::Renderer::stylingProfile = "Your-schema";

2. Restart apache

You may have to wait for the image cache to clear before the changes take effect.

Torrus Styling Profile Guide

Styling Profiles

Schema Definitions

Schema Overlay

Schema Replacement

Author