BasicC dla WWW przejmuje cechy i funkcje JavaScript, podczas gdy standardowa wersja oparta jest na C, wiąże się to z szeregiem niezgodności. Aby uzyskać maksymalną zgodność należy stosować się do określonych zasad. Przede wszystkim należy używać komend Basic, a unikać specyficznych funkcji JavaScript czy C.

Struktury i unie Najlepiej nie korzystać z tych obiektów zastępując je zwykłymi zmiennymi. Wersja WWW nie posiada unii, posiada obiekty podobne do struktur, ale obsługiwane inaczej. Deklaruje się je tak jak zwykłe zmienne JS, ponieważ w JS nie ma ścisłego określania typu, np: const point; I już można używać point jak struktury, np: point.x=0;point.y=0; Można też zainicjować zmienną podczas deklaracji oddzielając pola przecinkiem: const point={x:0,y:0};

Tablice Tablice w JS deklaruje się inaczej niż w C. Zaleca się używanie specjalnych deklaracji BasicC z użyciem słów Dim, Arr lub ByteBuffer + ...Array z odpowiednim przedrostkiem typu. Nie można bezpośrednio deklarować tablic wielowymiarowych. Najpierw deklarujemy tablicę jednowymiarową, następnie każdy jej element oddzielnie inicjujemy jako tablicę, otrzymując tablicę dwuwymiarową, i.t.d. Np: int a Dim(10); For(i,0,9) a[i]=[]; Next Otrzymujemy tablicę dwuwymiarowa, gdzie pierwszy wymiar wynosi 10, a drugi jest nieokreślony. Możemy się do jej elementów odnosić przy pomocy nawiasów, np. a=5;

Funkcje matematyczne Większość funkcji, np. cos, używamy bez przedrostka Math stosowanego w JS, czyli piszemy cos zamias Math.cos. Zapis Math.cos zostanie zamieniony przez preprocesor na Math.Math.cos, co spowoduje błąd. Ln oznacza logarytm naturalny. Funkcje te są zdefiniowane w BasicWWW.h Funkcje Round, Ceil, Floor działają dokładnie tak samo jak round, ceil, floor.

Obsługa plików Brak większości komend obsługi plików. Zaimplementowane są jedynie specjalistyczne funkcje ładowania obrazów, czy dźwięku oraz komendy:

BAppend(N,B) Dopisuje B (zmienna lub napis) do pliku o nazwie N, jeśli plik nie istnieje - tworzy nowy.

BLoad(N,B) Wczytuje plik o nazwie N do bufora B typu ByteBuffer.

BSave(N,B) Zapisuje B (zmienna lub napis) w nowym pliku o nazwie N, jeśli już istnieje - jest kasowany.

Kill(N) Usuwa plik o nazwie N.

LoadText(N,S) Powoduje wczytanie pliku tekstowego o nazwie N i przypisanie do zmiennej S.

Komendy te mogą być używane tylko wewnątrz funkcji MAIN lub oznaczonych jako asynchroniczne za pomocą słowa async, ponieważ wymuszają synchroniczność, czyli program (podprogram) powinien zostać wstrzymany do czasu załadowania pliku.

Magazyn przeglądarki Możemy w nim przechowywać dane podobnie jak w pliku. Każdy element jest parą ciągów tekstowych {klucz,wartość}.

Read(K) Zwraca wartość zapisanego elementu o kluczu K.

Write(K,D) Zapisuje wartość D jako element o kluczu K.

Remove(K) Usuwa element o kluczu K z magazynu.

ClearStorage Czyści całą zawartość magazynu.

Konsola / terminal Poniżej "okna" graficznego wyświetlana jest konsola tekstowa pełniąca funkcję okna terminala. Można ją ukryć komendą CloseCon i przywrócić przez OpenCon. W zwykłym BasicC komendy te są ignorowane. Komendy Input oraz Input$ nie działają w konsoli, lecz powodują wyświetlenie nowego okna dialogowego, mogą nie wstrzymywać programu na czas wprowadzania danych. Dostępne są dodatkowe komendy:

PrLog(...) Wyświetla w konsoli przeglądarki (dostępnej w narzędziach dla programistów) podany ciąg tekstowy. Zamiennik console.log w JS, której nie zaleca się używać.

Prr(S) Umożliwia wypisywanie w konsoli tekstu oraz liczb powodując dodatkowo wyczyszczenie wcześniejszej zawartości.

Napisy Wersja WWW dziedziczy po JavaScripcie szereg komend obsługi napisów, nie ma też ograniczenia ich długości, jednak kompatybilność z wersją standardową zapewniają jedynie komendy Basic. Nie ma rozróżnienia na napisy typu $, czyli np. Add i Add$ dają ten sam efekt, a String$(S) nie robi nic. Komendy tekstowe nie wykorzystują zmiennej STRING$ i nie powodują zmiany jej zawartości. Litery UTF, które w pamięci zajmują więcej niż 1 bajt, traktowane są jak 1 znak, nie zaimplementowano funkcji LenChr oraz LenUTF. Nie zaimplementowano też komendy MemSet.

Wskaźniki W JS nie ma jawnej deklaracji wskaźników. BasicPJS usuwa symbole wskaźnika *, pod warunkiem, że zostały umieszczone zaraz po określeniu typu zmiennej, beż żadnych spacji, np. SDL_Texture*.

Grafika Do wyświetlania grafiki wykorzystywany jest obszar okna zwany płótnem (canvas). Jest podstawowe płótno, na którym wyświetlane są obrazy z wykorzystaniem WebGL, na co nakładane jest dodatkowe płótno (tzw canvas2d) z przeźroczystym tłem, na którym można wyświetlać grafikę tworzona standardowymi komendami JS, głównie napisy i prymitywne kształty jak punkt, linia, prostokąt, koło. Obrazy są wyświetlane nawet szybciej niż w wersji standardowej wykorzystującej SDL, która jest jedną z najszybszych bibliotek. Obszar okna przeglądarki traktowany jest jak ekran, a płótna jak okno. W głównym sposobem wyświetlania obrazów jest wykorzystanie pętli MAINLOOP, zwykłe pętle powodują jakby zawieszenie przeglądarki, nie generuje wtedy obrazu i nie odczytuje zdarzeń. Wyświetlanie odbywa się z częstotliwością zależną od przeglądarki, parametr SYNC nie ma znaczenia. Zmienna Display.refresh_rate ma zawsze wartość 60, niezależnie od faktycznej częstotliwości, a Display.driverdata 0. Dodatkowo można zdefiniować 4-wymiarową macierz przekształcania obrazu przypisaną do zmiennej TransMatrix, przez którą przemnożone zostaną dane obrazu. Zdefiniowana jest też funkcja MulMatrix4(a,b) zwracająca macierz będąca wynikiem mnożenia macierzy 4-wymiarowych a i b. Jest to wykorzystywane przez komendę SetScale, która ustawia i włącza skalowanie, oraz dodatkowa komendę SetPerspective. Brak komendy IntScaling, przekształcenia wyłączamy komendą TransformOff, która przypisuje zmiennej TransMatrix wartość NULL.

SetPerspective(P,TZ,RX,RY) Ustawia macierz przekształceń dając efekt perspektywy wykorzystując 3. wymiar z oznaczający przesunięcie w głąb ekranu. Jest ona wykorzystywana np. w grze GPRO. P - współczynnik perspektywy, dobry efekt daje wartość 1. TZ - przesunięcie obrazu wzdłuż osi z, zwykle wartości ułamkowe z zakresu . RX, RY - obrót wokół osi x lub y o dany kąt w stopniach.

AddScaling(sx,sy,sz) SetScale ustawia nową macierz przekształceń, natomiast AddScaling modyfikuje istniejącą macierz dodając do niej dane skalowanie włącznie ze skalowaniem wymiaru z. Stosujemy ją np. po wcześniejszym użyciu SetPerspective.

#define SCALEQUALITY NEAREST Jest to domyślna definicja w BasicWWW.h sposobu obliczania kolorów przy skalowaniu obrazów przez WebGL. Zastąpienie NEAREST parametrem LINEAR spowoduje, że przejścia kolorów będą płynne. Taką definicję można wpisać w programie przed załączeniem BasicWWW.h. W zwykłym BasicC nie da to żadnego efektu.

SDLOpen(flag) Komenda inicjacji grafiki, wartość flag ma wpływ tylko na wielkość obszaru graficznego: 0 - rozmiar WINDOWWxWINDOWH - domyślnie 640x400 >=1 - tryb pełnoekranowy, ale wirtualna rozdzielczość nadal wynosi WINDOWWxWINDOWH, to samo uzyskujemy komendą FullscreenWindow lub MaximizeWindow

Cls2 ClRect2(X,Y,W,H) Cls i ClRect powodują wypełnienie danego obszaru płótna WebGL aktualnym kolorem, natomiast Cls2 i ClRect2 wypełniają płótno Canvas2d kolorem czarnym, przeźroczystym.

SetDrawBlendMode(Mode) Jest duża różnica w działaniu komend mieszania w porównaniu ze standardowym BasicC, gdzie komenda ta ustawia sposób mieszania kolorów przy rysowaniu tzw. prymitywów, a inne komendy ustawiają mieszanie dla konkretnego obrazka. W wersji WWW komenda ta nie ma wpływu na rysowanie prymitywów, lecz ustawia mieszanie dla wszystkich obrazków, włącznie z czcionką GPRINT. Dostępne tryby to: SDL_BLENDMODE_NONE SDL_BLENDMODE_BLEND SDL_BLENDMODE_ADD SDL_BLENDMODE_MOD SDL_BLENDMODE_REV SDL_BLENDMODE_SUB Uwaga! Komenda InvertImg powoduje zmianę trybu na SDL_BLENDMODE_REV

ImgColorModRGBA(r,g,b,a) Jest zamiennikiem ImgColorModRGB oraz ImgColorMod, ale ustawia tryb mieszania we wszystkich kolejnych operacjach na obrazach polegający na modulacji kolorów, na raz ustawiamy modulację RGB oraz Alfa. Jednocześnie ustawiana jest przeźroczystość, jak w SDL_BLENDMODE_BLEND. Komenda SetDrawBlendMode powoduję wyłączenie modulacji.

ShowPage Nie powoduje żadnego działania. Odświeżaniem ekranu steruje przeglądarka.

SDL_Texture Obraz SDL_Texture jest obiektem strukturalnym posiadającym dodatkowe pola: .tex - dane pikseli tekstury .w - szerokość w pikselach .h - wysokość .fb - obiekt framebuffer, jeśli obraz jest w trybie target

ImgBitmap W operacjach na bitmapach parametr pixels powinien być typu ByteBuffer

ImgFlip(f) Dla f=true powoduje odwrócenie symetryczne obrazu w niektórych operacjach.

WebGL używa odwrotnej geometrii w porównaniu do tradycyjnie używanej w komputerach - oś Y jest skierowana w górę, dlatego obrazy wysyłane do projektora są obracane, co powoduje, że przy pobieraniu bitmapy ekranu otrzymujemy obraz odwrócony. Przy pobieraniu bitmapy z projektora należy używać tej odwrotnej geometrii - punkt (0,0) to lewy-dolny róg obszaru.

GetImgC2d(X,Y,W,H,T) Odpowiednik GetImg dla drugiego płótna (canvas2d). Tu geometria jest tradycyjna - punkt (0,0) to lewy-górny róg obszaru.

ColorKey(S,c), ColorKeyRGB(S,R,G,B) Zerują składową Alfa danego koloru w obrazie S (ustawia przeźroczystość). Prawdopodobnie w przyszłości komenda ta również w zwykłym BasicC będzie dotyczyła obrazu SDL_Texture.

SaveBMP Nie zaimplementowana w wersji WWW!

Lines, Points, Rects, PRects Nie zaimplementowane. Rysowanie prymitywów odbywa się na drugim płótnie - canvas2d.

Zdarzenia systemowe JS inaczej obsługuje zdarzenia niż SDL, ale z punktu widzenia programisty BasicC wygląda to podobnie. Główna różnica jest w działaniu zmiennej InKey, która w wersji WWW nie ma efektu samopowtarzania klawisza, ale pojawia się on, jeśli program działa wewnątrz MAINLOOP. Inne są kody klawiszy, kody w JS są napisami, ale można to ujednolicić definiując makra, np. #define SDL_SCANCODE_A "KeyA", co dla części klawiszy zostało zrobione w BasicWWW.h. Odpowiednikiem SDL_SCANCODE są w JS wartości code zdarzenia klawiatury, a SDLK wartości key, odpowiednie wartości można odczytać np. na stronie https://www.toptal.com/developers/keycode Do prawidłowego odczytu stanu klawisza z pomocą InKey(code) konieczne może być uzupełnienie definicji zmiennej SDLKeyboardState zawartej w BasicWWW.h przypisującej kluczom code - klawiszy używanych w programie (np. grze) wartości 0, przykładowo: const SDLKeyboardState={"ArrowDown":0,"ArrowUp":0,"ArrowRight":0};

Inaczej obsługuje się dotyk. Nie używa się komendy GetFinger, a przy odczycie palca podajemy jego numer, np. FingerX(0) podaje współrzędną X dotknięcia względem okna przeglądarki w pikselach. Przed odczytem stanu joystick'ów należy wywołać komendę GetJoys - aktualizuje ona stany wszystkich manipulatorów.

WaitInKey, WaitMouseU, WaitMouseD w WWW nie dają żadnego efektu. Nie działają też funkcje zdarzeń TextInput i okna. Nie działa SetMouse. GetEvents nie daje żadnego efektu, pobieraniem zdarzeń steruje przeglądarka.

Napisy graficzne Napisy GPRint są obrazami tworzonymi na płótnie webgl. Nie działają komendy: GPrintF, GPrintFAt Wyłączenie trybu mieszania kolorów przywraca biały kolor czcionki. Nie zaimplementowano funkcji biblioteki SDL_ttf, zamiast niej zdefiniowano funkcje pisania na płótnie canvas2d:

Font(F) Wybieramy rodzaj, styl i wielkość czcionki, szczegóły w dokumentacji JavaScript. Parametr podajemy bez cudzysłowu.

FontStretch(s) Ustawia rozciągnięcie czcionki. Parametr podajemy bez cudzysłowu.

StrokeText(X,Y,Txt) Wyświetla text i Txt w pozycji X, Y bez wypełnienia.

StrokeTextMax(X,Y,Txt,M) J.w. + parametr M określający maksymalna szerokość tekstu.

Text(X,Y,Txt), TextMax(X,Y,Txt,M) Wyświetlają tekst wypełniony

TextAlign(a) Określa sposób przesunięcia tekstu względem pozycji X. Parametr podajemy bez cudzysłowu.

TextBaseline(b)