Crate glfw_raw_window_handle_0_5_0

Crate glfw_raw_window_handle_0_5_0 

Source
Expand description

An idiomatic wrapper for the GLFW library.

§Example

extern crate glfw;

use glfw::{Action, Context, Key};

fn main() {
   let mut glfw = glfw::init(glfw::FAIL_ON_ERRORS).unwrap();

    // Create a windowed mode window and its OpenGL context
    let (mut window, events) = glfw.create_window(300, 300, "Hello this is window", glfw::WindowMode::Windowed)
        .expect("Failed to create GLFW window.");

    // Make the window's context current
    window.make_current();
    window.set_key_polling(true);

    // Loop until the user closes the window
    while !window.should_close() {
        // Swap front and back buffers
        window.swap_buffers();

        // Poll for and process events
        glfw.poll_events();
        for (_, event) in glfw::flush_messages(&events) {
            println!("{:?}", event);
            match event {
                glfw::WindowEvent::Key(Key::Escape, _, Action::Press, _) => {
                    window.set_should_close(true)
                },
                _ => {},
            }
        }
    }
}

§Cargo Features

Use the vulkan feature flag to enable all Vulkan functions and types.

Use the image feature flag to enable use of the image library for cursors and icons.

Use the all feature flag to enable both at the same time.

Re-exports§

pub use self::MouseButton::Button1 as MouseButtonLeft;
pub use self::MouseButton::Button2 as MouseButtonRight;
pub use self::MouseButton::Button3 as MouseButtonMiddle;

Modules§

ffi
Low-level function bindings and constants pertaining to the underlying GLFW library.

Structs§

Callback
Cursor
Represents a window cursor that can be used to display any of the standard cursors or load a custom cursor from an image.
DebugAliases
Formats the type using aliases rather than the default variant names.
FlushedMessages
An iterator that yields until no more messages are contained in the Receiver’s queue.
GamepadState
State of a gamepad.
GammaRamp
Describes the gamma ramp of a monitor.
Glfw
A token from which to call various GLFW functions. It can be obtained by calling the init function. This cannot be sent to other tasks, and should only be initialized on the main platform thread. Whilst this might make performing some operations harder, this is to ensure thread safety is enforced statically.
Joystick
A joystick handle.
JoystickHats
Joystick hats.
Modifiers
Key modifiers (e.g., Shift, Control, Alt, Super)
Monitor
A struct that wraps a *GLFWmonitor handle.
PixelImage
When not using the image library, or if you just want to, you can specify an image from its raw pixel data using this structure.
RenderContext
A rendering context that can be shared between tasks.
Version
VidMode
Describes a single video mode.
Window
A struct that wraps a *GLFWwindow handle.

Enums§

Action
Input actions.
ClientApiHint
Client API tokens.
ContextCreationApi
Specifies the API to use to create the context
ContextReleaseBehavior
ContextReleaseBehavior specifies the release behavior to be used by the context.
ContextRobustnessHint
Context robustness tokens.
CursorMode
Cursor modes.
Error
Tokens corresponding to various error types.
GamepadAxis
Axis identifier tokens.
GamepadButton
Button identifier tokens.
InitError
An error that might be returned when glfw::init is called.
InitHint
Initialization hints that can be set using the init_hint function.
JoystickEvent
Joystick events.
JoystickId
Joystick identifier tokens.
Key
Input keys.
MonitorEvent
Monitor events.
MouseButton
Mouse buttons. The MouseButtonLeft, MouseButtonRight, and MouseButtonMiddle aliases are supplied for convenience.
OpenGlProfileHint
OpenGL profile tokens.
StandardCursor
Standard cursors provided by GLFW
SwapInterval
Specifies how the context should handle swapping the buffers.
WindowEvent
Window event messages.
WindowHint
Window hints that can be set using the window_hint function.
WindowMode
Describes the mode of a window

Statics§

FAIL_ON_ERRORS
A callback that triggers a task failure when an error is encountered.
LOG_ERRORS
A callback that logs each error as it is encountered without triggering a task failure.

Traits§

Context
Methods common to renderable contexts

Functions§

fail_on_errors
The function to be used with the FAIL_ON_ERRORS callback.
flush_messages
Returns an iterator that yields until no more messages are contained in the Receiver’s queue. This is useful for event handling where the blocking behaviour of Receiver::iter is undesirable.
get_key_name
Wrapper around glfwGetKeyName
get_key_scancode
Wrapper around glfwGetKeyScancode.
get_version
Wrapper for glfwGetVersion.
get_version_string
Wrapper for glfwGetVersionString.
init
Initializes the GLFW library. This must be called on the main platform thread.
init_hint
Sets hints for the next initialization of GLFW.
key_nameDeprecated
Wrapper around glfwGetKeyName
log_errors
The function to be used with the LOG_ERRORS callback.
make_context_current
Wrapper for glfwMakeContextCurrent.
string_from_c_str
Replacement for String::from_raw_buf
string_from_nullable_c_str
Like string_from_c_str, but handles null pointers correctly
with_c_str
Replacement for ToCStr::with_c_str

Type Aliases§

ErrorCallback
An error callback. This can be supplied with some user data to be passed to the callback function when it is triggered.
GLProc
An OpenGL process address.
JoystickCallback
An joystick callback. This can be supplied with some user data to be passed to the callback function when it is triggered.
MonitorCallback
An monitor callback. This can be supplied with some user data to be passed to the callback function when it is triggered.
Scancode
Keyboard code returned by the OS
WindowId
Unique identifier for a Window.