CreativePython 1.1.4__py3-none-any.whl → 1.1.5__py3-none-any.whl

CreativePython/GuiHandler.py

@@ -86,11 +86,20 @@ def _launchRenderer(childCommandConnection, childPriorityConnection, parentPrior
 
    parentPriorityConnection.close()   # child must not hold the parent end open
 
-   # Redirect stderr (fd 2) to a log file so both Python tracebacks and C-level
-   # output from Qt/Cocoa/XPC are captured for diagnostics.
-   # The log is removed on clean exit if nothing was written to it.
-   _logPath = os.path.join(os.getcwd(), "PENCIL_debug.log")
-   _logFile = open(_logPath, "w")
+   # Set to True to redirect stderr to PENCIL_debug.log for diagnostics.
+   # When False, stderr is silenced (sent to /dev/null) to suppress Qt/Cocoa noise.
+   _DEBUG_LOG = False
+
+   if _DEBUG_LOG:
+      # Redirect stderr (fd 2) to a log file so both Python tracebacks and C-level
+      # output from Qt/Cocoa/XPC are captured for diagnostics.
+      # The log is removed on clean exit if nothing was written to it.
+      _logPath = os.path.join(os.getcwd(), "PENCIL_debug.log")
+      _logFile = open(_logPath, "w")
+   else:
+      _logPath = None
+      _logFile = open(os.devnull, "w")
+
    os.dup2(_logFile.fileno(), 2)
    sys.stderr = _logFile
 
@@ -103,7 +112,7 @@ def _launchRenderer(childCommandConnection, childPriorityConnection, parentPrior
       raise
    finally:
       _logFile.flush()
-      if os.path.getsize(_logPath) == 0:
+      if _DEBUG_LOG and _logPath and os.path.getsize(_logPath) == 0:
          try:
             _logFile.close()
             os.unlink(_logPath)

CreativePython/GuiRenderer.py

@@ -549,9 +549,10 @@ class _QtGraphicsItemEventMixin:
       pos  = event.scenePos()
       args = [int(pos.x()), int(pos.y())]
       self._send('mouseDown', args)
-      # register this item for drag delivery during subsequent mouse moves
+      # register this item for release and drag delivery during subsequent mouse events
       view = self._qtview()
       if view is not None:
+         view._pressedItems.append(self._mirror.objectId)   # track for manual release delivery (see QtView.mouseReleaseEvent)
          if (self._mirror.objectId, 'mouseDrag') in self._mirror.guiRenderer._registeredEvents:
             view._draggingItems.append(self._mirror.objectId)
       event.ignore()   # allow cascade to items below
@@ -653,6 +654,7 @@ class QtView(QtWidgets.QGraphicsView):
       self._display       = displayMirror
       self._pressPos      = None   # QPointF scene pos at last press
       self._draggingItems = []     # objectIds wanting drag events
+      self._pressedItems  = []     # objectIds of items that received the last mousePressEvent
 
    # ── Helpers ────────────────────────────────────────────────────────────────
 
@@ -679,16 +681,28 @@ class QtView(QtWidgets.QGraphicsView):
 
    def mouseReleaseEvent(self, event):
       x, y = self._sceneXY(event)
-      super().mouseReleaseEvent(event)  # → item cascade via mixin
+
+      # Items call event.ignore() in mousePressEvent to allow cascade, so Qt never
+      # sets a mouse grabber and mouseReleaseEvent is never routed to items normally.
+      # Manually deliver mouseUp and mouseClick using the objectIds tracked at press time,
+      # mirroring the _draggingItems pattern used for mouseDrag.
+      registered = self._display.guiRenderer._registeredEvents
+      pos        = self.mapToScene(event.position().toPoint())
+      is_click   = (self._pressPos is not None
+                    and abs(pos.x() - self._pressPos.x()) <= _QtGraphicsItemEventMixin._CLICK_THRESHOLD
+                    and abs(pos.y() - self._pressPos.y()) <= _QtGraphicsItemEventMixin._CLICK_THRESHOLD)
+      for objectId in self._pressedItems:
+         if (objectId, 'mouseUp') in registered:
+            self._display.guiRenderer.sendEvent('mouseUp', objectId, [x, y])
+         if is_click and (objectId, 'mouseClick') in registered:
+            self._display.guiRenderer.sendEvent('mouseClick', objectId, [x, y])
+
       self._sendDisplay('mouseUp', [x, y])
-      if self._pressPos is not None:
-         pos = self.mapToScene(event.position().toPoint())
-         dx  = abs(pos.x() - self._pressPos.x())
-         dy  = abs(pos.y() - self._pressPos.y())
-         if dx <= _QtGraphicsItemEventMixin._CLICK_THRESHOLD and dy <= _QtGraphicsItemEventMixin._CLICK_THRESHOLD:
-            self._sendDisplay('mouseClick', [x, y])
+      if is_click:
+         self._sendDisplay('mouseClick', [x, y])
       self._pressPos      = None
       self._draggingItems = []
+      self._pressedItems  = []
 
    def mouseMoveEvent(self, event):
       x, y = self._sceneXY(event)

CreativePython/__init__.py

@@ -1,4 +1,10 @@
 import platform, ctypes, importlib.resources
+from importlib.metadata import version as _metadata_version
+
+try:
+    __version__ = _metadata_version("CreativePython")
+except Exception:
+    __version__ = "unknown"
 
 
 # import portaudio binary on MacOS

{creativepython-1.1.4.dist-info → creativepython-1.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: CreativePython
-Version: 1.1.4
+Version: 1.1.5
 Summary: A Python-based software environment for developing algorithmic art projects.
 Author-email: "Dr. Bill Manaris" <manaris@cofc.edu>, Taj Ballinger <ballingertj@g.cofc.edu>, Trevor Ritchie <ritchiets@g.cofc.edu>
 License: MIT License

{creativepython-1.1.4.dist-info → creativepython-1.1.5.dist-info}/RECORD

@@ -1,16 +1,16 @@
-gui.py,sha256=2UjM25KRq8NdA6D5mUeb797tPBklTbUwBLf7uKm7W5A,134968
+gui.py,sha256=U_mAXHFJeSyDPF0lz3vs2AExwsOEdK_slAImKKRm9eE,136824
 iannix.py,sha256=jlBJhPzBcIl2iayG01ldoslAytxYOvP3z_vN-EgiJA4,17188
-image.py,sha256=-jp7ewEcw60GdzqGfcRMXons1nTEEuml6yZmTeWkc1w,3703
+image.py,sha256=wohpTTZH6QzN3wRfXI5ac7VTRsOKcwqk8_d3yha8oDw,3763
 markov.py,sha256=VhTXZfDDHETj6KhriFmOLHKNjgx08cWZvpLECuGRTG0,24653
-midi.py,sha256=IUS5grFuI23cun7R5wa5AyBZDGhFJsxzqXPrfaN4cEs,42826
-music.py,sha256=--h3xSVTFJL59sjSN6vLho9Y-XCktcSOxgVAYHu1bZo,266610
-osc.py,sha256=76qLrFE_vXLaqi0c4XDilromvVSZjPMseNIpQm9C1IM,18724
+midi.py,sha256=g5qezyjD--oj92uUR7g91V4-IiYWhjrHQuIwV8XfQR8,27282
+music.py,sha256=H-4c03IZBmjaLeio6ZQTl0BZGGU-Ri6GdiOj2L-mmJI,268534
+osc.py,sha256=yUIIvPZmEmaxnpP2Q9FBh-sCL9aXR-qFDQk4N7998vk,8553
 timer.py,sha256=uQ1BHWTjZ6DpJo-leGhxgOJcVcd1Lj0jvQQodXx1kw4,16341
 zipf.py,sha256=J6fWwUYz88LFAwanc0TmXJlU7VtpBM24_Rw5XJTOn9c,40312
-CreativePython/GuiHandler.py,sha256=sNwvHlcHJhq61l5r8hXKeDh_17RG_ewI-aZ9rx49UjU,30662
-CreativePython/GuiRenderer.py,sha256=CpjBcc_NnZ4UW1HtIRy_PjIXapZ_thKpGI_RG4mX0AQ,138519
+CreativePython/GuiHandler.py,sha256=ONnxhqivBrzCHQv7GcE4vkMgnONbuXXq7Fwe0Au5QPs,30974
+CreativePython/GuiRenderer.py,sha256=jqoKD2XSNeDJ4lAmQXfaEbtVrsL-4LublHhbUHbJRkk,139445
 CreativePython/RealtimeAudioPlayer.py,sha256=tjqBjSOvSvH1kP0t6q35xsbKHPr0wuLUvGdxdWAY73E,44590
-CreativePython/__init__.py,sha256=lQcg42OKznQmgyt_WYsrsXFen2sJK4j0TUBGtCX-54Y,285
+CreativePython/__init__.py,sha256=bT1nZ-Fp8-7uiKqhVdnFeOwL-8Jps2rvE6BfoOE8fZ0,451
 CreativePython/notationRenderer.py,sha256=2KIMvInNLEUZyn_r1KMmyt7X2XDrfekVkggFeHLRu1M,35440
 CreativePython/nevmuse/RunMetrics.py,sha256=wP5HeS7u5VmH9s-9yyF1EuvF8xFcU6oYTT90Qr16Mu0,4917
 CreativePython/nevmuse/Surveyor.py,sha256=y5_GgTpfZl4IteymBD1-I1lduZuw-ap1mS9zgnOamUc,4794
@@ -77,9 +77,9 @@ CreativePython/nevmuse/utilities/CSVWriter.py,sha256=k2GccvzD5IwdkmFdN5qtRA2qZX1
 CreativePython/nevmuse/utilities/PowerLawRandom.py,sha256=WIEI-p8wiiWhkkBR5pO9gJ2TwxZBw453T_xXzCNdKPY,3752
 CreativePython/nevmuse/utilities/__init__.py,sha256=pAGIMMGfLvR2DQfxr8qkfKQJ-4fIkVqlhnGK657JPL8,166
 bin/libportaudio.2.dylib,sha256=ooJlm7QeL7jYzc1c8YMmH-C8PhYHwDvBJZkNDVPFRbE,286592
-creativepython-1.1.4.dist-info/licenses/LICENSE,sha256=tz38qDa5RhHMqzZR1Q5QafqWdXn_EhheXYBP7FjgtEM,1992
-creativepython-1.1.4.dist-info/licenses/LICENSE-PSF,sha256=JN1jUPIsEUH1mq3AXxet-b1IdhAr-XzscXBZiz74c9c,3371
-creativepython-1.1.4.dist-info/METADATA,sha256=qM6dP7eB2aczJ8OJxuKcfVU5EpfKSpbeoBpOqiTe6Hw,8703
-creativepython-1.1.4.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-creativepython-1.1.4.dist-info/top_level.txt,sha256=PzvvUyy-3YzTedVGnLS02ju1TCMuo76h1LuVd8XvHhA,69
-creativepython-1.1.4.dist-info/RECORD,,
+creativepython-1.1.5.dist-info/licenses/LICENSE,sha256=tz38qDa5RhHMqzZR1Q5QafqWdXn_EhheXYBP7FjgtEM,1992
+creativepython-1.1.5.dist-info/licenses/LICENSE-PSF,sha256=JN1jUPIsEUH1mq3AXxet-b1IdhAr-XzscXBZiz74c9c,3371
+creativepython-1.1.5.dist-info/METADATA,sha256=jesD86ZrXoIlpqmWVilNd9KtPsNsQEeP9UmEfMZEuzE,8703
+creativepython-1.1.5.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+creativepython-1.1.5.dist-info/top_level.txt,sha256=PzvvUyy-3YzTedVGnLS02ju1TCMuo76h1LuVd8XvHhA,69
+creativepython-1.1.5.dist-info/RECORD,,

gui.py

@@ -197,24 +197,48 @@ class Color:
       """
       return self.red
 
+   def setRed(self, red):
+      """
+      Sets the Color's red value (0-255).
+      """
+      self.red = int(red)
+
    def getGreen(self):
       """
       Returns the Color's green value (0-255).
       """
       return self.green
 
+   def setGreen(self, green):
+      """
+      Sets the Color's green value (0-255).
+      """
+      self.green = int(green)
+
    def getBlue(self):
       """
       Returns the Color's blue value (0-255).
       """
       return self.blue
 
+   def setBlue(self, blue):
+      """
+      Sets the Color's blue value (0-255).
+      """
+      self.blue = int(blue)
+
    def getAlpha(self):
       """
       Returns the Color's transparency value (0-255).
       """
       return self.alpha
 
+   def setAlpha(self, alpha):
+      """
+      Sets the Color's transparency value (0-255).
+      """
+      self.alpha = int(alpha)
+
    def getRGB(self):
       """
       Returns the Color's values (0-255) as a list.
@@ -442,9 +466,9 @@ class Font:
       """
       Creates a new Font object.
       """
-      self._name  = name
-      self._style = style
-      self._size  = size
+      self.name  = name
+      self.style = style
+      self.size  = size
 
    def __str__(self):
       return f'Font(name = "{self.getName()}", style = {self.getStyle()}, size = {self.getSize()}")'
@@ -456,7 +480,13 @@ class Font:
       """
       Returns the Font's family name as a string.
       """
-      return self._name
+      return self.name
+
+   def setName(self, name):
+      """
+      Sets the Font's family name.
+      """
+      self.name = name
 
    def getStyle(self):
       """
@@ -464,13 +494,25 @@ class Font:
       The first value represents the Font's weight.
       The second value represents whether the Font is italicized.
       """
-      return self._style
+      return self.style
+
+   def setStyle(self, style):
+      """
+      Sets the Font's style (e.g., Font.PLAIN, Font.BOLD, Font.ITALIC, Font.BOLDITALIC).
+      """
+      self.style = style
 
    def getSize(self):
       """
       Returns the Font's point size.
       """
-      return self._size
+      return self.size
+
+   def setSize(self, size):
+      """
+      Sets the Font's point size.
+      """
+      self.size = size
 
 
 #######################################################################################
@@ -1071,6 +1113,15 @@ class Display(_Interactable):
          'font':  fontData,
       })
 
+   # ── Compatibility Aliases ─────────────────────────────────────────────────────────
+
+   def drawText(self, text, x, y, color=Color.BLACK, font=None):
+      """
+      Paints a text label onto the display's draw layer.
+      Unlike add(), this is a one-time paint — no object is created or returned.
+      The result is permanent until clearDrawing() is called.
+      """
+      self.drawLabel(text, x, y, color, font)
 
 #######################################################################################
 # Drawable - items that can be added to a Display
@@ -2179,6 +2230,7 @@ class Icon(_Graphics):
       self._height         = height if height is not None else 0
       self._originalWidth  = self._width
       self._originalHeight = self._height
+      self._pixelCache     = None   # lazily populated on getPixel/getPixels; invalidated by crop/setPixel/setPixels
 
       _handler().sendCommand('create', self._objectId, {
          'type':     'Icon',
@@ -2224,8 +2276,9 @@ class Icon(_Graphics):
       """
       Crop the icon to the specified rectangle, relative to the icon's position.
       """
-      self._width  = int(width)
-      self._height = int(height)
+      self._width      = int(width)
+      self._height     = int(height)
+      self._pixelCache = None  # invalidate local cache
       _handler().sendCommand('crop', self._objectId, {'x': x, 'y': y, 'width': width, 'height': height})
 
    # ── Pixel Manipulation ────────────────────────────────────────────────────────────
@@ -2234,27 +2287,31 @@ class Icon(_Graphics):
       """
       Returns the [r, g, b] color of a given pixel in the icon.
       """
-      result = _handler().sendQuery('getPixel', self._objectId, {'column': column, 'row': row})
-      return result
+      if self._pixelCache is None:  # fetch local cache, if needed
+         self._pixelCache = _handler().sendQuery('getPixels', self._objectId)
+      return self._pixelCache[row][column]
 
    def setPixel(self, column, row, color):
       """
       Sets the [r, g, b] color of a given pixel in the icon.
       """
       r, g, b = color
+      self._pixelCache = None  # invalidate local cache
       _handler().sendCommand('setPixel', self._objectId, {'column': column, 'row': row, 'color': [r, g, b]})
 
    def getPixels(self):
       """
       Returns the [r, g, b] color of all pixels in the icon as a 2-dimensional array.
       """
-      result = _handler().sendQuery('getPixels', self._objectId)
-      return result[0]
+      if self._pixelCache is None:  # fetch local cache, if needed
+         self._pixelCache = _handler().sendQuery('getPixels', self._objectId)
+      return self._pixelCache
 
    def setPixels(self, pixels):
       """
       Sets the [r, g, b] color of all pixels in the icon from a 2-dimensional array.
       """
+      self._pixelCache = None  # invalidate local cache
       _handler().sendCommand('setPixels', self._objectId, {'pixels': pixels})
 
 

image.py

@@ -24,8 +24,9 @@ class Image:
       # (int, None) -> the width of a square, blank canvas
       # (int, int)  -> the width and height of a blank canvas
 
-      self._display = Display()  # create a new, blank Display
-      self.read(arg1, arg2)      # read() handles loading the icon, plus setting the title and size of the Display
+      self._display = Display()  # the display the image is on
+      self._icon    = None       # the icon that holds the image data (created in read())
+      self.read(arg1, arg2)      # read() loads the icon and sets Display properties
 
    def show(self):
       """