Developer Networks
Build with GraphicStream technologies
GraphicStream library of technical articles, tutorials, and learning resources
GraphicStream is a software publisher and the publisher of Immersive. The Developer Network supports teams building with its products and technologies.
Get started
Essential resources
A curated selection for understanding the GraphicStream ecosystem and starting to build around Immersive.
Presentation of the Beholder interface
Quickly get your bearings in the Beholder by discovering how the screen is organized between 3D view, equipment list, alarms and menus. This chapter shows where to act, what to look for, and how to select equipment from both the digital twin and the side panels. You will immediately understand the meaning of the color codes and visual indicators to spot a defect, a disconnection or equipment under construction without wasting time. It also explains the role of 3D widgets, graphical objects, and annotations to read the field context more accurately. By the end, you'll be able to navigate the application smoothly and interpret the overall status of a fleet of equipment at a glance.
Read the resourceHub: Overview
Understand in a few minutes how the Immersive Hub orchestrates data access between your applications and heterogeneous sources such as OPC UA, Excel, MQTT or SQL. This presentation shows concretely how the same mechanism unifies requests, updates and quality statuses, without exposing the complexity of the protocols. You will see the precise role of handles, sessions and connectors, and how the Hub distributes the right values to the right consumers at the right time. By reading, you will be able to model access to data, follow the life cycle of a session and understand how to connect or design a connector adapted to your needs. You will also be able to interpret error states, timeouts and fault reports to make monitoring and maintenance more reliable.
Read the resourceBinding: Introduction
Cette introduction vous montre comment relier proprement un objet de la scène 3D à un équipement métier Immersive, pour que données, états, alarmes et interactions pointent toujours vers la bonne cible. Vous comprendrez la logique du modèle objet, des familles, des instances, des handles et des scopes, sans rester au niveau théorique. La formation s’appuie sur un cas concret, BuildingSensorSimulator, pour apprendre à identifier les équipements à créer et à structurer un contrat de données fiable. À la lecture, vous saurez préparer un binding stable entre vue 3D et DOM, éviter les mappings fragiles et concevoir une base exploitable pour le scripting, l’UI et la supervision. C’est le point de départ indispensable pour bâtir un jumeau numérique cohérent, évolutif et fidèle au terrain.
Read the resourceExplore
Browse GSDN domains
Each shelving groups documents, guides and references for a single functional or technical domain.
Forge
Forge is the **integrated creation** environment of the Immersive platform. Designed for developers, integrators, merchants and trainers, Forge allows you to create, customize and deploy experiences for Immersive adapted to a multitude of use cases.
16 documentsBinding
Binding concepts and guides.
1 documentArticles
Technical articles and transversal topics.
1 documentCommons
Common setup and shared fundamentals.
0 documentsConnaissances de base
Explore the guides, references and examples for this domain.
2 documentsHub
The Immersive Hub is the heart of the Immersive solution's data infrastructure. It is the universal intermediary between: * Data sources: IoT sensors, PLCs (OPC UA, Modbus, MQTT, etc.), Excel files, SQL databases, REST APIs, etc. * Consumers: Beholder 3D applications, supervisors, web synoptics, or any other business service. The Hub acts as an **conductor**: It centralizes heterogeneous data from multiple protocols, synchronizes useful values with client applications in real time, and ensures consistency and reliability of information for monitoring and maintenance.
5 documents
Rest Frontage
y
21 documentsScripting
Learn how to bring your plan to life by reacting to the data received and offering an interface tailored to the needs of your users.
16 documentsDiscover
Continue exploring
Resources selected at random from the library to reveal more possibilities offered by Immersive and GraphicStream technologies.
ConnectorTester: Insure your extensions
Avec ConnectorTester, vous validez un connecteur Immersive sans déployer tout le Hub, dans un environnement pensé pour aller droit au problème. Ce tutoriel montre comment charger votre DLL, piloter les cycles Initialize, Connect et Disconnect, puis suivre en direct logs, états et valeurs publiées. Vous apprendrez à vérifier concrètement que vos paths sont bien reconnus par `CanHandle`, que les handles sont enregistrés correctement et que les `HandleSnapshot` remontent comme attendu. Vous verrez aussi comment tester les écritures et scènes, configurer des propriétés de Hub et reproduire rapidement des cas réels de debug. À la fin, vous saurez isoler une anomalie, prouver le bon comportement d’un connecteur et fiabiliser vos extensions avant intégration.
DiscoverAPI Facade and Security
This guide goes far beyond a simple endpoint inventory: it shows how to secure an end-to-end RestFrontage API façade. You'll learn how to authenticate a client, manage the token lifecycle, enforce or audit rights, and manage OData access without missing blind spots. It also details the business rules that govern writes, internal or external sharing, and client-side error responses. By reading, you'll be able to build reliable calls, choose recommended routes, understand the limits of historical points, and build security into your controllers and Razor tools.
DiscoverForge: Patch Notes.
These release notes allow you to identify in a few minutes what is really changing in Forge, version by version. You will see the new concrete uses, such as the Excel export of model weights, the first-person view, the improvement of copy and paste and the smoother editing tools. The document also highlights the fixes that remove penalizing blocks, from freezes to save or selection errors. By reading it, you will know which new features to integrate into your habits, which shortcuts to exploit and which limits have been lifted. It's the most direct way to work faster, with more comfort and fewer incidents in your Forge projects.
DiscoverEnable an object type for security
This guide shows exactly what the toggle of an object type changes in RestFrontage security, and more importantly, what it doesn't. You'll see how to enable or disable a type like 'Map', 'Equipment' or 'Workspace', and then where to follow up to set useful permissions and automatic rights. The document helps avoid common confusion: an active type doesn't grant any access on its own, and an inactive type doesn't remove existing rights or controls that are already plugged in. By going through it, you'll be able to read the actual state of a type, understand the impact of a change on the in-memory configuration, and react correctly if a toggle is stuck, ignored, or reverts to its previous state.
DiscoverThe Recovery Console
Understanding the Recovery console means knowing how to intervene when a service needs to be restored, verified or refurbished without improvisation. This document explains its role in the architecture, the prerequisites to be met and the points of vigilance to be aware of before any manipulation. You will find a concrete process to prepare the environment, configure the solution and succeed in a simple first case with a clearly identifiable expected result. The training also helps to identify common errors, diagnose a malfunction and adopt best practices to secure your operations. At the end, you will know in which cases to use the Recovery console, how to integrate it into your business context and how to validate that an intervention has indeed produced the expected effect.
Discover