CreativePython 0.3.0__py3-none-any.whl → 0.3.2__py3-none-any.whl

{creativepython-0.3.0.dist-info → creativepython-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: CreativePython
-Version: 0.3.0
+Version: 0.3.2
 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
@@ -76,8 +76,8 @@ CreativePython is distributed under the MIT License.
 
 - [Homepage](https://jythonmusic.me/)
 - [Download All Examples [ZIP]](https://www.dropbox.com/scl/fo/rvc8m8pt4m0281qn0t4oi/AO2Y0W2qOrOcurlQmLa7M54?rlkey=0sf80bmov135tc85dk9k7ats6&dl=1)
-- [Report a Bug (email link)](mailto:manaris@cofc.edu?cc=ballingertj@g.cofc.edu,ritchiets@g.cofc.edu&subject=[CreativePython]%20Bug%20Report&body=CreativePython%20Version:%20(e.g.%200.1.8)%0D%0AOperating%20System:%20(e.g.%20macOS%2015,%20Windows%2011,%20Ubuntu%2024.04)%0D%0APython%20Version:%20(e.g.%203.11)%0D%0A%0D%0ASummary:%0D%0A%0D%0ASteps%20to%20Reproduce:%0D%0A1.%20%0D%0A2.%20%0D%0A3.%20%0D%0A%0D%0AExpected%20Result:%0D%0A%0D%0AActual%20Result:%0D%0A%0D%0AError%20Messages%20or%20Logs:%0D%0A)
-- [Request a Feature (email link)](mailto:manaris@cofc.edu?cc=ballingertj@g.cofc.edu,ritchiets@g.cofc.edu&subject=[CreativePython]%20Feature%20Request&body=CreativePython%20Version:%20(e.g.%200.1.8)%0D%0AOperating%20System:%20(e.g.%20macOS%2015,%20Windows%2011,%20Ubuntu%2024.04)%0D%0A%0D%0AFeature%20Name:%0D%0A%0D%0ADescription:%0D%0A%0D%0AExample%20Use%20Case%20or%20Scenario:%0D%0A%0D%0ARelated%20Modules%20or%20Functions:%0D%0A%0D%0A)
+- [Report a Bug (email link)](mailto:creativepythoncofc@gmail.com&subject=[CreativePython]%20Bug%20Report&body=CreativePython%20Version:%20(e.g.%200.1.8)%0D%0AOperating%20System:%20(e.g.%20macOS%2015,%20Windows%2011,%20Ubuntu%2024.04)%0D%0APython%20Version:%20(e.g.%203.11)%0D%0A%0D%0ASummary:%0D%0A%0D%0ASteps%20to%20Reproduce:%0D%0A1.%20%0D%0A2.%20%0D%0A3.%20%0D%0A%0D%0AExpected%20Result:%0D%0A%0D%0AActual%20Result:%0D%0A%0D%0AError%20Messages%20or%20Logs:%0D%0A)
+- [Request a Feature (email link)](mailto:creativepythoncofc@gmail.com&subject=[CreativePython]%20Feature%20Request&body=CreativePython%20Version:%20(e.g.%200.1.8)%0D%0AOperating%20System:%20(e.g.%20macOS%2015,%20Windows%2011,%20Ubuntu%2024.04)%0D%0A%0D%0AFeature%20Name:%0D%0A%0D%0ADescription:%0D%0A%0D%0AExample%20Use%20Case%20or%20Scenario:%0D%0A%0D%0ARelated%20Modules%20or%20Functions:%0D%0A%0D%0A)
 
 This package is still under development.
 

{creativepython-0.3.0.dist-info → creativepython-0.3.2.dist-info}/RECORD

@@ -1,5 +1,5 @@
 _RealtimeAudioPlayer.py,sha256=AHKDE4etmfRgwyUG3SIoEblXoPaFUk9oxQLy1BgDFP8,46808
-gui.py,sha256=7j7axSEcUVR9cVyMCuSNILtb_GMev1C2xv1cg3o5iMQ,163606
+gui.py,sha256=hml7_U2ykR-UD4GHnnM2F3anD0VoyDlKv6dOdknpqpI,164641
 iannix.py,sha256=Ixl_wiFqIMyAWO4eAcIJvyNAuJ8alTrkSGXu8ruhVug,17162
 image.py,sha256=8TEKOREWnIFpOKZBqrdTGeiQV2vN09texrb_nAzgorw,2739
 markov.py,sha256=UXXHDJ6Y1BItACpa9vSRjSb1wfIedv7T1GuHqpnvzWE,24407
@@ -96,9 +96,9 @@ CreativePython/resources/550973__luizguilherme_a__clean-guitarr-riff.mp3,sha256=
 CreativePython/resources/chopper.jpg,sha256=AykvUOwRSDi4g6OpfcNQ-LgwPE05_eVkCv5E9lnhUbk,135266
 CreativePython/resources/de-brazzas-monkey.jpg,sha256=AFCxemqkDYv_TPpcLwrHnTtoxGduvZD7O2S0xMqQ4C0,119054
 bin/libportaudio.2.dylib,sha256=ooJlm7QeL7jYzc1c8YMmH-C8PhYHwDvBJZkNDVPFRbE,286592
-creativepython-0.3.0.dist-info/licenses/LICENSE,sha256=tz38qDa5RhHMqzZR1Q5QafqWdXn_EhheXYBP7FjgtEM,1992
-creativepython-0.3.0.dist-info/licenses/LICENSE-PSF,sha256=JN1jUPIsEUH1mq3AXxet-b1IdhAr-XzscXBZiz74c9c,3371
-creativepython-0.3.0.dist-info/METADATA,sha256=25ukd_ta2v5MR03_a2KHg3kkufTlO1AQ6cvsznGRaGk,8740
-creativepython-0.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-creativepython-0.3.0.dist-info/top_level.txt,sha256=TdeMVDq8cqDv2qX3w8KNKagpLCy1eaTRFCSk2MUbtC0,90
-creativepython-0.3.0.dist-info/RECORD,,
+creativepython-0.3.2.dist-info/licenses/LICENSE,sha256=tz38qDa5RhHMqzZR1Q5QafqWdXn_EhheXYBP7FjgtEM,1992
+creativepython-0.3.2.dist-info/licenses/LICENSE-PSF,sha256=JN1jUPIsEUH1mq3AXxet-b1IdhAr-XzscXBZiz74c9c,3371
+creativepython-0.3.2.dist-info/METADATA,sha256=YXF2RWUeVssqZ3e26FU6joGb0C60--nOmo3wWRU-W8k,8670
+creativepython-0.3.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+creativepython-0.3.2.dist-info/top_level.txt,sha256=TdeMVDq8cqDv2qX3w8KNKagpLCy1eaTRFCSk2MUbtC0,90
+creativepython-0.3.2.dist-info/RECORD,,

gui.py

@@ -2122,8 +2122,10 @@ class Control(Drawable, Interactable):
 # Graphics Objects (Geometric shapes, text, and images)
 #######################################################################################
 class Rectangle(Graphics):
+   """
+   Rectangles are linear Graphics defined by its bounding box.
+   """
    def __init__(self, x1, y1, x2, y2, color=Color.BLACK, fill=False, thickness=1, rotation=0):
-      """Create a new Rectangle."""
       Graphics.__init__(self)
 
       # calculate bounding box dimensions
@@ -2153,6 +2155,9 @@ class Rectangle(Graphics):
 
 
 class Oval(Graphics):
+   """
+   Ovals are curved Graphics defined by its bounding box.
+   """
    def __init__(self, x1, y1, x2, y2, color=Color.BLACK, fill=False, thickness=1, rotation=0):
       """Create a new oval."""
       Graphics.__init__(self)
@@ -2184,6 +2189,9 @@ class Oval(Graphics):
 
 
 class Circle(Oval):
+   """
+   Circles are ovals defined by a center point and radius.
+   """
    def __init__(self, x, y, radius, color=Color.BLACK, fill=False, thickness=1, rotation=0):
       """Create a new Circle."""
       x1 = x - radius  # calculate Oval dimensions
@@ -2237,6 +2245,9 @@ class Circle(Oval):
 
 
 class Point(Circle):
+   """
+   Points are individual pixels defined by their coordinate.
+   """
    def __init__(self, x, y, color=Color.BLACK):
       """Create a new Point."""
       Circle.__init__(self, x, y, 1, color, True, 1, 0)
@@ -2271,6 +2282,9 @@ class Point(Circle):
 
 
 class Arc(Graphics):
+   """
+   Arcs are curved lines defined by a bounding box, and the angles of its endpoints within that box.
+   """
    def __init__(self, x1, y1, x2, y2, startAngle=PI, endAngle=TWO_PI, style=OPEN, color=Color.BLACK, fill=False, thickness=1, rotation=0):
       """Create a new Arc."""
       Graphics.__init__(self)
@@ -2353,6 +2367,9 @@ class Arc(Graphics):
 
 
 class ArcCircle(Arc):
+   """
+   ArcCircles are Arcs defined by a center point, radius, and the angles of its endpoints around its center.
+   """
    def __init__(self, x, y, radius, startAngle=PI, endAngle=TWO_PI, style=OPEN, color=Color.BLACK, fill=False, thickness=1, rotation=0):
       """Create a new ArcCircle."""
       x1 = x - radius  # calculate Arc dimensions
@@ -2405,6 +2422,9 @@ class ArcCircle(Arc):
 
 
 class Line(Graphics):
+   """
+   Lines are straight paths between two endpoints.
+   """
    def __init__(self, x1, y1, x2, y2, color=Color.BLACK, thickness=1, rotation=0):
       """Create a new Line."""
       Graphics.__init__(self)
@@ -2509,6 +2529,9 @@ class Line(Graphics):
 
 
 class PolyLine(Graphics):
+   """
+   PolyLines are straight paths between a series of endpoints.
+   """
    def __init__(self, xPoints, yPoints, color=Color.BLACK, thickness=1, rotation=0):
       """Create a new Polyline."""
       Graphics.__init__(self)
@@ -2607,6 +2630,9 @@ class PolyLine(Graphics):
 
 
 class Polygon(Graphics):
+   """
+   Polygons are defined by linear paths between a series of connected endpoints.
+   """
    def __init__(self, xPoints, yPoints, color=Color.BLACK, fill=False, thickness=1, rotation=0):
       """Create a new Polygon."""
       Graphics.__init__(self)
@@ -2701,6 +2727,9 @@ class Polygon(Graphics):
 
 
 class Icon(Graphics):
+   """
+   Icons are shapes rendered from .png or .jpg files, and/or drawn pixel-by-pixel.
+   """
    def __init__(self, filename, width=None, height=None, rotation=0):
       """Create a new Icon."""
       Graphics.__init__(self)
@@ -2747,7 +2776,7 @@ class Icon(Graphics):
       if height is None:  # scale height to width
          height = int(self._pixmap.height() * (width / self._pixmap.width()))
 
-      oldWidth, oldHeight = self._getSize()
+      oldWidth, oldHeight = self.getSize()
 
       if (width != oldWidth) or (height != oldHeight):
          pixmap = self._pixmap.scaled(width, height)  # scale new pixmap
@@ -2838,6 +2867,9 @@ class Icon(Graphics):
 
 
 class Label(Graphics):
+   """
+   Labels are text with an included background box.
+   """
    def __init__(self, text, alignment=LEFT, foregroundColor=Color.BLACK, backgroundColor=Color.CLEAR, rotation=0):
       """Create a new Label."""
       Graphics.__init__(self)
@@ -2984,6 +3016,9 @@ class Label(Graphics):
 # Music Controls
 #######################################################################################
 class HFader(MusicControl):
+   """
+   HFaders are horizontal, linear controls.
+   """
    def __init__(self, x1, y1, x2, y2, minValue=0, maxValue=999, startValue=None,
                 updateFunction=None, foreground=Color.RED, background=Color.BLACK,
                 outline=Color.BLACK, thickness=3, rotation=0):
@@ -3089,6 +3124,9 @@ class HFader(MusicControl):
 
 
 class VFader(HFader):
+   """
+   VFaders are vertical, linear controls.
+   """
    def __init__(self, x1, y1, x2, y2, minValue=0, maxValue=999, startValue=None,
                updateFunction=None, foreground=Color.RED, background=Color.BLACK,
                outline=Color.BLACK, thickness=3, rotation=0):
@@ -3156,6 +3194,9 @@ class VFader(HFader):
 
 
 class Rotary(MusicControl):
+   """
+   Rotaries are circular controls.
+   """
    def __init__(self, x1, y1, x2, y2, minValue=0, maxValue=999, startValue=None,
                updateFunction=None, foreground=Color.RED, background=Color.BLACK,
                outline=Color.BLUE, thickness=3, arcWidth=300, rotation=0):
@@ -3282,6 +3323,9 @@ class Rotary(MusicControl):
 
 
 class Push(MusicControl):
+   """
+   Pushes are rectangular buttons that reset when released.
+   """
    def __init__(self, x1, y1, x2, y2, updateFunction=None, foreground=Color.RED, background=Color.BLACK, outline=Color.CLEAR, thickness=3, rotation=0):
       """Creates a new Push button."""
       MusicControl.__init__(self, updateFunction)
@@ -3368,6 +3412,9 @@ class Push(MusicControl):
 
 
 class Toggle(Push):
+   """
+   Toggles are rectangular buttons that change when clicked.
+   """
    def __init__(self, x1, y1, x2, y2, updateFunction=None, foreground=Color.RED, background=Color.BLACK, outline=Color.CLEAR, thickness=3, rotation=0):
       """
       Creates a new Toggle button.
@@ -3401,6 +3448,9 @@ class Toggle(Push):
 
 
 class XYPad(MusicControl):
+   """
+   XYPads are grids that track values in two dimensions.
+   """
    def __init__(self, x1, y1, x2, y2, updateFunction=None, foreground=Color.RED, background=Color.BLACK, outline=Color.CLEAR, outlineThickness=2, trackerRadius=10, crosshairsThickness=None, rotation=0):
       """
       Creates a new XYPad.
@@ -3524,7 +3574,6 @@ class XYPad(MusicControl):
 #######################################################################################
 class Button(Control):
    def __init__(self, text="", function=None):
-      """Create a new button."""
       Control.__init__(self)
 
       # create qt object
@@ -3567,7 +3616,6 @@ class Button(Control):
 
 class CheckBox(Control):
    def __init__(self, text="", function=None):
-      """Create a new checkbox."""
       Control.__init__(self)
 
       qtObject = _QtWidgets.QCheckBox(text)
@@ -3609,7 +3657,6 @@ class CheckBox(Control):
 
 class Slider(Control):
    def __init__(self, orientation=HORIZONTAL, lower=0, upper=100, start=None, function=None):
-      """Create a new slider."""
       Control.__init__(self)
 
       start = start if start is not None else ((lower + upper)//2)
@@ -3649,7 +3696,6 @@ class Slider(Control):
 
 class DropDownList(Control):
    def __init__(self, items=[], function=None):
-      """Create a new dropdown list."""
       Control.__init__(self)
 
       qtObject = _QtWidgets.QComboBox()
@@ -3690,7 +3736,6 @@ class DropDownList(Control):
 
 class TextField(Control):
    def __init__(self, text="", columns=8, function=None):
-      """Create a new text field."""
       Control.__init__(self)
 
       self._qtObject = _QtWidgets.QLineEdit(str(text))
@@ -3782,7 +3827,6 @@ class TextField(Control):
 
 class TextArea(Control):
    def __init__(self, text="", columns=8, rows=5):
-      """Create a new text field."""
       Control.__init__(self)
 
       self._qtObject = _QtWidgets.QTextEdit(str(text))
@@ -3848,7 +3892,6 @@ class TextArea(Control):
 
 class Menu():
    def __init__(self, menuName):
-      """Create a new menu."""
       self._qtObject = _QtWidgets.QMenu(menuName)
       self._name     = menuName