CommonLib 8.0

Biblioteka CommonLib
Wersja: 8.0
Data: 29 marca 2008

CommonLib to uniwersalna biblioteka dla C++ zawierająca różnorodne elementy. Powstała przy okazji pisania silnika graficznego i różnych innych moich projektów. Obecna wersja jest pisana od wakacji 2006.

Właściwie od dziecka, odkąd tylko zacząłem programować (wtedy to był jeszcze Turbo Pascal pod DOS) zawsze rozwijałem jakąś swoją bibliotekę modułów bazowych, z którymi potem nigdy się nie rozstawałem pisząc swoje projekty. Teraz uważam, że nadal jest to potrzebne - szczególnie w C++, którego biblioteka standardowa - w przeciwieństwie do nowoczesnych języków i środowisk programowania takich jak Delphi, C# czy Java - jest bardzo uboga, a to co zawiera pozostawia wiele do życzenia.

Cechy i założenia

Jest to uniwersalna biblioteka do C++, chociaż pisana głównie z myślą o programowaniu gier.
Jest przenośna na Windows i Linux.
Używa tylko biblioteki standardowej C, C++ oraz API systemowego. Opcjonalnie współpracuje także z DirectX (D3DX), zlib i innymi bibliotekami.
Do przechowywania wszelkich łańcuchów stosuje typ string/wstring z biblioteki C++.
W systemie Windows może zostać przełączona w tryb pracy w Unicode.
Do obsługi błędów stosowane są wyjątki własnych klas z modułu Error. Jedynie funkcje wykonujące proste obliczenia lub konwersje nigdy nie rzucają wyjątków.
Nastawiona jest na maksymalną wydajność, ale nie kosztem kontroli błędów. Bardzo ważna jest też wygoda.
Wymaga dobrego kompilatora C++, ponieważ używa zaawansowanych cech języka takich jak częściowa specjalizacja szablonów. Kompilacja była testowana na Visual C++ 2005 oraz GCC 4.
Wszystkie elementy zgromadzone są w przestrzeni nazw common.
Komentarze w kodzie oraz dokumentacja są po polsku. Identyfikatory w kodzie są po angielsku. Komunikaty błędów i inne łańcuchy są po angielsku.
Nagłówki są udokumentowane za pomocą Doxygen.
Pliki z kodem mają polskie znaki w kodowaniu Windows-1250 z końcami wiersza w formacie Windows "\r\n". Biblioteka posiada funkcje do konwersji polskich znaków i końców wiersza.
Polega na rozmiarze, a nawet budowie bitowej typów atomowych takich jak znaki, liczby całkowite i zmiennoprzecinkowe. Przez to nie nadaje się do kompilacji na platformach z inną endianowością czy 64-bitowych.

Jak użyć

Biblioteka ma postać plików z kodem C++ - CPP i HPP. Możesz z tym kodem zrobić co chcesz. Najprościej jest po prostu skopiować te pliki i dodać do swojego projektu.

Poniżej opisana jest jedna z możliwości - przygotowanie kodu jako biblioteki LIB i jej użycie w projekcie w Visual C++ 2005. Niestety nie jest to tak banalne jak rozpakować i od razu zacząć używać. To nie moja wina - takie są uroki języka C++...

Aby przygotować bibliotekę LIB:

Utwórz projekt Visual C++ lub otwórz istniejący, który znajdziesz w pliku Common.sln.
Wejdź do opcji projektu i zmień:
1. Configuration Properties > General > Character Set: zależnie czy chcesz używać Unicode, ustaw na "Not Set" lub "Use Unicode Character Set" (w obydwu konfiguracjach - Debug i Release).
2. Configuration Properties > C/C++ > Code Generation > Runtime Library: zależnie jak będziesz kompilował kod swoich programów korzystających z CommonLib: jeśli chcesz aby nie musiały używać dodatkowych plików DLL z biblioteką standardową C (których część użytkowników nie ma), przestaw na "Multithreaded Debug" (konfiguracja Debug) i "Multithreaded" (konfiguracja Release). Jeśli wolisz otrzymywać mniejsze pliki EXE, wybierze "Multithreaded Debug DLL" (konfiguracja Debug) i "Multithreaded DLL" (konfiguracja Release).
3. Configuration Properties > C/C++ > Preprocessor > Preprocessor Definitions: W obydwu konfiguracjach (w każdej osobno) dopisz wybrane makra odpowiednio do bibliotek, których będziesz używał w swoim kodzie: USE_SDL, USE_OPENGL, USE_FMOD, USE_WINSOCK, USE_DEVIL, USE_AVI_FILE
4. Jeśli nie masz zainstalowanej biblioteki zlib, nie chcesz jej używać albo w ogóle nie wiesz co to jest, usuń z projektu pliki ZlibUtils.cpp i ZlibUtils.hpp.
Skompiluj bibliotekę w obydwu konfiguracjach - Debug i Release.
Załóz na swoim dysku jakiś katalog, gdzie umieścisz skompilowaną bibliotekę jako gotową do używania w projektach. Utwórz w nim podkatalog include i skopiuj do niego pliki HPP. Utwórz katalog lib i skopiuj do niego pliki Common.lib (który powstał w podkatalogu Release) i Common_d.lib (który powstał w katalogu Debug).
Skonfiguruj ścieżki do katalogów w Visual C++. W tym celu wybierze polecenie z menu Tools > Options. Po lewej zaznacz Projects and Solutions > VC++ Directories. Do "Include files" dopisz ścieżkę do podkatalogu includes. Do "Library files" dopisz ścieżkę do podkatalogu lib.

Aby skorzystać z tak skompilowanej biblioteki w swoim projekcie:

Utwórz lub otwórz istniejący projekt programu w Visual C++.
Dołącz wybane nagłówki biblioeki w postaci takiej jak np. include <Common/Base.hpp>. Jeśli używasz jakichkolwiek nagłówków CommonLib, musisz najpierw włączyć nagłówek Base.hpp.
Wejdź do opcji projektu i zmień:
1. Configuration Properties > General > Character Set: Tak jak wyżej.
2. Configuration Properties > C/C++ > Code Generation > Runtime Library: Tak jak wyżej.
3. Configuration Properties > C/C++ > Preprocessor > Preprocessor Definitions: Tak jak wyżej.
4. Opcjonalnie, jeśli masz procesor dwurdzeniowy: Configuration Properties > C/C++ > Command Line > Additional Options: Wpisz "/MP" (w obydwu konfiguracjach). To przyspieszy kompilację.
5. Opcjonalnie, skonfiguruj Precompiled Headers. Dopisz też do nich włączenie nagłówków CommonLib. Jeśli jeszcze nie wiesz, co to jest Precompiled Headers, dowiedz się czym prędzej - ten prosty mechanizm Visual C++ wielokrotnie przyspiesza kompilację!

Składniki i możliwości

Moduł Base

Moduł podstawowy

Dokumentacja: Module_Base
Elementy modułu: Moduł Base
Nagłówek: Base.hpp

Podstawy:
- Włącza m.in.: <cassert>, <string>, <vector>
- Typy podstawowe, m.in.: uint1, uint2, uint4, uint8 int1, int2, int4, int8
Różne drobne, użyteczne makra i funkcje
Operator dosłownej reinterpretacji bitowej common::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
- Konwersja między łańcuchami ANSI i Unicode (tylko Windows)
- 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 common::IntToStr, common::StrToInt, common::UintToStr, common::StrToUint sprawdzające błędy składni i zakresu
- Uogólniony, rozszerzony mechanizm konwersji zrealizowany za pomocą szablonów common::SthToStr i common::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

Dokumentacja: Module_Config
Elementy modułu: Moduł Config
Nagłówek: Config.hpp

Obsługa plików konfiguracyjnych

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

Moduł DateTime

Data i czas

Dokumentacja: Module_DateTime
Elementy modułu: Moduł DateTime
Nagłówek: DateTime.hpp

Dostępne typy:
- common::WEEKDAY - Dzień tygodnia
- common::MONTH - Miesiąc roku
- common::NAME_FORM - Sposób generowania nazw dla dni tygodnia i miesięcy
- common::DATESPAN - Reprezentuje odcinek czasu jako liczbę lat, miesięcy, tygodni i dni
- common::TIMESPAN - Reprezentuje odcinek czasu jako liczbę milisekund
- common::TMSTRUCT - Reprezentuje moment czasu jako pola: dzien, miesiąc, rok, godzina, minuta, sekunda, milisekunda oraz dzień tygodnia
- common::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

Dokumentacja: Module_Dator
Elementy modułu: Moduł Dator
Nagłówek: Dator.hpp

Moduł Error

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

Dokumentacja: Module_Error
Elementy modułu: Moduł Error
Nagłówek: Error.hpp

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

Dokumentacja: Module_Files
Elementy modułu: Moduł Files
Nagłówek: Files.hpp

common::FileStream - klasa strumienia do zapisywania i odczytywania treści pliku
common::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
Zapisywanie i odczytywanie plików i strumieni tekstowych w różnym kodowaniu, w tym Unicode (tylko Windows).

Moduł FreeList

Bardzo szybki alokator pamięci

Dokumentacja: Module_FreeList
Elementy modułu: Moduł FreeList
Nagłówek: FreeList.hpp

Szablony klas common::FreeList oraz common::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

Dokumentacja: Module_Logger
Elementy modułu: Moduł Logger
Nagłówek: Logger.hpp

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

Dokumentacja: Module_Math
Elementy modułu: Moduł Math
Nagłówek: Math.hpp

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

Dokumentacja: Module_Profiler
Elementy modułu: Moduł Profiler
Nagłówek: Profiler.hpp

Moduł Stream

Hierarchia klas strumieni

Dokumentacja: Module_Stream
Elementy modułu: Moduł Stream
Nagłówek: Stream.hpp

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

Moduł Threads

Biblioteka do wielowątkowości i synchronizacji

Dokumentacja: Module_Threads
Elementy modułu: Moduł Threads
Nagłówek: Threads.hpp

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

Moduł Tokenizer

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

Dokumentacja: Module_Tokenizer
Elementy modułu: Moduł Tokenizer
Nagłówek: Tokenizer.hpp

Moduł ZlibUtils

Moduł wspmagający biblioteki zlib

Dokumentacja: Module_ZlibUtils
Elementy modułu: Moduł ZlibUtils
Nagłówek: ZlibUtils.hpp

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

Obsługa Unicode

Od wersji 8.0 biblioteka posiada w systemie Windows możliwość pracy ze znakami i łańcuchami Unicode. Aby przełączyć CommonLib w tryb pracy z Unicode, należy podjąć te same kroki, co podczas przełączania do tego trybu WinAPI i DirectX. Trzeba w tym celu zdefiniować dla całego projektu makra preprocesora UNICODE i _UNICODE. W przypadki Visual C++ można przestawić w opcjach projektu, na zakładce Configuration Properties > General, opcję Character Set na Use Unicode Character Set - wówczas to makro zostanie dodane automatycznie.

Przy starannym stosowaniu się do poniższych zaleceń można pisać kod programu korzystający z WinAPI, DirectX i CommonLib tak, aby kompilował się i działał zarówno ze znakami Unicode, jak i zwykłymi ANSI, bez jakichkolwiek zmian w kodzie (wystarczy zmiana opisanego wyżej ustawienia).

Moduł definiuje typ znakowy common::tchar jako alias do char lub wchar_t oraz typ łańcuchowy common::tstring jako alias do std::string lub std::wstring, zależnie od ustawienia. Prawie wszystkie klasy i funkcje CommonLib korzystają z tych typów, tak że automatycznie przełączają się na używanie znaków i łańcuchów Unicode zależnie od tego ustawienia.

Łańcuch znaków ANSI zapisuje się w kodzie C++, jak wiadomo, w taki sposób: "ABC". Łańcuch znaków Unicode zapisuje się tak: L"ABC". Moduł Base definiuje makro, którym należy obejmować wszystkie łańcuchy w kodzie, jeśli chcemy, aby zostały zamienione na odpowiednią postać (ANSI lub Unicode) zależnie od ustawienia. Przykład: _T("ABC").

Jeśli piszemy kod, który ma działać zarówno ze znakami ANSI jak i Unicode, jako makro oznaczające nazwę bieżącego pliku źródłowego (podawane do konstruktora klas wyjątków modułu Error) używać należy zdefiniowanego w module Base makra __TFILE__. Podobnie, makro przechowujące sygnatuję bieżącej funkcji to __TFUNCSIG__.

Do konwersji między standardami kodowania znaków użyj funkcji common::ConvertUnicodeToChars i common::ConvertCharsToUnicode. Działają one tylko w Windows. Są niezależne od ustawienia _UNICODE. Pozwalają zamieniać łańćuchy między kodowaniem UTF-16 (Unicode), UTF-8 i ANSI (np. Windows-1250 w przypadku języka polskiego).

Jeśli piszesz kod, który ma się kompilować bez zmian zarówno w ANSI jak i Unicode, przydatne będą funkcje konwertujące łańćuchy między kodowaniem ASNI (typ string) lub Unicode (typ wstring), a tym używanym zależnie od ustawienia (typ common::tstring). Te funkcje to: common::TstringToString, common::StringToTstring, common::TstringToWstring, common::WstringToTstring. Jak można się domyślić, połowa z nich (która, to zależy od ustawienia) nic nie robi, tylko zwraca podany łańcuch.

Do zapisywania i odczytywania plików tekstowych w różnym kodowaniu służą funkcje modułu Files: common::SaveUnicodeToFile, common::SaveUnicodeToStream, common::LoadUnicodeFromFile, common::LoadUnicodeFromStream. W razie potrzeby automatycznie konwertują kodowanie znaków. Obsługują kodowanie ANSI, UTF-16 LE i UTF-8. Funkcje zapisujące mogą dołączać nagłówek BOM. Funkcje odczytujące, na podstawie nagłówka i analizy treści, mogą automatycznie rozpoznać kodowanie.

Mini FAQ

Skąd taka nazwa?

W moim głównym kodzie, z którego biblioteka się wywodzi, mam w Visual C++ w Solution szereg projektów. Jednym z nich jest silnik graficzny, innym pomocnicze narzędzie konsolowe czy program testujący. Kod wspólny dla wszystkich projektów zgromadziłem w katalogu, który nazwałem Common i tak już zostało.

Skąd taka wersja?

Faktycznie nie było CommonLib 4 czy 5, a wersja 6.1 była tak różna od 6.0, że powinna się nazywać 7.0. Jednak chciałem zrównać numerację biblioteki z numeracją mojego głównego projektu - silnika graficznego, na potrzeby którego napisałem tą bibliotekę.

Nowe wydanie - CommonLib 8.0 - nie oznacza że zacząłem pisać od nowa swój silnik graficzny. Oznacza raczej, że biblioteka przeszła wielkie zmiany po tym, jak silnik w wersji 7 został uznany za skończony.

Co nowego?

Wersja 8.0 (29 marca 2008)

Biblioteka przeszła wielkie zmiany. Logicznie większość kodu jest nadal kompatybilna wstecz, ale tekstowo zmiany są tak duże, że praktycznie nie ma sensu robić Diff. Ogólne, duże nowości:

W systemie Windows biblioteka może być teraz przełączona w tryb wsparcia dla Unicode (patrz Obsługa Unicode).
Komentarze w nagłówkach zostały zamienione na format Doxygen, co umożliwiło automatyczne wygenerowanie niniejszej dokumentacji.
Moduł Math: Kiedy zdefiniowane jest makro USE_DIRECTX, typy matematyczne są aliasami do typów z D3DX, więc nie jest juź potrzebna żadna konwersja. (VEC2 to D3DXVECTOR2, VEC3 to D3DXVECTOR3, VEC4 to D3DXVECTOR4, MATRIX to D3DXMATRIX, QUATERNION to D3DXQUATERNION, PLANE to D3DXPLANE.) W przeciwnym wypadku moduł definiuje własne struktury o takiej samej budowie bitowej i zbliżonej funkcjonalności.
Wszystkie (prawie) łańcuchy w kodzie, w tym głównie komunikaty błędów, są teraz w języku angielskim.

Inne zmiany:

Moduł Base
- Dodana stała common::EMPTY_STRING - pusty łańcuch, na wypadek gdyby był potrzebny wskaźnik lub referencja do takiego.
- Dodany szablon funkcji common::InsertionSort - sortowanie przez wstawianie. Działa jak algorytm STL.
- Poprawione konwersje między liczbą zmiennoprzecinkową i łańcuchem (funkcje common::StrToFloat, common::FloatToStr, common::StrToDouble, common::DoubleToStr). W Windows działają teraz niezależnie od ustawionego "locale". Jako separatora dziesiętnego używają zawsze kropki nawet po przestawieniu "locale" na polski.
Moduł Math
- Poprawione błędy obliczeniowe w funkcjach: common::Slerp, common::LookAtRH, common::PerspectiveFovRH, common::PerspectiveRH, common::PerspectiveOffCenterRH.
- Zmienione stałe typu POSITIVE_X, WHITE itp. Nie są już jak dawniej statycznymi polami klas (VEC3::POSITIVE_X, COLORF::WHITE), ale globalnymi stałymi (common::VEC3_POSITIVE_X, common::COLORF_WHITE).
- Zmienione typy matematyczne. Zostały upodobnione do tych z D3DX. Usunięte zostały operator[] i metoda GetArray. Dodany został konstruktor (const float Arr), operator float* i operator const float*.
- Z typów matematycznych usunięte zostały dodatkowe metody nieobecne w ich odpowiednikach z D3DX i przeniesione jako funkcje globalne. Na przykład metoda PLANE::GetNormal() stała się funkcją common::GetPlaneNormal().
- Dodana funkcja common::Rotation2D generująca macierz obrotu 2D.
Moduł Stream
- Dodane do struktury common::MD5_SUM operatory porównania: < > <= >=
Moduł ZlibUtils
- Poprawiony błąd - strumienie dekompresji niepotrzebne rzucały asercją mimo że wszystko było OK.
Inne drobne poprawki...

Wersja 7.0 (3 listopada 2007)

Biblioteka była przez ostatnie miesiące uzupełniana i poprawiana na bieżąco wraz z rozwojem silnika graficznego 3D, na potrzeby którego powstała.

Moduł Base
- Dodane nowe funkcje do obsługi surowej pamięci: common::CompareMem i common::FillMem.
- Dodana funkcja do rozwiązywania równania kwadratowego: common::QuadraticEquation.
- Dodane funkcje generujące szum: common::PerlinNoise1, common::PerlinNoise2, common::PerlinNoise3 i common::BrownianNoise1, common::BrownianNoise2, common::BrownianNoise3.
- Zmiana w common::RandomGenerator: metody common::RandomGenerator::RandUint i common::RandomGenerator::RandInt losują teraz liczby z wyłączeniem górnej granicy (max).
Moduł Error
- Dodane makra dla wygody: ERR_GUARD_BOOL, ERR_GUARD_DIRECTX, ERR_GUARD_BOOL_D, ERR_GUARD_DIRECTX_D
- Poprawiony błąd w funkcji common::MustStrToSth.
Moduł Math
- Dodana funkcja common::PerpedicularVectors - oblicza dwa dowolne wektory prostopadłe do danego.
- Dodana funkcja common::ColorDistance - zwraca "odległość" dwóch kolorów.
- Dodana funkcja common::CapsuleVolume licząca objętość kapsuły.
- Dodane funkcje common::SphereInBox i common::BoxInSphere.
- Dodane funkcje do kolizji trójkąta z prostpadłościanem: common::TriangleInBox, common::TriangleToBox.
- Dodane funkcje do kolizji z płaskim wielokątem w 3D: common::PointInPolygon, common::RayToPolygon.
- Dodane funkcje do kolizji poruszających się obiektów: common::SweptSphereToSphere, common::SweptBoxToBox.
- Dodane funkcje do losowania punktów z wnętrza brył:common:: RandomPointInUnitSphere, common::RandomPointInUnitCircle, common::RandomPointInCapsule.
- Ulepszona funkcja common::RayToTriangle - teraz można wybrać czy ma być Backface Culling.
- Poprawione błędy w funkcjach: common::LinesIntersection, common::RotationYawPitchRoll, common::RotationYawPitchRollInv, common::Normalize (do kwaterninów), common::Log (do kwaternionów), common::ClosestPointOnLineSegment, common::RayToSphere.
Moduł Stream
- Dodana nowa klasa strumienia: common::RingBuffer - bufor kołowy.
Moduł Tokenizer
- Dodane metody do klasy common::Tokenizer czyniące parsowanie jeszcze wygodniejszym: common::Tokenizer::QueryToken, common::Tokenizer::QueryEOF, common::Tokenizer::QueryEOL, common::Tokenizer::QuerySymbol, common::Tokenizer::QueryIdentifier, common::Tokenizer::QueryKeyword, common::Tokenizer::AssertToken, common::Tokenizer::AssertIdentifier.
- Poprawiony błąd tokenizacji liczb.
- Poprawione metody GetUint*, GetInt*, MustGetUint*, MustGetInt*, GetFloat, GetDouble - w przypadku błędu zamiast wykonywać assert rzucają wyjątek błędu tokenizacji.