Skip to content

Manual [rus]

1Ridav edited this page Feb 27, 2019 · 26 revisions

Добро пожаловать на Penguee wiki!

Penguee позволяет автоматизировать большой спектр рутинных задач при помощи скриптов. Тестирование софта, автоматизация рутинных задач в играх, офисных приложениях и тд... Это кроссплатформенный аналог AutoIt. Penguee использует скриптовый движок Jython, который позволяет использовать простоту и лёгкость Python, а так же использовать библиотеки Java в скриптах. Открывается возможность лёгкого управления мышью, клавиатурой прямо из скрипта.

Аргументы

java -jar PengueeBot.jar

-nogui запускает программу в консольном режиме, без отрисовки GUI

-script {ScriptFileName} запускает выбранный скрипт

-forceUseGPU Принудительно использует GPGPU для поиска фрагменов (альфа тест)

Linux/Unix системы требуют запуска с полным путём до .jar файла, иначе фрагменты ищутся в домашней директории пользователя

Скрипты

Для взаимодействия с ботом требуются два класса: MatrixPosition - объект хранит в себе координаты X, Y, а так же название позиции. Используется как контейнер для хранения координат на экране. Action - объект позволяет использовать функционал движка бота из скрипта.

В процессе написания...

Фрагменты

Фрагмент - это паттерн для поиска на экране. Заранее заготовленная картинка, которую впоследствии можно попытаться найти на скриншоте экрана. Хранятся они в директории frag/ в папке бота, в виде *.bmp файлов. На данный момент существует два вида фрагментов - стандартный фрагмент и моно фрагмент.

Стандартный

Является обычной прямоугольной картинкой, находится на экране при точном совпадении всех пикселей. Поиск ведется построчно слева-направо сверху-вниз. Используется для большого количества обычных задач по поиску, где не изменяется цвет и форма. Сравнительно "дешевый" и быстрый способ найти что либо на экране.

Моно

Является специализацией стандартного фрагмента, используется в тех местах, где у искомого паттерна меняется фон. Проверяются совпадения лишь отдельных пикселей путем следования карте "прыжков". У данного типа фрагментов может быть лишь один цвет, который выбирается при их создании. Находится на экране при точном совпадении всех пикселей. Поиск ведется построчно слева-направо сверху-вниз.

Создание фрагментов

Для создания фрагмента необходимо выделить его на скриншоте и дать название. В окне Penguee перейдите во вкладку обработки скриншотов, затем нажмите на кнопку GRAB, она сделает скриншот и покажет его. Теперь левой кнопкой мыши выделите прямоугольник на скриншоте. Используйте "лупу" для более точного выделения, если потребуется. Выделенная область будет отображаться в окне рядом. После выделения, нажмите на кнопку TEST, выделенный вами регион будет найден на скриншоте и выделен красным цветом. Если вы довольны результатом, то можно сохранить нажав на SAVE и введя название, к примеру "myfirstfragment". Будет создан файл myfirstfragment.bmp в директории frag. Фрагмент готов к использованию! Создание Моно фрагмента: Все то же самое, только на выделенном фрагменте необходимо выбрать цвет, под который он будет оптимизирован, затем нажать на SHOW MONO, чтобы увидеть, какой в итоге результат будет после выбора цвета и оптимизации. Для тестового поиска на скриншоте ПКМ и выбрать Test Mono

API

https://1ridav.github.io/PengueeBot/