Skip to content

qtm.gui._3d

Interface to the measurement 3d view with methods for custom drawing.

import qtm

def draw_sphere():
    # Draw a red sphere located in (x=1000, y=500, z=750), with a diameter of 500 mm.
    position = [1000, 500, 750]
    diameter = 500
    color = qtm.utilities.color.rgb(0.855, 0.161, 0.11)
    qtm.gui._3d.draw_sphere(position, diameter, color)

def draw_arrow():
    # Draw a red arrow, with its base at (x=1000, y=-500, z=750), and points towards the sphere.
    starting_point = [1000, -500, 750]
    pointing_at = [1000, 150, 750]
    color = qtm.utilities.color.rgb(0.855, 0.161, 0.11)
    qtm.gui._3d.draw_arrow(starting_point, pointing_at, color)

def draw_axes():
    # Draw an axis in (x=-1000, y=-500, z=750) and 500 mm in size.
    translation_matrix = ([
            [1.0, 0.0, 0.0, -1000,0],
            [0.0, 1.0, 0.0,  -500.0],
            [0.0, 0.0, 1.0,   750.0],
            [0.0, 0.0, 0.0,     1.0]
        ])
    size = 500
    qtm.gui._3d.draw_axes(translation_matrix, size)

def draw_text_2d(measurement_time):
    # Draw the current frames measurement time in the middle of the 3D view.
    position = [0, 0]
    font_size = 24
    text_to_draw = '{:.2f}'.format(measurement_time)
    origin = {"horizontal": "center", "vertical": "center"}
    alignment = {"horizontal": "center", "vertical": "center"}
    color = qtm.utilities.color.rgb(0.855, 0.161, 0.11)
    qtm.gui._3d.draw_text_2d(position, font_size, text_to_draw, origin, alignment, color)

def draw_callback(measurement_time):
    draw_sphere()
    draw_arrow()
    draw_axes()
    draw_text_2d(measurement_time)

# - Set "draw_callback" as the draw function
qtm.gui._3d.set_draw_function(draw_callback)
function draw_sphere()
    -- Draw a red sphere located in (x=1000, y=500, z=750), with a diameter of 500 mm.
    position = {1000, 500, 750}
    diameter = 500
    color = qtm.utilities.color.rgb(0.855, 0.161, 0.11)
    qtm.gui._3d.draw_sphere(position, diameter, color)
end

function draw_arrow()
    -- Draw a red arrow, with its base at (x=1000, y=-500, z=750), and points towards the sphere.
    starting_point = {1000, -500, 750}
    pointing_at = {1000, 150, 750}
    color = qtm.utilities.color.rgb(0.855, 0.161, 0.11)
    qtm.gui._3d.draw_arrow(starting_point, pointing_at, color)
end

function draw_axes()
    -- Draw an axis in (x=-1000, y=-500, z=750) and 500 mm in size.
    translation_matrix = {
        {1.0, 0.0, 0.0, -1000.0},
        {0.0, 1.0, 0.0,  -500.0},
        {0.0, 0.0, 1.0,   750.0},
        {0.0, 0.0, 0.0,     1.0}
    }
    qtm.gui._3d.draw_axes(translation_matrix, 500)
end

function draw_text_2d(measurement_time)
    -- Draw the current frames  measurement time in the middle of the 3D view.
    position = {0, 0}
    font_size = 24
    text_to_draw = string.format("%.2f", measurement_time)
    origin = {horizontal="center", vertical="center"}
    alignment = {horizontal="center", vertical="center"}
    color = qtm.utilities.color.rgb(0.855, 0.161, 0.11)
    qtm.gui._3d.draw_text_2d(position, font_size, text_to_draw, origin, alignment, color)
end


function draw_callback(measurement_time)
    draw_sphere()
    draw_arrow()
    draw_axes()
    draw_text_2d(measurement_time)
end

-- - Set "draw_callback" as the draw function
qtm.gui._3d.set_draw_function(draw_callback)

draw_sphere

Draw a sphere.

qtm.gui._3d.draw_sphere(position, size, color?)

This method may only be used in a draw callback function (see 'set_draw_function').

Parameters

position vec3f
The position of the center of the sphere (in millimeters).

size float
The diameter of the sphere (in millimeters).

color integer?
The color of the sphere (in 0xbbggrr format, see 'qtm.utilities.color' module). If null, white (0xffffff) will be used.


draw_arrow

Draw an arrow.

qtm.gui._3d.draw_arrow(position, endpoint, color?)

This method may only be used in a draw callback function (see 'set_draw_function').

Parameters

position vec3f
The position of the tail of the arrow (in millimeters).

endpoint vec3f
The position of the head of the arrow (in millimeters).

color integer?
The color of the arrow (in 0xbbggrr format, see 'qtm.utilities.color' module). If null, white (0xffffff) will be used.


draw_axes

Draw coordinate system axes.

qtm.gui._3d.draw_axes(transform, size)

This method may only be used in a draw callback function (see 'set_draw_function').

Parameters

transform mat4x4f
The transform of the axes (with translation in millimeters).

size float
The size of the axes (in millimeters).


draw_mesh

Draw a mesh.

qtm.gui._3d.draw_mesh(transform, scale, filename)

This method may only be used in a draw callback function (see 'set_draw_function').

Parameters

transform mat4x4f
The transform of the mesh (with translation in millimeters).

scale float
The scale of the mesh (the units of the mesh is assumed to be in meters).

filename string
The filename of the mesh. Only .obj files are supported. The file must be located next to the measurement or in one of the project's meshes folders.


draw_text_2d

Draw 2d text.

qtm.gui._3d.draw_text_2d(position, size, text, origin?, alignment?, color?)

This method may only be used in a draw callback function (see 'set_draw_function').

Parameters

position vec2f
The position of the text (in pixels relative to the given origin, with positive axes pointing down-right).

size integer
The font size.

text string
The text.

origin {"horizontal": "left"|"center"|"right", "vertical": "top"|"center"|"bottom"}?
The origin of the text position (if null, top-left corner will be used).

alignment {"horizontal": "left"|"center"|"right", "vertical": "top"|"center"|"bottom"}?
The alignment of the text (if null, top-left alignment will be used).

color integer?
The color of the text (in 0xbbggrr format, see 'qtm.utilities.color' module). If null, white (0xffffff) will be used.


set_draw_function

Set a draw callback function.

qtm.gui._3d.set_draw_function(function?)

Parameters

function function?
The function to invoke when the 3d view is redrawn (if null, custom drawing will be disabled). The function must have a single float parameter receiving the measurement time to be drawn (in seconds).


help

Get the documentation for a module or method.

qtm.gui._3d.help(method?)

Parameters

method string?
The name of the method (if null, the documentation for the module will be returned instead).

Returns

string