Difference between revisions of "Inkscape-dev"

From X-Moto
Jump to: navigation, search
(Required softwares)
(TODO)
 
(57 intermediate revisions by 6 users not shown)
Line 7: Line 7:
 
=Disclaimer=
 
=Disclaimer=
  
This version of Inksmoto Level Editor is not stable and not fully tested, but you can test it anyway. It requires Inkscape functionnalities available in the version 0.45 of Inkscape.
+
This version of Inksmoto Level Editor is not stable and not fully tested, but you can test it anyway.
  
Svg made with the 0.2.0 version of Inksmoto Level Editor are not compatible with this developement version of Inksmoto Level Editor.
+
=Required softwares =
 +
 
 +
The next version of Inksmoto will require Inkscape 0.46 or 0.47 This version of Inkscape no longer uses python-xml, but lxml instead. PyGtk is now needed instead of Tk. And python too (don't know the minimum required version required, but Inkscape 0.46 is packaged with python 2.5).
 +
*inkscape
 +
*python
 +
*python-lxml
 +
*python-gtk2
 +
*libglade2-0
 +
 
 +
=Installation on Linux =
 +
 
 +
==Installation of the prerequisites==
 +
 
 +
For example on a debian/ubuntu:
 +
sudo apt-get install inkscape python python-lxml python-gtk2 libglade2-0
 +
 
 +
==Using the svn==
 +
 
 +
run:
 +
sudo apt-get install subversion
 +
mkdir ~/.inkscape
 +
cd ~/.inkscape
 +
svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions
 +
 
 +
for newer versions of inkscape using xdg basedirs (e.g. Inkscape 0.47):
 +
sudo apt-get install subversion
 +
mkdir ~/.config/inkscape
 +
cd ~/.config/inkscape
 +
svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions
 +
 
 +
=Installation on Windows=
 +
 
 +
== General ==
 +
There is another way to get it too, this one illustartes the way to get it with Tortoise SVN so that you can easily update to the newest version.
 +
 
 +
== Things needed ==
 +
You need:
 +
* Microsoft Windows
 +
* Tortoise SVN (or another svn program, I like tortoise best)
 +
* patience... (not really)
 +
* Latest official Inksmoto and Inkscape installed
 +
 
 +
== Step 1. Get Tortoise SVN ==
 +
Download the installer here: [http://tortoisesvn.net/downloads Tortoise SVN] Install it.
 +
 
 +
== Step 2. Checkout ==
 +
Make sure that you remove the old inksmoto files from the extensions folder before proceeding.
 +
Go to your Inkscape installation directory and there to the share folder, for example:
 +
*"C:\Program Files\Inkscape\share\"
 +
Then Right-Click the extensions folder to see the context menu of windows, you should see the tortoise svn and a button which says: "SVN Check out...".
 +
* URL of repository: svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions/
 +
* Checkout directory: [install dir]\share\extensions
 +
Click Ok. Wait... It will download all the files needed and then you are done. Just open inkscape and voila.
 +
 
 +
== Step 3. Testing ==
 +
Open Inkscape and begin testing and developing. voila!
 +
 
 +
=Installation on Mac OS X=
 +
 
 +
There is a way to get the svn of Inksmoto for Mac OS X.
 +
 
 +
==Required software==
 +
 
 +
*Apple's Mac OS X
 +
*MacPorts
 +
*Inkscape
 +
*Subversion(MacPort's Port)
 +
 
 +
==Downloading and installing MacPorts==
 +
 
 +
Download the right version of MacPorts for your Mac OS X version.
 +
 
 +
*Mac OS X 10.4 Tiger: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.4-Tiger.dmg
 +
 
 +
*Mac OS X 10.5 Leopard: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.5-Leopard.dmg
 +
 
 +
*Mac OS X 10.6 Snow Leopard: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.6-SnowLeopard.pkg
 +
 
 +
*Mac OS X 10.7 Lion: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.7-Lion.pkg
  
=Required softwares =
+
*Mac OS X 10.8 Mountain Lion: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.8-MountainLion.pkg
 +
 
 +
==Installing Subversion==
 +
 
 +
After installing MacPorts, open up Terminal.app, and type in:
 +
 
 +
sudo port install subversion
  
* [http://www.inkscape.org/ Inkscape] (>= 0.45)
+
After its done, to make sure subversion is working, type in:  
* [http://www.python.org/ Python] (>= 2.3)
 
* Tcl/Tk (and python-tk under Linux)
 
* Inksmoto Level Editor converter and Inkscape extension from svn
 
$ svn checkout svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk svg2lvl/trunk
 
  
= Pre-requesites =
+
svn
  
They are the same that for the 0.3.0 version of Inksmoto Level Editor : http://wiki.xmoto.free.fr/index.php?title=Inkscape-0.3.0#Pre-requesites
+
Your terminal window should look like this, if it works properly:
  
= TODO =
+
DarkSeph22:~ WeatherGameMan97$ svn
 +
Type 'svn help' for usage.
  
* use Tkinter to have extension windows populated with values from the svg. DONE
+
==Getting the svn of Inksmoto==
* support for xmoto 0.2.5 new functionnalities (rotated sprite, sky properties, level border, reversed sprites, ...) DONE
 
* add check boxes to extension windows, parameters are changed only if checkbox is set (example: when you convert blocks to background blocks, you can choose if you want to update the blocks texture). DONE
 
* a block can have two edge texture now (one on the upper side and one on the down side). DONE
 
* allow xmoto to update texture and sprite informations from the xmoto website. DONE
 
* web site php script which update the xml file when themes are updated. DONE
 
* create a pack with inkscape 0.45, tcl/tk and svg2lvl for Windows (easy installation). TODO
 
  
* allow inkscape to open .lvl files. IN PROGRESS (postpone to next version)
+
Type in the URL repository, then the full path of where you want the files to go, like this:
* show xmoto textures in Inkscape. DONE (postpone to next version)
 
* show xmoto sprites in Inkscape. IN PROGRESS (postpone to next version)
 
* create an automatic installation for Unix and Windows. TODO (postpone to next version)
 
  
= Screenshoot =
+
svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions /Users/your username/Applications/Inkscape.app/Contents/Resources/extensions
  
The new window which allows to update xmoto menu from Internet.
+
Once its all done, open up Inkscape and begin testing.
[[Image:Udpate.png]]
 
  
The Tk window which allow to put the sky properties. Sky properties are stored in the svg (in the metadata). It's a Tk window so that it can be populated with values from the svg.
+
=Inksmoto-dev Bug Tracker=
[[Image:Sky.png]]
 
  
The Tk window for the level properties. Level properties are also stored in the svg.
+
You can see the progress of the developement in the bug tracker:
[[Image:Level.png]]
+
[http://todo.xmoto.tuxfamily.org/index.php?project=2 Inksmoto-dev Bug Tracker]

Latest revision as of 17:03, 11 June 2013

Català - Español


Documentation for the developpement version of Inksmoto Level Editor


Disclaimer

This version of Inksmoto Level Editor is not stable and not fully tested, but you can test it anyway.

Required softwares

The next version of Inksmoto will require Inkscape 0.46 or 0.47 This version of Inkscape no longer uses python-xml, but lxml instead. PyGtk is now needed instead of Tk. And python too (don't know the minimum required version required, but Inkscape 0.46 is packaged with python 2.5).

  • inkscape
  • python
  • python-lxml
  • python-gtk2
  • libglade2-0

Installation on Linux

Installation of the prerequisites

For example on a debian/ubuntu:

sudo apt-get install inkscape python python-lxml python-gtk2 libglade2-0

Using the svn

run:

sudo apt-get install subversion
mkdir ~/.inkscape
cd ~/.inkscape
svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions

for newer versions of inkscape using xdg basedirs (e.g. Inkscape 0.47):

sudo apt-get install subversion
mkdir ~/.config/inkscape
cd ~/.config/inkscape
svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions

Installation on Windows

General

There is another way to get it too, this one illustartes the way to get it with Tortoise SVN so that you can easily update to the newest version.

Things needed

You need:

  • Microsoft Windows
  • Tortoise SVN (or another svn program, I like tortoise best)
  • patience... (not really)
  • Latest official Inksmoto and Inkscape installed

Step 1. Get Tortoise SVN

Download the installer here: Tortoise SVN Install it.

Step 2. Checkout

Make sure that you remove the old inksmoto files from the extensions folder before proceeding. Go to your Inkscape installation directory and there to the share folder, for example:

  • "C:\Program Files\Inkscape\share\"

Then Right-Click the extensions folder to see the context menu of windows, you should see the tortoise svn and a button which says: "SVN Check out...".

Click Ok. Wait... It will download all the files needed and then you are done. Just open inkscape and voila.

Step 3. Testing

Open Inkscape and begin testing and developing. voila!

Installation on Mac OS X

There is a way to get the svn of Inksmoto for Mac OS X.

Required software

  • Apple's Mac OS X
  • MacPorts
  • Inkscape
  • Subversion(MacPort's Port)

Downloading and installing MacPorts

Download the right version of MacPorts for your Mac OS X version.

Installing Subversion

After installing MacPorts, open up Terminal.app, and type in:

sudo port install subversion

After its done, to make sure subversion is working, type in:

svn

Your terminal window should look like this, if it works properly:

DarkSeph22:~ WeatherGameMan97$ svn
Type 'svn help' for usage.

Getting the svn of Inksmoto

Type in the URL repository, then the full path of where you want the files to go, like this:

svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions /Users/your username/Applications/Inkscape.app/Contents/Resources/extensions

Once its all done, open up Inkscape and begin testing.

Inksmoto-dev Bug Tracker

You can see the progress of the developement in the bug tracker: Inksmoto-dev Bug Tracker