Reorder¶
Tools to reorder DXF entities by handle or a special sort handle mapping.
Such reorder mappings are stored only in layouts as Modelspace,
Paperspace or BlockLayout,
and can be retrieved by the method get_redraw_order().
Each entry in the handle mapping replaces the actual entity handle, where the “0” handle has a special meaning, this handle always shows up at last in ascending ordering.
- ezdxf.reorder.ascending(entities: Iterable[DXFGraphic], mapping: Optional[Union[dict, Iterable[tuple[str, str]]]] = None) Iterable[DXFGraphic]¶
Yields entities in ascending handle order.
The sort-handle doesn’t have to be the entity handle, every entity handle in mapping will be replaced by the given sort-handle, mapping is an iterable of 2-tuples (entity_handle, sort_handle) or a dict (entity_handle, sort_handle). Entities with equal sort-handles show up in source entities order.
- Parameters
entities – iterable of
DXFGraphicobjectsmapping – iterable of 2-tuples (entity_handle, sort_handle) or a handle mapping as dict.
- ezdxf.reorder.descending(entities: Iterable[DXFGraphic], mapping: Optional[Union[dict, Iterable[tuple[str, str]]]] = None) Iterable[DXFGraphic]¶
Yields entities in descending handle order.
The sort-handle doesn’t have to be the entity handle, every entity handle in mapping will be replaced by the given sort-handle, mapping is an iterable of 2-tuples (entity_handle, sort_handle) or a dict (entity_handle, sort_handle). Entities with equal sort-handles show up in reversed source entities order.
- Parameters
entities – iterable of
DXFGraphicobjectsmapping – iterable of 2-tuples (entity_handle, sort_handle) or a handle mapping as dict.