Menu

Image / Video Facelet

The Image Facelet renders an image from a URL or local file. It also supports video streams.

Configuration

  • Position
    X, Y position of the top-left corner in screen coordinates [mil].

  • Size
    Width and height in [mil].

  • Pivot
    Rotation pivot point X, Y in [mil].

  • Rotation
    Rotation angle in degrees.

  • Fill Mode
    How the image is scaled to fit the target area.

    Mode Description

    Fill

    Scale image to fill the area, cropping if necessary.

    Fit

    Scale image to fit inside the area, preserving aspect ratio.

    Center

    Center the image without scaling.

    Original

    Display at original size with optional offset.

    Crop X

    Crop the image horizontally to fill.

    Crop Y

    Crop the image vertically to fill.

    Stretch

    Stretch the image to fill the area, ignoring aspect ratio.

  • Offset X / Offset Y
    Pixel offset for Original fill mode.

  • Image URL
    The URL of the image to display. Supports data binding expressions.
    Special placeholders in the URL: $USER, $PASS, $PARA are replaced by the configured confidential parameters. $TIME is replaced by the current timestamp.

  • HTTP Method

    Method Description

    Get

    HTTP GET request (default).

    Post

    HTTP POST request.

    Put

    HTTP PUT request.

  • Authentication

    Method Description

    None

    No authentication.

    Basic

    HTTP Basic authentication.

    Token

    Bearer Token authentication.

  • Username / Password / Token
    Credentials for the selected authentication method.

  • Confidential URL Parameters
    Username, password and optional parameter for URL placeholders $USER, $PASS, $PARA.

  • Video Mode
    Enable for video stream sources.

  • Refresh Interval
    Refresh interval for reloading the image, like 30s or 5m. 0 disables automatic refresh.

  • Cache
    Cache external images so they are available on restart.

  • Brightness
    Image brightness adjustment from -100 to 100.

  • Visibility
    A condition expression. The Facelet is displayed if this evaluates to 1.

  • Display Mode

    Mode Description

    Normal

    This Facelet is only displayed in interactive (normal) mode.

    Ambient

    This Facelet is only displayed in ambient mode.

    Always

    This Facelet is displayed in both interactive and ambient mode.

  • Ambient Brightness
    Brightness adjustment for ambient mode from -100 to 100.