\ j\'dZddlZddlmZGddeZGddZGdd ZGd d ZGd d Z dS)aGroup multiple small images into larger textures. This module is used by :py:mod:`pyglet.resource` to efficiently pack small images into larger textures. :py:class:`~pyglet.image.atlas.TextureAtlas` maintains one texture; :py:class:`TextureBin` manages a collection of atlases of a given size. Example usage:: # Load images from disk car_image = pyglet.image.load('car.png') boat_image = pyglet.image.load('boat.png') # Pack these images into one or more textures bin = TextureBin() car_texture = bin.add(car_image) boat_texture = bin.add(boat_image) The result of :py:meth:`TextureBin.add` is a :py:class:`TextureRegion` containing the image. Once added, an image cannot be removed from a bin (or an atlas); nor can a list of images be obtained from a given bin or atlas -- it is the application's responsibility to keep track of the regions returned by the ``add`` methods. .. versionadded:: 1.1 N)GL_RGBAceZdZdZdS)AllocatorExceptionzSThe allocator does not have sufficient free space for the requested image size.N)__name__ __module__ __qualname____doc__L/DATA/AppData/hermes/venv/lib/python3.11/site-packages/pyglet/image/atlas.pyrrCsDr rc$eZdZdZdZdZdZdS)_Stripxy max_heighty2c>d|_||_||_||_dSNrr)selfrrs r __init__z_Strip.__init__Ls"$r c|dkr|dksJ||jksJ|j|j}}|xj|z c_t|j|z|j|_||fSr)rrrmaxr)rwidthheightrrs r addz _Strip.addRsiqyyVaZZZ'((((vtv1 %dfvotw//!t r c.|j|jz |_dS)N)rrrrs r compactz_Strip.compact[s'DF*r N)rrr __slots__rrrr r r rrIsF,I +++++r rc.eZdZdZdZdZdZdZdZdS) AllocatoraiRectangular area allocation algorithm. Initialise with a given ``width`` and ``height``, then repeatedly call `alloc` to retrieve free regions of the area and protect that area from future allocations. `Allocator` uses a fairly simple strips-based algorithm. It performs best when rectangles are allocated in decreasing height order. )rrstrips used_areacx|dkr|dksJ||_||_td|g|_d|_dS)zCreate an `Allocator` of the given size. :Parameters: `width` : int Width of the allocation region. `height` : int Height of the allocation region. rN)rrrr#r$)rrrs r rzAllocator.__init__ksGqyyVaZZZ'  a(() r c|jD]K}|j|jz |kr6|j|kr+|xj||zz c_|||cSL|j|kr|j|jz |kry|xj||zz c_|t|j|j|jz }|j ||||Std|||fz)aGet a free area in the allocator of the given size. After calling `alloc`, the requested area will no longer be used. If there is not enough room to fit the given area `AllocatorException` is raised. :Parameters: `width` : int Width of the area to allocate. `height` : int Height of the area to allocate. :rtype: int, int :return: The X and Y coordinates of the bottom-left corner of the allocated region. z!No more space in %r for box %dx%d) r#rrrr$rrrrrappendr)rrrstripnewstrips r alloczAllocator.alloc{s"[ 0 0EzEG#u,,1AV1K1K%&.0yy///// :  4;#9V#C#C NNefn ,NN MMOOOeh eh(>??H K  x ( ( (<<v.. . !DeU[G\!\]]]r cJ|jt|j|jzz S)zGet the fraction of area already allocated. This method is useful for debugging and profiling only. :rtype: float )r$floatrrrs r get_usagezAllocator.get_usages"~dj4;&> ? ???r c||jsdS|jdj|jz}d|jt |z z S)zGet the fraction of area that's unlikely to ever be used, based on current allocation behaviour. This method is useful for debugging and profiling only. :rtype: float gg?)r#rrr$r,)r possible_areas r get_fragmentationzAllocator.get_fragmentationsB{ 3 B*TZ7 T^eM&:&::::r N) rrrr r rr*r-r1r r r r"r"_sg9I ^^^>@@@ ; ; ; ; ;r r"c"eZdZdZddZddZdS) TextureAtlasz&Collection of images within a texture.ctj}t||}t||}tjj||t d|_t|||_ dS)zCreate a texture atlas of the given size. :Parameters: `width` : int Width of the underlying texture. `height` : int Height of the underlying texture. T) rectangleN) pygletimageget_max_texture_sizeminTexturecreatertexturer" allocator)rrrmax_texture_sizes r rzTextureAtlas.__init__sq"<<<>>E+,,V-..|+225&'UY2ZZ "5&11r rc |j|j|dzz|j|dzz\}}|j|||z||zd|j||z||z|j|jS)aAdd an image to the atlas. This method will fail if the given image cannot be transferred directly to a texture (for example, if it is another texture). :py:class:`~pyglet.image.ImageData` is the usual image type for this method. `AllocatorException` will be raised if there is no room in the atlas for the image. :Parameters: `img` : `~pyglet.image.AbstractImage` The image to add. `border` : int Leaves specified pixels of blank space around each image added to the Atlas. :rtype: :py:class:`~pyglet.image.TextureRegion` :return: The region of the atlas containing the newly added image. r)r>r*rrr= blit_into get_region)rimgborderrrs r rzTextureAtlas.adds(~##CIq$8#*vax:OPP1 sAfHah:::|&&qx639cjQQQr Nr4r4rrrrr rrr r r r3r3sH002222"RRRRRRr r3c"eZdZdZddZddZdS) TextureBinzCollection of texture atlases. :py:class:`~pyglet.image.atlas.TextureBin` maintains a collection of texture atlases, and creates new ones as necessary to accommodate images added to the bin. r4ctj}t|||_t|||_g|_dS)aCreate a texture bin for holding atlases of the given size. :Parameters: `texture_width` : int Width of texture atlases to create. `texture_height` : int Height of texture atlases to create. `border` : int Leaves specified pixels of blank space around each image added to the Atlases. N)r7r8r9r: texture_widthtexture_heightatlases)rrLrMr?s r rzTextureBin.__init__sI"<<<>> 0@AA!.2BCC r rctt|jD]Z} |||cS#t$r3|jdkr%|jdkr|j|YWwxYwt|j|j }|j ||||S)aAdd an image into this texture bin. This method calls `TextureAtlas.add` for the first atlas that has room for the image. `AllocatorException` is raised if the image exceeds the dimensions of ``texture_width`` and ``texture_height``. :Parameters: `img` : `~pyglet.image.AbstractImage` The image to add. `border` : int Leaves specified pixels of blank space around each image added to the Atlas. :rtype: :py:class:`~pyglet.image.TextureRegion` :return: The region of an atlas containing the newly added image. @) listrNrrrrremover3rLrMr')rrDrEatlass r rzTextureBin.adds&$,'' / /E /yyf-----% / / /9r>>cj2ooL''...  /T/1DEE E"""yyf%%%s0:A-,A-NrFrGrHr r r rJrJsF $&&&&&&r rJ) r r7 pyglet.glr Exceptionrrr"r3rJr r r rVsH4         ++++++++,P;P;P;P;P;P;P;P;f*R*R*R*R*R*R*R*RZ8&8&8&8&8&8&8&8&8&8&r