Tag effects

Tag effects

A DISPLAX Active OR tag offers two features of feedback: light and vibration.

There are two ways these features can be used:
  • programmaticaly (see DisplaxSDK),
  • on Displax Connect (mainly for testing purposes, see here),


The sleep mode timeout is reset after an effect execution.


Light effects

A Tag has a ring light all around it, which will activate if it receives a light effect action. For a light effect action to be executed, besides the tag ID, the action must send the following parameters:

  • color, 
  • effect, 
  • number of cycles the effect will be executed,
  • time duration of each cycle (milisseconds).


Details on each parameter:

color

RGB value, in hexadecimal notation. Example: a light effect in red should define the color as FF0000.

effect

there are 6 effects available:


effect ID

Effect

Comments

0

FadeToColor

Fade from last effect color to new color. The fade takes time duration milisseconds to reach the final color.  

This effect is power consuming, as the final color will remain active, until a different effect is sent or the tag enters sleep mode.

1

Blink

Fade from last color to color (20% duty cycle), maintains the color (60% duty cycle), and fade to blackness (20% duty cycle).

2

ShortPulse

Fade from last color to color (20% duty cycle) and fade to blackness (80% duty cycle).

3

TriangularWave

Fade from last color to color (50% duty cycle) and fade to blackness (50% duty cycle).

4

ToothsawWave

Fade from last color to color (99% duty cycle) and goes to blackness (1% duty cycle).

5

Heartbeat

color (10% duty cycle), followed by blackness (10% duty cycle), followed by color with 20% brigthness (20% duty cycle), followed by darkness (60% duty cycle)


number of cycles

the number of consecutive executions/repetitions of the selected effect

time duration

number of milisseconds the effect will take to be executed on each cycle.


Vibration effects

A tag has a vibration motor inside, which will engage if it receives a vibration effect action. For a vibration effect action be executed,besides the tag ID, the action must send the following parameters:

  • number of cycles, 
  • level, 
  • time_on of each cycle (milisseconds),
  • time_off of each cycle (milisseconds).


Details on each parameter:

number of cycles

the number of consecutive executions/repetitions of the selected effec. A cycle will take time_on+time_off milissecondsto execute. The action total execution time will be (time_on+time_of)*number of cycles.

level

vibration level or intensity. Ranges from 0 (no vibration) to 100 (full intensity).

time_on

time in milisseconds the vibration motor is turned on, on each cycle 

time_off

time in milisseconds the vibration motor is turned off, on each cycle


    • Related Articles

    • Effects editor

      Within Displax Connect it is possible to customize the the color and vibration effects.  To access the Effects editor follow the steps show on the link below: 

    • Light codes

      On specific tasks and contexts, the tag will show light effects. These light effects should be understood as light codes, as they identify a specific system state or system task result. The light codes, and their meanings are listed below: Entering ...

    • Overview

      DISPLAX Active Object Recognition (DPXActiveOR) solution is a combo of hardware and middleware, which enables interactive solutions developers to integrate and deliver powerful Object Recognition (OR) interactive experiences, going beyond traditional ...

    • Reset button operation

      The Reset button has various functions. The different functions are triggered depending on the amount of time the button is pressed for. The button, accessible through a small hole at the bottom of the tag,  should be pressed using a small pin, ...

    • Change ID and Name

      You can change the the ID and Name of a tag from within Displax Connect.  This is useful if, for example, you want to change the the tag with ID 1 to 2, since the ID is automatically attributed by pairing order. Each tag also has a name attributed by ...