BasicC/Podstawy

 BasicC jest biblioteką C oraz JavaScript ułatwiającą programowanie w tych językach, zawiera też obsługę SDL oraz prosty interfejs graficzny GEM. Większa część podręcznika dotyczy biblioteki C składającej się z plików nagłówkowych Basic.h, BasicSDL.h, BasicGEM.h, BasicSND.h. Dodatkowy plik BASICC.h jest odpowiednikiem Basic.h, w którym komendy pisane są w całości dużymi literami. Niniejsza instrukcja będzie odnosić się do Basic.h, w której dużymi literami zapisuje się tylko początki poszczególnych członów komend, z wyjątkami, jak operatory, niektóre zmienne i stałe. Biblioteka JavaScript składa się z plików BasicWWW.h, BasicC.html oraz BasicPJS. Większość komend zdefiniowano za pomocą dyrektyw preprocesora. W procesie pre-kompilacji komendy te są zamieniane na standardowe instrukcje języka C. Powinny też działać w C++, choć mogą być konieczne drobne poprawki w plikach nagłówkowych. Ponadto BasicC zawiera dodatkowe funkcje nie zawarte w standardowym C i SDL.
Głównym celem BasicC miało być stworzenie prostszej składni, wyeliminowanie średników, klamer i wskaźników stosowanych w C, co udało się tylko częściowo. Średniki stosuje się nadal, gdy używamy składni C, głównie przy deklaracji zmiennych, podstawianiu i wywoływaniu funkcji.
 By używać BasicC należy przyłączyć bibliotekę Basic.h lub, jeśli używamy SDL, BasicSDL.h, lub BasicGEM.h poprzez wpisanie na początku naszego programu dyrektywy preprocesora, np.: #include "Basic.h". Pliki te najlepiej skopiować do katalogu naszego programu. Jeśli nie korzystamy z SDL i GEM - wystarczy tylko Basic.h, jeśli korzystamy - dodatkowo BasicSDL.h i BASFont.bmp, jeśli korzystamy z GEM - dodatkowo BasicGEM.h. Standardowo BasicC załącza podstawowe biblioteki C: stdio.h, stdlib.h, string.h, więc nie trzeba ich oddzielnie dołączać. BasicSDL.h zawiera załączenie SDL.h, BasicSND, opcjonalnie: SDL_image.h, SDL_ttf.h, SDL_mixer.h i math.h. BasicGEM załącza BasicSDL.h. Sposób używania wersji dla WWW opisany jest w oddzielnym rozdziale.
 Wpisanie na początku programu dyrektywy #define DEBUG 1 włącza tryb kontroli błędów, w którym niektóre komendy wypisują w terminalu informacje o ew. błędach np. przekroczenie zakresu, zbyt długi tekst. DEBUG 0 oznacza tryb zwykły. Tryb DEBUG może spowalniać działanie programu, ale jest zalecany podczas testowania.

Opis plików:

Basic.h, BASICC.h - podstawowe komendy
BasicSDL.h - obsługa SDL, załączamy zamiast Basic.h
BASFont.bmp - czcionki bitmapowe wykorzystywane przez BasicSDL.h
BasicGEM.h - obsługa GEM, załączamy zamiast BasicSDL.h
BASSND.h - podstawowa obsługa dźwięku, załączany przez BasicSDL.h zamiast BasicSND.h
BasicSND.h - obsługa dźwięku, załączany przez BasicSDL.h
BasicOGG.h - ładowanie plików .OGG dla BasicSND.h
lodepng.h - obsługa obrazów .PNG, załączany w BasicSDL.h
micromod.h - ładowanie plików .MOD dla BasicSND.h
BasicWWW.h - zamiennik powyższych bibliotek dla wersji WWW, stosujemy zamiast BasicSDL.h i Basic.h.
BasicC.html - kod strony html uruchamiającej nasz program w przeglądarce
BasicPJS - "kompilator" BasicC do JavaScript.
Ponadto może być konieczne dołączenie do programu plików bibliotek jak SDL2.dll, czy SDL2_image.dll.