You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

679 lines
74KB

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <feed xmlns="http://www.w3.org/2005/Atom"><title>Opensource Game Studio</title><link href="http://opengamestudio.org/" rel="alternate"></link><link href="http://opengamestudio.org/feeds/news.atom.xml" rel="self"></link><id>http://opengamestudio.org/</id><updated>2018-01-26T00:00:00+03:00</updated><entry><title>Mahjong recreation start</title><link href="http://opengamestudio.org/mahjong-recreation-start.html" rel="alternate"></link><updated>2018-01-26T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2018-01-26:mahjong-recreation-start.html</id><summary type="html">&lt;p&gt;&lt;img alt="Screenshot" src="http://opengamestudio.org/2018-01-26-mahjong-recreation-start.png" /&gt;&lt;/p&gt;
  3. &lt;p&gt;This article describes the start of Mahjong game recreation.&lt;/p&gt;
  4. &lt;p&gt;&lt;strong&gt;Plan&lt;/strong&gt;&lt;/p&gt;
  5. &lt;p&gt;We started Mahjong recreation endeavour by composing a brief plan to get gameplay with minimal graphics:&lt;/p&gt;
  6. &lt;ul&gt;
  7. &lt;li&gt;Load single layout&lt;/li&gt;
  8. &lt;li&gt;Place tiles in layout positions&lt;/li&gt;
  9. &lt;li&gt;Distinguish tiles&lt;/li&gt;
  10. &lt;li&gt;Implement selection&lt;/li&gt;
  11. &lt;li&gt;Implement matching&lt;/li&gt;
  12. &lt;/ul&gt;
  13. &lt;p&gt;Just like any other plan, this one looked fine at first sight. However, once you get down to work, new details start to come out. This plan was no exception. Below are a few problems that came out during development.&lt;/p&gt;
  14. &lt;p&gt;&lt;strong&gt;Problem №1: provide binary resources across supported platforms&lt;/strong&gt;&lt;/p&gt;
  15. &lt;p&gt;Mahjong is going to be available on desktop, mobile, and web. Each of these platforms has its constraints on accessing external files:&lt;/p&gt;
  16. &lt;ul&gt;
  17. &lt;li&gt;Desktop can access almost any file&lt;/li&gt;
  18. &lt;li&gt;Android/iOS have limited access to file system&lt;/li&gt;
  19. &lt;li&gt;Web does not have any file system at all&lt;/li&gt;
  20. &lt;/ul&gt;
  21. &lt;p&gt;To provide a unified way for accessing resources, we decided to include them into final executable. This decision led to the birth of &lt;strong&gt;mjin-resource&lt;/strong&gt; and &lt;strong&gt;mahjong-data&lt;/strong&gt; projects.&lt;/p&gt;
  22. &lt;p&gt;&lt;a href="https://bitbucket.org/ogstudio/mjin-resource"&gt;mjin-resource&lt;/a&gt;:&lt;/p&gt;
  23. &lt;ul&gt;
  24. &lt;li&gt;converts binary files to C header files with the help of &lt;strong&gt;xxd&lt;/strong&gt; utility&lt;/li&gt;
  25. &lt;li&gt;generates MJIN project that contains generated headers to be compiled into static library&lt;/li&gt;
  26. &lt;li&gt;provides C++ interface for accessing generated resources&lt;/li&gt;
  27. &lt;/ul&gt;
  28. &lt;p&gt;&lt;a href="https://bitbucket.org/ogstudio-games/mahjong-data"&gt;mahjong-data&lt;/a&gt; is an example of such generated MJIN project that is referenced by &lt;a href="https://bitbucket.org/ogstudio-games/mahjong"&gt;mahjong&lt;/a&gt; project.&lt;/p&gt;
  29. &lt;p&gt;&lt;strong&gt;Problem №2: load PNG images across supported platforms&lt;/strong&gt;&lt;/p&gt;
  30. &lt;p&gt;To load PNG, we use corresponding OpenSceneGraph plugin. We built it for desktop with no issues. Building for web (Emscripten) turned out to be more difficult: Emscripten provides its own version of &lt;strong&gt;libpng&lt;/strong&gt;, which OpenSceneGraph build script can't detect. We had to work around several OpenSceneGraph checks to successfully build the plugin for Emscripten.
  31. Building the plugin for Android and iOS is still waiting for us. Once we get PNG plugin working across supported platforms, we are going to publish a new tutorial for &lt;a href="https://github.com/ogstudio/openscenegraph-cross-platform-guide"&gt;OpenSceneGraph cross-platform guide&lt;/a&gt; to cover PNG image loading. We already got a &lt;a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/issues/4"&gt;request to describe image loading&lt;/a&gt;.&lt;/p&gt;
  32. &lt;p&gt;&lt;strong&gt;Development&lt;/strong&gt;&lt;/p&gt;
  33. &lt;p&gt;&lt;a href="http://opengamestudio.org/lets-go.html"&gt;As you know&lt;/a&gt;, we published OpenSceneGraph cross-platform guide to make OpenSceneGraph community stronger. We value education, and we love to share our knowledge. That's why we decided to develop Mahjong in small reproducible chunks uniquely identified by internal versions. These versions are available in &lt;a href="https://bitbucket.org/ogstudio-games/mahjong"&gt;mahjong repository&lt;/a&gt;.&lt;/p&gt;
  34. &lt;p&gt;We also provide &lt;a href="http://ogstudio.github.io/game-mahjong"&gt;version history and web releases of each internal version&lt;/a&gt; for the following reasons:&lt;/p&gt;
  35. &lt;ul&gt;
  36. &lt;li&gt;education: show how development looks like internally&lt;/li&gt;
  37. &lt;li&gt;accessibility: provide older versions for comparison&lt;/li&gt;
  38. &lt;/ul&gt;
  39. &lt;p&gt;&lt;strong&gt;Current Mahjong game status&lt;/strong&gt;&lt;/p&gt;
  40. &lt;p&gt;As of the time of this writing, we have implemented tile selection. &lt;a href="https://ogstudio.github.io/game-mahjong/versions/010/mjin-player.html"&gt;Try it in your browser!&lt;/a&gt;&lt;/p&gt;
  41. &lt;p&gt;Once we finish tile matching implementation, we are going to publish the intermediate result for all supported platforms.&lt;/p&gt;
  42. &lt;p&gt;That's it for describing the start of Mahjong game recreation.&lt;/p&gt;</summary></entry><entry><title>The year of lessons</title><link href="http://opengamestudio.org/the-year-of-lessons.html" rel="alternate"></link><updated>2017-12-31T22:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2017-12-31:the-year-of-lessons.html</id><summary type="html">&lt;p&gt;&lt;img alt="Screenshot" src="http://opengamestudio.org/2017-12-31-celebration.jpg" /&gt;&lt;/p&gt;
  43. &lt;p&gt;So, the year 2017 is approaching its finale, the year's results have already
  44. been summed up. We're going to take a break from igniting the fireworks or
  45. preparation of the champagne so that we can designate our goal for the
  46. following year.&lt;/p&gt;
  47. &lt;p&gt;As it may be clear from other articles on the site, half of our plans in 2017
  48. were destined to be completed at least approximately as we assumed. The other
  49. half was changed significantly.&lt;/p&gt;
  50. &lt;p&gt;During the year, people joined the team and left it. As a result, we meet the
  51. end of the year with exactly the same team as 365 days ago. It made us think.
  52. A lot. But We'll save the story for another time.&lt;/p&gt;
  53. &lt;p&gt;There will be exactly one goal for 2018. We will take all the results, and then
  54. we will make a new mahjong game. We're already know how to make a mahjong
  55. solitaire so we will begin with it. This time, it will be cross-platform.
  56. We will definitely try to cover Windows, Linux, macOs, Web, and Android.
  57. We can't promis anything about the iOS right now (although we'll see what
  58. we can do).&lt;/p&gt;
  59. &lt;p&gt;There is no point in writing more than We want to say. We learned a lot for
  60. this year, and we will try to apply all this knowledge to achieve more in the
  61. next one. We wish everyone a Happy New Year. Stay tuned.&lt;/p&gt;
  62. &lt;p&gt;The Opensource Game Studio Team.&lt;/p&gt;</summary></entry><entry><title>2017 summary</title><link href="http://opengamestudio.org/2017-summary.html" rel="alternate"></link><updated>2017-11-22T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2017-11-22:2017-summary.html</id><summary type="html">&lt;p&gt;&lt;img alt="Screenshot" src="http://opengamestudio.org/2017-11-22-2017-summary.png" /&gt;&lt;/p&gt;
  63. &lt;p&gt;It's time to step back to see our accomplishments in 2017 and how they connect to the overall goal of Opensource Game Studio project.&lt;/p&gt;
  64. &lt;p&gt;&lt;strong&gt;Brief history&lt;/strong&gt;&lt;/p&gt;
  65. &lt;p&gt;Opensource Game Studio project is 12 years old now.&lt;/p&gt;
  66. &lt;p&gt;&lt;strong&gt;2005.&lt;/strong&gt; We started the project with a &lt;a href="https://www.linuxquestions.org/questions/general-10/the-creation-of-the-best-rpg-355858/"&gt;fanatic call&lt;/a&gt; to create the best game ever. Probably right after finishing Half-Life 2 or Morrowind. 99.99% of those who wanted to participate weathered during a couple of years leaving only the two of us: Michael (coding) and Ivan (the rest).
  67. The project was in a constant turmoil because we had no clear purpose and discipline. Thus, we only got a handful of demonstrations during that period.&lt;/p&gt;
  68. &lt;p&gt;&lt;strong&gt;2010.&lt;/strong&gt; The first year for us to admit we failed big time. After accepting the failure, we have set Mahjong game as our initial target. We also realized that if we want the game out, we must work every day. We didn't get anywhere by working on weekends because they often collided with family time.&lt;/p&gt;
  69. &lt;p&gt;&lt;strong&gt;2012, 2013.&lt;/strong&gt; We released Mahjong 1.0 and Mahjong 1.1 correspondingly. We created a complete, polished game in 3-4 years after failing to provide anything of value during previous 5 years. To this date, Mahjong is the best and only game we released so far. We're still proud of it because it still feels great.&lt;/p&gt;
  70. &lt;p&gt;&lt;strong&gt;2015.&lt;/strong&gt; We showcased the first version of our game toolset. After releasing Mahjong, we decided to spend time on building toolset that would allow us to develop games faster.&lt;/p&gt;
  71. &lt;p&gt;&lt;strong&gt;2016.&lt;/strong&gt; We recreated Mahjong gameplay with our game toolset. However, we quickly realized that desktop only game toolset is a dead end. It led us to research mobile platforms.&lt;/p&gt;
  72. &lt;p&gt;&lt;strong&gt;Last year&lt;/strong&gt;&lt;/p&gt;
  73. &lt;p&gt;&lt;strong&gt;2016, October.&lt;/strong&gt; We started mobile platforms' research by making simple straightforward OpenSceneGraph application run under Android.&lt;/p&gt;
  74. &lt;p&gt;&lt;strong&gt;2017, January.&lt;/strong&gt; We got the Android version working and started iOS and Web research.&lt;/p&gt;
  75. &lt;p&gt;&lt;strong&gt;2017, February.&lt;/strong&gt; We made the sample application work everywhere: desktop, mobile, web.&lt;/p&gt;
  76. &lt;p&gt;Researching mobile and web took us about five months. We spent that much time because there was no documentation on how to run OpenSceneGraph across platforms. We had to step in and create said documentation.&lt;/p&gt;
  77. &lt;p&gt;&lt;strong&gt;2017, July.&lt;/strong&gt; We published &lt;a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide"&gt;OpenSceneGraph cross-platform guide&lt;/a&gt;, which describes how to create a simple OpenSceneGraph application and make it run on desktop, mobile, and web. To this date, this is our most popular GitHub repository.&lt;/p&gt;
  78. &lt;p&gt;&lt;strong&gt;2017, November.&lt;/strong&gt; We published simple &lt;a href="https://ogstudio.github.io/game-memory-colors/tutorial-5.3/mjin-player.html"&gt;Memory: Colors game&lt;/a&gt; and the &lt;a href="https://bitbucket.org/ogstudio-games/memory-colors"&gt;guide&lt;/a&gt; on how to create the game from scratch. The game is powered by MJIN, our new cross-platform game toolset that we started this summer.&lt;/p&gt;
  79. &lt;p&gt;Currently MJIN toolset is in its infancy. MJIN needs a real game to flourish. That's why we are already working on cross-platform Mahjong. We'll do our best to make Mahjong faster this time.&lt;/p&gt;</summary></entry><entry><title>Back to the Static</title><link href="http://opengamestudio.org/back-to-the-static.html" rel="alternate"></link><updated>2017-10-16T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2017-10-16:back-to-the-static.html</id><summary type="html">&lt;p&gt;&lt;img alt="Back to the Static" src="http://opengamestudio.org/2017-10-16-back-to-the-static.png" /&gt;&lt;/p&gt;
  80. &lt;p&gt;We have been using Wordpress as our website engine for more than seven years. And now it's time to move forward. Or backward.
  81. For some time we've been tracking the development of the new breed of website engines - static site generators.
  82. It seems that this is the technology capable of changing past into future.&lt;/p&gt;
  83. &lt;p&gt;A static website is more straightforward, quicker and more secure. And with the help of generators, it is also as easy to manage, as the dynamic website.
  84. So, we are starting our site anew with the help of the &lt;a href="https://blog.getpelican.com/"&gt;Pelican&lt;/a&gt;.
  85. Right now it doesn't have all the content from our old site, but we'll add most of it soon.&lt;/p&gt;</summary></entry><entry><title>The birth of MJIN world</title><link href="http://opengamestudio.org/mjin-world-birth.html" rel="alternate"></link><updated>2017-09-10T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2017-09-10:mjin-world-birth.html</id><summary type="html">&lt;p&gt;&lt;img alt="The birth of MJIN world" src="http://opengamestudio.org/2017-09-mjin-world-birth.png" /&gt;&lt;/p&gt;
  86. &lt;p&gt;This article describes the birth of MJIN world in August 2017.&lt;/p&gt;
  87. &lt;p&gt;&lt;strong&gt;mjin-player&lt;/strong&gt;&lt;/p&gt;
  88. &lt;p&gt;As you know, &lt;a href="http://opengamestudio.org/scripting-research.html"&gt;we spent July to research scripting&lt;/a&gt;. We found a solution that satisfies the following criteria. Scripts should:&lt;/p&gt;
  89. &lt;ol&gt;
  90. &lt;li&gt;run unchanged on all supported platforms&lt;/li&gt;
  91. &lt;li&gt;allow extending C++ code&lt;/li&gt;
  92. &lt;/ol&gt;
  93. &lt;p&gt;We have verified the second criterion by writing a sample application. The first criterion was taken for granted because it SHOULD be true.&lt;/p&gt;
  94. &lt;p&gt;At the time, we saw two ways to verify the first criterion:&lt;/p&gt;
  95. &lt;ol&gt;
  96. &lt;li&gt;create one sample application for each platform to verify scripting only&lt;/li&gt;
  97. &lt;li&gt;create a single cross-platform application, which can run any code&lt;/li&gt;
  98. &lt;/ol&gt;
  99. &lt;p&gt;We chose the second approach because it is more beneficial in the long run. As you might have guessed, &lt;a href="https://bitbucket.org/ogstudio/mjin-player"&gt;mjin-player&lt;/a&gt; is that application.&lt;/p&gt;
  100. &lt;p&gt;mjin-player serves as a base for the rest of MJIN projects to make them run on all supported platforms. However, there's no magic trick to hide the projects from the platform, and there was no such intention. Instead, mjin-player provides a consistent set of rules how other MJIN projects should be structured to be able to run on all supported platforms.&lt;/p&gt;
  101. &lt;p&gt;&lt;strong&gt;mjin-application&lt;/strong&gt;&lt;/p&gt;
  102. &lt;p&gt;This set of rules for MJIN projects is packaged into &lt;a href="https://bitbucket.org/ogstudio/mjin-application"&gt;mjin-application&lt;/a&gt;. mjin-application is a library that provides basic functionality every MJIN project would need and nothing more. For instance, mjin-application does not and will not contain scripting or any other specific functionality.&lt;/p&gt;
  103. &lt;p&gt;&lt;strong&gt;MJIN world&lt;/strong&gt;&lt;/p&gt;
  104. &lt;p&gt;So what is &lt;a href="https://bitbucket.org/ogstudio/mjin"&gt;MJIN world&lt;/a&gt;? It's a set of projects that constitute our game development tools. mjin-player and mjin-application are the first bricks of the newly born MJIN world. A lot more to come. Stay tuned for the brighter MJIN future.&lt;/p&gt;
  105. &lt;p&gt;That's it for describing the birth of MJIN world in August 2017.&lt;/p&gt;</summary></entry><entry><title>Scripting research</title><link href="http://opengamestudio.org/scripting-research.html" rel="alternate"></link><updated>2017-08-16T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2017-08-16:scripting-research.html</id><summary type="html">&lt;p&gt;&lt;img alt="Scripting research" src="http://opengamestudio.org/2017-08-scripting-research.png" /&gt;&lt;/p&gt;
  106. &lt;p&gt;This article describes scripting research in July 2017.&lt;/p&gt;
  107. &lt;p&gt;&lt;strong&gt;Our first goal of using a scripting language was to have a platform-independent code that runs unchanged on every supported platform.&lt;/strong&gt;&lt;/p&gt;
  108. &lt;p&gt;OGS Editor 0.10 supports Python for such a code thanks to &lt;a href="http://swig.org/"&gt;SWIG&lt;/a&gt;. SWIG provides a way to wrap almost any C/C++ code and use it in dozens of languages like Python, Ruby, Lua, Java, C#, etc.. SWIG really helped us taste the beauty of platform-independent code. However, SWIG only works one way: from C/C++ to a target language. This means the main application must be in the target language, and C/C++ code can only be used as a library.&lt;/p&gt;
  109. &lt;p&gt;Having the main application in Python works fine for the desktop, but not so great for mobile and web, where C and C++ are the only natively supported cross-platform languages. There are projects like &lt;a href="https://kivy.org"&gt;Kivy&lt;/a&gt;, which allow you to develop cross-platform applications in Python, but they are not supported natively. This means it's a lot of headaches when Android and iOS APIs change.&lt;/p&gt;
  110. &lt;p&gt;Having the main application in C/C++ and the need to support scripting means that a scripting language should be interpreted by the application. This is what SWIG, Kivy, and similar projects are not meant to fulfill.&lt;/p&gt;
  111. &lt;p&gt;&lt;strong&gt;Our secondary goal for using a scripting language was to allow to extend C++ code.&lt;/strong&gt;&lt;/p&gt;
  112. &lt;p&gt;OGS Editor 0.10 has some modules written in C++, and some in Python. The modules are equal from the perspective of the main application; it doesn't care what language the module is written in.&lt;/p&gt;
  113. &lt;p&gt;To achieve such flexibility, we introduced a so-called Environment. Each module would register the keys it responds to, and Environment would deliver corresponding messages.
  114. Technically such behaviour is achieved by inheriting a base class and overriding its methods in both C++ and a scripting language.&lt;/p&gt;
  115. &lt;p&gt;&lt;strong&gt;First, we evaluated Python for the role of cross-platform scripting language.&lt;/strong&gt;&lt;/p&gt;
  116. &lt;p&gt;Since we already used Python, we started to research the possibility to run Python code on every supported platform. The result was disappointing because CPython (the default Python implementation used on the desktop) does not mention mobile and web platforms. We only found some years old forks of CPython that were claimed to work either on Android or iOS. Such a disarray was not suitable for us.
  117. We also had a look at &lt;a href="http://pypy.org"&gt;PyPy&lt;/a&gt;, another Python implementation. It also did not mention support for mobile and web platforms.&lt;/p&gt;
  118. &lt;p&gt;This was a clear indication that Python community doesn't care for mobile and web platforms. Or that nobody had time to provide the information about building Python on such platforms. Either way, it was not acceptable for us.&lt;/p&gt;
  119. &lt;p&gt;&lt;strong&gt;Second, we evaluated &lt;a href="http://wren.io"&gt;Wren&lt;/a&gt; for the role of cross-platform scripting language.&lt;/strong&gt;&lt;/p&gt;
  120. &lt;p&gt;Wren was the first scripting language we stumbled upon in the long list of non-mainstream scripting languages.&lt;/p&gt;
  121. &lt;p&gt;Wren claimed to be small and easy to learn. Wren also claimed to be intended for embedding in applications. Ironically, the author &lt;a href="http://wren.io/embedding-api.html"&gt;had no time to document how to do the embedding in the first place&lt;/a&gt;. When &lt;a href="https://github.com/munificent/wren/issues/465"&gt;we asked for the time estimates of publishing&lt;/a&gt; the critical part of the documentation, &lt;a href="https://github.com/munificent/wren/issues/402"&gt;we just got a reference to another issue&lt;/a&gt; where the other guy was asking the same question half a year ago!&lt;/p&gt;
  122. &lt;p&gt;That's when we ended our relationship with Wren.&lt;/p&gt;
  123. &lt;p&gt;&lt;strong&gt;Third, we evaluated &lt;a href="http://chaiscript.com"&gt;Chai&lt;/a&gt; for the role of cross-platform scripting language.&lt;/strong&gt;&lt;/p&gt;
  124. &lt;p&gt;Chai was in the long list of non-mainstream scripting languages, too. Chai was promising because it claimed to be specifically tailored for embedding in a C++ application.
  125. We successfully managed to call a C++ function from inside Chai but failed to call a member function. &lt;a href="http://discourse.chaiscript.com/t/cannot-call-a-function-that-accepts-a-string-and-a-vector/334"&gt;We asked for help&lt;/a&gt;, but nobody replied.&lt;/p&gt;
  126. &lt;p&gt;We had to end our relationship with Chai.&lt;/p&gt;
  127. &lt;p&gt;&lt;strong&gt;Fourth, we evaluated Lua for the role of cross-platform scripting language.&lt;/strong&gt;&lt;/p&gt;
  128. &lt;p&gt;Lua is the mainstream language for embedding. So we decided to try the obvious choice. Documentation looked promising, too. However, by the end of reading the &lt;a href="https://www.lua.org/pil/24.html"&gt;C API&lt;/a&gt; chapter we had no clue how to inherit a class inside Lua.&lt;/p&gt;
  129. &lt;p&gt;This led us to search for libraries that wrap Lua C API syntax into something more meaningful for C++. That's how we found &lt;a href="http://sol2.rtfd.io"&gt;Sol2&lt;/a&gt;. Just as before, the first attempt to call a C++ member function from Lua failed. But unlike before, we asked for help and &lt;a href="https://github.com/ThePhD/sol2/issues/465"&gt;got the help&lt;/a&gt;! This was a refreshing surprise for us.
  130. Next, we tried to inherit a class in Lua and override the class methods. We failed, but &lt;a href="https://github.com/ThePhD/sol2/issues/468"&gt;the author helped us out again&lt;/a&gt;. In the end, we succeeded in inheriting a class and overriding its behaviour.&lt;/p&gt;
  131. &lt;p&gt;That's when we understood it's a start for a long and mutual relationship with Sol2/Lua.&lt;/p&gt;
  132. &lt;p&gt;&lt;strong&gt;This search for a scripting language taught us one important lesson: people matter, not technologies.&lt;/strong&gt;&lt;/p&gt;
  133. &lt;p&gt;There are lots of scripting languages that look shiny on the outside but are dead. Why? Because some authors don't have time for users. In return, users don't have time for the authors' projects.&lt;/p&gt;
  134. &lt;p&gt;That's it for describing scripting research in July 2017.&lt;/p&gt;</summary></entry><entry><title>OpenSceneGraph cross-platform guide</title><link href="http://opengamestudio.org/openscenegraph-cross-platform-guide.html" rel="alternate"></link><updated>2017-07-17T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2017-07-17:openscenegraph-cross-platform-guide.html</id><summary type="html">&lt;p&gt;&lt;img alt="OpenSceneGraph guide" src="http://opengamestudio.org/2017-07-openscenegraph-guide.png" /&gt;&lt;/p&gt;
  135. &lt;p&gt;This article summarizes the work we did to produce OpenSceneGraph cross-platform guide.&lt;/p&gt;
  136. &lt;p&gt;June marked the finish of &lt;a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide"&gt;OpenSceneGraph cross-platform guide&lt;/a&gt; with the publishing of the last (initially planned) tutorial. The tutorial describes &lt;a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/tree/master/1.10.SampleWeb"&gt;how to build and run sample OpenSceneGraph application in Web&lt;/a&gt; using Emscripten.
  137. In case you missed it, here's a &lt;a href="https://ogstudio.github.io/openscenegraph-cross-platform-guide/"&gt;link to the final application&lt;/a&gt;. Open it in your web browser.&lt;/p&gt;
  138. &lt;p&gt;We started to compose the guide in February when we successfully managed to render a simple model on mobile and web.
  139. We spent 120 hours in five months to produce ten tutorials of the guide.&lt;/p&gt;
  140. &lt;p&gt;We have been doing OpenSceneGraph cross-platform guide for two main reasons:&lt;/p&gt;
  141. &lt;ol&gt;
  142. &lt;li&gt;Keep OpenSceneGraph cross-platform knowledge in easily accessible and reproducible form&lt;/li&gt;
  143. &lt;li&gt;Share the knowledge with OpenSceneGraph community to make it stronger&lt;/li&gt;
  144. &lt;/ol&gt;
  145. &lt;p&gt;We believe we succeeded in both. Here's why:&lt;/p&gt;
  146. &lt;ol&gt;
  147. &lt;li&gt;The guide repository has more &lt;a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/stargazers"&gt;stars&lt;/a&gt; (aka "likes") than any other repository of ours&lt;/li&gt;
  148. &lt;li&gt;OpenSceneGraph project leader Robert Osfield said &lt;a href="http://www.mail-archive.com/osg-users@lists.openscenegraph.org/msg74815.html"&gt;"Great work"&lt;/a&gt;, which means a lot&lt;/li&gt;
  149. &lt;li&gt;The guide already has &lt;a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/issues"&gt;two issues&lt;/a&gt;&lt;/li&gt;
  150. &lt;/ol&gt;
  151. &lt;p&gt;Reaching our goal of researching OpenSceneGraph cross-platform development and providing the knowledge back to the community just made us happier.&lt;/p&gt;
  152. &lt;p&gt;However, our journey does not stop here. Using the knowledge of the guide, we now continue to work on bringing our tools to support mobile and web, just as we &lt;a href="http://opengamestudio.org/lang/en/news/2456"&gt;promised in January&lt;/a&gt;.&lt;/p&gt;
  153. &lt;p&gt;That's it for summarizing the work we did to produce OpenSceneGraph cross-platform guide.&lt;/p&gt;</summary></entry><entry><title>iOS tutorial</title><link href="http://opengamestudio.org/ios-tutorial.html" rel="alternate"></link><updated>2017-06-08T10:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2017-06-08:ios-tutorial.html</id><summary type="html">&lt;p&gt;&lt;img alt="iOS tutorial" src="http://opengamestudio.org/2017-06-08-ios-refactoring.png" /&gt;&lt;/p&gt;
  154. &lt;p&gt;This article describes problems we faced during the creation of iOS tutorial in May 2017.&lt;/p&gt;
  155. &lt;p&gt;&lt;a href="https://twitter.com/OpenGameStudio/status/826816343433498627"&gt;This February&lt;/a&gt; we managed to get simple model rendered under iOS in just a few days. We expected to finish iOS tutorial in no time. However, the reality reminded us: it's easy to come up with a hackish demo that works for one person, but it's hard to create a concise example that works for everyone.&lt;/p&gt;
  156. &lt;h3&gt;Native library&lt;/h3&gt;
  157. &lt;p&gt;The first question we had to answer was: should the sample application be part of Xcode project or be a separately built library?&lt;/p&gt;
  158. &lt;p&gt;We had to consider the following facts:&lt;/p&gt;
  159. &lt;ol&gt;
  160. &lt;li&gt;Xcode project can use C++ directly (thanks to Objective-C++) without stuff like JNI&lt;ul&gt;
  161. &lt;li&gt;There's no need for a separate library (+ application)&lt;/li&gt;
  162. &lt;li&gt;Creating a separate library is an additional work (- library)&lt;/li&gt;
  163. &lt;/ul&gt;
  164. &lt;/li&gt;
  165. &lt;li&gt;OpenSceneGraph builds libraries&lt;ul&gt;
  166. &lt;li&gt;It's easier to use standard build process (+ library)&lt;/li&gt;
  167. &lt;li&gt;It's harder to create custom build process just for a single platform (- application)&lt;/li&gt;
  168. &lt;/ul&gt;
  169. &lt;/li&gt;
  170. &lt;li&gt;OpenSceneGraph uses CMake build system, which is not supported by Xcode&lt;ul&gt;
  171. &lt;li&gt;Xcode project can't include CMake files (- application)&lt;/li&gt;
  172. &lt;li&gt;It's easy to create custom CMake file that includes OpenSceneGraph CMake file to build a single library (+ library)&lt;/li&gt;
  173. &lt;/ul&gt;
  174. &lt;/li&gt;
  175. &lt;li&gt;CMake can generate Xcode project&lt;ul&gt;
  176. &lt;li&gt;It's possible to create a CMake file that builds both OpenSceneGraph and the sample application (+ application)&lt;/li&gt;
  177. &lt;li&gt;Xcode is the de-facto tool to create Xcode projects; it's easier to use standard build process (+ library)&lt;/li&gt;
  178. &lt;/ul&gt;
  179. &lt;/li&gt;
  180. &lt;/ol&gt;
  181. &lt;p&gt;After evaluating the pros and cons of each approach, we decided to turn the sample application into a library and include it in Xcode project. The downside of this approach is that simulator and real device builds need separate library builds.&lt;/p&gt;
  182. &lt;h3&gt;Refactoring&lt;/h3&gt;
  183. &lt;p&gt;The second question we had to answer was: should there be a single source code base for all platforms or several ones, one for each platform?&lt;/p&gt;
  184. &lt;p&gt;While doing Android tutorial we used single source code base because it worked fine for desktop and Android. As we started to work through iOS tutorial, it became apparent that particular features may or may not work on some platforms. For example, one feature may work on desktop and iOS, but not Android. Another feature may work on iOS and Android, but not desktop. Since we didn't want to pollute the code with #ifdefs, we started to put each platform combination into a separate file. The number of files grew rapidly. The files were reusable, but it became extremely hard to see the whole picture.&lt;/p&gt;
  185. &lt;p&gt;At this point, we realized there's the second question. We reminded ourselves that the main purpose of the sample source code is to teach how to do basic OpenSceneGraph things, not create a reusable library with API that is stable across several years.&lt;/p&gt;
  186. &lt;p&gt;That's when our home grown feature tool came into play. With its help, we separated the code into several parts, which in the end produce just two files for each platform:&lt;/p&gt;
  187. &lt;ol&gt;
  188. &lt;li&gt;functions.h - contains reusable classless functions&lt;/li&gt;
  189. &lt;li&gt;main.h - contains the rest of the sample application code&lt;/li&gt;
  190. &lt;/ol&gt;
  191. &lt;p&gt;Their contents differ slightly for each platform, but it's easy to see the whole picture now.&lt;/p&gt;
  192. &lt;p&gt;That's it for describing problems we faced during the creation of iOS tutorial in May 2017.&lt;/p&gt;</summary></entry><entry><title>OpenSceneGraph sample</title><link href="http://opengamestudio.org/osg-sample.html" rel="alternate"></link><updated>2017-05-12T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2017-05-12:osg-sample.html</id><summary type="html">&lt;p&gt;&lt;img alt="OSG sample" src="http://opengamestudio.org/2017-05_osg-sample.png" /&gt;&lt;/p&gt;
  193. &lt;p&gt;This article describes creation of the tutorials for building sample OpenSceneGraph application under Linux, macOS, Windows, and Android in April 2017.&lt;/p&gt;
  194. &lt;p&gt;Previous tutorials described how to install OpenSceneGraph under Linux, macOS, Windows and render a model using the standard &lt;strong&gt;osgviewer&lt;/strong&gt; tool. This time we worked on a &lt;a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide-application"&gt;sample OpenSceneGraph application&lt;/a&gt; that would run under Linux, macOS, Windows, and Android.&lt;/p&gt;
  195. &lt;p&gt;The application is very basic and has the following features:&lt;/p&gt;
  196. &lt;ol&gt;
  197. &lt;li&gt;Render window creation&lt;/li&gt;
  198. &lt;li&gt;Model loading&lt;/li&gt;
  199. &lt;li&gt;Model rendering with simple GLSL shaders&lt;/li&gt;
  200. &lt;li&gt;Model motion with a mouse under Linux, macOS, Windows and a finger under Android&lt;/li&gt;
  201. &lt;/ol&gt;
  202. &lt;p&gt;Creating the tutorials for Linux, macOS, Windows was so easy and straightforward, that it only took us half a month. We spent the second half of the month creating Android tutorial.&lt;/p&gt;
  203. &lt;p&gt;Our &lt;a href="http://opengamestudio.org/2016-october-recap.html"&gt;first successful Android build&lt;/a&gt; last year included hacks and non-obvious steps to make OpenSceneGraph run under Android. This time we wanted a cleaner, faster, and cheaper approach.&lt;/p&gt;
  204. &lt;p&gt;The approach we ended up with requires just a few files and a few changes to the original Android Studio project (with C++ support) to make sample OpenSceneGraph application run under Android.&lt;/p&gt;
  205. &lt;p&gt;Here's a quick rundown of the files:&lt;/p&gt;
  206. &lt;ol&gt;
  207. &lt;li&gt;GLES2 surface&lt;/li&gt;
  208. &lt;li&gt;Render activity to render to the surface&lt;/li&gt;
  209. &lt;li&gt;Native library Java interface&lt;/li&gt;
  210. &lt;li&gt;Native library C++ implementation&lt;/li&gt;
  211. &lt;li&gt;CMake file to build native library&lt;/li&gt;
  212. &lt;li&gt;Render activity layout&lt;/li&gt;
  213. &lt;li&gt;Model to display&lt;/li&gt;
  214. &lt;/ol&gt;
  215. &lt;p&gt;Here's a quick rundown of the project changes:&lt;/p&gt;
  216. &lt;ol&gt;
  217. &lt;li&gt;Update Android manifest to use GLES2 and render activity&lt;/li&gt;
  218. &lt;li&gt;Reference native library's CMake file in the project's CMake file&lt;/li&gt;
  219. &lt;/ol&gt;
  220. &lt;p&gt;OpenSceneGraph documentation suggests building OpenSceneGraph outside Android Studio with CMake. However, this approach has the following limitations:&lt;/p&gt;
  221. &lt;ol&gt;
  222. &lt;li&gt;You have to build OpenSceneGraph for each target architecture&lt;/li&gt;
  223. &lt;li&gt;You have to manually copy/reference built OpenSceneGraph libraries into Android Studio project&lt;/li&gt;
  224. &lt;/ol&gt;
  225. &lt;p&gt;Our approach includes building OpenSceneGraph for those target architectures that Android Studio project is built for. Also, OpenSceneGraph is already referenced, so no extra work is required: you just need to rebuild the project, and you're done.&lt;/p&gt;
  226. &lt;p&gt;That's it for describing the creation of the tutorials for building sample OpenSceneGraph application under Linux, macOS, Windows, and Android in April 2017.&lt;/p&gt;</summary></entry><entry><title>It's all fine</title><link href="http://opengamestudio.org/its-all-fine.html" rel="alternate"></link><updated>2017-04-07T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2017-04-07:its-all-fine.html</id><summary type="html">&lt;p&gt;&lt;img alt="ItsAllFine" src="http://opengamestudio.org/2017-04_its-all-fine.png" /&gt;&lt;/p&gt;
  227. &lt;p&gt;This article describes creation of the first four OpenSceneGraph tutorials in March 2017.&lt;/p&gt;
  228. &lt;p&gt;The &lt;a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/"&gt;first four OpenSceneGraph tutorials&lt;/a&gt; explain how to create a cube model with Blender and display the model under Linux, macOS, or Windows using OpenSceneGraph tool called osgviewer.&lt;/p&gt;
  229. &lt;p&gt;The whole process of creating a single tutorial turned out to be pretty daunting because it includes several tasks:&lt;/p&gt;
  230. &lt;ol&gt;
  231. &lt;li&gt;Record original video depicting one or more steps&lt;/li&gt;
  232. &lt;li&gt;Name the steps as clear as possible&lt;/li&gt;
  233. &lt;li&gt;Select the parts of the video that display the step&lt;/li&gt;
  234. &lt;li&gt;Remove the parts of the video that bare no value, e.g., waiting in the middle of compilation&lt;/li&gt;
  235. &lt;li&gt;Select a single frame to best represent current step, e.g., typing a specific command&lt;/li&gt;
  236. &lt;li&gt;Add a detailed description to article, why current step should have been taken&lt;/li&gt;
  237. &lt;li&gt;Proof-read the article&lt;/li&gt;
  238. &lt;li&gt;Correct typos and video timing&lt;/li&gt;
  239. &lt;li&gt;Review the whole video&lt;/li&gt;
  240. &lt;li&gt;Upload the video to YouTube with timestamps of steps for easier navigation&lt;/li&gt;
  241. &lt;/ol&gt;
  242. &lt;p&gt;Some of those tasks had to be repeated multiple times until the combination of video, text, and article was clear and logical.&lt;/p&gt;
  243. &lt;p&gt;Overall, it took us 30 hours to create the tutorials. The whole process gave us a lot of experience, which will help us in shaping learning materials for our technologies in the future. We don't know how they will look like exactly, but they will definitely be better.&lt;/p&gt;
  244. &lt;p&gt;That's it for describing creation of the first four OpenSceneGraph tutorials in March 2017.&lt;/p&gt;</summary></entry><entry><title>Let's go</title><link href="http://opengamestudio.org/lets-go.html" rel="alternate"></link><updated>2017-03-16T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2017-03-16:lets-go.html</id><summary type="html">&lt;p&gt;&lt;img alt="Let's go" src="http://opengamestudio.org/2017-03_lets-go.png" /&gt;&lt;/p&gt;
  245. &lt;p&gt;In this article we describe our progress in January and February of 2017: rendering under iOS/Web and a new tutorial tool.&lt;/p&gt;
  246. &lt;p&gt;&lt;strong&gt;Rendering under iOS/Web&lt;/strong&gt;&lt;/p&gt;
  247. &lt;p&gt;To our surprise, we got a simple red cube rendered under &lt;a href="https://twitter.com/OpenGameStudio/status/826816343433498627"&gt;iOS&lt;/a&gt; and &lt;a href="https://twitter.com/OpenGameStudio/status/829731986264698881"&gt;Web&lt;/a&gt; pretty fast: in early February. However, this is only the beginning of this year's challenge to support Android, iOS, and Web platforms. There's a long and bumpy road ahead of us as we need a lot more on each platform before we can claim a success: visual effects, Python scripting, data archives.&lt;/p&gt;
  248. &lt;p&gt;Since it took us about four months to get to mobile and web platforms, we decided to share our knowledge and help OpenSceneGraph community with a guide that shows how to use OpenSceneGraph on desktop, mobile, and web. We believe the more widespread OpenSceneGraph is, the stronger our technology becomes. As Isaac Newton said, "If I have seen further, it is by standing on the shoulders of giants." OpenSceneGraph is our giant.&lt;/p&gt;
  249. &lt;p&gt;&lt;strong&gt;Tutorial tool&lt;/strong&gt;&lt;/p&gt;
  250. &lt;p&gt;Having conducted four live sessions before, it was clear the guide needs videos depicting every nuance. However, bare video alone is only good for showing what to do and not for explaining why do it in a certain way. That's why we decided to combine video with text in the forms of video subtitles and separate articles.&lt;/p&gt;
  251. &lt;p&gt;To combine text and video, we first tried &lt;a href="http://openshotvideo.com"&gt;OpenShot&lt;/a&gt;. It worked well, but we quickly saw its limitations:&lt;/p&gt;
  252. &lt;ul&gt;
  253. &lt;li&gt;Too much time is spent on adjusting time frames and animations&lt;/li&gt;
  254. &lt;li&gt;Project file and original resources are hard to track with VCS&lt;/li&gt;
  255. &lt;/ul&gt;
  256. &lt;p&gt;Since OpenSceneGraph cross-platform guide would consist of several tutorials, we decided to automate the process. Brief research revealed a great multimedia framework called &lt;a href="http://mltframework.org"&gt;MLT&lt;/a&gt;, which powers OpenShot itself. With MLT we got our tutorial tool in no time.&lt;/p&gt;
  257. &lt;p&gt;Currently, the tutorial tool allows anyone to combine text and video using a simple text file like this:&lt;/p&gt;
  258. &lt;div class="highlight"&gt;&lt;pre&gt;background bg.png
  259. text 5 Let&amp;#39;s install Blender
  260. video 0:6 install_blender.mp4
  261. text 5 Installing it with apt
  262. video 6:26 install_blender.mp4
  263. text 5 We&amp;#39;re still installing it
  264. video 26:56 install_blender.mp4
  265. text 5 Congratulations! We just finished installing Blender
  266. &lt;/pre&gt;&lt;/div&gt;
  267. &lt;p&gt;This is the actual script. See the final result &lt;a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/tree/master/tutorial-tool"&gt;here&lt;/a&gt;.&lt;/p&gt;
  268. &lt;p&gt;That's it for describing our progress in January and February of 2017: rendering under iOS/Web and the new tutorial tool.&lt;/p&gt;</summary></entry><entry><title>The year of challenges</title><link href="http://opengamestudio.org/the-year-of-challenges.html" rel="alternate"></link><updated>2017-01-25T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2017-01-25:the-year-of-challenges.html</id><summary type="html">&lt;p&gt;&lt;img alt="The year of challenges" src="http://opengamestudio.org/2017-01_the-year-of-challenges.png" /&gt;&lt;/p&gt;
  269. &lt;p&gt;This article describes our plans for 2017.&lt;/p&gt;
  270. &lt;p&gt;Our past plans suggested we would have Android platform support by this time. However, we have a long way to go, before we can declare Android support. See for yourself:&lt;/p&gt;
  271. &lt;p&gt;&lt;img alt="Android rendering" src="http://opengamestudio.org/2017-01_mjin-android-gles.png" /&gt;&lt;/p&gt;
  272. &lt;p&gt;Some people would consider this a failure. We don't. We see a chance to start low and jump high!&lt;/p&gt;
  273. &lt;p&gt;Having only worked with liberal and forgiving desktop environments, Android was a complete surprise for us. Android punished us for everything: memory, resources, graphics. The usual Android response was either a crash, or an empty screen.
  274. At the same time, such a harsh environment highlighted weak spots in our technologies and helped us see where to go next.&lt;/p&gt;
  275. &lt;p&gt;This month we start working on iOS platform support, even though we have only scratched Android. Why? Because it's a lot easier to get those red cubes rendered on iOS without polishing Android first. We don't want to spend months polishing Android only to find out later we had to implement certain feature differently so that it works on all supported platforms.&lt;/p&gt;
  276. &lt;p&gt;And right after we get those cubes rendered on iOS, we start to work on bringing them to Web.&lt;/p&gt;
  277. &lt;p&gt;&lt;strong&gt;You got it right: we challenge ourselves with support for Android, iOS, and Web this year.&lt;/strong&gt;&lt;/p&gt;
  278. &lt;p&gt;That's it for describing our plans for 2017.&lt;/p&gt;</summary></entry><entry><title>Happy 2017</title><link href="http://opengamestudio.org/2017-happy-new-year.html" rel="alternate"></link><updated>2016-12-31T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-12-31:2017-happy-new-year.html</id><summary type="html">&lt;p&gt;&lt;img alt="Happy new year" src="http://opengamestudio.org/2016-12-31_happy-new-year.png" /&gt;&lt;/p&gt;
  279. &lt;p&gt;Okay. It's been a hard year for everyone in the team. And it's almost over. Praise it ends! Praise the new one!&lt;/p&gt;
  280. &lt;p&gt;It may seem, that our progress stalled. Three years ago we announced the beginning of a new project (two to be precise), and now we still working on the engine and editor, haven't even started creating the actual game.&lt;/p&gt;
  281. &lt;p&gt;If you were monitoring our news during the year, you know that we held several live sessions, showing in the real time how to use our tools to create some simple games. Each session was a step in a long road to our goal. While preparing for these live sessions, we added necessary building blocks, that will be needed to create almost any game.&lt;/p&gt;
  282. &lt;p&gt;Future live sessions and technical previews will add even more, so at some point in future (i hope not very distant), we will have everything we need to sit down and build our planned game from these blocks.&lt;/p&gt;
  283. &lt;p&gt;So, the project isn't dead; the idea was not thrown away. But there is a lot of work to be done before we can start making the game, and there are only two of us, using our spare time.
  284. So. You want our game to become a reality? Join us. Together we will rule the galaxy. Or just wait and see. We didn't stop several years ago. We won't stop now.
  285. After all, there is only one way to create a fine tool (and it's our initial goal if you remember) - we need to use it ourselves.
  286. We will. Stay tuned.&lt;/p&gt;
  287. &lt;p&gt;Happy 2017. Let it be simple.&lt;/p&gt;</summary></entry><entry><title>November 2016 recap</title><link href="http://opengamestudio.org/2016-november-recap.html" rel="alternate"></link><updated>2016-12-15T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-12-15:2016-november-recap.html</id><summary type="html">&lt;p&gt;&lt;img alt="November recap" src="http://opengamestudio.org/2016-12-15_2016-november-recap.png" /&gt;&lt;/p&gt;
  288. &lt;p&gt;This article describes the start of MJIN library separation into modules.&lt;/p&gt;
  289. &lt;p&gt;Once we built OpenSceneGraph for Android, it became obvious that some MJIN functionality is not suitable for Android. For example, UIQt provides a basis for OGS Editor UI. Since OGS Editor is a desktop application, we don't need UIQt for Android.&lt;/p&gt;
  290. &lt;p&gt;We decided to have a look at two approaches to separate MJIN into modules: build-time separation and run-time one.
  291. &lt;strong&gt;Build-time&lt;/strong&gt; separation means MJIN becomes highly configurable and each platform gets specifically tailored MJIN build.
  292. &lt;strong&gt;Run-time&lt;/strong&gt; separation means MJIN is divided into smaller libraries that are connected at run-time, which makes it easy to change functionality without rebuilding.&lt;/p&gt;
  293. &lt;p&gt;&lt;strong&gt;Run-time separation research.&lt;/strong&gt;&lt;/p&gt;
  294. &lt;p&gt;Since run-time separation has more benefits, we started researching it first.
  295. The easiest way to achieve it was to use C API, because C ABI rules are much simpler than C++ one's.&lt;/p&gt;
  296. &lt;p&gt;We created a sample project consisting of the application, library, and plugin.
  297. &lt;strong&gt;The application&lt;/strong&gt; has been linked to the library and used it to load the plugin.
  298. &lt;strong&gt;The library&lt;/strong&gt; provided functions to register plugins and call their functions.
  299. &lt;strong&gt;The plugin&lt;/strong&gt; provided functions for the library and called library functions.&lt;/p&gt;
  300. &lt;p&gt;The research was successful: the sample project worked correctly under Linux and Windows. However, since MJIN is currently a single large entity, we postponed C API application until we finish build-time separation.&lt;/p&gt;
  301. &lt;p&gt;&lt;strong&gt;Build-time separation start.&lt;/strong&gt;&lt;/p&gt;
  302. &lt;p&gt;We extracted the following modules from MJIN:&lt;/p&gt;
  303. &lt;ul&gt;
  304. &lt;li&gt;
  305. &lt;p&gt;Android: provides Java Native Interface (JNI) to MJIN&lt;/p&gt;
  306. &lt;/li&gt;
  307. &lt;li&gt;
  308. &lt;p&gt;Sound: provides access to OpenAL&lt;/p&gt;
  309. &lt;/li&gt;
  310. &lt;li&gt;
  311. &lt;p&gt;UIQt: provides access to Qt UI&lt;/p&gt;
  312. &lt;/li&gt;
  313. &lt;/ul&gt;
  314. &lt;p&gt;Sound and UIQt modules are currently statically linked into MJIN library, while Android module is already a separate library due to JNI requirements.&lt;/p&gt;
  315. &lt;p&gt;In the coming year, we're going to significantly restructure MJIN so that it suits as many platforms as possible.&lt;/p&gt;
  316. &lt;p&gt;That's it for describing the start of MJIN library separation into modules.&lt;/p&gt;</summary></entry><entry><title>October 2016 recap</title><link href="http://opengamestudio.org/2016-october-recap.html" rel="alternate"></link><updated>2016-11-19T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-11-19:2016-october-recap.html</id><summary type="html">&lt;p&gt;&lt;img alt="October recap" src="http://opengamestudio.org/2016-11-19_2016-october-recap.png" /&gt;&lt;/p&gt;
  317. &lt;p&gt;This article describes how we spent a month building OpenSceneGraph (OSG) for Android: the first attempt to build OSG, the search for OSG alternatives, and the success in building OSG.&lt;/p&gt;
  318. &lt;p&gt;&lt;strong&gt;First attempt to build OSG.&lt;/strong&gt;&lt;/p&gt;
  319. &lt;p&gt;Having no prior knowledge of Android development, we grabbed the latest Android Studio and started doing beginner tutorials.
  320. We passed Java part pretty fast. Everything worked out of the box. Then came C++ part and related problems.&lt;/p&gt;
  321. &lt;p&gt;&lt;strong&gt;CMake. &lt;/strong&gt;To work with C++, Android Studio uses custom CMake, which conflicts with the system one. This was a clear indication that we had to set up a separate development environment specifically for Android.&lt;/p&gt;
  322. &lt;p&gt;&lt;strong&gt;KVM. &lt;/strong&gt;We got Ubuntu under VirtualBox installed. All went fine until we tried to use Android Emulator. Turned out, VirtualBox could not run Android Emulator, because a virtual machine cannot provide kernel virtualization inside already virtualized environment.&lt;/p&gt;
  323. &lt;p&gt;&lt;strong&gt;Chroot for Android. &lt;/strong&gt;Since we had a successful experience with chroot to build OGS Editor before, we decided to place Android development environment into chroot. With minor tweaking, we could finally run Android Emulator and build C++ project.&lt;/p&gt;
  324. &lt;p&gt;&lt;strong&gt;OSG. &lt;/strong&gt;Building OSG seemed like a piece of cake at the time. However, all we got was a crash. Thinking that we got it wrong the first time, we tried to rebuild OSG once again. And the same crash again.
  325. Searching for the problem did not reveal any hint.
  326. Nobody helped us at the OSG mailing list.&lt;/p&gt;
  327. &lt;p&gt;We were in despair.&lt;/p&gt;
  328. &lt;p&gt;&lt;strong&gt;The search for OSG alternatives.&lt;/strong&gt;&lt;/p&gt;
  329. &lt;p&gt;Since OSG community did not help us, we decided to search for an alternative open source project to fit our Android needs (and may be more).&lt;/p&gt;
  330. &lt;p&gt;And we found it: &lt;a href="http://babylonhx.gamestudiohx.com/"&gt;BabylonHX&lt;/a&gt;. The home page looked awesome: it rendered WebGL in the background!
  331. We thought we finally found the gem we were looking for. However, the example on the home page simply did not work.&lt;/p&gt;
  332. &lt;p&gt;You can probably understand our feelings at the time.&lt;/p&gt;
  333. &lt;p&gt;&lt;strong&gt;The success in building OSG.&lt;/strong&gt;&lt;/p&gt;
  334. &lt;p&gt;We realized nobody would make OSG work under Android for us. We had to do it ourselves.&lt;/p&gt;
  335. &lt;p&gt;Since &lt;a href="http://www.openscenegraph.org/index.php/documentation/platform-specifics/android/178-building-openscenegraph-for-android-3-4"&gt;OSG 3.4 document&lt;/a&gt; on building for Android was very short, we no longer trusted it and headed to &lt;a href="http://www.openscenegraph.org/index.php/documentation/platform-specifics/android/44-building-openscenegraph-for-android-3-0-3-0-1"&gt;original OSG 3.0 document&lt;/a&gt;.
  336. While following it, we faced a dead link to third party dependencies.
  337. The search for an alternative download link lead us to a &lt;a href="https://xinyustudio.wordpress.com/2013/09/24/install-osg-for-android-on-ubuntu-13-04-step-by-step-tutorials/"&gt;2013 tutorial&lt;/a&gt; on building OSG 3.0 for Android.&lt;/p&gt;
  338. &lt;p&gt;After following the tutorial, we finally got OSG to run under Android!
  339. But there was a nuance: both OSG and Android tools used in the tutorial were ancient.
  340. In a few days, we gradually updated both OSG and Android tools to their latest versions.&lt;/p&gt;
  341. &lt;p&gt;During the update process, we learned two things that prevented us from having OSG to work in the first place:&lt;/p&gt;
  342. &lt;ul&gt;
  343. &lt;li&gt;Android API headers changed in NDK r12&lt;/li&gt;
  344. &lt;li&gt;OSG only works as a static library under Android&lt;/li&gt;
  345. &lt;/ul&gt;
  346. &lt;p&gt;That's it for describing how we spent the month building OSG for Android: the first attempt to build OSG, the search for OSG alternatives, and the success in building OSG.&lt;/p&gt;</summary></entry><entry><title>Technology showcases</title><link href="http://opengamestudio.org/2016-tech-showcases.html" rel="alternate"></link><updated>2016-10-31T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-10-31:2016-tech-showcases.html</id><summary type="html">&lt;p&gt;&lt;img alt="TechShowcases" src="http://opengamestudio.org/2016-10-31_tech-showcases.png" /&gt;&lt;/p&gt;
  347. &lt;p&gt;In this article, we take another look at 2015-2016 live sessions' format and introduce a new showcase format for 2017.&lt;/p&gt;
  348. &lt;p&gt;&lt;strong&gt;2015 and 2016: live sessions.&lt;/strong&gt;&lt;/p&gt;
  349. &lt;p&gt;As you know, we use live sessions to show the state of our technology and create a small functional game from scratch.
  350. We have conducted four live sessions in the past year, which gave birth to the following small games:
  351. &lt;table&gt;
  352. &lt;tr&gt;
  353. &lt;th&gt;&lt;strong&gt;№&lt;/strong&gt;&lt;/th&gt;
  354. &lt;th&gt;&lt;strong&gt;Created game&lt;/strong&gt;&lt;/th&gt;
  355. &lt;th&gt;&lt;strong&gt;Live session date&lt;/strong&gt;&lt;/th&gt;
  356. &lt;/tr&gt;
  357. &lt;tr&gt;
  358. &lt;td&gt;1&lt;/td&gt;
  359. &lt;td&gt;Whac-a-mole&lt;/td&gt;
  360. &lt;td&gt;November 2015&lt;/td&gt;
  361. &lt;/tr&gt;
  362. &lt;tr&gt;
  363. &lt;td&gt;2&lt;/td&gt;
  364. &lt;td&gt;Rolling ball&lt;/td&gt;
  365. &lt;td&gt;February 2016&lt;/td&gt;
  366. &lt;/tr&gt;
  367. &lt;tr&gt;
  368. &lt;td&gt;3&lt;/td&gt;
  369. &lt;td&gt;Domino&lt;/td&gt;
  370. &lt;td&gt;May 2016&lt;/td&gt;
  371. &lt;/tr&gt;
  372. &lt;tr&gt;
  373. &lt;td&gt;4&lt;/td&gt;
  374. &lt;td&gt;Mahjong Solitaire&lt;/td&gt;
  375. &lt;td&gt;September 2016&lt;/td&gt;
  376. &lt;/tr&gt;
  377. &lt;/table&gt;&lt;/p&gt;
  378. &lt;p&gt;We spent four months to prepare for these live sessions.
  379. It has been an extremely useful experience for us. However, 2017 will have only 2 live sessions.
  380. Why? We want to spend more time on actual development!&lt;/p&gt;
  381. &lt;p&gt;&lt;strong&gt;2017: live sessions + technical previews.&lt;/strong&gt;&lt;/p&gt;
  382. &lt;p&gt;Starting next year, we will be doing technical previews twice a year. A technical preview is another way to show the state of our technology, but without creating new games and conducting live sessions.&lt;/p&gt;
  383. &lt;p&gt;Here's an approximate schedule of technical previews and live sessions for 2017:
  384. &lt;table&gt;
  385. &lt;tr&gt;
  386. &lt;th&gt;&lt;strong&gt;№&lt;/strong&gt;&lt;/th&gt;
  387. &lt;th&gt;&lt;strong&gt;Month&lt;/strong&gt;&lt;/th&gt;
  388. &lt;th&gt;&lt;strong&gt;Showcase type&lt;/strong&gt;&lt;/th&gt;
  389. &lt;th&gt;&lt;strong&gt;Topic&lt;/strong&gt;&lt;/th&gt;
  390. &lt;/tr&gt;
  391. &lt;tr&gt;
  392. &lt;td&gt;1&lt;/td&gt;
  393. &lt;td&gt;January&lt;/td&gt;
  394. &lt;td&gt;Technical preview&lt;/td&gt;
  395. &lt;td&gt;Android platform support&lt;/td&gt;
  396. &lt;/tr&gt;
  397. &lt;tr&gt;
  398. &lt;td&gt;2&lt;/td&gt;
  399. &lt;td&gt;April&lt;/td&gt;
  400. &lt;td&gt;Live session&lt;/td&gt;
  401. &lt;td&gt;Android game creation&lt;/td&gt;
  402. &lt;/tr&gt;
  403. &lt;tr&gt;
  404. &lt;td&gt;3&lt;/td&gt;
  405. &lt;td&gt;July&lt;/td&gt;
  406. &lt;td&gt;Technical preview&lt;/td&gt;
  407. &lt;td&gt;To be announced&lt;/td&gt;
  408. &lt;/tr&gt;
  409. &lt;tr&gt;
  410. &lt;td&gt;4&lt;/td&gt;
  411. &lt;td&gt;October&lt;/td&gt;
  412. &lt;td&gt;Live session&lt;/td&gt;
  413. &lt;td&gt;To be announced&lt;/td&gt;
  414. &lt;/tr&gt;
  415. &lt;/table&gt;&lt;/p&gt;
  416. &lt;p&gt;That's it for taking another look at 2015-2016 live sessions' format and introducing the new showcase format for 2017.&lt;/p&gt;</summary></entry><entry><title>September 2016 recap</title><link href="http://opengamestudio.org/2016-september-recap.html" rel="alternate"></link><updated>2016-10-11T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-10-11:2016-september-recap.html</id><summary type="html">&lt;p&gt;&lt;img alt="September recap" src="http://opengamestudio.org/2016-10-11_september-recap.png" /&gt;&lt;/p&gt;
  417. &lt;p&gt;This article explains September 2016 live session stages: draft, rehearsal, live session itself, and publishing.&lt;/p&gt;
  418. &lt;p&gt;Even though live session takes only a few hours, we devote a whole month to prepare for it. Let's have a look at live session stages in detail.&lt;/p&gt;
  419. &lt;ol&gt;
  420. &lt;li&gt;
  421. &lt;p&gt;&lt;strong&gt;Draft.&lt;/strong&gt; Game creation for the first time.&lt;/p&gt;
  422. &lt;p&gt;Purposes:&lt;/p&gt;
  423. &lt;ul&gt;
  424. &lt;li&gt;test our technologies and fix major bugs;&lt;/li&gt;
  425. &lt;li&gt;discover usability issues to fix in the next development iteration;&lt;/li&gt;
  426. &lt;li&gt;list exact steps to reproduce the game later;&lt;/li&gt;
  427. &lt;li&gt;create draft version of the game assets (models, textures, sounds, scripts).&lt;/li&gt;
  428. &lt;/ul&gt;
  429. &lt;p&gt;Upon stage completion, we announce live session date and show you the game preview.&lt;/p&gt;
  430. &lt;/li&gt;
  431. &lt;li&gt;
  432. &lt;p&gt;&lt;strong&gt;Rehearsal.&lt;/strong&gt; Game recreation.&lt;/p&gt;
  433. &lt;p&gt;Purposes:&lt;/p&gt;
  434. &lt;ul&gt;
  435. &lt;li&gt;make sure we have no major bugs left;&lt;/li&gt;
  436. &lt;li&gt;record the whole process of the game creation;&lt;/li&gt;
  437. &lt;li&gt;create final game assets.&lt;/li&gt;
  438. &lt;/ul&gt;
  439. &lt;p&gt;This is 99% the game we publish later.&lt;/p&gt;
  440. &lt;/li&gt;
  441. &lt;li&gt;
  442. &lt;p&gt;&lt;strong&gt;Live session.&lt;/strong&gt; Reassembling the game live in front of you.&lt;/p&gt;
  443. &lt;p&gt;Purposes:&lt;/p&gt;
  444. &lt;ul&gt;
  445. &lt;li&gt;show how easy it is to create a game;&lt;/li&gt;
  446. &lt;li&gt;walk you through nuances of game creation;&lt;/li&gt;
  447. &lt;li&gt;get feedback from you;&lt;/li&gt;
  448. &lt;li&gt;answer your questions.&lt;/li&gt;
  449. &lt;/ul&gt;
  450. &lt;p&gt;We take game assets from the rehearsal and use them to quickly reassemble the game in just a few hours.&lt;/p&gt;
  451. &lt;/li&gt;
  452. &lt;li&gt;
  453. &lt;p&gt;&lt;strong&gt;Publishing.&lt;/strong&gt; The release of our technologies' last version, live session materials, and stand alone game.&lt;/p&gt;
  454. &lt;/li&gt;
  455. &lt;/ol&gt;
  456. &lt;p&gt;That's it for explaining September 2016 live session stages: draft, rehearsal, live session itself, and publishing.&lt;/p&gt;</summary></entry><entry><title>OGS Editor 0.10 and live session materials</title><link href="http://opengamestudio.org/ogs-editor-0.10.html" rel="alternate"></link><updated>2016-10-03T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-10-03:ogs-editor-0.10.html</id><summary type="html">&lt;p&gt;&lt;img alt="ogs-editor-0.10" src="http://opengamestudio.org/2016-10-03_ogs-editor-0.10.png" /&gt;&lt;/p&gt;
  457. &lt;p&gt;Note: we won't release 0.10 for macOS due to technical difficulties with the build system. macOS support will be back for 0.11.&lt;/p&gt;
  458. &lt;ul&gt;
  459. &lt;li&gt;&lt;strong&gt;OGS Editor 0.10&lt;/strong&gt; &lt;a href="https://sourceforge.net/projects/osrpgcreation/files/Editor/jenkins/51_2016-10-01_06-39-48_0.10.0/"&gt;is available at SourceForge&lt;/a&gt;. Simply unpack the archive and launch the run script.&lt;/li&gt;
  460. &lt;li&gt;&lt;strong&gt;Mahjong Solitaire game&lt;/strong&gt; &lt;a href="https://sourceforge.net/projects/osrpgcreation/files/Games/MahjongSolitaire/"&gt;is available at SourceForge&lt;/a&gt;, too. Simply unpack the archive and launch the run script.&lt;/li&gt;
  461. &lt;li&gt;&lt;strong&gt;Live session project&lt;/strong&gt; &lt;a href="https://github.com/OGStudio/mahjong-solitaire-livesession"&gt;is available at GitHub&lt;/a&gt;.&lt;/li&gt;
  462. &lt;li&gt;&lt;strong&gt;Live session recording&lt;/strong&gt; &lt;a href="https://youtu.be/g8Tyj_YH2Qc?list=PLWMTZqE4MAMJzBnXS9qU_ObWnzJuskI3F"&gt;is available at YouTube&lt;/a&gt;. The video depicts the whole process of creating Mahjong Solitaire from scratch using &lt;a href="https://github.com/OGStudio/mahjong-solitaire-rehearsal"&gt;rehearsal project&lt;/a&gt; resources.&lt;/li&gt;
  463. &lt;/ul&gt;</summary></entry><entry><title>A few words about live session yesterday</title><link href="http://opengamestudio.org/yesterdays-live-session-short-overview.html" rel="alternate"></link><updated>2016-09-26T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-09-26:yesterdays-live-session-short-overview.html</id><summary type="html">&lt;iframe width="560" height="315" src="https://www.youtube.com/embed/_t8TGhSgJG4" frameborder="0" allowfullscreen&gt;&lt;/iframe&gt;
  464. &lt;p&gt;Mahjong Solitaire was successfully created, and it took less than 4 hours.
  465. We will publish live session materials later this week.&lt;/p&gt;
  466. &lt;p&gt;Thank you for joining us.&lt;/p&gt;</summary></entry><entry><title>Live session is in 24 hours</title><link href="http://opengamestudio.org/september-live-session-announcement-tomorrow.html" rel="alternate"></link><updated>2016-09-24T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-09-24:september-live-session-announcement-tomorrow.html</id><summary type="html">&lt;iframe width="560" height="315" src="https://www.youtube.com/embed/Fj4yHG-mV1U" frameborder="0" allowfullscreen&gt;&lt;/iframe&gt;
  467. &lt;p&gt;Get ready for &lt;a href="https://www.livecoding.tv/kornerr"&gt;live session&lt;/a&gt;, it's about to happen in 24 hours!&lt;/p&gt;</summary></entry><entry><title>Live session: 25 September 2016</title><link href="http://opengamestudio.org/september-live-session-announcement.html" rel="alternate"></link><updated>2016-09-17T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-09-17:september-live-session-announcement.html</id><summary type="html">&lt;iframe width="560" height="315" src="https://www.youtube.com/embed/Y5hOGKcQ8wA" frameborder="0" allowfullscreen&gt;&lt;/iframe&gt;
  468. &lt;p&gt;We will hold &lt;a href="https://www.livecoding.tv/kornerr"&gt;live session&lt;/a&gt; on &lt;a href="http://www.timeanddate.com/worldclock/fixedtime.html?msg=Open+Game+Studio+September+2016+live+session&amp;amp;iso=20160925T12&amp;amp;p1=37&amp;amp;ah=2"&gt;25 September 2016 at 12:00 CEST&lt;/a&gt;
  469. It's time to create simple Mahjong solitaire game.&lt;/p&gt;</summary></entry><entry><title>August 2016 recap</title><link href="http://opengamestudio.org/2016-august-recap.html" rel="alternate"></link><updated>2016-09-03T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-09-03:2016-august-recap.html</id><summary type="html">&lt;p&gt;&lt;img alt="2016-august-recap" src="http://opengamestudio.org/2016-09-03_august-recap.png" /&gt;&lt;/p&gt;
  470. &lt;p&gt;This article explains the most important technical details about development in August: UIQt module, its refactoring, a new feature based development approach, and its benefits.&lt;/p&gt;
  471. &lt;p&gt;&lt;strong&gt;UIQt module&lt;/strong&gt; is a collection of UI components backed by Qt. We only use it for Editor UI at the moment.&lt;/p&gt;
  472. &lt;p&gt;Here is a list of UIQt module components with their description and current code size:&lt;table&gt;
  473. &lt;tr&gt;
  474. &lt;th&gt;&lt;strong&gt;№&lt;/strong&gt;&lt;/th&gt;
  475. &lt;th&gt;&lt;strong&gt;Component&lt;/strong&gt;&lt;/th&gt;
  476. &lt;th&gt;&lt;strong&gt;Description&lt;/strong&gt;&lt;/th&gt;
  477. &lt;th&gt;&lt;strong&gt;Size (B)&lt;/strong&gt;&lt;/th&gt;
  478. &lt;th&gt;&lt;strong&gt;Size (%)&lt;/strong&gt;&lt;/th&gt;
  479. &lt;/tr&gt;
  480. &lt;tr&gt;
  481. &lt;td&gt;1&lt;/td&gt;
  482. &lt;td&gt;UIQtAction&lt;/td&gt;
  483. &lt;td&gt;Actions (events) for menus&lt;/td&gt;
  484. &lt;td&gt;11224&lt;/td&gt;
  485. &lt;td&gt;9&lt;/td&gt;
  486. &lt;/tr&gt;
  487. &lt;tr&gt;
  488. &lt;td&gt;2&lt;/td&gt;
  489. &lt;td&gt;UIQtAux&lt;/td&gt;
  490. &lt;td&gt;Initializes Qt and main window. Provides widget resolution by name to other components&lt;/td&gt;
  491. &lt;td&gt;15518&lt;/td&gt;
  492. &lt;td&gt;12&lt;/td&gt;
  493. &lt;/tr&gt;
  494. &lt;tr&gt;
  495. &lt;td&gt;3&lt;/td&gt;
  496. &lt;td&gt;UIQtDock&lt;/td&gt;
  497. &lt;td&gt;Widget docks&lt;/td&gt;
  498. &lt;td&gt;5273&lt;/td&gt;
  499. &lt;td&gt;4&lt;/td&gt;
  500. &lt;/tr&gt;
  501. &lt;tr&gt;
  502. &lt;td&gt;4&lt;/td&gt;
  503. &lt;td&gt;UIQtFileDialog&lt;/td&gt;
  504. &lt;td&gt;File selection dialogs&lt;/td&gt;
  505. &lt;td&gt;8960&lt;/td&gt;
  506. &lt;td&gt;7&lt;/td&gt;
  507. &lt;/tr&gt;
  508. &lt;tr&gt;
  509. &lt;td&gt;5&lt;/td&gt;
  510. &lt;td&gt;UIQtMenu&lt;/td&gt;
  511. &lt;td&gt;Menus for main window and pop-ups (like node's add/copy/paste/delete menu)&lt;/td&gt;
  512. &lt;td&gt;4566&lt;/td&gt;
  513. &lt;td&gt;3&lt;/td&gt;
  514. &lt;/tr&gt;
  515. &lt;tr&gt;
  516. &lt;td&gt;6&lt;/td&gt;
  517. &lt;td&gt;UIQtMenuBar&lt;/td&gt;
  518. &lt;td&gt;Menu bar for main window&lt;/td&gt;
  519. &lt;td&gt;4222&lt;/td&gt;
  520. &lt;td&gt;3&lt;/td&gt;
  521. &lt;/tr&gt;
  522. &lt;tr&gt;
  523. &lt;td&gt;7&lt;/td&gt;
  524. &lt;td&gt;UIQtRunner&lt;/td&gt;
  525. &lt;td&gt;Allows to start QApplication&lt;/td&gt;
  526. &lt;td&gt;2450&lt;/td&gt;
  527. &lt;td&gt;2&lt;/td&gt;
  528. &lt;/tr&gt;
  529. &lt;tr&gt;
  530. &lt;td&gt;8&lt;/td&gt;
  531. &lt;td&gt;UIQtThumbnailDialog&lt;/td&gt;
  532. &lt;td&gt;Dialog with thumbnail images&lt;/td&gt;
  533. &lt;td&gt;18615&lt;/td&gt;
  534. &lt;td&gt;14&lt;/td&gt;
  535. &lt;/tr&gt;
  536. &lt;tr&gt;
  537. &lt;td&gt;9&lt;/td&gt;
  538. &lt;td&gt;UIQtToolBar&lt;/td&gt;
  539. &lt;td&gt;Tool bar for main window&lt;/td&gt;
  540. &lt;td&gt;4276&lt;/td&gt;
  541. &lt;td&gt;3&lt;/td&gt;
  542. &lt;/tr&gt;
  543. &lt;tr&gt;
  544. &lt;td&gt;10&lt;/td&gt;
  545. &lt;td&gt;UIQtTree&lt;/td&gt;
  546. &lt;td&gt;Provides complex widgets like Scene tree and Property browser&lt;/td&gt;
  547. &lt;td&gt;51216&lt;/td&gt;
  548. &lt;td&gt;39&lt;/td&gt;
  549. &lt;/tr&gt;
  550. &lt;tr&gt;
  551. &lt;td&gt;11&lt;/td&gt;
  552. &lt;td&gt;UIQtWidget&lt;/td&gt;
  553. &lt;td&gt;Common widget properties like focus and visibility&lt;/td&gt;
  554. &lt;td&gt;5465&lt;/td&gt;
  555. &lt;td&gt;4&lt;/td&gt;
  556. &lt;/tr&gt;
  557. &lt;/table&gt;&lt;/p&gt;
  558. &lt;p&gt;&lt;strong&gt;UIQt module refactoring&lt;/strong&gt; purpose was to replace old State API with new Environment API, which allows to achieve the same functionality with less code, i.e., makes development easier and faster.&lt;/p&gt;
  559. &lt;p&gt;Refactoring started in July and should have been done the same month. However, we only finished the work in August. Initial plan assumed 28 hours would be enough, but we spent 65 instead. We estimated planned time by relying on the number of public API calls of each component. That worked fine for small components, because the number of their public API calls was roughly equal to the number of their features, and features themselves were very small. However, it totally failed for UIQtTree, which contains 39% of UIQt module code, because there was no direct connection between public API and features.&lt;/p&gt;
  560. &lt;p&gt;&lt;strong&gt;Feature based development approach&lt;/strong&gt; was born as a result of UIQtTree refactoring struggle. Since Qt uses MVC, UIQtTree component consists of several classes. By the time UIQtTree could display and manage a hierarchy of items, the component was already 27K in size. We noticed UIQtTree started to require abnormal amount of development time even for tiny features. This was an obvious &lt;a href="http://kornerr.blogspot.com/2012/04/complexity-conservation-law-complexity.html"&gt;quantitative complexity&lt;/a&gt; manifestation.&lt;/p&gt;
  561. &lt;p&gt;We decided to separate UIQtTree into base part and additional ones. Base would only contain minimal code required by all features. Addition would contain specific feature code and could be safely modified. In the case of UIQtTree, item hierarchy display and modification is the minimal functionality, while item renaming is an addition.&lt;/p&gt;
  562. &lt;p&gt;Here is a list of current UIQtTree features:&lt;/p&gt;
  563. &lt;table&gt;
  564. &lt;tr&gt;
  565. &lt;th&gt;**№**&lt;/th&gt;
  566. &lt;th&gt;**Feature**&lt;/th&gt;
  567. &lt;th&gt;**Description**&lt;/th&gt;
  568. &lt;th&gt;**Size (B)**&lt;/th&gt;
  569. &lt;th&gt;**Size (%)**&lt;/th&gt;
  570. &lt;/tr&gt;
  571. &lt;tr&gt;
  572. &lt;td&gt;1&lt;/td&gt;
  573. &lt;td&gt;Base&lt;/td&gt;
  574. &lt;td&gt;Allows to construct item hierarchy, modify it, and display it&lt;/td&gt;
  575. &lt;td&gt;26966&lt;/td&gt;
  576. &lt;td&gt;52&lt;/td&gt;
  577. &lt;/tr&gt;
  578. &lt;tr&gt;
  579. &lt;td&gt;2&lt;/td&gt;
  580. &lt;td&gt;Item open state&lt;/td&gt;
  581. &lt;td&gt;Keeps track of collapsed/expanded item properties&lt;/td&gt;
  582. &lt;td&gt;3094&lt;/td&gt;
  583. &lt;td&gt;6&lt;/td&gt;
  584. &lt;/tr&gt;
  585. &lt;tr&gt;
  586. &lt;td&gt;3&lt;/td&gt;
  587. &lt;td&gt;Item renaming&lt;/td&gt;
  588. &lt;td&gt;Allows to rename an item&lt;/td&gt;
  589. &lt;td&gt;3471&lt;/td&gt;
  590. &lt;td&gt;7&lt;/td&gt;
  591. &lt;/tr&gt;
  592. &lt;tr&gt;
  593. &lt;td&gt;4&lt;/td&gt;
  594. &lt;td&gt;Item selection&lt;/td&gt;
  595. &lt;td&gt;Allows to get/set selected item&lt;/td&gt;
  596. &lt;td&gt;2338&lt;/td&gt;
  597. &lt;td&gt;5&lt;/td&gt;
  598. &lt;/tr&gt;
  599. &lt;tr&gt;
  600. &lt;td&gt;5&lt;/td&gt;
  601. &lt;td&gt;Item value&lt;/td&gt;
  602. &lt;td&gt;Provides 2nd and the rest columns for items, used by Property browser&lt;/td&gt;
  603. &lt;td&gt;1307&lt;/td&gt;
  604. &lt;td&gt;3&lt;/td&gt;
  605. &lt;/tr&gt;
  606. &lt;tr&gt;
  607. &lt;td&gt;6&lt;/td&gt;
  608. &lt;td&gt;Item value editing&lt;/td&gt;
  609. &lt;td&gt;Allows to edit item values with a default editor widget&lt;/td&gt;
  610. &lt;td&gt;1996&lt;/td&gt;
  611. &lt;td&gt;4&lt;/td&gt;
  612. &lt;/tr&gt;
  613. &lt;tr&gt;
  614. &lt;td&gt;7&lt;/td&gt;
  615. &lt;td&gt;Item value editing with combobox&lt;/td&gt;
  616. &lt;td&gt;Provides combobox editor&lt;/td&gt;
  617. &lt;td&gt;5819&lt;/td&gt;
  618. &lt;td&gt;11&lt;/td&gt;
  619. &lt;/tr&gt;
  620. &lt;tr&gt;
  621. &lt;td&gt;8&lt;/td&gt;
  622. &lt;td&gt;Item value editing with spinner&lt;/td&gt;
  623. &lt;td&gt;Provides spinbox editor&lt;/td&gt;
  624. &lt;td&gt;5290&lt;/td&gt;
  625. &lt;td&gt;10&lt;/td&gt;
  626. &lt;/tr&gt;
  627. &lt;tr&gt;
  628. &lt;td&gt;9&lt;/td&gt;
  629. &lt;td&gt;Menu&lt;/td&gt;
  630. &lt;td&gt;Provides pop-up menu&lt;/td&gt;
  631. &lt;td&gt;1248&lt;/td&gt;
  632. &lt;td&gt;2&lt;/td&gt;
  633. &lt;/tr&gt;
  634. &lt;/table&gt;
  635. &lt;p&gt;Here's an example of UIQtTree Menu feature file: &lt;a href="https://bitbucket.org/ogstudio-history/mjin/src/0c4cc3c3213f4687c0f3bd6a5426a6054cadd79b/f/TREE_MENU.cpp?at=Studio+0.10&amp;amp;fileviewer=file-view-default"&gt;TREE_MENU&lt;/a&gt;.&lt;/p&gt;
  636. &lt;p&gt;&lt;strong&gt;Benefits of the approach&lt;/strong&gt; include:&lt;/p&gt;
  637. &lt;ol&gt;
  638. &lt;li&gt;Faster code reading/understanding due to small size&lt;/li&gt;
  639. &lt;li&gt;Easier and safer modification due to isolated code&lt;/li&gt;
  640. &lt;/ol&gt;
  641. &lt;p&gt;There's a drawback, too: new approach requires learning.&lt;/p&gt;
  642. &lt;p&gt;That's it for the most important technical details about development in August: UIQt module, its refactoring, a new feature based development approach, and its benefits.&lt;/p&gt;</summary></entry><entry><title>We’re back to social networks</title><link href="http://opengamestudio.org/back-to-social-networks.html" rel="alternate"></link><updated>2016-08-18T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-08-18:back-to-social-networks.html</id><summary type="html">&lt;p&gt;If you follow us on &lt;a href="https://www.facebook.com/groups/162611230470183/"&gt;Facebook&lt;/a&gt;, &lt;a href="https://twitter.com/OpenGameStudio"&gt;Twitter&lt;/a&gt;, or &lt;a href="https://new.vk.com/opengamestudo"&gt;VK&lt;/a&gt; you noticed we started to use them again. That's no coincidence: we're finally ready to communicate our progress verbally after 4 years of almost silent development.&lt;/p&gt;
  643. &lt;p&gt;Follow us to stay up-to-date!&lt;/p&gt;</summary></entry><entry><title>Once Mahjong – always Mahjong</title><link href="http://opengamestudio.org/once-mahjong-always-mahjong.html" rel="alternate"></link><updated>2016-08-10T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-08-10:once-mahjong-always-mahjong.html</id><summary type="html">&lt;p&gt;We started Opensource Game Studio project a long time ago. We wanted to provide open source community with tools to create games. However, it was unclear what tools' purpose was. So we decided to start small: create a game first.&lt;/p&gt;
  644. &lt;p&gt;It took us 3 years to reach the first goal: we released OGS Mahjong 1.0 in 2012. Even for a hobby project (we spend about 40 hours a month) it's too long.&lt;/p&gt;
  645. &lt;p&gt;Upon the game release we got it: &lt;strong&gt;Tools are means to save development time&lt;/strong&gt;.&lt;/p&gt;
  646. &lt;p&gt;We spent 4 more years to develop them. Now is the time to prove they are worth every single day spent. How? We will &lt;strong&gt;recreate Mahjong solitaire mode&lt;/strong&gt; in just a few hours!&lt;/p&gt;
  647. &lt;p&gt;Join our next live session in September.&lt;/p&gt;</summary></entry><entry><title>May 2016 live session materials</title><link href="http://opengamestudio.org/ogs-editor-0.9.html" rel="alternate"></link><updated>2016-05-29T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-05-29:ogs-editor-0.9.html</id><summary type="html">&lt;iframe width="560" height="315" src="https://www.youtube.com/embed/8gHYOkMRoos?list=PLWMTZqE4MAMKp3wP1N63xbdhdgfKi-d-J" frameborder="0" allowfullscreen&gt;&lt;/iframe&gt;
  648. &lt;p&gt;This time we have shown how to create a simple Domino based game. Below you can find all materials related to the game creation.&lt;/p&gt;
  649. &lt;ol&gt;
  650. &lt;li&gt;Editor 0.9 for Linux (Debian based), OS X (10.9+), Windows &lt;a title="SourceForge" href="https://sourceforge.net/projects/osrpgcreation/files/Editor/jenkins/49_2016-05-24_04-48-47_0.9.0/"&gt;is available at SourceForge&lt;/a&gt;. Simply unpack it and launch the run script.&lt;/li&gt;
  651. &lt;li&gt;Domino project created during live session &lt;a title="GitHub" href="https://github.com/OGStudio/domino-livesession"&gt;is available at GitHub&lt;/a&gt;.&lt;/li&gt;
  652. &lt;li&gt;Domino rehearsal videos referenced during live session &lt;a title="YouTube" href="https://www.youtube.com/playlist?list=PLWMTZqE4MAMKp3wP1N63xbdhdgfKi-d-J"&gt;are available at YouTube&lt;/a&gt;&lt;/li&gt;
  653. &lt;li&gt;Domino rehearsal project referenced during live session &lt;a title="GitHub" href="https://github.com/OGStudio/domino-rehearsal"&gt;is available at GitHub&lt;/a&gt;.&lt;/li&gt;
  654. &lt;/ol&gt;
  655. &lt;p&gt;The next live session will be held in September 2016.&lt;/p&gt;</summary></entry><entry><title>Live session: 28 May 2016</title><link href="http://opengamestudio.org/may-live-session-announcement.html" rel="alternate"></link><updated>2016-05-17T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-05-17:may-live-session-announcement.html</id><summary type="html">&lt;p&gt;We're glad to annouce that the &lt;a title="LiveCoding" href="https://www.livecoding.tv/kornerr"&gt;LiveCoding&lt;/a&gt; session will take place on &lt;a title="Local time" href="http://www.timeanddate.com/worldclock/fixedtime.html?msg=Open+Game+Studio+May+live+session&amp;iso=20160528T12&amp;p1=37&amp;ah=3"&gt;28 May 2016 at 12:00 CEST&lt;/a&gt;. Join us!&lt;/p&gt;</summary></entry><entry><title>May live session (Editor 0.9)</title><link href="http://opengamestudio.org/may-live-session-decision.html" rel="alternate"></link><updated>2016-04-24T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-04-24:may-live-session-decision.html</id><summary type="html">&lt;p&gt;As you know, the previously published roadmap assumed, that we would hold a live session in April and it would feature a ping-pong game created with Editor 0.9.&lt;/p&gt;
  656. &lt;p&gt;We have to admit, our abilities to plan are not yet good enough. That's why the next live session will take place by the end of May. The exact date will be announced later.&lt;/p&gt;
  657. &lt;p&gt;Here's a short preview of the coming game:
  658. &lt;iframe width="560" height="315" src="https://www.youtube.com/embed/V3EvCVPc6kg" frameborder="0" allowfullscreen&gt;&lt;/iframe&gt;&lt;/p&gt;</summary></entry><entry><title>"Rolling ball" live session videos and downloads</title><link href="http://opengamestudio.org/rolling-ball.html" rel="alternate"></link><updated>2016-02-10T00:00:00+03:00</updated><author><name>Opensource Game Studio</name></author><id>tag:opengamestudio.org,2016-02-10:rolling-ball.html</id><summary type="html">&lt;p&gt;Since we held 2 live sessions to create "Rolling ball" game, here are 2 YouTube videos of the process:&lt;/p&gt;
  659. &lt;iframe width="560" height="315" src="https://www.youtube.com/embed/70Jny1xJxK8" frameborder="0" allowfullscreen&gt;&lt;/iframe&gt;
  660. &lt;iframe width="560" height="315" src="http://www.youtube.com/embed/851IlFT7y18" frameborder="0" allowfullscreen&gt;&lt;/iframe&gt;
  661. &lt;p&gt;"Rolling ball" game for Linux (Debian based), OS X (10.9+), Windows &lt;a title="SourceForge" href="http://sourceforge.net/projects/osrpgcreation/files/Games/RollingBall/"&gt;is available at SourceForge&lt;/a&gt;.
  662. Simply unpack it and launch the run script.&lt;/p&gt;
  663. &lt;p&gt;Editor 0.8 &lt;a title="SourceForge" href="http://sourceforge.net/projects/osrpgcreation/files/Editor/jenkins/46_2016-01-30_22-20-41_0.8.0/"&gt;is available at SourceForge&lt;/a&gt;, too.&lt;/p&gt;
  664. &lt;p&gt;"Rolling ball" project for the Editor &lt;a title="GitHub" href="https://github.com/OGStudio/rollingBall.ogs/archive/master.zip"&gt;is available at GitHub&lt;/a&gt;.&lt;/p&gt;
  665. &lt;p&gt;To open it in the Editor:&lt;/p&gt;
  666. &lt;ul&gt;
  667. &lt;li&gt;replace slideDown.ogs with rollingBall.ogs you downloaded&lt;/li&gt;
  668. &lt;li&gt;rename rollingBall.ogs to slideDown.ogs&lt;/li&gt;
  669. &lt;/ul&gt;
  670. &lt;p&gt;Since live session took us so long, we decided to concentrate on polishing. Editor already has a lot of features, but their use is inconvenient. We will fix major obstacles for the next Editor release.&lt;/p&gt;</summary></entry></feed>