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
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
|
/**
* 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/>.
*/
#include "libgamma-facade.hh"
#include <cstdlib>
namespace libgamma
{
/**
* 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 Array of methods.
*/
std::vector<int> list_methods(int operation)
{
int* methods = (int*)malloc(LIBGAMMA_METHOD_COUNT * sizeof(int));
size_t n, i;
std::vector<int> rc;
n = libgamma_list_methods(methods, LIBGAMMA_METHOD_COUNT, operation);
if (n > LIBGAMMA_METHOD_COUNT)
{
free(methods);
methods = (int*)malloc(n * sizeof(int));
libgamma_list_methods(methods, n, operation);
}
for (i = 0; i < n; i++)
rc.push_back(methods[i]);
free(methods);
return rc;
}
/**
* 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.
*/
int is_method_available(int method)
{
return libgamma_is_method_available(method);
}
/**
* Return the capabilities of an adjustment method.
*
* @param output The data structure to fill with the method's capabilities,
* @param method The adjustment method (display server and protocol).
*/
void method_capabilities(MethodCapabilities* output, int method)
{
libgamma_method_capabilities_t caps;
libgamma_method_capabilities(&caps, method);
*output = MethodCapabilities(&caps);
}
/**
* Return the default site for an adjustment method.
*
* @param method The adjustment method (display server and protocol.)
* @return The default site, `nullptr` if it cannot be determined or if
* multiple sites are not supported by the adjustment method.
*/
std::string* method_default_site(int method)
{
char* cstr = libgamma_method_default_site(method);
if (cstr == nullptr)
return nullptr;
return new std::string(cstr);
}
/**
* 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. `nullptr` if there is none, that is, if
* the method does not support multiple sites.
* This value should not be `free`:d.
*/
std::string* method_default_site_variable(int method)
{
const char* cstr = libgamma_method_default_site_variable(method);
if (cstr == nullptr)
return nullptr;
return new std::string(cstr);
}
/**
* Convert a raw representation of an EDID to a lowercase hexadecimal representation.
*
* @param edid The EDID in raw representation.
* @param length The length of `edid`.
* @return The EDID in lowercase hexadecimal representation.
*/
std::string behex_edid(const unsigned char* edid, size_t length)
{
return behex_edid_lowercase(edid, length);
}
/**
* Convert a raw representation of an EDID to a lowercase hexadecimal representation.
*
* @param edid The EDID in raw representation.
* @param length The length of `edid`.
* @return The EDID in lowercase hexadecimal representation.
*/
std::string behex_edid_lowercase(const unsigned char* edid, size_t length)
{
char* cstr = libgamma_behex_edid_lowercase(edid, length);
std::string rc = std::string(cstr);
free(cstr);
return rc;
}
/**
* Convert a raw representation of an EDID to an uppercase hexadecimal representation.
*
* @param edid The EDID in raw representation.
* @param length The length of `edid`.
* @return The EDID in uppercase hexadecimal representation.
*/
std::string behex_edid_uppercase(const unsigned char* edid, size_t length)
{
char* cstr = libgamma_behex_edid_uppercase(edid, length);
std::string rc = std::string(cstr);
free(cstr);
return rc;
}
/**
* Convert an hexadecimal representation of an EDID to a raw representation.
*
* @param edid The EDID in hexadecimal representation.
* @return The EDID in raw representation, it will be half the length
* of `edid` (the input value).
*/
unsigned char* unhex_edid(const std::string edid)
{
const char* cstr = edid.c_str();
return libgamma_unhex_edid(cstr);
}
}
|
