Logo Logo nl
  • iRidi Pro
    Основные компоненты
    • Приложение i3 Pro
    • iRidi Pro Server
    • iRidi Studio
    • iRidium studio v. 1.3.8 (устаревшая версия)
    Java Script в iRidi
    • Руководство
    • Справочник
    • Примеры
    • JS драйвера
    другие
    • Личный Кабинет
    • iRidium Cloud
    • iRidium Transfer
    • Push-уведомления
    • Лучшая практика
    Лицензирование
    • Лицензирование и передача проекта
    • Оффлайн-лицензирование
    • Активация iRidi Pro Server
  • Продукты
    i3 lite
    • Приложение i3 lite
    • Регистрация и лицензирование
    • Сервер
    • Модули
    KNX Home Server
    • Приложение i3 KNX
    • KNX Home Server
    BUS77 HOME SERVER
    • Приложения Bus77 Home и Bus77 Lite
    • Bus77 Home Server
    Решения
    • BYOD - решение для гостиниц
    • Портал жителя - решение для МКД
    iRidi SCADA
    • iRidi SCADA
  • Bus77
    НАСТРОЙКА BUS77
    • Основы Bus77
    • Приложения Bus77 Home и Bus77 Lite
    • Работа с драйвером Bus77 в iRidi Studio
    • Настройка шины Bus77 в iRidi Studio
    ПРОТОКОЛ BUS77
    • Характеристики CAN (Bus77)
    • Описание протокола
    • Исходники на GitHub
    ОБОРУДОВАНИЕ BUS77
    • Каталог Bus77 Pro
    • Каталог Bus77 Lite
  • Поддерживаемое оборудование
    Драйверы
    • Список драйверов
    • ProAV драйвера
    • AV & Custom Systems
    • JS драйвера
    • Сторонние драйвера и фриланс
    Протоколы и интерфейсы
    • Голосовое управление
    • 1-Wire
    • BACnet IP
    • Bus77
    • KNX
    • KNX IP BAOS
    • Weinzierl kBerry
    • Microsoft Exchange
    • Modbus
    • MQTT
    • NFC
    • ODBC
    • Onvif
    • SIP
    • SNMP
    • Wake On Lan
    • Z-Wave
    • ZigBee
    Производители
    • AMX
    • AVCiT
    • Beckhoff ADS
    • Biamp Tesira
    • Bluesound
    • Casambi
    • BSS Harman
    • Clipsal
    • ControlArt 7Port
    • Crestron
    • DigiBird
    • Domintell
    • Duotecno
    • EIDE
    • EPSNET
    • Global Cache
    • HDL Buspro
    • Helvar
    • IEAST
    • INELS BUS
    • INELS Wireless
    • Intesis
    • Kleger
    • Kramer VIA
    • Kramer 3000
    • Larnitech
    • Legrand Netatmo
    • LG TV
    • Lutron
    • Lutron Homeworks QS
    • MyHome
    • Nest
    • Novastar
    • Panasоnic PTZ
    • Philips Dynalite
    • PJLink
    • Satel
    • SamsungTV
    • Sonos
    • Somfy
    • SpinetiX
    • Televic Conference
    • TIS
    • Tion
    • URRI
    • Velbus
    • Velocio
    • Vinteo
    • WyreStorm
    • WiiM
    • Xicato
    • Yamaha
    • ZONT
    • Z-Wave.me
    Протестированное оборудование
    • Панель HDL S57
    • Панель HDL S10
    • SIP-домофон
    • Akuvox
    • Arlight
    • Divus
    • QBic TD-1050 PRO
    • QBic TD-1060 Slim
    • QBic TD-1070
    • Sigur
    • Uni-Ubi
    • Velocio
  • Оборудование iRidi

    Серверы
    • HS Сервер
    • ProAV Control Processor Basic
    • ProAV Control Processor Advanced
    • Спецификация контроллеров UMC
    • Настройка контроллера UMC C2
    • Настройка контроллера UMC C3
    • Настройка контроллера HDL IntelliCenter 2 (UMC C4)
    Модули расширения
    • I-PX-RS1
    • I-PX-RS4
    • I-PX-IR3
    KNX
    • KNX Home Server
    • KNX IP Interface
    Панели управления
    • iRidium Panel 7
    • Touch Panel P3
    • Touch Panel P6
    • Touch Panel P8
    • Touch Panel P10
    • Tabletop Touch Panel 10
    • AV Remote Control
    ОБОРУДОВАНИЕ BUS77
    • Каталог Bus77 Pro
    • Каталог Bus77 Lite
    • Differences
iRidium mobile web-site
Содержание
    Инструменты‌
    • Сведения о странице
    • Постоянная ссылка
    • Версия для печати
    • Спецстраницы
    • Связанные правки
    • Ссылки сюда
    Login / Create Account
    Материал из for iRidium developers
    Перейти к: навигация, поиск
    Эта страница является переводом страницы Editor Tools. Перевод выполнен на 63%.

    Other languages:
    English • ‎Nederlands • ‎русский

    Содержание

    • 1 iRidium Studio
    • 2 Je eerste iRidium project
    • 3 De structuur van je project
    • 4 De verschillende onderdelen
    • 5 De opbouw van je grafische project
    • 6 Grafische items
    • 7 Item tekenen
    • 8 De verschillende typen grafische items
      • 8.1 Knop
      • 8.2 Dimmer
      • 8.3 Multistate knop
      • 8.4 Multistate dimmer
      • 8.5 Dynamische lijst
      • 8.6 Op/neer knop
      • 8.7 Toggle knop
      • 8.8 Radio Buttons
      • 8.9 Edit Box
      • 8.10 Virtual Key
      • 8.11 Joystick
      • 8.12 Color Picker
      • 8.13 Static List (List of Popups)
      • 8.14 Trend
      • 8.15 Circular level
    • 9 Project pages and popups
      • 9.1 Nieuwe pagina's, nieuwe popup-pagina's
      • 9.2 Auto-turn of Pages
      • 9.3 Preliminary view of Popups on Pages
      • 9.4 Switching Between Pages and Popups
      • 9.5 Popup Group
      • 9.6 Project Start Page
      • 9.7 Project Screensaver
      • 9.8 Password for Opening Pages (Popups)
      • 9.9 Scaling of Pages and Items
    • 10 Processing of Pressings and Gestures
      • 10.1 Types of Events
        • 10.1.1 Work Principles of Interface Events
      • 10.2 Macros Editor
    • 11 Graphic and Sound Galleries
      • 11.1 Graphic Galleries
      • 11.2 Sound Galleries
      • 11.3 Working with Images
        • 11.3.1 Background Images
        • 11.3.2 Main Images, Icons
        • 11.3.3 Chameleon Image
    • 12 Execute: URL Schemes
      • 12.1 Activation from iRidium
      • 12.2 Activation from JavaScript
      • 12.3 Activating iRidium from other applications
    • 13 Visualization Effects
      • 13.1 Animation at popup opening
      • 13.2 Pressing Effect
      • 13.3 «Fast Effects»
      • 13.4 Frame Animation
    • 14 Project Optimization
    • 15 Project Merge

    iRidium Studio

    De eerste stappen voor het maken van je visualisatie-project met iRidium mobile.
    « Instellingen Studio Instellen apparatuur »

    Voor een actueel overzicht van de beschikbare trainingen kijk je op:
    Trainingen

    Elk iRidium project bestaat uit een grafisch gedeelte (pagina's, popup pagina's, knoppen afbeeldingen, animaties, video-beelden etc) en het technische gedeelte (commando's, feedbacks, Javascript op basis van deze JavaScript handleiding). Al deze onderdelen communiceren continue, en gezamenlijk bepalen zij de werking van je project. Je start altijd met het grafische gedeelte bij het maken van een project in iRidium mobile.

    Je kunt op een aantal maniere starten met het maken van projecten in de iRidium Studio editor:

    1. Als eerste mogelijkheid kun je een kant-en-klaar project downloaden in de "Downloads" sectie op onze website. Hiermee bespaar je veel tijd, en je hoeft niet een project vanaf scratch te maken.
    2. De tweede optie is een compleet grafisch project aan te schaffen in het koopgedeelte van onze website (alleen toegankelijk voor geregistreerde system-integrators). Hiervoor dien je de z.g. Full registration procedure te doorlopen op de website in het Mijn Account gedeelte.
    3. De laatste optie is om een compleet eigen ontwerp te maken, met eigen kleuren, logo's etc.


    Je eerste iRidium project

    Na het starten van de iRidium Studio is de eerste stap een nieuw project te maken of een bestaand project te openen. Een nieuw project kun je maken met behulp van de menu-keuze File > New Project (afbeelding 1), de knop op de werkbalk (afbeelding 2) of via de toetscombinatie Control-N (afbeelding 3)

    Editor window menu new project.png


    Na deze stap, krijg je het volgende dialoogscherm te zien:

    Editor window new project.png

    Bestand > Nieuw > Nieuw project bedieningstoestel

    • Projectnaam - de naam van het project
    • Bedieningstoestel - het type bedieningstoestel waarop je project zal gaan draaien (dit bepaald de resolutie van het project). Selecteer "Aangepast" om zelf de resolutie te bepalen *Landscape Breedte / Landscape Hoogte - de resolutie van de horizontale pagina in het aantal pixels
    • Paginanaam - de naam van de eerste pagina in het nieuwe project
    • Oriëntatie - de oriëntatie van de startpagina (Portrait/Landscape)


    Na het maken van je project zie je dit scherm met alle instellingen:

    Instellingen van je iRidium project


    Klik op de naam van de eerste pagina in je project om te beginnen met het tekenen van je eerste knop:

    GUIfirstPage.png


    Met behulp van de onderstaande twee functies kun je schakelen tussen het selecteren van items (knoppen, afbeeldingen, dimmers, etc) en het tekenen van nieuwe items:

    Icon Select.png Select – om een grafisch item te selecteren
    Icon Draw Item.png Draw Item - om een nieuw grafisch item te tekenen

    Alle hulpmiddelen voor het snel ontwikkelen van je grafische project kun je vinden in het gedeelte

    iRidium Studio werkgebied



    De structuur van je project

    De verschillende onderdelen

    • Paginas - de basis van je project. Op de pagina('s) plaats je de grafische elementen (items) zoals knoppen, afbeeldingen, tekst, etc. De z.g. popup-pagina's (zie hieronder) kun je alleen tonen bovenop een pagina.
      • Je project dient ten minste één pagina te bevatten
      • Pagina's mogen horizontaal (landscape) of verticaal (portrait) zijn
      • Pagina's ondersteunen de functie om automatisch te schakelen tussen horizontale of verticale weergave. Dit werkt overigens alleen maar op bedieningstoestellen met een accelerometer. Om deze functie te kunnen gebruiken dien je 2 dezelfde pagina's te maken met een verschillende resolutie.
      • Alle pagina's in je project hebben hetzelfde formaat. Het formaat bepaal je in de project-eigenschappen.
      • Je kunt pagina's niet voorzien van animatie-effecten (zoals binnenvliegen van rechts naar links); ze mogen ook niet (gedeeltelijk) transparant zijn.
      • Je kunt altijd maar één pagina tegelijk openen (het openen van een nieuwe pagina zal tot gevolg hebben dat de vorige gesloten zal worden, inclusief eventuele aanwezige popups)
    • Popup-paginas - dit zijn stukken van een pagina in elke gewenste resolutie; hierop kun je grafische items plaatsen.
      • Het gebruik van popup-pagina's is een optie; het is dus niet verplicht
      • popup-pagina's kunnen niet horizontaal of verticaal georiënteerd zijn
      • popup-pagina's worden automatisch gesloten bij het draaien van je bedieningstoestel, maar ook bij het openen van een andere pagina
      • popup-pagina's kunnen elk formaat, transparantie en positie op de pagina hebben.
      • Je kunt net zoveel popup-pagina's op een pagina maken als je zelf wilt
    • Knoppen voor het schakelen tussen pagina's en popup-pagina's
      • je kunt voor deze functie elk willekeurig grafisch item gebruiken
      • je kunt met een knop je project besturen door het toevoegen van het "Flip" commando
      • je kunt knoppen gebruiken voor het besturen van pagina's, popup-pagina's en apparatuur.
    • Knoppen voor het besturen van apparatuur
      • je kunt hiervoor elk grafisch item gebruiken
      • de instellingen van de knop bepalen de waarde die je naar de apparatuur stuurt
      • deze knoppen kunnen pagina's besturen, maar gelijktijdig ook popup-pagina's en/of apparatuur
    • Items als onderdeel van je grafische ontwerp
      • je kunt elk grafisch item hiervoor gebruiken
      • je kunt deze items inactief maken: als de gebruiker er op drukt, zal er geen effect zichtbaar zijn


    De opbouw van je grafische project

    • Projecten op basis van pagina's

    Wanneer je projecten maakt op basis van alleen pagina's (dus zonder gebruik te maken van popup-pagina's) kun je gebruik maken van de automatische functie om van pagina te veranderen als je de smartphone of tablet draait. Tijdens het werken met pagina's kun je gebruik maken van het commando "Prev Page" (vorige pagina) om naar de vorige pagina te gaan.

    Een nadeel van het werken met pagina's is, dat je bij navigatie-structuren (menu's) alle pagina's dient te onderhouden wanneer er een menu-item gewijzigd of toegevoegd dient te worden. Het is daarom beter om bij projecten met navigatie-structuren niet met pagina's te werken, maar met een combinatie van 1 hoofdpagina (met daarop het navigatie-menu) en losse popups die de functionaliteit van een bepaald menu tonen.

    • Projecten op basis van 1 pagina en (1 of meer) popup-pagina's

    Met deze methode maak je dus 1 hoofdpagina (met b.v. links in beeld het navigatie-menu) en diverse popup-pagina's met de functionaliteit. De hoofdpagina blijft continue in beeld, terwijl de informatie in de popup-pagina's kan wisselen, afhankelijk van de gekozen functie (het gekozen menu). Je kunt ook nog extra pagina's maken. Een project met 1 hoofdpagina en een aantal popup-pagina's kun je niet draaien, omdat dit niet mogelijk is bij popup-pagina's.



    Grafische items

    Grafische items zijn alle objecten die zich binnen een iRidium project op een pagina of popup-pagina bevinden. Dit kunnen o.a. knoppen, dimmers, iconen, achtergronden en alle overige zaken zijn die gezamenlijk je project vormen.

    Als je een nieuw iRidium project gestart bent, zie je de startpagina waarna je kunt starten met het toevoegen van grafische items.



    Item tekenen

    Gebruik het tekengereedschap om een nieuw grafisch item te tekenen: een knop met standaard twee statussen: uit (off) en aan (on). Op basis van deze standaardknop kun je alle eigenschappen aan gaan passen:

    Editor window menu draw item.png


    Een nieuw item is standaard van het type 'Knop' (Button) en heeft standaard 2 statussen: uit en aan (off en on). Een dergelijke knop wijzigt de status door deze in te drukken, en weer terug door hem los te laten.


    De status van grafische items

    Om een status aan een item toe te voegen of te verwijderen, of te schakelen tussen statussen, klik je op het tabblad Object Properties > States:

    Editor window Object Properties States.png
    Icon Current State.png Current State - de geselecteerde status van het grafische item
    Icon Prev State.png Prev State - ga naar de vorige status
    Icon Next State.png Next State - ga naar de volgende status
    Icon Add State.png Add State - voeg 1 of meer statussen toe
    Icon Delete State.png Delete State - verwijder de geselecteerde status


    Alle eigenschappen van grafische items >>



    De verschillende typen grafische items

    In iRidium projecten kun je de volgende typen grafische items gebruiken:

    Knop (Button) Voor het versturen van vaste waarden (commando's) en het weergeven van ontvangen data (feedback)
    Dimmer (Level) Voor het versturen van een vastgestelde reeks van waarden met behulp van een slider, en voor het weergeven van de actuele waarde (feedback) op deze slider.
    Toggle knop (Trigger Button) Voor het schakelen tussen 2 vaste waarden, die ingesteld worden bij het aanmaken van de knop
    Op/Neer knop (Up/Down Button)
    Het verhogen of verlagen van een waarde met een ingestelde stapgrootte. De onder- en bovengrens van de toegestane waarde zijn in te stellen bij de eigenschappen van de knop
    Multi-state knop (Multistate Button) Het versturen van vaste waarden en het ontvangen van data (feedback), voorzien van een animatie bij het indrukken van de knop of het ontvangen van data
    Multi-state dimmer (Multistate Level) Het vesturen en ontvangen van waarden in een binnen een onder- en bovengrens, waarbij elke waarde (of groep van waarden) een aparte afbeeldingen kan hebben
    Invoerveld (Edit Box) Voor het invoeren van eigen tekst, die verstuurt kan worden naar de bus
    Joystick Voor de besturing van RGB- of DMX-apparaten met behulp van een color picker
    Lijst (Static List) Een lijst met verschillende popup-pagina's waar je doorheen kunt scrollen



    Knop


    De knop is een grafisch item met 1 of 2 statussen. Knoppen kunnen informatie versturen (commando's), of 'statisch' zijn (gewoon een tekst of een afbeelding om uw project mooi te maken). Bij het indrukken van een knop worden de commando's die aan de knop verbonden zijn, verzonden naar het betreffende apparaat.


    1 Maak een commando aan, waar een getal of tekst naar verstuurd moet wroden. Doe dit met de instructies op deze Wiki-pagina's.

    2 Maak een knop aan en configureer deze als volgt (zie ook: instellingen):

    UImakeAbutton.png
    Type Button
    Feedback De manier waarop de knop reageert op het indrukken door de gebruiker, of het ontvangen van feedback van apparatuur
    • Momentary - de knop verstuurt waarden, maar laat geen feedback zien
    • Channel - de knop verstuurt waarden, en geeft ook de ontvangen feedback weer
    • None - de knop reageert niet op het indrukken er van, maar ook niet op het ontvangen van feedback
    • Invert Channel - de knop stuurt waarden en toont ontvangen waarden (feedback) geïnverteerd (niet waar - aan, waar - uit)

    3 Drag & drop het commando naar de knop, en kies de gewenste actie uit het dialoogvenster:

    UIdragCommand.png
    Actie Send Number - het versturen van een getal naar het apparaat. Je kunt ook kiezen voor Send String om een tekst te versturen (ASCII tekst)
    Event for Action De gebeurtenissen (events) die aan de knop gekoppeld kunnen worden. Wanneer de gebeurtenis wordt geactiveerd zal de opgegeven waarde verstuurd worden
    • Press - versturen van de waarde bij het indrukken van de knop
    • Release - versturen van de waarde bij het loslaten van de knop
    • Hold - versturen van de waarde bij het ingedrukt houden van de knop
    • Move - deze functie werkt niet bij een knop


    Je kunt meerdere gebeurtenissen (events) tegelijk gebruiken. Je kunt bijvoorbeeld bij het indrukken van de knop het getal 100 versturen, en bij het loslaten het getal 0.

    Value De waarde die je wilt versturen bij 1 of meerdere gebeurtenissen (events)
    Add a feedback channel (Maak een feedback channel aan) Vink deze optie aan als je wilt dat iRidium automatisch een feedback aanmaakt, waarmee deze weergegeven kan worden op de knop. Dit kan een verandering van de status zijn (b.v. van uit naar aan), maar je kunt de waarde ook als getal weergeven in het tekstveld van de knop.

    4 Na het bevestigen met OK, is het commando gekoppeld aan de knop. Je kunt alles gekoppelde commandos (en feedbacks) zien in het tabblad OBJECT PROPERTIES > Programming

    Voorbeeldproject
    Klik hier om het voorbeeldproject te downloaden


    Gebruik feedback om de waarden op een item weer te geven in cijfers :

    1. zet een variabele (die begint met $) in het tekstveld van het grafische item
    2. drag & drop de feedback naar het grafische item, en kies bij het loslaten voor de optie "In Value":


    Lijst met variabelen in een tekstveld van een grafisch item

    Variabele Functie Variabele Functie
    $V De waarde van de feedback weergegeven als geheel getal (integer) $P De waarde van de feedback weergegeven als percentage
    $F1 - 5 De waarde van de feedback met het gewenste aantal cijfers achter de komma (van 1 tot 5)
    $H De hoogste waarde
    $S De waarde van de huidige status $A De waarde van de feedback min de laagste waarde
    $R Weergave van het verschil tussen de hoogste waarde en de laagste waarde $L Weergave van de laagste waarde
    $X De waarde van de feedback in HEX $$ De weergave van het dollar-teken ($)


    Je kunt het weergeven van de feedback in he tekstveld van het grafische item uiteraard combineren met andere tekst en symbolen. Voorbeeld: De huidige temperatuur is $F2° levert dit als resultaat op: De huidige temperatuur is 22,50°
    (Het gradenteken ° krijg je met ALT-248)

    • Download hier een voorbeeldproject met alle mogelijke voorbeelden van het weergeven van variabelen (0.7 Mb)


    Dimmer


    De dimmer (level) kun je gebruiken voor het besturen dimmers, het instellen van volumes, temperaturen etc. Door het indrukken of bewegen van de dimmer verstuur je de geselecteerde waarde naar je apparaat (dimmer, volume-regeling).

    1 Maak een commando aan (b.v. een dim-commando) wat je wilt gebruiken in de dimmer.

    2 Maak een dimmer aan, en stel deze als volgt in (zie het hoofdstuk "alle instellingen"):

    UImakeAlevel.png
    Type Dimmer (level)
    Feedback de manier waarop de dimmer zal reageren met het weergeven van de feedback (b.v. het actuele volume)
    • Channel - om waarden te versturen en feedback te ontvangen (de slider zal bewegen om de actuele waarde van de feedback weer te geven)
    Min / Max De onder- en bovenwaarde van de slider: zij bepalen de range van te versturen waarden
    Invert Range De range van de te sturen waarden wordt geïnverteerd (dus bijvoorbeeld niet van 0 tot 100 dimmen, maar van 100 naar 0)

    3 Drag & drop het commando naar de slider, zoals weergegeven in onderstaande afbeelding. Bij het loslaten zal het dialoogkader 'Send Command' getoond worden:

    UIdragCommandToLevel.png
    Action Send Token - voor het versturen van de gekozen waarde op de slider, in de range die opgegeven is
    Event for Action De gewenste events (gebeurtenissen) die de gekozen waarde moeten versturen
    • Press - om de gekozen waarde te versturen bij het indrukken van de slider
    • Release - om de gekozen waarde te versturen bij het loslaten van de slider
    • Move - om reeds tijdens het bewegen van de slider de waarde te versturen.
      Het is raadzaam om een Delay van 100 milliseconden toe te voegen voor het 'Move' event, om overbelasting van het busssyteem te voorkomen. Door het toevoegen van het Delay-commando zal het commando 'Move' 1 keer per 100ms werken.



    Je kunt deze events ook allemaal tegelijk gebruiken.

    Add a feedback channel (Automatisch een feedback aanmaken) - Hiermee wordt automatisch een feedback aangemaakt, waarmee de slider altijd de acutele waarde (b.v. lichtsterkte, volume, temperatuur) zal weergeven.

    4 Het commando (en eventuele feedback) is nu gekoppeld aan de slider. Alle gekoppelde commando's en feedbacks kun je altijd zien in het tabblad OBJECT PROPERTIES > Programming

    Voorbeeldproject
    Klik hier om het voorbeeldproject te downloaden


    Gebruik feedback om de waarden op een item weer te geven in getallen :

    1. zet een variabele (die begint met een $) in het tekstveld van het grafische item
    2. drag & drop de feedback naar het grafische item, en kies bij het loslaten voor de optie "In Value":


    Lijst met variabelen in een tekstveld van een grafisch item

    Variabele Functie Variabele Functie
    $V De waarde van de feedback weergegeven als geheel getal (integer) $P De waarde van de feedback weergegeven als percentage
    $F1 - 5 De waarde van de feedback met het gewenste aantal cijfers achter de komma (van 1 tot 5)
    $H De hoogste waarde
    $S De waarde van de huidige status $A De waarde van de feedback min de laagste waarde
    $R Weergave van het verschil tussen de hoogste waarde en de laagste waarde $L Weergave van de laagste waarde
    $X De waarde van de feedback in HEX $$ De weergave van het dollar-teken ($)


    Je kunt het weergeven van de feedback in he tekstveld van het grafische item uiteraard combineren met andere tekst en symbolen. Voorbeeld: De huidige temperatuur is $F2° levert dit als resultaat op: De huidige temperatuur is 22,50°
    (Het gradenteken ° krijg je met ALT-248)

    • Download hier een voorbeeldproject met alle mogelijke voorbeelden van het weergeven van variabelen (0.7 Mb)



    Multistate knop


    Met een multi-state knop kun je (net zoals een gewone knop) commando's versturen. Alleen zal tijdens het indrukken van de knop een animatie getoond worden, bestaande uit de afzonderlijke afbeeldingen die gekoppeld zijn aan individuele statussen van de knop. Elke 'status' van de ingedrukte knop geeft dus een aparte afbeelding weer, deze worden achter elkaar afgespeeld als een kleine animatie. Deze animatie kan ook afgespeeld worden door het ontvangen van feedbacks op de multi-state knop.


    1 Maak een nieuw commando aan waarmee een getal of tekst verstuurd moet worden.

    2 Maak een nieuw item aan van het type 'Multistate button', en maak hier het gewenste aantal statussen in aan. Koppel aan elke status een andere afbeelding. Je kunt uiteraard ook aan elke status afzonderlijke teksten toevoegen, of randen (borders), etc. Kijk ook (hier voor alle instellingen):

    UImakeAnMSbutton.png
    Type Multistate knop
    Feedback de manier waarop de knop zal reageren op het indrukken ervan of het ontvangen van feedback van apparatuur
    • Momentary – de animatie zal starten als de knop ingedrukt wordt. Als je de knop weer loslaat, zal de animatie in omgekeerde volgorde afgespeeld worden. Repeat: True - de animatie zal niet stoppen totdat de knop zal worden losgelaten.
    • On – de animatie zal starten zodra het iRidium project wordt gestart. Repeat: True - de animatie zal gedurende het werken met het project doorgaan (eindeloze loop)
    • Blink / Channel – de animatie wordt afgespeeld wanneer er een getal (niet zijnde 0) wordt ontvangen van de apparatuur. Repeat: True - de animatie zal niet stoppen, totdat een nul (0) wordt ontvangen van de apparatuur
    Time Up / Time Down (in tienden van seconden) de snelheid van het afspelen van de animatie van het eerste frame tot het laatste frame en terug
    Repeat eindeloos doorgaan met de animatie zolang het actief is

    3 Drag & drop het commando naar de knop, zoals in onderstaand voorbeeld:

    UIdragCommand.png
    Action Send Number - voor het versturen van getallen met het commando. Je kunt ook kiezen voor 'Send String' om tekst te versturen.
    Event for Action Kies het gewenste event (gebeurtenis) waarmee de waarde verstuurd moet worden
    • Press - de waarde wordt verstuurd bij het indrukken van de knop
    • Release - de waarde wordt verstuurd wordt bij het loslaten van de knop
    • Hold - de waarde wordt verstuurd bij het ingedrukt houden van de knop



    Je kunt verschillende events tegelijk gebruiken. Bijvoorbeeld het getal 100 versturen bij het indrukken en het getal 0 bij het loslaten van de knop.

    Value De waarde die je wilt versturen met het commando. De knop zal altijd de waarde die je hier opgeeft versturen.
    Add a feedback channel (Automatisch een feedback aanmaken) Vink deze optie aan om automatisch een feedback aan te maken, zodat de status van de knop gewijzigd wordt als er feedback wordt ontvangen van je apparatuur. Ook zal de animatie afgespeeld worden bij het ontvangen van de feedback.

    4 Het commando (en eventuele feedbacks) is nu gekoppeld aan de knop. Je kunt alle commando's en feedbacks altijd raadplegen in het tabblad OBJECT PROPERTIES > Programming

    Voorbeeldproject
    Klik hier om het voorbeeldproject te downloaden



    Multistate dimmer


    De multistate dimmer is een dimmer (slider) met meer dan 2 statussen. Door te drukken op de dimmer, wordt de waarde verstuurd van de ingedrukte positie. Maar is geen 'slider' aanwezig (het balkje dat je normaal verschuift). In plaats daarvan toont de dimmer één van de statussen (afbeeldingen) die corresponderen met de geselecteerde (of ontvangen) waarde. Elke status (state) van een multistate dimmer kan worden voorzien van een eigen afbeeldingen, tekst, kleur etc.


    1 Maak een nieuw commando aan waarmee een getal of tekst verstuurd moet worden.

    2 Maak een nieuw item aan van het type 'Multistate dimmer', en maak hier het gewenste aantal statussen in aan. Koppel aan elke status een andere afbeelding. Je kunt uiteraard ook aan elke status afzonderlijke teksten toevoegen, of randen (borders), etc. Kijk ook (hier voor alle instellingen):

    Editor examples of Multistate Level 1.png
    Type Multistate dimmer
    Feedback het reageren van de dimmer op het indrukken door de gebruiker of het ontvangen van data (feedback) van apparatuur
    • Momentary - de statussen van de dimmer wijzigen alleen door het indrukken
    • Channel - de statussen wijzigen door het indrukken, maar ook door het ontvangen van feedback van apparatuur
    Min / Max de onder- en bovengrens (range) waarin de dimmer werkt
    Invert Range de dimmer werkt geïnverteerd (omgekeerd): niet van 0 naar 100, maar van 100 naar 0

    3 Drag & drop het commando naar de dimmer. Het volgende dialoogkader verschijnt::

    UIdragCommandToLevel.png
    Action Send Token - verstuurt de actuele waarde naar de bus, in de opgegeven range (min/max)
    Event for Action Kies hier het gewenste 'event' (of meerdere events) die u wilt koppelen aan de knop. Door het activeren van een event wordt de gekozen waarde verstuurd naar de bus
    • Press - de waarde wordt verstuurd bij het indrukken van de knop
    • Release - de waarde wordt verstuurd wordt bij het loslaten van de knop
    • Move -de waarde wordt verstuurd bij het ingedrukt houden van de knop.
      Het is raadzaam om een Delay van 100 milliseconden toe te voegen voor het 'Move' event, om overbelasting van het busssyteem te voorkomen. Door het toevoegen van het Delay-commando zal het commando 'Move' 1 keer per 100ms werken



    Je kunt verschillende events tegelijk gebruiken. Bijvoorbeeld het volume van een versterker verhogen met 5dB bij het indrukken en met 10dB bij het ingedrukt houden van de knop.

    Add a feedback channel (Automatisch een feedback aanmaken) - Hiermee wordt automatisch een feedback aangemaakt, waarmee de slider altijd de acutele waarde (b.v. lichtsterkte, volume, temperatuur) zal weergeven

    4 Het commando (en eventuele feedback) is nu gekoppeld aan de slider. Alle gekoppelde commando's en feedbacks kun je altijd zien in het tabblad OBJECT PROPERTIES > Programming

    Voorbeeldproject
    Klik hier om het voorbeeldproject te downloaden



    Dynamische lijst


    Algemeen.
    De dynamische lijst is een bijzonder grafisch item dat rechtstreeks met apparatuur communiceert.
    De naam zegt het al: het is een lijst met 'dynamische' (wisselende) informatie, in tegenstelling tot de statische lijst (zie verderop).
    Dynamische lijsten zijn bijzonder krachtig: alle content met dynamische inhoud kun je weergeven in zelf vormgegeven lijsten. De keerzijde van het gebruik van dynamische lijsten is echter, dat er kennis van Javascript nodig om is om de lijsten goed te kunnen vullen met inhoud.
    Wil je bijvoorbeeld covert-art (albumhoesjes) weergeven van af te spelen DVD- of BluRay-films, dan dien je niet alleen die cover-art (de daadwerkelijke afbeeldingen) van een server af te halen (b.v. een media-player), maar ook op te slaan in een array.
    De dynamische lijst is gemaakt om een reeks van items (knoppen), die gebaseerd is op templates, weer te geven. Op elke knop kun je bepaalde (dynamische) tekst weergeven, maar ook dynamische afbeeldingen. Met het indrukken van zo'n knop selecteer je dan de gewenste keuze. Dat kan een bepaald muzieknummer zijn, of een bepaalde artiest, of een bepaalde ruimte, etc. De inhoud van de dynamische lijst dien je te vullen met iRidium Script; kijk daarvoor op de iRidium List API.

    Zoals gezegd, kun je de dynamische lijst gebruiken om bijvoorbeeld een lijst te maken van muzieknummers, films en mappen, afkomstig uit een externe bron.


    1 Maak met behulp van JavaScript een set gegevens aan waarmee de dynamisch lijst wordt opgebouwd (bijvoorbeeld een lijst met artiesten of tekstschrijvers). Gebruik de List API om de lijst te vullen.

    2 Maak de dynamische lijst aan met behulp van de volgende parameters (zie ook (alle instellingen)):

    Editor examples of List.png
    Type Dynamische lijst
    Feedback heeft effect op de lijst, maar niet op de items daarin. Wordt niet gebruikt.
    List Template de popup die je gebruikt om de dynamische lijst samen te stellen
    List Items de lijst-items die standaard gebruikt worden (op basis van het template). Je kunt een willekeurig aantal items toevoegen en verschillende teksten daarvoor gebruiken. De commando's stel je samen met behulp van de List API
    Resistance de mate van 'weerstand' van de lijst
    Scroll Bar om de scroll bar wel of niet te tonen

    3 Gebruik de dynamische lijst API om items te koppelen aan de gebruikte apparatuur.

    Voorbeeldproject
    Klik hier om het voorbeeldproject te downloaden



    Op/neer knop


    Algemeen.
    De op/neer knop heeft altijd 2 onderdelen: een op (of +) en een neer (of -) knop. Samen zorgen ze ervoor, dat -met een bepaalde stapgrootte- een waarde naar de bus gestuurd wordt, maar altijd binnen een range, die je zelf kunt bepalen met de parameter Min/Max value. De waarde die gestuurd wordt, is een berekende waarde: het is de actuele waarde (die als feedback van de bus verkregen is) + de van te voren ingestelde stapgrootte. Je hebt dus altijd de feedback van de bus nodig om met een op/neer-knop te kunnen werken.

    Hieronder de stappen om een op/neer-knop te kunnen maken:


    1 Maak een commando aan, waarvan de waarde verhoogd/verlaagd kan worden. Zie de betreffende documentatie op deze site hoe dit te doen.

    2 Maak een level (dimmer) en twee knoppen (de + en de - knop) en stel deze met de volgende parameters in (kijk ook bij alle instellingen):

    Editor window Object Properties General Up Down.png
    Type Op/Neer Button
    Feedback Het effect van het klikken op de + en - knoppen wordt weergegeven in het level: daarop komt de feedback binnen.
    • Momentary - er kan alleen op de + en - knoppen gedrukt worden, er is verder geen visuele verandering van de status.
    Up/Down Value de gewenste stapgrootte voor het verhogen/verlagen (de stapgrootte kan zowel een positief- als negatief getal zijn)
    Min/Max Value de onder- en bovengrens die maximaal ingesteld kunnen worden
    Hold Value de stapgrootte die gehanteerd moet worden indien het 'On Hold' event wordt geactiveerd. Hiermee kun je bereiken dat kort of lang indrukken van de knop resulteert in andere waarden die naar de bus gestuurd worden.
    Hold Time de tijd (in milliseconden) voordat het 'On Hold' event actief wordt
    Repeat Time de frequentie waarmee de 'On Hold' events herhaald worden

    3 Drag & drop de commando's naar de knoppen zoals aangegeven in de onderstaande afbeelding:

    Editor drag to UDB.png
    Action Send Token - verstuur de berekende waarde (bestaande uit de som van de huidige waarden + de stapgrootte)
    Event for Action Het gewenste event wat aan de knop gekoppeld is, en waarmee de waarde verstuurd moet worden:
    • Press - de waarde wordt verstuurd bij het indrukken van de knop
    • Hold - de waarde wordt verstuurd bij het ingedrukt houden van de knop


    Je kunt verschillende events tegelijk gebruiken. Bijvoorbeeld het volume van de versterker met 5dB ophogen bij het indrukken van de knop, en met 10dB bij het ingedrukt houden van de knop.

    Add a feedback channel (Automatisch een feedback aanmaken) Vink deze optie aan om automatisch een feedback aan te maken, zodat de status van de knop gewijzigd wordt als er feedback wordt ontvangen van je apparatuur.

    4 Het commando (en de feedback) is nu gekoppeld aan de knoppen + slider. Alle gekoppelde commando's en feedbacks kun je altijd zien in het tabblad OBJECT PROPERTIES > Programming

    Voorbeeldproject
    Klik hier om het voorbeeldproject te downloaden



    Toggle knop


    Algemeen. Met de toggle-knop (vaak binnen iRidium Trigger-Button genoemd, wat eigenlijk niet de juiste benaming is) kun je twee vaste waarden sturen, die je vastlegt in respectievelijk Trigger Value 1 en Trigger Value 2. Als er feedback op de knop ontvangen wordt, zal deze automatisch van status veranderen, en de tegenovergestelde waarde versturen bij het indrukken van de knop.

    Voorbeeld: als de knop een feedback van een schakelaar ontvangt dat de lamp aan staat, zal automatisch status 2 (aan) getoond worden. Wanneer de toggle-knop dan ingedrukt wordt, zal de waarde 'uit' gestuurd worden, en ook de status 1 weer getoond worden.
    De toggle-knop kan slechts 2 statussen bevatten; 3 of meer statussen is niet mogelijk.

    Hieronder de stappen om een toggle-knop te maken:


    1 Maak een commando aan, wat kan schakelen tussen 2 waarden: aan/uit, omhoog/omlaag, naar boven/beneden. Zie de betreffende documentatie op deze site hoe je dit doet.

    2 Maak een knop aan en stel deze met de volgende parameters in (kijk ook bij alle instellingen):

    UImakeAtriggerButton.png
    Type Toggle knop
    Feedback Zoals het indrukken van de knop als het ontvangen van feedback is zichtbaar
    • Channel - stuurt de andere waarde en toont de feedback (andere typen feedback worden niet gebruikt)
    Trigger Value 1 / Trigger Value 2 de waarden die je wilt versturen met de Toggle-knop.

    3 Drag & drop het commando naar de toggle-knop, en kies in het dialoogscherm de juiste instellingen:

    UIdragCommandToTrigger.png
    Action Send Token - stuur (afhankelijk van de huidige status) de waarde van 'Trigger Value 1' of 'Trigger Value 2' naar de bus
    Event for Action Het betreffende event dat gebruikt wordt voor het versturen van waarden
    • Press - de waarde wordt verstuurd bij het indrukken van de knop
    • Release - de waarde wordt verstuurd bij het loslaten van de knop



    Bij de Toggle-knop kun je altijd maar 1 event tegelijk gebruiken

    Add a feedback channel (Automatisch een feedback aanmaken) Vink deze optie aan om automatisch een feedback aan te maken, zodat de status van de knop gewijzigd wordt als er feedback wordt ontvangen van je apparatuur.

    4 Now the variable is connected to the trigger. You can see all relations in OBJECT PROPERTIES > Programming

    Voorbeeldproject
    Klik hier om het voorbeeldproject te downloaden



    Radio Buttons


    Radio Button - an interface item which allows to select one of the preset options. In iRidium Radio Buttons are not separated as an item type as they can be set up on the basis of Trigger Button. The task of Radio Buttons: to send to the variables values from different buttons from which you can select only one.

    Settings and behavior of Radio Button depend on the variable you work with. You can find several examples below.


    Variant 1 Radio Buttons for controlling one variable with the possibility to receive feedback. Values are written in one variable: equipment returns the current state of this variable.

    1. Set up the Trigger Button items (see the image) in a number equal to the number of Radio Buttons. In the fieldsTrigger Value 1 and 2 indicate the same values corresponding to those which have to be sent to the controlled variable by each button
    2. Drag the command for controlling the variable on all Radio Buttons. Select the Press or Release events for sending, tick Add A Feedback Channel to display the variable status


    RadioButtons-MainSettings.png
    RadioButtons-DragCommand.png

    the set up button will go to State 2 only when the variable takes the value indicated in Trigger Value 1 and 2


    Variant 2 Radio Buttons for controlling variables with possibility to receive feedback. ON/OFF values are written in different variables; equipment returns the current state of these variables. The variables are not synchronized by automation equipment for working in the Radio Buttons mode (inactive modes on the side of iRidium have to be off)

    1. Set up the items Type: Trigger Button, Feedback: Channel, indicate Trigger Value 1 = inactive, Trigger Value 2 = the variable active state (for example 0/1, 0/100)
    2. Drag the commands for controlling the variables on graphic items. By the example of the first item of the group:
      1. Send zeros to all variables in the Radion Buttons group to deactivate the current active mode. In order to do that select Action: Send Number in the dialog window for command sending
      2. Add Delay(50) ms through the macros editor of the Press event to give equipment time to deactivate the active mode
      3. Drag the command for controlling the variable corresponding to Radio Button on the item. Leave Action: Send Token. Value on the Press (or Release) event, tick Add a Feedback Channel


    RadioButtons-MainSettings-Septd.png
    RadioButtons-DragCommand-Septd.png

    If the equipment working modes are synchronized on the automation equipment side (when activating one of the modes the rest are automatically deactivated) you do not need to send zeros to the deactivated variables. Execute only article 2.3 of the settings.


    Edit Box


    It is an item for inputting data from keyboards. The input data are assigned to an item from where they can be "taken" - sent to equipment or processed in the script.


    1 Create an item and set it up as follows (see all settings):

    Editor window Object Properties Programming EditBoxSetup.png
    Type Tekst invoerveld
    Feedback Het gedrag van de knop wanneer deze ingedrukt wordt
    • Momentary - het tekstinvoerveld is geselecteerd wanner de muis erop komt te staan

    2 Edit Box items can be related to variables directly or via scripts

    Editor window Object Properties Programming Edit Box show.png

    When clicking on the Edit Box item execute the command for keyboard opening:

    • Object Properties > Programming > Press > «Show Keyboard [keyboard_type]»


    On activation of the Enter event send data from Edit Box to the item or driver.


    Example of work:

    • Press - the virtual keyboard of the smart phone (tablet) is opened
    • Enter - the Edit Box item sends the text as a command to the driver; closes the keyboard; clears the input area.


    To delete data you input before, write an empty string in Edit Box:

    Editor window Object Properties Programming Edit Box hide.png
    Editor window Object Properties Programming Edit Box Clean.png

    Voorbeeldproject
    Voorbeeldproject met varianten hoe je een Edit Box kunt gebruiken



    Virtual Key


    It is an item for creating user keyboards. You can create a keyboard of any type and configuration in your iRidium project.


    1 Create an item and set it up as follows (see all settings):

    Editor window Object Properties General Virlual Key.png
    Type Virtual key
    Feedback Reaction on pressings
    • Momentary - for keys responsible for input of separate symbols
    • Channel - for keys which there is a possibility to change registers



    To switch the layout use the project variables which stores the number - the current key state. Assign the variable using “In Value” to change the register.

    Key Action Key event
    • Insert Text – input of the symbol indicated in the text field of the key. Write one letter or figure in the text field and it will be sent by the key
    • Enter, Up, Down, Left, … – commands of the Windows OS keyboard


    The virtual key sends the value in the active input field (Edit Box). If you did not create Edit Box the value will not be written anywhere.

    Voorbeeldproject
    Klik hier om het voorbeeldproject te downloaden



    Joystick


    It is a graphic item with 1 state. It has X and Y coordinates - the current position of the Joystick cursor. The range for moving the cursor is limited by the minimum and maximum values. It is also possible to receive the color under the cursor for RGB control.


    1 Create an item and set it up as follows (see all settings):

    Editor window Object Properties General Joystick.png
    Type Joystick
    Feedback the reaction on events
    • Momentary – the cursor is moved by the user
    MinX ... MaxX / MinY ... MaxY the range for moving by the X and Y coordinates
    InvertX / InvertY the minimum and maximum values by the X and Y coordinates swap locations

    2 Joystick can be related to the variable directly or via scripts. Usually the script for receiving the color under the cursor and sending the color components to the RGB strip control channels is used

    Voorbeeldproject
    Klik hier om het voorbeeldproject te downloaden



    Color Picker



    RGB LED strips are controlled with the help of DMX controllers and have one of the following configuration:

    • Red, Green, Blue - three channels for controlling the LED strip color. Decrease of brightness is performed by decreasing brightness of separate channels.
    • Red, Green, Blue, Alpha - four channels for controlling the LED strip color and brightness


    Variant 1 Control RGB strips with the help of three (four) Level items.


    You create 3 (4) Unsigned 8-bit (Subtupe: VALUE) variables in the project. The variables are controlled in the range 0...255, value increase in the channel corresponds to the increase brightness of the respective color.

    LEVEL

    De dimmer (level) kun je gebruiken voor het besturen dimmers, het instellen van volumes, temperaturen etc. Door het indrukken of bewegen van de dimmer verstuur je de geselecteerde waarde naar je apparaat (dimmer, volume-regeling).

    1 Maak een commando aan (b.v. een dim-commando) wat je wilt gebruiken in de dimmer.

    2 Maak een dimmer aan, en stel deze als volgt in (zie het hoofdstuk "alle instellingen"):

    UImakeAlevel.png
    Type Dimmer (level)
    Feedback de manier waarop de dimmer zal reageren met het weergeven van de feedback (b.v. het actuele volume)
    • Channel - om waarden te versturen en feedback te ontvangen (de slider zal bewegen om de actuele waarde van de feedback weer te geven)
    Min / Max De onder- en bovenwaarde van de slider: zij bepalen de range van te versturen waarden
    Invert Range De range van de te sturen waarden wordt geïnverteerd (dus bijvoorbeeld niet van 0 tot 100 dimmen, maar van 100 naar 0)

    3 Drag & drop het commando naar de slider, zoals weergegeven in onderstaande afbeelding. Bij het loslaten zal het dialoogkader 'Send Command' getoond worden:

    UIdragCommandToLevel.png
    Action Send Token - voor het versturen van de gekozen waarde op de slider, in de range die opgegeven is
    Event for Action De gewenste events (gebeurtenissen) die de gekozen waarde moeten versturen
    • Press - om de gekozen waarde te versturen bij het indrukken van de slider
    • Release - om de gekozen waarde te versturen bij het loslaten van de slider
    • Move - om reeds tijdens het bewegen van de slider de waarde te versturen.
      Het is raadzaam om een Delay van 100 milliseconden toe te voegen voor het 'Move' event, om overbelasting van het busssyteem te voorkomen. Door het toevoegen van het Delay-commando zal het commando 'Move' 1 keer per 100ms werken.



    Je kunt deze events ook allemaal tegelijk gebruiken.

    Add a feedback channel (Automatisch een feedback aanmaken) - Hiermee wordt automatisch een feedback aangemaakt, waarmee de slider altijd de acutele waarde (b.v. lichtsterkte, volume, temperatuur) zal weergeven.

    4 Het commando (en eventuele feedback) is nu gekoppeld aan de slider. Alle gekoppelde commando's en feedbacks kun je altijd zien in het tabblad OBJECT PROPERTIES > Programming


    Variant 2 Control of RGB strips with the help of palette


    You can use any colored item as a palette - you will be able to send commands of setting up the selected color to equipment by moving a finger on the item.

    It requires adding a special script - RGB libraries - in your project. The script has to be added only once. Then you will be able to use it to control RGB strips of any built-in iRidium drivers.

    2.1 Create a palette and auxiliary items. You can use any colored image as a palette.

    • Set up the palette like Joystick with the range 0...100 for Х and Y coordinates
    • Set up an inactive item Button which will display the color selected on the palette
    • If it is required set up active Button items which will change the strip brightness step-by-step
    RGBPalette.png

    2.2 Download the file RGB_Library.js

    This file enables color control with the help of JavaScript. Add the file in your visualization project: open the project in iRidium Studio, click Icon Scripts.png, select the item ( + ) "Add Script From File"

    2.3 Create an empty script file: ( + ) "New Script" to add the description of your RGB palette in it:

    Describe the palette and the item for displaying the selected color in the script file:
    ///////// Copy this function to make one more RGB palette ///////
    RGB_player(
             "Driver",                                            // Driver in project
             "Channel Red",                                       // Name of Red Channel
             "Channel Green",                                     // Name of Green Channel 
             "Channel Blue",                                      // Name of Blue Channel
             255,                                                 // Top limit for RGB channel (100 or 255)
             IR.GetItem("Page 1").GetItem("Item Color Picker 1"), // Item "Color Picker"
             /////// optional parameters ///////////////////////////
             IR.GetItem("Page 1").GetItem("Item Display 1"),      // Item "Display"
             )

    The extended version has buttons for controlling brightness:

    Palette, displaying the color and the button +/- for controlling brightness

    ///////// Copy this function to make one more RGB palette ///////
    RGB_player(
             "Driver",                                            // Driver in project
             "Channel Red",                                       // Name of Red Channel
             "Channel Green",                                     // Name of Green Channel 
             "Channel Blue",                                      // Name of Blue Channel
             255,                                                 // Top limit for RGB channel (100 or 255)
             IR.GetItem("Page 1").GetItem("Item Color Picker 1"), // Item "Color Picker"
             /////// optional parameters ////////////////////////////
             IR.GetItem("Page 1").GetItem("Item Display 1"),      // Item "Display"
             IR.GetItem("Page 1").GetItem("Up 1"),                // Item "Up"
             IR.GetItem("Page 1").GetItem("Down 1"),              // Item "Down"
             10                                                   // Increment step for "Up" and "Down"
             )


    In the description indicate where the palette is and to what equipment it sends data:

    • IR.GetDevice("Driver") - the name of the diver to which you will send RGB commands. Copy the driver name in PROJECT DEVICE PANEL
    • "Channel Red", "Channel Green", "Channel Blue" - the names of the variables (Commands) which are responsible for control of red, green and blue color components. Copy the names in PROJECT DEVICE PANEL. The Commands names have to be the same as the names of Feedbacks from where information about the current color of the RGB strip comes.
      HDL-Buspro, Domintell - they have a special way of writing names. For them you need to indicate <the device name in the network>:<the channel name>, for example "Dimmer in Bedroom:Channel 1"
    • 255 - the maximum brightness value for each color. For the majority of equipment brightness is regulated in the range from 0 to 255 but there are drivers which control color brightness in the range 0...100 (for example, HDL). For HDL-Buspro indicate value 100 for this property.
    • IR.GetItem("Page 1").GetItem("Item Color Picker 1") - the page name ("Page 1") and the item on it ("Item Color Picker 1") which you will use as a palette
    • IR.GetItem("Page 1").GetItem("Item Display 1") - the page name ("Page 1") and the item on it ("Item Display 1") which you will use for displaying the color selected on the palette
    • IR.GetItem("Page 1").GetItem("Up 1") - the page name ("Page 1") and the item on it ("Up 1") which will increase brightness of the selected color on pressing
    • IR.GetItem("Page 1").GetItem("Down 1") - the page name ("Page 1") and the item on it ("Down 1") which will decrease brightness of the selected color on pressing
    • 10 - the value on which brightness of the selected color will increase/decrease when clicking Up and Down


    2.3 Click "OK" to save the palette description. Start Emulator to test its work.

    Errors which can appear at incorrect palette description are displayed in the log window (F4)


    Static List (List of Popups)


    It is a graphic item inside which you can scroll popups. it is used for creating menus controlled with the help of gestures.

    1 Create an item and set it up as follows (see all settings):

    Editor window Object Properties General Static list.png
    Type Joystick
    Popups List the list of popups: open the settings window and select the popups to be displayed on the list
    Direction the vertical or horizontal list
    Resistance (%) the degree of list resistance
    Pull Up Type / Time the type of animation at list scrolling / (ms) the speed of list scrolling
    List Type the way of "sticking" popups to the edges of the base list item: to the center, to the left edge, to both edges . It is used when the size of popups in the list is different from the base item.
    List Gap distance between popups on Static list. The property appears if the List Type = Stick Up or Stick Up & Down property

    Command to equipment are assigned to graphic items on the popups of the list.

    example
    DOWNLOAD


    Trend


    TrendLogo.jpg

    Linear Trend graphic items are used for building trends of variable changes in time.

    Trends can be built in real time receiving information about variables directly from automation equipment. You can also use historic data together with the current variable values. The historic data can be stored only on iRidium server.


    To save the history of changes set up saving of the variable in the server database. The setting is performed in the server project. When the variable is saved in the database, you can request the trend of its changes from i3 pro. The trend will unite the historic and actual data depending on the settings of the Linear Trend graphic item.

    The setting of trend displaying is performed in the project for control panels.


    1 Create the variable which has to be displayed on the trend. Set up the variable storing in the database in the iRidium server project.

    StoreInDB.png

    The format of the data saving (Signed 32-bit, Float 64-bit) depends on the variable size. To save fractional values always use Float 64-bit.

    You can save the variable with the selected frequency (Interval) or when changing it by more than the indicated value (Deadband).


    2 Create a graphic item, select Type: Linear Trend. Drag one or several feedback channels for which you want to display the trend of changes on the item:

    AddNewCurve.png


    3 Go to the trend settings and describe its appearance:

    TrendItemSettings.png
    LinearTrendSettings-General.png
    TrendColor-General.png
    1. Trend - the main trend properties: work with the database, time range, main curve
      1. Main Curve - select the main variable on the trend (it will be drawn brighter than the others)
    2. Background, Data View, Border, Cursor - the design of the trend color scheme, see the example


    LinearTrendSettings-Curves.png
    1. List of channels - the variables displayed on the trend and their individual settings (General, Axis X, Axis Y)
    2. Channel settings - the behavior, color and width of each line on the trend
      1. Type - the curve behavior when reloading the server (under development)
      2. Color - the line color
      3. Depth - the line width
      4. Tag - the tag full name, it indicates to the driver and server variable from which data comes. It enables control of the variable via JavaScript
    3. Axis X, Axis Y - the individual settings of trend scales: color, sign and division width


    LinearTrendSettings-MainAxisX.png
    1. General - the time scale (the X axis)
      1. Visible Axis X - to display the time scale
      2. Position: Down - the time scale begins from the top, Top - from the bottom
      3. Line - the color of the time scale
      4. Label, Text - signing of the time scale

    Trend examples:

    Trend1.png
    Trend2.png
    Trend3.png


    Download: the sample of trend settings

    Control the display of trends using a script




    Circular level

    Circular level is a type of level with a slider moving on a circular scale.

    Circular level00.png

    1 Create a variable to control. Set it as described in the manual (see all settings).

    2 Create a level and set it this way (see all settings):

    Circular level01.png
    Type Circular Level
    Feedback Reaction of a level to user pressing and to getting data from equipment
    • Channel - sends a value and displays feedback (a slider moves when data are received)
    Mode Modes of a circular level:
    • Simple (with one slider and one active zone),
    • Double (with two sliders),
    • Triple (with three sliders).
    Min Angle / Max Angle Limits of the slider rotation angle in degrees: admissible values are from 0 to 360, the start and the rotation direction is similar to hands of a clock. You can set Min Angle / Max Angle identical or equal to 0 and 360. In this case the circular level will rotate without angle limits.
    Min Value / Max Value Limits of changing the level value
    Invert Range Direction of level rotation:
    • False - clockwise,
    • True - counterclockwise.
    Range Type Type of range:
    • Integer - integer
    • Float - floating point
    Active Zone The size of the active zone in per cent from 0 to 100:
    • 100 - the whole level is an active zone,
    • 0 - no active zone, only the slider zone.
    Slider Slider appearance
    Slider Color The color of a slider
    Slider Image The image of a slider in the project gallery (a slider must be displayed with a pointer upwards). This property is available when setting Custom value in Slider property.
    Slider Offset Shifting the slider image along the slider axis from the center to its upper point in pixels. It is always a nonnegative value.
    Slider Stretch Fitting the slider image to the size of a circular level
    Default Value Default value for this slider

    3 Drag the variable on the level and indicate in the dialog:

    Circular level02.png
    Circular level03.png
    Action Send Token - sent to the variable a Value taken as the current position of a slider in the range from Min Value to Max Value.
    Event for Action An interface event connected with the button. When an event happens, the set value is written in the variable
    • Press - send Value by press,
    • Release - send Value by release,
    • Move - send all intermediate values during slider movement.
      Add Delay command (100) before a command by Move to decrease the equipment load (with Delay command, Move works no oftener than 100 times in a millisecond).



    All three events can be used at the same time.

    Add a feedback channel (Create a feedback channel) Put this tick as it is required that a sider move according to the current variable state.

    4 Het commando (en eventuele feedback) is nu gekoppeld aan de slider. Alle gekoppelde commando's en feedbacks kun je altijd zien in het tabblad OBJECT PROPERTIES > Programming.

    Download demo project:
    • Circular Level
    Cl demo01.png
    Cl demo02.png
    Cl demo03.png
    Cl demo04.png
    Cl demo05.png
    Cl demo06.png

    Project pages and popups

    Een project dient minstens één pagina te bevatten. De afmeting van deze pagina is tevens het formaat van het gehele project. Popup-pagina's zijn 'losse' pagina's met grafische items, en worden altijd over een pagina geopend.


    Nieuwe pagina's, nieuwe popup-pagina's

    Je project bestaat uit pagina's en popup-pagina's:

    • Pagina - de basis voor het plaatsen van grafische items.
      • je project dient minstens één pagina te bevatten
      • pagina's kunnen horizontaal of verticaal georiënteerd zijn
      • pagina's ondersteunen de functie om automatisch te roteren van horizontaal (landscape) naar verticaal (portrait) als je bedieningstoestel een accelerometer heeft. Wil je van deze functie gebruik maken, dan dien je 2 pagina's te maken: 1 pagina in horizontale opmaak, en 1 pagina in verticale opmaak.
      • alle pagina's in een project hebben altijd hetzelfde formaat.
      • pagina's kunnen geen effecten bevatten en kunnen ook niet transparant of half-transparant zijn
      • er kan altijd maar 1 pagina gelijktijdig geopend zijn (bij het openen van een nieuwe pagina sluit de vorige pagina inclusief eventuele aanwezige popup-pagina's)
    • Popup-pagina's - extra pagina's met grafische items .
      • je bent niet verplicht om popup-pagina's in je project op te nemen
      • popups cannot be horizontal or vertical (its coordinates are fixed)
      • popups can have any size, opacity and position on the page
      • there can be any number of popups on one page
      • popups close at auto-turn of the page


    Create a page (popup):

    Editor menu project add page.png
    • Add Page – to add a page
    • Add Popup Page – to add a popup
    • Add Folder – to create a folder of pages and popups
    • Change View - to change the view of the pages tree for work with Popup Groups

    Page (popup) settings:

    Editor menu project setup pageORpopup.png
    • A new page
      • Name - the name
      • Landscape/Portrait - horizontal/vertical
    • A new popup
      • Name - the name
      • Left and Top - the shift relative to the left upper corner of the page (in pixels)
      • Width and Height - the width and height (in pixels)



    Auto-turn of Pages

    When creating a new pape you can select the orientation and then change it.

    GUI Page orientation Settings.png
    • Name - the page name
    • Alternate View - the page with the opposite orientation view which will be displayed automatically instead of the current one when you turn the control panel (if the panel has an accelerometer)


    When creating a design with auto-turn, use Pages only, not Popups. It is recommended because at auto-turn of a page all previously opened popups will be closed, use JavaScript API



    Preliminary view of Popups on Pages

    Set up the preview in the right-click menu on the open project page or popup.

    Editor right click page view popap.png



    Switching Between Pages and Popups

    Commands for controlling pages and popups can be executed on activation of events:

    • Pressings on graphic items
    • Gestures on pages/popups

    The commands are formed in the window for creation macros for pages, popups and graphic items:

    Editor examples of macros on press.png


    "'Lijst van commando' s:"'

    Flip (commands for switching pages)
    Show TEST THEO Page (Page name) Open a page (only 1 page can be opened at a time). Indicate the name of the page which has to be open in the command properties
    Prev Page show the previous project page
    Show Popup (Popup name) Show a popup (multiple popups can be shown at a time). Indicate the name of the popup which has to be open in the command properties
    Hide Popup (Popup name) Parameter – the name of the hidden popup
    Toggle Popup (Popup name) Show if it is hidden and hide if it is shown. Indicate the name of the popup to be hidden in the command properties
    Hide Group (Group name) Hide all popups in Popups group (see below)
    Hide Popups On Page (Page name) Hide all popups on the page (page name)
    Hide All Popups Hide all popups opened in the project at the moment

    Collectively, the buttons containing navigation commands form the system for navigation between pages and popups of iRidium project.

    The commands are executed with the help of gestures. Select the page in 'Projects Overview', go to 'Object Properties – Programming – Gesture'.



    Popup Group

    In the tree of pages you can create Folders to group pages and popups. It does not affect the project work. But you can also create Popup Groups by right-clicking on a project or popup:

    Popup Group is a set of popups which cannot be opened together. The popups added in one group become mutex. If you open one popup and then another, the first popup will be automatically closed.

    Popup groups are convenient for project navigation. You do not need to monitor if unused popups are closed as it is done automatically.

    GUI Popup Group Altern.png


    The Hide Group command hides any opened popup of the group:

    GUI Popup Group Altern 1.png


    You can hide the Group with script command: IR.HideGroup("Group")


    Project Start Page

    When launching an iRidium project only one page and an unlimited number of popups can be shown.

    Select the start page in Project Properties:

    Editor window menu project properties.png
    • Page – the name of the page to be opened at the iRidium project launch (only one);
    • Popups – the list of popups to be opened at the project launch over the start page. The popups will be opened one by one, in the preset order.

    StartUp in project settings:

    Editor window project properties startup.png



    Project Screensaver

    step 1 Create a screensaver page

    step 2 Set up the "back" button to return to the project, the "Prev Page" command:

    Editor screensaver page with items.png

    step 3 Select the screensaver page in Project Properties:

    Editor window project properties screensaver.png

    ScreenSaver - the screensaver screen:

    • On/Off – to turn on/off the project screensaver
    • Page – the page to be used as the screensaver
    • Interval (sec) – the project idle time after which the screensaver will be opened

    downloads

    • Examples of screensavers>>
    • Example of a screensaver from JaHeLi media >>



    Password for Opening Pages (Popups)

    Use the system of passwords when setting up pages and popups.

    Editor object properties password number.png
    Passwords are asigned to graphic items:
    • None – no password, free access (by default)
    • 1 … 4 – the password number defining the access level (from the 1st to the 4th)

    Open the project settings to setup the passwords corresponding to their numbers (1-4):

    Editor object properties password number inSudio.png

    The application requests the password automatically when you press the protected button. All the commands assigned to the button are executed only after entering the correct password. If the password is not selected in project properties it will not be required.

    The passwords can be changed in iRidium Cloud (see the project settings), in iRidium Transfer and via the System menu of application:

    Editor object properties password number cloud.png
    Editor object properties password number transfer.png

    with JavaScript API you are able to use the method that allows to use the system passwords with any actions (not only when press on buttons):

    • request of the system password via the custom window



    Scaling of Pages and Items

    Om de resolutie van je project te wijzigen, bijvoorbeeld van 2048x1536 naar 1024x768, voer je de gewenste resolutie in bij de eigenschappen van het project. Probeer altijd te downscalen om verlies van kwaliteit van je afbeeldingen te voorkomen.

    ResolutionChange InProject.png

    Na het aanpassen van de resolutie zie je de 2 volgende dialoogvensters:

    1. Bevestig het wijzigen van de resolutie

    ResolutionChange ConfirmResize.png
    • "Ok" - hiermee bevestig je de wijziging van de resolutie van je gehele project
    • "Annuleren" - er zullen geen wijzigingen worden aangebracht in je project


    2. Geef aan of je ook het formaat van popup-pagina's en grafische items wilt wijzigen

    ResolutionChange ChooseResizeType.png
    • "Ja" - het formaat van popup-pagina's en grafische items zal worden aangepast aan het nieuwe paginaformaat
    • "Nee" - het formaat van popup-pagina's en grafische items zal niet worden aangepast; alleen het formaat van de pagina zal dus worden gewijzigd


    3. Sla het gewijzigde project op.

    Na het opslaan van het project kun je verder gaan met het bewerken hiervan, of het project samenvoegen met andere projecten.


    Aandachtspunten bij het wijzigen van de resolutie van projecten:

    Als in het project het nieuwe aspectratio (de hoogte/breedte verhouding) anders is dan het origineel, kan het project er uitgerekt of samengedrukt uit komen te zien.

    Je kunt dit voorkomen door het wijzigen van de resolutie in 2 stappen uit te voeren: wijzig eerst het project zonder het aspect-ratio te veranderen. Neem daarvoor de nieuwe hoogte van het project, en bereken zelf de breedte, zodat het aspectratio hetzelfde blijft. Bevestig hierna dat je het formaat van popup-pagina's en grafische items wilt wijzigen.

    Wijzig nu in de volgende stap alleen de breedte van het project. Laat daarbij het formaat van popup-pagina's en grafische items niet wijzigen.

    Het resultaat hiervan is dat je de resolutie van het project hebt gewijzigd, met behoud van de originele aspect-ratio. Het kan zijn dat je aan de rechterzijde nu lege ruimte hebt, of dat juist niet alle grafische items op de pagina passen. Deze zul je zelf moeten aanpassen.


    Processing of Pressings and Gestures

    Types of Events

    Communication of the end-user with the control panel interface - it is a sequence of events at which interface commands have to be executed or canceled.

    Pressing on the screen, releasing the screen, moving an item - these are different event on which the graphic interface can react.

    Pages, popups, graphic items, list items - they support different set of events and thus have different rules of command sending.

    GUI Events And Gestures.png

    Brief description:

    • Press - command sending on pressing the button
    • Release - command sending on releasing the button
    • Hold - cyclic command sending when you hold the button
    • End Of Hold - single command sending when releasing the button, it it was held before that
    • Move - command sending when moving the slider of Level or Joystick


    • Select - selection of an item and subitem in List. Control of the event is available in JavaScript: List API


    • Change - input of a symbol or command in Edit Box. More information is available in JavaScript: GUI API
    • Enter - clicking on the Enter button in Edit Box


    • Lost Focus - the event generated by any item at release. The event means the item lost its focus (inactive). The event is available for processing only in JavaScript: GUI API


    • Gestures - gestures setting up is possible only in the Page properties. A gesture can be on the page, on a graphic item or popup. It will be automatically transferred to the parent page - commands set up for the page will be executed. Exceptions: Level, Joystick, List and Static List which process the Move event disabling gestures
    download the example on use of gestures >>


    Events available for different object types:

    Page

    • Press
    • Release
    • Gestures:
      • Swipe Left
      • Swipe Right
      • Swipe Up
      • Swipe Down
      • Pinch In
      • Pinch Out
      • Double Tap

    Popup
    • -

    Button
    • Press
    • Release
    • Hold
    • End of Hold

    Level
    • Press
    • Release
    • Move

    Multistate Button
    • Press
    • Release
    • Hold
    • End of Hold

    Multistate Level

    • Press
    • Release
    • Move

    List
    • Press
    • Release
    • Select (JavaScript: List API)

    Up/Down Button

    • Press
    • Release
    • Hold
    • End of Hold

    Trigger Button
    • Press
    • Release
    • Hold
    • End of Hold

    Edit Box
    • Press
    • Release
    • Change (JavaScript: GUI API)
    • Enter

    Virtual key
    • Press
    • Release

    Joystick

    • Press
    • Release
    • Move

    Static List
    • Press
    • Release

    Linear Trend
    • -

    Pie Chart
    • -

    Bar Chart
    • -


    Work Principles of Interface Events

    On pages and popups which are not parts of Static List and List buttons behave as follows:

    1. short pressing on an item generate the events Press > Release
    2. long pressing on an item generate the events Press > Hold > End Of Hold
    3. moving of the Level and Joystick slider generate the events Press > Move > Release
    4. release of any item generate the Lost Focus event


    Graphic items in List and Static List are different as their work can be disturbed by list scrolling. The scrolling can start on the popup and the graphic item which stops command execution:

    1. the start of scrolling deactivates the Release event. So at short pressing with moving, only the Press > scrolling event of the button will work
    2. in the beginning of list scrolling (moving of the cursor/finger) Hold stops working and End Of Hold is generated: Press > Hold > scrolling > End Of Hold
    3. release of any item generate the Lost Focus event


    Recommendations on implementing interface scenes:

    • If the button works on a standard page, comamnds should be assigned to the Press event, if it works on a list - to the Release evetn
    • If the button has to execute different commands on short and long pressing, assign the "short" command to Release, and the "long" one to End Of Hold
    • If you need to send a pulse (first 1, then 0) by short pressing, there are two ways of doing that:
      • assign sending of 1 to Press and sending of 0 to Release. It will allow you to regulate the length of the pulse by the time you hold the button. But you cannot use this way in lists as moving of lists will cancel the Release event
      • assign both commands: 1 and 0 to Release, set up Delay between them. The pulse will have fixed length and work correctly in lists

    Macros Editor

    It is a window for setting up commands which have to be executed when pressing on graphic items.

    The list of interface events and gestures to which iRidium reacts


    The set of commands which can be performed on activating an interface event can be different. That is why in this section only commands and ways of macros creation (sequences of several commands) are described.


    Select a graphic item and open Macros Editor in the window Object Properties > Programming. Depending on the item type a different set of events is available.

    Strings of macros are executed in a sequential order, from top to bottom:

    Editor examples of macros on press.png



    Commands in Macros Editor:

    Flip (commands for switching pages)
    Show TEST THEO Page (Page name) Open a page (only 1 page can be opened at a time). Indicate the name of the page which has to be open in the command properties
    Prev Page show the previous project page
    Show Popup (Popup name) Show a popup (multiple popups can be shown at a time). Indicate the name of the popup which has to be open in the command properties
    Hide Popup (Popup name) Parameter – the name of the hidden popup
    Toggle Popup (Popup name) Show if it is hidden and hide if it is shown. Indicate the name of the popup to be hidden in the command properties
    Hide Group (Group name) Hide all popups in Popups group (see below)
    Hide Popups On Page (Page name) Hide all popups on the page (page name)
    Hide All Popups Hide all popups opened in the project at the moment


    Sound (control of sounds)
    Play Sample to play the audio file
    Stop Sample to stop playing the audio file
    Stop Slot (the slot number) to stop playing the audio file on the first slot
    Stop All Sounds to stop playing all sounds in the project
    Send To Driver (sending data to the driver)
    Send Number to send a decimal number (the DEC format)
    Send Text to send a data string (the ASCII format)
    Send Data to send binary data (BIN format)
    Send Token to send data extracted from the properties of the graphic item (Value, coordinates, size, etc. – variable values defined by the object properties).
    Send To Token (sending data to the project variable (token))
    Send Number to send a decimal number (the DEC format)
    Send Text to send a text (the ASCII format)
    Send Token to send data extracted from the properties of the graphic item (Value, coordinates, size, etc. – variable values defined by the object properties).
    Other (остальные команды)
    Delay (ms) to set up a delay between commands of the macro (at random)
    Script Call (the function name) to refer to the iRidium Script function by its name
    Show Keyboard (the keyboard type) to show the virtual keyboard of the control panel
    Hide Keyboard to hide the virtual keyboard of the control panel
    Minimize to minimize iRidium App on the control panel
    Execute (the command) to execute a standard OS command, for example:
    • open a hyperlink in the browser (http://iridiummobile.net/)
    • send an e-mail (mailto:example@mail.ru)
    • open “the calculator” (calc)
    • or other standard commands for various OS
    Exit to close iRidium App on the control panel (only for Windows and Android OS)


    Commands to control macros:

    GUI Editor macros window.png
    Wiki Macros 1.png to delete the selected macro
    Wiki Macros 2.png to move the selected macro one position up
    Wiki Macros 3.png to move the selected macro one position down
    Wiki Macros 4.png to clone the selected macro
    Wiki Macros 5.png to delete the group of macros
    Wiki Macros 6.png save the group of macros in Project Gallery - Macros


    Saving macros:

    1. Create a command sequence and click the "Save" button
    2. Name the new macro command, click ОК
    3. Open "GALLERY" > "Project Gallery" > "Macros". You can drag it directly on an item or on the Programming window to assigne it to some other event besides Press


    Wiki Macros 7.png


    Creating relations:
    Besides macro commands set up in the properties of separate interface objects (buttons, pages, popups) there are general project macro commands which can be set up in the All Relations window. Here you can create relations for sending data from one interface object to another:


    Icon All Relations.png - open the All Relations window

    Editor window feedback relation.png
    for example, with the help of the value received from the Level slider of Item 1 you can change the coordinate of Item 2. Properties of graphic items, pages, popups, channels and tokens (global variables) can be related in the project.



    Working with elements that caused Script Call
    When using Script Call, you have the opportunity to access the properties of an element that uses the Script Call function.
    Example.
    Create a script function that will take the value of the Text property of the element that called the function, increment the value by one, and write it back. Running the function is tied to an element via Script Call

    ScriptCallItem.png
    var a = 0;
    function action () {
        a + = 1;
        this.Text = a; // Refer to the Text property of the element that called the function
    };

    As a result, the function will change the value of the element that called it
    [Download example]


    Graphic and Sound Galleries

    iRidium Galleries are tools for storing background images, buttons , levels, sets of several items or projects, sounds and macro commands.



    Graphic Galleries

    Graphic gallery in Studio (Gallery > Graphics)
    it is a storage of interface objects which can be used when creating projects. The following items can be stored in the gallery:

    • simple images presented by objects with 1 state
    • buttons with 2 states
    • animated buttons
    • levels with 2 states
    • levels with multiple states
    • groups of graphic items
    • project pages and popups
    Editor window Gallery Graphics.png


    Project gallery (Gallery > Project Gallery)
    it is a storage of images which are already used in your iRidium project. It does not contain complex objects. It operates with separate images the objects consist of.



    Sound Galleries

    Sound gallery in Studio (Gallery > Sounds)
    it is a library of audio files for your visualization projects. They are played at event activation (pressing on an item, releasing it, etc.). Assigning of sounds to graphic items is made by the DragDrop method. Then the sounds are displayed in the Programming tab of the Object Properties window:

    Editor window Gallery Project Sounds.png

    When clicking on [...] in the Programming tab the macros editor will open:

    Editor window Sound macros.png
    • Play Sample - to play the audio file (indicate the name)
    • Play System Sample - to play the standard system sound (select one out of two available)
    • Stop Sample - to stop playing of the audio file (indicate the name)
    • Stop Slot - to stop playing of the particular slot (from 1 to 32)
    • Stop All Sounds - to stop playing of all sounds

    Double-clicking on the audio file string opens playback settings:

    Editor window Sound settings.png
    • Sound - the audio file name;
    • Slot - the number of the playing slot for the audio file (it is required when grouping audio files in streams). In total there can be 32 slots with unlimited number of audio files in each slot. By default it is indicated "Slot 0" (a new playing channel is formed without a slot);
    • Volume - the volume for playing the audio file;
    • Loop - it activates (True) or deactivates (False) repetition of playing the audio file


    Supported audio-formats:

    mp3 (with fixed and variable bitrate)
    wav with the following codecs:
    PСM (sound depth - 8 or 16 bit, sampling frequency- from 8 to 96 kHz)
    IMA ADPCM (sound depth - 8 or 16 bit, sampling frequency- from 8 to 96 kHz)
    MS ADPCM (sound depth - 8 or 16 bit, sampling frequency- from 8 to 96 kHz)
    GSM (sampling frequency 8 kHz, sound depth 16 bit)
    MS GSM (sampling frequency 8 kHz, sound depth 16 bit)
    mu-Law (sampling frequency 8 kHz, sound depth 16 bit)
    A-Law (sampling frequency 8 kHz, sound depth 16 bit)
    OGG


    Project Gallery (Gallery > Project Gallery)
    it contains only the sounds used in the iRidium project.



    Working with Images


    Background Images

    Editor window Gallery put image.png

    Use the “Put Image To Page Background” command in the right-click menu to make an image the page/popup background. This command does not work for complex Gallery objects.
    You can also select the page background in Object Properties > States, the Image property


    Main Images, Icons

    Editor window Gallery add as image.png

    A button can display 2 images at a time:

    • Image - the base image
    • Icon - the icon over Image



    Select how the image will be used when dragging it on the button (see more information about Chameleon Image below)

    Settings of images and icons in the States tab:

    Editor window Object Properties change image.png

    You can change images and icons in object properties, States:

    • Image – a main image
    • Icon – an icon image (placed over the main one)
    • Chameleon Image - an image in the PNG format which, when assigned to the button, uses the button colors of its filling and border to define the colors inside the image.
    • Icon Align – the way of aligning the icon relatively to the item sides
    • Image Aligh – the way of aligning the main image relatively to the item sides



    The States tab refers to Project Gallery where the images which are already used in the project are stored.


    Chameleon Image

    Chameleon Image is an image without the fixed color. By changing the color of the button and its border you change the color of Chameleon Image. When using Chameleon Images with custom palettes they allow you to create a large number of color schemes for one template and also highlighting, glowing, the shadow and depth effects.

    Chameleon image is an image in the PNG format consisting of four color channels (alpha, red, green and blue: ARGB). The colors are processed as follows:

    Editor Chameleon Image.png
    • Alpha - the item form
    • Red - the area which will be filled with the item filling color
    • Green - the area which will be filled with the item border color
    • Blue - it is not used



    In order to distinguish transparency correctly save your PNG file in RGB colors (32-bit).


    Example of setting up the color scheme of Chameleon Image and the results:

    Editor examples of Chameleon Image.png
    Editor examples of Chameleon Image result.png



    Execute: URL Schemes

    URL scheme - in is an indicator to the resource which can be activated by iRidium commands. With the help of URL schemes you can start applications, open links in the browser, open mail agents, make calls, send SMS.

    There are different URL schemes for different OS. Consider the type of the operating system in which the project will work when you select the commands.


    Activation from iRidium

    In iRidium you can create a button which open a third-party application or link in the browser. Examples of commands which can be executed in different OS:

    AppCallFromUI.png

    Hyperlinks:

    • Execute(http://iridiummobile.net)


    Windows files and applications:

    • Execute(c:\Program Files\iRidium.exe)


    the screen keyboard (Windows):

    • Execute(osk)


    Make a call, write an SMS:

    • Execute(tel:+123456789)
    • Execute(sms:+123456789)


    Send an e-mail:

    • Execute(mailto:test@example.com)


    Start the app:

    • Execute(videos://)
    • Execute(music://)


    iOS 8 and iOS 9 Settings app (there is no solution for iOS 10 yet):

    • Execute(prefs:root)
    • Execute(prefs:root=WIFI)
    • see all schemes


    i3 pro settings on iOS 9-10:

    • Execute(app-settings://)


    List of URL schemes for iOS >>

    URL schemes for iOS and Android are not identical

    some applications cannot be launched as the developer did not provide such possibility!


    Activation from JavaScript

    Create a JavaScript file in the script editor of iRidium Studio for commands to be executed on clicking the button or activating and event in the system.

    IR.Execute("http://iridiummobile.net");

    You can see more information about working with JavaScript in JS Guide.



    Activating iRidium from other applications


    URL schemes of starting i3 pro can be activated from the browser or mail agent similarly to hyperlinks to network resources. Use the commands:

    • i3pro://
    the command for application activation (open or maximize). Works in the browser of iOS/Android devices with i3 pro. it can be executed as a hyperlink in the browser, mail agent or another application
    • i3pro://script?data1&data2
    the command of application activation at the script activation
    the data string which will be sent to the script, in the query property. IR.AddListener(IR.EVENT_RECIEVE_SCHEME,0,function(query, source) {}); - the listener which has to be created in your iRidium project to receive data from URL schemes


    Example:


    A URL scheme in a third-party application, browser:

    i3pro://script?Page1

    The handler of the URL scheme in iRidium:

    IR.AddListener(IR.EVENT_RECIEVE_SCHEME,0,function(query, source) 
    {
       if (query == "Page1")   
          IR.ShowPage("Page 1");
    });



    Visualization Effects

    iRidium supports animation of pressings on items, frame animation of items, animation at page/popup opening and special iRidium Script libraries.


    Animation at popup opening

    In popup properties Object Properties > General indicate the animation effects which will be used at popup opening/closing:

    Editor Object Properties popap effects.png


    • Lifetime (ms) – popup lifetime. After this time the popup will be automatically closed.
    • Effects – the effects of opening and closing the popup. You can use a custom combination of effects.
      • Fade - the popup changes the level of its opacity
      • Rotate - the popup moves rotating around the main axes
      • Slide - the popup slides from the side of the screen or "from itself"
      • Scale - the popup increases or decreases its Х and Y coordinates from 0 to the preset one
      • TV Scan - the popup appears after changing the Y coordinate from 0 to the preset one

    Settings of effects:

    • Duration (ms) - the duration of effect performance
    • Delay (ms) - the delay before the effect activation
    • Tween - the direction in which the popup moves when opening or closing



    Pressing Effect

    To create a visual effect on pressing, use different images for the item active and inactive states:

    Editor effect of pushing on button.png

    The item states changes on pressing, if you select "Feedback: Momentary" in its settings.
    The item states changes when receiving feedback when you select "Feedback: Channel".



    «Fast Effects»

    Met behulp van deze functie kun je snel een tweede status (state) van een item genereren op basis van de eerste (niet actieve) status van het item.

    Voeg een afbeelding aan je project toe, en klik op de knop "Snel effect" op de werkbalk. Daarbij kun je de volgende parameters gebruiken:

    • Het verplaatsen van de afbeeldingen ten opzichte van het origineel (de z.g. Offset)
    • De transparantie van de nieuwe status (state) (met behulp van het alpha-kanaal)
    • De kleur en grootte van de tekst in de nieuwe status (state)


    Editor Rapid effect on button.png
    Editor Rapid effect on button action.png



    Frame Animation

    To create an item which animation cycle runs all the time:

    1. Create an item with the Multistate Button type and states containing animation frames
    2. The animation must run in cycles Repeat: True
    3. The feedback type Feedback: On will provide sequential cyclic display of the animation frames


    Editor examples of create animation logo.png

    To create an item which animation cycle starts running when receiving a non-zero value (logical one):

    1. Create an item with the Multistate Button type and states containing animation frames
    2. The animation must run in cycles Repeat: True
    3. Select the feedback type Feedback: Blink


    Editor examples of create animation element.png


    To create an item which animation cycle starts running at user pressings:

    1. Create an item with the Multistate Button type and states containing animation frames
    2. The animation must run in cycles Repeat: True
    3. Select the feedback type Feedback: Momentary


    Editor examples of create animation button.png



    Project Optimization

    Editor Delete Unused Files menu.png

    Use the Delete Unused Files option to delete images which were added in the project but are not actually used.

    Such images lengthen the time of upload and increase the project size. The frequent reason for appearance of such images is item scaling as the copies of images in the new size are created at that.

    Make sure your project does not have unused files before uploading it on your control panels:



    Project Merge

    Use the video-instruction to learn how to merge your project with a ready Script module (with its own graphic and driver parts) or any other project fast and easy:


    Источник — «https://dev.iridi.com/index.php?title=Editor_Tools/nl&oldid=63072»
    Категория:
    • Инструкции
    Over ons
    Vennootschap
    Het team
    Verhaal
    Filosofie
    Onderscheidingen
    Vennootschap
    Onze partners
    Partnerprogramma's
    Vraag een partnerschap aan
    Producten
    iRidium pro
    iRidium lite
    iRidium gate
    iRidium server
    Downloaden
    iRidium pro
    iRidium lite
    Andere versies
    Marketingmateriaal
    Ondersteuning
    Online cursussen / video's
    Aanbevolen uitrusting
    Andere versies
    iRidium pro
    Documentatie
    FAQ
    Het forum
    iRidium lite
    Documentatie
    Het forum
    Projecten
    Typische projecten
    Slimme gebouwen
    Slim huis
    Speciale oplossingen
    Vind een dealer
    Nieuws
    Youtube
    Twitter
    VK
    Logo
    contact@iridi.com
    +7 (499) 322-73-29

    Privacybeleid