mirror of
https://github.com/acemod/ACE3.git
synced 2024-08-30 18:23:18 +00:00
42f4edc9b7
* Documentation - Remove slideshow note Fix in Arma 3 v2.00 * Remove another issue reference
59 lines
2.2 KiB
Markdown
59 lines
2.2 KiB
Markdown
---
|
|
layout: wiki
|
|
title: Slideshow Framework
|
|
description: Explains how to set-up slideshows.
|
|
group: framework
|
|
order: 5
|
|
parent: wiki
|
|
mod: ace
|
|
version:
|
|
major: 3
|
|
minor: 2
|
|
patch: 0
|
|
---
|
|
|
|
## 1. Overview
|
|
|
|
Slideshow is a very powerful tool for mission makers and platoon leaders giving them the power to project images on some objects.
|
|
|
|
Slideshow is setup through a module or [function](#create-slideshow).
|
|
|
|
Important notes:
|
|
|
|
- Only objects with `hiddenSelection` `0` can be used as "screens".
|
|
- If you set a duration the remotes will be disabled (if the remotes are disabled `ace_interaction` is not needed).
|
|
- You can have multiple sets of images on different screens by using multiple modules/function calls.
|
|
- It is advisable images resolution sizes are powers of 2 (eg. 512x512) to avoid graphical glitches in them.
|
|
|
|
|
|
## 2. Scripting
|
|
|
|
### 2.1 Create Slideshow
|
|
|
|
`ace_slideshow_fnc_createSlideshow`
|
|
|
|
| Arguments | Type | Optional (default value)
|
|
---| --------- | ---- | ------------------------
|
|
0 | Screen Objects | Array | Required
|
|
1 | Controller Objects | Array | Required (screen objects are used if empty `[]`, none are available with automatic transitions)
|
|
2 | Image Paths | Array | Required (paths must use backslash `\`)
|
|
3 | Action Names | Array | Required
|
|
4 | Slide Duration | Number | Optional (default: `0`, `0` disables automatic transitions)
|
|
5 | Set Name | String | Optional (default: localized `"Slides"`)
|
|
**R** | None | None | Return value
|
|
|
|
_Note: Set Name argument added in 3.9.1._
|
|
|
|
#### 2.1.1 Example
|
|
|
|
`[[object1, object2], [controller1], ["images\image1.paa", "images\image2.paa"], ["Action1", "Action2"], 5, "My Slides"] call ace_slideshow_fnc_createSlideshow;`
|
|
|
|
| Arguments | Explanation
|
|
---| --------- | -----------
|
|
0 | `[object1, object2]` | Objects on which images will be projected on
|
|
1 | `[controller1]` | Objects with which slideshow can be controlled
|
|
2 | `["images\image1.paa", "images\image2.paa"]` | Paths to images projected on screen objects
|
|
3 | `["Action1", "Action2"]` | Action names for interaction menu if automatic transitions are not enabled
|
|
4 | `5` | 5s slide duration before change to next image
|
|
5 | `"My Slides"` | Main interaction point name, for easier distinguishing of multiple slideshow sets
|