An item defines what is drawn to a tile. Example items:

• Image
• Video
• Web page
• Text

The item object TDJ must include a player to be used to render the item and additional data for example a uri pointing to the location of the data.

Media that does not have an inherent duration, for example images, requires duration to be specified. This value is in seconds.

Web pages and other items that have a variable output resolutions require pixelWidth and pixelHeight to be defined. The resolution specified by the item is independent of the display resolution and scaling is automatic.

See built in players.

A tile specifies a list of items to play sequentially and positioning information.

The tile object TDJ must include a list of items to display.

Margins can be used to position the tile. Margins are values between 0 and 1 relative to the screen size (or outer tile size when in a composite). This example displays the tile 10% from left and right edges and 5% from top and bottom. By default all margins are zero.

Items are drawn to OpenGL textures and rendered inside the tile. The scaling used to fit an item into an area defined by a tile can be specified by scaleMode in each item data. This is used when aspect ratios differ. Scale modes include:

• border - Display a border around the non-fitting item. (Color can be set by background value)
• crop - Make the item fit by filling the tile and cropping excess pixels.
• stretch - Distort the aspect ratio of the item to match the tile dimensions.
• pan - Performs crop but moves the item right or down while the item plays to show the full area.

Tile displaying a dog image followed by a cat video

{
    "data": {
        "marginLeft": "0.1",
        "marginRight": "0.1",
        "marginTop": "0.05",
        "marginBottom": "0.05"
    },
    "items": [
        {
            "player": "ImagePlayer",
            "data": {
                "label": "Funny dog",
                "scaleMode": "pan",
                "duration": "10.0",
                "uri": "http://example.com/dog.jpg"
            }
        },
        {
            "player": "VideoPlayer",
            "data": {
                "label": "Funny cat video",
                "uri": "http://example.com/cat.mp4"
            }
        }
    ]
}
                        

A composite item defines a list of tiles to display at the same time. A CompositePlayer is used to display the tiles.

The composite object TDJ must include a list of tiles to display. A duration should also be specified.

A composite acts like a wrapper to display multiple internal tiles as if they are a single item. This means a composite can contain tiles that contain additional composites. This hierarchical, grouping structure makes complicated display arrangements possible.

Items within each tile are loaded and prepared concurrently because each tile has its own independent controller.

Composite displaying a dog image next to a cat video

{
    "player": "CompositePlayer",
    "data": {
        "label": "Dog and cat composite",
        "duration": "10.0"
    },
    "tiles": [
        {
            "data": {
                "marginRight": "0.5"
            },
            "items": [
                {
                    "player": "ImagePlayer",
                    "data": {
                        "label": "Funny dog",
                        "duration": "10.0",
                        "uri": "http://example.com/dog.jpg"
                    }
                }
            ]
        },
        {
            "data": {
                "marginLeft": "0.5"
            },
            "items": [
                {
                    "player": "VideoPlayer",
                    "data": {
                        "label": "Funny cat video",
                        "uri": "http://example.com/cat.mp4"
                    }
                }
            ]
        }
    ]
}
                        

A playlist is a list of items that should display sequentially on a layer.

The TDJ for a playlist is analogous to that of a tile. The data object can specify margins and can include a loop value to define what happens after the last item in a list.

SignageNode supports 4 layers that each progress through an independent playlist. Layers are placed on top of one another and use the full resolution of the screen. Tile positioning and transparency in the layers makes it possible for each layer to contribute to the final output.

Playlist for a layer

{
    "data": {
        "loop": "true",
        "marginTop": "0.05"
    },
    "items": [
        ...
    ]
}