Shapes

Show color shapes on your visualization device

Table of contents

  1. Structure
  2. Validation
    1. General parameters (common for all shapes)
    2. Box specific
  3. Restrictions

Structure

With this shapes visualization app you can display different kinds of shapes on your visualization device. This can be useful for lighting up a certain part of your led stripe or wall. For example this app can be used for background lightning in a product shelve which should highlight certain products which are stored in the shelve depending on user actions.

The shapes app is an array of shapes to define multiple shapes at the same time. Each shape has a type (e.g. box) which defines what kind of shape is shown. For defining the position and size of the shapes we are using a relative measure. This means that you can choose a value between 0.0-1.0. Eventually easyvis.io is transforming this to the actual size of your LED stripe or wall. Note that you might need to try a bit to find the right positions and sizes of your shapes.

For all shape types it is always necessary to define the center by specifying centerX and centerY as relative positions.

Currently just the box shape is supported but we are working on supporting more shapes in the future.

Example box shapes which shows two different boxes in different colors:

[
  {
    "type": "box",
    "centerX": 0.25,
    "centerY": 0.5,
    "width": 0.5,
    "height": 1,
    "color": "#2332FF"
  },
  {
    "type": "box",
    "centerX": 0.75,
    "centerY": 0.5,
    "width": 0.5,
    "height": 1,
    "color": "#FF0055"
  }
]

Validation

General parameters (common for all shapes)

Config parameter Description Required Allowed Values Default
type Type of shape yes box not defined
centerX Relative position of the center on the x-axis yes 0.0 <= centerX <= 1.0 not defined
centerY Relative position of the center on the y-axis yes 0.0 <= centerY <= 1.0 not defined
color Color of the shape yes Six-digit hexadecimal notation, e.g. #0099CC not defined

Box specific

Config parameter Description Required Allowed Values Default
width Relative width of the box yes 0.0 <= width <= 1.0 not defined
height Relative height of the box yes 0.0 <= height <= 1.0 not defined

Restrictions

The shapes visualization app does not yet work with a hdmi device output.