Source code for simvx.graphics.platform._base

"""Window backend protocol — duck-typing friendly contract."""


from __future__ import annotations

import logging
from collections.abc import Callable
from typing import Any, Protocol, runtime_checkable

log = logging.getLogger(__name__)

__all__ = ["WindowBackend"]




@runtime_checkable
class WindowBackend(Protocol):
    """Protocol that all windowing backends must satisfy."""



    def create_window(self, width: int, height: int, title: str, *, visible: bool = True) -> None: ...




    def set_window_size(self, width: int, height: int) -> None: ...




    def set_title(self, title: str) -> None: ...




    def create_graphics_surface(self, instance: Any) -> Any: ...




    def get_required_instance_extensions(self) -> list[str]: ...




    def poll_events(self) -> None: ...




    def should_close(self) -> bool: ...




    def get_framebuffer_size(self) -> tuple[int, int]: ...




    def get_window_size(self) -> tuple[int, int]: ...




    def get_content_scale(self) -> tuple[float, float]: ...




    def set_key_callback(self, callback: Callable[[int, int, int], None] | None) -> None: ...




    def set_mouse_button_callback(self, callback: Callable[[int, int, int], None] | None) -> None: ...




    def set_cursor_pos_callback(self, callback: Callable[[float, float], None] | None) -> None: ...




    def set_char_callback(self, callback: Callable[[int], None] | None) -> None: ...




    def set_scroll_callback(self, callback: Callable[[float, float], None] | None) -> None: ...




    def request_close(self) -> None: ...




    def get_cursor_pos(self) -> tuple[float, float]: ...




    def set_cursor_shape(self, shape: int) -> None: ...




    def destroy(self) -> None: ...