# Scene Control

> Symcon documentation · English · generated on 2026-09-26  
> Index: https://www.symcon.de/en/llms.txt

Source: https://www.symcon.de/en/service/documentation/module-reference/logic/scene-control/

_Requires Symcon >= 5.0_

The scene control saves values of variables stored in a list in scenes and can call them up again from the Visualization and mobile apps at the press of a button.
The variables to be switched must be added to the "Variables" list in the instance configuration. Once all the variables required for a scene have been added and set to the desired value, they can be added to the corresponding scene using the "Save" button (in the Visualization). Now the scene can be called up at any time with the corresponding "Execute" button. The variables are set to the previously saved values.

### function scope
- Allows variables stored in a list to be saved and recalled via scenes.
- The currently active scene is displayed
- Display and operation via Visualization and mobile apps
- When a variable is replaced, scenes already created are retained and switch the new device

### software installation
- Install the 'Scene Controll' module via the [Module Store](https://www.symcon.de/de/service/dokumentation/komponenten/verwaltungskonsole/module-store/).

### Set up the instances in IP-Symcon
- Under "Add Instance" the 'Scene Controll' module can be found using the quick filter.
  - More information about adding instances in the [Instances documentation](https://www.symcon.de/en/service/documentation/basics/instances/)

#### Configuration Page:

| Name      | Description                       |
| --------- | --------------------------------- |
| Scenes    | Number of scenes provided.        |
| Variables | List of variables to be switched. |

### status variables and profiles
The status variables are created automatically. Deleting individual ones can lead to malfunctions.

#### Statusvariables
The scenes are numbered 1,2..n in ascending order.

| Name         | Type    | Description                                                                                                                                                                                                             |
| ------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Active scene | String  | Displays the name of the currently active scene. If the values of the variables can be assigned to a scene, this is also displayed. If the values of the variables do not correspond to a scene, 'Unknown' is displayed |
| Scene 1..n   | Integer | For display in the Visualization and the mobile apps. Calls "Save" or "Call".                                                                                                                                           |

#### Profile:

| Name             | Type    |
| ---------------- | ------- |
| SZS.SceneControl | Integer |

### Visualization
Via the Visualization the current values of the listed target variables can be stored in a Scene. Via "Execute" already saved scenes can be called.

## SZS_CallScene

Source: https://www.symcon.de/en/service/documentation/module-reference/logic/scene-control/szs-callscene/

`bool SZS_CallScene(int $InstanceID, int $SceneNumber)`

_Requires Symcon >= 5.0_

Calls the scene and sets it associated variables

**Parameters**

- `$InstanceID` (int): ID of the Instance
- `$SceneNumber` (int): Number of the Scene

**Returns** (bool): If the command could be executed successfully, it returns __TRUE__ as result, otherwise __FALSE__.

Number of the Scene

**Example**

```text
SZS_CallScene(12345, 1);
```

## SZS_GetActiveScene

Source: https://www.symcon.de/en/service/documentation/module-reference/logic/scene-control/szs-getactivescene/

`int SZS_GetActiveScene(int $InstanceID)`

_Requires Symcon >= 5.0_

**Parameters**

- `$InstanceID` (int): ID of the Instance

**Returns** (int): Number of the active scene. If an unknown scene is active, 0 is returned.

ID of the Instance

**Example**

```text
SZS_GetActiveScene(12345);
```

## SZS_SaveScene

Source: https://www.symcon.de/en/service/documentation/module-reference/logic/scene-control/szs-savescene/

`bool SZS_SaveScene(int $InstanceID, int $SceneNumber)`

_Requires Symcon >= 5.0_

**Parameters**

- `$InstanceID` (int): ID of Instance
- `$SceneNumber` (int): Number of the Scene

**Returns** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis __TRUE__, andernfalls __FALSE__.

Number of the Scene

**Example**

```text
SZS_SaveScene(12345, 1);
```