Package org.kurento.client
Interface FaceOverlayFilter
-
- All Superinterfaces:
Filter
,KurentoObject
,MediaElement
,MediaObject
public interface FaceOverlayFilter extends Filter
FaceOverlayFilter interface. This type ofFilter
detects faces in a video feed. The face is then overlaid with an image.
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static class
FaceOverlayFilter.Builder
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description void
setOverlayedImage(String uri, float offsetXPercent, float offsetYPercent, float widthPercent, float heightPercent)
Sets the image to use as overlay on the detected faces.void
setOverlayedImage(String uri, float offsetXPercent, float offsetYPercent, float widthPercent, float heightPercent, Continuation<Void> cont)
Asynchronous version of setOverlayedImage:Continuation.onSuccess(F)
is called when the action is done.void
setOverlayedImage(Transaction tx, String uri, float offsetXPercent, float offsetYPercent, float widthPercent, float heightPercent)
Sets the image to use as overlay on the detected faces.void
unsetOverlayedImage()
Clear the image to be shown over each detected face.void
unsetOverlayedImage(Continuation<Void> cont)
Asynchronous version of unsetOverlayedImage:Continuation.onSuccess(F)
is called when the action is done.void
unsetOverlayedImage(Transaction tx)
Clear the image to be shown over each detected face.-
Methods inherited from interface org.kurento.client.KurentoObject
addEventListener, invoke, isCommited, release, release, release, removeEventListener, waitCommited, whenCommited, whenCommited
-
Methods inherited from interface org.kurento.client.MediaElement
addElementConnectedListener, addElementConnectedListener, addElementDisconnectedListener, addElementDisconnectedListener, addMediaFlowInStateChangedListener, addMediaFlowInStateChangedListener, addMediaFlowOutStateChangedListener, addMediaFlowOutStateChangedListener, addMediaTranscodingStateChangedListener, addMediaTranscodingStateChangedListener, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, connect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, disconnect, getEncoderBitrate, getEncoderBitrate, getEncoderBitrate, getGstreamerDot, getGstreamerDot, getGstreamerDot, getGstreamerDot, getGstreamerDot, getGstreamerDot, getMaxEncoderBitrate, getMaxEncoderBitrate, getMaxEncoderBitrate, getMinEncoderBitrate, getMinEncoderBitrate, getMinEncoderBitrate, getSinkConnections, getSinkConnections, getSinkConnections, getSinkConnections, getSinkConnections, getSinkConnections, getSinkConnections, getSinkConnections, getSinkConnections, getSourceConnections, getSourceConnections, getSourceConnections, getSourceConnections, getSourceConnections, getSourceConnections, getSourceConnections, getSourceConnections, getSourceConnections, getStats, getStats, getStats, getStats, getStats, getStats, isMediaFlowingIn, isMediaFlowingIn, isMediaFlowingIn, isMediaFlowingIn, isMediaFlowingIn, isMediaFlowingIn, isMediaFlowingOut, isMediaFlowingOut, isMediaFlowingOut, isMediaFlowingOut, isMediaFlowingOut, isMediaFlowingOut, isMediaTranscoding, isMediaTranscoding, isMediaTranscoding, isMediaTranscoding, isMediaTranscoding, isMediaTranscoding, removeElementConnectedListener, removeElementConnectedListener, removeElementDisconnectedListener, removeElementDisconnectedListener, removeMediaFlowInStateChangedListener, removeMediaFlowInStateChangedListener, removeMediaFlowOutStateChangedListener, removeMediaFlowOutStateChangedListener, removeMediaTranscodingStateChangedListener, removeMediaTranscodingStateChangedListener, setAudioFormat, setAudioFormat, setAudioFormat, setEncoderBitrate, setEncoderBitrate, setEncoderBitrate, setMaxEncoderBitrate, setMaxEncoderBitrate, setMaxEncoderBitrate, setMinEncoderBitrate, setMinEncoderBitrate, setMinEncoderBitrate, setVideoFormat, setVideoFormat, setVideoFormat
-
Methods inherited from interface org.kurento.client.MediaObject
addErrorListener, addErrorListener, addTag, addTag, addTag, getChildren, getChildren, getChildren, getCreationTime, getCreationTime, getCreationTime, getId, getId, getId, getMediaPipeline, getMediaPipeline, getMediaPipeline, getName, getName, getName, getParent, getParent, getParent, getSendTagsInEvents, getSendTagsInEvents, getSendTagsInEvents, getTag, getTag, getTag, getTags, getTags, getTags, removeErrorListener, removeErrorListener, removeTag, removeTag, removeTag, setName, setName, setName, setSendTagsInEvents, setSendTagsInEvents, setSendTagsInEvents
-
-
-
-
Method Detail
-
unsetOverlayedImage
void unsetOverlayedImage()
Clear the image to be shown over each detected face. Stops overlaying the faces.
-
unsetOverlayedImage
void unsetOverlayedImage(Continuation<Void> cont)
Asynchronous version of unsetOverlayedImage:Continuation.onSuccess(F)
is called when the action is done. If an error occurs,Continuation.onError(java.lang.Throwable)
is called.- See Also:
unsetOverlayedImage()
-
unsetOverlayedImage
void unsetOverlayedImage(Transaction tx)
Clear the image to be shown over each detected face. Stops overlaying the faces.
-
setOverlayedImage
void setOverlayedImage(String uri, float offsetXPercent, float offsetYPercent, float widthPercent, float heightPercent)
Sets the image to use as overlay on the detected faces.- Parameters:
uri
- URI where the image is locatedoffsetXPercent
- the offset applied to the image, from the X coordinate of the detected face upper right corner. A positive value indicates right displacement, while a negative value moves the overlaid image to the left. This offset is specified as a percentage of the face width. For example, to cover the detected face with the overlaid image, the parameter has to be0.0
. Values of1.0
or-1.0
indicate that the image upper right corner will be at the face´s X coord, +- the face´s width.
Note The parameter name is misleading, the value is not a percent but a ratiooffsetYPercent
- the offset applied to the image, from the Y coordinate of the detected face upper right corner. A positive value indicates up displacement, while a negative value moves the overlaid image down. This offset is specified as a percentage of the face width. For example, to cover the detected face with the overlaid image, the parameter has to be0.0
. Values of1.0
or-1.0
indicate that the image upper right corner will be at the face´s Y coord, +- the face´s width.
Note The parameter name is misleading, the value is not a percent but a ratiowidthPercent
- proportional width of the overlaid image, relative to the width of the detected face. A value of 1.0 implies that the overlaid image will have the same width as the detected face. Values greater than 1.0 are allowed, while negative values are forbidden.
Note The parameter name is misleading, the value is not a percent but a ratioheightPercent
- proportional height of the overlaid image, relative to the height of the detected face. A value of 1.0 implies that the overlaid image will have the same height as the detected face. Values greater than 1.0 are allowed, while negative values are forbidden.
Note The parameter name is misleading, the value is not a percent but a ratio
-
setOverlayedImage
void setOverlayedImage(String uri, float offsetXPercent, float offsetYPercent, float widthPercent, float heightPercent, Continuation<Void> cont)
Asynchronous version of setOverlayedImage:Continuation.onSuccess(F)
is called when the action is done. If an error occurs,Continuation.onError(java.lang.Throwable)
is called.- Parameters:
uri
- URI where the image is locatedoffsetXPercent
- the offset applied to the image, from the X coordinate of the detected face upper right corner. A positive value indicates right displacement, while a negative value moves the overlaid image to the left. This offset is specified as a percentage of the face width. For example, to cover the detected face with the overlaid image, the parameter has to be0.0
. Values of1.0
or-1.0
indicate that the image upper right corner will be at the face´s X coord, +- the face´s width.
Note The parameter name is misleading, the value is not a percent but a ratiooffsetYPercent
- the offset applied to the image, from the Y coordinate of the detected face upper right corner. A positive value indicates up displacement, while a negative value moves the overlaid image down. This offset is specified as a percentage of the face width. For example, to cover the detected face with the overlaid image, the parameter has to be0.0
. Values of1.0
or-1.0
indicate that the image upper right corner will be at the face´s Y coord, +- the face´s width.
Note The parameter name is misleading, the value is not a percent but a ratiowidthPercent
- proportional width of the overlaid image, relative to the width of the detected face. A value of 1.0 implies that the overlaid image will have the same width as the detected face. Values greater than 1.0 are allowed, while negative values are forbidden.
Note The parameter name is misleading, the value is not a percent but a ratioheightPercent
- proportional height of the overlaid image, relative to the height of the detected face. A value of 1.0 implies that the overlaid image will have the same height as the detected face. Values greater than 1.0 are allowed, while negative values are forbidden.
Note The parameter name is misleading, the value is not a percent but a ratio- See Also:
setOverlayedImage(java.lang.String, float, float, float, float)
-
setOverlayedImage
void setOverlayedImage(Transaction tx, String uri, float offsetXPercent, float offsetYPercent, float widthPercent, float heightPercent)
Sets the image to use as overlay on the detected faces.- Parameters:
uri
- URI where the image is locatedoffsetXPercent
- the offset applied to the image, from the X coordinate of the detected face upper right corner. A positive value indicates right displacement, while a negative value moves the overlaid image to the left. This offset is specified as a percentage of the face width. For example, to cover the detected face with the overlaid image, the parameter has to be0.0
. Values of1.0
or-1.0
indicate that the image upper right corner will be at the face´s X coord, +- the face´s width.
Note The parameter name is misleading, the value is not a percent but a ratiooffsetYPercent
- the offset applied to the image, from the Y coordinate of the detected face upper right corner. A positive value indicates up displacement, while a negative value moves the overlaid image down. This offset is specified as a percentage of the face width. For example, to cover the detected face with the overlaid image, the parameter has to be0.0
. Values of1.0
or-1.0
indicate that the image upper right corner will be at the face´s Y coord, +- the face´s width.
Note The parameter name is misleading, the value is not a percent but a ratiowidthPercent
- proportional width of the overlaid image, relative to the width of the detected face. A value of 1.0 implies that the overlaid image will have the same width as the detected face. Values greater than 1.0 are allowed, while negative values are forbidden.
Note The parameter name is misleading, the value is not a percent but a ratioheightPercent
- proportional height of the overlaid image, relative to the height of the detected face. A value of 1.0 implies that the overlaid image will have the same height as the detected face. Values greater than 1.0 are allowed, while negative values are forbidden.
Note The parameter name is misleading, the value is not a percent but a ratio
-
-