blob: ac2ec2c127ff051b2da02f6eeedad3f8b3c0820f (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
# 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)
|
