-
Notifications
You must be signed in to change notification settings - Fork 0
API Class CellEditController
Bo Chen edited this page Apr 24, 2026
·
2 revisions
Edit-workflow controller that coordinates selection, preview, and redraw behavior across many cells.
- Module:
icescopy_cell_controller - File:
src/icescopy_cell_controller.py - Line:
42
- Bases:
object
Edit-workflow controller that coordinates selection, preview, and redraw behavior across many cells.
| Variable | Line | Explanation |
|---|---|---|
SINGLE_EDIT_MODES |
50 | Stores single edit modes. |
GRID_PREVIEW_MODES |
51 | Stores grid preview modes. |
| Attribute | First assigned in | Line | Explanation |
|---|---|---|---|
group_cell_ids |
__init__ |
55 | Stores group cell ids. |
group_ordered_cell_ids |
__init__ |
56 | Stores group ordered cell ids. |
group_reference_cells |
__init__ |
57 | Stores group reference cells. |
main_window |
__init__ |
54 | Stores main window. |
updating_preview_handle |
__init__ |
58 | Stores updating preview handle. |
| Method | Line | Explanation |
|---|---|---|
__init__(main_window) |
53 | Initializes the instance. |
reset() |
60 | Resets internal state for this object. |
is_single_edit_mode(tool_mode=None) |
66 | Returns whether single edit mode. |
is_group_edit_mode() |
70 | Returns whether group edit mode. |
is_any_edit_mode(tool_mode=None) |
73 | Returns whether any edit mode. |
uses_grid_preview() |
77 | Returns whether grid preview. |
uses_grid_panel() |
80 | Returns whether grid panel. |
uses_circle_panel() |
89 | Returns whether circle panel. |
is_single_preview_mode() |
92 | Returns whether single preview mode. |
selected_scene_items() |
95 | Returns selected scene items. |
selected_scene_cell_ids() |
98 | Returns selected scene cell ids. |
reset_edit_chosen() |
113 | Resets edit chosen. |
mark_edit_targets(cell_ids) |
118 | Marks edit targets. |
get_target_items() |
124 | Returns target items. |
get_edit_chosen_items() |
135 | Returns edit chosen items. |
_principal_axes(points) |
143 | Implements principal axes. |
anchor_to_current_image(cell_items) |
171 | Build fresh scene items anchored to the current image slot. |
_anchored_geometry(item) |
202 | Implements anchored geometry. |
redraw_current_cells(preserve_selection=True, force_scene_scan=False) |
418 | Implements redraw current cells. |
redraw_interpolated_cells(frame_index, preview=False) |
431 | Implements redraw interpolated cells. |
rebase_edit_preview_to_current_frame() |
453 | Keep pinned edit previews attached to the same edit targets after frame changes. |
add_single_cell(circle_position, circle_pixel_position, circle_size) |
485 | Implements add single cell. |
replace_active_edit_cell(circle_position, circle_pixel_position, circle_size) |
501 | Implements replace active edit cell. |
delete_cell_by_id(cell_id) |
544 | Implements delete cell by ID. |
set_group_cells_from_items(selected_items, preserve_existing=False) |
565 | Sets group cells from items. |
enter_edit_mode(restored_mode=None) |
581 | Enter the appropriate edit sub-mode from the current scene cell set. |
start_edit_choose() |
614 | Starts edit choose. |
start_single_edit(cell_item) |
627 | Starts single edit. |
start_group_edit(selected_items, preserve_preview=False) |
631 | Starts group edit. |
infer_grid_parameters_from_cells(selected_items) |
679 | Infer a best-fit grid from the selected items. |
_cluster_axis(values, radii) |
717 | Implements cluster axis. |
_infer_spatial_order(selected_items) |
740 | Return cell IDs ordered by their current geometric layout. |
_infer_group_reference(selected_items) |
744 | Freeze the selected group's local reference frame for one edit session. |
float_preview() |
921 | Implements float preview. |
pin_preview_from_cell_layout(selected_items) |
937 | Pins preview from cell layout. |
pin_current_preview(log_change=False) |
952 | Pins current preview. |
_preview_count() |
1001 | Implements preview count. |
preview_capacity() |
1010 | Implements preview capacity. |
get_preview_definitions() |
1013 | Returns preview definitions. |
order_grid_add_definitions_for_cell_ids(definitions) |
1054 | Orders grid add definitions for cell ids. |
get_preview_radii() |
1072 | Returns preview radii. |
| Method | Line | Explanation |
|---|---|---|
remove_preview_handle() |
780 | Removes preview handle. |
ensure_preview_handle() |
791 | Ensures preview handle. |
move_pinned_preview_to_scene_pos(scene_pos) |
830 | Move a pinned preview without forcing users back into floating mode. |
cancel_preview(log_message=True) |
865 | Cancels preview. |
apply_grid_add() |
1116 | Applies grid add. |
apply_single_add() |
1146 | Applies single add. |
apply_single_edit() |
1166 | Applies single edit. |
apply_group_edit() |
1191 | Applies group edit. |
handle_grid_apply_action() |
1306 | Handles grid apply action. |
handle_circle_apply_action() |
1312 | Handles circle apply action. |
handle_grid_cancel_action() |
1318 | Handles grid cancel action. |
handle_circle_cancel_action() |
1321 | Handles circle cancel action. |
| Method | Line | Explanation |
|---|---|---|
handle_wheel_adjustment(event, wheel_delta) |
1324 | Handles wheel adjustment. |
| Method | Line | Explanation |
|---|---|---|
update_scene_selectable_state() |
101 | Updates scene selectable state. |
clear_scene_selection(clear_group=True) |
106 | Clears scene selection. |
clear_group_cells() |
138 | Clears group cells. |
_sync_scene_items_from_models(source_items, preserve_selected_cell_ids=None, forced_edit_cell_ids=None, force_scene_scan=False) |
211 | Implements sync scene items from models. |
_fast_sync_scene_items_for_preview(source_items, forced_edit_cell_ids=None) |
369 | Implements fast sync scene items for preview. |
sync_preview_handle() |
803 | Synchronizes preview handle. |
clear_preview() |
855 | Clears preview. |
update_preview_from_scene_pos(scene_pos, pin=False, log_change=True) |
975 | Updates preview from scene pos. |
update_preview() |
1088 | Updates preview. |
update_grid_panel_state() |
1243 | Updates grid panel state. |
| Method | Line | Explanation |
|---|---|---|
restore_scene_cell_ids(cell_ids, sync_tool_panel=True) |
168 | Restores scene cell ids. |