nuitrack-rs 0.0.15

Rust bindings for the Nuitrack SDK, enabling skeletal tracking, gesture recognition, and other computer vision capabilities.
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137

#include "nuitrack_bridge/modules/hand_tracker.h"
#include "nuitrack/modules/HandTracker.h"
#include "nuitrack/types/HandTrackerData.h"
#include "nuitrack/Nuitrack.h" // For tdv::nuitrack::Exception


#include <stdexcept> // For std::runtime_error

#include <string>    // For std::string

#include <functional> // For std::function (used by Nuitrack callbacks)


namespace nuitrack_bridge::hand_tracker {

    // Reusing error formatting helpers (can be in a shared utility header if used by many modules)
    static std::string format_nuitrack_error(const std::string& function_name, const std::string& nuitrack_error_what) {
        return "Nuitrack " + function_name + " failed: " + nuitrack_error_what;
    }

    static std::string format_std_error(const std::string& function_name, const std::string& std_error_what) {
        return "Standard exception in Nuitrack " + function_name + ": " + std_error_what;
    }

    static std::string format_unknown_error(const std::string& function_name) {
        return "Unknown exception during Nuitrack " + function_name;
    }

    std::shared_ptr<HandTracker> createHandTracker() {
        try {
            return tdv::nuitrack::HandTracker::create();
        } catch (const tdv::nuitrack::Exception& e) {
            throw std::runtime_error(format_nuitrack_error("HandTracker::create", e.what()));
        } catch (const std::exception& e) {
            throw std::runtime_error(format_std_error("HandTracker::create", e.what()));
        } catch (...) {
            throw std::runtime_error(format_unknown_error("HandTracker::create"));
        }
    }

    uint64_t connectOnUpdateForAsync(
        const std::shared_ptr<HandTracker>& tracker,
        void* handFrameSender
    ) {
        if (!tracker) {
            throw std::runtime_error("HandTracker instance is null in connectOnUpdateForAsync");
        }
        try {
            return tracker->connectOnUpdate(
                [handFrameSender](tdv::nuitrack::HandTrackerData::Ptr data) {
                    // Call the Rust dispatcher
                    rust_hand_tracker_hand_frame_dispatcher_async(data, handFrameSender);
                });
        } catch (const tdv::nuitrack::Exception& e) {
            throw std::runtime_error(format_nuitrack_error("HandTracker::connectOnUpdate", e.what()));
        } catch (const std::exception& e) { // Catches rust::Error too
            throw std::runtime_error(format_std_error("HandTracker::connectOnUpdate", e.what()));
        } catch (...) {
            throw std::runtime_error(format_unknown_error("HandTracker::connectOnUpdate"));
        }
    }

    void disconnectOnUpdate(
        const std::shared_ptr<HandTracker>& tracker,
        uint64_t handlerId
    ) {
        if (!tracker) {
            throw std::runtime_error("HandTracker instance is null in disconnectOnUpdate");
        }
        try {
            tracker->disconnectOnUpdate(handlerId);
        } catch (const tdv::nuitrack::Exception& e) {
            throw std::runtime_error(format_nuitrack_error("HandTracker::disconnectOnUpdate", e.what()));
        } catch (const std::exception& e) {
            throw std::runtime_error(format_std_error("HandTracker::disconnectOnUpdate", e.what()));
        } catch (...) {
            throw std::runtime_error(format_unknown_error("HandTracker::disconnectOnUpdate"));
        }
    }

    std::shared_ptr<HandData> getData(const std::shared_ptr<HandTracker>& tracker) {
        if (!tracker) {
            throw std::runtime_error("HandTracker instance is null in getData");
        }
        try {
            return tracker->getData();
        } catch (const tdv::nuitrack::Exception& e) {
            throw std::runtime_error(format_nuitrack_error("HandTracker::getData", e.what()));
        } catch (const std::exception& e) {
            throw std::runtime_error(format_std_error("HandTracker::getData", e.what()));
        } catch (...) {
            throw std::runtime_error(format_unknown_error("HandTracker::getData"));
        }
    }

    float getProcessingTime(const std::shared_ptr<HandTracker>& tracker) {
        if (!tracker) {
            throw std::runtime_error("HandTracker instance is null in getProcessingTime");
        }
        try {
            return tracker->getProcessingTime();
        } catch (const tdv::nuitrack::Exception& e) {
            throw std::runtime_error(format_nuitrack_error("HandTracker::getProcessingTime", e.what()));
        } catch (const std::exception& e) {
            throw std::runtime_error(format_std_error("HandTracker::getProcessingTime", e.what()));
        } catch (...) {
            throw std::runtime_error(format_unknown_error("HandTracker::getProcessingTime"));
        }
    }

    bool canUpdate(const std::shared_ptr<HandTracker>& tracker) {
        if (!tracker) {
            throw std::runtime_error("HandTracker instance is null in canUpdate");
        }
        try {
            return tracker->canUpdate(); // Inherited from tdv::nuitrack::Module
        } catch (const tdv::nuitrack::Exception& e) {
            throw std::runtime_error(format_nuitrack_error("HandTracker::canUpdate (Module)", e.what()));
        } catch (const std::exception& e) {
            throw std::runtime_error(format_std_error("HandTracker::canUpdate (Module)", e.what()));
        } catch (...) {
            throw std::runtime_error(format_unknown_error("HandTracker::canUpdate (Module)"));
        }
    }

    uint64_t getTrackerTimestamp(const std::shared_ptr<HandTracker>& tracker) {
        if (!tracker) {
            throw std::runtime_error("HandTracker instance is null in getTrackerTimestamp");
        }
        try {
            return tracker->getTimestamp(); // Inherited from tdv::nuitrack::Module
        } catch (const tdv::nuitrack::Exception& e) {
            throw std::runtime_error(format_nuitrack_error("HandTracker::getTimestamp (Module)", e.what()));
        } catch (const std::exception& e) {
            throw std::runtime_error(format_std_error("HandTracker::getTimestamp (Module)", e.what()));
        } catch (...) {
            throw std::runtime_error(format_unknown_error("HandTracker::getTimestamp (Module)"));
        }
    }

}