Crate glfw

An idiomatic wrapper for the GLFW library.

Example

extern crate glfw;

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

fn main() {
   use glfw::fail_on_errors;
let mut glfw = glfw::init(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.

Macros

• 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

Structs

• 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.
• GlfwReceiver
• Joystick
  A joystick handle.
• JoystickHats
  Joystick hats.
• Modifiers
  Key modifiers (e.g., Shift, Control, Alt, Super)
• Monitor
  A struct that wraps a *GLFWmonitor handle.
• PRenderContext
• PWindow
• 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.
• ThreadSafeGlfw
  A struct that represents a thread safe handle to a Glfw
• 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

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_error
  Wrapper for glfwGetError.
• get_error_string
  Wrapper for glfwGetError.
• 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.
• init_no_callbacks
• 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

• GLProc
  An OpenGL process address.
• Scancode
  Keyboard code returned by the OS
• VkProc
  A Vulkan process address
• WindowId
  Unique identifier for a Window.