From Human Computer Interaction Laboratory
(Zpět na VRECKO Manuál)
V současné době (prázdniny 2011) jádro Vrecka běží v jednom threadu. Ten řeší posílání zpráv, kódy abilit, vykreslování a všechny ostatní akce.
Každá abilita může tedy předpokládat, že ve chvíli, kdy se vykonává její kód (ať už v metodě update() nebo při přijetí zprávy/žádosti), tak zbytek programu stojí a je bezpečné dělat jakékoliv téměř zásahy do scény. Výjimkou je mazání sebe sama, které se nedoporučuje.
Kdokoliv si ale běžnou Windows funkcí CreateThread() může vytvořit vlastní thread. Ve vedlejších threadech je ale nutné dávat pozor na použité operace, protože zdaleka ne všechny jsou bezpečné a mohou rychle způsobit pád aplikace. Níže jsou vysvětlené základní operace a jak na ně:
Contents
Bezpečné operace
Zápis do logu
Použití logger.noticeLog()/warningLog()/errorLog()/debugLog() je bezpečné (a pravděpodobně i výpis pomocí std::cout << "text";). Text se nicméně uloží do bufferu a v souboru se skutečně objeví až po vykonání zápisu, který proběhne v nejbližším snímku v hlavním threadu. Tímto způsobem může vedlejší thread běžet velmi rychle a nečeká na zápisy do souboru.
Posílání zpráv
(Pozor, NE posílání requestů - viz níže)
Kód plně podporuje multi-threading, ale zprávy se nedoručí hned - namísto toho budou automaticky odloženy a zpracují se v hlavním threadu v nejbližším snímku. To zabraňuje tomu, aby příjemce vykonal svůj kód ve vedlejším threadu, což obvykle nečeká, a při pokusu o změnu objektu ve scéně může způsobit pád programu.
Procházení přes všechny objekty ve scéně
Pozor! Naivní přístup přes přečtení mapy objektů (world->getScenePtr()->getEOMap()) a iterování přes všechny objekty zde způsobí pád aplikace, pokud kdokoliv jiný v tuto chvíli přidá nebo odebere objekt.
Místo toho je nutné použít třidu Scene::EOIteratorHelper, která dokáže projít přes všechny objekty a poradí si s případnými změnami během procházení. Použití je jednoduché, ale je potřeba dodržovat jistá pravidla - více viz soubor Scene.h s rozsáhlými komentáři této třídy.
Pozor! Zatímco procházení objekty je tímto způsobem bezpečné, přidávat nebo odebírat objekty ve vedlejším threadu se nedoporučuje.
Polo-bezpečné operace
Posílání žádostí (Pozor!)
Requesty se zpracovávají podobně jako volání funkce, takže se provádějí okamžitě. Pokud volaný nepředpokládá, že se jeho kód provede ve vedlejším threadu, mohou z toho vznikat pády aplikace. Pokud ale s tímto počítá, nemělo by nic bránit použití requestů v jakémkoliv threadu.
Nastavení pozice objektu (Pozor!)
Běžně je tato operace nebezpečná, ale je možné vytvořit abilitu MTMatrixTransform a přiřadit ji tomuto objektu. Pokud se dále bude používat pro nastavení a čtení pozice, vše bude fungovat v jakémkoliv threadu.
Tato abilita "cachuje" nastavenou matici a na dotazy ji vrací. Se skutečnou pozicí objektu se synchronizuje jednou za frame v hlavním threadu.
Pomocné třídy
Kromě zmíněné Scene::EOIteratorHelper pro procházení objektů, je zde možnost využít zamykací mechanismy v souboru vrecko/MTLock.h, tedy:
- obecnou třídu MTLock pro zamykání
- MTAutoLock pro ještě jednodušší použítí MTLock
- MTLockSingleProcess pro zamykání v rámci jednoho procesu (rychlejší, ale s omezeními)
- MTReadWriteLock a MTReadWriteLockEx pro zamykání obsahu pro čtenáře a zapisovatele
- MTTwoPrioLimitedLock pro zamykání s dvěma urovněmi priorit.
SystemInfo ability
Dovoluje pojmenovávat thready a omezovat jejich běh na určené procesory/jádra. Má vlastní stránku zde: SystemInfo
(Zpět na VRECKO Manuál)