jpayne@69: /* jpayne@69: * This file generated automatically from dbe.xml by c_client.py. jpayne@69: * Edit at your peril. jpayne@69: */ jpayne@69: jpayne@69: /** jpayne@69: * @defgroup XCB_Dbe_API XCB Dbe API jpayne@69: * @brief Dbe XCB Protocol Implementation. jpayne@69: * @{ jpayne@69: **/ jpayne@69: jpayne@69: #ifndef __DBE_H jpayne@69: #define __DBE_H jpayne@69: jpayne@69: #include "xcb.h" jpayne@69: #include "xproto.h" jpayne@69: jpayne@69: #ifdef __cplusplus jpayne@69: extern "C" { jpayne@69: #endif jpayne@69: jpayne@69: #define XCB_DBE_MAJOR_VERSION 1 jpayne@69: #define XCB_DBE_MINOR_VERSION 0 jpayne@69: jpayne@69: extern xcb_extension_t xcb_dbe_id; jpayne@69: jpayne@69: typedef uint32_t xcb_dbe_back_buffer_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_back_buffer_iterator_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_back_buffer_iterator_t { jpayne@69: xcb_dbe_back_buffer_t *data; jpayne@69: int rem; jpayne@69: int index; jpayne@69: } xcb_dbe_back_buffer_iterator_t; jpayne@69: jpayne@69: typedef enum xcb_dbe_swap_action_t { jpayne@69: XCB_DBE_SWAP_ACTION_UNDEFINED = 0, jpayne@69: /**< Discard the buffer. The buffer may be reallocated and end up with random VRAM content. */ jpayne@69: jpayne@69: XCB_DBE_SWAP_ACTION_BACKGROUND = 1, jpayne@69: /**< Erase with window background. */ jpayne@69: jpayne@69: XCB_DBE_SWAP_ACTION_UNTOUCHED = 2, jpayne@69: /**< Leave untouched. */ jpayne@69: jpayne@69: XCB_DBE_SWAP_ACTION_COPIED = 3 jpayne@69: /**< Copy the newly displayed front buffer. */ jpayne@69: jpayne@69: } xcb_dbe_swap_action_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_swap_info_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_swap_info_t { jpayne@69: xcb_window_t window; jpayne@69: uint8_t swap_action; jpayne@69: uint8_t pad0[3]; jpayne@69: } xcb_dbe_swap_info_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_swap_info_iterator_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_swap_info_iterator_t { jpayne@69: xcb_dbe_swap_info_t *data; jpayne@69: int rem; jpayne@69: int index; jpayne@69: } xcb_dbe_swap_info_iterator_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_buffer_attributes_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_buffer_attributes_t { jpayne@69: xcb_window_t window; jpayne@69: } xcb_dbe_buffer_attributes_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_buffer_attributes_iterator_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_buffer_attributes_iterator_t { jpayne@69: xcb_dbe_buffer_attributes_t *data; jpayne@69: int rem; jpayne@69: int index; jpayne@69: } xcb_dbe_buffer_attributes_iterator_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_visual_info_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_visual_info_t { jpayne@69: xcb_visualid_t visual_id; jpayne@69: uint8_t depth; jpayne@69: uint8_t perf_level; jpayne@69: uint8_t pad0[2]; jpayne@69: } xcb_dbe_visual_info_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_visual_info_iterator_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_visual_info_iterator_t { jpayne@69: xcb_dbe_visual_info_t *data; jpayne@69: int rem; jpayne@69: int index; jpayne@69: } xcb_dbe_visual_info_iterator_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_visual_infos_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_visual_infos_t { jpayne@69: uint32_t n_infos; jpayne@69: } xcb_dbe_visual_infos_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_visual_infos_iterator_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_visual_infos_iterator_t { jpayne@69: xcb_dbe_visual_infos_t *data; jpayne@69: int rem; jpayne@69: int index; jpayne@69: } xcb_dbe_visual_infos_iterator_t; jpayne@69: jpayne@69: /** Opcode for xcb_dbe_bad_buffer. */ jpayne@69: #define XCB_DBE_BAD_BUFFER 0 jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_bad_buffer_error_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_bad_buffer_error_t { jpayne@69: uint8_t response_type; jpayne@69: uint8_t error_code; jpayne@69: uint16_t sequence; jpayne@69: xcb_dbe_back_buffer_t bad_buffer; jpayne@69: uint16_t minor_opcode; jpayne@69: uint8_t major_opcode; jpayne@69: } xcb_dbe_bad_buffer_error_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_query_version_cookie_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_query_version_cookie_t { jpayne@69: unsigned int sequence; jpayne@69: } xcb_dbe_query_version_cookie_t; jpayne@69: jpayne@69: /** Opcode for xcb_dbe_query_version. */ jpayne@69: #define XCB_DBE_QUERY_VERSION 0 jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_query_version_request_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_query_version_request_t { jpayne@69: uint8_t major_opcode; jpayne@69: uint8_t minor_opcode; jpayne@69: uint16_t length; jpayne@69: uint8_t major_version; jpayne@69: uint8_t minor_version; jpayne@69: uint8_t pad0[2]; jpayne@69: } xcb_dbe_query_version_request_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_query_version_reply_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_query_version_reply_t { jpayne@69: uint8_t response_type; jpayne@69: uint8_t pad0; jpayne@69: uint16_t sequence; jpayne@69: uint32_t length; jpayne@69: uint8_t major_version; jpayne@69: uint8_t minor_version; jpayne@69: uint8_t pad1[22]; jpayne@69: } xcb_dbe_query_version_reply_t; jpayne@69: jpayne@69: /** Opcode for xcb_dbe_allocate_back_buffer. */ jpayne@69: #define XCB_DBE_ALLOCATE_BACK_BUFFER 1 jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_allocate_back_buffer_request_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_allocate_back_buffer_request_t { jpayne@69: uint8_t major_opcode; jpayne@69: uint8_t minor_opcode; jpayne@69: uint16_t length; jpayne@69: xcb_window_t window; jpayne@69: xcb_dbe_back_buffer_t buffer; jpayne@69: uint8_t swap_action; jpayne@69: uint8_t pad0[3]; jpayne@69: } xcb_dbe_allocate_back_buffer_request_t; jpayne@69: jpayne@69: /** Opcode for xcb_dbe_deallocate_back_buffer. */ jpayne@69: #define XCB_DBE_DEALLOCATE_BACK_BUFFER 2 jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_deallocate_back_buffer_request_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_deallocate_back_buffer_request_t { jpayne@69: uint8_t major_opcode; jpayne@69: uint8_t minor_opcode; jpayne@69: uint16_t length; jpayne@69: xcb_dbe_back_buffer_t buffer; jpayne@69: } xcb_dbe_deallocate_back_buffer_request_t; jpayne@69: jpayne@69: /** Opcode for xcb_dbe_swap_buffers. */ jpayne@69: #define XCB_DBE_SWAP_BUFFERS 3 jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_swap_buffers_request_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_swap_buffers_request_t { jpayne@69: uint8_t major_opcode; jpayne@69: uint8_t minor_opcode; jpayne@69: uint16_t length; jpayne@69: uint32_t n_actions; jpayne@69: } xcb_dbe_swap_buffers_request_t; jpayne@69: jpayne@69: /** Opcode for xcb_dbe_begin_idiom. */ jpayne@69: #define XCB_DBE_BEGIN_IDIOM 4 jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_begin_idiom_request_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_begin_idiom_request_t { jpayne@69: uint8_t major_opcode; jpayne@69: uint8_t minor_opcode; jpayne@69: uint16_t length; jpayne@69: } xcb_dbe_begin_idiom_request_t; jpayne@69: jpayne@69: /** Opcode for xcb_dbe_end_idiom. */ jpayne@69: #define XCB_DBE_END_IDIOM 5 jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_end_idiom_request_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_end_idiom_request_t { jpayne@69: uint8_t major_opcode; jpayne@69: uint8_t minor_opcode; jpayne@69: uint16_t length; jpayne@69: } xcb_dbe_end_idiom_request_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_get_visual_info_cookie_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_get_visual_info_cookie_t { jpayne@69: unsigned int sequence; jpayne@69: } xcb_dbe_get_visual_info_cookie_t; jpayne@69: jpayne@69: /** Opcode for xcb_dbe_get_visual_info. */ jpayne@69: #define XCB_DBE_GET_VISUAL_INFO 6 jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_get_visual_info_request_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_get_visual_info_request_t { jpayne@69: uint8_t major_opcode; jpayne@69: uint8_t minor_opcode; jpayne@69: uint16_t length; jpayne@69: uint32_t n_drawables; jpayne@69: } xcb_dbe_get_visual_info_request_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_get_visual_info_reply_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_get_visual_info_reply_t { jpayne@69: uint8_t response_type; jpayne@69: uint8_t pad0; jpayne@69: uint16_t sequence; jpayne@69: uint32_t length; jpayne@69: uint32_t n_supported_visuals; jpayne@69: uint8_t pad1[20]; jpayne@69: } xcb_dbe_get_visual_info_reply_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_get_back_buffer_attributes_cookie_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_get_back_buffer_attributes_cookie_t { jpayne@69: unsigned int sequence; jpayne@69: } xcb_dbe_get_back_buffer_attributes_cookie_t; jpayne@69: jpayne@69: /** Opcode for xcb_dbe_get_back_buffer_attributes. */ jpayne@69: #define XCB_DBE_GET_BACK_BUFFER_ATTRIBUTES 7 jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_get_back_buffer_attributes_request_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_get_back_buffer_attributes_request_t { jpayne@69: uint8_t major_opcode; jpayne@69: uint8_t minor_opcode; jpayne@69: uint16_t length; jpayne@69: xcb_dbe_back_buffer_t buffer; jpayne@69: } xcb_dbe_get_back_buffer_attributes_request_t; jpayne@69: jpayne@69: /** jpayne@69: * @brief xcb_dbe_get_back_buffer_attributes_reply_t jpayne@69: **/ jpayne@69: typedef struct xcb_dbe_get_back_buffer_attributes_reply_t { jpayne@69: uint8_t response_type; jpayne@69: uint8_t pad0; jpayne@69: uint16_t sequence; jpayne@69: uint32_t length; jpayne@69: xcb_dbe_buffer_attributes_t attributes; jpayne@69: uint8_t pad1[20]; jpayne@69: } xcb_dbe_get_back_buffer_attributes_reply_t; jpayne@69: jpayne@69: /** jpayne@69: * Get the next element of the iterator jpayne@69: * @param i Pointer to a xcb_dbe_back_buffer_iterator_t jpayne@69: * jpayne@69: * Get the next element in the iterator. The member rem is jpayne@69: * decreased by one. The member data points to the next jpayne@69: * element. The member index is increased by sizeof(xcb_dbe_back_buffer_t) jpayne@69: */ jpayne@69: void jpayne@69: xcb_dbe_back_buffer_next (xcb_dbe_back_buffer_iterator_t *i); jpayne@69: jpayne@69: /** jpayne@69: * Return the iterator pointing to the last element jpayne@69: * @param i An xcb_dbe_back_buffer_iterator_t jpayne@69: * @return The iterator pointing to the last element jpayne@69: * jpayne@69: * Set the current element in the iterator to the last element. jpayne@69: * The member rem is set to 0. The member data points to the jpayne@69: * last element. jpayne@69: */ jpayne@69: xcb_generic_iterator_t jpayne@69: xcb_dbe_back_buffer_end (xcb_dbe_back_buffer_iterator_t i); jpayne@69: jpayne@69: /** jpayne@69: * Get the next element of the iterator jpayne@69: * @param i Pointer to a xcb_dbe_swap_info_iterator_t jpayne@69: * jpayne@69: * Get the next element in the iterator. The member rem is jpayne@69: * decreased by one. The member data points to the next jpayne@69: * element. The member index is increased by sizeof(xcb_dbe_swap_info_t) jpayne@69: */ jpayne@69: void jpayne@69: xcb_dbe_swap_info_next (xcb_dbe_swap_info_iterator_t *i); jpayne@69: jpayne@69: /** jpayne@69: * Return the iterator pointing to the last element jpayne@69: * @param i An xcb_dbe_swap_info_iterator_t jpayne@69: * @return The iterator pointing to the last element jpayne@69: * jpayne@69: * Set the current element in the iterator to the last element. jpayne@69: * The member rem is set to 0. The member data points to the jpayne@69: * last element. jpayne@69: */ jpayne@69: xcb_generic_iterator_t jpayne@69: xcb_dbe_swap_info_end (xcb_dbe_swap_info_iterator_t i); jpayne@69: jpayne@69: /** jpayne@69: * Get the next element of the iterator jpayne@69: * @param i Pointer to a xcb_dbe_buffer_attributes_iterator_t jpayne@69: * jpayne@69: * Get the next element in the iterator. The member rem is jpayne@69: * decreased by one. The member data points to the next jpayne@69: * element. The member index is increased by sizeof(xcb_dbe_buffer_attributes_t) jpayne@69: */ jpayne@69: void jpayne@69: xcb_dbe_buffer_attributes_next (xcb_dbe_buffer_attributes_iterator_t *i); jpayne@69: jpayne@69: /** jpayne@69: * Return the iterator pointing to the last element jpayne@69: * @param i An xcb_dbe_buffer_attributes_iterator_t jpayne@69: * @return The iterator pointing to the last element jpayne@69: * jpayne@69: * Set the current element in the iterator to the last element. jpayne@69: * The member rem is set to 0. The member data points to the jpayne@69: * last element. jpayne@69: */ jpayne@69: xcb_generic_iterator_t jpayne@69: xcb_dbe_buffer_attributes_end (xcb_dbe_buffer_attributes_iterator_t i); jpayne@69: jpayne@69: /** jpayne@69: * Get the next element of the iterator jpayne@69: * @param i Pointer to a xcb_dbe_visual_info_iterator_t jpayne@69: * jpayne@69: * Get the next element in the iterator. The member rem is jpayne@69: * decreased by one. The member data points to the next jpayne@69: * element. The member index is increased by sizeof(xcb_dbe_visual_info_t) jpayne@69: */ jpayne@69: void jpayne@69: xcb_dbe_visual_info_next (xcb_dbe_visual_info_iterator_t *i); jpayne@69: jpayne@69: /** jpayne@69: * Return the iterator pointing to the last element jpayne@69: * @param i An xcb_dbe_visual_info_iterator_t jpayne@69: * @return The iterator pointing to the last element jpayne@69: * jpayne@69: * Set the current element in the iterator to the last element. jpayne@69: * The member rem is set to 0. The member data points to the jpayne@69: * last element. jpayne@69: */ jpayne@69: xcb_generic_iterator_t jpayne@69: xcb_dbe_visual_info_end (xcb_dbe_visual_info_iterator_t i); jpayne@69: jpayne@69: int jpayne@69: xcb_dbe_visual_infos_sizeof (const void *_buffer); jpayne@69: jpayne@69: xcb_dbe_visual_info_t * jpayne@69: xcb_dbe_visual_infos_infos (const xcb_dbe_visual_infos_t *R); jpayne@69: jpayne@69: int jpayne@69: xcb_dbe_visual_infos_infos_length (const xcb_dbe_visual_infos_t *R); jpayne@69: jpayne@69: xcb_dbe_visual_info_iterator_t jpayne@69: xcb_dbe_visual_infos_infos_iterator (const xcb_dbe_visual_infos_t *R); jpayne@69: jpayne@69: /** jpayne@69: * Get the next element of the iterator jpayne@69: * @param i Pointer to a xcb_dbe_visual_infos_iterator_t jpayne@69: * jpayne@69: * Get the next element in the iterator. The member rem is jpayne@69: * decreased by one. The member data points to the next jpayne@69: * element. The member index is increased by sizeof(xcb_dbe_visual_infos_t) jpayne@69: */ jpayne@69: void jpayne@69: xcb_dbe_visual_infos_next (xcb_dbe_visual_infos_iterator_t *i); jpayne@69: jpayne@69: /** jpayne@69: * Return the iterator pointing to the last element jpayne@69: * @param i An xcb_dbe_visual_infos_iterator_t jpayne@69: * @return The iterator pointing to the last element jpayne@69: * jpayne@69: * Set the current element in the iterator to the last element. jpayne@69: * The member rem is set to 0. The member data points to the jpayne@69: * last element. jpayne@69: */ jpayne@69: xcb_generic_iterator_t jpayne@69: xcb_dbe_visual_infos_end (xcb_dbe_visual_infos_iterator_t i); jpayne@69: jpayne@69: /** jpayne@69: * @brief Queries the version of this extension jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @param major_version The major version of the extension. Check that it is compatible with the XCB_DBE_MAJOR_VERSION that your code is compiled with. jpayne@69: * @param minor_version The minor version of the extension. Check that it is compatible with the XCB_DBE_MINOR_VERSION that your code is compiled with. jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * Queries the version of this extension. You must do this before using any functionality it provides. jpayne@69: * jpayne@69: */ jpayne@69: xcb_dbe_query_version_cookie_t jpayne@69: xcb_dbe_query_version (xcb_connection_t *c, jpayne@69: uint8_t major_version, jpayne@69: uint8_t minor_version); jpayne@69: jpayne@69: /** jpayne@69: * @brief Queries the version of this extension jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @param major_version The major version of the extension. Check that it is compatible with the XCB_DBE_MAJOR_VERSION that your code is compiled with. jpayne@69: * @param minor_version The minor version of the extension. Check that it is compatible with the XCB_DBE_MINOR_VERSION that your code is compiled with. jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * Queries the version of this extension. You must do this before using any functionality it provides. jpayne@69: * jpayne@69: * This form can be used only if the request will cause jpayne@69: * a reply to be generated. Any returned error will be jpayne@69: * placed in the event queue. jpayne@69: */ jpayne@69: xcb_dbe_query_version_cookie_t jpayne@69: xcb_dbe_query_version_unchecked (xcb_connection_t *c, jpayne@69: uint8_t major_version, jpayne@69: uint8_t minor_version); jpayne@69: jpayne@69: /** jpayne@69: * Return the reply jpayne@69: * @param c The connection jpayne@69: * @param cookie The cookie jpayne@69: * @param e The xcb_generic_error_t supplied jpayne@69: * jpayne@69: * Returns the reply of the request asked by jpayne@69: * jpayne@69: * The parameter @p e supplied to this function must be NULL if jpayne@69: * xcb_dbe_query_version_unchecked(). is used. jpayne@69: * Otherwise, it stores the error if any. jpayne@69: * jpayne@69: * The returned value must be freed by the caller using free(). jpayne@69: */ jpayne@69: xcb_dbe_query_version_reply_t * jpayne@69: xcb_dbe_query_version_reply (xcb_connection_t *c, jpayne@69: xcb_dbe_query_version_cookie_t cookie /**< */, jpayne@69: xcb_generic_error_t **e); jpayne@69: jpayne@69: /** jpayne@69: * @brief Allocates a back buffer jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @param window The window to which to add the back buffer. jpayne@69: * @param buffer The buffer id to associate with the back buffer. jpayne@69: * @param swap_action The swap action most likely to be used to present this back buffer. This is only a hint, and does not preclude the use of other swap actions. jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * Associates \a buffer with the back buffer of \a window. Multiple ids may be associated with the back buffer, which is created by the first allocate call and destroyed by the last deallocate. jpayne@69: * jpayne@69: * This form can be used only if the request will not cause jpayne@69: * a reply to be generated. Any returned error will be jpayne@69: * saved for handling by xcb_request_check(). jpayne@69: */ jpayne@69: xcb_void_cookie_t jpayne@69: xcb_dbe_allocate_back_buffer_checked (xcb_connection_t *c, jpayne@69: xcb_window_t window, jpayne@69: xcb_dbe_back_buffer_t buffer, jpayne@69: uint8_t swap_action); jpayne@69: jpayne@69: /** jpayne@69: * @brief Allocates a back buffer jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @param window The window to which to add the back buffer. jpayne@69: * @param buffer The buffer id to associate with the back buffer. jpayne@69: * @param swap_action The swap action most likely to be used to present this back buffer. This is only a hint, and does not preclude the use of other swap actions. jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * Associates \a buffer with the back buffer of \a window. Multiple ids may be associated with the back buffer, which is created by the first allocate call and destroyed by the last deallocate. jpayne@69: * jpayne@69: */ jpayne@69: xcb_void_cookie_t jpayne@69: xcb_dbe_allocate_back_buffer (xcb_connection_t *c, jpayne@69: xcb_window_t window, jpayne@69: xcb_dbe_back_buffer_t buffer, jpayne@69: uint8_t swap_action); jpayne@69: jpayne@69: /** jpayne@69: * @brief Deallocates a back buffer jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @param buffer The back buffer to deallocate. jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * Deallocates the given \a buffer. If \a buffer is an invalid id, a `BadBuffer` error is returned. Because a window may have allocated multiple back buffer ids, the back buffer itself is not deleted until all these ids are deallocated by this call. jpayne@69: * jpayne@69: * This form can be used only if the request will not cause jpayne@69: * a reply to be generated. Any returned error will be jpayne@69: * saved for handling by xcb_request_check(). jpayne@69: */ jpayne@69: xcb_void_cookie_t jpayne@69: xcb_dbe_deallocate_back_buffer_checked (xcb_connection_t *c, jpayne@69: xcb_dbe_back_buffer_t buffer); jpayne@69: jpayne@69: /** jpayne@69: * @brief Deallocates a back buffer jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @param buffer The back buffer to deallocate. jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * Deallocates the given \a buffer. If \a buffer is an invalid id, a `BadBuffer` error is returned. Because a window may have allocated multiple back buffer ids, the back buffer itself is not deleted until all these ids are deallocated by this call. jpayne@69: * jpayne@69: */ jpayne@69: xcb_void_cookie_t jpayne@69: xcb_dbe_deallocate_back_buffer (xcb_connection_t *c, jpayne@69: xcb_dbe_back_buffer_t buffer); jpayne@69: jpayne@69: int jpayne@69: xcb_dbe_swap_buffers_sizeof (const void *_buffer); jpayne@69: jpayne@69: /** jpayne@69: * @brief Swaps front and back buffers jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @param n_actions Number of swap actions in \a actions. jpayne@69: * @param actions List of windows on which to swap buffers. jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * Swaps the front and back buffers on the specified windows. The front and back buffers retain their ids, so that the window id continues to refer to the front buffer, while the back buffer id created by this extension continues to refer to the back buffer. Back buffer contents is moved to the front buffer. Back buffer contents after the operation depends on the given swap action. The optimal swap action depends on how each frame is rendered. For example, if the buffer is cleared and fully overwritten on every frame, the "untouched" action, which throws away the buffer contents, would provide the best performance. To eliminate visual artifacts, the swap will occure during the monitor VSync, if the X server supports detecting it. jpayne@69: * jpayne@69: * This form can be used only if the request will not cause jpayne@69: * a reply to be generated. Any returned error will be jpayne@69: * saved for handling by xcb_request_check(). jpayne@69: */ jpayne@69: xcb_void_cookie_t jpayne@69: xcb_dbe_swap_buffers_checked (xcb_connection_t *c, jpayne@69: uint32_t n_actions, jpayne@69: const xcb_dbe_swap_info_t *actions); jpayne@69: jpayne@69: /** jpayne@69: * @brief Swaps front and back buffers jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @param n_actions Number of swap actions in \a actions. jpayne@69: * @param actions List of windows on which to swap buffers. jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * Swaps the front and back buffers on the specified windows. The front and back buffers retain their ids, so that the window id continues to refer to the front buffer, while the back buffer id created by this extension continues to refer to the back buffer. Back buffer contents is moved to the front buffer. Back buffer contents after the operation depends on the given swap action. The optimal swap action depends on how each frame is rendered. For example, if the buffer is cleared and fully overwritten on every frame, the "untouched" action, which throws away the buffer contents, would provide the best performance. To eliminate visual artifacts, the swap will occure during the monitor VSync, if the X server supports detecting it. jpayne@69: * jpayne@69: */ jpayne@69: xcb_void_cookie_t jpayne@69: xcb_dbe_swap_buffers (xcb_connection_t *c, jpayne@69: uint32_t n_actions, jpayne@69: const xcb_dbe_swap_info_t *actions); jpayne@69: jpayne@69: xcb_dbe_swap_info_t * jpayne@69: xcb_dbe_swap_buffers_actions (const xcb_dbe_swap_buffers_request_t *R); jpayne@69: jpayne@69: int jpayne@69: xcb_dbe_swap_buffers_actions_length (const xcb_dbe_swap_buffers_request_t *R); jpayne@69: jpayne@69: xcb_dbe_swap_info_iterator_t jpayne@69: xcb_dbe_swap_buffers_actions_iterator (const xcb_dbe_swap_buffers_request_t *R); jpayne@69: jpayne@69: /** jpayne@69: * @brief Begins a logical swap block jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * Creates a block of operations intended to occur together. This may be needed if window presentation requires changing buffers unknown to this extension, such as depth or stencil buffers. jpayne@69: * jpayne@69: * This form can be used only if the request will not cause jpayne@69: * a reply to be generated. Any returned error will be jpayne@69: * saved for handling by xcb_request_check(). jpayne@69: */ jpayne@69: xcb_void_cookie_t jpayne@69: xcb_dbe_begin_idiom_checked (xcb_connection_t *c); jpayne@69: jpayne@69: /** jpayne@69: * @brief Begins a logical swap block jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * Creates a block of operations intended to occur together. This may be needed if window presentation requires changing buffers unknown to this extension, such as depth or stencil buffers. jpayne@69: * jpayne@69: */ jpayne@69: xcb_void_cookie_t jpayne@69: xcb_dbe_begin_idiom (xcb_connection_t *c); jpayne@69: jpayne@69: /** jpayne@69: * @brief Ends a logical swap block jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * No description yet jpayne@69: * jpayne@69: * This form can be used only if the request will not cause jpayne@69: * a reply to be generated. Any returned error will be jpayne@69: * saved for handling by xcb_request_check(). jpayne@69: */ jpayne@69: xcb_void_cookie_t jpayne@69: xcb_dbe_end_idiom_checked (xcb_connection_t *c); jpayne@69: jpayne@69: /** jpayne@69: * @brief Ends a logical swap block jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * No description yet jpayne@69: * jpayne@69: */ jpayne@69: xcb_void_cookie_t jpayne@69: xcb_dbe_end_idiom (xcb_connection_t *c); jpayne@69: jpayne@69: int jpayne@69: xcb_dbe_get_visual_info_sizeof (const void *_buffer); jpayne@69: jpayne@69: /** jpayne@69: * @brief Requests visuals that support double buffering jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * No description yet jpayne@69: * jpayne@69: */ jpayne@69: xcb_dbe_get_visual_info_cookie_t jpayne@69: xcb_dbe_get_visual_info (xcb_connection_t *c, jpayne@69: uint32_t n_drawables, jpayne@69: const xcb_drawable_t *drawables); jpayne@69: jpayne@69: /** jpayne@69: * @brief Requests visuals that support double buffering jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * No description yet jpayne@69: * jpayne@69: * This form can be used only if the request will cause jpayne@69: * a reply to be generated. Any returned error will be jpayne@69: * placed in the event queue. jpayne@69: */ jpayne@69: xcb_dbe_get_visual_info_cookie_t jpayne@69: xcb_dbe_get_visual_info_unchecked (xcb_connection_t *c, jpayne@69: uint32_t n_drawables, jpayne@69: const xcb_drawable_t *drawables); jpayne@69: jpayne@69: int jpayne@69: xcb_dbe_get_visual_info_supported_visuals_length (const xcb_dbe_get_visual_info_reply_t *R); jpayne@69: jpayne@69: xcb_dbe_visual_infos_iterator_t jpayne@69: xcb_dbe_get_visual_info_supported_visuals_iterator (const xcb_dbe_get_visual_info_reply_t *R); jpayne@69: jpayne@69: /** jpayne@69: * Return the reply jpayne@69: * @param c The connection jpayne@69: * @param cookie The cookie jpayne@69: * @param e The xcb_generic_error_t supplied jpayne@69: * jpayne@69: * Returns the reply of the request asked by jpayne@69: * jpayne@69: * The parameter @p e supplied to this function must be NULL if jpayne@69: * xcb_dbe_get_visual_info_unchecked(). is used. jpayne@69: * Otherwise, it stores the error if any. jpayne@69: * jpayne@69: * The returned value must be freed by the caller using free(). jpayne@69: */ jpayne@69: xcb_dbe_get_visual_info_reply_t * jpayne@69: xcb_dbe_get_visual_info_reply (xcb_connection_t *c, jpayne@69: xcb_dbe_get_visual_info_cookie_t cookie /**< */, jpayne@69: xcb_generic_error_t **e); jpayne@69: jpayne@69: /** jpayne@69: * @brief Gets back buffer attributes jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @param buffer The back buffer to query. jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * Returns the attributes of the specified \a buffer. jpayne@69: * jpayne@69: */ jpayne@69: xcb_dbe_get_back_buffer_attributes_cookie_t jpayne@69: xcb_dbe_get_back_buffer_attributes (xcb_connection_t *c, jpayne@69: xcb_dbe_back_buffer_t buffer); jpayne@69: jpayne@69: /** jpayne@69: * @brief Gets back buffer attributes jpayne@69: * jpayne@69: * @param c The connection jpayne@69: * @param buffer The back buffer to query. jpayne@69: * @return A cookie jpayne@69: * jpayne@69: * Returns the attributes of the specified \a buffer. jpayne@69: * jpayne@69: * This form can be used only if the request will cause jpayne@69: * a reply to be generated. Any returned error will be jpayne@69: * placed in the event queue. jpayne@69: */ jpayne@69: xcb_dbe_get_back_buffer_attributes_cookie_t jpayne@69: xcb_dbe_get_back_buffer_attributes_unchecked (xcb_connection_t *c, jpayne@69: xcb_dbe_back_buffer_t buffer); jpayne@69: jpayne@69: /** jpayne@69: * Return the reply jpayne@69: * @param c The connection jpayne@69: * @param cookie The cookie jpayne@69: * @param e The xcb_generic_error_t supplied jpayne@69: * jpayne@69: * Returns the reply of the request asked by jpayne@69: * jpayne@69: * The parameter @p e supplied to this function must be NULL if jpayne@69: * xcb_dbe_get_back_buffer_attributes_unchecked(). is used. jpayne@69: * Otherwise, it stores the error if any. jpayne@69: * jpayne@69: * The returned value must be freed by the caller using free(). jpayne@69: */ jpayne@69: xcb_dbe_get_back_buffer_attributes_reply_t * jpayne@69: xcb_dbe_get_back_buffer_attributes_reply (xcb_connection_t *c, jpayne@69: xcb_dbe_get_back_buffer_attributes_cookie_t cookie /**< */, jpayne@69: xcb_generic_error_t **e); jpayne@69: jpayne@69: jpayne@69: #ifdef __cplusplus jpayne@69: } jpayne@69: #endif jpayne@69: jpayne@69: #endif jpayne@69: jpayne@69: /** jpayne@69: * @} jpayne@69: */