2023-08-16 00:20:26 +10:00
|
|
|
# SPDX-FileCopyrightText: 2009-2023 Blender Authors
|
2023-06-15 13:09:04 +10:00
|
|
|
#
|
2022-02-11 09:07:11 +11:00
|
|
|
# SPDX-License-Identifier: GPL-2.0-or-later
|
2023-06-15 13:09:04 +10:00
|
|
|
|
2009-08-13 16:59:52 +00:00
|
|
|
import bpy
|
2025-10-07 09:15:20 +11:00
|
|
|
from bpy.types import Panel
|
2025-09-11 14:43:42 +02:00
|
|
|
from bpy.app.translations import (
|
|
|
|
|
pgettext_n as n_,
|
|
|
|
|
contexts as i18n_contexts,
|
|
|
|
|
)
|
2009-08-13 16:59:52 +00:00
|
|
|
|
2009-10-31 23:35:56 +00:00
|
|
|
|
2025-09-02 12:22:29 +02:00
|
|
|
class TIME_PT_playhead_snapping(Panel):
|
|
|
|
|
bl_space_type = 'DOPESHEET_EDITOR'
|
|
|
|
|
bl_region_type = 'HEADER'
|
|
|
|
|
bl_label = "Playhead"
|
|
|
|
|
|
|
|
|
|
@classmethod
|
|
|
|
|
def poll(cls, context):
|
|
|
|
|
del context
|
|
|
|
|
return True
|
|
|
|
|
|
|
|
|
|
def draw(self, context):
|
|
|
|
|
tool_settings = context.tool_settings
|
|
|
|
|
layout = self.layout
|
|
|
|
|
col = layout.column()
|
|
|
|
|
|
|
|
|
|
col.prop(tool_settings, "playhead_snap_distance")
|
|
|
|
|
col.separator()
|
|
|
|
|
col.label(text="Snap Target")
|
|
|
|
|
col.prop(tool_settings, "snap_playhead_element", expand=True)
|
|
|
|
|
col.separator()
|
|
|
|
|
|
|
|
|
|
if 'FRAME' in tool_settings.snap_playhead_element:
|
|
|
|
|
col.prop(tool_settings, "snap_playhead_frame_step")
|
|
|
|
|
if 'SECOND' in tool_settings.snap_playhead_element:
|
|
|
|
|
col.prop(tool_settings, "snap_playhead_second_step")
|
|
|
|
|
|
|
|
|
|
|
2025-06-19 15:54:53 +02:00
|
|
|
def playback_controls(layout, context):
|
VSE: Scene Selector & Scene Time Synchronization
Implements the proposed design (with some modifications) in #135058.
## Sequencer Scene
This adds a new property called `sequencer_scene` to workspaces. This scene is used
by the video sequence editors in the current workspace for their context.
This is a first step towards "detaching" the VSE from the active scene in the window.
Each sequencer timeline editor shows the sequencer scene that is being used.
By default, when no sequencer scene is selected, the timeline and preview are empty.
Pressing the "new" button will add a new scene and assign it to the sequencer
scene for the current workspace.
## Contextual Playback
Pressing `Space` (by default) for starting the animation playback is now contextual:
depending on the context (where your mouse cursor is), the scene that is played back
might be different. E.g. with a 3D Viewport and a Sequencer open, pressing "play"
in the 3D Viewport will play the _active scene_ of the window, while pressing "play"
in the sequencer will play the _sequencer scene_.
## Time & Scene Synchronization
Additionally, this adds a toggle called "Sync Active Scene".
With the property turned on, the active scene & scene time in the window will be
synced with the time & scene of the current scene strip in the sequencer.
Note that this is _not_ bi-directional. The sequencer can change the active scene
and map time, but it's not possible the other way around since it one can have
multiple strips using the same scene (+camera, and even time!).
Currently this setting is exposed in the footer of the sequencer timeline as well
as in the workspace settings.
This allows for one of the core concepts that the story tools projects aims at: Working
in a scene (e.g. in the 3D viewport) while also working with the edit
(in the sequencer timeline).
## Some technical notes
* Undoing while playback is running will now cancel playback. This is to avoid the timer,
that points to the scene and viewlayer that are playing, to get de-synced after loading
the memfile undo step.
* When the sequencer scene is not the same as the active scene, we ensure it has
a depsgraph.
* Normally, when a `NC_SCENE` notifier points to a specific scene, the notifier is dropped
if that scene doesn't match the active one in the window. We now also check that it
doesn't match the sequencer scene in the active workspace.
* When loading older files, we need to make sure that the active workspace in a window
uses the active scene as the sequencer scene. This is to make sure that the file opens with
the same sequences open.
* Tool settings are stored per scene. To make sure the sequencer uses the tool settings for
the sequencer scene, the "context.tool_settings" and `CTX_data_tool_settings` members
are overridden in the sequence editors.
Pull Request: https://projects.blender.org/blender/blender/pulls/140271
2025-08-25 11:58:17 +02:00
|
|
|
st = context.space_data
|
|
|
|
|
is_sequencer = st.type == 'SEQUENCE_EDITOR' and st.view_type == 'SEQUENCER'
|
|
|
|
|
|
|
|
|
|
scene = context.scene if not is_sequencer else context.sequencer_scene
|
2025-09-29 16:54:40 +02:00
|
|
|
tool_settings = scene.tool_settings if scene else None
|
2025-06-19 15:54:53 +02:00
|
|
|
screen = context.screen
|
|
|
|
|
|
2025-09-23 11:51:54 +02:00
|
|
|
if scene:
|
|
|
|
|
layout.popover(
|
|
|
|
|
panel="TIME_PT_playback",
|
|
|
|
|
text="Playback",
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
if tool_settings:
|
|
|
|
|
icon_keytype = 'KEYTYPE_{:s}_VEC'.format(tool_settings.keyframe_type)
|
|
|
|
|
layout.popover(
|
|
|
|
|
panel="TIME_PT_keyframing_settings",
|
|
|
|
|
text_ctxt=i18n_contexts.id_windowmanager,
|
|
|
|
|
icon=icon_keytype,
|
|
|
|
|
)
|
2025-06-19 15:54:53 +02:00
|
|
|
|
VSE: Scene Selector & Scene Time Synchronization
Implements the proposed design (with some modifications) in #135058.
## Sequencer Scene
This adds a new property called `sequencer_scene` to workspaces. This scene is used
by the video sequence editors in the current workspace for their context.
This is a first step towards "detaching" the VSE from the active scene in the window.
Each sequencer timeline editor shows the sequencer scene that is being used.
By default, when no sequencer scene is selected, the timeline and preview are empty.
Pressing the "new" button will add a new scene and assign it to the sequencer
scene for the current workspace.
## Contextual Playback
Pressing `Space` (by default) for starting the animation playback is now contextual:
depending on the context (where your mouse cursor is), the scene that is played back
might be different. E.g. with a 3D Viewport and a Sequencer open, pressing "play"
in the 3D Viewport will play the _active scene_ of the window, while pressing "play"
in the sequencer will play the _sequencer scene_.
## Time & Scene Synchronization
Additionally, this adds a toggle called "Sync Active Scene".
With the property turned on, the active scene & scene time in the window will be
synced with the time & scene of the current scene strip in the sequencer.
Note that this is _not_ bi-directional. The sequencer can change the active scene
and map time, but it's not possible the other way around since it one can have
multiple strips using the same scene (+camera, and even time!).
Currently this setting is exposed in the footer of the sequencer timeline as well
as in the workspace settings.
This allows for one of the core concepts that the story tools projects aims at: Working
in a scene (e.g. in the 3D viewport) while also working with the edit
(in the sequencer timeline).
## Some technical notes
* Undoing while playback is running will now cancel playback. This is to avoid the timer,
that points to the scene and viewlayer that are playing, to get de-synced after loading
the memfile undo step.
* When the sequencer scene is not the same as the active scene, we ensure it has
a depsgraph.
* Normally, when a `NC_SCENE` notifier points to a specific scene, the notifier is dropped
if that scene doesn't match the active one in the window. We now also check that it
doesn't match the sequencer scene in the active workspace.
* When loading older files, we need to make sure that the active workspace in a window
uses the active scene as the sequencer scene. This is to make sure that the file opens with
the same sequences open.
* Tool settings are stored per scene. To make sure the sequencer uses the tool settings for
the sequencer scene, the "context.tool_settings" and `CTX_data_tool_settings` members
are overridden in the sequence editors.
Pull Request: https://projects.blender.org/blender/blender/pulls/140271
2025-08-25 11:58:17 +02:00
|
|
|
if is_sequencer:
|
|
|
|
|
layout.prop(context.workspace, "use_scene_time_sync", text="Sync Scene Time")
|
|
|
|
|
|
2025-06-19 15:54:53 +02:00
|
|
|
layout.separator_spacer()
|
|
|
|
|
|
VSE: Scene Selector & Scene Time Synchronization
Implements the proposed design (with some modifications) in #135058.
## Sequencer Scene
This adds a new property called `sequencer_scene` to workspaces. This scene is used
by the video sequence editors in the current workspace for their context.
This is a first step towards "detaching" the VSE from the active scene in the window.
Each sequencer timeline editor shows the sequencer scene that is being used.
By default, when no sequencer scene is selected, the timeline and preview are empty.
Pressing the "new" button will add a new scene and assign it to the sequencer
scene for the current workspace.
## Contextual Playback
Pressing `Space` (by default) for starting the animation playback is now contextual:
depending on the context (where your mouse cursor is), the scene that is played back
might be different. E.g. with a 3D Viewport and a Sequencer open, pressing "play"
in the 3D Viewport will play the _active scene_ of the window, while pressing "play"
in the sequencer will play the _sequencer scene_.
## Time & Scene Synchronization
Additionally, this adds a toggle called "Sync Active Scene".
With the property turned on, the active scene & scene time in the window will be
synced with the time & scene of the current scene strip in the sequencer.
Note that this is _not_ bi-directional. The sequencer can change the active scene
and map time, but it's not possible the other way around since it one can have
multiple strips using the same scene (+camera, and even time!).
Currently this setting is exposed in the footer of the sequencer timeline as well
as in the workspace settings.
This allows for one of the core concepts that the story tools projects aims at: Working
in a scene (e.g. in the 3D viewport) while also working with the edit
(in the sequencer timeline).
## Some technical notes
* Undoing while playback is running will now cancel playback. This is to avoid the timer,
that points to the scene and viewlayer that are playing, to get de-synced after loading
the memfile undo step.
* When the sequencer scene is not the same as the active scene, we ensure it has
a depsgraph.
* Normally, when a `NC_SCENE` notifier points to a specific scene, the notifier is dropped
if that scene doesn't match the active one in the window. We now also check that it
doesn't match the sequencer scene in the active workspace.
* When loading older files, we need to make sure that the active workspace in a window
uses the active scene as the sequencer scene. This is to make sure that the file opens with
the same sequences open.
* Tool settings are stored per scene. To make sure the sequencer uses the tool settings for
the sequencer scene, the "context.tool_settings" and `CTX_data_tool_settings` members
are overridden in the sequence editors.
Pull Request: https://projects.blender.org/blender/blender/pulls/140271
2025-08-25 11:58:17 +02:00
|
|
|
if tool_settings:
|
|
|
|
|
row = layout.row(align=True)
|
|
|
|
|
row.prop(tool_settings, "use_keyframe_insert_auto", text="", toggle=True)
|
|
|
|
|
sub = row.row(align=True)
|
|
|
|
|
sub.active = tool_settings.use_keyframe_insert_auto
|
|
|
|
|
sub.popover(
|
|
|
|
|
panel="TIME_PT_auto_keyframing",
|
|
|
|
|
text="",
|
|
|
|
|
)
|
2025-06-19 15:54:53 +02:00
|
|
|
|
|
|
|
|
row = layout.row(align=True)
|
|
|
|
|
row.operator("screen.frame_jump", text="", icon='REW').end = False
|
|
|
|
|
row.operator("screen.keyframe_jump", text="", icon='PREV_KEYFRAME').next = False
|
|
|
|
|
|
|
|
|
|
if not screen.is_animation_playing:
|
|
|
|
|
# if using JACK and A/V sync:
|
|
|
|
|
# hide the play-reversed button
|
|
|
|
|
# since JACK transport doesn't support reversed playback
|
VSE: Scene Selector & Scene Time Synchronization
Implements the proposed design (with some modifications) in #135058.
## Sequencer Scene
This adds a new property called `sequencer_scene` to workspaces. This scene is used
by the video sequence editors in the current workspace for their context.
This is a first step towards "detaching" the VSE from the active scene in the window.
Each sequencer timeline editor shows the sequencer scene that is being used.
By default, when no sequencer scene is selected, the timeline and preview are empty.
Pressing the "new" button will add a new scene and assign it to the sequencer
scene for the current workspace.
## Contextual Playback
Pressing `Space` (by default) for starting the animation playback is now contextual:
depending on the context (where your mouse cursor is), the scene that is played back
might be different. E.g. with a 3D Viewport and a Sequencer open, pressing "play"
in the 3D Viewport will play the _active scene_ of the window, while pressing "play"
in the sequencer will play the _sequencer scene_.
## Time & Scene Synchronization
Additionally, this adds a toggle called "Sync Active Scene".
With the property turned on, the active scene & scene time in the window will be
synced with the time & scene of the current scene strip in the sequencer.
Note that this is _not_ bi-directional. The sequencer can change the active scene
and map time, but it's not possible the other way around since it one can have
multiple strips using the same scene (+camera, and even time!).
Currently this setting is exposed in the footer of the sequencer timeline as well
as in the workspace settings.
This allows for one of the core concepts that the story tools projects aims at: Working
in a scene (e.g. in the 3D viewport) while also working with the edit
(in the sequencer timeline).
## Some technical notes
* Undoing while playback is running will now cancel playback. This is to avoid the timer,
that points to the scene and viewlayer that are playing, to get de-synced after loading
the memfile undo step.
* When the sequencer scene is not the same as the active scene, we ensure it has
a depsgraph.
* Normally, when a `NC_SCENE` notifier points to a specific scene, the notifier is dropped
if that scene doesn't match the active one in the window. We now also check that it
doesn't match the sequencer scene in the active workspace.
* When loading older files, we need to make sure that the active workspace in a window
uses the active scene as the sequencer scene. This is to make sure that the file opens with
the same sequences open.
* Tool settings are stored per scene. To make sure the sequencer uses the tool settings for
the sequencer scene, the "context.tool_settings" and `CTX_data_tool_settings` members
are overridden in the sequence editors.
Pull Request: https://projects.blender.org/blender/blender/pulls/140271
2025-08-25 11:58:17 +02:00
|
|
|
if scene and scene.sync_mode == 'AUDIO_SYNC' and context.preferences.system.audio_device == 'JACK':
|
2019-08-27 12:52:36 +02:00
|
|
|
row.scale_x = 2
|
2025-06-19 15:54:53 +02:00
|
|
|
row.operator("screen.animation_play", text="", icon='PLAY')
|
2019-08-27 12:52:36 +02:00
|
|
|
row.scale_x = 1
|
2025-06-19 15:54:53 +02:00
|
|
|
else:
|
|
|
|
|
row.operator("screen.animation_play", text="", icon='PLAY_REVERSE').reverse = True
|
|
|
|
|
row.operator("screen.animation_play", text="", icon='PLAY')
|
|
|
|
|
else:
|
|
|
|
|
row.scale_x = 2
|
|
|
|
|
row.operator("screen.animation_play", text="", icon='PAUSE')
|
|
|
|
|
row.scale_x = 1
|
|
|
|
|
|
2025-06-27 12:42:00 +02:00
|
|
|
row.operator("screen.keyframe_jump", text="", icon='NEXT_KEYFRAME').next = True
|
2025-06-19 15:54:53 +02:00
|
|
|
row.operator("screen.frame_jump", text="", icon='FF').end = True
|
2018-05-10 19:04:14 +02:00
|
|
|
|
Anim: Time jump operator
Adds a new operator that jumps time by a given number of frames or seconds, forward or backward.
Surprisingly, it was lacking in Blender, and prompted many users (including me) to create extensions.
This PR adds two properties: `time_jump_unit` for choosing whether to jump by frames or seconds
and `time_jump_delta` property that defines by how many frames or seconds the operator should jump,
as well as an actual operator that changes the current frame (`screen.time_jump`).
`time_jump_delta` is a float that gives users the ability to jump by half a second, for example, or by subframes.
Default is set to 1 second, which translates to as many frames jump as frame rate / frame base.
The operator is intentionally not bound by frame range, and can go in negative frames as well.
This is very important because it's extremely common to set frame range to the current workload,
but wish to see animation beyond that.
Operators are added in the new footer for animation editors alongside with pop-up menu where
properties can be changed.
Shortcuts are also added: Ctrl+Left/Right Arrow, which was surprisingly free in Blender.
Now timeline controls are:
- **Right Arrow**: Next Frame
- **Ctrl + Right Arrow**: Jump Forward (by default also Next Second)
- **Shift + Right Arrow**: Jump to End
Pull Request: https://projects.blender.org/blender/blender/pulls/140677
2025-10-07 13:43:20 +02:00
|
|
|
# Time jump
|
|
|
|
|
row = layout.row(align=True)
|
|
|
|
|
row.operator("screen.time_jump", text="", icon='FRAME_PREV').backward = True
|
|
|
|
|
row.operator("screen.time_jump", text="", icon='FRAME_NEXT').backward = False
|
|
|
|
|
row.popover(panel="TIME_PT_jump", text="")
|
|
|
|
|
|
2025-09-23 11:51:54 +02:00
|
|
|
if tool_settings:
|
|
|
|
|
row = layout.row(align=True)
|
|
|
|
|
row.prop(tool_settings, "use_snap_playhead", text="")
|
|
|
|
|
sub = row.row(align=True)
|
|
|
|
|
sub.popover(panel="TIME_PT_playhead_snapping", text="")
|
2025-09-02 12:22:29 +02:00
|
|
|
|
2025-06-19 15:54:53 +02:00
|
|
|
layout.separator_spacer()
|
2018-05-10 19:04:14 +02:00
|
|
|
|
VSE: Scene Selector & Scene Time Synchronization
Implements the proposed design (with some modifications) in #135058.
## Sequencer Scene
This adds a new property called `sequencer_scene` to workspaces. This scene is used
by the video sequence editors in the current workspace for their context.
This is a first step towards "detaching" the VSE from the active scene in the window.
Each sequencer timeline editor shows the sequencer scene that is being used.
By default, when no sequencer scene is selected, the timeline and preview are empty.
Pressing the "new" button will add a new scene and assign it to the sequencer
scene for the current workspace.
## Contextual Playback
Pressing `Space` (by default) for starting the animation playback is now contextual:
depending on the context (where your mouse cursor is), the scene that is played back
might be different. E.g. with a 3D Viewport and a Sequencer open, pressing "play"
in the 3D Viewport will play the _active scene_ of the window, while pressing "play"
in the sequencer will play the _sequencer scene_.
## Time & Scene Synchronization
Additionally, this adds a toggle called "Sync Active Scene".
With the property turned on, the active scene & scene time in the window will be
synced with the time & scene of the current scene strip in the sequencer.
Note that this is _not_ bi-directional. The sequencer can change the active scene
and map time, but it's not possible the other way around since it one can have
multiple strips using the same scene (+camera, and even time!).
Currently this setting is exposed in the footer of the sequencer timeline as well
as in the workspace settings.
This allows for one of the core concepts that the story tools projects aims at: Working
in a scene (e.g. in the 3D viewport) while also working with the edit
(in the sequencer timeline).
## Some technical notes
* Undoing while playback is running will now cancel playback. This is to avoid the timer,
that points to the scene and viewlayer that are playing, to get de-synced after loading
the memfile undo step.
* When the sequencer scene is not the same as the active scene, we ensure it has
a depsgraph.
* Normally, when a `NC_SCENE` notifier points to a specific scene, the notifier is dropped
if that scene doesn't match the active one in the window. We now also check that it
doesn't match the sequencer scene in the active workspace.
* When loading older files, we need to make sure that the active workspace in a window
uses the active scene as the sequencer scene. This is to make sure that the file opens with
the same sequences open.
* Tool settings are stored per scene. To make sure the sequencer uses the tool settings for
the sequencer scene, the "context.tool_settings" and `CTX_data_tool_settings` members
are overridden in the sequence editors.
Pull Request: https://projects.blender.org/blender/blender/pulls/140271
2025-08-25 11:58:17 +02:00
|
|
|
if scene:
|
|
|
|
|
row = layout.row()
|
|
|
|
|
if scene.show_subframe:
|
|
|
|
|
row.scale_x = 1.15
|
|
|
|
|
row.prop(scene, "frame_float", text="")
|
|
|
|
|
else:
|
|
|
|
|
row.scale_x = 0.95
|
|
|
|
|
row.prop(scene, "frame_current", text="")
|
2025-06-19 15:54:53 +02:00
|
|
|
|
VSE: Scene Selector & Scene Time Synchronization
Implements the proposed design (with some modifications) in #135058.
## Sequencer Scene
This adds a new property called `sequencer_scene` to workspaces. This scene is used
by the video sequence editors in the current workspace for their context.
This is a first step towards "detaching" the VSE from the active scene in the window.
Each sequencer timeline editor shows the sequencer scene that is being used.
By default, when no sequencer scene is selected, the timeline and preview are empty.
Pressing the "new" button will add a new scene and assign it to the sequencer
scene for the current workspace.
## Contextual Playback
Pressing `Space` (by default) for starting the animation playback is now contextual:
depending on the context (where your mouse cursor is), the scene that is played back
might be different. E.g. with a 3D Viewport and a Sequencer open, pressing "play"
in the 3D Viewport will play the _active scene_ of the window, while pressing "play"
in the sequencer will play the _sequencer scene_.
## Time & Scene Synchronization
Additionally, this adds a toggle called "Sync Active Scene".
With the property turned on, the active scene & scene time in the window will be
synced with the time & scene of the current scene strip in the sequencer.
Note that this is _not_ bi-directional. The sequencer can change the active scene
and map time, but it's not possible the other way around since it one can have
multiple strips using the same scene (+camera, and even time!).
Currently this setting is exposed in the footer of the sequencer timeline as well
as in the workspace settings.
This allows for one of the core concepts that the story tools projects aims at: Working
in a scene (e.g. in the 3D viewport) while also working with the edit
(in the sequencer timeline).
## Some technical notes
* Undoing while playback is running will now cancel playback. This is to avoid the timer,
that points to the scene and viewlayer that are playing, to get de-synced after loading
the memfile undo step.
* When the sequencer scene is not the same as the active scene, we ensure it has
a depsgraph.
* Normally, when a `NC_SCENE` notifier points to a specific scene, the notifier is dropped
if that scene doesn't match the active one in the window. We now also check that it
doesn't match the sequencer scene in the active workspace.
* When loading older files, we need to make sure that the active workspace in a window
uses the active scene as the sequencer scene. This is to make sure that the file opens with
the same sequences open.
* Tool settings are stored per scene. To make sure the sequencer uses the tool settings for
the sequencer scene, the "context.tool_settings" and `CTX_data_tool_settings` members
are overridden in the sequence editors.
Pull Request: https://projects.blender.org/blender/blender/pulls/140271
2025-08-25 11:58:17 +02:00
|
|
|
row = layout.row(align=True)
|
|
|
|
|
row.prop(scene, "use_preview_range", text="", toggle=True)
|
|
|
|
|
sub = row.row(align=True)
|
|
|
|
|
sub.scale_x = 0.8
|
|
|
|
|
if not scene.use_preview_range:
|
|
|
|
|
sub.prop(scene, "frame_start", text="Start")
|
|
|
|
|
sub.prop(scene, "frame_end", text="End")
|
|
|
|
|
else:
|
|
|
|
|
sub.prop(scene, "frame_preview_start", text="Start")
|
|
|
|
|
sub.prop(scene, "frame_preview_end", text="End")
|
2009-08-13 22:10:50 +00:00
|
|
|
|
2009-10-31 23:35:56 +00:00
|
|
|
|
2019-03-13 11:52:54 +11:00
|
|
|
def marker_menu_generic(layout, context):
|
2011-11-03 12:47:39 +00:00
|
|
|
|
2015-09-01 03:51:50 +10:00
|
|
|
# layout.operator_context = 'EXEC_REGION_WIN'
|
2011-11-03 12:47:39 +00:00
|
|
|
|
|
|
|
|
layout.column()
|
|
|
|
|
|
2023-08-31 20:25:35 +02:00
|
|
|
tool_settings = context.tool_settings
|
|
|
|
|
layout.prop(tool_settings, "lock_markers")
|
2011-11-03 12:47:39 +00:00
|
|
|
|
2023-08-31 20:25:35 +02:00
|
|
|
layout.separator()
|
|
|
|
|
|
|
|
|
|
layout.operator("screen.marker_jump", text="Jump to Previous Marker").next = False
|
|
|
|
|
layout.operator("screen.marker_jump", text="Jump to Next Marker").next = True
|
2011-11-03 12:47:39 +00:00
|
|
|
|
|
|
|
|
layout.separator()
|
|
|
|
|
|
2023-08-31 20:25:35 +02:00
|
|
|
layout.operator("marker.camera_bind")
|
2013-11-20 03:38:18 +11:00
|
|
|
|
2013-10-21 15:00:22 +00:00
|
|
|
layout.separator()
|
2013-11-20 03:38:18 +11:00
|
|
|
|
2024-03-14 10:38:16 +11:00
|
|
|
layout.menu("NLA_MT_marker_select")
|
2022-04-14 11:30:12 +02:00
|
|
|
|
|
|
|
|
layout.separator()
|
|
|
|
|
|
2023-08-31 20:25:35 +02:00
|
|
|
layout.operator("marker.move", text="Move Marker")
|
|
|
|
|
props = layout.operator("wm.call_panel", text="Rename Marker")
|
|
|
|
|
props.name = "TOPBAR_PT_name_marker"
|
|
|
|
|
props.keep_open = False
|
2018-04-24 17:59:32 +02:00
|
|
|
|
|
|
|
|
layout.separator()
|
|
|
|
|
|
2023-08-31 20:25:35 +02:00
|
|
|
layout.operator("marker.delete", text="Delete Marker")
|
|
|
|
|
|
|
|
|
|
if len(bpy.data.scenes) > 10:
|
|
|
|
|
layout.operator_context = 'INVOKE_DEFAULT'
|
|
|
|
|
layout.operator("marker.make_links_scene", text="Duplicate Marker to Scene...", icon='OUTLINER_OB_EMPTY')
|
|
|
|
|
else:
|
|
|
|
|
layout.operator_menu_enum("marker.make_links_scene", "scene", text="Duplicate Marker to Scene")
|
|
|
|
|
|
|
|
|
|
layout.operator("marker.duplicate", text="Duplicate Marker")
|
|
|
|
|
layout.operator("marker.add", text="Add Marker")
|
2011-11-03 12:47:39 +00:00
|
|
|
|
2015-04-14 12:11:24 +02:00
|
|
|
|
2018-05-10 18:33:41 +02:00
|
|
|
###################################
|
|
|
|
|
|
2018-06-05 16:35:20 +02:00
|
|
|
|
2018-05-10 18:33:41 +02:00
|
|
|
class TimelinePanelButtons:
|
|
|
|
|
bl_space_type = 'DOPESHEET_EDITOR'
|
|
|
|
|
bl_region_type = 'UI'
|
|
|
|
|
|
|
|
|
|
|
2018-05-10 19:28:27 +02:00
|
|
|
class TIME_PT_playback(TimelinePanelButtons, Panel):
|
|
|
|
|
bl_label = "Playback"
|
|
|
|
|
bl_region_type = 'HEADER'
|
2024-03-14 17:10:34 +01:00
|
|
|
bl_ui_units_x = 13
|
2018-05-10 19:28:27 +02:00
|
|
|
|
|
|
|
|
def draw(self, context):
|
|
|
|
|
layout = self.layout
|
2020-09-07 14:22:29 -05:00
|
|
|
layout.use_property_split = True
|
|
|
|
|
layout.use_property_decorate = False
|
2018-05-10 19:28:27 +02:00
|
|
|
|
|
|
|
|
screen = context.screen
|
VSE: Scene Selector & Scene Time Synchronization
Implements the proposed design (with some modifications) in #135058.
## Sequencer Scene
This adds a new property called `sequencer_scene` to workspaces. This scene is used
by the video sequence editors in the current workspace for their context.
This is a first step towards "detaching" the VSE from the active scene in the window.
Each sequencer timeline editor shows the sequencer scene that is being used.
By default, when no sequencer scene is selected, the timeline and preview are empty.
Pressing the "new" button will add a new scene and assign it to the sequencer
scene for the current workspace.
## Contextual Playback
Pressing `Space` (by default) for starting the animation playback is now contextual:
depending on the context (where your mouse cursor is), the scene that is played back
might be different. E.g. with a 3D Viewport and a Sequencer open, pressing "play"
in the 3D Viewport will play the _active scene_ of the window, while pressing "play"
in the sequencer will play the _sequencer scene_.
## Time & Scene Synchronization
Additionally, this adds a toggle called "Sync Active Scene".
With the property turned on, the active scene & scene time in the window will be
synced with the time & scene of the current scene strip in the sequencer.
Note that this is _not_ bi-directional. The sequencer can change the active scene
and map time, but it's not possible the other way around since it one can have
multiple strips using the same scene (+camera, and even time!).
Currently this setting is exposed in the footer of the sequencer timeline as well
as in the workspace settings.
This allows for one of the core concepts that the story tools projects aims at: Working
in a scene (e.g. in the 3D viewport) while also working with the edit
(in the sequencer timeline).
## Some technical notes
* Undoing while playback is running will now cancel playback. This is to avoid the timer,
that points to the scene and viewlayer that are playing, to get de-synced after loading
the memfile undo step.
* When the sequencer scene is not the same as the active scene, we ensure it has
a depsgraph.
* Normally, when a `NC_SCENE` notifier points to a specific scene, the notifier is dropped
if that scene doesn't match the active one in the window. We now also check that it
doesn't match the sequencer scene in the active workspace.
* When loading older files, we need to make sure that the active workspace in a window
uses the active scene as the sequencer scene. This is to make sure that the file opens with
the same sequences open.
* Tool settings are stored per scene. To make sure the sequencer uses the tool settings for
the sequencer scene, the "context.tool_settings" and `CTX_data_tool_settings` members
are overridden in the sequence editors.
Pull Request: https://projects.blender.org/blender/blender/pulls/140271
2025-08-25 11:58:17 +02:00
|
|
|
st = context.space_data
|
|
|
|
|
is_sequencer = st.type == 'SEQUENCE_EDITOR' and st.view_type == 'SEQUENCER'
|
|
|
|
|
scene = context.scene if not is_sequencer else context.sequencer_scene
|
2018-05-10 19:28:27 +02:00
|
|
|
|
2020-10-29 12:31:48 +01:00
|
|
|
layout.prop(scene, "sync_mode", text="Sync")
|
|
|
|
|
col = layout.column(heading="Audio")
|
2020-09-07 14:22:29 -05:00
|
|
|
col.prop(scene, "use_audio_scrub", text="Scrubbing")
|
2024-01-18 11:01:13 +11:00
|
|
|
col.prop(scene, "use_audio")
|
2020-09-07 14:22:29 -05:00
|
|
|
|
|
|
|
|
col = layout.column(heading="Playback")
|
|
|
|
|
col.prop(scene, "lock_frame_selection_to_range", text="Limit to Frame Range")
|
|
|
|
|
col.prop(screen, "use_follow", text="Follow Current Frame")
|
|
|
|
|
|
|
|
|
|
col = layout.column(heading="Play In")
|
|
|
|
|
col.prop(screen, "use_play_top_left_3d_editor", text="Active Editor")
|
|
|
|
|
col.prop(screen, "use_play_3d_editors", text="3D Viewport")
|
|
|
|
|
col.prop(screen, "use_play_animation_editors", text="Animation Editors")
|
|
|
|
|
col.prop(screen, "use_play_image_editors", text="Image Editor")
|
2024-04-05 18:17:41 +02:00
|
|
|
col.prop(screen, "use_play_properties_editors", text="Properties and Sidebars")
|
2020-09-07 14:22:29 -05:00
|
|
|
col.prop(screen, "use_play_clip_editors", text="Movie Clip Editor")
|
|
|
|
|
col.prop(screen, "use_play_node_editors", text="Node Editors")
|
|
|
|
|
col.prop(screen, "use_play_sequence_editors", text="Video Sequencer")
|
2023-05-24 09:25:10 +02:00
|
|
|
col.prop(screen, "use_play_spreadsheet_editors", text="Spreadsheet")
|
2020-09-07 14:22:29 -05:00
|
|
|
|
|
|
|
|
col = layout.column(heading="Show")
|
|
|
|
|
col.prop(scene, "show_subframe", text="Subframes")
|
2018-05-10 19:28:27 +02:00
|
|
|
|
|
|
|
|
layout.separator()
|
|
|
|
|
|
|
|
|
|
row = layout.row(align=True)
|
|
|
|
|
row.operator("anim.start_frame_set")
|
|
|
|
|
row.operator("anim.end_frame_set")
|
|
|
|
|
|
|
|
|
|
|
2018-05-10 18:33:41 +02:00
|
|
|
class TIME_PT_keyframing_settings(TimelinePanelButtons, Panel):
|
|
|
|
|
bl_label = "Keyframing Settings"
|
|
|
|
|
bl_options = {'HIDE_HEADER'}
|
2018-05-25 17:02:40 +02:00
|
|
|
bl_region_type = 'HEADER'
|
2025-09-11 14:43:42 +02:00
|
|
|
bl_description = "Active keying set and keyframing settings"
|
|
|
|
|
|
|
|
|
|
def draw_header(self, context):
|
|
|
|
|
st = context.space_data
|
|
|
|
|
is_sequencer = st.type == 'SEQUENCE_EDITOR' and st.view_type == 'SEQUENCER'
|
|
|
|
|
scene = context.scene if not is_sequencer else context.sequencer_scene
|
|
|
|
|
if scene.keying_sets_all.active:
|
|
|
|
|
self.bl_label = scene.keying_sets_all.active.bl_label
|
|
|
|
|
if scene.keying_sets_all.active.bl_label in scene.keying_sets:
|
|
|
|
|
# Do not translate, this keying set is user-defined.
|
2025-09-23 19:54:03 +02:00
|
|
|
self.bl_translation_context = i18n_contexts.no_translation
|
2025-09-11 14:43:42 +02:00
|
|
|
else:
|
|
|
|
|
# Use the keying set's translation context (default).
|
|
|
|
|
self.bl_translation_context = scene.keying_sets_all.active.bl_rna.translation_context
|
|
|
|
|
else:
|
|
|
|
|
# Use a custom translation context to differentiate from compositing keying.
|
|
|
|
|
self.bl_label = n_("Keying", i18n_contexts.id_windowmanager)
|
|
|
|
|
self.bl_translation_context = i18n_contexts.id_windowmanager
|
2018-05-10 18:33:41 +02:00
|
|
|
|
|
|
|
|
def draw(self, context):
|
|
|
|
|
layout = self.layout
|
|
|
|
|
|
VSE: Scene Selector & Scene Time Synchronization
Implements the proposed design (with some modifications) in #135058.
## Sequencer Scene
This adds a new property called `sequencer_scene` to workspaces. This scene is used
by the video sequence editors in the current workspace for their context.
This is a first step towards "detaching" the VSE from the active scene in the window.
Each sequencer timeline editor shows the sequencer scene that is being used.
By default, when no sequencer scene is selected, the timeline and preview are empty.
Pressing the "new" button will add a new scene and assign it to the sequencer
scene for the current workspace.
## Contextual Playback
Pressing `Space` (by default) for starting the animation playback is now contextual:
depending on the context (where your mouse cursor is), the scene that is played back
might be different. E.g. with a 3D Viewport and a Sequencer open, pressing "play"
in the 3D Viewport will play the _active scene_ of the window, while pressing "play"
in the sequencer will play the _sequencer scene_.
## Time & Scene Synchronization
Additionally, this adds a toggle called "Sync Active Scene".
With the property turned on, the active scene & scene time in the window will be
synced with the time & scene of the current scene strip in the sequencer.
Note that this is _not_ bi-directional. The sequencer can change the active scene
and map time, but it's not possible the other way around since it one can have
multiple strips using the same scene (+camera, and even time!).
Currently this setting is exposed in the footer of the sequencer timeline as well
as in the workspace settings.
This allows for one of the core concepts that the story tools projects aims at: Working
in a scene (e.g. in the 3D viewport) while also working with the edit
(in the sequencer timeline).
## Some technical notes
* Undoing while playback is running will now cancel playback. This is to avoid the timer,
that points to the scene and viewlayer that are playing, to get de-synced after loading
the memfile undo step.
* When the sequencer scene is not the same as the active scene, we ensure it has
a depsgraph.
* Normally, when a `NC_SCENE` notifier points to a specific scene, the notifier is dropped
if that scene doesn't match the active one in the window. We now also check that it
doesn't match the sequencer scene in the active workspace.
* When loading older files, we need to make sure that the active workspace in a window
uses the active scene as the sequencer scene. This is to make sure that the file opens with
the same sequences open.
* Tool settings are stored per scene. To make sure the sequencer uses the tool settings for
the sequencer scene, the "context.tool_settings" and `CTX_data_tool_settings` members
are overridden in the sequence editors.
Pull Request: https://projects.blender.org/blender/blender/pulls/140271
2025-08-25 11:58:17 +02:00
|
|
|
st = context.space_data
|
|
|
|
|
is_sequencer = st.type == 'SEQUENCE_EDITOR' and st.view_type == 'SEQUENCER'
|
|
|
|
|
scene = context.scene if not is_sequencer else context.sequencer_scene
|
2018-12-17 17:26:47 +11:00
|
|
|
tool_settings = context.tool_settings
|
2018-05-10 18:33:41 +02:00
|
|
|
|
|
|
|
|
col = layout.column(align=True)
|
2020-10-06 15:17:36 -05:00
|
|
|
col.label(text="Active Keying Set")
|
2018-05-10 18:33:41 +02:00
|
|
|
row = col.row(align=True)
|
|
|
|
|
row.prop_search(scene.keying_sets_all, "active", scene, "keying_sets_all", text="")
|
|
|
|
|
row.operator("anim.keyframe_insert", text="", icon='KEY_HLT')
|
|
|
|
|
row.operator("anim.keyframe_delete", text="", icon='KEY_DEHLT')
|
|
|
|
|
|
|
|
|
|
col = layout.column(align=True)
|
2020-10-06 15:17:36 -05:00
|
|
|
col.label(text="New Keyframe Type")
|
2018-12-17 17:26:47 +11:00
|
|
|
col.prop(tool_settings, "keyframe_type", text="")
|
2013-11-20 03:38:18 +11:00
|
|
|
|
2021-05-03 00:03:00 +03:00
|
|
|
layout.prop(tool_settings, "use_keyframe_cycle_aware")
|
|
|
|
|
|
2020-12-16 18:02:40 +11:00
|
|
|
|
2020-10-06 15:17:36 -05:00
|
|
|
class TIME_PT_auto_keyframing(TimelinePanelButtons, Panel):
|
|
|
|
|
bl_label = "Auto Keyframing"
|
|
|
|
|
bl_options = {'HIDE_HEADER'}
|
|
|
|
|
bl_region_type = 'HEADER'
|
|
|
|
|
bl_ui_units_x = 9
|
|
|
|
|
|
|
|
|
|
def draw(self, context):
|
|
|
|
|
layout = self.layout
|
|
|
|
|
|
|
|
|
|
tool_settings = context.tool_settings
|
|
|
|
|
prefs = context.preferences
|
|
|
|
|
|
|
|
|
|
layout.active = tool_settings.use_keyframe_insert_auto
|
|
|
|
|
|
|
|
|
|
layout.prop(tool_settings, "auto_keying_mode", expand=True)
|
|
|
|
|
|
2018-05-10 18:33:41 +02:00
|
|
|
col = layout.column(align=True)
|
2020-10-06 15:17:36 -05:00
|
|
|
col.prop(tool_settings, "use_keyframe_insert_keyingset", text="Only Active Keying Set", toggle=False)
|
2018-12-21 12:47:44 +11:00
|
|
|
if not prefs.edit.use_keyframe_insert_available:
|
2018-12-17 17:26:47 +11:00
|
|
|
col.prop(tool_settings, "use_record_with_nla", text="Layered Recording")
|
2018-05-10 18:33:41 +02:00
|
|
|
|
|
|
|
|
|
Anim: Time jump operator
Adds a new operator that jumps time by a given number of frames or seconds, forward or backward.
Surprisingly, it was lacking in Blender, and prompted many users (including me) to create extensions.
This PR adds two properties: `time_jump_unit` for choosing whether to jump by frames or seconds
and `time_jump_delta` property that defines by how many frames or seconds the operator should jump,
as well as an actual operator that changes the current frame (`screen.time_jump`).
`time_jump_delta` is a float that gives users the ability to jump by half a second, for example, or by subframes.
Default is set to 1 second, which translates to as many frames jump as frame rate / frame base.
The operator is intentionally not bound by frame range, and can go in negative frames as well.
This is very important because it's extremely common to set frame range to the current workload,
but wish to see animation beyond that.
Operators are added in the new footer for animation editors alongside with pop-up menu where
properties can be changed.
Shortcuts are also added: Ctrl+Left/Right Arrow, which was surprisingly free in Blender.
Now timeline controls are:
- **Right Arrow**: Next Frame
- **Ctrl + Right Arrow**: Jump Forward (by default also Next Second)
- **Shift + Right Arrow**: Jump to End
Pull Request: https://projects.blender.org/blender/blender/pulls/140677
2025-10-07 13:43:20 +02:00
|
|
|
class TIME_PT_jump(TimelinePanelButtons, Panel):
|
|
|
|
|
bl_label = "Time Jump"
|
|
|
|
|
bl_options = {'HIDE_HEADER'}
|
|
|
|
|
bl_region_type = 'HEADER'
|
|
|
|
|
bl_ui_units_x = 10
|
|
|
|
|
|
|
|
|
|
def draw(self, context):
|
|
|
|
|
layout = self.layout
|
|
|
|
|
layout.use_property_split = True
|
|
|
|
|
layout.use_property_decorate = False
|
|
|
|
|
|
|
|
|
|
scene = context.scene
|
|
|
|
|
|
|
|
|
|
layout.prop(scene, "time_jump_unit", expand=True, text="Jump Unit")
|
|
|
|
|
layout.prop(scene, "time_jump_delta", text="Delta")
|
|
|
|
|
|
|
|
|
|
|
2018-05-10 18:33:41 +02:00
|
|
|
###################################
|
2011-11-03 12:47:39 +00:00
|
|
|
|
2017-03-18 20:03:24 +11:00
|
|
|
classes = (
|
2018-05-10 19:28:27 +02:00
|
|
|
TIME_PT_playback,
|
2018-05-10 18:33:41 +02:00
|
|
|
TIME_PT_keyframing_settings,
|
2020-10-06 15:17:36 -05:00
|
|
|
TIME_PT_auto_keyframing,
|
Anim: Time jump operator
Adds a new operator that jumps time by a given number of frames or seconds, forward or backward.
Surprisingly, it was lacking in Blender, and prompted many users (including me) to create extensions.
This PR adds two properties: `time_jump_unit` for choosing whether to jump by frames or seconds
and `time_jump_delta` property that defines by how many frames or seconds the operator should jump,
as well as an actual operator that changes the current frame (`screen.time_jump`).
`time_jump_delta` is a float that gives users the ability to jump by half a second, for example, or by subframes.
Default is set to 1 second, which translates to as many frames jump as frame rate / frame base.
The operator is intentionally not bound by frame range, and can go in negative frames as well.
This is very important because it's extremely common to set frame range to the current workload,
but wish to see animation beyond that.
Operators are added in the new footer for animation editors alongside with pop-up menu where
properties can be changed.
Shortcuts are also added: Ctrl+Left/Right Arrow, which was surprisingly free in Blender.
Now timeline controls are:
- **Right Arrow**: Next Frame
- **Ctrl + Right Arrow**: Jump Forward (by default also Next Second)
- **Shift + Right Arrow**: Jump to End
Pull Request: https://projects.blender.org/blender/blender/pulls/140677
2025-10-07 13:43:20 +02:00
|
|
|
TIME_PT_jump,
|
2025-09-02 12:22:29 +02:00
|
|
|
TIME_PT_playhead_snapping,
|
2017-03-18 20:03:24 +11:00
|
|
|
)
|
|
|
|
|
|
2011-04-04 10:13:04 +00:00
|
|
|
if __name__ == "__main__": # only for live edit.
|
2017-03-18 20:03:24 +11:00
|
|
|
from bpy.utils import register_class
|
|
|
|
|
for cls in classes:
|
|
|
|
|
register_class(cls)
|