LogMarkerRegistry.h

Go to the documentation of this file.

/*
* This file is part of ArmarX.
*
* ArmarX is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2 as
* published by the Free Software Foundation.
*
* ArmarX is distributed in the hope that it will be useful, but
* WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*
* @package    ArmarX::
* @author     Fabian Reister ( fabian dot reister at kit dot edu )
* @date       2026
* @copyright  http://www.gnu.org/licenses/gpl-2.0.txt
*             GNU General Public License
*/
 
#pragma once
 
// ArmarX
#include <ArmarXCore/interface/core/Log.h>
 
// Qt
#include <QColor>
#include <QObject>
 
// C++
#include <cstdint>
#include <mutex>
#include <vector>
 
namespace armarx
{
    using LogMarkerId = std::uint64_t;
 
    //! A single pinned log line: a snapshot of the message plus the color assigned to it.
    struct LogMarker
    {
        LogMarkerId id = 0;
        LogMessage snapshot;
        QColor color;
    };
 
    /*!
     * \brief Shared, session-only store of pinned ("labeled") log lines.
     *
     * Owned by the LogViewer and shared by (non-owning) pointer with every LogTableModel, so
     * a line pinned in one filter becomes visible (injected) in all of them. Colors are drawn
     * from the Glasbey lookup table (maximally distinct) by an increasing color index.
     *
     * All mutating methods emit markersChanged() so the Labels panel and every model can
     * refresh. Access is GUI-thread only in practice, but a mutex guards the container.
     */
    class LogMarkerRegistry : public QObject
    {
        Q_OBJECT
    public:
        explicit LogMarkerRegistry(QObject* parent = nullptr);
 
        //! Pin the given message. If an equal message is already pinned, its existing marker
        //! is returned unchanged (no duplicate). Assigns the next Glasbey color otherwise.
        const LogMarker* add(const LogMessage& snapshot);
 
        //! Remove the marker with the given id (no-op if unknown).
        void remove(LogMarkerId id);
 
        //! Reassign a marker's color (no-op if unknown).
        void recolor(LogMarkerId id, const QColor& color);
 
        //! Drop all markers.
        void clear();
 
        //! Ordered (insertion-order) view of all markers.
        std::vector<LogMarker> markers() const;
 
        //! Marker for a message identical to \p message, or nullptr. Identity is
        //! (time, who, what); see LogMarkerRegistry.cpp.
        const LogMarker* markerForMessage(const LogMessage& message) const;
 
        //! Whether any marker's snapshot is identical to \p message.
        bool isMarked(const LogMessage& message) const;
 
    signals:
        void markersChanged();
 
    private:
        //! Whole-line identity used to detect duplicates and to match snapshots against live
        //! entries. Same-microsecond collisions with identical text/component are an accepted
        //! limitation (see the concept).
        static bool sameLine(const LogMessage& a, const LogMessage& b);
 
        mutable std::mutex mutex;
        std::vector<LogMarker> entries;
        LogMarkerId nextId = 1;
        std::size_t colorIndex = 0;
    };
} // namespace armarx