Screen Operators


Handle area action zones for mouse actions/gestures

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

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

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

Step through animation by position


Duplicate selected area into new window

bpy.ops.screen.area_join(cursor=(0, 0))

Join selected areas into new window

Parameters:cursor (int array of 2 items in [-inf, inf], (optional)) – Cursor
bpy.ops.screen.area_move(x=0, y=0, delta=0)

Move selected area edges

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

Operations for splitting and merging

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

Split selected area into new windows

  • 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(cursor=(0, 0))

Swap selected areas screen positions

Parameters:cursor (int array of 2 items in [-inf, inf], (optional)) – Cursor

Revert back to the original screen layout, before fullscreen area overlay


Delete active screen


Show drivers editor in a separate window


Jump to first/last frame in frame range

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

Move current frame forward/backward by a given number

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

Expand or collapse the header pulldown menus


Show info log in a separate window


Jump to previous/next keyframe

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

Jump to previous/next marker

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

Add a new screen


Display parameters for last action performed


Blend in and out overlapping region


Display region context menu


Toggle the region’s alignment (left/right or top/bottom)


Split selected area into camera, front, right & top views


Scale selected area


Hide or unhide the region

Parameters:region_type (enum in ['WINDOW', 'HEADER', 'CHANNELS', 'TEMPORARY', 'UI', 'TOOLS', 'TOOL_PROPS', 'PREVIEW', 'HUD', 'NAVIGATION_BAR', 'EXECUTE', 'FOOTER', 'TOOL_HEADER'], (optional)) – Region Type, Type of the region to toggle

Display menu for previous actions performed

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

Repeat last action


Toggle display selected area as fullscreen/maximized

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

Cycle through available screens

Parameters:delta (int in [-inf, inf], (optional)) – Delta
bpy.ops.screen.screenshot(filepath="", hide_props_region=True, 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_archive=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

  • filepath (string, (optional, never None)) – File Path, Path to file
  • hide_props_region (boolean, (optional)) – Hide Operator Properties, Collapse the region displaying the operator settings
  • 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_archive (boolean, (optional)) – Filter archive 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_VERTICAL', 'LIST_HORIZONTAL', 'THUMBNAIL'], (optional)) –

    Display Type

    • DEFAULT Default, Automatically determine display type for files.
    • LIST_VERTICAL Short List, Display files as short list.
    • LIST_HORIZONTAL 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 Name, Sort the file list alphabetically.
    • FILE_SORT_EXTENSION Extension, Sort the file list by extension/type.
    • FILE_SORT_TIME Modified Date, Sort files by modification time.
    • FILE_SORT_SIZE Size, Sort files by size.
  • full (boolean, (optional)) – Full Screen, Capture the whole window (otherwise only capture the active area)

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

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

Set the space type or cycle sub-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.

Remove unused settings for invisible editors


Edit user preferences and system settings


Cycle through workspaces

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