Block.faces_attribute

Block.faces_attribute(name, value=None, keys=None)

Get or set an attribute of multiple faces.

Parameters:
namestr

The name of the attribute.

valueobject, optional

The value of the attribute. Default is None.

keyslist[int], optional

A list of face identifiers.

Returns:
list[Any] | None

A list containing the value per face of the requested attribute, or None if the function is used as a “setter”.

Raises:
KeyError

If any of the faces does not exist.