Blender V4.3
Functions
screen_edit.cc File Reference
Blender » Editors » screen
#include <cmath>
#include <cstring>
#include "MEM_guardedalloc.h"
#include "DNA_object_types.h"
#include "DNA_scene_types.h"
#include "DNA_userdef_types.h"
#include "BLI_blenlib.h"
#include "BLI_utildefines.h"
#include "BKE_context.hh"
#include "BKE_global.hh"
#include "BKE_icons.h"
#include "BKE_image.hh"
#include "BKE_layer.hh"
#include "BKE_lib_id.hh"
#include "BKE_main.hh"
#include "BKE_scene.hh"
#include "BKE_screen.hh"
#include "BKE_sound.h"
#include "BKE_workspace.hh"
#include "WM_api.hh"
#include "WM_types.hh"
#include "ED_clip.hh"
#include "ED_node.hh"
#include "ED_screen.hh"
#include "ED_screen_types.hh"
#include "RNA_access.hh"
#include "RNA_enum_types.hh"
#include "UI_interface.hh"
#include "WM_message.hh"
#include "WM_toolsystem.hh"
#include "DEG_depsgraph_query.hh"
#include "screen_intern.hh"

Go to the source code of this file.

Functions

static ScrArea * screen_addarea_ex (ScrAreaMap *area_map, ScrVert *bottom_left, ScrVert *top_left, ScrVert *top_right, ScrVert *bottom_right, const eSpace_Type space_type)
static ScrArea * screen_addarea (bScreen *screen, ScrVert *left_bottom, ScrVert *left_top, ScrVert *right_top, ScrVert *right_bottom, const eSpace_Type space_type)
static void screen_delarea (bContext *C, bScreen *screen, ScrArea *area)
ScrArea * area_split (const wmWindow *win, bScreen *screen, ScrArea *area, const eScreenAxis dir_axis, const float fac, const bool merge)
bScreen * screen_add (Main *bmain, const char *name, const rcti *rect)
void screen_data_copy (bScreen *to, bScreen *from)
void screen_new_activate_prepare (const wmWindow *win, bScreen *screen_new)
eScreenDir area_getorientation (ScrArea *sa_a, ScrArea *sa_b)
void area_getoffsets (ScrArea *sa_a, ScrArea *sa_b, const eScreenDir dir, int *r_offset1, int *r_offset2)
static void screen_verts_halign (const wmWindow *win, const bScreen *screen, const short from_x, const short to_x)
static void screen_verts_valign (const wmWindow *win, const bScreen *screen, const short from_y, const short to_y)
static bool screen_areas_can_align (bScreen *screen, ScrArea *sa1, ScrArea *sa2, eScreenDir dir)
static bool screen_areas_align (bContext *C, bScreen *screen, ScrArea *sa1, ScrArea *sa2, const eScreenDir dir)
static bool screen_area_join_aligned (bContext *C, bScreen *screen, ScrArea *sa1, ScrArea *sa2)
static ScrArea * screen_area_trim (bContext *C, bScreen *screen, ScrArea **area, int size, eScreenDir dir, bool reverse)
static bool screen_area_join_ex (bContext *C, bScreen *screen, ScrArea *sa1, ScrArea *sa2, bool close_all_remainders)
int screen_area_join (bContext *C, bScreen *screen, ScrArea *sa1, ScrArea *sa2)
bool screen_area_close (bContext *C, bScreen *screen, ScrArea *area)
void screen_area_spacelink_add (const Scene *scene, ScrArea *area, eSpace_Type space_type)
static void region_cursor_set_ex (wmWindow *win, ScrArea *area, ARegion *region, bool swin_changed)
static void region_cursor_set (wmWindow *win, bool swin_changed)
void ED_screen_do_listen (bContext *C, const wmNotifier *note)
static bool region_poll (const bContext *C, const bScreen *screen, const ScrArea *area, const ARegion *region)
static bool screen_regions_poll (bContext *C, wmWindow *win, const bScreen *screen)
static void screen_refresh (bContext *C, wmWindowManager *wm, wmWindow *win, const bool force_full_refresh)
void ED_screen_refresh (bContext *C, wmWindowManager *wm, wmWindow *win)
void ED_screens_init (bContext *C, Main *bmain, wmWindowManager *wm)
void ED_screen_ensure_updated (bContext *C, wmWindowManager *wm, wmWindow *win)
void ED_region_remove (bContext *C, ScrArea *area, ARegion *region)
void ED_region_exit (bContext *C, ARegion *region)
void ED_area_exit (bContext *C, ScrArea *area)
void ED_screen_exit (bContext *C, wmWindow *window, bScreen *screen)
blender::StringRefNull ED_area_name (const ScrArea *area)
int ED_area_icon (const ScrArea *area)
static void screen_cursor_set (wmWindow *win, const int xy[2])
void ED_screen_set_active_region (bContext *C, wmWindow *win, const int xy[2])
int ED_screen_area_active (const bContext *C)
static ScrArea * screen_area_create_with_geometry (ScrAreaMap *area_map, const rcti *rect, eSpace_Type space_type)
static void screen_area_set_geometry_rect (ScrArea *area, const rcti *rect)
static void screen_global_area_refresh (wmWindow *win, bScreen *screen, const eSpace_Type space_type, GlobalAreaAlign align, const rcti *rect, const short height_cur, const short height_min, const short height_max)
static int screen_global_header_size ()
static void screen_global_topbar_area_refresh (wmWindow *win, bScreen *screen)
static void screen_global_statusbar_area_refresh (wmWindow *win, bScreen *screen)
void ED_screen_global_areas_sync (wmWindow *win)
void ED_screen_global_areas_refresh (wmWindow *win)
void screen_change_prepare (bScreen *screen_old, bScreen *screen_new, Main *bmain, bContext *C, wmWindow *win)
void screen_change_update (bContext *C, wmWindow *win, bScreen *screen)
bool ED_screen_change (bContext *C, bScreen *screen)
 Change the active screen.
static void screen_set_3dview_camera (Scene *scene, ViewLayer *view_layer, ScrArea *area, View3D *v3d)
void ED_screen_scene_change (bContext *C, wmWindow *win, Scene *scene, const bool refresh_toolsystem)
ScrArea * ED_screen_full_newspace (bContext *C, ScrArea *area, int type)
void ED_screen_full_prevspace (bContext *C, ScrArea *area)
void ED_screen_restore_temp_type (bContext *C, ScrArea *area)
void ED_screen_full_restore (bContext *C, ScrArea *area)
static bScreen * screen_state_to_nonnormal (bContext *C, wmWindow *win, ScrArea *toggle_area, int state)
bScreen * ED_screen_state_maximized_create (bContext *C)
ScrArea * ED_screen_state_toggle (bContext *C, wmWindow *win, ScrArea *area, const short state)
ScrArea * ED_screen_temp_space_open (bContext *C, const char *title, const rcti *rect_unscaled, eSpace_Type space_type, int display_type, bool dialog)
void ED_screen_animation_timer (bContext *C, int redraws, int sync, int enable)
static ARegion * time_top_left_3dwindow (bScreen *screen)
void ED_screen_animation_timer_update (bScreen *screen, int redraws)
void ED_update_for_newframe (Main *bmain, Depsgraph *depsgraph)
bool ED_screen_stereo3d_required (const bScreen *screen, const Scene *scene)
Scene * ED_screen_scene_find_with_window (const bScreen *screen, const wmWindowManager *wm, wmWindow **r_window)
ScrArea * ED_screen_area_find_with_spacedata (const bScreen *screen, const SpaceLink *sl, const bool only_visible)
Scene * ED_screen_scene_find (const bScreen *screen, const wmWindowManager *wm)
wmWindow * ED_screen_window_find (const bScreen *screen, const wmWindowManager *wm)

Function Documentation

◆ area_getoffsets()

void area_getoffsets ( ScrArea * sa_a,
ScrArea * sa_b,
eScreenDir dir,
int * r_offset1,
int * r_offset2 )

Get alignment offset of adjacent areas. 'dir' value is like area_getorientation().

Definition at line 310 of file screen_edit.cc.

References BLI_assert, SCREEN_DIR_E, SCREEN_DIR_N, SCREEN_DIR_NONE, SCREEN_DIR_S, SCREEN_DIR_W, ScrArea::v1, ScrArea::v2, ScrArea::v3, ScrArea::v4, ScrVert::vec, vec2s::x, and vec2s::y.

Referenced by area_docking_apply(), screen_area_join_ex(), screen_areas_can_align(), and screen_draw_join_highlight().

◆ area_getorientation()

eScreenDir area_getorientation ( ScrArea * sa_a,
ScrArea * sa_b )

with sa_a as center, sa_b is located at: 0=W, 1=N, 2=E, 3=S -1 = not valid check. used with join operator.

Definition at line 270 of file screen_edit.cc.

References AREAJOINTOLERANCEX, AREAJOINTOLERANCEY, int, SCREEN_DIR_NONE, ScrArea::v1, ScrArea::v3, ScrVert::vec, vec2s::x, and vec2s::y.

Referenced by area_close_poll(), area_docking_apply(), area_join_exec(), area_join_init(), area_join_update_data(), ED_area_has_shared_border(), screen_area_close(), screen_area_join_aligned(), screen_area_join_ex(), and screen_area_options_invoke().

◆ area_split()

ScrArea * area_split ( const wmWindow * win,
bScreen * screen,
ScrArea * area,
const eScreenAxis dir_axis,
const float fac,
const bool merge )

Definition at line 95 of file screen_edit.cc.

References BKE_screen_remove_double_scredges(), BKE_screen_remove_double_scrverts(), BKE_screen_remove_unused_scredges(), ED_area_data_copy(), merge(), screen_addarea(), SCREEN_AXIS_H, screen_geom_edge_add(), screen_geom_find_area_split_point(), screen_geom_vertex_add(), ScrArea::spacetype, split(), ScrArea::v1, ScrArea::v2, ScrArea::v3, ScrArea::v4, ScrVert::vec, WM_window_rect_calc(), vec2s::x, and vec2s::y.

Referenced by area_docking_apply(), area_join_modal(), area_split_apply(), and screen_area_trim().

◆ ED_area_exit()

void ED_area_exit ( bContext * C,
ScrArea * area )

Definition at line 885 of file screen_edit.cc.

References C, CTX_wm_area(), CTX_wm_area_set(), CTX_wm_manager(), CTX_wm_window(), ED_region_exit(), SpaceType::exit, ScrArea::handlers, LISTBASE_FOREACH, ScrArea::regionbase, ScrArea::type, WM_event_modal_handler_area_replace(), and WM_event_remove_handlers().

Referenced by ED_area_newspace(), ED_area_swapspace(), ED_screen_exit(), screen_delarea(), and WM_event_remove_handlers().

◆ ED_area_icon()

int ED_area_icon ( const ScrArea * area)

Definition at line 962 of file screen_edit.cc.

References EnumPropertyItem::icon, RNA_enum_from_value(), rna_enum_space_type_items, SpaceType::space_icon_get, ScrArea::spacetype, and ScrArea::type.

Referenced by screen_draw_area_drag_tip().

◆ ED_area_name()

blender::StringRefNull ED_area_name ( const ScrArea * area)

Definition at line 951 of file screen_edit.cc.

References EnumPropertyItem::name, RNA_enum_from_value(), rna_enum_space_type_items, SpaceType::space_name_get, ScrArea::spacetype, and ScrArea::type.

Referenced by screen_draw_area_drag_tip(), and WM_window_title().

◆ ED_region_exit()

void ED_region_exit ( bContext * C,
ARegion * region )

Definition at line 843 of file screen_edit.cc.

References C, CTX_wm_manager(), CTX_wm_region(), CTX_wm_region_set(), CTX_wm_window(), ARegionType::exit, ARegion::handlers, ARegion::headerstr, MEM_SAFE_FREE, wmWindowManager::message_bus, ARegion::regiontimer, ARegion::regiontype, RGN_TYPE_TEMPORARY, ARegion::type, ARegion::visible, WM_draw_region_free(), WM_event_modal_handler_region_replace(), WM_event_remove_handlers(), WM_event_timer_remove(), WM_event_ui_handler_region_popup_replace(), and WM_msgbus_clear_by_owner().

Referenced by ED_area_exit(), ED_region_remove(), ED_screen_exit(), and ui_region_temp_remove().

◆ ED_region_remove()

void ED_region_remove ( bContext * C,
ScrArea * area,
ARegion * region )

Utility to exit and free an area-region. Screen level regions (menus/popups) need to be treated slightly differently, see ui_region_temp_remove().

Definition at line 834 of file screen_edit.cc.

References BKE_area_region_free(), BLI_freelinkN(), C, ED_region_exit(), ScrArea::regionbase, and ScrArea::type.

Referenced by region_quadview_exec().

◆ ED_screen_animation_timer()

void ED_screen_animation_timer ( bContext * C,
int redraws,
int sync,
int enable )

redraws: uses defines from stime->redraws

Parameters
enable1 - forward on, -1 - backwards on, 0 - off.

Definition at line 1773 of file screen_edit.cc.

References ANIMPLAY_FLAG_NO_SYNC, ANIMPLAY_FLAG_REVERSE, ANIMPLAY_FLAG_SYNC, bScreen::animtimer, C, RenderData::cfra, CTX_data_scene(), CTX_wm_area(), CTX_wm_manager(), CTX_wm_region(), CTX_wm_screen(), CTX_wm_window(), wmTimer::customdata, DEG_id_tag_update(), ED_screen_animation_playing(), ELEM, ScreenAnimData::flag, FPS, ScreenAnimData::from_anim_edit, Scene::id, ID_RECALC_FRAME_CHANGE, MEM_callocN, NC_SCREEN, ND_ANIMPLAY, PRVRANGEON, RenderData::psfra, Scene::r, ScreenAnimData::redraws, ScreenAnimData::region, RenderData::sfra, ScreenAnimData::sfra, SPACE_ACTION, SPACE_GRAPH, SPACE_NLA, ScrArea::spacetype, TIMER0, WM_event_add_notifier(), WM_event_timer_add(), and WM_event_timer_remove().

Referenced by ED_screen_animation_play().

◆ ED_screen_animation_timer_update()

void ED_screen_animation_timer_update ( bScreen * screen,
int redraws )

Definition at line 1859 of file screen_edit.cc.

References bScreen::animtimer, wmTimer::customdata, ScreenAnimData::redraws, ScreenAnimData::region, TIME_REGION, and time_top_left_3dwindow().

◆ ED_screen_area_active()

int ED_screen_area_active ( const bContext * C)

Definition at line 1124 of file screen_edit.cc.

References bScreen::active_region, AZONE_REGION, C, CTX_wm_area(), CTX_wm_screen(), CTX_wm_window(), ED_area_actionzone_find_xy(), wmWindow::eventstate, LISTBASE_FOREACH, ScrArea::regionbase, AZone::type, and wmEvent::xy.

Referenced by blender::ed::outliner::outliner_highlight_update_invoke().

◆ ED_screen_area_find_with_spacedata()

ScrArea * ED_screen_area_find_with_spacedata ( const bScreen * screen,
const SpaceLink * sl,
const bool only_visible )

Definition at line 1990 of file screen_edit.cc.

References bScreen::areabase, BLI_findindex(), and LISTBASE_FOREACH.

◆ ED_screen_change()

bool ED_screen_change ( bContext * C,
bScreen * screen )

Change the active screen.

Operator call, WM + Window + screen already existed before

Warning
Do NOT call in area/region queues!
Returns
if screen changing was successful.

Definition at line 1337 of file screen_edit.cc.

References BKE_workspace_active_get(), BKE_workspace_layout_find(), BKE_workspace_layout_screen_get(), C, CTX_data_main(), CTX_wm_screen(), CTX_wm_window(), ED_workspace_screen_change_ensure_unused_layout(), screen_change_prepare(), screen_change_update(), WM_window_set_active_screen(), and wmWindow::workspace_hook.

Referenced by ED_screen_full_newspace(), ED_screen_state_toggle(), ED_workspace_layout_cycle(), wm_event_do_notifiers(), WM_window_open(), and workspace_layout_delete_doit().

◆ ED_screen_do_listen()

void ED_screen_do_listen ( bContext * C,
const wmNotifier * note )

Definition at line 641 of file screen_edit.cc.

References wmNotifier::action, C, wmNotifier::category, CTX_wm_screen(), CTX_wm_window(), wmNotifier::data, bScreen::do_draw, bScreen::do_refresh, NA_EDITED, NC_SCENE, NC_SCREEN, NC_WINDOW, NC_WM, ND_FILEREAD, ND_MODE, and region_cursor_set().

Referenced by wm_event_do_notifiers().

◆ ED_screen_ensure_updated()

void ED_screen_ensure_updated ( bContext * C,
wmWindowManager * wm,
wmWindow * win )

Definition at line 827 of file screen_edit.cc.

References C, and screen_refresh().

Referenced by wm_draw_update().

◆ ED_screen_exit()

void ED_screen_exit ( bContext * C,
wmWindow * window,
bScreen * screen )

Definition at line 907 of file screen_edit.cc.

References bScreen::active_region, bScreen::animtimer, bScreen::areabase, ScrAreaMap::areabase, BKE_sound_stop_scene(), C, CTX_data_depsgraph_pointer(), CTX_wm_manager(), CTX_wm_window(), CTX_wm_window_set(), DEG_get_evaluated_id(), depsgraph, ED_area_exit(), ED_region_exit(), wmWindow::global_areas, Scene::id, LISTBASE_FOREACH, bScreen::regionbase, bScreen::scrubbing, bScreen::winid, WM_event_timer_remove(), WM_window_get_active_scene(), and WM_window_is_temp_screen().

Referenced by screen_change_prepare(), WM_exit_ex(), wm_file_read_setup_wm_init(), and wm_window_close().

◆ ED_screen_full_newspace()

ScrArea * ED_screen_full_newspace ( bContext * C,
ScrArea * area,
int type )

Definition at line 1445 of file screen_edit.cc.

References bScreen::areabase, BLI_assert, C, ED_area_newspace(), ED_screen_change(), ED_screen_state_maximized_create(), ListBase::first, ScrArea::full, SpaceLink::link_flag, SPACE_EMPTY, SPACE_FLAG_TYPE_TEMPORARY, SPACE_FLAG_TYPE_WAS_ACTIVE, ScrArea::spacedata, and ScrArea::spacetype.

Referenced by ED_screen_temp_space_open(), and render_view_open().

◆ ED_screen_full_prevspace()

void ED_screen_full_prevspace ( bContext * C,
ScrArea * area )

was_prev_temp for the case previous space was a temporary full-screen as well

Definition at line 1478 of file screen_edit.cc.

References AREA_FLAG_STACKED_FULLSCREEN, BLI_assert, C, ED_area_prevspace(), ED_screen_restore_temp_type(), ScrArea::flag, and ScrArea::full.

Referenced by ED_screen_full_restore(), fullscreen_back_exec(), render_view_cancel_exec(), render_view_show_invoke(), and wm_handler_fileselect_do().

◆ ED_screen_full_restore()

void ED_screen_full_restore ( bContext * C,
ScrArea * area )

Restore a screen / area back to default operation, after temp full-screen modes.

Definition at line 1507 of file screen_edit.cc.

References C, CTX_wm_screen(), CTX_wm_window(), ED_screen_full_prevspace(), ED_screen_state_toggle(), ListBase::first, SpaceLink::link_flag, SpaceLink::next, SCREENMAXIMIZED, SPACE_FLAG_TYPE_TEMPORARY, ScrArea::spacedata, bScreen::state, and state.

Referenced by ED_workspace_layout_cycle().

◆ ED_screen_global_areas_refresh()

void ED_screen_global_areas_refresh ( wmWindow * win)

Definition at line 1272 of file screen_edit.cc.

References ScrAreaMap::areabase, BKE_screen_area_map_free(), BKE_workspace_active_screen_get(), bScreen::do_refresh, ListBase::first, wmWindow::global_areas, wmWindow::parent, screen_global_statusbar_area_refresh(), screen_global_topbar_area_refresh(), bScreen::temp, and wmWindow::workspace_hook.

Referenced by screen_refresh(), and wm_window_ghostwindow_ensure().

◆ ED_screen_global_areas_sync()

void ED_screen_global_areas_sync ( wmWindow * win)

Definition at line 1255 of file screen_edit.cc.

References ScrAreaMap::areabase, BKE_workspace_active_screen_get(), bScreen::flag, wmWindow::global_areas, LISTBASE_FOREACH, SCREEN_COLLAPSE_STATUSBAR, SPACE_STATUSBAR, and wmWindow::workspace_hook.

Referenced by area_move_apply_do().

◆ ED_screen_refresh()

void ED_screen_refresh ( bContext * C,
wmWindowManager * wm,
wmWindow * win )

Make this screen usable. for file read and first use, for scaling window, area moves.

Definition at line 801 of file screen_edit.cc.

References C, and screen_refresh().

Referenced by ED_screens_init(), screen_change_update(), wm_debug_menu_exec(), and WM_window_open().

◆ ED_screen_restore_temp_type()

void ED_screen_restore_temp_type ( bContext * C,
ScrArea * area )

Definition at line 1491 of file screen_edit.cc.

References C, CTX_wm_window(), ED_area_prevspace(), ED_area_tag_redraw(), ED_screen_state_toggle(), ListBase::first, ScrArea::full, SpaceLink::link_flag, SCREENMAXIMIZED, SPACE_FLAG_TYPE_TEMPORARY, and ScrArea::spacedata.

Referenced by ED_screen_full_prevspace().

◆ ED_screen_scene_change()

void ED_screen_scene_change ( bContext * C,
wmWindow * win,
Scene * scene,
const bool refresh_toolsystem )

Definition at line 1398 of file screen_edit.cc.

References bScreen::areabase, BKE_view_layer_active_object_get(), C, CTX_data_scene_set(), CTX_wm_window(), CTX_wm_workspace(), LISTBASE_FOREACH, WorkSpace::object_mode, wmWindow::scene, screen_set_3dview_camera(), SPACE_VIEW3D, UNUSED_VARS, WM_toolsystem_refresh_screen_window(), WM_window_ensure_active_view_layer(), WM_window_get_active_screen(), and WM_window_get_active_view_layer().

Referenced by WM_window_open(), and WM_window_set_active_scene().

◆ ED_screen_scene_find()

Scene * ED_screen_scene_find ( const bScreen * screen,
const wmWindowManager * wm )

Definition at line 2011 of file screen_edit.cc.

References ED_screen_scene_find_with_window().

◆ ED_screen_scene_find_with_window()

Scene * ED_screen_scene_find_with_window ( const bScreen * screen,
const wmWindowManager * wm,
wmWindow ** r_window )

Find the scene displayed in screen.

Note
Assumes screen to be visible/active!

Definition at line 1973 of file screen_edit.cc.

References LISTBASE_FOREACH, wmWindowManager::windows, WM_window_get_active_scene(), and WM_window_get_active_screen().

Referenced by ED_screen_scene_find().

◆ ED_screen_set_active_region()

void ED_screen_set_active_region ( bContext * C,
wmWindow * win,
const int xy[2] )

Called in wm_event_system.cc. sets state vars in screen, cursors. event type is mouse move.

Definition at line 1022 of file screen_edit.cc.

References bScreen::active_region, BORDERPADDING, C, ED_area_azones_update(), ED_region_contains_xy(), ED_region_tag_redraw_no_rebuild(), ED_screen_areas_iter, ELEM, ARegion::gizmo_map, LISTBASE_FOREACH, region_cursor_set_ex(), ScrArea::regionbase, RGN_TYPE_HEADER, RGN_TYPE_TOOL_HEADER, screen_cursor_set(), ARegion::type, UI_screen_free_active_but_highlight(), UNUSED_VARS, WM_cursor_test_motion_and_update(), WM_gizmo_highlight_set(), WM_window_get_active_screen(), WM_window_status_area_tag_redraw(), and xy.

Referenced by ED_screens_init(), and wm_event_do_handlers().

◆ ED_screen_state_maximized_create()

bScreen * ED_screen_state_maximized_create ( bContext * C)

Create a new temporary screen with a maximized, empty area. This can be closed with ED_screen_state_toggle().

Use this to just create a new maximized screen/area, rather than maximizing an existing one. Otherwise, maximize with ED_screen_state_toggle().

Definition at line 1616 of file screen_edit.cc.

References C, CTX_wm_window(), screen_state_to_nonnormal(), and SCREENMAXIMIZED.

Referenced by ED_screen_full_newspace().

◆ ED_screen_state_toggle()

ScrArea * ED_screen_state_toggle ( bContext * C,
wmWindow * win,
ScrArea * area,
short state )

This function toggles: if area is maximized/full then the parent will be restored.

Use ED_screen_state_maximized_create() if you do not want the toggle behavior when changing to a maximized area. I.e. if you just want to open a new maximized screen/area, not maximize a specific area. In the former case, space data of the maximized and non-maximized area should be independent, in the latter it should be the same.

Warning
area may be freed.

Definition at line 1621 of file screen_edit.cc.

References bScreen::animtimer, bScreen::areabase, ScrAreaMap::areabase, BKE_workspace_layout_remove(), BKE_workspace_layout_screen_get(), BLI_assert, C, CTX_data_main(), CTX_wm_area(), CTX_wm_area_set(), CTX_wm_manager(), CTX_wm_screen(), ED_area_data_swap(), ED_area_status_text(), ED_area_tag_refresh(), ED_screen_change(), ED_workspace_status_text(), ListBase::first, bScreen::flag, ScrArea::full, ScrArea::global, GLOBAL_AREA_IS_HIDDEN, wmWindow::global_areas, LISTBASE_FOREACH, ScrArea::regionbase, screen_state_to_nonnormal(), SCREENFULL, SCREENNORMAL, bScreen::skip_handling, bScreen::state, state, UI_blocklist_free(), WM_event_timer_remove(), WM_window_get_active_layout(), WM_window_get_active_screen(), and WM_window_get_active_workspace().

Referenced by ED_screen_full_restore(), ED_screen_restore_temp_type(), render_view_cancel_exec(), and screen_maximize_area_exec().

◆ ED_screen_stereo3d_required()

bool ED_screen_stereo3d_required ( const bScreen * screen,
const Scene * scene )
Returns
true if any active area requires to see in 3D.

Definition at line 1897 of file screen_edit.cc.

References bScreen::areabase, BKE_image_is_stereo(), View3D::camera, SpaceSeq::draw_flag, ED_node_is_compositor(), ELEM, ImageUser::flag, SpaceNode::flag, IMA_SHOW_STEREO, SpaceImage::image, SpaceImage::iuser, LISTBASE_FOREACH, RegionView3D::persp, Scene::r, R_MULTIVIEW, RGN_TYPE_WINDOW, RV3D_CAMOB, RenderData::scemode, SEQ_DRAW_BACKDROP, SEQ_VIEW_PREVIEW, SEQ_VIEW_SEQUENCE_PREVIEW, SNODE_BACKDRAW, SPACE_IMAGE, SPACE_NODE, SPACE_SEQ, SPACE_VIEW3D, View3D::stereo3d_camera, STEREO_3D_ID, and SpaceSeq::view.

Referenced by WM_stereo3d_enabled().

◆ ED_screen_temp_space_open()

ScrArea * ED_screen_temp_space_open ( bContext * C,
const char * title,
const rcti * rect_unscaled,
eSpace_Type space_type,
int display_type,
bool dialog )

Definition at line 1728 of file screen_edit.cc.

References AREA_FLAG_STACKED_FULLSCREEN, C, CTX_wm_area(), ED_area_newspace(), ED_screen_full_newspace(), ListBase::first, ScrArea::flag, ScrArea::full, SPACE_FLAG_TYPE_TEMPORARY, ScrArea::spacedata, USER_TEMP_SPACE_DISPLAY_FULLSCREEN, USER_TEMP_SPACE_DISPLAY_WINDOW, WIN_ALIGN_LOCATION_CENTER, and WM_window_open().

◆ ED_screen_window_find()

wmWindow * ED_screen_window_find ( const bScreen * screen,
const wmWindowManager * wm )

Definition at line 2016 of file screen_edit.cc.

References LISTBASE_FOREACH, wmWindowManager::windows, and WM_window_get_active_screen().

◆ ED_screens_init()

void ED_screens_init ( bContext * C,
Main * bmain,
wmWindowManager * wm )

File read, set all screens, ....

Definition at line 806 of file screen_edit.cc.

References BKE_screen_header_alignment_reset(), BKE_workspace_active_get(), BKE_workspace_active_set(), C, ED_screen_refresh(), ED_screen_set_active_region(), ListBase::first, LISTBASE_FOREACH, Main::screens, U, USER_HEADER_FROM_PREF, wmWindowManager::windows, and Main::workspaces.

Referenced by WM_check().

◆ ED_update_for_newframe()

void ED_update_for_newframe ( Main * bmain,
Depsgraph * depsgraph )

Results in fully updated anim system.

Definition at line 1873 of file screen_edit.cc.

References BKE_scene_graph_update_for_newframe(), BKE_screen_view3d_scene_sync(), camera, Scene::camera, RenderData::cfra, DEG_get_input_scene(), DEG_id_tag_update(), DEG_time_tag_update(), depsgraph, ED_clip_update_frame(), Scene::id, ID_RECALC_SYNC_TO_EVAL, LISTBASE_FOREACH, Scene::r, and Main::screens.

Referenced by bc_update_scene(), dynamicPaint_bakeImageSequence(), ED_scene_change_update(), fluid_bake_sequence(), fluid_free_startjob(), render_endjob(), screen_animation_step_invoke(), screen_render_exec(), wm_event_do_handlers(), and wm_event_do_notifiers().

◆ region_cursor_set()

void region_cursor_set ( wmWindow * win,
bool swin_changed )
static

Definition at line 627 of file screen_edit.cc.

References bScreen::active_region, ED_screen_areas_iter, LISTBASE_FOREACH, region_cursor_set_ex(), and WM_window_get_active_screen().

Referenced by ED_screen_do_listen().

◆ region_cursor_set_ex()

void region_cursor_set_ex ( wmWindow * win,
ScrArea * area,
ARegion * region,
bool swin_changed )
static

Definition at line 618 of file screen_edit.cc.

References BLI_assert, ED_region_cursor_set(), ARegionType::event_cursor, wmWindow::tag_cursor_refresh, ARegion::type, and WM_window_get_active_screen().

Referenced by ED_screen_set_active_region(), and region_cursor_set().

◆ region_poll()

bool region_poll ( const bContext * C,
const bScreen * screen,
const ScrArea * area,
const ARegion * region )
static

Definition at line 669 of file screen_edit.cc.

References BLI_assert_unreachable, C, params, ARegionType::poll, and ARegion::type.

Referenced by screen_regions_poll().

◆ screen_add()

bScreen * screen_add ( Main * bmain,
const char * name,
const rcti * rect )

Empty screen, with 1 dummy area without space-data. Uses window size.

Definition at line 193 of file screen_edit.cc.

References BKE_libblock_alloc(), bScreen::do_refresh, ID_SCR, bScreen::redraws_flag, screen_addarea(), screen_geom_edge_add(), screen_geom_vertex_add(), SPACE_EMPTY, TIME_ALL_3D_WIN, TIME_ALL_ANIM_WIN, rcti::xmax, rcti::xmin, rcti::ymax, and rcti::ymin.

Referenced by ED_workspace_layout_add().

◆ screen_addarea()

ScrArea * screen_addarea ( bScreen * screen,
ScrVert * left_bottom,
ScrVert * left_top,
ScrVert * right_top,
ScrVert * right_bottom,
const eSpace_Type space_type )
static

Definition at line 73 of file screen_edit.cc.

References AREAMAP_FROM_SCREEN, and screen_addarea_ex().

Referenced by area_split(), and screen_add().

◆ screen_addarea_ex()

ScrArea * screen_addarea_ex ( ScrAreaMap * area_map,
ScrVert * bottom_left,
ScrVert * top_left,
ScrVert * top_right,
ScrVert * bottom_right,
const eSpace_Type space_type )
static

Definition at line 54 of file screen_edit.cc.

References ScrAreaMap::areabase, BLI_addtail(), MEM_callocN, ScrArea::spacetype, ScrArea::v1, ScrArea::v2, ScrArea::v3, and ScrArea::v4.

Referenced by screen_addarea(), and screen_area_create_with_geometry().

◆ screen_area_close()

bool screen_area_close ( bContext * C,
bScreen * screen,
ScrArea * area )

Close a screen area, allowing most-aligned neighbor to take its place.

Definition at line 572 of file screen_edit.cc.

References area_getorientation(), bScreen::areabase, C, float, LISTBASE_FOREACH, screen_area_join_ex(), SCREEN_DIR_IS_VERTICAL, SCREEN_DIR_NONE, ScrArea::v1, ScrArea::v3, ScrVert::vec, vec2s::x, and vec2s::y.

Referenced by area_close_exec(), area_docking_apply(), area_join_modal(), and screen_area_join_ex().

◆ screen_area_create_with_geometry()

ScrArea * screen_area_create_with_geometry ( ScrAreaMap * area_map,
const rcti * rect,
eSpace_Type space_type )
static

Add an area and geometry (screen-edges and -vertices) for it to area_map, with coordinates/dimensions matching rect.

Definition at line 1150 of file screen_edit.cc.

References screen_addarea_ex(), screen_geom_edge_add_ex(), screen_geom_vertex_add_ex(), rcti::xmax, rcti::xmin, rcti::ymax, and rcti::ymin.

Referenced by screen_global_area_refresh().

◆ screen_area_join()

int screen_area_join ( bContext * C,
bScreen * screen,
ScrArea * sa1,
ScrArea * sa2 )

Join any two neighboring areas. Might involve complex changes.

Definition at line 567 of file screen_edit.cc.

References C, and screen_area_join_ex().

Referenced by area_docking_apply(), area_join_apply(), and area_split_cancel().

◆ screen_area_join_aligned()

bool screen_area_join_aligned ( bContext * C,
bScreen * screen,
ScrArea * sa1,
ScrArea * sa2 )
static

Definition at line 462 of file screen_edit.cc.

References area_getorientation(), BKE_icon_changed(), BKE_screen_remove_double_scrverts(), C, ID::icon_id, bScreen::id, screen_areas_align(), screen_delarea(), SCREEN_DIR_E, SCREEN_DIR_N, SCREEN_DIR_S, SCREEN_DIR_W, screen_geom_edge_add(), ScrArea::v1, ScrArea::v2, ScrArea::v3, and ScrArea::v4.

Referenced by screen_area_join_ex().

◆ screen_area_join_ex()

bool screen_area_join_ex ( bContext * C,
bScreen * screen,
ScrArea * sa1,
ScrArea * sa2,
bool close_all_remainders )
static

Definition at line 531 of file screen_edit.cc.

References area_getoffsets(), area_getorientation(), BKE_icon_changed(), C, ED_area_tag_redraw(), ID::icon_id, bScreen::id, screen_area_close(), screen_area_join_aligned(), screen_area_trim(), and SCREEN_DIR_NONE.

Referenced by screen_area_close(), and screen_area_join().

◆ screen_area_set_geometry_rect()

void screen_area_set_geometry_rect ( ScrArea * area,
const rcti * rect )
static

Definition at line 1167 of file screen_edit.cc.

References ScrArea::v1, ScrArea::v2, ScrArea::v3, ScrArea::v4, ScrVert::vec, vec2s::x, rcti::xmax, rcti::xmin, vec2s::y, rcti::ymax, and rcti::ymin.

Referenced by screen_global_area_refresh().

◆ screen_area_spacelink_add()

void screen_area_spacelink_add ( const Scene * scene,
ScrArea * area,
eSpace_Type space_type )

Definition at line 604 of file screen_edit.cc.

References BKE_spacetype_from_id(), BLI_addhead(), BLI_listbase_clear(), SpaceType::create, ScrArea::regionbase, SpaceLink::regionbase, and ScrArea::spacedata.

Referenced by area_init_type_fallback(), ED_area_offscreen_create(), and screen_global_area_refresh().

◆ screen_area_trim()

ScrArea * screen_area_trim ( bContext * C,
bScreen * screen,
ScrArea ** area,
int size,
eScreenDir dir,
bool reverse )
static

Definition at line 505 of file screen_edit.cc.

References abs(), area_split(), AREAJOINTOLERANCEX, AREAJOINTOLERANCEY, C, CTX_wm_window(), float, SCREEN_AXIS_H, SCREEN_AXIS_V, SCREEN_DIR_IS_VERTICAL, and size().

Referenced by screen_area_join_ex().

◆ screen_areas_align()

bool screen_areas_align ( bContext * C,
bScreen * screen,
ScrArea * sa1,
ScrArea * sa2,
const eScreenDir dir )
static

Definition at line 422 of file screen_edit.cc.

References C, CTX_wm_window(), left, screen_areas_can_align(), SCREEN_DIR_IS_HORIZONTAL, screen_verts_halign(), screen_verts_valign(), top, ScrArea::v1, ScrArea::v2, ScrArea::v3, ScrArea::v4, ScrVert::vec, vec2s::x, and vec2s::y.

Referenced by screen_area_join_aligned().

◆ screen_areas_can_align()

bool screen_areas_can_align ( bScreen * screen,
ScrArea * sa1,
ScrArea * sa2,
eScreenDir dir )
static

Definition at line 369 of file screen_edit.cc.

References abs(), area_getoffsets(), bScreen::areabase, AREAJOINTOLERANCEX, AREAJOINTOLERANCEY, ELEM, LISTBASE_FOREACH, RPT_ERROR, SCREEN_DIR_IS_HORIZONTAL, SCREEN_DIR_IS_VERTICAL, SCREEN_DIR_NONE, ScrArea::v1, ScrArea::v3, ScrVert::vec, WM_report(), vec2s::x, and vec2s::y.

Referenced by screen_areas_align().

◆ screen_change_prepare()

void screen_change_prepare ( bScreen * screen_old,
bScreen * screen_new,
Main * bmain,
bContext * C,
wmWindow * win )
Returns
the screen to activate.
Warning
The returned screen may not always equal screen_new!

Definition at line 1291 of file screen_edit.cc.

References bScreen::animtimer, bScreen::areabase, BLI_assert, BLI_findindex(), C, CTX_wm_manager(), ED_screen_exit(), LISTBASE_FOREACH, wmWindow::modalhandlers, Main::screens, UNUSED_VARS_NDEBUG, WM_event_remove_area_handler(), and WM_event_timer_sleep().

Referenced by ED_screen_change(), and ED_workspace_change().

◆ screen_change_update()

void screen_change_update ( bContext * C,
wmWindow * win,
bScreen * screen )

Definition at line 1319 of file screen_edit.cc.

References BKE_screen_view3d_scene_sync(), BKE_workspace_active_get(), BKE_workspace_layout_find(), C, CTX_wm_manager(), CTX_wm_window_set(), ED_screen_refresh(), NC_SCREEN, NC_WINDOW, ND_LAYOUTSET, WM_event_add_mousemove(), WM_event_add_notifier(), WM_window_get_active_scene(), and wmWindow::workspace_hook.

Referenced by ED_screen_change(), and ED_workspace_change().

◆ screen_cursor_set()

void screen_cursor_set ( wmWindow * win,
const int xy[2] )
static

Definition at line 976 of file screen_edit.cc.

References AE_LEFT_TO_TOPRIGHT, AE_RIGHT_TO_TOPLEFT, bScreen::areabase, AZONE_AREA, AZONE_REGION, AZONE_REGION_SCROLL, ED_area_actionzone_find_xy(), AZone::edge, ELEM, LISTBASE_FOREACH, screen_geom_edge_is_horizontal(), screen_geom_find_active_scredge(), AZone::type, WM_CURSOR_DEFAULT, WM_CURSOR_EDIT, WM_cursor_set(), WM_CURSOR_X_MOVE, WM_CURSOR_Y_MOVE, WM_window_get_active_screen(), and xy.

Referenced by ED_screen_set_active_region().

◆ screen_data_copy()

void screen_data_copy ( bScreen * to,
bScreen * from )

Definition at line 215 of file screen_edit.cc.

References bScreen::areabase, BKE_screen_free_data(), BKE_screen_sort_scrvert(), BLI_duplicatelist(), BLI_listbase_clear(), ED_area_data_copy(), bScreen::edgebase, ListBase::first, bScreen::flag, LISTBASE_FOREACH, ScrVert::newv, ScrArea::next, ScrVert::next, bScreen::regionbase, ScrArea::v1, and bScreen::vertbase.

Referenced by ED_workspace_layout_duplicate().

◆ screen_delarea()

void screen_delarea ( bContext * C,
bScreen * screen,
ScrArea * area )
static

Definition at line 84 of file screen_edit.cc.

References bScreen::areabase, BKE_screen_area_free(), BLI_remlink(), C, ED_area_exit(), and MEM_freeN().

Referenced by screen_area_join_aligned().

◆ screen_global_area_refresh()

void screen_global_area_refresh ( wmWindow * win,
bScreen * screen,
const eSpace_Type space_type,
GlobalAreaAlign align,
const rcti * rect,
const short height_cur,
const short height_min,
const short height_max )
static

Definition at line 1179 of file screen_edit.cc.

References ScrGlobalAreaData::align, ScrAreaMap::areabase, ScrGlobalAreaData::cur_fixed_height, bScreen::do_refresh, ScrArea::global, wmWindow::global_areas, LISTBASE_FOREACH, MEM_callocN, screen_area_create_with_geometry(), screen_area_set_geometry_rect(), screen_area_spacelink_add(), SCREENFULL, ScrGlobalAreaData::size_max, ScrGlobalAreaData::size_min, bScreen::state, and WM_window_get_active_scene().

Referenced by screen_global_statusbar_area_refresh(), and screen_global_topbar_area_refresh().

◆ screen_global_header_size()

int screen_global_header_size ( )
static

Definition at line 1222 of file screen_edit.cc.

References ceilf, ED_area_headersize(), int, and UI_SCALE_FAC.

Referenced by screen_global_statusbar_area_refresh(), and screen_global_topbar_area_refresh().

◆ screen_global_statusbar_area_refresh()

void screen_global_statusbar_area_refresh ( wmWindow * win,
bScreen * screen )
static

Definition at line 1240 of file screen_edit.cc.

References BLI_rcti_init(), bScreen::flag, GLOBAL_AREA_ALIGN_BOTTOM, SCREEN_COLLAPSE_STATUSBAR, screen_global_area_refresh(), screen_global_header_size(), size(), SPACE_STATUSBAR, WM_window_native_pixel_size(), rcti::ymax, and rcti::ymin.

Referenced by ED_screen_global_areas_refresh().

◆ screen_global_topbar_area_refresh()

void screen_global_topbar_area_refresh ( wmWindow * win,
bScreen * screen )
static

Definition at line 1227 of file screen_edit.cc.

References BLI_rcti_init(), GLOBAL_AREA_ALIGN_TOP, screen_global_area_refresh(), screen_global_header_size(), size(), SPACE_TOPBAR, WM_window_native_pixel_size(), rcti::ymax, and rcti::ymin.

Referenced by ED_screen_global_areas_refresh().

◆ screen_new_activate_prepare()

void screen_new_activate_prepare ( const wmWindow * win,
bScreen * screen_new )

Prepare a newly created screen for initializing it as active screen.

Definition at line 263 of file screen_edit.cc.

References bScreen::do_draw, bScreen::do_refresh, bScreen::winid, and wmWindow::winid.

◆ screen_refresh()

void screen_refresh ( bContext * C,
wmWindowManager * wm,
wmWindow * win,
const bool force_full_refresh )
static
Parameters
force_full_refreshIf false, a full refresh will only be performed if the screen is tagged for refresh (bScreen.do_refresh), or region polling changes require a refresh.

Definition at line 741 of file screen_edit.cc.

References bScreen::animtimer, C, bScreen::context, bScreen::do_refresh, ED_area_and_region_types_init(), ED_area_init(), ED_screen_areas_iter, ed_screen_context(), ED_screen_global_areas_refresh(), G, G_DEBUG_EVENTS, wmWindow::ghostwin, printf, screen_geom_vertices_scale(), screen_regions_poll(), bScreen::winid, wmWindow::winid, WM_event_timer_sleep(), WM_window_get_active_screen(), and WM_window_set_dpi().

Referenced by ED_screen_ensure_updated(), and ED_screen_refresh().

◆ screen_regions_poll()

bool screen_regions_poll ( bContext * C,
wmWindow * win,
const bScreen * screen )
static
Returns
true if any region polling state changed, and a screen refresh is needed.

Definition at line 695 of file screen_edit.cc.

References C, CTX_wm_area(), CTX_wm_area_set(), CTX_wm_region(), CTX_wm_region_set(), CTX_wm_window(), CTX_wm_window_set(), ED_region_visibility_change_update(), ED_screen_areas_iter, LISTBASE_FOREACH, region_poll(), RGN_FLAG_POLL_FAILED, and V2D_IS_INIT.

Referenced by screen_refresh().

◆ screen_set_3dview_camera()

void screen_set_3dview_camera ( Scene * scene,
ViewLayer * view_layer,
ScrArea * area,
View3D * v3d )
static

Definition at line 1363 of file screen_edit.cc.

References BKE_screen_view3d_sync(), BKE_view_layer_base_find(), BKE_view_layer_camera_find(), BKE_view_layer_synced_ensure(), View3D::camera, ListBase::first, LISTBASE_FOREACH, RegionView3D::persp, ScrArea::regionbase, View3D::regionbase, RGN_TYPE_WINDOW, RV3D_CAMOB, RV3D_PERSP, and ScrArea::spacedata.

Referenced by ED_screen_scene_change().

◆ screen_state_to_nonnormal()

bScreen * screen_state_to_nonnormal ( bContext * C,
wmWindow * win,
ScrArea * toggle_area,
int state )
static
Parameters
toggle_areaIf this is set, its space data will be swapped with the one of the new empty area, when toggling back it can be swapped back again.
Returns
The newly created screen with the non-normal area.
Note
The caller must run ED_screen_change this is not done in this function as it would attempt to initialize areas that don't yet have a space-type assigned (converting them to 3D view without creating the space-data).

Definition at line 1541 of file screen_edit.cc.

References bScreen::animtimer, bScreen::areabase, ScrAreaMap::areabase, BKE_workspace_layout_screen_get(), BLI_assert, C, CTX_data_main(), ED_area_data_swap(), ED_area_tag_refresh(), ED_workspace_layout_add(), ELEM, ListBase::first, bScreen::flag, ScrArea::flag, ScrArea::full, GLOBAL_AREA_IS_HIDDEN, wmWindow::global_areas, bScreen::id, LISTBASE_FOREACH, MAX_ID_NAME, ID::name, bScreen::redraws_flag, ScrArea::regionbase, RGN_FLAG_HIDDEN, RGN_TYPE_ASSET_SHELF, RGN_TYPE_ASSET_SHELF_HEADER, RGN_TYPE_EXECUTE, RGN_TYPE_FOOTER, RGN_TYPE_HEADER, RGN_TYPE_NAV_BAR, RGN_TYPE_TOOL_HEADER, RGN_TYPE_TOOLS, RGN_TYPE_UI, SCREENFULL, SCREENMAXIMIZED, SNPRINTF, bScreen::state, state, bScreen::temp, WM_window_get_active_screen(), and WM_window_get_active_workspace().

Referenced by ED_screen_state_maximized_create(), and ED_screen_state_toggle().

◆ screen_verts_halign()

void screen_verts_halign ( const wmWindow * win,
const bScreen * screen,
const short from_x,
const short to_x )
static

Definition at line 341 of file screen_edit.cc.

References ED_screen_verts_iter.

Referenced by screen_areas_align().

◆ screen_verts_valign()

void screen_verts_valign ( const wmWindow * win,
const bScreen * screen,
const short from_y,
const short to_y )
static

Definition at line 355 of file screen_edit.cc.

References ED_screen_verts_iter.

Referenced by screen_areas_align().

◆ time_top_left_3dwindow()

ARegion * time_top_left_3dwindow ( bScreen * screen)
static

Definition at line 1838 of file screen_edit.cc.

References bScreen::areabase, LISTBASE_FOREACH, min, RGN_TYPE_WINDOW, and SPACE_VIEW3D.

Referenced by ED_screen_animation_timer_update().

Generated on Sat Oct 4 2025 05:32:23 for Blender by  doxygen 1.14.0