From 76073fe5fad8799e5850805f2f090af2cb62c741 Mon Sep 17 00:00:00 2001 From: Berke Güzel Date: Tue, 13 Oct 2026 23:41:31 +0300 Subject: Simplify the public event and CPU API Applications now need far less ceremony: hello.c is a 20-line loop that handles REFRESH, CLOSE and QUIT and draws into the surface's own pixels. - Fold GEOMETRY, STATE and FOCUS into one WINDOW event carrying size, scale and state; unchanged values send nothing. - Guarantee REFRESH once a window has a size and after every resize, never at size zero. - Merge DROP_HOVER into DROP with over/leave/data actions and give drag and drop actions enums. - Keep event strings valid until the next wait and drop yasl_event_release; empty or failed waits report NONE. - Replace copy-in presentation with a lent pixel buffer: yasl_cpu_pixels and yasl_cpu_present. - Remove yasl_poll_event, yasl_cpu_read_pixels, unused event fields and comments that restated names. - Wayland: resize floating windows in request_size instead of reporting it unsupported, and stop marking new GPU surfaces as Vulkan so yasl_vulkan_create_surface no longer fails with NATIVE_WINDOW_IN_USE. Also includes the in-progress public API refactor that was uncommitted in the tree (removal of the app/loop layer, new surface, GL and Vulkan entry points). Co-Authored-By: Claude Opus 5.5 --- include/yasl/native.h | 90 --------------------------------------------------- 1 file changed, 90 deletions(-) delete mode 100644 include/yasl/native.h (limited to 'include/yasl/native.h') diff --git a/include/yasl/native.h b/include/yasl/native.h deleted file mode 100644 index 64bc161..0000000 --- a/include/yasl/native.h +++ /dev/null @@ -1,90 +0,0 @@ -/** - * @file - * Optional native handles and application-managed rendering. - * - * These extensions follow the core thread and lifetime rules. Handles are borrowed; - * never destroy them or dispatch their native connection independently. Typed - * backend accessors live in the yasl/native headers and are installed only for built - * backends. Application-managed drawing currently supports Cocoa/Metal only. - */ -#ifndef YASL_NATIVE_H -#define YASL_NATIVE_H - -#include "yasl/yasl.h" - -#ifdef __cplusplus -extern "C" { -#endif - -/* Optional platform interoperability. All handles are borrowed and expire on - * object destruction. Check yasl_display_backend() before casting: - * - * display surface - * Wayland struct wl_display * struct wl_surface * - * X11 Display * Window (cast through uintptr_t) - * Cocoa NSApplication * NSWindow * (view: window.contentView) - */ -/** - * Get a borrowed, backend-specific display handle. - * @param d Display, or NULL. - * @return Native handle, or NULL. Inspect yasl_display_backend() before casting. - * Prefer a typed accessor from yasl/native/wayland.h, x11.h, or cocoa.h. - * The handle expires on display close; do not close or dispatch it independently. - */ -YASL_API void *yasl_display_get_native_handle(struct yasl_display *d); -/** - * Get a borrowed, backend-specific surface handle. - * @param s Surface, or NULL. - * @return Native handle, or NULL. X11 encodes a Window through uintptr_t. - * Prefer typed accessors. The handle expires on surface destruction. Do not - * change native ownership, event masks, buffer attachment, or surface roles. - */ -YASL_API void *yasl_surface_get_native_handle(struct yasl_surface *s); - -/* Create a surface for application-managed native rendering. graphics_device - * must be non-NULL; currently an id on Cocoa, retained by the surface. - * Other backends return NULL with errno=ENOTSUP. CPU rendering uses the ordinary - * yasl_surface_create_toplevel() and requires no native device. */ -/** - * Create a toplevel for application-managed native rendering. - * @param d Display with YASL_CAP_NATIVE_GRAPHICS. - * @param spec Copied window options, with logical-pixel size and optional callbacks. - * @param graphics_device Required native graphics device; currently id on Cocoa. - * @return Owned surface, or NULL with errno set: EINVAL for invalid arguments, - * ENOTSUP for an unsupported backend, or a backend error. - * Cocoa retains the device. Query the drawable during draw, submit/present it, - * then call yasl_surface_present() to record submission. - * Callback ownership and timing follow yasl_surface_create_toplevel(). - */ -YASL_API struct yasl_surface *yasl_surface_create_native(struct yasl_display *d, - const struct yasl_window_spec *spec, void *graphics_device); - -/** Borrowed native drawable for the current draw target, currently Cocoa/Metal. */ -struct yasl_native_frame { - /** Borrowed id on Cocoa. */ - void *drawable; - /** Cocoa CAMetalLayer presentsWithTransaction setting for this frame. */ - bool transaction; -}; - -/* Query the current draw target's native drawable. Returns false for unsupported - * backends, stale targets, or outside the draw callback. The result expires on - * successful present, callback return, or surface destruction. Native renderers - * submit/present the drawable, then call yasl_surface_present() to record it. */ -/** - * Get the current draw target's native drawable. - * @param s Surface currently being drawn. - * @param target Exact framebuffer identity supplied to this draw callback. - * @param out Required output native frame. - * @return true if available, false for NULL arguments, unsupported backends, - * stale targets, or calls outside draw. The drawable is borrowed and expires on - * successful present, callback return, or surface destruction. Currently Cocoa only. - */ -YASL_API bool yasl_surface_get_native_frame(struct yasl_surface *s, - const struct yasl_framebuffer *target, struct yasl_native_frame *out); - -#ifdef __cplusplus -} -#endif - -#endif /* YASL_NATIVE_H */ -- cgit v1.2.3