Рисование

<head>

Ivan Mahonin

<meta charset="UTF-8" />

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

</head>

Ivan Mahonin

<body>

Ivan Mahonin

Ivan Mahonin

  Helianthus

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

  Рисование

Ivan Mahonin

  Шрифты и текст

Ivan Mahonin

  Текстуры и анимация

Ivan Mahonin

  Буфер кадра

Ivan Mahonin

  Спрайты

Ivan Mahonin

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

Ivan Mahonin

  Звук

Ivan Mahonin

Ivan Mahonin

  Все функции

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

Рисование

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Для указания цвета используется его числовой код. Код можно записать в виде шестнадцатеричного числа, например: 0xFF0000AA — это полупрозрачный красный (также как #FF0000 в формате web/CSS3, только с добавлением двух цифр альфа-канала в конце). Однако проще всего получить код используя вспомогательные функции: colorByName, colorByRGB, colorByHSV, colorByYUV, а также их аналоги с альфа-каналом: colorByNameA, colorByRGBA, colorByHSVA, colorByYUVA.

Ivan Mahonin

Ivan Mahonin

Вы можете также провести и обратную операцию — извлечь данные отдельных цветовых каналов из кода цвета, см. функции: colorGetRed, colorGetGreen, colorGetBlue, colorGetAlpha, colorGetHue, colorGetSaturation, colorGetValue, colorGetYLuminance, colorGetUChromanance, colorGetVChromanance.

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

fill("red");

Ivan Mahonin

stroke("black");

Ivan Mahonin

strokeWeight(10);

Ivan Mahonin

moveTo(100, 300);

Ivan Mahonin

lineTo(300, 300);

Ivan Mahonin

lineTo(50, 200);

Ivan Mahonin

closePath();

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

Также существуют отдельные функции для рисования точек (point), линий (line), прямоугольников (rect), правильных многоугольников (regularPolygon), эллипсов (ellipse) и дуг окружности (arc), смотрите описания функций ниже.

Ivan Mahonin

Ivan Mahonin

Для очистки экрана используйте функцию clear. Функция background задаёт цвет фона — функция clear закрасит все пиксели именно этим цветом. Обратите внимание, что перед рисованием очередного кадра картинка полностью затирается цветом фона. Если вам необходимо сохранять картинку, то вам либо придётся повторить все операции рисования выполненные ранее или обратиться к разделам «Буфер кадра» и «Текстуры и анимация», чтобы узнать, как можно рисовать не на экран, а в текстуру.

Ivan Mahonin

Ivan Mahonin

Для рисования текста см. раздел «Шрифты и текст».

Ivan Mahonin

Ivan Mahonin

Трансформации и прочие преобразования

Ivan Mahonin

Ivan Mahonin

Перед рисованием вы можете сместить, повернуть или растянуть выводимое изображение при помощи функций соответственно: translate, rotate и scale. Таким образом вы можете как бы изменить позицию камеры. Отменить все вышеуказанные трансформации можно вызвав функцию noTransform. Указанные функции меняют текущую матрицу OpenGL, если вы знакомы с OpenGL, то можете менять матрицы напрямую — на работу Helianthus это не повлияет.

Ivan Mahonin

Ivan Mahonin

Также вы можете ограничить область рисования задав прямоугольник отсечения — cliprect.

Ivan Mahonin

Ivan Mahonin

Также обратите внимание на функции saveState и restoreState. Они позволяют соответственно сохранить действующие в данный момент преобразование и затем вернуться к сохранённому состоянию.

Ivan Mahonin

Ivan Mahonin

Функция resetState отменяет все преобразования.

Ivan Mahonin

Ivan Mahonin

Фукнции saveState, restoreState и resetState затрагивают также выбранный шрифт (см. textFont), выбранный буфер кадра (см. target), матрицу проекции (см. projectionByVireport) и координаты области рисования (см. viewportByFramebuffer, viewportByWindow).

Ivan Mahonin

Ivan Mahonin

Взаимодействие с OpenGL

Ivan Mahonin

Ivan Mahonin

Helianthus использует библиотеку OpenGL для рисования. Вы тоже можете использовать функции OpenGL в своих программах. Helianthus спроектирована так чтобы минимально влиять на состояние OpenGL, так чтобы вы могли полноценно использовать все функции библиотеки OpenGL, если вы того захотите. Например, если вы вызвали функцию translate, то изменится только текущая матрица OpenGL, обычно, это матрица модели.

Ivan Mahonin

Ivan Mahonin

Вы можете также использовать рисование в 3D, в этом случае, если вы обратитесь к 2D функциям Helianthus — они будут выполнены в плоскости XY и координата Z будет принята равной нулю.

Ivan Mahonin

Ivan Mahonin

Функции:

Ivan Mahonin

Ivan Mahonin

unsigned int colorByName(const char *colorName);

Ivan Mahonin

Ivan Mahonin

Функция генерирует код цвета по его текстовому наименованию в соответствии с CSS3.

Ivan Mahonin

Ivan Mahonin

Вот примеры наименований:

Ivan Mahonin

    "transparent" — прозрачный,

Ivan Mahonin

    "black" — чёрный,

Ivan Mahonin

    "white" — белый,

Ivan Mahonin

    "gray" — серый,

Ivan Mahonin

    "red" — красный,

Ivan Mahonin

    "green" — зелёный,

Ivan Mahonin

    "blue" — синий,

Ivan Mahonin

    "yellow" — жёлтый,

Ivan Mahonin

    "brown" — коричневый.

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

    #000000 — чёрный;

Ivan Mahonin

    #ff0000 — красный;

Ivan Mahonin

    #0000ff — синий;

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

unsigned int colorByNameA(const char *colorName, double a);

Ivan Mahonin

Ivan Mahonin

Генерирует код цвета по его текстовому наименованию с применением прозрачности (alpha). См. также colorByName. Если в текстовом наименовании уже заключён цвет с прозрачностью (alpha) то значения альфа-канала будут перемножены.

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

colorName — текстовое наименование цвета;

Ivan Mahonin

a — альфа-канал, степень непрозрачности от 0 до 1, где 0 — полностью прозрачный, 1 — полностью непрозрачный.

Ivan Mahonin

Ivan Mahonin

unsigned int colorByRGB(double r, double g, double b);

Ivan Mahonin

Ivan Mahonin

Генерирует код цвета по трём цветовым составляющим — красный, зелёный, синий. Генерируется полностью непрозрачный цвет (альфа-канал равен 1). См. также colorByRGBA.

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

r — красная составляющая, от 0 до 1;

Ivan Mahonin

g — зелёная составляющая, от 0 до 1;

Ivan Mahonin

b — синяя составляющая, от 0 до 1.

Ivan Mahonin

Ivan Mahonin

unsigned int colorByRGBA(double r, double g, double b, double a);

Ivan Mahonin

Ivan Mahonin

Генерирует код цвета по трём цветовым составляющим — красный, зелёный, синий — и прозрачности — альфа-канал. См. также colorByRGB.

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

r — красная составляющая, от 0 до 1;

Ivan Mahonin

g — зелёная составляющая, от 0 до 1;

Ivan Mahonin

b — синяя составляющая, от 0 до 1;

Ivan Mahonin

a — альфа-канал, степень непрозрачности от 0 до 1, где 0 — полностью прозрачный, 1 — полностью непрозрачный.

Ivan Mahonin

Ivan Mahonin

unsigned int colorByHSV(double h, double s, double v);

Ivan Mahonin

Ivan Mahonin

Генерирует код цвета по трём составляющим в системе HSV — оттенок (hue), цветность (saturation), яркость (value). Генерируется полностью непрозрачный цвет (альфа-канал равен 1). См. также colorByHSVA.

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

h — оттенок (hue) в градусах на цветовом круге, обычно от 0 до 360;

Ivan Mahonin

s — цветность (saturation), от 0 до 1;

Ivan Mahonin

v — яркость, от 0 до 1.

Ivan Mahonin

Ivan Mahonin

unsigned int colorByHSVA(double h, double s, double v, double a);

Ivan Mahonin

Ivan Mahonin

Генерирует код цвета по трём составляющим в системе HSV — оттенок (hue), цветность (saturation), яркость (value) — и прозрачности (alpha). См. также colorByHSV.

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

h — оттенок (hue) в градусах на цветовом круге, обычно от 0 до 360;

Ivan Mahonin

s — цветность (saturation), от 0 до 1;

Ivan Mahonin

v — яркость, от 0 до 1;

Ivan Mahonin

a — альфа-канал, степень непрозрачности от 0 до 1, где 0 — полностью прозрачный, 1 — полностью непрозрачный.

Ivan Mahonin

Ivan Mahonin

unsigned int colorByYUV(double y, double u, double v);

Ivan Mahonin

Ivan Mahonin

Генерирует код цвета по трём составляющим в системе YUV. Генерируется полностью непрозрачный цвет (альфа-канал равен 1). См. также colorByYUVA.

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

y — яркость, от 0 до 1;

Ivan Mahonin

u — цветоразностный компонент U, от -1 до 1;

Ivan Mahonin

v — цветоразностный компонент V, от -1 до 1.

Ivan Mahonin

Ivan Mahonin

unsigned int colorByYUVA(double y, double u, double v, double a);

Ivan Mahonin

Ivan Mahonin

Генерирует код цвета по трём составляющим в системе YUV и прозрачности. См. также colorByYUV.

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

y — яркость, от 0 до 1;

Ivan Mahonin

u — цветоразностный компонент U, от -1 до 1;

Ivan Mahonin

v — цветоразностный компонент V, от -1 до 1;

Ivan Mahonin

a — альфа-канал, степень непрозрачности от 0 до 1, где 0 — полностью прозрачный, 1 — полностью непрозрачный.

Ivan Mahonin

Ivan Mahonin

double colorGetRed(unsigned int colorCode);

Ivan Mahonin

Ivan Mahonin

Возвращает красную составляющую цвета. См. также colorByRGBA.

Ivan Mahonin

Ivan Mahonin

double colorGetGreen(unsigned int colorCode);

Ivan Mahonin

Ivan Mahonin

Возвращает зелёную составляющую цвета. См. также colorByRGBA.

Ivan Mahonin

Ivan Mahonin

double colorBlueRed(unsigned int colorCode);

Ivan Mahonin

Ivan Mahonin

Возвращает синюю составляющую цвета. См. также colorByRGBA.

Ivan Mahonin

Ivan Mahonin

double colorGetAlpha(unsigned int colorCode);

Ivan Mahonin

Ivan Mahonin

Возвращает степень непрозрачности цвета — альфа-канал. См. также colorByRGBA.

Ivan Mahonin

Ivan Mahonin

double colorGetHue(unsigned int colorCode);

Ivan Mahonin

Ivan Mahonin

Возвращает цветовой оттенок в градусах на цветовом круге, от 0 до 360 в системе HSV. См. также colorByHSV.

Ivan Mahonin

Ivan Mahonin

double colorGetSaturation(unsigned int colorCode);

Ivan Mahonin

Ivan Mahonin

Возвращает цветность (цветовую насыщенность) для выбранного цвета в системе HSV. См. также colorByHSV.

Ivan Mahonin

Ivan Mahonin

double colorGetValue(unsigned int colorCode);

Ivan Mahonin

Ivan Mahonin

Возвращает яркость для выбранного цвета в системе HSV. См. также colorByHSV.

Ivan Mahonin

Ivan Mahonin

double colorGetYLuminance(unsigned int colorCode);

Ivan Mahonin

Ivan Mahonin

Возвращает яркость для выбранного цвета в системе YUV. См. также colorByYUV.

Ivan Mahonin

Ivan Mahonin

double colorGetUChromanance(unsigned int colorCode);

Ivan Mahonin

Ivan Mahonin

Возвращает цветоразностный компонент U для выбранного цвета в системе YUV. См. также colorByYUV.

Ivan Mahonin

Ivan Mahonin

double colorGetVChromanance(unsigned int colorCode);

Ivan Mahonin

Ivan Mahonin

Возвращает цветоразностный компонент V для выбранного цвета в системе YUV. См. также colorByYUV.

Ivan Mahonin

Ivan Mahonin

void background(unsigned int colorCode);

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

colorCode — код цвета.

Ivan Mahonin

Ivan Mahonin

void clear();

Ivan Mahonin

Ivan Mahonin

Заполняет все пиксели цветом фона. См. также background.

Ivan Mahonin

Ivan Mahonin

void fill(unsigned int colorCode);

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

colorCode — код цвета.

Ivan Mahonin

Ivan Mahonin

void fillTexture(Animation animation, double x, double y, double width, diuble height, int fixed);

Ivan Mahonin

Ivan Mahonin

Установить заливку текстурой. После вызова этой функции все фигуры будут заполняться выбранной текстурой. Для заливки текстурой определяется базовый прямоугольник (по координатам x, y, width, height) в который будет смасштабировано изображение текстуры. Если текстура повторяющаяся, то её копии будут распространяться и за пределами базового прямоугольника. При помощи параметра fixed вы можете зафиксировать базовый прямоугольник текстуры в текущих координатах так, что на них в не будут влиять последующие трансформации перемещения (translate), вращения (rotate) и масштабирования (scale и zoom). См. также fill, noFill и раздел «Текстуры и анимация».

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

animation — анимированная или статическая текстура;

Ivan Mahonin

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

Ivan Mahonin

width — ширина базового прямоугольника текстуры;

Ivan Mahonin

height — ширина базового прямоугольника текстуры;

Ivan Mahonin

fixed — если TRUE (1 или любое другое число кроме 0), то фиксирует прямоугольник текстуры в текущих координатах — операции трансформации на него не влияют.

Ivan Mahonin

Ivan Mahonin

void noFill();

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

void stroke(unsigned int colorCode);

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

colorCode — код цвета.

Ivan Mahonin

Ivan Mahonin

void strokeTexture(Animation animation, double x, double y, double width, diuble height, int fixed);

Ivan Mahonin

Ivan Mahonin

Установить заливку текстурой для контура. После вызова этой функции все фигуры будут заполняться выбранной текстурой. Для заливки текстурой определяется базовый прямоугольник (по координатам x, y, width, height) в который будет смасштабировано изображение текстуры. Если текстура повторяющаяся, то её копии будут распространяться и за пределами базового прямоугольника. При помощи параметра fixed вы можете зафиксировать базовый прямоугольник текстуры в текущих координатах так, что на них в не будут влиять последующие трансформации перемещения (translate), вращения (rotate) и масштабирования (scale и zoom). См. также stroke, noStroke и раздел «Текстуры и анимация».

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

animation — анимированная или статическая текстура;

Ivan Mahonin

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

Ivan Mahonin

width — ширина базового прямоугольника текстуры;

Ivan Mahonin

height — ширина базового прямоугольника текстуры;

Ivan Mahonin

fixed — если TRUE (1 или любое другое число кроме 0), то фиксирует прямоугольник текстуры в текущих координатах — операции трансформации на него не влияют.

Ivan Mahonin

Ivan Mahonin

void noStroke();

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

void strokeWidth(double width);

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

void moveTo(double x, double y);

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

void lineTo(double x, double y);

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

void resetPath();

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

void closePath();

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

void strokePath();

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

void rectTextured(Animation animation, double x, double y, double width, double height);

Ivan Mahonin

Ivan Mahonin

Нарисовать прямоугольник и заполнить его выбранной текстурой. Цвет контура задаётся заранее функцией stroke. См. также функции rect, fillTexture, strokeTexture и раздел «Текстуры и анимация».

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

animation — анимированная или статическая текстура;

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

void circle(double x, double y, double radius);

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

x, y — координаты центра;

Ivan Mahonin

radius — радиус.

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

void point(double x, double y);

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Параметры:

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

void translate(double x, double y);

Ivan Mahonin

Ivan Mahonin

Задать смещение системы координат. После вызова этой функции все объекты будут рисоваться с заданным смещением. Смещение производится относительно действующей в данный момент системы координат. См. также rotate, scale и noTransform.

Ivan Mahonin

Ivan Mahonin

void rotate(double angle);

Ivan Mahonin

Ivan Mahonin

Повернуть текущую систему координат на заданный угол (angle) в градусах. См. также translate, scale и noTransform.

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

void zoom(double z);

Ivan Mahonin

Ivan Mahonin

Смасштабировать текущую систему координат на заданный коэффициент (z). Эквивалентно вызову scale(z, z). См. также translate, rotate, scale и noTransform.

Ivan Mahonin

Ivan Mahonin

void scale(double x, double y);

Ivan Mahonin

Ivan Mahonin

Смасштабировать (растянуть) текущую систему координат на заданные коэффициенты по осям x и y. См. также translate, rotate и noTransform.

Ivan Mahonin

Ivan Mahonin

void noTransform();

Ivan Mahonin

Ivan Mahonin

Отменяет все преобразования системы координат заданные функциями translate, rotate, scale и zoom. См. также saveState и restoreState.

Ivan Mahonin

Ivan Mahonin

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

Ivan Mahonin

Ivan Mahonin

Задаёт прямоугольник отсечения. Все последующие операции рисования будут выполнены только внутри заданного прямоугольника. Всё что было нарисовано ранее за его пределами останется неизменным. Повторный вызов функции заменяет (а не дополняет) ранее заданную область отсечения. Если вы знакомы с OpenGL, вам будет полезно знать, что данная функция просто задаёт четыре плоскости отсечения (glClipPlane). Область отсечения применяется со всеми действующими в момент вызова функции преобразованиями системы координат, таким образом она может быть на экране не прямоугольной, а, например, иметь форму параллелограмма. См. также noClip.

Ivan Mahonin

Ivan Mahonin

void noClip();

Ivan Mahonin

Ivan Mahonin

Отменяет область отсечения заданную функцией clipRect. См. также saveState и restoreState.

Ivan Mahonin

Ivan Mahonin

void resetState();

Ivan Mahonin

Ivan Mahonin

Сбрасывает состояние инструментов рисования к их начальным значениям. Эквивалентно вызову resetStateEx(STATE_ALL). См. также saveState и restoreState.

Ivan Mahonin

Ivan Mahonin

void resetStateEx(unsigned int flags);

Ivan Mahonin

Ivan Mahonin

Сбрасывает выбранные состояния инструментов рисования к их начальным значениям. Аргумент flags определяет перечень состояний которые необходимо сбросить. Значение для него можно вычислить объединив операцией побитового «или» (вертикальная черта: |) несколько флагов из следующего списка:

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_FILL_COLOR

Ivan Mahonin

    цвет заполнения, см. fill

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_FILL_TEXTURE

Ivan Mahonin

    текстура заполнения, см. fillTexture

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_STROKE_COLOR

Ivan Mahonin

    цвет обводки, см. stroke

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_STROKE_TEXTURE

Ivan Mahonin

    текстура обводки, см. strokeTexture

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_STROKE_WIDTH

Ivan Mahonin

    толщина обводки, см. strokeWidth

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_TEXT_ALIGN

Ivan Mahonin

    расположение текста, см. textAlign

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_TEXT_SIZE

Ivan Mahonin

    размер шрифта, см. textSize

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_TEXT_FONT

Ivan Mahonin

    шрифт, см. textFont

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_TARGET_FRAMEBUFFER

Ivan Mahonin

    выбранный буфер кадра, см. target

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_TARGET_VIEWPORT

Ivan Mahonin

    текущая область рисования, см. viewportByFramebuffer, viewportByWindow

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_TARGET_PROJECTION

Ivan Mahonin

    текущая матрица проекции, см. projectionByViewport

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_BACKGROUND

Ivan Mahonin

    цвет очистки экрана (цвет фона), см. baclground

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_TRANSFORM

Ivan Mahonin

    преобразования системы координат, см. translate, rotate, scale, zoom

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_CLIP

Ivan Mahonin

    область отсечения, см. clipRect

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_FILL

Ivan Mahonin

    объединение флагов STATE_FILL_*

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_STROKE

Ivan Mahonin

    объединение флагов STATE_STROKE_*

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_TEXT

Ivan Mahonin

    объединение флагов STATE_TEXT_*

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_TARGET

Ivan Mahonin

    объединение флагов STATE_TARGET_*

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

    STATE_ALL

Ivan Mahonin

    объединение всех флагов

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

void saveState();

Ivan Mahonin

Ivan Mahonin

Запоминает состояние всех инструментов рисования для того чтобы впоследствии к ним вернуться вызвав функцию restoreState. Функция может быть вызвана несколько раз чтобы запомнить несколько состояний, при этом позже необходимо будет выполнить соответствующее количество вызовов функции restoreState. Обращение в данной функции эквивалентно вызову saveStateEx(STATE_ALL). См. также resetState.

Ivan Mahonin

Ivan Mahonin

void saveStateEx(unsigned int flags);

Ivan Mahonin

Ivan Mahonin

Запоминает выбранные состояния инструментов рисования для того чтобы впоследствии к ним вернуться вызвав функцию restoreState. Функция может быть вызвана несколько раз, при этом позже необходимо будет выполнить соответствующее количество вызовов функции restoreState. Аргумент flags определяет перечень состояний которые необходимо запомнить. Значение для него можно вычислить объединив операцией побитового «или» (вертикальная черта: |) несколько флагов из списка представленного в описании функции resetState.

Ivan Mahonin

См. также saveState.

Ivan Mahonin

Ivan Mahonin

void restoreState();

Ivan Mahonin

Ivan Mahonin

Восстанавливает состояния инструментов рисования ранее сохранённые функцией saveState или saveStateEx. Если функция saveState (или saveStateEx) была вызвана несколько раз, то чтобы вернуться к первоначальному состоянию нужно вызвать restoreState аналогичное количество раз. См. также resetState.

Ivan Mahonin

Ivan Mahonin

Важно: следите за тем чтобы количество сохранений (saveState или saveStateEx) всегда совпадало с количеством восстановлений (restoreState).

Ivan Mahonin

Ivan Mahonin

Ivan Mahonin

</body>

Ivan Mahonin