Mir
mir_display_configuration.h
Go to the documentation of this file.
1 /*
2  * Copyright © 2016 Canonical Ltd.
3  *
4  * This program is free software: you can redistribute it and/or modify it
5  * under the terms of the GNU Lesser General Public License version 3,
6  * as published by the Free Software Foundation.
7  *
8  * This program is distributed in the hope that it will be useful,
9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11  * GNU Lesser General Public License for more details.
12  *
13  * You should have received a copy of the GNU Lesser General Public License
14  * along with this program. If not, see <http://www.gnu.org/licenses/>.
15  *
16  * Authored by: Christopher James Halse Rogers <christopher.halse.rogers@canonical.com>
17  */
18 
19 #ifndef MIR_TOOLKIT_MIR_DISPLAY_CONFIGURATION_H_
20 #define MIR_TOOLKIT_MIR_DISPLAY_CONFIGURATION_H_
21 
22 #include "client_types.h"
23 
24 #ifdef __cplusplus
25 extern "C" {
26 #endif
27 
41 
48 
62  MirDisplayConfig const* config)
63  __attribute__((deprecated("Not accurate in Mir 0.26 and later. May be removed in future.")));
64 
82 
94  size_t index);
95 
107  size_t index);
108 
118 int mir_output_get_num_modes(MirOutput const* output);
119 
134 MirOutputMode const* mir_output_get_mode(MirOutput const* output, size_t index);
135 
153 
167 size_t mir_output_get_preferred_mode_index(MirOutput const* output);
168 
183 
194 size_t mir_output_get_current_mode_index(MirOutput const* output);
195 
202 void mir_output_set_current_mode(MirOutput* output, MirOutputMode const* mode);
203 
211 
222  size_t index);
223 
232 
240 
251 int mir_output_get_id(MirOutput const* output);
252 
263 
271 __attribute__((deprecated("use mir_output_type_name instead")));
272 
279 char const* mir_output_type_name(MirOutputType type);
280 
295 int mir_output_get_position_x(MirOutput const* output);
296 
311 int mir_output_get_position_y(MirOutput const* output);
312 
329 void mir_output_set_position(MirOutput* output, int x, int y);
330 
353  MirOutput const* output);
354 
361 bool mir_output_is_enabled(MirOutput const* output);
362 
368 void mir_output_enable(MirOutput* output);
369 
375 void mir_output_disable(MirOutput* output);
376 
387 char const* mir_output_get_model(MirOutput const* output);
388 
403 
418 
429 
439 
447 
454 void mir_output_set_orientation(MirOutput* output, MirOrientation orientation);
455 
470 float mir_output_get_scale_factor(MirOutput const* output);
471 
480 
490 
496 bool mir_output_is_gamma_supported(MirOutput const* client_output);
497 
504 uint32_t mir_output_get_gamma_size(MirOutput const* client_output);
505 
516 void mir_output_get_gamma(MirOutput const* client_output,
517  uint16_t* red,
518  uint16_t* green,
519  uint16_t* blue,
520  uint32_t size);
521 
530 void mir_output_set_gamma(MirOutput* client_output,
531  uint16_t const* red,
532  uint16_t const* green,
533  uint16_t const* blue,
534  uint32_t size);
535 
545 void mir_output_set_scale_factor(MirOutput* output, float scale);
546 
561 uint8_t const* mir_output_get_edid(MirOutput const* output);
562 
573 size_t mir_output_get_edid_size(MirOutput const* output);
574 
584 
593 
600 
603 #ifdef __cplusplus
604 }
605 #endif
606 
607 #endif //MIR_TOOLKIT_MIR_DISPLAY_CONFIGURATION_H_
struct MirOutput MirOutput
Descriptor for an output connection.
Definition: client_types.h:65
int mir_output_get_position_y(MirOutput const *output)
Get the y coordinate of the top-left point of the output in the virtual display space.
int mir_output_get_num_modes(MirOutput const *output)
Get the number of modes in the supported mode list of this output.
void mir_output_get_gamma(MirOutput const *client_output, uint16_t *red, uint16_t *green, uint16_t *blue, uint32_t size)
Get the gamma ramp of a display.
struct MirDisplayConfig MirDisplayConfig
Definition: client_types.h:52
void mir_output_set_current_mode(MirOutput *output, MirOutputMode const *mode)
Set the current mode of an output.
size_t mir_output_get_preferred_mode_index(MirOutput const *output)
Get the index of the output&#39;s preferred mode.
MirOutputMode const * mir_output_get_mode(MirOutput const *output, size_t index)
Get a handle for a mode descriptor from the list of supported modes.
void mir_output_set_power_mode(MirOutput *output, MirPowerMode mode)
Set the power state of a connected display.
int mir_output_mode_get_width(MirOutputMode const *mode)
Get the width, in pixels, of a MirOutputMode.
int mir_display_config_get_num_outputs(MirDisplayConfig const *config)
Get the number of outputs available in this display configuration.
MirOutputConnectionState
Definition: client_types.h:325
int mir_output_get_physical_width_mm(MirOutput const *output)
Get the physical width of the connected display, in millimetres.
MirOutputMode const * mir_output_get_preferred_mode(MirOutput const *output)
Get a handle to the output&#39;s preferred mode.
MirOrientation mir_output_get_orientation(MirOutput const *output)
Get the orientation of a display.
MirFormFactor mir_output_get_form_factor(MirOutput const *output)
Get the form-factor of a connected output.
MirOutputConnectionState mir_output_get_connection_state(MirOutput const *output)
Get whether there is a display physically connected to the output.
MirPixelFormat mir_output_get_pixel_format(MirOutput const *output, size_t index)
Get a pixel format from the list of supported formats.
uint32_t mir_output_get_gamma_size(MirOutput const *client_output)
Gets the gamma size.
MirOrientation
Direction relative to the "natural" orientation of the display.
Definition: common.h:269
MirSubpixelArrangement
Physical arrangement of subpixels on the physical output.
Definition: common.h:419
MirOutputMode const * mir_output_get_current_mode(MirOutput const *output)
Get a handle to the output&#39;s current mode.
void mir_output_set_position(MirOutput *output, int x, int y)
Set the coordinates of the top-left point of the output in the virtual display space.
bool mir_output_is_gamma_supported(MirOutput const *client_output)
Gets if the platform supports gamma correction.
MirPowerMode mir_output_get_power_mode(MirOutput const *output)
Get the power state of a connected display.
bool mir_output_is_enabled(MirOutput const *output)
Get whether this output is enabled in the current configuration.
void mir_display_config_release(MirDisplayConfig *config)
Release resources associated with a MirDisplayConfig handle.
void mir_output_set_scale_factor(MirOutput *output, float scale)
Set the scale-factor of a display.
MirPowerMode
Definition: common.h:184
char const * mir_display_output_type_name(MirDisplayOutputType type) __attribute__((deprecated("use mir_output_type_name instead")))
Get the textual name of an output type.
MirOutputType mir_output_get_type(MirOutput const *output)
Get the physical connection type of an output.
int mir_output_get_position_x(MirOutput const *output)
Get the x coordinate of the top-left point of the output in the virtual display space.
MirFormFactor
Form factor associated with a physical output.
Definition: common.h:403
MirPixelFormat
32-bit pixel formats (8888): The order of components in the enum matches the order of the components ...
Definition: common.h:239
char const * mir_output_type_name(MirOutputType type)
Get the textual name of an output type.
void mir_output_set_gamma(MirOutput *client_output, uint16_t const *red, uint16_t const *green, uint16_t const *blue, uint32_t size)
Set the gamma ramp of a display.
struct MirOutputMode MirOutputMode
A descriptor for a display mode.
Definition: mir_display_configuration.h:40
double mir_output_mode_get_refresh_rate(MirOutputMode const *mode)
Get the refresh rate, in Hz, of a MirOutputMode.
MirOutput * mir_display_config_get_mutable_output(MirDisplayConfig *config, size_t index)
Get a modifyable handle to the index &#39;th output of this configuration.
MirPixelFormat mir_output_get_current_pixel_format(MirOutput const *output)
Get the current pixel format.
MirConnectedCallback mir_connected_callback __attribute__((deprecated("Use MirConnectedCallback instead")))
Release a platform message.
Definition: client_types.h:85
void mir_output_set_pixel_format(MirOutput *output, MirPixelFormat format)
Set the output format.
MirDisplayOutputType
Definition: client_types.h:303
int mir_output_get_num_pixel_formats(MirOutput const *output)
Get the number of pixel formats supported by this output.
char const * mir_output_get_model(MirOutput const *output)
Get a descriptive manufacturer/model string for the connected display.
int mir_output_get_physical_height_mm(MirOutput const *output)
Get the physical height of the connected display, in millimetres.
void mir_output_set_orientation(MirOutput *output, MirOrientation orientation)
Set the orientation of a display.
MirOutputType
Definition: common.h:192
uint8_t const * mir_output_get_edid(MirOutput const *output)
Get the raw EDID data of a display.
void mir_output_enable(MirOutput *output)
Enable this output.
int mir_output_get_id(MirOutput const *output)
Get the ID of an output.
size_t mir_output_get_edid_size(MirOutput const *output)
Get the size of the EDID of this display.
MirOutput const * mir_display_config_get_output(MirDisplayConfig const *config, size_t index)
Get a read-only handle to the index &#39;th output of this configuration.
void mir_output_disable(MirOutput *output)
Disable this output.
int mir_display_config_get_max_simultaneous_outputs(MirDisplayConfig const *config) __attribute__((deprecated("Not accurate in Mir 0.26 and later. May be removed in future.")))
Get the maximum possible number of simultaneously active outputs this system supports.
float mir_output_get_scale_factor(MirOutput const *output)
Get the scale-factor of a display.
size_t mir_output_get_current_mode_index(MirOutput const *output)
Get the index of to the output&#39;s current mode.
int mir_output_mode_get_height(MirOutputMode const *mode)
Get the height, in pixels, of a MirOutputMode.
MirSubpixelArrangement mir_output_get_subpixel_arrangement(MirOutput const *output)
Get the subpixel arrangement of a display.

Copyright © 2012-2016 Canonical Ltd.
Generated on Mon Mar 27 12:06:55 UTC 2017