🚀 BORIEL BASIC: КОМПИЛИРУЕМ БЫСТРЫЕ ПРОГРАММЫ ДЛЯ ZX SPECTRUM КАК ПРОФЕССИОНАЛЫ

ВСТУПЛЕНИЕ: ОТ МЕДЛИТЕЛЬНОГО ИНТЕРПРЕТАТОРА К МОЛНИЕНОСНОМУ КОДУ​

ЧТО ТАКОЕ BORIEL BASIC И ЗАЧЕМ ОН НУЖЕН?​

КЛЮЧЕВЫЕ ВОЗМОЖНОСТИ (ЧТО ОН ДАЁТ ПРОГРАММИСТУ)​

1. Компиляция в машинный код — ваши программы на Бейсике выполняются со скоростью, сравнимой с ассемблером .
2. Современный синтаксис — вдохновлён FreeBASIC, C и Visual Basic . Забудьте про номера строк и GOTO.
3. Структурное программирование — процедуры (SUB), функции (FUNCTION), циклы DO...LOOP, SELECT CASE и многое другое .
4. Типизированные переменные — выбирайте тип (Byte, Integer, Float и др.) для экономии памяти и ускорения кода .
5. Вставки на ассемблере — можно писать ассемблерный код прямо внутри BASIC-программы, обращаясь к BASIC-переменным .
6. Многоуровневая оптимизация — компилятор убирает мёртвый код, оптимизирует математические операции и делает программу компактнее .
7. Поддержка современного железа — отлично работает с ZX Spectrum Next, включая спрайты, слои и банки памяти .
8. Активное сообщество — Telegram-канал, форум, сам автор регулярно помогает пользователям .

ИСТОРИЧЕСКИЙ КОНТЕКСТ: ПОЧЕМУ ЭТО ПРОРЫВ?​

УСТАНОВКА И НАСТРОЙКА: ТРИ ПУТИ К ЦЕЛИ​

Способ 1: Готовые бинарные сборки (рекомендуется для Windows)​

1. Перейдите на официальную страницу загрузки или в раздел "Releases" на GitHub-репозитории проекта.
2. Скачайте последнюю версию ZXBasic_Win32_<version>.zip.
3. Распакуйте архив в удобную папку, например, C:\ZXBasic.
4. В папке вы найдёте исполняемые файлы: zxbc.exe (компилятор), zxbasm.exe (ассемблер) и другие. Для компиляции программ нам понадобится в первую очередь zxbc.exe.

Способ 2: Универсальная Python-версия (для Linux, macOS и Windows)​

1. Убедитесь, что у вас установлен Python версии 3.12 или выше .
2. Скачайте архив с Python-скриптами (например, ZXBasic_Py_<version>.zip) со страницы релизов .
3. Распакуйте его в любую папку.
4. Основные скрипты — zxbc.py, zxbasm.py. Для их запуска вам потребуется интерпретатор Python.

Способ 3: NextBuild (для ZX Spectrum Next)​

1. Скачайте NextBuild с официального сайта или GitHub.
2. Распакуйте архив.
3. Откройте папку Sources в Visual Studio Code (рекомендуемая IDE) .
4. Установите рекомендуемые расширения (включая em00k.nextbuild и maziac.asm-code-lens) .

НАСТРОЙКА СРЕДЫ РАЗРАБОТКИ​

isual Studio Code + Boriel Basic Extension​

1. Запустите VS Code.
2. Нажмите Ctrl+Shift+X, найдите "Boriel Basic" от rtorralba и установите .
3. Расширение добавит:
   
   • Подсветку синтаксиса Boriel Basic .
   • Автодополнение команд и функций .
   • Компиляцию прямо из редактора (Ctrl+Shift+B) .
   • Запуск в эмуляторе одной кнопкой .
   • Отображение ошибок прямо в коде .

Структура проекта​

MyGame/
├── src/
│   ├── main.bas          # Основной файл программы
│   ├── sprites.bas        # Данные спрайтов
│   └── music.bas          # Музыкальные данные
├── assets/
│   ├── graphics/          # Исходники графики
│   └── sounds/            # Исходники звуков
├── build/                  # Сюда компилируется .tap/.nex
└── .vscode/
    └── tasks.json          # Настройка задач сборки

РАБОЧИЙ ПРОЦЕСС (ДЕНЬ ОПЛАТЫ)​

Шаг 1: Пишем код​

' Современный Boriel Basic (комментарии через апостроф)
'!org=32768    ' Директива компилятора: адрес загрузки

' Определяем типизированные переменные
DIM score AS UInteger = 0
DIM lives AS Byte = 3
DIM player_x AS Byte = 128
DIM player_y AS Byte = 96

' Процедура инициализации
SUB init()
    BORDER 0: PAPER 0: INK 7: CLS
    PRINT AT 0,0; "SCORE:"; score
    PRINT AT 0,20; "LIVES:"; lives
END SUB

' Главная процедура обновления
SUB update()
    ' Проверка клавиш
    IF INKEY$ = "q" THEN player_x = player_x - 1
    IF INKEY$ = "w" THEN player_x = player_x + 1
    
    ' Отрисовка
    PLOT player_x, player_y
END SUB

' Основная программа
init()

DO
    update()
    PAUSE 2    ' Небольшая задержка
LOOP

Шаг 2: Компилируем​

zxbc.exe game.bas -t -B -a -o game.tap

• -t — создать TAP-файл (образ ленты)
• -B — добавить BASIC-загрузчик
• -a — автозапуск после загрузки
• -o game.tap — имя выходного файла

Шаг 3: Запускаем и тестируем​

• Загрузить в любой эмулятор Spectrum (Fuse, ZEsarUX, CSpect)
• Перекинуть на реальный Spectrum через аудиокабель или DivMMC
• Запустить прямо из VS Code, если настроен эмулятор

РОДВИНУТЫЕ ВОЗМОЖНОСТИ​

Типы данных​

Управляющие конструкции​

FOR i = 0 TO 255 STEP 2
    PRINT i
NEXT i

DO
    ' Бесконечный цикл
LOOP

DO WHILE a < 10
    a = a + 1
LOOP

IF score > 1000 THEN
    lives = lives + 1
    score = 0
ELSEIF lives = 0 THEN
    PRINT "GAME OVER"
ELSE
    PRINT "Keep going!"
END IF

SELECT CASE keypress
    CASE 1 TO 4
        PRINT "Movement key"
    CASE 13
        PRINT "ENTER"
    CASE ELSE
        PRINT "Other key"
END SELECT

Процедуры и функции​

' Процедура (не возвращает значение)
SUB draw_player(x AS Byte, y AS Byte)
    PLOT x, y
END SUB

' Функция (возвращает значение)
FUNCTION max(a AS Integer, b AS Integer) AS Integer
    IF a > b THEN
        RETURN a
    ELSE
        RETURN b
    END IF
END FUNCTION

' Использование
draw_player(player_x, player_y)
LET highest = max(100, 200)

Вставки на ассемблере​

SUB fast_copy(src AS UInteger, dst AS UInteger, len AS UInteger)
    ASM
        ; HL = источник, DE = приёмник, BC = длина
        ld hl, (src)
        ld de, (dst)
        ld bc, (len)
        ldir           ; Быстрое копирование
    END ASM
END SUB

Директивы компилятора​

ЭКОСИСТЕМА: BORIEL BASIC И ZX SPECTRUM NEXT​

NextLib — библиотека для работы с железом Next​

'!org=32768
'!heap=2048

#define NEX
#include <nextlib.bas>

' Загружаем спрайты с SD-карты в банк 34
LoadSDBank("sprites.spr", 0, 0, 0, 34)

' Инициализируем спрайты
InitSprites2(64, $C000, 34)

DO
    ' Обновляем позицию спрайта
    UpdateSprite(player_x, player_y, 0, 0, 0, 128)
    WaitRetrace(1)   ' Ждём обратный ход луча
LOOP

СРАВНЕНИЕ: BORIEL BASIC VS SINCLAIR BASIC​

ПЛЮСЫ И МИНУСЫ​

Плюсы (Почему это гениально)​

• Скорость ассемблера, простота Бейсика — идеальный баланс для создания игр .
• Современный синтаксис — забудьте про GOTO и номера строк .
• Типизация — контроль памяти и ускорение кода .
• Ассемблерные вставки — для критических участков .
• Поддержка ZX Spectrum Next — доступ ко всем возможностям современного железа .
• Активное сообщество — помощь от автора и других разработчиков .
• Отличная документация — подробная официальная документация на ReadTheDocs .
• Книга-бестселлер — существует исчерпывающее руководство на английском (678 страниц!) от Хуана Сегура Дурана, ставшее бестселлером в Испании и получившее восторженные отзывы .

Минусы (О чём нужно знать)​

• Не 100% Sinclair-совместимость — некоторые старые программы могут требовать адаптации (особенно массивы с базой 1) .
• Нет INPUT в стандартной поставке — нужно использовать --sinclair флаг или писать свой ввод .
• Требует установки — это кросс-компилятор, нужно ставить на ПК, нельзя писать прямо на Spectrum.
• Порог входа для абсолютных новичков — хотя он ниже, чем у ассемблера, некоторые концепции (типы данных, компиляция) могут быть незнакомы.

СОВЕТЫ БЫВАЛОГО (ОПТИМИЗАЦИЯ РАБОТЫ)​

1. Всегда объявляйте типы переменных. Это не только ускоряет код, но и защищает от ошибок .
2. Используйте самый маленький тип данных. Для координат — Byte (0-255), для счёта — UInteger .
3. Включайте оптимизацию. Уровень 4 ('!opt=4) даёт максимальную производительность .
4. Для Next используйте NextBuild. Он берёт на себя всю настройку и даёт готовые библиотеки .
5. Пишите структурно. SUB и FUNCTION делают код понятным и переиспользуемым .
6. Экспортируйте графику через ZX Graphics Editor. Есть специальный экспорт в формат Boriel Basic (DIM-стиль) .
7. Читайте книгу Хуана Сегура Дурана. Это 678 страниц практических знаний, примеров и советов .

РЕСУРСЫ И ССЫЛКИ​

• Официальная документация: zxbasic.readthedocs.io
• GitHub репозиторий: github.com/boriel-basic
• Расширение для VS Code: Boriel Basic на Marketplace
• NextBuild (для ZX Spectrum Next): wiki.specnext.dev/NextBuild:Main_Page
• Книга на Amazon: "Boriel Basic for ZX Spectrum: A guide for beginners…"
• Telegram-канал: "Boriel ZX Basic" (активное сообщество)

ЗАКЛЮЧЕНИЕ: НОВАЯ ЭРА BASIC-ПРОГРАММИРОВАНИЯ​