<meta charset="UTF-8">

<link href="style.css" rel="stylesheet" type="text/css">

<title>Рисование - Helianthus</title>

  
Helianthus

  
Запуск и общие функции

  
Клавиатура и мышь

  
Рисование

  
Спрайты

  
Группы спрайтов

  
Камера

  
Звук

  
Все функции

Рисование

Перечисленные ниже функцию позволяют рисовать на экране различные фигуры и текст.

Для указания цвета используется его текстовое наименование.

Вот список наименований:

    "transparent",

    "black",

    "white",

    "gray",

    "red",

    "green",

    "blue",

    "yellow",

    "magenta",

    "cyan",

    "yellow",

    "magenta",

    "cyan",

    "brown".

Также поддерживаются цвета в кодировка #RRGGBBAA:

    #000000 — чёрный;

    #ff0000 — красный;

    #0000ff — синий;

    #00ff00aa — зелёный полупрозрачный.

Вы можете сгенерировать текстовое наименования для любого цвета по его числовым составляющим при помощи функций rgb и rgba.

Для рисования линий и многоугольников используются функции moveTo, lineTo, closePath, strokePath. При этом функции stroke и fill задают цвет линий и заливки. Функция strokeWeight задаёт толщину линий. Вот пример рисования красного треугольника с чёрным контуром:

fill("red");

stroke("black");

strokeWeight(10);

moveTo(100, 300);

lineTo(300, 300);

lineTo(50, 200);

closePath();

Также существуют отдельные функции для рисования прямоугольников, линий, эллипсов и дуг окружности, смотрите описания функций ниже.

Для вывода текста используются функции text, textAlign, textFont и textSize. Смотрите их описание ниже.

Функции:

void background(const char *color);

Установить цвет фона. Начиная со следующего все кадры будут рисоваться на выбранном фоне.

Параметры:

color — текстовое наименование цвета.

void fill(const char *color);

Установить цвет заливки. После вызова этой функции все фигуры будут заполняться выбранным цветом. См. также noFill.

Параметры:

color — текстовое наименование цвета.

void noFill();

Отключить заливку фигур. После вызова этой функции все фигуры будут рисоваться без заполнения. См. также fill.

void stroke(const char *color);

Установить цвет контура. После вызова этой функции все фигуры будут рисоваться с контуром выбранного цвета. Также эта функция задаёт цвет рисования текста См. также noStroke.

Параметры:

color — текстовое наименование цвета.

void noStroke();

Отключить рисование контура. После вызова этой функции все фигуры будут рисоваться без прорисовки контура. См. также stroke.

Важно: Так как текст рисуется цветом контура, эта функция полностью отключает вывод текста.

void strokeWeight(double weight);

Установить толщину линий и контуров. После вызова этой функции все линии и контуры будут рисоваться с заданной толщиной.

Параметры:

weight — толщина линии.

char* rgb(double r, double g, double b);

Функция возвращает текстовое наименование цвета для заданных числовых значений яркости красной, зелёной и синей составляющих.

Параметры:

r — яркость красной составляющей цвета, дробное число от 0 до 1;

g — яркость зелёной составляющей цвета, дробное число от 0 до 1;

b — яркость синей составляющей цвета, дробное число от 0 до 1.

char* rgba(double r, double g, double b, double a);

Функция возвращает текстовое наименование цвета для заданных числовых значений яркости красной, зелёной и синей составляющих, а также прозрачности.

Параметры:

r — яркость красной составляющей цвета, дробное число от 0 до 1;

g — яркость зелёной составляющей цвета, дробное число от 0 до 1;

b — яркость синей составляющей цвета, дробное число от 0 до 1;

a — прозрачность, дробное число от 0 до 1, при этом 0 — цвет полностью прозрачный, 1 — цвет непрозрачный.

void moveTo(double x, double y);

Начать рисование новой фигуры, и задать начальное положение пера. Перед запуском этой функции убедитесь что вы завершили рисование предыдущей фигуры функцией closePath или strokePath.

Параметры:

x, y — координаты в которые будет помещено перо.

void lineTo(double x, double y);

Наметить линию от текущих координат пера до заданной точки, а также перевести перо в указанною точку. Настоящая линия будет нарисована позже при помощи функции closePath или strokePath. См. также функцию moveTo.

Важно: если положение пера не было задано, то линия не намечается, вместо этого просто задаётся начальное положение пера.

void resetPath();

Убрать все намеченные функцией lineTo или arcPath линии и отменить их рисование. Положение пера также забывается.

void closePath();

Завершить контур соединив начальную и конечную точки линией и нарисовать заполненную фигуру с контуром. Цвета заполнения и контура задаются функциями fill и stroke. См. также функции moveTo и lineTo. После вывода фигуры на экран положение пера и все намеченные линии забываются.

void strokePath();

Нарисовать ранее намеченные линии. В отличии от функции closePath, данная функция не соединяет начальную и конечную точки, а просто рисует только те линии которые были намечены. Цвет контура задаётся функцией stroke, а вот заполнение цветом не производится. После вывода намеченных линий на экран, их расположение и позиция пера забываются.

void rect(double x, double y, double width, double height);

Нарисовать прямоугольник. Цвета заполнения и контура задаются заранее функциями fill и stroke.

Параметры:

x, y — координаты левого верхнего угла прямоугольника;

width — ширина прямоугольника;

height — высота прямоугольника.

void ellipse(double x, double y, double width, double height);

Нарисовать эллипс. Эллипс рисуется таким чтобы от вписался в ограничивающий прямоугольник (см. функцию rect). Следовательно для того чтобы нарисовать окружность нужно передать одинаковую ширину и высоту ограничивающего прямоугольника. Цвета заполнения и контура задаются заранее функциями fill и stroke.

Параметры:

x, y — координаты левого верхнего угла ограничивающего прямоугольника;

width — ширина ограничивающего прямоугольника;

height — высота ограничивающего прямоугольника.

void arc(double x, double y, double w, double h, double start, double stop);

Нарисовать дугу эллипса заданного ограничивающим прямоугольником. Дуга задаётся значением начального и конечного угла. Цвет линии задаётся функцией stroke.

Параметры:

x, y — координаты левого верхнего угла ограничивающего прямоугольника;

width — ширина ограничивающего прямоугольника;

height — высота ограничивающего прямоугольника;

start — начальный угол в градусах;

end — конечный угол в градусах.

void arcPath(double x, double y, double w, double h, double start, double stop);

Наметить дугу эллипса заданного ограничивающим прямоугольником так как если бы она рисовалась функциями moveTo и lineTo. Дуга задаётся значением начального и конечного угла. Окончательное рисование будет выполнено после вызова функции closePath или strokePath.

Параметры:

x, y — координаты левого верхнего угла ограничивающего прямоугольника;

width — ширина ограничивающего прямоугольника;

height — высота ограничивающего прямоугольника;

start — начальный угол в градусах;

end — конечный угол в градусах.

void line(double x1, double y1, double x2, double y2);

Провести прямую линию от первой указанной точки до второй. Цвет линии задаётся функцией stroke.

Параметры:

x1, y1 — координаты первой точки;

x2, y2 — координаты второй точки.

void point(double x, double y);

Нарисовать точку в указанных координатах. Цвет задаётся функцией stroke. Диаметр точки задаётся функцией strokeWeight.

Параметры:

x, y — координаты точки.

void regularPolygon(double x, double y, int sides, double size);

Нарисовать правильный многоугольник заданного размера с центром в указанной точке. Цвета заполнения и контура задаются функциями fill и stroke.

Параметры:

x, y — координаты центра многоугольника;

sides — количество сторон;

size — размер многоугольника — диаметр описанной окружности.

void text(const char *text, double x, double y);

Вывести текст в заданной точке. Расположение текста относительно указанной точки задаётся функцией textAlign. Шрифи и размер задаются функциями textFont и textSize. Цвет текста задаётся функцией stroke.

Параметры:

text — текст для вывода;

x, y — координаты начальной точки.

void textAlign(HAlign hor, VAlign vert);

Установить расположение текста относительно начальной точки (см. функцию text)

Параметры:

hor — горизонтальное расположение начальной точки текста, может принимать значения:

    HALIGN_LEFT — начальная точка находится по левому краю текста;

    HALIGN_CENTER — начальная точка находится в середине текста;

    HALIGN_RIGHT — начальная точка находится по правому краю текста.

vert — вертикальное расположение начальной точки текста, может принимать значения:

    VALIGN_TOP — начальная точка находится по верхнему краю текста;

    VALIGN_CENTER — начальная точка находится в середине текста;

    VALIGN_BOTTOM — начальная точка находится по нижнему краю текста.

void textFont(const char *font);

Установить шрифт для текста (см. функцию text). Указанный шрифт должен быть установлен в системе. Можете посмотреть списки шрифтов в любом установленном на вашем компьютере текстовом редакторе.

Параметры:

font — текстовое наименование шрифта.

void textSize(double size);

Установить размер текста (см. функцию text).

Параметры:

size — размер текста в пикселях.