diff --git a/2017-07-openscenegraph-guide.png b/2017-07-openscenegraph-guide.png new file mode 100644 index 0000000..9c4b13b Binary files /dev/null and b/2017-07-openscenegraph-guide.png differ diff --git a/archives.html b/archives.html index c0f3def..79dcd7d 100644 --- a/archives.html +++ b/archives.html @@ -49,6 +49,10 @@ + + + + diff --git a/author/opensource-game-studio.html b/author/opensource-game-studio.html index b4d3014..25065ef 100644 --- a/author/opensource-game-studio.html +++ b/author/opensource-game-studio.html @@ -48,50 +48,30 @@
-

iOS tutorial

 -
Thu 08 June 2017 - ru - -

iOS tutorial

-

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:

+

OpenSceneGraph cross-platform guide

 +
Sat 01 July 2017 + ru + +

OpenSceneGraph guide

+

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:

    -
  1. 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)
      • -
    -
    2. -
  2. 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)
      • -
    -
    3. -
  3. 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)
      • -
    -
    4. -
  4. 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)
      • -
    -
    5. +
  5. Keep OpenSceneGraph cross-platform knowledge in easily accessible and reproducible form
    6. +
  6. Share the knowledge with OpenSceneGraph community to make it stronger
-

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:

+

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

    -
  1. functions.h - contains reusable classless functions
    2. -
  2. main.h - contains the rest of the sample application code
    3. +
  3. The guide repository has more stars (aka "likes") than any other repository of ours
    4. +
  4. OpenSceneGraph project leader Robert Osfield said "Great work", which means a lot
    5. +
  5. The guide already has two issues
-

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.

Category: News +

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.

Category: News

@@ -105,6 +85,25 @@ +
+

iOS tutorial

 +
Thu 08 June 2017 + ru + +

iOS tutorial

+

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 …

Category: News + +

+ + + Read More +
+
+ + + +

Pelican review
Sat 03 June 2017 @@ -247,24 +246,6 @@ to get up and running real fast.

- - - -
-

kr4

 -
Sun 01 January 2017 - ru - -

kr4

-

LANG: en

Category: Review - -

- - - Read More -
-
-
Page 1 of 2
diff --git a/author/opensource-game-studio2.html b/author/opensource-game-studio2.html index a9fedcf..821d4bb 100644 --- a/author/opensource-game-studio2.html +++ b/author/opensource-game-studio2.html @@ -48,6 +48,24 @@ + + + + +

kr3
Sun 01 January 2017 diff --git a/category/news.html b/category/news.html index ed91944..fe0614d 100644 --- a/category/news.html +++ b/category/news.html @@ -47,6 +47,44 @@ +
+

OpenSceneGraph cross-platform guide

 +
Sat 01 July 2017 + ru + +

OpenSceneGraph guide

+

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:

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

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

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

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.

Category: News + +

+ + +
+ + +
+ + + + +

iOS tutorial
Thu 08 June 2017 @@ -54,50 +92,16 @@

iOS tutorial

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:

-
    -
  1. 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)
      • -
    -
    2. -
  2. 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)
      • -
    -
    3. -
  3. 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)
      • -
    -
    4. -
  4. 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)
      • -
    -
    5. -
-

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:

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

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.

Category: News +

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 …

Category: News

+ Read More +
+
Page 1 of 1
@@ -106,10 +110,6 @@

- - - -
diff --git a/feeds/all.atom.xml b/feeds/all.atom.xml index b42d7e5..b47621b 100644 --- a/feeds/all.atom.xml +++ b/feeds/all.atom.xml @@ -1,5 +1,49 @@ -Opensource Game Studiohttps://ogstudio.github.io/2017-06-08T10:00:00+07:00iOS tutorial2017-06-08T10:00:00+07:002017-06-08T10:00:00+07:00Opensource Game Studiotag:ogstudio.github.io,2017-06-08:/ios-tutorial.html<p><img alt="iOS tutorial" src="https://ogstudio.github.io/2017-06-08-ios-refactoring.png"></p> +Opensource Game Studiohttps://ogstudio.github.io/2017-07-01T00:00:00+07:00OpenSceneGraph cross-platform guide2017-07-01T00:00:00+07:002017-07-01T00:00:00+07:00Opensource Game Studiotag:ogstudio.github.io,2017-07-01:/openscenegraph-cross-platform-guide.html<p><img alt="OpenSceneGraph guide" src="https://ogstudio.github.io/2017-07-openscenegraph-guide.png"></p> +<p>This article summarizes the work we did to produce OpenSceneGraph cross-platform guide.</p> +<p>June marked the finish of <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide">OpenSceneGraph cross-platform guide</a> with the publishing of the last (initially planned) tutorial. The tutorial describes <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/tree/master/1.10.SampleWeb">how to build and run sample OpenSceneGraph application in Web</a> using Emscripten. +In case you missed it, here's …</p><p><img alt="OpenSceneGraph guide" src="https://ogstudio.github.io/2017-07-openscenegraph-guide.png"></p> +<p>This article summarizes the work we did to produce OpenSceneGraph cross-platform guide.</p> +<p>June marked the finish of <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide">OpenSceneGraph cross-platform guide</a> with the publishing of the last (initially planned) tutorial. The tutorial describes <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/tree/master/1.10.SampleWeb">how to build and run sample OpenSceneGraph application in Web</a> using Emscripten. +In case you missed it, here's a <a href="https://ogstudio.github.io/openscenegraph-cross-platform-guide/">link to the final application</a>. Open it in your web browser.</p> +<p>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.</p> +<p>We have been doing OpenSceneGraph cross-platform guide for two main reasons:</p> +<ol> +<li>Keep OpenSceneGraph cross-platform knowledge in easily accessible and reproducible form</li> +<li>Share the knowledge with OpenSceneGraph community to make it stronger</li> +</ol> +<p>We believe we succeeded in both. Here's why:</p> +<ol> +<li>The guide repository has more <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/stargazers">stars</a> (aka "likes") than any other repository of ours</li> +<li>OpenSceneGraph project leader Robert Osfield said <a href="http://www.mail-archive.com/osg-users@lists.openscenegraph.org/msg74815.html">"Great work"</a>, which means a lot</li> +<li>The guide already has <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/issues">two issues</a></li> +</ol> +<p>Reaching our goal of researching OpenSceneGraph cross-platform development and providing the knowledge back to the community just made us happier.</p> +<p>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 <a href="http://opengamestudio.org/lang/en/news/2456">promised in January</a>.</p> +<p>That's it for summarizing the work we did to produce OpenSceneGraph cross-platform guide.</p>OpenSceneGraph cross-platform guide2017-07-01T00:00:00+07:002017-07-01T00:00:00+07:00Opensource Game Studiotag:ogstudio.github.io,2017-07-01:/openscenegraph-cross-platform-guide-ru.html<p><img alt="OpenSceneGraph guide" src="https://ogstudio.github.io/2017-07-openscenegraph-guide.png"></p> +<p>Эта статья резюмирует создание кросс-платформенного руководства OpenSceneGraph.</p> +<p>Июнь ознаменовал собой окончание работы над <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide">кросс-платформенным руководством OpenSceneGraph</a>. Мы опубликовали последний самоучитель (из изначально запланированных). Этот самоучитель описывает <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/tree/master/1.10.SampleWeb">сборку и запуск примера приложения OpenSceneGraph в вебе</a> с помощью Emscripten. +Если вы упустили этот самоучитель, то вот <a href="https://ogstudio.github.io/openscenegraph-cross-platform-guide/">ссылка на приложение</a> из него. Откройте …</p><p><img alt="OpenSceneGraph guide" src="https://ogstudio.github.io/2017-07-openscenegraph-guide.png"></p> +<p>Эта статья резюмирует создание кросс-платформенного руководства OpenSceneGraph.</p> +<p>Июнь ознаменовал собой окончание работы над <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide">кросс-платформенным руководством OpenSceneGraph</a>. Мы опубликовали последний самоучитель (из изначально запланированных). Этот самоучитель описывает <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/tree/master/1.10.SampleWeb">сборку и запуск примера приложения OpenSceneGraph в вебе</a> с помощью Emscripten. +Если вы упустили этот самоучитель, то вот <a href="https://ogstudio.github.io/openscenegraph-cross-platform-guide/">ссылка на приложение</a> из него. Откройте ссылку в веб-браузере.</p> +<p>Мы начали составление руководства в феврале, как только нам удалось отобразить простую модель на мобилках и вебе. +Мы потратили 120 часов за пять месяцев на составление десяти самоучителей этого руководства.</p> +<p>Создание кросс-платформенного руководства OpenSceneGraph преследовало две основные цели:</p> +<ol> +<li>Сохранить знания о кросс-платформенной работе с OpenSceneGraph в легкодоступной и воспроизводимой форме</li> +<li>Поделиться этим знанием с сообществом OpenSceneGraph и тем самым усилить сообщество</li> +</ol> +<p>Мы уверены в том, что нам удалось достичь обе цели. И вот почему:</p> +<ol> +<li>Хранилище руководства получило больше <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/stargazers">звёзд</a> (лайков), чем любое другое наше хранилище</li> +<li>Robert Osfield, лидер проекта OpenSceneGraph, оценил руководство как <a href="http://www.mail-archive.com/osg-users@lists.openscenegraph.org/msg74815.html">"отличную работу"</a>; это значит для нас многое</li></li> +<li>У руководства уже есть <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/issues">два тикета</a></li> +</ol> +<p>В конце концов, мы просто рады тому факту, что изучили кросс-платформенную разработку с OpenSceneGraph и поделились этим знанием с сообществом.</p> +<p>Тем не менее, наше путешествие на этом не окончено. Используя знания руководства, мы продолжаем работу над тем, чтобы добавить в свои инструменты поддержку мобилок и веба, как мы <a href="http://opengamestudio.org/lang/ru/news/2456">обещали в январе</a>.</p> +<p>На этом мы заканчиваем резюме о создании кросс-платформенного руководства OpenSceneGraph.</p>iOS tutorial2017-06-08T10:00:00+07:002017-06-08T10:00:00+07:00Opensource Game Studiotag:ogstudio.github.io,2017-06-08:/ios-tutorial.html<p><img alt="iOS tutorial" src="https://ogstudio.github.io/2017-06-08-ios-refactoring.png"></p> <p>This article describes problems we faced during the creation of iOS tutorial in May 2017.</p> <p><a href="https://twitter.com/OpenGameStudio/status/826816343433498627">This February</a> 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 …</p><p><img alt="iOS tutorial" src="https://ogstudio.github.io/2017-06-08-ios-refactoring.png"></p> <p>This article describes problems we faced during the creation of iOS tutorial in May 2017.</p> diff --git a/feeds/news.atom.xml b/feeds/news.atom.xml index 109bd4d..3c32ded 100644 --- a/feeds/news.atom.xml +++ b/feeds/news.atom.xml @@ -1,5 +1,27 @@ -Opensource Game Studio - Newshttps://ogstudio.github.io/2017-06-08T10:00:00+07:00iOS tutorial2017-06-08T10:00:00+07:002017-06-08T10:00:00+07:00Opensource Game Studiotag:ogstudio.github.io,2017-06-08:/ios-tutorial.html<p><img alt="iOS tutorial" src="https://ogstudio.github.io/2017-06-08-ios-refactoring.png"></p> +Opensource Game Studio - Newshttps://ogstudio.github.io/2017-07-01T00:00:00+07:00OpenSceneGraph cross-platform guide2017-07-01T00:00:00+07:002017-07-01T00:00:00+07:00Opensource Game Studiotag:ogstudio.github.io,2017-07-01:/openscenegraph-cross-platform-guide.html<p><img alt="OpenSceneGraph guide" src="https://ogstudio.github.io/2017-07-openscenegraph-guide.png"></p> +<p>This article summarizes the work we did to produce OpenSceneGraph cross-platform guide.</p> +<p>June marked the finish of <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide">OpenSceneGraph cross-platform guide</a> with the publishing of the last (initially planned) tutorial. The tutorial describes <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/tree/master/1.10.SampleWeb">how to build and run sample OpenSceneGraph application in Web</a> using Emscripten. +In case you missed it, here's …</p><p><img alt="OpenSceneGraph guide" src="https://ogstudio.github.io/2017-07-openscenegraph-guide.png"></p> +<p>This article summarizes the work we did to produce OpenSceneGraph cross-platform guide.</p> +<p>June marked the finish of <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide">OpenSceneGraph cross-platform guide</a> with the publishing of the last (initially planned) tutorial. The tutorial describes <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/tree/master/1.10.SampleWeb">how to build and run sample OpenSceneGraph application in Web</a> using Emscripten. +In case you missed it, here's a <a href="https://ogstudio.github.io/openscenegraph-cross-platform-guide/">link to the final application</a>. Open it in your web browser.</p> +<p>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.</p> +<p>We have been doing OpenSceneGraph cross-platform guide for two main reasons:</p> +<ol> +<li>Keep OpenSceneGraph cross-platform knowledge in easily accessible and reproducible form</li> +<li>Share the knowledge with OpenSceneGraph community to make it stronger</li> +</ol> +<p>We believe we succeeded in both. Here's why:</p> +<ol> +<li>The guide repository has more <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/stargazers">stars</a> (aka "likes") than any other repository of ours</li> +<li>OpenSceneGraph project leader Robert Osfield said <a href="http://www.mail-archive.com/osg-users@lists.openscenegraph.org/msg74815.html">"Great work"</a>, which means a lot</li> +<li>The guide already has <a href="https://github.com/OGStudio/openscenegraph-cross-platform-guide/issues">two issues</a></li> +</ol> +<p>Reaching our goal of researching OpenSceneGraph cross-platform development and providing the knowledge back to the community just made us happier.</p> +<p>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 <a href="http://opengamestudio.org/lang/en/news/2456">promised in January</a>.</p> +<p>That's it for summarizing the work we did to produce OpenSceneGraph cross-platform guide.</p>iOS tutorial2017-06-08T10:00:00+07:002017-06-08T10:00:00+07:00Opensource Game Studiotag:ogstudio.github.io,2017-06-08:/ios-tutorial.html<p><img alt="iOS tutorial" src="https://ogstudio.github.io/2017-06-08-ios-refactoring.png"></p> <p>This article describes problems we faced during the creation of iOS tutorial in May 2017.</p> <p><a href="https://twitter.com/OpenGameStudio/status/826816343433498627">This February</a> 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 …</p><p><img alt="iOS tutorial" src="https://ogstudio.github.io/2017-06-08-ios-refactoring.png"></p> <p>This article describes problems we faced during the creation of iOS tutorial in May 2017.</p> diff --git a/index.html b/index.html index aca43f1..178d4a9 100644 --- a/index.html +++ b/index.html @@ -48,50 +48,30 @@
-

iOS tutorial

 -
Thu 08 June 2017 - ru - -

iOS tutorial

-

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:

+

OpenSceneGraph cross-platform guide

 +
Sat 01 July 2017 + ru + +

OpenSceneGraph guide

+

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:

    -
  1. 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)
      • -
    -
    2. -
  2. 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)
      • -
    -
    3. -
  3. 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)
      • -
    -
    4. -
  4. 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)
      • -
    -
    5. +
  5. Keep OpenSceneGraph cross-platform knowledge in easily accessible and reproducible form
    6. +
  6. Share the knowledge with OpenSceneGraph community to make it stronger
-

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:

+

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

    -
  1. functions.h - contains reusable classless functions
    2. -
  2. main.h - contains the rest of the sample application code
    3. +
  3. The guide repository has more stars (aka "likes") than any other repository of ours
    4. +
  4. OpenSceneGraph project leader Robert Osfield said "Great work", which means a lot
    5. +
  5. The guide already has two issues
-

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.

Category: News +

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.

Category: News

@@ -105,6 +85,25 @@ +
+

iOS tutorial

 +
Thu 08 June 2017 + ru + +

iOS tutorial

+

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 …

Category: News + +

+ + + Read More +
+
+ + + +

Pelican review
Sat 03 June 2017 @@ -247,24 +246,6 @@ to get up and running real fast.

- - - - -
Page 1 of 2
diff --git a/index2.html b/index2.html index ed10a92..0987448 100644 --- a/index2.html +++ b/index2.html @@ -48,6 +48,24 @@ + + + + +

kr3
Sun 01 January 2017 diff --git a/openscenegraph-cross-platform-guide-ru.html b/openscenegraph-cross-platform-guide-ru.html new file mode 100644 index 0000000..1a2faa0 --- /dev/null +++ b/openscenegraph-cross-platform-guide-ru.html @@ -0,0 +1,131 @@ + + + + + + + OpenSceneGraph cross-platform guide + + + + + + + + + + + + + + + + + + + + +
+ + +
+
+
+

OpenSceneGraph cross-platform guide

+
+ +
Sat 01 July 2017 + en + +

OpenSceneGraph guide

+

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

+

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

+

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

+

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

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

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

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

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

+

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

+

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

+

Category: News + +

+ + + +
+
+ + + + + +
+ + + +
+
+
+
+
+

Proudly powered by Pelican, which takes great advantage of Python.

+
+
+
+
\ No newline at end of file diff --git a/openscenegraph-cross-platform-guide.html b/openscenegraph-cross-platform-guide.html new file mode 100644 index 0000000..f0f2080 --- /dev/null +++ b/openscenegraph-cross-platform-guide.html @@ -0,0 +1,131 @@ + + + + + + + OpenSceneGraph cross-platform guide + + + + + + + + + + + + + + + + + + + + +
+ + +
+
+
+

OpenSceneGraph cross-platform guide

+
+ +
Sat 01 July 2017 + ru + +

OpenSceneGraph guide

+

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:

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

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

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

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.

+

Category: News + +

+ + + +
+
+ + + + + +
+ + + + \ No newline at end of file
Sat 01 July 2017OpenSceneGraph cross-platform guide
Thu 08 June 2017 iOS tutorial