/**************************************************************************/ /* rendering_context_driver_metal.mm */ /**************************************************************************/ /* This file is part of: */ /* GODOT ENGINE */ /* https://godotengine.org */ /**************************************************************************/ /* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */ /* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */ /* */ /* Permission is hereby granted, free of charge, to any person obtaining */ /* a copy of this software and associated documentation files (the */ /* "Software"), to deal in the Software without restriction, including */ /* without limitation the rights to use, copy, modify, merge, publish, */ /* distribute, sublicense, and/or sell copies of the Software, and to */ /* permit persons to whom the Software is furnished to do so, subject to */ /* the following conditions: */ /* */ /* The above copyright notice and this permission notice shall be */ /* included in all copies or substantial portions of the Software. */ /* */ /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */ /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */ /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */ /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */ /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */ /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */ /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /**************************************************************************/ #import "rendering_context_driver_metal.h" #import "rendering_device_driver_metal.h" @protocol MTLDeviceEx #if TARGET_OS_OSX && __MAC_OS_X_VERSION_MAX_ALLOWED < 130300 - (void)setShouldMaximizeConcurrentCompilation:(BOOL)v; #endif @end RenderingContextDriverMetal::RenderingContextDriverMetal() { } RenderingContextDriverMetal::~RenderingContextDriverMetal() { } Error RenderingContextDriverMetal::initialize() { metal_device = MTLCreateSystemDefaultDevice(); #if TARGET_OS_OSX if (@available(macOS 13.3, *)) { [id(metal_device) setShouldMaximizeConcurrentCompilation:YES]; } #endif device.type = DEVICE_TYPE_INTEGRATED_GPU; device.vendor = VENDOR_APPLE; device.workarounds = Workarounds(); MetalDeviceProperties props(metal_device); int version = (int)props.features.highestFamily - (int)MTLGPUFamilyApple1 + 1; device.name = vformat("%s (Apple%d)", metal_device.name.UTF8String, version); return OK; } const RenderingContextDriver::Device &RenderingContextDriverMetal::device_get(uint32_t p_device_index) const { DEV_ASSERT(p_device_index < 1); return device; } uint32_t RenderingContextDriverMetal::device_get_count() const { return 1; } RenderingDeviceDriver *RenderingContextDriverMetal::driver_create() { return memnew(RenderingDeviceDriverMetal(this)); } void RenderingContextDriverMetal::driver_free(RenderingDeviceDriver *p_driver) { memdelete(p_driver); } class API_AVAILABLE(macos(11.0), ios(14.0)) SurfaceLayer : public RenderingContextDriverMetal::Surface { CAMetalLayer *__unsafe_unretained layer = nil; LocalVector frame_buffers; LocalVector> drawables; uint32_t rear = -1; uint32_t front = 0; uint32_t count = 0; public: SurfaceLayer(CAMetalLayer *p_layer, id p_device) : Surface(p_device), layer(p_layer) { layer.allowsNextDrawableTimeout = YES; layer.framebufferOnly = YES; layer.opaque = OS::get_singleton()->is_layered_allowed() ? NO : YES; layer.pixelFormat = get_pixel_format(); layer.device = p_device; } ~SurfaceLayer() override { layer = nil; } Error resize(uint32_t p_desired_framebuffer_count) override final { if (width == 0 || height == 0) { // Very likely the window is minimized, don't create a swap chain. return ERR_SKIP; } CGSize drawableSize = CGSizeMake(width, height); CGSize current = layer.drawableSize; if (!CGSizeEqualToSize(current, drawableSize)) { layer.drawableSize = drawableSize; } // Metal supports a maximum of 3 drawables. p_desired_framebuffer_count = MIN(3U, p_desired_framebuffer_count); layer.maximumDrawableCount = p_desired_framebuffer_count; #if TARGET_OS_OSX // Display sync is only supported on macOS. switch (vsync_mode) { case DisplayServer::VSYNC_MAILBOX: case DisplayServer::VSYNC_ADAPTIVE: case DisplayServer::VSYNC_ENABLED: layer.displaySyncEnabled = YES; break; case DisplayServer::VSYNC_DISABLED: layer.displaySyncEnabled = NO; break; } #endif drawables.resize(p_desired_framebuffer_count); frame_buffers.resize(p_desired_framebuffer_count); for (uint32_t i = 0; i < p_desired_framebuffer_count; i++) { // Reserve space for the drawable texture. frame_buffers[i].set_texture_count(1); } return OK; } RDD::FramebufferID acquire_next_frame_buffer() override final { if (count == frame_buffers.size()) { return RDD::FramebufferID(); } rear = (rear + 1) % frame_buffers.size(); count++; MDFrameBuffer &frame_buffer = frame_buffers[rear]; frame_buffer.size = Size2i(width, height); id drawable = layer.nextDrawable; ERR_FAIL_NULL_V_MSG(drawable, RDD::FramebufferID(), "no drawable available"); drawables[rear] = drawable; frame_buffer.set_texture(0, drawable.texture); return RDD::FramebufferID(&frame_buffer); } void present(MDCommandBuffer *p_cmd_buffer) override final { if (count == 0) { return; } // Release texture and drawable. frame_buffers[front].unset_texture(0); id drawable = drawables[front]; drawables[front] = nil; count--; front = (front + 1) % frame_buffers.size(); [p_cmd_buffer->get_command_buffer() presentDrawable:drawable afterMinimumDuration:present_minimum_duration]; } }; RenderingContextDriver::SurfaceID RenderingContextDriverMetal::surface_create(const void *p_platform_data) { const WindowPlatformData *wpd = (const WindowPlatformData *)(p_platform_data); Surface *surface = memnew(SurfaceLayer(wpd->layer, metal_device)); return SurfaceID(surface); } void RenderingContextDriverMetal::surface_set_size(SurfaceID p_surface, uint32_t p_width, uint32_t p_height) { Surface *surface = (Surface *)(p_surface); if (surface->width == p_width && surface->height == p_height) { return; } surface->width = p_width; surface->height = p_height; surface->needs_resize = true; } void RenderingContextDriverMetal::surface_set_vsync_mode(SurfaceID p_surface, DisplayServer::VSyncMode p_vsync_mode) { Surface *surface = (Surface *)(p_surface); if (surface->vsync_mode == p_vsync_mode) { return; } surface->vsync_mode = p_vsync_mode; surface->needs_resize = true; } DisplayServer::VSyncMode RenderingContextDriverMetal::surface_get_vsync_mode(SurfaceID p_surface) const { Surface *surface = (Surface *)(p_surface); return surface->vsync_mode; } uint32_t RenderingContextDriverMetal::surface_get_width(SurfaceID p_surface) const { Surface *surface = (Surface *)(p_surface); return surface->width; } uint32_t RenderingContextDriverMetal::surface_get_height(SurfaceID p_surface) const { Surface *surface = (Surface *)(p_surface); return surface->height; } void RenderingContextDriverMetal::surface_set_needs_resize(SurfaceID p_surface, bool p_needs_resize) { Surface *surface = (Surface *)(p_surface); surface->needs_resize = p_needs_resize; } bool RenderingContextDriverMetal::surface_get_needs_resize(SurfaceID p_surface) const { Surface *surface = (Surface *)(p_surface); return surface->needs_resize; } void RenderingContextDriverMetal::surface_destroy(SurfaceID p_surface) { Surface *surface = (Surface *)(p_surface); memdelete(surface); }