Download Print this page
Visual Productions KIOSC Manual
Hide thumbs Also See for KIOSC:

Advertisement

Quick Links

KI OSC
MAN UA L
©
V I S U A L P R O D U C T I O N S B V
W W W . V I S U A L P R O D U C T I O N S . N L

Advertisement

loading
Need help?

Need help?

Do you have a question about the KIOSC and is the answer not in the manual?

Questions and answers

Summary of Contents for Visual Productions KIOSC

  • Page 1 KI OSC MAN UA L © V I S U A L P R O D U C T I O N S B V W W W . V I S U A L P R O D U C T I O N S . N L...
  • Page 2 Revision History Revision Date Author(s) Description 07.06.2018 Initial version. 14.06.2019 Added Kiosc Touch chapter, added info on elements, expanded the index section...
  • Page 3: Table Of Contents

    Contents 1 Introduction 2 Kiosc App 3 Kiosc Touch 4 Kiosc Editor 5 File Locations...
  • Page 4 2019 Visual Productions BV. All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or mechanical, including photocopying, recording, taping, or infor- mation storage and retrieval systems - without the written permission of the publisher.
  • Page 5: Introduction

    Chapter 1 Introduction Thank you for choosing Kiosc. Kiosc (see figure 1.1) is a simple app for creating custom user-interfaces. These user-interfaces are typically used for controlling lighting and AV equipment. Kiosc communicates with the external equipment via OSC and UDP; protocols that run over the Ethernet network.
  • Page 6 Kiosc Editor. Finally, chapter 5 discusses the locations where the apps save and load the files on disk. At the time of writing this manual the Kiosc app is at version 1.8.5, the Kiosc Editor is at version 1.8.0.
  • Page 7 Multiple pages Available on 5 operating systems OSC and UDP PIN lock Compatibility Kiosc is compatible with the following devices. Visual Productions CueCore2 Visual Productions CueCore1 Visual Productions QuadCore Visual Productions IoCore2 Visual Productions IoCore1 Visual Productions Cuety LPU-2 Visual Productions B-Station...
  • Page 8: Kiosc App

    Visual Productions device and control it directly. Secondly, in this mode, Kiosc can connect to a Kiosc Editor and receive live updates as the user works on his design. This way it provides a real-time preview on the actual target device.
  • Page 9 It is using a propriety protocol that is only supported by the Visual Productions range of devices. This protocol is uni-directional and thus provides no means for giving feedback to the Kiosc app. No OSC or UDP is used in this mode.
  • Page 10 Figure 2.3: Kiosc connected to a media player Figure 2.3 shows an example of Kiosc controlling a Brightsign, a 3rd party media player. Kiosc is using UDP messages to trigger the playback of different media files inside the Brightsign. Protocols Kiosc can communicate with external equipment via two protocols, OSC and UDP.
  • Page 11 OSC, leaving UDP an important asset inside your protocol toolbox. Options The options screen presents a few settings for customising the Kiosc behaviour. 2.3.1 Modes The modes selector allows you to choose between Remote and File mode. Modes are discussed on page 8.
  • Page 12 Figure 2.4: Remote options 2.3.3 File This menu is only enabled when in File mode. It presents a list of the layout files. It also has buttons for saving, deleting and renaming files. Figure 2.5: File options The Folder buttons opens a file browser at the path where the files are stored.
  • Page 13 IP address and PORT is a decimal number. Figure 2.7: OSC options The incoming port field specifies the port number on which Kiosc will receive OSC messages. External equipment that will send feedback information to Kiosc need to know this incoming port number. By default this port number is set to...
  • Page 14 The incoming port field specifies the port number on which Kiosc will receive UDP messages. External equipment that will send feedback information to Kiosc need to know this incoming port number. By default this port number is set to 7000.
  • Page 15 Kiosc. This information can be useful when trouble shooting network issues. Installation The Kiosc app is available on a wide range of operating systems, both mobile and desktop. The software is distributed through app-stores; there are no stand-alone installation packages (e.g. EXE, APK, DMG or DEB files) available. One of...
  • Page 16 Kiosc can be downloaded from the Apple iOS app-store at: https://itunes.apple.com/us/app/kiosc/id1131605366. Android Kiosc can be found on the Google Play store at https://play.google.com/store/apps/details?id=nl.visualproductions.
  • Page 17 Ubuntu 18.04 LTS is recommended. The app is only available for the amd64 architecture.
  • Page 18: Kiosc Touch

    Chapter 3 Kiosc Touch The Kiosc Touch is a Touch screen solution created by Visual Productions. It is a standalone PoE-powered device running the Kiosc app. Figure 3.1: Kiosc Touch Specifications The Kiosc Touch has the following specifications. PoE (Power-over-Ethernet) Class III.
  • Page 19 The Kiosc Touch is wall-mount, it is compatible with European and Amer- ican gang boxes. If no gang box is available then the Kiosc Touch can also be surface mounted. The mounting bracket of the Kiosc Touch suggests where you can create a hole for the cable to enter.
  • Page 20 Network The Kiosc Touch is a network device. A network connection between between a computer running Kiosc Editor and the unit is required to program the Kiosc Touch. More information on this can be found in chapter 4. There are multiple arrangements possible for connecting the computer and the Kiosc Touch.
  • Page 21 The Kiosc Touch supports both static IP addresses and automatic IP addresses. By default, the Kiosc Touch is set DHCP in which it will be automatically as- signed an IP address by the DHCP server in the network. The ’DHCP server’...
  • Page 22 Figure 3.5: IP Settings The IP address or DHCP mode of the Kiosc Touch can be set in the ’IP’ tab in the settings menu, as shown in figure 3.5. The ’IP Address’ field is also where the current IP is shown.
  • Page 23: Kiosc Editor

    Chapter 4 Kiosc Editor The Kiosc editor is a software tool for designing Kiosc layouts. Installation The Editor is available on Microsoft Windows, Apple macOS and Ubuntu Linux. The software is distributed through app-stores; there are no stand-alone installa- tion packages (e.g. EXE, APK, DMG or DEB files) available. One of the major advantages of installing an app via an app store is to receive future software updates automatically.
  • Page 24 The Editor Figure 4.1: Kiosc Editor user-interface Figure 4.1 shows the different sections in the Editor’s user-interface. Each section is discussed in detail below. 4.2.1 Menu Bar At the top of the Editor screen there is a menu bar. Reading from left to right, it contains buttons for New File, Save, Save As and Open.
  • Page 25 Figure 4.3: Pages You can rename the page by selecting it and then changing the Label. 4.2.3 Elements Controls like buttons, faders, encoders, etc. are called Elements (see figure 4.4). A layout is basically created by dragging several Elements into the Pages. Figure 4.4: Elements The available Elements include:...
  • Page 26 Button The button can be used to send a bool value (ON/OFF) or integer value (0 or 1). The Button sends ON or 1 when pressed, and OFF or 0 when released. Fader The fader can send a range of values. The range can be set using the Min and Max values.
  • Page 27 1 when checked, and OFF or 0 when unchecked. Image The image element is perfect for adding your own logo to your Kiosc layout. Clock The clock displays the current time of the system. It has no other functions when pressed.
  • Page 28 Axis The Axis element is for controlling XY values, like a movings head’s pan and tilt. 4.2.4 Images A Page can have a background image. Also, there is a Image Element that can display an image. To use images in your design, you first have to import them into the images list (see figure 4.5).
  • Page 29 Size Presets When no element is selected, the size affects the size of the canvas. Presets can be chosen by pressing the Size Presets button, and selecting the target device. When an element is selected, Size Presets is disabled. The size of the element is decided by setting a desired Width and Height.
  • Page 30 Figure 4.8: Arrange buttons Tags When the user clicks on a button in Kiosc, or controls any other element, it typically sends an OSC or UDP message to an external device. Which message is send out is determined by the Tags fields (see figure 4.9).
  • Page 31 Enable the Snap to Grid to have an aid in aligning Elements. The size of the grid can be specified in the Gridsize field. Local IP Addresses A list with local IP addresses used by the computer running the Kiosc Editor. This information can be useful when trouble shooting network issues. Clients A list of all Kiosc clients currently connected to this Editor.
  • Page 32 For your convenience, there is a popup dialog with size presets for common mobile devices. Press the Size Presets button to open this dialog. Feedback Feedback in the Kiosc app is created by having the external equipment sending messages back Kiosc. The messages should match the Tags.
  • Page 33: File Locations

    The layout file created by the Editor will have the .kiosc file extension. Transferring files from the Kiosc Editor running on a desktop OS to the Kiosc app running on a mobile OS can be done with a tool for copying files to...
  • Page 34 E.g. Apple iTunes can copy files to an iOS device. To make copying files to Kiosc on a mobile device more convenient, Kiosc is capable to connect to a Kiosc Editor under Remote mode and subsequently save it as a local file in File mode. Follow these steps: 1.
  • Page 35 UDP, 10, 14 Grid Size, 9, 12 Values, 29 Image, 27 Version, 15 Images, 28 VisualTouch, 9 Incoming port, 13, 14 vManager, 19 iOS, 16 IP Address, 31 Windows, 16, 23 IP Settings, 21 Wireless, 20 iTunes, 34 Kiosc, 8...

This manual is also suitable for:

00136340