src/compositor.h

   1 /*
   2  * Copyright © 2008-2011 Kristian Høgsberg
   3  * Copyright © 2012 Collabora, Ltd.
   4  *
   5  * Permission to use, copy, modify, distribute, and sell this software and
   6  * its documentation for any purpose is hereby granted without fee, provided
   7  * that the above copyright notice appear in all copies and that both that
   8  * copyright notice and this permission notice appear in supporting
   9  * documentation, and that the name of the copyright holders not be used in
  10  * advertising or publicity pertaining to distribution of the software
  11  * without specific, written prior permission.  The copyright holders make
  12  * no representations about the suitability of this software for any
  13  * purpose.  It is provided "as is" without express or implied warranty.
  14  *
  15  * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS
  16  * SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
  17  * FITNESS, IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY
  18  * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER
  19  * RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF
  20  * CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  21  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  22  */
  23
  24 #ifndef _WAYLAND_SYSTEM_COMPOSITOR_H_
  25 #define _WAYLAND_SYSTEM_COMPOSITOR_H_
  26
  27 #include <pixman.h>
  28 #include <xkbcommon/xkbcommon.h>
  29 #include <wayland-server.h>
  30
  31 #include <GLES2/gl2.h>
  32 #include <GLES2/gl2ext.h>
  33 #include <EGL/egl.h>
  34 #include <EGL/eglext.h>
  35
  36 #include "matrix.h"
  37 #include "../shared/config-parser.h"
  38 #include "weston-egl-ext.h"
  39
  40
  41 struct weston_transform {
  42         struct weston_matrix matrix;
  43         struct wl_list link;
  44 };
  45
  46 struct weston_surface;
  47 struct shell_surface;
  48 struct weston_seat;
  49 struct weston_output;
  50 struct input_method;
  51
  52 enum weston_keyboard_modifier {
  53         MODIFIER_CTRL = (1 << 0),
  54         MODIFIER_ALT = (1 << 1),
  55         MODIFIER_SUPER = (1 << 2),
  56         MODIFIER_SHIFT = (1 << 3),
  57 };
  58
  59 enum weston_led {
  60         LED_NUM_LOCK = (1 << 0),
  61         LED_CAPS_LOCK = (1 << 1),
  62         LED_SCROLL_LOCK = (1 << 2),
  63 };
  64
  65 struct weston_mode {
  66         uint32_t flags;
  67         int32_t width, height;
  68         uint32_t refresh;
  69         struct wl_list link;
  70 };
  71
  72 struct weston_shell_client {
  73         void (*send_configure)(struct weston_surface *surface,
  74                                uint32_t edges, int32_t width, int32_t height);
  75 };
  76
  77 struct weston_shell_interface {
  78         void *shell;                    /* either desktop or tablet */
  79
  80         struct shell_surface *(*create_shell_surface)(void *shell,
  81                                                       struct weston_surface *surface,
  82                                                       const struct weston_shell_client *client);
  83
  84         void (*set_toplevel)(struct shell_surface *shsurf);
  85
  86         void (*set_transient)(struct shell_surface *shsurf,
  87                               struct weston_surface *parent,
  88                               int x, int y, uint32_t flags);
  89         int (*move)(struct shell_surface *shsurf, struct weston_seat *ws);
  90         int (*resize)(struct shell_surface *shsurf,
  91                       struct weston_seat *ws, uint32_t edges);
  92
  93 };
  94
  95 struct weston_border {
  96         int32_t left, right, top, bottom;
  97 };
  98
  99 struct weston_animation {
 100         void (*frame)(struct weston_animation *animation,
 101                       struct weston_output *output, uint32_t msecs);
 102         int frame_counter;
 103         struct wl_list link;
 104 };
 105
 106 struct weston_spring {
 107         double k;
 108         double friction;
 109         double current;
 110         double target;
 111         double previous;
 112         uint32_t timestamp;
 113 };
 114
 115 enum {
 116         ZOOM_FOCUS_POINTER,
 117         ZOOM_FOCUS_TEXT
 118 };
 119
 120 struct weston_fixed_point {
 121         wl_fixed_t x, y;
 122 };
 123
 124 struct weston_output_zoom {
 125         int active;
 126         uint32_t type;
 127         float increment;
 128         float level;
 129         float max_level;
 130         float trans_x, trans_y;
 131         struct weston_animation animation_z;
 132         struct weston_spring spring_z;
 133         struct weston_animation animation_xy;
 134         struct weston_spring spring_xy;
 135         struct weston_fixed_point from;
 136         struct weston_fixed_point to;
 137         struct weston_fixed_point current;
 138         struct weston_fixed_point text_cursor;
 139 };
 140
 141 /* bit compatible with drm definitions. */
 142 enum dpms_enum {
 143         WESTON_DPMS_ON,
 144         WESTON_DPMS_STANDBY,
 145         WESTON_DPMS_SUSPEND,
 146         WESTON_DPMS_OFF
 147 };
 148
 149 struct weston_output {
 150         uint32_t id;
 151
 152         EGLSurface egl_surface;
 153         struct wl_list link;
 154         struct wl_list resource_list;
 155         struct wl_global *global;
 156         struct weston_compositor *compositor;
 157         struct weston_matrix matrix;
 158         struct wl_list animation_list;
 159         int32_t x, y, width, height;
 160         int32_t mm_width, mm_height;
 161         struct weston_border border;
 162         pixman_region32_t region;
 163         int current_buffer;
 164         pixman_region32_t buffer_damage[2];
 165         int repaint_needed;
 166         int repaint_scheduled;
 167         struct weston_output_zoom zoom;
 168         int dirty;
 169         struct wl_signal frame_signal;
 170         uint32_t frame_time;
 171         int disable_planes;
 172
 173         char *make, *model;
 174         uint32_t subpixel;
 175         uint32_t transform;
 176
 177         struct weston_mode *current;
 178         struct weston_mode *origin;
 179         struct wl_list mode_list;
 180
 181         void (*repaint)(struct weston_output *output,
 182                         pixman_region32_t *damage);
 183         void (*destroy)(struct weston_output *output);
 184         void (*assign_planes)(struct weston_output *output);
 185         int (*switch_mode)(struct weston_output *output, struct weston_mode *mode);
 186
 187         /* backlight values are on 0-255 range, where higher is brighter */
 188         uint32_t backlight_current;
 189         void (*set_backlight)(struct weston_output *output, uint32_t value);
 190         void (*set_dpms)(struct weston_output *output, enum dpms_enum level);
 191 };
 192
 193 struct weston_xkb_info {
 194         struct xkb_keymap *keymap;
 195         int keymap_fd;
 196         size_t keymap_size;
 197         char *keymap_area;
 198         xkb_mod_index_t shift_mod;
 199         xkb_mod_index_t caps_mod;
 200         xkb_mod_index_t ctrl_mod;
 201         xkb_mod_index_t alt_mod;
 202         xkb_mod_index_t mod2_mod;
 203         xkb_mod_index_t mod3_mod;
 204         xkb_mod_index_t super_mod;
 205         xkb_mod_index_t mod5_mod;
 206         xkb_led_index_t num_led;
 207         xkb_led_index_t caps_led;
 208         xkb_led_index_t scroll_led;
 209 };
 210
 211 struct weston_seat {
 212         struct wl_seat seat;
 213         struct wl_pointer pointer;
 214         int has_pointer;
 215         struct wl_keyboard keyboard;
 216         int has_keyboard;
 217         struct wl_touch touch;
 218         int has_touch;
 219
 220         struct weston_compositor *compositor;
 221         struct weston_surface *sprite;
 222         struct wl_listener sprite_destroy_listener;
 223         struct weston_surface *drag_surface;
 224         struct wl_listener drag_surface_destroy_listener;
 225         int32_t hotspot_x, hotspot_y;
 226         struct wl_list link;
 227         enum weston_keyboard_modifier modifier_state;
 228         struct wl_surface *saved_kbd_focus;
 229         struct wl_listener saved_kbd_focus_listener;
 230
 231         uint32_t num_tp;
 232
 233         struct wl_listener new_drag_icon_listener;
 234
 235         void (*led_update)(struct weston_seat *ws, enum weston_led leds);
 236
 237         struct weston_xkb_info xkb_info;
 238         struct {
 239                 struct xkb_state *state;
 240                 enum weston_led leds;
 241         } xkb_state;
 242
 243         struct input_method *input_method;
 244 };
 245
 246 struct weston_shader {
 247         GLuint program;
 248         GLuint vertex_shader, fragment_shader;
 249         GLint proj_uniform;
 250         GLint tex_uniforms[3];
 251         GLint alpha_uniform;
 252         GLint color_uniform;
 253 };
 254
 255 enum {
 256         WESTON_COMPOSITOR_ACTIVE,
 257         WESTON_COMPOSITOR_IDLE,         /* shell->unlock called on activity */
 258         WESTON_COMPOSITOR_SLEEPING      /* no rendering, no frame events */
 259 };
 260
 261 struct weston_layer {
 262         struct wl_list surface_list;
 263         struct wl_list link;
 264 };
 265
 266 struct weston_plane {
 267         pixman_region32_t damage;
 268         int32_t x, y;
 269 };
 270
 271 struct weston_renderer {
 272         void (*repaint_output)(struct weston_output *output,
 273                                pixman_region32_t *output_damage);
 274         void (*flush_damage)(struct weston_surface *surface);
 275         void (*attach)(struct weston_surface *es, struct wl_buffer *buffer);
 276         void (*destroy_surface)(struct weston_surface *surface);
 277 };
 278
 279 struct weston_compositor {
 280         struct wl_signal destroy_signal;
 281
 282         EGLDisplay egl_display;
 283         EGLContext egl_context;
 284         EGLConfig egl_config;
 285         struct weston_shader texture_shader_rgba;
 286         struct weston_shader texture_shader_rgbx;
 287         struct weston_shader texture_shader_egl_external;
 288         struct weston_shader texture_shader_y_uv;
 289         struct weston_shader texture_shader_y_u_v;
 290         struct weston_shader texture_shader_y_xuxv;
 291         struct weston_shader solid_shader;
 292         struct weston_shader *current_shader;
 293         struct wl_display *wl_display;
 294         struct weston_shell_interface shell_interface;
 295
 296         struct wl_signal activate_signal;
 297         struct wl_signal kill_signal;
 298         struct wl_signal lock_signal;
 299         struct wl_signal unlock_signal;
 300
 301         struct wl_signal show_input_panel_signal;
 302         struct wl_signal hide_input_panel_signal;
 303
 304         struct wl_event_loop *input_loop;
 305         struct wl_event_source *input_loop_source;
 306
 307         struct weston_layer fade_layer;
 308         struct weston_layer cursor_layer;
 309
 310         struct wl_list output_list;
 311         struct wl_list seat_list;
 312         struct wl_list layer_list;
 313         struct wl_list surface_list;
 314         struct wl_list key_binding_list;
 315         struct wl_list button_binding_list;
 316         struct wl_list axis_binding_list;
 317         struct {
 318                 struct weston_spring spring;
 319                 struct weston_animation animation;
 320                 struct weston_surface *surface;
 321         } fade;
 322
 323         uint32_t state;
 324         struct wl_event_source *idle_source;
 325         uint32_t idle_inhibit;
 326         int option_idle_time;           /* default timeout, s */
 327         int idle_time;                  /* effective timeout, s */
 328
 329         /* Repaint state. */
 330         struct wl_array vertices;
 331         struct wl_array indices; /* only used in compositor-wayland */
 332         struct wl_array vtxcnt;
 333         struct weston_plane primary_plane;
 334         int fan_debug;
 335
 336         uint32_t focus;
 337
 338         struct weston_renderer *renderer;
 339
 340         PFNGLEGLIMAGETARGETRENDERBUFFERSTORAGEOESPROC
 341                 image_target_renderbuffer_storage;
 342         PFNGLEGLIMAGETARGETTEXTURE2DOESPROC image_target_texture_2d;
 343         PFNEGLCREATEIMAGEKHRPROC create_image;
 344         PFNEGLDESTROYIMAGEKHRPROC destroy_image;
 345
 346         int has_unpack_subimage;
 347         GLenum read_format;
 348
 349         PFNEGLBINDWAYLANDDISPLAYWL bind_display;
 350         PFNEGLUNBINDWAYLANDDISPLAYWL unbind_display;
 351         PFNEGLQUERYWAYLANDBUFFERWL query_buffer;
 352         int has_bind_display;
 353
 354         void (*destroy)(struct weston_compositor *ec);
 355         void (*restore)(struct weston_compositor *ec);
 356         int (*authenticate)(struct weston_compositor *c, uint32_t id);
 357
 358         void (*ping_handler)(struct weston_surface *surface, uint32_t serial);
 359
 360         int launcher_sock;
 361
 362         uint32_t output_id_pool;
 363
 364         struct xkb_rule_names xkb_names;
 365         struct xkb_context *xkb_context;
 366         struct weston_xkb_info xkb_info;
 367 };
 368
 369 struct weston_region {
 370         struct wl_resource resource;
 371         pixman_region32_t region;
 372 };
 373
 374 /* Using weston_surface transformations
 375  *
 376  * To add a transformation to a surface, create a struct weston_transform, and
 377  * add it to the list surface->geometry.transformation_list. Whenever you
 378  * change the list, anything under surface->geometry, or anything in the
 379  * weston_transforms linked into the list, you must set
 380  * surface->geometry.dirty = 1.
 381  *
 382  * The order in the list defines the order of transformations. Let the list
 383  * contain the transformation matrices M1, ..., Mn as head to tail. The
 384  * transformation is applied to surface-local coordinate vector p as
 385  *    P = Mn * ... * M2 * M1 * p
 386  * to produce the global coordinate vector P. The total transform
 387  *    Mn * ... * M2 * M1
 388  * is cached in surface->transform.matrix, and the inverse of it in
 389  * surface->transform.inverse.
 390  *
 391  * The list always contains surface->transform.position transformation, which
 392  * is the translation by surface->geometry.x and y.
 393  *
 394  * If you want to apply a transformation in local coordinates, add your
 395  * weston_transform to the head of the list. If you want to apply a
 396  * transformation in global coordinates, add it to the tail of the list.
 397  */
 398
 399 struct weston_surface {
 400         struct wl_surface surface;
 401         struct weston_compositor *compositor;
 402         GLuint textures[3];
 403         int num_textures;
 404         pixman_region32_t clip;
 405         pixman_region32_t damage;
 406         pixman_region32_t opaque;
 407         pixman_region32_t input;
 408         int32_t pitch;
 409         struct wl_list link;
 410         struct wl_list layer_link;
 411         struct weston_shader *shader;
 412         GLfloat color[4];
 413         float alpha;
 414         struct weston_plane *plane;
 415
 416         /* Surface geometry state, mutable.
 417          * If you change anything, set dirty = 1.
 418          * That includes the transformations referenced from the list.
 419          */
 420         struct {
 421                 float x, y; /* surface translation on display */
 422                 int32_t width, height;
 423
 424                 /* struct weston_transform */
 425                 struct wl_list transformation_list;
 426
 427                 int dirty;
 428         } geometry;
 429
 430         /* State derived from geometry state, read-only.
 431          * This is updated by weston_surface_update_transform().
 432          */
 433         struct {
 434                 pixman_region32_t boundingbox;
 435                 pixman_region32_t opaque;
 436
 437                 /* matrix and inverse are used only if enabled = 1.
 438                  * If enabled = 0, use x, y, width, height directly.
 439                  */
 440                 int enabled;
 441                 struct weston_matrix matrix;
 442                 struct weston_matrix inverse;
 443
 444                 struct weston_transform position; /* matrix from x, y */
 445         } transform;
 446
 447         /*
 448          * Which output to vsync this surface to.
 449          * Used to determine, whether to send or queue frame events.
 450          * Must be NULL, if 'link' is not in weston_compositor::surface_list.
 451          */
 452         struct weston_output *output;
 453
 454         /*
 455          * A more complete representation of all outputs this surface is
 456          * displayed on.
 457          */
 458         uint32_t output_mask;
 459
 460         struct wl_list frame_callback_list;
 461
 462         EGLImageKHR images[3];
 463         GLenum target;
 464         int num_images;
 465
 466         struct wl_buffer *buffer;
 467         struct wl_listener buffer_destroy_listener;
 468
 469         /* All the pending state, that wl_surface.commit will apply. */
 470         struct {
 471                 /* wl_surface.attach */
 472                 int remove_contents;
 473                 struct wl_buffer *buffer;
 474                 struct wl_listener buffer_destroy_listener;
 475                 int32_t sx;
 476                 int32_t sy;
 477
 478                 /* wl_surface.damage */
 479                 pixman_region32_t damage;
 480
 481                 /* wl_surface.set_opaque_region */
 482                 pixman_region32_t opaque;
 483
 484                 /* wl_surface.set_input_region */
 485                 pixman_region32_t input;
 486
 487                 /* wl_surface.frame */
 488                 struct wl_list frame_callback_list;
 489         } pending;
 490
 491         /*
 492          * If non-NULL, this function will be called on surface::attach after
 493          * a new buffer has been set up for this surface. The integer params
 494          * are the sx and sy paramerters supplied to surface::attach .
 495          */
 496         void (*configure)(struct weston_surface *es, int32_t sx, int32_t sy);
 497         void *private;
 498 };
 499
 500 enum weston_key_state_update {
 501         STATE_UPDATE_AUTOMATIC,
 502         STATE_UPDATE_NONE,
 503 };
 504
 505 void
 506 weston_surface_update_transform(struct weston_surface *surface);
 507
 508 void
 509 weston_surface_to_global_fixed(struct weston_surface *surface,
 510                                wl_fixed_t sx, wl_fixed_t sy,
 511                                wl_fixed_t *x, wl_fixed_t *y);
 512 void
 513 weston_surface_to_global_float(struct weston_surface *surface,
 514                                float sx, float sy, float *x, float *y);
 515
 516 void
 517 weston_surface_from_global_float(struct weston_surface *surface,
 518                                  float x, float y, float *sx, float *sy);
 519 void
 520 weston_surface_from_global(struct weston_surface *surface,
 521                            int32_t x, int32_t y, int32_t *sx, int32_t *sy);
 522 void
 523 weston_surface_from_global_fixed(struct weston_surface *surface,
 524                                  wl_fixed_t x, wl_fixed_t y,
 525                                  wl_fixed_t *sx, wl_fixed_t *sy);
 526
 527 void
 528 weston_spring_init(struct weston_spring *spring,
 529                    double k, double current, double target);
 530 void
 531 weston_spring_update(struct weston_spring *spring, uint32_t msec);
 532 int
 533 weston_spring_done(struct weston_spring *spring);
 534
 535 void
 536 weston_surface_activate(struct weston_surface *surface,
 537                         struct weston_seat *seat);
 538 void
 539 notify_motion(struct weston_seat *seat, uint32_t time,
 540               wl_fixed_t x, wl_fixed_t y);
 541 void
 542 notify_button(struct weston_seat *seat, uint32_t time, int32_t button,
 543               enum wl_pointer_button_state state);
 544 void
 545 notify_axis(struct weston_seat *seat, uint32_t time, uint32_t axis,
 546             wl_fixed_t value);
 547 void
 548 notify_key(struct weston_seat *seat, uint32_t time, uint32_t key,
 549            enum wl_keyboard_key_state state,
 550            enum weston_key_state_update update_state);
 551 void
 552 notify_modifiers(struct weston_seat *seat, uint32_t serial);
 553
 554 void
 555 notify_pointer_focus(struct weston_seat *seat, struct weston_output *output,
 556                      wl_fixed_t x, wl_fixed_t y);
 557
 558 void
 559 notify_keyboard_focus_in(struct weston_seat *seat, struct wl_array *keys,
 560                          enum weston_key_state_update update_state);
 561 void
 562 notify_keyboard_focus_out(struct weston_seat *seat);
 563
 564 void
 565 notify_touch(struct weston_seat *seat, uint32_t time, int touch_id,
 566              wl_fixed_t x, wl_fixed_t y, int touch_type);
 567
 568 void
 569 weston_layer_init(struct weston_layer *layer, struct wl_list *below);
 570
 571 void
 572 weston_plane_init(struct weston_plane *plane, int32_t x, int32_t y);
 573 void
 574 weston_plane_release(struct weston_plane *plane);
 575
 576 void
 577 weston_output_finish_frame(struct weston_output *output, uint32_t msecs);
 578 void
 579 weston_output_schedule_repaint(struct weston_output *output);
 580 void
 581 weston_output_damage(struct weston_output *output);
 582 void
 583 weston_compositor_schedule_repaint(struct weston_compositor *compositor);
 584 void
 585 weston_compositor_fade(struct weston_compositor *compositor, float tint);
 586 void
 587 weston_compositor_damage_all(struct weston_compositor *compositor);
 588 void
 589 weston_compositor_unlock(struct weston_compositor *compositor);
 590 void
 591 weston_compositor_wake(struct weston_compositor *compositor);
 592 void
 593 weston_compositor_activity(struct weston_compositor *compositor);
 594 void
 595 weston_compositor_update_drag_surfaces(struct weston_compositor *compositor);
 596
 597
 598 struct weston_binding;
 599 typedef void (*weston_key_binding_handler_t)(struct wl_seat *seat,
 600                                              uint32_t time, uint32_t key,
 601                                              void *data);
 602 struct weston_binding *
 603 weston_compositor_add_key_binding(struct weston_compositor *compositor,
 604                                   uint32_t key,
 605                                   enum weston_keyboard_modifier modifier,
 606                                   weston_key_binding_handler_t binding,
 607                                   void *data);
 608
 609 typedef void (*weston_button_binding_handler_t)(struct wl_seat *seat,
 610                                                 uint32_t time, uint32_t button,
 611                                                 void *data);
 612 struct weston_binding *
 613 weston_compositor_add_button_binding(struct weston_compositor *compositor,
 614                                      uint32_t button,
 615                                      enum weston_keyboard_modifier modifier,
 616                                      weston_button_binding_handler_t binding,
 617                                      void *data);
 618
 619 typedef void (*weston_axis_binding_handler_t)(struct wl_seat *seat,
 620                                               uint32_t time, uint32_t axis,
 621                                               wl_fixed_t value, void *data);
 622 struct weston_binding *
 623 weston_compositor_add_axis_binding(struct weston_compositor *compositor,
 624                                    uint32_t axis,
 625                                    enum weston_keyboard_modifier modifier,
 626                                    weston_axis_binding_handler_t binding,
 627                                    void *data);
 628 void
 629 weston_binding_destroy(struct weston_binding *binding);
 630
 631 void
 632 weston_binding_list_destroy_all(struct wl_list *list);
 633
 634 void
 635 weston_compositor_run_key_binding(struct weston_compositor *compositor,
 636                                   struct weston_seat *seat, uint32_t time,
 637                                   uint32_t key,
 638                                   enum wl_keyboard_key_state state);
 639 void
 640 weston_compositor_run_button_binding(struct weston_compositor *compositor,
 641                                      struct weston_seat *seat, uint32_t time,
 642                                      uint32_t button,
 643                                      enum wl_pointer_button_state value);
 644 void
 645 weston_compositor_run_axis_binding(struct weston_compositor *compositor,
 646                                    struct weston_seat *seat, uint32_t time,
 647                                    uint32_t axis, int32_t value);
 648
 649 int
 650 weston_environment_get_fd(const char *env);
 651
 652 struct wl_list *
 653 weston_compositor_top(struct weston_compositor *compositor);
 654
 655 struct weston_surface *
 656 weston_surface_create(struct weston_compositor *compositor);
 657
 658 void
 659 weston_surface_configure(struct weston_surface *surface,
 660                          float x, float y, int width, int height);
 661
 662 void
 663 weston_surface_restack(struct weston_surface *surface, struct wl_list *below);
 664
 665 void
 666 weston_surface_set_position(struct weston_surface *surface,
 667                             float x, float y);
 668
 669 int
 670 weston_surface_is_mapped(struct weston_surface *surface);
 671
 672 void
 673 weston_surface_schedule_repaint(struct weston_surface *surface);
 674
 675 void
 676 weston_surface_damage(struct weston_surface *surface);
 677
 678 void
 679 weston_surface_damage_below(struct weston_surface *surface);
 680
 681 void
 682 weston_surface_move_to_plane(struct weston_surface *surface,
 683                              struct weston_plane *plane);
 684 void
 685 weston_surface_unmap(struct weston_surface *surface);
 686
 687 void
 688 weston_buffer_post_release(struct wl_buffer *buffer);
 689
 690 uint32_t
 691 weston_compositor_get_time(void);
 692
 693 int
 694 weston_compositor_init(struct weston_compositor *ec, struct wl_display *display,
 695                        int argc, char *argv[], const char *config_file);
 696 void
 697 weston_compositor_shutdown(struct weston_compositor *ec);
 698 void
 699 weston_text_cursor_position_notify(struct weston_surface *surface,
 700                                                 wl_fixed_t x, wl_fixed_t y);
 701 void
 702 weston_output_init_zoom(struct weston_output *output);
 703 void
 704 weston_output_update_zoom(struct weston_output *output, uint32_t type);
 705 void
 706 weston_output_update_matrix(struct weston_output *output);
 707 void
 708 weston_output_move(struct weston_output *output, int x, int y);
 709 void
 710 weston_output_init(struct weston_output *output, struct weston_compositor *c,
 711                    int x, int y, int width, int height, uint32_t transform);
 712 void
 713 weston_output_destroy(struct weston_output *output);
 714
 715 void
 716 weston_seat_init(struct weston_seat *seat, struct weston_compositor *ec);
 717 void
 718 weston_seat_init_pointer(struct weston_seat *seat);
 719 void
 720 weston_seat_init_keyboard(struct weston_seat *seat, struct xkb_keymap *keymap);
 721 void
 722 weston_seat_init_touch(struct weston_seat *seat);
 723
 724 void
 725 weston_seat_release(struct weston_seat *seat);
 726
 727 /* String literal of spaces, the same width as the timestamp. */
 728 #define STAMP_SPACE "               "
 729
 730 void
 731 weston_log_file_open(const char *filename);
 732 void
 733 weston_log_file_close(void);
 734 int
 735 weston_log(const char *fmt, ...)
 736         __attribute__ ((format (printf, 1, 2)));
 737 int
 738 weston_log_continue(const char *fmt, ...)
 739         __attribute__ ((format (printf, 1, 2)));
 740
 741 enum {
 742         TTY_ENTER_VT,
 743         TTY_LEAVE_VT
 744 };
 745
 746 typedef void (*tty_vt_func_t)(struct weston_compositor *compositor, int event);
 747
 748 struct tty *
 749 tty_create(struct weston_compositor *compositor,
 750            tty_vt_func_t vt_func, int tty_nr);
 751
 752 void
 753 tty_destroy(struct tty *tty);
 754
 755 void
 756 tty_reset(struct tty *tty);
 757
 758 int
 759 tty_activate_vt(struct tty *tty, int vt);
 760
 761 void
 762 screenshooter_create(struct weston_compositor *ec);
 763
 764 struct clipboard *
 765 clipboard_create(struct weston_seat *seat);
 766
 767 void
 768 text_cursor_position_notifier_create(struct weston_compositor *ec);
 769
 770 void
 771 text_model_factory_create(struct weston_compositor *ec);
 772
 773 void
 774 input_method_create(struct weston_compositor *ec,
 775                     struct weston_seat *seat);
 776
 777 struct weston_process;
 778 typedef void (*weston_process_cleanup_func_t)(struct weston_process *process,
 779                                             int status);
 780
 781 struct weston_process {
 782         pid_t pid;
 783         weston_process_cleanup_func_t cleanup;
 784         struct wl_list link;
 785 };
 786
 787 struct wl_client *
 788 weston_client_launch(struct weston_compositor *compositor,
 789                      struct weston_process *proc,
 790                      const char *path,
 791                      weston_process_cleanup_func_t cleanup);
 792
 793 void
 794 weston_watch_process(struct weston_process *process);
 795
 796 struct weston_surface_animation;
 797 typedef void (*weston_surface_animation_done_func_t)(struct weston_surface_animation *animation, void *data);
 798
 799 struct weston_surface_animation *
 800 weston_zoom_run(struct weston_surface *surface, float start, float stop,
 801                 weston_surface_animation_done_func_t done, void *data);
 802
 803 struct weston_surface_animation *
 804 weston_fade_run(struct weston_surface *surface,
 805                 weston_surface_animation_done_func_t done, void *data);
 806 struct weston_surface_animation *
 807 weston_slide_run(struct weston_surface *surface, float start, float stop,
 808                  weston_surface_animation_done_func_t done, void *data);
 809
 810 void
 811 weston_surface_set_color(struct weston_surface *surface,
 812                          float red, float green, float blue, float alpha);
 813
 814 void
 815 weston_surface_destroy(struct weston_surface *surface);
 816
 817 int
 818 weston_output_switch_mode(struct weston_output *output, struct weston_mode *mode);
 819
 820 int
 821 gles2_renderer_init(struct weston_compositor *ec);
 822 void
 823 gles2_renderer_destroy(struct weston_compositor *ec);
 824
 825 struct weston_compositor *
 826 backend_init(struct wl_display *display, int argc, char *argv[],
 827             const char *config_file);
 828
 829 int
 830 module_init(struct weston_compositor *compositor);
 831
 832 #endif