some of libgamma-facade

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

1 files changed, 146 insertions, 0 deletions

diff --git a/src/libgamma_facade.py b/src/libgamma_facade.py
new file mode 100644
index 0000000..830a0b9
--- /dev/null
+++ b/src/libgamma_facade.py
@@ -0,0 +1,146 @@
+# -*- python -*-
+'''
+pylibgamma — Python 3 wrapper for libgamma
+Copyright © 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/>.
+'''
+
+
+from libgamma_method import MethodCapabilities
+
+
+
+def list_methods(operation : int) -> list
+    '''
+    List available adjustment methods by their order of preference based on the environment.
+    
+    @param  operation    Allowed values:
+                           0: Methods that the environment suggests will work, excluding fake.
+                           1: Methods that the environment suggests will work, including fake.
+                           2: All real non-fake methods.
+                           3: All real methods.
+                           4: All methods.
+                         Other values invoke undefined behaviour.
+    @return  :list<int>  A list of available adjustment methods.
+    '''
+    from libgamma_native_method import libgamma_native_list_methods
+    return libgamma_native_list_methods(method)
+
+
+def is_method_available(method : int) -> bool:
+    '''
+    Check whether an adjustment method is available, non-existing (invalid) methods will be
+    identified as not available under the rationale that the library may be out of date.
+    
+    @param   method  The adjustment method.
+    @return          Whether the adjustment method is available.
+    '''
+    from libgamma_native_method import libgamma_native_is_method_available
+    return not libgamma_native_is_method_available(method) == 0
+
+
+def method_capabilities(method : int) -> MethodCapabilities:
+    '''
+    Return the capabilities of an adjustment method.
+    
+    @param  this    The data structure to fill with the method's capabilities
+    @param  method  The adjustment method (display server and protocol).
+    '''
+    from libgamma_native_method import libgamma_native_method_capabilities
+    caps = libgamma_native_method_capabilities(method)
+    MethodCapabilities(*caps)
+
+
+def method_default_site(method : int) -> str:
+    '''
+    Return the capabilities of an adjustment method.
+    
+    @param   method  The adjustment method (display server and protocol.)
+    @return          The default site, `None` if it cannot be determined or
+                     if multiple sites are not supported by the adjustment
+                     method.
+    '''
+    from libgamma_native_method import libgamma_native_method_default_site
+    return libgamma_native_method_default_site(method)
+
+
+def method_default_site_variable(method : int) -> str:
+    '''
+    Return the capabilities of an adjustment method.
+    
+    @param   method  The adjustment method (display server and protocol.)
+    @return          The environ variables that is used to determine the
+                     default site. `None` if there is none, that is, if
+                     the method does not support multiple sites.
+    '''
+    from libgamma_native_method import libgamma_native_method_default_site_variable
+    return libgamma_native_method_default_site_variable(method)
+
+
+
+def behex_edid(edid : bytes) -> str:
+    '''
+    Convert a raw representation of an EDID to a lowercase hexadecimal representation.
+    
+    @param   edid  The EDID in raw representation.
+    @return        The EDID in lowercase hexadecimal representation.
+    '''
+    return behex_edid_lowercase(edid)
+
+
+def behex_edid_lowercase(edid : bytes) -> str:
+    '''
+    Convert a raw representation of an EDID to a lowercase hexadecimal representation.
+    
+    @param   edid  The EDID in raw representation.
+    @return        The EDID in lowercase hexadecimal representation.
+    '''
+    rc = ''
+    for b in edid:
+        rc += '0123456789abcdef'[(b >> 4) & 15]
+        rc += '0123456789abcdef'[(b >> 0) & 15]
+    return rc
+
+
+def behex_edid_uppercase(edid : bytes) -> str:
+    '''
+    Convert a raw representation of an EDID to an uppercase hexadecimal representation.
+    
+    @param   edid  The EDID in raw representation.
+    @return        The EDID in uppercase hexadecimal representation.
+    '''
+    rc = ''
+    for b in edid:
+        rc += '0123456789ABCDEF'[(b >> 4) & 15]
+        rc += '0123456789ABCDEF'[(b >> 0) & 15]
+    return rc
+
+
+def unhex_edid(edid : str) -> bytes:
+    '''
+    Convert an hexadecimal representation of an EDID to a raw representation.
+    
+    @param   edid  The EDID in hexadecimal representation.
+    @return        The EDID in raw representation.
+    '''
+    rc = []
+    edid = edid.lowercase()
+    for i in range(0, len(edid), 2):
+        a, b = edid[i + 0], edid[i + 1]
+        a = '0123456789abcdef'.find(a) << 4
+        b = '0123456789abcdef'.find(b) << 0
+        rc.append(a | b)
+    return bytes(rc)
+