Example Usage

4 Labels with various sizes, colours, captions and positions:

Graphline(
    Label1 = Label(caption="That", size=(2,2,1), sidecolour=(0,200,0), position=(-3,0,-10)),
    Label2 = Label(caption="Boy", bgcolour=(200,100,0), position=(3,0,-10)),
    Label3 = Label(caption="Needs", margin=15, position=(-1,0,-10), rotation=(30,0,10)),
    Label4 = Label(caption="Therapy!", fontsize=20, size=(0.3,0.3,1), position=(1,0,-10)),
    ECHO = ConsoleEchoer(),
    linkages = {
        ("Label1", "outbox") : ("ECHO", "inbox"),
        ("Label2", "outbox") : ("ECHO", "inbox"),
        ("Label3", "outbox") : ("ECHO", "inbox"),
        ("Label4", "outbox") : ("ECHO", "inbox"),
    }
).run()

How does it work?

This component is a subclass of OpenGLComponent. It overrides __init__(), setup(), draw(), handleEvents() and frame().

In setup() only buildCaption() gets called where the set caption is rendered on a pygame surface. This surface is then set as OpenGL texture.

In draw() a flat cuboid is drawn (if size is not specified) with the caption texture on both the front and the back surface.

class Label(OpenGLComponent)

Label(...) -> A new Label component.

A Label widget for the OpenGL display service.

Keyword arguments:

• caption -- Label caption (default="Label")
• bgcolour -- Colour of surfaces behind caption (default=(200,200,200))
• fgcolour -- Colour of the caption text (default=(0,0,0)
• sidecolour -- Colour of side planes (default=(200,200,244))
• margin -- Margin size in pixels (default=8)
• fontsize -- Font size for caption text (default=50)
• pixelscaling -- Factor to convert pixels to units in 3d, ignored if size is specified (default=100)
• thickness -- Thickness of Label widget, ignored if size is specified (default=0.3)