Opensource Game Studio

Ideal games and game development tools

2018-11-19T00:00:00+03:00

In this article, we discuss how ideal video game and video game development tool look like, in our opinion.

Questions

As you know, the goals of Opensource Game Studio are:

creation of free video game development tools
making video games with those tools
preparing video game development tutorials

This time we asked ourselves two simple questions:

What is an ideal video game?
What is an ideal video game development tool?

The best answers we could think of are below.

Answer 1: A video game is ideal if it delivers maximum pleasure possible

While content is probably the most important aspect to keep a player invested into the game, the technical side is the transport to deliver that content. There are quite a few technical problems that may damage otherwise excellent content of a game:

insufficient accessibility: the game does not run on your hardware
insufficient optimization: the game is slow
critical bugs: the game crashes from time to time

We work hard to make sure the games we create are accessible everywhere. That's why we released the second demonstration of OGS Mahjong 2 only for the web: because you can run web version virtually anywhere.

Answer 2: A video game development tool is ideal if it lets you create a video game of your dream in the shortest time possible

Even though we put a lot of effort into sharing our knowledge through guides and tutorials, we understand that those take a lot of time to study. One can't possibly make even a simple video game like Memory without performing the following steps:

configure the development environment
write code
build an application
debug the application
repeat write-build-debug steps as many times as necessary

Writing code and debugging are probably the ultimate forms of input and output of any software, so we can't escape those. However, there are ways to completely remove (or at least significantly decrease) the need for development environment setup and build steps. And this is what we are going to do in the coming months.

Our goal for the coming months is to create a video game development tool that would allow any programmer (or sufficiently skilled person) to create the Memory video game from scratch in an hour.

That's it for discussing how ideal video game and video game development tool look like, in our opinion.

Идеальные игры и средства для их разработки

2018-11-19T00:00:00+03:00

В этой статье мы обсудим, как выглядят идеальные видеоигра и инструмент для разработки видеоигр, по нашему мнению.

Вопросы

Как вы знаете, целями Opensource Game Studio являются:

создание бесплатных инструментов для разработки видеоигр
создание видеоигр с помощью этих инструментов
создание самоучителей по разработке видеоигр

В этот раз мы решили задать себе пару простых вопросов:

Какова идеальная видеоигра?
Каков идеальный инструмент для разработки видеоигр?

Ниже представлены наши ответы.

Ответ 1: Видеоигра идеальна, если она доставляет максимально возможное удовольствие

Несмотря на то, что содержание является, пожалуй, самой важной частью, удерживающей человека в игре, техническая сторона является транспортом для доставки этого содержания. Существует немало технических проблем, которые могут полностью испортить впечатление даже от превосходного содержания:

недостаточная доступность: игра не идёт на оборудовании человека
недостаточная оптимизация: игра тормозит
критичные ошибки: игра падает время от времени

Мы тратим много сил, чтобы сделать наши игры доступными везде. Именно поэтому мы выпустили вторую демонстрацию OGS Mahjong 2 лишь для веба: т.к. вы можете запустить веб-версию практически где угодно.

Ответ 2: Инструмент для разработки видеоигр идеален, если он позволяет создать игру мечты в кратчайшие возможные сроки

Несмотря на то, что мы тратим много усилий на то, чтобы делиться своими знаниями с помощью руководств и самоучителей, мы осознаём, что на работу с ними уходит много времени. Сейчас нельзя создать даже простейшую видеоигру на память без выполнения следующих шагов:

настроить окружение разработки
написать код
собрать приложение
отладить приложение
повторить шаги написать-собрать-отладить столько раз, сколько нужно

Написание кода и отладка, пожалуй, являются конечными формами входа и выхода любого программного обеспечения, поэтому мы их не избежим. Однако, мы можем полностью избавиться от шагов (или хотя бы значительно сократить их) настройки окружения разработки и сборки. Именно на это мы и потратим ближайшие месяцы.

Наша цель на ближайшие месяцы состоит в том, чтобы создать такой инструмент разработки видеоигр, чтобы любой программист (или достаточно квалифицированный человек) мог создать видеоигру на память с нуля за час.

На этом мы заканчиваем обсуждение, как выглядят идеальные видеоигра и инструмент для разработки видеоигр, по нашему мнению.

OGS Mahjong 2: Demo 2

2018-10-02T00:00:00+03:00

We are glad to announce the release of the second demonstration of OGS Mahjong 2. The purposes of this release were to refine our development techniques and build a solid cross-platform foundation.

Release

Run the latest version of OGS Mahjong 2 in your web browser: http://ogstudio.github.io/ogs-mahjong

You are encouraged to run the game with seed parameter like this: http://ogstudio.github.io/ogs-mahjong?seed=0

This allows you to play the same layout each time you launch the game.

Each seed uniquely identifies the placement of tiles. Thus, different seeds give you a different experience.

Development techniques and foundation

During the second demonstration development, we switched from standard development to example-driven one. This resulted in the creation of three distinct repositories to back the development of OGS Mahjong 2:

OpenSceneGraph cross-platform examples repository provides cross-platform foundation like resource handling, render window setup, etc.
OGS Mahjong components repository provides Mahjong specific functionality like parsing layout, matching tiles, etc.
OGS Mahjong repository contains snapshots of OGS Mahjong components features that comprise specific game version. E.g., Demo 2 version is almost identical to 05.ColorfulStatus example of OGS Mahjong components.

Beyond Mahjong solitaire

In addition to seed parameter, you can let the game use remote layout hosted at GitHub: http://ogstudio.github.io/ogs-mahjong?seed=0&layout=github://OGStudio/ogs-mahjong-components/data/cat.layout

Utilizing remote resources is an extremely powerful approach allowing anyone to create a layout of his/her choice and see the layout in action instantly.

Our next step is to turn game logic into a resource, too.

OGS Mahjong 2: Demo 2

2018-10-02T00:00:00+03:00

Мы рады сообщить о выпуске второй демонстрации OGS Mahjong 2. Её целью были улучшение техники разработки и создание надёжной основы кроссплатформенной разработки.

Выпуск

Запустите последний выпуск OGS Mahjong 2 в вашем браузере: http://ogstudio.github.io/ogs-mahjong

Рекомендуем запускать игру с параметром seed следующим образом: http://ogstudio.github.io/ogs-mahjong?seed=0

Это позволяет вам играть в ту же самую раскладку после перезапуска.

Каждое значение зерна (seed) однозначно задаёт расположение фишек, так что разные значения зерна дают разнообразие партий.

Техника разработки и основа

Во время разработки второй демонстрации мы перешли с обычной разработки на разработку через создание примеров. Это привело к появлению трёх различных хранилищ для обеспечения разработки OGS Mahjong 2:

Хранилище кроссплатформенных примеров OpenSceneGraph содержит основу вроде работы с ресурсами, создание графического окна и т.д.
Хранилище компонент OGS Mahjong содержит специфичную для Маджонга функциональность вроде разбора раскладки, сопоставления фишек и т.д.
Хранилище OGS Mahjong содержит снимок набора функциональностей компонент OGS Mahjong, которые определяют версию игры. Например, версия Demo 2 почти полностью повторяет пример 05.ColorfulStatus из компонент OGS Mahjong.

За пределами пасьянса Маджонг

В дополнение к параметру seed вы можете указать игре использовать удалённую раскладку, расположенную на GitHub: http://ogstudio.github.io/ogs-mahjong?seed=0&layout=github://OGStudio/ogs-mahjong-components/data/cat.layout

Использование удалённых ресурсов открывает огромные возможности, т.к. позволяет любому желающему создать раскладку на свой вкус и моментально её проверить.

Наш следующий шаг - это выделение игровой логики в виде ресурса.

Examples and dependencies

2018-08-21T00:00:00+03:00

This article describes two new OpenSceneGraph cross-platform examples and the change in handling dependencies.

Examples of HTTP client and node selection

Once we finished working on the remote debugging example and reported its completion, we were surprised by the fact that secure HTTP connection between a debugged application and debug broker was only working in the web version of the example. Desktop and mobile versions only worked with insecure HTTP.

Since current debug scheme has no authentication, insecure debugging over HTTP doesn't really hurt. However, if we want to access resources located at popular sites like GitHub and BitBucket, we have to support secure HTTP.

The need to support HTTPS on each platform spurred us to create HTTP client example. Turned out, each platform had its own preferred way of doing secure HTTP:

web (Emscripten) provides Fetch API
desktop is fine with Mongoose and OpenSSL
Android provides HttpUrlConnection in Java
iOS provides NSURLSession in Objective-C

The need to support different languages on different platforms resulted in the creation of so-called 'host-guest' pattern:

guest (platform agnostic)
- provides networking representation
- used by cross-platform C++ code
host (specific platform)
- polls guest for pending requests
- processes them
- reports results back to the guest

Node selection example was straightforward and caused no troubles.

The change in handling dependencies

For over a year we had to deal with the following shortcomings when building OpenSceneGraph across platforms using conventional methods:

macOS builds failing due to certain compile flags we use
hacking PNG plugin safety guards to have PNG support under Android
iOS simulator and device builds of the same example being in separate Xcode projects
OpenSceneGraph taking 20-30 minutes to build

These shortcomings were slowing us down and complicating the development of new examples. Upon hitting these problems ten more times this month we decided it was time to solve them once and for all. Now OpenSceneGraph is built as part of each example in 2-3 minutes, and there's no more dependency magic involved. We took the same approach of building dependencies as part of each example to other external libraries like Mongoose and libpng-android, too.

With these obstacles out of the way, we can now iterate faster. Just in time for the next technical demonstration of Mahjong 2!

That's it for describing two new OpenSceneGraph cross-platform examples and the change in handling dependencies.

Примеры и зависимости

2018-08-21T00:00:00+03:00

Эта статья описывает два новых кросс-платформенных примера OpenSceneGraph и изменение в работе с зависимостями.

Примеры клиента HTTP и выбора узла сцены

После окончания работы над примером удалённой отладки и сообщения об этом мы с удивлением обнаружили, что безопасное соединение HTTPS между отлаживаемым приложением и брокером отладки работало лишь в веб-версии примера. Десктопная и мобильная версии работали лишь с помощью обычного соединения HTTP.

Т.к. текущая схема отладки не имеет авторизации, отладка по обычному соединению HTTP не несёт никаких проблем. Однако, если мы хотим получить доступ к ресурсам, расположенным на популярных сайтах вроде GitHub и BitBucket, мы обязаны поддерживать HTTPS.

Необходимость поддержки HTTPS на каждой платформе побудила нас создать пример клиента HTTP. Оказалось, что каждая платформа имеет собственные правила по работе с HTTPS:

веб (Emscripten) предоставляет Fetch API
десктоп может использовать Mongoose с OpenSSL
Android предоставляет HttpUrlConnection в языке Java
iOS предоставляет NSURLSession в языке Objective-C

Необходимость поддержки разных языков на разных платформах привела к созданию так называемого шаблона "хозяин-гость":

гость (не привязан к платформе)
- имеет сетевое представление
- используется кросс-платформенным кодом на C++
хозяин (определённая платформа)
- опрашивает гостя на наличие ожидающих выполнение запросов
- обрабатывает их
- сообщает результат гостю

Пример выбора узла сцены оказался простым и не создал особых проблем.

Изменение в работе с зависимостями

Больше года нам приходилось жить со следующими недостатками сборки OpenSceneGraph официальными средствами:

проблемы сборки под macOS ввиду использования определённых флагов сборки
обход механизмов проверки зависимостей для использования PNG на Android
принадлежность сборок iOS под симулятор и устройство к разным проектам Xcode
ожидания в 20-30 минут для сборки OpenSceneGraph

Эти недостатки замедляли нас и усложняли разработку новых примеров. После того, как мы десятый раз столкнулись с указанными проблемами в этом месяце, мы решили исправить их раз и навсегда. Теперь мы собираем OpenSceneGraph как часть каждого примера за 2-3 минуты без какой-либо магии. Также мы использовали этот подход включения зависимости как части каждого примера для остальных библиотек вроде Mongoose и libpng-android.

Теперь без этих препятствий мы можем разрабатывать быстрее. Это значительно облегчит создание следующей технической демонстрации Mahjong 2!

На этом мы заканчиваем описание двух новых кросс-платформенных примеров OpenSceneGraph и изменения в работе с зависимостями.

Example-driven development

2018-06-27T00:00:00+03:00

This article explains how the third OpenSceneGraph cross-platform example opened our eyes to example-driven development.

2018-08 EDIT: the third example has been renamed to the fourth one due to the reasons described in the next article.

The third OpenSceneGraph cross-platform example

The third OpenSceneGraph cross-platform example explains how to implement remote debugging across platforms. This example is less about OpenSceneGraph and more about different platforms.

Remote anything nowadays assumes the use of HTTP(s) over TCP/IP. Thus, the first idea was to embed HTTP server into an application and let HTTP clients interact with the server. However, serving HTTP across all platforms is complicated:

desktops have firewalls
mobiles have restrictions on background processes
web browsers are HTTP clients by design

That's why we decided to create a mediator between debugged application and UI. Debug broker, a small Node.js application, became that mediator. Debug broker uses no external dependencies, so it's easy to run virtually anywhere. Also, since debug broker is a server application, you can configure it once and use it for any number of applications.

Both debug UI and debug broker use JavaScript because we wanted these tools to be accessible from anywhere with no prior installation. This decision limited us to web browser solution. Providing any sort of desktop application would incur additional installation and maintenance effort, which would only complicate the tools.

Example-driven development establishment

Once the third example was implemented, we realized how important and beneficial it is to develop new features outside the main project:

the main project is freed from excessive commit noise
a new feature is publicly shared for everyone to learn, criticize, and improve

When we publicly share our knowledge:

we must create documentation for everyone (including ourselves later) to understand what's going on
we must not use hacks because that would break your trust in us

From now on, all new features like input handling, Mahjong layout loading, resource caching, etc. are going to be first implemented as examples. We call this example-driven development.

That's it for explaining how the third OpenSceneGraph cross-platform example opened our eyes to example-driven development.

Разработка через создание примеров

2018-06-27T00:00:00+03:00

Эта статья описывает то, как создание третьего кросс-платформенного примера OpenSceneGraph привело нас к разработке через создание примеров.

ИЗМЕНЕНИЯ ОТ 2018-08: третий пример был переименован в четвёртый в связи с причинами, изложенными в следующей статье.

Третий кросс-платформенный пример OpenSceneGraph

Третий кросс-платформенный пример OpenSceneGraph содержит реализацию удалённой отладки, работающей на всех поддерживаемых платформах. Этот пример относится не столько к OpenSceneGraph, сколько к поддержке различных платформ.

Удалённое взаимодействие ныне предполагает использование HTTP(s) поверх TCP/IP. Таким образом, первая идея реализации подразумевала встраивание сервера HTTP в приложение, чтобы клиенты HTTP могли взаимодействовать с этим сервером. Однако, раздача HTTP на различных платформах имеет свои сложности:

на десктопах есть межсетевые экраны (firewalls)
на мобилках есть ограничения по работе фоновых процессов
веб-браузеры являются клиентами HTTP по дизайну

Эти ограничения подтолкнули нас к созданию посредника между отлаживаемым приложением и пользовательским интерфейсом отладки. Брокер отладки, небольшое приложение Node.js, стало тем самым посредником. Брокер отладки не имеет внешних зависимостей, поэтому его легко использовать практически везде. Благодаря тому, что брокер отладки - это серверное приложение, его достаточно настроить лишь раз и использовать для любого количества приложений.

И пользовательский интерфейс отладки, и брокер отладки используют JavaScript, т.к. мы хотели сделать эти инструменты максимально доступными без предварительной установки. Данное решение привело нас к реализации инструментов именно для веб-браузеров. Десктопное приложение потребовало бы дополнительных усилий на установку и поддержку, что лишь усложнило бы работу с инструментами.

Разработка через создание примеров

После создания третьего примера мы осознали важность и достоинства разработки новых функций вне основного проекта:

освобождение основного проекта от шума изменений (commit noise)
публичное освещение новой функции приглашает всех к её изучению, критике и улучшению

Когда мы делимся нашими знаниями:

мы обязаны создавать документацию, объясняющую происходящее (в том числе для нас самих позже)
мы обязаны сторониться непродуманных решений, т.к. они повредят нашей репутации

С этого момента все новые функции вроде обработки ввода, загрузки раскладок Маджонга, кэширования ресурсов и т.п. мы будем сначала реализовывать в виде примеров. Мы называем этот подход разработкой через создание примеров.

На этом мы заканчиваем описание того, как создание третьего кросс-платформенного примера OpenSceneGraph привело нас к разработке через создание примеров.

OpenSceneGraph cross-platform examples

2018-04-20T00:00:00+03:00

This article summarizes the work we did to produce the first two cross-platform OpenSceneGraph examples.

By the time the first technology demonstration of OGS Mahjong 2 has been released, we've already had issue request (to explain how to load images with OpenSceneGraph on Android) hanging for some time. We considered creating a new tutorial for OpenSceneGraph cross-platform guide at first. However, we realized that it's time-consuming and excessive for such a tiny topic (compared to what an average game has) as image loading. We decided to continue sharing our knowledge in the form of concrete examples. That's how OpenSceneGraph cross-platform examples were born.

Each example:

explains crucial code necessary to perform a specific task
accents platform-specific nuances
provides implementations to cover desktop, mobile, and web platforms
provides a web build to showcase results

The first two examples cover the following topics:

Embed resource into executable: this greatly simplifies resource handling across platforms
Use PNG images with PNG plugins: this explains the requirements necessary to build and use PNG plugins

We will be adding new examples as we proceed with OGS Mahjong 2 development.

That's it for summarizing the work we did to produce the first two cross-platform OpenSceneGraph examples.

Кросс-платформенные примеры OpenSceneGraph

2018-04-20T00:00:00+03:00

Эта статья резюмирует создание первых двух кросс-платформенных примеров OpenSceneGraph.

К тому времени, как мы выпустили первую техническую демонстрацию OGS Mahjong 2, нас уже дожидался запрос на описание работы с изображениями в OpenSceneGraph на Android. Сначала мы рассматривали возможность создания нового самоучителя для кросс-платформенного руководства OpenSceneGraph, но позже мы оценили необходимые трудозатраты и посчитали их излишними для освещения такой небольшой темы (по сравнению с тем, что умеет средняя игра) как загрузка изображений. Мы решили продолжить делиться нашими знаниями в виде конкретных примеров. Так на свет появились кросс-платформенные примеры OpenSceneGraph.

Каждый пример:

объясняет критически важный код для выполнения поставленной задачи
акцентирует внимание на нюансах, специфичных для каждой платформы
предоставляет реализации примера для десктопа, мобилок и веба
предоставляет сборку для веба, чтобы упростить оценку результата

Первая пара примеров освещает следующие темы:

Встраивание ресурсов в исполняемый файл: значительное упрощение работы с ресурсами на всех платформах
Использование изображений PNG с помощью плагинов PNG: описание требований, необходимых для сборки и использования плагинов PNG

Мы будем и впредь добавлять новые примеры по мере продвижения нашей разработки OGS Mahjong 2.

На этом мы заканчиваем резюме о создании первых двух кросс-платформенных примеров OpenSceneGraph.

First techdemo of OGS Mahjong 2: Gameplay

2018-02-16T00:00:00+03:00

We are glad to announce the release of the first technical demonstration of OGS Mahjong 2. The purpose of this release was to verify gameplay across supported platforms.

Get techdemo for your platform:

Notes:

iOS version is not released because it cannot be easily shared outside AppStore.
Launch run script under Linux and macOS.
Linux version is only available in 64-bit variant.
macOS version should run on macOS Sierra or newer.

That's it for now, have a nice testing!

Первая технодемка OGS Mahjong 2: Игровая механика

2018-02-16T00:00:00+03:00

Мы ради сообщить о выпуске первой технической демонастрации OGS Mahjong 2. Её цель была в проверке игровой механики на всех поддерживаемых платформах.

Проверьте технодемку на своей платформе:

Запустить версию для веба в браузере
Получить версию для Android
Получить версию для Windows
Получить версию для Linux
Получить версию для macOS

Замечания:

Версия для iOS не выпущена, т.к. нет простого способа её распространения вне AppStore.
Запустите скрипт run в версиях для Linux и macOS.
Версия для Linux доступна лишь в 64-битном варианте.
Версия для macOS должна работать на macOS Sierra или новее.

На сегодня это всё, хорошей проверки!

Mahjong recreation start

2018-01-26T00:00:00+03:00

This article describes the start of Mahjong game recreation.

Plan

We started Mahjong recreation endeavour by composing a brief plan to get gameplay with minimal graphics:

Load single layout
Place tiles in layout positions
Distinguish tiles
Implement selection
Implement matching

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.

Problem №1: provide binary resources across supported platforms

Mahjong is going to be available on desktop, mobile, and web. Each of these platforms has its constraints on accessing external files:

Desktop can access almost any file
Android/iOS have limited access to file system
Web does not have any file system at all

To provide a unified way for accessing resources, we decided to include them into final executable. This decision led to the birth of mjin-resource and mahjong-data projects.

mjin-resource:

converts binary files to C header files with the help of xxd utility
generates MJIN project that contains generated headers to be compiled into static library
provides C++ interface for accessing generated resources

mahjong-data is an example of such generated MJIN project that is referenced by mahjong project.

Problem №2: load PNG images across supported platforms

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 libpng, which OpenSceneGraph build script can't detect. We had to work around several OpenSceneGraph checks to successfully build the plugin for Emscripten. 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 OpenSceneGraph cross-platform guide to cover PNG image loading. We already got a request to describe image loading.

Development

As you know, 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 mahjong repository.

We also provide version history and web releases of each internal version for the following reasons:

education: show how development looks like internally
accessibility: provide older versions for comparison

Current Mahjong game status

As of the time of this writing, we have implemented tile selection. Try it in your browser!

Once we finish tile matching implementation, we are going to publish the intermediate result for all supported platforms.

That's it for describing the start of Mahjong game recreation.

Начало воссоздания Маджонга

2018-01-26T00:00:00+03:00

Эта статья описывает начало воссоздания игры Маджонг.

План

Мы начали воссоздание Маджонга с составления краткого плана реализации игровой механики с минимальной графикой:

Загрузить раскладку
Поместить фишки в позиции раскладки
Различить фишки
Реализовать выбор фишек
Реализовать сравнение фишек

Как и любой другой план, этот выглядел вполне адекватно на первый взгляд. Тем не менее стоит начать разработку, как появляются новые детали. Этот план не был исключением. Ниже представлена пара проблем, вскрывшихся во время разработки.

Проблема №1: предоставить бинарные ресурсы на поддерживаемых платформах

Маджонг будет доступен для десктопа, мобилок и веба. Каждая платформа имеет ограничения на доступ к внешним файлам:

Десктоп позволяет получить доступ почти к любому файлу
Мобилки имеют ограниченный доступ к файловой системе
Веб не имеет файловой системы

Мы решили сделать единый способ доступа к ресурсам путём их встраивания в исполняемый файл. Это решение привело к рождению проектов mjin-resource и mahjong-data.

Проект mjin-resource служит для:

перевода бинарных файлов в заголовочные файлы C с помощью утилиты xxd
создания проекта MJIN, состоящего из сгенерированных заголовочных файлов, который собирается в статическую библиотеку
предоставления интерфейса C++ для работы с ресурсами

Проект mahjong-data является примером подобного проекта MJIN, ресурсы из которого использует проект mahjong.

Проблема №2: загрузка изображений PNG на поддерживаемых платформах

Для загрузки PNG мы используем соответствующий плагин OpenSceneGraph. Мы собрали его без проблем для десктопа. Сборка же для веба (Emscripten) оказалась сложнее: Emscripten содержит собственную версию libpng, которую сборочный скрипт OpenSceneGraph не видит. Нам пришлось обойти несколько проверок OpenSceneGraph, чтобы успешно собрать плагин для Emscripten. Сборка плагина под мобилки ещё ждёт нас впереди. Как только мы разберёмся с плагином PNG на всех поддерживаемых платформах, мы опубликуем информацию о его сборке в новом самоучителе для кросс-платформенного руководства OpenSceneGraph. Нас уже попросили это сделать.

Разработка

Как вы знаете, мы опубликовали кросс-платформенное руководство OpenSceneGraph для усиления сообщества OpenSceneGraph. Мы ценим обучение и любим делиться своими знаниями. Поэтому мы решили разрабатывать Маджонг небольшими воспроизводимыми частями, каждая из которых имеет уникальную внутреннюю версию. Эти версии доступны в хранилище проекта mahjong.

Мы также предоставляем историю версий, каждая из которых сопровождается сборкой под веб, для следующих целей:

обучение: показать ход разработки изнутри
доступность: предоставить старые версии для сравнения

Текущее состояние игры Маджонг

На момент написания этой статьи мы закончили реализацию выбора фишек. Проверьте в своём браузере!

После реализации сравнения фишек мы опубликуем промежуточный результат для всех поддерживаемых платформ.

На этом мы заканчиваем описание начала воссоздания игры Маджонг.

The year of lessons

2017-12-31T22:00:00+03:00

So, the year 2017 is approaching its finale, the year's results have already been summed up. We're going to take a break from igniting the fireworks or preparation of the champagne so that we can designate our goal for the following year.

As it may be clear from other articles on the site, half of our plans in 2017 were destined to be completed at least approximately as we assumed. The other half was changed significantly.

During the year, people joined the team and left it. As a result, we meet the end of the year with exactly the same team as 365 days ago. It made us think. A lot. But We'll save the story for another time.

There will be exactly one goal for 2018. We will take all the results, and then we will make a new mahjong game. We're already know how to make a mahjong solitaire so we will begin with it. This time, it will be cross-platform. We will definitely try to cover Windows, Linux, macOs, Web, and Android. We can't promis anything about the iOS right now (although we'll see what we can do).

There is no point in writing more than We want to say. We learned a lot for this year, and we will try to apply all this knowledge to achieve more in the next one. We wish everyone a Happy New Year. Stay tuned.

The Opensource Game Studio Team.

Год новых уроков

2017-12-31T22:00:00+03:00

Итак, 2017й год стремительно приближается к финалу, итоги года уже подведены, так что в свободное от расчехления фейерверков и подготовки систем залпового огня шампанским время мы обозначим свою цель в следующем году.

Как, наверное, понятно из других статей на сайте, примерно половине наших планов в 2017 году было суждено осуществиться хотя бы приблизительно так как мы предполагали, остальные поменялись существенно.

В течение года люди приходили в команду, уходили из нее, в итоге конец года мы встречаем с тем же составом что и 365 дней назад. Это заставило нас задуматься, но о выводах как-нибудь в другой раз.

Цель на 2018й год у нас будет ровно одна. Мы возьмем все результаты своих технологических поисков, и снова вернемся к маджонгу. Первым будет то, что мы уже умеем делать и делали - пасьянс. На этот раз, он будет кроссплатформенным. Точно постараемся охватить Windows, Linux, macOs, Web и Android. На счет iOS пока ничего обещать не будем (хотя и зарекаться - тоже).

Наверное нет смысла писать больше чем хочется сказать. Мы многому научились за этот год, и в следующем постараемся все это применить. Так что желаем всем счастливого Нового Года и оставайтесь с нами.

Команда Opensource Game Studio.

2017 summary

2017-11-22T00:00:00+03:00

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.

Brief history

Opensource Game Studio project is 12 years old now.

2005. We started the project with a fanatic call 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). 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.

2010. 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.

2012, 2013. 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.

2015. 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.

2016. 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.

Last year

2016, October. We started mobile platforms' research by making simple straightforward OpenSceneGraph application run under Android.

2017, January. We got the Android version working and started iOS and Web research.

2017, February. We made the sample application work everywhere: desktop, mobile, web.

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.

2017, July. We published OpenSceneGraph cross-platform guide, 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.

2017, November. We published simple Memory: Colors game and the guide 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.

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.

Итоги 2017-го

2017-11-22T00:00:00+03:00

Настало время сделать ревизию наших достижений в 2017 году и проверить, насколько они следуют основной цели проекта Opensource Game Studio.

Краткая история

Проекту Opensource Game Studio уже 12 лет.

2005. Мы начали проект с фанатичного призыва к созданию самой лучшей игры. Видимо, сразу же после прохождения Half-Life 2 или Morrowind. 99.99% тех, кто хотел участвовать, отвалились в течение первых двух лет. Остались лишь два человека: Михаил (программирование) и Иван (всё остальное). Проект находился в стадии постоянного беспорядка, т.к. у нас не было ни чёткой цели, ни дисциплины. Неудивительно, что за этот период мы можем похвастаться лишь небольшим набором сумбурных демонстраций.

2010. Первый год признания нашего поражения. После принятия поражения мы поставили себе целью создать игру Маджонг. Мы также осознали, что для выпуска игры нам придётся работать каждый день. Работа по выходным не приносила результатов, т.к. она часто сталкивалась с необходимостью уделять время семье.

2012, 2013. Мы выпустили версии 1.0 и 1.1 Маджонга соответственно. Мы создали полноценную отполированную игру за 3-4 года, тогда как до этого 5 лет не могли сделать ничего вразумительного. Маджонг до сих пор остаётся нашей лучшей и единственной выпущенной игрой. Мы всё ещё гордимся им, и нам всё ещё нравится в него играть.

2015. Мы продемонстрировали первую версию нашего средства разработки. Мы приступили к его созданию сразу после выпуска Маджонга, т.к. решили сделать инструмент для экономии времени разработки следующих игр.

2016. Мы воссоздали игровую механику Маджонга с помощью нашего инструмента. Тем не менее, к тому моменту мы осознали, что разработка лишь под настольные компьютеры нежизнеспособна. Это понимание подтолкнуло нас к изучению мобильных платформ.

Последний год

2016, октябрь. Мы начали изучение мобильных платформ с создания простейшего приложения OpenSceneGraph, которое сможет работать на Android.

2017, январь. Мы получили версию Android и начали изучение iOS с Вебом.

2017, февраль. Мы запустили простейшее приложение везде: настольный компьютер, мобильные платформы, веб.

Изучение мобильных платформ и веба заняло у нас около пяти месяцев. Нам пришлось потратить это время по причине отсутствия какой-либо внятной документации по работе с OpenSceneGraph на разных платформах. После таких громадных трат времени мы решили сэкономить это время другим разработчикам и занялись созданием указанной документации.

2017, июль. Мы опубликовали инструкцию по работе с OpenSceneGraph на разных платформах, которая рассказывает в деталях о создании простейшего приложения OpenSceneGraph и запуске его на настольных компьютерах, мобильных платформах и вебе. Эта инструкция является нашим самым популярным проектом на GitHub.

2017, ноябрь. Мы выпустили простую игру "Память: Цвета" и инструкцию по созданию этой игры с нуля. Игра создана с помощью MJIN, нашего нового инструмента для разработки игр, этому инструменту всего лишь несколько месяцев.

На текущий момент MJIN лишь начинает развитие. Этому инструменту нужна настоящая игра, чтобы расцвести. Поэтому мы уже работаем над Маджонгом, который будет радовать вас и на настольных компьютерах, и на мобильных платформах, и в вебе. На этот раз мы постараемся сделать Маджонг быстрее.

Back to the Static

2017-10-16T00:00:00+03:00

We have been using Wordpress as our website engine for more than seven years. And now it's time to move forward. Or backward. For some time we've been tracking the development of the new breed of website engines - static site generators. It seems that this is the technology capable of changing past into future.

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. So, we are starting our site anew with the help of the Pelican. Right now it doesn't have all the content from our old site, but we'll add most of it soon.

Назад в Статику

2017-10-16T00:00:00+03:00

Мы используем Wordpress в качестве движка нашего сайта уже более семи лет. И теперь пришло время двигаться вперед. Или назад. Некоторое время мы следили за разработкой нового поколения движков - генераторов статических сайтов. Похоже, что это технология, способная превратить прошлое в будущее.

Статический веб-сайт проще, быстрее и безопаснее. И с помощью генераторов им настолько же легко управлять, как и динамическим веб-сайтом. Так что мы начинаем наш сайт заново с помощью [Pelican] (https://blog.getpelican.com/). Сейчас здесь нет всего контента с нашего старого сайта, но мы добавим его в ближайшее время.

The birth of MJIN world

2017-09-10T00:00:00+03:00

This article describes the birth of MJIN world in August 2017.

mjin-player

As you know, we spent July to research scripting. We found a solution that satisfies the following criteria. Scripts should:

run unchanged on all supported platforms
allow extending C++ code

We have verified the second criterion by writing a sample application. The first criterion was taken for granted because it SHOULD be true.

At the time, we saw two ways to verify the first criterion:

create one sample application for each platform to verify scripting only
create a single cross-platform application, which can run any code

We chose the second approach because it is more beneficial in the long run. As you might have guessed, mjin-player is that application.

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.

mjin-application

This set of rules for MJIN projects is packaged into mjin-application. 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.

MJIN world

So what is MJIN world? 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.

That's it for describing the birth of MJIN world in August 2017.

Рождение вселенной MJIN

2017-09-10T00:00:00+03:00

Эта статья описывает рождение вселенной MJIN в августе 2017.

mjin-player

Как вы знаете, в июле мы изучали скриптование. Мы нашли решение, которое удовлетворяет следующим критериям. Скрипты должны:

исполняться в исходном виде без изменений на всех поддерживаемых платформах
позволять расширять код C++

Мы проверили второй критерий в рамках тестового приложения. В первый критерий мы просто поверили, т.к. он ДОЛЖЕН быть верен.

В тот момент мы видели два варианта проверки первого критерия:

создать по одному тестовому приложению под каждую платформу для проверки лишь этого критерия
создать одно кросс-платформенное приложение, которому можно скормить практически любой код

Мы выбрали второй подход, т.к. он выгоднее в долгосрочной перспективе. Как вы уже догадались, mjin-player является тем самым кросс-платформенным приложением.

mjin-player служит базой для остальных проектов MJIN, которая позволяет этим проектам работать на всех поддерживаемых платформах. Тем не менее, в mjin-player нет никакой магии, проекты никак не скрыты от деталей платформ, да и не было такой задачи. Вместо скрытия деталей платформы mjin-player предоставляет набор правил, которым должны удовлетворять проекты MJIN для работы на всех поддерживаемых платформах.

mjin-application

Этот набор правил представлен в виде mjin-application. mjin-application является библиотекой с базовым функционалом, необходимым для каждого проекта MJIN, но не более. Например, mjin-application не содержит и никогда не будет содержать скриптования или подобного специфического функционала.

Вселенная MJIN

Так что же такое вселенная MJIN? Это множество проектов, которые являются нашими средствами для разработки игр. mjin-player и mjin-application - первые кирпичики недавно появившейся вселенной MJIN. А будет их намного больше. Оставайтесь на связи, нас ждёт светлое будущее с MJIN.

На этом мы заканчиваем описание рождения вселенной MJIN в августе 2017.

Scripting research

2017-08-16T00:00:00+03:00

This article describes scripting research in July 2017.

Our first goal of using a scripting language was to have a platform-independent code that runs unchanged on every supported platform.

OGS Editor 0.10 supports Python for such a code thanks to SWIG. 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.

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 Kivy, 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.

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.

Our secondary goal for using a scripting language was to allow to extend C++ code.

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.

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. Technically such behaviour is achieved by inheriting a base class and overriding its methods in both C++ and a scripting language.

First, we evaluated Python for the role of cross-platform scripting language.

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. We also had a look at PyPy, another Python implementation. It also did not mention support for mobile and web platforms.

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.

Second, we evaluated Wren for the role of cross-platform scripting language.

Wren was the first scripting language we stumbled upon in the long list of non-mainstream scripting languages.

Wren claimed to be small and easy to learn. Wren also claimed to be intended for embedding in applications. Ironically, the author had no time to document how to do the embedding in the first place. When we asked for the time estimates of publishing the critical part of the documentation, we just got a reference to another issue where the other guy was asking the same question half a year ago!

That's when we ended our relationship with Wren.

Third, we evaluated Chai for the role of cross-platform scripting language.

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. We successfully managed to call a C++ function from inside Chai but failed to call a member function. We asked for help, but nobody replied.

We had to end our relationship with Chai.

Fourth, we evaluated Lua for the role of cross-platform scripting language.

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 C API chapter we had no clue how to inherit a class inside Lua.

This led us to search for libraries that wrap Lua C API syntax into something more meaningful for C++. That's how we found Sol2. Just as before, the first attempt to call a C++ member function from Lua failed. But unlike before, we asked for help and got the help! This was a refreshing surprise for us. Next, we tried to inherit a class in Lua and override the class methods. We failed, but the author helped us out again. In the end, we succeeded in inheriting a class and overriding its behaviour.

That's when we understood it's a start for a long and mutual relationship with Sol2/Lua.

This search for a scripting language taught us one important lesson: people matter, not technologies.

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.

That's it for describing scripting research in July 2017.

Изучение скриптования

2017-08-16T00:00:00+03:00

Эта статья описывает изучение скриптования в июле 2017.

Наша основная цель использования скриптового языка - это наличие платформо-независимого кода, выполняемого без изменений на каждой поддерживаемой платформе.

Редактор 0.10 использует Python в качестве подобного кода с помощью SWIG. SWIG позволяет использовать практически любой код C/C++ из языков вроде Python, Ruby, Lua, Java, C# и т.д.. SWIG помог нам впервые оценить прелесть платформо-независимого кода. К сожалению, SWIG работает лишь в одном направлении: из C/C++ в язык назначения. Это приводит к тому, что основное приложение должно быть написано на языке назначения, а код C/C++ может быть использован лишь в виде библиотеки.

Основное приложение на языке Python вполне подходит для десктопа, но не для мобилок и веба, где языки C и C++ являются единственными языками, поддерживаемыми нативно на каждой платформе. Конечно, существуют проекты вроде Kivy, которые позволяет разрабатывать кросс-платформенные приложения на Python, но они не поддерживаются нативно. Отсутствие нативной поддержки выливается в огромную головную боль при изменении API у Android и iOS.

Необходимость в приложении на C/C++ и поддержке скриптов приводит к обязательному интерпретированию скриптового языка самим приложением. Это как раз то, что SWIG, Kivy и подобные проекты не позволяют сделать.

Наша вторичная цель использования скриптового языка - это возможность расширения кода C++.

Одни модули Редактора 0.10 написаны на C++, а другие на Python. С точки зрения основного приложения, все модули равны. Для приложения нет никакой разницы, на каком языке написан конкретный модуль.

Для достижения этой гибкости мы ввели так называемое Окружение (Environment). Каждый модуль регистрирует ключи (keys), на которые он отвечает, а Окружение доставляет соответствующие сообщения. Технически такое поведение можно достигнуть с помощью наследования базового класса и переопределения его методов как в C++, так и в скриптовом языке.

Python был первым языком, который мы рассмотрели в качестве платформо-независимого скриптового языка.

Т.к. мы уже использовали Python, то логично было начать изучение с него. Мы хотели проверить, можно ли запустить код Python на каждой поддерживаемой платформе. К сожалению, результаты были удручающими, т.к. документация CPython (реализация Python, используемая по умолчанию на десктопе) никак не упоминала ни мобилки, ни веб. Всё, что мы нашли, - это пара форков CPython лохматых годов, которые якобы работают либо на Android, либо на iOS. Такой раздрай нас не устроил. Мы также рассмотрели PyPy, ещё одну реализацию Python, но она тоже не содержала информации о мобилках и вебе.

Это было чётким сигналом об отсутствии интереса к мобилками и вебу со стороны сообщества Python. Либо об отсутствии времени даже на то, чтобы описать использование Python на данных платформах. В любом случае, такое положение вещей нас не устроило.

Wren был вторым языком, который мы рассмотрели в качестве платформо-независимого скриптового языка.

Wren был первым языком из длинного списка малоизвестных скриптовых языков.

Wren преподносился как небольшой и простой язык. Согласно документации, основная цель Wren - это быть встроенным в приложение. По иронии судьбы, у автора не было времени описать в документации встраивание Wren в приложение. Когда мы спросили о сроках публикации этой критически важной части документации, мы получили в ответ ссылку на тикет, в котором другой человек спрашивал тот же самый вопрос полгода назад!

На этом мы закончили отношения с Wren.

Chai был третьим языком, который мы рассмотрели в качестве платформо-независимого скриптового языка.

Chai был в том же длинном списке малоизвестных скриптовых языков. Он преподносился как язык, специально предназначенный для встраивания в приложения C++. Мы без проблем вызвали функцию C++ из Chai, но нам не удалось вызвать метод класса. Мы попросили о помощи, но ответом была лишь тишина.

Нам пришлось завершить отношения с Chai.

Lua был четвёртым языком, который мы рассмотрели в качестве платформо-независимого скриптового языка.

Lua является популярным языком для встраивания. Мы решили попробовать очевидный вариант. Документация выглядела многообещающе, однако под конец чтения главы C API у нас не было ни малейшего представления, как наследовать класс C++ в Lua.

Этот вопрос заставил нас найти библиотеку, которая смогла бы на него ответить: Sol2. Первая попытка вызвать функцию C++ из Lua провалилась. Правда, на этот раз наш вопрос был услышан, и мы получили ответ! Мы были сильно удивлены. Далее мы попытались наследовать класс C++ в Lua, чтобы переопределить методы класса. Нам это не удалось с первого раза, но автор Sol2 снова помог нам.

В тот момент мы поняли, что это начало долгого и взаимовыгодного сотрудничества с Sol2/Lua.

Поиск скриптового языка открыл для нас следующую истину: люди важнее технологий.

Существует множество скриптовых языков, которые выглядят привлекательно на первый взгляд, но которые мертвы. Почему? Потому что у некоторых авторов нет времени на пользователей. В ответ пользователи предпочитают не тратить своё время на проекты подобных авторов.

На этом мы заканчиваем описание изучения скриптования в июле 2017.

OpenSceneGraph cross-platform guide

2017-07-17T00:00:00+03:00

This article summarizes the work we did to produce OpenSceneGraph cross-platform guide.

June marked the finish of OpenSceneGraph cross-platform guide with the publishing of the last (initially planned) tutorial. The tutorial describes how to build and run sample OpenSceneGraph application in Web using Emscripten. In case you missed it, here's a link to the final application. Open it in your web browser.

We started to compose the guide in February when we successfully managed to render a simple model on mobile and web. We spent 120 hours in five months to produce ten tutorials of the guide.

We have been doing OpenSceneGraph cross-platform guide for two main reasons:

Keep OpenSceneGraph cross-platform knowledge in easily accessible and reproducible form
Share the knowledge with OpenSceneGraph community to make it stronger

We believe we succeeded in both. Here's why:

The guide repository has more stars (aka "likes") than any other repository of ours
OpenSceneGraph project leader Robert Osfield said "Great work", which means a lot
The guide already has two issues

Reaching our goal of researching OpenSceneGraph cross-platform development and providing the knowledge back to the community just made us happier.

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 promised in January.

That's it for summarizing the work we did to produce OpenSceneGraph cross-platform guide.

OpenSceneGraph cross-platform guide

2017-07-17T00:00:00+03:00

Эта статья резюмирует создание кросс-платформенного руководства OpenSceneGraph.

Июнь ознаменовал собой окончание работы над кросс-платформенным руководством OpenSceneGraph. Мы опубликовали последний самоучитель (из изначально запланированных). Этот самоучитель описывает сборку и запуск примера приложения OpenSceneGraph в вебе с помощью Emscripten. Если вы упустили этот самоучитель, то вот ссылка на приложение из него. Откройте ссылку в веб-браузере.

Мы начали составление руководства в феврале, как только нам удалось отобразить простую модель на мобилках и вебе. Мы потратили 120 часов за пять месяцев на составление десяти самоучителей этого руководства.

Создание кросс-платформенного руководства OpenSceneGraph преследовало две основные цели:

Сохранить знания о кросс-платформенной работе с OpenSceneGraph в легкодоступной и воспроизводимой форме
Поделиться этим знанием с сообществом OpenSceneGraph и тем самым усилить сообщество

Мы уверены в том, что нам удалось достичь обе цели. И вот почему:

Хранилище руководства получило больше звёзд (лайков), чем любое другое наше хранилище
Robert Osfield, лидер проекта OpenSceneGraph, оценил руководство как "отличную работу"; это значит для нас многое
У руководства уже есть два тикета

В конце концов, мы просто рады тому факту, что изучили кросс-платформенную разработку с OpenSceneGraph и поделились этим знанием с сообществом.

Тем не менее, наше путешествие на этом не окончено. Используя знания руководства, мы продолжаем работу над тем, чтобы добавить в свои инструменты поддержку мобилок и веба, как мы обещали в январе.

На этом мы заканчиваем резюме о создании кросс-платформенного руководства OpenSceneGraph.

iOS tutorial

2017-06-08T10:00:00+03:00

This article describes problems we faced during the creation of iOS tutorial in May 2017.

This February 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.

Native library

The first question we had to answer was: should the sample application be part of Xcode project or be a separately built library?

We had to consider the following facts:

Xcode project can use C++ directly (thanks to Objective-C++) without stuff like JNI
- There's no need for a separate library (+ application)
- Creating a separate library is an additional work (- library)
OpenSceneGraph builds libraries
- It's easier to use standard build process (+ library)
- It's harder to create custom build process just for a single platform (- application)
OpenSceneGraph uses CMake build system, which is not supported by Xcode
- Xcode project can't include CMake files (- application)
- It's easy to create custom CMake file that includes OpenSceneGraph CMake file to build a single library (+ library)
CMake can generate Xcode project
- It's possible to create a CMake file that builds both OpenSceneGraph and the sample application (+ application)
- Xcode is the de-facto tool to create Xcode projects; it's easier to use standard build process (+ library)

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.

Refactoring

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?

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.

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.

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:

functions.h - contains reusable classless functions
main.h - contains the rest of the sample application code

Their contents differ slightly for each platform, but it's easy to see the whole picture now.

That's it for describing problems we faced during the creation of iOS tutorial in May 2017.

Самоучитель iOS

2017-06-08T10:00:00+03:00

Эта статья описывает проблемы, с которыми мы столкнулись во время создания самоучителя для iOS в мае 2017.

В феврале мы сумели отобразить простую модель под iOS за считанные дни. Это дало нам уверенность, что самоучитель для iOS мы сделаем столь же быстро. Тем не менее, реальность напомнила нам о простой вещи: быстро сделать можно лишь поделку на коленке, работающую только у самого разработчика; над логически связанным примером, работающим у всех, придётся попотеть.

Нативная библиотека

Прежде всего нам необходимо было ответить на следующий вопрос: "должен ли пример приложения быть частью проекта Xcode или отдельной библиотекой?"

Для принятия решения мы использовали следующие факты:

Проект Xcode может напрямую использовать C++ (благодаря Objective-C++) без прослоек вроде JNI
- Отдельная библиотека не нужна (+ приложение)
- Создание отдельной библиотеки - это дополнительная работа (- библиотека)
OpenSceneGraph собирается в библиотеки
- Легче использовать стандартный процесс сборки (+ библиотека)
- Создавать свой процесс сборки лишь для одной платформы сложно (- приложение)
OpenSceneGraph использует систему сборки CMake, которая не поддерживается Xcode
- Проект Xcode не может включать файлы CMake (- приложение)
- Свой файл CMake может с лёгкостью включить файл OpenSceneGraph CMake для сборки единой библиотеки (+ библиотека)
CMake может генерировать проект Xcode
- Можно создать файл CMake, который будет собирать как OpenSceneGraph, так и пример приложения (+ приложение)
- Xcode - это де-факто инструмент для создания проектов Xcode; легче использовать стандартный процесс сборки (+ библиотека)

Оценив плюсы и минусы обоих подходов, мы решили сделать библиотеку, которую можно включать в проект Xcode. Минусом данного подхода является то, что сборки приложения для симулятора и реального устройства используют разные сборки библиотеки.

Рефакторинг

Также нам пришлось ответить на ещё один вопрос: "использовать ли единую кодовую базу для всех платформ или несколько под каждую платформу?"

При создании самоучителя для Android мы использовали единую кодовую базу, т.к. она отлично работала для десктопа и Android. Когда мы начали работу над самоучителем iOS, стало ясно, что часть функционала либо работает, либо не работает на некоторых платформах. Например, один функционал может работать на десктопе и iOS, но не работать на Android. Другой функционал может работать на iOS и Android, но не работать на десктопе. Т.к. мы не хотели загрязнять код кучей #ifdef, мы решили помещать функционал, специфичный для конкретной платформы или нескольких платформ, в разные файлы. Это привело к резкому увеличению количества файлов. Такой подход хорошо подходил для повторного использования, но совершенно не годился для понимания общей картины.

В этот момент мы осознали необходимость ответа на второй вопрос. Мы напомнили себе, что главная цель примера приложения состоит в том, чтобы обучить базовым вещам OpenSceneGraph, а не создать повторно используемую библиотеку с API, который будет жить без изменений десятилетиями.

Для ответа на этот вопрос нам помог наш внутренний инструмент feature tool. С его помощью мы разделили код на несколько частей, который в итоге собирается ровно в два файла для каждой платформы:

functions.h - содержит повторно используемые бесклассовые функции
main.h - содержит остальной код приложения

Их содержимое несколько отличается для каждой из платформ, но наличие всего двух файлов позволяет увидеть общую картину.

На этом мы заканчиваем описание проблем, с которыми мы столкнулись во время создания самоучителя для iOS в мае 2017.

OpenSceneGraph sample

2017-05-12T00:00:00+03:00

This article describes creation of the tutorials for building sample OpenSceneGraph application under Linux, macOS, Windows, and Android in April 2017.

Previous tutorials described how to install OpenSceneGraph under Linux, macOS, Windows and render a model using the standard osgviewer tool. This time we worked on a sample OpenSceneGraph application that would run under Linux, macOS, Windows, and Android.

The application is very basic and has the following features:

Render window creation
Model loading
Model rendering with simple GLSL shaders
Model motion with a mouse under Linux, macOS, Windows and a finger under Android

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.

Our first successful Android build last year included hacks and non-obvious steps to make OpenSceneGraph run under Android. This time we wanted a cleaner, faster, and cheaper approach.

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.

Here's a quick rundown of the files:

GLES2 surface
Render activity to render to the surface
Native library Java interface
Native library C++ implementation
CMake file to build native library
Render activity layout
Model to display

Here's a quick rundown of the project changes:

Update Android manifest to use GLES2 and render activity
Reference native library's CMake file in the project's CMake file

OpenSceneGraph documentation suggests building OpenSceneGraph outside Android Studio with CMake. However, this approach has the following limitations:

You have to build OpenSceneGraph for each target architecture
You have to manually copy/reference built OpenSceneGraph libraries into Android Studio project

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.

That's it for describing the creation of the tutorials for building sample OpenSceneGraph application under Linux, macOS, Windows, and Android in April 2017.

Приложение OpenSceneGraph

2017-05-12T00:00:00+03:00

Эта статья описывает создание самоучителей по сборке приложения OpenSceneGraph на Linux, macOS, Windows и Android в апреле 2017.

Предыдущие самоучители описывали установку OpenSceneGraph на Linux, macOS, Windows и отображение модели с помощью стандартного инструмента osgviewer. На этот раз результатом нашей работы стало приложение OpenSceneGraph, которое работает на Linux, macOS, Windows и Android.

Приложение очень простое. Оно умеет следующее:

Создание окна для отрисовки
Загрузка модели
Отрисовка модели с помощью простых шейдеров GLSL
Перемещение модели с помощью мыши на Linux, macOS, Windows и пальца на Android

Создать самоучители для Linux, macOS, Windows было настолько простой и понятной задачей, что мы справились с ней за пару недель. Оставшуюся половину месяца мы потратили на создание самоучителя для Android.

Наша первая успешная сборка под Android в прошлом году требовала множество неочивидных телодвижений. В этот раз мы хотели получить более чистый, быстрый и дешёвый подход.

Нам это удалось. В результате всё, что нужно для работы приложения OpenSceneGraph на Android, уместилось в набор из нескольких файлов и небольших изменений для стандартного проекта Android Studio (с поддержкой C++).

Краткий перечень файлов:

Поверхность GLES2
Activity для отрисовки на этой поверхности
Интерфейс Java для нативной библиотеки
Реализация нативной библиотеки на C++
Файл CMake для сборки нативной библиотеки
Activity layout
Модель для отрисовки

Краткий перечень изменений проекта:

Обновление Android manifest для использования GLES2 и Activity
Использование файла CMake нативной библиотеки в проектном файле CMake

Документация OpenSceneGraph предполагает сборку OpenSceneGraph вне Android Studio с помощью CMake. Такой подход имеет следующие ограничения:

Ручная сборка OpenSceneGraph под каждую платформу
Ручное копирование собранных библиотек OpenSceneGraph в проект Android Studio

Наш подход включает в себя сборку OpenSceneGraph для тех платформ, для которых собирается проект Android Studio. К тому же, OpenSceneGraph используется как часть проекта, поэтому нет никакой дополнительной рутины: достаточно просто пересобрать проект, и всё готово.

На этом мы заканчиваем описание создания самоучителей по сборке приложения OpenSceneGraph на Linux, macOS, Windows и Android в апреле 2017.

It's all fine

2017-04-07T00:00:00+03:00

This article describes creation of the first four OpenSceneGraph tutorials in March 2017.

The first four OpenSceneGraph tutorials explain how to create a cube model with Blender and display the model under Linux, macOS, or Windows using OpenSceneGraph tool called osgviewer.

The whole process of creating a single tutorial turned out to be pretty daunting because it includes several tasks:

Record original video depicting one or more steps
Name the steps as clear as possible
Select the parts of the video that display the step
Remove the parts of the video that bare no value, e.g., waiting in the middle of compilation
Select a single frame to best represent current step, e.g., typing a specific command
Add a detailed description to article, why current step should have been taken
Proof-read the article
Correct typos and video timing
Review the whole video
Upload the video to YouTube with timestamps of steps for easier navigation

Some of those tasks had to be repeated multiple times until the combination of video, text, and article was clear and logical.

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.

That's it for describing creation of the first four OpenSceneGraph tutorials in March 2017.

Всё проходит хорошо

2017-04-07T00:00:00+03:00

Эта статья рассказывает о создании первых четырёх самоучителей OpenSceneGraph в марте 2017.

Первые четыре самоучителя OpenSceneGraph объясняют, как создать модель куба в Blender и затем отобразить её на Linux, macOS или Windows с помощью osgviewer, стандартного инструмента OpenSceneGraph.

Процесс создания одного самоучителя оказался довольно утомительным, т.к. он состоит из следующих задач:

Записать видео с одним или более шагами
Назвать эти шаги как можно яснее
Выбрать те части видео, которые непосредственно показывают шаг
Убрать те части видео, которые не имеют значения, например, ожидание сборки
Выбрать один кадр, лучше всего передающий смысл этого шага, например, набор команды
Добавить детальное описание в статью, почему этот шаг был необходим
Перечитать статью
Поправить опечатки и монтаж видео
Пересмотреть полное видео
Загрузить видео на YouTube с временными отметками шагов для упрощения навигации

Некоторые из этих задач приходилось повторять несколько раз до тех пор, пока комбинация видео, текста и статьи не получилась целостной.

Всего мы потратили 30 часов на создание самоучителей. В ходе их создания мы почерпнули много нового, что поможет нам улучшить обучающие материалы наших технологий в будущем. Сейчас мы ещё не в курсе, как именно эти материалы будут выглядеть, но они точно будут лучше.

На этом мы заканчиваем рассказ о создании первых четырёх самоучителей OpenSceneGraph в марте 2017.

Let's go

2017-03-16T00:00:00+03:00

In this article we describe our progress in January and February of 2017: rendering under iOS/Web and a new tutorial tool.

Rendering under iOS/Web

To our surprise, we got a simple red cube rendered under iOS and Web 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.

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.

Tutorial tool

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.

To combine text and video, we first tried OpenShot. It worked well, but we quickly saw its limitations:

Too much time is spent on adjusting time frames and animations
Project file and original resources are hard to track with VCS

Since OpenSceneGraph cross-platform guide would consist of several tutorials, we decided to automate the process. Brief research revealed a great multimedia framework called MLT, which powers OpenShot itself. With MLT we got our tutorial tool in no time.

Currently, the tutorial tool allows anyone to combine text and video using a simple text file like this:

background bg.png
text 5 Let's install Blender
video 0:6 install_blender.mp4
text 5 Installing it with apt
video 6:26 install_blender.mp4
text 5 We're still installing it
video 26:56 install_blender.mp4
text 5 Congratulations! We just finished installing Blender

This is the actual script. See the final result here.

That's it for describing our progress in January and February of 2017: rendering under iOS/Web and the new tutorial tool.

Поехали

2017-03-16T00:00:00+03:00

В этой статье мы расскажем о результатах нашей работы в январе и феврале 2017: отображении куба на iOS/Веб и нашем инструменте для создания самоучителей.

Отображение куба на iOS/Web

К нашему удивлению, мы смогли отобразить простой красный куб на iOS и Веб довольно быстро: в начале февраля. Тем не менее, это лишь начало поддержки платформ Android, iOS и Веб. Впереди нас ждёт тернистая дорога, т.к. нам предстоит сделать ещё много вещей, прежде чем мы сможем объявить о полноценной поддержке этих платформ: визуальные эффекты, скрипты Python, архивы данных.

Т.к. нам потребовалось четыре месяца для начала поддержки платформ Android, iOS и Веб, мы решили поделиться своими знаниями и помочь сообществу OpenSceneGraph. Мы напишем руководство по использованию OpenSceneGraph на ПК, мобилках и Вебе. Мы верим: чем более распространён OpenSceneGraph, тем сильнее наши собственные технологии. Как сказал Исаак Ньютон: "Если я видел дальше других, то потому, что стоял на плечах гигантов". OpenSceneGraph - наш гигант.

Инструмент для создания самоучителей

Имея за плечами опыт проведения четырёх прямых эфиров, нам стало ясно, что руководство по использованию OpenSceneGraph будет полезно лишь при наличии видео. Но голое видео способно отразить лишь то, что мы делаем, но не то, почему мы делаем именно это и именно так. Поэтому мы решили совместить видео с текстом в форме как субтитров к видео, так и отдельных статей.

Первую попытку совмещения видео с текстом мы начали с помощью OpenShot. Инструмент хороший, но с первого же дня использования стали очевидны следующие ограничения:

Настройка моментов отображения текста и анимаций занимает много времени
Файл проекта и исходные ресурсы сложно положить в систему контроля версий

Т.к. руководство по использованию OpenSceneGraph будет состоять из нескольких самоучителей, мы решили автоматизировать процесс. Быстрый поиск рассказал нам о существовании замечательного мультимедийного фреймворка MLT, который используется и в OpenShot. С помощью MLT мы быстро сделали свой инструмент для создания самоучителей.

На текущий момент наш инструмент позволяет совместить видео и текст с помощью простого текстового файла:

background bg.png
text 5 Let's install Blender
video 0:6 install_blender.mp4
text 5 Installing it with apt
video 6:26 install_blender.mp4
text 5 We're still installing it
video 26:56 install_blender.mp4
text 5 Congratulations! We just finished installing Blender

Это реальный скрипт. Конечный результат можно увидеть здесь.

На этом мы заканчиваем рассказ о результатах нашей работы в январе и феврале 2017: отображении куба на iOS/Веб и нашем инструменте для создания самоучителей.

The year of challenges

2017-01-25T00:00:00+03:00

This article describes our plans for 2017.

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:

Some people would consider this a failure. We don't. We see a chance to start low and jump high!

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. At the same time, such a harsh environment highlighted weak spots in our technologies and helped us see where to go next.

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.

And right after we get those cubes rendered on iOS, we start to work on bringing them to Web.

You got it right: we challenge ourselves with support for Android, iOS, and Web this year.

That's it for describing our plans for 2017.

Год испытаний

2017-01-25T00:00:00+03:00

Эта статья содержит наши планы на 2017 год.

Наши предыдущие планы предполагали, что сейчас у нас уже будет поддержка платформы Android. Тем не менее, у нас впереди ещё очень много работы, прежде чем мы сможем объявить о поддержке Android. Судите сами:

Кто-нибудь может посчитать это неудачей. Но не мы. Мы видим шанс начать с низкого старта и прыгнуть высоко!

Т.к. ранее мы имели опыт работы лишь с либеральным и всё прощающим настольным ПК, Android стал для нас полной неожиданностью. На каждом шагу нас ожидало наказание за фривольное использование памяти, ресурсов, графики. Чаще всего в ответ на наши действия мы получали либо падение приложения, либо пустой экран. С другой стороны, такие суровые условия высветили слабые места в наших технологиях и помогли увидеть, куда нам двигаться дальше.

В этом месяце мы начинаем работу над поддержкой платформы iOS, хотя мы лишь слегка коснулись платформы Android. Почему? Потому что намного проще отобразить эти красные кубы на iOS без предварительной полировки Android. Мы не хотим потратить месяцы на полировку Android лишь для того, чтобы позже узнать о том, что какой-либо функционал следовало делать иначе для его работы на всех поддерживаемых платформах.

Сразу после отображения этих кубов на iOS мы начнём работу над их отображением в Вебе.

Всё верно: нашей целью в этом году является поддержка платформ Android, iOS и Веб.

На этом мы заканчиваем описание наших планов на 2017 год.

Happy 2017

2016-12-31T00:00:00+03:00

Okay. It's been a hard year for everyone in the team. And it's almost over. Praise it ends! Praise the new one!

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.

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.

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.

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. 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. 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. We will. Stay tuned.

Happy 2017. Let it be simple.

Счастливого 2017-го

2016-12-31T00:00:00+03:00

Ну вот. Это был тяжелый год для всех в команде. И он почти закончен. Хвала окончанию старого! Хвала наступлению нового!

Может показаться, что наш прогресс застопорился. Три года назад мы объявили о начале нового проекта (двух, если быть точным), но до сих пор мы работаем над движком и редактором, даже не начали делать ни Shuan, ни Mahjong 2.

Если вы следили за новостями в течение года, вы знаете что мы провели несколько "живых сессий", демонстрируя в реальном времени как можно использовать наш инструментарий для создания простой игры. Каждая сессия была шагом в долгом пути к нашей цели. В процессе подготовки к ним, мы добавляли важные элементы, которые будут необходимы для создания любой игры.

Будущие сессии и демонстрации добавят даже больше, так что в будущем (надеюсь не слишком отдаленном), у нас будет все необходимое для того чтобы просто сесть и собрать планируемую игру из этих элементов.

Так что проект не умер; идея не отброшена. Очень много работы предстоит сделать, прежде чем мы можем начать делать игру. И нас только двое, занимающихся всем этим в свое свободное время. Итак, вы хотите, чтобы наша игра стала реальностью? Присоединяйтесь к нам. Вместе мы будем править галактикой. Или можете просто подождать. Мы не бросили все это несколько лет назад. Не станем и сейчас. В конце концов, есть только один способ создать годный инструмент (а это наша первоначальная цель, если вы помните) - мы должны использовать его сами. Мы будем. Следите за новостями.

Счастливого 2017-го. Пусть он будет простым.

November 2016 recap

2016-12-15T00:00:00+03:00

This article describes the start of MJIN library separation into modules.

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.

We decided to have a look at two approaches to separate MJIN into modules: build-time separation and run-time one. Build-time separation means MJIN becomes highly configurable and each platform gets specifically tailored MJIN build. Run-time separation means MJIN is divided into smaller libraries that are connected at run-time, which makes it easy to change functionality without rebuilding.

Run-time separation research.

Since run-time separation has more benefits, we started researching it first. The easiest way to achieve it was to use C API, because C ABI rules are much simpler than C++ one's.

We created a sample project consisting of the application, library, and plugin. The application has been linked to the library and used it to load the plugin. The library provided functions to register plugins and call their functions. The plugin provided functions for the library and called library functions.

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.

Build-time separation start.

We extracted the following modules from MJIN:

Android: provides Java Native Interface (JNI) to MJIN
Sound: provides access to OpenAL
UIQt: provides access to Qt UI

Sound and UIQt modules are currently statically linked into MJIN library, while Android module is already a separate library due to JNI requirements.

In the coming year, we're going to significantly restructure MJIN so that it suits as many platforms as possible.

That's it for describing the start of MJIN library separation into modules.

Ноябрь 2016 кратко

2016-12-15T00:00:00+03:00

Эта статья описывает начало разделения библиотеки MJIN на модули.

Как только мы собрали OpenSceneGraph для Android, стало очевидно, что часть функционала MJIN не нужна на Android. Например, UIQt - это основа интерфейса Редактора. Раз Редактор - это приложение для ПК, то UIQt не нужен на Android.

Мы решили рассмотреть два подхода к разделению MJIN на модули: во время сборки (build-time) и исполнения (run-time). Разделение во время сборки означает гибкую систему настроек MJIN, что позволит собирать её различно под каждую платформу. Разделение во время исполнения означает разделение MJIN на несколько небольших библиотек с последующим соединением во время исполнения, что позволит легко менять функционал без повторной сборки.

Исследование разделения во время исполнения.

Т.к. разделение во время исполнения имеет больше преимуществ, мы начали с этого подхода. Самый простой способ достичь его заключался в использовании C API, т.к. правила C ABI намного проще правил C++ ABI.

Мы создали маленький проект, включающий в себя приложение, библиотеку и плагин. Приложение было слинковано с библиотекой и использовало её для загрузки плагина. Библиотека предоставляла функции для регистрации плагина и вызывала его функции. Плагин предоставлял функции для библиотеки и вызывал её функции.

Исследование прошло на ура: проект работал в полном соответствии с нашими ожиданиями на Linux и Windows. Тем не менее, т.к. MJIN на текущий момент является большой монолитной сущностью, мы отложили применение C API до окончания разделения во время сборки.

Начало разделения во время сборки.

Мы выделили следующие модули из MJIN:

Android: предоставляет Java Native Interface (JNI) к MJIN
Sound: предоставляет доступ к OpenAL
UIQt: предоставляет доступ к Qt

Модули Sound и UIQt на текущий момент статически линкуются в MJIN, тогда как модуль Android линкуется динамически из-за ограничений JNI.

В следующем году мы изменим структуру MJIN так, чтобы её можно было легче собрать под разные платформы.

На этом мы заканчиваем статью о начале разделения библиотеки MJIN на модули.

October 2016 recap

2016-11-19T00:00:00+03:00

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.

First attempt to build OSG.

Having no prior knowledge of Android development, we grabbed the latest Android Studio and started doing beginner tutorials. We passed Java part pretty fast. Everything worked out of the box. Then came C++ part and related problems.

CMake. 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.

KVM. 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.

Chroot for Android. 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.

OSG. 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. Searching for the problem did not reveal any hint. Nobody helped us at the OSG mailing list.

We were in despair.

The search for OSG alternatives.

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).

And we found it: BabylonHX. The home page looked awesome: it rendered WebGL in the background! We thought we finally found the gem we were looking for. However, the example on the home page simply did not work.

You can probably understand our feelings at the time.

The success in building OSG.

We realized nobody would make OSG work under Android for us. We had to do it ourselves.

Since OSG 3.4 document on building for Android was very short, we no longer trusted it and headed to original OSG 3.0 document. While following it, we faced a dead link to third party dependencies. The search for an alternative download link lead us to a 2013 tutorial on building OSG 3.0 for Android.

After following the tutorial, we finally got OSG to run under Android! But there was a nuance: both OSG and Android tools used in the tutorial were ancient. In a few days, we gradually updated both OSG and Android tools to their latest versions.

During the update process, we learned two things that prevented us from having OSG to work in the first place:

Android API headers changed in NDK r12
OSG only works as a static library under Android

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.

Октябрь 2016 кратко

2016-11-19T00:00:00+03:00

Эта статья описывает, как мы потратили месяц на сборку OpenSceneGraph (OSG) под Android: первая попытка собрать OSG, поиск альтернатив OSG и успех в сборке OSG.

Первая попытка собрать OSG.

Не имея опыта разработки под Android, мы взяли последнюю версию Android Studio и начали проходить самоучители для начинающих. Java далась легко. Всё работало из коробки. Затем наступил черёд C++ и проблем.

CMake. Android Studio для работы с C++ использует собственную версию CMake, которая конфликтует с системной. Для нас это было явным сигналом о необходимости подготовить отдельное окружение разработки специально под Android.

KVM. Мы установили Ubuntu на VirtualBox. Всё шло замечательно до того момента, пока мы не запустили эмулятор Android. Оказалось, что VirtualBox не может запустить эмулятор, т.к. виртуальная машина не предоставляет виртуализацию внутри уже виртуализированного окружения.

Chroot для Android. Вспомнив о положительном опыте работы с chroot для сборки OGS Editor, мы решили поместить окружение разработки Android в chroot. После небольших настроек мы сумели запустить эмулятор Android и собрать проект C++.

OSG. К этому моменту мы считали, что собрать OSG не составит труда, но не тут-то было. Всё, что мы получили, - это падение. Предположив, что мы ошиблись где-то при первой сборке, мы решили пересобрать OSG ещё раз. И снова получили ту же ошибку. Поиск решения проблемы не дал результатов. Никто не помог нам в списке рассылок OSG.

Мы были в отчаянии.

Поиск альтернатив OSG.

Раз сообщество OSG нам не помогло, мы решили поискать альтернативный открытый проект, который мог решить наши задачи на Android (и, возможно, на других платформах).

Такой проект мы нашли: BabylonHX. Домашняя страница выглядела замечательно: она отображала WebGL в фоне! Промелькнула мысль, что мы наконец нашли алмаз. К сожалению, пример на домашней странице просто не работал.

Думаем, вы понимаете наши чувства на тот момент.

Успех в сборке OSG.

Мы осознали, что никто за нас не запустит OSG на Android. Нужно было сделать это самостоятельно.

Потеряв доверие к очень короткой документации OSG 3.4 по сборке для Android, мы решили использовать первоначальную документацию OSG 3.0. В ходе следования ей мы наткнулись на мёртвую ссылку, которая должна была содержать зависимости. Поиск альтернативной ссылки вывел нас на самоучитель 2013 года по сборке OSG 3.0 для Android.

После прохождения самоучителя мы наконец смогли запустить OSG под Android! Тем не менее, был нюанс: используемые в самоучителе версии OSG и средств разработки Android были древними. В течение нескольких дней мы постепенно довели версии OSG и средств разработки Android до последних.

В ходе этого обновления мы узнали о двух вещах, помешавших нам запустить OSG с первого раза:

Изменение заголовков Android API в NDK r12
OSG работает под Android лишь в виде статической библиотеки

На этом мы заканчиваем описание того, как мы потратили месяц на сборку OSG под Android: первая попытка собрать OSG, поиск альтернатив OSG и успех в сборке OSG.

Technology showcases

2016-10-31T00:00:00+03:00

In this article, we take another look at 2015-2016 live sessions' format and introduce a new showcase format for 2017.

2015 and 2016: live sessions.

As you know, we use live sessions to show the state of our technology and create a small functional game from scratch. We have conducted four live sessions in the past year, which gave birth to the following small games:

№	Created game	Live session date
1	Whac-a-mole	November 2015
2	Rolling ball	February 2016
3	Domino	May 2016
4	Mahjong Solitaire	September 2016

We spent four months to prepare for these live sessions. It has been an extremely useful experience for us. However, 2017 will have only 2 live sessions. Why? We want to spend more time on actual development!

2017: live sessions + technical previews.

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.

Here's an approximate schedule of technical previews and live sessions for 2017:

№	Month	Showcase type	Topic
1	January	Technical preview	Android platform support
2	April	Live session	Android game creation
3	July	Technical preview	To be announced
4	October	Live session	To be announced

That's it for taking another look at 2015-2016 live sessions' format and introducing the new showcase format for 2017.

Демонстрации технологий

2016-10-31T00:00:00+03:00

Сегодня мы ещё раз взглянем на формат демонстраций в 2015-2016 годах, а также сообщим о новом формате 2017-го.

2015 и 2016: демонстрации в прямом эфире.

Как вы знаете, в ходе демонстраций мы в прямом эфире показываем состояние наших технологий и собираем небольшую работающую игру с нуля. За прошедший год мы провели 4 демонстрации в прямом эфире, в ходе которых создали следующие небольшие игры:

№	Созданная игра	Дата демонстрации в прямом эфире
1	Поймай крота	Ноябрь 2015
2	Катящийся мяч	Февраль 2016
3	Домино	Май 2016
4	Пасьянс Маджонг	Сентябрь 2016

На подготовку ко всем 4-м демонстрациям у нас ушло 4 месяца. Это был очень полезный для нас опыт. Тем не менее, в 2017-м году мы ограничимся лишь двумя такими демонстрациями. Почему? Потому что мы будем тратить больше времени непосредственно на разработку!

2017: демонстрации в прямом эфире + технические анонсы.

Место двух демонстраций займут технические анонсы. Технический анонс - это тоже демонстрация прогресса наших технологий, но без создания игр в прямом эфире.

Примерный календарь технических анонсов и демонстраций на 2017-й год выглядит следующим образом:

№	Месяц	Вид демонстрации	Тема
1	Январь	Технический анонс	Поддержка платформы Android
2	Апрель	Демонстрация в прямом эфире	Создание игры для Android
3	Июль	Технический анонс	Будет объявлено позднее
4	Октябрь	Демонстрация в прямом эфире	Будет объявлено позднее

На этом мы заканчиваем рассказ о формате демонстраций в 2015-2016 годах, а также о новом формате 2017-го.

September 2016 recap

2016-10-11T00:00:00+03:00

This article explains September 2016 live session stages: draft, rehearsal, live session itself, and publishing.

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.

Draft. Game creation for the first time.

Purposes:
- test our technologies and fix major bugs;
- discover usability issues to fix in the next development iteration;
- list exact steps to reproduce the game later;
- create draft version of the game assets (models, textures, sounds, scripts).
Upon stage completion, we announce live session date and show you the game preview.
Rehearsal. Game recreation.

Purposes:
- make sure we have no major bugs left;
- record the whole process of the game creation;
- create final game assets.
This is 99% the game we publish later.
Live session. Reassembling the game live in front of you.

Purposes:
- show how easy it is to create a game;
- walk you through nuances of game creation;
- get feedback from you;
- answer your questions.
We take game assets from the rehearsal and use them to quickly reassemble the game in just a few hours.
Publishing. The release of our technologies' last version, live session materials, and stand alone game.

That's it for explaining September 2016 live session stages: draft, rehearsal, live session itself, and publishing.

Сентябрь 2016 кратко

2016-10-11T00:00:00+03:00

Эта статья описывает стадии по подготовке и проведению прямого эфира сентября 2016: черновик, репетиция, прямой эфир и публикация.

Несмотря на то, что сам прямой эфир длится лишь несколько часов, мы готовимся к нему целый месяц. Рассмотрим каждую стадию прямого эфира подробнее.

Черновик. Создание игры в первый раз.

Цели:
- проверить наши технологии и исправить основные ошибки;
- узнать о неудобствах использования технологий, чтобы исправить их в следующей итерации разработки;
- перечислить точные шаги для воссоздания игры позже;
- создать черновой вариант ресурсов игры (модели, текстуры, звуки, скрипты).
После завершения стадии мы объявляем о дате прямого эфира и показываем примерный вид игры.
Репетиция. Повторное создание игры.

Цели:
- убедиться в отсутствии основных ошибок;
- записать полный процесс создания игры;
- создать финальный вариант ресурсов игры.
Это 99% публикуемой позже игры.
Прямой эфир. Воссоздание игры в прямом эфире.

Цели:
- показать простоту создания игр;
- объяснить нюансы создания игр;
- получить обратную связь от вас;
- ответить на ваши вопросы.
Мы используем ресурсы из репетиции, чтобы быстро воссоздать игру за считанные часы.
Публикация. Выпуск последней версии наших технологий, материалов прямого эфира и самостоятельной игры.

На этом мы заканчиваем описание стадий по подготовке и проведению прямого эфира сентября 2016: черновик, репетиция, прямой эфир и публикация.

OGS Editor 0.10 and live session materials

2016-10-03T00:00:00+03:00

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.

OGS Editor 0.10 is available at SourceForge. Simply unpack the archive and launch the run script.
Mahjong Solitaire game is available at SourceForge, too. Simply unpack the archive and launch the run script.
Live session project is available at GitHub.
Live session recording is available at YouTube. The video depicts the whole process of creating Mahjong Solitaire from scratch using rehearsal project resources.

OGS Editor 0.10 и материалы прямого эфира

2016-10-03T00:00:00+03:00

Внимание: мы не выпустим версию 0.10 для macOS из-за технических проблем с системой сборки. Поддержку macOS вернём к 0.11.

OGS Editor 0.10 доступен на SourceForge. Просто распакуйте архив и запустите скрипт run.
Пасьянс маджонг тоже доступен на SourceForge. Просто распакуйте архив и запустите скрипт run.
Проект прямого эфира доступен на GitHub.
Запись прямого эфира доступна на YouTube. Видео содержит весь процесс создания пасьянса маджонг с использованием ресурсов проекта-репетиции.

A few words about live session yesterday

2016-09-26T00:00:00+03:00

Mahjong Solitaire was successfully created, and it took less than 4 hours. We will publish live session materials later this week.

Thank you for joining us.

Пара слов о вчерашнем прямом эфире

2016-09-26T00:00:00+03:00

Создание пасьянса Маджонг прошло успешно, и заняло менее 4 часов. Мы опубликуем материалы прямого эфира чуть позже на этой неделе.

Спасибо за участие.

Live session is in 24 hours

2016-09-24T00:00:00+03:00

Get ready for live session, it's about to happen in 24 hours!

Прямой эфир через 24 часа

2016-09-24T00:00:00+03:00

Приготовьтесь к прямому эфиру, он начнётся через 24 часа!

Live session: 25 September 2016

2016-09-17T00:00:00+03:00

We will hold live session on 25 September 2016 at 12:00 CEST It's time to create simple Mahjong solitaire game.

Прямой эфир: 25 сентября 2016

2016-09-17T00:00:00+03:00

25 сентября 2016 в 13:00 MSK мы проведём прямой эфир. Самое время создать простой пасьянс Маджонг

August 2016 recap

2016-09-03T00:00:00+03:00

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.

UIQt module is a collection of UI components backed by Qt. We only use it for Editor UI at the moment.

Here is a list of UIQt module components with their description and current code size:

№	Component	Description	Size (B)	Size (%)
1	UIQtAction	Actions (events) for menus	11224	9
2	UIQtAux	Initializes Qt and main window. Provides widget resolution by name to other components	15518	12
3	UIQtDock	Widget docks	5273	4
4	UIQtFileDialog	File selection dialogs	8960	7
5	UIQtMenu	Menus for main window and pop-ups (like node's add/copy/paste/delete menu)	4566	3
6	UIQtMenuBar	Menu bar for main window	4222	3
7	UIQtRunner	Allows to start QApplication	2450	2
8	UIQtThumbnailDialog	Dialog with thumbnail images	18615	14
9	UIQtToolBar	Tool bar for main window	4276	3
10	UIQtTree	Provides complex widgets like Scene tree and Property browser	51216	39
11	UIQtWidget	Common widget properties like focus and visibility	5465	4

UIQt module refactoring 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.

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.

Feature based development approach 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 quantitative complexity manifestation.

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.

Here is a list of current UIQtTree features:

№	Feature	Description	Size (B)	Size (%)
1	Base	Allows to construct item hierarchy, modify it, and display it	26966	52
2	Item open state	Keeps track of collapsed/expanded item properties	3094	6
3	Item renaming	Allows to rename an item	3471	7
4	Item selection	Allows to get/set selected item	2338	5
5	Item value	Provides 2nd and the rest columns for items, used by Property browser	1307	3
6	Item value editing	Allows to edit item values with a default editor widget	1996	4
7	Item value editing with combobox	Provides combobox editor	5819	11
8	Item value editing with spinner	Provides spinbox editor	5290	10
9	Menu	Provides pop-up menu	1248	2

Here's an example of UIQtTree Menu feature file: TREE_MENU.

Benefits of the approach include:

Faster code reading/understanding due to small size
Easier and safer modification due to isolated code

There's a drawback, too: new approach requires learning.

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.

Август 2016 кратко

2016-09-03T00:00:00+03:00

Эта статья описывает самые важные технические детали разработки за август: модуль UIQt, его переработку, новый подход к разработке на основе функционала и его преимущества.

Модуль UIQt - это коллекция компонент UI на основе Qt. Сейчас используем лишь для интерфейса редактора.

Список компонент модуля UIQt с описанием и размером кода:

№	Компонента	Описание	Размер (Б)	Размер (%)
1	UIQtAction	Действия (события) для меню	11224	9
2	UIQtAux	Инициализирует Qt и главное окно. Предоставляет поиск виджета по имени для других компонент	15518	12
3	UIQtDock	Виджет стыковки	5273	4
4	UIQtFileDialog	Диалог выбора файла	8960	7
5	UIQtMenu	Меню для главного окна и на ПКМ (вроде меню по добавлению/копированию/вставке/удалению узла)	4566	3
6	UIQtMenuBar	Панель меню для главного окна	4222	3
7	UIQtRunner	Позволяет запустить QApplication	2450	2
8	UIQtThumbnailDialog	Диалог с изображениями	18615	14
9	UIQtToolBar	Панель инструментов для главого окна	4276	3
10	UIQtTree	Предоставляет сложные виджеты вроде Дерева сцены и Редактора свойств	51216	39
11	UIQtWidget	Общие свойства виджетов вроде фокуса и видимости	5465	4

Мы переработали модуль UIQt для замены старого State API на новый Environment API, который позволяет делать то же самое лаконичнее, т.е. упрощает и ускоряет разработку.

Переработку начали в июле и должны были закончить в том же месяце. Тем не менеe, работы завершили лишь в августе. Начальный план предполагал, что 28 часов должно хватить, но мы потратили 65. Мы оценивали необходимое время на основе количества вызовов публичного API каждой компоненты. Это хорошо сработало для небольших компонент, т.к. число вызовов их публичного API было примерно равно количеству их функционала, а сам функционал был очень маленький. Однако такой подход полностью провалился для компонеты UIQtTree, составляющей 39% кода модуля UIQt, потому что не было прямой связи между публичным API и функционалом.

Новый подход к разработке на основе функционала родился после решения проблем с переработкой UIQtTree. Т.к. Qt использует MVC, компонента UIQtTree состоит из нескольких классов. К тому моменту, когда UIQtTree могла отображать и управлять иерархией элементов, компонента уже имела размер в 27К. Мы заметили, что UIQtTree стала потреблять непомерное количество времени разработки даже для мелкого функционала. Это было явным проявлением количественной сложности.

Мы решили разбить UIQtTree на базовую часть и дополнительные. База содержит лишь необходимый минимум кода. Дополнение содержит код, специфичный для данного функционала, и может быть безболезненно изменено. В случае UIQtTree, отображение и управление иерархией элементов - это минимальный функционал, а переименование элементов - это дополнение.

Текущий функционал UIQtTree состоит из следующих возможностей:

№	Функционал	Описание	Размер (Б)	Размер (%)
1	Base	Создание, изменение, отображение иерархии элементов	26966	52
2	Item open state	Хранит состояние свойства скрыто/отображено элемента	3094	6
3	Item renaming	Переименование элемента	3471	7
4	Item selection	Получение/установка выбранного элемента	2338	5
5	Item value	Предоставляет второй и последующие столбцы для элементов, используется Редактором свойств	1307	3
6	Item value editing	Редактирование значений элемента с помощью стандартного виджета	1996	4
7	Item value editing with combobox	Редактирование значений элемента с помощью виджета combobox	5819	11
8	Item value editing with spinner	Редактирование значений элемента с помощью виджета spinbox	5290	10
9	Menu	Меню на ПКМ	1248	2

Пример файла функционала Menu для UIQtTree: TREE_MENU.

Преимущества подхода:

Более быстрое чтение/понимание благодаря небольшому размеру
Более простое и безболезненное изменение благодаря изолированному коду

Есть и недостаток: новый подход требует изучения.

На этом мы заканчиваем описание самых важных технических деталей разработки за август: модуль UIQt, его переработку, новый подход к разработке на основе функционала и его преимущества.

We’re back to social networks

2016-08-18T00:00:00+03:00

If you follow us on Facebook, Twitter, or VK 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.

Мы вернулись в социальные сети

2016-08-18T00:00:00+03:00

Если вы подписаны на нашу группу в Facebook, Twitter или VK, вы заметили, что мы начали использовать её снова. Это не случайно: мы наконец созрели для вербального общения после 4 лет молчаливой разработки.

Подписывайтесь!

Once Mahjong – always Mahjong

2016-08-10T00:00:00+03:00

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.

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.

Upon the game release we got it: Tools are means to save development time.

We spent 4 more years to develop them. Now is the time to prove they are worth every single day spent. How? We will recreate Mahjong solitaire mode in just a few hours!

Join our next live session in September.

Раз Маджонг – всегда Маджонг

2016-08-10T00:00:00+03:00

Мы начали проект Opensource Game Studio очень давно. Мы хотели дать сообществу свободного программного обеспечения средства для создания игр. Правда, тогда не было ясно, что они из себя должны представлять. Поэтому решили начать с малого: создать игру.

Мы потратили 3 года для достижения этой цели: выпуск OGS Mahjong 1.0 состоялся в 2012 году. Даже для хобби-проекта (мы тратим в среднем около 40 часов в месяц) это очень долго.

После выпуска игры до нас дошло: Средства для создания игр должны экономить время разработки.

Мы потратили ещё 4 года на их разработку. Пришло время доказать, что они стоят каждого затраченного дня. Как? Мы воссоздадим режим "пасьянс Маджонг" за считанные часы!

Присоединяйтесь к нашему следующему прямому эфиру в сентябре.

May 2016 live session materials

2016-05-29T00:00:00+03:00

This time we have shown how to create a simple Domino based game. Below you can find all materials related to the game creation.

Editor 0.9 for Linux (Debian based), OS X (10.9+), Windows is available at SourceForge. Simply unpack it and launch the run script.
Domino project created during live session is available at GitHub.
Domino rehearsal videos referenced during live session are available at YouTube
Domino rehearsal project referenced during live session is available at GitHub.

The next live session will be held in September 2016.

Материалы прямого эфира за май 2016

2016-05-29T00:00:00+03:00

В этот раз мы показали, как создать простую игру на основе Домино. Ниже приведены все материалы, связанные с созданием игры.

Редактор 0.9 для Linux (на основе Debian), OS X (10.9+), Windows доступен на SourceForge. Просто распакуйте и запустите скрипт run.
Проект Домино, созданный во время прямого эфира доступен на GitHub.
Видео репетиции создания игры, на которые есть ссылки в прямом эфире, доступны на YouTube
Проект Домино, созданный во время репетиции, доступен на GitHub.

Live session: 28 May 2016

2016-05-17T00:00:00+03:00

We're glad to annouce that the LiveCoding session will take place on 28 May 2016 at 12:00 CEST. Join us!

Прямой эфир: 28 мая 2016

2016-05-17T00:00:00+03:00

Мы рады сообщить, что трансляция LiveCoding состоится 28 мая 2016 в 13:00 MSK. Присоединяйтесь!

May live session (Editor 0.9)

2016-04-24T00:00:00+03:00

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.

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.

Here's a short preview of the coming game:

Майский прямой эфир (Редактор 0.9)

2016-04-24T00:00:00+03:00

Как вы знаете, ранее опубликованная дорожная карта предполагала, что в апреле будет прямой эфир, в котором с помощью Редактора 0.9 мы создадим игру пинг-понг.

Мы должны признать, что наши способности к планированию всё ещё недостаточно высоки, поэтому следующий прямой эфир состоится в конце мая. Точную дату мы объявим позже.

Вот пара моментов из будущей игры:

"Rolling ball" live session videos and downloads

2016-02-10T00:00:00+03:00

Since we held 2 live sessions to create "Rolling ball" game, here are 2 YouTube videos of the process:

"Rolling ball" game for Linux (Debian based), OS X (10.9+), Windows is available at SourceForge. Simply unpack it and launch the run script.

Editor 0.8 is available at SourceForge, too.

"Rolling ball" project for the Editor is available at GitHub.

To open it in the Editor:

replace slideDown.ogs with rollingBall.ogs you downloaded
rename rollingBall.ogs to slideDown.ogs

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.

Запись прямого эфира "Катящийся мяч" и материалы

2016-02-10T00:00:00+03:00

Т.к. мы провели 2 прямые трансляции для создания игры "Катящийся мяч", ниже вы можете увидеть 2 записи этого процесса на YouTube:

Игра "Катящийся мяч" для Linux (на основе Debian), OS X (10.9+), Windows доступна на SourceForge. Просто распакуйте и запустите скрипт 'run'.

Редактор 0.8 доступен тоже на SourceForge.

Проект "Катящийся мяч" для Редактора доступен на GitHub.

Чтобы открыть его в Редакторе:

замените slideDown.ogs загруженным rollingBall.ogs
переименуйте rollingBall.ogs в slideDown.ogs

Т.к. прямой эфир занял гораздо больше времени, чем мы планировали, мы решили сконцентрировать свои усилия на улучшении удобства редактора. Его возможности уже довольно обширны, но использовать их крайне неудобно. Наиболее серьезные из этих проблем мы планируем исправить в следующем релизе Редактора.

Game creation live session (part 2): 7 February 2016

2016-02-02T00:00:00+03:00

Unfortunately, we have failed to finish creation of the simple "Rolling ball" game in 3 hours. That's why we will hold the second LiveCoding session on 7 February 2016 at 12:00 CET. Let's finish the game!

Создание игры в прямом эфире (часть 2): 7 февраля 2016

2016-02-02T00:00:00+03:00

К сожалению, нам не удалось завершить создание простой игры "Катящийся мяч" за 3 часа. Поэтому вторая часть трансляции LiveCoding состоится 7 февраля 2016 в 14:00 MSK. Давайте завершим игру!

Game creation live session: 31 January 2016

2016-01-25T00:00:00+03:00

We're glad to annouce that the LiveCoding session will take place on 31 January 2016 at 12:00 CET. Join us!

Создание игры в прямом эфире: 31 января 2016

2016-01-25T00:00:00+03:00

Мы рады сообщить, что трансляция LiveCoding состоится 31 января 2016 в 14:00 MSK. Присоединяйтесь!

SOON: Creating a simple game live (Editor 0.8)

2016-01-21T00:00:00+03:00

We are ready to present Editor 0.8 with Player. The live session will be held at LiveCoding SOON. We will show you how to create a simple game with sounds from scratch. And this time it will not need an Editor to run. The exact date and time is to be announced in the coming days. Stay tuned!

СКОРО: Создание простой игры в прямом эфире (Редактор 0.8)

2016-01-21T00:00:00+03:00

Мы готовы предоставить вам Редактор 0.8 с Проигрывателем. Прямая трансляция будет проведена на LiveCoding СКОРО. Мы покажем вам, как создать простую игру со звуком с нуля. И на этот раз она не будет требовать Редактора для работы. Точную дату и время мы объявим в ближайшие дни. Оставайтесь на связи …

Roadmap for 2016

2015-12-26T00:00:00+03:00

As you know, according to the previously published roadmap, we now have sound system in place. However, we decided to go further and implement the first version of Player. We wanted to get it done by December, but, unfortunately, more work resulted in the change of dates.

Here's the revised roadmap for the first half of 2016:

Editor + Player 0.8.0 (January 2016): Sound system, Whac-a-mole game with sounds
Editor + Player 0.9.0 (April 2016): Networking system, simple ping pong game for 2 players over the net
Editor + Player 0.10.0 (July 2016): Polishing, "Shuan" prototype

Дорожная карта 2016

2015-12-26T00:00:00+03:00

Как вы знаете, согласно ранее опубликованной дорожной карте, мы добавили звуковую систему. Тем не менее, мы решили пойти дальше и создать первую версию Проигрывателя. Мы хотели завершить его в декабре, но, к сожалению, изменение планов вылилось в изменение сроков.

Представляем вам обновлённую дорожную карту на первую половину 2016:

Редактор + Проигрыватель 0.8.0 (Январь 2016): Звуковая система, игра "Поймай крота" со звуком
Редактор + Проигрыватель 0.9.0 (Апрель 2016): Сетевая система, простая игра ping pong для двух игроков по сети
Редактор + Проигрыватель 0.10.0 (Июль 2016): Полировка, прототип игры "Шуан"

Live session video and downloads

2015-11-15T00:00:00+03:00

If you missed the live session, you can watch it here: https://www.livecoding.tv/video/kornerr/playlists/whac-a-mole-from-scratch/

You can download the resulting project here: https://github.com/OGStudio/liveSessionWhacAMole/archive/master.zip

The latest editor can be found here: http://sourceforge.net/projects/osrpgcreation/files/Editor/jenkins/42_2015-11-13_08-16-46_0.7.4/

Download the editor archive, unpack, delete the wam.ogs folder, copy wam.ogs from the live session archive to the editor folder.

in Windows - run the run.bat file.
in Linux and OSX - run the run file.

Видеозапись живой сессии и материалы

2015-11-15T00:00:00+03:00

Если вы пропустили живую сессию, вы можете посмотреть ее здесь: https://www.livecoding.tv/video/kornerr/playlists/whac-a-mole-from-scratch/

Проект, созданный в ходе сессии, можно скачать здесь: https://github.com/OGStudio/liveSessionWhacAMole/archive/master.zip

Последняя версия редактора доступна здесь: http://sourceforge.net/projects/osrpgcreation/files/Editor/jenkins/42_2015-11-13_08-16-46_0.7.4/

Скачайте редактор, разархивируйте, удалите папку wam.ogs из редактора, скопируйте папку wam.ogs из архива живой сессии в папку редактора.

в Windows - запустите файл run.bat.
в Linux и OSX - запустите файл run.

Creating a simple game live: 15 November 2015

2015-11-09T00:00:00+03:00

We're glad to annouce that the LiveCoding session will take place on 15 November 2015 at 12:00 CET. Join us!

Создание простой игры в прямом эфире: 15 ноября 2015

2015-11-09T00:00:00+03:00

Мы рады сообщить, что трансляция LiveCoding состоится 15 ноября 2015 в 14:00 MSK. Присоединяйтесь!

SOON: Creating a simple game live (Editor 0.7)

2015-11-02T00:00:00+03:00

As we have promised, we are ready to give you Editor 0.7 which is capable of creating the complete test chamber. However, after recreating the test chamber ourselves, it became clear that:

it takes more than 8 hours to recreate it (too long)
it's inappropriate to be presented in the form of an article (too boring)

Therefore we decided to hold a live session at LiveCoding SOON to show you how to create a simple whac-a-mole like game from scratch.

Currently we are busy making final preparations, so we'll tell you the exact time and date this week. Stay tuned!

СКОРО: Создание простой игры в прямом эфире (Редактор 0.7)

2015-11-02T00:00:00+03:00

Как и было обещано, мы готовы предоставить вам Редактор 0.7, с помощью которого можно создать тестовый цех. Тем не менее, после воссоздания цеха стало ясно, что:

это занимает более 8 часов (слишком долго)
описание в виде статьи не подходит по формату (слишком скучно)

Поэтому мы решили провести прямую трансляцию на LiveCoding СКОРО, чтобы показать, как создать простую игру типа "поймай крота" с нуля.

Сейчас мы заняты последними приготовлениями, поэтому точные дату и время мы сообщим на этой неделе. Оставайтесь на связи!

Desura no more, hello Humble Bundle Widget

2015-07-23T00:00:00+03:00

After the recent bankruptcy of Desura's parent company, we decided, that we need a new place for our Deluxe version. Something better, more modern and more trustworthy. We have chosen the Humble Widget, with which you can buy the deluxe version of the game without leaving our site.

Here it is:

We haven't received a single penny from Desura (due to the minimal cache out limitations), but if you bought the deluxe version from them and experiencing any problems with downloading it (right now we see no problems with that), send us a letter, tell your name on Desura, we'll figure something out.

Прощай, Desura. Здравствуй, Humble Bundle Widget

2015-07-23T00:00:00+03:00

После недавнего банкротства родительской компании сервиса Desura мы пришли к выводу, что нам необходима новая площадка для распространения Deluxe-версии игры. Более современная, удобная, надежная. Наш выбор пал на Humble Widget, благодаря которому вы можете приобрести Deluxe-версию игры прямо у нас на сайте.

Вот он:

К сожалению, мы не получили от Desura ни копейки (из-за минимального порога вывода средств, которого мы не достигли), однако, если вы приобретали Deluxe-версию OGS Mahjong на Desura и испытываете проблемы с ее скачиванием (в настоящее время проблем не обнаружено), напишите нам, указав свое имя на Desura, и мы что-нибудь придумаем.

Test chamber for everyone (Editor 0.7.0)

2015-07-22T00:00:00+03:00

As you know, the main goal of Editor 0.7.0 is the ability to create the test chamber with it. It needs Actions' system and a few stability fixes for that. We are going to publish a detailed article describing how to create the test chamber, too, so that anyone could create their own test chamber!

We estimate to complete it in October.

Тестовый цех каждому (Редактор 0.7.0)

2015-07-22T00:00:00+03:00

Как вы знаете, основная цель Редактора 0.7.0 - это возможность создать тестовый цех с помощью него. Редактору не хватает системы Действий и исправления некоторых ошибок для этого. Помимо выпуска Редактора мы опубликуем подробную статью, описывающую создание тестового цеха, чтобы каждый мог создать себе свой тестовый цех!

Мы планируем завершить его в Октябре.

Roadmap for 2015-2016

2015-07-19T00:00:00+03:00

As promised, we have come up with a list of milestones and their approximate dates for the coming year:

Editor 0.7.0 (October 2015) - Actions' system: we recreate the test chamber
Editor 0.8.0 (December 2015) - Sound system
Editor 0.9.0 (February 2016) - Particles' system and minimal UI
Editor 0.10.0, Player 0.1.0 (April 2016) - Player to play what Editor produced: we create Shuan prototype with our engine
Editor 0.11.0, Player 0.2.0 (June 2016) - Networking: we create Classic 4-player Mahjong prototype

These approximate dates presume one coder spends 40 hours a month. That's about 1 work week at full-time job. Not much, but that's the only time we have.

We will post more details about Editor 0.7.0 shortly: we need to decide what features deserve 80 hours of our time for the next 2 months.

Дорожная карта 2015-2016

2015-07-19T00:00:00+03:00

Как и было обещано, мы составили список вех и их примерные даты на ближайший год:

Редактор 0.7.0 (Октябрь 2015) - Система действий: мы воссоздаём тестовый цех
Редактор 0.8.0 (Декабрь 2015) - Звуковая система
Редактор 0.9.0 (Февраль 2016) - Система частиц и минимальный интерфейс пользователя (UI)
Редактор 0.10.0, Проигрыватель 0.1.0 (Апрель 2016) - Проигрыватель воспроизводит созданное Редактором: мы создаём прототип Шуана на нашем движке
Редактор 0.11.0, Проигрыватель 0.2.0 (Июнь 2016) - Поддержка сети: мы создаём прототип классического Маджонга для 4-х игроков

Эти примерные даты предполагают трату 40 часов в месяц одним программистом. Это около 1 рабочей недели. Не много, но это всё время, что у нас есть.

Мы сообщим больше деталей о Редакторе 0.7.0 чуть позже: нам нужно решить, какие возможности заслуживают 80 часов нашего времени в следующие 2 месяца.

Editor 0.6.0

2015-06-28T00:00:00+03:00

We completed Editor 0.6.0. You can see 0.6.0 in action here.

Editor 0.6.0 got the following new features:

Camera and light node positioning
Node rotation along X axis
Node scripting support
Thumbnail dialog to preview models when editing scene node model properties
Node copying and pasting
Node selection by LMB click in the scene
Window geometry and state restoration after restart

We don't have 0.7.0 completion date at the moment, because we decided to take some time to set up a roadmap for Shuan and Mahjong 2. Once done, we will share 0.7.0 completion date and its feature list along with the roadmap.

Редактор 0.6.0

2015-06-28T00:00:00+03:00

Мы завершили работу над версией 0.6.0 редактора. Вы можете увидеть 0.6.0 в действии здесь.

Список новых возможностей Редактора 0.6.0:

Позиционирование узлов с камерой и светом
Вращение узлов по оси X
Поддержка скриптов у узлов
Диалог для предпросмотра моделей при редактировании моделей у узла
Копирование и вставка узлов
Выбор узла с помощью клика мышью в сцене
Восстановление позиции и состояния окна после перезапуска

На текущий момент у нас нет даты завершения 0.7.0, потому что мы решили взять паузу и потратить некоторое время на составление дорожной карты для Shuan и Mahjong 2. Как только мы её закончим, мы расскажем и о возможностях 0.7.0, и о дате завершения 0.7.0, и о самой дорожной карте.

Editor 0.5.0 and plans for 0.6.0

2015-04-15T00:00:00+03:00

We completed Editor 0.5.0. As it was planned, it has scene node tree editing, property browser, and Qt5 support. You can see 0.5.0 in action here.

Also, we have just started Editor 0.6.0 development.

Editor 0.6.0 planned features:

Camera node editing
Light node editing
Node rotation editing
Node scripting support
Thumbnail dialog to preview materials and models when editing scene node material and model properties
Copying and pasting of scene nodes
Scene node selection by clicking a mouse in the scene

We estimate to complete it in August.

Редактор 0.5.0 и планы для 0.6.0

2015-04-15T00:00:00+03:00

Мы завершили работу над версией 0.5.0 редактора. Как было запланировано, эта версия содержит редактирование узлов сцены, браузер свойств, поддеркжу Qt5. Вы можете увидеть 0.5.0 в действии здесь.

Также мы только что начали разработку Редактора 0.6.0.

Запланированные возможности Редактора 0.6.0:

Редактирование узлов с камерой
Редактирование узлов со светом
Редактирование вращения узлов
Поддержка скриптов у узлов
Диалог для предпросмотра моделей и материалов при редактировании моделей и материалов у узла
Копирование и вставка узлов
Выбор узла с помощью клика мышью в сцене

Мы планируем завершить его в августе.