pyglet 2.1.3__py3-none-any.whl → 2.1.4__py3-none-any.whl

pyglet/libs/darwin/cocoapy/cocoalibs.py

@@ -16,12 +16,14 @@ if lib is None:
 cf = cdll.LoadLibrary(lib)
 
 kCFStringEncodingUTF8 = 0x08000100
+kCFAllocatorDefault = None
 
 CFAllocatorRef = c_void_p
 CFStringEncoding = c_uint32
 CFURLRef = c_void_p
 CFStringRef = c_void_p
 CFURLPathStyle = c_int
+CFDataRef = c_void_p
 
 cf.CFStringCreateWithCString.restype = c_void_p
 cf.CFStringCreateWithCString.argtypes = [CFAllocatorRef, c_char_p, CFStringEncoding]
@@ -46,7 +48,11 @@ cf.CFAttributedStringCreate.argtypes = [CFAllocatorRef, c_void_p, c_void_p]
 
 # Core Foundation type to Python type conversion functions
 
-def CFSTR(string):
+def CFSTR(string: str):
+    """Create a CFStringRef object.
+
+    This must eventually be released by CFRelease.
+    """
     return cf.CFStringCreateWithCString(None, string.encode('utf8'), kCFStringEncodingUTF8)
 
 # Other possible names for this method:
@@ -72,6 +78,9 @@ cf.CFDataCreate.argtypes = [c_void_p, c_void_p, CFIndex]
 cf.CFDataGetBytes.restype = None
 cf.CFDataGetBytes.argtypes = [c_void_p, CFRange, c_void_p]
 
+cf.CFDataGetBytePtr.restype = POINTER(c_uint8)
+cf.CFDataGetBytePtr.argtypes = [CFDataRef]
+
 cf.CFDataGetLength.restype = CFIndex
 cf.CFDataGetLength.argtypes = [c_void_p]
 
@@ -340,8 +349,6 @@ kCGImageAlphaNoneSkipLast           = 5
 kCGImageAlphaNoneSkipFirst          = 6
 kCGImageAlphaOnly                   = 7
 
-kCGImageAlphaPremultipliedLast = 1
-
 kCGBitmapAlphaInfoMask              = 0x1F
 kCGBitmapFloatComponents            = 1 << 8
 
@@ -379,6 +386,9 @@ quartz = cdll.LoadLibrary(lib)
 CGDirectDisplayID = c_uint32     # CGDirectDisplay.h
 CGError = c_int32                # CGError.h
 CGBitmapInfo = c_uint32          # CGImage.h
+CGContextRef = c_void_p
+CGFontRef = c_void_p
+CTFontRef = c_void_p
 
 # /System/Library/Frameworks/ApplicationServices.framework/Frameworks/...
 #     ImageIO.framework/Headers/CGImageProperties.h
@@ -389,6 +399,15 @@ kCGImagePropertyGIFDelayTime = c_void_p.in_dll(quartz, 'kCGImagePropertyGIFDelay
 #     CoreGraphics.framework/Headers/CGColorSpace.h
 kCGRenderingIntentDefault = 0
 
+kCGTextFill = 0
+kCGTextStroke = 1
+kCGTextFillStroke = 2
+kCGTextInvisible = 3
+kCGTextFillClip = 4
+kCGTextStrokeClip = 5
+kCGTextFillStrokeClip = 6
+kCGTextClip = 7
+
 quartz.CGDisplayIDToOpenGLDisplayMask.restype = c_uint32
 quartz.CGDisplayIDToOpenGLDisplayMask.argtypes = [c_uint32]
 
@@ -490,6 +509,9 @@ quartz.CGDataProviderRelease.argtypes = [c_void_p]
 quartz.CGColorSpaceRelease.restype = None
 quartz.CGColorSpaceRelease.argtypes = [c_void_p]
 
+quartz.CGContextFillRect.restype = None
+quartz.CGContextFillRect.argtypes = [c_void_p, CGRect]
+
 quartz.CGWarpMouseCursorPosition.restype = CGError
 quartz.CGWarpMouseCursorPosition.argtypes = [CGPoint]
 
@@ -511,6 +533,24 @@ quartz.CGFontCreateWithDataProvider.argtypes = [c_void_p]
 quartz.CGFontCreateWithFontName.restype = c_void_p
 quartz.CGFontCreateWithFontName.argtypes = [c_void_p]
 
+quartz.CGContextSetFont.restype = None
+quartz.CGContextSetFont.argtypes = [CGContextRef, CGFontRef]
+
+quartz.CGContextSetFontSize.restype = None
+quartz.CGContextSetFontSize.argtypes = [CGContextRef, CGFloat]
+
+quartz.CGContextShowGlyphsAtPositions.restype = None
+quartz.CGContextShowGlyphsAtPositions.argtypes = [CGContextRef, POINTER(CGGlyph), POINTER(CGPoint), c_size_t]
+
+quartz.CTFontDrawGlyphs.restype = None
+quartz.CTFontDrawGlyphs.argtypes = [CTFontRef, POINTER(CGGlyph), POINTER(CGPoint), c_size_t, CGContextRef]
+
+quartz.CGContextTranslateCTM.restype = None
+quartz.CGContextTranslateCTM.argtypes = [CGContextRef, CGFloat, CGFloat]
+
+quartz.CGContextScaleCTM.restype = None
+quartz.CGContextScaleCTM.argtypes = [CGContextRef, CGFloat, CGFloat]
+
 quartz.CGContextDrawImage.restype = None
 quartz.CGContextDrawImage.argtypes = [c_void_p, CGRect, c_void_p]
 
@@ -523,6 +563,23 @@ quartz.CGContextSetTextPosition.argtypes = [c_void_p, CGFloat, CGFloat]
 quartz.CGContextSetShouldAntialias.restype = None
 quartz.CGContextSetShouldAntialias.argtypes = [c_void_p, c_bool]
 
+quartz.CGContextSetTextDrawingMode.restype = None
+quartz.CGContextSetTextDrawingMode.argtypes = [c_void_p, c_int32]
+
+quartz.CGContextSetRGBFillColor.restype = None
+quartz.CGContextSetRGBFillColor.argtypes = [c_void_p, CGFloat, CGFloat, CGFloat, CGFloat]
+
+quartz.CGFontCopyTableTags.restype = c_void_p
+quartz.CGFontCopyTableTags.argtypes = [c_void_p]
+
+quartz.CGFontCopyTableForTag.restype = c_void_p
+quartz.CGFontCopyTableForTag.argtypes = [c_void_p, c_uint32]
+
+quartz.CTFontCopyGraphicsFont.restype = c_void_p
+quartz.CTFontCopyGraphicsFont.argtypes = [c_void_p, c_void_p]
+
+
+
 ######################################################################
 
 # CORETEXT
@@ -543,7 +600,12 @@ kCTFontAttributeName = c_void_p.in_dll(ct, 'kCTFontAttributeName')
 kCTFontFamilyNameAttribute = c_void_p.in_dll(ct, 'kCTFontFamilyNameAttribute')
 kCTFontSymbolicTrait = c_void_p.in_dll(ct, 'kCTFontSymbolicTrait')
 kCTFontWeightTrait = c_void_p.in_dll(ct, 'kCTFontWeightTrait')
+kCTFontWidthTrait = c_void_p.in_dll(ct, 'kCTFontWidthTrait')
+kCTFontSlantTrait = c_void_p.in_dll(ct, 'kCTFontSlantTrait')
 kCTFontTraitsAttribute = c_void_p.in_dll(ct, 'kCTFontTraitsAttribute')
+kCTForegroundColorAttributeName = c_void_p.in_dll(ct, 'kCTForegroundColorAttributeName')
+kCTForegroundColorFromContextAttributeName = c_void_p.in_dll(ct, 'kCTForegroundColorFromContextAttributeName')
+kCFBooleanTrue = c_void_p.in_dll(ct, 'kCFBooleanTrue')
 
 # constants from CTFontTraits.h
 kCTFontItalicTrait = (1 << 0)
@@ -594,6 +656,15 @@ ct.CTFontDescriptorCreateWithAttributes.argtypes = [c_void_p]
 ct.CTFontDescriptorCopyAttribute.restype = c_void_p
 ct.CTFontDescriptorCopyAttribute.argtypes = [c_void_p, CFStringRef]
 
+ct.CTFontDescriptorCreateWithNameAndSize.restype = c_void_p
+ct.CTFontDescriptorCreateWithNameAndSize.argtypes = [CFStringRef, CGFloat]
+
+ct.CTFontDescriptorCreateMatchingFontDescriptor.restype = c_void_p
+ct.CTFontDescriptorCreateMatchingFontDescriptor.argtypes = [c_void_p, c_void_p]
+
+ct.CTFontCopyTraits.restype = c_void_p
+ct.CTFontCopyTraits.argtypes = [c_void_p]
+
 kCTFontURLAttribute = c_void_p.in_dll(ct, 'kCTFontURLAttribute')
 
 ######################################################################

pyglet/libs/darwin/coreaudio.py

@@ -111,8 +111,6 @@ ca.ExtAudioFileDispose.argtypes = [ExtAudioFileRef]
 ca.AudioFileClose.restype = OSStatus
 ca.AudioFileClose.argtypes = [AudioFileID]
 
-kCFAllocatorDefault = None
-
 
 def c_literal(mnemonic: str) -> int:
     """Pack a tiny ASCII string into a 32-bit int.

pyglet/libs/win32/__init__.py

@@ -1,10 +1,12 @@
 import atexit
 import struct
 import warnings
+from ctypes import HRESULT
+from ctypes.wintypes import ATOM, HFONT, HGDIOBJ, HGLOBAL, HMENU, HMODULE, INT, LPVOID, PUINT
 
 import pyglet
-from . import com
-from . import constants
+
+from . import com, constants
 from .types import *
 
 IS64 = struct.calcsize("P") == 8

pyglet/libs/win32/com.py

@@ -33,9 +33,12 @@ the return value.
 Don't forget to manually manage memory... call Release() when you're done with
 an interface.
 """
+from __future__ import annotations
 
-import sys
 import ctypes
+import re
+import sys
+from typing import Sequence
 
 from pyglet.util import debug_print
 
@@ -53,23 +56,43 @@ class GUID(ctypes.Structure):
         ('Data4', ctypes.c_ubyte * 8),
     ]
 
-    def __init__(self, l, w1, w2, b1, b2, b3, b4, b5, b6, b7, b8):
+    def __init__(self, l: int, w1: int, w2: int,
+                 b1: int, b2: int, b3: int, b4: int, b5: int, b6: int, b7: int, b8: int) -> None:
         self.Data1 = l
         self.Data2 = w1
         self.Data3 = w2
         self.Data4[:] = (b1, b2, b3, b4, b5, b6, b7, b8)
 
-    def __repr__(self):
+    def __repr__(self) -> str:
         b1, b2, b3, b4, b5, b6, b7, b8 = self.Data4
-        return 'GUID(%x, %x, %x, %x, %x, %x, %x, %x, %x, %x, %x)' % (
-            self.Data1, self.Data2, self.Data3, b1, b2, b3, b4, b5, b6, b7, b8)
+        return f'GUID({self.Data1:x}, {self.Data2:x}, {self.Data3:x}, {b1:x}, {b2:x}, {b3:x}, {b4:x}, {b5:x}, {b6:x}, {b7:x}, {b8:x})'
 
-    def __eq__(self, other):
+    def __eq__(self, other: object) -> bool:
         return isinstance(other, GUID) and bytes(self) == bytes(other)
 
-    def __hash__(self):
+    def __hash__(self) -> int:
         return hash(bytes(self))
 
+    @classmethod
+    def from_string(cls, text: str) -> GUID:
+        """Convert a GUID string into a GUID object.
+
+        Valid: 'bd4ec2d2-0662-4bee-ba8e-6f29f032e096' and '{bd4ec2d2-0662-4bee-ba8e-6f29f032e096}'
+        """
+        match = re.match(
+            r'^\{?([0-9A-Fa-f]{8})-([0-9A-Fa-f]{4})-([0-9A-Fa-f]{4})-([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})-([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})([0-9A-Fa-f]{2})\}?$', text)
+        if not match:
+            msg = f"Invalid GUID format: {text}"
+            raise ValueError(msg)
+
+        # Convert matched hex values into integers
+        d1 = int(match.group(1), 16)
+        d2 = int(match.group(2), 16)
+        d3 = int(match.group(3), 16)
+        d4 = [int(match.group(i), 16) for i in range(4, 12)]
+
+        return cls(d1, d2, d3, *d4)
+
 
 LPGUID = ctypes.POINTER(GUID)
 IID = GUID
@@ -195,7 +218,7 @@ class _pInterfaceMeta(_PointerMeta):
         # instead of
         # RegisterCallback(callback_obj)
         # could make it obsolete.
-        from ctypes import _pointer_type_cache
+        from ctypes import _pointer_type_cache  # noqa
         _pointer_type_cache[target] = pointer_type
 
         return pointer_type
@@ -204,12 +227,13 @@ class _pInterfaceMeta(_PointerMeta):
 class Interface(ctypes.Structure, metaclass=_InterfaceMeta, create_pointer_type=False):
     @classmethod
     def get_interface_inheritance(cls):
-        """Returns the types of all interfaces implemented by this interface, up to but not
-        including the base `Interface`.
+        """Return a reverse iterator over the interfaces implemented by this interface,
+        ranging from just after the base type `Interface` to this type.
         `Interface` does not represent an actual interface, but merely the base concept of
-        them, so viewing it as part of an interface's inheritance chain is meaningless.
+        them. Viewing it as part of an interface's inheritance chain is meaningless, so
+        it is excluded.
         """
-        return cls.__mro__[:cls.__mro__.index(Interface)]
+        return reversed(cls.__mro__[:cls.__mro__.index(Interface)])
 
 
 class pInterface(_DummyPointerType, metaclass=_pInterfaceMeta):
@@ -397,3 +421,32 @@ class COMObject:
             raise TypeError(f"Does not implement {interface_type}")
 
         return ctypes.byref(self._struct, offset)
+
+def is_available(interface: pInterface | Interface, guid: GUID, target_interface: pInterface | Interface,
+                 errors: Sequence[int] = (E_NOTIMPL, E_NOINTERFACE)) -> bool:
+    """
+    Determine if the target interface is available from the source.
+
+    Args:
+        interface:
+            The interface to query from.
+        guid:
+            The GUID of the target interface.
+        target_interface:
+            The interface object to query from.
+        errors:
+            Acceptable errors to consider as caught.
+
+    Returns:
+        If the query was successful, returns True. If so, the target interface object is available.
+    """
+    try:
+        interface.QueryInterface(guid, ctypes.byref(target_interface))
+        return True
+    except OSError as e:
+        for error in errors:
+            if error & 0xFFFFFFFF:  # to unsigned.
+                return False
+
+    msg = f"Failed to Query Interface {interface} with GUID: {guid}."
+    raise Exception(msg)

pyglet/libs/win32/constants.py

@@ -5036,6 +5036,7 @@ WINDOWS_8_OR_GREATER = sys.getwindowsversion() >= (6, 2)
 WINDOWS_8_1_OR_GREATER = sys.getwindowsversion() >= (6, 3)
 WINDOWS_10_ANNIVERSARY_UPDATE_OR_GREATER = sys.getwindowsversion() >= (10, 0, 14393)  # 1607
 WINDOWS_10_CREATORS_UPDATE_OR_GREATER = sys.getwindowsversion() >= (10, 0, 15063)  # 1703
+WINDOWS_10_1809_OR_GREATER = sys.getwindowsversion() >= (10, 0, 17763)  # 1809
 
 MSGFLT_ALLOW = 1
 MSGFLT_DISALLOW = 2

pyglet/libs/win32/dinput.py

@@ -1,20 +1,12 @@
 from __future__ import annotations
 
 import ctypes
+from ctypes.wintypes import BOOL, DWORD, HANDLE, HWND, LPDWORD, LPVOID, UINT, WCHAR, WORD
 
 from pyglet.libs.win32 import com
 
 lib = ctypes.oledll.dinput8
 
-LPVOID = ctypes.c_void_p
-WORD = ctypes.c_uint16
-DWORD = ctypes.c_uint32
-LPDWORD = ctypes.POINTER(DWORD)
-BOOL = ctypes.c_int
-WCHAR = ctypes.c_wchar
-UINT = ctypes.c_uint
-HWND = ctypes.c_uint32
-HANDLE = LPVOID
 MAX_PATH = 260
 
 DIENUM_STOP = 0

pyglet/libs/win32/types.py

@@ -1,12 +1,68 @@
 import ctypes
 import sys
-
-from ctypes import *
-from ctypes.wintypes import *
+from ctypes import (
+    POINTER,
+    WINFUNCTYPE,
+    Structure,
+    Union,
+    c_byte,
+    c_char,
+    c_char_p,
+    c_int,
+    c_int8,
+    c_int16,
+    c_int32,
+    c_int64,
+    c_long,
+    c_short,
+    c_size_t,
+    c_ubyte,
+    c_uint,
+    c_uint8,
+    c_uint16,
+    c_uint32,
+    c_uint64,
+    c_wchar,
+    c_wchar_p,
+    cast,
+    sizeof,
+)
+from ctypes.wintypes import (
+    BOOL,
+    BYTE,
+    DOUBLE,  # noqa: F401
+    DWORD,
+    FILETIME,
+    HANDLE,
+    HBITMAP,
+    HBRUSH,
+    HDC,
+    HICON,
+    HINSTANCE,
+    HMONITOR,
+    HRGN,
+    HWND,
+    LARGE_INTEGER,
+    LONG,
+    LPARAM,
+    LPCWSTR,
+    LPOLESTR,
+    LPWSTR,
+    MSG,
+    POINT,
+    POINTL,
+    RECT,
+    UINT,
+    ULARGE_INTEGER,
+    ULONG,
+    USHORT,
+    WCHAR,
+    WORD,
+    WPARAM,
+)
 
 from . import com
 
-
 _int_types = (c_int16, c_int32)
 if hasattr(ctypes, 'c_int64'):
     # Some builds of ctypes apparently do not have c_int64
@@ -45,13 +101,11 @@ def POINTER_(obj):
 
 
 c_void_p = POINTER_(c_void)
-INT = c_int
-LPVOID = c_void_p
+
 HCURSOR = HANDLE
 LRESULT = LPARAM
 COLORREF = DWORD
 PVOID = c_void_p
-WCHAR = c_wchar
 BCHAR = c_wchar
 LPRECT = POINTER(RECT)
 LPPOINT = POINTER(POINT)
@@ -63,7 +117,17 @@ LPTSTR = LPWSTR
 LPSTREAM = c_void_p
 CLSID = com.GUID
 
-# Fixed in python 3.12. Is c_byte on other versions.
+INT8 = c_int8
+UINT8 = c_uint8
+INT16 = c_int16
+UINT16 = c_uint16
+INT32 = c_int32
+UINT32 = c_uint32
+INT64 = c_int64
+UINT64 = c_uint64
+VOID = None
+
+# Fixed in python 3.12. Ctypes defined BYTE as c_byte in previous versions.
 # Ensure it's the same across all versions.
 if sys.version_info < (3, 12):
     BYTE = c_ubyte

pyglet/media/codecs/coreaudio.py

@@ -54,6 +54,7 @@ class CoreAudioSource(StreamingSource):
             url_ref = cf.CFURLCreateWithFileSystemPath(None, fn_str, kCFURLPOSIXPathStyle, False)
 
             err_check(ca.ExtAudioFileOpenURL(url_ref, byref(audref)))
+            cf.CFRelease(fn_str)
         else:
             self.file_obj = MemoryFileObject(file)