204 lines
7 KiB
HTML
204 lines
7 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<html>
|
|
<head>
|
|
<title>
|
|
Tux Paint Environment Variables Documentation </title>
|
|
<meta http-equiv="Content-Type"
|
|
content="text/html; charset=utf-8">
|
|
<style>
|
|
body { font-size: large; }
|
|
table { font-size: large; }
|
|
div.screenshot-center {
|
|
text-align: center;
|
|
}
|
|
div.screenshot-right {
|
|
float: right;
|
|
margin-left: 1em;
|
|
margin-bottom: 1em;
|
|
}
|
|
div.screenshot-right-after {
|
|
clear: both;
|
|
}
|
|
div.keeptogether { page-break-inside: avoid; }
|
|
section h1 { font-size: 2em; }
|
|
h1, h2, h3, h4, h5 { font-family: sans; }
|
|
h1 { color: #800; page-break-before: always; break-before: always; }
|
|
h2 { color: #440; page-break-after: avoid; break-after: avoid; }
|
|
h3 { color: #080; page-break-after: avoid; break-after: avoid; }
|
|
h4 { color: #008; page-break-after: avoid; break-after: avoid; }
|
|
h5 { color: #808; page-break-after: avoid; break-after: avoid; }
|
|
h1 + p { page-break-inside: avoid; }
|
|
h2 + p { page-break-inside: avoid; }
|
|
h3 + p { page-break-inside: avoid; }
|
|
h4 + p { page-break-inside: avoid; }
|
|
h5 + p { page-break-inside: avoid; }
|
|
dt {
|
|
font-size: large;
|
|
color: #404;
|
|
font-family: sans;
|
|
margin-top: 1em;
|
|
margin-bottom: 0.25em;
|
|
}
|
|
dd, blockquote {
|
|
border-left: 1px solid #888;
|
|
padding-left: 1em;
|
|
border-radius: 0 0 0 1em;
|
|
}
|
|
p.note {
|
|
border: 1px solid #000;
|
|
background-color: #eee;
|
|
border-radius: 0.5em;
|
|
padding: 0.5em;
|
|
display: inline-block;
|
|
margin-right: 3em;
|
|
margin-top: 0.5em;
|
|
margin-bottom: 0.5em;
|
|
}
|
|
section.outer {
|
|
padding-bottom: 1em;
|
|
border-bottom: 2px solid #000;
|
|
}
|
|
section.indent p,dl {
|
|
margin-left: 2em;
|
|
}
|
|
section.indent dl p {
|
|
margin-left: 0;
|
|
}
|
|
p + ul, p + ol {
|
|
margin-left: 2em;
|
|
}
|
|
|
|
@media print {
|
|
p {
|
|
orphans: 3;
|
|
widows: 3;
|
|
}
|
|
}
|
|
</style>
|
|
</head>
|
|
<body bgcolor="#FFFFFF"
|
|
text="#000000"
|
|
link="#0000FF"
|
|
vlink="#FF0000"
|
|
alink="#FF00FF">
|
|
<center>
|
|
<h1>
|
|
<img src="../../html/images/tuxpaint-title.png"
|
|
width="205"
|
|
height="210"
|
|
alt="Tux Paint"><br>
|
|
versión 0.9.35<br/>
|
|
Environment Variables Documentation </h1>
|
|
|
|
<p>
|
|
Copyright © 2021-2025 by various contributors; see <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
|
|
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
|
|
</p>
|
|
|
|
<p>
|
|
mayo 2, 2025 </p>
|
|
</center>
|
|
|
|
<hr>
|
|
|
|
<p>
|
|
Tux Paint understands a number of environment variables, either directly, or indirectly by the libraries that it utilizes. </p>
|
|
|
|
<h2>
|
|
Storage-related environment variables </h2>
|
|
<dl>
|
|
<dt>
|
|
<code>HOME</code>
|
|
</dt>
|
|
|
|
<dd>
|
|
<p>
|
|
Specifies the user's "home directory", which is used to locate numerous other files or directories. In some cases, it is utilized as part of a fall-back location, when other environment variables (elsewhere in this documentation) are not set. Sometimes, the location to use can be overridden by options provided on the command-line or via Tux Paint's configuration file. See the "OPTIONS" documentation for details. </p>
|
|
|
|
<p>
|
|
A few examples of where "<code>$HOME</code>" is used include: </p>
|
|
|
|
<ul>
|
|
<li>The location of Tux Paint's configuration file</li>
|
|
<li>The basis of where Tux Paint saves and loads users' drawings</li>
|
|
<li>The location of a user's private collection of data files — stamps, brushes, etc. — (versus those available system wide)</li>
|
|
</ul>
|
|
</dd>
|
|
|
|
<dt>
|
|
<code>XDG_CONFIG_HOME</code>
|
|
</dt>
|
|
|
|
<dd>
|
|
<p>
|
|
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's configuration files. Specifically, where to find "<code>user-dirs.dirs</code>", where the "<code>XDG_PICTURES_DIR</code>" might be defined. It is used for exporting drawings and animated GIFs. Generally it's set to something like "<code>$HOME/Pictures/</code>". If not specified, Tux Paint checks in the directory "<code>$HOME/.config/</code>". If the configuration cannot be found, Tux Paint simply exports drawings and GIFs to "<code>$HOME</code>". </p>
|
|
</dd>
|
|
|
|
<dt>
|
|
<code>XDG_DATA_HOME</code>
|
|
</dt>
|
|
|
|
<dd>
|
|
<p>
|
|
On Linux and other platforms where the X Desktop Group standards are used, the location of the user's data directories. Specifically, where to find the "<code>Trash</code>" directory. It is used when deleting images from Tux Paint's "Open" dialog. If not set, the location "<code>$HOME/.local/share/Trash/</code>" is used, if available. If not, images are simply deleted, rather than moved anywhere. </p>
|
|
</dd>
|
|
|
|
<dt>
|
|
<code>TEMP</code>
|
|
</dt>
|
|
|
|
<dd>
|
|
<p>
|
|
Specifies the location where temporary files may be created. Only used by Tux Paint on Microsoft Windows OSes. Uses "<code>userdata</code>" if not set. </p>
|
|
</dl>
|
|
|
|
|
|
<h2>
|
|
Language-related environment variables </h2>
|
|
<dl>
|
|
<dt>
|
|
<code>LANG</code>
|
|
</dt>
|
|
<dt>
|
|
<code>LANGUAGE</code>
|
|
</dt>
|
|
<dt>
|
|
<code>LC_ALL</code>
|
|
</dt>
|
|
<dt>
|
|
<code>LC_MESSAGES</code>
|
|
</dt>
|
|
|
|
<dd>
|
|
<p>
|
|
Specify the language Tux Paint should utilize in its user interface. Overridden by the "<code>--lang</code>" and "<code>--locale</code>" command-line options or their configuration file counterparts. The "<code>LANGUAGE</code>" environment variable is used, if set. If not, "<code>LC_ALL</code>" is used as a fallback. Then "<code>LC_MESSAGES</code>", and finally "<code>LANG</code>". </p>
|
|
</dd>
|
|
|
|
</dl>
|
|
|
|
<h2>
|
|
Display-related environment variables </h2>
|
|
|
|
<p>
|
|
The following are a few of the environment variables supported by Simple DirectMedia Layer (libSDL) — which Tux Paint utilizes for displaying graphics, playing sounds, and receiving mouse, keyboard, and joystick input — and which may be useful to users of Tux Paint.
|
|
<dl>
|
|
<dt>
|
|
<code>SDL_VIDEO_ALLOW_SCREENSAVER</code>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
Specifies whether Tux Paint should allow a screensaver to run. Can be set to '1' (true) by Tux Paint itself by issuing the command-line option "<code>--allowscreensaver</code>" or its configuration file counterpart. </p>
|
|
</dd>
|
|
<dt>
|
|
<code>SDL_VIDEO_WINDOW_POS</code>
|
|
</dt>
|
|
<dd>
|
|
<p>
|
|
Requests where to position Tux Paint's window, and can be used to specify what display to place a fullscreen Tux Paint in a multi-monitor configuration. If not set, or set to "<code>nopref</code>" (meaning "no preference"), Simple DirectMedia Layer (libSDL) decides. Can be set to an <code>X,Y</code> coordinate (e.g. <code>200,100</code>), or "<code>center</code>" (meaning "center"). </p>
|
|
</dd>
|
|
|
|
</dl>
|
|
|
|
</body>
|
|
</html>
|
|
|