Difference between revisions of "Panorama Plugin"
(→Usage) |
|||
(14 intermediate revisions by the same user not shown) | |||
Line 2: | Line 2: | ||
== Usage == | == Usage == | ||
− | The plugin must be loaded with an image URL. Optionally, the sliding duration and the background color of the panorama can be indicated. Please see following action syntax example. | + | The plugin must be loaded with an image URL. Optionally, the sliding duration and the background color of the panorama image can be indicated. Please see following action syntax example. |
* <code>video:plugin:http://msx.benzac.de/plugins/panorama.html?url={URL}&duration={DURATION}&color={COLOR}</code> | * <code>video:plugin:http://msx.benzac.de/plugins/panorama.html?url={URL}&duration={DURATION}&color={COLOR}</code> | ||
Line 10: | Line 10: | ||
== Syntax == | == Syntax == | ||
{| class="wikitable sortable" | {| class="wikitable sortable" | ||
− | |+ Parameter syntax of | + | |+ Parameter syntax of panorama plugin |
|- | |- | ||
! Parameter !! Type !! Default Value !! Mandatory !! class="unsortable" | Description | ! Parameter !! Type !! Default Value !! Mandatory !! class="unsortable" | Description | ||
|- | |- | ||
| <code>url</code> || <code>string</code> || <code>null</code> || '''Yes''' || | | <code>url</code> || <code>string</code> || <code>null</code> || '''Yes''' || | ||
− | The URL of the image. It is recommended to encode the value to ensure that it is evaluated correctly (e.g. <code>"http://msx.benzac.de/media/pano1.jpg"</code> → <code>"http%3A%2F%2Fmsx.benzac.de%2Fmedia%2Fpano1.jpg"</code>). | + | The URL of the panorama image. It is recommended to encode the value to ensure that it is evaluated correctly (e.g. <code>"http://msx.benzac.de/media/pano1.jpg"</code> → <code>"http%3A%2F%2Fmsx.benzac.de%2Fmedia%2Fpano1.jpg"</code>). |
+ | |||
+ | '''Note: Please note that the panorama image must have an aspect ratio of more than 16:9 (e.g. 2:1) in order for the sliding effect to become visible.''' | ||
|- | |- | ||
| <code>duration</code> || <code>number</code>{{pipe}}<code>string</code> || <code>40</code> || No || | | <code>duration</code> || <code>number</code>{{pipe}}<code>string</code> || <code>40</code> || No || | ||
− | The sliding duration of the image in seconds. You can also set this parameter to <code>"slideshow"</code> to use the slideshow interval settings from the application ('''Settings''' → '''Slideshow Interval'''). The following interval values can be set. Please note that the panorama plugin doubles the interval values. | + | The sliding duration of the panorama image in seconds. You can also set this parameter to <code>"slideshow"</code> to use the slideshow interval settings from the application ('''Settings''' → '''Slideshow Interval'''). The following interval values can be set. Please note that the panorama plugin doubles the interval values. |
* '''Very Fast''': 2 sec | * '''Very Fast''': 2 sec | ||
Line 27: | Line 29: | ||
|- | |- | ||
| <code>color</code> || <code>string</code> || <code>"black"</code> || No || | | <code>color</code> || <code>string</code> || <code>"black"</code> || No || | ||
− | The background color of the image in CSS syntax. It is recommended to encode the value to ensure that it is evaluated correctly (e.g. <code>"#000000"</code> → <code>"%23000000"</code>). | + | The background color of the panorama image in CSS syntax. It is recommended to encode the value to ensure that it is evaluated correctly (e.g. <code>"#000000"</code> → <code>"%23000000"</code>). |
|} | |} | ||
Line 48: | Line 50: | ||
"control:load": "silent", | "control:load": "silent", | ||
"control:type": "extended", | "control:type": "extended", | ||
+ | "control:dim": false, | ||
"label:extension": "{ico:vrpano}", | "label:extension": "{ico:vrpano}", | ||
"button:content:action": "settings:slideshow_interval", | "button:content:action": "settings:slideshow_interval", | ||
"button:content:icon": "settings", | "button:content:icon": "settings", | ||
+ | "button:speed:enable": true, | ||
"info:text": "Please use the {ico:msx-white:settings} {txt:msx-white:Slideshow Interval} settings to set the base speed (it is applied when the panorama changes).{br} Please use the {ico:msx-white:slow-motion-video} {txt:msx-white:Playback Speed} panel for runtime adjustments (it is reset when the panorama changes)." | "info:text": "Please use the {ico:msx-white:settings} {txt:msx-white:Slideshow Interval} settings to set the base speed (it is applied when the panorama changes).{br} Please use the {ico:msx-white:slow-motion-video} {txt:msx-white:Playback Speed} panel for runtime adjustments (it is reset when the panorama changes)." | ||
} | } | ||
}, | }, | ||
"items": [{ | "items": [{ | ||
− | "titleFooter": "Panorama 1", | + | "titleFooter": "{col:msx-white}Panorama 1", |
"playerLabel": "Panorama 1", | "playerLabel": "Panorama 1", | ||
"image": "http://msx.benzac.de/media/thumbs/pano1.jpg", | "image": "http://msx.benzac.de/media/thumbs/pano1.jpg", | ||
"action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano1.jpg&duration=slideshow" | "action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano1.jpg&duration=slideshow" | ||
}, { | }, { | ||
− | "titleFooter": "Panorama 2", | + | "titleFooter": "{col:msx-white}Panorama 2", |
"playerLabel": "Panorama 2", | "playerLabel": "Panorama 2", | ||
"image": "http://msx.benzac.de/media/thumbs/pano2.jpg", | "image": "http://msx.benzac.de/media/thumbs/pano2.jpg", | ||
"action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano2.jpg&duration=slideshow" | "action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano2.jpg&duration=slideshow" | ||
}, { | }, { | ||
− | "titleFooter": "Panorama 3", | + | "titleFooter": "{col:msx-white}Panorama 3", |
"playerLabel": "Panorama 3", | "playerLabel": "Panorama 3", | ||
"image": "http://msx.benzac.de/media/thumbs/pano3.jpg", | "image": "http://msx.benzac.de/media/thumbs/pano3.jpg", | ||
"action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano3.jpg&duration=slideshow" | "action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano3.jpg&duration=slideshow" | ||
}, { | }, { | ||
− | "titleFooter": "Panorama 4", | + | "titleFooter": "{col:msx-white}Panorama 4", |
"playerLabel": "Panorama 4", | "playerLabel": "Panorama 4", | ||
"image": "http://msx.benzac.de/media/thumbs/pano4.jpg", | "image": "http://msx.benzac.de/media/thumbs/pano4.jpg", | ||
"action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano4.jpg&duration=slideshow" | "action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano4.jpg&duration=slideshow" | ||
}, { | }, { | ||
− | "titleFooter": "Panorama 5", | + | "titleFooter": "{col:msx-white}Panorama 5", |
"playerLabel": "Panorama 5", | "playerLabel": "Panorama 5", | ||
"image": "http://msx.benzac.de/media/thumbs/pano5.jpg", | "image": "http://msx.benzac.de/media/thumbs/pano5.jpg", | ||
"action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano5.jpg&duration=slideshow" | "action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano5.jpg&duration=slideshow" | ||
}, { | }, { | ||
− | "titleFooter": "Panorama 6", | + | "titleFooter": "{col:msx-white}Panorama 6", |
"playerLabel": "Panorama 6", | "playerLabel": "Panorama 6", | ||
"image": "http://msx.benzac.de/media/thumbs/pano6.jpg", | "image": "http://msx.benzac.de/media/thumbs/pano6.jpg", | ||
"action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano6.jpg&duration=slideshow" | "action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano6.jpg&duration=slideshow" | ||
− | } | + | }] |
− | |||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Line 95: | Line 98: | ||
== See also == | == See also == | ||
* [[Video/Audio Plugin]] | * [[Video/Audio Plugin]] | ||
− | |||
− | |||
− | |||
* [[Plugin API Reference]] | * [[Plugin API Reference]] |
Latest revision as of 12:05, 12 June 2023
This is a special video plugin that displays an image as a sliding panorama. The plugin can be used with version 0.1.74 or higher.
Usage[edit]
The plugin must be loaded with an image URL. Optionally, the sliding duration and the background color of the panorama image can be indicated. Please see following action syntax example.
If you would like to use the plugin as reference to implement your own plugin, please have a look at this implementation script: http://msx.benzac.de/plugins/js/panorama.js.
Syntax[edit]
Parameter | Type | Default Value | Mandatory | Description |
---|---|---|---|---|
url |
string |
null |
Yes |
The URL of the panorama image. It is recommended to encode the value to ensure that it is evaluated correctly (e.g. Note: Please note that the panorama image must have an aspect ratio of more than 16:9 (e.g. 2:1) in order for the sliding effect to become visible. |
duration |
number |string |
40 |
No |
The sliding duration of the panorama image in seconds. You can also set this parameter to
|
color |
string |
"black" |
No |
The background color of the panorama image in CSS syntax. It is recommended to encode the value to ensure that it is evaluated correctly (e.g. |
Example[edit]
Screenshot[edit]
Code[edit]
{
"type": "pages",
"headline": "Panorama Plugin Test",
"template": {
"type": "default",
"layout": "0,0,6,2",
"color": "msx-glass",
"group": "{ico:vrpano}",
"imageFiller": "height-center",
"properties": {
"control:load": "silent",
"control:type": "extended",
"control:dim": false,
"label:extension": "{ico:vrpano}",
"button:content:action": "settings:slideshow_interval",
"button:content:icon": "settings",
"button:speed:enable": true,
"info:text": "Please use the {ico:msx-white:settings} {txt:msx-white:Slideshow Interval} settings to set the base speed (it is applied when the panorama changes).{br} Please use the {ico:msx-white:slow-motion-video} {txt:msx-white:Playback Speed} panel for runtime adjustments (it is reset when the panorama changes)."
}
},
"items": [{
"titleFooter": "{col:msx-white}Panorama 1",
"playerLabel": "Panorama 1",
"image": "http://msx.benzac.de/media/thumbs/pano1.jpg",
"action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano1.jpg&duration=slideshow"
}, {
"titleFooter": "{col:msx-white}Panorama 2",
"playerLabel": "Panorama 2",
"image": "http://msx.benzac.de/media/thumbs/pano2.jpg",
"action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano2.jpg&duration=slideshow"
}, {
"titleFooter": "{col:msx-white}Panorama 3",
"playerLabel": "Panorama 3",
"image": "http://msx.benzac.de/media/thumbs/pano3.jpg",
"action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano3.jpg&duration=slideshow"
}, {
"titleFooter": "{col:msx-white}Panorama 4",
"playerLabel": "Panorama 4",
"image": "http://msx.benzac.de/media/thumbs/pano4.jpg",
"action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano4.jpg&duration=slideshow"
}, {
"titleFooter": "{col:msx-white}Panorama 5",
"playerLabel": "Panorama 5",
"image": "http://msx.benzac.de/media/thumbs/pano5.jpg",
"action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano5.jpg&duration=slideshow"
}, {
"titleFooter": "{col:msx-white}Panorama 6",
"playerLabel": "Panorama 6",
"image": "http://msx.benzac.de/media/thumbs/pano6.jpg",
"action": "video:plugin:http://msx.benzac.de/plugins/panorama.html?url=http://msx.benzac.de/media/pano6.jpg&duration=slideshow"
}]
}
Demo[edit]
- Launch via App: https://msx.benzac.de/?start=content:https://msx.benzac.de/info/xp/data/plugin_test_5.json
- Launch via Demo Page: https://msx.benzac.de/info/?start=content:https://msx.benzac.de/info/xp/data/plugin_test_5.json