Kursor

Kursor rysowany przez grę: wbudowane kształty, własny obraz i jeden kursor dla dxDraw, GUI i przeglądarek.

Kursor gry, nie systemu

showCursor pokazuje kursor rysowany w grze, w tej samej klatce co reszta obrazu. Kursor Windows jest wtedy schowany, więc nie ma dwóch strzałek, mrugania ani opóźnienia względem interfejsu. Jeden kursor obsługuje rysowanie dxDraw, okna GUI i przeglądarki CEF: nad polem tekstowym sam zmienia się w kreskę, nad krawędzią okna w strzałki zmiany rozmiaru, nad linkiem w przeglądarce w dłoń.

bindKey("m", "down", function()
    showCursor(not isCursorShowing())
end)

**Kursor nad grą**Strzałka po `showCursor(true)`.

Kształty

Kształt zmienia się sam nad GUI i przeglądarką. setCursorType ustawia go na sztywno, setCursorType() bez argumentu oddaje sterowanie z powrotem.

Nazwa	Kiedy
`arrow`	domyślna strzałka
`hand`	coś do kliknięcia
`text`	pole tekstowe
`crosshair`	wybieranie punktu
`wait`, `progress`	coś się wczytuje (kręcące się kółko)
`help`	podpowiedź
`move`	przesuwanie
`sizewe`, `sizens`, `sizenesw`, `sizenwse`	zmiana rozmiaru w poziomie, pionie i po skosie
`no`	akcja niedostępna
`none`	kursor schowany, ale dalej działa (np. własny celownik rysowany przez `dxDraw`)

**Pole tekstowe**Nad `guiCreateEdit` kursor sam staje się kreską `text`.

**Róg okna**Krawędź okna, które można rozciągać: `sizenwse`.

**Czekanie**`setCursorType("wait")` na czas wczytywania.

**Dłoń**`setCursorType("hand")` nad własnym przyciskiem z `dxDraw`.

Własny obraz

setCursorImage zamienia kursor na dowolny obraz: plik PNG z zasobu albo teksturę z dxCreateTexture lub dxCreateRenderTarget. hotX i hotY to punkt kliknięcia w obrazie, liczony od lewego górnego rogu.

-- celownik 32x32, klika środek
setCursorImage("img/celownik.png", 16, 16)

-- powrót do wbudowanego kursora
setCursorImage(false)

Piksele są kopiowane w chwili wywołania. Jeśli rysujesz kursor w render targecie i chcesz go animować, wywołaj setCursorImage ponownie po każdej zmianie.

Przezroczystość i sprzątanie

setCursorAlpha ustawia przezroczystość kursora (0 do 255). Kształt, obraz i przezroczystość są wspólne dla wszystkich zasobów: gdy zasób, który je zmienił, zostanie zatrzymany, kursor wraca do zwykłej strzałki, więc jeden zasób nie zostawi innym schowanego kursora.