mirror of
https://github.com/rbreu/beeref.git
synced 2026-03-11 08:54:28 +00:00
Update view.py
This commit is contained in:
severr123
GitHub
parent
56f4301ac3
commit
ac41971d43
1 changed files with 126 additions and 125 deletions
251
beeref/view.py
251
beeref/view.py
|
|
@ -38,182 +38,183 @@ from beeref.utils import get_file_extension_from_format, qcolor_to_hex
|
|||
commandline_args = CommandlineArgs()
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
|
||||
# 主视图类，继承自QGraphicsView并混入自定义功能
|
||||
# 负责处理用户界面交互、图形渲染和场景管理
|
||||
class BeeGraphicsView(MainControlsMixin,
|
||||
QtWidgets.QGraphicsView,
|
||||
ActionsMixin):
|
||||
"""
|
||||
主视图类，继承自QGraphicsView并混入自定义功能
|
||||
负责处理用户界面交互、图形渲染和场景管理
|
||||
"""
|
||||
|
||||
# 视图模式常量
|
||||
PAN_MODE = 1 # 平移模式
|
||||
ZOOM_MODE = 2 # 缩放模式
|
||||
SAMPLE_COLOR_MODE = 3 # 取色模式
|
||||
|
||||
def __init__(self, app, parent=None):
|
||||
"""
|
||||
初始化视图
|
||||
|
||||
参数:
|
||||
app: 主应用程序对象
|
||||
parent: 父窗口部件
|
||||
"""
|
||||
super().__init__(parent)
|
||||
self.app = app
|
||||
self.parent = parent
|
||||
|
||||
super().__init__(parent)# 初始化父类
|
||||
self.app = app# 应用程序对象
|
||||
self.parent = parent # 父窗口部件
|
||||
self.settings = BeeSettings() # 应用程序设置
|
||||
self.keyboard_settings = KeyboardSettings()
|
||||
self.welcome_overlay = widgets.welcome_overlay.WelcomeOverlay(self)
|
||||
self.keyboard_settings = KeyboardSettings() # 键盘设置
|
||||
self.welcome_overlay = widgets.welcome_overlay.WelcomeOverlay(self) # 欢迎 overlay 层
|
||||
|
||||
self.setBackgroundBrush(
|
||||
QtGui.QBrush(QtGui.QColor(*constants.COLORS['Scene:Canvas'])))
|
||||
self.setRenderHint(QtGui.QPainter.RenderHint.Antialiasing)
|
||||
self.setFrameShape(QtWidgets.QFrame.Shape.NoFrame)
|
||||
|
||||
self.undo_stack = QtGui.QUndoStack(self)
|
||||
self.undo_stack.setUndoLimit(100)
|
||||
self.undo_stack.canRedoChanged.connect(self.on_can_redo_changed)
|
||||
QtGui.QBrush(QtGui.QColor(*constants.COLORS['Scene:Canvas']))) # 设置场景背景为画布颜色
|
||||
self.setRenderHint(QtGui.QPainter.RenderHint.Antialiasing) # 开启反锯齿渲染
|
||||
self.setFrameShape(QtWidgets.QFrame.Shape.NoFrame) # 移除边框
|
||||
|
||||
self.undo_stack = QtGui.QUndoStack(self) # 初始化撤销栈
|
||||
self.undo_stack.setUndoLimit(100) # 设置撤销栈最大操作数为 100
|
||||
self.undo_stack.canRedoChanged.connect(self.on_can_redo_changed)
|
||||
# 连接撤销栈的 canRedoChanged 信号到 on_can_redo_changed 槽函数
|
||||
self.undo_stack.canUndoChanged.connect(self.on_can_undo_changed)
|
||||
# 连接撤销栈的 canUndoChanged 信号到 on_can_undo_changed 槽函数
|
||||
self.undo_stack.cleanChanged.connect(self.on_undo_clean_changed)
|
||||
# 连接撤销栈的 cleanChanged 信号到 on_undo_clean_changed 槽函数
|
||||
|
||||
self.filename = None
|
||||
self.previous_transform = None
|
||||
self.active_mode = None
|
||||
self.filename = None# 当前打开的文件名
|
||||
self.previous_transform = None # 上一次的变换矩阵
|
||||
self.active_mode = None # 当前激活的模式
|
||||
|
||||
self.scene = BeeGraphicsScene(self.undo_stack)
|
||||
self.scene.changed.connect(self.on_scene_changed)
|
||||
self.scene.selectionChanged.connect(self.on_selection_changed)
|
||||
self.scene.cursor_changed.connect(self.on_cursor_changed)
|
||||
self.scene.cursor_cleared.connect(self.on_cursor_cleared)
|
||||
self.setScene(self.scene)
|
||||
self.scene = BeeGraphicsScene(self.undo_stack) # 初始化场景
|
||||
self.scene.changed.connect(self.on_scene_changed)
|
||||
# 连接场景的 changed 信号到 on_scene_changed 槽函数
|
||||
self.scene.selectionChanged.connect(self.on_selection_changed)
|
||||
# 连接场景的 selectionChanged 信号到 on_selection_changed 槽函数
|
||||
self.scene.cursor_changed.connect(self.on_cursor_changed)
|
||||
# 连接场景的 cursor_changed 信号到 on_cursor_changed 槽函数
|
||||
self.scene.cursor_cleared.connect(self.on_cursor_cleared)
|
||||
# 连接场景的 cursor_cleared 信号到 on_cursor_cleared 槽函数
|
||||
self.setScene(self.scene) # 设置场景
|
||||
|
||||
# Context menu and actions
|
||||
self.build_menu_and_actions()
|
||||
self.control_target = self
|
||||
self.init_main_controls(main_window=parent)
|
||||
self.build_menu_and_actions() # 构建菜单和操作
|
||||
self.control_target = self # 设置控制目标为自身
|
||||
self.init_main_controls(main_window=parent)# 初始化主控件
|
||||
|
||||
# Load files given via command line
|
||||
if commandline_args.filenames:
|
||||
fn = commandline_args.filenames[0]
|
||||
if os.path.splitext(fn)[1] == '.bee':
|
||||
self.open_from_file(fn)
|
||||
if commandline_args.filenames: # 如果命令行参数有文件名
|
||||
fn = commandline_args.filenames[0] # 获取第一个文件名
|
||||
if os.path.splitext(fn)[1] == '.bee': # 如果文件扩展名是 .bee
|
||||
self.open_from_file(fn) # 从文件打开
|
||||
else:
|
||||
self.do_insert_images(commandline_args.filenames)
|
||||
self.do_insert_images(commandline_args.filenames) # 否则插入图像
|
||||
|
||||
self.update_window_title()
|
||||
self.update_window_title() # 更新窗口标题
|
||||
|
||||
@property
|
||||
def filename(self):
|
||||
return self._filename
|
||||
@property # 文件名属性
|
||||
def filename(self): # 获取当前打开的文件名
|
||||
return self._filename # 返回当前打开的文件名
|
||||
|
||||
@filename.setter
|
||||
def filename(self, value):
|
||||
self._filename = value
|
||||
self.update_window_title()
|
||||
@filename.setter # 文件名属性设置器
|
||||
def filename(self, value): # 设置当前打开的文件名
|
||||
self._filename = value # 设置当前打开的文件名
|
||||
self.update_window_title() # 更新窗口标题
|
||||
if value:
|
||||
self.settings.update_recent_files(value)
|
||||
self.update_menu_and_actions()
|
||||
self.settings.update_recent_files(value) # 更新最近打开的文件列表
|
||||
self.update_menu_and_actions() # 更新菜单和操作
|
||||
|
||||
def cancel_active_modes(self):
|
||||
self.scene.cancel_active_modes()
|
||||
self.cancel_sample_color_mode()
|
||||
self.active_mode = None
|
||||
def cancel_active_modes(self): # 取消所有激活的模式
|
||||
self.scene.cancel_active_modes() # 取消场景中所有激活的模式
|
||||
self.cancel_sample_color_mode() # 取消取色模式
|
||||
self.active_mode = None # 重置当前激活的模式为 None
|
||||
|
||||
def cancel_sample_color_mode(self):
|
||||
logger.debug('Cancel sample color mode')
|
||||
self.active_mode = None
|
||||
self.viewport().unsetCursor()
|
||||
def cancel_sample_color_mode(self): # 取消取色模式
|
||||
logger.debug('Cancel sample color mode') # 调试日志：取消取色模式
|
||||
self.active_mode = None # 重置当前激活的模式为 None
|
||||
self.viewport().unsetCursor() # 取消设置视口光标
|
||||
if hasattr(self, 'sample_color_widget'):
|
||||
self.sample_color_widget.hide()
|
||||
del self.sample_color_widget
|
||||
self.sample_color_widget.hide() # 隐藏取色小部件
|
||||
del self.sample_color_widget # 删除取色小部件
|
||||
if self.scene.has_multi_selection():
|
||||
self.scene.multi_select_item.bring_to_front()
|
||||
self.scene.multi_select_item.bring_to_front()# 将多选项 bring to front
|
||||
|
||||
def update_window_title(self):
|
||||
clean = self.undo_stack.isClean()
|
||||
if clean and not self.filename:
|
||||
title = constants.APPNAME
|
||||
def update_window_title(self): # 更新窗口标题
|
||||
clean = self.undo_stack.isClean() # 获取撤销栈是否为干净状态
|
||||
if clean and not self.filename: # 如果撤销栈为干净状态且没有文件名
|
||||
title = constants.APPNAME # 窗口标题为应用程序名称
|
||||
else:
|
||||
name = os.path.basename(self.filename or '[Untitled]')
|
||||
clean = '' if clean else '*'
|
||||
title = f'{name}{clean} - {constants.APPNAME}'
|
||||
self.parent.setWindowTitle(title)
|
||||
name = os.path.basename(self.filename or '[Untitled]') # 获取文件名（如果有），否则为 '[Untitled]'
|
||||
clean = '' if clean else '*' # 如果撤销栈为干净状态，则不显示 '*'，否则显示 '*'
|
||||
title = f'{name}{clean} - {constants.APPNAME}'
|
||||
# 窗口标题为文件名（如果有），否则为 '[Untitled]'，后跟 '*'（如果撤销栈为不干净状态），最后为应用程序名称
|
||||
self.parent.setWindowTitle(title) # 设置父窗口标题为更新后的标题
|
||||
|
||||
def on_scene_changed(self, region):
|
||||
if not self.scene.items():
|
||||
logger.debug('No items in scene')
|
||||
self.setTransform(QtGui.QTransform())
|
||||
self.welcome_overlay.setFocus()
|
||||
self.clearFocus()
|
||||
self.welcome_overlay.show()
|
||||
self.actiongroup_set_enabled('active_when_items_in_scene', False)
|
||||
def on_scene_changed(self, region): # 场景变化槽函数
|
||||
if not self.scene.items(): # 如果场景中没有物品
|
||||
logger.debug('No items in scene') # 调试日志：场景中没有物品
|
||||
self.setTransform(QtGui.QTransform()) # 重置变换矩阵为单位矩阵
|
||||
self.welcome_overlay.setFocus() # 设置欢迎叠加层为焦点
|
||||
self.clearFocus() # 清除当前焦点
|
||||
self.welcome_overlay.show() # 显示欢迎叠加层
|
||||
self.actiongroup_set_enabled('active_when_items_in_scene', False) # 禁用场景中物品相关操作
|
||||
else:
|
||||
self.setFocus()
|
||||
self.welcome_overlay.clearFocus()
|
||||
self.welcome_overlay.hide()
|
||||
self.actiongroup_set_enabled('active_when_items_in_scene', True)
|
||||
self.recalc_scene_rect()
|
||||
self.setFocus(QtCore.Qt.PopupFocusReason) # 设置场景为焦点，使用 PopupFocusReason 原因
|
||||
self.welcome_overlay.clearFocus()# 清除欢迎叠加层焦点
|
||||
self.welcome_overlay.hide() # 隐藏欢迎叠加层
|
||||
self.actiongroup_set_enabled('active_when_items_in_scene', True) # 启用场景中物品相关操作
|
||||
self.recalc_scene_rect() # 重新计算场景矩形
|
||||
|
||||
def on_can_redo_changed(self, can_redo):
|
||||
self.actiongroup_set_enabled('active_when_can_redo', can_redo)
|
||||
def on_can_redo_changed(self, can_redo): # 可以重做变化槽函数
|
||||
self.actiongroup_set_enabled('active_when_can_redo', can_redo) # 根据 can_redo 启用或禁用 'active_when_can_redo' 操作组
|
||||
|
||||
def on_can_undo_changed(self, can_undo):
|
||||
self.actiongroup_set_enabled('active_when_can_undo', can_undo)
|
||||
def on_can_undo_changed(self, can_undo): # 可以撤销变化槽函数
|
||||
self.actiongroup_set_enabled('active_when_can_undo', can_undo) # 根据 can_undo 启用或禁用 'active_when_can_undo' 操作组
|
||||
|
||||
def on_undo_clean_changed(self, clean):
|
||||
self.update_window_title()
|
||||
def on_undo_clean_changed(self, clean): # 撤销栈干净状态变化槽函数
|
||||
self.update_window_title() # 更新窗口标题
|
||||
|
||||
def on_context_menu(self, point):
|
||||
self.context_menu.exec(self.mapToGlobal(point))
|
||||
def on_context_menu(self, point): # 上下文菜单槽函数
|
||||
self.context_menu.exec(self.mapToGlobal(point)) # 在全局坐标中执行上下文菜单
|
||||
|
||||
def get_supported_image_formats(self, cls):
|
||||
def get_supported_image_formats(self, cls): # 获取支持的图像格式
|
||||
formats = []
|
||||
|
||||
for f in cls.supportedImageFormats():
|
||||
string = f'*.{f.data().decode()}'
|
||||
formats.extend((string, string.upper()))
|
||||
return ' '.join(formats)
|
||||
for f in cls.supportedImageFormats(): # 遍历支持的图像格式
|
||||
string = f'*.{f.data().decode()}' # 转换为字符串格式
|
||||
formats.extend((string, string.upper())) # 扩展格式列表，包含小写和大写格式
|
||||
return ' '.join(formats) # 返回空格分隔的格式字符串
|
||||
|
||||
def get_view_center(self):
|
||||
def get_view_center(self): # 获取视图中心坐标
|
||||
return QtCore.QPoint(round(self.size().width() / 2),
|
||||
round(self.size().height() / 2))
|
||||
round(self.size().height() / 2)) # 返回视图中心坐标
|
||||
|
||||
def clear_scene(self):
|
||||
logging.debug('Clearing scene...')
|
||||
self.cancel_active_modes()
|
||||
self.scene.clear()
|
||||
self.undo_stack.clear()
|
||||
self.filename = None
|
||||
self.setTransform(QtGui.QTransform())
|
||||
def clear_scene(self): # 清除场景
|
||||
logging.debug('Clearing scene...') # 调试日志：清除场景
|
||||
self.cancel_active_modes() # 取消所有激活的模式
|
||||
self.scene.clear() # 清除场景中的所有物品
|
||||
self.undo_stack.clear() # 清除撤销栈
|
||||
self.filename = None # 重置文件名为 None
|
||||
self.setTransform(QtGui.QTransform()) # 重置变换矩阵为单位矩阵
|
||||
|
||||
def reset_previous_transform(self, toggle_item=None):
|
||||
if (self.previous_transform
|
||||
and self.previous_transform['toggle_item'] != toggle_item):
|
||||
self.previous_transform = None
|
||||
def reset_previous_transform(self, toggle_item=None): # 重置之前的变换
|
||||
if (self.previous_transform # 如果有之前的变换
|
||||
and self.previous_transform['toggle_item'] != toggle_item): # 如果之前的变换与当前物品不同
|
||||
self.previous_transform = None # 重置之前的变换为 None
|
||||
# 如果之前的变换与当前物品不同，将之前的变换重置为 None
|
||||
|
||||
def fit_rect(self, rect, toggle_item=None):
|
||||
if toggle_item and self.previous_transform:
|
||||
logger.debug('Fit view: Reset to previous')
|
||||
self.setTransform(self.previous_transform['transform'])
|
||||
self.centerOn(self.previous_transform['center'])
|
||||
self.previous_transform = None
|
||||
def fit_rect(self, rect, toggle_item=None): # 适合矩形
|
||||
if toggle_item and self.previous_transform: # 如果有之前的变换且与当前物品不同
|
||||
logger.debug('Fit view: Reset to previous') # 调试日志：重置到之前的变换
|
||||
self.setTransform(self.previous_transform['transform']) # 设置变换矩阵为之前的变换矩阵
|
||||
self.centerOn(self.previous_transform['center']) # 中心视图到之前的变换中心
|
||||
self.previous_transform = None # 重置之前的变换为 None
|
||||
return
|
||||
if toggle_item:
|
||||
self.previous_transform = {
|
||||
'toggle_item': toggle_item,
|
||||
'transform': QtGui.QTransform(self.transform()),
|
||||
'center': self.mapToScene(self.get_view_center()),
|
||||
if toggle_item: # 如果有物品
|
||||
self.previous_transform = { # 存储当前变换
|
||||
'toggle_item': toggle_item, # 存储当前物品
|
||||
'transform': QtGui.QTransform(self.transform()), # 存储当前变换矩阵
|
||||
'center': self.mapToScene(self.get_view_center()), # 存储当前视图中心坐标
|
||||
}
|
||||
else:
|
||||
self.previous_transform = None
|
||||
self.previous_transform = None # 重置之前的变换为 None
|
||||
|
||||
logger.debug(f'Fit view: {rect}')
|
||||
self.fitInView(rect, Qt.AspectRatioMode.KeepAspectRatio)
|
||||
self.recalc_scene_rect()
|
||||
logger.debug(f'Fit view: {rect}') # 调试日志：适合矩形
|
||||
self.fitInView(rect, Qt.AspectRatioMode.KeepAspectRatio) # 适合矩形，保持纵横比
|
||||
self.recalc_scene_rect() # 重新计算场景矩形
|
||||
# It seems to be more reliable when we fit a second time
|
||||
# Sometimes a changing scene rect can mess up the fitting
|
||||
self.fitInView(rect, Qt.AspectRatioMode.KeepAspectRatio)
|
||||
self.fitInView(rect, Qt.AspectRatioMode.KeepAspectRatio)
|
||||
logger.trace('Fit view done')
|
||||
|
||||
def get_confirmation_unsaved_changes(self, msg):
|
||||
|
|
|
|||
Loading…
Reference in a new issue