summaryrefslogtreecommitdiffstats
path: root/lib/imgui-1.90.7/backends/imgui_impl_osx.mm
diff options
context:
space:
mode:
authorgramanas <anastasis.gramm2@gmail.com>2024-06-05 19:04:25 +0300
committergramanas <anastasis.gramm2@gmail.com>2024-06-05 19:04:25 +0300
commita6501b5d7ad204c3b998c843c7ed68ef7be323ba (patch)
tree1a442e6095abf160e36baa31a319858774cd1178 /lib/imgui-1.90.7/backends/imgui_impl_osx.mm
parent6af7e785890a322f60c21a51e3d41cd9015e6773 (diff)
downloadcgame-a6501b5d7ad204c3b998c843c7ed68ef7be323ba.tar.gz
cgame-a6501b5d7ad204c3b998c843c7ed68ef7be323ba.tar.bz2
cgame-a6501b5d7ad204c3b998c843c7ed68ef7be323ba.zip
more vks, stupid mutlistep build, and imgui
Diffstat (limited to 'lib/imgui-1.90.7/backends/imgui_impl_osx.mm')
-rw-r--r--lib/imgui-1.90.7/backends/imgui_impl_osx.mm813
1 files changed, 813 insertions, 0 deletions
diff --git a/lib/imgui-1.90.7/backends/imgui_impl_osx.mm b/lib/imgui-1.90.7/backends/imgui_impl_osx.mm
new file mode 100644
index 0000000..3227980
--- /dev/null
+++ b/lib/imgui-1.90.7/backends/imgui_impl_osx.mm
@@ -0,0 +1,813 @@
+// dear imgui: Platform Backend for OSX / Cocoa
+// This needs to be used along with a Renderer (e.g. OpenGL2, OpenGL3, Vulkan, Metal..)
+// - Not well tested. If you want a portable application, prefer using the GLFW or SDL platform Backends on Mac.
+// - Requires linking with the GameController framework ("-framework GameController").
+
+// Implemented features:
+// [X] Platform: Mouse cursor shape and visibility. Disable with 'io.ConfigFlags |= ImGuiConfigFlags_NoMouseCursorChange'.
+// [X] Platform: Mouse support. Can discriminate Mouse/Pen.
+// [X] Platform: Keyboard support. Since 1.87 we are using the io.AddKeyEvent() function. Pass ImGuiKey values to all key functions e.g. ImGui::IsKeyPressed(ImGuiKey_Space). [Legacy kVK_* values will also be supported unless IMGUI_DISABLE_OBSOLETE_KEYIO is set]
+// [X] Platform: OSX clipboard is supported within core Dear ImGui (no specific code in this backend).
+// [X] Platform: Gamepad support. Enabled with 'io.ConfigFlags |= ImGuiConfigFlags_NavEnableGamepad'.
+// [X] Platform: IME support.
+
+// You can use unmodified imgui_impl_* files in your project. See examples/ folder for examples of using this.
+// Prefer including the entire imgui/ repository into your project (either as a copy or as a submodule), and only build the backends you need.
+// Learn about Dear ImGui:
+// - FAQ https://dearimgui.com/faq
+// - Getting Started https://dearimgui.com/getting-started
+// - Documentation https://dearimgui.com/docs (same as your local docs/ folder).
+// - Introduction, links and more at the top of imgui.cpp
+
+#import "imgui.h"
+#ifndef IMGUI_DISABLE
+#import "imgui_impl_osx.h"
+#import <Cocoa/Cocoa.h>
+#import <Carbon/Carbon.h>
+#import <GameController/GameController.h>
+#import <time.h>
+
+// CHANGELOG
+// (minor and older changes stripped away, please see git history for details)
+// 2023-10-05: Inputs: Added support for extra ImGuiKey values: F13 to F20 function keys. Stopped mapping F13 into PrintScreen.
+// 2023-04-09: Inputs: Added support for io.AddMouseSourceEvent() to discriminate ImGuiMouseSource_Mouse/ImGuiMouseSource_Pen.
+// 2023-02-01: Fixed scroll wheel scaling for devices emitting events with hasPreciseScrollingDeltas==false (e.g. non-Apple mices).
+// 2022-11-02: Fixed mouse coordinates before clicking the host window.
+// 2022-10-06: Fixed mouse inputs on flipped views.
+// 2022-09-26: Inputs: Renamed ImGuiKey_ModXXX introduced in 1.87 to ImGuiMod_XXX (old names still supported).
+// 2022-05-03: Inputs: Removed ImGui_ImplOSX_HandleEvent() from backend API in favor of backend automatically handling event capture.
+// 2022-04-27: Misc: Store backend data in a per-context struct, allowing to use this backend with multiple contexts.
+// 2022-03-22: Inputs: Monitor NSKeyUp events to catch missing keyUp for key when user press Cmd + key
+// 2022-02-07: Inputs: Forward keyDown/keyUp events to OS when unused by dear imgui.
+// 2022-01-31: Fixed building with old Xcode versions that are missing gamepad features.
+// 2022-01-26: Inputs: replaced short-lived io.AddKeyModsEvent() (added two weeks ago) with io.AddKeyEvent() using ImGuiKey_ModXXX flags. Sorry for the confusion.
+// 2021-01-20: Inputs: calling new io.AddKeyAnalogEvent() for gamepad support, instead of writing directly to io.NavInputs[].
+// 2022-01-17: Inputs: calling new io.AddMousePosEvent(), io.AddMouseButtonEvent(), io.AddMouseWheelEvent() API (1.87+).
+// 2022-01-12: Inputs: Added basic Platform IME support, hooking the io.SetPlatformImeDataFn() function.
+// 2022-01-10: Inputs: calling new io.AddKeyEvent(), io.AddKeyModsEvent() + io.SetKeyEventNativeData() API (1.87+). Support for full ImGuiKey range.
+// 2021-12-13: *BREAKING CHANGE* Add NSView parameter to ImGui_ImplOSX_Init(). Generally fix keyboard support. Using kVK_* codes for keyboard keys.
+// 2021-12-13: Add game controller support.
+// 2021-09-21: Use mach_absolute_time as CFAbsoluteTimeGetCurrent can jump backwards.
+// 2021-08-17: Calling io.AddFocusEvent() on NSApplicationDidBecomeActiveNotification/NSApplicationDidResignActiveNotification events.
+// 2021-06-23: Inputs: Added a fix for shortcuts using CTRL key instead of CMD key.
+// 2021-04-19: Inputs: Added a fix for keys remaining stuck in pressed state when CMD-tabbing into different application.
+// 2021-01-27: Inputs: Added a fix for mouse position not being reported when mouse buttons other than left one are down.
+// 2020-10-28: Inputs: Added a fix for handling keypad-enter key.
+// 2020-05-25: Inputs: Added a fix for missing trackpad clicks when done with "soft tap".
+// 2019-12-05: Inputs: Added support for ImGuiMouseCursor_NotAllowed mouse cursor.
+// 2019-10-11: Inputs: Fix using Backspace key.
+// 2019-07-21: Re-added clipboard handlers as they are not enabled by default in core imgui.cpp (reverted 2019-05-18 change).
+// 2019-05-28: Inputs: Added mouse cursor shape and visibility support.
+// 2019-05-18: Misc: Removed clipboard handlers as they are now supported by core imgui.cpp.
+// 2019-05-11: Inputs: Don't filter character values before calling AddInputCharacter() apart from 0xF700..0xFFFF range.
+// 2018-11-30: Misc: Setting up io.BackendPlatformName so it can be displayed in the About Window.
+// 2018-07-07: Initial version.
+
+#define APPLE_HAS_BUTTON_OPTIONS (__IPHONE_OS_VERSION_MIN_REQUIRED >= 130000 || __MAC_OS_X_VERSION_MIN_REQUIRED >= 101500 || __TV_OS_VERSION_MIN_REQUIRED >= 130000)
+#define APPLE_HAS_CONTROLLER (__IPHONE_OS_VERSION_MIN_REQUIRED >= 140000 || __MAC_OS_X_VERSION_MIN_REQUIRED >= 110000 || __TV_OS_VERSION_MIN_REQUIRED >= 140000)
+#define APPLE_HAS_THUMBSTICKS (__IPHONE_OS_VERSION_MIN_REQUIRED >= 120100 || __MAC_OS_X_VERSION_MIN_REQUIRED >= 101401 || __TV_OS_VERSION_MIN_REQUIRED >= 120100)
+
+@class ImGuiObserver;
+@class KeyEventResponder;
+
+// Data
+struct ImGui_ImplOSX_Data
+{
+ CFTimeInterval Time;
+ NSCursor* MouseCursors[ImGuiMouseCursor_COUNT];
+ bool MouseCursorHidden;
+ ImGuiObserver* Observer;
+ KeyEventResponder* KeyEventResponder;
+ NSTextInputContext* InputContext;
+ id Monitor;
+
+ ImGui_ImplOSX_Data() { memset(this, 0, sizeof(*this)); }
+};
+
+static ImGui_ImplOSX_Data* ImGui_ImplOSX_GetBackendData() { return (ImGui_ImplOSX_Data*)ImGui::GetIO().BackendPlatformUserData; }
+static void ImGui_ImplOSX_DestroyBackendData() { IM_DELETE(ImGui_ImplOSX_GetBackendData()); }
+
+static inline CFTimeInterval GetMachAbsoluteTimeInSeconds() { return (CFTimeInterval)(double)(clock_gettime_nsec_np(CLOCK_UPTIME_RAW) / 1e9); }
+
+// Forward Declarations
+static void ImGui_ImplOSX_AddTrackingArea(NSView* _Nonnull view);
+static bool ImGui_ImplOSX_HandleEvent(NSEvent* event, NSView* view);
+
+// Undocumented methods for creating cursors.
+@interface NSCursor()
++ (id)_windowResizeNorthWestSouthEastCursor;
++ (id)_windowResizeNorthEastSouthWestCursor;
++ (id)_windowResizeNorthSouthCursor;
++ (id)_windowResizeEastWestCursor;
+@end
+
+/**
+ KeyEventResponder implements the NSTextInputClient protocol as is required by the macOS text input manager.
+
+ The macOS text input manager is invoked by calling the interpretKeyEvents method from the keyDown method.
+ Keyboard events are then evaluated by the macOS input manager and valid text input is passed back via the
+ insertText:replacementRange method.
+
+ This is the same approach employed by other cross-platform libraries such as SDL2:
+ https://github.com/spurious/SDL-mirror/blob/e17aacbd09e65a4fd1e166621e011e581fb017a8/src/video/cocoa/SDL_cocoakeyboard.m#L53
+ and GLFW:
+ https://github.com/glfw/glfw/blob/b55a517ae0c7b5127dffa79a64f5406021bf9076/src/cocoa_window.m#L722-L723
+ */
+@interface KeyEventResponder: NSView<NSTextInputClient>
+@end
+
+@implementation KeyEventResponder
+{
+ float _posX;
+ float _posY;
+ NSRect _imeRect;
+}
+
+#pragma mark - Public
+
+- (void)setImePosX:(float)posX imePosY:(float)posY
+{
+ _posX = posX;
+ _posY = posY;
+}
+
+- (void)updateImePosWithView:(NSView *)view
+{
+ NSWindow *window = view.window;
+ if (!window)
+ return;
+ NSRect contentRect = [window contentRectForFrameRect:window.frame];
+ NSRect rect = NSMakeRect(_posX, contentRect.size.height - _posY, 0, 0);
+ _imeRect = [window convertRectToScreen:rect];
+}
+
+- (void)viewDidMoveToWindow
+{
+ // Ensure self is a first responder to receive the input events.
+ [self.window makeFirstResponder:self];
+}
+
+- (void)keyDown:(NSEvent*)event
+{
+ if (!ImGui_ImplOSX_HandleEvent(event, self))
+ [super keyDown:event];
+
+ // Call to the macOS input manager system.
+ [self interpretKeyEvents:@[event]];
+}
+
+- (void)keyUp:(NSEvent*)event
+{
+ if (!ImGui_ImplOSX_HandleEvent(event, self))
+ [super keyUp:event];
+}
+
+- (void)insertText:(id)aString replacementRange:(NSRange)replacementRange
+{
+ ImGuiIO& io = ImGui::GetIO();
+
+ NSString* characters;
+ if ([aString isKindOfClass:[NSAttributedString class]])
+ characters = [aString string];
+ else
+ characters = (NSString*)aString;
+
+ io.AddInputCharactersUTF8(characters.UTF8String);
+}
+
+- (BOOL)acceptsFirstResponder
+{
+ return YES;
+}
+
+- (void)doCommandBySelector:(SEL)myselector
+{
+}
+
+- (nullable NSAttributedString*)attributedSubstringForProposedRange:(NSRange)range actualRange:(nullable NSRangePointer)actualRange
+{
+ return nil;
+}
+
+- (NSUInteger)characterIndexForPoint:(NSPoint)point
+{
+ return 0;
+}
+
+- (NSRect)firstRectForCharacterRange:(NSRange)range actualRange:(nullable NSRangePointer)actualRange
+{
+ return _imeRect;
+}
+
+- (BOOL)hasMarkedText
+{
+ return NO;
+}
+
+- (NSRange)markedRange
+{
+ return NSMakeRange(NSNotFound, 0);
+}
+
+- (NSRange)selectedRange
+{
+ return NSMakeRange(NSNotFound, 0);
+}
+
+- (void)setMarkedText:(nonnull id)string selectedRange:(NSRange)selectedRange replacementRange:(NSRange)replacementRange
+{
+}
+
+- (void)unmarkText
+{
+}
+
+- (nonnull NSArray<NSAttributedStringKey>*)validAttributesForMarkedText
+{
+ return @[];
+}
+
+@end
+
+@interface ImGuiObserver : NSObject
+
+- (void)onApplicationBecomeActive:(NSNotification*)aNotification;
+- (void)onApplicationBecomeInactive:(NSNotification*)aNotification;
+
+@end
+
+@implementation ImGuiObserver
+
+- (void)onApplicationBecomeActive:(NSNotification*)aNotification
+{
+ ImGuiIO& io = ImGui::GetIO();
+ io.AddFocusEvent(true);
+}
+
+- (void)onApplicationBecomeInactive:(NSNotification*)aNotification
+{
+ ImGuiIO& io = ImGui::GetIO();
+ io.AddFocusEvent(false);
+}
+
+@end
+
+// Functions
+static ImGuiKey ImGui_ImplOSX_KeyCodeToImGuiKey(int key_code)
+{
+ switch (key_code)
+ {
+ case kVK_ANSI_A: return ImGuiKey_A;
+ case kVK_ANSI_S: return ImGuiKey_S;
+ case kVK_ANSI_D: return ImGuiKey_D;
+ case kVK_ANSI_F: return ImGuiKey_F;
+ case kVK_ANSI_H: return ImGuiKey_H;
+ case kVK_ANSI_G: return ImGuiKey_G;
+ case kVK_ANSI_Z: return ImGuiKey_Z;
+ case kVK_ANSI_X: return ImGuiKey_X;
+ case kVK_ANSI_C: return ImGuiKey_C;
+ case kVK_ANSI_V: return ImGuiKey_V;
+ case kVK_ANSI_B: return ImGuiKey_B;
+ case kVK_ANSI_Q: return ImGuiKey_Q;
+ case kVK_ANSI_W: return ImGuiKey_W;
+ case kVK_ANSI_E: return ImGuiKey_E;
+ case kVK_ANSI_R: return ImGuiKey_R;
+ case kVK_ANSI_Y: return ImGuiKey_Y;
+ case kVK_ANSI_T: return ImGuiKey_T;
+ case kVK_ANSI_1: return ImGuiKey_1;
+ case kVK_ANSI_2: return ImGuiKey_2;
+ case kVK_ANSI_3: return ImGuiKey_3;
+ case kVK_ANSI_4: return ImGuiKey_4;
+ case kVK_ANSI_6: return ImGuiKey_6;
+ case kVK_ANSI_5: return ImGuiKey_5;
+ case kVK_ANSI_Equal: return ImGuiKey_Equal;
+ case kVK_ANSI_9: return ImGuiKey_9;
+ case kVK_ANSI_7: return ImGuiKey_7;
+ case kVK_ANSI_Minus: return ImGuiKey_Minus;
+ case kVK_ANSI_8: return ImGuiKey_8;
+ case kVK_ANSI_0: return ImGuiKey_0;
+ case kVK_ANSI_RightBracket: return ImGuiKey_RightBracket;
+ case kVK_ANSI_O: return ImGuiKey_O;
+ case kVK_ANSI_U: return ImGuiKey_U;
+ case kVK_ANSI_LeftBracket: return ImGuiKey_LeftBracket;
+ case kVK_ANSI_I: return ImGuiKey_I;
+ case kVK_ANSI_P: return ImGuiKey_P;
+ case kVK_ANSI_L: return ImGuiKey_L;
+ case kVK_ANSI_J: return ImGuiKey_J;
+ case kVK_ANSI_Quote: return ImGuiKey_Apostrophe;
+ case kVK_ANSI_K: return ImGuiKey_K;
+ case kVK_ANSI_Semicolon: return ImGuiKey_Semicolon;
+ case kVK_ANSI_Backslash: return ImGuiKey_Backslash;
+ case kVK_ANSI_Comma: return ImGuiKey_Comma;
+ case kVK_ANSI_Slash: return ImGuiKey_Slash;
+ case kVK_ANSI_N: return ImGuiKey_N;
+ case kVK_ANSI_M: return ImGuiKey_M;
+ case kVK_ANSI_Period: return ImGuiKey_Period;
+ case kVK_ANSI_Grave: return ImGuiKey_GraveAccent;
+ case kVK_ANSI_KeypadDecimal: return ImGuiKey_KeypadDecimal;
+ case kVK_ANSI_KeypadMultiply: return ImGuiKey_KeypadMultiply;
+ case kVK_ANSI_KeypadPlus: return ImGuiKey_KeypadAdd;
+ case kVK_ANSI_KeypadClear: return ImGuiKey_NumLock;
+ case kVK_ANSI_KeypadDivide: return ImGuiKey_KeypadDivide;
+ case kVK_ANSI_KeypadEnter: return ImGuiKey_KeypadEnter;
+ case kVK_ANSI_KeypadMinus: return ImGuiKey_KeypadSubtract;
+ case kVK_ANSI_KeypadEquals: return ImGuiKey_KeypadEqual;
+ case kVK_ANSI_Keypad0: return ImGuiKey_Keypad0;
+ case kVK_ANSI_Keypad1: return ImGuiKey_Keypad1;
+ case kVK_ANSI_Keypad2: return ImGuiKey_Keypad2;
+ case kVK_ANSI_Keypad3: return ImGuiKey_Keypad3;
+ case kVK_ANSI_Keypad4: return ImGuiKey_Keypad4;
+ case kVK_ANSI_Keypad5: return ImGuiKey_Keypad5;
+ case kVK_ANSI_Keypad6: return ImGuiKey_Keypad6;
+ case kVK_ANSI_Keypad7: return ImGuiKey_Keypad7;
+ case kVK_ANSI_Keypad8: return ImGuiKey_Keypad8;
+ case kVK_ANSI_Keypad9: return ImGuiKey_Keypad9;
+ case kVK_Return: return ImGuiKey_Enter;
+ case kVK_Tab: return ImGuiKey_Tab;
+ case kVK_Space: return ImGuiKey_Space;
+ case kVK_Delete: return ImGuiKey_Backspace;
+ case kVK_Escape: return ImGuiKey_Escape;
+ case kVK_CapsLock: return ImGuiKey_CapsLock;
+ case kVK_Control: return ImGuiKey_LeftCtrl;
+ case kVK_Shift: return ImGuiKey_LeftShift;
+ case kVK_Option: return ImGuiKey_LeftAlt;
+ case kVK_Command: return ImGuiKey_LeftSuper;
+ case kVK_RightControl: return ImGuiKey_RightCtrl;
+ case kVK_RightShift: return ImGuiKey_RightShift;
+ case kVK_RightOption: return ImGuiKey_RightAlt;
+ case kVK_RightCommand: return ImGuiKey_RightSuper;
+// case kVK_Function: return ImGuiKey_;
+// case kVK_VolumeUp: return ImGuiKey_;
+// case kVK_VolumeDown: return ImGuiKey_;
+// case kVK_Mute: return ImGuiKey_;
+ case kVK_F1: return ImGuiKey_F1;
+ case kVK_F2: return ImGuiKey_F2;
+ case kVK_F3: return ImGuiKey_F3;
+ case kVK_F4: return ImGuiKey_F4;
+ case kVK_F5: return ImGuiKey_F5;
+ case kVK_F6: return ImGuiKey_F6;
+ case kVK_F7: return ImGuiKey_F7;
+ case kVK_F8: return ImGuiKey_F8;
+ case kVK_F9: return ImGuiKey_F9;
+ case kVK_F10: return ImGuiKey_F10;
+ case kVK_F11: return ImGuiKey_F11;
+ case kVK_F12: return ImGuiKey_F12;
+ case kVK_F13: return ImGuiKey_F13;
+ case kVK_F14: return ImGuiKey_F14;
+ case kVK_F15: return ImGuiKey_F15;
+ case kVK_F16: return ImGuiKey_F16;
+ case kVK_F17: return ImGuiKey_F17;
+ case kVK_F18: return ImGuiKey_F18;
+ case kVK_F19: return ImGuiKey_F19;
+ case kVK_F20: return ImGuiKey_F20;
+ case 0x6E: return ImGuiKey_Menu;
+ case kVK_Help: return ImGuiKey_Insert;
+ case kVK_Home: return ImGuiKey_Home;
+ case kVK_PageUp: return ImGuiKey_PageUp;
+ case kVK_ForwardDelete: return ImGuiKey_Delete;
+ case kVK_End: return ImGuiKey_End;
+ case kVK_PageDown: return ImGuiKey_PageDown;
+ case kVK_LeftArrow: return ImGuiKey_LeftArrow;
+ case kVK_RightArrow: return ImGuiKey_RightArrow;
+ case kVK_DownArrow: return ImGuiKey_DownArrow;
+ case kVK_UpArrow: return ImGuiKey_UpArrow;
+ default: return ImGuiKey_None;
+ }
+}
+
+#ifdef IMGUI_IMPL_METAL_CPP_EXTENSIONS
+
+IMGUI_IMPL_API bool ImGui_ImplOSX_Init(void* _Nonnull view) {
+ return ImGui_ImplOSX_Init((__bridge NSView*)(view));
+}
+
+IMGUI_IMPL_API void ImGui_ImplOSX_NewFrame(void* _Nullable view) {
+ return ImGui_ImplOSX_NewFrame((__bridge NSView*)(view));
+}
+
+#endif
+
+
+bool ImGui_ImplOSX_Init(NSView* view)
+{
+ ImGuiIO& io = ImGui::GetIO();
+ IMGUI_CHECKVERSION();
+ IM_ASSERT(io.BackendPlatformUserData == nullptr && "Already initialized a platform backend!");
+
+ // Setup backend capabilities flags
+ ImGui_ImplOSX_Data* bd = IM_NEW(ImGui_ImplOSX_Data)();
+ io.BackendPlatformUserData = (void*)bd;
+ io.BackendPlatformName = "imgui_impl_osx";
+ io.BackendFlags |= ImGuiBackendFlags_HasMouseCursors; // We can honor GetMouseCursor() values (optional)
+ //io.BackendFlags |= ImGuiBackendFlags_HasSetMousePos; // We can honor io.WantSetMousePos requests (optional, rarely used)
+
+ bd->Observer = [ImGuiObserver new];
+
+ // Load cursors. Some of them are undocumented.
+ bd->MouseCursorHidden = false;
+ bd->MouseCursors[ImGuiMouseCursor_Arrow] = [NSCursor arrowCursor];
+ bd->MouseCursors[ImGuiMouseCursor_TextInput] = [NSCursor IBeamCursor];
+ bd->MouseCursors[ImGuiMouseCursor_ResizeAll] = [NSCursor closedHandCursor];
+ bd->MouseCursors[ImGuiMouseCursor_Hand] = [NSCursor pointingHandCursor];
+ bd->MouseCursors[ImGuiMouseCursor_NotAllowed] = [NSCursor operationNotAllowedCursor];
+ bd->MouseCursors[ImGuiMouseCursor_ResizeNS] = [NSCursor respondsToSelector:@selector(_windowResizeNorthSouthCursor)] ? [NSCursor _windowResizeNorthSouthCursor] : [NSCursor resizeUpDownCursor];
+ bd->MouseCursors[ImGuiMouseCursor_ResizeEW] = [NSCursor respondsToSelector:@selector(_windowResizeEastWestCursor)] ? [NSCursor _windowResizeEastWestCursor] : [NSCursor resizeLeftRightCursor];
+ bd->MouseCursors[ImGuiMouseCursor_ResizeNESW] = [NSCursor respondsToSelector:@selector(_windowResizeNorthEastSouthWestCursor)] ? [NSCursor _windowResizeNorthEastSouthWestCursor] : [NSCursor closedHandCursor];
+ bd->MouseCursors[ImGuiMouseCursor_ResizeNWSE] = [NSCursor respondsToSelector:@selector(_windowResizeNorthWestSouthEastCursor)] ? [NSCursor _windowResizeNorthWestSouthEastCursor] : [NSCursor closedHandCursor];
+
+ // Note that imgui.cpp also include default OSX clipboard handlers which can be enabled
+ // by adding '#define IMGUI_ENABLE_OSX_DEFAULT_CLIPBOARD_FUNCTIONS' in imconfig.h and adding '-framework ApplicationServices' to your linker command-line.
+ // Since we are already in ObjC land here, it is easy for us to add a clipboard handler using the NSPasteboard api.
+ io.SetClipboardTextFn = [](void*, const char* str) -> void
+ {
+ NSPasteboard* pasteboard = [NSPasteboard generalPasteboard];
+ [pasteboard declareTypes:[NSArray arrayWithObject:NSPasteboardTypeString] owner:nil];
+ [pasteboard setString:[NSString stringWithUTF8String:str] forType:NSPasteboardTypeString];
+ };
+
+ io.GetClipboardTextFn = [](void*) -> const char*
+ {
+ NSPasteboard* pasteboard = [NSPasteboard generalPasteboard];
+ NSString* available = [pasteboard availableTypeFromArray: [NSArray arrayWithObject:NSPasteboardTypeString]];
+ if (![available isEqualToString:NSPasteboardTypeString])
+ return nullptr;
+
+ NSString* string = [pasteboard stringForType:NSPasteboardTypeString];
+ if (string == nil)
+ return nullptr;
+
+ const char* string_c = (const char*)[string UTF8String];
+ size_t string_len = strlen(string_c);
+ static ImVector<char> s_clipboard;
+ s_clipboard.resize((int)string_len + 1);
+ strcpy(s_clipboard.Data, string_c);
+ return s_clipboard.Data;
+ };
+
+ [[NSNotificationCenter defaultCenter] addObserver:bd->Observer
+ selector:@selector(onApplicationBecomeActive:)
+ name:NSApplicationDidBecomeActiveNotification
+ object:nil];
+ [[NSNotificationCenter defaultCenter] addObserver:bd->Observer
+ selector:@selector(onApplicationBecomeInactive:)
+ name:NSApplicationDidResignActiveNotification
+ object:nil];
+
+ // Add the NSTextInputClient to the view hierarchy,
+ // to receive keyboard events and translate them to input text.
+ bd->KeyEventResponder = [[KeyEventResponder alloc] initWithFrame:NSZeroRect];
+ bd->InputContext = [[NSTextInputContext alloc] initWithClient:bd->KeyEventResponder];
+ [view addSubview:bd->KeyEventResponder];
+ ImGui_ImplOSX_AddTrackingArea(view);
+
+ io.SetPlatformImeDataFn = [](ImGuiViewport* viewport, ImGuiPlatformImeData* data) -> void
+ {
+ ImGui_ImplOSX_Data* bd = ImGui_ImplOSX_GetBackendData();
+ if (data->WantVisible)
+ {
+ [bd->InputContext activate];
+ }
+ else
+ {
+ [bd->InputContext discardMarkedText];
+ [bd->InputContext invalidateCharacterCoordinates];
+ [bd->InputContext deactivate];
+ }
+ [bd->KeyEventResponder setImePosX:data->InputPos.x imePosY:data->InputPos.y + data->InputLineHeight];
+ };
+
+ return true;
+}
+
+void ImGui_ImplOSX_Shutdown()
+{
+ ImGui_ImplOSX_Data* bd = ImGui_ImplOSX_GetBackendData();
+ IM_ASSERT(bd != nullptr && "No platform backend to shutdown, or already shutdown?");
+
+ bd->Observer = nullptr;
+ if (bd->Monitor != nullptr)
+ {
+ [NSEvent removeMonitor:bd->Monitor];
+ bd->Monitor = nullptr;
+ }
+
+ ImGui_ImplOSX_DestroyBackendData();
+
+ ImGuiIO& io = ImGui::GetIO();
+ io.BackendPlatformName = nullptr;
+ io.BackendPlatformUserData = nullptr;
+ io.BackendFlags &= ~(ImGuiBackendFlags_HasMouseCursors | ImGuiBackendFlags_HasGamepad);
+}
+
+static void ImGui_ImplOSX_UpdateMouseCursor()
+{
+ ImGui_ImplOSX_Data* bd = ImGui_ImplOSX_GetBackendData();
+ ImGuiIO& io = ImGui::GetIO();
+ if (io.ConfigFlags & ImGuiConfigFlags_NoMouseCursorChange)
+ return;
+
+ ImGuiMouseCursor imgui_cursor = ImGui::GetMouseCursor();
+ if (io.MouseDrawCursor || imgui_cursor == ImGuiMouseCursor_None)
+ {
+ // Hide OS mouse cursor if imgui is drawing it or if it wants no cursor
+ if (!bd->MouseCursorHidden)
+ {
+ bd->MouseCursorHidden = true;
+ [NSCursor hide];
+ }
+ }
+ else
+ {
+ NSCursor* desired = bd->MouseCursors[imgui_cursor] ?: bd->MouseCursors[ImGuiMouseCursor_Arrow];
+ // -[NSCursor set] generates measureable overhead if called unconditionally.
+ if (desired != NSCursor.currentCursor)
+ {
+ [desired set];
+ }
+ if (bd->MouseCursorHidden)
+ {
+ bd->MouseCursorHidden = false;
+ [NSCursor unhide];
+ }
+ }
+}
+
+static void ImGui_ImplOSX_UpdateGamepads()
+{
+ ImGuiIO& io = ImGui::GetIO();
+ if ((io.ConfigFlags & ImGuiConfigFlags_NavEnableGamepad) == 0) // FIXME: Technically feeding gamepad shouldn't depend on this now that they are regular inputs.
+ return;
+
+#if APPLE_HAS_CONTROLLER
+ GCController* controller = GCController.current;
+#else
+ GCController* controller = GCController.controllers.firstObject;
+#endif
+ if (controller == nil || controller.extendedGamepad == nil)
+ {
+ io.BackendFlags &= ~ImGuiBackendFlags_HasGamepad;
+ return;
+ }
+
+ GCExtendedGamepad* gp = controller.extendedGamepad;
+
+ // Update gamepad inputs
+ #define IM_SATURATE(V) (V < 0.0f ? 0.0f : V > 1.0f ? 1.0f : V)
+ #define MAP_BUTTON(KEY_NO, BUTTON_NAME) { io.AddKeyEvent(KEY_NO, gp.BUTTON_NAME.isPressed); }
+ #define MAP_ANALOG(KEY_NO, AXIS_NAME, V0, V1) { float vn = (float)(gp.AXIS_NAME.value - V0) / (float)(V1 - V0); vn = IM_SATURATE(vn); io.AddKeyAnalogEvent(KEY_NO, vn > 0.1f, vn); }
+ const float thumb_dead_zone = 0.0f;
+
+#if APPLE_HAS_BUTTON_OPTIONS
+ MAP_BUTTON(ImGuiKey_GamepadBack, buttonOptions);
+#endif
+ MAP_BUTTON(ImGuiKey_GamepadFaceLeft, buttonX); // Xbox X, PS Square
+ MAP_BUTTON(ImGuiKey_GamepadFaceRight, buttonB); // Xbox B, PS Circle
+ MAP_BUTTON(ImGuiKey_GamepadFaceUp, buttonY); // Xbox Y, PS Triangle
+ MAP_BUTTON(ImGuiKey_GamepadFaceDown, buttonA); // Xbox A, PS Cross
+ MAP_BUTTON(ImGuiKey_GamepadDpadLeft, dpad.left);
+ MAP_BUTTON(ImGuiKey_GamepadDpadRight, dpad.right);
+ MAP_BUTTON(ImGuiKey_GamepadDpadUp, dpad.up);
+ MAP_BUTTON(ImGuiKey_GamepadDpadDown, dpad.down);
+ MAP_ANALOG(ImGuiKey_GamepadL1, leftShoulder, 0.0f, 1.0f);
+ MAP_ANALOG(ImGuiKey_GamepadR1, rightShoulder, 0.0f, 1.0f);
+ MAP_ANALOG(ImGuiKey_GamepadL2, leftTrigger, 0.0f, 1.0f);
+ MAP_ANALOG(ImGuiKey_GamepadR2, rightTrigger, 0.0f, 1.0f);
+#if APPLE_HAS_THUMBSTICKS
+ MAP_BUTTON(ImGuiKey_GamepadL3, leftThumbstickButton);
+ MAP_BUTTON(ImGuiKey_GamepadR3, rightThumbstickButton);
+#endif
+ MAP_ANALOG(ImGuiKey_GamepadLStickLeft, leftThumbstick.xAxis, -thumb_dead_zone, -1.0f);
+ MAP_ANALOG(ImGuiKey_GamepadLStickRight, leftThumbstick.xAxis, +thumb_dead_zone, +1.0f);
+ MAP_ANALOG(ImGuiKey_GamepadLStickUp, leftThumbstick.yAxis, +thumb_dead_zone, +1.0f);
+ MAP_ANALOG(ImGuiKey_GamepadLStickDown, leftThumbstick.yAxis, -thumb_dead_zone, -1.0f);
+ MAP_ANALOG(ImGuiKey_GamepadRStickLeft, rightThumbstick.xAxis, -thumb_dead_zone, -1.0f);
+ MAP_ANALOG(ImGuiKey_GamepadRStickRight, rightThumbstick.xAxis, +thumb_dead_zone, +1.0f);
+ MAP_ANALOG(ImGuiKey_GamepadRStickUp, rightThumbstick.yAxis, +thumb_dead_zone, +1.0f);
+ MAP_ANALOG(ImGuiKey_GamepadRStickDown, rightThumbstick.yAxis, -thumb_dead_zone, -1.0f);
+ #undef MAP_BUTTON
+ #undef MAP_ANALOG
+
+ io.BackendFlags |= ImGuiBackendFlags_HasGamepad;
+}
+
+static void ImGui_ImplOSX_UpdateImePosWithView(NSView* view)
+{
+ ImGui_ImplOSX_Data* bd = ImGui_ImplOSX_GetBackendData();
+ ImGuiIO& io = ImGui::GetIO();
+ if (io.WantTextInput)
+ [bd->KeyEventResponder updateImePosWithView:view];
+}
+
+void ImGui_ImplOSX_NewFrame(NSView* view)
+{
+ ImGui_ImplOSX_Data* bd = ImGui_ImplOSX_GetBackendData();
+ IM_ASSERT(bd != nullptr && "Context or backend not initialized! Did you call ImGui_ImplOSX_Init()?");
+ ImGuiIO& io = ImGui::GetIO();
+
+ // Setup display size
+ if (view)
+ {
+ const float dpi = (float)[view.window backingScaleFactor];
+ io.DisplaySize = ImVec2((float)view.bounds.size.width, (float)view.bounds.size.height);
+ io.DisplayFramebufferScale = ImVec2(dpi, dpi);
+ }
+
+ // Setup time step
+ if (bd->Time == 0.0)
+ bd->Time = GetMachAbsoluteTimeInSeconds();
+
+ double current_time = GetMachAbsoluteTimeInSeconds();
+ io.DeltaTime = (float)(current_time - bd->Time);
+ bd->Time = current_time;
+
+ ImGui_ImplOSX_UpdateMouseCursor();
+ ImGui_ImplOSX_UpdateGamepads();
+ ImGui_ImplOSX_UpdateImePosWithView(view);
+}
+
+// Must only be called for a mouse event, otherwise an exception occurs
+// (Note that NSEventTypeScrollWheel is considered "other input". Oddly enough an exception does not occur with it, but the value will sometimes be wrong!)
+static ImGuiMouseSource GetMouseSource(NSEvent* event)
+{
+ switch (event.subtype)
+ {
+ case NSEventSubtypeTabletPoint:
+ return ImGuiMouseSource_Pen;
+ // macOS considers input from relative touch devices (like the trackpad or Apple Magic Mouse) to be touch input.
+ // This doesn't really make sense for Dear ImGui, which expects absolute touch devices only.
+ // There does not seem to be a simple way to disambiguate things here so we consider NSEventSubtypeTouch events to always come from mice.
+ // See https://developer.apple.com/library/archive/documentation/Cocoa/Conceptual/EventOverview/HandlingTouchEvents/HandlingTouchEvents.html#//apple_ref/doc/uid/10000060i-CH13-SW24
+ //case NSEventSubtypeTouch:
+ // return ImGuiMouseSource_TouchScreen;
+ case NSEventSubtypeMouseEvent:
+ default:
+ return ImGuiMouseSource_Mouse;
+ }
+}
+
+static bool ImGui_ImplOSX_HandleEvent(NSEvent* event, NSView* view)
+{
+ ImGuiIO& io = ImGui::GetIO();
+
+ if (event.type == NSEventTypeLeftMouseDown || event.type == NSEventTypeRightMouseDown || event.type == NSEventTypeOtherMouseDown)
+ {
+ int button = (int)[event buttonNumber];
+ if (button >= 0 && button < ImGuiMouseButton_COUNT)
+ {
+ io.AddMouseSourceEvent(GetMouseSource(event));
+ io.AddMouseButtonEvent(button, true);
+ }
+ return io.WantCaptureMouse;
+ }
+
+ if (event.type == NSEventTypeLeftMouseUp || event.type == NSEventTypeRightMouseUp || event.type == NSEventTypeOtherMouseUp)
+ {
+ int button = (int)[event buttonNumber];
+ if (button >= 0 && button < ImGuiMouseButton_COUNT)
+ {
+ io.AddMouseSourceEvent(GetMouseSource(event));
+ io.AddMouseButtonEvent(button, false);
+ }
+ return io.WantCaptureMouse;
+ }
+
+ if (event.type == NSEventTypeMouseMoved || event.type == NSEventTypeLeftMouseDragged || event.type == NSEventTypeRightMouseDragged || event.type == NSEventTypeOtherMouseDragged)
+ {
+ NSPoint mousePoint = event.locationInWindow;
+ if (event.window == nil)
+ mousePoint = [[view window] convertPointFromScreen:mousePoint];
+ mousePoint = [view convertPoint:mousePoint fromView:nil];
+ if ([view isFlipped])
+ mousePoint = NSMakePoint(mousePoint.x, mousePoint.y);
+ else
+ mousePoint = NSMakePoint(mousePoint.x, view.bounds.size.height - mousePoint.y);
+ io.AddMouseSourceEvent(GetMouseSource(event));
+ io.AddMousePosEvent((float)mousePoint.x, (float)mousePoint.y);
+ return io.WantCaptureMouse;
+ }
+
+ if (event.type == NSEventTypeScrollWheel)
+ {
+ // Ignore canceled events.
+ //
+ // From macOS 12.1, scrolling with two fingers and then decelerating
+ // by tapping two fingers results in two events appearing:
+ //
+ // 1. A scroll wheel NSEvent, with a phase == NSEventPhaseMayBegin, when the user taps
+ // two fingers to decelerate or stop the scroll events.
+ //
+ // 2. A scroll wheel NSEvent, with a phase == NSEventPhaseCancelled, when the user releases the
+ // two-finger tap. It is this event that sometimes contains large values for scrollingDeltaX and
+ // scrollingDeltaY. When these are added to the current x and y positions of the scrolling view,
+ // it appears to jump up or down. It can be observed in Preview, various JetBrains IDEs and here.
+ if (event.phase == NSEventPhaseCancelled)
+ return false;
+
+ double wheel_dx = 0.0;
+ double wheel_dy = 0.0;
+
+ #if MAC_OS_X_VERSION_MAX_ALLOWED >= 1070
+ if (floor(NSAppKitVersionNumber) > NSAppKitVersionNumber10_6)
+ {
+ wheel_dx = [event scrollingDeltaX];
+ wheel_dy = [event scrollingDeltaY];
+ if ([event hasPreciseScrollingDeltas])
+ {
+ wheel_dx *= 0.01;
+ wheel_dy *= 0.01;
+ }
+ }
+ else
+ #endif // MAC_OS_X_VERSION_MAX_ALLOWED
+ {
+ wheel_dx = [event deltaX] * 0.1;
+ wheel_dy = [event deltaY] * 0.1;
+ }
+ if (wheel_dx != 0.0 || wheel_dy != 0.0)
+ io.AddMouseWheelEvent((float)wheel_dx, (float)wheel_dy);
+
+ return io.WantCaptureMouse;
+ }
+
+ if (event.type == NSEventTypeKeyDown || event.type == NSEventTypeKeyUp)
+ {
+ if ([event isARepeat])
+ return io.WantCaptureKeyboard;
+
+ int key_code = (int)[event keyCode];
+ ImGuiKey key = ImGui_ImplOSX_KeyCodeToImGuiKey(key_code);
+ io.AddKeyEvent(key, event.type == NSEventTypeKeyDown);
+ io.SetKeyEventNativeData(key, key_code, -1); // To support legacy indexing (<1.87 user code)
+
+ return io.WantCaptureKeyboard;
+ }
+
+ if (event.type == NSEventTypeFlagsChanged)
+ {
+ unsigned short key_code = [event keyCode];
+ NSEventModifierFlags modifier_flags = [event modifierFlags];
+
+ io.AddKeyEvent(ImGuiMod_Shift, (modifier_flags & NSEventModifierFlagShift) != 0);
+ io.AddKeyEvent(ImGuiMod_Ctrl, (modifier_flags & NSEventModifierFlagControl) != 0);
+ io.AddKeyEvent(ImGuiMod_Alt, (modifier_flags & NSEventModifierFlagOption) != 0);
+ io.AddKeyEvent(ImGuiMod_Super, (modifier_flags & NSEventModifierFlagCommand) != 0);
+
+ ImGuiKey key = ImGui_ImplOSX_KeyCodeToImGuiKey(key_code);
+ if (key != ImGuiKey_None)
+ {
+ // macOS does not generate down/up event for modifiers. We're trying
+ // to use hardware dependent masks to extract that information.
+ // 'imgui_mask' is left as a fallback.
+ NSEventModifierFlags mask = 0;
+ switch (key)
+ {
+ case ImGuiKey_LeftCtrl: mask = 0x0001; break;
+ case ImGuiKey_RightCtrl: mask = 0x2000; break;
+ case ImGuiKey_LeftShift: mask = 0x0002; break;
+ case ImGuiKey_RightShift: mask = 0x0004; break;
+ case ImGuiKey_LeftSuper: mask = 0x0008; break;
+ case ImGuiKey_RightSuper: mask = 0x0010; break;
+ case ImGuiKey_LeftAlt: mask = 0x0020; break;
+ case ImGuiKey_RightAlt: mask = 0x0040; break;
+ default:
+ return io.WantCaptureKeyboard;
+ }
+
+ NSEventModifierFlags modifier_flags = [event modifierFlags];
+ io.AddKeyEvent(key, (modifier_flags & mask) != 0);
+ io.SetKeyEventNativeData(key, key_code, -1); // To support legacy indexing (<1.87 user code)
+ }
+
+ return io.WantCaptureKeyboard;
+ }
+
+ return false;
+}
+
+static void ImGui_ImplOSX_AddTrackingArea(NSView* _Nonnull view)
+{
+ // If we want to receive key events, we either need to be in the responder chain of the key view,
+ // or else we can install a local monitor. The consequence of this heavy-handed approach is that
+ // we receive events for all controls, not just Dear ImGui widgets. If we had native controls in our
+ // window, we'd want to be much more careful than just ingesting the complete event stream.
+ // To match the behavior of other backends, we pass every event down to the OS.
+ ImGui_ImplOSX_Data* bd = ImGui_ImplOSX_GetBackendData();
+ if (bd->Monitor)
+ return;
+ NSEventMask eventMask = 0;
+ eventMask |= NSEventMaskMouseMoved | NSEventMaskScrollWheel;
+ eventMask |= NSEventMaskLeftMouseDown | NSEventMaskLeftMouseUp | NSEventMaskLeftMouseDragged;
+ eventMask |= NSEventMaskRightMouseDown | NSEventMaskRightMouseUp | NSEventMaskRightMouseDragged;
+ eventMask |= NSEventMaskOtherMouseDown | NSEventMaskOtherMouseUp | NSEventMaskOtherMouseDragged;
+ eventMask |= NSEventMaskKeyDown | NSEventMaskKeyUp | NSEventMaskFlagsChanged;
+ bd->Monitor = [NSEvent addLocalMonitorForEventsMatchingMask:eventMask
+ handler:^NSEvent* _Nullable(NSEvent* event)
+ {
+ ImGui_ImplOSX_HandleEvent(event, view);
+ return event;
+ }];
+}
+
+//-----------------------------------------------------------------------------
+
+#endif // #ifndef IMGUI_DISABLE