pyglet 2.1.6__tar.gz → 2.1.8__tar.gz

{pyglet-2.1.6 → pyglet-2.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: pyglet
-Version: 2.1.6
+Version: 2.1.8
 Summary: pyglet is a cross-platform games and multimedia package.
 Author-email: Alex Holkner & contributors <Alex.Holkner@gmail.com>
 Requires-Python: >=3.8

{pyglet-2.1.6 → pyglet-2.1.8}/RELEASE_NOTES

@@ -1,3 +1,42 @@
+pyglet 2.1.8
+
+Changes
+-------
+docs: Improve camera example documentation. (#1326)
+gl: Add type hints to GL functions. (#1237) (#1325)
+font: Add font shaping support to MacOSX.
+window: Add support for MacOSX to have transparent windows and overlays. (#1339)
+window: Add new `on_clipboard_copy` & `on_clipboard_paste` events, and add support to the Caret class. (#1313)
+examples: Add a `get_mouse_scale` helper method to the FixedResolution class.
+math: Remove `if` checks from `__matmul__` operations for small performance improvement.
+
+Bugfixes
+--------
+font: Fix get_text_size for DirectWrite to include trailing whitespaces.
+font: Cache glyphs based on unique ID and indices to reduce cache collions. (#1346)
+font: Fix issue with inline elements crashing in a non-multiline scenario. (#1346)
+media: Fix WMFDecoder delivering audio data as float. (#1315) (#1316)
+window: Fix bugs with transparent framebuffers for transparent windows. (#1333)
+window: Adjust software cursor scale factor for MacOS for HiDPI. (#1343)
+
+
+pyglet 2.1.7
+
+Changes
+-------
+event: Add EventDispatcher.post_event method for posting events to main thread
+window: Clamp width and height to minimum of (1,1) in internal resize events (#1322)
+window.mouse: Add __getattr__ to the MouseStateHandler (#1311)
+
+Bugfixes
+--------
+docs: Fix outbound link, cross-refs, and formatting for programming guide image page (#1318)
+input.Controller: fix Nonetype error if a mapping points towards a non-existing HAT Control
+math: fix bugged Vec methods (#1310)
+window: Fix window transparency for Windows OS.
+window: Fix X11 clipboard selection by not setting XlibWindow._clipboard_str in self.get_clipboard_text
+
+
 pyglet 2.1.6
 
 Bugfixes
@@ -195,7 +234,7 @@ Bugfixes
 - shapes: BezierCurve: fix miter artifacts from #1134. (#1155)
 - examples: Fix "more" button outline in soundspace example. (#1085)
 - tests: Fix a rarely-failing audio time test. (#1092)
-- input.controller: Fix accidentially missed mappings.
+- input.controller: Fix accidentally missed mappings.
 - graphics.shader: Add missing parent program reference in Uniforms (#1103)
 - graphics.domain: Fix VertexList.resize method.
 - text.directwrite: Fix crash with dw_legacy_naming. Check if a custom collection exists before find a font with it.
@@ -436,7 +475,7 @@ Changes and Improvements
 Bugfixes
 --------
 - gui: Prevent two TextEntry widgets from being active at the same time. #747
-- win32: Fix broken lib debug, and multiple related bugs due to depreacted functions.
+- win32: Fix broken lib debug, and multiple related bugs due to deprecated functions.
 - input: Controller mappings now indexed correctly on macOS and Windows.
 
 
@@ -577,7 +616,7 @@ Bugfixes
 - Windows - Prevent distortion with multiple XAudio2 audio sources (#515)
 - Fix frame dropping bug with FFMpeg decoder.
 - Windows - Fix Video alpha channel for WMF decoder.
-- Varios documentation and docstring fixes. Thanks everyone!
+- Various documentation and docstring fixes. Thanks everyone!
 
 
 pyglet 1.5.21
@@ -751,7 +790,7 @@ Bugfixes
 --------
 - Explicitly cast media.synthesis data to bytes to prevent issues on some audio drivers.
 - Refactor WIC module to work with new com module. (#298)
-- Prevent crash when setting `shapes.Circle.visable`. (#294)
+- Prevent crash when setting `shapes.Circle.visible`. (#294)
 - Remove deprecated `tostring` calls in PIL/PNG decoders to prevent crash on Python 3.9. (#295, #302)
 
 Improvements
@@ -829,7 +868,7 @@ Bugfix and minor feature release
 
 Bugfixes
 --------
-- Avoid WMFDecoder crash when mixing pyglet with other tookits. (#174)
+- Avoid WMFDecoder crash when mixing pyglet with other toolkits. (#174)
 - Prevent EventDispatcher subclasses from hiding AttributeError exceptions.
 
 Improvements
@@ -941,7 +980,7 @@ Bugfix and small improvement release
 Bugfixes
 --------
 - Allow creation of non-power-of-two compressed Textures. (#78)
-- Fix EventDispatchers surpressing `AttributeError`s. (#87)
+- Fix EventDispatchers suppressing `AttributeError`s. (#87)
 - Fix external lib loading on Windows under Python 3.8. (#90)
 
 Improvements
@@ -1029,7 +1068,7 @@ Of special note, is that the 1.4 release will be the last to support Python 2. I
 last release to support Legacy OpenGL (2.x). Future pyglet releases will be Python 3 only, and will
 require at least OpenGL 3 support. If you are using pyglet on legacy systems, don't worry. The 1.4
 branch will remain available for download. Bugfixes will be backported as long as someone is willing
-to do so, but new fetures on the 1.4 branch are unlikely.
+to do so, but new features on the 1.4 branch are unlikely.
 
 New features
 ------------
@@ -1060,7 +1099,7 @@ Improvements
   bundled Python Wave codec can also support loading of 24bit wave files. Please note that the
   OpenAL driver does NOT support 24bit audio playback.
 - Wave decoding is now based on the Python standard library `wave` module. This is slightly more
-  forgiving when loading slightly non-complient files.
+  forgiving when loading slightly non-compliant files.
 - Default texture min and mag filtering can be set on the Texture class. For example:
   `pyglet.image.Texture.default_min_filter = GL_LINEAR`
   `pyglet.image.Texture.default_mag_filter = GL_LINEAR`
@@ -1287,7 +1326,7 @@ Bugfixes
 - 638: Player set_pitch crashes with 'directaudio' driver
 - 653: Unsupported PNG color type: 3
 - 657: gdiplus.py : n_delays must be long, not float.
-- 659: image.save method doesnt catch correct Exception
+- 659: image.save method doesn't catch correct Exception
 - 660: platform_event_loop.post_event doesn't work for Cocoa loop
 - 661: Player.next is converted to Player.__next__ for python3
 - 662: gamepad cannot be found in linux
@@ -1314,7 +1353,7 @@ Bugfixes
 - 718: False "ImageDecodeException: Not a GIF stream" in python3.x
 - 719: .bmp files traceback with py3
 - 720: tests/image compatibility StringIO vs BytesIO
-- 721: compatibilty py3 for tests/image TEXTURE_3D.py and TEXTURE_GRID.py
+- 721: compatibility py3 for tests/image TEXTURE_3D.py and TEXTURE_GRID.py
 - 722: TypeError in graphics test suite with python3.x
 - 723: py3 compatibility in tests/image MATRIX_RGB.py, MATRIX_RGBA.py
 - 724: py3 compatibility for png s (bytes vs str)

{pyglet-2.1.6 → pyglet-2.1.8}/contrib/aseprite_codec/aseprite.py

@@ -40,7 +40,7 @@ PALETTE_INDEX = 0
 
 
 def _unpack(fmt, file):
-    """Unpack little endian bytes fram a file-like object. """
+    """Unpack little endian bytes from a file-like object. """
     size = struct.calcsize(fmt)
     data = file.read(size)
     if len(data) < size:

{pyglet-2.1.6 → pyglet-2.1.8}/doc/internal/doc.rst

@@ -26,7 +26,7 @@ folder are also defined in the index.rst, in order to includes them in the build
 
 API documentation
 -----------------
-The API documentation is generated direclty from the source code docstrings by `autodoc`_,
+The API documentation is generated directly from the source code docstrings by `autodoc`_,
 a plugin extension that is included with Sphinx. The generation itself is mostly automatic,
 but declaration files are necessary to instruct Sphinx how and which modules and classes
 should be included. Look through the existing files at ``pyglet/doc/modules/`` to get an
@@ -88,7 +88,7 @@ example
             """Constructor description
 
             Here is where you can describe how to make an instance of the
-            class. If any of the arguments need further explaination, that
+            class. If any of the arguments need further explanation, that
             detail can be added as necessary. For example:
             You must provide a name and a size, etc. etc.
 

{pyglet-2.1.6 → pyglet-2.1.8}/doc/internal/media_logging_manual.rst

@@ -96,7 +96,7 @@ Keep in mind that some raw data will be stale or misleading:
 
 The reports using that stale raw data will obviously report stale data.
 
-So it is a good idea to switch to a normal workflow as soon as posible
+So it is a good idea to switch to a normal workflow as soon as possible
 (simply creating a new session and deleting the special session).
 
 
@@ -112,7 +112,7 @@ If a ``playlist_file`` is specified, then it should contain one sample name
 per line; a sanity check will be performed ensuring no blacklisted extension
 is used, and that the sample exists in samples_dir.
 
-Once the ``playlist_file`` is used in ``configure.py new`` a copy is writen to
+Once the ``playlist_file`` is used in ``configure.py new`` a copy is written to
 the session raw data directory, and this copy will be the authoritative
 playlist for the session; ``playlist_file`` can be deleted if desired.
 
@@ -234,7 +234,7 @@ policies:
 Code Layout and conventions
 ===========================
 
-The emerging separation of responsabilities goes like
+The emerging separation of responsibilities goes like
 
 Scripts (commands)
 ------------------
@@ -255,7 +255,7 @@ Structured as:
 
 When two scripts use some related but not identical functionality, these parts
 can be moved to another module. Example: at first ``summarize`` had the code to
-collect defects stats, later, when ``compare`` was writen, the module
+collect defects stats, later, when ``compare`` was written, the module
 ``extractors`` was added and the defect collection stats code moved to that
 module.
 
@@ -599,7 +599,7 @@ The files in that directory will be
 etc (as captured at session creation).
 
 ``04_pyglet_hg_revision.txt`` , pyglet hg revision if running from a repo
-clone, non writen if no repo (as captured at session creation).
+clone, non written if no repo (as captured at session creation).
 
 ``sample_name.all.txt`` and ``sample_name.anomalies.txt`` for each sample that
 played non perfect.

{pyglet-2.1.6 → pyglet-2.1.8}/doc/internal/media_manual.rst

@@ -119,7 +119,7 @@ If any single measurement exceeds 280ms, an extreme desync that is noticeable
 in context of the app is assumed. If the ``AudioPlayer`` is running behind the
 master clock, all of this audio data is skipped and the measurements are reset.
 When running *ahead* by more than 280ms, nothing is done but the standard
-stretchin g of 12ms at a time.
+stretching of 12ms at a time.
 
 .. _audioplayer-play:
 
@@ -249,7 +249,7 @@ tends to be different: ::
         else:
             has_underrun = True
 
-High care must be taken to protect appropiate sections (any variables and
+High care must be taken to protect appropriate sections (any variables and
 buffers which get accessed by both callbacks and the work method) with a lock,
 otherwise the method is open to extremely unlucky issues where the callback
 is unscheduled in favor of the work method or vice versa, which may cause one

{pyglet-2.1.6 → pyglet-2.1.8}/doc/internal/virtualenv.rst

@@ -28,7 +28,7 @@ To build packages for distribution you need to install:
 It is preferred to create a Python virtual environment to develop in.
 This allows you to easily test on all Python versions supported by pyglet,
 not pollute your local system with pyglet development dependencies,
-and not have your local system interfere with pyglet developement.
+and not have your local system interfere with pyglet development.
 All dependencies you install while inside an activated virtual
 environment will remain isolated inside that environment.
 When you're finished, you can simply delete it.

{pyglet-2.1.6 → pyglet-2.1.8}/doc/internal/wraptypes.rst

@@ -143,7 +143,7 @@ is written to the token list as a ``PP_IFNDEF`` token.
 ``#define`` is handled specially.  After applying it to the namespace, it is
 parsed as an expression immediately.  This is allowed (and often expected) to
 fail.  If it does not fail, a ``PP_DEFINE_CONSTANT`` token is created, and the
-value is the result of evaluatin the expression.  Otherwise, a ``PP_DEFINE``
+value is the result of evaluating the expression.  Otherwise, a ``PP_DEFINE``
 token is created, and the value is the string concatenation of the tokens
 defined.  Special handling of parseable expressions makes it simple to later
 parse constants defined as, for example::
@@ -195,7 +195,7 @@ only what pyglet (and any other ctypes-wrapping application) requires.  The
 classes in the object model are:
 
 Declaration
-    A single declaration occuring outside of a function body.  This includes
+    A single declaration occurring outside of a function body.  This includes
     type declarations, function declarations and variable declarations.  The
     attributes are ``declarator`` (see below), ``type`` (a Type object) and
     ``storage`` (for example, 'typedef', 'const', 'static', 'extern', etc).

{pyglet-2.1.6 → pyglet-2.1.8}/doc/programming_guide/context.rst

@@ -215,7 +215,7 @@ created based on the values of these properties:
     ``accum_red_size``, ``accum_blue_size``, ``accum_green_size``, ``accum_alpha_size``
         The accumulation buffer can be used for simple antialiasing,
         depth-of-field, motion blur and other compositing operations.  Its use
-        nowadays is being superceded by the use of floating-point textures,
+        nowadays is being superseded by the use of floating-point textures,
         however it is still a practical solution for implementing these
         effects on older hardware.
 

{pyglet-2.1.6 → pyglet-2.1.8}/doc/programming_guide/eventloop.rst

@@ -101,7 +101,7 @@ for input indefinitely.
 Creating a Custom Event Loop
 ----------------------------
 
-Many windowing toolkits requie the application developer to write their own
+Many windowing toolkits require the application developer to write their own
 event loop. This is also possible in pyglet, but is usually just an inconvenience
 compared to :py:func:`pyglet.app.run`. It can be necessary in some situations,
 such as when combining pyglet with other toolkits, but is strongly discouraged

{pyglet-2.1.6 → pyglet-2.1.8}/doc/programming_guide/events.rst

@@ -36,7 +36,7 @@ should be written to accept these two values. For example::
     def on_resize(width, height):
         pass
 
-There are a few different ways in which event handlers can be attached to recieve them.
+There are a few different ways in which event handlers can be attached to receive them.
 The simplest way is to directly attach the event handler to the corresponding attribute
 on the object.  This will completely replace the default event handler::
 
@@ -91,7 +91,7 @@ or if your handler has a different name, pass the event name to the decorator::
 
 
 In most simple cases, the :py:class:`~pyglet.event.EventDispatcher.event`
-decorator is most convienent.  One limitation of using the decorator,
+decorator is most convenient.  One limitation of using the decorator,
 however, is that you can only add one additional event handler.
 If you want to add multiple additional event handlers, the next section
 describes how to accomplish that.

{pyglet-2.1.6 → pyglet-2.1.8}/doc/programming_guide/gui.rst

@@ -100,7 +100,7 @@ If a Frame is introduced, the following occurs:
 2. Set the Frame as a handler for Window events.
 3. Make one or more Widget instances.
 4. Add your widget instances to the Frame.
-5. Only Widgets near the mouse pointer will recieve Window events.
+5. Only Widgets near the mouse pointer will receive Window events.
 
 This works quite well for most cases, but has some limitations. When using the
 TextEntry widget, for instance, the widget may become unresponsive if you use

{pyglet-2.1.6 → pyglet-2.1.8}/doc/programming_guide/image.rst

@@ -6,16 +6,17 @@ using native operating system services.  If the `Pillow`_ library is installed,
 many additional formats can be supported.   pyglet also includes built-in
 codecs for loading PNG and BMP without external dependencies.
 
-Loaded images can be efficiently provided to OpenGL as a texture, and OpenGL
-textures and framebuffers can be retrieved as pyglet images to be saved or
-otherwise manipulated.
+In addition to loading, pyglet also supports the following operations
+for both OpenGL textures and framebuffers:
 
-If you've done any game or graphics programming, you're probably familiar with
-the concept of "sprites".  pyglet also provides an efficient and comprehensive
-:py:class:`~pyglet.sprite.Sprite` class, for displaying images on the screen
-with an optional transform (such as scaling and rotation). If you're planning
-to do anything with images that involves movement and placement on screen,
-you'll likely want to use sprites.
+* converting to pyglet image objects
+* saving to disk as screenshots
+* manipulation as image data
+* converting to :py:class:`bytes` of raw pixel data
+
+For most users, the :py:class:`~pyglet.sprite.Sprite` class is the best way
+to draw an image. One or more instances may draw the same image data with
+individually configured values for position, scaling, rotation, and more.
 
 .. _Pillow: https://pillow.readthedocs.io
 
@@ -60,7 +61,7 @@ Sprites
 
 A Sprite is a full featured class for displaying instances of Images or
 Animations in the window. Image and Animation instances are mainly concerned
-with the image data (size, pixels, etc.), wheras Sprites also include
+with the image data (size, pixels, etc.), whereas Sprites also include
 additional properties. These include x/y location, scale, rotation, opacity,
 color tint, visibility, and both horizontal and vertical scaling.
 Multiple sprites can share the same image; for example, hundreds of bullet
@@ -133,7 +134,7 @@ In addition, try to combine your images into as few textures as possible;
 for example, by loading images with :py:func:`pyglet.resource.image`
 (see :ref:`guide_resources`) or with :ref:`guide_texture-bins-and-atlases`).
 A common pitfall is to use the :py:func:`pyglet.image.load` method to load
-a large number of images.  This will cause a seperate texture to be created
+a large number of images.  This will cause a separate texture to be created
 for each image loaded, resulting in a lot of OpenGL texture binding overhead
 for each frame.
 
@@ -479,7 +480,7 @@ following table:
     = ============
 
 For example, a format string of ``"RGBA"`` corresponds to four bytes of
-colour data, in the order red, green, blue, alpha.  Note that machine
+color data, in the order red, green, blue, alpha.  Note that machine
 endianness has no impact on the interpretation of a format string.
 
 The length of a format string always gives the number of bytes per pixel.  So,
@@ -633,7 +634,7 @@ sprites from a single texture.  One problem you may encounter, however,
 is bleeding between adjacent images.
 
 When OpenGL renders a texture to the screen, by default it obtains each pixel
-colour by interpolating nearby texels.  You can disable this behaviour by
+color by interpolating nearby texels.  You can disable this behaviour by
 switching to the ``GL_NEAREST`` interpolation mode, however you then lose the
 benefits of smooth scaling, distortion, rotation and sub-pixel positioning.
 
@@ -678,7 +679,7 @@ appropriate locations within the texture to avoid overlap.
 
 It's possible for a :py:class:`~pyglet.image.atlas.TextureAtlas` to run out
 of space for new images, so applications will need to either know the correct
-size of the texture to allocate initally, or maintain multiple atlases as
+size of the texture to allocate initially, or maintain multiple atlases as
 each one fills up.
 
 The :py:class:`~pyglet.image.atlas.TextureBin` class provides a simple means
@@ -745,9 +746,13 @@ the window::
 When animations are loaded with :py:mod:`pyglet.resource` (see
 :ref:`guide_resources`) the frames are automatically packed into a texture bin.
 
-This example program is located in
-`examples/programming_guide/animation.py`, along with a sample GIF animation
-file.
+The ``examples/programming_guide/`` folder of the `GitHub repository`_
+includes:
+
+* this example program  (``animation.py``)
+* a sample GIF animation file  (``dinosaur.gif``)
+
+.. _GitHub repository: https://github.com/pyglet/pyglet/
 
 
 Framebuffers
@@ -779,7 +784,7 @@ as components of the :py:class:`~pyglet.image.AbstractImage` hierarchy.
 
     The :py:class:`~pyglet.image.BufferImage` hierarchy.
 
-* One or more colour buffers, represented by
+* One or more color buffers, represented by
   :py:class:`~pyglet.image.ColorBufferImage`
 * An optional depth buffer, represented by
   :py:class:`~pyglet.image.DepthBufferImage`
@@ -852,6 +857,10 @@ For example, to bind a texture::
 
     glBindTexture(texture.target, texture.id)
 
+
+
+.. _OpenGL Programming Guide: http://www.opengl-redbook.com/
+
 Texture dimensions
 ^^^^^^^^^^^^^^^^^^
 
@@ -943,23 +952,31 @@ empty (maximal).
 Use the :py:meth:`pyglet.image.Texture.create` class method to create a texture
 with a specific internal format.
 
+
 Texture filtering
 ^^^^^^^^^^^^^^^^^
 
-By default, all textures are created with smooth (``GL_LINEAR``) filtering.
-In some cases you may wish to have different filtered applied. Retro style
-pixel art games, for example, would require sharper textures. To achieve this,
-pas ``GL_NEAREST`` to the `min_filter` and `mag_filter` parameters when
-creating a texture. It is also possible to set the default filtering by
-setting the `default_min_filter` and `default_mag_filter` class attributes
-on the `Texture` class. This will cause all textures created internally by
-pyglet to use these values::
+By default, all textures are created with smooth (:py:data:`~pyglet.gl.GL_LINEAR`)
+filtering.
+
+To use a different filter for a specific texture, pass the filtering constant(s)
+to the :py:attr:`pyglet.image.Texture` class via the ``min_filter`` and ``mag_filter``
+arguments.
+
+Pixel art
+"""""""""
+
+To enable nearest-neighbor filtering for retro-style games, set the
+corresponding variables of :py:class:`pyglet.image.Texture` to
+:py:data:`~pyglet.gl.GL_NEAREST`:
 
-    pyglet.image.Texture.default_min_filter = GL_LINEAR
-    pyglet.image.Texture.default_mag_filter = GL_LINEAR
+.. code-block:: python
 
+   pyglet.image.Texture.default_min_filter = GL_LINEAR
+   pyglet.image.Texture.default_mag_filter = GL_LINEAR
 
-.. _OpenGL Programming Guide: http://www.glprogramming.com/red/
+Afterward, all textures pyglet creates will default
+to nearest-neighbor sampling.
 
 Saving an image
 ---------------

{pyglet-2.1.6 → pyglet-2.1.8}/doc/programming_guide/input.rst

@@ -14,7 +14,7 @@ digital and/or analog inputs. For most types of games, the game controller abstr
 recommended.
 
 For advanced use cases, it is also possible to access the low-level input devices directly.
-This can be useful if you need direct accesss to the raw inputs, without normalization.
+This can be useful if you need direct access to the raw inputs, without normalization.
 For most application and games this is not required.
 
 The :py:mod:`~pyglet.input` module provides several methods for querying

{pyglet-2.1.6 → pyglet-2.1.8}/doc/programming_guide/math.rst

@@ -72,8 +72,8 @@ In addition to the ``projection`` property, pyglet Windows also contain a ``view
 points to another matrix that is used internally by pyglet's built-in classes. The view matrix
 gets multiplied with the projection matrix, controlling the final positioning and rendering of
 pyglet's built-in objects like Sprites, Shapes, and text. Unlike the projection matrix the view
-matrix defaults to an indentity matrix, and therefore has no effect initially. This makes it useful
-for users to set their own matrix on it, and controll zooming or translating (panning) a "camera".
+matrix defaults to an identity matrix, and therefore has no effect initially. This makes it useful
+for users to set their own matrix on it, and control zooming or translating (panning) a "camera".
 The ``Mat4`` class contains helper methods for creating these types of matrixes::
 
     # translate the camera +100 on the X axis:

{pyglet-2.1.6 → pyglet-2.1.8}/doc/programming_guide/media.rst

@@ -286,7 +286,7 @@ and FLAC codecs.
 
 If the PyOgg module is installed in your site packages, pyglet will optionally detect
 and use it. Since not all operating systems can decode the same audio formats natively,
-it can often be a hassle to choose an audio format that is truely cross platform with
+it can often be a hassle to choose an audio format that is truly cross platform with
 a small footprint. This wrapper was created to help with that issue.
 
 Supports the following formats:
@@ -570,7 +570,7 @@ and then pass it into the constructor of any of the above waveforms.
 The same envelope instance can be passed to any number of waveforms,
 reducing duplicate code when creating multiple sounds.
 If no envelope is used, all waveforms will default to the FlatEnvelope
-of maximum amplitude, which esentially has no effect on the sound.
+of maximum amplitude, which essentially has no effect on the sound.
 Check the module documentation of each Envelope to see which parameters
 are available.
 
@@ -761,7 +761,7 @@ Incorporating video
 When a :py:class:`~pyglet.media.player.Player` is playing back a source with
 video, use the :attr:`~pyglet.media.Player.texture` property to obtain the
 video frame image. This can be used to display the current video image
-syncronised with the audio track, for example::
+synchronised with the audio track, for example::
 
     @window.event
     def on_draw():

{pyglet-2.1.6 → pyglet-2.1.8}/doc/programming_guide/migration.rst

@@ -33,7 +33,7 @@ you can get and set its attribute values directly via either approach below::
     # "New" 2.1 attribute-style works with type checkers
     pyglet.options.dpi_scaling = 'real'
 
-    # "Old" dict-style access is backward-compatible to helpe with porting
+    # "Old" dict-style access is backward-compatible to help with porting
     pyglet.options['dpi_scaling'] = 'real'
 
 
@@ -245,7 +245,7 @@ greater than ``1.0``. Normalizating allows concisely clamping the input to ``1.0
             player.position += vector * PLAYER_SPEED
 
 
-Accesing Vector Components
+Accessing Vector Components
 """"""""""""""""""""""""""
 You can directly access  individual :py:attr:`~pyglet.math.Vec2.x` and
 :py:attr:`~pyglet.math.Vec2.y` attributes or unpack a vector:
@@ -272,7 +272,7 @@ Widget Event Dispatching
 All widget events now dispatch the widget instance itself as the first argument.
 
 This is similar to how Controller/Joystick events are implemented. It allows
-you to re-use a single handler functions across multiple widgets without "forgetting"
+you to reuse a single handler functions across multiple widgets without "forgetting"
 which widget dispatched an event.
 
 Button Argument Names
@@ -314,8 +314,8 @@ Vector Changes
 
 The syntax for the Vec types has changed in several ways.
 Some of these changes are due to becoming :py:class:`typing.NamedTuple` subclasses, while others
-were done for general usibility. Where possible, we adopt the behavor of GLM/GLSL for most operations,
-for a more familar experience for computer graphics programmers.
+were done for general usability. Where possible, we adopt the behavior of GLM/GLSL for most operations,
+for a more familiar experience for computer graphics programmers.
 
 * The arguments for ``Vec2.from_polar`` have been reversed for consistency. The ``length`` argument also now defaults
   to 1.0. This will fail silently, so take care to correct this if you are using this method in your code::

{pyglet-2.1.6 → pyglet-2.1.8}/doc/programming_guide/resources.rst

@@ -107,7 +107,7 @@ The resource module attempts to pack small images into larger texture atlases
 (which is why the return type of this function can be
 :py:class:`~pyglet.image.TextureRegion`).
 It is also advisable to use the texture atlas classes directly if you wish
-to have different achor points on multiple copies of the same image.
+to have different anchor points on multiple copies of the same image.
 This is because when loading an image more than once, you will actually get
 the **same** object back. You can still use the resource module for getting
 the image location, and described in the next section.
@@ -222,7 +222,7 @@ the operating system's convention:
 * ``~/Library/Application Support/ApplicationName`` on Mac OS X
 
 The :py:func:`pyglet.resource.get_data_path` function returns a directory
-suitable for writing arbitray data, such as save files. The directory used follows
+suitable for writing arbitrary data, such as save files. The directory used follows
 the operating system's convention:
 
 * ``~/.local/share/ApplicationName/`` on Linux (depends on `XDG_DATA_HOME` environment variable).

{pyglet-2.1.6 → pyglet-2.1.8}/doc/programming_guide/shapes.rst

@@ -9,7 +9,7 @@ and manipulating colored shapes, such as rectangles, circles, and
 lines. Shapes can be resized, positioned, and rotated where applicable,
 and their color and opacity can be changed. All shapes are implemented
 using OpenGL primitives, so they can be drawn efficiently with :ref:`guide_batched-rendering`.
-In the following examples `Batch` will be ommitted for brevity, but in
+In the following examples `Batch` will be omitted for brevity, but in
 general you always want to use Batched rendering for performance.
 
 For drawing more complex shapes, see the :ref:`guide_graphics` module.

{pyglet-2.1.6 → pyglet-2.1.8}/doc/programming_guide/text.rst

@@ -130,7 +130,7 @@ for relatively short or unchanging documents.
 :py:class:`~pyglet.text.layout.ScrollableTextLayout` is a small extension to
 :py:func:`~pyglet.text.layout.TextLayout` that culls the
 text outside of a specified view rectangle, and allows text to be scrolled within that
-rectangle without performing the layout calculuation again.  Because of this
+rectangle without performing the layout calculation again.  Because of this
 clipping rectangle the graphics group cannot be shared with other text
 layouts, so for ideal performance
 :py:class:`~pyglet.text.layout.ScrollableTextLayout` should be used only
@@ -296,7 +296,7 @@ Attributed text
 ^^^^^^^^^^^^^^^
 
 pyglet provides two formats for decoding formatted documents from plain text.
-These are useful for loading preprepared documents such as help screens.  At
+These are useful for loading pre-prepared documents such as help screens.  At
 this time there is no facility for saving (encoding) formatted documents.
 
 The *attributed text* format is an encoding specific to pyglet that can