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.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 header display
Expand or collapse the header pulldown menus
-
bpy.ops.screen.header_toolbox()¶ Display header region toolbox
-
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_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
DEFAULTDefault, Automatically determine display type for files.LIST_SHORTShort List, Display files as short list.LIST_LONGLong List, Display files as a detailed list.THUMBNAILThumbnails, 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_ALPHASort alphabetically, Sort the file list alphabetically.FILE_SORT_EXTENSIONSort by extension, Sort the file list by extension/type.FILE_SORT_TIMESort by time, Sort files by modification time.FILE_SORT_SIZESort 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.spacedata_cleanup()¶ Remove unused settings for invisible editors
-
bpy.ops.screen.userpref_show()¶ Show user preferences