Menší OF update, Octadoc, Samsung a další věci

14.12.2013 16:51 | Přečteno: 814× | octaforge

Už je to zas nějakou dobu, tak to tady trochu aktualizuju.

Updaty z OF

Mám menší seznam změn, které se v posledních dnech udály. Na release to není, ale aspoň něco:

• Upravené GUI téma (míň rušivé, lehčí outlines, méně viditelné přechody)
• Texcull je teď texturecull
• Obecné přepínání mezi aktivními widgety klávesou tab (hodí se při přepínání mezi poli při úpravě entit, zatím funguje na checkboxech, radiobuttonech a polích/editorech)
• Upravitelná rychlost při skrčení
• Možnost skrýt některé vlastnosti při úpravě entit přes GUI (použito u těch, které jsou hlavně stavové a uživatel by je neměl měnit, třeba jestli hráč aktuálně běží)

Brzy nový hosting OF a systém vydání

Projekt se brzy bude přesouvat na nové VPS od vpsfree.cz. Půjde to postupně. Nové webové stránky budou postavené na vlastním Lua serverovém frameworku, který bude integrovat i rozhraní do hlavního master serveru (toto je na delší dobu).

Díky VPS budu rušit aktuální "vydávací" systém OF. Místo toho bude každý týden podobný (možná trochu detailnější) seznam změn, k tomu video (shrnující poslední změny, ukazující nové featury v akci, s možným komentářem - v angličtině, ale poskytnu české titulky). Binárky a zdrojové tarbally budu poskytovat formou nightly buildů, které se sestaví pro Linux x86/x64 a Windows x86/x64 každou noc (podpora ostatních platforem, tzn. Mac a FreeBSD půjde zvlášť, protože k nim nejsou cross-kompilátory).

Ještě proběhnou asi 2 vydání a pak nasadím tento nový systém.

Octadoc

Poslední dobou jsem pracoval na novém generátoru dokumentace, který jsem nazval Octadoc. Je psaný čistě v Lua a nemá žádné externí závislosti, pouze Lua 5.1 interpret, popř. LuaJIT (5.2 asi funguje taky, ale jistý si nejsem). Zatím pracuju na podpoře Lua API dokumentace, jako druhé bude na řadě Cčko.

Oproti klasickým generátorům jako Doxygen a Natural Docs funguje tento generátor trochu jinak. Obsahuje zabudovaný lexer/parser pro každý podporovaný jazyk, ten se parsuje do AST a zvlášť se parsují dokumentační komentáře. Ty se pak automaticky přebudují na document tree a do něj se doplní info získané z AST (díky tomu není třeba explicitně specifikovat, že komentář X dokumentuje funkci nebo strukturu, a scoping je taky automatický). Samozřejmě se toto info dá specifikovat i explicitně, pokud je to potřeba (třeba pokud dokumentuju funkci, ale nemám k dispozici tělo funkce, jen deklaraci proměnné).

Asi polovina dokumentace OF je už předělaná do nativního dokumentačního formátu Octadoc. Generátor je modulární, takže není problém dodat podporu pro více formátů jakožto pluginy, ale pracuju s nativním formátem (který je podobný zjednodušenému Markdownu s trochu jinou syntaxí např. referencí a URL, a s extra prvky jakožto třeba dokumentační sekce a makra).

Výchozí výstup bude HTML, ale opět je možné napsat moduly pro cokoliv (LaTeX, manpages...). OctaForge bude dodávat vlastní modul, který vygeneruje UI definice, takže bude možné procházet dokumentaci API zevnitř enginu pomocí zabudovaného UI.

Octadoc bohužel ještě není ve funkčním stavu - mám napsaných několik komponent, včetně lexeru a parseru pro Lua a parseru vstupního formátu, ale musím to vše ještě dát dohromady a napsat výstupní moduly.

Ukázky dokumentace jsou vidět třeba zde nebo zde. Bohužel ještě není žádná oficiální specifikace formátu.

Samsung

Během posledních pár dní se konečně vyřešily věci kolem mého zaměstnání a tudíž začátkem ledna nastupuju na pozici Senior Software Engineer v Samsung R&D ve Staines-upon-Thames, UK. Proto budou OF a Octadoc tou dobou na pár dní pozastaveny (než se trochu "zabydlím"). Až vše vyřeším, projekty budou pokračovat - očekávám tak v druhé polovině ledna (nastupuju 7. ledna, stěhuju se pár dní předtím).

Pro Samsung budu pracovat na open source knihovnách Enlightenment Foundation Libraries.

Závěr

To je zatím vše. Počítám, že do konce roku napíšu ještě jednu podobnou "aktualizaci", potom už bude další vydání enginu (doufám už s podporou dokumentace).

       

Komentáře

[dumblob]

Ten napad parsovat krome komentare i samotny jazyk je hezky.

Kazdopadne gratuluji k ziskani zamestnaneckeho pomeru - ve tvem veku to je obrovsky uspech. Ohledne Enlightenment predpokladam, ze jiz nejakou dobu prispivas. V takovem pripade by me zajimalo, zdali se nekde objevuji tendence udelat EFL thread-safe, protoze vicevlaknove aplikace jsou nepochybne blizka budoucnost a nyni s tim asi budeme bojovat napr. v bindings pro DaoVM. Nemas o tom nejake "interni" informace?

[q66]

hm, EFL thread safe není a pokud vím tak ani v blízké době nebude, ale podívej se třeba na http://docs.enlightenment.org/auto/ecore/group__Ecore__Thread__Group.html - to by mohlo pomoct.

[q66]

jen BTW, pro EFL 2.0 se chystá náhrada Edje (codename Bob) bez zvláštního jazyka pro GUI, ale místo toho s použitím Lua (s LuaJIT) a bude to celé vícevláknové - momentálně tak předem zkoumám jak vyřešit GIL v LuaJIT s více vlákny - nejspíš poběží na každém zvlášť interpret + serialized message passing... zrovna jsem se díval, jak by se toto dalo udělat s funkcema tak, aby se zachovaly upvalues (string.dump upvalues kompletně ignoruje)

[dumblob]

Njn, Lua na tohle neni out-of-box pripraveny. Kazdopadne mi uniklo, ze se pripravuje Bob, coz je velice pozitivni zprava. Osobne to vidis na prvni betu za par mesicu, za rok a nebo dele?

[q66]

netuším, ale myslím, že to bude ještě celkem trvat.

[dumblob]

Pro pozdejsi ctenare uvedu, ze korektni syntaxe pro codename je BÖB a ze se ma objevit nekdy v roce 2015/2016. Nebude thread-safe, ale bude poskytovat high-level API v integrovanem interpretu Lua s tim, ze serializace parametru fci/metod bude provadena implicitne za zady programatora.

Bude tez mozne plne pouzivat API BÖB z C pouze s pthreads, ale bude nutne explicitne volat serializacni fce (ktere jsou thread-safe) na parametry pro thread-unsafe fce. Toto se hodi zejmena tvurcum ruznych bindings. Pro kodery v C jsou pripraveny primo wrappery nad pthreads, ktere delaji serializaci apod. implicitne.

[Bedňa]

Tak veľa zdaru v novej práci.

[q66]

dík... jen doufám, že se všechno vyřeší co nejrychleji (bezprostředně po stěhování asi budu bez internetu)

[Bedňa]

Platenú prácu na EFL pokladám za prácu snov. Moc ti fandím priateľu.

GL