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[str], optional) – A list of attribute names.

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

Returns

dict[str, Any] | list[Any] | 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.