Interface ImageOverlayFilter

All Superinterfaces:
Filter, KurentoObject, MediaElement, MediaObject

public interface ImageOverlayFilter extends Filter
ImageOverlayFilter interface. This type of Filter draws an image in a configured position over a video feed.
  • Method Details

    • removeImage

      void removeImage(String id)
      Remove the image with the given ID.
      Parameters:
      id - Image ID to be removed
    • removeImage

      void removeImage(String id, Continuation<Void> cont)
      Asynchronous version of removeImage: Continuation.onSuccess(F) is called when the action is done. If an error occurs, Continuation.onError(java.lang.Throwable) is called.
      Parameters:
      id - Image ID to be removed
      See Also:
    • removeImage

      void removeImage(Transaction tx, String id)
      Remove the image with the given ID.
      Parameters:
      id - Image ID to be removed
    • addImage

      void addImage(String id, String uri, float offsetXPercent, float offsetYPercent, float widthPercent, float heightPercent, boolean keepAspectRatio, boolean center)
      Add an image to be used as overlay.
      Parameters:
      id - image ID
      uri - URI where the image is located
      offsetXPercent - Percentage relative to the image width to calculate the X coordinate of the position (left upper corner) [0..1]
      offsetYPercent - Percentage relative to the image height to calculate the Y coordinate of the position (left upper corner) [0..1]
      widthPercent - Proportional width of the overlaid image, relative to the width of the video [0..1].
      heightPercent - Proportional height of the overlaid image, relative to the height of the video [0..1].
      keepAspectRatio - Keep the aspect ratio of the original image.
      center - If the image doesn't fit in the dimensions, the image will be center into the region defined by height and width.
    • addImage

      void addImage(String id, String uri, float offsetXPercent, float offsetYPercent, float widthPercent, float heightPercent, boolean keepAspectRatio, boolean center, Continuation<Void> cont)
      Asynchronous version of addImage: Continuation.onSuccess(F) is called when the action is done. If an error occurs, Continuation.onError(java.lang.Throwable) is called.
      Parameters:
      id - image ID
      uri - URI where the image is located
      offsetXPercent - Percentage relative to the image width to calculate the X coordinate of the position (left upper corner) [0..1]
      offsetYPercent - Percentage relative to the image height to calculate the Y coordinate of the position (left upper corner) [0..1]
      widthPercent - Proportional width of the overlaid image, relative to the width of the video [0..1].
      heightPercent - Proportional height of the overlaid image, relative to the height of the video [0..1].
      keepAspectRatio - Keep the aspect ratio of the original image.
      center - If the image doesn't fit in the dimensions, the image will be center into the region defined by height and width.
      See Also:
    • addImage

      void addImage(Transaction tx, String id, String uri, float offsetXPercent, float offsetYPercent, float widthPercent, float heightPercent, boolean keepAspectRatio, boolean center)
      Add an image to be used as overlay.
      Parameters:
      id - image ID
      uri - URI where the image is located
      offsetXPercent - Percentage relative to the image width to calculate the X coordinate of the position (left upper corner) [0..1]
      offsetYPercent - Percentage relative to the image height to calculate the Y coordinate of the position (left upper corner) [0..1]
      widthPercent - Proportional width of the overlaid image, relative to the width of the video [0..1].
      heightPercent - Proportional height of the overlaid image, relative to the height of the video [0..1].
      keepAspectRatio - Keep the aspect ratio of the original image.
      center - If the image doesn't fit in the dimensions, the image will be center into the region defined by height and width.