Moduł Base

Moduł podstawowy

» Base.hpp - nagłówek
» Base.txt - dokumentacja

• Podstawy:
  • Włącza: <cassert>, <string>, <vector>
  • Definiuje: using std::string;
  • Typy całkowitoliczbowe: uint1, uint2, uint4, uint8 int1, int2, int4, int8
• Różne drobne, użyteczne makra i funkcje
• Operator dosłownej reinterpretacji bitowej absolute_cast
• Inteligentne wskaźnki i uchwyty
  • Parametryzowane polityką zwalniania
  • Z wyłączną własnością lub ze zliczaniem referencji
• Funkcje do operacji na znakach i łańcuchach, w tym oprócz prostych także:
  • Konwersja między stronami kodowymi: Windows-1250, ISO-8859-2, IBM CP852, UTF-8
  • Dopasowanie do maski ze znakami wieloznacznymi '*' i '?'
  • Odległość edycyjna łańcuchów - Levenshtein Distance
  • Porównywanie łańcuchów w tzw. porządku naturalnym
• Funkcje do operacji na ścieżkach do plików
  • Działające zarówno dla ścieżek Windows jak i Linux
• Konwersje różnych typów do i z łańcucha znaków, w tym:
  • Własne IntToStr, StrToInt, UintToStr, StrToUint sprawdzające błędy składni i zakresu
  • Uogólniony, rozszerzony mechanizm konwersji zrealizowany za pomocą szablonów SthToStr i StrToSth
  • Wygodny mechanizm formułowania łańcuchów korzystający z powyższego, np.: string s = Format("x=#, y=#") % x % y;
• Dokładny pomiar czasu i czekanie określony czas
• Podstawowe typy, stałe, makra i funkcje matematyczne, w tym oprócz prostych także:
  • Funkcja wygładzająca metodą Critically Damped Smoothing
  • Funkcje okresowe - sinus, trójkąta, prostokątna, piłokształtna, PWM
• Generator liczb pseudolosowych
  • Bardzo szybki, deterministyczny
  • Losowanie liczb różnych typów
  • Generowanie losowych danych binarnych
  • Losowanie liczb o rozkładzie normalnym (Gaussa)
• Generator unikatowych identyfikatorów
• Parser parametrów przekazanych z wiersza poleceń
  • Szybki i prosty w użyciu
  • Wsparcie zarówno dla main (int argc, char **argv), jak i WinMain (char *CmdLine)
  • Obsługuje opcje krótkie (jednoznakowe) i długie (wieloznakowe), w formatach:
    • Linuksa: -a -b -c -abc --długa -lARG -l ARG -l=ARG
    • Windowsa: /a /b /c /długa /lARG /l ARG /l=ARG
• Klasa bazowa dla wzorca projektowego Singleton

Moduł Config

Obsługa plików konfiguracyjnych

» Config.hpp - nagłówek
» Config.txt - dokumentacja

Obsługuje hierarchiczne pliki konfiguracyjne o składni wzorowanej na C/C++.

Moduł DateTime

Data i czas

» DateTime.hpp - nagłówek
» DateTime.txt - dokumentacja

• Dostępne typy:
  • WEEKDAY - Dzień tygodnia
  • MONTH - Miesiąc roku
  • NAME_FORM - Sposób generowania nazw dla dni tygodnia i miesięcy
  • DATESPAN - Reprezentuje odcinek czasu jako liczbę lat, miesięcy, tygodni i dni
  • TIMESPAN - Reprezentuje odcinek czasu jako liczbę milisekund
  • TMSTRUCT - Reprezentuje moment czasu jako pola: dzien, miesiąc, rok, godzina, minuta, sekunda, milisekunda oraz dzień tygodnia
  • DATETIME - Reprezentuje moment czasu jako liczbę milisekund od 1 stycznia 1970.
• Dokładne pobieranie bieżącego czasu
• Konwersja do i z łańcucha, dowolne formatowanie
• Konwersje między typami daty i czasu - z tej biblioteki oraz z biblioteki standardowej C
• Przeładowane operatory

Moduł Dator

Otoczka na pojedynczą wartość dowolnego typu

» Dator.hpp - nagłówek
» Dator.txt - dokumentacja

Moduł Error

Klasy wyjątków do obsługi błędów

» Error.hpp - nagłówek
» Error.txt - dokumentacja

• Ujednolicony mechanizm obsługi błędów w programie z użyciem wyjątków C++
• Wyjątek przechowuje stos komunikatów
• Makra ułatwiające obsługę błędów
• Wsparcie dla błędów zgłaszanych przez: errno, Win32API, SDL, OpenGL, DirectX, FMOD, WinSock, DevIL, AVIFile

Moduł Files

Obsługa plików i systemu plików

» Files.hpp - nagłówek
» Files.txt - dokumentacja

• FileStream - klasa strumienia do zapisywania i odczytywania treści pliku
• DirLister - klasa do listowania zawartości katalogu
• Funkcje do operacji na systemie plików, w tym:
  • Zapisywanie i odczytywanie całych plików
  • Sprawdzanie, czy plik albo katalog istnieje
  • Odczytywanie i zapisywanie daty modyfikacji, utworzenia i ostatniego dostępu
  • Tworzenie, usuwanie, zmiana nazwy i przenoszenie plików i katalogów

Moduł FreeList

Bardzo szybki alokator pamięci

» FreeList.hpp - nagłówek
» FreeList.txt - dokumentacja

Szablony klas FreeList oraz DynamicFreeList. Obiekty tych klas to napisane we własnym zakresie alokatory przeznaczone do alokowania dużych ilości zmiennych jednego wybranego typu, które działają znacząco szybciej niż standardowe operatory new i delete.

Moduł Logger

Mechanizm logowania komunikatów

» Logger.hpp - nagłówek
» Logger.txt - dokumentacja

• Bezpieczny wątkowo.
• Opcjonalnie logowaine odbywa się w osobnym wątku.
• Uogólnienie logów: Log to abstrakcyjny obiekt, którym może być plik, konsola i dowolne inne miejsce. Można pisać własne logi.
• Rozdzielenie komunikatów od logów: Zapisywane komunikaty trafiają do centralnego loggera, a stamtąd dopiero każdy jest mapowany na zero, jeden lub więcej logów.
• Uogólniony podział komunikatów: Komuniaty są opisywane przez maskę bitową, która może oznaczać kategorię, priorytet lub cokolwiek i którą można wykorzystać do mapowania na logi docelowe, na prefiksy, kolory i dowolne inne rzeczy zależnie od loga.

Moduł Math

Moduł matematyczny

» Math.hpp - nagłówek
» Math.txt - dokumentacja

• Wsparcie dla obiektów geometrycznych:
  • Punkt 2D, prostokąt 2D, prosta 2D
  • Wektor 2D, 3D, 4D
  • Macierz 4x4
  • Kwaternion
  • Płaszczyzna 3D
  • Prostopadłościan
  • Kolor
  • Promień/prosta 3D
  • Sfera
  • Trójkąt 3D
  • Frustum
• Kolizje między różnego rodzaju obiektami geometrycznymi
• Tablice liczb losowych o rozkładzie progresywnego Poisson Disc

Moduł Profiler

Przyrząd do pomiarów czasu i wydajności

» Profiler.hpp - nagłówek
» Profiler.txt - dokumentacja

Moduł Stream

Hierarchia klas strumieni

» Stream.hpp - nagłówek
» Stream.txt - dokumentacja

• Stream - klasa bazowa strumieni
• SeekableStream - klasa bazowa strumieni z obsługą długości i kursora
• CharWriter - klasa przyspieszająca zapisywanie do strumienia po znaku
• CharReader - klasa przyspieszająca odczytywanie ze strumienia po znaku
• MemoryStream - strumień do bloku pamięci o stałym rozmiarze
• VectorStream - strumień do samorozszerzającego się bloku pamięci
• StringStream - strumień do łańcucha typu string
• OverlayStream - klasa bazowa nakładek na strumienie
• CounterOverlayStream - nakładka zliczająca zapisywane i odczytywane dane
• LimitOverlayStream - nakładka ograniczająca ilość zapisywanych i odczytywanych danych
• MultiWriterStream - strumień zapisujący na raz do wielu strumieni
• Hash_Calc - strumień liczący hash
• CRC32_Calc - strumień liczący sumę kontrolną CRC32
• MD5_Calc - strumień liczący sumę kontrolną MD5
• XorCoder - strumień szyfrujący i deszyfrujący dane operacją XOR
• BinEncoder, BinDecoder - strumień kodujący, dekodujący dane binarne jako ciąg zer i jedynek. Szczyt bezużyteczności :) Każdy bajt zamienia na 8 znaków.
• HexEncoder, HexDecoder - strumień kodujący, dekodujący dane binarne jako ciąg liczb szesnastkowych. Każdy bajt zamienia na 2 znaki.
• Base64Encoder, Base64Decoder - strumień kodujący, dekodujący dane binarne w formacie Base64. Każde 3 bajty zamienia na 4 znaki.
• RingBuffer - bufor kołowy.

Moduł Threads

Biblioteka do wielowątkowości i synchronizacji

» Threads.hpp - nagłówek
» Threads.txt - dokumentacja

• Thread - klasa wątku
• Obiekty synchronizujące:
  • Mutex - muteks
    • Klasa pomocnicza MutexLock i makro MUTEX_LOCK
  • Semaphore - semafor zliczający
  • Cond - zmienna warunkowa
  • Barrier - bariera
  • Event - zdarzenie (auto-reset lub manual-reset)

Moduł Tokenizer

Parser składni języka podobnego do C/C++

» Tokenizer.hpp - nagłówek
» Tokenizer.txt - dokumentacja

Moduł ZlibUtils

Moduł wspmagający biblioteki zlib

» ZlibUtils.hpp - nagłówek
» ZlibUtils.txt - dokumentacja

• ZlibCompressionStream - strumień kompresji danych do formatu zlib
• GzipCompressionStream - strumień kompresji danych do formatu gzip
• ZlibDecompressionStream - strumień dekompresji danych z formatu zlib
• GzipDecompressionStream - strumień dekompresji danych z formatu gzip
• GzipFileStream - strumień zapisu i odczytu pliku w formacie gzip (.gz)