147 lines
6.1 KiB
HTML
147 lines
6.1 KiB
HTML
|
|
||
|
|
<!DOCTYPE html>
|
||
|
|
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<meta charset="utf-8" />
|
||
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
|
||
|
|
|
||
|
|
<title>File Path Function Arguments — pygame v2.5.2 documentation</title>
|
||
|
|
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
|
||
|
|
<link rel="stylesheet" type="text/css" href="_static/pygame.css" />
|
||
|
|
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
|
||
|
|
<script src="_static/jquery.js"></script>
|
||
|
|
<script src="_static/underscore.js"></script>
|
||
|
|
<script src="_static/doctools.js"></script>
|
||
|
|
<link rel="shortcut icon" href="_static/pygame.ico"/>
|
||
|
|
<link rel="index" title="Index" href="genindex.html" />
|
||
|
|
<link rel="search" title="Search" href="search.html" />
|
||
|
|
<link rel="next" title="Pygame Logos Page" href="logos.html" />
|
||
|
|
<link rel="prev" title="API exported by pygame.version" href="c_api/version.html" />
|
||
|
|
</head><body>
|
||
|
|
|
||
|
|
<div class="document">
|
||
|
|
|
||
|
|
<div class="header">
|
||
|
|
<div class="flex-container">
|
||
|
|
<div class="logo">
|
||
|
|
<a href="https://www.pygame.org/">
|
||
|
|
<img src="_static/pygame_tiny.png"/>
|
||
|
|
</a>
|
||
|
|
<h5>pygame documentation</h5>
|
||
|
|
</div>
|
||
|
|
<div class="pagelinks">
|
||
|
|
<div class="top">
|
||
|
|
<a href="https://www.pygame.org/">Pygame Home</a> ||
|
||
|
|
<a href="index.html">Help Contents</a> ||
|
||
|
|
<a href="genindex.html">Reference Index</a>
|
||
|
|
|
||
|
|
<form action="search.html" method="get" style="display:inline;float:right;">
|
||
|
|
<input name="q" value="" type="text">
|
||
|
|
<input value="search" type="submit">
|
||
|
|
</form>
|
||
|
|
</div>
|
||
|
|
<hr style="color:black;border-bottom:none;border-style: dotted;border-bottom-style:none;">
|
||
|
|
<p class="bottom"><b>Most useful stuff</b>:
|
||
|
|
<a href="ref/color.html">Color</a> |
|
||
|
|
<a href="ref/display.html">display</a> |
|
||
|
|
<a href="ref/draw.html">draw</a> |
|
||
|
|
<a href="ref/event.html">event</a> |
|
||
|
|
<a href="ref/font.html">font</a> |
|
||
|
|
<a href="ref/image.html">image</a> |
|
||
|
|
<a href="ref/key.html">key</a> |
|
||
|
|
<a href="ref/locals.html">locals</a> |
|
||
|
|
<a href="ref/mixer.html">mixer</a> |
|
||
|
|
<a href="ref/mouse.html">mouse</a> |
|
||
|
|
<a href="ref/rect.html">Rect</a> |
|
||
|
|
<a href="ref/surface.html">Surface</a> |
|
||
|
|
<a href="ref/time.html">time</a> |
|
||
|
|
<a href="ref/music.html">music</a> |
|
||
|
|
<a href="ref/pygame.html">pygame</a>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p class="bottom"><b>Advanced stuff</b>:
|
||
|
|
<a href="ref/cursors.html">cursors</a> |
|
||
|
|
<a href="ref/joystick.html">joystick</a> |
|
||
|
|
<a href="ref/mask.html">mask</a> |
|
||
|
|
<a href="ref/sprite.html">sprite</a> |
|
||
|
|
<a href="ref/transform.html">transform</a> |
|
||
|
|
<a href="ref/bufferproxy.html">BufferProxy</a> |
|
||
|
|
<a href="ref/freetype.html">freetype</a> |
|
||
|
|
<a href="ref/gfxdraw.html">gfxdraw</a> |
|
||
|
|
<a href="ref/midi.html">midi</a> |
|
||
|
|
<a href="ref/pixelarray.html">PixelArray</a> |
|
||
|
|
<a href="ref/pixelcopy.html">pixelcopy</a> |
|
||
|
|
<a href="ref/sndarray.html">sndarray</a> |
|
||
|
|
<a href="ref/surfarray.html">surfarray</a> |
|
||
|
|
<a href="ref/math.html">math</a>
|
||
|
|
</p>
|
||
|
|
|
||
|
|
<p class="bottom"><b>Other</b>:
|
||
|
|
<a href="ref/camera.html">camera</a> |
|
||
|
|
<a href="ref/sdl2_controller.html#module-pygame._sdl2.controller">controller</a> |
|
||
|
|
<a href="ref/examples.html">examples</a> |
|
||
|
|
<a href="ref/fastevent.html">fastevent</a> |
|
||
|
|
<a href="ref/scrap.html">scrap</a> |
|
||
|
|
<a href="ref/tests.html">tests</a> |
|
||
|
|
<a href="ref/touch.html">touch</a> |
|
||
|
|
<a href="ref/pygame.html#module-pygame.version">version</a>
|
||
|
|
</p>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="documentwrapper">
|
||
|
|
<div class="body" role="main">
|
||
|
|
|
||
|
|
<section id="file-path-function-arguments">
|
||
|
|
<p>A pygame function or method which takes a file path argument will accept
|
||
|
|
either a Unicode or a byte (8-bit or ASCII character) string.
|
||
|
|
Unicode strings are translated to Python's default filesystem encoding,
|
||
|
|
as returned by sys.getfilesystemencoding(). A Unicode code point
|
||
|
|
above U+FFFF (<code class="docutils literal notranslate"><span class="pre">\uFFFF</span></code>) can be coded directly with a 32-bit escape sequences
|
||
|
|
(<code class="docutils literal notranslate"><span class="pre">\Uxxxxxxxx</span></code>), even for Python interpreters built with an UCS-2
|
||
|
|
(16-bit character) Unicode type. Byte strings are passed
|
||
|
|
to the operating system unchanged.</p>
|
||
|
|
<p>Null characters (<code class="docutils literal notranslate"><span class="pre">\x00</span></code>) are not permitted in the path, raising an exception.
|
||
|
|
An exception is also raised if an Unicode file path cannot be encoded.
|
||
|
|
How UTF-16 surrogate codes are handled is Python-interpreter-dependent.
|
||
|
|
Use UTF-32 code points and 32-bit escape sequences instead.
|
||
|
|
The exception types are function-dependent.</p>
|
||
|
|
</section>
|
||
|
|
|
||
|
|
|
||
|
|
<br /><br />
|
||
|
|
<hr />
|
||
|
|
<a href="https://github.com/pygame/pygame/edit/main/docs/reST/filepaths.rst" rel="nofollow">Edit on GitHub</a>
|
||
|
|
<div class="clearer"></div>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div class="clearer"></div>
|
||
|
|
</div>
|
||
|
|
<div class="related" role="navigation" aria-label="related navigation">
|
||
|
|
<h3>Navigation</h3>
|
||
|
|
<ul>
|
||
|
|
<li class="right" style="margin-right: 10px">
|
||
|
|
<a href="genindex.html" title="General Index"
|
||
|
|
accesskey="I">index</a></li>
|
||
|
|
<li class="right" >
|
||
|
|
<a href="py-modindex.html" title="Python Module Index"
|
||
|
|
>modules</a> |</li>
|
||
|
|
<li class="right" >
|
||
|
|
<a href="logos.html" title="Pygame Logos Page"
|
||
|
|
accesskey="N">next</a> |</li>
|
||
|
|
<li class="right" >
|
||
|
|
<a href="c_api/version.html" title="API exported by pygame.version"
|
||
|
|
accesskey="P">previous</a> |</li>
|
||
|
|
<li class="nav-item nav-item-0"><a href="index.html">pygame v2.5.2 documentation</a> »</li>
|
||
|
|
<li class="nav-item nav-item-this"><a href="">File Path Function Arguments</a></li>
|
||
|
|
<script type="text/javascript" src="https://www.pygame.org/comment/jquery.plugin.docscomments.js"></script>
|
||
|
|
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
<div class="footer" role="contentinfo">
|
||
|
|
© Copyright 2000-2023, pygame developers.
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|