🎨 VSCode-NEXTBASIC: СОВРЕМЕННЫЙ РЕДАКТОР ДЛЯ НОВЕЙШЕГО БЕЙСИКА

ВСТУПЛЕНИЕ: ОТ ЭКРАНА 32×24 К БЕСКОНЕЧНЫМ ПОЛОТНАМ VS CODE​

ЧТО ТАКОЕ VSCode-NEXTBASIC И ЗАЧЕМ ОНО НУЖНО?​

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

1. Подсветка синтаксиса NextBASIC 2.08+ — все команды, директивы и структуры разноцветные и наглядные .
2. Автодополнение и подсказки — помощь при вводе команд, подсказки по параметрам .
3. Навигация по коду — переход к определению для GO TO и PROC, поиск символов для DEFPROC и DEF FN .
4. Рефакторинг — автоматическая перенумерация строк (для всего документа, выделенного блока или обмена строк) .
5. Валидация синтаксиса — проверка кода на ошибки прямо во время набора .
6. Форматирование — автоматическое выравнивание и отступы, поддержка сворачивания блоков DEFPROC .
7. Интеграция с CSpect — запуск кода в эмуляторе одной кнопкой .
8. Экспорт в TAP и BAS — создание готовых файлов для загрузки на реальный Next или в эмулятор .
9. Поддержка директив — #autostart, #autoline, #program, #define и работа с банками памяти через #bank и #bankfile .

ИСТОРИЧЕСКИЙ КОНТЕКСТ: ЭВОЛЮЦИЯ РЕДАКТОРОВ BASIC​

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

Шаг 1: Установка Visual Studio Code​

Шаг 2: Установка расширения​

1. Запустите Visual Studio Code.
2. Нажмите Ctrl+Shift+X (или иконку квадратиков слева), чтобы открыть вкладку Extensions.
3. В поиске введите "NextBASIC".
4. Найдите расширение от автора Remy Sharp (иконка с фиолетовым логотипом) и нажмите Install .

Шаг 3: Установка эмулятора CSpect (для запуска кода)​

1. Скачайте CSpect с официального сайта (или через менеджер пакетов).
2. Скачайте образ системы ZX Spectrum Next (файл .img или .hdf) — например, с сайта specnext.co.uk.
3. Распакуйте всё в удобную папку (например, C:\CSpect на Windows или ~/CSpect на macOS/Linux).

Шаг 4: Установка hdfmonkey (для работы с образами дисков)​

• Windows: скачайте специальную сборку с uto.speccy.org (без зависимостей от cygwin) .
• macOS: установите через brew install hdfmonkey .
• Linux: через пакетный менеджер (например, sudo apt install hdfmonkey).

Шаг 5: Настройка расширения​

Параметр	Описание	Пример
CSpect Path	Путь к исполняемому файлу CSpect	C:\CSpect\CSpect.exe (на Windows) или /usr/local/bin/CSpect (на macOS/Linux)
CSpect Options	Параметры запуска CSpect (опционально)	-w3 -zxnext -mmc=./
Next Image Path	Путь к образу SD-карты Next	C:\CSpect\next.img или ~/CSpect/next.hdf
hdfmonkey Path	Путь к hdfmonkey (если не в PATH)	C:\tools\hdfmonkey.exe
Auto Line Numbers	Автоматически добавлять номера строк при вводе	true или false
Use REM for Comments	Использовать REM (вместо для комментариев	false (рекомендуется ; — современный стиль)

СТРУКТУРА ПРОЕКТА И РАБОТА С ФАЙЛАМИ​

Что такое .bas файл?​

• Создавать новые файлы (File -> New File, сохранить как *.bas).
• Открывать существующие проекты.
• Импортировать бинарные NextBASIC-файлы (например, с реального Next) .

Типичная структура проекта​

MyNextProject/
├── src/
│   ├── main.bas           # Основной файл программы
│   ├── graphics.bas        # Процедуры для графики
│   ├── sound.bas           # Процедуры для звука
│   └── data.bas            # Данные (спрайты, таблицы)
├── assets/
│   ├── sprites/            # Спрайты (если нужны внешние файлы)
│   └── music/              # Музыкальные файлы
├── build/                   # Сюда будут генерироваться TAP/BAS файлы
└── .vscode/
    └── settings.json        # Настройки проекта (опционально)

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

Пишем код​

• Подсветка синтаксиса: команды PRINT, PROC, DEFPROC, FN — цветные.
• Автодополнение: начинаете печатать PR — выпадает список PRINT, PROC и т.д.
• Подсказки: наводите мышь на команду — видите её описание .

; Современный NextBASIC (комментарии через ;)
#autostart 10
#program "My Game"

10 REM ** Главная программа
   PROC setup
   PROC main_loop
   END

DEFPROC setup
   ; Очистка экрана и установка графики
   LAYER 2,0
   CLS
   PROC load_sprites
ENDPROC

DEFPROC main_loop
   DO
     ; Основной игровой цикл
     PROC update_objects
     PROC draw_screen
     IF INKEY$ = "q" THEN EXIT DO
   LOOP
ENDPROC

DEFPROC load_sprites
   ; Загрузка спрайтов в банки памяти
   #bank 1,"sprites.bin"
   SPRITE 0,0,0,16,16
ENDPROC

Форматирование​

Перенумерация строк (Renumber)​

1. Выделите блок кода (или ничего, если хотите перенумеровать весь файл).
2. Нажмите Ctrl+Shift+P, введите "NextBASIC: Renumber Document" (или "Renumber Selection").
3. Готово! Строки получили новые номера с шагом по умолчанию (можно настроить) .

Навигация​

• Перейти к определению: нажмите F12 на имени процедуры (PROC myproc) — и вы окажетесь там, где она объявлена (DEFPROC myproc) .
• Найти все вхождения: Shift+F12 на метке или переменной.
• Свернуть процедуру: кликните на стрелочку слева от DEFPROC — тело процедуры свернётся для лучшего обзора .

Проверка синтаксиса​

Запуск в CSpect​

1. Убедитесь, что CSpect и hdfmonkey настроены правильно.
2. Нажмите Ctrl+Shift+P, введите "NextBASIC: run with cspect".
3. Расширение:
   • Скопирует ваш код в образ диска (в файл autoexec.bas) .
   • Запустит CSpect с загруженным образом.
   • NextBASIC автоматически выполнит ваш код (если указана директива #autostart).
4. Наслаждайтесь результатом в эмуляторе!

Экспорт в TAP/BAS​

1. Нажмите Ctrl+Shift+P, введите "NextBASIC: Export as ...".
2. Выберите формат:
   • .tap — образ ленты, можно загрузить через эмулятор или на реальном Next через аудиовход.
   • .bas — файл в формате +3DOS, можно скопировать на SD-карту Next .

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

Директивы компиляции/экспорта​

Использование #define​

#define SCREEN_ADDR 16384
#define ATTR_ADDR 22528
#define BLACK_WHITE %01111000

; Дальше в коде можно писать:
PRINT AT SCREEN_ADDR
POKE ATTR_ADDR, BLACK_WHITE

Работа с банками памяти​

; Загружаем спрайты в банк 1 из файла
#bank 1,"sprites.bin"
#bankfile "game.bin"

; Используем спрайты в коде
SPRITE 0,0,0,16,16,1  ; Банк 1, спрайт 0

СРАВНЕНИЕ: VSCode-NEXTBASIC VS ТРАДИЦИОННЫЕ РЕДАКТОРЫ​

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

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

• Современный редактор: вся мощь VS Code — мультикурсор, поиск по проекту, Git, интеграция с терминалом.
• Специализирован именно под NextBASIC: не универсальный инструмент, а точный скальпель.
• Поддержка новейших возможностей Next: банки памяти, спрайты, директивы — всё это работает .
• Интеграция с CSpect: написал — нажал кнопку — увидел результат в эмуляторе .
• Экспорт в разные форматы: TAP для ленты, BAS для SD-карты .
• Активная разработка: автор Remy Sharp постоянно обновляет расширение (последний коммит был несколько месяцев назад) .
• Сообщество: вокруг расширения сложилось сообщество разработчиков для Next .

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

• Требуется настройка: чтобы запускать код в CSpect, нужно установить и настроить эмулятор и hdfmonkey. Это не сложно, но один раз сделать надо .
• Только для NextBASIC: если вы пишете на классическом Sinclair BASIC или на ассемблере — это расширение не для вас. Но для NextBASIC оно идеально.
• Зависимость от внешних инструментов: для запуска нужен CSpect, для экспорта — hdfmonkey .
• Нет отладчика в реальном времени: расширение не умеет ставить брейкпоинты и смотреть переменные (это делает эмулятор). Но для этого есть DeZog (но он для ассемблера, не для BASIC).
• Нет "ламповости": если вы фанат написания кода прямо на реальном Next с мерцающим экраном — это не ваш инструмент. Это инструмент для прагматиков.

СОВЕТЫ БЫВАЛОГО (КАК ВЫЖАТЬ МАКСИМУМ)​

1. Используйте современный синтаксис. Забудьте про REM для комментариев — используйте ;. Это короче и привычнее для программистов .
2. Пишите без номеров строк, а потом перенумеруйте. В NextBASIC номера строк не обязательны, но для совместимости со старым кодом их можно добавить автоматически через "Renumber".
3. Пользуйтесь #define. Если в программе много раз используется одно и то же число (адрес экрана, цвет), определите его один раз в начале. Потом легко менять .
4. Разбивайте код на несколько файлов. Используйте INCLUDE (директива NextBASIC) или просто держите процедуры в разных .bas файлах и копируйте вручную при сборке. Расширение позволяет открыть несколько файлов в одном проекте.
5. Настройте сниппеты. В VS Code можно создать свои шаблоны для часто используемых конструкций (например, для загрузки спрайтов или настройки слоёв).
6. Используйте #bank для больших данных. Графика, музыка, таблицы — всё это можно вынести в отдельные бинарные файлы и подключать через банки .
7. Автоматизируйте запуск. После настройки CSpect вы сможете запускать код одной командой — это ускоряет тестирование в разы.

ЭКОСИСТЕМА: С ЧЕМ ДРУЖИТ VSCode-NEXTBASIC​

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