Mosaic products documentation: Concepts, API Reference, Technical articles, How-to, Downloads and tools

Visible Video Watermarking

This job request section defines the content processing behavior for visible video watermarks along with an example of the output.

{
    "ContentProcessing" : {
        "VisibleVideoWatermarks": [
            {
                "WatermarkFileName": "axinom_drm.png",
                "PositionXPercentage": 20,
                "PositionYPercentage": 20,
                "StartTime": "00:00:10",
                "EndTime": "00:23:55",
                "FadeInDurationInMs": 1000,
                "FadeOutDurationInMs": 1000,
                "SizePercentage": 30,
                "OpacityPercentage": 100
            }
        ]
    }
}
visible video watermarking
Figure 1. Visible Video Watermark

Visible Video Watermark job request

Watermark Properties

WatermarkFileName: Specifies the file name of the watermark image that will be used from the acquisiton folder. For example, axinom_drm.png indicates the watermark file name is axinom_drm.png.

PositionXPercentage: Determines the horizontal position of the watermark on the video frame as a percentage. A value of 20 means the watermark is placed at 20% from the left edge of the video.

PositionYPercentage: Determines the vertical position of the watermark on the video frame as a percentage. A value of 20 means the watermark is placed at 20% from the top edge of the video.

StartTime: Defines the time offset from the start of the video when the watermark will first appear. Here, 00:00:10 means the watermark will appear 10 seconds into the video.

EndTime: Specifies the time at which the watermark will disappear. 00:23:55 means the watermark will be visible until 23 minutes and 55 seconds into the video.

FadeInDurationInMs: Represents the duration of the fade-in effect for the watermark in milliseconds. A value of 1000 indicates a fade-in duration of 1 second after StartTime.

FadeOutDurationInMs: Represents the duration of the fade-out effect for the watermark in milliseconds. A value of 1000 indicates a fade-out duration of 1 second before EndTime.

SizePercentage: Specifies the size of the watermark as a percentage of the video frame’s size. A value of 30 means the watermark’s size is 30% of the video frame’s dimensions.

OpacityPercentage: Defines the opacity level of the watermark. A value of 100 means the watermark is completely visible and a value of 0 means completely invisible.

Watermark Layering (Z-index)

In scenarios where multiple watermarks are defined and their display times and positions overlap, the order of the watermark definitions in the VisibleVideoWatermarks array determines their Z-index, or layering order. Watermarks listed later in the array are displayed in front of those listed earlier. This means that if two watermarks occupy the same position and time on the video, the one that appears later in the VisibleVideoWatermarks array will be visible on top of the previous watermark. This layering behavior allows for precise control over how multiple watermarks interact visually within the video.