def __init__(self, expression, intensity=Default(), speed=Default(), duration=Default(), feedback_cb=None, done_cb=None):
""" Makes the robot perform a facial expression, e.g. smile.
The default values for the intensity, speed and duration of each gesture are specified in the robots IExpression
enumeration definition.
This function is asynchronous and returns an ActionHandle.
:param expression: The type of expression to perform, an IExpression enumeration member (e.g.for Zeno, Expression.Smile).
:type expression: IExpression subclass member
:param intensity: The strength of the expression e.g. a smile with an intensity of 1.0 is the largest possible smile
(normalised between 0.0 < speed <= 1.0).
:type intensity: float, Default
:param speed: how fast the expression is performed, e.g. a smile expression with a speed of 1.0 is
performed at the fastest possible speed (normalized between 0.0 <= speed <= 1.0). If Default() then the
expression is performed at its default speed.
:type speed: float, Default
:param duration: how long the expression lasts (seconds). If Default() then the expression is performed for its
default duration. Use positive infinity for a never ending expression, hint: float('inf')
:type duration: float, Default
:param feedback_cb: a function that will be called when the state of the expression action changes. The function
should have one parameter, which will be filled with a ExpressionActionFeedback instance.
:type feedback_cb: Callable
:param done_cb: a function that will be called when the expression action finishes.
:type done_cb: Callable
:return: an action handle to keep track of the action
:rtype: MultiGoalActionHandle
:raises TypeError: expression is not an IExpression member, intensity is not a float or Default, speed is not a
float or Default, duration is not a float or Default, feedback_cb is not None or Callable, done_cb is not None or Callable
"""
TypeChecker.accepts(inspect.currentframe().f_code.co_name,
(IExpression, (Default, float), (Default, float), (Default, float), (None, Callable), (None, Callable)),
expression, intensity, speed, duration, feedback_cb, done_cb)
IExpressionGoal.__init__(self)
self.expression = expression.name
if intensity is Default:
self.intensity = expression.default_intensity
else:
self.intensity = intensity
if speed is Default:
self.speed = expression.default_speed
else:
self.speed = speed
if self.duration is Default:
self.duration = expression.default_duration
else:
self.duration = duration
