Skip to main content

Banner Support

Display banners, marquee text, and image carousels in HMI pages.

Draft

This documentation is a draft and will be updated after testing.

Overview

TOR Reference: 3.1.1.5

Banner support enables displaying dynamic content in HMI pages including scrolling text, static images, and image carousels.

TypeDescription
Text MarqueeScrolling text ticker
Static ImageSingle image display
CarouselRotating image slideshow

Configuration

Banners are configured in Settings > Banner Settings.

PropertyDescription
NameDisplay name for the banner
TypeMarquee, Static, or Carousel
ItemsList of content items
PropertyDescription
ContentText or image URL
DurationDisplay duration (for carousel)
OrderDisplay order

Marquee Options

OptionDescription
Scroll DirectionLeft, Right, Up, Down
Scroll SpeedPixels per second
Background ColorBackground color
Text ColorText color

Transition Effects

For carousel banners:

EffectDescription
FadeCrossfade between images
SlideSlide animation
NoneInstant switch

Technical Implementation

Entity Structure

public class BannerContent : BaseMasterEntity
{
public string Name { get; set; }
public int BannerType { get; set; }
public IList<BannerItem> Items { get; set; }
}

public class BannerItem : BaseEntity
{
public string Content { get; set; }
public int Duration { get; set; }
public int DisplayOrder { get; set; }
}

API Endpoints

MethodEndpointDescription
GET/api/bannersettingsList all banners
GET/api/bannersettings/{id}Get banner by ID
POST/api/bannersettingsCreate banner
PUT/api/bannersettings/{id}Update banner
DELETE/api/bannersettings/{id}Delete banner