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
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
|
/* mate-rr.h
*
* Copyright 2007, 2008, Red Hat, Inc.
*
* This file is part of the Mate Library.
*
* The Mate Library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public License as
* published by the Free Software Foundation; either version 2 of the
* License, or (at your option) any later version.
*
* The Mate 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
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public
* License along with the Mate Library; see the file COPYING.LIB. If not,
* write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor,
* Boston, MA 02110-1301, USA.
*
* Author: Soren Sandmann <sandmann@redhat.com>
*/
#ifndef MATE_RR_H
#define MATE_RR_H
#ifndef MATE_DESKTOP_USE_UNSTABLE_API
#error MateRR is unstable API. You must define MATE_DESKTOP_USE_UNSTABLE_API before including materr.h
#endif
#include <glib.h>
#include <gdk/gdk.h>
typedef struct MateRRScreenPrivate MateRRScreenPrivate;
typedef struct MateRROutput MateRROutput;
typedef struct MateRRCrtc MateRRCrtc;
typedef struct MateRRMode MateRRMode;
typedef struct {
GObject parent;
MateRRScreenPrivate* priv;
} MateRRScreen;
typedef struct {
GObjectClass parent_class;
void (* changed) (void);
} MateRRScreenClass;
typedef enum
{
MATE_RR_ROTATION_0 = (1 << 0),
MATE_RR_ROTATION_90 = (1 << 1),
MATE_RR_ROTATION_180 = (1 << 2),
MATE_RR_ROTATION_270 = (1 << 3),
MATE_RR_REFLECT_X = (1 << 4),
MATE_RR_REFLECT_Y = (1 << 5)
} MateRRRotation;
/* Error codes */
#define MATE_RR_ERROR (mate_rr_error_quark ())
GQuark mate_rr_error_quark (void);
typedef enum {
MATE_RR_ERROR_UNKNOWN, /* generic "fail" */
MATE_RR_ERROR_NO_RANDR_EXTENSION, /* RANDR extension is not present */
MATE_RR_ERROR_RANDR_ERROR, /* generic/undescribed error from the underlying XRR API */
MATE_RR_ERROR_BOUNDS_ERROR, /* requested bounds of a CRTC are outside the maximum size */
MATE_RR_ERROR_CRTC_ASSIGNMENT, /* could not assign CRTCs to outputs */
MATE_RR_ERROR_NO_MATCHING_CONFIG, /* none of the saved configurations matched the current configuration */
} MateRRError;
#define MATE_RR_CONNECTOR_TYPE_PANEL "Panel" /* This is a laptop's built-in LCD */
#define MATE_TYPE_RR_SCREEN (mate_rr_screen_get_type())
#define MATE_RR_SCREEN(obj) (G_TYPE_CHECK_INSTANCE_CAST ((obj), MATE_TYPE_RR_SCREEN, MateRRScreen))
#define MATE_IS_RR_SCREEN(obj) (G_TYPE_CHECK_INSTANCE_TYPE ((obj), MATE_TYPE_RR_SCREEN))
#define MATE_RR_SCREEN_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), MATE_TYPE_RR_SCREEN, MateRRScreenClass))
#define MATE_IS_RR_SCREEN_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), MATE_TYPE_RR_SCREEN))
#define MATE_RR_SCREEN_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), MATE_TYPE_RR_SCREEN, MateRRScreenClass))
#define MATE_TYPE_RR_OUTPUT (mate_rr_output_get_type())
#define MATE_TYPE_RR_CRTC (mate_rr_crtc_get_type())
#define MATE_TYPE_RR_MODE (mate_rr_mode_get_type())
GType mate_rr_screen_get_type (void);
GType mate_rr_output_get_type (void);
GType mate_rr_crtc_get_type (void);
GType mate_rr_mode_get_type (void);
/* MateRRScreen */
MateRRScreen * mate_rr_screen_new (GdkScreen *screen,
GError **error);
MateRROutput **mate_rr_screen_list_outputs (MateRRScreen *screen);
MateRRCrtc ** mate_rr_screen_list_crtcs (MateRRScreen *screen);
MateRRMode ** mate_rr_screen_list_modes (MateRRScreen *screen);
MateRRMode ** mate_rr_screen_list_clone_modes (MateRRScreen *screen);
void mate_rr_screen_set_size (MateRRScreen *screen,
int width,
int height,
int mm_width,
int mm_height);
MateRRCrtc * mate_rr_screen_get_crtc_by_id (MateRRScreen *screen,
guint32 id);
gboolean mate_rr_screen_refresh (MateRRScreen *screen,
GError **error);
MateRROutput * mate_rr_screen_get_output_by_id (MateRRScreen *screen,
guint32 id);
MateRROutput * mate_rr_screen_get_output_by_name (MateRRScreen *screen,
const char *name);
void mate_rr_screen_get_ranges (MateRRScreen *screen,
int *min_width,
int *max_width,
int *min_height,
int *max_height);
void mate_rr_screen_get_timestamps (MateRRScreen *screen,
guint32 *change_timestamp_ret,
guint32 *config_timestamp_ret);
void mate_rr_screen_set_primary_output (MateRRScreen *screen,
MateRROutput *output);
MateRRMode **mate_rr_screen_create_clone_modes (MateRRScreen *screen);
/* MateRROutput */
guint32 mate_rr_output_get_id (MateRROutput *output);
const char * mate_rr_output_get_name (MateRROutput *output);
gboolean mate_rr_output_is_connected (MateRROutput *output);
int mate_rr_output_get_size_inches (MateRROutput *output);
int mate_rr_output_get_width_mm (MateRROutput *outout);
int mate_rr_output_get_height_mm (MateRROutput *output);
const guint8 * mate_rr_output_get_edid_data (MateRROutput *output);
MateRRCrtc ** mate_rr_output_get_possible_crtcs (MateRROutput *output);
MateRRMode * mate_rr_output_get_current_mode (MateRROutput *output);
MateRRCrtc * mate_rr_output_get_crtc (MateRROutput *output);
const char * mate_rr_output_get_connector_type (MateRROutput *output);
gboolean mate_rr_output_is_laptop (MateRROutput *output);
void mate_rr_output_get_position (MateRROutput *output,
int *x,
int *y);
gboolean mate_rr_output_can_clone (MateRROutput *output,
MateRROutput *clone);
MateRRMode ** mate_rr_output_list_modes (MateRROutput *output);
MateRRMode * mate_rr_output_get_preferred_mode (MateRROutput *output);
gboolean mate_rr_output_supports_mode (MateRROutput *output,
MateRRMode *mode);
gboolean mate_rr_output_get_is_primary (MateRROutput *output);
/* MateRRMode */
guint32 mate_rr_mode_get_id (MateRRMode *mode);
guint mate_rr_mode_get_width (MateRRMode *mode);
guint mate_rr_mode_get_height (MateRRMode *mode);
int mate_rr_mode_get_freq (MateRRMode *mode);
/* MateRRCrtc */
guint32 mate_rr_crtc_get_id (MateRRCrtc *crtc);
#ifndef MATE_DISABLE_DEPRECATED
gboolean mate_rr_crtc_set_config (MateRRCrtc *crtc,
int x,
int y,
MateRRMode *mode,
MateRRRotation rotation,
MateRROutput **outputs,
int n_outputs,
GError **error);
#endif
gboolean mate_rr_crtc_set_config_with_time (MateRRCrtc *crtc,
guint32 timestamp,
int x,
int y,
MateRRMode *mode,
MateRRRotation rotation,
MateRROutput **outputs,
int n_outputs,
GError **error);
gboolean mate_rr_crtc_can_drive_output (MateRRCrtc *crtc,
MateRROutput *output);
MateRRMode * mate_rr_crtc_get_current_mode (MateRRCrtc *crtc);
void mate_rr_crtc_get_position (MateRRCrtc *crtc,
int *x,
int *y);
MateRRRotation mate_rr_crtc_get_current_rotation (MateRRCrtc *crtc);
MateRRRotation mate_rr_crtc_get_rotations (MateRRCrtc *crtc);
gboolean mate_rr_crtc_supports_rotation (MateRRCrtc *crtc,
MateRRRotation rotation);
gboolean mate_rr_crtc_get_gamma (MateRRCrtc *crtc,
int *size,
unsigned short **red,
unsigned short **green,
unsigned short **blue);
void mate_rr_crtc_set_gamma (MateRRCrtc *crtc,
int size,
unsigned short *red,
unsigned short *green,
unsigned short *blue);
#endif /* MATE_RR_H */
|
