mirror of
https://github.com/aseprite/aseprite.git
synced 2024-12-27 21:19:18 +00:00
502 lines
19 KiB
HTML
502 lines
19 KiB
HTML
<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'><html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml">
|
|
<head>
|
|
<meta content="text/html; charset=utf-8" http-equiv="Content-Type"/>
|
|
<title>ASE | Allegro Sprite Editor</title>
|
|
<style text="text/css">
|
|
body { font-family:sans-serif; font-size:11pt; }
|
|
a { text-decoration:none; }
|
|
a:hover { text-decoration:underline; }
|
|
#page { width:600px; margin-left:auto; margin-right:auto; }
|
|
#title { font-size:20pt; }
|
|
#subtitle { font-size:12pt; color:#aaa; }
|
|
#warning { font-size:12pt; color:#f77; background-color:#fee; border:1px solid #f77; padding:8px; margin:8px auto; width:80%; }
|
|
#footer { font-size:10pt; color:#aaa; border-top:1px solid #aaa; }
|
|
h1 { font-size:14pt; font-weight:bold; color:#080; }
|
|
h2 { font-size:12pt; font-weight:bold; color:#0a0; }
|
|
p { margin-left:8px; }
|
|
.author { margin-left:8px; }
|
|
.details { margin-left:16px; margin-bottom:8px; color:#aaa; }
|
|
.details a { display:block; }
|
|
.ideas { margin-left:16px; }
|
|
pre { background-color:#e0f0e0; padding:8px; margin-left:32px; }
|
|
</style>
|
|
</head>
|
|
<body>
|
|
<div id="page">
|
|
|
|
<div id="title">
|
|
<span style="color:#f00">A</span><span style="color:#0a0">S</span><span style="color:#00f">E</span>
|
|
<span style="color:#aca">| Allegro Sprite Editor</span>
|
|
</div>
|
|
<div id="subtitle">Copyright © 2001-2010 David Capello</div>
|
|
<div id="warning">
|
|
THIS PROGRAM IS DISTRIBUTED WITHOUT ANY WARRANTY<br/>
|
|
See <a href="#license">license</a> section for more information.
|
|
</div>
|
|
|
|
<h1>TABLE OF CONTENTS</h1>
|
|
<p id="tableofcontent">
|
|
<a href="#introduction">Introduction</a><br/>
|
|
<a href="#features">Features</a><br/>
|
|
<a href="#configuration_files">Configuration Files</a><br/>
|
|
<a href="#developers">Developers</a><br/>
|
|
<a style="margin-left:32px;" href="#compilation">Compilation</a><br/>
|
|
<a style="margin-left:32px;" href="#installation">Installation</a><br/>
|
|
<a style="margin-left:32px;" href="#uninstallation">Uninstallation</a><br/>
|
|
<a style="margin-left:32px;" href="#sourcecode">Source Code</a><br/>
|
|
<a href="#contact_information">Contact Information</a><br/>
|
|
<a href="#license">License</a><br/>
|
|
<a style="margin-left:32px;" href="#legal_issues">Legal Issues</a><br/>
|
|
<a href="#authors">Authors</a><br/>
|
|
<a style="margin-left:32px;" href="#thankfulness">Thankfulness</a><br/>
|
|
</p>
|
|
|
|
<a name="introduction"></a><h1>INTRODUCTION</h1>
|
|
<p>
|
|
<b>ASE</b> is an open source program to create animated
|
|
sprites. Sprites are little images that can be used in your website
|
|
or in a video game. You can draw characters with movement, intros,
|
|
textures, patterns, backgrounds, logos, color palettes, isometric
|
|
levels, etc.
|
|
</p>
|
|
<p>
|
|
What makes ASE different? It focuses on pixel editing, to do
|
|
pixel-art. Indeed, it isn't a photo retouching tool or a vector
|
|
graphics editor. Mainly it is a tool to create tiny animations
|
|
pixel-by-pixel.
|
|
</p>
|
|
|
|
<a name="features"></a><h1>FEATURES</h1>
|
|
<p>
|
|
The biggest features of ASE are:
|
|
</p>
|
|
<p>
|
|
<ul>
|
|
<li>
|
|
Sprites are composed by <b>layers and frames</b>. These two concept are separated.
|
|
You have layers in one side and frames on the other side. You can imagine this as a
|
|
matrix, where each row is a layer and each column is a frame.
|
|
</li>
|
|
<li>
|
|
Supported color modes: <b>RGBA</b>, Grayscale and <b>Indexed images</b> (palettes up to 256 colors).
|
|
</li>
|
|
<li>
|
|
Supported image formats (load/save): <b>PNG</b>, <b>GIF</b>, JPG, FLC, FLI, BMP, PCX, TGA, and ASE (special format).
|
|
</li>
|
|
<li>
|
|
Load and save animations in a <b>sequence of bitmaps</b> (e.g. frame1.png, frame2.png, etc.).
|
|
</li>
|
|
<li>
|
|
Tiled drawing mode, useful to draw patterns and textures.
|
|
</li>
|
|
<li>
|
|
<b>Undo/Redo</b> for every operation.
|
|
</li>
|
|
<li>
|
|
Special tools like Blur, Jumble, Convolution Matrices.
|
|
</li>
|
|
<li>
|
|
<b>Multiple editors</b> support. You can split an editor horizontally or vertically multiple times
|
|
to edit and view the same sprite with different zooms, or different sprites.
|
|
</li>
|
|
<li>
|
|
<b>Onion skinning</b>.
|
|
</li>
|
|
</ul>
|
|
</p>
|
|
|
|
<a name="configuration_files"></a><h1>CONFIGURATION FILES</h1>
|
|
<p>
|
|
In Windows 98/2K/XP/Vista the main configuration file is
|
|
<em>aseprite.cfg</em> which is saved in the same folder of
|
|
<em>aseprite.exe</em>
|
|
executable file (in this way ASE is a portable
|
|
application, i.e. you can transport a copy of the program
|
|
in your USB drive).
|
|
</p>
|
|
<p>
|
|
The following is a list of all configuration files that you could
|
|
modify (it is not recommended to do so, but is useful if you want to
|
|
<em>super</em>-customize ASE):
|
|
<p>
|
|
<p>
|
|
<pre>aseprite.cfg Program configuration
|
|
data/gui.xml Menus, shortcuts, and tools
|
|
data/convmatr.def Convolutions matrices
|
|
data/fonts/*.pcx Fonts to be used in the GUI
|
|
data/jids/*.jid XML files with dialogs
|
|
data/skins/*.* ASE skins</pre>
|
|
</p>
|
|
<p>
|
|
In GNU/Linux, the configuration file is ~/.asepriterc, and
|
|
the data/ files are searched in these locations (in priority
|
|
order):
|
|
</p>
|
|
<p>
|
|
<pre>$HOME/.aseprite/
|
|
/usr/local/share/aseprite/
|
|
data/</pre>
|
|
</p>
|
|
|
|
<a name="developers"></a><h1>DEVELOPERS</h1>
|
|
<a name="compilation"></a><h2>COMPILATION</h2>
|
|
<p>
|
|
Before compile, you have to configure how to compile ASE, what
|
|
libraries are available, release-debug-profile mode, etc. You can
|
|
run the "fix.sh" script, answer some questions and done: the main
|
|
makefile is created, just do
|
|
</p>
|
|
<p>
|
|
<pre>make</pre>
|
|
</p>
|
|
<p>
|
|
Or you could edit the "makefile.cfg", uncomment CONFIGURED=1 and
|
|
uncomment the necessary options, and then run
|
|
</p>
|
|
<p>
|
|
<pre>makefile -f makefile.lnx</pre>
|
|
</p>
|
|
<p>
|
|
|
|
For MinGW, edit the "makefile.cfg" file, and then
|
|
</p>
|
|
<p>
|
|
<pre>makefile -f makefile.mgw</pre>
|
|
</p>
|
|
|
|
<a name="installation"></a><h2>INSTALLATION</h2>
|
|
<p>
|
|
After compilation, you have two options:
|
|
</p>
|
|
<p>
|
|
<ol>
|
|
<li>
|
|
<p>
|
|
Running ASE from its source directory.
|
|
</p>
|
|
</li>
|
|
<li>
|
|
<p>
|
|
Install ASE in the directory that you specified in the "fix.sh" question:
|
|
"Where do you want install ASE by default?" (generally "/usr/local")
|
|
(in the "makefile.cfg", it's the DEFAULT_PREFIX variable)
|
|
</p>
|
|
<p>
|
|
Run "make install" (it only works in Unix like systems)
|
|
</p>
|
|
</li>
|
|
</ol>
|
|
</p>
|
|
<a name="uninstallation"></a><h2>UNINSTALLATION</h2>
|
|
<p>
|
|
Run "make uninstall".
|
|
</p>
|
|
<a name="sourcecode"></a><h2>SOURCE CODE</h2>
|
|
<p>
|
|
If you downloaded ASE from Git repository, after
|
|
updating I recommend you to do:
|
|
</p>
|
|
<p>
|
|
<pre>~/aseprite-src/$ make clean
|
|
~/aseprite-src/$ ./fix.sh
|
|
~/aseprite-src/$ make</pre>
|
|
</p>
|
|
<p>
|
|
Also, you can make dependencies of the files (if you are trying to
|
|
hack the ASE source code):
|
|
</p>
|
|
<p>
|
|
<pre>~/aseprite-src/$ sh misc/deps.sh</pre>
|
|
</p>
|
|
|
|
<a name="contact_information"></a><h1>CONTACT INFORMATION</h1>
|
|
<p>We recommend you to use the SourceForge tracker to do specific reporting of issues:</p>
|
|
<p>
|
|
<ul>
|
|
<li><a href="http://sourceforge.net/tracker/?group_id=20848&atid=120848&func=add">Bugs</a></li>
|
|
<li><a href="http://sourceforge.net/tracker/?group_id=20848&atid=370848&func=add">Request features</a></li>
|
|
<li><a href="http://sourceforge.net/tracker/?group_id=20848&atid=320848&func=add">Patches</a></li>
|
|
<li><a href="http://sourceforge.net/tracker/?group_id=20848&atid=220848&func=add">Support request</a></li>
|
|
</ul>
|
|
</p>
|
|
<p>
|
|
For more information, visit the official page of the project:
|
|
</p>
|
|
<p>
|
|
<a href="http://www.aseprite.org/">http://www.aseprite.org/</a>
|
|
</p>
|
|
|
|
<a name="license"></a><h1>LICENSE</h1>
|
|
<p>
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2 of the License, or
|
|
(at your option) any later version.
|
|
</p>
|
|
<p>
|
|
This program is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
General Public License for more details.
|
|
</p>
|
|
<p>
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the Free Software
|
|
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
|
|
USA
|
|
<p>
|
|
<a name="legal_issues"></a><h2>LEGAL ISSUES</h2>
|
|
<p>
|
|
<ul>
|
|
<li>ASE is distributed under <a href="http://www.opensource.org/licenses/gpl-2.0.php">GPL license</a>.</li>
|
|
<li>Jinete and Vaca are under <a href="http://www.opensource.org/licenses/bsd-license.php">BSD license</a>.</li>
|
|
<li>Allegro is giftware license (similar to <a href="http://www.opensource.org/licenses/mit-license.html">MIT license</a>).</li>
|
|
<li>ALFONT is under <a href="http://www.opensource.org/licenses/lgpl-2.1.php">LGPL license</a>.</li>
|
|
<li>quantize.c is copyright by Ben Davis (you need his authorization to use his code in your own program).</li>
|
|
<li>quantize2.c is distributed under the <a href="http://www.opensource.org/licenses/mit-license.html">MIT license</a></li>
|
|
<li>Lua-5.0 is distributed under the <a href="http://www.opensource.org/licenses/mit-license.html">MIT license</a></li>
|
|
<li>GIMP is distributed under <a href="http://www.opensource.org/licenses/gpl-2.0.php">GPL license</a></li>
|
|
<li>GLib and GTK+ are distributed under <a href="http://www.opensource.org/licenses/lgpl-2.1.php">LGPL license</a>.</li>
|
|
<li>GFLI-1.3 is distributed under <a href="http://www.opensource.org/licenses/gpl-2.0.php">GPL license</a>.</li>
|
|
<li>Libart 2.3.3 is distributed under <a href="http://www.opensource.org/licenses/lgpl-2.1.php">LGPL license</a>.</li>
|
|
<li>Libintl is distributed under <a href="http://www.opensource.org/licenses/lgpl-2.1.php">LGPL license</a>.</li>
|
|
<li>The FreeType Project is distributed under <a href="http://freetype.sourceforge.net/FTL.TXT">FTL license</a>.</li>
|
|
<li>zlib & Libpng are under the <a href="http://www.opensource.org/licenses/zlib-license.php">ZLIB license</a>.</li>
|
|
</ul>
|
|
</p>
|
|
|
|
<a name="authors"></a><h1>AUTHORS</h1>
|
|
<div class="author">David Capello <<a href="mailto:davidcapello@gmail.com">davidcapello@gmail.com</a>></div>
|
|
<div class="details">Programmer, designer, and maintainer.</div>
|
|
<div class="author">Ilija Melentijevic</div>
|
|
<div class="details">
|
|
New GUI skin (from ASE 0.8). A lot of good ideas for ASE 0.8.
|
|
<a href="http://ilkke.blogspot.com/">http://ilkke.blogspot.com/</a>
|
|
<a href="http://www.pixeljoint.com/p/9270.htm">http://www.pixeljoint.com/p/9270.htm</a>
|
|
</div>
|
|
<div class="author">Trent Gamblin</div>
|
|
<div class="details">Mac OS X packager.</div>
|
|
<p>
|
|
Thanks for ideas, patches, bugs report and contributions to:
|
|
</p>
|
|
<div class="ideas">
|
|
Alex Winter,
|
|
Álvaro "Kronoman X" González,
|
|
Angelo Mottola,
|
|
Ben "entheh" Davis,
|
|
Carl Olsson,
|
|
Christer Sandberg,
|
|
Clayton Enga,
|
|
David Campo,
|
|
Elias "networm" Pschernig,
|
|
Elio Cuevas Gómez,
|
|
Emmanuel "God_Cells" Rousseau,
|
|
Hernán Echegoyemberry,
|
|
Ilija "iLKke" Melentijevic,
|
|
Jon "kazzmir" Rafkind,
|
|
Jonathan Taylor,
|
|
Jorge Ramírez Flores,
|
|
Juraj Michalek,
|
|
Manuel De Miguel Moreno,
|
|
Manuel "manuq" Quiñones,
|
|
Mateusz Czaplinski,
|
|
Nathan "whitedoor" Smith,
|
|
Nora Amendez,
|
|
Peter "tjaden" Wang,
|
|
Philippe Michael Groarke,
|
|
Robert "Bob" J Ohannessian,
|
|
Scott Wilson,
|
|
Trent "trentg" Gamblin.
|
|
</div>
|
|
<a name="thankfulness"></a><h2>THANKFULNESS</h2>
|
|
<p>
|
|
Some people didn't contribute to the project in a direct way,
|
|
but their work was indispensable to make it real:
|
|
</p>
|
|
<div class="author">Álvaro González</div>
|
|
<div class="details">
|
|
For the other routine to generate
|
|
optimized palettes (used in old versions of ASE).
|
|
</div>
|
|
<div class="author">Angelo Mottola</div>
|
|
<div class="details">
|
|
For the routines to load/save JPEG files with JPGalleg
|
|
(alternative use instead of libjpeg).
|
|
</div>
|
|
<div class="author">Ben Davis</div>
|
|
<div class="details">
|
|
For his optimized palette generation routine.
|
|
</div>
|
|
<div class="author">Billy Biggs and Lauris Kaplinski</div>
|
|
<div class="details">
|
|
For the help with the alpha blending routines.
|
|
</div>
|
|
<div class="author">Csaba Biegl</div>
|
|
<div class="details">
|
|
For his ellipse routine in the GRX library (used in old versions
|
|
of ASE).
|
|
</div>
|
|
<div class="author">David Turner, Robert Wilhelm, and Werner Lemberg</div>
|
|
<div class="details">
|
|
For the FreeType project.
|
|
<a href="http://www.freetype.org/">http://www.freetype.org/</a>
|
|
</div>
|
|
<div class="author">Derek Liauw Kie Fa and Robert J Ohannessian</div>
|
|
<div class="details">
|
|
for 2xSaI.
|
|
</div>
|
|
<div class="author">DJ Delorie</div>
|
|
<div class="details">
|
|
For the DJGPP port to DOS of the GNU software.
|
|
<a href="http://www.delorie.com/djgpp/">http://www.delorie.com/djgpp/</a>
|
|
</div>
|
|
<div class="author">Elias Pschernig</div>
|
|
<div class="details">
|
|
For his excelent bresenham ellipse algorithm and to report some
|
|
nasty keyboard bugs. And his patch to load/save GIF files.
|
|
</div>
|
|
<div class="author">Elver Loho</div>
|
|
<div class="details">
|
|
For port ASE to BeOS.
|
|
</div>
|
|
<div class="author">Frank J. T. Wojcik, Guy Eric Schalnat, Andreas Dilger, Glenn
|
|
Randers-Pehrson</div>
|
|
<div class="details">
|
|
For libpng.
|
|
</div>
|
|
<div class="author">Gary Oberbrunner</div>
|
|
<div class="details">
|
|
For his code to quantize RGB images with ordered dither method.
|
|
</div>
|
|
<div class="author">Javier Gonzalez</div>
|
|
<div class="details">
|
|
For his AllegroFont wrapper.
|
|
</div>
|
|
<div class="author">Jean-loup Gailly and Mark Adler</div>
|
|
<div class="details">
|
|
For zlib
|
|
</div>
|
|
<div class="author">Jens Ch. Restemeier</div>
|
|
<div class="details">
|
|
For GFLI, his code to save FLI files is just "amazing".
|
|
</div>
|
|
<div class="author">Jerry Coffin and HenkJan Wolthuis</div>
|
|
<div class="details">
|
|
For the hash table routines.
|
|
</div>
|
|
<div class="author">Johan Halmén and Anders "Trezker" Andersson</div>
|
|
<div class="details">
|
|
for mapgen (included in old ASE versions).
|
|
<a href="http://edu.loviisa.fi/~lg/jh/mapgen/">http://edu.loviisa.fi/~lg/jh/mapgen/</a>
|
|
<a href="http://www.angelfire.com/art/dumlesoft/Projects.html">http://www.angelfire.com/art/dumlesoft/Projects.html</a>
|
|
</div>
|
|
<div class="author">Jordan Russell and Martijn Laan</div>
|
|
<div class="details">
|
|
For Inno Setup.
|
|
<a href="http://www.innosetup.com/">http://www.innosetup.com/</a>
|
|
</div>
|
|
<div class="author">Jose Luis Torres Pantoja</div>
|
|
<div class="details">
|
|
For his gift, the book "Digital Image Processing, Gonzalez and
|
|
Woods, Addison-Wesley, 2002"
|
|
</div>
|
|
<div class="author">Juraj Michalek</div>
|
|
<div class="details">
|
|
For the support to ASE in his portal.
|
|
<a href="http://games.linux.sk/">http://games.linux.sk/</a>
|
|
</div>
|
|
<div class="author">Lee Thomason</div>
|
|
<div class="details">
|
|
For tinyxml library.
|
|
<a href="http://www.sourceforge.net/projects/tinyxml">http://www.sourceforge.net/projects/tinyxml</a>
|
|
</div>
|
|
<div class="author">Matthieu Haller and Kirsten Schulz</div>
|
|
<div class="details">
|
|
For filled polygon algorithm of GD library.
|
|
<a href="http://www.libgd.org/">http://www.libgd.org/</a>
|
|
</div>
|
|
<div class="author">Matthew Leverton</div>
|
|
<div class="details">
|
|
For his Allegro portal.
|
|
<a href="http://www.allegro.cc/">http://www.allegro.cc/</a>
|
|
</div>
|
|
<div class="author">Max Maischein</div>
|
|
<div class="details">
|
|
For the documents about various file formats of the Animator and
|
|
Animator Pro.
|
|
</div>
|
|
<div class="author">Mike Haaland</div>
|
|
<div class="details">
|
|
For his documentation about the FLI/FLC, COL, PIC, and MSK files
|
|
format.
|
|
</div>
|
|
<div class="author">Paúl Andrés "Ceniza" Jiménez</div>
|
|
<div class="details">
|
|
For his help in the translation of FULL-SCREEN.txt document.
|
|
</div>
|
|
<div class="author">Peter Wang</div>
|
|
<div class="details">
|
|
For his Red Pixel II game, it was very helpful for the scripting
|
|
routines. Also for loadpng library.
|
|
<a href="http://redpixel.sourceforge.net/">http://redpixel.sourceforge.net/</a>
|
|
<a href="http://tjaden.strangesoft.net/">http://tjaden.strangesoft.net/</a>
|
|
</div>
|
|
<div class="author">Raph Levien</div>
|
|
<div class="details">
|
|
For his excelent work with the libart library.
|
|
<a href="http://www.levien.com/divbart/">http://www.levien.com/divbart/</a>
|
|
</div>
|
|
<div class="author">Richard M. Stallman</div>
|
|
<div class="details">
|
|
For the Free Software Foundation, GNU and Emacs, and everyone
|
|
who contributed with free software.
|
|
<a href="http://www.fsf.org/">http://www.fsf.org/</a>
|
|
<a href="http://www.gnu.org/">http://www.gnu.org/</a>
|
|
<a href="http://www.emacs.org/">http://www.emacs.org/</a>
|
|
</div>
|
|
<div class="author">Robert Höhne</div>
|
|
<div class="details">
|
|
For the RHIDE enviroment.
|
|
<a href="http://www.lanet.lv/~pavenis/rhide.html">http://www.lanet.lv/~pavenis/rhide.html</a>
|
|
</div>
|
|
<div class="author">Salvador Eduardo Tropea</div>
|
|
<div class="details">
|
|
For the SETEdit editor (although I don't use it anymore, the
|
|
first months in Linux without it would have been impossibles)
|
|
<a href="http://setedit.sourceforge.net/">http://setedit.sourceforge.net/</a>
|
|
</div>
|
|
<div class="author">Shawn Hargreaves</div>
|
|
<div class="details">
|
|
And hundreds of people who helped in the Allegro library.
|
|
<a href="http://alleg.sourceforge.net/">http://alleg.sourceforge.net/</a>
|
|
</div>
|
|
<div class="author">Spencer Kimball and Peter Mattis</div>
|
|
<div class="details">
|
|
And a lot of people who contributed with The GIMP and GTK+. I
|
|
personally "borrow" source code for differents task in the
|
|
program.
|
|
<a href="http://www.gimp.org/">http://www.gimp.org/</a>
|
|
<a href="http://www.gtk.org/">http://www.gtk.org/</a>
|
|
</div>
|
|
<div class="author">The Independent JPEG Group</div>
|
|
<div class="details">
|
|
For the JPEG library to load/save Jpeg files.
|
|
<a href="ftp://ftp.uu.net/graphics/jpeg/">ftp://ftp.uu.net/graphics/jpeg/</a>
|
|
</div>
|
|
<div class="author">The Open Group</div>
|
|
<div class="details">
|
|
For XFree86.
|
|
<a href="http://www.x.org/">http://www.x.org/</a>
|
|
</div>
|
|
<div class="author">Waldemar Celes, Roberto Ierusalimschy, and Luiz Henrique de Figueiredo</div>
|
|
<div class="details">
|
|
For their excelent work with Lua.
|
|
<a href="http://www.lua.org/">http://www.lua.org/</a>
|
|
</div>
|
|
|
|
<div id="footer">Copyright © 2001-2010 David Capello</div>
|
|
</div>
|
|
</body>
|
|
</html>
|
|
|