Feedback system¶

The LayerFeedback.h module handles the computation of all essential data required to deliver visual guidance to the user during the fabrication process. To compute feedback, information is primarily retrieved from two preceding layers:

1. LayerModel.h: Contains the execution model and the geometries associated with the currently active hole or cut (via AC_FF_COMP macro).
2. LayerToolhead.h: Provides similar information, but specific to the current toolhead attached to the tool (via AC_FF_TOOL macro).

The LayerFeedback::OnFrameStart() from the LayerFeedback.h simply activates the feedback set based on the correct toolhead based on the current fabrication element.

Once the correct feedback is indetified, we have all the geometries of the joint or hole we are working on, as well as the geometries of the toolhead attached to the tool, we can compute all the relevant computations to build the feedback set: starting distance, depth, orientation, etc. In the layer LayerFeedback.h not only we calculate these values but we generate all the necessary GOs to visualize them in the AR scene.

FabFeedback interface¶

Feedback is categorized by similar operations:

• drilling (HoleFeedback.h),
• circular cutting (CutCircularSawFeedback.h),
• and chainsaw cutting (CutChainSawFeedback.h).

Each feedback category inherits from an interface class (AIAC/Feedback/FabFeedback.h), which provides top-level control functions such as Update(), Activate(), and Deactivate().

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

#pragma once

#include "AIAC/Config.h"

#define AC_FF_COMP AIAC_APP.GetLayer<LayerModel>()->GetACInfoModel().GetTimberInfo().GetCurrentComponent()
#define AC_FF_TOOL AIAC_APP.GetLayer<LayerToolhead>()->ACInfoToolheadManager->GetActiveToolhead()

namespace AIAC {
    class FabFeedback {
    public:
        FabFeedback() {
            this->m_ScaleFactor = AIAC::Config::Get<float>(AIAC::Config::SEC_AIAC, AIAC::Config::SCALE_FACTOR, 1.0f);
        };
        ~FabFeedback() = default;

        virtual void Update() {};
        virtual void Activate() {};
        virtual void Deactivate() {};

    protected:
        float m_ScaleFactor = 0.0f;
    };
}

FeedbackVisualizer widgets¶

Each tool's visual guidance might consists of multiple visual cues, most of which are built on the template FeedbackVisualizer.h. All the feedback values are computed but also visualized as GOs, and stored inside (m_AllPrimitives). This is convinient as we can easily toggle the visibility of the feedback by calling the Activate()/Deactivate() functions.

 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

#ifndef AC_FEEDBACKVISUALIZER_H
#define AC_FEEDBACKVISUALIZER_H

#include "vector"
#include "memory"
#include "AIAC/GOSys/GOPrimitive.h"
#include "AIAC/Config.h"

namespace AIAC{
    class FeedbackVisualizer {
    public:
        FeedbackVisualizer() = default;
        ~FeedbackVisualizer() = default;

        inline virtual void Activate() {
            for (auto &p : m_AllPrimitives) {
                p->SetVisibility(true);
            }
        }

        inline virtual void Deactivate() {
            for (auto &p : m_AllPrimitives) {
                p->SetVisibility(false);
            }
        }

        // ...

    protected:
        std::vector<std::shared_ptr<GOPrimitive>> m_AllPrimitives;
    };

}

This composite system allows for a flexible and modular feedback system that can be easily extended with new feedback types and visualizations.