3D-printing/Cura
1
0
Fork 0
mirror of https://github.com/Ultimaker/Cura.git synced 2025-07-12 09:17:50 -06:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Document PreviewStage.py

Browse source 
Some stuff I had to ask the original implementer to explain to me. So I wrote that down so that the next guy doesn't have to do that.

Contributes to issue CURA-5829.
This commit is contained in:
Ghostkeeper 2018-11-02 15:11:49 +01:00
parent a85fa6b9ad
commit 20b3b6da79
No known key found for this signature in database
GPG key ID: 86BEF881AE2CF276
3 changed files with 20 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

3
plugins/PreviewStage/PreviewMenu.qml
View file

@ -1,3 +1,6 @@
// Copyright (c) 2018 Ultimaker B.V.
// Cura is released under the terms of the LGPLv3 or higher.
import QtQuick 2.7 import QtQuick 2.7
import QtQuick.Controls 1.4 import QtQuick.Controls 1.4

16
plugins/PreviewStage/PreviewStage.py
View file

@ -1,5 +1,6 @@
# Copyright (c) 2018 Ultimaker B.V. # Copyright (c) 2018 Ultimaker B.V.
# Cura is released under the terms of the LGPLv3 or higher. # Cura is released under the terms of the LGPLv3 or higher.
import os.path import os.path
from UM.Qt.QtApplication import QtApplication from UM.Qt.QtApplication import QtApplication
@ -11,6 +12,11 @@ if TYPE_CHECKING:
from UM.View.View import View from UM.View.View import View
## Displays a preview of what you're about to print.
#
# The Python component of this stage just loads PreviewMain.qml for display
# when the stage is selected, and makes sure that it reverts to the previous
# view when the previous stage is activated.
class PreviewStage(CuraStage): class PreviewStage(CuraStage):
def __init__(self, application: QtApplication, parent = None) -> None: def __init__(self, application: QtApplication, parent = None) -> None:
super().__init__(parent) super().__init__(parent)
@ -18,14 +24,24 @@ class PreviewStage(CuraStage):
self._application.engineCreatedSignal.connect(self._engineCreated) self._application.engineCreatedSignal.connect(self._engineCreated)
self._previously_active_view = None # type: Optional[View] self._previously_active_view = None # type: Optional[View]
## When selecting the stage, remember which was the previous view so that
# we can revert to that view when we go out of the stage later.
def onStageSelected(self) -> None: def onStageSelected(self) -> None:
self._previously_active_view = self._application.getController().getActiveView() self._previously_active_view = self._application.getController().getActiveView()
## Called when going to a different stage (away from the Preview Stage).
#
# When going to a different stage, the view should be reverted to what it
# was before. Normally, that just reverts it to solid view.
def onStageDeselected(self) -> None: def onStageDeselected(self) -> None:
if self._previously_active_view is not None: if self._previously_active_view is not None:
self._application.getController().setActiveView(self._previously_active_view.getPluginId()) self._application.getController().setActiveView(self._previously_active_view.getPluginId())
self._previously_active_view = None self._previously_active_view = None
## Delayed load of the QML files.
#
# We need to make sure that the QML engine is running before we can load
# these.
def _engineCreated(self) -> None: def _engineCreated(self) -> None:
plugin_path = self._application.getPluginRegistry().getPluginPath(self.getPluginId()) plugin_path = self._application.getPluginRegistry().getPluginPath(self.getPluginId())
if plugin_path is not None: if plugin_path is not None:

2
plugins/PreviewStage/__init__.py
View file

@ -1,4 +1,4 @@
# Copyright (c) 2017 Ultimaker B.V. # Copyright (c) 2018 Ultimaker B.V.
# Cura is released under the terms of the LGPLv3 or higher. # Cura is released under the terms of the LGPLv3 or higher.
from . import PreviewStage from . import PreviewStage