<meta charset="UTF-8">

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

<title>Запуск и общие функции - Helianthus</title>

  
Helianthus

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

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

  
Рисование

  
Спрайты

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

  
Камера

  
Звук

  
Все функции

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

Для подключения и использования библиотеки Helianthus нужно:

- подключить файл <helianthus.h>

- создать и зарегистрировать  функции для начальной загрузки и для перерисовки кадра (см. worldSetInit и worldSetDraw)

- вызвать функцию worldRun для запуска вашей программы

Вот что должно получиться:

#include <helianthus.h>

void init() {

    // Здесь будут команды для начальной загрузки.

    // Они выполнятся только один раз в самом начале.

}

void draw() {

    // Здесь будут команды для движения и рисования.

    // Во время работы программы они будут запускаться

    // несколько раз в секунду.

}

int main() {

    worldSetInit(&init); 

    worldSetDraw(&draw);

    worldRun();

    return 0;

}

Функции:

void worldSetInit(Callback init);

Задать функцию для начальной инициализации (загрузки). Эта функция будет запущена только один раз в самом начале работы программы, как только будет вызвана функция worldRun.

Параметры:

init — указатель на функцию начальной инициализации (загрузки). Функция быть работать без параметров и не должна возвращать значение.

void worldSetDraw(Callback draw);

Задать основную функцию вашей программы — функцию для перерисовки кадра. Во время работы программы заданная функция будет запускаться несколько раз в секунду перед перерисовкой каждого кадра. Поместите в неё команды для движения и рисования.

Параметры:

draw — указатель на функцию перерисовки кадра. Функция быть работать без параметров и не должна возвращать значение.

void worldRun();

Запустить вашу программу на Helianthus. Перед вызовом этой функции нужно зарегистрировать функции начальной загрузки и перерисовки кадра (см. выше)

void worldStop();

Остановить и закрыть программу. Программа всегда закрывается если пользователь нажмёт на крестик в верхнем правом углу окна, но вы можете добавить и свои способы выхода из программы. Например, в функцию перерисовки вы можете вставить возможность выхода по нажатию клавиши Esc (см. также раздел «Клавиатура и мышь»):

void draw() {

    …

    if (keyWentPressed("escape")) {

        worldStop()

    }

    …

}

int worldGetWidth();

Возвращает ширину окна в пикселях. См. также worldSetWidth.

void worldSetWidth(int width);

Установить ширину окна. См. также worldGetWidth.

Параметры:

width — новая ширина окна.

int worldGetHeight();

Возвращает высоту окна в пикселях. См. также worldSetHeight.

void worldSetHeight(int height);

Установить высоту окна. См. также worldGetHeight.

Параметры:

height — новая ширина окна.

double worldGetFrameRate();

Возвращает частоту перерисовки окна, количество кадров в секунду. См. также worldSetFrameRate.

void worldSetFrameRate(double frameRate);

Установить частоту перерисовки окна. См. также worldGetFrameRate.

Параметры:

frameRate — количество кадров в секунду, от 1 до 100.

double worldGetTimeStep();

Возвращает длительность одного кадра в секундах. См. также worldGetFrameRate.

int worldGetFrameCount();

Возвращает количество кадров прошедшее с момента запуска программы (с момента вызова функции worldRun. См. также worldGetSeconds.

double worldGetSeconds();

Возвращает количество секунд прошедшее с момента запуска программы (с момента вызова функции worldRun. См. также worldGetFrames.

int randomNumber(int min, int max);

Возвращает случайное целое число от min до max включительно.

Параметры:

min — минимальное значение для случайного числа;

max — максимальное значение для случайного числа.

double randomFloat();

Возвращает случайное дробное число в диапазоне от 0 до 1.