UoPilot - Вклад участника [ru]

Printscreen (Lua)

2020-10-25T17:09:11Z

Cirus:

== Описание ==
'''printscreen''' - команда сохранения копии экрана в файл.

== Синтаксис ==
Привязка к окну: опционально.
 Работа со свернутым окном: нет.
 Работа с перекрытым окном: Да. Привязка к окну обязательна. Aero (темы Windows7) должен быть включен. Если был установлен Астер, то он должен быть отключен, а система перезагружена.
 Все параметры заключаются в скобки и разделяются запятыми. Путь указывается в кавычках.
printscreen (<handle>, <x>, <y>, <width>, <height>, <path>)
Где:
 '''handle''' - хендл окна. Для работы с перекрытом окном иногда нужно указывать родительское окно.
 '''x''' - Координата X
 '''y''' - Координата Y
 '''width''' - Ширина, если 'width' = 0, то берётся максимальное возможное значение.
 '''height''' - Высота, если 'height' = 0, то берётся максимальное возможное значение.
 '''path''' - Путь для сохранения изображения.

== Примеры ==
--lua
printscreen (0, 0, 0, 0, 0, <nowiki>[[C:\window.jpg]]</nowiki>) -- скрин всего экрана

--lua
printscreen (0, 0, 0, 300, 300, <nowiki>[[C:\window1.jpg]]</nowiki>) -- скрин от левого верхнего угла экрана, размером 300*300

--lua
printscreen (0, 500, 500, 200, 200, <nowiki>[[C:\window2.jpg]]</nowiki>) -- скрин экрана от координат 500 500, размером 200*200

--lua
-- сделать 5 скринов с интервалом 1,5 секунды
-- сохраняются на диск C: в формате: день.месяц.год_час.минута.секунда
for _ = 1, 5 do
printscreen (0, 0, 0, 0, 0, <nowiki>[[C:\]]</nowiki> .. os.date("%d.%m.%Y") .. "_" .. os.date("%H.%M.%S") .. <nowiki>[[.jpg]]</nowiki>)
wait (1500)
end
hint ("Скрины сделаны")

'''Примеры для скринов перекрытых (не свёрнутых!) окон:'''
 Привязка к окну обязательна. Окна могут находиться за пределами экрана. Если на скрине "чёрный квадрат", значит надо указывать родительское окно.

--lua
local h = findwindow ("UoPilot") -- найти окно UoPilot
if h then -- если окно найдено
printscreen (h[1][1], 0, 0, 0, 0, <nowiki>[[C:\window4.jpg]]</nowiki>) -- скрин рабочего окна
end

--lua
local h = findwindow ("UoPilot") -- найти окно UoPilot
if h then -- если окно найдено
printscreen (h[1][1], 100, 100, 80, 80, <nowiki>[[C:\window5.jpg]]</nowiki>) -- скрин рабочего окна от координат 100 100, размером 80 на 80
end

== Смотрите также ==

[[Findimage (Lua)]]

Findimage (Lua)

2020-10-04T22:01:36Z

Cirus:

== Описание ==
'''findimage''' - поиск изображения в области заданной начальными и конечными координатами по оси XY.
 
 Формат картинки должен быть: '''bmp 24 бита.''' Цвет крайнего пикселя в левом верхнем углу изображения считается "цветом фона", и при поиске картинки на экране не учитывается. Например, цвет этого пикселя красный (255). В этом случае все пиксели красного цвета присутствующие на искомой картинке будут считаться фоновыми (прозрачными) и не будут сравниваться с тем, что присутствует на экране. Поэтому, нельзя чтобы в файле-картинке все пиксели были одного цвета. Нужно сделать, чтобы хотя бы один левый верхний пиксель цветом отличался от остальных.

== Синтаксис ==

Привязка к окну: опционально.
 Работа со свернутым окном: нет.
 Работа с перекрытым окном: Да. Привязка к окну обязательна. Aero (темы Windows, кроме Windows 10, в котором нет aero) должен быть включен. Если был установлен Астер, то он должен быть отключен, а система перезагружена.
ResultArray, a = findimage (<StartX>, <StartY>, <EndX>, <EndY>, <{filename}> [, type [, accuracy [, count [, deviation]]]] [, abs])
Где:
 '''ResultArray''' - результирующий массив, в который записываются координаты изображения. Координатами изображения считается пиксель левого верхнего угла изображения. Если найдено несколько изображений, то координаты всех найденных изображений. Каждая строка массива хранится данные по отдельному найденному изображению: в первой колонке- координата X, во второй колонке- координата Y.
 '''<a>''' - переменная, в которую записывается результат работы команды findimage:
 Если a = 0, значит поиск был произведён, но картинка не найдена.
 Если найдена только 1 картинка, то будет записан процент точности найденного изображения.
 Если найдено несколько картинок, то будет записано количество найденных изображений.
 Однозначно определить сколько именно картинок было найдено командой FindImage лучше всего по размеру массива ResultArray с помощью функции #ResultArray.
 a < 0 означает, что FindImage не смог произвести поиск- либо была обнаружена ошибка в написании параметров команды, либо проблемы с самим файлом картинки.
 Если a = -4, значит файл картинки не найден / в неправильном формате / повреждён / все пиксели файла одного цвета. Чаще всего- путь к файлу указан неправильно.
 '''StartX, StartY''' - координаты левого верхнего угла области поиска.
 '''EndX, EndY''' - координаты правого нижнего угла области поиска.
 '''{filename}''' - путь к сохранённому изображению (только файл формата bmp 24 бита). Путь к изображению может быть указан как '''абсолютный''' - {C:\\programms\\pilot\\images\\}, так '''и относительный''' - {images\\}. Указывается в фигурных скобках.
 '''type''' - тип поиска. Может принимать значения: '''1''' (надежный), '''2''' (быстрый), '''workwindow'''(поиск в окне, в том числе перекрытом). Настоятельно рекомендуется использовать быстрый способ поиска, кроме случаев с некорректным обнаружением изображения. По умолчанию 2й тип поиска. Тип workwindow - в качестве аргумента указывать хендл окна.
 '''accuracy''' - точность поиска. Указывается в процентах. Используется для отсева изображений не достаточно схожих с оригиналом. По умолчанию значение равно 80%.
 '''count''' - ограничение количества найденных изображений. По умолчанию установлено для одного изображения - значение '''1''', для всех возможных - значение '''-1'''.
 '''deviation''' - погрешность оттенка. Пример: есть погрешность 3%. Точка имеет цвет 100 120 130, 255*3%=7, соответственно 100+/-7. При этом все цвета в пределах (93 113 123)-(107 127 137) будут считаться совпадением.
 '''abs''' - флаг использования абсолютных координат. Если он указан то поиск происходит относительно левого верхнего угла экрана. Без флага поиск происходит относительно левого верхнего угла рабочего окна(привязанного через ctrl+a либо иным способом). Указывается в кавычках "abs".
 
 Если вы ищете на экране текст в виде картинки, и в системе используется сглаживание шрифтов, то могут быть проблемы с нахождением, даже если вы видите, что такой текст на экране есть. Все-равно при включенном сглаживании искомая картинка может незначительно отличаться от того что есть на экране. В этом случае рекомендуется снизить точность поиска либо отключить сглаживание шрифтов на компьютере, где используется findimage.

'''Коды ошибок FindImage:''' 
''''-1'''' упало при поиске, точная причина не известна. 
''''-2'''' не нашли открывающую скобку после имени функции. 
''''-3'''' не найдено пути в скобках. 
''''-4'''' ошибка поиска файла. 
''''-5'''' ошибка обработки искомого изображения. 
''''-6'''' ошибка получения изображения с экрана. 
''''-7'''' нечего искать, искомая картинка пустая.
 Иногда требуется сделать клик не по самому изображению, а со смещением. Указывать можно как вначале скрипта так и перед функцией findimage.
findoffsetx (50) -- смещение вправо на 50 пикселей
findoffsety (30) -- смещение вниз на 30 пикселей

findoffsetx (-40) -- смещение влево на 40 пикселей
findoffsety (-60) -- смещение вверх на 60 пикселей

== Примеры ==

--lua
local startX, startY, endX, endY = 0, 0, 1920, 1080 -- координаты поиска
local path = <nowiki>[["C:\картинка.bmp"]]</nowiki> -- путь к картинке, bmp 24 бита
local arr, a = findimage (startX, startY, endX, endY, {path}, 2) -- поиск картинки
hint (a) -- результат поиска, подсказка в правом нижнем углу
if arr then -- если найдена
log ("Изображение найдено в координатах X= " .. arr[1][1] .. " Y= " .. arr[1][2])
kleft (arr[1][1], arr[1][2]) -- кликнули
end
-- в результате работы, если в заданной области картинка обнаружена, в массив %arr[1][1] будет записано значение координаты X
-- а в %arr[1][2] - значение координаты Y

--lua
-- поиск нескольких одинаковых изображений
-- если будет найдено больше 20 поиск прекратится, точность 70%, отклонение в цвете 5%
local arr, a = findimage (0, 0, 1920, 1080, {"картинка.bmp"}, 2, 70, 20, 5) -- поиск картинки, должна быть в папке с пилотом
hint (a) -- результат поиска, подсказка в правом нижнем углу
if arr then -- если найдена
log ("Найдено картинок: " .. #arr)
for i=1, #arr do
kleft (arr[i][1], arr[i][2]) -- кликнули на каждой
wait (1000) -- пауза 1000 мсек (1 сек)
end
end

--lua
local startX, startY, endX, endY = 0, 0, 1920, 1080 -- координаты поиска
local path = <nowiki>[[C:\pilot]]</nowiki> -- путь к картинкам

local image = {"картинка", "картинка2", "картинка3"} -- массив с именами картинок, имена могут быть любыми
hint ("Всего картинок для поиска " .. #image)
for i=1, #image do -- цикл для поиска картинок
local arr, a = findimage (startX, startY, endX, endY, {path .. "\\" .. image[i] .. ".bmp"}, 2) -- поиск картинки
if arr then
move (arr[1][1], arr[1][2]) -- переместить курсор на найденную картинку
wait (500) -- ждать 0,5 секунды
end
end
'''Пример поиска картинки в перекрытом(не свёрнутом) окне:'''
 Привязка к окну обязательна. Aero (темы Windows 7) должен быть включен. Если был установлен Астер, то он должен быть отключен, а система перезагружена.
 Окно может быть перекрыто полностью, частично или вообще не перекрыто. Может находиться за пределами экрана.
 Как правило, требуется указывать родительское окно. В окне пилота есть кнопка 'F', при нажатии открывается окно, в котором отображается что "видит" пилот при поиске (Findcolor, Findimage).
--lua
local handle = findwindow ("Lineage2") -- поиск окна, вместо 'Lineage2' написать нужное имя окна
local startX, startY, endX, endY = 0, 0, 1920, 1080 -- координаты поиска
local path = <nowiki>[["C:\картинка.bmp"]]</nowiki> -- путь к картинке
if handle then
local arr, a = findimage (startX, startY, endX, endY, {path}, handle[1][1]) -- поиск картинки
hint (a) -- результат поиска, подсказка в правом нижнем углу
if arr then -- если найдена
log ("Изображение найдено в координатах X= " .. arr[1][1] .. " Y= " .. arr[1][2])
left (arr[1][1], arr[1][2], handle[1][1]) -- кликнули, left работает не во всех приложениях
-- move (arr[1][1], arr[1][2], handle[1][1]) -- навести курсор на картинку (раскомментировать строку чтобы сработало)
else
log ("Изображение не найдено")
end
else
log("Окно не найдено")
end

== Смотрите также ==

[[Findcolor (Lua)]]
 [[Color (Lua)]]

While (Lua)

2020-04-11T12:25:15Z

Cirus:

== Описание ==

'''while''' - оператор цикла. Создает цикл, который выполняется до того момента, пока условие является истиной. Выполняет операцию сравнения, а так же проверку цвета пикселя и последнего сообщения от сервера (для ultima online).
 Для отрицания сравнения используется while (not ()).
 Для выхода из цикла используются оператор break.
 Для операций сравнения используются знаки операций: >, <, ==(равно), <=, >=, ~=(не равно). Так же используются логические операторы or и and:
:or - логическое ИЛИ. Или один или другой или оба.
:and - логическое И. И один и другой.
Для указания приоритета нескольких операций используются круглые скобки: (, ).
 В конце операции необходимо поставить end для корректного выполнения сценария.

== Синтаксис ==
Привязка к окну: опционально.
 Работа со свернутым окном: частично.
while условие do
блок
end

while (not(условие)) do
блок
end

== Примеры ==

--lua
local i = 2
while i ~= 1 do
i = i * 2
msg (i)
end
-- Результатом работы является умножение значения переменной i на два, каждый раз, до того момента,
-- пока значение переменной i не станет равной единице, т.е. бесконечно.

--lua
while color(403, 234) ~= 4727808 do --пока цвет в координатах 403, 234 не будет равен 4727808
log ('---') -- вывести в лог 1
wait (10)
end
log ('+++')

--lua
-- Бесконечный цикл
-- Здесь сделаем подготовку
local count = 1
msg ("На счетчике число: " .. count .. ", будем увеличивать...")
-- А теперь зацикленная часть скрипта
while 1 == 1 do -- условие всегда будет выполняться, а значит цикл - бесконечный
count = count + 1 -- увеличим значение на 1
msg ("Теперь на счётчике число: " .. count)
end

--lua
-- Выход из цикла через break
local count = 0
while true do -- пока истина, т. е. бесконечно, тоже самое что while 1 == 1 do
count = count + 1 -- увеличим значение на 1
msg ("Теперь на счётчике число: " .. count)
if count == 3 then -- если переменная 'count' = 3
break -- выходим из цикла
end
end
msg ("Вышли из цикла")

--lua
local a = 1
while (not (a == 4)) do -- пока переменная 'a' не равна 4, тоже самое что: while a ~= 4 do
log (a)
a = a + 1 -- увеличим значение на 1
end
log (a)
log ("Вышли из цикла")

== Смотрите также ==

[[For (Lua)]]
 [[Repeat (Lua)]]
 [[Break (Lua)]]

Color (Lua)

2020-04-11T12:24:17Z

Cirus:

== Описание ==
'''Color''' - определяет цвет в заданных координатах.
Может находить цвет в перекрытых окнах.

== Синтаксис ==
Привязка к окну: опционально.
 Работа перекрытым окном: опционально.
 Работа со свернутым окном: нет.
color (<x>, <y> [, handle] [, abs])
Где:
 '''<x>''' - координата X
 '''<y>''' - координата Y
 '''[handle]''' - хендл окна. Если указать, то цвет будет определяться и в перекрытом (не свёрнутом) окне. Как правило, требуется указывать родительское окно. Если возвращается 0, скорее всего, указано не то окно.
 '''[abs]''' - использовать абсолютные координаты.
При указании сразу обоих необязательных параметров 'handle' и 'abs', точка с координатами 'x, y' должна попадать в заданное окно, иначе цвет не будет определен и команда вернет ошибку.

== Примеры ==
--lua
local a = color (150, 200) -- определить цвет в координатах 150 200
log (a)

--lua
-- определить цвет в перекрытом окне
local a = color (600, 400, workwindow()) -- определить цвет в рабочем окне в координатах 600 400
log (a)

--lua
if color(403, 234) == 4727808 then -- если в координатах 403, 234 цвет 4727808
log (1) -- вывести в лог 1
end

--lua
if color(403, 234) == 4727808 then -- если в координатах 403, 234 цвет 4727808
log (1) -- вывести в лог 1
else -- иначе
log(0) -- вывести 0
end

--lua
while color(403, 234) ~= 4727808 do --пока цвет в координатах 403, 234 не будет равен 4727808
log ('---') -- вывести в лог 1
wait (10)
end
log ('+++')

--lua
-- определить цвет в перекрытом окне
local handle = findwindow("Яндекс")
local x, y = 89, 386

if handle then -- если рабочее окно найдено
if color (x, y, handle[1][1]) == 255 then -- определить цвет в рабочем окне в координатах 89 386, если он равен 255
log ("Цвет совпал") -- показать сообщение
else
log ("Цвет не совпал")
end
else
log ("Окно не найдено")
end

== Смотрите также ==

[[Findcolor (Lua)]]
 [[Colortorgb]]

Color (Lua)

2020-04-11T12:21:35Z

Cirus:

== Описание ==
'''Color''' - определяет цвет в заданных координатах.
Может находить цвет в перекрытых окнах.

== Синтаксис ==
Привязка к окну: опционально.
 Работа перекрытым окном: опционально.
 Работа со свернутым окном: нет.
color (<x>, <y> [, handle] [, abs])
Где:
 '''<x>''' - координата X
 '''<y>''' - координата Y
 '''[handle]''' - хендл окна. Если указать, то цвет будет определяться и в перекрытом (не свёрнутом) окне. Как правило, требуется указывать родительское окно. Если возвращается 0, скорее всего, указано не то окно.
 '''[abs]''' - использовать абсолютные координаты.
При указании сразу обоих необязательных параметров 'handle' и 'abs', точка с координатами 'x, y' должна попадать в заданное окно, иначе цвет не будет определен и команда вернет ошибку.

== Примеры ==
--lua
local a = color (150, 200) -- определить цвет в координатах 150 200
log (a)

--lua
-- определить цвет в перекрытом окне
local a = color (600, 400, workwindow()) -- определить цвет в рабочем окне в координатах 600 400
log (a)

--lua
if color(403, 234) == 4727808 then -- если в координатах 403, 234 цвет 4727808
log (1) -- вывести в лог 1
end

--lua
if color(403, 234) == 4727808 then -- если в координатах 403, 234 цвет 4727808
log (1) -- вывести в лог 1
else -- иначе
log(0) -- вывести 0
end

--lua
-- определить цвет в перекрытом окне
local handle = findwindow("Яндекс")
local x, y = 89, 386

if handle then -- если рабочее окно найдено
if color (x, y, handle[1][1]) == 255 then -- определить цвет в рабочем окне в координатах 89 386, если он равен 255
log ("Цвет совпал") -- показать сообщение
else
log ("Цвет не совпал")
end
else
log ("Окно не найдено")
end

== Смотрите также ==

[[Findcolor (Lua)]]
 [[Colortorgb]]

Color (Lua)

2020-04-11T12:21:22Z

Cirus:

== Описание ==
'''Color''' - определяет цвет в заданных координатах.
Может находить цвет в перекрытых окнах.

== Синтаксис ==
Привязка к окну: опционально.
 Работа перекрытым окном: опционально.
 Работа со свернутым окном: нет.
color (<x>, <y> [, handle] [, abs])
Где:
 '''<x>''' - координата X
 '''<y>''' - координата Y
 '''[handle]''' - хендл окна. Если указать, то цвет будет определяться и в перекрытом (не свёрнутом) окне. Как правило, требуется указывать родительское окно. Если возвращается 0, скорее всего, указано не то окно.
 '''[abs]''' - использовать абсолютные координаты.
При указании сразу обоих необязательных параметров 'handle' и 'abs', точка с координатами 'x, y' должна попадать в заданное окно, иначе цвет не будет определен и команда вернет ошибку.

== Примеры ==
--lua
local a = color (150, 200) -- определить цвет в координатах 150 200
log (a)

--lua
-- определить цвет в перекрытом окне
local a = color (600, 400, workwindow()) -- определить цвет в рабочем окне в координатах 600 400
log (a)

--lua
if color(403, 234) == 4727808 then -- если в координатах 403, 234 цвет 4727808
log (1) -- вывести в лог 1
end

--lua
if color(403, 234) == 4727808 then -- если в координатах 403, 234 цвет 4727808
log (1) -- вывести в лог 1
else -- иначе
log(0) -- вывести 0
end

--lua
-- определить цвет в перекрытом окне
local handle = findwindow("Яндекс")
local x, y = 89, 386

if handle then -- если рабочее окно найдено
if color (x, y, handle[1][1]) == 255 then -- определить цвет в рабочем окне в координатах 89 386, если он равен 255
log ("Цвет совпал") -- показать сообщение
else
log ("Цвет не совпал")
end
else
log ("Окно не найдено")
end

== Смотрите также ==

[[Findcolor (Lua)]]
 [[Colortorgb]]

If (Lua)

2020-04-11T12:19:22Z

Cirus:

== Описание ==
'''if''' - условный оператор содержит логическое выражение. Позволяет выполнять определенный код в зависимости от результатов некоторого условия. Так же выполняет проверку последнего сообщения от сервера (для ultima online). Операция принимает вид сравнения.
 Если логическое выражение истинно (true) - будет выполнен код. Если ложно (false)- код выполняться не будет.
 Часто if используется в связке с else. Конструкция if-else имеет тот же вид, что if, но с дополнительной возможностью для выполнения другого кода, если условие не истинно (false).
 Для выполнения операций отрицания результата выражения: if (not (условие)).
 Для операций сравнения используются знаки операций: >, <, ==(равно), <=, >=, ~=(не равно). Так же используются логические операторы or или and.
 or- логическое ИЛИ. Или один или другой или оба.
 and- логическое И. И один и другой.
 Результатом логической операции является число 1, если результат истинный, или 0, если результат ложный.
 Для указания приоритета нескольких операций используются круглые скобки: (, ).
 В конце операции необходимо поставить end для корректного выполнения сценария.

== Синтаксис ==
Привязка к окну: опциональна.
 Работа со свернутым окном: частично.
if условие then
[строки кода]
end

if (not (условие)) then
[строки кода]
end

if условие then
[строки кода]
else
[строки кода, если условие ложно]
end

== Примеры ==

--lua
if 2 < 3 then
msg ("два меньше трех")
end
-- Результат: вывод сообщения "два меньше трех"

--lua
if 2 > 3 then
msg ("два больше трех")
else
msg ("два не может быть больше трех")
end
-- Результат: вывод сообщения "два не может быть больше трех"

--lua
if color(403, 234) == 4727808 then -- если в координатах 403, 234 цвет 4727808
log (1) -- вывести в лог 1
end

--lua
if color(403, 234) == 4727808 then -- если в координатах 403, 234 цвет 4727808
log (1) -- вывести в лог 1
else -- иначе
log(0) -- вывести 0
end

--lua
local two = 2
local five = 5
if two < five or 3 < five then
msg ("два меньше пяти или три меньше пяти")
end
-- Результат: вывод сообщения "два меньше пяти или три меньше пяти"

--lua
local num = 3
if 7 ~= 4 and num ~= 4 then
msg ("семь не равно четырём и три не равно четырём")
else
msg ("четыре и num равно семи")
end
-- Результат: вывод сообщения "семь не равно четырём и три не равно четырём"

--lua
-- Выполнение действия в определённое время
if os.date("%H:%M") == "23:14" then -- в 23:14 выполнится условие
-- тут пишем что нужно выполнить, например:
start_script (3) -- запустить скрипт номер 3
alarm () -- звуковой сигнал
stop_script () -- остановить текущий скрипт
end

== Смотрите также ==

[[While (Lua)]]
 [[For (Lua)]]

Список функций (Lua)

2020-03-03T22:52:19Z

Cirus:

== Мышка ==

:[http://uopilot.tati.pro/index.php?title=Mouse_pos_(Lua) mousepos] - получить координаты курсора мыши.
:[http://uopilot.tati.pro/index.php?title=Move_(Lua) move] - переместить курсор мыши в указанные координаты.
:[http://uopilot.tati.pro/index.php?title=Move_Smooth_(Lua) move_smooth] - плавно переместить курсор мыши в указанные координаты.
:[http://uopilot.tati.pro/index.php?title=Drag_(Lua) drag] - перенести из точки с координатами <откуда> в точку с координатами <куда>.
:'''simple (в активном и не активном окне)'''
::[http://uopilot.tati.pro/index.php?title=Left_(Lua) left] - ''клик левой кнопки мыши в указанные координаты.''
::[http://uopilot.tati.pro/index.php?title=Left_(Lua) right] - ''клик правой.''
::[http://uopilot.tati.pro/index.php?title=Left_(Lua) middle] - ''клик средней.''
::[http://uopilot.tati.pro/index.php?title=Left_(Lua) double_left] - ''двойной клик левой кнопки мыши в указанные координаты.''
::[http://uopilot.tati.pro/index.php?title=Left_(Lua) double_right] - ''двойной клик правой.''
::[http://uopilot.tati.pro/index.php?title=Left_(Lua) double_middle] - ''двойной клик средней.''
::[http://uopilot.tati.pro/index.php?title=Left_Up_(Lua) left_down] - ''зажать левую кнопку мыши.''
::[http://uopilot.tati.pro/index.php?title=Left_Up_(Lua) right_down] - ''зажать правую.''
::[http://uopilot.tati.pro/index.php?title=Left_Up_(Lua) middle_down] - ''зажать среднюю.''
::[http://uopilot.tati.pro/index.php?title=Left_Up_(Lua) left_up] - ''отпустить левую кнопку мыши.''
::[http://uopilot.tati.pro/index.php?title=Left_Up_(Lua) right_up] - ''отпустить правую.''
::[http://uopilot.tati.pro/index.php?title=Left_Up_(Lua) middle_up] - ''отпустить среднюю.''

:'''k (только в активном окне, захватывают мышь)'''
::[http://uopilot.tati.pro/index.php?title=Kleft_(Lua) kleft] - ''клик левой кнопки мыши в указанные координаты.''
::[http://uopilot.tati.pro/index.php?title=Kleft_(Lua) kright] - ''клик правой.''
::[http://uopilot.tati.pro/index.php?title=Kleft_(Lua) kmiddle] - ''клик средней.''
::[http://uopilot.tati.pro/index.php?title=Kleft_(Lua) double_kleft] - ''двойной клик левой кнопки мыши в указанные координаты.''
::[http://uopilot.tati.pro/index.php?title=Kleft_(Lua) double_kright] - ''двойной клик правой.''
::[http://uopilot.tati.pro/index.php?title=Kleft_(Lua) double_kmiddle] - ''двойной клик средней.''
::[http://uopilot.tati.pro/index.php?title=Kleft_Down_(Lua) kleft_down] - ''зажать левую кнопку мыши.''
::[http://uopilot.tati.pro/index.php?title=Kleft_Down_(Lua) kright_down] - ''зажать правую.''
::[http://uopilot.tati.pro/index.php?title=Kleft_Down_(Lua) kmiddle_down] - ''зажать среднюю.''
::[http://uopilot.tati.pro/index.php?title=Kleft_Down_(Lua) kleft_up] - ''отпустить левую кнопку мыши.''
::[http://uopilot.tati.pro/index.php?title=Kleft_Down_(Lua) kright_up] - ''отпустить правую.''
::[http://uopilot.tati.pro/index.php?title=Kleft_Down_(Lua) kmiddle_up] - ''отпустить среднюю.''

:'''wheel (эмулирует прокручивание колёсика мыши)'''
::[http://uopilot.tati.pro/index.php?title=Wheel_Up_(Lua) wheel_down] - ''прокручивание вниз.''
::[http://uopilot.tati.pro/index.php?title=Wheel_Up_(Lua) wheel_up] - ''прокручивание вверх.''
::[http://uopilot.tati.pro/index.php?title=Wheel_Up_(Lua) kwheel_down] - ''аналог Wheel_down.''
::[http://uopilot.tati.pro/index.php?title=Wheel_Up_(Lua) kwheel_up] - ''аналог Wheel_up.''
::[http://uopilot.tati.pro/index.php?title=Wheel_Up_(Lua) pwheel_down] - ''для Windows XP sp2-3 32 бит и Vista Home 32 бит).''
::[http://uopilot.tati.pro/index.php?title=Wheel_Up_(Lua) pwheel_up] - ''для Windows XP sp2-3 32 бит и Vista Home 32 бит).''

== Клавиши ==

:[http://uopilot.tati.pro/index.php?title=Getlayout_(Lua) getlayout] - позволяет получить текущую раскладку клавиатуры.
:[http://uopilot.tati.pro/index.php?title=Setlayout_(Lua) setlayout] - устанавливает язык раскладки клавиатуры для команд send, sendex.

:'''В активном и не активном окне'''
::[http://uopilot.tati.pro/index.php?title=Send_(Lua) send] - ''нажать клавишу.''
::[http://uopilot.tati.pro/index.php?title=Send_down_(Lua) send_down] - ''зажать клавишу.''
::[http://uopilot.tati.pro/index.php?title=Send_down_(Lua) send_up] - ''отпустить клавишу.''
::[http://uopilot.tati.pro/index.php?title=Send217_(Lua) send217] - ''аналог send.''
::[http://uopilot.tati.pro/index.php?title=Send_down_(Lua) send217_down] - ''аналог send_down.''
::[http://uopilot.tati.pro/index.php?title=Send_down_(Lua) send217_up] - ''аналог send_up.''
::[http://uopilot.tati.pro/index.php?title=Say_(Lua) say] - ''набрать текст.''

:'''Только в активном окне''' (Позволяют нажимать\зажимать клавиши Ctrl, Alt, Shift)
::[http://uopilot.tati.pro/index.php?title=Sendex_(Lua) sendex] - ''нажать клавишу или комбинацию клавиш.''
::[http://uopilot.tati.pro/index.php?title=Sendex_down_(Lua) sendex_down] - ''зажать клавишу или комбинацию клавиш.''
::[http://uopilot.tati.pro/index.php?title=Sendex_down_(Lua) sendex_up] - ''отпустить клавишу или комбинацию клавиш.''

== Циклы ==

:[http://uopilot.tati.pro/index.php?title=Break_(Lua) break] - ''прерывание цикла.''
:[http://uopilot.tati.pro/index.php?title=Repeat_(Lua) repeat] - ''выполняет блок кода до тех пор, пока условие не станет истинным.''
:[http://uopilot.tati.pro/index.php?title=For_(Lua) for] - ''выполняет цикл несколько раз в соответствии со значением переменной управления циклом. Также используется для обхода элементов массива/таблицы.''
:[http://uopilot.tati.pro/index.php?title=While_(Lua) while] - ''цикл, с проверкой условия.''

== Условия ==

:[http://uopilot.tati.pro/index.php?title=If_(Lua) if] - ''проверка условия истина\ложь.''

== Цвет и изображения ==
:[http://uopilot.tati.pro/index.php?title=Findimage_(Lua) findimage] - ''поиск изображения.''
:[http://uopilot.tati.pro/index.php?title=Color_(Lua) color] - ''определяет цвет в заданных координатах. Может находить цвет в перекрытых окнах.''
:[http://uopilot.tati.pro/index.php?title=Getimage_(Lua) getimage] - ''запомнить части экранной области.''
:[http://uopilot.tati.pro/index.php?title=Saveimage_(Lua) saveimage] - ''сохраняет часть экранной области из памяти.''
:[http://uopilot.tati.pro/index.php?title=Deleteimage_(Lua) deleteimage] - ''удаляет запомненную часть экранной области.''
:[http://uopilot.tati.pro/index.php?title=Loadimage_(Lua) loadimage] - ''функция загрузки изображения в память.''

== Массивы и таблицы ==

:[http://uopilot.tati.pro/index.php?title=Table.insert_(Lua) table.insert] - ''добавляет элемент в массив.''
:[http://uopilot.tati.pro/index.php?title=Table.remove_(Lua) table.remove] - ''удаляет из массива элемент.''
:[http://uopilot.tati.pro/index.php?title=Table.concat_(Lua) table.concat] - ''возвращает значения массива.''
:[http://uopilot.tati.pro/index.php?title=Unpack_(Lua) unpack] - ''возвращает значения массива.''
:[http://uopilot.tati.pro/index.php?title=Table.maxn_(Lua) table.maxn] - ''возвращает наибольший положительный числовой индекс таблицы''
:[http://uopilot.tati.pro/index.php?title=Table.sort_(Lua) table.sort] - ''сортирует массив в заданном порядке.''

== Скрипты ==

:[http://uopilot.tati.pro/index.php?title=Start_script_(Lua) start_script] - ''запустить указанный скрипт.''
:[http://uopilot.tati.pro/index.php?title=Stop_script_(Lua) stop_script] - ''остановить текущий или указанный скрипт.''
:[http://uopilot.tati.pro/index.php?title=Restart_script_(Lua) restart_script] - ''перезапуск скрипта или всех скриптов.''
:[http://uopilot.tati.pro/index.php?title=End_script_(Lua) end_script] - ''остановbnm скрипт.''
:[http://uopilot.tati.pro/index.php?title=Load_script_(Lua) load_script] - ''загрузить скрипт.''
:[http://uopilot.tati.pro/index.php?title=Current_script_(Lua) current_script] - ''переменная, возвращающая номер закладки текущего скрипта.''
:[http://uopilot.tati.pro/index.php?title=Active_script_(Lua) active_script] - ''переменная, возвращающая номер закладки активного скрипта.''
:[http://uopilot.tati.pro/index.php?title=Scripts_(Lua) scripts] - ''позволяет выяснить количество вкладок со скриптами, с занесением в массив их номеров, имен и статуса запуска.''
:[http://uopilot.tati.pro/index.php?title=Get_script_text_(Lua) get_script_text] - ''возвращает в таблицу скрипт с указанным номером, либо текущий, если номер не указан.''

== Программы ==

:[http://uopilot.tati.pro/index.php?title=Exec_(Lua) exec] - ''запуск внешнего приложения.''
:[http://uopilot.tati.pro/index.php?title=ExecAndWait_(Lua) execandwait] - ''запуск внешнего приложения и ожидание его завершения.''
:[http://uopilot.tati.pro/index.php?title=Terminate_(Lua) terminate] - ''завершает приложение.''

== Файлы ==

:[http://uopilot.tati.pro/index.php?title=Dir_(Lua) dir] - ''вывод дерева каталогов.''
:[http://uopilot.tati.pro/index.php?title=Filecopy_(Lua) filecopy] - ''копировать файл.''
:[http://uopilot.tati.pro/index.php?title=Filerename_(Lua) filerename] - ''переименовать файл.''
:[http://uopilot.tati.pro/index.php?title=Filedelete_(Lua) filedelete] - ''удалить файл.''
:[http://uopilot.tati.pro/index.php?title=Filesetdate_(Lua) filesetdate] - ''установить дату и время последнего изменения файла.''
:[http://uopilot.tati.pro/index.php?title=Filesetattr_(Lua) filesetattr] - ''установить атрибуты для файла.''
:[http://uopilot.tati.pro/index.php?title=Filegetattr_(Lua) filegetattr] - ''получить атрибуты файла.''
:[http://uopilot.tati.pro/index.php?title=Filegetdate_(Lua) filegetdate] - ''получить дату и время последнего изменения.''
:[http://uopilot.tati.pro/index.php?title=Fileexists_(Lua) fileexists] - ''возвращает 1, если файл существует, иначе 0.''
:[http://uopilot.tati.pro/index.php?title=Dircreate_(Lua) dircreate] - ''создание директории (папки/папок).''
:[http://uopilot.tati.pro/index.php?title=Dirremove_(Lua) dirremove] - ''удаление пустых каталогов (папок).''
:[http://uopilot.tati.pro/index.php?title=Write_(Lua) write] - ''дописать текст в файл.''

== Окна ==
:[http://uopilot.tati.pro/index.php?title=Findwindow_(Lua) findwindow] - ''поиск хендла окна по его заголовку или PID.''
:[http://uopilot.tati.pro/index.php?title=Workwindow_(Lua) workwindow] - ''возвращает хендл окна, к которому привязан скрипт. Привязывает скрипт к окну с указанным хендлом.''
:[http://uopilot.tati.pro/index.php?title=Workwindowpid_(Lua) workwindowpid] - ''переменная, возвращающая PID процесса, которому принадлежит рабочее окно.''
:[http://uopilot.tati.pro/index.php?title=Windowhandle_(Lua) windowhandle] - ''переменная хранящая хендл окна пилота.''
:[http://uopilot.tati.pro/index.php?title=Windowfromcursor_(Lua) windowfromcursor] - ''возвращает хэндл окна или контрола под курсором мыши.''
:[http://uopilot.tati.pro/index.php?title=Getwindow_(Lua) getwindow] - ''позволяет получить хендл активного окна или же окна относительно указанного.''
:[http://uopilot.tati.pro/index.php?title=Getfocus_(Lua) getfocus] - ''возвращает хэндл окна, имеющего фокус ввода.''
:[http://uopilot.tati.pro/index.php?title=Windowpos_(Lua) windowpos] - ''позволяет получить или установить координаты и размер окна.''
:[http://uopilot.tati.pro/index.php?title=Showwindow_(Lua) showwindow] - ''управление состоянием окна.''
:[http://uopilot.tati.pro/index.php?title=Setwindowtext_(Lua) setwindowtext] - ''изменяет заголовок указанного окна.''
:[http://uopilot.tati.pro/index.php?title=Getwindowtext_(Lua) getwindowtext] - ''возвращает заголовок указанного окна.''

== Память ==
:[http://uopilot.tati.pro/index.php?title=Readmem_(Lua) readmem] - ''чтение из памяти.''
:[http://uopilot.tati.pro/index.php?title=Writemem_(Lua) writemem] - ''запись в память.''

== Буфер ==
:[http://uopilot.tati.pro/index.php?title=Clipboard_(Lua) clipboard] - ''чтение или запись в буфера обмена.''

== Строки ==

:[http://uopilot.tati.pro/index.php?title=Tonumber_(Lua) tonumber] - ''преобразование параметра в число.''
:[http://uopilot.tati.pro/index.php?title=Tostring_(Lua) tostring] - ''конвертирует параметр любого типа в строку.''
:[http://uopilot.tati.pro/index.php?title=String.byte_(Lua) string.byte] - ''возвращает числовые коды символов.''
:[http://uopilot.tati.pro/index.php?title=String.char_(Lua) string.char] - ''возвращает строку из переданной последовательности кодов.''
:[http://uopilot.tati.pro/index.php?title=String.lower_(Lua) string.lower] - ''возвращает копию строку, в которой все буквы заменены на строчные.''
:[http://uopilot.tati.pro/index.php?title=String.upper_(Lua) string.upper] - ''возвращает копию строку, в которой все буквы заменены на заглавные.''
:[http://uopilot.tati.pro/index.php?title=String.rep_(Lua) string.rep] - ''возвращает строку, в которой содержится n копий строки.''
:[http://uopilot.tati.pro/index.php?title=String.reverse_(Lua) string.reverse] - ''возвращает строку, в которой символы строки расположены в обратном порядке.''
:[http://uopilot.tati.pro/index.php?title=String.len_(Lua) string.len] - ''возвращает длину строки.''
:[http://uopilot.tati.pro/index.php?title=String.sub_(Lua) string.sub] - ''возвращает подстроку строки.''
:[http://uopilot.tati.pro/index.php?title=String.find_(Lua) string.find] - ''возвращает позицию подстроки в строке.''
:[http://uopilot.tati.pro/index.php?title=String.match_(Lua) string.match] - ''поиск первого вхождения шаблона в строку.''
:[http://uopilot.tati.pro/index.php?title=String.gmatch_(Lua) string.gmatch] - ''возвращает итератор, который, при каждом вызове, возвращает следующее вхождение шаблона в строке.''
:[http://uopilot.tati.pro/index.php?title=String.gsub_(Lua) string.gsub] - ''возвращает копию строки, в которой все вхождения 'шаблона поиска' заменяются на 'шаблон замены'.''
:[http://uopilot.tati.pro/index.php?title=String.format_(Lua) string.format] - ''возвращает отформатированную строку.''
:[http://uopilot.tati.pro/index.php?title=Regexp_(Lua) regexp] - ''поиск позиции подстроки в строке с помощью регулярного выражения.''
:[http://uopilot.tati.pro/index.php?title=Copy_(Lua) copy] - ''копирование одного или нескольких символов из строки с указанной позиции.''
:[http://uopilot.tati.pro/index.php?title=Delete_(Lua) delete] - ''удаление одного или нескольких символов из строки с указанной позиции.''
:[http://uopilot.tati.pro/index.php?title=Insert_(Lua) insert] - ''вставка одного или нескольких символов в строку в указанную позицию.''
:[http://uopilot.tati.pro/index.php?title=String_letters_(Lua) string_letters] - ''возвращает строку, выбрасывая из неё все числа.''
:[http://uopilot.tati.pro/index.php?title=String_digits_(Lua) string_digits] - ''возвращает строку, выбрасывая из неё все буквенные символы.''
:[http://uopilot.tati.pro/index.php?title=String_count_(Lua) string_count] - ''возвращает число, показывающее сколько раз подстрока встречается в строке.''
:[http://uopilot.tati.pro/index.php?title=Trim_(Lua) trim] - ''удаляет лишние пробелы вначале и в конце строки.''
:[http://uopilot.tati.pro/index.php?title=Ltrim_(Lua)&redirect=no ltrim] - ''удаляет пробелы в начале строки.''
:[http://uopilot.tati.pro/index.php?title=Rtrim_(Lua)&redirect=no rtrim] - ''удаляет пробелы в конце строки.''

== Числа ==

:[http://uopilot.tati.pro/index.php?title=Math.random_(Lua) math.random] - ''генерирует псевдослучайное число.''
:[http://uopilot.tati.pro/index.php?title=Math.abs_(Lua) math.abs] - ''возвращает абсолютную величину (модуль) числа.''
:[http://uopilot.tati.pro/index.php?title=Math.min_(Lua) math.min] - ''возвращает минимальный из аргументов.''
:[http://uopilot.tati.pro/index.php?title=Math.max_(Lua) math.max] - ''возвращает максимальный из аргументов.''
:[http://uopilot.tati.pro/index.php?title=Math.floor_(Lua) math.floor] - ''возвращает x округлённый до ближайшего целого числа, которое меньше x.''
:[http://uopilot.tati.pro/index.php?title=Math.ceil_(Lua) math.ceil] - ''возвращает x округлённый до ближайшего целого числа, которое больше x.''
:[http://uopilot.tati.pro/index.php?title=Math.modf_(Lua) math.modf] - ''возвращает целую и дробную часть числа.''
:[http://uopilot.tati.pro/index.php?title=Math.fmod_(Lua) math.fmod] - ''возвращает остаток от деления 'x' на 'y'.''
:[http://uopilot.tati.pro/index.php?title=Math.sqrt_(Lua) math.sqrt] - ''возвращает квадратный корень.''
:[http://uopilot.tati.pro/index.php?title=Math.pow_(Lua) math.pow] - ''возвращает x в степени n. Вместо функции можно использовать x^n.''
:[http://uopilot.tati.pro/index.php?title=Math.sin_(Lua) math.sin] - ''возвращает синус угла.''
:[http://uopilot.tati.pro/index.php?title=Math.cos_(Lua) math.cos] - ''возвращает косинус угла.''
:[http://uopilot.tati.pro/index.php?title=Math.tan_(Lua) math.tan] - ''возвращает тангенс угла.''
:[http://uopilot.tati.pro/index.php?title=Math.asin_(Lua) math.asin] - ''возвращает арксинус x.''
:[http://uopilot.tati.pro/index.php?title=Math.acos_(Lua) math.acos] - ''возвращает арккосинус x.''
:[http://uopilot.tati.pro/index.php?title=Math.atan_(Lua) math.atan] - ''возвращает арктангенс x.''
:[http://uopilot.tati.pro/index.php?title=Math.deg_(Lua) math.deg] - ''преобразовывает угол, заданный в радианах, в градусы.''
:[http://uopilot.tati.pro/index.php?title=Math.rad_(Lua) math.rad] - ''преобразовывает угол, заданный в градусах, в радианы.''
:[http://uopilot.tati.pro/index.php?title=Point_distance_(Lua) point_distance] - ''возвращает расстояние между двумя точками в виде дробного числа, представленного строкой.''
:[http://uopilot.tati.pro/index.php?title=Point_direction_(Lua) point_direction] - ''возвращает угол (в градусах) между осью X и вектором с началом в точке (x1,y1) и окончанием в точке (x2,y2).''
:[http://uopilot.tati.pro/index.php?title=Lengthdir_x_(Lua) lengthdir_x] - ''возвращает горизонтальный x-катет вектора определённый указанной длиной и направлением.''
:[http://uopilot.tati.pro/index.php?title=Lengthdir_x_(Lua) lengthdir_y] - ''возвращает вертикальный y-катет вектора определённый указанной длиной и направлением.''
:[http://uopilot.tati.pro/index.php?title=Dec2hex_(Lua) dec2hex] - ''преобразует десятичное значение в шестнадцатеричное.''
:[http://uopilot.tati.pro/index.php?title=Hex2dec_(Lua) hex2dec] - ''преобразует шестнадцатеричное значение в десятичное.''

== Дата и время ==

:[http://uopilot.tati.pro/index.php?title=Os.date_(Lua) os.date] - ''возвращает дату и время в виде строки или таблицы.''
:[http://uopilot.tati.pro/index.php?title=Os.time_(Lua) os.time] - ''возвращает время в формате posix.''
:[http://uopilot.tati.pro/index.php?title=Os.clock_(Lua) os.clock] - ''возвращает время в секундах с точностью до миллисекунд с момента запуска UoPilot.''

== Вывод сообщений ==
:[http://uopilot.tati.pro/index.php?title=Logging_(Lua) logging] - ''лог.''
:[http://uopilot.tati.pro/index.php?title=Logging_(Lua) log] - ''лог, аналог logging.''
:[http://uopilot.tati.pro/index.php?title=Msg_(Lua) msg] - ''вывод сообщения.''
:[http://uopilot.tati.pro/index.php?title=Alarm_(Lua) alarm] - ''воспроизвести звук или звуковой файл.''
:[http://uopilot.tati.pro/index.php?title=Flash_(Lua) flash] - ''мигнуть в таскбаре.''

== Другие ==
:[http://uopilot.tati.pro/index.php?title=Homepath_(Lua) homepath] - ''возвращает путь к exe пилота.''
:[http://uopilot.tati.pro/index.php?title=Exefilename_(Lua) exefilename] - ''возвращает имя exe пилота.''
:[http://uopilot.tati.pro/index.php?title=Loghandle_(Lua) loghandle] - ''возвращает хендл окна лога.''
:[http://uopilot.tati.pro/index.php?title=Version_(Lua) version] - ''возвращает в массив версию пилота.''
:[http://uopilot.tati.pro/index.php?title=Wait_(Lua) wait] - ''приостанавливает выполнение текущего скрипта на указанное количество времени.''
:[http://uopilot.tati.pro/index.php?title=Printscreen_(Lua) printscreen] - ''команда сохранения копии экрана в файл.''
:[http://uopilot.tati.pro/index.php?title=Exit_(Lua) exit] - ''выход из пилота.''
:[http://uopilot.tati.pro/index.php?title=Type_(Lua) type] - ''возвращает тип параметра в виде строки.''
:[http://uopilot.tati.pro/index.php?title=Timer_(Lua) timer] - ''выполняет код через определённый промежуток времени.''
:[https://uopilot.uokit.com/wiki/index.php?title=Goto_(Lua) goto] - ''позволяет переходить к другому участку кода, обозначенному меткой.''

Goto (Lua)

2020-03-03T22:50:54Z

Cirus: Новая страница: « == Описание == '''goto''' - позволяет переходить к другому участку кода, обозначенному меткой....»

== Описание ==
'''goto''' - позволяет переходить к другому участку кода, обозначенному меткой.

== Синтаксис ==
Привязка к окну: опционально.

goto <имя_метки>
<ваш_код>
::<имя_метки>::
<имя_метки> - имя метки к которой будет осуществлен переход.
== Примеры ==

--lua
goto metka
log ("Данный оператор будет пропущен.")
::metka::
log ("Был осуществлен переход к метке.")

== Смотрите также ==

 [[Kleft (Lua)]]
 [[Exit (Lua)]]

== История развития ==

Findimage (Lua)

2019-11-15T09:40:09Z

Cirus:

== Описание ==
'''findimage''' - поиск изображения в области заданной начальными и конечными координатами по оси XY.
 
 Формат картинки должен быть: '''bmp 24 бита.''' Цвет крайнего пикселя в левом верхнем углу изображения считается "цветом фона", и при поиске картинки на экране не учитывается. Например, цвет этого пикселя красный (255). В этом случае все пиксели красного цвета присутствующие на искомой картинке будут считаться фоновыми (прозрачными) и не будут сравниваться с тем, что присутствует на экране. Поэтому, нельзя чтобы в файле-картинке все пиксели были одного цвета. Нужно сделать, чтобы хотя бы один левый верхний пиксель цветом отличался от остальных.

== Синтаксис ==

Привязка к окну: опционально.
 Работа со свернутым окном: нет.
 Работа с перекрытым окном: Да. Привязка к окну обязательна. Aero (темы Windows, кроме Windows 10, в котором нет aero) должен быть включен. Если был установлен Астер, то он должен быть отключен, а система перезагружена.
ResultArray, a = findimage (<StartX>, <StartY>, <EndX>, <EndY>, <{filename}> [, type [, accuracy [, count [, deviation]]]] [, abs])
Где:
 '''ResultArray''' - результирующий массив, в который записываются координаты изображения. Координатами изображения считается пиксель левого верхнего угла изображения. Если найдено несколько изображений, то координаты всех найденных изображений. Каждая строка массива хранится данные по отдельному найденному изображению: в первой колонке- координата X, во второй колонке- координата Y.
 '''<a>''' - переменная, в которую записывается результат работы команды findimage:
 Если a = 0, значит поиск был произведён, но картинка не найдена.
 Если найдена только 1 картинка, то будет записан процент точности найденного изображения.
 Если найдено несколько картинок, то будет записано количество найденных изображений.
 Однозначно определить сколько именно картинок было найдено командой FindImage лучше всего по размеру массива ResultArray с помощью функции #ResultArray.
 a < 0 означает, что FindImage не смог произвести поиск- либо была обнаружена ошибка в написании параметров команды, либо проблемы с самим файлом картинки.
 Если a = -4, значит файл картинки не найден / в неправильном формате / повреждён / все пиксели файла одного цвета. Чаще всего- путь к файлу указан неправильно.
 '''StartX, StartY''' - координаты левого верхнего угла области поиска.
 '''EndX, EndY''' - координаты правого нижнего угла области поиска.
 '''{filename}''' - путь к сохранённому изображению (только файл формата bmp 24 бита). Путь к изображению может быть указан как '''абсолютный''' - {C:\\programms\\pilot\\images\\}, так '''и относительный''' - {images\\}. Указывается в фигурных скобках.
 '''type''' - тип поиска. Может принимать значения: '''1''' (надежный), '''2''' (быстрый), '''workwindow'''(поиск в окне, в том числе перекрытом). Настоятельно рекомендуется использовать быстрый способ поиска, кроме случаев с некорректным обнаружением изображения. По умолчанию 2й тип поиска. Тип workwindow - в качестве аргумента указывать хендл окна.
 '''accuracy''' - точность поиска. Указывается в процентах. Используется для отсева изображений не достаточно схожих с оригиналом. По умолчанию значение равно 80%.
 '''count''' - ограничение количества найденных изображений. По умолчанию установлено для одного изображения - значение '''1''', для всех возможных - значение '''-1'''.
 '''deviation''' - погрешность оттенка. Пример: есть погрешность 3%. Точка имеет цвет 100 120 130, 255*3%=7, соответственно 100+/-7. При этом все цвета в пределах (93 113 123)-(107 127 137) будут считаться совпадением.
 '''abs''' - флаг использования абсолютных координат. Если он указан то поиск происходит относительно левого верхнего угла экрана. Без флага поиск происходит относительно левого верхнего угла рабочего окна(привязанного через ctrl+a либо иным способом). Указывается в кавычках "abs".
 
 Если вы ищете на экране текст в виде картинки, и в системе используется сглаживание шрифтов, то могут быть проблемы с нахождением, даже если вы видите, что такой текст на экране есть. Все-равно при включенном сглаживании искомая картинка может незначительно отличаться от того что есть на экране. В этом случае рекомендуется снизить точность поиска либо отключить сглаживание шрифтов на компьютере, где используется findimage.

'''Коды ошибок FindImage:''' 
''''-1'''' упало при поиске, точная причина не известна. 
''''-2'''' не нашли открывающую скобку после имени функции. 
''''-3'''' не найдено пути в скобках. 
''''-4'''' ошибка поиска файла. 
''''-5'''' ошибка обработки искомого изображения. 
''''-6'''' ошибка получения изображения с экрана. 
''''-7'''' нечего искать, искомая картинка пустая.
 Иногда требуется сделать клик не по самому изображению, а со смещением. Указывать можно как вначале скрипта так и перед функцией findimage.
findoffsetx (50) -- смещение вправо на 50 пикселей
findoffsety (30) -- смещение вниз на 30 пикселей

findoffsetx (-40) -- смещение влево на 40 пикселей
findoffsety (-60) -- смещение вверх на 60 пикселей

== Примеры ==

--lua
local startX, startY, endX, endY = 0, 0, 1920, 1080 -- координаты поиска
local path = <nowiki>[["C:\картинка.bmp"]]</nowiki> -- путь к картинке, bmp 24 бита
local arr, a = findimage (startX, startY, endX, endY, {path}, 2) -- поиск картинки
hint (a) -- результат поиска, подсказка в правом нижнем углу
if arr then -- если найдена
log ("Изображение найдено в координатах X= " .. arr[1][1] .. " Y= " .. arr[1][2])
kleft (arr[1][1], arr[1][2]) -- кликнули
end
-- в результате работы, если в заданной области картинка обнаружена, в массив %arr[1][1] будет записано значение координаты X
-- а в %arr[1][2] - значение координаты Y

--lua
-- поиск нескольких одинаковых изображений
-- если будет найдено больше 20 поиск прекратится, точность 70%, отклонение в цвете 5%
local arr, a = findimage (0, 0, 1920, 1080, {"картинка.bmp"}, 2, 70, 20, 5) -- поиск картинки, должна быть в папке с пилотом
hint (a) -- результат поиска, подсказка в правом нижнем углу
if arr then -- если найдена
log ("Найдено картинок: " .. #arr)
for i=1, #arr do
kleft (arr[i][1], arr[i][2]) -- кликнули на каждой
wait (1000) -- пауза 1000 мсек (1 сек)
end
end

--lua
local startX, startY, endX, endY = 0, 0, 1920, 1080 -- координаты поиска
local path = <nowiki>[[C:\pilot]]</nowiki> -- путь к картинкам

local image = {"картинка", "картинка2", "картинка3"} -- массив с именами картинок, имена могут быть любыми
hint ("Всего картинок для поиска " .. #image)
for i=1, #image do -- цикл для поиска картинок
local arr, a = findimage (startX, startY, endX, endY, {path .. "\\" .. image[i] .. ".bmp"}, 2) -- поиск картинки
if arr then
move (arr[1][1], arr[1][2]) -- переместить курсор на найденную картинку
wait (500) -- ждать 0,5 секунды
end
end
'''Пример поиска картинки в перекрытом(не свёрнутом) окне:'''
 Привязка к окну обязательна. Aero (темы Windows 7) должен быть включен. Если был установлен Астер, то он должен быть отключен, а система перезагружена.
 Окно может быть перекрыто полностью, частично или вообще не перекрыто. Может находиться за пределами экрана.
 Как правило, требуется указывать родительское окно. В окне пилота есть кнопка 'F', при нажатии открывается окно, в котором отображается что "видит" пилот при поиске (Findcolor, Findimage).
--lua
local handle = findwindow ("RPG") -- поиск окна, вместо 'Lineage2' написать нужное имя окна
local startX, startY, endX, endY = 0, 0, 1920, 1080 -- координаты поиска
local path = <nowiki>[["C:\картинка.bmp"]]</nowiki> -- путь к картинке
if handle then
local arr, a = findimage (startX, startY, endX, endY, {path}, handle[1][1]) -- поиск картинки
hint (a) -- результат поиска, подсказка в правом нижнем углу
if arr then -- если найдена
log ("Изображение найдено в координатах X= " .. arr[1][1] .. " Y= " .. arr[1][2])
left (arr[1][1], arr[1][2], handle[1][1]) -- кликнули, left работает не во всех приложениях
-- move (arr[1][1], arr[1][2], handle[1][1]) -- навести курсор на картинку (раскомментировать строку чтобы сработало)
else
log ("Изображение не найдено")
end
else
log("Окно не найдено")
end

== Смотрите также ==

[[Findcolor (Lua)]]
 [[Color (Lua)]]