aboutsummaryrefslogtreecommitdiff
path: root/src/argaze/ArUcoMarkers/ArUcoMarker.py
blob: f088dae052a1ab2a33985934742cfaa7a527a757 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
#!/usr/bin/env python

""" """

__author__ = "Théo de la Hogue"
__credits__ = []
__copyright__ = "Copyright 2023, Ecole Nationale de l'Aviation Civile (ENAC)"
__license__ = "BSD"

from dataclasses import dataclass, field

from argaze.ArUcoMarkers import ArUcoMarkersDictionary

import numpy
import cv2
import cv2.aruco as aruco

@dataclass
class ArUcoMarker():
    """Define ArUco marker class."""

    dictionary: ArUcoMarkersDictionary.ArUcoMarkersDictionary
    """Dictionary to which it belongs."""

    identifier: int
    """Index into dictionary"""

    size: float
    """Size of marker in centimeters."""

    corners: numpy.array = field(init=False, repr=False)
    """Estimated 2D corner positions in camera image referential."""

    translation: numpy.array = field(init=False, repr=False)
    """Estimated 3D center position in camera world referential."""

    rotation: numpy.array = field(init=False, repr=False)
    """Estimated 3D marker rotation in camera world referential."""

    points: numpy.array = field(init=False, repr=False)
    """Estimated 3D corners positions in camera world referential."""

    @property
    def center(self) -> numpy.array:
        """Get 2D center position in camera image referential."""

        return self.corners[0].mean(axis=0)

    def image(self, dpi) -> numpy.array:
        """Create marker matrix image at a given resolution."""

        dimension = round(self.size * dpi / 2.54) # 1 cm = 2.54 inches
        matrix = numpy.zeros((dimension, dimension, 1), dtype="uint8")

        aruco.generateImageMarker(self.dictionary.markers, self.identifier, dimension, matrix, 1)

        return numpy.repeat(matrix, 3).reshape(dimension, dimension, 3)

    def draw(self, image: numpy.array, K, D, color: tuple = None, draw_axes: dict = None):
        """Draw marker in image.

        Parameters:
            image: image where to draw
            color: marker color (if None, no marker drawn)
            draw_axes: enable marker axes drawing
        """

        # Draw marker if required
        if color is not None:

            aruco.drawDetectedMarkers(image, [numpy.array([list(self.corners)])], numpy.array([self.identifier]), color)

        # Draw marker axes if pose has been estimated and if required
        if self.translation.size == 3 and self.rotation.size == 9 and draw_axes is not None:

            cv2.drawFrameAxes(image, numpy.array(K), numpy.array(D), self.rotation, self.translation, self.size, **draw_axes)

    def save(self, destination_folder, dpi):
        """Save marker image as .png file into a destination folder."""

        filename = f'{self.dictionary.name}_{self.dictionary.format}_{self.identifier}.png'
        filepath = f'{destination_folder}/{filename}'

        cv2.imwrite(filepath, self.image(dpi))