Blender V4.5
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_listbase.h"
#include "BLI_rect.h"
#include "BLI_string.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_report.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 (ReportList *reports, bScreen *screen, ScrArea *sa1, ScrArea *sa2, eScreenDir dir)
static bool screen_areas_align (bContext *C, ReportList *reports, bScreen *screen, ScrArea *sa1, ScrArea *sa2, const eScreenDir dir)
static bool screen_area_join_aligned (bContext *C, ReportList *reports, 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, ReportList *reports, bScreen *screen, ScrArea *sa1, ScrArea *sa2, bool close_all_remainders)
int screen_area_join (bContext *C, ReportList *reports, bScreen *screen, ScrArea *sa1, ScrArea *sa2)
bool screen_area_close (bContext *C, ReportList *reports, 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)
bool area_regions_poll (bContext *C, const bScreen *screen, ScrArea *area)
static bool screen_regions_poll (bContext *C, wmWindow *win, const bScreen *screen)
static void screen_refresh_if_needed (bContext *C, wmWindowManager *wm, wmWindow *win)
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 313 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 273 of file screen_edit.cc.

References AREAJOINTOLERANCEX, AREAJOINTOLERANCEY, 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_regions_poll()

bool area_regions_poll ( bContext * C,
const bScreen * screen,
ScrArea * area )
Returns
true if any region polling state changed, and an area re-init is needed.

Definition at line 719 of file screen_edit.cc.

References C, CTX_wm_area(), CTX_wm_area_set(), CTX_wm_region(), CTX_wm_region_set(), CTX_wm_screen(), CTX_wm_screen_set(), ED_region_visibility_change_update_ex(), LISTBASE_FOREACH, region_poll(), ScrArea::regionbase, RGN_FLAG_HIDDEN, RGN_FLAG_POLL_FAILED, and V2D_IS_INIT.

Referenced by ED_area_init(), and screen_regions_poll().

◆ 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 98 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 945 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 1022 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 1011 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 898 of file screen_edit.cc.

References C, CTX_wm_manager(), CTX_wm_region(), CTX_wm_region_set(), CTX_wm_window(), LISTBASE_FOREACH, MEM_SAFE_FREE, wmWindowManager::message_bus, ARegion::panels, ARegion::regiontype, RGN_TYPE_TEMPORARY, ARegion::runtime, UI_panel_stop_animation(), 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 889 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 1840 of file screen_edit.cc.

References ANIMPLAY_FLAG_JUMPED, ANIMPLAY_FLAG_NO_SYNC, ANIMPLAY_FLAG_REVERSE, ANIMPLAY_FLAG_SYNC, bScreen::animtimer, C, RenderData::cfra, CLAMP, 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, PEFRA, PSFRA, Scene::r, ScreenAnimData::redraws, ScreenAnimData::region, 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 1913 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 1187 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 2038 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 1404 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 662 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, region_cursor_set(), WM_capabilities_flag(), WM_CAPABILITY_WINDOW_DECORATION_STYLES, and WM_window_decoration_style_apply().

Referenced by wm_event_do_notifiers().

◆ ED_screen_ensure_updated()

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

Definition at line 884 of file screen_edit.cc.

References C, and screen_refresh_if_needed().

Referenced by wm_draw_update().

◆ ED_screen_exit()

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

Definition at line 967 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(), depsgraph, ED_area_exit(), ED_region_exit(), wmWindow::global_areas, 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 1512 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 1545 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 1574 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 1335 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, screen_global_statusbar_area_refresh(), screen_global_topbar_area_refresh(), WM_window_is_main_top_level(), and wmWindow::workspace_hook.

Referenced by screen_refresh_if_needed(), and wm_window_ghostwindow_ensure().

◆ ED_screen_global_areas_sync()

void ED_screen_global_areas_sync ( wmWindow * win)

Definition at line 1318 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 849 of file screen_edit.cc.

References C, bScreen::do_refresh, screen_refresh_if_needed(), and WM_window_get_active_screen().

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 1558 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 1465 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 2059 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 2021 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 1085 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, LISTBASE_FOREACH, region_cursor_set_ex(), ScrArea::regionbase, RGN_TYPE_HEADER, RGN_TYPE_TOOL_HEADER, ARegion::runtime, screen_cursor_set(), 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 1683 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 1688 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, wmWindowManager::runtime, 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 1949 of file screen_edit.cc.

References bScreen::areabase, BKE_image_is_stereo(), View3D::camera, 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_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 1795 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 2064 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 857 of file screen_edit.cc.

References BKE_screen_header_alignment_reset(), BKE_workspace_active_get(), BKE_workspace_active_set(), BLI_SCOPED_DEFER, C, CTX_wm_window(), CTX_wm_window_set(), 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 1927 of file screen_edit.cc.

References BKE_scene_camera_switch_find(), BKE_scene_graph_update_for_newframe(), BKE_screen_view3d_scene_sync(), 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_PARAMETERS, 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(), and wm_event_do_notifiers().

◆ region_cursor_set()

void region_cursor_set ( wmWindow * win,
bool swin_changed )
static

Definition at line 648 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 637 of file screen_edit.cc.

References BLI_assert, ED_region_cursor_set(), ARegion::runtime, wmWindow::tag_cursor_refresh, 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 696 of file screen_edit.cc.

References BLI_assert_unreachable, C, params, and ARegion::runtime.

Referenced by area_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 196 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 76 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 57 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,
ReportList * reports,
bScreen * screen,
ScrArea * area )

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

Definition at line 591 of file screen_edit.cc.

References area_getorientation(), bScreen::areabase, C, LISTBASE_FOREACH, reports, 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 1213 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,
ReportList * reports,
bScreen * screen,
ScrArea * sa1,
ScrArea * sa2 )

Join any two neighboring areas. Might involve complex changes.

Definition at line 586 of file screen_edit.cc.

References C, reports, 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,
ReportList * reports,
bScreen * screen,
ScrArea * sa1,
ScrArea * sa2 )
static

Definition at line 470 of file screen_edit.cc.

References area_getorientation(), BKE_icon_changed(), BKE_screen_remove_double_scrverts(), C, ID::icon_id, bScreen::id, reports, 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,
ReportList * reports,
bScreen * screen,
ScrArea * sa1,
ScrArea * sa2,
bool close_all_remainders )
static

Definition at line 540 of file screen_edit.cc.

References bScreen::active_region, area_getoffsets(), area_getorientation(), BKE_icon_changed(), C, CTX_wm_area(), ED_area_tag_redraw(), ID::icon_id, bScreen::id, reports, 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 1230 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 623 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 514 of file screen_edit.cc.

References abs, area_split(), AREAJOINTOLERANCEX, AREAJOINTOLERANCEY, C, CTX_wm_window(), 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,
ReportList * reports,
bScreen * screen,
ScrArea * sa1,
ScrArea * sa2,
const eScreenDir dir )
static

Definition at line 426 of file screen_edit.cc.

References C, CTX_wm_window(), left, reports, 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 ( ReportList * reports,
bScreen * screen,
ScrArea * sa1,
ScrArea * sa2,
eScreenDir dir )
static

Definition at line 372 of file screen_edit.cc.

References abs, area_getoffsets(), bScreen::areabase, AREAJOINTOLERANCEX, AREAJOINTOLERANCEY, BKE_report(), ELEM, LISTBASE_FOREACH, reports, RPT_ERROR, SCREEN_DIR_IS_HORIZONTAL, SCREEN_DIR_IS_VERTICAL, SCREEN_DIR_NONE, ScrArea::v1, ScrArea::v3, ScrVert::vec, 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 1354 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, UI_popup_handlers_remove_all(), 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 1386 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 1036 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 218 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 87 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 1242 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 1285 of file screen_edit.cc.

References ceilf, ED_area_headersize(), 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 1303 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 1290 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 266 of file screen_edit.cc.

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

◆ screen_refresh_if_needed()

void screen_refresh_if_needed ( bContext * C,
wmWindowManager * wm,
wmWindow * win )
static

Refreshes the active screen of win if bScreen.do_refresh is set. Region polling is also done here, which will trigger a refresh on changes.

Screen refreshes should only be necessary if the screen layout changes in some way.

Definition at line 794 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 766 of file screen_edit.cc.

References area_regions_poll(), C, CTX_wm_area(), CTX_wm_area_set(), CTX_wm_region(), CTX_wm_region_set(), CTX_wm_window(), CTX_wm_window_set(), and ED_screen_areas_iter.

Referenced by screen_refresh_if_needed().

◆ screen_set_3dview_camera()

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

Definition at line 1430 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 1608 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 344 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 358 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 1892 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 for Blender by  doxygen 1.15.0