模型可视化>> ramses>> 返回
项目作者： GENIVI

项目描述 ：
A distributed system for rendering 3D content with focus on bandwidth and resource efficiency
高级语言： C++
项目地址: git://github.com/GENIVI/ramses.git
创建时间： 2018-09-05T12:28:59Z
项目社区：https://github.com/GENIVI/ramses
开源协议：Mozilla Public License 2.0
下载


Table of Contents

What is RAMSES

RAMSES is 3D rendering engine with focus on bandwidth and resource efficiency.
For a broader overview and introduction to the ecosystem and tools, visit our
homepage.

Have a look at our showcase video: RAMSES Distributed Rendering Engine Showcase Video

Obtaining the source code

RAMSES can be cloned from its BMW Car IT repository using git:

  1. git clone --recurse-submodules https://github.com/bmwcarit/ramses <ramses-sdk>

Build instructions

General building tips: RAMSES’s build system is based on CMake. It has
mandatory components and optional components which are built only if
required dependencies and/or CMake flags are present. The CMake log will
provide info what was built and what not - a ‘plus’ indicating that something
was built, and ‘minus’ that it wasn’t. If an optional component was not built,
CMake will list the missing dependencies which were not found or not built.
Check the CMake logs! Typical build errors:

  • not able to find a compiler -> Check that you have a valid compiler!
  • not able to find something in external/ folder -> Check that you downloaded the submodules as shown in section 2.)
  • CMake can’t identify the compiler of Visual studio Community edition -> You need to download a Windows SDK 8.1
  • No renderer was built on linux -> Check that you have installed some of the platform packages (x11-dev, egl, openGL, wayland)

Building RAMSES on Windows:

  • start CMake GUI
  • select as source path, choose arbitrary folder.
    Configure
    If you want to build the tests, set ‘ramses-sdk_BUILD_TESTS’ to true in the CMake cache.
    generate -> open solution in Visual Studio.

Building RAMSES on Linux with docker:

We prefer to build RAMSES in Docker because it abstracts the dependency installation
and the CMake invocations away from the user. Docker is installed slightly differently
on different distros, check the docker manual for your distro. The instructions below
are for Ubuntu 20.04 LTS:

  1. apt install docker.io
  2. groupadd docker             #can fail if already exists
  3. usermod –aG docker $USER
  4. newgrp docker               #logs you into the new group in the current terminal session
  6. docker run hello-world      #check that docker works
  8. # build RAMSES docker container
  9. cd <ramses-sdk>/scripts/docker
  10. ./build-basic-container.sh
  11. # Start RAMSES docker
  12. ./start-basic-for-x11.sh    # (on wayland-enabled systems, optionally: ./start-basic-for-wayland.sh)
  13. # Inside docker container
  14. ./build-ramses.sh
  15. # optionally - check if all RAMSES features work on your system
  16. ./run-unittests.sh

Building RAMSES on Linux (without docker):

-Install dependencies using Distro of choice package manager. For example, for Ubuntu:

  1. sudo apt-get install libx11-dev libgles2-mesa-dev
  2. mkdir <build>
  3. cd <build>
  4. cmake <ramses-sdk>

You can also check the docker container setup scripts for a reference how to build:

  1. <ramses-sdk>/scripts/docker/ramses-basic/Dockerfile         -> contains info about build dependencies
  2. <ramses-sdk>/scripts/docker/runtime-files/build-ramses.sh   -> contains CMake command for building

License

RAMSES original code is copyright BMW Car IT or BMW AG

Copyright (C) 20xx BMW Car IT GmbH or Copyright (C) 20xx BMW AG

The source code is licensed under the Mozilla Public License 2.0, please find a
copy of that license in the LICENSE.txt file.

RAMSES makes use of several open source libraries which can be found in the folder ‘external’.
Some of these are shipped directly with the sourcecode, others are included as git submodule references.
RAMSES also includes some assets (e.g. font files) which are licensed under different open source licenses.

Directly included:

  • cityhash (Licensed under MIT License)
  • Khronos Headers (Licensed under Khronos Group License)
  • lodepng (Licensed under zlib License)
  • Wayland-IVI Extension (Licensed under MIT License)
  • wayland-zwp-linux-dmabuf-v1-extension (Licensed under MIT License)
  • Wayland-IVI example client (Licensed under MIT License)

Submodule reference:

  • Freetype 2 (Licensed under FTL, also containing code under BSD and ZLib)
  • GLSLang (Licensed under BSD-3 and Khronos Group License)
  • OpenGL Mathematics (Licensed under MIT License)
  • Googletest (Licensed under BSD-3)
  • Google Benchmark (Licensed under Apache-2.0)
  • Harfbuzz (Licensed under MIT and ISC; see external/harfbuzz/COPYING)
  • Asio (Boost Software License - Version 1.0)
  • LZ4 (Licensed under BSD-2; see also external/lz4/LICENSE for more details)
  • {fmt} (Licensed under MIT License)
  • ImGui (Licensed under MIT License)
  • Abseil (Licensed under Apache 2.0; see also external/abseil/LICENSE for more details)
  • CLI11 (Licensed under BSD-3)
  • Lua (Licensed under MIT)
  • Sol (Licensed under MIT)
  • Flatbuffers (Licensed under Apache-2.0)
  • Webkit ANGLE (Licensed under BSD-3)

Included Assets:

  • Roboto Font (Licensed under Apache 2.0)
  • M+ Font (Licensed under Public Domain)
  • WenQuanYi MicroHei (Licensed under Apache 2.0)
  • Arimo Font (Licensed under Apache 2.0)
  • Droid Kufi Font (Licensed under Apache 2.0)
  • Droid Naskh Font (Licensed under Apache 2.0)
  • Satisfy Font (Licensed under Apache 2.0)
  • Noto Sans Thai Font (Licensed under SIL Open Font License 1.1)