Line Chart Commands

The following command line arguments to the PDF Chart Creator are specific to Line Charts. Additionally, the Labels and Axes can be configured.

Note: All color command parameters can be specified in one of three ways, just choose the method that you are most comfortable with:

  • #RRGGBB - HTML color specification, uses hexadecimal notation to define the amount of red (RR), green (GG) and blue (BB) in a color. These values are between 0 (hexadecimal 00) and 255 (hexadecimal FF) inclusive. Click here for more information and examples with hexadecimal colors.
  • R G B - decimal colour specification, uses normal decimal notation to define the amount of red (RRR), green (GGG) and blue (BBB) in a color. These values are between 0 and 255 inclusive. Click here for more information and examples with decimal colors.
  • R.R G.G B.B - real colour specification, used real number notation to define the amount of red (R.R), green (G.G) and blue (B.B) in a color. These values are between 0.0 and 1.0 inclusive. Click here for more information and examples with real colors.

  •   -Datum
    Parameters: label - is the text associated with the value - can be up to 30 characters long.
    value data series #1 - is a numeric value (either integer, real or time).
    value data series #2 - is optional and if specified must be the same type as value data series #1.
    value data series #3 - is optional and if specified must be the same type as value data series #1.
    value data series #4 - is optional and if specified must be the same type as value data series #1.
    value data series #5 - is optional and if specified must be the same type as value data series #1.
    value data series #6 - is optional and if specified must be the same type as value data series #1.
    value data series #7 - is optional and if specified must be the same type as value data series #1.
    value data series #8 - is optional and if specified must be the same type as value data series #1.
    value data series #9 - is optional and if specified must be the same type as value data series #1.
    value data series #10 - is optional and if specified must be the same type as value data series #1.
    Notes:
  • There is an overall limit of 1000 items of data per data series, and at least one item must be defined.
  • Both this and the -DataSet command can be used either individually or together, and in any order.
  • If spaces are required in the label then put quotes around the label text.
  • If a time value is specified as the first value then all values must be time values.
  • If a time value is not specified as the first value then any subsequent value must NOT be a time value.
  • A time value has the general form of HH:MM:SS.FFF where:
    HH - hours (0 upwards)
    MM - minutes (0 to 59)
    SS - seconds (0 to 59)
    FFF - milliseconds (0 to 999)
    Note: HH and FFF are optional
  • Values for data series #2 to #10 are optional and specify the values in the additional data series.
  • An alternative to specifying all required data series values using just the -Datum command are the -Datum2 through to -Datum10 commands as detailed below.
  • -Datum commands specifying all data series values can be mixed with -Datum commands specifying the first data series value along with subsequent -Datum2 through to -Datum10 commands.

  •   -Datum2, -Datum3, -Datum4, -Datum5, -Datum6, -Datum7, -Datum8, -Datum9, -Datum10
    Parameters: value for specified data series - is a numeric value (either integer, real or time).
    Notes:
  • There is an overall limit of 1000 items of data per data series, and at least one data series must be defined.
  • Both these and the -DataSet command can be used either individually or together, and in any order.
  • There is NO label specified for subsequent data series as they all share the same label as the first series.
  • If a time value is specified as the first value then all values must be time values.
  • If a time value is not specified as the first value then any subsequent value must NOT be a time value.
  • A time value has the general form of HH:MM:SS.FFF where:
    HH - hours (0 upwards)
    MM - minutes (0 to 59)
    SS - seconds (0 to 59)
    FFF - milliseconds (0 to 999)
    Note: HH and FFF are optional
  • Values for data series #2 to #10 are optional and specify the values in the additional data series.
  • These -Datum2 through to -Datum10 commands can be used as an alternative to specifying all required data series values using just the -Datum command as detailed above.
  • -Datum commands specifying all data series values can be mixed with -Datum commands specifying the first data series value along with subsequent -Datum2 through to -Datum10 commands.
  • -Datum2 through to -Datum10 commands specify the data series value at the same position in the data series as the -Datum command, in other words, you must use a -Datum2 command after each -Datum command - you cannot list all the -Datum commands first and then all of the -Datum2 commands. If this was done then each subsequent -Datum2 command data series value would overwrite the same position.

  •   -Line
    Parameters: color data series #1 - color for the line of data series #1.
    thickness data series #1 - must be greater than 0.0 and less than or equal to 100.0. Normally a value of 1.0 would be used.
    color data series #2 - is optional and if specified is the color for the line of data series #2.
    thickness data series #2 - must be greater than 0.0 and less than or equal to 100.0. Normally a value of 1.0 would be used.
    color data series #3 - is optional and if specified is the color for the line of data series #3.
    thickness data series #3 - must be greater than 0.0 and less than or equal to 100.0. Normally a value of 1.0 would be used.
    color data series #4 - is optional and if specified is the color for the line of data series #4.
    thickness data series #4 - must be greater than 0.0 and less than or equal to 100.0. Normally a value of 1.0 would be used.
    color data series #5 - is optional and if specified is the color for the line of data series #5.
    thickness data series #5 - must be greater than 0.0 and less than or equal to 100.0. Normally a value of 1.0 would be used.
    color data series #6 - is optional and if specified is the color for the line of data series #6.
    thickness data series #6 - must be greater than 0.0 and less than or equal to 100.0. Normally a value of 1.0 would be used.
    color data series #7 - is optional and if specified is the color for the line of data series #7.
    thickness data series #7 - must be greater than 0.0 and less than or equal to 100.0. Normally a value of 1.0 would be used.
    color data series #8 - is optional and if specified is the color for the line of data series #8.
    thickness data series #8 - must be greater than 0.0 and less than or equal to 100.0. Normally a value of 1.0 would be used.
    color data series #9 - is optional and if specified is the color for the line of data series #9.
    thickness data series #9 - must be greater than 0.0 and less than or equal to 100.0. Normally a value of 1.0 would be used.
    color data series #10 - is optional and if specified is the color for the line of data series #10.
    thickness data series #10 - must be greater than 0.0 and less than or equal to 100.0. Normally a value of 1.0 would be used.
    Notes:
  • Specifies the line thickness and color that is used to connect all of the data items.
  • When using multiple data series it is normal to use either different line colors and / or thicknesses to differentiate the different data series.

  •   -LineMarker
    Parameters: shape data series #1 - must be one of the following values:
  • FilledCircle
  • OutlineCircle
  • FilledSquare
  • OutlineSquare
  • Cross
  • FilledDiamond
  • OutlineDiamond

  • color data series #1 - color for the data series #1 shape.
    size data series #1 - must be between 0 and 100.0 inclusive.
    outline thickness data series #1 - is only specified if one of the "outline" (or cross) shapes is used for data series #1, must be between 0 and 100.0 inclusive.
    shape data series #2 - is optional and if specified must be one of the shape values listed above.
    color data series #2 - is optional and if specified is the color for the data series #2 shape.
    size data series #2 - is optional and if specified must be between 0 and 100.0 inclusive.
    outline thickness data series #2 - is only specified if one of the "outline" (or cross) shapes is used for data series #2, must be between 0 and 100.0 inclusive.
    shape data series #3 - is optional and if specified must be one of the shape values listed above.
    color data series #3 - is optional and if specified is the color for the data series #3 shape.
    size data series #3 - is optional and if specified must be between 0 and 100.0 inclusive.
    outline thickness data series #3 - is only specified if one of the "outline" (or cross) shapes is used for data series #3, must be between 0 and 100.0 inclusive.
    shape data series #4 - is optional and if specified must be one of the shape values listed above.
    color data series #4 - is optional and if specified is the color for the data series #4 shape.
    size data series #4 - is optional and if specified must be between 0 and 100.0 inclusive.
    outline thickness data series #4 - is only specified if one of the "outline" (or cross) shapes is used for data series #4, must be between 0 and 100.0 inclusive.
    shape data series #5 - is optional and if specified must be one of the shape values listed above.
    color data series #5 - is optional and if specified is the color for the data series #5 shape.
    size data series #5 - is optional and if specified must be between 0 and 100.0 inclusive.
    outline thickness data series #5 - is only specified if one of the "outline" (or cross) shapes is used for data series #5, must be between 0 and 100.0 inclusive.
    shape data series #6 - is optional and if specified must be one of the shape values listed above.
    color data series #6 - is optional and if specified is the color for the data series #6 shape.
    size data series #6 - is optional and if specified must be between 0 and 100.0 inclusive.
    outline thickness data series #6 - is only specified if one of the "outline" (or cross) shapes is used for data series #6, must be between 0 and 100.0 inclusive.
    shape data series #7 - is optional and if specified must be one of the shape values listed above.
    color data series #7 - is optional and if specified is the color for the data series #7 shape.
    size data series #7 - is optional and if specified must be between 0 and 100.0 inclusive.
    outline thickness data series #7 - is only specified if one of the "outline" (or cross) shapes is used for data series #7, must be between 0 and 100.0 inclusive.
    shape data series #8 - is optional and if specified must be one of the shape values listed above.
    color data series #8 - is optional and if specified is the color for the data series #8 shape.
    size data series #8 - is optional and if specified must be between 0 and 100.0 inclusive.
    outline thickness data series #8 - is only specified if one of the "outline" (or cross) shapes is used for data series #8, must be between 0 and 100.0 inclusive.
    shape data series #9 - is optional and if specified must be one of the shape values listed above.
    color data series #9 - is optional and if specified is the color for the data series #9 shape.
    size data series #9 - is optional and if specified must be between 0 and 100.0 inclusive.
    outline thickness data series #9 - is only specified if one of the "outline" (or cross) shapes is used for data series #9, must be between 0 and 100.0 inclusive.
    shape data series #10 - is optional and if specified must be one of the shape values listed above.
    color data series #10 - is optional and if specified is the color for the data series #10 shape.
    size data series #10 - is optional and if specified must be between 0 and 100.0 inclusive.
    outline thickness data series #10 - is only specified if one of the "outline" (or cross) shapes is used for data series #10, must be between 0 and 100.0 inclusive.
    Notes:
  • This is optional and specifies a marker to be displayed on the line at the data point position.
  • The color of the marker can be different to that of the line in order to make it stand out.
  • When using multiple data series it is normal to use different marker shape and color combinations to make the differentiate the different data series.