Extension repository

2008-02-26T16:27:01Z

RichardHenwood:

It would be very useful to have a central Internet repository for Inkscape extensions, similarly as Firefox has. This way, Inkscape could update installed extensions from the web site, with no need for the user to know if an extension is updated.

What extensions are there? We can start listing them here:
* [http://www.ekips.org/comp/inkscape/ Inkscape Effects] - Aaron Spikes set of extensions is now included in Inkscape.
* [http://www.colibre.com.br/bin/view/Aurium/InkscapeCalendarShellScript InkscapeCalendarShellScript] - Create Calendars sucks or is impracticable if you do not have something that automatizes the process of to put the days organized in blocks of months to you. To format manually is easy, but this extension can help you on this too [Bash script, works for win32 with cygwin].
* [http://www.colibre.com.br/bin/view/Aurium/InkscapeAreaCuter InkscapeAreaCutter] - For Webdesigners, layout for sites, slice area into .png images. util! (pt_BR)
* [http://julvitard.free.fr/eqtexsvg/ EQTeXSVG] - EQTeXSVG is an extension for Inkscape used to convert an inline LATEX equation into SVG path using Python.
* [http://www.kono.cis.iwate-u.ac.jp/~arakit/inkscape/inklatex.html InkLaTeX] Insert LaTeX text or equations into Inkscape.
* [http://www.iki.fi/pav/software/textext/ TexText] Embed re-editable LaTeX objects in SVG drawings.
* [http://math.univ-lille1.fr/~barraud/Inkscape/pathdeform/ PathDeform] - Here is an Inkscape extension whose purpose is to bend a path according to another one. Note: it was added to Inkscape 0.45 as "Pattern along Path".
* [http://www.inkbar.lineaire.net/ InkBar] - This is an Inkscape extension whose purpose is to draw EAN13 bar code.
* [http://technoargia.free.fr/swftools/ SWF output] - A little extension to save as Swf from Inkscape.
* [http://www.colivre.coop.br/bin/view/Aurium/Puff Puff] - Fluffs elements! :-D
* [http://www.colivre.coop.br/bin/view/Aurium/InkSudoku Sudoku Generator] - Generates Sudoku square with the solution ''(in a small square if you want)''.
* [[CalligraphedOutlineFill]] - helps to fill in the inside area of shapes drawn with the Calligraphy tool
* [http://edlab.die.unipd.it/Site4.html SlotStar] - helps to draw the star of slot of a winding of an electrical machine
* [http://richard.henwood.googlepages.com/inkscapelatexextension inkscapeLatexExtension] - Extract text in an inkscape drawing to a latex picture environment.

== For Programers: ==

* [http://www.colivre.coop.br/bin/view/Aurium/RubyInk RubyInk] - Inkscape extension with Ruby
* [http://www.colivre.coop.br/bin/view/Aurium/InkBash Ink-Bash] - <nowiki>ShellScript</nowiki> Forever!
* [http://www.colivre.coop.br/bin/view/Aurium/InkMoz InkMoz] - the Bridge from Inkscape to Mozilla (Inkscape extension with Javascript and more)

[[Category:Developer Documentation]]
[[Category:Extensions]]

Using Eclipse

2008-02-01T10:00:54Z

RichardHenwood: /* Building */ for linux users

Eclipse is a popular development tool used primarily with Java; however, with the CDT plugin, C/C++ development can also be done. This page will help you set up Eclipse for coding, building, and debugging Inkscape.

= Eclipse on Windows =

Running Eclipse provides a relatively easy and familiar way to work with Inkscape code on Windows. This section will explain how to make it happen.

'''Note:''' Some of these instructions may be applicable to development on Mac or Linux. Feel free to refactor them if you are adding information for those platforms.

== Initial Setup ==

First, if you don't have Eclipse, [http://www.eclipse.org/downloads/ get it]. Check out the [http://help.eclipse.org/help32/index.jsp online help] if needed.

Next, you need to set up the necessary add-ons. Most important is the [http://www.eclipse.org/cdt/downloads.php CDT plug-in] which facilitates C/C++ development. You may also wish to add [http://subclipse.tigris.org/install.html Subclipse] for SVN access within Eclipse. Alternatively, many Windows users prefer to use [http://tortoisesvn.net/downloads TortoiseSVN], which works with Windows Explorer.

Finally, follow the instructions on the [[Win32Port]] page under the heading '''Inkscape under Windows'''.

== Creating a Project ==

=== Subclipse ===

The next step is to get the source code ready for use in Eclipse. Check [[WorkingWithSVN | here]] for general instructions for working with SVN; in this section, the aim is to show how to check out the code using Subclipse.

In Eclipse, we want the SVN perspective to be open. Click '''Window > Open Perspective > Other'''. Choose '''SVN Repository Exploring''' and click ok.

[[Image:Eclipse-01.png]]

In the '''SVN Repository''' tab, right click and choose '''New > Repository Location...'''.

[[Image:Eclipse-02.png]]

In the '''Location Url:''' box, paste the link https://inkscape.svn.sourceforge.net/svnroot/inkscape/inkscape/trunk and click finish. This location will now show in the '''SVN Repository''' tab. You can expand the tree to see what is on the server.

Now right click the location name (which is really just the link given above), and click '''Checkout...'''. Choose '''Check out as a project configured using the New Project Wizard''' and the revision you want (probably Head), and click '''Finish'''.

In the New Project window that appears, choose '''C++ Project''' in Eclipse Europa (or in Callisto '''Standard Make C++ Project''') and click '''Next'''.

[[Image:Eclipse-Europa-ProjectType.png]]

Give your project a name such as InkscapeSVN. Uncheck the '''Use default location''' box so you can provide a better project location outside of your workspace, such as C:\InkscapeSVN. Select '''Executable (XL C/C++)''' as the project type, and '''XL C/C++ Tool Chain''' as the the Toolchain (this will not be necessary in Callisto (or before?) as this has been already been specified by selecting '''Standard Make C++ Project'''). Click '''Finish'''.

[[Image:Eclipse-Europa-CppProjectType.png]]

The source code will now be checked out - this may take a while. You will also now have a project in the '''C/C++ Perspective''' with whatever name you provided earlier.

=== TortoiseSVN ===

To use TortoiseSVN instead of Subclipse to check out your project, open a Windows Explorer instance. Right click anywhere outside of an existing SVN tree and choose '''SVN Checkout...'''. Specify the link given above and the destination directory.

To get a project in Eclipse, go to the '''C/C++ Perspective'''.

In Eclipse Europa select '''File > New > C++ Project'''. Choose a project type of '''Executable (XL C/C++)'''.

In Eclipse Calisto right click in the '''C/C++ Projects''' tab, and choose '''New > Project...''' and in the window choose '''Standard Make C++ Project.'''

Give the project a name, and uncheck the '''Use default location''' box. You must give the location that you checked the code out into here.

At this point, you will be able to use TortoiseSVN or Subclipse within Eclipse to control the source.

== Building ==

'''NOTE FOR LINUX USERS''' For building, you can probably get away with running './autogen.sh' then './configure' from the directory containing your copy of the repository. You can then create a 'Builder' which contains Makefile as Main-Location.

Be sure you have the btool built and ready to go, as outlined on the [[Win32Port]] page. You can build Inkscape from the command line or initiate it from within Eclipse, which will capture the output for you.

To set up Eclipse to do this, make sure you are in the '''C/C++ Perspective''' and that your project is open. Right click on the project name and click '''Properties'''. Click on '''Builders'''. Uncheck any builders that are there since we will be using the custom btool. Click '''New...''' and select '''Program'''.

[[Image:Eclipse-04.png]]

In the '''Main''' tab, browse the workspace for the location of the btool.exe file. Browse the workspace again to set the working directory to the main project directory.

[[Image:Eclipse-05.png]]

Now go to the '''Environment Tab''' and add a new variable called path. Add the same thing that appears in your mingenv.bat file here.

[[Image:Eclipse-06.png]]

[[Image:Eclipse-07.png]]

Click on '''C/C++ Project Paths''' and then the tab '''Path Containers'''. Click '''Add...''', choose '''Discovered scanner configuration container''', '''Next''', '''Discovered Paths''', and '''Finish'''.

Now go to '''C/C++ Include Paths and Symbols'''. Click '''Add Contributed''' and choose the '''Discovered scanner configuration container''', then '''Discovered Paths'''. Then click '''Add External Include Path''' and add the path to your GTK folder (probably something like c:\gtk210).

[[Image:Eclipse-08.png]]

You should now be able to use the '''Project > Build All''' command, capturing the output onto Eclipse's console.

== Debugging ==

You need to make a couple of changes to the build.xml file and do a clean rebuild. First, add -g to the flags section:

<flags>
-Wall -O3
-mms-bitfields
'''-g'''
</flags>

Then avoid stripping symbol information from the exe by changing this line
strip="'''true'''" symfile="${build}/inkscape.dbg"
with this one
strip="'''false'''" symfile="${build}/inkscape.dbg"

Now you need to create a debugging instance in Eclipse. Click '''Run > Debug...'''. Click on '''C/C++ Local Application''' and then click the new button. Give the launch configuration a logical name such as Inkscape Debug.

These screenshots show you the values you have to change in each tab. Nothing else needs to change.

[[Image:Eclipse-09.png]]

[[Image:Eclipse-10.png]]

Now you can launch this new configuration and debug away!

(Don't worry about funny warnings about files or folders not existing - it doesn't seem to affect the use of the debugger. However, if you know how to fix it, please replace this comment with instructions.)

[[Category:Developer Documentation]]

Inkscape Wiki - User contributions [en]

Extension repository

Using Eclipse