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 documentsForge Interface
Forge est l’environnement de **création intégré** de la plateforme Immersive. Conçu pour les développeurs, intégrateurs, comemrciaux et formateurs, Forge permet de créer, personnaliser et déployer des expériences pour Immersive adaptées à une multitude de cas d’usage.
0 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.
1 documentHub
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.
4 documents
Rest Frontage
y
19 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.
Scripting: Geolocation
This tutorial shows how to use the GPS data of a device to display it and make it evolve automatically in the 3D digital twin, without writing JavaScript. You will understand when to use GeoTracking, GeoMove or NavMeshMove depending on the accuracy of the positions, the frequency of ascent and the type of movement expected. The document also details the exact configuration to be planned for variables, from the format 'longitude; latitude' to orientation or reverse fields. When you read it, you will be able to choose the right native behavior, avoid the pitfalls associated with WGS 84 and obtain consistent visual tracking, from a simple teleport to a fluid animation on a navigation graph.
DiscoverScripting: Introduction
Understand how scripting becomes the business layer that transforms an Immersive digital twin into a truly operational application. This introduction shows where it fits into the creation journey, from modeling to the dynamic behaviors of the Beholder. You will see how JavaScript scripts, versioned on the server side and executed locally, make it possible to adjust the interface, react to real-time data and automate actions without redeployment. The document also clarifies the essential notions of Workspace, Controller, handle and import rules, to know how to structure your developments. By reading, you will be able to identify the role of scripting, understand its life cycle and prepare a clean, maintainable and scalable basis for your future use cases.
DiscoverView and understand user logs.
This course teaches you how to use user logs to quickly understand what happened, when, and for whom. You'll learn how to read useful information, spot important signals, and distinguish between normal behavior and an anomaly to investigate. The document also outlines prerequisites, points to look out for, and a simple way to prepare your environment without wasting time. By the end, you'll be able to interpret critical events, verify a real-world case, and rely on logs to speed up business diagnosis, support, and analysis.
DiscoverThe Forge interface
Prenez rapidement vos repères dans Forge en découvrant comment l’interface organise chaque étape du travail, de la modélisation à la supervision. Ce contenu détaille les cinq grandes zones de l’écran et le rôle concret de chacune pour éditer, naviguer, valider et sauvegarder efficacement une carte. Vous verrez où agir selon le contexte, quels panneaux pilotent les outils, et comment exploiter les paramètres affichés à droite, en bas et au centre. À la fin, vous saurez circuler sans hésiter dans l’environnement, choisir le bon mode d’édition et ajuster l’affichage pour gagner en confort et en performance.
DiscoverBinder equipment
Learn how to link a piece of equipment to a map element to turn a Forge view into a truly usable interface. This content shows, step by step, how to activate supervision editing, choose the right scope, and associate equipment with an area, structure, model, or waypoint. You'll also see how to add a visual marker to immediately locate the equipment on the map. By the end, you'll know how to bind an instance of equipment neatly, organize its display, and prepare clearer, more interactive, and more useful monitoring in operation.
Discover