function widget:GetInfo()
  return {
    name      = "GUI_Tut_Hello_World",
    desc      = "Draw a Rectangle and text to the screen",
    author    = "Enetheru",
    date      = "17 June 2010",
    license   = "GPLv2 or later",
    layer     = 1, -- not sure what layer I should be using
    enabled   = false -- default to disabled
  }
end

-- Used to store the view size
local view_w, view_h

-- By localising finction calls it speeds up calling them. in this
-- little program it isnt useful as i only really use the functions once each
-- but in more complex setups where calling them 1000's of times there can be
-- considerable improvement
local gl_GetViewSizes = gl.GetViewSizes
local gl_Color = gl.Color
local gl_Rect = gl.Rect
local gl_Text = gl.Text

-- This function is what is run when you enable the widget, it is only run once.
function widget:Initialize()
        -- Get and store the view size.
        -- gl.GetViewSizez() -> width, height
        view_w, view_h = gl_GetViewSizes()
end

-- This function runs every screen update, so make it really fast..
function widget:DrawScreen()
        -- Draw a rectangle
        -- gl.Color(red, green, blue, alpha) -> nil
        -- RGBA Colour values range from 0.0 to 1.0.
        -- In this case I have gone for dark grey at 50% opacity.
        gl_Color( 0.1, 0.1, 0.1, 0.5 )

        -- gl.Rect( x1, y1, x2, y2) -> nil
        -- Coordinate system starts at 0,0 bottom left.
        -- First two coordinates are the bottom left of the rectangle, second two
        -- are the top right.
        gl_Rect( view_w / 3.0, view_h / 3.0,
                        view_w * 2.0 / 3.0, view_h * 2.0 / 3.0 )

        -- Draw some text
        -- Full white
        gl_Color( 1, 1, 1, 1)

        -- gl.Text("text", x-position, y-position, size [, "options"]) -> nil
        -- where "options" are:
        -- 'c' = center
        -- 'r' = right
        -- 'n' = deactives colorCodes (so you can use gl.Color() to write
        --              transparent text etc.)
        -- 'o' = black outline
        -- 'O' = white outline
        gl_Text( "Hello World!", view_w / 2, view_h / 2, 16, "co" )
end