summaryrefslogtreecommitdiff
path: root/include/yasl/native.h
diff options
context:
space:
mode:
Diffstat (limited to 'include/yasl/native.h')
-rw-r--r--include/yasl/native.h5
1 files changed, 3 insertions, 2 deletions
diff --git a/include/yasl/native.h b/include/yasl/native.h
index d65f8d3..64bc161 100644
--- a/include/yasl/native.h
+++ b/include/yasl/native.h
@@ -48,15 +48,16 @@ YASL_API void *yasl_surface_get_native_handle(struct yasl_surface *s);
/**
* Create a toplevel for application-managed native rendering.
* @param d Display with YASL_CAP_NATIVE_GRAPHICS.
- * @param spec Copied toplevel options, with logical-pixel size.
+ * @param spec Copied window options, with logical-pixel size and optional callbacks.
* @param graphics_device Required native graphics device; currently id<MTLDevice> 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_surface_spec *spec, void *graphics_device);
+ const struct yasl_window_spec *spec, void *graphics_device);
/** Borrowed native drawable for the current draw target, currently Cocoa/Metal. */
struct yasl_native_frame {