HalfFace.face_attributes

HalfFace.face_attributes(face, names=None, values=None)[source]

Get or set multiple attributes of a face.

Parameters

  • face (int) – The identifier of the face.

  • names (list, optional) – A list of attribute names.

  • values (list, optional) – A list of attribute values.

Returns

dict, list or None – If the parameter names is empty, a dictionary of all attribute name-value pairs of the face. If the parameter names is not empty, a list of the values corresponding to the provided names. None if the function is used as a “setter”.

Raises

KeyError – If the face does not exist.