Inkscape Wiki - User contributions [en]

CheatSheetForConvertingto2geom

2008-12-30T23:33:50Z

Verbalshadow: add replacement python script

=Cheat Sheet For Converting to 2geom=

If you are just starting I suggest you pick a header file and convert just one function at a time. That will give you a feel for the process as you get more comfortable do more at one time.

==Lets talk about emptiness.==
In Inkscape and in 2geom there are two types of emptiness for rectangles.

Rectangles with no coordinates.
Rectangles with zero area.

What is the difference?

A Rect that has the coordinates of (1,2) - (2,6) contains points and has a non-zero area.
A Rect that has the coordinates of (0,0) - (0,0) contains one point but has zero area.
A Rect that has the coordinates of (0,0) - (10,0) contains points but has zero area.
A Geom::OptRect that has not been defined with coordinates has neither points or area.

If you need to define a rectangle, but are not sure whether it is always a valid rectangle, please use Geom::OptRect. It means "Optional Rect". A bounding box of a path could be an "invalid" rectangle for example, when the path has no fill or stroke.

optrect.isEmpty() checks if optrect contains a valid rectangle NOT if the rect has zero area. rect.hasZeroArea() does that.

==Items That you Can Switch NR:: for Geom::==

* <code>NR::Matrix</code>
* <code>NR::Rect</code>
* <code>NR::Dim2</code>
* <code>NR::L2</code>
* <code>NR::Y</code>
* <code>NR::X</code>
* <code>NR::identity</code>
* <code>NR::Coord</code>

==Things that need small adjustments or complete replacement==

{| class="prettytable" border="1"
| '''Error looks like'''
| '''NR Function or Code'''
| '''2geom Replacement'''

|-
|
| <code>NR::scale</code>
| <code>Geom::Scale</code> (note the capital letter S)

|-
|
| <code>NR::translate</code>
| <code>Geom::Translate</code> (capital)

|-
|
| <code>nrrect.extent(NR::X)</code>
| <code><nowiki>geomrect.dimensions()[Geom::X]</nowiki></code> '''OR'''

<code><nowiki>geomRect[X].extent()</nowiki></code>

|-
|
| <code>height = r->extent(NR::Y);</code>
| <code><nowiki>height = r->dimensions()[Geom::Y];</nowiki></code>

|-
|
| <code>NR::expansion(nrmatrix)</code>
| <code>geommatrix.descrim()</code>

|-
| desktop.cpp:754: error: 'expand' is not a member of 'Geom'
| <code>NR::Rect const viewbox = NR::expand(canvas->getViewbox(), border);</code>

| <code>Geom::Rect viewbox = canvas->getViewbox();</code>
<code>viewbox.expandBy(border);</code>

|-
| desktop.cpp:162: error: 'class Geom::Matrix' has no member named 'set_identity'
| <code>Mymatrix = set_identity (Nrmatrix)</code>
| <code>identity(Nrmatrix)</code> '''OR'''

<code>matrix.setIdentity()</code>

|-
| desktop.cpp: In member function 'bool SPDesktop::isWithinViewport(SPItem*) const':

desktop.cpp:532: error: conversion from

<nowiki>'boost::optional<NR::Rect>' to non-scalar type </nowiki>

<nowiki>'boost::optional<Geom::D2<Geom::Interval> >' requested</nowiki>
| <code><nowiki>boost::optional<NR::Rect></nowiki></code>
| <code><nowiki>Geom::OptRect</nowiki></code>

|-
| <nowiki>desktop.cpp:1004: error: no matching function for call to 'Geom::D2<Geom::Interval>::isEmpty(double)' ./2geom/rect.h:105: note: candidates are: bool Geom::D2<Geom::Interval>::isEmpty() const </nowiki>
| <pre><nowiki>if ( !d || d->isEmpty(0.1) ) {
return;
}
</nowiki></pre>

| <pre><nowiki> if ( !d
|| d->width() < 0.1
|| d->height() < 0.1)
{
return;
}</pre>

|-
| display/nr-arena-item.cpp:734: error: ‘const class Geom::Matrix’ has no member named ‘test_identity’
| <code>NR::matrix.test_identity()</code>
| <code>local.isIdentity()</code>

|-
| <nowiki>selection-chemistry.cpp:1424: error: no match for ‘operator[]’ in ‘center[X]’</nowiki>

<nowiki>center is a boost::optional<Geom::Point> </nowiki>
|
| you're missing the *

|-
| <code>Geom::Rotate</code> doesn't seem have a operator/ what is the trick for turning division in to multiplication, again
| <code>r1/r2</code>
| <code>r1 * r2.inverse()</code>

|-
|
| <code>NR::Rect</code>'s can be changed to <code>Geom::Rect</code> But it is better not to do this.
| <code>geomrect = to_2geom(nrrect)</code>

|-
|
| <code>NR::union_bounds()</code>
| <code>Geom::unify()</code>

|-
| sp-item.cpp:814: error: ‘expansionX’ is not a member of ‘Geom’
| <code>dy0 *= NR::expansionY(i2d);</code>
<code>dx0 *= NR::expansionX(i2d);</code>
| <code>dy0 *= i2d.expansionY();</code>
<code>dx0 *= i2d.expansionX();</code>
|-
| sp-item.cpp:1447: error: ‘const class Geom::Matrix’ has no member named ‘is_translation’

| <code>!(!transform.is_translation() && SP_OBJECT_STYLE(item) && SP_OBJECT_STYLE(item)->getFilter())</code>
| <code>!(!transform.isTranslation() && SP_OBJECT_STYLE(item) && SP_OBJECT_STYLE(item)->getFilter())</code>

|-
| text-context.cpp:1610: error: no matching function for call to ‘to_2geom(boost::optional<Geom::D2<Geom::Interval> >)’

| <code><nowiki>boost::optional<Geom::Rect> frame_bbox = to_2geom(sp_item_bbox_desktop(frame));</nowiki></code>
| <code><nowiki>boost::optional<Geom::Rect> frame_bbox = sp_item_bbox_desktop(frame);</nowiki></code>

|}

== Conversion of rectangles (NR::Rect, NRRect, Geom::Rect, Geom::OptRect) ==
sorry for the very brief text here. feel free to improve it and add things. ask in the jabber channel if you have difficulties.

Most of the conversions of NR::Rect and NRRect to 2Geom needs careful thought.

2Geom makes a very important distinction between rectangles and optional rectangles. Libnr is most vague about this, so you often have to find out how a certain rectangle is used: whether it always contains valid data, or whether it can contain wrong data. For example, an NRRect that is defined as (a,b)-(a,b) often means it is an "invalid" rectangle, i.e. the data is invalid and the rectangle coordinates should not be trusted. In this case NRRect::upgrade() returns an empty boost::optional<NR::Rect>. So probably, an NRRect should be replaced with Geom::OptRect. A what? OptRect. Optional Rectangle. This means 2geom knows the data in it can not always be trusted. So when one unifies an OptRect with another OptRect, 2geom checks first whether the coordinates in both can be trusted. An Geom::Rect is always considered as a valid rectangle:

Geom::Rect rect1; // will probably be initialized as (0,0)-(0,0), but don't use this! (deprecated)
Geom::Rect rect2(Geom::Point(1,1), Geom::Point(1,1); // creates (1,1)-(1,1) rect :-)
Geom::OptRect rect3; // creates rectangle with no coordinates
Geom::OptRect rect4(Geom::Rect((Geom::Point(1,2), Geom::Point(3,4)); // creates optional rectangle with defined coordinates.
Geom::Rect rect3b = *rect3; // this will crash, because rect3 does not contain a rect
//correct usage is:
if (rect4) {
Geom::Rect rect4b = *rect4; // rect4b = (1,2)-(3,4)
}

Note that geomrect.isEmpty() does not exist as this name is ambiguous. geomrect.hasZeroArea() does exist, and geomoptrect.isEmpty() too.

In summary, it is safest to do the following, but please think carefully about your decision

NRRect ==> Geom::OptRect 
NR::Rect ==> Geom::OptRect

If you are certain that the NR::Rect always contains valid coordinates, replace it with Geom::Rect.

== Simple One for One Multi-Replacement in a Single Pass Python Script ==

http://inkscape.pastebin.com/f53b7e2ae

CheatSheetForConvertingto2geom

2008-10-18T05:19:29Z

Verbalshadow: correction

CheatSheetForConvertingto2geom

2008-10-18T05:06:36Z

Verbalshadow: add comments about types of empties and isEmpty

CheatSheetForConvertingto2geom

2008-10-03T21:19:09Z

Verbalshadow: add error

'''Cheat Sheet For Converting to 2geom'''

If you are just starting I suggest you pick a header file and convert just one function at a time. That will give you a feel for the process as you get more comfortable do more at one time.

'''ItemsThat you Can Switch NR:: for Geom::'''

{| class="prettytable" border="1"
| NR::Point

|-
| NR::Matrix

|-
| NR::Rect

|-
| NR::Dim2

|-
| NR::L2

|-
| NR::Y

|-
| NR::X

|-
| NR::identify

|-
| NR::Coord

|}
'''Things that need small adjustments or Complete replacement'''

{| class="prettytable" border="1"
| '''Error looks like'''
| '''NR Function or Code'''
| '''2geom Replacement'''

|-
|
| NR::scale
| Geom::Scale (note the capital letter S)

|-
|
| NR::translate
| Geom::Translate (capital)

|-
|
| nrrect.extent(NR::X)
| <nowiki>geomrect.dimensions()[Geom::X] </nowiki>'''OR'''

<nowiki>geomRect[X].extent()</nowiki>

|-
|
| height= r->extent(NR::Y);
| <nowiki>height= r->dimensions()[Geom::Y];</nowiki>

|-
|
| NR::expansion(nrmatrix)
| geommatrix.descrim()

|-
| desktop.cpp:754: error: 'expand' is not a member of 'Geom'
| NR::Rect const viewbox = NR::expand(canvas->getViewbox(), border);

| Geom::Rect viewbox = canvas->getViewbox();

viewbox.expandBy(border);

|-
| desktop.cpp:162: error: 'class Geom::Matrix' has no member named 'set_identity'
| Mymatrix = set_identity (Nrmatrix)
| identity(Nrmatrix) '''OR'''

matrix.setIdentity()

|-
| desktop.cpp: In member function 'bool SPDesktop::isWithinViewport(SPItem*) const':

desktop.cpp:532: error: conversion from

<nowiki>'boost::optional<NR::Rect>' to non-scalar type </nowiki>

<nowiki>'boost::optional<Geom::D2<Geom::Interval> >' requested</nowiki>
| <nowiki>boost::optional<NR::Rect></nowiki>
| <nowiki>boost::optional<Geom::Rect></nowiki>

|-
| <nowiki>desktop.cpp:1004: error: no matching function for call to 'Geom::D2<Geom::Interval>::isEmpty(double)' ./2geom/rect.h:105: note: candidates are: bool Geom::D2<Geom::Interval>::isEmpty() const </nowiki>
| <nowiki>if ( !d || d->isEmpty(0.1) ) {

return;

}
</nowiki>

| if ( !d

<nowiki>|| d->width() < 0.1</nowiki>

<nowiki>|| d->height() < 0.1</nowiki>

)

{

return;

}

|-
| display/nr-arena-item.cpp:734: error: ‘const class Geom::Matrix’ has no member named ‘test_identity’
| NR::

matrix.test_identity()
| local.isIdentity()

|-
| <nowiki>selection-chemistry.cpp:1424: error: no match for ‘operator[]’ in ‘center[X]’</nowiki>

<nowiki>center is a boost::optional<Geom::Point> </nowiki>
|
| you're missing the *

|-
| Geom::Rotate doesn't seem have a operator/ what is the trick for turning division in to multiplication, again
| r1/r2
| r1 * r2.inverse()

|-
|
| NR::Rect's can be changed to Geom::Rect But it is better not to do this.
| geomrect = to_2geom(nrrect)

|-
|
| NR::union_bounds()
| Geom::unify()

|-
| sp-item.cpp:814: error: ‘expansionX’ is not a member of ‘Geom’
| dy0 *= NR::expansionY(i2d);
dx0 *= NR::expansionX(i2d);
| dy0 *= i2d.expansionY();
dx0 *= i2d.expansionX();

|-
| sp-item.cpp:1447: error: ‘const class Geom::Matrix’ has no member named ‘is_translation’

| !(!transform.is_translation() && SP_OBJECT_STYLE(item) && SP_OBJECT_STYLE(item)->getFilter())
| !(!transform.isTranslation() && SP_OBJECT_STYLE(item) && SP_OBJECT_STYLE(item)->getFilter())

|-
| text-context.cpp:1610: error: no matching function for call to ‘to_2geom(boost::optional<Geom::D2<Geom::Interval> >)’

| boost::optional<Geom::Rect> frame_bbox = to_2geom(sp_item_bbox_desktop(frame));
| boost::optional<Geom::Rect> frame_bbox = sp_item_bbox_desktop(frame);

|}

CheatSheetForConvertingto2geom

2008-10-01T05:20:34Z

Verbalshadow: Add to_2geom error

'''Cheat Sheet For Converting to 2geom'''

If you are just starting I suggest you pick a header file and convert just one function at a time. That will give you a feel for the process as you get more comfortable do more at one time.

'''ItemsThat you Can Switch NR:: for Geom::'''

{| class="prettytable" border="1"
| NR::Point

|-
| NR::Matrix

|-
| NR::Rect

|-
| NR::Dim2

|-
| NR::L2

|-
| NR::Y

|-
| NR::X

|-
| NR::identify

|-
| NR::Coord

|}
'''Things that need small adjustments or Complete replacement'''

{| class="prettytable" border="1"
| '''Error looks like'''
| '''NR Function or Code'''
| '''2geom Replacement'''

|-
|
| NR::scale
| Geom::Scale (note the capital letter S)

|-
|
| NR::translate
| Geom::Translate (capital)

|-
|
| nrrect.extent(NR::X)
| <nowiki>geomrect.dimensions()[Geom::X] </nowiki>'''OR'''

<nowiki>geomRect[X].extent()</nowiki>

|-
|
| height= r->extent(NR::Y);
| <nowiki>height= r->dimensions()[Geom::Y];</nowiki>

|-
|
| NR::expansion(nrmatrix)
| geommatrix.descrim()

|-
| desktop.cpp:754: error: 'expand' is not a member of 'Geom'
| NR::Rect const viewbox = NR::expand(canvas->getViewbox(), border);

| Geom::Rect viewbox = canvas->getViewbox();

viewbox.expandBy(border);

|-
| desktop.cpp:162: error: 'class Geom::Matrix' has no member named 'set_identity'
| Mymatrix = set_identity (Nrmatrix)
| identity(Nrmatrix) '''OR'''

matrix.setIdentity()

|-
| desktop.cpp: In member function 'bool SPDesktop::isWithinViewport(SPItem*) const':

desktop.cpp:532: error: conversion from

<nowiki>'boost::optional<NR::Rect>' to non-scalar type </nowiki>

<nowiki>'boost::optional<Geom::D2<Geom::Interval> >' requested</nowiki>
| <nowiki>boost::optional<NR::Rect></nowiki>
| <nowiki>boost::optional<Geom::Rect></nowiki>

|-
| <nowiki>desktop.cpp:1004: error: no matching function for call to 'Geom::D2<Geom::Interval>::isEmpty(double)' ./2geom/rect.h:105: note: candidates are: bool Geom::D2<Geom::Interval>::isEmpty() const </nowiki>
| <nowiki>if ( !d || d->isEmpty(0.1) ) {

return;

}
</nowiki>

| if ( !d

<nowiki>|| d->width() < 0.1</nowiki>

<nowiki>|| d->height() < 0.1</nowiki>

)

{

return;

}

|-
|
| NR::

matrix.test_identity()
| local.isIdentity()

|-
| <nowiki>selection-chemistry.cpp:1424: error: no match for ‘operator[]’ in ‘center[X]’</nowiki>

<nowiki>center is a boost::optional<Geom::Point> </nowiki>
|
| you're missing the *

|-
| Geom::Rotate doesn't seem have a operator/ what is the trick for turning division in to multiplication, again
| r1/r2
| r1 * r2.inverse()

|-
|
| NR::Rect's can be changed to Geom::Rect But it is better not to do this.
| geomrect = to_2geom(nrrect)

|-
|
| NR::union_bounds()
| Geom::unify()

|-
| sp-item.cpp:814: error: ‘expansionX’ is not a member of ‘Geom’
| dy0 *= NR::expansionY(i2d);
dx0 *= NR::expansionX(i2d);
| dy0 *= i2d.expansionY();
dx0 *= i2d.expansionX();

|-
| sp-item.cpp:1447: error: ‘const class Geom::Matrix’ has no member named ‘is_translation’

| !(!transform.is_translation() && SP_OBJECT_STYLE(item) && SP_OBJECT_STYLE(item)->getFilter())
| !(!transform.isTranslation() && SP_OBJECT_STYLE(item) && SP_OBJECT_STYLE(item)->getFilter())

|-
| text-context.cpp:1610: error: no matching function for call to ‘to_2geom(boost::optional<Geom::D2<Geom::Interval> >)’

| boost::optional<Geom::Rect> frame_bbox = to_2geom(sp_item_bbox_desktop(frame));
| boost::optional<Geom::Rect> frame_bbox = sp_item_bbox_desktop(frame);

|}

CheatSheetForConvertingto2geom

2008-10-01T00:09:48Z

Verbalshadow: Add is isTranslation()

'''Cheat Sheet For Converting to 2geom'''

If you are just starting I suggest you pick a header file and convert just one function at a time. That will give you a feel for the process as you get more comfortable do more at one time.

'''ItemsThat you Can Switch NR:: for Geom::'''

{| class="prettytable" border="1"
| NR::Point

|-
| NR::Matrix

|-
| NR::Rect

|-
| NR::Dim2

|-
| NR::L2

|-
| NR::Y

|-
| NR::X

|-
| NR::identify

|-
| NR::Coord

|}
'''Things that need small adjustments or Complete replacement'''

{| class="prettytable" border="1"
| '''Error looks like'''
| '''NR Function or Code'''
| '''2geom Replacement'''

|-
|
| NR::scale
| Geom::Scale (note the capital letter S)

|-
|
| NR::translate
| Geom::Translate (capital)

|-
|
| nrrect.extent(NR::X)
| <nowiki>geomrect.dimensions()[Geom::X] </nowiki>'''OR'''

<nowiki>geomRect[X].extent()</nowiki>

|-
|
| height= r->extent(NR::Y);
| <nowiki>height= r->dimensions()[Geom::Y];</nowiki>

|-
|
| NR::expansion(nrmatrix)
| geommatrix.descrim()

|-
| desktop.cpp:754: error: 'expand' is not a member of 'Geom'
| NR::Rect const viewbox = NR::expand(canvas->getViewbox(), border);

| Geom::Rect viewbox = canvas->getViewbox();

viewbox.expandBy(border);

|-
| desktop.cpp:162: error: 'class Geom::Matrix' has no member named 'set_identity'
| Mymatrix = set_identity (Nrmatrix)
| identity(Nrmatrix) '''OR'''

matrix.setIdentity()

|-
| desktop.cpp: In member function 'bool SPDesktop::isWithinViewport(SPItem*) const':

desktop.cpp:532: error: conversion from

<nowiki>'boost::optional<NR::Rect>' to non-scalar type </nowiki>

<nowiki>'boost::optional<Geom::D2<Geom::Interval> >' requested</nowiki>
| <nowiki>boost::optional<NR::Rect></nowiki>
| <nowiki>boost::optional<Geom::Rect></nowiki>

|-
| <nowiki>desktop.cpp:1004: error: no matching function for call to 'Geom::D2<Geom::Interval>::isEmpty(double)' ./2geom/rect.h:105: note: candidates are: bool Geom::D2<Geom::Interval>::isEmpty() const </nowiki>
| <nowiki>if ( !d || d->isEmpty(0.1) ) {

return;

}
</nowiki>

| if ( !d

<nowiki>|| d->width() < 0.1</nowiki>

<nowiki>|| d->height() < 0.1</nowiki>

)

{

return;

}

|-
|
| NR::

matrix.test_identity()
| local.isIdentity()

|-
| <nowiki>selection-chemistry.cpp:1424: error: no match for ‘operator[]’ in ‘center[X]’</nowiki>

<nowiki>center is a boost::optional<Geom::Point> </nowiki>
|
| you're missing the *

|-
| Geom::Rotate doesn't seem have a operator/ what is the trick for turning division in to multiplication, again
| r1/r2
| r1 * r2.inverse()

|-
|
| NR::Rect's can be changed to Geom::Rect But it is better not to do this.
| geomrect = to_2geom(nrrect)

|-
|
| NR::union_bounds()
| Geom::unify()

|-
| sp-item.cpp:814: error: ‘expansionX’ is not a member of ‘Geom’
| dy0 *= NR::expansionY(i2d);
dx0 *= NR::expansionX(i2d);
| dy0 *= i2d.expansionY();
dx0 *= i2d.expansionX();

|-
| sp-item.cpp:1447: error: ‘const class Geom::Matrix’ has no member named ‘is_translation’

| !(!transform.is_translation() && SP_OBJECT_STYLE(item) && SP_OBJECT_STYLE(item)->getFilter())
| !(!transform.isTranslation() && SP_OBJECT_STYLE(item) && SP_OBJECT_STYLE(item)->getFilter())

|}

CheatSheetForConvertingto2geom

2008-09-30T23:58:06Z

Verbalshadow: fix namespace error

'''Cheat Sheet For Converting to 2geom'''

If you are just starting I suggest you pick a header file and convert just one function at a time. That will give you a feel for the process as you get more comfortable do more at one time.

'''ItemsThat you Can Switch NR:: for Geom::'''

{| class="prettytable" border="1"
| NR::Point

|-
| NR::Matrix

|-
| NR::Rect

|-
| NR::Dim2

|-
| NR::L2

|-
| NR::Y

|-
| NR::X

|-
| NR::identify

|-
| NR::Coord

|}
'''Things that need small adjustments or Complete replacement'''

{| class="prettytable" border="1"
| '''Error looks like'''
| '''NR Function or Code'''
| '''2geom Replacement'''

|-
|
| NR::scale
| Geom::Scale (note the capital letter S)

|-
|
| NR::translate
| Geom::Translate (capital)

|-
|
| nrrect.extent(NR::X)
| <nowiki>geomrect.dimensions()[Geom::X] </nowiki>'''OR'''

<nowiki>geomRect[X].extent()</nowiki>

|-
|
| height= r->extent(NR::Y);
| <nowiki>height= r->dimensions()[Geom::Y];</nowiki>

|-
|
| NR::expansion(nrmatrix)
| geommatrix.descrim()

|-
| desktop.cpp:754: error: 'expand' is not a member of 'Geom'
| NR::Rect const viewbox = NR::expand(canvas->getViewbox(), border);

| Geom::Rect viewbox = canvas->getViewbox();

viewbox.expandBy(border);

|-
| desktop.cpp:162: error: 'class Geom::Matrix' has no member named 'set_identity'
| Mymatrix = set_identity (Nrmatrix)
| identity(Nrmatrix) '''OR'''

matrix.setIdentity()

|-
| desktop.cpp: In member function 'bool SPDesktop::isWithinViewport(SPItem*) const':

desktop.cpp:532: error: conversion from

<nowiki>'boost::optional<NR::Rect>' to non-scalar type </nowiki>

<nowiki>'boost::optional<Geom::D2<Geom::Interval> >' requested</nowiki>
| <nowiki>boost::optional<NR::Rect></nowiki>
| <nowiki>boost::optional<Geom::Rect></nowiki>

|-
| <nowiki>desktop.cpp:1004: error: no matching function for call to 'Geom::D2<Geom::Interval>::isEmpty(double)' ./2geom/rect.h:105: note: candidates are: bool Geom::D2<Geom::Interval>::isEmpty() const </nowiki>
| <nowiki>if ( !d || d->isEmpty(0.1) ) {

return;

}
</nowiki>

| if ( !d

<nowiki>|| d->width() < 0.1</nowiki>

<nowiki>|| d->height() < 0.1</nowiki>

)

{

return;

}

|-
|
| NR::

matrix.test_identity()
| local.isIdentity()

|-
| <nowiki>selection-chemistry.cpp:1424: error: no match for ‘operator[]’ in ‘center[X]’</nowiki>

<nowiki>center is a boost::optional<Geom::Point> </nowiki>
|
| you're missing the *

|-
| Geom::Rotate doesn't seem have a operator/ what is the trick for turning division in to multiplication, again
| r1/r2
| r1 * r2.inverse()

|-
|
| NR::Rect's can be changed to Geom::Rect But it is better not to do this.
| geomrect = to_2geom(nrrect)

|-
|
| NR::union_bounds()
| Geom::unify()

|-
| sp-item.cpp:814: error: ‘expansionX’ is not a member of ‘Geom’
| dy0 *= NR::expansionY(i2d);
dx0 *= NR::expansionX(i2d);
| dy0 *= i2d.expansionY();
dx0 *= i2d.expansionX();
|}

CheatSheetForConvertingto2geom

2008-09-30T23:57:06Z

Verbalshadow: add expansionX() & expansionY()

'''Cheat Sheet For Converting to 2geom'''

If you are just starting I suggest you pick a header file and convert just one function at a time. That will give you a feel for the process as you get more comfortable do more at one time.

'''ItemsThat you Can Switch NR:: for Geom::'''

{| class="prettytable" border="1"
| NR::Point

|-
| NR::Matrix

|-
| NR::Rect

|-
| NR::Dim2

|-
| NR::L2

|-
| NR::Y

|-
| NR::X

|-
| NR::identify

|-
| NR::Coord

|}
'''Things that need small adjustments or Complete replacement'''

{| class="prettytable" border="1"
| '''Error looks like'''
| '''NR Function or Code'''
| '''2geom Replacement'''

|-
|
| NR::scale
| Geom::Scale (note the capital letter S)

|-
|
| NR::translate
| Geom::Translate (capital)

|-
|
| nrrect.extent(NR::X)
| <nowiki>geomrect.dimensions()[Geom::X] </nowiki>'''OR'''

<nowiki>geomRect[X].extent()</nowiki>

|-
|
| height= r->extent(NR::Y);
| <nowiki>height= r->dimensions()[Geom::Y];</nowiki>

|-
|
| NR::expansion(nrmatrix)
| geommatrix.descrim()

|-
| desktop.cpp:754: error: 'expand' is not a member of 'Geom'
| NR::Rect const viewbox = NR::expand(canvas->getViewbox(), border);

| Geom::Rect viewbox = canvas->getViewbox();

viewbox.expandBy(border);

|-
| desktop.cpp:162: error: 'class Geom::Matrix' has no member named 'set_identity'
| Mymatrix = set_identity (Nrmatrix)
| identity(Nrmatrix) '''OR'''

matrix.setIdentity()

|-
| desktop.cpp: In member function 'bool SPDesktop::isWithinViewport(SPItem*) const':

desktop.cpp:532: error: conversion from

<nowiki>'boost::optional<NR::Rect>' to non-scalar type </nowiki>

<nowiki>'boost::optional<Geom::D2<Geom::Interval> >' requested</nowiki>
| <nowiki>boost::optional<NR::Rect></nowiki>
| <nowiki>boost::optional<Geom::Rect></nowiki>

|-
| <nowiki>desktop.cpp:1004: error: no matching function for call to 'Geom::D2<Geom::Interval>::isEmpty(double)' ./2geom/rect.h:105: note: candidates are: bool Geom::D2<Geom::Interval>::isEmpty() const </nowiki>
| <nowiki>if ( !d || d->isEmpty(0.1) ) {

return;

}
</nowiki>

| if ( !d

<nowiki>|| d->width() < 0.1</nowiki>

<nowiki>|| d->height() < 0.1</nowiki>

)

{

return;

}

|-
|
| NR::

matrix.test_identity()
| local.isIdentity()

|-
| <nowiki>selection-chemistry.cpp:1424: error: no match for ‘operator[]’ in ‘center[X]’</nowiki>

<nowiki>center is a boost::optional<Geom::Point> </nowiki>
|
| you're missing the *

|-
| Geom::Rotate doesn't seem have a operator/ what is the trick for turning division in to multiplication, again
| r1/r2
| r1 * r2.inverse()

|-
|
| NR::Rect's can be changed to Geom::Rect But it is better not to do this.
| geomrect = to_2geom(nrrect)

|-
|
| NR::union_bounds()
| Geom::unify()

|-
| sp-item.cpp:814: error: ‘expansionX’ is not a member of ‘Geom’
| dy0 *= Geom::expansionY(i2d);
dx0 *= Geom::expansionX(i2d);
| dy0 *= i2d.expansionY();
dx0 *= i2d.expansionX();
|}

CheatSheetForConvertingto2geom

2008-09-30T20:32:09Z

Verbalshadow: remove used rows

'''Cheat Sheet For Converting to 2geom'''

If you are just starting I suggest you pick a header file and convert just one function at a time. That will give you a feel for the process as you get more comfortable do more at one time.

'''ItemsThat you Can Switch NR:: for Geom::'''

{| class="prettytable" border="1"
| NR::Point

|-
| NR::Matrix

|-
| NR::Rect

|-
| NR::Dim2

|-
| NR::L2

|-
| NR::Y

|-
| NR::X

|-
| NR::identify

|-
| NR::Coord

|}
'''Things that need small adjustments or Complete replacement'''

{| class="prettytable" border="1"
| '''Error looks like'''
| '''NR Function or Code'''
| '''2geom Replacement'''

|-
|
| NR::scale
| Geom::Scale (note the capital letter S)

|-
|
| NR::translate
| Geom::Translate (capital)

|-
|
| nrrect.extent(NR::X)
| <nowiki>geomrect.dimensions()[Geom::X] </nowiki>'''OR'''

<nowiki>geomRect[X].extent()</nowiki>

|-
|
| height= r->extent(NR::Y);
| <nowiki>height= r->dimensions()[Geom::Y];</nowiki>

|-
|
| NR::expansion(nrmatrix)
| geommatrix.descrim()

|-
| desktop.cpp:754: error: 'expand' is not a member of 'Geom'
| NR::Rect const viewbox = NR::expand(canvas->getViewbox(), border);

| Geom::Rect viewbox = canvas->getViewbox();

viewbox.expandBy(border);

|-
| desktop.cpp:162: error: 'class Geom::Matrix' has no member named 'set_identity'
| Mymatrix = set_identity (Nrmatrix)
| identity(Nrmatrix) '''OR'''

matrix.setIdentity()

|-
| desktop.cpp: In member function 'bool SPDesktop::isWithinViewport(SPItem*) const':

desktop.cpp:532: error: conversion from

<nowiki>'boost::optional<NR::Rect>' to non-scalar type </nowiki>

<nowiki>'boost::optional<Geom::D2<Geom::Interval> >' requested</nowiki>
| <nowiki>boost::optional<NR::Rect></nowiki>
| <nowiki>boost::optional<Geom::Rect></nowiki>

|-
| <nowiki>desktop.cpp:1004: error: no matching function for call to 'Geom::D2<Geom::Interval>::isEmpty(double)' ./2geom/rect.h:105: note: candidates are: bool Geom::D2<Geom::Interval>::isEmpty() const </nowiki>
| <nowiki>if ( !d || d->isEmpty(0.1) ) {

return;

}
</nowiki>

| if ( !d

<nowiki>|| d->width() < 0.1</nowiki>

<nowiki>|| d->height() < 0.1</nowiki>

)

{

return;

}

|-
|
| NR::

matrix.test_identity()
| local.isIdentity()

|-
| <nowiki>selection-chemistry.cpp:1424: error: no match for ‘operator[]’ in ‘center[X]’</nowiki>

<nowiki>center is a boost::optional<Geom::Point> </nowiki>
|
| you're missing the *

|-
| Geom::Rotate doesn't seem have a operator/ what is the trick for turning division in to multiplication, again
| r1/r2
| r1 * r2.inverse()

|-
|
| NR::Rect's can be changed to Geom::Rect But it is better not to do this.
| geomrect = to_2geom(nrrect)

|-
|
| NR::union_bounds()
| Geom::unify()

|}

CheatSheetForConvertingto2geom

2008-09-30T20:30:28Z

Verbalshadow:

'''Cheat Sheet For Converting to 2geom'''

If you are just starting I suggest you pick a header file and convert just one function at a time. That will give you a feel for the process as you get more comfortable do more at one time.

'''ItemsThat you Can Switch NR:: for Geom::'''

{| class="prettytable" border="1"
| NR::Point

|-
| NR::Matrix

|-
| NR::Rect

|-
| NR::Dim2

|-
| NR::L2

|-
| NR::Y

|-
| NR::X

|-
| NR::identify

|-
| NR::Coord

|}
'''Things that need small adjustments or Complete replacement'''

{| class="prettytable" border="1"
| '''Error looks like'''
| '''NR Function or Code'''
| '''2geom Replacement'''

|-
|
| NR::scale
| Geom::Scale (note the capital letter S)

|-
|
| NR::translate
| Geom::Translate (capital)

|-
|
|
|

|-
|
|
|

|-
|
|
|

|-
|
|
|

|-
|
| nrrect.extent(NR::X)
| <nowiki>geomrect.dimensions()[Geom::X] </nowiki>'''OR'''

<nowiki>geomRect[X].extent()</nowiki>

|-
|
| height= r->extent(NR::Y);
| <nowiki>height= r->dimensions()[Geom::Y];</nowiki>

|-
|
| NR::expansion(nrmatrix)
| geommatrix.descrim()

|-
| desktop.cpp:754: error: 'expand' is not a member of 'Geom'
| NR::Rect const viewbox = NR::expand(canvas->getViewbox(), border);

| Geom::Rect viewbox = canvas->getViewbox();

viewbox.expandBy(border);

|-
| desktop.cpp:162: error: 'class Geom::Matrix' has no member named 'set_identity'
| Mymatrix = set_identity (Nrmatrix)
| identity(Nrmatrix) '''OR'''

matrix.setIdentity()

|-
| desktop.cpp: In member function 'bool SPDesktop::isWithinViewport(SPItem*) const':

desktop.cpp:532: error: conversion from

<nowiki>'boost::optional<NR::Rect>' to non-scalar type </nowiki>

<nowiki>'boost::optional<Geom::D2<Geom::Interval> >' requested</nowiki>
| <nowiki>boost::optional<NR::Rect></nowiki>
| <nowiki>boost::optional<Geom::Rect></nowiki>

|-
| <nowiki>desktop.cpp:1004: error: no matching function for call to 'Geom::D2<Geom::Interval>::isEmpty(double)' ./2geom/rect.h:105: note: candidates are: bool Geom::D2<Geom::Interval>::isEmpty() const </nowiki>
| <nowiki>if ( !d || d->isEmpty(0.1) ) {

return;

}
</nowiki>

| if ( !d

<nowiki>|| d->width() < 0.1</nowiki>

<nowiki>|| d->height() < 0.1</nowiki>

)

{

return;

}

|-
|
| NR::

matrix.test_identity()
| local.isIdentity()

|-
| <nowiki>selection-chemistry.cpp:1424: error: no match for ‘operator[]’ in ‘center[X]’</nowiki>

<nowiki>center is a boost::optional<Geom::Point> </nowiki>
|
| you're missing the *

|-
| Geom::Rotate doesn't seem have a operator/ what is the trick for turning division in to multiplication, again
| r1/r2
| r1 * r2.inverse()

|-
|
| NR::Rect's can be changed to Geom::Rect But it is better not to do this.
| geomrect = to_2geom(nrrect)

|-
|
| NR::union_bounds()
| Geom::unify()

|}

CheatSheetForConvertingto2geom

2008-09-30T20:29:03Z

Verbalshadow:

'''Cheat Sheet For Converting to 2geom'''

If you are just starting I suggest you pick a header file and convert just one function at a time. That will give you a feel for the process as you get more comfortable do more at one time.

'''ItemsThat you Can Switch NR:: for Geom::'''

{| class="prettytable" border="1"
| NR::Point

|-
| NR::Matrix

|-
| NR::Rect

|-
| NR::Dim2

|-
| NR::L2

|-
| NR::Y

|-
| NR::X

|-
| NR::identify

|-
| NR::Coord

|}
'''Things that need small adjustments or Complete replacement'''

{| class="prettytable" border="1"
| '''Error looks like'''
| '''NR Function or Code'''
| '''2geom Replacement'''

|-
|
| NR::scale
| Geom::Scale (note the capital letter S)

|-
|
| NR::translate
|

|-
|
|
|

|-
|
|
|

|-
|
|
|

|-
|
|
|

|-
|
| nrrect.extent(NR::X)
| <nowiki>geomrect.dimensions()[Geom::X] </nowiki>'''OR'''

<nowiki>geomRect[X].extent()</nowiki>

|-
|
| height= r->extent(NR::Y);
| <nowiki>height= r->dimensions()[Geom::Y];</nowiki>

|-
|
| NR::expansion(nrmatrix)
| geommatrix.descrim()

|-
| desktop.cpp:754: error: 'expand' is not a member of 'Geom'
| NR::Rect const viewbox = NR::expand(canvas->getViewbox(), border);

| Geom::Rect viewbox = canvas->getViewbox();

viewbox.expandBy(border);

|-
| desktop.cpp:162: error: 'class Geom::Matrix' has no member named 'set_identity'
| Mymatrix = set_identity (Nrmatrix)
| identity(Nrmatrix) '''OR'''

matrix.setIdentity()

|-
| desktop.cpp: In member function 'bool SPDesktop::isWithinViewport(SPItem*) const':

desktop.cpp:532: error: conversion from

<nowiki>'boost::optional<NR::Rect>' to non-scalar type </nowiki>

<nowiki>'boost::optional<Geom::D2<Geom::Interval> >' requested</nowiki>
| <nowiki>boost::optional<NR::Rect></nowiki>
| <nowiki>boost::optional<Geom::Rect></nowiki>

|-
| <nowiki>desktop.cpp:1004: error: no matching function for call to 'Geom::D2<Geom::Interval>::isEmpty(double)' ./2geom/rect.h:105: note: candidates are: bool Geom::D2<Geom::Interval>::isEmpty() const </nowiki>
| <nowiki>if ( !d || d->isEmpty(0.1) ) {

return;

}
</nowiki>

| if ( !d

<nowiki>|| d->width() < 0.1</nowiki>

<nowiki>|| d->height() < 0.1</nowiki>

)

{

return;

}

|-
|
| NR::

matrix.test_identity()
| local.isIdentity()

|-
| <nowiki>selection-chemistry.cpp:1424: error: no match for ‘operator[]’ in ‘center[X]’</nowiki>

<nowiki>center is a boost::optional<Geom::Point> </nowiki>
|
| you're missing the *

|-
| Geom::Rotate doesn't seem have a operator/ what is the trick for turning division in to multiplication, again
| r1/r2
| r1 * r2.inverse()

|-
|
| NR::Rect's can be changed to Geom::Rect But it is better not to do this.
| geomrect = to_2geom(nrrect)

|-
|
| NR::union_bounds()
| Geom::unify()

|}

CheatSheetForConvertingto2geom

2008-09-30T20:01:00Z

Verbalshadow: First edtion

'''Cheat Sheet For Converting to 2geom'''

If you are just starting I suggest you pick a header file and convert just one function at a time. That will give you a feel for the process as you get more comfortable do more at one time.

'''ItemsThat you Can Switch NR:: for Geom::'''

{| class="prettytable" border="1"
| NR::Point

|-
| NR::Matrix

|-
| NR::Rect

|-
| NR::Dim2

|-
| NR::L2

|-
| NR::Y

|-
| NR::X

|-
| NR::identify

|-
| NR::Coord

|}
'''Things that need small adjustments or Complete replacement'''

{| class="prettytable" border="1"
| '''Error looks like'''
| '''NR Function or Code'''
| '''2geom Replacement'''

|-
|
| NR::scale
| Geom::Scale (note the capital letter S)

|-
|
| NR::translate
|

|-
|
|
|

|-
|
|
|

|-
|
|
|

|-
|
|
|

|-
|
| nrrect.extent(NR::X)
| <nowiki>geomrect.dimensions()[Geom::X] </nowiki>'''OR'''

<nowiki>geomRect[X].extent()</nowiki>

|-
|
| height= r->extent(NR::Y);
| <nowiki>height= r->dimensions()[Geom::Y];</nowiki>

|-
|
| NR::expansion(nrmatrix)
| geommatrix.descrim()

|-
| desktop.cpp:754: error: 'expand' is not a member of 'Geom'
| NR::Rect const viewbox = NR::expand(canvas->getViewbox(), border);

| Geom::Rect viewbox = canvas->getViewbox();

viewbox.expandBy(border);

|-
| desktop.cpp:162: error: 'class Geom::Matrix' has no member named 'set_identity'
| Mymatrix = set_identity (Nrmatrix)
| identity(Nrmatrix) '''OR'''

'''matrix.setIdentity('''

|-
| desktop.cpp: In member function 'bool SPDesktop::isWithinViewport(SPItem*) const':

desktop.cpp:532: error: conversion from

<nowiki>'boost::optional<NR::Rect>' to non-scalar type </nowiki>

<nowiki>'boost::optional<Geom::D2<Geom::Interval> >' requested</nowiki>
| <nowiki>boost::optional<NR::Rect></nowiki>
| <nowiki>boost::optional<Geom::Rect></nowiki>

|-
| <nowiki>desktop.cpp:1004: error: no matching function for call to 'Geom::D2<Geom::Interval>::isEmpty(double)' ./2geom/rect.h:105: note: candidates are: bool Geom::D2<Geom::Interval>::isEmpty() const </nowiki>
| <nowiki>if ( !d || d->isEmpty(0.1) ) {

return;

}
</nowiki>

| if ( !d

<nowiki>|| d->width() < 0.1</nowiki>

<nowiki>|| d->height() < 0.1</nowiki>

)

{

return;

}

|-
|
| NR::

matrix.test_identity()
| local.isIdentity()

|-
| <nowiki>selection-chemistry.cpp:1424: error: no match for ‘operator[]’ in ‘center[X]’</nowiki>

<nowiki>center is a boost::optional<Geom::Point> </nowiki>
|
| you're missing the *

|-
| Geom::Rotate doesn't seem have a operator/ what is the trick for turning division in to multiplication, again
| r1/r2
| r1 * r2.inverse()

|-
|
| NR::Rect's can be changed to Geom::Rect But it is better not to do this.
| geomrect = to_2geom(nrrect)

|-
|
| NR::union_bounds()
| Geom::unify()

|}

SpecFilterEffectDialog

2008-07-17T22:21:08Z

Verbalshadow: /* Rationale */

Launchpad Entry:
https://blueprints.launchpad.net/inkscape/+spec/improved-filter-effects-dialog

== Summary ==
Utilizing the Inkscape canvas to visualize a flow diagram of the construction of the filter effects.

== Release Note ==

== Rationale ==

[[Image:MockupFilterEffects.png|800px]]

This flow diagram setup is a great deal easier to understand then the current way the diagram is displayed and allows the user to see at every step the what the filter does.

== Design ==

== TODO ==

* Flesh this specification out in more detail

== Discussion ==

SpecFilterEffectDialog

2008-07-17T22:05:48Z

Verbalshadow: True Initial Input

Launchpad Entry:
https://blueprints.launchpad.net/inkscape/+spec/improved-filter-effects-dialog

== Summary ==
Utilizing the Inkscape canvas to visualize a flow diagram of the construction of the filter effects.

== Release Note ==

== Rationale ==

[[Image:MockupFilterEffects.png]]

This flow diagram setup is a great deal easier to understand then the current way the diagram is displayed and allows the user to see at every step the what the filter does.

== Design ==

== TODO ==

* Flesh this specification out in more detail

== Discussion ==

File:MockupFilterEffects.png

2008-07-17T22:00:14Z

Verbalshadow:

SpecFilterEffectDialog

2008-07-17T20:40:37Z

Verbalshadow: New page: temp

temp

Lib2geom Release Notes 02

2008-06-25T22:56:19Z

Verbalshadow: /* Release Notes for lib2geom v 0.2 */

== Release Notes for lib2geom v 0.2 ==

*Greatly expanded Python bindings
**began wrapping Rect, d2pwsb, pwd2sb, Region, Regions, Path and PathVector
**...
*Boolean Ops
*SVG elliptiarc

--[[User:Verbalshadow|verbalshadow]] 22:41, 25 June 2008 (UTC)

Lib2geom Release Notes 02

2008-06-25T22:41:43Z

Verbalshadow: New page: == Release Notes for lib2geom v 0.2 == *Python bindings *Boolean Ops --~~~~

== Release Notes for lib2geom v 0.2 ==

*Python bindings
*Boolean Ops

--[[User:Verbalshadow|verbalshadow]] 22:41, 25 June 2008 (UTC)

Swatch Book

2008-05-16T05:30:37Z

Verbalshadow: /* Feature Details */

= Overview =

This page is for discussing the concepts around swatch books, for Inkscape and any other programs, and what things users might want.

Feel free to contribute here, on the mailing lists, or in our Jabber/IRC chat rooms.

== What is a Swatch Book? ==

Basically a "Swatch Book" is a collection of swatches that an artist or designer might put together for reference during a project.

Although a large number of people are familiar with various commercial spot color books, a swatch book is not limited to just colors. Decorators, designers and others often have books with more than simple color chips. That leads into the question of just what is a 'swatch' - [[JonCruz]]

== What is a "Swatch"? ==

In general artistic design work, I normally hit a different
definition of "swatch". It's not just a color, it's a "sample" or
"material". It could be a simple solid ink color, or it could be a
heavy plaid cloth. Moving into software, "Gold" is another good
example. "Gold" is a texture, not a color (just ask the Blender
artists out there). From an artist/designer's viewpoint, they tend to
think in terms of a swatch book as "a collection of things I've
pulled together to use for this project". I *think* some of the
problem comes from saying "Pantone swatch book" and such but not
keeping in mind that it is just a subset of general "swatch books".
That is, it is a "swatch book but with only solid paint swatches".
Then again... I have used foil Pantone books, so those definitely
fall into the "material, not just color" category. - [[JonCruz]]

Some examples I've seen in swatch books are
* Fabric
* Ribbon
* Paint
* Spot color samples (Pantone, Trumatch, Focoltone, Toyo, etc)
* Paper
* Wood
* Flooring
* Tile
* Counter material

The key here might be to think "material" instead of just "color". Although one might work with just colors, others might want to extend to a bit more.

= Use Cases =

And think of the use case. Say a comic artist is working on a
project. He would probably want a "swatch book" for each of his
characters, and perhaps one combining them. Then he might also want
to add a book per character per lighting condition ("daytime",
"nighttime", etc). When he went to use it, he might like to just
select "Fred's skin" and apply it to an area. Then "Fred's shirt" for
another. Those might just be simple RGB colors, or the skin might be
a simple gradient and the shirt might be a checked pattern.

However... the artist most definitely would benefit from being able
to define those books once and then just reference them from each of
the programs he uses to create things. - [[JonCruz]]

I think it would also be good if we could educate the comic artists on SVG Blend modes work, this way there would be no need to have separate color swatches for time of day. You could easily overlay a colored/gradiated rectangle within a frame and use multiply or another blend mode. Then again, that's also a preference of workflow.- [[ScislaC]]

= Swatches in SVG/Inkscape =

For SVG work, we'd probably like to be able to include gradients and
patterns also. "Brushes" might also be nice... but I think those are
something a bit different. For the apps I've seen that differentiate
brushes from patterns, brushes get to be more of blobs of complex
procedural code. - [[JonCruz]]

This involves more than just the swatches, but I found the brush weight profiles in Xara X[1|treme] quite intuitive. Basically it's now doable in 0.46 with LPE and an auxiliary shape that defines the variable brush weight, but Xara's simple dropdown of pre-defined profiles worked quite well. Just a thought. - [[jegHegy]]

I think all mentioned uses of swatches are applicable. As for brushes, yes, I think those would be great as well. If we can have a standard cross-application compatible way to include those and then leave it up to the applications to implement how they want to utilize them, that would be optimal. In addition to brushes, having a symbols library implemented in a swatch book would also be greatly helpful. - [[ScislaC]]

= Mockups =

TBD

= Software Support =

== Chart ==
The purpose of this table is first of all to find what apps support each feature, so that we can then look into each of those to make sure that we support everything that each app needs to be sharable in a swatchbook.

Please note that the features across the top will probably change as we gain more information. Also what gets entered into each cell will change once we have a better idea what's going on.

{| class="wikitable" border="1"
|-
! App
! Color
! Gradient
! Gradient
Application
! Pattern
! Filter
! Brush
! Symbol
! Line Marker
|-
| [http://www.inkscape.org/ Inkscape]
| yes, rich
| yes
| limited
| yes, vector
| Yes, as of 0.46+Dev
| not really
| ?
| yes
|-
| [http://www.blender.org/ Blender]
| ?
| ?
| ?
| ?
| ?
| ?
| ?
| ?
|-
| [http://www.cinepaint.org/ CinePaint]
| ?
| ?
| ?
| ?
| ?
| ?
| ?
| ?
|-
| [http://www.gimp.org/ GIMP]
| yes
| yes
| yes, rich
| yes, bitmap
| ?
| yes
| ?
| ?
|-
| [http://kolourpaint.org/ KolourPaint]
| ?
| ?
| ?
| ?
| ?
| ?
| ?
| ?
|-
| [http://www.koffice.org/krita/ Krita]
| ?
| ?
| ?
| ?
| ?
| ?
| ?
| ?
|-
| [http://www.scribus.net/ Scribus]
| ?
| ?
| ?
| ?
| ?
| ?
| ?
| ?
|}

== Feature Details ==
=== Color ===

The intent is to exchange color in the [http://create.freedesktop.org/wiki/index.php/Swatches_-_colour_file_format/Propositions format worked out by CREATE]

A few additions might be made, but only in a manner that won't break use of that spec.

=== Gradient ===

Gradients in SVG can be expressed as a subset of those supported by GIMP once shape/coordinates are separated. That is, pulling off linear, radial, etc.

In the GIMP UI there is a "blend" tool, and one of the inputs is "Gradient". "Shape" is a different input.

General Characteristics
{| border="1"
! aspect
! SVG
! GIMP
|-
|Multi-segment
|Y
|Y
|-
|Segment end can differ from next segment start
|N
|Y
|-
|Adjustable segment midpoint
|N
|Y
|-
|Fixed color stop
|Y
|Y
|-
|FG color stop
|N
|Y
|-
|FG+A color stop
|N
|Y
|-
|BG color stop
|N
|Y
|-
|BG+A color stop
|N
|Y
|-
|Blend linear
|Y
|Y
|-
|Blend sinusoidal
|N
|Y
|-
|Blend spherical +
|N
|Y
|-
|Blend spherical -
|N
|Y
|-
|Color mode RGB
|Y
|Y
|-
|Color mode HSV cw
|N
|Y
|-
|Color mode HSV ccw
|N
|Y
|}

So a GIMP format gradient is SVG compatible if:
* the end stop for each segment matches the begin stop for the next segment
* the midpoint of each segment is centered
* the color chosen is proper (need some work here)
* the blend is limited to only linear
* the coloring mode is limited to only RGB

=== Gradient Application ===

{| border="1"
! Type
! SVG
! GIMP
|-
|Linear
|Y
|Y
|-
|Bi-linear
|?
|Y
|-
|Radial
|Y
|Y
|-
|Square
|N
|Y
|-
|Conical (sym)
|N
|Y
|-
|Conical (asym)
|N
|Y
|-
|Shaped (angular)
|N
|Y
|-
|Shaped (spherical)
|N
|Y
|-
|Shaped (dimpled)
|N
|Y
|-
|Spiral (cw)
|N
|Y
|-
|Spiral (ccw)
|N
|Y

|}

=== Pattern ===
=== Filter ===
=== Brush ===
=== Symbol ===
=== Line Marker ===

= References =

* [http://lists.freedesktop.org/archives/create/2007-September/000994.html My post] to the CREATE list on Sep 27, 2007.

Swatch Book

2008-05-16T05:25:54Z

Verbalshadow: /* Chart */

= Overview =

This page is for discussing the concepts around swatch books, for Inkscape and any other programs, and what things users might want.

Feel free to contribute here, on the mailing lists, or in our Jabber/IRC chat rooms.

== What is a Swatch Book? ==

Basically a "Swatch Book" is a collection of swatches that an artist or designer might put together for reference during a project.

Although a large number of people are familiar with various commercial spot color books, a swatch book is not limited to just colors. Decorators, designers and others often have books with more than simple color chips. That leads into the question of just what is a 'swatch' - [[JonCruz]]

== What is a "Swatch"? ==

In general artistic design work, I normally hit a different
definition of "swatch". It's not just a color, it's a "sample" or
"material". It could be a simple solid ink color, or it could be a
heavy plaid cloth. Moving into software, "Gold" is another good
example. "Gold" is a texture, not a color (just ask the Blender
artists out there). From an artist/designer's viewpoint, they tend to
think in terms of a swatch book as "a collection of things I've
pulled together to use for this project". I *think* some of the
problem comes from saying "Pantone swatch book" and such but not
keeping in mind that it is just a subset of general "swatch books".
That is, it is a "swatch book but with only solid paint swatches".
Then again... I have used foil Pantone books, so those definitely
fall into the "material, not just color" category. - [[JonCruz]]

Some examples I've seen in swatch books are
* Fabric
* Ribbon
* Paint
* Spot color samples (Pantone, Trumatch, Focoltone, Toyo, etc)
* Paper
* Wood
* Flooring
* Tile
* Counter material

The key here might be to think "material" instead of just "color". Although one might work with just colors, others might want to extend to a bit more.

= Use Cases =

And think of the use case. Say a comic artist is working on a
project. He would probably want a "swatch book" for each of his
characters, and perhaps one combining them. Then he might also want
to add a book per character per lighting condition ("daytime",
"nighttime", etc). When he went to use it, he might like to just
select "Fred's skin" and apply it to an area. Then "Fred's shirt" for
another. Those might just be simple RGB colors, or the skin might be
a simple gradient and the shirt might be a checked pattern.

However... the artist most definitely would benefit from being able
to define those books once and then just reference them from each of
the programs he uses to create things. - [[JonCruz]]

I think it would also be good if we could educate the comic artists on SVG Blend modes work, this way there would be no need to have separate color swatches for time of day. You could easily overlay a colored/gradiated rectangle within a frame and use multiply or another blend mode. Then again, that's also a preference of workflow.- [[ScislaC]]

= Swatches in SVG/Inkscape =

For SVG work, we'd probably like to be able to include gradients and
patterns also. "Brushes" might also be nice... but I think those are
something a bit different. For the apps I've seen that differentiate
brushes from patterns, brushes get to be more of blobs of complex
procedural code. - [[JonCruz]]

This involves more than just the swatches, but I found the brush weight profiles in Xara X[1|treme] quite intuitive. Basically it's now doable in 0.46 with LPE and an auxiliary shape that defines the variable brush weight, but Xara's simple dropdown of pre-defined profiles worked quite well. Just a thought. - [[jegHegy]]

I think all mentioned uses of swatches are applicable. As for brushes, yes, I think those would be great as well. If we can have a standard cross-application compatible way to include those and then leave it up to the applications to implement how they want to utilize them, that would be optimal. In addition to brushes, having a symbols library implemented in a swatch book would also be greatly helpful. - [[ScislaC]]

= Mockups =

TBD

= Software Support =

== Chart ==
The purpose of this table is first of all to find what apps support each feature, so that we can then look into each of those to make sure that we support everything that each app needs to be sharable in a swatchbook.

Please note that the features across the top will probably change as we gain more information. Also what gets entered into each cell will change once we have a better idea what's going on.

{| class="wikitable" border="1"
|-
! App
! Color
! Gradient
! Gradient
Application
! Pattern
! Filter
! Brush
! Symbol
! Line Marker
|-
| [http://www.inkscape.org/ Inkscape]
| yes, rich
| yes
| limited
| yes, vector
| Yes, as of 0.46+Dev
| not really
| ?
| yes
|-
| [http://www.blender.org/ Blender]
| ?
| ?
| ?
| ?
| ?
| ?
| ?
| ?
|-
| [http://www.cinepaint.org/ CinePaint]
| ?
| ?
| ?
| ?
| ?
| ?
| ?
| ?
|-
| [http://www.gimp.org/ GIMP]
| yes
| yes
| yes, rich
| yes, bitmap
| ?
| yes
| ?
| ?
|-
| [http://kolourpaint.org/ KolourPaint]
| ?
| ?
| ?
| ?
| ?
| ?
| ?
| ?
|-
| [http://www.koffice.org/krita/ Krita]
| ?
| ?
| ?
| ?
| ?
| ?
| ?
| ?
|-
| [http://www.scribus.net/ Scribus]
| ?
| ?
| ?
| ?
| ?
| ?
| ?
| ?
|}

== Feature Details ==
=== Color ===

The intent is to exchange color in the [http://create.freedesktop.org/wiki/index.php/Swatches_-_colour_file_format/Propositions format worked out by CREATE]

A few additions might be made, but only in a manner that won't break use of that spec.

=== Gradient ===

Gradients in SVG can be expressed as a subset of those supported by GIMP once shape/coordinates are separated. That is, pulling off linear, radial, etc.

In the GIMP UI there is a "blend" tool, and one of the inputs is "Gradient". "Shape" is a different input.

General Characteristics
{| border="1"
! aspect
! SVG
! GIMP
|-
|Multi-segment
|Y
|Y
|-
|Segment end can differ from next segment start
|N
|Y
|-
|Adjustable segment midpoint
|N
|Y
|-
|Fixed color stop
|Y
|Y
|-
|FG color stop
|N
|Y
|-
|FG+A color stop
|N
|Y
|-
|BG color stop
|N
|Y
|-
|BG+A color stop
|N
|Y
|-
|Blend linear
|Y
|Y
|-
|Blend sinusoidal
|N
|Y
|-
|Blend spherical +
|N
|Y
|-
|Blend spherical -
|N
|Y
|-
|Color mode RGB
|Y
|Y
|-
|Color mode HSV cw
|N
|Y
|-
|Color mode HSV ccw
|N
|Y
|}

So a GIMP format gradient is SVG compatible if:
* the end stop for each segment matches the begin stop for the next segment
* the midpoint of each segment is centered
* the color chosen is proper (need some work here)
* the blend is limited to only linear
* the coloring mode is limited to only RGB

=== Gradient Application ===

{| border="1"
! Type
! SVG
! GIMP
|-
|Linear
|Y
|Y
|-
|Bi-linear
|?
|Y
|-
|Radial
|Y
|Y
|-
|Square
|N
|Y
|-
|Conical (sym)
|N
|Y
|-
|Conical (asym)
|N
|Y
|-
|Shaped (angular)
|N
|Y
|-
|Shaped (spherical)
|N
|Y
|-
|Shaped (dimpled)
|N
|Y
|-
|Spiral (cw)
|N
|Y
|-
|Spiral (ccw)
|N
|Y

|}

=== Pattern ===
=== Filter ===
=== Brush ===
=== Symbol ===

= References =

* [http://lists.freedesktop.org/archives/create/2007-September/000994.html My post] to the CREATE list on Sep 27, 2007.

CMake

2008-04-08T02:52:52Z

Verbalshadow:

'''Work is a on going to get this build system functional!'''

Cmake is a cross-platform build system know to work on all major platforms we support (*nix, Windows, OSX).

CMake is an extensible, open-source system that has many powerful features.
Those features include:

* Supports complex, large build environments. CMake has been proven in several large projects (KDE, ParaView, SecondLife, Scribus)
* Generates native build files (e.g., makefiles on Unix; workspaces/projects on MS Visual C++). Therefore, standard tools can be used on any platform/compiler configuration.
* Powerful system introspection abilities including the ability to find installed include files, libraries and executables. Also the ability to test the compiler for supported features.
* Integrated testing system called CTest.
* Integrated packaging system called CPack.
* Easy integration with CDash and Dart dashboard servers.
* Powerful scripting language with simple syntax.
* Supports in-place and out-of-place builds. Multiple compilation trees are possible from a single source tree.
* Can be easily extended to add new features.
* CMake is open source, under a liberal BSD license.
* CMake operates with a cache designed to be interfaced with a graphical editor. The cache provides optional interaction to conditionally control the build process.
* Ability to create Mac OSX Frameworks and Application Bundles.
* Supports adding complex custom rules to the build.

== How you can help ==

We have completed the building of the CMakeLists.txt for almost everything needed.
We are now working on get the build to compile properly. See below Testing/Using to help.

== SIMPLE CmakeLists.txt ==
SET(libavoid_SRC
connector.cpp
geometry.cpp
graph.cpp
makepath.cpp
polyutil.cpp
region.cpp
router.cpp
shape.cpp
static.cpp
timer.cpp
vertices.cpp
visibility.cpp
)

== SIMPLE with single sub-directory Cmakelists.txt ==

SET(libavoid_SRC
connector.cpp
geometry.cpp
graph.cpp
makepath.cpp
polyutil.cpp
region.cpp
router.cpp
shape.cpp
static.cpp
timer.cpp
vertices.cpp
visibility.cpp
#Add our subdirectory sourcelist Var
${libavoid_parameter_SRC}
)
# this adds a single sub-directory
ADD_SUBDIRECTORY(parameter)

== Testing/Using ==

Experience with Scribus '''strongly''' suggests using an "out of source"build arrangement. E.g.

<pre>
mkdir buildinkscape
cd buildinkscape
cmake ./path/to/inkscape/sources
make
</pre>

References:
[http://docs.scribus.net/index.php?lang=en&page=install4 Installing Scribus with Cmake] 
[http://docs.scribus.net/index.php?lang=en&page=install5 Installing with CMake on OSX]

CMake

2008-04-08T02:49:16Z

Verbalshadow: /* How you can help */

'''Work is a on going to get this build system functional!'''

Cmake is a cross-platform build system know to work on all major platforms we support (*nix, Windows, OSX).

CMake is an extensible, open-source system that has many powerful features.
Those features include:

* Supports complex, large build environments. CMake has been proven in several large projects (KDE, ParaView, SecondLife, Scribus)
* Generates native build files (e.g., makefiles on Unix; workspaces/projects on MS Visual C++). Therefore, standard tools can be used on any platform/compiler configuration.
* Powerful system introspection abilities including the ability to find installed include files, libraries and executables. Also the ability to test the compiler for supported features.
* Integrated testing system called CTest.
* Integrated packaging system called CPack.
* Easy integration with CDash and Dart dashboard servers.
* Powerful scripting language with simple syntax.
* Supports in-place and out-of-place builds. Multiple compilation trees are possible from a single source tree.
* Can be easily extended to add new features.
* CMake is open source, under a liberal BSD license.
* CMake operates with a cache designed to be interfaced with a graphical editor. The cache provides optional interaction to conditionally control the build process.
* Ability to create Mac OSX Frameworks and Application Bundles.
* Supports adding complex custom rules to the build.

== How you can help ==

We have completed the building of the CMakeLists.txt for almost everything needed.
We are now working on get the build to compile properly. See below to Build.

== SIMPLE CmakeLists.txt ==
SET(libavoid_SRC
connector.cpp
geometry.cpp
graph.cpp
makepath.cpp
polyutil.cpp
region.cpp
router.cpp
shape.cpp
static.cpp
timer.cpp
vertices.cpp
visibility.cpp
)

== SIMPLE with single sub-directory Cmakelists.txt ==

SET(libavoid_SRC
connector.cpp
geometry.cpp
graph.cpp
makepath.cpp
polyutil.cpp
region.cpp
router.cpp
shape.cpp
static.cpp
timer.cpp
vertices.cpp
visibility.cpp
#Add our subdirectory sourcelist Var
${libavoid_parameter_SRC}
)
# this adds a single sub-directory
ADD_SUBDIRECTORY(parameter)

== Testing/Using ==

Experience with Scribus '''strongly''' suggests using an "out of source"build arrangement. E.g.

<pre>
mkdir buildinkscape
cd buildinkscape
cmake ./path/to/inkscape/sources
</pre>

References:
[http://docs.scribus.net/index.php?lang=en&page=install4 Installing Scribus with Cmake] 
[http://docs.scribus.net/index.php?lang=en&page=install5 Installing with CMake on OSX]

CMake

2008-03-30T17:39:59Z

Verbalshadow:

==
'''Work is a on going to get this build system functional.''' ==

Cmake is a cross-platform build system know to work on all major platforms we support(*nix, Windows, OSX).

CMake is an extensible, open-source system that has many powerful features.
Those features include:

* Supports complex, large build environments. CMake has been proven in several large projects (KDE, ParaView, SecondLife)
* Generates native build files (e.g., makefiles on Unix; workspaces/projects on MS Visual C++). Therefore, standard tools can be used on any platform/compiler configuration.
* Powerful system introspection abilities including the ability to find installed include files, libraries and executables. Also the ability to test the compiler for supported features.
* Integrated testing system called CTest.
* Integrated packaging system called CPack.
* Easy integration with CDash and Dart dashboard servers.
* Powerful scripting language with simple syntax.
* Supports in-place and out-of-place builds. Multiple compilation trees are possible from a single source tree.
* Can be easily extended to add new features.
* CMake is open source, under a liberal BSD license.
* CMake operates with a cache designed to be interfaced with a graphical editor. The cache provides optional interaction to conditionally control the build process.
* Ability to create Mac OSX Frameworks and Application Bundles.
* Supports adding complex custom rules to the build.

== How you can help. ==

Right now we are going through all of the directories and sub-directories in the src folder and add a CMakeLists.txt file

== SIMPLE CmakeLists.txt ==
<nowiki>
SET(libavoid_SRC
connector.cpp
geometry.cpp
graph.cpp
makepath.cpp
polyutil.cpp
region.cpp
router.cpp
shape.cpp
static.cpp
timer.cpp
vertices.cpp
visibility.cpp
)
</nowiki>

== SIMPLE with single sub-directory Cmakelists.txt ==

<nowiki>
SET(libavoid_SRC
connector.cpp
geometry.cpp
graph.cpp
makepath.cpp
polyutil.cpp
region.cpp
router.cpp
shape.cpp
static.cpp
timer.cpp
vertices.cpp
visibility.cpp
#Add our subdirectory sourcelist Var
${libavoid_parameter_SRC}
)
# this adds a single sub-directory
ADD_SUBDIRECTORY(parameter)
</nowiki>

CMake

2008-03-30T17:39:11Z

Verbalshadow: Added Cmake samples

==
'''Work is a on going to get this build system functional.''' ==

Cmake is a cross-platform build system know to work on all major platforms we support(*nix, Windows, OSX).

CMake is an extensible, open-source system that has many powerful features.
Those features include:

* Supports complex, large build environments. CMake has been proven in several large projects (KDE, ParaView, SecondLife)
* Generates native build files (e.g., makefiles on Unix; workspaces/projects on MS Visual C++). Therefore, standard tools can be used on any platform/compiler configuration.
* Powerful system introspection abilities including the ability to find installed include files, libraries and executables. Also the ability to test the compiler for supported features.
* Integrated testing system called CTest.
* Integrated packaging system called CPack.
* Easy integration with CDash and Dart dashboard servers.
* Powerful scripting language with simple syntax.
* Supports in-place and out-of-place builds. Multiple compilation trees are possible from a single source tree.
* Can be easily extended to add new features.
* CMake is open source, under a liberal BSD license.
* CMake operates with a cache designed to be interfaced with a graphical editor. The cache provides optional interaction to conditionally control the build process.
* Ability to create Mac OSX Frameworks and Application Bundles.
* Supports adding complex custom rules to the build.

== How you can help. ==

Right now we are going through all of the directories and sub-directories in the src folder and add a CMakeLists.txt file

== SIMPLE CmakeLists.txt ==
<nowiki>
SET(libavoid_SRC
connector.cpp
geometry.cpp
graph.cpp
makepath.cpp
polyutil.cpp
region.cpp
router.cpp
shape.cpp
static.cpp
timer.cpp
vertices.cpp
visibility.cpp
)
</nowiki>

== SIMPLE with single sub-directory Cmakelists.txt ==

SET(libavoid_SRC
connector.cpp
geometry.cpp
graph.cpp
makepath.cpp
polyutil.cpp
region.cpp
router.cpp
shape.cpp
static.cpp
timer.cpp
vertices.cpp
visibility.cpp
#Add our subdirectory sourcelist Var
${libavoid_parameter_SRC}
)
# this adds a single sub-directory
ADD_SUBDIRECTORY(parameter)

CMake

2008-03-27T22:15:24Z

Verbalshadow: New page: Cmake is a cross-platform build system. And is know to work on all Work is a on going to get this build system functional. Here are some features of Cmake; CMake is an extensible, open...

Cmake is a cross-platform build system. And is know to work on all

Work is a on going to get this build system functional.

Here are some features of Cmake;

CMake is an extensible, open-source system that has many powerful features.
Those features include:

* Supports complex, large build environments. CMake has been proven in several large projects (KDE, ParaView, SecondLife)
* Generates native build files (e.g., makefiles on Unix; workspaces/projects on MS Visual C++). Therefore, standard tools can be used on any platform/compiler configuration.
* Powerful system introspection abilities including the ability to find installed include files, libraries and executables. Also the ability to test the compiler for supported features.
* Integrated testing system called CTest.
* Integrated packaging system called CPack.
* Easy integration with CDash and Dart dashboard servers.
* Powerful scripting language with simple syntax.
* Supports in-place and out-of-place builds. Multiple compilation trees are possible from a single source tree.
* Can be easily extended to add new features.
* CMake is open source, under a liberal BSD license.
* CMake operates with a cache designed to be interfaced with a graphical editor. The cache provides optional interaction to conditionally control the build process.
* Ability to create Mac OSX Frameworks and Application Bundles.
* Supports adding complex custom rules to the build.

AnnouncePlanning046

2008-02-20T22:52:36Z

Verbalshadow: /* The Inkscape Community Releases Inkscape 0.46 */

Planning the PR for the 0.46 release is done here...

=Tasks=
{| class="wikitable" style="text-align:center"
|-
! Task
! Performer
! Projected Date of completion
! Status
|-
| Informal PR text
| Collaborated on this wiki page
| 18th Feb 2008
| 50%
|-
| Formal PR text
| Collaborated on this wiki page
| 18th Feb 2008
| 50%
|-
| Interview
| [[user:Prokoudine|Prokoudine]]
| progressing
| 25%
|}

=Announcement Process=
# Create new news posts (using the small overview below) on all the relevant social bookmarking sites: digg, slashdot etc.
# Create a new Page on the Inkscape website that has the Formal Announcement on it (for linking purposes) have links back to the socal bookmarking stories for the release.
# Post the official announcement to the Inkscape News on the website, the and the relevant inkscape lists (announce, user, deleveloper)
# Send out the informal announcement (include a link to the webpage with the formal announcement)
# Send out the formal announcement. (include a link to the webpage with the formal announcement)

=Press Release Translations=
Once the English Press Release text has been finalised, translation can start into other languages.

The current goal for this PR text is to have the english version finished by 18th Feb 2008.

Please Create a new Wiki page for planning / translating the 0.46 PR in your language here:

=Press Release Text=
==Small Overview==
Inkscape, the open source vector graphics editor has released version 0.46. Major updates include native PDF support, a paint bucket tool, color profiles, dockable dialogs, SVG Filters, Live Path Effects, and many more features and updates.

==Informal==
===Inkscape Announces 0.46 Release :: http://www.inkscape.org :: Draw Freely.===
The Inkscape community today is announcing the release of the newest version of its open source vector graphics editor. Inkscape 0.46 is a major update that introduces native PDF support. The implementation of PDF support in Inkscape provides an easy, open source solution to editing PDF documents.

A ton of new features and performance improvements are included in this release. Dialogs boxes now have the ability to be docked to the side. Gradients can be edited completely on-canvas now. The new Paint Bucket Tool fills bounded areas with colors and allows quick recoloring of existing objects. A new 3D Box tool helps with creating perspective-correct drawings. A new Tweak tool gives a intuitive method for modifying node paths. The new Live Path Effects feature creates "brushes" and attaches organic effects to paths. Improvements to color management includes support for color spaces other than just sRGB. Most SVG Filters are now implemented, and now have a dedicated UI.

===Download Inkscape 0.46 for Linux, Windows or Mac OS X===
http://inkscape.org/download/

===For More Information===
Complete Release Notes for 0.46, http://wiki.inkscape.org/wiki/index.php/ReleaseNotes046 
Community Contributed Screenshots, http://inkscape.org/screenshots/

===About Inkscape===
Inkscape is an open source drawing tool that uses the World Wide Web Consortium's (W3C) scalable vector graphics format (SVG). Some supported SVG features include basic shapes, paths, text, markers, clones, alpha blending, transforms, gradients, and grouping. In addition, Inkscape supports Creative Commons' metadata, node-editing, layers, complex path operations, text-on-path, text-in-shape, and SVG XML editing. It can also import EPS, PostScript, and most bitmap formats, and exports PNG, PS, PDF and various vector formats.
Inkscape's main motivation is to provide the Open Source community with a fully W3C compliant XML, SVG, and CSS2 drawing tool. Additional work includes conversion of the codebase from C/Gtk to C++/Gtkmm, emphasizing a lightweight core with powerful features added through an extension mechanism, and maintaining a friendly, open, community-oriented development process.

==Formal==
===The Inkscape Community Releases Inkscape 0.46===

New York, NY, '''INSERT DATE OF RELEASE HERE****yyyy/mm/dd****''' -- The Inkscape community today announced the
release of Inkscape 0.46, the newest stable version of their
multi-platform, open-source vector graphics editor.

This newest Inkscape release includes a plethora of new tools and
improvements, beginning with native PDF support. Developed with the
assistance of the 2007 Google Summer of Code, and utilising the open
source Cairo and Poppler libraries, Inkscape 0.46 provides an easy, open
source tool for editing and creating PDF documents.

The 2007 Google Summer of Code also produced the new 3D Box tool and Live Path Effects.

As its name suggests, the 3D Box tool makes it possible to create and
edit the perspective of three-dimensional boxes.

Live Path Effects can be used to create "brushes" and organic effects
while keeping the original paths editable. [This needs to be more
concrete as well.]

The new Tweak Tool allows you to modify objects similar to molding clay.

As well, gradient editing is now done visually and on-canvas. Gradient
stops are depicted as nodes, and multiple nodes can be selected and
moved simultaneously.

Colour management has also been improved, with initial support for
colour spaces other than sRGB, including Adobe RGB and calibrated CMYK.
This makes it possible to use calibrated colour values, including CMYK
values, that are preserved across applications.

The new Paint Bucket Tool allows bounded areas to be filled with colour
at the click of a mouse button. This new tool creates a closed-path
based on the visible canvas and is useful for quickly colouring line
drawings.

The Gaussian Blur filter, introduced in Inkscape 0.45, was the first SVG
Filter. Inkscape 0.46 expands on this with Offset, Blend, Diffuse
Lighting, Specular Lighting and Turbulence primitives. There is also a
new, dedicated user interface for creating and altering filters based on
these new primitives.

Finally, Inkscape 0.46 introduces workflow and user interface
improvements. Dialogue boxes can now be docked and minimised to a
side-panel, reducing visual clutter and making the relationship between
documents and interaction choices clearer, especially when working on
multiple documents in separate Inkscape instances.

With 0.46 out, the Inkscape community is already working on future
releases, including the upcoming 0.47. Full compatibility with SVG
Mobile/Tiny is slated for version 0.50 and version 1.0 will include
complete W3C SVG 1.1 compliance.

Inkscape users have contributed many features and ideas to the project
and the community invites anyone to contribute to the project. The more
help Inkscape gets, the sooner we reach these goals.

<strike>
The Inkscape community today announced the release of the newest version of their multi platform, open source vector graphics editor, Inkscape 0.46. The latest installment of Inkscape is a feature filled release that introduces a large number of new tools and improvements, including native PDF support. Utilizing the open source libraries of Cairo and Poppler, and developed with the assistance of the Google Summer of Code, Inkscape's PDF support provides an easy, open source solution to editing PDF documents.

Inkscape 0.46 introduces improvements that provides enhanced work flow that complements creativity. Dialogs boxes now have the ability to be docked and minimized to a side panel, enhancing the user experience when editing multiple documents in separate inkscape instances. Gradient editing can now be done visually on-canvas, with gradient stops being depicted as nodes and the abilty to select and move multiple stops simultaneously. Color management has also been improved, with initial support for color definitions that use a colorspace other than sRGB (for example Adobe RGB, or calibrated CMYK colors). This allows for the use of calibrated color spaces, including using CMYK values that are preserved across applications.

The new Paint Bucket Tool allows bounded areas to be quickly filled in with color. It creates a closed path based on the visible canvas and is useful for quickly coloring line drawings. Additional functionality produced by the Google Summer of Code 2007 include the new 3D Box tool, the Tweak tool and Live Path Effects. The Tweak Tool allows smooth and natural change of the shape or style of objects directly on canvas. Live Path Effects can be used to create "brushes" and all kinds of organic effects, while keeping the original paths editable.

Inkscape 0.45 introduced SVG Filters with the Gussian Blur filter primitive; Inkscape 0.46 greatly expands on this by adding the Offset, Blend, Diffuse Lighting, Specular Lighting and Turbulence primitives. As well, there is a new dedicated user interface for creation and alteration of complex filters based on these primitives.

The Inkscape community is now working on the upcoming 0.47 release and invites you to contribute to the project. Beyond that, Inkscape is pushing for full compatibility with SVG Mobile/Tiny by version 0.50, and full W3C SVG 1.1 compliance by Inkscape 1.0. Users have also contributed many great feature ideas in addition to this; the more help the project receives, the faster these goals and ideas can be achieved.
</strike>

===Download Inkscape 0.46 for Linux, Windows or Mac OS X===
http://inkscape.org/download/

===For More Information===

Complete Release Notes for 0.46, http://wiki.inkscape.org/wiki/index.php/ReleaseNotes046 
Community Contributed Screenshots, http://inkscape.org/screenshots/

===About Inkscape===
Inkscape is a multi platform, open source drawing tool that uses the World Wide Web Consortium's (W3C) scalable vector graphics format (SVG). Some supported SVG features include basic shapes, paths, text, markers, clones, alpha blending, transforms, gradients, and grouping. In addition, Inkscape supports Creative Commons' metadata, node-editing, layers, complex path operations, text-on-path, text-in-shape, and SVG XML editing. It can also import EPS, PostScript, and most bitmap formats, and exports PNG, PS, PDF and various vector formats.
Inkscape's main motivation is to provide the Open Source community with a fully W3C compliant XML, SVG, and CSS2 drawing tool. Additional work includes conversion of the codebase from C/Gtk to C++/Gtkmm, emphasizing a lightweight core with powerful features added through an extension mechanism, and maintaining a friendly, open, community-oriented development process.

=Places to Announce=

In general, for linux community receives a general informal announcement. However, for formal press channels we use the more formal 3rd-person press release.

== Receive small overview ==
{|style="background:#f2f2f2;"
!style="text-align:left;background-color:#d3d7cf;width:20%;"|Contact Name
!style="text-align:left;background-color:#d3d7cf;width:30%;"|Who will contact / post
!style="text-align:left;background-color:#d3d7cf;width:50%;"|Notes...
|-style="border-bottom:white 2px solid;"
|Digg
|ryanlerch
|digg.com someone needs to post a short excerpt anouncing the release, and link it to inkscape.org.
|-style="border-bottom:white 2px solid;"
|slashdot.org
|ryanlerch
|submit a new news item.
|-
|-style="border-bottom:white 2px solid;"
|newsvine.com/
|ryanlerch
|submit a new news item.
|-
|}

== Receive Informal PR ==
=== Open Source Community ===
{| style="background:#f2f2f2;"
!style="text-align:left;background-color:#d3d7cf;width:20%;"|Contact Name
!style="text-align:left;background-color:#d3d7cf;width:30%;"|Who will contact / post
!style="text-align:left;background-color:#d3d7cf;width:50%;"|Notes...
|- style="border-bottom:white 2px solid;"
|gnome office list
|
|gnome-office-list at gnome dot org
|-style="border-bottom:white 2px solid;"
|svg developers yahoo group
|
|svg-developers at yahoo dot com must join the list to send (rejon is on)
|-style="border-bottom:white 2px solid;"
|SVG.org
|ryanlerch
|antoine at graougraou dot com, svg at steltenpower dot com
|-style="border-bottom:white 2px solid;"
|svgfaq.org
|ryanlerch
|maxdunn at siliconpublishing dot com
|-style="border-bottom:white 2px solid;"
|svgfoundation.org
|ryanlerch
|michael (at) svgfoundation.org
|-style="border-bottom:white 2px solid;"
|cairo list
|ryanlerch
|cairo at cairographics dot org
|-style="border-bottom:white 2px solid;"
|gnome-list
|ryanlerch
|gnome-announce-list at gnome dot org
|-style="border-bottom:white 2px solid;"
|Scribus List (mrdocs)
|ryanlerch
|scribus at nashi dot altmuehlnet dot de
|-style="border-bottom:white 2px solid;"
|osnews.com
|ryanlerch
|http://osnews.com/submit.php
|-style="border-bottom:white 2px solid;"
|desktoplinux.com
|ryanlerch
|http://desktoplinux.com/contactus.html
|-style="border-bottom:white 2px solid;"
|SVG Cafe.com
|ryanlerch
|http://www.svg-cafe.com/ join and post to news section
|-style="border-bottom:white 2px solid;"
|Freshmeat.net
|
|a new release has to be added to inkscape's freshmeat profile
|-style="border-bottom:white 2px solid;"
|gnome footnotes
|
|http://gnomedesktop.org/node/add/story
|-style="border-bottom:white 2px solid;"
|scale-a-vector
|ryanlerch
|kukofka at scale-a-vector dot de http://www.scale-a-vector.de/cont.htm
|-style="border-bottom:white 2px solid;"
|http://dot.kde.org
|ryanlerch
|http://dot.kde.org/addPostingForm
|-style="border-bottom:white 2px solid;"
|revelinux.com
|ryanlerch
|theobroma at revelinux dot com
|-style="border-bottom:white 2px solid;"
|}

=== Broader Inkscape & Art Community ===
{|style="background:#f2f2f2;"
!style="text-align:left;background-color:#d3d7cf;width:20%;"|Contact Name
!style="text-align:left;background-color:#d3d7cf;width:30%;"|Who will contact / post?
!style="text-align:left;background-color:#d3d7cf;width:50%;"|Notes...
|-style="border-bottom:white 2px solid;"
|Inkscape deviantart group
|ScislaC
|http://inkscape.deviantart.com/
|
|-style="border-bottom:white 2px solid;"
|the inkscape forum
| ryanlerch
|http://www.inkscapeforum.com/ run by microUgly
|-style="border-bottom:white 2px solid;"
|inkscape tutorials blog
|ryanlerch
|http://inkscapetutorials.wordpress.com/
|-
|-style="border-bottom:white 2px solid;"
|open clip art library list
|ryanlerch
|clipart@freedesktop.org
|-style="border-bottom:white 2px solid;"
|open clip art library news
|ryanlerch
|
|-style="border-bottom:white 2px solid;"
|artdc.org forum
|johncoswell
|http://www.artdc.org/
|-style="border-bottom:white 2px solid;"
|bittbox.com - vector art blog
|ryanlerch
|contact(at)bittbox.com
|-style="border-bottom:white 2px solid;"
|The Daily Ubuntu - Daily Ubuntu Applications
|ryanlerch
|http://www.contactify.com/35b54
|-style="border-bottom:white 2px solid;"
|
|
|
|-style="border-bottom:white 2px solid;"
|
|
|
|-
|}

== Receive Formal PR ==
{|style="background:#f2f2f2;"
!style="text-align:left;background-color:#d3d7cf;width:20%;"|Contact Name
!style="text-align:left;background-color:#d3d7cf;width:30%;"|Who will contact / post?
!style="text-align:left;background-color:#d3d7cf;width:50%;"|Notes...
|-style="border-bottom:white 2px solid;"
|http://linuxformat.co.uk/
|
|login and submit news via top of page link
|-style="border-bottom:white 2px solid;"
|http://linux-magazine.com/
|
|pr(at)linux - magazine (dot) com
|-style="border-bottom:white 2px solid;"
|http://linuxjournal.com/
|
|newproducts (at) ssc (dot) com
|-style="border-bottom:white 2px solid;"
|http://linuxmagazine.com/
|
|jbrockmeier at linux hyphen mag DOT com.
|-style="border-bottom:white 2px solid;"
|http://linuxuser.co.uk
|
|terry at linuxuser dot co dot uk http://linuxuser.co.uk/index.php?option=com_content&task=view&id=48&Itemid=40
|-style="border-bottom:white 2px solid;"
|http://www.tuxmagazine.com/
|
|editor at tuxmagazine dot com
|-style="border-bottom:white 2px solid;"
|http://www.linuxworld.com/
|
|mrhinkle at linuxworld dot com tim at linuxworld dot com
|-style="border-bottom:white 2px solid;"
|http://cmykmag.com/
|
|
|-style="border-bottom:white 2px solid;"
|http://www.computerarts.co.uk/
|
|dom dot hall at futurenet dot co dot uk http://www.computerarts.co.uk/contacts
|-style="border-bottom:white 2px solid;"
|http://www.theopensourcereport.com/
|ryanlerch
|contact at theopensourcereport dot com
|-style="border-bottom:white 2px solid;"
|http://www.builderau.com.au/
|ryanlerch
|Chris Duckett, editor at builderau dot com dot au
|-style="border-bottom:white 2px solid;"
|http://www.zdnet.com.au
|ryanlerch
|edit at zdnet dot com dot au
|-style="border-bottom:white 2px solid;"
|
|
|
|-style="border-bottom:white 2px solid;"
|
|
|
|-style="border-bottom:white 2px solid;"
|
|
|
|-
|}

=== Other ===

* [http://openpr.com openpr] - http://openpr.com/news/submit.html
* nettime-ann - http://www.nettime.org/
* See Kansas City infoZine: http://www.infozine.com/news/stories/op/storiesView/sid/5080/
* http://graphicdesign.about.com
* http://graphicssoft.about.com
* http://desktoppublishing.about.com

CompilingUbuntu

2005-12-20T06:55:04Z

Verbalshadow: Added Breezy info

The following packages are need to compile cvs inkscape under a default Ubuntu Hoary/Breezy system:
apt-get install cvs build-essential intltool libtool libgtkmm-2.4-dev libglib2.0-dev libpng12-dev libxslt1-dev libsigc++-2.0-dev libpopt-dev libgc-dev

Inkscape requires libgc-6.4.

Breezy doesn't require any further work.

Hoary uses version 6.3 is provided in the Repos. (Is there somewhere to get a .deb for 6.4?)

To overwrite libgc-6.3 with libgc-6.4:
Download gc6.4
./configure --prefix=/usr
make
sudo make install

== libgc 6.5 debs for ubuntu ==

http://inkscape.modevia.com/ap/libgc-dev_6.5-1_i386.deb

http://inkscape.modevia.com/ap/libgc1_6.5-1_i386.deb

BugParty

2005-09-19T19:09:50Z

Verbalshadow: added links to get current dev builds

= Bug Party =

== Announcement: ==

Bug Party Invitation

In an effort to organize the bug tracker and the feature tracker, the Inkscape project will organize a "Bug Party" on Saturday, September 24, 2005. This is an opportunity for new contributors and non-developers to help the project.

All day long (in the US time) the IRC channel #inkscape on server irc.freenode.org will be open, along with the correspondent Jabber room (see http://inkscape.org/discussion.php for more details). We expect to reach peak hours at 16-20 UTC on September 24 (8-12 PST) and 0-4 UTC on September 25 (16-20 PST on September 24) and guarantee presence of core Inkscape developers on those time intervals.

For additional information, rules and information, a Wiki page is available: http://wiki.inkscape.org/cgi-bin/wiki.pl?BugParty

We await you!

To be distributed at:
* Inkscape users list;
* Inkscape test list;
* Openclipart list;
* Scribus list?;
* news item on front page (aggregated to various Planet sites).

== Fun Stuff: ==
* Color logo: http://nicubunu.ro/pictures/inkscape/debug.png
* Black and white: http://nicubunu.ro/pictures/inkscape/debug_bw.png

== Objectives: ==
* trim down the number of open bugs/enhancement request. we should find old bugs which are not existing anymore, features already implemented and not closed in the tracker, duplicates and, why not, quick fixes.

== Rules: ==
* if a bug report is one release old/one month old, we can't reproduce it and don't have any follow-up from the poster, it can be closed;

== Procedures: ==
* is possible to post to the tracker without login to sourceforge.net, but a login is recommended, because this improve your ability to follow-up a post;
* not everyone is allowed to close a bug, so people without this right should comment in the bug reasoning why the bug should be closed (is a duplicate, not happen anymore, can't be reproduced). We should define a way to work after that, alternatives are:
** put in a message a special string, like TOCLOSE, which can be queried later, for closure;
** announce the bug number on the chat channel, so it can be closed interactively;
** put the URL of the bug in the wiki page.

== Tools: ==
* a new version of Inkscape will be needed [to determine later what version: 0.42.2, CVS build, etc.)
** Easy ways get builds.
*** Daily Win32 builds http://www.inkscape.org/win32-snap/
*** Linux AutoPackages http://inkscape.modevia.com/ap/
** Build Your Own
*** Working with CVS http://wiki.inkscape.org/cgi-bin/wiki.pl?WorkingWithCVS and Compiling Inkscape http://wiki.inkscape.org/cgi-bin/wiki.pl?CompilingInkscape
* the Inkscape bug tracker at sf.net: http://sourceforge.net/tracker/?group_id=93438&atid=604306
* the Inkscape feature tracker at sf.net: http://sourceforge.net/tracker/?group_id=93438&atid=604309
* the Wiki page: http://wiki.inkscape.org/cgi-bin/wiki.pl?BugParty
* the Inkscape developer mailing list: inkscape-devel AT lists.sourceforge.net

Compiling Inkscape

2005-03-16T12:55:54Z

Verbalshadow:

Hopefully, Inkscape will compile right out of the box. If it doesn't, well that's what this page is for.

Jot down notes, questions, findings, tips, etc. here on things you run into. It's a good idea to
make mention of what version of the code you're trying to compile, the distribution you're running,
and other such information that might be pertinent.

If legitimate bugs are found or patches developed, please move them to the tracker at Sourceforge
rather than inlining them here.

= Notes =
Inkscape needs automake1.7 or automake1.8 to compile NOT automake1.9 it has a bug ( link: http://sourceforge.net/mailarchive/message.php?msg_id=10288631 ) that prevents compiling of Inkscape. If you have already tried to do a $ make with automake1.9 then $ ./autogen.sh from your inkscape-cvs dir and proceed as normal.

= OS & Distribution Specific =
* '''Linux'''
** [[CompilingFedora|Fedora]]
** [[CompilingGentoo|Gentoo]]
** [[CompilingDebian|Debian]]
** [[CompilingYellowDog|Yellow Dog]]
** [[CompilingSuse|Suse]]
** [[CompilingSlackware|Slackware]]
** [[CompilingYoper|Yoper]]
** [[CompilingMandrake|Mandrakelinux]]
* [[CompilingMacOsX|Mac OS X]]
* [[Win32Port|Windows]]
* [[CompilingSPARC|SPARC]]
* [[CompilingSunSolaris|Sun Solaris]]
* [[CompilingStatic|Static Compiles]]

= Package Config (pkg-config) =

If you must compile and install any of these from source, you may find an error like this when trying to
compile them or Inkscape itself:

checking for gtk+-2.0 >= 2.0.0 libxml-2.0 >= 2-2.4.24 sigc++-1.2 gtkmm-2.0... Package gtkmm-2.0 was not found in the pkg-config search path.
Perhaps you should add the directory containing `gtkmm-2.0.pc'
to the PKG_CONFIG_PATH environment variable
No package 'gtkmm-2.0' found

A solution is to set the PKG_CONFIG_PATH variable as so:

for bash:
export PKG_CONFIG_PATH=/usr/local/bin/pkgconfig:/usr/lib/pkgconfig
for csh:
setenv PKG_CONFIG_PATH /usr/local/lib/pkgconfig:/usr/lib/pkgconfig

A good place to put this line is in your .bashrc or .cshrc file

= Getting and Installing Source packages =

If your distro does not have some packages available (like many don't, ie, Fedora Core 2), you must often download
source packages and build and install them yourself. Actually this is not that hard, and is similar to
doing a Gentoo 'emerge.'

* Usually you download a file with a name like somepackage-1.0.tar.gz. Unpack it with

$ tar zxf somepackage-1.0.tar.gz
or
$ tar jxf somepackage-1.0.tar.bz2

* Then 'cd' into the new directory.

* Configure it with the command:

$ ./configure

* Build it with:

$ make

* As the 'root' user, install it with:

$ make install

== Boehm-GC ==

Source: http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc6.4.tar.gz

[Note that for old 0.40CVS development versions we used the C++ version of gc, so you need to compile it with the --enable-cplusplus; we didn't include that version in any of the official releases though.]

Also, if searching for a package for GC, the name of it is sometimes:

* gc
* libgc
* libgc-devel
* boehm-gc (on Gentoo)

== libSigc++ ==

Source: http://sourceforge.net/project/showfiles.php?group_id=1970&package_id=76644

With this file, and for GlibMM and GtkMM below, it is usually desirable for us developers to
build this C++ library statically. This removes a dependency that might be difficult for an
end-user during installation. Configure it with:

./configure --enable-static --disable-shared

== GlibMM ==

Source: http://ftp.gnome.org/pub/GNOME/sources/glibmm/2.4/

== GtkMM ==

Source: http://ftp.gnome.org/pub/GNOME/sources/gtkmm/2.4/

= Developer Compilation =

Plain vanilla compilation is done as documented in INSTALL; ./autogen.sh (optionally); ./configure; make; su && make test; make install (optional). See INSTALL for more on that.

But if you're going to be doing a lot of development, there's some tricks and techniques you should know,
to get best results.

# Turn off optimization
# Use ccache for faster compilation
# Set up a separate build directory (nice for testing both gcc and g++, or cross compiling)
# Use the -j N flag to optimize for the number of processors in your machine, with N = 1 + no. proc's

Example: Setting up both gcc and g++ build environments (in separate tree), and using ccache for faster
compilations on a dual-processor machine, with no optimization, assuming /bin/bash:

mkdir build-gcc build-g++
cvs checkout inkscape
cd inkscape
libtoolize --copy --force
./autogen.sh
cd ../build-gcc
CFLAGS='-g -O0 -Wall' CC='ccache gcc' ../inkscape/configure
cd ../build-g++
CXXFLAGS='-g -O0 -Wall' CXX='ccache g++' ../inkscape/configure
cd build-gcc && make -j 3
cd build-g++ && make -j 3

Turning off just optimization (which can produce strange results in debuggers):

export CC=g++
export CXXFLAGS='-g -O0 -Wall'
export CFLAGS='-g -O0 -Wall'
./configure