File indexing completed on 2024-05-19 05:32:29

 /*
     KWin - the KDE window manager
     This file is part of the KDE project.
 
     SPDX-FileCopyrightText: 2019 Vlad Zahorodnii <vlad.zahorodnii@kde.org>
 
     SPDX-License-Identifier: GPL-2.0-or-later
 */
 
 #pragma once
 
 #include "core/colorspace.h"
 #include "kwin_export.h"
 
 #include <QByteArray>
 #include <QList>
 #include <QSize>
 #include <QVector2D>
 
 namespace KWin
 {
 
 /**
  * Helper class that can be used for parsing EDID blobs.
  *
  * http://read.pudn.com/downloads110/ebook/456020/E-EDID%20Standard.pdf
  */
 class KWIN_EXPORT Edid
 {
 public:
     Edid();
     Edid(const void *data, uint32_t size);
 
     /**
      * Whether this instance of EDID is valid.
      */
     bool isValid() const;
 
     /**
      * Returns physical dimensions of the monitor, in millimeters.
      */
     QSize physicalSize() const;
 
     /**
      * Returns EISA ID of the manufacturer of the monitor.
      */
     QByteArray eisaId() const;
 
     /**
      * Returns the product name of the monitor.
      */
     QByteArray monitorName() const;
 
     /**
      * Returns the serial number of the monitor.
      */
     QByteArray serialNumber() const;
 
     /**
      * Returns the name of the vendor.
      */
     QByteArray vendor() const;
 
     /**
      * Returns the raw edid
      */
     QByteArray raw() const;
 
     /**
      * returns the vendor if included, the EISA ID if not
      */
     QString manufacturerString() const;
 
     /**
      * returns a string representing the monitor name
      * Can be a serial number or "unknown" if the name is empty
      */
     QString nameString() const;
 
     QString hash() const;
 
     std::optional<Colorimetry> colorimetry() const;
 
     double desiredMinLuminance() const;
     std::optional<double> desiredMaxFrameAverageLuminance() const;
     std::optional<double> desiredMaxLuminance() const;
     bool supportsPQ() const;
     bool supportsBT2020() const;
 
     /**
      * @returns a string that is intended to identify the monitor uniquely.
      * Note that multiple monitors can have the same EDID, so this is not always actually unique
      */
     QByteArray identifier() const;
 
 private:
     QSize m_physicalSize;
     QByteArray m_vendor;
     QByteArray m_eisaId;
     QByteArray m_monitorName;
     QByteArray m_serialNumber;
     QString m_hash;
     std::optional<Colorimetry> m_colorimetry;
     struct HDRMetadata
     {
         double desiredContentMinLuminance;
         std::optional<double> desiredContentMaxLuminance;
         std::optional<double> desiredMaxFrameAverageLuminance;
         bool supportsPQ;
         bool supportsBT2020;
     };
     std::optional<HDRMetadata> m_hdrMetadata;
 
     QByteArray m_identifier;
 
     QByteArray m_raw;
     bool m_isValid = false;
 };
 
 } // namespace KWin