#ifndef UU_PORTAL_ENGINE_H #define UU_PORTAL_ENGINE_H #include #include #include "dmabuf_frame.h" struct uu_portal; typedef int (*uu_portal_cancelled_fn)(void *data); typedef void (*uu_portal_save_detailed_fn)(const char *token, void *data, int has_position, int32_t x, int32_t y); /* Reports the granted position alongside the rotated token before video initialization. */ struct uu_portal *uu_portal_open_detailed(const char *restore, uu_portal_save_detailed_fn save_token, void *save_data, uu_portal_cancelled_fn cancelled, void *cancel_data, int prefer_dmabuf, uint32_t source_types, int *error, uint32_t *width, uint32_t *height); /* One object owns one consent/session and one PipeWire stream. */ struct uu_portal *uu_portal_open(int *error, uint32_t *width, uint32_t *height); /* Saves the rotated token immediately after Start, before video initialization. */ struct uu_portal *uu_portal_open_virtual(const char *restore, void (*save_token)(const char *, void *), void *data, int *error, uint32_t *width, uint32_t *height); struct uu_portal *uu_portal_open_persist(const char *restore, void (*save_token)(const char *, void *), void *data, int *error, uint32_t *width, uint32_t *height); /* The cancellation callback and data are used only until this call returns. */ struct uu_portal *uu_portal_open_persist_cancellable(const char *restore, void (*save_token)(const char *, void *), void *save_data, uu_portal_cancelled_fn cancelled, void *cancel_data, int *error, uint32_t *width, uint32_t *height); /* Select the capture transport before connecting, including on same-process recovery. */ struct uu_portal *uu_portal_open_persist_capture(const char *restore, void (*save_token)(const char *, void *), void *save_data, uu_portal_cancelled_fn cancelled, void *cancel_data, int prefer_dmabuf, int *error, uint32_t *width, uint32_t *height); struct uu_portal *uu_portal_open_restore(const char *restore, int *error, uint32_t *width, uint32_t *height); /* Cursor mode for subsequent sessions: 1 hidden, 2 embedded (the compositor draws the pointer * into the stream). -1 restores the UU_PORTAL_CURSOR_MODE default. The host switches this at * runtime because the viewer cannot draw a pointer of its own during relative motion. */ void uu_portal_set_cursor_mode(int mode); /* What the last session requested and what the backend offered, for host bookkeeping. */ int uu_portal_cursor_mode(struct uu_portal *portal); int uu_portal_cursor_modes(struct uu_portal *portal); const char *uu_portal_restore_token(struct uu_portal *portal); void uu_portal_close(struct uu_portal *portal); int uu_portal_clipboard_ready(struct uu_portal *portal); int uu_portal_clipboard_set(struct uu_portal *portal, const uint8_t *text, size_t length); /* Offers the text `from` still owns to `to`; 0 transferred, 1 nothing to transfer. */ int uu_portal_clipboard_copy(struct uu_portal *from, struct uu_portal *to); int uu_portal_clipboard_poll(struct uu_portal *portal, uint8_t *text, size_t capacity); int uu_portal_alive(struct uu_portal *portal); int uu_portal_capture_alive(struct uu_portal *portal); /* Wait for a new frame or status change with a timeout in microseconds. * Returns 1 if a new frame or status change occurred, 0 on timeout, <0 on closed/error. */ int uu_portal_wait_frame(struct uu_portal *portal, int64_t timeout_us); void uu_portal_input_dispatch(struct uu_portal *portal); void uu_portal_logical_size(struct uu_portal *portal, uint32_t *width, uint32_t *height); void uu_portal_reset_frame(struct uu_portal *portal); int uu_portal_capture(struct uu_portal *portal, uint8_t *bgra, size_t length); int uu_portal_capture_since(struct uu_portal *portal, uint8_t *bgra, size_t length, uint64_t *revision); /* acquire holds the PipeWire loop until release, including GPU completion. * 0/12 = leased new/unchanged frame, 10 = pending, 15 = neutral black. * CPU fallback: 14 layout/disabled, 16 shared memory, 17 timeout, 18 explicit sync, 19 modifier. */ int uu_portal_dmabuf_acquire(struct uu_portal *portal, UuDmaFrame *frame, uint64_t *revision); void uu_portal_dmabuf_release(struct uu_portal *portal); void uu_portal_dmabuf_disable(struct uu_portal *portal); int uu_portal_move(struct uu_portal *portal, double x, double y, int relative); int uu_portal_button(struct uu_portal *portal, int button, int pressed); int uu_portal_scroll(struct uu_portal *portal, double dx, double dy, int finish); int uu_portal_touch_supported(struct uu_portal *portal); int uu_portal_touch_available(struct uu_portal *portal); int uu_portal_touch(struct uu_portal *portal, int phase, double x, double y); int uu_portal_key(struct uu_portal *portal, uint32_t keysym, int keycode, int pressed); int uu_portal_stream_position(struct uu_portal *portal, int32_t *x, int32_t *y); int uu_portal_monitors(char *out, size_t length); void uu_portal_end(struct uu_portal *portal); #endif