SAMSON 11.0.0 Developer Guide

This guide is for developers who build, debug, and distribute SAMSON Extensions with the SAMSON SDK.

Use it when you need to understand how the SDK is organized, how extensions fit into SAMSON, and how to implement common extension workflows such as building UI, working with the data graph, exposing functionality, and packaging your work.

If you are new to SAMSON extension development, follow this order:

1. Read Getting started to understand what SAMSON, the SDK, and extensions are.
2. Install the SDK with Installation.
3. Create your first project with Extension Generator.
4. Build it with Building extensions.
5. Learn the core runtime concepts: Extensions, Data graph, Getting nodes, Modeling and simulation, Developing GUI, Introspection, Serialization.
6. Use Tutorials when you want a worked example instead of a concept page.

Reading paths

Choose the path that matches your immediate task.

I want to create my first extension

• Getting started
• Installation
• Extension Generator
• Building extensions
• Developing GUI

I want to understand the SDK model

• SAMSON Extensions
• SDK Organization
• Data graph
• Modeling and simulation
• Node specification language

I want to implement common extension features

• Getting nodes
• Selectors
• Rendering
• Serialization
• Undo and redo
• Versioning
• Scripting with Python

I want reference material and worked examples

• Fundamentals
• Tutorials
• Changelog
• All versions

Main sections

• Getting started: what SAMSON and the SAMSON SDK are, and what you need before writing code.
• SAMSON Extensions: the extension types, roles, and categories you will work with.
• Installation: how to install the SDK and run the developer build of SAMSON.
• Extension Generator: how to scaffold a new extension correctly.
• Building extensions: how to configure, generate, and compile extensions on each platform.
• Developing GUI: where GUI code lives and how it connects to apps, editors, and models.
• Data graph: the core object model used throughout SAMSON.
• Getting nodes: practical recipes for finding the nodes you want to work with.
• Modeling and simulation: the different model families and how simulators interact with them.
• Scripting with Python: how SAMSON integrates Python for runtime scripting and automation.
• SDK Organization: how the SDK libraries are grouped and where to look for classes.
• Tutorials: hands-on guides for common extension patterns.
• Cite your research: how to attach citations and documentation metadata to your extension.
• Publishing a SAMSON Extension: how to package and distribute your extension on SAMSON Connect.
• Fundamentals: focused concept pages such as introspection, undo and redo, signals and slots, and units.
• Changelog: SDK changes across releases.
• All versions: links to other versions of this guide.

SAMSON Extension samples are available on GitHub: SAMSON-Developer-Tutorials.

Links

• SAMSON Connect
• Marketplace
• Documentation Center
• Release notes
• The SAMSON User Guide
• The SAMSON Scripting Guide
• SAMSON Extensions Tutorials
• Forum
• Blog
• YouTube channel
• Privacy Policy
• Terms of Use
• llms-full.txt - a single text file with a packed representation of the Developer Guide, including the main parts of the SAMSON SDK (excluding pages for template classes and macros).