[Commits] SDL: Fix high-dpi support on macOS and simplify it and iOS variant.

libsdl.org revision control commits-owner at libsdl.org
Wed Feb 21 10:01:53 PST 2018


details:   https://hg.libsdl.org/SDL/rev/27d81cb6e6af
changeset: 11886:27d81cb6e6af
user:      Mark Callow <libsdl.org at callow.im>
date:      Wed Feb 21 09:58:21 2018 -0800
description:
Fix high-dpi support on macOS and simplify it and iOS variant.

The detault drawableSize for a CAMetalLayer is its bounds x its scale.
So it is sufficient to set the *layer's* scale to the desired value.

diffstat:

 include/SDL_video.h                  |   4 ++-
 include/SDL_vulkan.h                 |   3 ++
 src/video/cocoa/SDL_cocoametalview.h |   3 +-
 src/video/cocoa/SDL_cocoametalview.m |  42 +++++++++++++++++++++--------------
 src/video/uikit/SDL_uikitmetalview.h |   3 +-
 src/video/uikit/SDL_uikitmetalview.m |  30 +++++++------------------
 6 files changed, 42 insertions(+), 43 deletions(-)

diffs (202 lines):

diff -r e6fc3ef41ffd -r 27d81cb6e6af include/SDL_video.h
--- a/include/SDL_video.h	Wed Feb 21 09:40:47 2018 -0800
+++ b/include/SDL_video.h	Wed Feb 21 09:58:21 2018 -0800
@@ -110,7 +110,9 @@
     SDL_WINDOW_MOUSE_FOCUS = 0x00000400,        /**< window has mouse focus */
     SDL_WINDOW_FULLSCREEN_DESKTOP = ( SDL_WINDOW_FULLSCREEN | 0x00001000 ),
     SDL_WINDOW_FOREIGN = 0x00000800,            /**< window not created by SDL */
-    SDL_WINDOW_ALLOW_HIGHDPI = 0x00002000,      /**< window should be created in high-DPI mode if supported */
+    SDL_WINDOW_ALLOW_HIGHDPI = 0x00002000,      /**< window should be created in high-DPI mode if supported.
+                                                     On macOS NSHighResolutionCapable must be set true in the
+                                                     application's Info.plist for this to have any effect. */
     SDL_WINDOW_MOUSE_CAPTURE = 0x00004000,      /**< window has mouse captured (unrelated to INPUT_GRABBED) */
     SDL_WINDOW_ALWAYS_ON_TOP = 0x00008000,      /**< window should always be above others */
     SDL_WINDOW_SKIP_TASKBAR  = 0x00010000,      /**< window should not be added to the taskbar */
diff -r e6fc3ef41ffd -r 27d81cb6e6af include/SDL_vulkan.h
--- a/include/SDL_vulkan.h	Wed Feb 21 09:40:47 2018 -0800
+++ b/include/SDL_vulkan.h	Wed Feb 21 09:58:21 2018 -0800
@@ -240,6 +240,9 @@
  * platform with high-DPI support (Apple calls this "Retina"), and not disabled
  * by the \c SDL_HINT_VIDEO_HIGHDPI_DISABLED hint.
  *
+ *  \note On macOS high-DPI support must be enabled for an application by
+ *        setting NSHighResolutionCapable to true in its Info.plist.
+ *
  *  \sa SDL_GetWindowSize()
  *  \sa SDL_CreateWindow()
  */
diff -r e6fc3ef41ffd -r 27d81cb6e6af src/video/cocoa/SDL_cocoametalview.h
--- a/src/video/cocoa/SDL_cocoametalview.h	Wed Feb 21 09:40:47 2018 -0800
+++ b/src/video/cocoa/SDL_cocoametalview.h	Wed Feb 21 09:58:21 2018 -0800
@@ -41,11 +41,10 @@
 
 @interface SDL_cocoametalview : NSView {
     NSInteger _tag;
-    bool _useHighDPI;
 }
 
 - (instancetype)initWithFrame:(NSRect)frame
-                   useHighDPI:(bool)useHighDPI;
+                        scale:(CGFloat)scale;
 
 /* Override superclass tag so this class can set it. */
 @property (assign, readonly) NSInteger tag;
diff -r e6fc3ef41ffd -r 27d81cb6e6af src/video/cocoa/SDL_cocoametalview.m
--- a/src/video/cocoa/SDL_cocoametalview.m	Wed Feb 21 09:40:47 2018 -0800
+++ b/src/video/cocoa/SDL_cocoametalview.m	Wed Feb 21 09:58:21 2018 -0800
@@ -57,17 +57,19 @@
 }
 
 - (instancetype)initWithFrame:(NSRect)frame
-                   useHighDPI:(bool)useHighDPI
+                        scale:(CGFloat)scale
 {
 	if ((self = [super initWithFrame:frame])) {
+        _tag = METALVIEW_TAG;
         self.wantsLayer = YES;
 
         /* Allow resize. */
         self.autoresizingMask = NSViewWidthSizable | NSViewHeightSizable;
-        _tag = METALVIEW_TAG;
 
-        _useHighDPI = useHighDPI;
-        [self updateDrawableSize];
+        /* Set the desired scale. The default drawableSize of a CAMetalLayer
+         * is its bounds x its scale so nothing further needs to be done.
+         */
+        self.layer.contentsScale = scale;
 	}
   
 	return self;
@@ -77,16 +79,6 @@
 - (void)resizeWithOldSuperviewSize:(NSSize)oldSize
 {
     [super resizeWithOldSuperviewSize:oldSize];
-    [self updateDrawableSize];
-}
-
-- (void)updateDrawableSize
-{
-    NSRect bounds = [self bounds];
-    if (_useHighDPI) {
-        bounds = [self convertRectToBacking:bounds];
-    }
-    ((CAMetalLayer *) self.layer).drawableSize = NSSizeToCGSize(bounds.size);
 }
 
 @end
@@ -94,12 +86,26 @@
 SDL_cocoametalview*
 Cocoa_Mtl_AddMetalView(SDL_Window* window)
 {
-    SDL_WindowData *data = (SDL_WindowData *)window->driverdata;
+    SDL_WindowData* data = (__bridge SDL_WindowData *)window->driverdata;
     NSView *view = data->nswindow.contentView;
+    CGFloat scale = 1.0;
 
+    if (window->flags & SDL_WINDOW_ALLOW_HIGHDPI) {
+        /* Set the scale to the natural scale factor of the screen - then
+         * the backing dimensions of the Metal view will match the pixel
+         * dimensions of the screen rather than the dimensions in points
+         * yielding high resolution on retine displays.
+         *
+         * N.B. In order for backingScaleFactor to be > 1,
+         * NSHighResolutionCapable must be set to true in the app's Info.plist.
+         */
+        NSWindow* nswindow = data->nswindow;
+        if ([nswindow.screen respondsToSelector:@selector(backingScaleFactor)])
+            scale = data->nswindow.screen.backingScaleFactor;
+    }
+        
     SDL_cocoametalview *metalview
-        = [[SDL_cocoametalview alloc] initWithFrame:view.frame
-                       useHighDPI:(window->flags & SDL_WINDOW_ALLOW_HIGHDPI)];
+        = [[SDL_cocoametalview alloc] initWithFrame:view.frame scale:scale];
     [view addSubview:metalview];
     return metalview;
 }
@@ -119,6 +125,8 @@
         if (h) {
             *h = layer.drawableSize.height;
         }
+    } else {
+        SDL_GetWindowSize(window, w, h);
     }
 }
 
diff -r e6fc3ef41ffd -r 27d81cb6e6af src/video/uikit/SDL_uikitmetalview.h
--- a/src/video/uikit/SDL_uikitmetalview.h	Wed Feb 21 09:40:47 2018 -0800
+++ b/src/video/uikit/SDL_uikitmetalview.h	Wed Feb 21 09:58:21 2018 -0800
@@ -43,8 +43,7 @@
 @interface SDL_uikitmetalview : SDL_uikitview
 
 - (instancetype)initWithFrame:(CGRect)frame
-                        scale:(CGFloat)scale
-                        tag:(int)tag;
+                        scale:(CGFloat)scale;
 
 @end
 
diff -r e6fc3ef41ffd -r 27d81cb6e6af src/video/uikit/SDL_uikitmetalview.m
--- a/src/video/uikit/SDL_uikitmetalview.m	Wed Feb 21 09:40:47 2018 -0800
+++ b/src/video/uikit/SDL_uikitmetalview.m	Wed Feb 21 09:58:21 2018 -0800
@@ -46,14 +46,12 @@
 
 - (instancetype)initWithFrame:(CGRect)frame
                         scale:(CGFloat)scale
-                          tag:(int)tag
 {
     if ((self = [super initWithFrame:frame])) {
-        /* Set the appropriate scale (for retina display support) */
-        self.contentScaleFactor = scale;
-        self.tag = tag;
-
-        [self updateDrawableSize];
+        self.tag = METALVIEW_TAG;
+        /* Set the desired scale. The default drawableSize of a CAMetalLayer
+         * is its bounds x its scale so nothing further needs to be done. */
+        self.layer.contentsScale = scale;
     }
 
     return self;
@@ -63,16 +61,6 @@
 - (void)layoutSubviews
 {
     [super layoutSubviews];
-    [self updateDrawableSize];
-}
-
-- (void)updateDrawableSize
-{
-    CGSize size  = self.bounds.size;
-    size.width  *= self.contentScaleFactor;
-    size.height *= self.contentScaleFactor;
-
-    ((CAMetalLayer *) self.layer).drawableSize = size;
 }
 
 @end
@@ -89,9 +77,10 @@
 	}
 
     if (window->flags & SDL_WINDOW_ALLOW_HIGHDPI) {
-        /* Set the scale to the natural scale factor of the screen - the
-         * backing dimensions of the Metal view will match the pixel
-         * dimensions of the screen rather than the dimensions in points.
+        /* Set the scale to the natural scale factor of the screen - then
+         * the backing dimensions of the Metal view will match the pixel
+         * dimensions of the screen rather than the dimensions in points
+         * yielding high resolution on retine displays.
          */
 #ifdef __IPHONE_8_0
         if ([data.uiwindow.screen respondsToSelector:@selector(nativeScale)]) {
@@ -104,8 +93,7 @@
     }
     SDL_uikitmetalview *metalview
          = [[SDL_uikitmetalview alloc] initWithFrame:view.frame
-                                          scale:scale
-                                            tag:METALVIEW_TAG];
+                                               scale:scale];
     [metalview setSDLWindow:window];
 
     return metalview;


More information about the commits mailing list