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.
Camera Management
Keep a handy handy sheet on hand to get the hang of the camera in Forge right away. With a few visual cues, it summarizes the essential mouse and keyboard actions to move the view, rotate around a point, zoom in and refocus on a selection. It also details the first-person view mode with controls to move forward, backward and orient yourself without hesitation. Ideal as a printable cheat sheet, it saves you time when navigating a 3D scene and helps you quickly adopt the right reflexes.
DiscoverMap Drawing
This module teaches you how to build a 3D plan that can be used in Forge, from the layout of structures and areas to detail adjustments. You'll learn how to pose, rework, and correct an outline, manage vertices accurately, and quickly create reusable shapes. The course also shows how to cut openings, add points without breaking a line, and take advantage of snapping to achieve reliable right angles, parallels, and alignments. By the end, you'll be able to model a building or site cleaner, with geometry that is clear, consistent, and easy to scale.
DiscoverHub: create your connector
When a business API, a proprietary protocol or a customer source goes beyond the scope of standard connectors, you need to know how to extend the Hub properly. This course guides you step by step in the creation of a custom .NET connector from a concrete case of building sensors exposed in REST. You will see how to query the source, map equipment and variables, record useful handles and publish exploitable values in real time. At the end, you will know how to structure your connector around the 'IConnector' contract or 'ConnectorBase', manage its lifecycle and link an unsupported source to the Immersive digital twin.
DiscoverDévelopper un connecteur Testo Smart Connect
Ce guide montre pas à pas comment créer un connecteur Immersive Hub à partir d’un cas réel : l’accès aux mesures de capteurs via l’API Testo Smart Connect. Vous y verrez comment concevoir un Path robuste, reconnaître les handles à prendre en charge, valider leur adresse et restituer les changements au Hub. L’exemple complet en .NET vous aide à comprendre le rôle exact du connecteur face aux sessions, aux handles et à l’inventaire des capteurs. À la fin, vous saurez raccorder votre propre API, protocole ou équipement en réutilisant une architecture claire, déployable et adaptée aux usages d’intégration.
DiscoverManage the permissions of a secure object type
This guide shows concretely how to administer the permissions of a type of secure object without the risk of distorting rights already in place. You will see how to consult the existing one, test 'AuthorizedFlags' / 'DeniedFlags' pairs, create a new valid permission and properly rename those that can be valid. It explains the difference between 'Flag' and 'DeniedFlag', the priority of an explicit refusal and the constraints to be respected to avoid inconsistencies. When you read it, you will be able to interpret the tester's results, choose the right mask according to the desired effect and understand why certain fields are immutable. You will also leave with the essential checks to be carried out in the rights, automatic rules and business code after any creation.
Discover