^ jrdZddlmZddlZddlZddlZddlZddlmZm Z ddl m Z m Z ddl Z e r:ddl mZddlmZddlmZdd lmZmZmZdd lmZdd lmZdd lmZdd lmZddlm Z Gdde!Z"Gdde!Z#d%dZ$d&dZ%d&dZ&GddZ'Gdde'Z(Gdde'Z)Gdd e'Z*Gd!d"Z+ga,Gd#d$e+Z-e-Z.e.j/Z/e.j0Z0e.j1Z1e.j2Z2e.j3Z3e.j4Z4e.j5Z5e.j6Z6e.j7Z7e.j8Z8e.j9Z9e.j:Z:e.j;Z;e.j<ZZ>e.j?Z?dS)'apLoad application resources from a known path. Loading resources by specifying relative paths to filenames is often problematic in Python, as the working directory is not necessarily the same directory as the application's script files. This module allows applications to specify a search path for resources. Relative paths are taken to be relative to the application's ``__main__`` module. ZIP files can appear on the path; they will be searched inside. The resource module also behaves as expected when applications are bundled using Freezers such as PyInstaller, Nuitka, py2app, etc.. In addition to providing file references (with the :py:func:`file` function), the resource module also contains convenience functions for loading images, textures, fonts, media and documents. 3rd party modules or packages not bound to a specific application should construct their own :py:class:`Loader` instance and override the path to use the resources in the module's directory. Path format ^^^^^^^^^^^ The resource path :py:attr:`path` (see also :py:meth:`Loader.__init__` and :py:meth:`Loader.path`) is a list of locations to search for resources. Locations are searched in the order given in the path. If a location is not valid (for example, if the directory does not exist), it is skipped. Locations in the path beginning with an "at" symbol (''@'') specify Python packages. Other locations specify a ZIP archive or directory on the filesystem. Locations that are not absolute are assumed to be relative to the script home. Some examples:: # Search just the `res` directory, assumed to be located alongside the # main script file. path = ['res'] # Search the directory containing the module `levels.level1`, followed # by the `res/images` directory. path = ['@levels.level1', 'res/images'] Paths are always **case-sensitive** and **forward slashes are always used** as path separators, even in cases when the filesystem or platform does not do this. This avoids a common programmer error when porting applications between platforms. The default path is ``['.']``. If you modify the path, you must call :py:func:`reindex`. ) annotationsN)BytesIOStringIO) TYPE_CHECKINGIO)Literal)Batch)Shader) AbstractImageTexture TextureRegion) Animation) TextureBin)Source)Scene)AbstractDocumentceZdZdZdZdS)ResourceNotFoundExceptionz4The named resource was not found on the search path.cHd|d}t||dS)Nz Resource 'zV' was not found on the path. Ensure that the filename has the correct capitalisation. Exception__init__selfnamemessages J/home/agentuser/manim-venv/lib/python3.11/site-packages/pyglet/resource.pyrz"ResourceNotFoundException.__init__Ms:NNNN4)))))N__name__ __module__ __qualname____doc__rrrrrJs)>>*****rrceZdZdZdZdS)UndetectableShaderTypez6The type of the Shader source could not be identified.cHd|d}t||dS)NzThe Shader type of 'z}' could not be determined. Ensure that your source file has a standard extension, or provide a valid 'shader_type' parameter.rrs rrzUndetectableShaderType.__init__Vs<A$AAA 4)))))rNrr$rrr&r&Ss)@@*****rr&returnstrcttdd}ttdd}|r|S|dvr)tjtjS|dkrtjdStjd}t|drAtjtj |j Sd tj tjvrtj StjtjS) aGet the directory containing the program entry module. For ordinary Python scripts, this is the directory containing the ``__main__`` module. For applications that have been bundled with PyInstaller, Nuitka, etc., this may be the bundle path or a temporary directory. If none of the above cases apply and the file for ``__main__`` cannot be determined the working directory is returned. When the script is being run by a Python profiler, this function may return the directory where the profiler is running instead of the directory of the real script. To work around this behaviour the full path to the real script can be specified in :py:attr:`pyglet.resource.path`. frozenN_MEIPASS) windows_exe console_exe macosx_app RESOURCEPATH__main____file__python) getattrsysospathdirname executableenvironmoduleshasattrabspathr2basenamegetcwd)r+meipassmains rget_script_homerB]s S(D ) )Fc:t,,G7 1 1 1ws~... <  z.)){:& 4 $ $ 77??27??4=#A#ABB B27++CN;;;;y{{"ws~666rrctjdvr`dtjvr0tjtjd|Stjd|Stjdkr"tjd|Stjdr`dtjvr0tjtjd|Stjd|Stjd |S) aGet a directory path to save user preferences. Different platforms have different conventions for where to save user preferences and settings. This function implements those conventions as described below, and returns a fully formed path. On Linux, a directory ``name`` in the user's configuration directory is returned (usually under ``~/.config``). On Windows (including under Cygwin) the ``name`` directory in the user's ``Application Settings`` directory is returned. On Mac OS X the ``name`` directory under ``~/Library/Application Support`` is returned. .. note:: This function does not perform any directory creation. Users should use ``os.path.exists`` and ``os.makedirs`` to construct the directory if desired. cygwinwin32APPDATA~/darwin~/Library/Application Support/linuxXDG_CONFIG_HOMEz ~/.config/~/.pygletcompat_platformr6r:r7join expanduser startswithrs rget_settings_pathrUs(!444  " "7<< 9 5t<< <7%%k4kk22 2  8 + +w!!"I4"I"IJJJ   * *7 3 30  * *7<< +< =tDD D7%%&94&9&9:: :w!!,,,///rctjdvr`dtjvr0tjtjd|Stjd|Stjdkr"tjd|Stjdr`dtjvr0tjtjd|Stjd|Stjd |S) aGet a directory to save user data. For a Posix or Linux based system many distributions have a separate directory to store user data for a specific application and this function returns the path to that location. On Linux, a directory ``name`` in the user's data directory is returned (usually under ``~/.local/share``). On Windows (including under Cygwin) the ``name`` directory in the user's ``Application Settings`` directory is returned. On Mac OS X the ``name`` directory under ``~/Library/Application Support`` is returned. .. note:: This function does not perform any directory creation. Users should use ``os.path.exists`` and ``os.makedirs`` to construct the directory if desired. rDrGrHrIrJrK XDG_DATA_HOMEz~/.local/share/rMrNrTs r get_data_pathrXs(!444  " "7<< 9 5t<< <7%%k4kk22 2  8 + +w!!"I4"I"IJJJ   * *7 3 30 bj ( (7<< ? ;TBB B7%%&>&>&>?? ?w!!,,,///rceZdZdZd d dZd S) LocationaAbstract resource location. Given a location, a file can be loaded from that location with the :py:meth:`open` method. This provides a convenient way to specify a path to load files from, even when that path does not reside on the filesystem. rbrr)moder(BytesIO | StringIO | IOc td)aOpen a file at this location. Args: name: The file name to open. Absolute paths are not supported. Relative paths are not supported by most locations (you should specify only a file name with no path component). mode: The file mode to open with. Only files opened on the filesystem make use of this parameter; others ignore it. abstract)NotImplementedError)rrr\s ropenz Location.opens"*---rNr[rr)r\r)r(r])r r!r"r#rar$rrrZrZs7 . . . . . . .rrZc$eZdZdZd dZddd Zd S) FileLocationzLocation on the filesystem.filepathr)r(Nonec||_dS)z4Create a location given a relative or absolute path.Nr7)rrfs rrzFileLocation.__init__  rr[filenamer\rchttj|j||SN)rar6r7rQ)rrkr\s rrazFileLocation.opens$BGLLH55t<<>>>>rrqc$eZdZdZd dZddd Zd S) URLLocationz|Location on the network. This class uses the ``urllib`` module to open files on the network, given a base URL. base_urlr)r(rgc||_dS)z#Create a location given a base URL.N)base)rrs rrzURLLocation.__init__rjrrkr\rcddl}ddl}|j|j|}t |j|S)zOpen a remote file. Args: filename: The name of the remote resource to open. mode: Unused, as the mode is determined by the remote server. rN) urllib.parseurllib.requestparseurljoinrrrequesturlopenr)rrkr\urlliburls rrazURLLocation.opens_ l""49h77v~--c227799:::rN)rr)r(rg)rrnror$rrrrsK  ; ; ; ; ; ; ;rrceZdZdZdDdEd Zd ZdFdZdZdGdHdZdIdZ dJdZ dKdZ dLd"Z dMdNd-Z dOdPd/ZdQd1ZdQd2ZdQd3ZdRd5ZdSdTd8ZdUd:ZdVd<ZdWd>ZdWd?ZdWd@ZdXdYdCZdS)ZLoaderzLoad program resource files from disk. The loader contains a search path which can include filesystem directories, ZIP archives, URLs, and Python packages. Npathlistlist[str] | None script_homerur(rgc>|pdg}t|tr|g}t||_|p t |_d|_i|_tj |_ tj |_ tj |_ dS)aCreate a loader for the given path. If no path is specified it defaults to ``['.']``; that is, just the program directory. See the module documentation for details on the path format. Args: pathlist: List of locations to search for resources. script_home: Base location of relative files. Defaults to the result of :py:func:`get_script_home`. .N) isinstancer)listr7rB _script_home_index_texture_atlas_binsweakrefWeakValueDictionary_cached_textures_cached_images_cached_animations)rrrs rrzLoader.__init__3s$u h $ $ " zHNN 'd |tjD}d |}|D]4} |r |d z| z} n| } t)|} || | 5d} d} |rtj|sc|} tj|\}}|| krn8d || f} |rtj|c|| kr| d } t/j|rt/j|d }|D]v}|r| |jvr!|j| } | d } t=|| } || | wPdS) zRefresh the file index. You must call this method if ``resource.path`` is changed, or the filesystem layout changes. @Nrr2rz\\z/Backslashes are not permitted in relative pathscg|]}||Srmr$).0parts r z"Loader.reindex..s \ \ \$4K[K[K[K[rr{r|)rr7rS __import__ ImportError ValueErrorsplitr4r<r6r8r2isabsrQrisdirrstripr~walklenrerisfilezipfile is_zipfileZipFileinfolistis_dirrklstriprq)r _path_name module_namemodule componentdirpathdirnames filenamespartsrk index_name file_location zip_directoryold_pathtail_dirrrfileinfos rrzLoader.reindex[s  )F BF BJ$$S)) I(n ' 44FF#Z0H!,!2!23!7!7!;88I$VY77FF6:..$!#!A!AJJ!#JJW]]:.. IJ...0a...W\\$*;ZHH w}}Z((0 B'..rw{;; 46GJ4G4G D D0GXy%c*oo&9&:&:;G2 \ \'--2G2G \ \ \"%((5//$-DD"2)03)AJJ)1J(4Z(@(@ ((]CCCC D D&!#  H"'..*D*DH)H+-7==+D+D(J!X--$'HHh -F$G$GM !H"'..*D*DH )) - 4 4S 9 9 %j11 B!(S!A!AJ$.$7$7$9$9 B B#??,,%$(0AAA$#+#4#;#;M#J#J#+??3#7#7(3J (N(N ((=AAAAMF BF BsAAAr[r\r]c| |j|}|||S#t$rt |wxYw)aLoad a file-like object. Args: name: Filename of the resource to load. mode: Combination of ``r``, ``w``, ``a``, ``b`` and ``t`` characters with the meaning as for the builtin ``open`` function. )rrraKeyErrorr)rrr\rs rfilez Loader.filesf  2 K-M %%dD11 1 2 2 2+D11 1 2s "9Ark(FileLocation | URLLocation | ZIPLocationc| |j|S#t$rt|wxYw)aEGet the location of a resource. This method is useful for opening files referenced from a resource. For example, an HTML file loaded as a resource might reference some images. These images should be located relative to the HTML file, not looked up individually in the loader's path. )rrrr)rrks rlocationzLoader.locationsQ  6;x( ( 6 6 6+H55 5 6s #=c|ddlm}||}||dS)aAdd a font resource to the application. Fonts not installed on the system must be added to pyglet before they can be used with ``font.load``. Although the font is added with its filename using this function, fonts are always loaded by specifying their family name. For example:: resource.add_font('action_man.ttf') action_man = font.load('Action Man') r)fontN)rrOrradd_file)rrkrfileobjs radd_fontzLoader.add_fontsQ ))H%% gr use_atlasboolborderintr c||} tj||}|n#|wxYw|s|S||j|j|x}r| ||S|S)Nr) rrOimageloadclose get_texture_get_texture_atlas_binwidthheightadd)rrrrrimg texture_bins r _alloc_imagezLoader._alloc_images))D// ,##Dw#77C MMOOOOGMMOOOO %??$$ $55ciVTT T; 0??3// /   s !A A#rrTextureBin | Nonec6tj}td||z }||ks||krdSd}||dz krd} |j|}n=#t $r0tjj}||j|<YnwxYw|S)zA heuristic for determining the atlas bin to use for a given image size. Returns None if the image should not be placed in an atlas (too big), otherwise the bin (a list of TextureAtlas). iNr)rOrget_max_texture_sizeminrratlasr)rrrrmax_texture_sizemax_sizebin_sizers rrzLoader._get_texture_atlas_bins "<<<>>t-..7 8  v004 HqL H =28  4& & &*40HH373D3DT5RX3Y3Y YHt*40 f V O%%fff===rrc| |j|}n#t$rtj|||}||| |}|r| |||x}|j|<YnwxYw|s|s|s|S| |||S)a Load an animation with optional transformation. Animations loaded from the same source but with different transformations will use the same textures. Args: name: Filename of the animation source to load. flip_x: If ``True``, the returned image will be flipped horizontally. flip_y: If ``True``, the returned image will be flipped vertically. rotate: The returned image will be rotated clockwise by the given number of degrees (must be a multiple of 90). border: Leaves specified pixels of blank space around each image in an atlas, which may help reduce texture bleeding. ) rrrrOrload_animationrr get_max_widthget_max_heightadd_to_texture_binr) rrrrrrr _animationrs r animationzLoader.animation-s*  B.t4HH B B B44T499T??KKJ55j6N6N6P6P6@6O6O6Q6Q6<>>K C--k6BBB7A AHt.t444 B f V O%%fff===s $BCC list[str]cv|t|jS)z{Get a list of animation filenames that have been cached. This is useful for debugging and profiling only. )rrrkeysrs rget_cached_animation_namesz!Loader.get_cached_animation_namesTs3 D+0022333rcv|t|jS)zwGet a list of image filenames that have been cached. This is useful for debugging and profiling only. )rrrr rs rget_cached_image_nameszLoader.get_cached_image_names\s3 D',,..///rcv|t|jS)zyGet a list of texture filenames that have been cached. This is useful for debugging and profiling only. )rrrr rs rget_cached_texture_nameszLoader.get_cached_texture_namesds3 D)..00111rlist[TextureBin]cv|t|jS)zeGet a list of texture bins in use. This is useful for debugging and profiling only. )rrrvaluesrs rget_texture_binszLoader.get_texture_binsls3 D,3355666r streamingrc|ddlm} |j|}t t t r(>(>(>(>TINKL%>%>%>%>%>N444400002222777722222:    MMMM <<<< MMMM==== I I I I I I IrrcDeZdZedZejdZdS)_DefaultLoaderctSrmrirs rr7z_DefaultLoader.paths rc |adSrmri)rvalues rr7z_DefaultLoader.paths rN)r r!r"propertyr7setterr$rrr>r>sJ X [[rr>)r(r))rr)r(r))@r# __future__rr6r5rriorrtypingrrrOrpyglet.graphicsr pyglet.graphics.shaderr pyglet.imager r r pyglet.image.animationrpyglet.image.atlasrpyglet.media.codecsr pyglet.modelrpyglet.text.documentrrrr&rBrUrXrZrerqrrr7r>_default_loaderrrrrrrrrr#r%r!rr8rr r rr$rrrPs|00b#"""""  $$$$$$$$  6%%%%%%------BBBBBBBBBB000000------******""""""555555***** ********Y***$7$7$7$7N!0!0!0!0H!0!0!0!0H........0=====8===!>!>!>!>!>(!>!>!>H;;;;;(;;;4jIjIjIjIjIjIjIjIj       V   !.""  !  #  #  %   !  '   *C(?,G"3r