Skip to content

bmwcarit/ramses-sample-app

Repository files navigation

Ramses sample app

Car

This application demonstrates the usage of the Ramses rendering engine alongside a 3D vehicle model of a BMW X5 (2018). The application is written in Kotlin and the vehicle resource is built using the Ramses Composer GUI v1.3.0. You can find a modifiable project with the car on Github.

For further guidance look at the tutorial which explains how to write an App using Ramses.

To automatically create and place the binaries of your Ramses Composer project into the apps assets folder use the Ramses Gradle Plugin. The configuration part is already added to this app in the app level build.gradle file, you just need to update the information according to your setup. If you want to learn how the Ramses Gradle plugin is used correctly look at the corresponding tutorial.

The app has two UI fragments. The first fragment shows a surface with 3D view of a BMW X5 model. The second fragment shows a static logo image. It is possible to mix Ramses 3D content with other Android UI elements in various ways. Be creative!

Please refer to the Ramses Website for further materials and information on the Ramses Project.

License

The application source code is under the MPL 2.0 license, the same license as the Ramses AAR, Ramses itself and the Ramses Logic.

The digital car model is licensed under CC-BY-4.0 (see the source repository).

The binary files of the digital car model that are located in the apps asset folder are also licensed under CC-BY-4.0 (see the source repository).