Configuring slide views

A slide view determines one particular slide to display from a slide cycler.

Slide views are configured in the slide_views section of awesign.yaml. An example configuration looks like this:

slide_views:
  - name: davis_tv1
    slide_cycler: hallway_cycler
    offset_count: 0
    offset_percent: 0
    transition: none
  - name: davis_tv2
    slide_cycler: hallway_cycler
    offset_count: 0
    offset_percent: 50
    transition: fade
  - name: davis_tv3
    slide_cycler: hallway_cycler
    offset_count: -1
    offset_percent: -33.33
    transition: slide

• name is a unique identifier for the slide cycler. The front-end SlideShow component will use this to retrieve the correct slide view.
• slide_cycler is the name of the slide cycler that this slide view should get its slides from.
• offset_count is a relative offset that should be applied to the slide cycler's position. This is useful if you have multiple displays next to each other and want to achieve a "conveyer belt" effect. This can be a positive or negative integer.
• offset_percent is a percentage-based relative offset similar to offset_count. This is more useful if you have multiple displays that aren't near each other that you want to synchronize. This can be a positive or negative integer or float.
• transition is the animation that will be played between slide switches. Valid options are:
  • none: Abruptly switch to the next slide
  • fade: Fade between slides
  • slide: Slide the previous slide off the screen while the new one slides in (right to left)
  • wipe: Reveal the next slide in-place by wiping right to left
  • flip: Rotate the previous slide in 3D to reveal the next slide on the back of it

Example use cases

Three hallway TVs

If you have three hallway TVs, and you want to ensure they don't show the same slide simultaneously, create three slide views that each use the same slide cycler. The offset_count should be the same for each (probably 0 unless you have a particular reason to change it). The offset_percent should be evenly spread into thirds across the three slide views. Display 1 should have offset_percent=0, display 2 should have offset_percent=33.33, and display 3 should have offset_percent=66.66. This way, the slides will be evenly spaced out among the three displays, and they won't display the same slide simultaneously (unless there aren't enough slides to guarantee that). The transition can be anything you'd like, but it's probably cleanest to stay consistent.