Screen Operators¶

bpy.ops.screen.actionzone(modifier=0)¶

Handle area action zones for mouse actions/gestures

Parameters:	modifier (int in [0, 2], (optional)) – Modifier, Modifier state

bpy.ops.screen.animation_cancel(restore_frame=True)¶

Cancel animation, returning to the original frame

Parameters:	restore_frame (boolean, (optional)) – Restore Frame, Restore the frame when animation was initialized

bpy.ops.screen.animation_play(reverse=False, sync=False)¶

Play animation

Parameters:	reverse (boolean, (optional)) – Play in Reverse, Animation is played backwards sync (boolean, (optional)) – Sync, Drop frames to maintain framerate

bpy.ops.screen.animation_step()¶: Step through animation by position

bpy.ops.screen.area_dupli()¶: Duplicate selected area into new window

bpy.ops.screen.area_join(min_x=-100, min_y=-100, max_x=-100, max_y=-100)¶

Join selected areas into new window

Parameters:	min_x (int in [-inf, inf], (optional)) – X 1 min_y (int in [-inf, inf], (optional)) – Y 1 max_x (int in [-inf, inf], (optional)) – X 2 max_y (int in [-inf, inf], (optional)) – Y 2

bpy.ops.screen.area_move(x=0, y=0, delta=0)¶

Move selected area edges

Parameters:	x (int in [-inf, inf], (optional)) – X y (int in [-inf, inf], (optional)) – Y delta (int in [-inf, inf], (optional)) – Delta

bpy.ops.screen.area_options()¶: Operations for splitting and merging

bpy.ops.screen.area_split(direction='HORIZONTAL', factor=0.5, cursor=(0, 0))¶

Split selected area into new windows

Parameters:	direction (enum in ['HORIZONTAL', 'VERTICAL'], (optional)) – Direction factor (float in [0, 1], (optional)) – Factor cursor (int array of 2 items in [-inf, inf], (optional)) – Cursor

bpy.ops.screen.area_swap()¶: Swap selected areas screen positions

bpy.ops.screen.back_to_previous()¶: Revert back to the original screen layout, before fullscreen area overlay

bpy.ops.screen.delete()¶: Delete active screen

bpy.ops.screen.drivers_editor_show()¶: Show drivers editor in a separate window

bpy.ops.screen.frame_jump(end=False)¶

Jump to first/last frame in frame range

Parameters:	end (boolean, (optional)) – Last Frame, Jump to the last frame of the frame range

bpy.ops.screen.frame_offset(delta=0)¶

Move current frame forward/backward by a given number

Parameters:	delta (int in [-inf, inf], (optional)) – Delta

bpy.ops.screen.header_toggle_menus()¶: Expand or collapse the header pulldown menus

bpy.ops.screen.keyframe_jump(next=True)¶

Jump to previous/next keyframe

Parameters:	next (boolean, (optional)) – Next Keyframe

bpy.ops.screen.marker_jump(next=True)¶

Jump to previous/next marker

Parameters:	next (boolean, (optional)) – Next Marker

bpy.ops.screen.new()¶: Add a new screen

bpy.ops.screen.redo_last()¶: Display menu for last action performed

bpy.ops.screen.region_blend()¶: Blend in and out overlapping region

bpy.ops.screen.region_context_menu()¶: Display region context menu

bpy.ops.screen.region_flip()¶: Toggle the region’s alignment (left/right or top/bottom)

bpy.ops.screen.region_quadview()¶: Split selected area into camera, front, right & top views

bpy.ops.screen.region_scale()¶: Scale selected area

bpy.ops.screen.repeat_history(index=0)¶

Display menu for previous actions performed

Parameters:	index (int in [0, inf], (optional)) – Index

bpy.ops.screen.repeat_last()¶: Repeat last action

bpy.ops.screen.screen_full_area(use_hide_panels=False)¶

Toggle display selected area as fullscreen/maximized

Parameters:	use_hide_panels (boolean, (optional)) – Hide Panels, Hide all the panels

bpy.ops.screen.screen_set(delta=0)¶

Cycle through available screens

Parameters:	delta (int in [-inf, inf], (optional)) – Delta

bpy.ops.screen.screenshot(filepath="", check_existing=True, filter_blender=False, filter_backup=False, filter_image=True, filter_movie=False, filter_python=False, filter_font=False, filter_sound=False, filter_text=False, filter_btx=False, filter_collada=False, filter_alembic=False, filter_folder=True, filter_blenlib=False, filemode=9, show_multiview=False, use_multiview=False, display_type='DEFAULT', sort_method='FILE_SORT_ALPHA', full=True)¶

Capture a picture of the active area or whole Blender window

Parameters:

filepath (string, (optional, never None)) – File Path, Path to file
check_existing (boolean, (optional)) – Check Existing, Check and warn on overwriting existing files
filter_blender (boolean, (optional)) – Filter .blend files
filter_backup (boolean, (optional)) – Filter .blend files
filter_image (boolean, (optional)) – Filter image files
filter_movie (boolean, (optional)) – Filter movie files
filter_python (boolean, (optional)) – Filter python files
filter_font (boolean, (optional)) – Filter font files
filter_sound (boolean, (optional)) – Filter sound files
filter_text (boolean, (optional)) – Filter text files
filter_btx (boolean, (optional)) – Filter btx files
filter_collada (boolean, (optional)) – Filter COLLADA files
filter_alembic (boolean, (optional)) – Filter Alembic files
filter_folder (boolean, (optional)) – Filter folders
filter_blenlib (boolean, (optional)) – Filter Blender IDs
filemode (int in [1, 9], (optional)) – File Browser Mode, The setting for the file browser mode to load a .blend file, a library or a special file
show_multiview (boolean, (optional)) – Enable Multi-View
use_multiview (boolean, (optional)) – Use Multi-View
display_type (enum in ['DEFAULT', 'LIST_SHORT', 'LIST_LONG', 'THUMBNAIL'], (optional)) –
Display Type
- DEFAULT Default, Automatically determine display type for files.
- LIST_SHORT Short List, Display files as short list.
- LIST_LONG Long List, Display files as a detailed list.
- THUMBNAIL Thumbnails, Display files as thumbnails.
sort_method (enum in ['FILE_SORT_ALPHA', 'FILE_SORT_EXTENSION', 'FILE_SORT_TIME', 'FILE_SORT_SIZE'], (optional)) –
File sorting mode
- FILE_SORT_ALPHA Sort alphabetically, Sort the file list alphabetically.
- FILE_SORT_EXTENSION Sort by extension, Sort the file list by extension/type.
- FILE_SORT_TIME Sort by time, Sort files by modification time.
- FILE_SORT_SIZE Sort by size, Sort files by size.
full (boolean, (optional)) – Full Screen, Capture the whole window (otherwise only capture the active area)

bpy.ops.screen.space_context_cycle(direction='NEXT')¶

Cycle through the editor context by activating the next/previous one

Parameters:	direction (enum in ['PREV', 'NEXT'], (optional)) – Direction, Direction to cycle through

bpy.ops.screen.space_type_set_or_cycle(space_type='EMPTY')¶

Set the space type or cycle sub-type

Parameters:

space_type (enum in ['EMPTY', 'VIEW_3D', 'IMAGE_EDITOR', 'NODE_EDITOR', 'SEQUENCE_EDITOR', 'CLIP_EDITOR', 'DOPESHEET_EDITOR', 'GRAPH_EDITOR', 'NLA_EDITOR', 'TEXT_EDITOR', 'CONSOLE', 'INFO', 'TOPBAR', 'STATUSBAR', 'OUTLINER', 'PROPERTIES', 'FILE_BROWSER', 'PREFERENCES'], (optional)) –

Type

EMPTY Empty.
VIEW_3D 3D Viewport, Manipulate objects in a 3D environment.
IMAGE_EDITOR UV/Image Editor, View and edit images and UV Maps.
NODE_EDITOR Node Editor, Editor for node-based shading and compositing tools.
SEQUENCE_EDITOR Video Sequencer, Video editing tools.
CLIP_EDITOR Movie Clip Editor, Motion tracking tools.
DOPESHEET_EDITOR Dope Sheet, Adjust timing of keyframes.
GRAPH_EDITOR Graph Editor, Edit drivers and keyframe interpolation.
NLA_EDITOR Nonlinear Animation, Combine and layer Actions.
TEXT_EDITOR Text Editor, Edit scripts and in-file documentation.
CONSOLE Python Console, Interactive programmatic console for advanced editing and script development.
INFO Info, Log of operations, warnings and error messages.
TOPBAR Top Bar, Global bar at the top of the screen for global per-window settings.
STATUSBAR Status Bar, Global bar at the bottom of the screen for general status information.
OUTLINER Outliner, Overview of scene graph and all available data-blocks.
PROPERTIES Properties, Edit properties of active object and related data-blocks.
FILE_BROWSER File Browser, Browse for files and assets.
PREFERENCES Preferences, Edit persistent configuration settings.

bpy.ops.screen.spacedata_cleanup()¶: Remove unused settings for invisible editors

bpy.ops.screen.userpref_show()¶: Edit user preferences and system settings

bpy.ops.screen.workspace_cycle(direction='NEXT')¶

Cycle through workspaces

Parameters:	direction (enum in ['PREV', 'NEXT'], (optional)) – Direction, Direction to cycle through