Block.faces_attributes

Block.faces_attributes(names=None, values=None, keys=None)

Get or set multiple attributes of multiple faces.

Parameters:
nameslist[str], optional

The names of the attribute. Default is None.

valueslist[Any], optional

The values of the attributes. Default is None.

keyslist[int], optional

A list of face identifiers.

Returns:
list[dict[str, Any]] | list[list[Any]] | None

If the parameter names is empty, a list containing per face an attribute dict with all attributes (default + custom) of the face. If the parameter names is not empty, a list containing per face a list of attribute values corresponding to the requested names. None if the function is used as a “setter”.

Raises:
KeyError

If any of the faces does not exist.