midd-media 0.1.0__tar.gz

midd_media-0.1.0/PKG-INFO

@@ -0,0 +1,31 @@
+Metadata-Version: 2.3
+Name: midd-media
+Version: 0.1.0
+Summary: 
+Author: Christopher Andrews
+Author-email: candrews@middlebury.edu
+Requires-Python: >=3.9
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: pillow (>=11.1.0,<12.0.0)
+Requires-Dist: pygame (>=2.6.1,<3.0.0)
+Description-Content-Type: text/markdown
+
+# midd-media
+Libraries and examples for CSCI 0145
+
+
+## middsound
+
+A library for interacting with sound. This provides a thin wrapper around the wave library. This also requires pygame for sound playback.
+
+
+##middimage
+
+Another thin wrapper to simplify the interface. This wraps pillow while providing an interface very close to that of middsound.
+
+

midd_media-0.1.0/README.md

@@ -0,0 +1,13 @@
+# midd-media
+Libraries and examples for CSCI 0145
+
+
+## middsound
+
+A library for interacting with sound. This provides a thin wrapper around the wave library. This also requires pygame for sound playback.
+
+
+##middimage
+
+Another thin wrapper to simplify the interface. This wraps pillow while providing an interface very close to that of middsound.
+

midd_media-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "midd-media"
+version = "0.1.0"
+description = ""
+authors = [
+    {name = "Christopher Andrews",email = "candrews@middlebury.edu"},
+    {name = "Andrea Vaccari",email = "vaccari@middlebury.edu"}
+]
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+    "pygame (>=2.6.1,<3.0.0)",
+    "pillow (>=11.1.0,<12.0.0)"
+]
+
+[tool.poetry]
+packages = [{include = "midd_media", from = "src"}]
+
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0"]
+build-backend = "poetry.core.masonry.api"

midd_media-0.1.0/src/midd_media/middimage.py

@@ -0,0 +1,110 @@
+# -*- coding: utf-8 -*-
+"""
+This module provides a thin wrapper around pillow allowing us to easily create and manipulate images.
+
+@author: C. Andrews, A. Vaccari
+
+2022-04-20  Modified __repr__ to fit an entire line if 8-bit mono
+2025-01-06  Removed the dependency on `numpy` and added a `Row` class to allow for 2D array notation.
+"""
+
+
+from PIL import Image
+    
+
+class MiddImage:
+    """
+    This class provides a thin wrapper around the PIL Image class. It boils access down to some basic functionality and also allows for direct access to the pixels.
+
+    Access to the pixels can be done using 2D array notation (e.g., img[x][y]) or using a tuple (e.g., img[x,y]). The former will feel more natural to new Python programmers, but is 50% slower. 
+    """
+    class Row:
+        """
+        Hidden helper class that allows us to access a row of pixels using 2D array notation.
+        """
+        def __init__(self, image, row):
+            self.image = image
+            self.row = row
+
+        def __getitem__(self, index):
+            return self.image[self.row, index]
+        
+        def __setitem__(self, index, value):
+            self.image[self.row, index] = value
+    
+    def __init__(self, data=None, width=None, height=None, mode='RGB' ):
+        if data is None:
+            self._data = Image.new(mode, (width, height))
+        else:
+            self._data = data
+        self._pixels = self._data.load()
+    
+    def __getitem__(self, index):
+        """
+        Get the pixel at the specified 'index'.
+        The 'index' should be a tuple.
+        """
+        if type(index) == int:
+            return MiddImage.Row(self, index)
+        else:
+            return self._pixels[index]
+    
+    
+    def __setitem__(self, index, value):
+        """
+        Set the pixel at location 'index'.
+        The 'value' should be a three channel tuple.
+        """
+        self._pixels[index] = value
+        
+
+    def __getattr__(self, attr):
+        """
+        Passes through attributes to the underlying image object.
+
+        Most important attributes are `width`,`height`, and `mode`.
+        """
+        return getattr(self._data, attr)
+    
+
+    def __repr__(self):
+        """
+        Show the pixels of the image.
+        """
+        return repr(list(self._data.getdata()))
+        
+    def save(self, filename):
+        """
+        Save the image as 'filename' into the current working directory.
+        """
+        self._data.save(filename)
+    
+    def show(self):
+        """
+        Show the image.
+        """
+        self._data.show()
+    
+    def copy(self):
+        """
+        Returns a new MiddImage with identical contents.
+        """
+        new_image = MiddImage(self._data.copy())
+        return new_image
+    
+    
+def new(width, height, mode='RGB'):
+    """
+    Create a new image with the specified width and height.
+    """
+    return MiddImage(width=width, height=height, mode=mode)
+
+
+def open(filename):
+    """
+    Open an image file located in 'filename' (which is assumed to be in the working directory
+    or an absolute path.
+    """
+    image_data = Image.open(filename)
+    new_image = MiddImage(data=image_data)
+    return new_image

midd_media-0.1.0/src/midd_media/middsound.py

@@ -0,0 +1,136 @@
+# -*- coding: utf-8 -*-
+"""
+This module provides a thin wrapper around the wave library allowing us to
+easily create and manipulate wav files.
+
+@author: C. Andrews, A. Vaccari
+
+Update: 2024-10-18 - Included the allowedchanges=0 option in pygame.mixer.init()
+                     to solve an issue with double speed in Windows.
+Update: 2024-03-26 - Updated to use pygame (simpleaudio is no longer maintained)
+Update: 2022-04-20 - Added ValueError exception when trying to play an empty sound
+Update: 2019-11-03 - Added support for sharps: capital letters will produce sharps
+Update: 2019-04-02 - Added support for len(), removed extraneous functions
+Update: 2016-08-23 - Changed play to use system tools
+Update: 2016-08-22 - Converted to use __getitem__ and __setitem__
+
+"""
+
+import wave
+import array
+import pygame
+
+
+# These two constants are the maximum and minimum values allowed for our samples
+MAXVALUE = 32677 
+MINVALUE = -32768 
+
+
+class Sound:
+    """
+    This class is a container that holds one 'sound'. It provides an interface
+    mirroring the wave library that hides some of the details such as setting the
+    framerate and the sample width, as well as the interactions with the array
+    library which allows us to build the sound before writing it out to a file on
+    disk.
+    """
+
+    def __init__(self, framerate=44100):
+        """
+        Initialize the sound with a data store for our samples and a default
+        sample rate of 44kHz
+        """
+        self.data = array.array('h')
+        self.numchannels = 1
+        self.framerate = framerate
+        pygame.mixer.init(frequency=self.framerate, size=-16, channels=self.numchannels, allowedchanges=0)
+
+
+
+    def __getitem__(self, index):
+        """
+        Get the sample at location index.
+        """
+        return self.data[index]
+
+    def __len__(self):
+        """
+        Support the len() function.
+        """
+        return len(self.data)
+
+
+    def __setitem__(self, index, value):
+        """
+        Set the value of a particular sample.
+        """
+        self.data[index] = value
+
+    def append(self, sample):
+        """
+        Append one sample on to the end of the sound.
+        """
+        self.data.append(sample)
+
+    def save(self, filename):
+        """
+        Save the sound as 'filename' into the current working directory.
+
+        Under the hood, this is the point when the wav file is actually created
+        and the samples are written into it.
+        """
+        snd = wave.open(filename, 'wb')
+        # nchannels, sampwidth, framerate, nframes, comptype, compname
+        snd.setparams((self.numchannels, 2, self.framerate, len(self.data), 'NONE', 'not compressed'))
+        snd.writeframes(self.data.tobytes())
+        snd.close()
+
+    def play(self):
+        """
+        Play the sound.
+        """
+        # Check if the data is empty. If it is, the backend would
+        # crash with an obscure message.
+        if len(self.data) == 0:
+            raise ValueError("Sound data empty. The sound should contain at least one sample")
+        sound = pygame.mixer.Sound(self.data)
+        sound.play()
+
+
+
+def new(framerate=44100):
+    """
+    A convenience function for creating a new Sound object.
+    """
+    return Sound(framerate=framerate)
+
+
+def open(filename):
+    """
+    Open a wave file located in 'filename' (which is assumed to be in
+    the working directory, or an absolute path).
+    """
+    soundObj = Sound()
+
+    snd = wave.open(filename, 'rb')
+    soundObj.numchannels = snd.getnchannels()
+    soundObj.framerate = snd.getframerate()
+    soundObj.data.frombytes(snd.readframes(snd.getnframes()))
+
+    snd.close()
+    return soundObj
+
+def get_frequency(note):
+    """
+    A quick converter for getting notes of various frequencies. This covers the
+    piano keyboard.
+    The sharp version of a, c, d, f, and g can be obtained using capital letters.
+    """
+    d = {'a':27.5,'b':30.8677,'c':32.7032,'d':36.7081,'e':41.2035,'f':43.6536,'g':48.995,
+         'A':29.1353,'C':34.6479,'D':38.8909,'F':46.2493,'G':51.913}
+    frequency = d[note[0]]
+    octave = int(note[1])
+    if note[0] > 'b':
+        octave -= 1
+    frequency *= 2**octave
+    return frequency