m + misc

Signed-off-by: Mattias Andrée <maandree@operamail.com>

1 files changed, 468 insertions, 0 deletions

diff --git a/src/libgamma-method.hh b/src/libgamma-method.hh
new file mode 100644
index 0000000..514ae31
--- /dev/null
+++ b/src/libgamma-method.hh
@@ -0,0 +1,468 @@
+/**
+ * libgammamm -- C++ wrapper for libgamma
+ * Copyright (C) 2014  Mattias Andrée (maandree@member.fsf.org)
+ * 
+ * This library is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ * 
+ * This library 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 library.  If not, see <http://www.gnu.org/licenses/>.
+ */
+#ifndef LIBGAMMA_METHOD_HH
+#define LIBGAMMA_METHOD_HH
+
+
+#include <string>
+
+#include "libgamma-native.hh"
+
+
+namespace libgamma
+{
+  /**
+   * Cathode ray tube controller information data structure.
+   */
+  class CRTCInformation;
+  
+  /**
+   * Capabilities of adjustment methods.
+   */
+  class MethodCapabilities;
+  
+  
+  
+  /**
+   * Capabilities of adjustment methods.
+   */
+  class MethodCapabilities
+  {
+  public:
+    /**
+     * Constructor.
+     */
+    MethodCapabilities();
+    
+    /**
+     * Constructor.
+     * 
+     * @param  caps  The information in the native structure
+     */
+    MethodCapabilities(libgamma_method_capabilities_t* caps);
+    
+    /**
+     * Copy constructor.
+     * 
+     * @param  other  The information to copy.
+     */
+    MethodCapabilities(const MethodCapabilities& other);
+    
+    /**
+     * Destructor.
+     */
+    ~MethodCapabilities();
+    
+    /**
+     * Copy operator.
+     * 
+     * @param  other  The information to copy.
+     */
+    MethodCapabilities& operator =(const MethodCapabilities& other);
+    
+    
+    
+    
+    /**
+     * OR of the CRTC information fields in `libgamma_crtc_information_t`
+     * that may (but can fail) be read successfully.
+     */
+    int32_t crtc_information;
+    
+    /**
+     * Whether the default site is known, if true the site is integrated
+     * to the system or can be determined using environment variables.
+     */
+    bool default_site_known;
+    
+    /**
+     * Whether the adjustment method supports multiple sites rather
+     * than just the default site.
+     */
+    bool multiple_sites;
+    
+    /**
+     * Whether the adjustment method supports multiple partitions
+     * per site.
+     */
+    bool multiple_partitions;
+    
+    /**
+     * Whether the adjustment method supports multiple CRTC:s
+     * per partition per site.
+     */
+    bool multiple_crtcs;
+    
+    /**
+     * Whether the partition to graphics card is a bijection.
+     */
+    bool partitions_are_graphics_cards;
+    
+    /**
+     * Whether the adjustment method supports `libgamma_site_restore`.
+     */
+    bool site_restore;
+    
+    /**
+     * Whether the adjustment method supports `libgamma_partition_restore`.
+     */
+    bool partition_restore;
+    
+    /**
+     * Whether the adjustment method supports `libgamma_crtc_restore`.
+     */
+    bool crtc_restore;
+    
+    /**
+     * Whether the `red_gamma_size`, `green_gamma_size` and `blue_gamma_size`
+     * fields in `libgamma_crtc_information_t` will always have the same
+     * values as each other for the adjustment method.
+     */
+    bool identical_gamma_sizes;
+    
+    /**
+     * Whether the `red_gamma_size`, `green_gamma_size` and `blue_gamma_size`
+     * fields in `libgamma_crtc_information_t` will always be filled with the
+     * same value for the adjustment method.
+     */
+    bool fixed_gamma_size;
+    
+    /**
+     * Whether the `gamma_depth` field in `libgamma_crtc_information_t`
+     * will always be filled with the same value for the adjustment method.
+     */
+    bool fixed_gamma_depth;
+    
+    /**
+     * Whether the adjustment method will actually perform adjustments.
+     */
+    bool real;
+    
+    /**
+     * Whether the adjustment method is implement using a translation layer.
+     */
+    bool fake;
+    
+  };
+  
+  
+  /**
+   * Types for connectors.
+   */
+  typedef libgamma_connector_type_t ConnectorType;
+  
+  /**
+   * Orders for subpixels. Currently the possible values are
+   * very biased to LCD, Plasma and monochrome monitors.
+   */
+  typedef libgamma_subpixel_order_t SubpixelOrder;
+  
+  
+  /**
+   * Cathode ray tube controller information data structure.
+   */
+  class CRTCInformation
+  {
+  public:
+    /**
+     * Constructor.
+     */
+    CRTCInformation();
+    
+    /**
+     * Constructor.
+     * 
+     * @param  info  The information in the native structure
+     */
+    CRTCInformation(libgamma_crtc_information_t* info);
+    
+    /**
+     * Copy constructor.
+     * 
+     * @param  other  The information to copy.
+     */
+    CRTCInformation(const CRTCInformation& other);
+    
+    /**
+     * Destructor.
+     */
+    ~CRTCInformation();
+    
+    /**
+     * Copy operator.
+     * 
+     * @param  other  The information to copy.
+     */
+    CRTCInformation& operator =(const CRTCInformation& other);
+    
+    
+    
+    /**
+     * The Extended Display Identification Data associated with
+     * the attached monitor. This is raw byte array that is usually
+     * 128 bytes long. It is not NUL-terminate, rather its length
+     * is stored in `edid_length`.
+     */
+    unsigned char* edid;
+    
+    /**
+     * The length of `edid`.
+     */
+    size_t edid_length;
+    
+    /**
+     * Zero on success, positive it holds the value `errno` had
+     * when the reading failed, otherwise (negative) the value
+     * of an error identifier provided by this library.
+     */
+    int edid_error;
+    
+    
+    /**
+     * The phyical width, in millimetres, of the viewport of the
+     * attached monitor, as reported by the adjustment method. This
+     * value may be incorrect, which is a known issue with the X
+     * server where it is the result of the X server attempting
+     * the estimate the size on its own.
+     * Zero means that its is not applicable, which is the case
+     * for projectors.
+     */
+    size_t width_mm;
+    
+    /**
+     * Zero on success, positive it holds the value `errno` had
+     * when the reading failed, otherwise (negative) the value
+     * of an error identifier provided by this library.
+     */
+    int width_mm_error;
+    
+    
+    /**
+     * The phyical height, in millimetres, of the viewport of the
+     * attached monitor, as reported by the adjustment method. This
+     * value may be incorrect, which is a known issue with the X
+     * server where it is the result of the X server attempting
+     * the estimate the size on its own.
+     * Zero means that its is not applicable, which is the case
+     * for projectors.
+     */
+    size_t height_mm;
+    
+    /**
+     * Zero on success, positive it holds the value `errno` had
+     * when the reading failed, otherwise (negative) the value
+     * of an error identifier provided by this library.
+     */
+    int height_mm_error;
+    
+    
+    /**
+     * The phyical width, in millimetres, of the viewport of the
+     * attached monitor, as reported by it the monitor's Extended
+     * Display Information Data. This value can only contain whole
+     * centimetres, which means that the result is always zero
+     * modulus ten. However, this could change with revisions of
+     * the EDID structure.
+     * Zero means that its is not applicable, which is the case
+     * for projectors.
+     */
+    size_t width_mm_edid;
+    
+    /**
+     * Zero on success, positive it holds the value `errno` had
+     * when the reading failed, otherwise (negative) the value
+     * of an error identifier provided by this library.
+     */
+    int width_mm_edid_error;
+    
+    
+    /**
+     * The phyical height, in millimetres, of the viewport of the
+     * attached monitor, as reported by it the monitor's Extended
+     * Display Information Data. This value can only contain whole
+     * centimetres, which means that the result is always zero
+     * modulus ten. However, this could change with revisions of
+     * the EDID structure.
+     * Zero means that its is not applicable, which is the case
+     * for projectors.
+     */
+    size_t height_mm_edid;
+    
+    /**
+     * Zero on success, positive it holds the value `errno` had
+     * when the reading failed, otherwise (negative) the value
+     * of an error identifier provided by this library.
+     */
+    int height_mm_edid_error;
+    
+    
+    /**
+     * The size of the encoding axis of the red gamma ramp.
+     */
+    size_t red_gamma_size;
+    
+    /**
+     * The size of the encoding axis of the green gamma ramp.
+     */
+    size_t green_gamma_size;
+    
+    /**
+     * The size of the encoding axis of the blue gamma ramp.
+     */
+    size_t blue_gamma_size;
+    
+    /**
+     * Zero on success, positive it holds the value `errno` had
+     * when the reading failed, otherwise (negative) the value
+     * of an error identifier provided by this library.
+     */
+    int gamma_size_error;
+    
+    
+    /**
+     * The bit-depth of the value axes of gamma ramps,
+     * -1 for single precision floating point, and -2 for
+     * double precision floating point.
+     */
+    signed gamma_depth;
+    
+    /**
+     * Zero on success, positive it holds the value `errno` had
+     * when the reading failed, otherwise (negative) the value
+     * of an error identifier provided by this library.
+     */
+    int gamma_depth_error;
+    
+    
+    /**
+     * Non-zero gamma ramp adjustments are supported.
+     */
+    int gamma_support;
+    
+    /**
+     * Zero on success, positive it holds the value `errno` had
+     * when the reading failed, otherwise (negative) the value
+     * of an error identifier provided by this library.
+     */
+    int gamma_support_error;
+    
+    
+    /**
+     * The layout of the subpixels.
+     * You cannot count on this value --- especially for CRT:s ---
+     * but it is provided anyway as a means of distinguishing monitors.
+     */
+    SubpixelOrder subpixel_order;
+    
+    /**
+     * Zero on success, positive it holds the value `errno` had
+     * when the reading failed, otherwise (negative) the value
+     * of an error identifier provided by this library.
+     */
+    int subpixel_order_error;
+    
+    
+    /**
+     * Whether there is a monitors connected to the CRTC.
+     */
+    int active;
+    
+    /**
+     * Zero on success, positive it holds the value `errno` had
+     * when the reading failed, otherwise (negative) the value
+     * of an error identifier provided by this library.
+     */
+    int active_error;
+    
+    
+    /**
+     * The name of the connector as designated by the display
+     * server or as give by this library in case the display
+     * server lacks this feature.
+     */
+    std::string* connector_name;
+    
+    /**
+     * Zero on success, positive it holds the value `errno` had
+     * when the reading failed, otherwise (negative) the value
+     * of an error identifier provided by this library.
+     */
+    int connector_name_error;
+    
+    
+    /**
+     * The type of the connector that is associated with the CRTC.
+     */
+    ConnectorType connector_type;
+    
+    /**
+     * Zero on success, positive it holds the value `errno` had
+     * when the reading failed, otherwise (negative) the value
+     * of an error identifier provided by this library.
+     */
+    int connector_type_error;
+    
+    
+    /**
+     * The gamma characteristics of the monitor as reported
+     * in its Extended Display Information Data. The value
+     * holds the value for the red channel. If you do not have
+     * and more accurate measurement of the gamma for the
+     * monitor this could be used to give a rought gamma
+     * correction; simply divide the value with 2.2 and use
+     * the result for the red channel in the gamma correction.
+     */
+    float gamma_red;
+    
+    /**
+     * The gamma characteristics of the monitor as reported
+     * in its Extended Display Information Data. The value
+     * holds the value for the green channel. If you do not have
+     * and more accurate measurement of the gamma for the
+     * monitor this could be used to give a rought gamma
+     * correction; simply divide the value with 2.2 and use
+     * the result for the green channel in the gamma correction.
+     */
+    float gamma_green;
+    
+    /**
+     * The gamma characteristics of the monitor as reported
+     * in its Extended Display Information Data. The value
+     * holds the value for the blue channel. If you do not have
+     * and more accurate measurement of the gamma for the
+     * monitor this could be used to give a rought gamma
+     * correction; simply divide the value with 2.2 and use
+     * the result for the blue channel in the gamma correction.
+     */
+    float gamma_blue;
+    
+    /**
+     * Zero on success, positive it holds the value `errno` had
+     * when the reading failed, otherwise (negative) the value
+     * of an error identifier provided by this library.
+     */
+    int gamma_error;
+    
+  };
+
+  
+}
+
+
+#endif
+