127 lines
4.5 KiB
Python
127 lines
4.5 KiB
Python
# See LICENSE file for copyright and license details.
|
|
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_facade import libgamma_native_list_methods
|
|
return libgamma_native_list_methods(operation)
|
|
|
|
|
|
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_facade 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_facade import libgamma_native_method_capabilities
|
|
caps = libgamma_native_method_capabilities(method)
|
|
return MethodCapabilities(*caps)
|
|
|
|
|
|
def method_default_site(method : int) -> str:
|
|
'''
|
|
Return the default site for 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_facade import libgamma_native_method_default_site
|
|
return libgamma_native_method_default_site(method)
|
|
|
|
|
|
def method_default_site_variable(method : int) -> str:
|
|
'''
|
|
Return the default variable that determines
|
|
the default site for 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_facade 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.lower()
|
|
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)
|