love.mouse.newCursor

Доступно начиная с LÖVE 0.9.0
Эта функция не поддерживается в более ранних версиях.

Создаёт новый объект курсора аппаратного типа (Cursor) из файла изображения или объекта ImageData.

Аппаратные курсоры не зависят от частоты кадров и работают так же, как и обычные курсоры операционной системы. В отличие от рисования изображения в текущих координатах мыши, аппаратные курсоры никогда не имеют видимой задержки между перемещением мыши и обновлением позиции курсора, даже при низкой частоте кадров.

Горячая точка — это точка, которую использует операционная система для определения того, что было нажато и в какой позиции находится курсор мыши. Например, обычный курсор стрелки обычно имеет горячую точку в верхнем левом углу изображения, но курсор крестика может иметь её в середине.

Эта функция может быть медленной, если вызывается многократно, например, из love.update или love.draw. Если вам нужно часто использовать определённый ресурс, создайте его один раз и сохраните в месте, где он может быть повторно использован!

Функция

Синтаксис

cursor = love.mouse.newCursor( imageData, hotx, hoty )

Аргументы

ImageData imageData

Объект ImageData для нового курсора.

number hotx (0)

Координата x горячей точки курсора в объекте ImageData.

number hoty (0)

Координата y горячей точки курсора в объекте ImageData.

Возвращаемое значение

Cursor cursor

Новый объект Cursor.

Функция

Синтаксис

cursor = love.mouse.newCursor( filename, hotx, hoty )

Аргументы

string filename

Путь к изображению для нового курсора.

number hotx (0)

Координата x горячей точки курсора в изображении.

number hoty (0)

Координата y горячей точки курсора в изображении.

Возвращаемое значение

Cursor cursor

Новый объект Cursor.

Функция

Синтаксис

cursor = love.mouse.newCursor( fileData, hotx, hoty )

Аргументы

FileData fileData

Данные, представляющие изображение для нового курсора.

number hotx (0)

Координата x горячей точки курсора в изображении.

number hoty (0)

Координата y горячей точки курсора в изображении.

Возвращаемое значение

Cursor cursor

Новый объект Cursor.

См. также

• love.mouse
• love.mouse.setCursor
• love.mouse.getCursor
• Cursor