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.