aboutsummaryrefslogtreecommitdiffstats
path: root/src/test/methods.c
blob: 5cd8bd6c325bcbcf65bedbf88799ec4f4b403650 (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
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
/* See LICENSE file for copyright and license details. */
#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";
	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("  %s: %s\n", "Auto restore",          caps.auto_restore                  ? "yes" : "no");
			printf("\n");
		}
	}
}