NAME

    Tickit::Widget::SegmentDisplay - show a single character like a
    segmented display

DESCRIPTION

    This class provides a widget that imitates a segmented LED or LCD
    display. It shows a single character by lighting or shading fixed
    rectangular bars.

STYLE

    The default style pen is used as the widget pen, though only the
    background colour will actually matter as the widget does not directly
    display text.

    The following style keys are used:

    lit => COLOUR

    unlit => COLOUR

      Colour descriptions (index or name) for the lit and unlight segments
      of the display.

CONSTRUCTOR

 new

       $segmentdisplay = Tickit::Widget::SegmentDisplay->new( %args )

    Constructs a new Tickit::Widget::SegmentDisplay object.

    Takes the following named arguments

    value => STR

      Sets an initial value.

    type => STR

      The type of display. Supported types are:

      seven

	A 7-segment bar display. The display can also be blanked with the
	value " ".

      seven_dp

	A 7-segment bar display with decimal-point. To light the decimal
	point, append the value with ".".

      colon

	A static :

      symb

	A unit, prefix symbol or other character. The following characters
	are recognised:

          V A W Ω F H s
          G M k m µ n p
          + - %

	Each will be drawn in a style approximately to fit the general LED
	shape display, by drawing lines of erased cells. Note however that
	some more intricate shapes may not be very visible on smaller
	scales.

    use_unicode => BOOL

      If true, use Unicode block-drawing characters. If false, use only
      coloured erase cells using the background colour.

    use_halfline => BOOL

      If true, vertical resolution of rendered block characters is
      effectively doubled by using half-filled Unicode block-drawing
      characters. Setting this option implies use_unicode.

    use_linedraw => BOOL

      If true, use Unicode linedrawing instead of erased or solid blocks.
      This style is more readable on smaller sizes, but is only supported
      by seven and colon types.

    thickness => INT

      Gives the number of columns wide and half-lines tall that LED bars
      will be drawn in. Note that unless use_halfline is set, this value
      ought to be an even number. Defaults to 2.

      When use_linedraw is in effect, if thickness is greater than 1 then
      LINE_THICK segments will be used for drawing. Defaults to 1.

ACCESSORS

 value

       $value = $segmentdisplay->value
    
       $segmentdisplay->set_value( $value )

    Return or set the character on display

AUTHOR

    Paul Evans <leonerd@leonerd.org.uk>

