SDL  2.0
SDL_cocoavideo.m
Go to the documentation of this file.
1 /*
2  Simple DirectMedia Layer
3  Copyright (C) 1997-2020 Sam Lantinga <slouken@libsdl.org>
4 
5  This software is provided 'as-is', without any express or implied
6  warranty. In no event will the authors be held liable for any damages
7  arising from the use of this software.
8 
9  Permission is granted to anyone to use this software for any purpose,
10  including commercial applications, and to alter it and redistribute it
11  freely, subject to the following restrictions:
12 
13  1. The origin of this software must not be misrepresented; you must not
14  claim that you wrote the original software. If you use this software
15  in a product, an acknowledgment in the product documentation would be
16  appreciated but is not required.
17  2. Altered source versions must be plainly marked as such, and must not be
18  misrepresented as being the original software.
19  3. This notice may not be removed or altered from any source distribution.
20 */
21 #include "../../SDL_internal.h"
22 
23 #if SDL_VIDEO_DRIVER_COCOA
24 
25 #include "SDL.h"
26 #include "SDL_endian.h"
27 #include "SDL_cocoavideo.h"
28 #include "SDL_cocoashape.h"
29 #include "SDL_cocoavulkan.h"
30 #include "SDL_cocoametalview.h"
31 
32 /* Initialization/Query functions */
33 static int Cocoa_VideoInit(_THIS);
34 static void Cocoa_VideoQuit(_THIS);
35 
36 /* Cocoa driver bootstrap functions */
37 
38 static void
39 Cocoa_DeleteDevice(SDL_VideoDevice * device)
40 {
41  SDL_free(device->driverdata);
43 }
44 
45 static SDL_VideoDevice *
46 Cocoa_CreateDevice(int devindex)
47 {
50 
52 
53  /* Initialize all variables that we clean on shutdown */
55  if (device) {
56  data = (struct SDL_VideoData *) SDL_calloc(1, sizeof(SDL_VideoData));
57  } else {
58  data = NULL;
59  }
60  if (!data) {
63  return NULL;
64  }
65  device->driverdata = data;
66 
67  /* Set the function pointers */
68  device->VideoInit = Cocoa_VideoInit;
69  device->VideoQuit = Cocoa_VideoQuit;
70  device->GetDisplayBounds = Cocoa_GetDisplayBounds;
71  device->GetDisplayUsableBounds = Cocoa_GetDisplayUsableBounds;
72  device->GetDisplayDPI = Cocoa_GetDisplayDPI;
73  device->GetDisplayModes = Cocoa_GetDisplayModes;
74  device->SetDisplayMode = Cocoa_SetDisplayMode;
75  device->PumpEvents = Cocoa_PumpEvents;
76  device->SuspendScreenSaver = Cocoa_SuspendScreenSaver;
77 
78  device->CreateSDLWindow = Cocoa_CreateWindow;
79  device->CreateSDLWindowFrom = Cocoa_CreateWindowFrom;
80  device->SetWindowTitle = Cocoa_SetWindowTitle;
81  device->SetWindowIcon = Cocoa_SetWindowIcon;
82  device->SetWindowPosition = Cocoa_SetWindowPosition;
83  device->SetWindowSize = Cocoa_SetWindowSize;
84  device->SetWindowMinimumSize = Cocoa_SetWindowMinimumSize;
85  device->SetWindowMaximumSize = Cocoa_SetWindowMaximumSize;
86  device->SetWindowOpacity = Cocoa_SetWindowOpacity;
87  device->ShowWindow = Cocoa_ShowWindow;
88  device->HideWindow = Cocoa_HideWindow;
89  device->RaiseWindow = Cocoa_RaiseWindow;
90  device->MaximizeWindow = Cocoa_MaximizeWindow;
91  device->MinimizeWindow = Cocoa_MinimizeWindow;
92  device->RestoreWindow = Cocoa_RestoreWindow;
93  device->SetWindowBordered = Cocoa_SetWindowBordered;
94  device->SetWindowResizable = Cocoa_SetWindowResizable;
95  device->SetWindowFullscreen = Cocoa_SetWindowFullscreen;
96  device->SetWindowGammaRamp = Cocoa_SetWindowGammaRamp;
97  device->GetWindowGammaRamp = Cocoa_GetWindowGammaRamp;
98  device->SetWindowGrab = Cocoa_SetWindowGrab;
99  device->DestroyWindow = Cocoa_DestroyWindow;
100  device->GetWindowWMInfo = Cocoa_GetWindowWMInfo;
101  device->SetWindowHitTest = Cocoa_SetWindowHitTest;
102  device->AcceptDragAndDrop = Cocoa_AcceptDragAndDrop;
103 
104  device->shape_driver.CreateShaper = Cocoa_CreateShaper;
105  device->shape_driver.SetWindowShape = Cocoa_SetWindowShape;
106  device->shape_driver.ResizeWindowShape = Cocoa_ResizeWindowShape;
107 
108 #if SDL_VIDEO_OPENGL_CGL
109  device->GL_LoadLibrary = Cocoa_GL_LoadLibrary;
110  device->GL_GetProcAddress = Cocoa_GL_GetProcAddress;
111  device->GL_UnloadLibrary = Cocoa_GL_UnloadLibrary;
112  device->GL_CreateContext = Cocoa_GL_CreateContext;
113  device->GL_MakeCurrent = Cocoa_GL_MakeCurrent;
114  device->GL_GetDrawableSize = Cocoa_GL_GetDrawableSize;
115  device->GL_SetSwapInterval = Cocoa_GL_SetSwapInterval;
116  device->GL_GetSwapInterval = Cocoa_GL_GetSwapInterval;
117  device->GL_SwapWindow = Cocoa_GL_SwapWindow;
118  device->GL_DeleteContext = Cocoa_GL_DeleteContext;
119 #elif SDL_VIDEO_OPENGL_EGL
120  device->GL_LoadLibrary = Cocoa_GLES_LoadLibrary;
121  device->GL_GetProcAddress = Cocoa_GLES_GetProcAddress;
122  device->GL_UnloadLibrary = Cocoa_GLES_UnloadLibrary;
123  device->GL_CreateContext = Cocoa_GLES_CreateContext;
124  device->GL_MakeCurrent = Cocoa_GLES_MakeCurrent;
125  device->GL_SetSwapInterval = Cocoa_GLES_SetSwapInterval;
126  device->GL_GetSwapInterval = Cocoa_GLES_GetSwapInterval;
127  device->GL_SwapWindow = Cocoa_GLES_SwapWindow;
128  device->GL_DeleteContext = Cocoa_GLES_DeleteContext;
129 #endif
130 
131 #if SDL_VIDEO_VULKAN
132  device->Vulkan_LoadLibrary = Cocoa_Vulkan_LoadLibrary;
133  device->Vulkan_UnloadLibrary = Cocoa_Vulkan_UnloadLibrary;
134  device->Vulkan_GetInstanceExtensions = Cocoa_Vulkan_GetInstanceExtensions;
135  device->Vulkan_CreateSurface = Cocoa_Vulkan_CreateSurface;
136  device->Vulkan_GetDrawableSize = Cocoa_Vulkan_GetDrawableSize;
137 #endif
138 
139 #if SDL_VIDEO_METAL
140  device->Metal_CreateView = Cocoa_Metal_CreateView;
141  device->Metal_DestroyView = Cocoa_Metal_DestroyView;
142  device->Metal_GetLayer = Cocoa_Metal_GetLayer;
143  device->Metal_GetDrawableSize = Cocoa_Metal_GetDrawableSize;
144 #endif
145 
146  device->StartTextInput = Cocoa_StartTextInput;
147  device->StopTextInput = Cocoa_StopTextInput;
148  device->SetTextInputRect = Cocoa_SetTextInputRect;
149 
150  device->SetClipboardText = Cocoa_SetClipboardText;
151  device->GetClipboardText = Cocoa_GetClipboardText;
152  device->HasClipboardText = Cocoa_HasClipboardText;
153 
154  device->free = Cocoa_DeleteDevice;
155 
156  return device;
157 }
158 
160  "cocoa", "SDL Cocoa video driver",
161  Cocoa_CreateDevice
162 };
163 
164 
165 int
166 Cocoa_VideoInit(_THIS)
167 {
169 
172  if (Cocoa_InitMouse(_this) < 0) {
173  return -1;
174  }
175 
176  data->allow_spaces = ((floor(NSAppKitVersionNumber) > NSAppKitVersionNumber10_6) && SDL_GetHintBoolean(SDL_HINT_VIDEO_MAC_FULLSCREEN_SPACES, SDL_TRUE));
177 
178  /* The IOPM assertion API can disable the screensaver as of 10.7. */
179  data->screensaver_use_iopm = floor(NSAppKitVersionNumber) > NSAppKitVersionNumber10_6;
180 
181  data->swaplock = SDL_CreateMutex();
182  if (!data->swaplock) {
183  return -1;
184  }
185 
186  return 0;
187 }
188 
189 void
190 Cocoa_VideoQuit(_THIS)
191 {
196  SDL_DestroyMutex(data->swaplock);
197  data->swaplock = NULL;
198 }
199 
200 /* This function assumes that it's called from within an autorelease pool */
201 NSImage *
203 {
204  SDL_Surface *converted;
205  NSBitmapImageRep *imgrep;
206  Uint8 *pixels;
207  int i;
208  NSImage *img;
209 
211  if (!converted) {
212  return nil;
213  }
214 
215  imgrep = [[[NSBitmapImageRep alloc] initWithBitmapDataPlanes: NULL
216  pixelsWide: converted->w
217  pixelsHigh: converted->h
218  bitsPerSample: 8
219  samplesPerPixel: 4
220  hasAlpha: YES
221  isPlanar: NO
222  colorSpaceName: NSDeviceRGBColorSpace
223  bytesPerRow: converted->pitch
224  bitsPerPixel: converted->format->BitsPerPixel] autorelease];
225  if (imgrep == nil) {
226  SDL_FreeSurface(converted);
227  return nil;
228  }
229 
230  /* Copy the pixels */
231  pixels = [imgrep bitmapData];
232  SDL_memcpy(pixels, converted->pixels, converted->h * converted->pitch);
233  SDL_FreeSurface(converted);
234 
235  /* Premultiply the alpha channel */
236  for (i = (surface->h * surface->w); i--; ) {
237  Uint8 alpha = pixels[3];
238  pixels[0] = (Uint8)(((Uint16)pixels[0] * alpha) / 255);
239  pixels[1] = (Uint8)(((Uint16)pixels[1] * alpha) / 255);
240  pixels[2] = (Uint8)(((Uint16)pixels[2] * alpha) / 255);
241  pixels += 4;
242  }
243 
244  img = [[[NSImage alloc] initWithSize: NSMakeSize(surface->w, surface->h)] autorelease];
245  if (img != nil) {
246  [img addRepresentation: imgrep];
247  }
248  return img;
249 }
250 
251 /*
252  * Mac OS X log support.
253  *
254  * This doesn't really have aything to do with the interfaces of the SDL video
255  * subsystem, but we need to stuff this into an Objective-C source code file.
256  *
257  * NOTE: This is copypasted in src/video/uikit/SDL_uikitvideo.m! Be sure both
258  * versions remain identical!
259  */
260 
261 void SDL_NSLog(const char *text)
262 {
263  NSLog(@"%s", text);
264 }
265 
266 #endif /* SDL_VIDEO_DRIVER_COCOA */
267 
268 /* vim: set ts=4 sw=4 expandtab: */
#define _THIS
char * Cocoa_GetClipboardText(_THIS)
int Cocoa_SetClipboardText(_THIS, const char *text)
SDL_bool Cocoa_HasClipboardText(_THIS)
void Cocoa_RegisterApp(void)
void Cocoa_SuspendScreenSaver(_THIS)
void Cocoa_PumpEvents(_THIS)
void Cocoa_QuitKeyboard(_THIS)
void Cocoa_StartTextInput(_THIS)
void Cocoa_InitKeyboard(_THIS)
void Cocoa_SetTextInputRect(_THIS, SDL_Rect *rect)
void Cocoa_StopTextInput(_THIS)
void Cocoa_QuitModes(_THIS)
int Cocoa_GetDisplayDPI(_THIS, SDL_VideoDisplay *display, float *ddpi, float *hpdi, float *vdpi)
int Cocoa_SetDisplayMode(_THIS, SDL_VideoDisplay *display, SDL_DisplayMode *mode)
int Cocoa_GetDisplayUsableBounds(_THIS, SDL_VideoDisplay *display, SDL_Rect *rect)
void Cocoa_GetDisplayModes(_THIS, SDL_VideoDisplay *display)
void Cocoa_InitModes(_THIS)
int Cocoa_GetDisplayBounds(_THIS, SDL_VideoDisplay *display, SDL_Rect *rect)
void Cocoa_QuitMouse(_THIS)
int Cocoa_InitMouse(_THIS)
int Cocoa_ResizeWindowShape(SDL_Window *window)
SDL_WindowShaper * Cocoa_CreateShaper(SDL_Window *window)
int Cocoa_SetWindowShape(SDL_WindowShaper *shaper, SDL_Surface *shape, SDL_WindowShapeMode *shape_mode)
NSImage * Cocoa_CreateImage(SDL_Surface *surface)
void Cocoa_SetWindowPosition(_THIS, SDL_Window *window)
int Cocoa_SetWindowOpacity(_THIS, SDL_Window *window, float opacity)
void Cocoa_SetWindowFullscreen(_THIS, SDL_Window *window, SDL_VideoDisplay *display, SDL_bool fullscreen)
void Cocoa_SetWindowGrab(_THIS, SDL_Window *window, SDL_bool grabbed)
void Cocoa_ShowWindow(_THIS, SDL_Window *window)
void Cocoa_SetWindowIcon(_THIS, SDL_Window *window, SDL_Surface *icon)
int Cocoa_GetWindowGammaRamp(_THIS, SDL_Window *window, Uint16 *ramp)
int Cocoa_SetWindowHitTest(SDL_Window *window, SDL_bool enabled)
int Cocoa_CreateWindowFrom(_THIS, SDL_Window *window, const void *data)
void Cocoa_SetWindowSize(_THIS, SDL_Window *window)
void Cocoa_SetWindowMaximumSize(_THIS, SDL_Window *window)
void Cocoa_MaximizeWindow(_THIS, SDL_Window *window)
void Cocoa_AcceptDragAndDrop(SDL_Window *window, SDL_bool accept)
void Cocoa_SetWindowBordered(_THIS, SDL_Window *window, SDL_bool bordered)
int Cocoa_SetWindowGammaRamp(_THIS, SDL_Window *window, const Uint16 *ramp)
void Cocoa_HideWindow(_THIS, SDL_Window *window)
void Cocoa_SetWindowMinimumSize(_THIS, SDL_Window *window)
void Cocoa_MinimizeWindow(_THIS, SDL_Window *window)
void Cocoa_DestroyWindow(_THIS, SDL_Window *window)
void Cocoa_RestoreWindow(_THIS, SDL_Window *window)
SDL_bool Cocoa_GetWindowWMInfo(_THIS, SDL_Window *window, struct SDL_SysWMinfo *info)
void Cocoa_RaiseWindow(_THIS, SDL_Window *window)
void Cocoa_SetWindowResizable(_THIS, SDL_Window *window, SDL_bool resizable)
int Cocoa_CreateWindow(_THIS, SDL_Window *window)
void Cocoa_SetWindowTitle(_THIS, SDL_Window *window)
#define SDL_CreateMutex
#define SDL_ConvertSurfaceFormat
#define SDL_free
#define SDL_GetHintBoolean
#define SDL_memcpy
#define SDL_FreeSurface
#define SDL_DestroyMutex
#define SDL_calloc
#define SDL_OutOfMemory()
Definition: SDL_error.h:88
#define SDL_HINT_VIDEO_MAC_FULLSCREEN_SPACES
A variable that dictates policy for fullscreen Spaces on Mac OS X.
Definition: SDL_hints.h:1000
GLint GLvoid * img
Definition: SDL_opengl.h:1980
GLint GLint GLsizei GLsizei GLsizei GLint GLenum GLenum const GLvoid * pixels
Definition: SDL_opengl.h:1572
GLint GLenum GLsizei GLsizei GLsizei GLint GLsizei const GLvoid * data
Definition: SDL_opengl.h:1974
GLfloat GLfloat GLfloat alpha
@ SDL_PIXELFORMAT_RGBA32
Definition: SDL_pixels.h:280
uint16_t Uint16
Definition: SDL_stdinc.h:197
@ SDL_TRUE
Definition: SDL_stdinc.h:170
uint8_t Uint8
Definition: SDL_stdinc.h:185
VideoBootStrap COCOA_bootstrap
static SDL_VideoDevice * _this
Definition: SDL_video.c:126
return Display return Display Bool Bool int int int return Display XEvent Bool(*) XPointer return Display return Display Drawable _Xconst char unsigned int unsigned int return Display Pixmap Pixmap XColor XColor unsigned int unsigned int return Display _Xconst char char int char return Display Visual unsigned int int int char unsigned int unsigned int in i)
Definition: SDL_x11sym.h:50
#define NULL
Definition: begin_code.h:163
EGLSurface surface
Definition: eglext.h:248
static SDL_AudioDeviceID device
Definition: loopwave.c:37
double floor(double x)
Definition: s_floor.c:33
A collection of pixels used in software blitting.
Definition: SDL_surface.h:71
void * pixels
Definition: SDL_surface.h:76
static char text[MAX_TEXT_LENGTH]
Definition: testime.c:47