- Dokumentacja
- Funkcje klienta
- setCursorImage
Funkcja
setCursorImage
Zamienia kursor gry na własny obraz: plik PNG z zasobu albo teksturę z dxCreateTexture lub dxCreateRenderTarget. Wywołanie bez argumentu albo z false wraca do wbudowanego kursora.
Składnia
bool setCursorImage([string|texture|bool image = nil, int hotX = 0, int hotY = 0, int width, int height])Argumenty
imagestring|texture|bool, opcjonalny = nil- Ścieżka do pliku, tekstura albo
false. hotXint, opcjonalny = 0- Punkt kliknięcia w obrazie: piksele od lewej krawędzi.
hotYint, opcjonalny = 0- Punkt kliknięcia: piksele od górnej krawędzi.
widthint, opcjonalny- Szerokość na ekranie (domyślnie szerokość obrazu, do 512).
heightint, opcjonalny- Wysokość na ekranie (domyślnie wysokość obrazu, do 512).
Zwraca
true przy powodzeniu.
Przykład
Celownik 32x32, który klika środkiem.
showCursor(true)
setCursorImage("img/celownik.png", 16, 16)Uwagi
Piksele są kopiowane w chwili wywołania. Kursor rysowany w render targecie wymaga ponownego wywołania po każdej zmianie. Gdy zasób, który ustawił obraz, zostanie zatrzymany, wraca zwykła strzałka.
Zobacz też
setCursorTypeZmienia kształt kursora gry. Bez argumentu kursor wraca do zmieniania kształtu sam: nad linkiem w przeglądarce zmienia się w rękę, nad polem tekstowym w kreskę.setCursorAlphaUstawia przezroczystość kursora w grze (0 = niewidoczny, 255 = pełny). Kursor pokazany przezshowCursorjest rysowany przez grę, nad HUD-em, GUI i przeglądarkami, więc przezroczystość widać też na zrzutach ekranu.showCursorPokazuje albo chowa kursor myszy. Kursor jest pokazany, dopóki chce go choć jeden zasób, więc chowanie w jednym zasobie nie zamyka kursora innego. Domyślnie przy pokazanym kursorze sterowanie postacią jest zablokowane.