API
XCB.Connection
XCB.Connection
XCB.ConnectionError
XCB.FlushError
XCB.GraphicsContext
XCB.Handle
XCB.RequestError
XCB.Setup
XCB.XCBWindow
XCB.XCBWindow
XCB.XCBWindow
XCB.XCBWindow
XCB.check
XCB.check_flush
XCB.check_request
XCB.response_type_xcb
XCB.state_xcb
XCB.@check
XCB.@flush
XCB.Connection
— TypeConnection to the X server.
mutable struct Connection <: XCB.Handle
h::Ptr{Nothing}
: Opaque handle to the connection, used for API calls.
XCB.Connection
— MethodInitialize a connection to the X server.
Connection(; display) -> Connection
-
XCB.ConnectionError
— TypeThe X Server reported a connection error.
struct ConnectionError <: Exception
msg::Any
code::Any
XCB.FlushError
— TypeError when flushing a connection to the X Server.
struct FlushError <: Exception
code::Any
XCB.GraphicsContext
— TypeGraphics context attached to a window. Used to register drawing commands on the window surface.
mutable struct GraphicsContext
conn::Connection
id::UInt32
XCB.Handle
— TypeStructures which contain a handle (opaque pointer) as primary data. Those structures are usually defined as mutable so that a finalizer can be registered. Any Handle structure is automatically converted to its handle data on ccall
s, through unsafe_convert
.
abstract type Handle
XCB.RequestError
— TypeA request to the X Server returned with an error.
struct RequestError <: Exception
msg::Any
XCB.Setup
— TypeConnection setup handle and data.
struct Setup <: XCB.Handle
h::Ptr{xcb_setup_t}
: Handle to the setup, used for API calls.
value::xcb_setup_t
: Setup value, obtained when dereferencing its handle.
XCB.XCBWindow
— TypeWindow type used with the XCB API.
mutable struct XCBWindow <: AbstractWindow
conn::Connection
id::UInt32
parent_id::UInt32
visual_id::UInt32
delete_request::UInt32
gc::Union{Nothing, GraphicsContext}
XCB.XCBWindow
— MethodCreate a new window whose parent is given by parent_id
and visual by visual_id
.
XCBWindow(
+API · XCB.jl API
XCB.Connection
XCB.Connection
XCB.ConnectionError
XCB.FlushError
XCB.GraphicsContext
XCB.Handle
XCB.RequestError
XCB.Setup
XCB.XCBWindow
XCB.XCBWindow
XCB.XCBWindow
XCB.XCBWindow
XCB.check
XCB.check_flush
XCB.check_request
XCB.response_type_xcb
XCB.state_xcb
XCB.@check
XCB.@flush
XCB.Connection
— TypeConnection to the X server.
mutable struct Connection <: XCB.Handle
h::Ptr{Nothing}
: Opaque handle to the connection, used for API calls.
sourceXCB.Connection
— MethodInitialize a connection to the X server.
Connection(; display) -> Connection
+
sourceXCB.ConnectionError
— TypeThe X Server reported a connection error.
struct ConnectionError <: Exception
msg::Any
code::Any
sourceXCB.FlushError
— TypeError when flushing a connection to the X Server.
struct FlushError <: Exception
code::Any
sourceXCB.GraphicsContext
— TypeGraphics context attached to a window. Used to register drawing commands on the window surface.
mutable struct GraphicsContext
conn::Connection
id::UInt32
sourceXCB.Handle
— TypeStructures which contain a handle (opaque pointer) as primary data. Those structures are usually defined as mutable so that a finalizer can be registered. Any Handle structure is automatically converted to its handle data on ccall
s, through unsafe_convert
.
abstract type Handle
sourceXCB.RequestError
— TypeA request to the X Server returned with an error.
struct RequestError <: Exception
msg::Any
sourceXCB.Setup
— TypeConnection setup handle and data.
struct Setup <: XCB.Handle
h::Ptr{xcb_setup_t}
: Handle to the setup, used for API calls.
value::xcb_setup_t
: Setup value, obtained when dereferencing its handle.
sourceXCB.XCBWindow
— TypeWindow type used with the XCB API.
mutable struct XCBWindow <: AbstractWindow
conn::Connection
id::UInt32
parent_id::UInt32
visual_id::UInt32
delete_request::UInt32
gc::Union{Nothing, GraphicsContext}
sourceXCB.XCBWindow
— MethodCreate a new window whose parent is given by parent_id
and visual by visual_id
.
XCBWindow(
conn,
parent_id,
visual_id;
@@ -17,18 +17,18 @@
attributes,
values
) -> XCBWindow
-
sourceXCB.XCBWindow
— MethodCreate a new window on the provided screen
.
XCBWindow(conn::Connection, screen; kwargs...) -> XCBWindow
-
sourceXCB.XCBWindow
— MethodCreate a new window on the current screen.
XCBWindow(conn::Connection; kwargs...) -> XCBWindow
-
sourceXCB.check
— MethodCheck that the connection to the X server was successful. Throws a ConnectionError
if the connection failed.
check(connection::Connection) -> Connection
-
sourceXCB.check_flush
— MethodCheck that the flush was successful, throwing a FlushError
if the code is negative.
check_flush(code)
-
sourceXCB.check_request
— MethodCheck that the request was successfully handled by the server, throwing a RequestError
if the request failed.
The severity level can be set via level
with one of the two following values:
- `:warn`: logs a warning with `@warn` (default).
+
sourceXCB.XCBWindow
— MethodCreate a new window on the provided screen
.
XCBWindow(conn::Connection, screen; kwargs...) -> XCBWindow
+
sourceXCB.XCBWindow
— MethodCreate a new window on the current screen.
XCBWindow(conn::Connection; kwargs...) -> XCBWindow
+
sourceXCB.check
— MethodCheck that the connection to the X server was successful. Throws a ConnectionError
if the connection failed.
check(connection::Connection) -> Connection
+
sourceXCB.check_flush
— MethodCheck that the flush was successful, throwing a FlushError
if the code is negative.
check_flush(code)
+
sourceXCB.check_request
— MethodCheck that the request was successfully handled by the server, throwing a RequestError
if the request failed.
The severity level can be set via level
with one of the two following values:
- `:warn`: logs a warning with `@warn` (default).
- `:error`: raise a `RequestError`.
check_request(conn, request; level)
-
sourceXCB.response_type_xcb
— MethodTranslate an action into its corresponding XCB value.
response_type_xcb(event::Event) -> Int64
-
sourceXCB.state_xcb
— MethodTranslate mouse or modifier state into the corresponding XCB value.
state_xcb(
+
sourceXCB.response_type_xcb
— MethodTranslate an action into its corresponding XCB value.
response_type_xcb(event::Event) -> Int64
+
sourceXCB.state_xcb
— MethodTranslate mouse or modifier state into the corresponding XCB value.
state_xcb(
event::Event
) -> Union{Int64, UInt64, xcb_mod_mask_t}
-
sourceXCB.@check
— MacroCheck the value returned by the function call request
with check_request
.
The severity level (:error
or :warn
) can be supplied as first argument. By default, the severity level is :warn
.
Wraps request
with check_request
. The Connection
argument is taken as the first argument of the function call expression request
. The request is transformed to be checkable, through the functions xcb*checked (or xcb* if there exists a xcb*_unchecked version). If no checkable substitute is found, an ArgumentError
is raised.
TODO: @macroexpand
example
sourceXCB.@flush
— MacroFlush a connection attached to a request expr
.
The connection is taken to be the first argument of expr
. expr
can be a call to XCB.@check
.
Examples
julia> @macroexpand @flush xcb_unmap_window(win.conn, win.id)
+
sourceXCB.@check
— MacroCheck the value returned by the function call request
with check_request
.
The severity level (:error
or :warn
) can be supplied as first argument. By default, the severity level is :warn
.
Wraps request
with check_request
. The Connection
argument is taken as the first argument of the function call expression request
. The request is transformed to be checkable, through the functions xcb*checked (or xcb* if there exists a xcb*_unchecked version). If no checkable substitute is found, an ArgumentError
is raised.
TODO: @macroexpand
example
sourceXCB.@flush
— MacroFlush a connection attached to a request expr
.
The connection is taken to be the first argument of expr
. expr
can be a call to XCB.@check
.
Examples
julia> @macroexpand @flush xcb_unmap_window(win.conn, win.id)
quote
xcb_unmap_window(win.conn, win.id)
(flush)(win.conn)
-end
sourceSettings
This document was generated with Documenter.jl version 1.5.0 on Sunday 18 August 2024. Using Julia version 1.9.4.
+end