threejs-kotlin

Recently I started learn Kotlin js and based on Nicolas article I've wanted to try out Kotlin transpiling ability.

This is a Three.js bindings for Kotlin using external modifiers and based on Three.js r84 with working examples.

Usage

git clone https://github.com/Pozo/threejs-kotlin
cd threejs-kotlin
./gradlew examples:run
xdg-open http://localhost:8088

Kotlin JS and javascript modules

If you would like to use any javascript library with Kotlin, you can try several ways. According to the Kotlin Language Documentation:

ts2kt

"To access third-party frameworks with a strongly-typed API, you can convert TypeScript definitions from the Definitely Typed type definitions repository to Kotlin using the ts2kt tool."

With ts2kt you can try out the following libraries:

• DefinitelyTyped/types/three
• kontan/three.d.ts
• selbyk/three.ts

external modifier

"To tell Kotlin that a certain declaration is written in pure JavaScript, you should mark it with external modifier. When the compiler sees such a declaration, it assumes that the implementation for the corresponding class, function or property is provided by the developer, and therefore does not try to generate any JavaScript code from the declaration. This means that you should omit bodies of external declarations."

There are a few existing solutions based on this method.

• ClassicThunder/Kotlin_ThreeJS
• michael-johansen/kotlin-three.js

Goals

• strongly-typed API

more details later, play with example and discover the code! :smiley_cat:

Licensing

Please see the file called LICENSE.

Links

Kotlin related

• Kotlin JavaScript overview
• Kotlin JavaScript modules
• kotlinjs-frontend-plugin
• Nicolas Fränkel - Creating a simple Google Maps using Kotlin (an example using external modifier)

Three.js

• Three.js homepage
• Three.js repository
• Three.js hello-world (codepen)

Contact

Zoltan Polgar - [email protected]

Please do not hesitate to contact me if you have any further questions.