LED.h

Go to the documentation of this file.

// Copyright 2015 Sensics, Inc.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//  http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

#ifndef INCLUDED_LED_h_GUID_C53E1134_AD6B_46B0_4808_19C7EAA7D0EC
#define INCLUDED_LED_h_GUID_C53E1134_AD6B_46B0_4808_19C7EAA7D0EC

// Internal Includes
#include "LedMeasurement.h"
#include "LedIdentifier.h"

// Library/third-party includes
#include <opencv2/core/core.hpp>

// Standard includes
#include <vector>

namespace osvr {
namespace vbtracker {

    class Led {
      public:
        Led(LedIdentifier *identifier, LedMeasurement const &meas);
        typedef int ID;

        static const ID SENTINEL_NO_IDENTIFIER_OBJECT_OR_INSUFFICIENT_DATA = -1;
        static const ID SENTINEL_INSUFFICIENT_EXTREMA_DIFFERENCE = -2;
        static const ID SENTINEL_NO_PATTERN_RECOGNIZED_DESPITE_SUFFICIENT_DATA =
            -3;
        static const uint8_t MAX_NOVELTY = 4;
        void addMeasurement(LedMeasurement const &meas, bool blobsKeepId);

        LedMeasurement const &getMeasurement() const {
            return m_latestMeasurement;
        }

        int getID() const { return m_id; }

        int getOneBasedID() const { return (m_id < 0) ? m_id : m_id + 1; }

        bool identified() const { return !(m_id < 0); }

        uint8_t novelty() const { return m_novelty; }

        cv::Point2f getLocation() const { return m_latestMeasurement.loc; }

        KeyPointIterator nearest(KeyPointList &keypoints,
                                 double threshold) const;

        LedMeasurementIterator nearest(LedMeasurementList &meas,
                                       double threshold) const;

        bool isBright() const { return m_lastBright; }

        bool wasUsedLastFrame() const { return m_wasUsedLastFrame; }

        void markAsUsed() { m_wasUsedLastFrame = true; }

        void resetUsed() { m_wasUsedLastFrame = false; }

        void markMisidentified();

      private:
        LedMeasurement m_latestMeasurement;

        BrightnessList m_brightnessHistory;

        int m_id;

        LedIdentifier *m_identifier;

        bool m_lastBright = false;

        bool m_newlyRecognized = false;
        uint8_t m_novelty;

        bool m_wasUsedLastFrame = false;
    };

} // End namespace vbtracker
} // End namespace osvr

#endif // INCLUDED_LED_h_GUID_C53E1134_AD6B_46B0_4808_19C7EAA7D0EC