Pixilang — межплатформенный пиксельно-ориентированный язык программирования. В данном учебнике рассматриваются только версии 1 и 2 языка Pixilang. Документация на версию 3 находится здесь: https://warmplace.ru/soft/pixilang/index_ru.php

Основы

править

Основа Pixilang - это pixi-контейнеры. pixi-контейнер может содержать в себе картинку, строку текста, числовой массив и ссылку на другой pixi-контейнер с альфа-каналом. То есть, любой набор данных хранится в pixi-контейнере, к которому можно обращаться как к массиву. Далее под терминами "картинка", "текстовая строка", "числовой массив" будет пониматься обычное число - номер pixi-контейнера.

Пример:

//Считывание значения второго пикселя в картинке image:
pixel_value = image[ 2 ]

Обычное рабочее окно Pixilang имеет следующий вид:

 

Здесь "current screen" - это виртуальный экран. "User window" - пользовательское окно (окно интерпретатора). Pixilang-программа имеет право рисовать только в области виртуального экрана, который принудительно может изменять свои размеры независимо от пользовательского окна.

Конфигурация

править

Pixilang может использовать файл конфигурации config.ini, в котором задаются начальные размеры окна, длина (в сэмплах) звукового буфера, название окна и опция выключения бордюра окна.

Пример:

width       320
height      240
noborder
windowname  "Название окна"
buffer      4096

Элементы языка

править

Комментарии

править

Закомментировать строку кода можно при помощи символов //. Пример:

// эта строка закомментирована

При помощи символов /* */ можно делать многострочные комментарии:

/* blah blah blah
blah blah blah */

Текстовые строки

править

Текстовые строки заключаются в двойные кавычки. Пример:

a = "текстовая строка" 
//В переменную a поместили номер новой строки (pixi-контейнера)

При передаче строки какой-либо команде (кроме make_pixi) возможно динамически включать в эту строку числовые значения переменных. Пример:

blahblah = 34
video_export_gif( "VIDEO$blahblah.gif" )
//Сохраняем видео в файл VIDEO34.gif

Коды ASCII-символов

править

Коды ASCII-символов (максимум 4 символа): 'A','B','ABC'... Пример:

ascii_code = 'E' 
//По сути, это мы в переменную ascii_code поместили число 69

Переменные

править

Переменная может хранить в себе одно 32-битное знаковое целое число. Запрещено использование одного имени для переменной и подпрограммы, так как имя подпрограммы - это тоже переменная. Пример:

medved = 4 //в переменную medved я помещаю 4

Математические операции

править

Возможны следующие математические операции: -,+,*,/,% Пример:

a = b + 4 //Сложение
b = 1 / 3 //Деление
c = 4 % 5 //Остаток от деления

Условные операции

править

Возможные варианты условных операторов:

  • < - меньше
  • > - больше
  • <= - меньше или равно
  • >= - больше или равно
  • = - равно (если стоит после if)
  • != - не равно

Бинарные операции

править

Бинарные логические операции (для тех, кто знает, что это такое):

  • ^ - xor
  • & - and
  • | - or

Обычное число типа 12345 воспринимается как обычное десятичное число :)

Некоторые команды (например, команды трансформации) требуют числа в формате с фиксированной точкой 24.8. Далее такие числа будем кратко называть Fixed point. Fixed point - обычные десятичные числа умноженные на 256. То есть, например, число 1 в формате Fixed point будет равно 256, так как 1 * 256 = 256. 2 будет равно 512 (2*256). 0.5 будет равно 128 (0.5*256). И так далее.

Число типа #4499FF автоматически преобразуется в значение цвета. Удобно использовать для передачи цвета различным графическим командам. Формат: #RRGGBB. RR - красный, GG - зеленый, BB - синий. В общем, как в HTML. Заранее заданы следующие цветовые константы: ORANGE, BLACK, WHITE и аналогичная SNEG, RED, GREEN, BLUE, YELLOW.

Подпрограммы

править

Программа начинается с самого начала текстового файла. Возможно использование подпрограмм - их желательно определять где-нибудь в конце. Вот пример:

print("Hello world!",0,0)
myfunc1 //тут мы вызываем нашу подпрограмму, определенную в конце
stop //остановка основной программы
myfunc1:
  //здесь какая-то подпрограмма
ret

Где ret - это метка конца подпрограммы. Не забывайте про неё! Отсюда следует, что подпрограммы определяются в виде: ИМЯ_ПОДПРОГРАММЫ: НЕПОСРЕДСТВЕННО ПОДПРОГРАММА ret. Возможно также более гибкое использование подпрограмм вот в таком виде:

//На лету создаём подпрограмму podpr:
podpr = { print("hello1") print("hello2") }
//И вызываем её:
podpr
//На самом деле, здесь podpr - это обычная переменная, 
//содержащая в себе адрес подпрограммы.

Метки перехода пишутся вот в таком виде:

my_cool_metka:
  blah blah
  goto my_cool_metka

То есть, переход на метку осуществляется при помощи команды goto (или просто go).

Циклы while

править

Циклы while пишутся следующим образом: while( условие, при котором выполняется цикл ) { действия }. Пример:

a = 0
while( a < 8 )
{ 
  print( "$a", a * 8, 0, WHITE ) 
  a + 1
} //Этот цикл выведет значение возрастающей переменной "a" восемь раз \\ но на самом деле, цикл выведет просто $a, а не число, потому что кавычки это текст, и команда print выводит только текст. Чтобы увидеть число, которое помещено в $а, его необходимо преобразовать в строку. Чтобы упростить задачу в будущем, стоит один раз написать функцию:

fn printtt ($var) {

  string =  "" 
  num_to_str(string, $var) 
  ret(string) 

}

a = 0
while( a < 8 )
{ 
  print(printtt(a), a * 8, 0, WHITE ) 
  a + 1
  frame(100)
}

Команды

править

Команды пишутся следующим образом: ИМЯ_КОМАНДЫ (ПАРАМЕТРЫ ЧЕРЕЗ ЗАПЯТУЮ) Например, выполним команду dot: dot(1,1,#FF0000) Если никаких параметров не передаем, то пишем просто название команды без скобок. Например: frame. Команда может возвращать значение: x = get_pen_x() Запрещено использование параметров такого вида: com( com() )

Детальный список команд

править

Ниже приводится детальный список всех команд языка Pixilang. В скобках указываются возможные (но не обязательные) параметры.

Графические

править

dot (x,y,color) - поставить точку. Пример: dot(10,20,#FFFF00)

get_dot (x,y) - возвращает цвет точки по координатам x,y

fps - возвращает текущее число кадров в секунду

frame (delay,clip_x,clip_y,clip_xsize,clip_ysize) - перерисовывает экран и делает паузу, специально для перехода между кадрами. delay - длина паузы. 1000 - секунда, 500 - половина секунды, 0 - нет паузы. Параметры clip_x,clip_y,clip_xsize,clip_ysize характеризуют координаты и размер региона, который нужно перерисовать. Регион нулевого размера (по умолчанию) означает перерисовку всего экрана. Пример: frame(500)

clear (color) - очистить экран. Пример: clear(#FFFF00)

print (text,x,y,color) - печатает текст по координатам x, y. Пример: print("HELLO!",10,10,#FFFFFF) Можно заставлять print выводить числовые значения переменных. Делается это очень просто. Например, выведем значение переменной b вот так: print("VALUE=$b",10,10,#ffffff)

line (x1,y1,x2,y2,color) - рисует линию. Пример: line(0,0,10,10,#FFFF00)

box (x1,y1,xsize,ysize,color) - рисует прямоугольник. Пример: box(0,0,10,10,#FFFF00)

fbox (x1,y1,xsize,ysize,color) - рисует закрашенный прямоугольник. Пример: fbox(0,0,10,10,#FFFF00)

triangle (x1,y1,x2,y2,x3,y3,color) - рисует треугольник закрашенный цветом color

pixi_triangle (x1,y1,tx1,ty1,x2,y2,tx2,ty2,x3,y3,tx3,ty3,image,frame) - рисует треугольник закрашенный текстурой, взятой из контейнера image. Текстурные координаты: tx1, ty1, tx2, ty2, tx3, ty3

triangles3d (vertexes,triangles), pixi_triangles3d (vertexes,triangles,pixi,frame) - нарисовать цветные или текстурированные треугольники из числовых массивов vertexes и triangles.

//структура массива вершин - "vertexes":
X, Y, Z, texture_X, texture_Y, 0, 0, 0,
X, Y, Z, texture_X, texture_Y, 0, 0, 0,
...
//структура массива треугольников - "triangles":
V1, V2, V3, COLOR, TRANSPARENCY, 0, 0, ORDER, 
V1, V2, V3, COLOR, TRANSPARENCY, 0, 0, ORDER,
...
//V1..V3 - номера вершин. ORDER - номер треугольника (команда sort_triangles автоматически заполнит это значение)
//X,Y,Z - координаты (Fixed point)

sort_triangles (vertexes,triangles) - отсортировать треугольники (заполнить значения ORDER в массиве triangles) по координате Z.

save_screen(filename,x,y,xsize,ysize) - сохранить участок экрана в текстовый файл.

Пример:

s = 1
save_screen("IMG$s.txt",0,0,10,10)
//Сохраняем в файл с именем IMG1.txt

set_screen (some_image) - устанавливает указанную картинку в качестве экранного буфера. 0 - стандартный экран по умолчанию

make_pixi (text_source,alpha_pixi,transparent_color) - преобразовать текстовую строку в картинку с заданным прозрачным цветом (transparent_color) и альфа-каналом (alpha_pixi). Альфа канал должен иметь такой же размер как и основная картинка. Чтобы не использовать альфа-канал, необходимо указать 0 в качестве параметра alpha_pixi. Предупреждение: данная команда автоматически преобразовывает пиксели черного цвета в темно-синий (для глаза он остается черным) Символы входной текстовой строки (в том числе для альфа канала): 0,1,2,3,4,5,6,7,8,9 - градиент серого; . (точка) - прозрачный цвет; остальные символы - имена переменных, в которых хранятся цвета

make_ascii_pixi (text_source,color_pixi) - то же, что и предыдущая команда, только картинка будет выводиться на экран в виде ASCII символов, а цвета символов будут браться из альфа-канала. Пример:

text =       "Hello World!"
text_color = "123456789123"
make_ascii_pixi( text, text_color )

new_pixi (xsize,ysize,frames) - создает новую пустую картинку с заданным размером и количеством кадров. Пример: bird = new_pixi( 32, 32, 4 )

load_pixi (filename) - загружает картинку из GIF или JPG файла

remove_pixi (pixi) - удалить pixi-контейнер

resize_pixi (pixi,xsize,ysize,mode) - изменить размер графического pixi-контейнера; xsize,ysize - новый размер в пикселях. mode: 0 - очистить pixi после масштабирования.

clone_pixi (pixi,clone_alpha) - клонировать pixi-контейнер. Значения параметра clone_alpha: 0 - не клонировать альфа-канал; 1 - клонировать альфа-канал. Пример: new_image = clone_pixi( sobaka, 1 )

get_pixi_xsize (image) - получить ширину картинки image (в пикселях). Пример: xsize = get_pixi_xsize( sobaka )

get_pixi_ysize (image) - получить высоту картинки image (в пикселях). Пример: ysize = get_pixi_ysize( sobaka )

get_pixi_frames (image) - получить количество кадров в картинке image. Пример: frames = get_pixi_frames( sobaka )

get_pixi_alpha (image) - получить картинку, которая выступает в роли альфа-канала картинки image. Пример: alpha = get_pixi_alpha( sobaka ) pixi( alpha, 10, 10, 1 )

pixi_alpha (image,new_alpha) - установить альфа-канал (картинку, которая будет выступать в роли карты прозрачности) для картинки image

pixi_transp (image,transp,transp_color) - контроль прозрачного цвета указанной картинки (image). transp - прозрачность включена/выключена (1/0). transp_color - прозрачный цвет

pixi (image,x,y,pixel_size,pixel_size_correction), fpixi (image,x,y,pixel_size,pixel_size_correction,frame) - рисует заранее созданную картинку. Параметр frame (только для fpixi) - номер кадра (от 0 до бесконечности). В команде pixi номер кадра не указывается и определяется автоматически. pixels - это строка текста, которая превращается в пиксели. pixel_size - размер пикселя (размеры меньше 1 приравниваются к 1). pixel_size_correction - плавная коррекция указанного размера пикселя: 0 - нет коррекции; 256 - размер пикселя увеличивается на единицу; 128 - размер пикселя увеличивается на 0.5 (половинка экранного пикселя) и т.д. Рассмотрим пример:

//ЗАДАЕМ АНИМАЦИЮ ИЗ 5 КАДРОВ - ЧТО-ТО ТИПА ЛЕТЯЩЕЙ ПТИЧКИ :)
//КАДРЫ ДОЛЖНЫ РАЗДЕЛЯТЬСЯ СИМВОЛОМ "+".
//СИМВОЛ "." - ПРОЗРАЧНЫЙ ПИКСЕЛЬ
//ОСТАЛЬНЫЕ СИМВОЛЫ - ИМЕНА ПЕРЕМЕННЫХ, КОТОРЫЕ СОДЕРЖАТ В СЕБЕ НУЖНЫЕ ЦВЕТА
//ПРИСВОИМ ПЕРЕМЕННОЙ "B" НУЖНЫЙ ЦВЕТ (КРАСНЫЙ):
B = #FF0000
//ЗАДАДИМ ТЕКСТОВУЮ СТРОКУ:
t = "
B......B
.B....B.
..BBBB..
+
........
BB....BB
..BBBB..
+
........
........
BBBBBBBB
+
........
........
...BB...
BBB..BBB
+
........
BB....BB
..BBBB..
"
//ПРЕОБРАЗУЕМ ЭТУ СТРОКУ В КАРТИНКУ:
make_pixi( t )
//И ВЫВЕДЕМ ВСЕ ЭТО ЧУДО НА ЭКРАН:
repeat_marker:
  clear(BLACK)
  pixi(t,10,10)
  frame(100)
go repeat_marker

get_window_xsize - получить ширину пользовательского окна (в пикселях)

get_window_ysize - получить высоту пользовательского окна (в пикселях)

get_color (r,g,b) - возвращает цвет, скомпонованный по составляющим r,g,b (red,green,blue)

get_red (color) - возвращает значение (от 0 до 255) красной составляющей цвета color

get_green (color) - возвращает значение (от 0 до 255) зеленой составляющей цвета color

get_blue (color) - возвращает значение (от 0 до 255) синей составляющей цвета color

get_blend (color1,color2,val) - возвращает средний цвет между color1 и color2. val - значение близости: 0 - ближе всего к цвету color1; 256 - ближе всего к цвету color2

transp (value) - устанавливает прозрачность последующих графических команд. 0 - невидимый ... 255 - видимый

effector (color,power,type,x,y,xsize,ysize,xadd) - команда для использования стандартных графических эффектов. сolor - цвет эффекта. power - мощность эффекта (от 0 до 256). type - тип эффекта: 0 - шум; 1 - горизонтальное размытие; 2 - вертикальное размытие. x,y,xsize,ysize - прямоугольная область, в которой будет работать выбранный эффект. xadd - интервал между точками.

pixel_shader (pixel_shader_subprogram) - включить программный пиксельный шейдер (версия PS1). pixel_shader_subprogram - подпрограмма шейдера. Входные параметры для этой подпрограммы: PS_T - номер пикси-контейнера с текстурой; PS_TX - текущая координата X на текстуре (Fixed point); PS_TY - текущая координата Y на текстуре (Fixed point); PS_TP - номер пикселя на текстуре; PS_P - номер пикселя на экране. Выходные параметры: PS_R - окончательный цвет точки.

Пример:

pixel_shader( GLASS_PIXEL_SHADER ) //Включение пиксельного шейдера "стекло"
... /* Здесь рисуем какие-нибудь pixi */
pixel_shader( -1 ) //Выключение пиксельных шейдеров
GLASS_PIXEL_SHADER:
v = get_red( PS_T[ PS_TP - 1 ] ) - get_red( PS_T[ PS_TP + 1 ] )
PS_R = get_blend( scr0[ PS_P + get_red( PS_T[ PS_TP ] ) / 8 ], WHITE, v )
ret

Шрифты

править

pixi_font (image) - указать анимированную картинку (графический pixi-контейнер), которая будет выступать в роли текущего шрифта. Шрифт моноширный. Каждый символ в шрифте - это кадр картинки. Соответственно, для 256 ASCII символов нужна анимация из 256 кадров

get_pixi_font - получить картинку, которая является шрифтом на данный момент

Трансформация

править

t_reset - очистить трансформацию

t_rotate_x (angle,x,y,z) , t_rotate_y (angle,x,y,z) , t_rotate_z (angle,x,y,z) - добавить трансформацию поворота вокруг оси X, Y или Z на угол angle (512 = 2*Пи). Центр поворота - x,y,z

t_translate (x,y,z) - добавить трансформацию переноса (сдвига). Коэф-ты переноса x,y,z - целые числа (Fixed point).

t_scale (x,y,z) - добавить трансформацию масштабирования. Коэф-ты масштабирования x,y,z - целые числа (Fixed point). Нормальный размер - 256; увеличение в два раза - 512.

t_get_matrix (m), t_set_matrix (m), t_mul_matrix (m) - действия с матрицей трансформации (матрица - 4х4 ячейки, или просто массив из 16ти 32-битных чисел (Fixed point)). t_get_matrix - записать текущую активную матрицу в массив m. t_set_matrix - взять матрицу из массива m и сделать её активной. t_mul_matrix - умножить текущую активную матрицу на матрицу из массива m.

t_get_x (x,y,z), t_get_y (x,y,z), t_get_z (x,y,z) - произвести трансформацию точки с координатами x,y,z (Fixed point) и возвратить измененную координату x, y или z (Fixed point).

Работа со строками

править

new_string (size) - создать пустую строку длиной в size символов. Пример: str = new_string( 10 )

get_string_size (string) - получить размер строки string (в символах). Пример: strsize = get_string_size( "Мама мыла раму" )

Работа с числовыми массивами

править

Массивом считается любое хранилище данных - то есть, любой pixi-контейнер:

  • картинка - хранит в себе значения пикселей;
  • строка - хранит в себе значения отдельных символов;
  • числовой массив - хранит в себе числа.

new_array (len) - создать новый массив (числовой pixi-контейнер) 32битных чисел. len - кол-во чисел. Пример: array = new_array( 256 )

get_array_size (array) - получить размер (кол-во чисел) числового массива

Время и таймеры

править

start_timer (t) - запустить таймер номер t. Пример: start_timer(3)

get_timer (t) - получить значение таймера номер t. Пример: get_timer(3) Если полученное значение равно 1000, то прошла одна секунда; если 2000, то две секунды и т.д.

get_seconds - получить текущее время: секунды

get_minutes - получить текущее время: минуты

get_hours - получить текущее время: часы

Взаимодействие с пользователем

править

handle_pen_keys (button_down_handler,pen_move_handler,button_up_handler), handle_keys (...) - обработать все события, связанные с мышкой (стилусом), произошедшие с момента последнего вызова команды frame. Параметры этой команды - подпрограммы, обработчики.

Пример: handle_pen_keys( {x=get_pen_x}, 0, 0 )

get_pen_x, gpx - получить текущую x-координату мыши (или стилуса)

get_pen_y, gpy - получить текущую y-координату мыши (или стилуса)

get_pen_region (x,y,xsize,ysize), gpr (x,y,xsize,ysize) - возвращает единицу, если есть попадание курсора мыши (или стилуса) в указанную область

get_pen_key, gpk - получить текущую нажатую клавишу мыши (или клик стилуса); 1 - если есть нажатие, или 0 - если нажатия нет

handle_hard_keys (button_down_handler,button_up_handler) - обработать события нажатых клавиш. Работает аналогично команде handle_pen_keys, только для клавиатуры, а не для мыши. Для получения кода нажатой клавиши вызывается команда get_hard_key (или ghk). Пример: handle_hard_keys( {key_code=get_hard_key}, 0, 0 )

get_hard_key, ghk - получить текущую нажатую клавишу на клавиатуре. Коды клавиш со стандартными ASCII символами соответствуют кодам ASCII. Коды дополнительных клавиш:

256: F1
257: F2
258: F3
259: F4
260: F5
261: F6
262: F7
263: F8
264: UP
265: DOWN
266: LEFT
267: RIGHT
268: INSERT
269: DELETE
270: HOME
271: END
272: PAGEUP
273: PAGEDOWN
274: CAPS

При нажатии клавиши SHIFT, к коду добавляется 512 При нажатии клавиши CTRL, к коду добавляется 1024

Видео-экспорт

править

video_export_gif (filename,x,y,xsize,ysize), video_export_avi (filename,x,y,xsize,ysize) - включить сохранение всех кадров в анимированный GIF-файл или AVI-файл (сохранение в AVI пока работает только в Windows).

Примеры:

//Экспорт всего экрана:
video_export_gif("my_video.gif")
//Экспорт указанного региона:
video_export_gif("my_video.gif",-10,-10,64,64)

После каждого выполнения команды frame очередной кадр будет сохранятся в указанный файл. Сам файл временно хранится в памяти и сохраняется на диск при выходе из pixilang, при выполнении команды stop_video_export или при очередном включении экспорта командой video_export_XXX.

pause_video_export - временно приостановить сохранение кадров.

resume_video_export - продолжить сохранение кадров.

stop_video_export - остановить сохранение кадров и сохранить результат в выбранный (в команде video_export_XXX) файл.

video_export_fps (fps) - установить количество кадров в секунду при сохранении кадров в AVI (по умолчанию стоит 30 кадров в секунду).

video_export_realtime (rt) - установка режима реального времени для экспорта в AVI.

Примеры:

video_export_realtime( 1 ) //Включение режима реального времени. AVI файл будет без звука
video_export_realtime( 0 ) //Включение режима виртуального времени. AVI файл будет с плавным изображением и со звуком

По умолчанию включен режим реального времени.

video_export_dither (dither) - включить или выключить dithering (эмуляция плавных цветовых переходов при помощи шума) при экспорте. Пример включения: video_export_dither(1) Пример выключения: video_export_dither(0)

video_export_hq (highquality) - включить или выключить режим качественного экспорта в GIF, при котором для каждого кадра будет создаваться своя локальная цветовая палитра. Пример включения: video_export_hq(1). Пример выключения: video_export_hq(0). По умолчанию - выключен

Музыка

править

load_music (filename,slot) - загрузить композицию в трекерном формате XM или MOD. slot - номер места, в которое загрузится музыка. slot может принимать любые значения от 0 до 15. Загрузив несколько композиций в разные места можно обеспечить их одновременное проигрывание.

play_music (slot) - начать проигрывание загруженной композиции

stop_music (slot) - остановка проигрывания

music_volume (volume,slot) - установить громкость проигрывания (от 0 to 255)

get_music_pattern (slot) - получить номер текущего паттерна в композиции

get_music_position (slot) - получить текущую позицию в паттерне

send_sound (sound_pixi,freq,channels,loop) - послать sound_pixi (pixi-контейнер, содержащий в себе кусок звука) в звуковой буфер. freq - частота дискретизации, с которой этот кусочек будет проигрываться. channels - кол-во каналов (1 - моно или 2 - стерео). loop - если установить этот параметр в единичку, то данный кусочек звука будет проигрываться бесконечно долго. Возвращаемое значение - порядковый номер (ID) указанного кусочка звука в звуковом буфере.

send_sound_to (sound_id,sound_pixi,freq,channels,loop) - аналогично предыдущей команде, только позиция в звуковом буфере указывается не автоматически, а берется из параметра sound_id. Значение этого параметра может быть в диапазоне от 0 до 15.

get_sound_status (sound_id) - получить статус (позицию проигрывания) указанного куска звука.

Пример:

sound_id = send_sound(sound,44100,2,0)
position = get_sound_status( sound_id )

sound_volume (volume) - установить громкость звука (от 0 до 256)

Пример создания зацикленного буфера c 8-битным звуком:

snd = new_string( 256 ) //Длина звука - 256 отсчетов (сэмплов)
//Амплитуда в 8-ми битном звуке - это величина от -127 до +127
send_sound( snd, 44100, 1, 1 )

Пример создания зацикленного буфера c 32-битным звуком:

snd = new_array( 256 )
//Нормальная амплитуда в 32-битном звуке - от -32767 до 32767.
send_sound( snd, 44100, 1, 1 )

Пример создания зацикленного буфера из картинки:

//img - какая-то цветная pixi-картинка
send_sound( img, 44100, 2, 1 ) //Превращаем картинку в стерео-звук
//правый канал - красный цвет; левый канал - зеленый цвет

Работа с файлами

править

fopen, fclose, fgetc, fputc, fseek, ftell, feof - POSIX совместимые команды для работы с файлами. Аналогичны таким же функциям в языках Си/Cи++. fopen, freopen, fdopen открывают файл для определенных типов чтения и записи

fclose закрывает файл, ассоциированный с переданным ей значением FILE *

fgetc возвращает один символ из файла

fputc записывает один символ в файл

fseek производит смещение от текущей позиции в файле на указанное количество байт, или от его начала или конца, в указанном направлении.

ftell возвращает указатель позиции файла, который может быть передан fseek

feof проверяет, установлен ли индикатор EOF для данного потока

set_disk0 (TAR_file_name) - указать имя TAR файла, который будет восприниматься языком в роли диска 0.

Пример:

set_disk0( "archive.tar" ) //

Архив archive.tar содержит какие-нибудь файлы и файл PIC.JPG

img = load_pixi( "0:/PIC.JPG" ); //

Грузим файл PIC.JPG с виртуального диска 0

file_dialog (filename,dialogname,mask,id) - открыть графический диалог для выбора файла. filename - контейнер с заранее созданной строкой, в которую будет производиться сохранение имени выбранного файла. dialogname - имя диалогового окна. mask - маска типов файлов (например, "jpg/gif"). id - имя файла, в который будет сохраняться текущее состояние диалога. Если файл успешно выбран, команда возвращает значение 1. В противном случае - 0.

Пример:

filename = "................................"
if( file_dialog( filename, "Выберете графический файл", "jpg/gif", "gfx_files_dialog" ) )
{ /* файл выбран. имя в переменной filename */ }
else
{ /* файл не выбран */ }

Математика

править

sin (angle) - получить значение целочисленного синуса. Значения для угла angle: 512 = 2*Пи. Возвращаемые значения: -256...0...256

cos (angle) - получить значение целочисленного косинуса. Значения для угла angle: 512 = 2*Пи. Возвращаемые значения: -256...0...256

csin (angle) - ccos (angle) - такие же как sin и cos, только с более низкой четкостью. Значение для угла angle: 256 = 2*Пи. Возвращаемые значения: -128...0...128

rand - получить случайное число в диапазоне от 0 до 32767

rand_seed (seed) - установить указатель случайных чисел

Системные

править

stop - остановить выполнение программы

halt - тоже самое что и stop.

exit (exit_code) - выход в ОС; exit(1) - выход в ОС с выходным кодом 1.

noesc (no) - включение/выключение выхода по ESC; noesc(0) - выходить при нажатии ESC; noesc(1) - не выходить при нажатии ESC.

Правила программирования

править

С чего начать

править

Создайте в текстовом редакторе файл (например, MY_PROGRAM.TXT) и напишите в нем следующее:

a = 2 * 2
metka1:
clear(BLACK)
print("HELLO PIXEL! $a",-20,10,#FFFFFF)
frame
a = a + 1
goto metka1

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

Математика

править

В Pixilang все числа целые знаковые 32-битные. Возможны операции со скобками. Не забывайте про старшинство операций (сначала выполнится умножение, а потом уже сложение и вычитание). Ниже приведен список операций по приоритетам:

% (эта операция будет выполнена в первую очередь)
/
*
-
+
>=
<=
>
<
!=
=
^
&
| (эта операция будет выполнена последней)

Возможны операции без знака "равно". Примеры:

a+1	//переменная a увеличивается на единицу
a+1*2	//переменная a увеличивается на величину (1*2)

Условные операции

править

Условные операции выглядят следующим образом: if КАКОЕ-ЛИБО УСЛОВИЕ { КУСОК ПРОГРАММЫ, ИСПОЛНЯЕМЫЙ ПРИ ВЫПОЛНЕННОМ УСЛОВИИ } Рассмотрим примеры:

//Если a > 4, то записываем 2 в переменную b
if a > 4  { b = 2 }
//Если a равно 1, то записываем 1 в переменную b
if a = 1  { b = 1 }
//Если b не равно 1, то выводим на экран строчку текста "HELLO"
if b != 1  { print("HELLO",1,1) }
//Если b не равно 1, то выводим на экран строчку текста "HELLO"; 
//если b равно 1, то рисуем точку по координатам 10,10
if b != 1  { print("HELLO",1,1) } else { dot(10,10) }

Подключение внешних файлов

править

В Pixilang есть возможность подключения внешних файлов, которые содержат в себе, к примеру, код библиотек. Сделать это можно очень просто:

INCLUDE "имя внешнего файла"

Подключение произойдет на этапе компиляции.

Оптимизация программы

править

Pixilang поддерживает удобные приемы оптимизации вашей программы. Рассмотрим примеры.

Возьмем следующую программу:

pixi( t, 44, 44 )
pixi( a, 44, 44 )
pixi( b, 44, 44 )

Как видим, название команды повторяется. Повторяются так же и координаты (44,44). В таком случае данный код можно сократить до следующего вида:

pixi( t, 44, 44 )
.( a )
.( b )

Поясним. Если вместо названия команды указана точка, то вызывается последняя выполненная команда. Неуказанные параметры так же берутся из параметров последней выполненной команды.

Азы программирования

править

Пример №1. ASCII анимация

править

Главный инструмент в языке Pixilang - это универсальный pixi-контейнер. Пример создания пиксельной анимации при помощи такого контейнера был рассмотрен выше. Попробуем заменить пиксели на ASCII-символы.

//описываем контейнер с анимированным содержанием 
pic="
 o   ooo   o 
  o  o o  o  
   ooo ooo   
   ooooooo   
 ooooooooooo 
 o ooooooo o 
oo         oo
+
     ooo     
     o o     
 ooooo ooooo 
   ooooooo   
 ooooooooooo 
 o ooooooo o 
oo         oo
"
// тупо раскрашиваем все красненьким 
a=RED
pic_color="
aaaaaaaaaaaaa
aaaaaaaaaaaaa
aaaaaaaaaaaaa
aaaaaaaaaaaaa
aaaaaaaaaaaaa
aaaaaaaaaaaaa
aaaaaaaaaaaaa
"
make_ascii_pixi(pic,pic_color)
//создаем контейнер с ascii анимированным содержанием
make_ascii_pixi(pic)
// метка 
start:
// цвет фона
clear(#000000)
/* задаем анимированному контейнеру координаты  x=2 и y=3 увеличение=4 */
pixi(pic,2,3,4)
// время демонстрации фрейма
frame(100)
//возврат к метке start - бесконечный цикл
go start

Пример №2. Часы

править
time:
clear(SNEG)
// считаем часы минуты секунды
h = get_hours
m = get_minutes
s = get_seconds
//выводим цифровые значения времени
print( "$h:$m:$s", -65, -65, BLACK )
//делаем их удобоваримыми для вращающихся стрелок
h=h * 256   h / 12   h - 64
m=m * 256   m / 60   m - 64
s=s * 256   s / 60   s - 64
//рисуем стрелки
line(0,0, ccos(h) /4, csin(h)/4, BLACK)
line(0,0, ccos(s) /3, csin(s) /3,  BLACK)
line(0,0, ccos(m) /5, csin(m)/5, BLACK)
frame(0)
go time

Пример №3. Кубики по кругу

править
xcenter=0
ycenter=0
radius=1
N=8
clear(SNEG)
angle=0
delta = 256 / N
time:
N-1
x =( xcenter+radius*ccos(angle))/2
y = (ycenter+radius*csin(angle))/2
fbox(x,y,11,11,BLACK)
angle=angle+delta
frame(110)
if N>0 {go time}

Ссылки

править