The VideoSnapshot widget is designed to easily exchange an image file within a Pandoras Box project by a Video Snapshot from your attached Video Input.
A click on the VideoSnapshot button and the created snapshot is immediately send to an image file within Pandoras Box.
The newly loaded image file will automatically spread to all connected Clients.
To send a Video Snapshot to Pandoras Box, you need to
1. have an image file added into Pandoras Box project with assigned File and Folder ID.
2. create a Video Input Display and enter the Video Input ID of your Video Source.
3. set up the VideoSnapshot Properties, see below.
To create an VideoSnapshot widget choose "Widgets > Buttons > VideoSnapshot". The mouse cursor changes to a crosshair icon, indicating the create mode. With a left-click anywhere on the empty main background window you add the selected widget to the current page. Left-click again if you like to add one more. To quit the create mode, you can switch to the run mode with [F8], where you can use all widgets. Most widgets however need to be set up first.
To edit the VideoSnapshot parameters simply right-click on the VideoSnapshot Button and choose the menu entry "Item Properties", press [ALT+P] whilst the mouse is hovering above it or double-click on it when being in the edit / move mode ([F9]). The VideoSnapshot Property Dialog opens up.
A unique name can be entered to identify the widget via the Object and Member Notation. The default name is based on the widget type and ID.
This drop-down offers all available pages to place the widget on.
The VideoSnapshot button's ID may be changed by entering a new one in the text field top left. If you change it, you will be asked if you also want to adapt the name to the new ID.
A short note can be added here. It is not displayed outside the widget but can be set and retrieved with the WidgetID.Note property member.
Uncheck this box to hide the widget.
When the option “Fix” is checked, the VideoSnapshot button will be displayed on every page.
Enter a pixel size for the VideoSnapshot button's size.
X and Y
Enter the location of the widget (upper left corner) in pixels
Video Input Display ID
Enter here the ID of the VideoInput display you want to generate the snaphots from.
Folder and File ID
Enter here the File and Folder ID of the image in Pandoras Box, to which the new image should be loaded.
Width, Height, Fit
You may enter the Width and Height the image should get. Press Fit to enable this size option, otherwise the image will be fitted to the size of the original image file inside Pandoras Box.
The Delay between copying the new image to the original image file and loading it inside Pandoras Box is set to 1000ms. This delay is set to be sure that the copy process is finished before the image is loaded into Pandoras Box. This value can be edited by entering a new delay time.
Press [Target Path...] and browse to the image file which should be exchanged through the new loaded images.
Web Link URL
The Web Link section is of special interest when working with the Web Server feature, i.e. clicking the VideoSnapshot button in a web browser. Enter a URL e.g. "http://www.coolux.com" that your browser should call when clicking the button.
But it is also possible to achieve a quick page change with the URL, simply enter a hash tag "#" and the page name. E.g.: #Page2
Enter a label that will be displayed on the button. The text's color can be set via the color field and its font via the according button.
VideoSnapshot buttons can be colored by selecting a tint color, this applies only to the default button images.
Three images can be assigned to the different states of the button (the modes are explained above).
“Release” refers to no click or not toggled.
“Click” is on press or toggled.
“Highlight” can be used to draw a png with alpha over either the click or release image.
Click on the "..." button to open a file dialog where you can choose your path and image. If you like to choose an image from the Widget Designer "library", click on the "Res" button. The Resource Manager opens where you can double-click on the image of your choice. You can also save custom images in the Resource Manager to access them faster. The small "x" at the right sets the default image.
In the Script section you may enter commands to be executed. You can type directly in the text field, the Script Assistant will help you finding the expression you search for. The topic Script Language explains this in more detail.
The scripts for Click, Mouse Enter and Mouse Leave are executed when the Widget Designer button is being used, on the local interface as well as on any web client.
You can put as much text in one of the scripting fields as you like, but for keeping a good overview, using Macros and Functions is recommended for sophisticated scripts
If you are interested in the Web Server feature and some small examples, please read the topics Web Server and Object and Member Notation .
See here a list of all commands.
The NBS (Network Broadcast Service) allows transmitting and updating Faders, Labels and buttons across multiple WD Designers instances on the network. To activate this service, please refer to the Remoting dialog!
To send the VideoSnapshot buttons state (clicked or released) as broadcast into the network, you only have to check “Enable Send”.
To receive values from other VideoSnapshot buttons, please check “Enable Receive”.
Now you have to specify which item should update your VideoSnapshot button:
Enter the IP address of the computer you want to listen to. This could be the local computer (to control the VideoSnapshot button through another VideoSnapshot button on the same Widget Designer) or a different computer in the network. If you do not want to specify the computer but want to listen to all computers in the network, enter “255.255.255.255”.
As next step specify the VideoSnapshot button you want to take the status from. This could be e.g. “VideoSnapshot1” or “ VideoSnapshot2”.
CSS based effects and animations can be applied to this widget. Please refer to the topic Effects & Animations for more information.