Описание

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

Синтаксис

Привязка к окну: опционально.
Работа со свернутым окном: Нет.
Работа с перекрытым окном: Да. Привязка к окну обязательна.

set #a FindColor (StartX StartY EndX EndY ShiftX ShiftY (RequiredColor) ResultArray ]] )

где:
<#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, в третьей найденный цвет.
(необязательно) — тип поиска. Может принимать значения «1» (надежный), «2» (быстрый) или целое число означающее хендл окна, в котором нужно вести поиск. Как правило, чаще используют «2», он тоже отлично работает.
Если вместо «2» или «1» указать «workwindow» (переменная содержащая хендл рабочего окна), то поиск будет происходить в привязанном рабочем окне (и в его относительных координатах). По сути, это третий тип поиска. При этом окно может быть частично или полностью закрыто другими окнами (но не свёрнуто!).
(необязательно)- количество найденных пикселей, после которых поиск прерывается. Если просто нужно определить наличие цвета в заданной области и не важно общее число таких пикселей, то можно указать «1» — и скорость работы команды будет оптимальной. Если параметр не указывать, то будет искаться максимальное число пикселей
(необязательно) — погрешность оттенка. Указывается в %. Например: есть погрешность 3%. Точка имеет цвет 100 120 130, 255*3%=7, соответственно 100+/-7. При этом все цвета в пределах (93 113 123)-(107 127 137) будут считаться совпадением.
(необязательно) — этот параметр указывается, если вы ищете пиксели в координатах относительно верхнего левого угла экрана. Если не указывать параметр, то поиск будет идти в координатах рабочего окна текущего скрипта.

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

set findoffsetx 50 //смещение вправо на 50 пикселей set findoffsety 30 //смещение вниз на 30 пикселей set findoffsetx -40 //смещение влево на 40 пикселей set 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 будет записано значение координаты X для первого пикселя, в %close будет записано значение координаты Y для первого пикселя, в %close — значение X для второго пикселя, в %close — значение 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 , %arr 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 , %arr 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 %a // вывод в лог координат move %a %a // переместит курсор на найденные точки 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 %arr // переместить курсор на первый найденный цвет 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
If
Get color
Color

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

2.17
Добавил функцию поиска точек определенного цвета в заданной области. Возвращает количество найденных элементов. В параметр ‘ResultArray’ заносятся их координаты.

findcolor (StartX StartY EndX EndY ShiftX ShiftY (RequiredColor) ResultArray )

где ‘type’:
1 — обычный способ (по умолчанию)
2 — альтернативный Пример:

set $a findcolor (0, 0 1024, 3 1 1 (10243328) %s 2) set #w size (%s) msg size: #w found: $a for #i 1 #w set #x %s set #y %s end_for

2.18
Исправил ‘FindColor’ для работы с линейкой.

2.19
Поправил задание цвета в findcolor с помощью переменной.
Ускорил findcolor.
Отключил преобразование найденных координат в относительные для клиентского окна в альтернативном способе поиска цвета в ‘findcolor’.

2.20
При ошибке альтернативного определения цвета в ‘findcolor’, в строковой переменной будет возвращено значение ‘-3’ (ранее возвращалось что-то типа ‘0—‘). Отрицательные значения в принципе сигнализируют об ошибке.
Отныне ‘findcolor’ ищет во всем указанном диапазоне, а не ‘до’ конечной точки. ‘set $a FindColor (10, 15 10, 15 1 1 84235 %arr)’ будет искать цвет в одной точке.
Научил ‘findcolor’ искать по диапазону цветов и по отдельным каналам цвета. Для поиска по диапазону параметры цвета задаются в круглых скобках. Можно задавать сразу несколько параметров. Ищет сразу по всем указанным параметрам. если цвет указан без скобок, то ищется точное совпадение цвета, как раньше.

‘set $a FindColor (StartX StartY EndX EndY ShiftX ShiftY (RequiredColor) ResultArray )’

Примеры задания ‘RequiredColor’:

‘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)’ — комбинированное указание искомых цветов

Добавил предельное количество точек для поиска в команде ‘findcolor’, в связи с этим слегка изменился синтаксис:

‘set $a FindColor (StartX StartY EndX EndY ShiftX ShiftY (RequiredColor) ResultArray ] )’

2.23
Поправил возвращаемый размер массива в ‘findcolor’ при ошибке поиска с результатом -1.

2.25
Переделал ‘printscreen’ и ‘findcolor’. Повысил стабильность работы.

2.27
Научил ‘findcolor’ искать цвет в перекрытых окнах. Ищет не на всем экране, а в конкретном указанном окне. Хэндл окна указывается в качестве типа поиска.

2.27.1
Подправил поиск в перекрытых окнах в командах ‘findimage’, ‘findcolor’.

2.27.2
Добавил код ошибки -4 в команде ‘findcolor’ — неправильно указан тип поиска, либо не выбрано рабочее окно.

2.32
Добавил задание диапазона цветов с помощью переменных в команде ‘findcolor (725 48 813 123 1 1 (#color2a-#color2b) %Centr2 2).
Добавил в ‘findcolor’ погрешность оттенка. Указывается в %. Слегка изменился синтаксис команды. пример: есть погрешность 3%. точка имеет цвет 100 120 130, 255*3%=7, соответственно 100+/-7. При этом все цвета в пределах (93 113 123)-(107 127 137) будут считаться совпадением.
Для учета погрешности оттенка, цвет должен быть указан в скобках, иначе погрешность будет проигнорирована.

set $a FindColor (StartX StartY EndX EndY ShiftX ShiftY (RequiredColor) ResultArray ]] )

Исправил указание цвета с помощью переменных в конструкциях типа ‘set $a findcolor (4, 1 13, 38 1 1 (B(#i)) %watch 2)’.

2.33
Починил ‘deviation’ в ‘findcolor’.
Исправил падение команды ‘findcolor’. Исправил утечки памяти.

2.34
Исправил ‘findimage’ и ‘findcolor’. Возвращали неправильные координаты по Y. Ищет слева снизу — вправо вверх.

2.35
Исправил ‘findimage’ и ‘findcolor’. Возвращали неправильные координаты.

2.36
Добавил кнопочку «F», открывающую тестовую формочку с изображением, найденным Findcolor.
Добавил возврат найденного цвета в третьем элементе массива в команде ‘findcolor’.
Добавил переменные смещения возвращаемых координат команд ‘findimage’ и ‘findcolor’:

‘findoffsetx’, ‘findoffsety’

2.38
Исправил команду ‘findcolor’. При поиске по хэндлу возвращал неправильную координату «y» (вычитал стартовую).

2.39
Вынес ‘findcolor’ из потока пилота, теперь оно меньше подтормаживает сам пилот.
Исправил ошибку в разборе строки диапазонов цветов, указанных в ‘findcolor’, когда лишние пробелы вокруг «-» приводили к недопониманию.

2.41
Добавил в функцию ‘findcolor’ поиск цвета в загруженной области.
Исправил в функции ‘findcolor’ поиск цвета в загруженной области.