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
177
178
179
180
181
182
183
184
185
|
/**
* libgamma -- Display server abstraction layer for gamma ramp adjustments
* Copyright (C) 2014, 2015 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 "methods.h"
/**
* Get the name representation of an
* adjustment method by its identifier.
*
* @param method The identifier of the adjustment method.
* @return The name of the adjustment method, should not be `free`:d.
*/
const char* method_name(int method)
{
switch (method)
{
case LIBGAMMA_METHOD_DUMMY: return "dummy";
case LIBGAMMA_METHOD_X_RANDR: return "RandR X extension";
case LIBGAMMA_METHOD_X_VIDMODE: return "VidMode X extension";
case LIBGAMMA_METHOD_LINUX_DRM: return "Linux DRM";
case LIBGAMMA_METHOD_W32_GDI: return "Windows GDI";
case LIBGAMMA_METHOD_QUARTZ_CORE_GRAPHICS: return "Quartz using CoreGraphics";
case LIBGAMMA_METHOD_WAYLAND: return "Wayland/Orbital";
default:
return "(unknown)";
}
}
/**
* Print a list of adjustment methods.
*
* @param description Precursory text for the list.
* @param methods An array allocated to fit all adjustment methods.
* @param operation See the `operation` parameter for `libgamma_list_methods`.
*/
void list_methods(const char* description, int* methods, int operation)
{
/* Get adjustment method list. */
size_t i, n = libgamma_list_methods(methods, LIBGAMMA_METHOD_COUNT, operation);
/* Print adjustment method list. */
printf("%s:\n", description);
for (i = 0; i < n; i++)
printf(" %s\n", method_name(methods[i]));
printf("\n");
}
/**
* Print all lists, of adjustments methods, that
* are made available by `libgamma_list_methods`.
*/
void list_methods_lists(void)
{
/* Allocate a list for adjustment methods that is
large enough if the program is up to date with
the library. */
int* methods = malloc(LIBGAMMA_METHOD_COUNT * sizeof(int));
/* Get a list of all adjustment methods. */
size_t n = libgamma_list_methods(methods, LIBGAMMA_METHOD_COUNT, 4);
/* If we got more adjustment methods than we expected
the program needs to be recompiled, and we need to
reallocate the list so it is large enough. */
if (n > LIBGAMMA_METHOD_COUNT)
{
printf("Warning: you should to recompile the program, libgamma has been updated.\n");
methods = realloc(methods, n * sizeof(int));
}
/* Print adjustment method lists. */
list_methods("Available adjustment methods", methods, 4);
list_methods("Available real adjustment methods", methods, 3);
list_methods("Available real non-fake adjustment methods", methods, 2);
list_methods("Recommended adjustment methods", methods, 1);
list_methods("Recommended non-fake adjustment methods", methods, 0);
free(methods);
}
/**
* Test the availability (determined
* at compile-time) of all adjustment
* methods and one that does not exist.
*/
void method_availability(void)
{
int method;
/* The availability of an adjustmen method
whose identifier is invalid. It should
say it is not available. */
printf("Testing the availability of a non-existing adjustment method: ");
printf("%s\n", libgamma_is_method_available(-1) ? "available" : "not available");
/* Test the availability of the adjustment
methods that does exist. */
for (method = 0; method < LIBGAMMA_METHOD_COUNT; method++)
{
printf("Testing the availability of %s: ", method_name(method));
printf("%s\n", libgamma_is_method_available(method) ? "available" : "not available");
}
printf("\n");
}
/**
* List the default site and the environment
* variable, if any, that determines the
* default site, for all availiable adjustment
* methods.
*/
void list_default_sites(void)
{
int method;
for (method = 0; method < LIBGAMMA_METHOD_COUNT; method++)
/* Include only available adjustment methods.
If an adjustment method is not available
it should print "(null)", but as that can
be misguiding we exclude those methods. */
if (libgamma_is_method_available(method))
{
printf("Default site for %s:\n", method_name(method));
printf(" Variable: %s\n", libgamma_method_default_site_variable(method));
printf(" Site name: %s\n", libgamma_method_default_site(method));
printf("\n");
}
}
/**
* Print the capabilities of all availiable
* adjustment methods.
*/
void method_capabilities(void)
{
libgamma_method_capabilities_t caps;
int method;
for (method = 0; method < LIBGAMMA_METHOD_COUNT; method++)
if (libgamma_is_method_available(method))
{
/* Print adjustment method name and get the
adjustment method's capabilities. */
printf("Capabilities of %s:\n", method_name(method));
libgamma_method_capabilities(&caps, method);
/* Print capabilities. The CRTC information
capabilities is printed hexadecimal. See
the `LIBGAMMA_CRTC_INFO_*` definitions in
`src/lib/libgamma-method.h` for what each
bit represents. */
printf(" %s: %X\n", "CRTC information", caps.crtc_information);
printf(" %s: %s\n", "Default site known", caps.default_site_known ? "yes" : "no");
printf(" %s: %s\n", "Multiple sites", caps.multiple_sites ? "yes" : "no");
printf(" %s: %s\n", "Multiple partitions", caps.multiple_partitions ? "yes" : "no");
printf(" %s: %s\n", "Multiple crtcs", caps.multiple_crtcs ? "yes" : "no");
printf(" %s: %s\n", "Graphics cards", caps.partitions_are_graphics_cards ? "yes" : "no");
printf(" %s: %s\n", "Site restore", caps.site_restore ? "yes" : "no");
printf(" %s: %s\n", "Partition restore", caps.partition_restore ? "yes" : "no");
printf(" %s: %s\n", "CRTC restore", caps.crtc_restore ? "yes" : "no");
printf(" %s: %s\n", "Identical gamma sizes", caps.identical_gamma_sizes ? "yes" : "no");
printf(" %s: %s\n", "Fixed gamma size", caps.fixed_gamma_size ? "yes" : "no");
printf(" %s: %s\n", "Fixed gamma depth", caps.fixed_gamma_depth ? "yes" : "no");
printf(" %s: %s\n", "Real method", caps.real ? "yes" : "no");
printf(" %s: %s\n", "Fake method", caps.fake ? "yes" : "no");
printf("\n");
}
}
|