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

Findcolor (Lua)

2023-08-20T19:14:18Z

Madeus: /* Синтаксис */

Findcolor (Lua)

2023-08-20T09:11:51Z

Madeus: /* Примеры */

Findcolor (Lua)

2023-08-20T09:11:25Z

Madeus: /* Примеры */

== Описание ==
'''findcolor''' - ищет пиксели определённого цвета(-ов) в заданной прямоугольной области.

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

Привязка к окну: опционально.
 Работа со свернутым окном: Нет.
 Работа с перекрытым окном: Да. Привязка к окну обязательна.
a = findcolor (StartX, StartY, EndX, EndY, ShiftX, ShiftY, '(RequiredColor)', '%ResultArray' [, type [, count [, deviation]]] [, 'abs'])
где:
 
'''<a>''' - переменная, в которую записывается количество найденных пикселей (или код ошибки меньший нуля) 
'''<StartX StartY>''' - координаты левого верхнего угла области поиска 
'''<EndX EndY>''' - координаты правого нижнего угла области поиска 
'''<ShiftX ShiftY>''' - шаг поиска по осям X и Y соответственно. Почти всегда указывают равным "1". 
'''<'(RequiredColor)'>''' - один или несколько цветов для поиска (в круглых скобках!). Могут указываться отдельные RGB каналы и/или цвета в виде значений и/или диапазонов: 
:'(84235)' - точный десятичный цвет 
:'(84235-86027)' - диапазон десятичных цветов 
:'(R(11))' - значение красного канала = 11, остальные каналы не проверяются 
:'(G(73-80))' - диапазон значений зеленого канала, остальные каналы не проверяются 
:'(R(11)+G(73-80)+B(1))' - заданы значения по всем каналам 
:'(84235, R(0), R(11)+G(73-80)+B(1))' - комбинированное указание искомых цветов 
Если в команде указывается только один десятичный цвет, то его (цвет) можно записывать без круглых скобок. 
'''<'%ResultArray'>''' - массив, в который записываются найденные значения. В каждую строку записываются координаты найденного пикселя. В 1-й колонке координата X, во 2-й координата Y, в третьей найденный цвет. 
'''[type]''' (необязательно) - тип поиска. Может принимать значения "1" (надежный), "2" (быстрый) или целое число означающее хендл окна, в котором нужно вести поиск. Как правило, чаще используют "2", он тоже отлично работает. 
Если вместо "2" или "1" указать "workwindow" (переменная содержащая хендл рабочего окна), то поиск будет происходить в привязанном рабочем окне (и в его относительных координатах). По сути, это третий тип поиска. При этом окно может быть частично или полностью закрыто другими окнами (но не свёрнуто!). 
'''[count]''' (необязательно)- количество найденных пикселей, после которых поиск прерывается. Если просто нужно определить наличие цвета в заданной области и не важно общее число таких пикселей, то можно указать "1" - и скорость работы команды будет оптимальной. Если параметр не указывать, то будет искаться максимальное число пикселей 
'''[deviation]''' !!!НЕ РАБОТАЕТ!!! 
'''['abs']''' (необязательно) - этот параметр указывается, если вы ищете пиксели в координатах относительно верхнего левого угла экрана. Если не указывать параметр, то поиск будет идти в координатах рабочего окна текущего скрипта.

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

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

== Примеры ==
--lua
-- Пример 1
a = findcolor (339, 501, 341, 631, 1, 1, '(207)', '%close', 2) -- поиск в рабочем окне
log(#close) -- вывести в лог длину массива close
Этот пример означает следующее: в текущем рабочем окне в области с координатами (339,501)-(341,631) с шагом поиска (1,1) ищутся все пиксели с десятичным цветом 207. Все найденные координаты пикселей будут записаны в массив close. Тип поиска = 2 (быстрый). 
В результате работы, если в данной области будет обнаружено 2 пикселя с цветом 207, то в элемент массива close[1][1] будет записано значение координаты X для первого пикселя, в close[1][2] будет записано значение координаты Y для первого пикселя, в close[2][1] - значение X для второго пикселя, в close[2][2] - значение Y для второго пикселя, 
В a будет записано число найденных пикселей = 2 (или 0, если бы такие пиксели не были найдены).
// Пример 2
set #b findcolor ( 339 501 341 631 1 1(207) %close 2 abs ) // поиск на экране

// Пример 3
set #c findcolor ( 339 501 341 631 1 1 (207) %close workwindow ) // поиск в рабочем окне (даже в перекрытом)

// Пример 4
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2)
if #d > 0 // если найден нужный цвет, то делаем двойной левый клик мышкой в первой найденной точке
double_left %arr [1 1], %arr [1 2]
else
msg Цвет не найден!
end_if

// Пример 5
// Использование отклонения цвета - deviation
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2 -1 3) // 2 - это тип поиска
// -1 - количество найденных пикселей (искать все)
// 3 - погрешность оттенка
if #d > 0 // если найден нужный цвет
kleft %arr [1 1], %arr [1 2]
wait 2000
else
log Цвет не найден!
end_if

// Пример 6
// Использование шага поиска
// Допустим, найти 2 одинаковых изображения в сетке 3*3.
set #a findcolor (100 100 200 200 50 50 2366701 %a) // проверить 9 точек на цвет 2366701
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
log #a // вывод в лог количества найденных цветов
if #a > 1 // если найдено больше 1 точки
for #i 1 size(%a)
log %a [#i 1] %a [#i 2] // вывод в лог координат
move %a [#i 1] %a [#i 2] // переместит курсор на найденные точки
wait 2000 // ждать 2 секунды
end_for
end_if
End_script

// Пример 7
// Использование шага поиска
set #a findcolor (100 100 200 200 50 50 (0-16777215) %arr) // получить цвета в 9 точках, сетка 3*3
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
save_array %arr C:\SaveColor.txt // сохранить массив с найденными координатами в файл 'C:\SaveColor.txt'
End_script
'''Примеры поиска цвета в перекрытом(не свёрнутом) окне:'''
 Привязка к окну обязательна. Aero (темы Windows 7) должен быть включен. Если был установлен Астер, то он должен быть отключен, а система перезагружена.
 Окно может быть перекрыто полностью, частично или вообще не перекрыто. Может находиться за пределами экрана.
 Иногда требуется указывать родительское окно. В окне пилота есть кнопка 'F', при нажатии открывается окно, в котором отображается что "видит" пилот при поиске (Findcolor, Findimage). Если в окне "чёрный квадрат", значит указано не то окно. В Windows 10 работает не во всех приложениях, может потребоваться установка Aero Glass.
// Пример 8
set #a findcolor (0 0 1920 1080 1 1 (12146182) %arr workwindow )
log #a // если в логе 0, скорее всего, надо указать родительское окно
End_script
Учтите, при указании родительского окна в качестве рабочего, клики могут быть со смещением. Используйте поиск окна [[Findwindow]] и [[Поиск пути к дочернему окну]].

// Пример 9
set #handle findwindow (Google) // поиск окна с именем Google
set #a findcolor (100 100 1000 1000 (5482548 ) %arr #handle)
log #a // количество найденных цветов
if #a > 0 // если цвет найден
move %arr [1 1] %arr [1 2] // переместить курсор на первый найденный цвет
end_if
End_script

// Пример 10
set #handle findwindow (lineage2)
set #a findcolor (18 17 243 37 1 1 (23176) %arr #handle)
log #a // количество найденных цветов
End_script

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

[[Findimage (Lua)]]
 [[Color (Lua)]]

Findcolor (Lua)

2023-08-20T09:10:59Z

Madeus: /* Синтаксис */

== Описание ==
'''findcolor''' - ищет пиксели определённого цвета(-ов) в заданной прямоугольной области.

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

Привязка к окну: опционально.
 Работа со свернутым окном: Нет.
 Работа с перекрытым окном: Да. Привязка к окну обязательна.
a = findcolor (StartX, StartY, EndX, EndY, ShiftX, ShiftY, '(RequiredColor)', '%ResultArray' [, type [, count [, deviation]]] [, 'abs'])
где:
 
'''<a>''' - переменная, в которую записывается количество найденных пикселей (или код ошибки меньший нуля) 
'''<StartX StartY>''' - координаты левого верхнего угла области поиска 
'''<EndX EndY>''' - координаты правого нижнего угла области поиска 
'''<ShiftX ShiftY>''' - шаг поиска по осям X и Y соответственно. Почти всегда указывают равным "1". 
'''<'(RequiredColor)'>''' - один или несколько цветов для поиска (в круглых скобках!). Могут указываться отдельные RGB каналы и/или цвета в виде значений и/или диапазонов: 
:'(84235)' - точный десятичный цвет 
:'(84235-86027)' - диапазон десятичных цветов 
:'(R(11))' - значение красного канала = 11, остальные каналы не проверяются 
:'(G(73-80))' - диапазон значений зеленого канала, остальные каналы не проверяются 
:'(R(11)+G(73-80)+B(1))' - заданы значения по всем каналам 
:'(84235, R(0), R(11)+G(73-80)+B(1))' - комбинированное указание искомых цветов 
Если в команде указывается только один десятичный цвет, то его (цвет) можно записывать без круглых скобок. 
'''<'%ResultArray'>''' - массив, в который записываются найденные значения. В каждую строку записываются координаты найденного пикселя. В 1-й колонке координата X, во 2-й координата Y, в третьей найденный цвет. 
'''[type]''' (необязательно) - тип поиска. Может принимать значения "1" (надежный), "2" (быстрый) или целое число означающее хендл окна, в котором нужно вести поиск. Как правило, чаще используют "2", он тоже отлично работает. 
Если вместо "2" или "1" указать "workwindow" (переменная содержащая хендл рабочего окна), то поиск будет происходить в привязанном рабочем окне (и в его относительных координатах). По сути, это третий тип поиска. При этом окно может быть частично или полностью закрыто другими окнами (но не свёрнуто!). 
'''[count]''' (необязательно)- количество найденных пикселей, после которых поиск прерывается. Если просто нужно определить наличие цвета в заданной области и не важно общее число таких пикселей, то можно указать "1" - и скорость работы команды будет оптимальной. Если параметр не указывать, то будет искаться максимальное число пикселей 
'''[deviation]''' !!!НЕ РАБОТАЕТ!!! 
'''['abs']''' (необязательно) - этот параметр указывается, если вы ищете пиксели в координатах относительно верхнего левого угла экрана. Если не указывать параметр, то поиск будет идти в координатах рабочего окна текущего скрипта.

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

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

== Примеры ==
--lua
-- Пример 1
a = findcolor (339, 501, 341, 631, 1, 1, '(207)', '%close', 2) -- поиск в рабочем окне
log(#arr) -- вывести в лог длину массива arr
Этот пример означает следующее: в текущем рабочем окне в области с координатами (339,501)-(341,631) с шагом поиска (1,1) ищутся все пиксели с десятичным цветом 207. Все найденные координаты пикселей будут записаны в массив close. Тип поиска = 2 (быстрый). 
В результате работы, если в данной области будет обнаружено 2 пикселя с цветом 207, то в элемент массива close[1][1] будет записано значение координаты X для первого пикселя, в close[1][2] будет записано значение координаты Y для первого пикселя, в close[2][1] - значение X для второго пикселя, в close[2][2] - значение Y для второго пикселя, 
В a будет записано число найденных пикселей = 2 (или 0, если бы такие пиксели не были найдены).
// Пример 2
set #b findcolor ( 339 501 341 631 1 1(207) %close 2 abs ) // поиск на экране

// Пример 3
set #c findcolor ( 339 501 341 631 1 1 (207) %close workwindow ) // поиск в рабочем окне (даже в перекрытом)

// Пример 4
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2)
if #d > 0 // если найден нужный цвет, то делаем двойной левый клик мышкой в первой найденной точке
double_left %arr [1 1], %arr [1 2]
else
msg Цвет не найден!
end_if

// Пример 5
// Использование отклонения цвета - deviation
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2 -1 3) // 2 - это тип поиска
// -1 - количество найденных пикселей (искать все)
// 3 - погрешность оттенка
if #d > 0 // если найден нужный цвет
kleft %arr [1 1], %arr [1 2]
wait 2000
else
log Цвет не найден!
end_if

// Пример 6
// Использование шага поиска
// Допустим, найти 2 одинаковых изображения в сетке 3*3.
set #a findcolor (100 100 200 200 50 50 2366701 %a) // проверить 9 точек на цвет 2366701
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
log #a // вывод в лог количества найденных цветов
if #a > 1 // если найдено больше 1 точки
for #i 1 size(%a)
log %a [#i 1] %a [#i 2] // вывод в лог координат
move %a [#i 1] %a [#i 2] // переместит курсор на найденные точки
wait 2000 // ждать 2 секунды
end_for
end_if
End_script

// Пример 7
// Использование шага поиска
set #a findcolor (100 100 200 200 50 50 (0-16777215) %arr) // получить цвета в 9 точках, сетка 3*3
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
save_array %arr C:\SaveColor.txt // сохранить массив с найденными координатами в файл 'C:\SaveColor.txt'
End_script
'''Примеры поиска цвета в перекрытом(не свёрнутом) окне:'''
 Привязка к окну обязательна. Aero (темы Windows 7) должен быть включен. Если был установлен Астер, то он должен быть отключен, а система перезагружена.
 Окно может быть перекрыто полностью, частично или вообще не перекрыто. Может находиться за пределами экрана.
 Иногда требуется указывать родительское окно. В окне пилота есть кнопка 'F', при нажатии открывается окно, в котором отображается что "видит" пилот при поиске (Findcolor, Findimage). Если в окне "чёрный квадрат", значит указано не то окно. В Windows 10 работает не во всех приложениях, может потребоваться установка Aero Glass.
// Пример 8
set #a findcolor (0 0 1920 1080 1 1 (12146182) %arr workwindow )
log #a // если в логе 0, скорее всего, надо указать родительское окно
End_script
Учтите, при указании родительского окна в качестве рабочего, клики могут быть со смещением. Используйте поиск окна [[Findwindow]] и [[Поиск пути к дочернему окну]].

// Пример 9
set #handle findwindow (Google) // поиск окна с именем Google
set #a findcolor (100 100 1000 1000 (5482548 ) %arr #handle)
log #a // количество найденных цветов
if #a > 0 // если цвет найден
move %arr [1 1] %arr [1 2] // переместить курсор на первый найденный цвет
end_if
End_script

// Пример 10
set #handle findwindow (lineage2)
set #a findcolor (18 17 243 37 1 1 (23176) %arr #handle)
log #a // количество найденных цветов
End_script

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

[[Findimage (Lua)]]
 [[Color (Lua)]]

Findcolor (Lua)

2023-08-20T09:10:43Z

Madeus: /* Примеры */

== Описание ==
'''findcolor''' - ищет пиксели определённого цвета(-ов) в заданной прямоугольной области.

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

Привязка к окну: опционально.
 Работа со свернутым окном: Нет.
 Работа с перекрытым окном: Да. Привязка к окну обязательна.
a = findcolor (StartX, StartY, EndX, EndY, ShiftX, ShiftY, '(RequiredColor)', '%ResultArray' [, type [, count [, deviation]]] [, 'abs'])
где:
 
'''<a>''' - переменная, в которую записывается количество найденных пикселей (или код ошибки меньший нуля) 
'''<StartX StartY>''' - координаты левого верхнего угла области поиска 
'''<EndX EndY>''' - координаты правого нижнего угла области поиска 
'''<ShiftX ShiftY>''' - шаг поиска по осям X и Y соответственно. Почти всегда указывают равным "1". 
'''<'(RequiredColors)'>''' - один или несколько цветов для поиска (в круглых скобках!). Могут указываться отдельные RGB каналы и/или цвета в виде значений и/или диапазонов: 
:'(84235)' - точный десятичный цвет 
:'(84235-86027)' - диапазон десятичных цветов 
:'(R(11))' - значение красного канала = 11, остальные каналы не проверяются 
:'(G(73-80))' - диапазон значений зеленого канала, остальные каналы не проверяются 
:'(R(11)+G(73-80)+B(1))' - заданы значения по всем каналам 
:'(84235, R(0), R(11)+G(73-80)+B(1))' - комбинированное указание искомых цветов 
Если в команде указывается только один десятичный цвет, то его (цвет) можно записывать без круглых скобок. 
'''<'%ResultArray'>''' - массив, в который записываются найденные значения. В каждую строку записываются координаты найденного пикселя. В 1-й колонке координата X, во 2-й координата Y, в третьей найденный цвет. 
'''[type]''' (необязательно) - тип поиска. Может принимать значения "1" (надежный), "2" (быстрый) или целое число означающее хендл окна, в котором нужно вести поиск. Как правило, чаще используют "2", он тоже отлично работает. 
Если вместо "2" или "1" указать "workwindow" (переменная содержащая хендл рабочего окна), то поиск будет происходить в привязанном рабочем окне (и в его относительных координатах). По сути, это третий тип поиска. При этом окно может быть частично или полностью закрыто другими окнами (но не свёрнуто!). 
'''[count]''' (необязательно)- количество найденных пикселей, после которых поиск прерывается. Если просто нужно определить наличие цвета в заданной области и не важно общее число таких пикселей, то можно указать "1" - и скорость работы команды будет оптимальной. Если параметр не указывать, то будет искаться максимальное число пикселей 
'''[deviation]''' !!!НЕ РАБОТАЕТ!!! 
'''['abs']''' (необязательно) - этот параметр указывается, если вы ищете пиксели в координатах относительно верхнего левого угла экрана. Если не указывать параметр, то поиск будет идти в координатах рабочего окна текущего скрипта.

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

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

== Примеры ==
--lua
-- Пример 1
a = findcolor (339, 501, 341, 631, 1, 1, '(207)', '%close', 2) -- поиск в рабочем окне
log(#arr) -- вывести в лог длину массива arr
Этот пример означает следующее: в текущем рабочем окне в области с координатами (339,501)-(341,631) с шагом поиска (1,1) ищутся все пиксели с десятичным цветом 207. Все найденные координаты пикселей будут записаны в массив close. Тип поиска = 2 (быстрый). 
В результате работы, если в данной области будет обнаружено 2 пикселя с цветом 207, то в элемент массива close[1][1] будет записано значение координаты X для первого пикселя, в close[1][2] будет записано значение координаты Y для первого пикселя, в close[2][1] - значение X для второго пикселя, в close[2][2] - значение Y для второго пикселя, 
В a будет записано число найденных пикселей = 2 (или 0, если бы такие пиксели не были найдены).
// Пример 2
set #b findcolor ( 339 501 341 631 1 1(207) %close 2 abs ) // поиск на экране

// Пример 3
set #c findcolor ( 339 501 341 631 1 1 (207) %close workwindow ) // поиск в рабочем окне (даже в перекрытом)

// Пример 4
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2)
if #d > 0 // если найден нужный цвет, то делаем двойной левый клик мышкой в первой найденной точке
double_left %arr [1 1], %arr [1 2]
else
msg Цвет не найден!
end_if

// Пример 5
// Использование отклонения цвета - deviation
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2 -1 3) // 2 - это тип поиска
// -1 - количество найденных пикселей (искать все)
// 3 - погрешность оттенка
if #d > 0 // если найден нужный цвет
kleft %arr [1 1], %arr [1 2]
wait 2000
else
log Цвет не найден!
end_if

// Пример 6
// Использование шага поиска
// Допустим, найти 2 одинаковых изображения в сетке 3*3.
set #a findcolor (100 100 200 200 50 50 2366701 %a) // проверить 9 точек на цвет 2366701
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
log #a // вывод в лог количества найденных цветов
if #a > 1 // если найдено больше 1 точки
for #i 1 size(%a)
log %a [#i 1] %a [#i 2] // вывод в лог координат
move %a [#i 1] %a [#i 2] // переместит курсор на найденные точки
wait 2000 // ждать 2 секунды
end_for
end_if
End_script

// Пример 7
// Использование шага поиска
set #a findcolor (100 100 200 200 50 50 (0-16777215) %arr) // получить цвета в 9 точках, сетка 3*3
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
save_array %arr C:\SaveColor.txt // сохранить массив с найденными координатами в файл 'C:\SaveColor.txt'
End_script
'''Примеры поиска цвета в перекрытом(не свёрнутом) окне:'''
 Привязка к окну обязательна. Aero (темы Windows 7) должен быть включен. Если был установлен Астер, то он должен быть отключен, а система перезагружена.
 Окно может быть перекрыто полностью, частично или вообще не перекрыто. Может находиться за пределами экрана.
 Иногда требуется указывать родительское окно. В окне пилота есть кнопка 'F', при нажатии открывается окно, в котором отображается что "видит" пилот при поиске (Findcolor, Findimage). Если в окне "чёрный квадрат", значит указано не то окно. В Windows 10 работает не во всех приложениях, может потребоваться установка Aero Glass.
// Пример 8
set #a findcolor (0 0 1920 1080 1 1 (12146182) %arr workwindow )
log #a // если в логе 0, скорее всего, надо указать родительское окно
End_script
Учтите, при указании родительского окна в качестве рабочего, клики могут быть со смещением. Используйте поиск окна [[Findwindow]] и [[Поиск пути к дочернему окну]].

// Пример 9
set #handle findwindow (Google) // поиск окна с именем Google
set #a findcolor (100 100 1000 1000 (5482548 ) %arr #handle)
log #a // количество найденных цветов
if #a > 0 // если цвет найден
move %arr [1 1] %arr [1 2] // переместить курсор на первый найденный цвет
end_if
End_script

// Пример 10
set #handle findwindow (lineage2)
set #a findcolor (18 17 243 37 1 1 (23176) %arr #handle)
log #a // количество найденных цветов
End_script

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

[[Findimage (Lua)]]
 [[Color (Lua)]]

Findcolor (Lua)

2023-08-20T09:10:12Z

Madeus: /* Примеры */

== Описание ==
'''findcolor''' - ищет пиксели определённого цвета(-ов) в заданной прямоугольной области.

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

Привязка к окну: опционально.
 Работа со свернутым окном: Нет.
 Работа с перекрытым окном: Да. Привязка к окну обязательна.
a = findcolor (StartX, StartY, EndX, EndY, ShiftX, ShiftY, '(RequiredColor)', '%ResultArray' [, type [, count [, deviation]]] [, 'abs'])
где:
 
'''<a>''' - переменная, в которую записывается количество найденных пикселей (или код ошибки меньший нуля) 
'''<StartX StartY>''' - координаты левого верхнего угла области поиска 
'''<EndX EndY>''' - координаты правого нижнего угла области поиска 
'''<ShiftX ShiftY>''' - шаг поиска по осям X и Y соответственно. Почти всегда указывают равным "1". 
'''<'(RequiredColors)'>''' - один или несколько цветов для поиска (в круглых скобках!). Могут указываться отдельные RGB каналы и/или цвета в виде значений и/или диапазонов: 
:'(84235)' - точный десятичный цвет 
:'(84235-86027)' - диапазон десятичных цветов 
:'(R(11))' - значение красного канала = 11, остальные каналы не проверяются 
:'(G(73-80))' - диапазон значений зеленого канала, остальные каналы не проверяются 
:'(R(11)+G(73-80)+B(1))' - заданы значения по всем каналам 
:'(84235, R(0), R(11)+G(73-80)+B(1))' - комбинированное указание искомых цветов 
Если в команде указывается только один десятичный цвет, то его (цвет) можно записывать без круглых скобок. 
'''<'%ResultArray'>''' - массив, в который записываются найденные значения. В каждую строку записываются координаты найденного пикселя. В 1-й колонке координата X, во 2-й координата Y, в третьей найденный цвет. 
'''[type]''' (необязательно) - тип поиска. Может принимать значения "1" (надежный), "2" (быстрый) или целое число означающее хендл окна, в котором нужно вести поиск. Как правило, чаще используют "2", он тоже отлично работает. 
Если вместо "2" или "1" указать "workwindow" (переменная содержащая хендл рабочего окна), то поиск будет происходить в привязанном рабочем окне (и в его относительных координатах). По сути, это третий тип поиска. При этом окно может быть частично или полностью закрыто другими окнами (но не свёрнуто!). 
'''[count]''' (необязательно)- количество найденных пикселей, после которых поиск прерывается. Если просто нужно определить наличие цвета в заданной области и не важно общее число таких пикселей, то можно указать "1" - и скорость работы команды будет оптимальной. Если параметр не указывать, то будет искаться максимальное число пикселей 
'''[deviation]''' !!!НЕ РАБОТАЕТ!!! 
'''['abs']''' (необязательно) - этот параметр указывается, если вы ищете пиксели в координатах относительно верхнего левого угла экрана. Если не указывать параметр, то поиск будет идти в координатах рабочего окна текущего скрипта.

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

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

== Примеры ==
-- Пример 1
--lua
a = findcolor (339, 501, 341, 631, 1, 1, '(207)', '%close', 2) -- поиск в рабочем окне
log(#arr) -- вывести в лог длину массива arr
Этот пример означает следующее: в текущем рабочем окне в области с координатами (339,501)-(341,631) с шагом поиска (1,1) ищутся все пиксели с десятичным цветом 207. Все найденные координаты пикселей будут записаны в массив close. Тип поиска = 2 (быстрый). 
В результате работы, если в данной области будет обнаружено 2 пикселя с цветом 207, то в элемент массива close[1][1] будет записано значение координаты X для первого пикселя, в close[1][2] будет записано значение координаты Y для первого пикселя, в close[2][1] - значение X для второго пикселя, в close[2][2] - значение Y для второго пикселя, 
В a будет записано число найденных пикселей = 2 (или 0, если бы такие пиксели не были найдены).
// Пример 2
set #b findcolor ( 339 501 341 631 1 1(207) %close 2 abs ) // поиск на экране

// Пример 3
set #c findcolor ( 339 501 341 631 1 1 (207) %close workwindow ) // поиск в рабочем окне (даже в перекрытом)

// Пример 4
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2)
if #d > 0 // если найден нужный цвет, то делаем двойной левый клик мышкой в первой найденной точке
double_left %arr [1 1], %arr [1 2]
else
msg Цвет не найден!
end_if

// Пример 5
// Использование отклонения цвета - deviation
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2 -1 3) // 2 - это тип поиска
// -1 - количество найденных пикселей (искать все)
// 3 - погрешность оттенка
if #d > 0 // если найден нужный цвет
kleft %arr [1 1], %arr [1 2]
wait 2000
else
log Цвет не найден!
end_if

// Пример 6
// Использование шага поиска
// Допустим, найти 2 одинаковых изображения в сетке 3*3.
set #a findcolor (100 100 200 200 50 50 2366701 %a) // проверить 9 точек на цвет 2366701
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
log #a // вывод в лог количества найденных цветов
if #a > 1 // если найдено больше 1 точки
for #i 1 size(%a)
log %a [#i 1] %a [#i 2] // вывод в лог координат
move %a [#i 1] %a [#i 2] // переместит курсор на найденные точки
wait 2000 // ждать 2 секунды
end_for
end_if
End_script

// Пример 7
// Использование шага поиска
set #a findcolor (100 100 200 200 50 50 (0-16777215) %arr) // получить цвета в 9 точках, сетка 3*3
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
save_array %arr C:\SaveColor.txt // сохранить массив с найденными координатами в файл 'C:\SaveColor.txt'
End_script
'''Примеры поиска цвета в перекрытом(не свёрнутом) окне:'''
 Привязка к окну обязательна. Aero (темы Windows 7) должен быть включен. Если был установлен Астер, то он должен быть отключен, а система перезагружена.
 Окно может быть перекрыто полностью, частично или вообще не перекрыто. Может находиться за пределами экрана.
 Иногда требуется указывать родительское окно. В окне пилота есть кнопка 'F', при нажатии открывается окно, в котором отображается что "видит" пилот при поиске (Findcolor, Findimage). Если в окне "чёрный квадрат", значит указано не то окно. В Windows 10 работает не во всех приложениях, может потребоваться установка Aero Glass.
// Пример 8
set #a findcolor (0 0 1920 1080 1 1 (12146182) %arr workwindow )
log #a // если в логе 0, скорее всего, надо указать родительское окно
End_script
Учтите, при указании родительского окна в качестве рабочего, клики могут быть со смещением. Используйте поиск окна [[Findwindow]] и [[Поиск пути к дочернему окну]].

// Пример 9
set #handle findwindow (Google) // поиск окна с именем Google
set #a findcolor (100 100 1000 1000 (5482548 ) %arr #handle)
log #a // количество найденных цветов
if #a > 0 // если цвет найден
move %arr [1 1] %arr [1 2] // переместить курсор на первый найденный цвет
end_if
End_script

// Пример 10
set #handle findwindow (lineage2)
set #a findcolor (18 17 243 37 1 1 (23176) %arr #handle)
log #a // количество найденных цветов
End_script

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

[[Findimage (Lua)]]
 [[Color (Lua)]]

Findcolor (Lua)

2023-08-20T09:09:26Z

Madeus:

== Описание ==
'''findcolor''' - ищет пиксели определённого цвета(-ов) в заданной прямоугольной области.

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

Привязка к окну: опционально.
 Работа со свернутым окном: Нет.
 Работа с перекрытым окном: Да. Привязка к окну обязательна.
a = findcolor (StartX, StartY, EndX, EndY, ShiftX, ShiftY, '(RequiredColor)', '%ResultArray' [, type [, count [, deviation]]] [, 'abs'])
где:
 
'''<a>''' - переменная, в которую записывается количество найденных пикселей (или код ошибки меньший нуля) 
'''<StartX StartY>''' - координаты левого верхнего угла области поиска 
'''<EndX EndY>''' - координаты правого нижнего угла области поиска 
'''<ShiftX ShiftY>''' - шаг поиска по осям X и Y соответственно. Почти всегда указывают равным "1". 
'''<'(RequiredColors)'>''' - один или несколько цветов для поиска (в круглых скобках!). Могут указываться отдельные RGB каналы и/или цвета в виде значений и/или диапазонов: 
:'(84235)' - точный десятичный цвет 
:'(84235-86027)' - диапазон десятичных цветов 
:'(R(11))' - значение красного канала = 11, остальные каналы не проверяются 
:'(G(73-80))' - диапазон значений зеленого канала, остальные каналы не проверяются 
:'(R(11)+G(73-80)+B(1))' - заданы значения по всем каналам 
:'(84235, R(0), R(11)+G(73-80)+B(1))' - комбинированное указание искомых цветов 
Если в команде указывается только один десятичный цвет, то его (цвет) можно записывать без круглых скобок. 
'''<'%ResultArray'>''' - массив, в который записываются найденные значения. В каждую строку записываются координаты найденного пикселя. В 1-й колонке координата X, во 2-й координата Y, в третьей найденный цвет. 
'''[type]''' (необязательно) - тип поиска. Может принимать значения "1" (надежный), "2" (быстрый) или целое число означающее хендл окна, в котором нужно вести поиск. Как правило, чаще используют "2", он тоже отлично работает. 
Если вместо "2" или "1" указать "workwindow" (переменная содержащая хендл рабочего окна), то поиск будет происходить в привязанном рабочем окне (и в его относительных координатах). По сути, это третий тип поиска. При этом окно может быть частично или полностью закрыто другими окнами (но не свёрнуто!). 
'''[count]''' (необязательно)- количество найденных пикселей, после которых поиск прерывается. Если просто нужно определить наличие цвета в заданной области и не важно общее число таких пикселей, то можно указать "1" - и скорость работы команды будет оптимальной. Если параметр не указывать, то будет искаться максимальное число пикселей 
'''[deviation]''' !!!НЕ РАБОТАЕТ!!! 
'''['abs']''' (необязательно) - этот параметр указывается, если вы ищете пиксели в координатах относительно верхнего левого угла экрана. Если не указывать параметр, то поиск будет идти в координатах рабочего окна текущего скрипта.

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

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

== Примеры ==
-- Пример 1
--lua
a = findcolor (339, 501, 341, 631, 1, 1, '(207)', '%close', 2) -- поиск в рабочем окне
log(#arr) -- вывести в лог длина массива arr
Этот пример означает следующее: в текущем рабочем окне в области с координатами (339,501)-(341,631) с шагом поиска (1,1) ищутся все пиксели с десятичным цветом 207. Все найденные координаты пикселей будут записаны в массив close. Тип поиска = 2 (быстрый). 
В результате работы, если в данной области будет обнаружено 2 пикселя с цветом 207, то в элемент массива close[1][1] будет записано значение координаты X для первого пикселя, в close[1][2] будет записано значение координаты Y для первого пикселя, в close[2][1] - значение X для второго пикселя, в close[2][2] - значение Y для второго пикселя, 
В a будет записано число найденных пикселей = 2 (или 0, если бы такие пиксели не были найдены).
// Пример 2
set #b findcolor ( 339 501 341 631 1 1(207) %close 2 abs ) // поиск на экране

// Пример 3
set #c findcolor ( 339 501 341 631 1 1 (207) %close workwindow ) // поиск в рабочем окне (даже в перекрытом)

// Пример 4
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2)
if #d > 0 // если найден нужный цвет, то делаем двойной левый клик мышкой в первой найденной точке
double_left %arr [1 1], %arr [1 2]
else
msg Цвет не найден!
end_if

// Пример 5
// Использование отклонения цвета - deviation
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2 -1 3) // 2 - это тип поиска
// -1 - количество найденных пикселей (искать все)
// 3 - погрешность оттенка
if #d > 0 // если найден нужный цвет
kleft %arr [1 1], %arr [1 2]
wait 2000
else
log Цвет не найден!
end_if

// Пример 6
// Использование шага поиска
// Допустим, найти 2 одинаковых изображения в сетке 3*3.
set #a findcolor (100 100 200 200 50 50 2366701 %a) // проверить 9 точек на цвет 2366701
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
log #a // вывод в лог количества найденных цветов
if #a > 1 // если найдено больше 1 точки
for #i 1 size(%a)
log %a [#i 1] %a [#i 2] // вывод в лог координат
move %a [#i 1] %a [#i 2] // переместит курсор на найденные точки
wait 2000 // ждать 2 секунды
end_for
end_if
End_script

// Пример 7
// Использование шага поиска
set #a findcolor (100 100 200 200 50 50 (0-16777215) %arr) // получить цвета в 9 точках, сетка 3*3
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
save_array %arr C:\SaveColor.txt // сохранить массив с найденными координатами в файл 'C:\SaveColor.txt'
End_script
'''Примеры поиска цвета в перекрытом(не свёрнутом) окне:'''
 Привязка к окну обязательна. Aero (темы Windows 7) должен быть включен. Если был установлен Астер, то он должен быть отключен, а система перезагружена.
 Окно может быть перекрыто полностью, частично или вообще не перекрыто. Может находиться за пределами экрана.
 Иногда требуется указывать родительское окно. В окне пилота есть кнопка 'F', при нажатии открывается окно, в котором отображается что "видит" пилот при поиске (Findcolor, Findimage). Если в окне "чёрный квадрат", значит указано не то окно. В Windows 10 работает не во всех приложениях, может потребоваться установка Aero Glass.
// Пример 8
set #a findcolor (0 0 1920 1080 1 1 (12146182) %arr workwindow )
log #a // если в логе 0, скорее всего, надо указать родительское окно
End_script
Учтите, при указании родительского окна в качестве рабочего, клики могут быть со смещением. Используйте поиск окна [[Findwindow]] и [[Поиск пути к дочернему окну]].

// Пример 9
set #handle findwindow (Google) // поиск окна с именем Google
set #a findcolor (100 100 1000 1000 (5482548 ) %arr #handle)
log #a // количество найденных цветов
if #a > 0 // если цвет найден
move %arr [1 1] %arr [1 2] // переместить курсор на первый найденный цвет
end_if
End_script

// Пример 10
set #handle findwindow (lineage2)
set #a findcolor (18 17 243 37 1 1 (23176) %arr #handle)
log #a // количество найденных цветов
End_script
== Смотрите также ==

[[Findimage (Lua)]]
 [[Color (Lua)]]

Findcolor (Lua)

2023-08-20T09:07:09Z

Madeus:

== Описание ==
'''findcolor''' - ищет пиксели определённого цвета(-ов) в заданной прямоугольной области.

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

Привязка к окну: опционально.
 Работа со свернутым окном: Нет.
 Работа с перекрытым окном: Да. Привязка к окну обязательна.
a = findcolor (StartX, StartY, EndX, EndY, ShiftX, ShiftY, '(RequiredColor)', '%ResultArray' [, type [, count [, deviation]]] [, 'abs'])
где:
 
'''<a>''' - переменная, в которую записывается количество найденных пикселей (или код ошибки меньший нуля) 
'''<StartX StartY>''' - координаты левого верхнего угла области поиска 
'''<EndX EndY>''' - координаты правого нижнего угла области поиска 
'''<ShiftX ShiftY>''' - шаг поиска по осям X и Y соответственно. Почти всегда указывают равным "1". 
'''<'(RequiredColors)'>''' - один или несколько цветов для поиска (в круглых скобках!). Могут указываться отдельные RGB каналы и/или цвета в виде значений и/или диапазонов: 
:'(84235)' - точный десятичный цвет 
:'(84235-86027)' - диапазон десятичных цветов 
:'(R(11))' - значение красного канала = 11, остальные каналы не проверяются 
:'(G(73-80))' - диапазон значений зеленого канала, остальные каналы не проверяются 
:'(R(11)+G(73-80)+B(1))' - заданы значения по всем каналам 
:'(84235, R(0), R(11)+G(73-80)+B(1))' - комбинированное указание искомых цветов 
Если в команде указывается только один десятичный цвет, то его (цвет) можно записывать без круглых скобок. 
'''<'%ResultArray'>''' - массив, в который записываются найденные значения. В каждую строку записываются координаты найденного пикселя. В 1-й колонке координата X, во 2-й координата Y, в третьей найденный цвет. 
'''[type]''' (необязательно) - тип поиска. Может принимать значения "1" (надежный), "2" (быстрый) или целое число означающее хендл окна, в котором нужно вести поиск. Как правило, чаще используют "2", он тоже отлично работает. 
Если вместо "2" или "1" указать "workwindow" (переменная содержащая хендл рабочего окна), то поиск будет происходить в привязанном рабочем окне (и в его относительных координатах). По сути, это третий тип поиска. При этом окно может быть частично или полностью закрыто другими окнами (но не свёрнуто!). 
'''[count]''' (необязательно)- количество найденных пикселей, после которых поиск прерывается. Если просто нужно определить наличие цвета в заданной области и не важно общее число таких пикселей, то можно указать "1" - и скорость работы команды будет оптимальной. Если параметр не указывать, то будет искаться максимальное число пикселей 
'''[deviation]''' !!!НЕ РАБОТАЕТ!!! 
'''['abs']''' (необязательно) - этот параметр указывается, если вы ищете пиксели в координатах относительно верхнего левого угла экрана. Если не указывать параметр, то поиск будет идти в координатах рабочего окна текущего скрипта.

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

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

== Примеры ==
-- Пример 1
--lua
a = findcolor (339, 501, 341, 631, 1, 1, '(207)', '%close', 2) -- поиск в рабочем окне

Этот пример означает следующее: в текущем рабочем окне в области с координатами (339,501)-(341,631) с шагом поиска (1,1) ищутся все пиксели с десятичным цветом 207. Все найденные координаты пикселей будут записаны в массив close. Тип поиска = 2 (быстрый). 
В результате работы, если в данной области будет обнаружено 2 пикселя с цветом 207, то в элемент массива close[1][1] будет записано значение координаты X для первого пикселя, в close[1][2] будет записано значение координаты Y для первого пикселя, в close[2][1] - значение X для второго пикселя, в close[2][2] - значение Y для второго пикселя, 
В a будет записано число найденных пикселей = 2 (или 0, если бы такие пиксели не были найдены).
// Пример 2
set #b findcolor ( 339 501 341 631 1 1(207) %close 2 abs ) // поиск на экране

// Пример 3
set #c findcolor ( 339 501 341 631 1 1 (207) %close workwindow ) // поиск в рабочем окне (даже в перекрытом)

// Пример 4
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2)
if #d > 0 // если найден нужный цвет, то делаем двойной левый клик мышкой в первой найденной точке
double_left %arr [1 1], %arr [1 2]
else
msg Цвет не найден!
end_if

// Пример 5
// Использование отклонения цвета - deviation
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2 -1 3) // 2 - это тип поиска
// -1 - количество найденных пикселей (искать все)
// 3 - погрешность оттенка
if #d > 0 // если найден нужный цвет
kleft %arr [1 1], %arr [1 2]
wait 2000
else
log Цвет не найден!
end_if

// Пример 6
// Использование шага поиска
// Допустим, найти 2 одинаковых изображения в сетке 3*3.
set #a findcolor (100 100 200 200 50 50 2366701 %a) // проверить 9 точек на цвет 2366701
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
log #a // вывод в лог количества найденных цветов
if #a > 1 // если найдено больше 1 точки
for #i 1 size(%a)
log %a [#i 1] %a [#i 2] // вывод в лог координат
move %a [#i 1] %a [#i 2] // переместит курсор на найденные точки
wait 2000 // ждать 2 секунды
end_for
end_if
End_script

// Пример 7
// Использование шага поиска
set #a findcolor (100 100 200 200 50 50 (0-16777215) %arr) // получить цвета в 9 точках, сетка 3*3
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
save_array %arr C:\SaveColor.txt // сохранить массив с найденными координатами в файл 'C:\SaveColor.txt'
End_script
'''Примеры поиска цвета в перекрытом(не свёрнутом) окне:'''
 Привязка к окну обязательна. Aero (темы Windows 7) должен быть включен. Если был установлен Астер, то он должен быть отключен, а система перезагружена.
 Окно может быть перекрыто полностью, частично или вообще не перекрыто. Может находиться за пределами экрана.
 Иногда требуется указывать родительское окно. В окне пилота есть кнопка 'F', при нажатии открывается окно, в котором отображается что "видит" пилот при поиске (Findcolor, Findimage). Если в окне "чёрный квадрат", значит указано не то окно. В Windows 10 работает не во всех приложениях, может потребоваться установка Aero Glass.
// Пример 8
set #a findcolor (0 0 1920 1080 1 1 (12146182) %arr workwindow )
log #a // если в логе 0, скорее всего, надо указать родительское окно
End_script
Учтите, при указании родительского окна в качестве рабочего, клики могут быть со смещением. Используйте поиск окна [[Findwindow]] и [[Поиск пути к дочернему окну]].

// Пример 9
set #handle findwindow (Google) // поиск окна с именем Google
set #a findcolor (100 100 1000 1000 (5482548 ) %arr #handle)
log #a // количество найденных цветов
if #a > 0 // если цвет найден
move %arr [1 1] %arr [1 2] // переместить курсор на первый найденный цвет
end_if
End_script

// Пример 10
set #handle findwindow (lineage2)
set #a findcolor (18 17 243 37 1 1 (23176) %arr #handle)
log #a // количество найденных цветов
End_script
== Смотрите также ==

[[Findimage (Lua)]]
 [[Color (Lua)]]

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

2023-08-20T09:02:23Z

Madeus: /* Цвет и изображения */

== Мышка ==

:[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=Findcolor_(Lua) findcolor] - ''поиск определённого цвета(-ов) в заданной области.''
:[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] - ''позволяет переходить к другому участку кода, обозначенному меткой.''
:[https://forum.uokit.com/index.php?act=Attach&type=post&id=2665 test] - ''ыавмавымыв''

Findcolor (Lua)

2023-08-20T08:57:57Z

Madeus: Новая страница: « == Описание == '''findcolor''' - ищет пиксели определённого цвета(-ов) в заданной прямоугольной об...»

== Описание ==
'''findcolor''' - ищет пиксели определённого цвета(-ов) в заданной прямоугольной области.

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

Привязка к окну: опционально.
 Работа со свернутым окном: Нет.
 Работа с перекрытым окном: Да. Привязка к окну обязательна.
a = findcolor (StartX, StartY, EndX, EndY, ShiftX, ShiftY, '(RequiredColor)', '%ResultArray', [type, [count, [deviation]]] [, 'abs'])
где:
 
'''<a>''' - переменная, в которую записывается количество найденных пикселей (или код ошибки меньший нуля) 
'''<StartX StartY>''' - координаты левого верхнего угла области поиска 
'''<EndX EndY>''' - координаты правого нижнего угла области поиска 
'''<ShiftX ShiftY>''' - шаг поиска по осям X и Y соответственно. Почти всегда указывают равным "1". 
'''<'(RequiredColors)'>''' - один или несколько цветов для поиска (в круглых скобках!). Могут указываться отдельные RGB каналы и/или цвета в виде значений и/или диапазонов: 
:'(84235)' - точный десятичный цвет 
:'(84235-86027)' - диапазон десятичных цветов 
:'(R(11))' - значение красного канала = 11, остальные каналы не проверяются 
:'(G(73-80))' - диапазон значений зеленого канала, остальные каналы не проверяются 
:'(R(11)+G(73-80)+B(1))' - заданы значения по всем каналам 
:'(84235, R(0), R(11)+G(73-80)+B(1))' - комбинированное указание искомых цветов 
Если в команде указывается только один десятичный цвет, то его (цвет) можно записывать без круглых скобок. 
'''<'%ResultArray'>''' - массив, в который записываются найденные значения. В каждую строку записываются координаты найденного пикселя. В 1-й колонке координата X, во 2-й координата Y, в третьей найденный цвет. 
'''[type]''' (необязательно) - тип поиска. Может принимать значения "1" (надежный), "2" (быстрый) или целое число означающее хендл окна, в котором нужно вести поиск. Как правило, чаще используют "2", он тоже отлично работает. 
Если вместо "2" или "1" указать "workwindow" (переменная содержащая хендл рабочего окна), то поиск будет происходить в привязанном рабочем окне (и в его относительных координатах). По сути, это третий тип поиска. При этом окно может быть частично или полностью закрыто другими окнами (но не свёрнуто!). 
'''[count]''' (необязательно)- количество найденных пикселей, после которых поиск прерывается. Если просто нужно определить наличие цвета в заданной области и не важно общее число таких пикселей, то можно указать "1" - и скорость работы команды будет оптимальной. Если параметр не указывать, то будет искаться максимальное число пикселей 
'''[deviation]''' !!!НЕ РАБОТАЕТ!!! 
'''['abs']''' (необязательно) - этот параметр указывается, если вы ищете пиксели в координатах относительно верхнего левого угла экрана. Если не указывать параметр, то поиск будет идти в координатах рабочего окна текущего скрипта.

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

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

== Примеры ==
// Пример 1
set #a findcolor ( 339 501 341 631 1 1 (207) %close 2 ) // поиск в рабочем окне

Этот пример означает следующее: в текущем рабочем окне в области с координатами (339,501)-(341,631) с шагом поиска (1,1) ищутся все пиксели с десятичным цветом 207. Все найденные координаты пикселей будут записаны в массив %close. Тип поиска = 2 (быстрый). 
В результате работы, если в данной области будет обнаружено 2 пикселя с цветом 207, то в элемент массива %close[1 1] будет записано значение координаты X для первого пикселя, в %close[1 2] будет записано значение координаты Y для первого пикселя, в %close[2 1] - значение X для второго пикселя, в %close[2 2] - значение Y для второго пикселя, 
В #a будет записано число найденных пикселей = 2 (или 0, если бы такие пиксели не были найдены).
// Пример 2
set #b findcolor ( 339 501 341 631 1 1(207) %close 2 abs ) // поиск на экране

// Пример 3
set #c findcolor ( 339 501 341 631 1 1 (207) %close workwindow ) // поиск в рабочем окне (даже в перекрытом)

// Пример 4
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2)
if #d > 0 // если найден нужный цвет, то делаем двойной левый клик мышкой в первой найденной точке
double_left %arr [1 1], %arr [1 2]
else
msg Цвет не найден!
end_if

// Пример 5
// Использование отклонения цвета - deviation
set #d findcolor (403, 138 973, 502 1 1 (3949430) %arr 2 -1 3) // 2 - это тип поиска
// -1 - количество найденных пикселей (искать все)
// 3 - погрешность оттенка
if #d > 0 // если найден нужный цвет
kleft %arr [1 1], %arr [1 2]
wait 2000
else
log Цвет не найден!
end_if

// Пример 6
// Использование шага поиска
// Допустим, найти 2 одинаковых изображения в сетке 3*3.
set #a findcolor (100 100 200 200 50 50 2366701 %a) // проверить 9 точек на цвет 2366701
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
log #a // вывод в лог количества найденных цветов
if #a > 1 // если найдено больше 1 точки
for #i 1 size(%a)
log %a [#i 1] %a [#i 2] // вывод в лог координат
move %a [#i 1] %a [#i 2] // переместит курсор на найденные точки
wait 2000 // ждать 2 секунды
end_for
end_if
End_script

// Пример 7
// Использование шага поиска
set #a findcolor (100 100 200 200 50 50 (0-16777215) %arr) // получить цвета в 9 точках, сетка 3*3
// координаты: 100 100, 150 100, 200 100
// 100 150, 150 150, 200 150
// 100 200, 150 200, 200 200
save_array %arr C:\SaveColor.txt // сохранить массив с найденными координатами в файл 'C:\SaveColor.txt'
End_script
'''Примеры поиска цвета в перекрытом(не свёрнутом) окне:'''
 Привязка к окну обязательна. Aero (темы Windows 7) должен быть включен. Если был установлен Астер, то он должен быть отключен, а система перезагружена.
 Окно может быть перекрыто полностью, частично или вообще не перекрыто. Может находиться за пределами экрана.
 Иногда требуется указывать родительское окно. В окне пилота есть кнопка 'F', при нажатии открывается окно, в котором отображается что "видит" пилот при поиске (Findcolor, Findimage). Если в окне "чёрный квадрат", значит указано не то окно. В Windows 10 работает не во всех приложениях, может потребоваться установка Aero Glass.
// Пример 8
set #a findcolor (0 0 1920 1080 1 1 (12146182) %arr workwindow )
log #a // если в логе 0, скорее всего, надо указать родительское окно
End_script
Учтите, при указании родительского окна в качестве рабочего, клики могут быть со смещением. Используйте поиск окна [[Findwindow]] и [[Поиск пути к дочернему окну]].

// Пример 9
set #handle findwindow (Google) // поиск окна с именем Google
set #a findcolor (100 100 1000 1000 (5482548 ) %arr #handle)
log #a // количество найденных цветов
if #a > 0 // если цвет найден
move %arr [1 1] %arr [1 2] // переместить курсор на первый найденный цвет
end_if
End_script

// Пример 10
set #handle findwindow (lineage2)
set #a findcolor (18 17 243 37 1 1 (23176) %arr #handle)
log #a // количество найденных цветов
End_script
== Смотрите также ==

[[Findimage (Lua)]]
 [[Color (Lua)]]