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.