UM:Appendix Monitorgraphs Spec

From DigitalVision
Revision as of 14:21, 8 July 2015 by Alastair (talk | contribs)

Jump to: navigation, search

Darrow-up.png     Previous Next

Graphs Specification

Display a graph or histogram of image colour map.

 

app-viewer_hist1

Parade style centred.

app-viewer_hist2

Fill style south-west.

 

File Specification

A graphs file must end in the extension '.graphs', e.g. test.graphs
It should be a plain text file

 

The format used for a Graph file is simpler than that used for Grids and Masks.

 

Each specification file specifies one or more graphs, each identified by unique name (a GraphID string) and containing a list of drawing instructions.

Graph File Format

// This is a comment and ignored

<GraphID 1>

{

   <Graph Specification>

}

 

<GraphID 2>

{

   <Graph Specification>

}

 

 

Graph files :

 

Do not use semi-colons to terminate lines
Use C++ style comments (two characters "//" at line start)

Overview

The main elements of the graph are shown below :

 

app-viewer_overall-annotated

Main Parameters

GraphID

The unique identifier for the graph e.g.

 

NameOfGraph

{

   ....

}

 

This identifier is not displayed.

 

dv_alert

This identifier must not contain any spaces.

name

name   "<STRING>"

 

This is the name displayed in the GUI Graph drop-down list e.g.

 

app-viewer_name-cropped-scaled

Graph name in drop-down list

intervals

intervals  <INT>

 

The intervals parameter defines the total number of solid lines drawn to mark intervals on the graph. See overview diagram above.

black

black  <FLOAT>

 

The black parameter specifies the position of the dashed line representing the black point. See overview diagram above.

 

It is given in normalised coordinates (0.0 to 1.0).

white

white  <FLOAT>

 

The white parameter specifies the position of the dashed line representing the white point. See overview diagram above.

 

It is given in normalised coordinates (0.0 to 1.0).

Current Section

The current section is optional.

 

current

{

   origin "bottom" "left"

   offset 0 0

   size   800 600

   style "parade"

}

origin

origin "<STRING V>" "<STRING H>"

 

This defines the vertical and horizontal positioning of the graph.

 

Where :

STRING V

Vertical alignment.

Values : bottom center (or centre) top

STRING H

Horizontal alignment

Values : left center (or centre) right

offset

offset <INT x> <INT y>

 

This is the (x,y) position of the graph inside the monitor display area.

 

(0,0) is bottom-left.

size

size <INT w> <INT h>

 

This is the (width,height) in pixels of the graph.

style

style "<STRING S>"

 

Where :

STRING S

Style chosen

Values : parade fill line

 

This defines the type of graph to display.

 

app-viewer_parade

parade

app-viewer_fill

fill

app-viewer_line

line

Compare Section

The compare section is optional.

 

compare

{

   origin "bottom" "left"

}

 

If present, this defines the location of the second comparison graph when in compare mode. The origin parameter is as per the current section but refers to the location of the second comparison graph.

 

Example :

 

current

{

   origin "bottom" "left"

   ....

}

 

compare

{

   origin "top" "right"

}

app-viewer_compare-cropped-scaled-anno

Dual Comparison Mode with Graphs

 

Darrow-up.png     Previous Next