RAMSES Documentation  27.0.130
Information for RAMSES users and developers
ramses-example-local-displays/src/main.cpp

Example of a local client plus renderer and two displays

// -------------------------------------------------------------------------
// Copyright (C) 2014 BMW Car IT GmbH
// -------------------------------------------------------------------------
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at https://mozilla.org/MPL/2.0/.
// -------------------------------------------------------------------------
#include "ramses-client.h"
#include <unordered_set>
#include <thread>
{
public:
void windowClosed(ramses::displayId_t /*displayId*/) override
{
m_windowClosed = true;
}
bool isWindowClosed() const
{
return m_windowClosed;
}
private:
bool m_windowClosed = false;
};
uint64_t nowMs()
{
auto now = std::chrono::system_clock::now();
return std::chrono::time_point_cast<std::chrono::milliseconds>(now).time_since_epoch().count();
}
{
//client scene
ramses::Scene* clientScene = client.createScene(sceneId, ramses::SceneConfig(), "local displays example scene");
//fill scene with content, i.e. use high level api
// every scene needs a render pass with camera
auto* camera = clientScene->createPerspectiveCamera("my camera");
camera->setViewport(0, 0, 1280u, 480u);
camera->setFrustum(19.f, 1280.f / 480.f, 0.1f, 1500.f);
camera->setTranslation(0.0f, 0.0f, 5.0f);
ramses::RenderPass* renderPass = clientScene->createRenderPass("my render pass");
renderPass->setCamera(*camera);
ramses::RenderGroup* renderGroup = clientScene->createRenderGroup();
renderPass->addRenderGroup(*renderGroup);
// prepare triangle geometry: vertex position array and index array
float vertexPositionsArray[] = { -1.f, 0.f, -6.f, 1.f, 0.f, -6.f, 0.f, 1.f, -6.f };
ramses::ArrayResource* vertexPositions = clientScene->createArrayResource(ramses::EDataType::Vector3F, 3, vertexPositionsArray);
uint16_t indicesArray[] = { 0, 1, 2 };
ramses::ArrayResource* indices = clientScene->createArrayResource(ramses::EDataType::UInt16, 3, indicesArray);
// create an appearance for red triangle
effectDesc.setVertexShaderFromFile("res/ramses-local-displays-test.vert");
effectDesc.setFragmentShaderFromFile("res/ramses-local-displays-test.frag");
ramses::Effect* effect = clientScene->createEffect(effectDesc, ramses::ResourceCacheFlag_DoNotCache, "glsl shader");
ramses::Appearance* appearance = clientScene->createAppearance(*effect, "triangle appearance");
ramses::GeometryBinding* geometry = clientScene->createGeometryBinding(*effect, "triangle geometry");
geometry->setIndices(*indices);
ramses::AttributeInput positionsInput;
effect->findAttributeInput("a_position", positionsInput);
geometry->setInputBuffer(positionsInput, *vertexPositions);
effect->findUniformInput("color", colorInput);
// create a mesh node to define the triangle with chosen appearance
ramses::MeshNode* meshNode = clientScene->createMeshNode("triangle mesh node");
meshNode->setAppearance(*appearance);
meshNode->setGeometryBinding(*geometry);
// mesh needs to be added to a render group that belongs to a render pass with camera in order to be rendered
renderGroup->addMeshNode(*meshNode);
// create splines with animation keys
ramses::SplineLinearFloat* spline1 = animationSystem->createSplineLinearFloat("spline1");
spline1->setKey(0u, 0.f);
spline1->setKey(5000u, 500.f);
spline1->setKey(10000u, 1000.f);
// create animated property for each translation node with single component animation
// create three animations
ramses::Animation* animation1 = animationSystem->createAnimation(*animProperty1, *spline1, "animation1");
// create animation sequence and add animation
ramses::AnimationSequence* sequence = animationSystem->createAnimationSequence();
sequence->addAnimation(*animation1);
// set animation properties (optional)
sequence->setAnimationLooping(*animation1);
sequence->setPlaybackSpeed(5.f);
// start animation sequence
animationSystem->updateLocalTime(nowMs());
sequence->start();
appearance->setInputValueVector4f(colorInput, 1.0f, 1.0f, 0.3f, 1.0f);
return clientScene;
}
{
//client scene
ramses::Scene* clientScene = client.createScene(sceneId, ramses::SceneConfig(), "local displays example scene");
//fill scene with content, i.e. use high level api
// every scene needs a render pass with camera
auto* camera = clientScene->createPerspectiveCamera("my camera");
camera->setViewport(0, 0, 1280u, 480u);
camera->setFrustum(19.f, 1280.f / 480.f, 0.1f, 1500.f);
camera->setTranslation(0.0f, 0.0f, 5.0f);
ramses::RenderPass* renderPass = clientScene->createRenderPass("my render pass");
renderPass->setCamera(*camera);
ramses::RenderGroup* renderGroup = clientScene->createRenderGroup();
renderPass->addRenderGroup(*renderGroup);
// prepare triangle geometry: vertex position array and index array
float vertexPositionsArray[] = { -1.1f, 0.f, -6.1f, 1.1f, 0.f, -6.1f, 0.f, 1.1f, -6.1f };
ramses::ArrayResource* vertexPositions = clientScene->createArrayResource(ramses::EDataType::Vector3F, 3, vertexPositionsArray);
uint16_t indicesArray[] = { 2, 0, 1 };
ramses::ArrayResource* indices = clientScene->createArrayResource(ramses::EDataType::UInt16, 3, indicesArray);
// create an appearance for red triangle
effectDesc.setVertexShaderFromFile("res/ramses-local-displays-test.vert");
effectDesc.setFragmentShaderFromFile("res/ramses-local-displays-test.frag");
ramses::Effect* effect = clientScene->createEffect(effectDesc, ramses::ResourceCacheFlag_DoNotCache, "glsl shader");
ramses::Appearance* appearance = clientScene->createAppearance(*effect, "triangle appearance");
ramses::GeometryBinding* geometry = clientScene->createGeometryBinding(*effect, "triangle geometry");
geometry->setIndices(*indices);
ramses::AttributeInput positionsInput;
effect->findAttributeInput("a_position", positionsInput);
geometry->setInputBuffer(positionsInput, *vertexPositions);
effect->findUniformInput("color", colorInput);
// create a mesh node to define the triangle with chosen appearance
ramses::MeshNode* meshNode = clientScene->createMeshNode("triangle mesh node");
meshNode->setAppearance(*appearance);
meshNode->setGeometryBinding(*geometry);
// mesh needs to be added to a render group that belongs to a render pass with camera in order to be rendered
renderGroup->addMeshNode(*meshNode);
// create splines with animation keys
ramses::SplineLinearFloat* spline1 = animationSystem->createSplineLinearFloat("spline1");
spline1->setKey(0u, 0.f);
spline1->setKey(5000u, -500.f);
spline1->setKey(10000u, -1000.f);
// create animated property for each translation node with single component animation
// create three animations
ramses::Animation* animation1 = animationSystem->createAnimation(*animProperty1, *spline1, "animation1");
// create animation sequence and add animation
ramses::AnimationSequence* sequence = animationSystem->createAnimationSequence();
sequence->addAnimation(*animation1);
// set animation properties (optional)
sequence->setAnimationLooping(*animation1);
sequence->setPlaybackSpeed(5.f);
// start animation sequence
animationSystem->updateLocalTime(nowMs());
sequence->start();
appearance->setInputValueVector4f(colorInput, 1.0f, 0.0f, 0.5f, 1.0f);
return clientScene;
}
int main(int argc, char* argv[])
{
//Ramses client
ramses::RamsesFrameworkConfig config(argc, argv);
config.setRequestedRamsesShellType(ramses::ERamsesShellType_Console); //needed for automated test of examples
ramses::RamsesFramework framework(config);
ramses::RamsesClient& client(*framework.createClient("ramses-local-client-test"));
// Ramses renderer
ramses::RendererConfig rendererConfig(argc, argv);
ramses::RamsesRenderer& renderer(*framework.createRenderer(rendererConfig));
auto& sceneControlAPI = *renderer.getSceneControlAPI();
framework.connect();
ramses::sceneId_t sceneId1(1u);
ramses::Scene* scene1 = createScene1(client, sceneId1);
scene1->flush();
scene1->publish();
ramses::sceneId_t sceneId2(2u);
ramses::Scene* scene2 = createScene2(client, sceneId2);
scene2->flush();
scene2->publish();
// IMPORTANT NOTE: For simplicity and readability the example code does not check return values from API calls.
// This should not be the case for real applications.
// Create displays and map scenes to them
ramses::DisplayConfig displayConfig1(argc, argv);
const ramses::displayId_t display1 = renderer.createDisplay(displayConfig1);
sceneControlAPI.setSceneMapping(sceneId1, display1);
sceneControlAPI.setSceneState(sceneId1, ramses::RendererSceneState::Rendered);
sceneControlAPI.flush();
ramses::DisplayConfig displayConfig2(argc, argv);
//ivi surfaces must be unique for every display
displayConfig2.setWaylandIviSurfaceID(ramses::waylandIviSurfaceId_t(displayConfig1.getWaylandIviSurfaceID().getValue() + 1));
const ramses::displayId_t display2 = renderer.createDisplay(displayConfig2);
renderer.flush();
sceneControlAPI.setSceneMapping(sceneId2, display2);
sceneControlAPI.setSceneState(sceneId2, ramses::RendererSceneState::Rendered);
sceneControlAPI.flush();
renderer.startThread();
renderer.flush();
//ramses::RamsesRenderer::setMaximumFramerate(renderer, 60, display1);
std::this_thread::sleep_for(std::chrono::milliseconds(10000));
RendererEventHandler eventHandler;
while (!eventHandler.isWindowClosed())
{
renderer.dispatchEvents(eventHandler);
std::this_thread::sleep_for(std::chrono::milliseconds(1000));
std::this_thread::sleep_for(std::chrono::milliseconds(1000));
std::this_thread::sleep_for(std::chrono::milliseconds(1000));
}
}
Definition: main.cpp:24
void windowClosed(ramses::displayId_t) override
This method will be called when a display's window has been closed.
Definition: main.cpp:26
bool isWindowClosed() const
Definition: main.cpp:31
The AnimatedProperty holds a reference to data that can be animated.
Definition: AnimatedProperty.h:20
The AnimationSequence is a container for multiple animations. AnimationSequence has its own virtual t...
Definition: AnimationSequence.h:26
status_t start(timeMilliseconds_t offset=0)
Starts the sequence of animations. Offset can be used to postpone start if positive or start sequence...
status_t addAnimation(const Animation &animation, sequenceTimeStamp_t startTimeInSequence=0u, sequenceTimeStamp_t stopTimeInSequence=0u)
Add animation to the sequence. Animation will be placed on to sequence time line at given time stamp ...
status_t setPlaybackSpeed(float playbackSpeed)
Sets sequence playback speed affecting all animations within the sequence. Default sequence playback ...
status_t setAnimationLooping(const Animation &animation, timeMilliseconds_t loopDuration=0)
Enables animation looping. When animation reaches last spline key (or loopDuration passes) it begins ...
The AnimationSystemRealTime is a special version of AnimationSystem that is designed to use system ti...
Definition: AnimationSystemRealTime.h:33
status_t updateLocalTime(globalTimeStamp_t systemTime=0u)
Sets the local animation system to a given time. The time used should always be system time,...
AnimationSequence * createAnimationSequence(const char *name=nullptr)
Creates AnimationSequence that can hold references to multiple animations and control them together.
SplineLinearFloat * createSplineLinearFloat(const char *name=nullptr)
Creates a spline in this animation system using float data type and linear interpolation.
AnimatedProperty * createAnimatedProperty(const Node &propertyOwner, EAnimatedProperty property, EAnimatedPropertyComponent propertyComponent=EAnimatedPropertyComponent_All, const char *name=nullptr)
Create a new animated property for Node.
Animation * createAnimation(const AnimatedProperty &animatedProperty, const Spline &spline, const char *name=nullptr)
Creates Animation that can animate given property using given spline.
The Animation combines spline with one or more AnimatedProperty instances and allows control of the a...
Definition: Animation.h:22
The Appearance describes how an object should look like. This includes GLSL uniform values,...
Definition: Appearance.h:34
status_t setInputValueVector4f(const UniformInput &input, float x, float y, float z, float w)
Sets value of the input.
The ArrayResource stores a data array of a given type. The data is immutable. The resource can be use...
Definition: ArrayResource.h:26
The AttributeInput is a description of an attribute effect input.
Definition: AttributeInput.h:22
status_t setViewport(int32_t x, int32_t y, uint32_t width, uint32_t height)
Sets the viewport to be used when rendering with this camera.
The DisplayConfig holds a set of parameters to be used to initialize a display.
Definition: DisplayConfig.h:22
An effect description holds all necessary information for an effect to be created.
Definition: EffectDescription.h:21
status_t setVertexShaderFromFile(const char *shaderSourceFileName)
Reads and sets vertex shader source from file.
status_t setUniformSemantic(const char *inputName, EEffectUniformSemantic semanticType)
Sets an uniform semantic. Used for uniforms which are not locally available on the client,...
status_t setFragmentShaderFromFile(const char *shaderSourceFileName)
Reads and sets fragment shader source from file.
An effect describes how an object will be rendered to the screen.
Definition: Effect.h:26
status_t findUniformInput(const char *inputName, UniformInput &uniformInput) const
Finds uniform input by input name.
status_t findAttributeInput(const char *inputName, AttributeInput &attributeInput) const
Finds attribute input by input name.
A geometry binding together with an appearance describe how an object will be rendered to the screen.
Definition: GeometryBinding.h:25
status_t setIndices(const ArrayResource &indicesResource)
Assign a data array with data type UInt16 or UInt32 to be used when accessing vertex data.
status_t setInputBuffer(const AttributeInput &attributeInput, const ArrayResource &arrayResource, uint32_t instancingDivisor=0)
Assign a data array resource to a given effect attribute input.
The MeshNode holds all information which is needed to render an object to the screen.
Definition: MeshNode.h:25
status_t setAppearance(Appearance &appearance)
Sets the Appearance of the MeshNode.
status_t setGeometryBinding(GeometryBinding &geometry)
Sets the GeometryBinding of the MeshNode.
Entry point of RAMSES client API.
Definition: RamsesClient.h:34
Scene * createScene(sceneId_t sceneId, const SceneConfig &sceneConfig=SceneConfig(), const char *name=nullptr)
Create a new empty Scene.
The RamsesFrameworkConfig holds a set of parameters to be used to initialize ramses.
Definition: RamsesFrameworkConfig.h:23
Class representing ramses framework components that are needed to initialize an instance of ramses cl...
Definition: RamsesFramework.h:35
RamsesRenderer is the main renderer component which provides API to configure and control the way con...
Definition: RamsesRenderer.h:37
status_t setMaximumFramerate(float maximumFramerate)
Sets the maximum frame rate per second for the update/render loop when in threaded mode.
The RenderGroup is a container used to collect renderables which are supposed to be rendered together...
Definition: RenderGroup.h:31
status_t addMeshNode(const MeshNode &mesh, int32_t orderWithinGroup=0)
Add a mesh to this RenderGroup. If a mesh is already contained in this RenderGroup only its render or...
The RenderPass is a container used to collect meshes which are supposed to be rendered together.
Definition: RenderPass.h:31
status_t setCamera(const Camera &camera)
Set the camera to use for rendering the objects of this renderpass.
status_t setClearFlags(uint32_t clearFlags)
Set the clear flags which enable/disable the clearing of the render target assigned to this RenderPas...
status_t addRenderGroup(const RenderGroup &renderGroup, int32_t orderWithinPass=0)
Add a RenderGroup to this RenderPass for rendering.
The RendererConfig holds a set of parameters to be used to initialize a renderer.
Definition: RendererConfig.h:26
Convenience empty implementation of IRendererEventHandler that can be used to derive from when only s...
Definition: IRendererEventHandler.h:194
The SceneConfig holds a set of parameters to be used when creating a scene.
Definition: SceneConfig.h:22
The Scene holds a scene graph. It is the essential class for distributing content to the ramses syste...
Definition: Scene.h:83
MeshNode * createMeshNode(const char *name=nullptr)
Creates a scene graph MeshNode. MeshNode is a Node with additional properties and bindings that repre...
Effect * createEffect(const EffectDescription &effectDesc, resourceCacheFlag_t cacheFlag=ResourceCacheFlag_DoNotCache, const char *name=nullptr)
Create a new Effect by parsing a GLSL shader described by an EffectDescription instance....
GeometryBinding * createGeometryBinding(const Effect &effect, const char *name=nullptr)
Creates a new GeometryBinding.
ArrayResource * createArrayResource(EDataType type, uint32_t numElements, const void *arrayData, resourceCacheFlag_t cacheFlag=ResourceCacheFlag_DoNotCache, const char *name=nullptr)
Create a new ArrayResource. It makes a copy of the given data of a certain type as a resource,...
status_t publish(EScenePublicationMode publicationMode=EScenePublicationMode_LocalAndRemote)
Publishes the scene to the ramses system.
RenderPass * createRenderPass(const char *name=nullptr)
Create a render pass in the scene.
Appearance * createAppearance(const Effect &effect, const char *name=nullptr)
Creates a new Appearance.
RenderGroup * createRenderGroup(const char *name=nullptr)
Create a RenderGroup instance in the scene.
PerspectiveCamera * createPerspectiveCamera(const char *name=nullptr)
Creates a Perspective Camera in this Scene.
AnimationSystemRealTime * createRealTimeAnimationSystem(uint32_t flags=EAnimationSystemFlags_Default, const char *name=nullptr)
Create a new animation system that is designed to work with system time. The animation system will be...
status_t flush(sceneVersionTag_t sceneVersionTag=InvalidSceneVersionTag)
Commits all changes done to the scene since the last flush or since scene creation....
The SplineLinearFloat stores spline keys of type float that can be used for animation with linear int...
Definition: SplineLinearFloat.h:21
status_t setKey(splineTimeStamp_t timeStamp, float value)
Sets a spline key at given time with given value.
The UniformInput is a description of an uniform effect input.
Definition: UniformInput.h:22
@ EAnimatedPropertyComponent_Z
Definition: AnimatedProperty.h:68
@ EAnimatedProperty_Rotation
Definition: AnimatedProperty.h:77
@ EClearFlags_None
Definition: RamsesFrameworkTypes.h:257
@ EAnimationSystemFlags_Default
Definition: AnimationSystemEnums.h:19
@ ModelViewProjectionMatrix
Model-view-projection matrix 4x4.
@ UInt16
one component of type uint16_t per data element
@ Vector3F
three components of type float per data element
@ ERamsesShellType_Console
Definition: RamsesFrameworkTypes.h:169
@ Rendered
Scene is being rendered.
constexpr const resourceCacheFlag_t ResourceCacheFlag_DoNotCache
Requests the render to not cache a resource. This is the default value.
Definition: RamsesFrameworkTypes.h:212
int main(int argc, char *argv[])
Definition: main.cpp:21
ramses::Scene * createScene2(ramses::RamsesClient &client, ramses::sceneId_t sceneId)
Definition: main.cpp:126
ramses::Scene * createScene1(ramses::RamsesClient &client, ramses::sceneId_t sceneId)
Definition: main.cpp:46
uint64_t nowMs()
Definition: main.cpp:40