Block.face_attributes
- Block.face_attributes(key, names=None, values=None)
Get or set multiple attributes of a face.
- Parameters:
- keyint
The identifier of the face.
- nameslist[str], optional
A list of attribute names.
- valueslist[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.