falsepattern/zig-glfw
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity

glfw: add Joystick.getGUID

Browse source 
Signed-off-by: Stephen Gutekanst <stephen@hexops.com>
This commit is contained in:
Stephen Gutekanst 2021-10-21 23:35:11 -07:00 • committed by Stephen Gutekanst
parent dc608ee6a8
commit 089b70b678
1 changed files with 42 additions and 39 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

81
glfw/src/joystick.zig
View file

@ -203,44 +203,38 @@ pub inline fn getName(self: Joystick) Error![*c]const u8 {
return name; return name;
} }
// TODO(joystick) /// Returns the SDL compatible GUID of the specified joystick.
// /// Returns the SDL compatible GUID of the specified joystick. ///
// /// /// This function returns the SDL compatible GUID, as a UTF-8 encoded hexadecimal string, of the
// /// This function returns the SDL compatible GUID, as a UTF-8 encoded /// specified joystick. The returned string is allocated and freed by GLFW. You should not free it
// /// hexadecimal string, of the specified joystick. The returned string is /// yourself.
// /// allocated and freed by GLFW. You should not free it yourself. ///
// /// /// The GUID is what connects a joystick to a gamepad mapping. A connected joystick will always have
// /// The GUID is what connects a joystick to a gamepad mapping. A connected /// a GUID even if there is no gamepad mapping assigned to it.
// /// joystick will always have a GUID even if there is no gamepad mapping ///
// /// assigned to it. /// If the specified joystick is not present this function will return null but will not generate an
// /// /// error. This can be used instead of first calling glfw.Joystick.present.
// /// If the specified joystick is not present this function will return null ///
// /// but will not generate an error. This can be used instead of first calling /// The GUID uses the format introduced in SDL 2.0.5. This GUID tries to uniquely identify the make
// /// @ref glfwJoystickPresent. /// and model of a joystick but does not identify a specific unit, e.g. all wired Xbox 360
// /// /// controllers will have the same GUID on that platform. The GUID for a unit may vary between
// /// The GUID uses the format introduced in SDL 2.0.5. This GUID tries to /// platforms depending on what hardware information the platform specific APIs provide.
// /// uniquely identify the make and model of a joystick but does not identify ///
// /// a specific unit, e.g. all wired Xbox 360 controllers will have the same /// @return The UTF-8 encoded GUID of the joystick, or null if the joystick is not present.
// /// GUID on that platform. The GUID for a unit may vary between platforms ///
// /// depending on what hardware information the platform specific APIs provide. /// Possible errors include glfw.Error.NotInitialized, glfw.Error.InvalidEnum and glfw.Error.PlatformError.
// /// ///
// /// @param[in] jid The [joystick](@ref joysticks) to query. /// @pointer_lifetime The returned string is allocated and freed by GLFW. You should not free it
// /// @return The UTF-8 encoded GUID of the joystick, or null if the joystick /// yourself. It is valid until the specified joystick is disconnected or the library is terminated.
// /// is not present or an error occurred. ///
// /// /// @thread_safety This function must only be called from the main thread.
// /// Possible errors include glfw.Error.NotInitialized, glfw.Error.InvalidEnum and glfw.Error.PlatformError. ///
// /// /// see also: gamepad
// /// @pointer_lifetime The returned string is allocated and freed by GLFW. You pub inline fn getGUID(self: Joystick) Error![*c]const u8 {
// /// should not free it yourself. It is valid until the specified joystick is const guid = c.glfwGetJoystickGUID(self.jid);
// /// disconnected or the library is terminated. try getError();
// /// return guid;
// /// @thread_safety This function must only be called from the main thread. }
// ///
// /// see also: gamepad
// ///
// ///
// /// @ingroup input
// GLFWAPI const char* glfwGetJoystickGUID(int jid);
/// Sets the user pointer of the specified joystick. /// Sets the user pointer of the specified joystick.
/// ///
@ -280,7 +274,6 @@ fn callbackWrapper(jid: c_int, event: c_int) callconv(.C) void {
_callback.?(Joystick{ .jid = jid }, @intCast(isize, event)); _callback.?(Joystick{ .jid = jid }, @intCast(isize, event));
} }
// TODO(joystick)
/// Sets the joystick configuration callback. /// Sets the joystick configuration callback.
/// ///
/// This function sets the joystick configuration callback, or removes the currently set callback. /// This function sets the joystick configuration callback, or removes the currently set callback.
@ -472,6 +465,16 @@ test "getName" {
_ = joystick.getName() catch |err| std.debug.print("failed to get joystick name, joysticks not supported? error={}\n", .{err}); _ = joystick.getName() catch |err| std.debug.print("failed to get joystick name, joysticks not supported? error={}\n", .{err});
} }
test "getGUID" {
const glfw = @import("main.zig");
try glfw.init();
defer glfw.terminate();
const joystick = glfw.Joystick{ .jid = glfw.Joystick.one };
_ = joystick.getGUID() catch |err| std.debug.print("failed to get joystick GUID, joysticks not supported? error={}\n", .{err});
}
test "setUserPointer_syntax" { test "setUserPointer_syntax" {
const glfw = @import("main.zig"); const glfw = @import("main.zig");
try glfw.init(); try glfw.init();