CuraContainerStack.py 20 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430
  1. # Copyright (c) 2018 Ultimaker B.V.
  2. # Cura is released under the terms of the LGPLv3 or higher.
  3. from typing import Any, cast, List, Optional, Dict
  4. from PyQt5.QtCore import pyqtProperty, pyqtSignal, QObject
  5. from UM.Application import Application
  6. from UM.Decorators import override
  7. from UM.FlameProfiler import pyqtSlot
  8. from UM.Logger import Logger
  9. from UM.Settings.ContainerStack import ContainerStack, InvalidContainerStackError
  10. from UM.Settings.InstanceContainer import InstanceContainer
  11. from UM.Settings.DefinitionContainer import DefinitionContainer
  12. from UM.Settings.ContainerRegistry import ContainerRegistry
  13. from UM.Settings.Interfaces import ContainerInterface, DefinitionContainerInterface
  14. from cura.Settings import cura_empty_instance_containers
  15. from . import Exceptions
  16. class CuraContainerStack(ContainerStack):
  17. """Base class for Cura related stacks that want to enforce certain containers are available.
  18. This class makes sure that the stack has the following containers set: user changes, quality
  19. changes, quality, material, variant, definition changes and finally definition. Initially,
  20. these will be equal to the empty instance container.
  21. The container types are determined based on the following criteria:
  22. - user: An InstanceContainer with the metadata entry "type" set to "user".
  23. - quality changes: An InstanceContainer with the metadata entry "type" set to "quality_changes".
  24. - quality: An InstanceContainer with the metadata entry "type" set to "quality".
  25. - material: An InstanceContainer with the metadata entry "type" set to "material".
  26. - variant: An InstanceContainer with the metadata entry "type" set to "variant".
  27. - definition changes: An InstanceContainer with the metadata entry "type" set to "definition_changes".
  28. - definition: A DefinitionContainer.
  29. Internally, this class ensures the mentioned containers are always there and kept in a specific order.
  30. This also means that operations on the stack that modifies the container ordering is prohibited and
  31. will raise an exception.
  32. """
  33. def __init__(self, container_id: str) -> None:
  34. super().__init__(container_id)
  35. self._empty_instance_container = cura_empty_instance_containers.empty_container #type: InstanceContainer
  36. self._empty_quality_changes = cura_empty_instance_containers.empty_quality_changes_container #type: InstanceContainer
  37. self._empty_quality = cura_empty_instance_containers.empty_quality_container #type: InstanceContainer
  38. self._empty_material = cura_empty_instance_containers.empty_material_container #type: InstanceContainer
  39. self._empty_variant = cura_empty_instance_containers.empty_variant_container #type: InstanceContainer
  40. self._containers = [self._empty_instance_container for i in range(len(_ContainerIndexes.IndexTypeMap))] #type: List[ContainerInterface]
  41. self._containers[_ContainerIndexes.QualityChanges] = self._empty_quality_changes
  42. self._containers[_ContainerIndexes.Quality] = self._empty_quality
  43. self._containers[_ContainerIndexes.Material] = self._empty_material
  44. self._containers[_ContainerIndexes.Variant] = self._empty_variant
  45. self.containersChanged.connect(self._onContainersChanged)
  46. import cura.CuraApplication #Here to prevent circular imports.
  47. self.setMetaDataEntry("setting_version", cura.CuraApplication.CuraApplication.SettingVersion)
  48. self._settable_per_extruder_cache = {} # type: Dict[str, Any]
  49. self.setDirty(False)
  50. # This is emitted whenever the containersChanged signal from the ContainerStack base class is emitted.
  51. pyqtContainersChanged = pyqtSignal()
  52. def setUserChanges(self, new_user_changes: InstanceContainer) -> None:
  53. """Set the user changes container.
  54. :param new_user_changes: The new user changes container. It is expected to have a "type" metadata entry with the value "user".
  55. """
  56. self.replaceContainer(_ContainerIndexes.UserChanges, new_user_changes)
  57. @pyqtProperty(InstanceContainer, fset = setUserChanges, notify = pyqtContainersChanged)
  58. def userChanges(self) -> InstanceContainer:
  59. """Get the user changes container.
  60. :return: The user changes container. Should always be a valid container, but can be equal to the empty InstanceContainer.
  61. """
  62. return cast(InstanceContainer, self._containers[_ContainerIndexes.UserChanges])
  63. def setQualityChanges(self, new_quality_changes: InstanceContainer, postpone_emit = False) -> None:
  64. """Set the quality changes container.
  65. :param new_quality_changes: The new quality changes container. It is expected to have a "type" metadata entry with the value "quality_changes".
  66. """
  67. self.replaceContainer(_ContainerIndexes.QualityChanges, new_quality_changes, postpone_emit = postpone_emit)
  68. @pyqtProperty(InstanceContainer, fset = setQualityChanges, notify = pyqtContainersChanged)
  69. def qualityChanges(self) -> InstanceContainer:
  70. """Get the quality changes container.
  71. :return: The quality changes container. Should always be a valid container, but can be equal to the empty InstanceContainer.
  72. """
  73. return cast(InstanceContainer, self._containers[_ContainerIndexes.QualityChanges])
  74. def setIntent(self, new_intent: InstanceContainer, postpone_emit: bool = False) -> None:
  75. """Set the intent container.
  76. :param new_intent: The new intent container. It is expected to have a "type" metadata entry with the value "intent".
  77. """
  78. self.replaceContainer(_ContainerIndexes.Intent, new_intent, postpone_emit = postpone_emit)
  79. @pyqtProperty(InstanceContainer, fset = setIntent, notify = pyqtContainersChanged)
  80. def intent(self) -> InstanceContainer:
  81. """Get the quality container.
  82. :return: The intent container. Should always be a valid container, but can be equal to the empty InstanceContainer.
  83. """
  84. return cast(InstanceContainer, self._containers[_ContainerIndexes.Intent])
  85. def setQuality(self, new_quality: InstanceContainer, postpone_emit: bool = False) -> None:
  86. """Set the quality container.
  87. :param new_quality: The new quality container. It is expected to have a "type" metadata entry with the value "quality".
  88. """
  89. self.replaceContainer(_ContainerIndexes.Quality, new_quality, postpone_emit = postpone_emit)
  90. @pyqtProperty(InstanceContainer, fset = setQuality, notify = pyqtContainersChanged)
  91. def quality(self) -> InstanceContainer:
  92. """Get the quality container.
  93. :return: The quality container. Should always be a valid container, but can be equal to the empty InstanceContainer.
  94. """
  95. return cast(InstanceContainer, self._containers[_ContainerIndexes.Quality])
  96. def setMaterial(self, new_material: InstanceContainer, postpone_emit: bool = False) -> None:
  97. """Set the material container.
  98. :param new_material: The new material container. It is expected to have a "type" metadata entry with the value "material".
  99. """
  100. self.replaceContainer(_ContainerIndexes.Material, new_material, postpone_emit = postpone_emit)
  101. @pyqtProperty(InstanceContainer, fset = setMaterial, notify = pyqtContainersChanged)
  102. def material(self) -> InstanceContainer:
  103. """Get the material container.
  104. :return: The material container. Should always be a valid container, but can be equal to the empty InstanceContainer.
  105. """
  106. return cast(InstanceContainer, self._containers[_ContainerIndexes.Material])
  107. def setVariant(self, new_variant: InstanceContainer) -> None:
  108. """Set the variant container.
  109. :param new_variant: The new variant container. It is expected to have a "type" metadata entry with the value "variant".
  110. """
  111. self.replaceContainer(_ContainerIndexes.Variant, new_variant)
  112. @pyqtProperty(InstanceContainer, fset = setVariant, notify = pyqtContainersChanged)
  113. def variant(self) -> InstanceContainer:
  114. """Get the variant container.
  115. :return: The variant container. Should always be a valid container, but can be equal to the empty InstanceContainer.
  116. """
  117. return cast(InstanceContainer, self._containers[_ContainerIndexes.Variant])
  118. def setDefinitionChanges(self, new_definition_changes: InstanceContainer) -> None:
  119. """Set the definition changes container.
  120. :param new_definition_changes: The new definition changes container. It is expected to have a "type" metadata entry with the value "definition_changes".
  121. """
  122. self.replaceContainer(_ContainerIndexes.DefinitionChanges, new_definition_changes)
  123. @pyqtProperty(InstanceContainer, fset = setDefinitionChanges, notify = pyqtContainersChanged)
  124. def definitionChanges(self) -> InstanceContainer:
  125. """Get the definition changes container.
  126. :return: The definition changes container. Should always be a valid container, but can be equal to the empty InstanceContainer.
  127. """
  128. return cast(InstanceContainer, self._containers[_ContainerIndexes.DefinitionChanges])
  129. def setDefinition(self, new_definition: DefinitionContainerInterface) -> None:
  130. """Set the definition container.
  131. :param new_definition: The new definition container. It is expected to have a "type" metadata entry with the value "definition".
  132. """
  133. self.replaceContainer(_ContainerIndexes.Definition, new_definition)
  134. def getDefinition(self) -> "DefinitionContainer":
  135. return cast(DefinitionContainer, self._containers[_ContainerIndexes.Definition])
  136. definition = pyqtProperty(QObject, fget = getDefinition, fset = setDefinition, notify = pyqtContainersChanged)
  137. @override(ContainerStack)
  138. def getBottom(self) -> "DefinitionContainer":
  139. return self.definition
  140. @override(ContainerStack)
  141. def getTop(self) -> "InstanceContainer":
  142. return self.userChanges
  143. @pyqtSlot(str, result = bool)
  144. def hasUserValue(self, key: str) -> bool:
  145. """Check whether the specified setting has a 'user' value.
  146. A user value here is defined as the setting having a value in either
  147. the UserChanges or QualityChanges container.
  148. :return: True if the setting has a user value, False if not.
  149. """
  150. if self._containers[_ContainerIndexes.UserChanges].hasProperty(key, "value"):
  151. return True
  152. if self._containers[_ContainerIndexes.QualityChanges].hasProperty(key, "value"):
  153. return True
  154. return False
  155. def setProperty(self, key: str, property_name: str, property_value: Any, container: "ContainerInterface" = None, set_from_cache: bool = False) -> None:
  156. """Set a property of a setting.
  157. This will set a property of a specified setting. Since the container stack does not contain
  158. any settings itself, it is required to specify a container to set the property on. The target
  159. container is matched by container type.
  160. :param key: The key of the setting to set.
  161. :param property_name: The name of the property to set.
  162. :param new_value: The new value to set the property to.
  163. """
  164. container_index = _ContainerIndexes.UserChanges
  165. self._containers[container_index].setProperty(key, property_name, property_value, container, set_from_cache)
  166. @override(ContainerStack)
  167. def addContainer(self, container: ContainerInterface) -> None:
  168. """Overridden from ContainerStack
  169. Since we have a fixed order of containers in the stack and this method would modify the container
  170. ordering, we disallow this operation.
  171. """
  172. raise Exceptions.InvalidOperationError("Cannot add a container to Global stack")
  173. @override(ContainerStack)
  174. def insertContainer(self, index: int, container: ContainerInterface) -> None:
  175. """Overridden from ContainerStack
  176. Since we have a fixed order of containers in the stack and this method would modify the container
  177. ordering, we disallow this operation.
  178. """
  179. raise Exceptions.InvalidOperationError("Cannot insert a container into Global stack")
  180. @override(ContainerStack)
  181. def removeContainer(self, index: int = 0) -> None:
  182. """Overridden from ContainerStack
  183. Since we have a fixed order of containers in the stack and this method would modify the container
  184. ordering, we disallow this operation.
  185. """
  186. raise Exceptions.InvalidOperationError("Cannot remove a container from Global stack")
  187. @override(ContainerStack)
  188. def replaceContainer(self, index: int, container: ContainerInterface, postpone_emit: bool = False) -> None:
  189. """Overridden from ContainerStack
  190. Replaces the container at the specified index with another container.
  191. This version performs checks to make sure the new container has the expected metadata and type.
  192. :throws Exception.InvalidContainerError Raised when trying to replace a container with a container that has an incorrect type.
  193. """
  194. expected_type = _ContainerIndexes.IndexTypeMap[index]
  195. if expected_type == "definition":
  196. if not isinstance(container, DefinitionContainer):
  197. raise Exceptions.InvalidContainerError("Cannot replace container at index {index} with a container that is not a DefinitionContainer".format(index = index))
  198. elif container != self._empty_instance_container and container.getMetaDataEntry("type") != expected_type:
  199. raise Exceptions.InvalidContainerError("Cannot replace container at index {index} with a container that is not of {type} type, but {actual_type} type.".format(index = index, type = expected_type, actual_type = container.getMetaDataEntry("type")))
  200. current_container = self._containers[index]
  201. if current_container.getId() == container.getId():
  202. return
  203. super().replaceContainer(index, container, postpone_emit)
  204. @override(ContainerStack)
  205. def deserialize(self, serialized: str, file_name: Optional[str] = None) -> str:
  206. """Overridden from ContainerStack
  207. This deserialize will make sure the internal list of containers matches with what we expect.
  208. It will first check to see if the container at a certain index already matches with what we
  209. expect. If it does not, it will search for a matching container with the correct type. Should
  210. no container with the correct type be found, it will use the empty container.
  211. :raise InvalidContainerStackError: Raised when no definition can be found for the stack.
  212. """
  213. # update the serialized data first
  214. serialized = super().deserialize(serialized, file_name)
  215. new_containers = self._containers.copy()
  216. while len(new_containers) < len(_ContainerIndexes.IndexTypeMap):
  217. new_containers.append(self._empty_instance_container)
  218. # Validate and ensure the list of containers matches with what we expect
  219. for index, type_name in _ContainerIndexes.IndexTypeMap.items():
  220. container = None
  221. try:
  222. container = new_containers[index]
  223. except IndexError:
  224. pass
  225. if type_name == "definition":
  226. if not container or not isinstance(container, DefinitionContainer):
  227. definition = self.findContainer(container_type = DefinitionContainer)
  228. if not definition:
  229. raise InvalidContainerStackError("Stack {id} does not have a definition!".format(id = self.getId()))
  230. new_containers[index] = definition
  231. continue
  232. if not container or container.getMetaDataEntry("type") != type_name:
  233. actual_container = self.findContainer(type = type_name)
  234. if actual_container:
  235. new_containers[index] = actual_container
  236. else:
  237. new_containers[index] = self._empty_instance_container
  238. self._containers = new_containers
  239. # CURA-5281
  240. # Some stacks can have empty definition_changes containers which will cause problems.
  241. # Make sure that all stacks here have non-empty definition_changes containers.
  242. if isinstance(new_containers[_ContainerIndexes.DefinitionChanges], type(self._empty_instance_container)):
  243. from cura.Settings.CuraStackBuilder import CuraStackBuilder
  244. CuraStackBuilder.createDefinitionChangesContainer(self, self.getId() + "_settings")
  245. ## TODO; Deserialize the containers.
  246. return serialized
  247. def _onContainersChanged(self, container: Any) -> None:
  248. """Helper to make sure we emit a PyQt signal on container changes."""
  249. Application.getInstance().callLater(self.pyqtContainersChanged.emit)
  250. # Helper that can be overridden to get the "machine" definition, that is, the definition that defines the machine
  251. # and its properties rather than, for example, the extruder. Defaults to simply returning the definition property.
  252. def _getMachineDefinition(self) -> DefinitionContainer:
  253. return self.definition
  254. @classmethod
  255. def _findInstanceContainerDefinitionId(cls, machine_definition: DefinitionContainerInterface) -> str:
  256. """Find the ID that should be used when searching for instance containers for a specified definition.
  257. This handles the situation where the definition specifies we should use a different definition when
  258. searching for instance containers.
  259. :param machine_definition: The definition to find the "quality definition" for.
  260. :return: The ID of the definition container to use when searching for instance containers.
  261. """
  262. quality_definition = machine_definition.getMetaDataEntry("quality_definition")
  263. if not quality_definition:
  264. return machine_definition.id #type: ignore
  265. definitions = ContainerRegistry.getInstance().findDefinitionContainers(id = quality_definition)
  266. if not definitions:
  267. Logger.log("w", "Unable to find parent definition {parent} for machine {machine}", parent = quality_definition, machine = machine_definition.id) #type: ignore
  268. return machine_definition.id #type: ignore
  269. return cls._findInstanceContainerDefinitionId(definitions[0])
  270. def getExtruderPositionValueWithDefault(self, key):
  271. """getProperty for extruder positions, with translation from -1 to default extruder number"""
  272. value = self.getProperty(key, "value")
  273. if value == -1:
  274. value = int(Application.getInstance().getMachineManager().defaultExtruderPosition)
  275. return value
  276. def getProperty(self, key: str, property_name: str, context = None) -> Any:
  277. if property_name == "settable_per_extruder":
  278. # Setable per extruder isn't a value that can ever change. So once we requested it once, we can just keep
  279. # that in memory.
  280. try:
  281. return self._settable_per_extruder_cache[key]
  282. except KeyError:
  283. self._settable_per_extruder_cache[key] = super().getProperty(key, property_name, context)
  284. return self._settable_per_extruder_cache[key]
  285. return super().getProperty(key, property_name, context)
  286. class _ContainerIndexes:
  287. """Private helper class to keep track of container positions and their types."""
  288. UserChanges = 0
  289. QualityChanges = 1
  290. Intent = 2
  291. Quality = 3
  292. Material = 4
  293. Variant = 5
  294. DefinitionChanges = 6
  295. Definition = 7
  296. # Simple hash map to map from index to "type" metadata entry
  297. IndexTypeMap = {
  298. UserChanges: "user",
  299. QualityChanges: "quality_changes",
  300. Intent: "intent",
  301. Quality: "quality",
  302. Material: "material",
  303. Variant: "variant",
  304. DefinitionChanges: "definition_changes",
  305. Definition: "definition",
  306. }
  307. # Reverse lookup: type -> index
  308. TypeIndexMap = dict([(v, k) for k, v in IndexTypeMap.items()])