diff --git a/Documentation/GUI.md b/Documentation/GUI.md index a5fd2f8a..7c93a326 100644 --- a/Documentation/GUI.md +++ b/Documentation/GUI.md @@ -410,3 +410,34 @@ GUI.**chart**( x, y, width, height, axisColor, axisValueColor, axisHelpersColor, | *table* | values | Таблица вида {{x = *float* x, y = *float* y}, ...} со значениями графика | Создать объект типа "график", предназначенный для отображения статистической информации в виде графика с подписью значений осей. + +Практические примеры +-------------------- + + Для закрепления работы с GUI.**window**, GUI.**panel** и GUI.**button** напишем следующий код: + +```lua +local buffer = require("doubleBuffering") +local GUI = require("GUI") + +local window = GUI.window(1, 1, buffer.screen.width, buffer.screen.height) +window:addPanel(1, 1, window.width, window.height, 0x2D2D2D) + +local y = 2 +for i = 1, 5 do + local button = window:addButton(2, y, 30, 3, 0xEEEEEE, 0x2D2D2D, 0x666666, 0xEEEEEE, "This is button " .. i) + button.onTouch = function() + GUI.error("You've pressed button " .. i .. "!") + end + y = y + button.height + 1 +end + +window:draw() +buffer.draw() +window:handleEvents() +``` +При нажатии на любую из созданных кнопок будет показываться дебаг-окно с информацией, указанной в методе *.onTouch*: + +![enter image description here](http://i90.fastpic.ru/big/2017/0402/32/90656de1b96b157284fb21e2467d9632.png) + +![enter image description here](http://i91.fastpic.ru/big/2017/0402/c3/e02d02fb39a28dd17220b535e59292c3.png) diff --git a/Documentation/compressor.lua.md b/Documentation/compressor.md similarity index 100% rename from Documentation/compressor.lua.md rename to Documentation/compressor.md diff --git a/Documentation/image.lua.md b/Documentation/image.lua.md deleted file mode 100644 index 091f6538..00000000 --- a/Documentation/image.lua.md +++ /dev/null @@ -1,146 +0,0 @@ -# image.load(string path): table image - -> Загружает существующую картинку в формате .pic и возвращает ее -> в качестве массива (таблицы). - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *string* | path | путь до картинки | - -# image.draw(int x, int y, table image) -> Рисует на экране загруженную ранее картинку по указанным координатам. - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *int* | x | позиция картинки по x | -| *int* | y | позиция картинки по y | -| *table* | image | предварительно загруженная картинка | - -# image.save(string path, table image [, int method]) -> Сохраняет указанную картинку по указанному пути в формате .pic, -> по умолчанию используя метод кодирования 3. Рекомендуется -> использовать именно его. - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *int* | path | позиция картинки по x | -| *table* | image | картинка, которую надо сохранить | -| *int* | method | метод кодирования | - -# image.transform(table image, int w, int h): table image -> Изменяет размер картинки по методу интерполяции по соседним пикселям. - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *table* | image | картинка | -| *int* | w | масштаб по ширине | -| *int* | h | масштаб по высоте | - -# image.expand(table image, string direction, int pixelcount[, int bgColor, int textColor, int transparency, char symbol]): table image -> Расширяет указанную картинку в указанном направлении (fromRight, fromLeft, fromTop, fromBottom), -> создавая при этом пустые белые пиксели. Если указаны опциональные аргументы, то вместо пустых -> пикселей могут быть вполне конкретные значения. - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *table* | image | картинка | -| *string* | direction | направление | -| *int* | pixelcount | к-во пикселей | -| *int* | bgcolor | цвет заливки | -| *int* | textcolor | цвет текста | -| *int* | transparency | непрозрачность | -| *char* | symbol | символ | - -# image.crop(table image, string direction, int pixelCount): table image -> Обрезает указанную картинку в указанном направлении (fromRight, fromLeft, fromTop, fromBottom), -> удаляя лишние пиксели. - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *table* | image | картинка | -| *string* | direction | направление | -| *int* | pixelcount | к-во пикселей | - -# image.rotate(table image, int angle): table image -> Поворачивает указанную картинку на указанный угол. Угол может иметь -> значение 90, 180 и 270 градусов. - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *table* | image | картинка | -| *int* | angle | угол | - -# image.flipVertical(table image): table image -> Отражает указанную картинку по вертикали. - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *table* | image | картинка | - -# image.flipHorizontal(table image): table image -> Отражает указанную картинку по горизонтали. - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *table* | image | картинка | - -# image.hueSaturationBrightness(table image, int hue, int sat, int brightness): table image -> Корректирует цветовой тон, насыщенность и яркость указанной картинки. -> Значения аргументов могут быть отрицательными для уменьшения параметра -> и положительными для его увеличения. Если значение, к примеру, насыщенности -> менять не требуется, просто указывайте 0. - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *table* | image | картинка | -| *int* | hue | тон | -| *int* | sat | насыщенность | -| *int* | brightness | яркость | - -> Для удобства вы можете использовать следующие сокращения: - -> image.hue(table image, int hue): table image - -> image.saturation(table image, int sat): table image - -> image.brightness(table image, int brightness): table image - -> image.blackAndWhite(table image): table image - -# image.colorBalance(table image, int r, int g, int b): table image -> Корректирует цветовые каналы изображения указанной картинки. Аргументы цветовых -> каналов могут принимать как отрицательные значения для уменьшения интенсивности канала, -> так и положительные для увеличения. - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *table* | image | картинка | -| *int* | r | красный | -| *int* | g | зелёный | -| *int* | b | синий | - -# image.invert(table image): table image -> Инвертирует цвета в указанной картинке. - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *table* | image | картинка | - -# image.photoFilter(table image, int color, int transparency): table картинка -> Накладывает на указанное изображение фотофильтр с указанной прозрачностью. -> Прозрачность может быть от 0 до 255. - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *table* | image | картинка | -| *int* | color | цвет | -| *int* | transparency | непрозрачность | - -# image.replaceColor(table image, int color, int colorToReplace): table image -> Заменяет в указанном изображении один конкретный цвет на другой. - -| Тип | Аргумент | Описание | -| ------ | ------ | ------ | -| *table* | image | картинка | -| *int* | color | цвет который нужно заменить | -| *int* | colorToReplace | цвет на который нужно заменить |