Olena-patches
Threads by month
- ----- 2025 -----
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2024 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2023 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2022 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2021 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2020 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2019 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2018 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2017 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2016 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2015 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2014 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2013 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2012 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2011 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2010 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2009 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2008 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2007 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2006 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2005 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- February
- January
- ----- 2004 -----
- December
- November
- October
- September
- August
- July
- June
- May
- April
- March
- 9625 discussions
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Olena, a generic and efficient image processing platform".
The branch unstable/scribo has been updated
via c471618c68f0572f188c1851e2a016d92ca42855 (commit)
from e9bb20fdca74a67c31321df1050a0937d69600e8 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
c471618 src/Makefile.am: Remove -lpthread.
-----------------------------------------------------------------------
Summary of changes:
scribo/ChangeLog | 4 ++++
scribo/src/Makefile.am | 1 -
2 files changed, 4 insertions(+), 1 deletions(-)
hooks/post-receive
--
Olena, a generic and efficient image processing platform
1
0
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "Olena, a generic and efficient image processing platform".
The branch unstable/scribo has been updated
discards c471618c68f0572f188c1851e2a016d92ca42855 (commit)
This update discarded existing revisions and left the branch pointing at
a previous point in the repository history.
* -- * -- N (e9bb20fdca74a67c31321df1050a0937d69600e8)
\
O -- O -- O (c471618c68f0572f188c1851e2a016d92ca42855)
The removed revisions are not necessarilly gone - if another reference
still refers to them they will stay in the repository.
No new revisions were added by this update.
Summary of changes:
scribo/ChangeLog | 4 ----
scribo/src/Makefile.am | 1 +
2 files changed, 1 insertions(+), 4 deletions(-)
hooks/post-receive
--
Olena, a generic and efficient image processing platform
1
0
---
scribo/ChangeLog | 4 ++++
scribo/src/Makefile.am | 1 -
2 files changed, 4 insertions(+), 1 deletions(-)
diff --git a/scribo/ChangeLog b/scribo/ChangeLog
index db9fca4..0d24f37 100644
--- a/scribo/ChangeLog
+++ b/scribo/ChangeLog
@@ -1,3 +1,7 @@
+2011-12-01 Guillaume Lazzara <z(a)lrde.epita.fr>
+
+ * src/Makefile.am: Remove -lpthread.
+
2011-11-30 Guillaume Lazzara <z(a)lrde.epita.fr>
* scribo/text/recognition.hh: Make some includes conditional.
diff --git a/scribo/src/Makefile.am b/scribo/src/Makefile.am
index 26f2ade..08dc3ce 100644
--- a/scribo/src/Makefile.am
+++ b/scribo/src/Makefile.am
@@ -92,7 +92,6 @@ if HAVE_TESSERACT
$(MAGICKXX_CPPFLAGS) \
-I$(top_builddir)
text_recognition_in_picture_LDFLAGS = $(AM_LDFLAGS) \
- -lpthread \
$(TESSERACT_LDFLAGS) \
$(TIFF_LDFLAGS) \
$(MAGICKXX_LDFLAGS)
--
1.7.2.5
1
0
olena-2.0-25-g81cd3b6 Add an image for illustrating Milena's possibilities.
by Guillaume Lazzara 29 Nov '11
by Guillaume Lazzara 29 Nov '11
29 Nov '11
---
milena/doc/img/genericity.png | Bin 0 -> 135325 bytes
milena/doc/img/src/genericity.svg | 354 +++++++++++++++++++++++++++++++++++++
milena/doc/mainpage.dox | 93 +++++-----
3 files changed, 404 insertions(+), 43 deletions(-)
create mode 100644 milena/doc/img/genericity.png
create mode 100644 milena/doc/img/src/genericity.svg
diff --git a/milena/doc/img/genericity.png b/milena/doc/img/genericity.png
new file mode 100644
index 0000000000000000000000000000000000000000..e9d7378ac31e7199708d7556def6205fd21eed8d
GIT binary patch
literal 135325
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	xtp#VB4V_!ov(KeHI7{QO&O5O`1xHlR
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
Ra8kfORV6LOf?M}P{|`xh17-jK
literal 0
HcmV?d00001
diff --git a/milena/doc/img/src/genericity.svg b/milena/doc/img/src/genericity.svg
new file mode 100644
index 0000000..ef8b914
--- /dev/null
+++ b/milena/doc/img/src/genericity.svg
@@ -0,0 +1,354 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+ xmlns:dc="http://purl.org/dc/elements/1.1/"
+ xmlns:cc="http://creativecommons.org/ns#"
+ xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+ xmlns:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+ width="2099.5906"
+ height="1353.4995"
+ id="svg2"
+ version="1.1"
+ inkscape:version="0.47 r22583"
+ sodipodi:docname="genericity.svg">
+ <defs
+ id="defs4">
+ <marker
+ inkscape:stockid="Arrow1Lend"
+ orient="auto"
+ refY="0"
+ refX="0"
+ id="Arrow1Lend"
+ style="overflow:visible">
+ <path
+ id="path4297"
+ d="M 0,0 5,-5 -12.5,0 5,5 0,0 z"
+ style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+ transform="matrix(-0.8,0,0,-0.8,-10,0)" />
+ </marker>
+ <marker
+ inkscape:stockid="Arrow1Lstart"
+ orient="auto"
+ refY="0"
+ refX="0"
+ id="Arrow1Lstart"
+ style="overflow:visible">
+ <path
+ id="path4294"
+ d="M 0,0 5,-5 -12.5,0 5,5 0,0 z"
+ style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt;marker-start:none"
+ transform="matrix(0.8,0,0,0.8,10,0)" />
+ </marker>
+ <inkscape:perspective
+ sodipodi:type="inkscape:persp3d"
+ inkscape:vp_x="0 : 526.18109 : 1"
+ inkscape:vp_y="0 : 1000 : 0"
+ inkscape:vp_z="744.09448 : 526.18109 : 1"
+ inkscape:persp3d-origin="372.04724 : 350.78739 : 1"
+ id="perspective10" />
+ <inkscape:perspective
+ id="perspective2956"
+ inkscape:persp3d-origin="0.5 : 0.33333333 : 1"
+ inkscape:vp_z="1 : 0.5 : 1"
+ inkscape:vp_y="0 : 1000 : 0"
+ inkscape:vp_x="0 : 0.5 : 1"
+ sodipodi:type="inkscape:persp3d" />
+ <inkscape:perspective
+ id="perspective3030"
+ inkscape:persp3d-origin="0.5 : 0.33333333 : 1"
+ inkscape:vp_z="1 : 0.5 : 1"
+ inkscape:vp_y="0 : 1000 : 0"
+ inkscape:vp_x="0 : 0.5 : 1"
+ sodipodi:type="inkscape:persp3d" />
+ <inkscape:perspective
+ id="perspective3104"
+ inkscape:persp3d-origin="0.5 : 0.33333333 : 1"
+ inkscape:vp_z="1 : 0.5 : 1"
+ inkscape:vp_y="0 : 1000 : 0"
+ inkscape:vp_x="0 : 0.5 : 1"
+ sodipodi:type="inkscape:persp3d" />
+ <inkscape:perspective
+ id="perspective3253"
+ inkscape:persp3d-origin="0.5 : 0.33333333 : 1"
+ inkscape:vp_z="1 : 0.5 : 1"
+ inkscape:vp_y="0 : 1000 : 0"
+ inkscape:vp_x="0 : 0.5 : 1"
+ sodipodi:type="inkscape:persp3d" />
+ <inkscape:perspective
+ id="perspective3363"
+ inkscape:persp3d-origin="0.5 : 0.33333333 : 1"
+ inkscape:vp_z="1 : 0.5 : 1"
+ inkscape:vp_y="0 : 1000 : 0"
+ inkscape:vp_x="0 : 0.5 : 1"
+ sodipodi:type="inkscape:persp3d" />
+ <inkscape:perspective
+ id="perspective3437"
+ inkscape:persp3d-origin="0.5 : 0.33333333 : 1"
+ inkscape:vp_z="1 : 0.5 : 1"
+ inkscape:vp_y="0 : 1000 : 0"
+ inkscape:vp_x="0 : 0.5 : 1"
+ sodipodi:type="inkscape:persp3d" />
+ </defs>
+ <sodipodi:namedview
+ id="base"
+ pagecolor="#ffffff"
+ bordercolor="#666666"
+ borderopacity="1.0"
+ inkscape:pageopacity="0.0"
+ inkscape:pageshadow="2"
+ inkscape:zoom="0.32014852"
+ inkscape:cx="1160.7884"
+ inkscape:cy="650.81386"
+ inkscape:document-units="px"
+ inkscape:current-layer="layer1"
+ showgrid="false"
+ inkscape:window-width="1592"
+ inkscape:window-height="1149"
+ inkscape:window-x="0"
+ inkscape:window-y="0"
+ inkscape:window-maximized="1" />
+ <metadata
+ id="metadata7">
+ <rdf:RDF>
+ <cc:Work
+ rdf:about="">
+ <dc:format>image/svg+xml</dc:format>
+ <dc:type
+ rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+ <dc:title></dc:title>
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <g
+ inkscape:label="Calque 1"
+ inkscape:groupmode="layer"
+ id="layer1"
+ transform="translate(596.74498,224.88271)">
+ <rect
+ style="fill:#fff6d5;stroke:#000000;stroke-width:4;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none"
+ id="rect2885"
+ width="893.33527"
+ height="409.18506"
+ x="602.84521"
+ y="419.55798"
+ transform="translate(-596.74498,-224.88271)"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75" />
+ <g
+ id="g3451"
+ transform="translate(-318.60213,374.82603)"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75">
+ <image
+ xlink:href="file:///home/lazzara/svn/lrde-publis/trunk/lrde-a2si/levillain.10.icip/figs/bunny-holefilled.png"
+ width="450"
+ height="450"
+ id="image2958"
+ x="-278.14285"
+ y="-138.3521" />
+ <image
+ xlink:href="file:///home/lazzara/svn/lrde-publis/trunk/lrde-a2si/levillain.10.icip/figs/classgradi.png"
+ width="454.28574"
+ height="448.57144"
+ id="image3106"
+ x="-278.14285"
+ y="305.21933" />
+ <image
+ xlink:href="file:///home/lazzara/svn/lrde-publis/trunk/lrde-a2si/levillain.10.icip/figs/lena.png"
+ width="452"
+ height="460.57141"
+ id="image3365"
+ x="-278.14285"
+ y="-599.70874" />
+ </g>
+ <g
+ id="g3456"
+ transform="translate(371.7026,371.07634)"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75">
+ <image
+ xlink:href="file:///home/lazzara/svn/lrde-publis/trunk/lrde-a2si/levillain.10.icip/figs/bunny-holefilled-complex-pinv-curv-area-500-segm.png"
+ width="450"
+ height="450"
+ id="image3032"
+ x="681.14288"
+ y="-144.06639" />
+ <image
+ xlink:href="file:///home/lazzara/svn/lrde-publis/trunk/lrde-a2si/levillain.10.icip/figs/classwst2b.png"
+ width="448.57144"
+ height="451.42856"
+ id="image3255"
+ x="681.14288"
+ y="305.21933" />
+ <image
+ xlink:href="file:///home/lazzara/svn/lrde-publis/trunk/lrde-a2si/levillain.10.icip/figs/lena-s.png"
+ width="449.14285"
+ height="449.14285"
+ id="image3439"
+ x="681.14288"
+ y="-595.06647" />
+ </g>
+ <g
+ id="g3471"
+ transform="translate(-74.310365,74.19173)"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75">
+ <rect
+ y="271.47461"
+ x="109.32426"
+ height="212.40141"
+ width="368.57892"
+ id="rect3463"
+ style="fill:#f9f9f9;stroke:#000000;stroke-width:0.96799999;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none" />
+ <text
+ id="text3465"
+ y="355.81046"
+ x="299.86081"
+ style="font-size:40px;font-style:normal;font-weight:normal;fill:#000000;fill-opacity:1;stroke:none;font-family:Bitstream Vera Sans"
+ xml:space="preserve"><tspan
+ style="font-size:64px;text-align:center;text-anchor:middle"
+ y="355.81046"
+ x="299.86081"
+ id="tspan3467"
+ sodipodi:role="line">Area</tspan><tspan
+ style="font-size:64px;text-align:center;text-anchor:middle"
+ id="tspan3469"
+ y="435.81046"
+ x="299.86081"
+ sodipodi:role="line">Closing</tspan></text>
+ </g>
+ <g
+ transform="translate(390.90885,74.19173)"
+ id="g3477"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75">
+ <rect
+ style="fill:#f9f9f9;stroke:#000000;stroke-width:0.96799999;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none"
+ id="rect3479"
+ width="368.57892"
+ height="212.40141"
+ x="109.32426"
+ y="271.47461" />
+ <text
+ xml:space="preserve"
+ style="font-size:40px;font-style:normal;font-weight:normal;fill:#000000;fill-opacity:1;stroke:none;font-family:Bitstream Vera Sans"
+ x="299.86081"
+ y="355.81046"
+ id="text3481"><tspan
+ sodipodi:role="line"
+ id="tspan3483"
+ x="299.86081"
+ y="355.81046"
+ style="font-size:64px;text-align:center;text-anchor:middle">Watershed</tspan><tspan
+ sodipodi:role="line"
+ x="299.86081"
+ y="435.81046"
+ id="tspan3485"
+ style="font-size:64px;text-align:center;text-anchor:middle">Flooding</tspan></text>
+ </g>
+ <path
+ style="fill:none;stroke:#000000;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:none;marker-end:url(#Arrow1Lend)"
+ d="m -150.28848,868.07272 97.529943,0"
+ id="path3489"
+ inkscape:connector-type="polyline"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75" />
+ <path
+ style="fill:none;stroke:#000000;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;display:inline;stroke-miterlimit:4;stroke-dasharray:none"
+ d="m -53.008405,868.20786 0,-417.43053"
+ id="path3497"
+ inkscape:connector-type="polyline"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75" />
+ <path
+ style="fill:none;stroke:#000000;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-miterlimit:4;stroke-opacity:1;stroke-dasharray:none;marker-end:url(#Arrow1Lend);display:inline"
+ d="m -146.72366,447.18288 176.387083,0"
+ id="path3499"
+ inkscape:connector-type="polyline"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75" />
+ <path
+ style="fill:none;stroke:#000000;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:none;marker-end:url(#Arrow1Lend)"
+ d="m -145.2169,33.058748 94.965307,1.096259"
+ id="path3503"
+ inkscape:connector-type="polyline"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75" />
+ <path
+ style="fill:none;stroke:#000000;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:none"
+ d="M -50.802426,34.161751 -53.005703,453.80623"
+ id="path3505"
+ inkscape:connector-type="polyline"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75" />
+ <path
+ style="fill:none;stroke:#000000;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:none;marker-end:url(#Arrow1Lend)"
+ d="m 399.54619,447.18288 99.84184,0"
+ id="path3507"
+ inkscape:connector-type="polyline"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75" />
+ <path
+ style="fill:none;stroke:#000000;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-end:url(#Arrow1Lend);stroke-miterlimit:4;stroke-dasharray:none"
+ d="m 870.39821,451.60025 182.96699,0"
+ id="path3511"
+ inkscape:connector-type="polyline"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75" />
+ <path
+ style="fill:none;stroke:#000000;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:none"
+ d="m 971.82078,915.97919 0,-934.831771"
+ id="path3513"
+ inkscape:connector-type="polyline"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75" />
+ <path
+ style="fill:none;stroke:#000000;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-end:url(#Arrow1Lend);stroke-miterlimit:4;stroke-dasharray:none"
+ d="m 971.46519,915.4238 93.19981,0"
+ id="path3515"
+ inkscape:connector-type="polyline"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75" />
+ <path
+ style="fill:none;stroke:#000000;stroke-width:4;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;stroke-miterlimit:4;stroke-dasharray:none;marker-end:url(#Arrow1Lend)"
+ d="m 971.65505,-18.849357 80.69205,0"
+ id="path3517"
+ inkscape:connector-type="polyline"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75" />
+ <text
+ xml:space="preserve"
+ style="font-size:40px;font-style:normal;font-weight:normal;fill:#000000;fill-opacity:1;stroke:none;font-family:Bitstream Vera Sans"
+ x="181.01906"
+ y="285.25821"
+ id="text2887"
+ inkscape:export-filename="/home/lazzara/git/oln/milena/doc/img/genericity.png"
+ inkscape:export-xdpi="75"
+ inkscape:export-ydpi="75"><tspan
+ sodipodi:role="line"
+ id="tspan2889"
+ x="181.01906"
+ y="285.25821"
+ style="font-size:64px">Generic workflow</tspan></text>
+ </g>
+</svg>
diff --git a/milena/doc/mainpage.dox b/milena/doc/mainpage.dox
index df9eac0..cf9bec8 100644
--- a/milena/doc/mainpage.dox
+++ b/milena/doc/mainpage.dox
@@ -7,6 +7,11 @@ image processing as well as algorithms, in particular in the field of
mathematical morphology. It is used as the base image processing
library in all Olena modules.
+<center><h2>Write once, run on many kinds of images.</h2></center>
+\image html genericity.png
+\image latex genericity.png
+
+
\subsection mlnimagestruct Images and Structures
Milena can be used on:
@@ -57,49 +62,51 @@ image.
\section mln_sec Overview of Milena.
- <UL>
- <LI> \ref mln
- <LI> \ref mln::accu
- <LI> \ref mln::algebra
- <LI> \ref mln::arith
- <LI> \ref mln::binarization
- <LI> \ref mln::border
- <LI> \ref mln::canvas
- <LI> \ref mln::convert
- <LI> \ref mln::data
- <LI> \ref mln::debug
- <LI> \ref mln::display
- <LI> \ref mln::draw
- <LI> \ref mln::estim
- <LI> \ref mln::extension
- <LI> \ref mln::fun
- <LI> \ref mln::geom
- <LI> \ref mln::graph
- <LI> \ref mln::histo
- <LI> \ref mln::io
- <LI> \ref mln::labeling
- <LI> \ref mln::data
- <LI> \ref mln::linear
- <LI> \ref mln::literal
- <LI> \ref mln::logical
- <LI> \ref mln::make
- <LI> \ref mln::math
- <LI> \ref mln::metal
- <LI> \ref mln::morpho
- <LI> \ref mln::norm
- <LI> \ref mln::opt
- <LI> \ref mln::pw
- <LI> \ref mln::registration
- <LI> \ref mln::set
- <LI> \ref mln::tag
- <LI> \ref mln::test
- <LI> \ref mln::topo
- <LI> \ref mln::trace
- <LI> \ref mln::trait
- <LI> \ref mln::transform
- <LI> \ref mln::util
- <LI> \ref mln::value
- <LI> \ref mln::win
+ Here is a list of the different namespaces/categories of algorithms
+ provided in Milena.
+
+ \li \ref mln
+ \li \ref mln::accu
+ \li \ref mln::algebra
+ \li \ref mln::arith
+ \li \ref mln::binarization
+ \li \ref mln::border
+ \li \ref mln::canvas
+ \li \ref mln::convert
+ \li \ref mln::data
+ \li \ref mln::debug
+ \li \ref mln::display
+ \li \ref mln::draw
+ \li \ref mln::estim
+ \li \ref mln::extension
+ \li \ref mln::fun
+ \li \ref mln::geom
+ \li \ref mln::graph
+ \li \ref mln::histo
+ \li \ref mln::io
+ \li \ref mln::labeling
+ \li \ref mln::data
+ \li \ref mln::linear
+ \li \ref mln::literal
+ \li \ref mln::logical
+ \li \ref mln::make
+ \li \ref mln::math
+ \li \ref mln::metal
+ \li \ref mln::morpho
+ \li \ref mln::norm
+ \li \ref mln::opt
+ \li \ref mln::pw
+ \li \ref mln::registration
+ \li \ref mln::set
+ \li \ref mln::tag
+ \li \ref mln::test
+ \li \ref mln::topo
+ \li \ref mln::trace
+ \li \ref mln::trait
+ \li \ref mln::transform
+ \li \ref mln::util
+ \li \ref mln::value
+ \li \ref mln::win
\section copyright Copyright and License.
Copyright (C) 2007, 2008, 2009, 2010, 2011 EPITA Research and
--
1.7.2.5
1
0
olena-2.0-26-g695a1f2 Add more information in binarization algorithms documentation.
by Guillaume Lazzara 29 Nov '11
by Guillaume Lazzara 29 Nov '11
29 Nov '11
---
scribo/doc/mainpage.dox | 32 +++++++++++-----------
scribo/scribo/binarization/niblack_threshold.hh | 2 +
scribo/scribo/binarization/otsu_threshold.hh | 2 +
scribo/scribo/binarization/sauvola_threshold.hh | 2 +
4 files changed, 22 insertions(+), 16 deletions(-)
diff --git a/scribo/doc/mainpage.dox b/scribo/doc/mainpage.dox
index 77786d9..ffe2185 100644
--- a/scribo/doc/mainpage.dox
+++ b/scribo/doc/mainpage.dox
@@ -10,6 +10,22 @@ Paris-R
the French government, its economic development agencies and by the
Paris-Région institutions.
+<center>
+<table border=0 cellpadding=5>
+<tr>
+<td>\image html olena_mp00419c.png "A document image."</td>
+<td style="vertical-align:center;">\htmlonly<font size="300%">→ </font>\endhtmlonly<td>
+<td style="vertical-align:bottom;">\image html olena_viewer1.png "A GUI for analyzing the content and reconstruct the document."</td>
+<td style="vertical-align:center;">\htmlonly<font size="300%">→ </font>\endhtmlonly<td>
+<td>\image html olena_mp00419c_demat.png "The reconstructed document in PDF."</td>
+</tr>
+</table>
+</center>
+
+\image latex olena_mp00419c.png
+\image latex olena_viewer1.png
+\image latex olena_mp00419c_demat.png
+
It aims at providing the following features:
\li routines for DIA,
@@ -42,22 +58,6 @@ look at the following files :
Take also a look at the <a href="modules.html">Modules section</a>.
-<center>
-<table border=0 cellpadding=5>
-<tr>
-<td>\image html olena_mp00419c.png "A document image."</td>
-<td style="vertical-align:center;">\htmlonly<font size="300%">→ </font>\endhtmlonly<td>
-<td style="vertical-align:bottom;">\image html olena_viewer1.png "A GUI for analyzing the content and reconstruct the document."</td>
-<td style="vertical-align:center;">\htmlonly<font size="300%">→ </font>\endhtmlonly<td>
-<td>\image html olena_mp00419c_demat.png "The reconstructed document in PDF."</td>
-</tr>
-</table>
-</center>
-
-\image latex olena_mp00419c.png
-\image latex olena_viewer1.png
-\image latex olena_mp00419c_demat.png
-
\section copyright Copyright and License
Copyright (C) 2011 EPITA Research and Development (LRDE)
diff --git a/scribo/scribo/binarization/niblack_threshold.hh b/scribo/scribo/binarization/niblack_threshold.hh
index d9829f4..d817fc0 100644
--- a/scribo/scribo/binarization/niblack_threshold.hh
+++ b/scribo/scribo/binarization/niblack_threshold.hh
@@ -66,6 +66,8 @@ namespace scribo
\return An image of local thresholds.
\ingroup grpalgobinniblack
+
+ \sa scribo::binarization::local_threshold
*/
template <typename I, typename J>
mln_ch_value(I, value::int_u8)
diff --git a/scribo/scribo/binarization/otsu_threshold.hh b/scribo/scribo/binarization/otsu_threshold.hh
index 7ba458f..d43422b 100644
--- a/scribo/scribo/binarization/otsu_threshold.hh
+++ b/scribo/scribo/binarization/otsu_threshold.hh
@@ -51,6 +51,8 @@ namespace scribo
\return A global threshold value.
\ingroup grpalgobinotsu
+
+ \sa scribo::binarization::global_threshold
*/
template <typename I>
mln_value(I)
diff --git a/scribo/scribo/binarization/sauvola_threshold.hh b/scribo/scribo/binarization/sauvola_threshold.hh
index 41d70f7..e419237 100644
--- a/scribo/scribo/binarization/sauvola_threshold.hh
+++ b/scribo/scribo/binarization/sauvola_threshold.hh
@@ -66,6 +66,8 @@ namespace scribo
\return An image of local thresholds.
\ingroup grpalgobinsauvola
+
+ \sa scribo::binarization::local_threshold
*/
template <typename I, typename J>
mln_ch_value(I, value::int_u8)
--
1.7.2.5
1
0
29 Nov '11
* scribo/binarization/all.hh: Update includes.
* scribo/binarization/internal/compute_local_threshold.hh,
* scribo/binarization/internal/compute_sauvola_threshold.hh,
* scribo/binarization/internal/first_pass_functor.hh,
* scribo/binarization/internal/local_threshold_debug.hh,
* scribo/binarization/internal/sauvola_debug.hh,
* scribo/binarization/internal/sauvola_formula.hh,
* scribo/binarization/sauvola.hh,
* scribo/binarization/sauvola_ms.hh,
* scribo/binarization/sauvola_threshold.hh,
* scribo/binarization/sauvola_threshold_image.hh: Revamp code in
order to share some parts with Niblack's algorithm.
* scribo/binarization/internal/niblack_formula.hh,
* scribo/binarization/niblack.hh,
* scribo/binarization/niblack_threshold.hh: New.
* src/binarization/Makefile.am
* tests/binarization/Makefile.am: Add new targets.
* src/binarization/niblack.cc: New tool.
* tests/binarization/niblack.cc: New test.
* tests/binarization/niblack.ref.pbm: New test data.
---
scribo/ChangeLog | 31 ++
scribo/scribo/binarization/all.hh | 5 +-
.../internal/compute_local_threshold.hh | 224 +++++++++++++++
.../internal/compute_sauvola_threshold.hh | 285 ------------------
.../binarization/internal/first_pass_functor.hh | 24 +-
.../binarization/internal/local_threshold_debug.hh | 88 ++++++
.../binarization/internal/niblack_formula.hh | 105 +++++++
.../scribo/binarization/internal/sauvola_debug.hh | 87 ------
.../binarization/internal/sauvola_formula.hh | 121 ++++++++
scribo/scribo/binarization/niblack.hh | 218 ++++++++++++++
scribo/scribo/binarization/niblack_threshold.hh | 299 +++++++++++++++++++
scribo/scribo/binarization/sauvola.hh | 24 +-
scribo/scribo/binarization/sauvola_ms.hh | 21 +-
scribo/scribo/binarization/sauvola_threshold.hh | 296 +++++++++++++++++++
.../scribo/binarization/sauvola_threshold_image.hh | 301 --------------------
scribo/src/binarization/Makefile.am | 12 +-
scribo/src/binarization/niblack.cc | 106 +++++++
.../binarization/pgm_sauvola_threshold_image.cc | 7 +-
scribo/tests/binarization/Makefile.am | 3 +
scribo/tests/binarization/niblack.cc | 52 ++++
scribo/tests/binarization/niblack.ref.pbm | Bin 0 -> 16498 bytes
21 files changed, 1597 insertions(+), 712 deletions(-)
create mode 100644 scribo/scribo/binarization/internal/compute_local_threshold.hh
delete mode 100644 scribo/scribo/binarization/internal/compute_sauvola_threshold.hh
create mode 100644 scribo/scribo/binarization/internal/local_threshold_debug.hh
create mode 100644 scribo/scribo/binarization/internal/niblack_formula.hh
delete mode 100644 scribo/scribo/binarization/internal/sauvola_debug.hh
create mode 100644 scribo/scribo/binarization/internal/sauvola_formula.hh
create mode 100644 scribo/scribo/binarization/niblack.hh
create mode 100644 scribo/scribo/binarization/niblack_threshold.hh
create mode 100644 scribo/scribo/binarization/sauvola_threshold.hh
delete mode 100644 scribo/scribo/binarization/sauvola_threshold_image.hh
create mode 100644 scribo/src/binarization/niblack.cc
create mode 100644 scribo/tests/binarization/niblack.cc
create mode 100644 scribo/tests/binarization/niblack.ref.pbm
diff --git a/scribo/ChangeLog b/scribo/ChangeLog
index 5aa2a06..0923b28 100644
--- a/scribo/ChangeLog
+++ b/scribo/ChangeLog
@@ -1,3 +1,34 @@
+2011-10-17 Guillaume Lazzara <z(a)lrde.epita.fr>
+
+ Add Niblack's binarization algorithm.
+
+ * scribo/binarization/all.hh: Update includes.
+
+ * scribo/binarization/internal/compute_local_threshold.hh,
+ * scribo/binarization/internal/compute_sauvola_threshold.hh,
+ * scribo/binarization/internal/first_pass_functor.hh,
+ * scribo/binarization/internal/local_threshold_debug.hh,
+ * scribo/binarization/internal/sauvola_debug.hh,
+ * scribo/binarization/internal/sauvola_formula.hh,
+ * scribo/binarization/sauvola.hh,
+ * scribo/binarization/sauvola_ms.hh,
+ * scribo/binarization/sauvola_threshold.hh,
+ * scribo/binarization/sauvola_threshold_image.hh: Revamp code in
+ order to share some parts with Niblack's algorithm.
+
+ * scribo/binarization/internal/niblack_formula.hh,
+ * scribo/binarization/niblack.hh,
+ * scribo/binarization/niblack_threshold.hh: New.
+
+ * src/binarization/Makefile.am
+ * tests/binarization/Makefile.am: Add new targets.
+
+ * src/binarization/niblack.cc: New tool.
+
+ * tests/binarization/niblack.cc: New test.
+
+ * tests/binarization/niblack.ref.pbm: New test data.
+
2011-10-14 Guillaume Lazzara <z(a)lrde.epita.fr>
Add a new tool for global thresholding.
diff --git a/scribo/scribo/binarization/all.hh b/scribo/scribo/binarization/all.hh
index 6f40505..5530861 100644
--- a/scribo/scribo/binarization/all.hh
+++ b/scribo/scribo/binarization/all.hh
@@ -1,4 +1,5 @@
-// Copyright (C) 2010 EPITA Research and Development Laboratory (LRDE)
+// Copyright (C) 2010, 2011 EPITA Research and Development Laboratory
+// (LRDE)
//
// This file is part of Olena.
//
@@ -50,6 +51,6 @@ namespace scribo
# include <scribo/binarization/sauvola.hh>
# include <scribo/binarization/sauvola_ms.hh>
# include <scribo/binarization/sauvola_ms_split.hh>
-# include <scribo/binarization/sauvola_threshold_image.hh>
+# include <scribo/binarization/sauvola_threshold.hh>
#endif // ! SCRIBO_BINARIZATION_ALL_HH
diff --git a/scribo/scribo/binarization/internal/compute_local_threshold.hh b/scribo/scribo/binarization/internal/compute_local_threshold.hh
new file mode 100644
index 0000000..147ef0f
--- /dev/null
+++ b/scribo/scribo/binarization/internal/compute_local_threshold.hh
@@ -0,0 +1,224 @@
+// Copyright (C) 2010, 2011 EPITA Research and Development Laboratory
+// (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#ifndef SCRIBO_BINARIZATION_INTERNAL_COMPUTE_LOCAL_THRESHOLD_HH
+# define SCRIBO_BINARIZATION_INTERNAL_COMPUTE_LOCAL_THRESHOLD_HH
+
+
+/// \file
+///
+/// \brief Compute a threshold with Local's binarization formula.
+
+# include <algorithm>
+# include <cmath>
+
+# include <mln/core/image/image2d.hh>
+# include <mln/value/int_u8.hh>
+
+# include <scribo/binarization/internal/local_threshold_debug.hh>
+
+
+
+// extern mln::image2d<double> skewness;
+
+namespace scribo
+{
+
+ namespace binarization
+ {
+
+ namespace internal
+ {
+
+ using namespace mln;
+
+
+ /*! \brief Compute a point wise threshold according to a local
+ binarization formula.
+
+ \param[in] p A site.
+ \param[in] simple An integral image of mean values.
+ \param[in] squared An integral image of squared mean values.
+ \param[in] win_width Window width.
+ \param[in] k Control the threshold value in the local
+ window. The higher, the lower the threshold
+ form the local mean m(x, y).
+ \param[in] R Maximum value of the standard deviation (128
+ for grayscale documents).
+ \param[in] formula The function to use to compute the local
+ threshold.
+
+ \return A threshold.
+ */
+ template <typename P, typename J, typename F>
+ double
+ compute_local_threshold(const P& p,
+ const J& simple,
+ const J& squared,
+ int win_width, double K, double R,
+ const F& formula);
+
+
+
+# ifndef MLN_INCLUDE_ONLY
+
+
+ template <typename P, typename J, typename F>
+ double
+ compute_local_threshold(const P& p,
+ const J& simple,
+ const J& squared,
+ int win_width, double K, double R,
+ const F& formula)
+ {
+ mln_precondition(simple.nrows() == squared.nrows());
+ mln_precondition(simple.ncols() == squared.ncols());
+
+ // Window half width.
+ int w_2 = win_width >> 1;
+
+ int row_min = std::max(0, p.row() - w_2 - 1);
+ int col_min = std::max(0, p.col() - w_2 - 1);
+
+ int row_max = std::min(static_cast<int>(simple.nrows()) - 1,
+ p.row() + w_2);
+ int col_max = std::min(static_cast<int>(simple.ncols()) - 1,
+ p.col() + w_2);
+
+
+ double wh = (row_max - row_min) * (col_max - col_min);
+
+ // Mean.
+ double m_x_y_tmp = (simple.at_(row_max, col_max)
+ + simple.at_(row_min, col_min)
+ - simple.at_(row_max, col_min)
+ - simple.at_(row_min, col_max));
+
+ double m_x_y = m_x_y_tmp / wh;
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+ // Store local mean
+ debug_mean(p) = m_x_y * mean_debug_factor;
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
+
+ // Standard deviation.
+ double s_x_y_tmp = (squared.at_(row_max, col_max)
+ + squared.at_(row_min, col_min)
+ - squared.at_(row_max, col_min)
+ - squared.at_(row_min, col_max));
+
+ double s_x_y = std::sqrt((s_x_y_tmp - (m_x_y_tmp * m_x_y_tmp) / wh) / (wh - 1.f));
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+ // Store local standard deviation
+ debug_stddev(p) = s_x_y * stddev_debug_factor;
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
+
+ // Thresholding.
+ // skewness_ = skewness(p);
+ // b = (p == point2d(5,5));
+ double t_x_y = formula(m_x_y, s_x_y, K, R);
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+ double alpha = K * (1 - s_x_y / R);
+ debug_alpham(p) = alpha * m_x_y * alpham_debug_factor;
+ debug_alphacond(p) = (s_x_y < (alpha * m_x_y / 2.));
+# endif // !SCRIBO_LOCAL_THRESHOLD_DEBUG
+
+ return t_x_y;
+ }
+
+
+ template <typename P, typename J, typename F>
+ double
+ compute_local_threshold_single_image(const P& p,
+ const J& integral,
+ int win_width,
+ double K, double R,
+ const F& formula)
+ {
+ // Window half width.
+ int w_2 = win_width >> 1;
+
+ int row_min = std::max(0, p.row() - w_2);
+ int col_min = std::max(0, p.col() - w_2);
+
+ int row_max = std::min(static_cast<int>(integral.nrows()) - 1,
+ p.row() + w_2);
+ int col_max = std::min(static_cast<int>(integral.ncols()) - 1,
+ p.col() + w_2);
+
+
+ double wh = (row_max - row_min + 1) * (col_max - col_min + 1);
+
+ // Mean.
+ double m_x_y_tmp = (integral.at_(row_max, col_max).first()
+ + integral.at_(row_min, col_min).first()
+ - integral.at_(row_max, col_min).first()
+ - integral.at_(row_min, col_max).first());
+
+ double m_x_y = m_x_y_tmp / wh;
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+ // Store local mean
+ debug_mean(p) = m_x_y * mean_debug_factor;
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
+
+ // Standard deviation.
+ double s_x_y_tmp = (integral.at_(row_max, col_max).second()
+ + integral.at_(row_min, col_min).second()
+ - integral.at_(row_max, col_min).second()
+ - integral.at_(row_min, col_max).second());
+
+ double s_x_y = std::sqrt((s_x_y_tmp - (m_x_y_tmp * m_x_y_tmp) / wh) / (wh - 1.f));
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+ // Store local standard deviation
+ debug_stddev(p) = s_x_y * stddev_debug_factor;
+# endif // !SCRIBO_LOCAL_THRESHOLD_DEBUG
+
+ // Thresholding.
+ double t_x_y = formula(m_x_y, s_x_y, K, R);
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+ double alpha = K * (1 - s_x_y / R);
+ debug_alpham(p) = alpha * m_x_y * alpham_debug_factor;
+ debug_alphacond(p) = (s_x_y < (alpha * m_x_y / 2.));
+# endif // !SCRIBO_LOCAL_THRESHOLD_DEBUG
+
+ return t_x_y;
+ }
+
+
+#endif // ! MLN_INCLUDE_ONLY
+
+ } // end of namespace scribo::binarization::internal
+
+ } // end of namespace scribo::binarization
+
+} // end of namespace scribo
+
+#endif // ! SCRIBO_BINARIZATION_INTERNAL_COMPUTE_LOCAL_THRESHOLD_HH
diff --git a/scribo/scribo/binarization/internal/compute_sauvola_threshold.hh b/scribo/scribo/binarization/internal/compute_sauvola_threshold.hh
deleted file mode 100644
index d3ca07f..0000000
--- a/scribo/scribo/binarization/internal/compute_sauvola_threshold.hh
+++ /dev/null
@@ -1,285 +0,0 @@
-// Copyright (C) 2010 EPITA Research and Development Laboratory (LRDE)
-//
-// This file is part of Olena.
-//
-// Olena is free software: you can redistribute it and/or modify it under
-// the terms of the GNU General Public License as published by the Free
-// Software Foundation, version 2 of the License.
-//
-// Olena is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-// General Public License for more details.
-//
-// You should have received a copy of the GNU General Public License
-// along with Olena. If not, see <http://www.gnu.org/licenses/>.
-//
-// As a special exception, you may use this file as part of a free
-// software project without restriction. Specifically, if other files
-// instantiate templates or use macros or inline functions from this
-// file, or you compile this file and link it with other files to produce
-// an executable, this file does not by itself cause the resulting
-// executable to be covered by the GNU General Public License. This
-// exception does not however invalidate any other reasons why the
-// executable file might be covered by the GNU General Public License.
-
-#ifndef SCRIBO_BINARIZATION_INTERNAL_COMPUTE_SAUVOLA_THRESHOLD_HH
-# define SCRIBO_BINARIZATION_INTERNAL_COMPUTE_SAUVOLA_THRESHOLD_HH
-
-
-/// \file
-///
-/// \brief Compute a threshold with Sauvola's binarization formula.
-
-# include <algorithm>
-# include <cmath>
-
-# include <mln/core/image/image2d.hh>
-# include <mln/value/int_u8.hh>
-
-# include <scribo/binarization/internal/sauvola_debug.hh>
-
-
-// Setup default Sauvola's formulae parameters values.
-// These macros may be used in other variant of Sauvola's algorithm.
-//
-// Values are set according to the following reference: "Automatic
-// Evaluation of Document Binarization Results", Badekas and al, 2005
-//
-// Badekas et al. said 0.34 was best.
-# define SCRIBO_DEFAULT_SAUVOLA_K 0.34
-//
-// 128 is best for grayscale documents.
-# define SCRIBO_DEFAULT_SAUVOLA_R 128
-
-
-namespace scribo
-{
-
- namespace binarization
- {
-
- namespace internal
- {
-
- using namespace mln;
-
-
- /*! \brief Compute a point wise threshold according Sauvola's
- binarization.
-
- \param[in] p A site.
- \param[in] simple An integral image of mean values.
- \param[in] squared An integral image of squared mean values.
- \param[in] win_width Window width.
- \param[in] k Control the threshold value in the local
- window. The higher, the lower the threshold
- form the local mean m(x, y).
- \param[in] R Maximum value of the standard deviation (128
- for grayscale documents).
-
- \return A threshold.
- */
- template <typename P, typename J>
- double
- compute_sauvola_threshold(const P& p,
- const J& simple,
- const J& squared,
- int win_width, double K, double R);
-
- /// \overload
- /// K is set to 0.34 and R to 128.
- //
- template <typename P, typename J>
- double
- compute_sauvola_threshold(const P& p,
- const J& simple,
- const J& squared,
- int win_width);
-
-
-
-# ifndef MLN_INCLUDE_ONLY
-
-
-
- /*! \brief compute Sauvola's threshold applying directly the formula.
-
- \param[in] m_x_y Mean value.
- \param[in] s_x_y Standard deviation.
- \param[in] k Control the threshold value in the local
- window. The higher, the lower the threshold
- form the local mean m(x, y).
- \param[in] R Maximum value of the standard deviation (128
- for grayscale documents).
-
- \return A threshold.
- */
- inline
- double
- sauvola_threshold_formula(const double m_x_y, const double s_x_y,
- const double K, const double R)
- {
- return m_x_y * (1.0 + K * ((s_x_y / R) - 1.0));
- }
-
- /// \overload
- /// K is set to 0.34 and R to 128.
- //
- inline
- double
- sauvola_threshold_formula(double m_x_y, double s_x_y)
- {
- return sauvola_threshold_formula(m_x_y, s_x_y,
- SCRIBO_DEFAULT_SAUVOLA_K,
- SCRIBO_DEFAULT_SAUVOLA_R);
- }
-
-
-
- template <typename P, typename J>
- double
- compute_sauvola_threshold(const P& p,
- const J& simple,
- const J& squared,
- int win_width, double K, double R)
- {
- mln_precondition(simple.nrows() == squared.nrows());
- mln_precondition(simple.ncols() == squared.ncols());
-
- // Window half width.
- int w_2 = win_width >> 1;
-
- int row_min = std::max(0, p.row() - w_2 - 1);
- int col_min = std::max(0, p.col() - w_2 - 1);
-
- int row_max = std::min(static_cast<int>(simple.nrows()) - 1,
- p.row() + w_2);
- int col_max = std::min(static_cast<int>(simple.ncols()) - 1,
- p.col() + w_2);
-
-
- double wh = (row_max - row_min) * (col_max - col_min);
-
- // Mean.
- double m_x_y_tmp = (simple.at_(row_max, col_max)
- + simple.at_(row_min, col_min)
- - simple.at_(row_max, col_min)
- - simple.at_(row_min, col_max));
-
- double m_x_y = m_x_y_tmp / wh;
-
-# ifdef SCRIBO_SAUVOLA_DEBUG
- // Store local mean
- debug_mean(p) = m_x_y * mean_debug_factor;
-# endif // ! SCRIBO_SAUVOLA_DEBUG
-
- // Standard deviation.
- double s_x_y_tmp = (squared.at_(row_max, col_max)
- + squared.at_(row_min, col_min)
- - squared.at_(row_max, col_min)
- - squared.at_(row_min, col_max));
-
- double s_x_y = std::sqrt((s_x_y_tmp - (m_x_y_tmp * m_x_y_tmp) / wh) / (wh - 1.f));
-
-# ifdef SCRIBO_SAUVOLA_DEBUG
- // Store local standard deviation
- debug_stddev(p) = s_x_y * stddev_debug_factor;
-# endif // ! SCRIBO_SAUVOLA_DEBUG
-
- // Thresholding.
- double t_x_y = sauvola_threshold_formula(m_x_y, s_x_y, K, R);
-
-# ifdef SCRIBO_SAUVOLA_DEBUG
- double alpha = K * (1 - s_x_y / R);
- debug_alpham(p) = alpha * m_x_y * alpham_debug_factor;
- debug_alphacond(p) = (s_x_y < (alpha * m_x_y / 2.));
-# endif // !SCRIBO_SAUVOLA_DEBUG
-
- return t_x_y;
- }
-
-
- template <typename P, typename J>
- double
- compute_sauvola_threshold_single_image(const P& p,
- const J& integral,
- int win_width,
- double K, double R)
- {
- // Window half width.
- int w_2 = win_width >> 1;
-
- int row_min = std::max(0, p.row() - w_2);
- int col_min = std::max(0, p.col() - w_2);
-
- int row_max = std::min(static_cast<int>(integral.nrows()) - 1,
- p.row() + w_2);
- int col_max = std::min(static_cast<int>(integral.ncols()) - 1,
- p.col() + w_2);
-
-
- double wh = (row_max - row_min + 1) * (col_max - col_min + 1);
-
- // Mean.
- double m_x_y_tmp = (integral.at_(row_max, col_max).first()
- + integral.at_(row_min, col_min).first()
- - integral.at_(row_max, col_min).first()
- - integral.at_(row_min, col_max).first());
-
- double m_x_y = m_x_y_tmp / wh;
-
-# ifdef SCRIBO_SAUVOLA_DEBUG
- // Store local mean
- debug_mean(p) = m_x_y * mean_debug_factor;
-# endif // ! SCRIBO_SAUVOLA_DEBUG
-
- // Standard deviation.
- double s_x_y_tmp = (integral.at_(row_max, col_max).second()
- + integral.at_(row_min, col_min).second()
- - integral.at_(row_max, col_min).second()
- - integral.at_(row_min, col_max).second());
-
- double s_x_y = std::sqrt((s_x_y_tmp - (m_x_y_tmp * m_x_y_tmp) / wh) / (wh - 1.f));
-
-# ifdef SCRIBO_SAUVOLA_DEBUG
- // Store local standard deviation
- debug_stddev(p) = s_x_y * stddev_debug_factor;
-# endif // !SCRIBO_SAUVOLA_DEBUG
-
- // Thresholding.
- double t_x_y = sauvola_threshold_formula(m_x_y, s_x_y, K, R);
-
-# ifdef SCRIBO_SAUVOLA_DEBUG
- double alpha = K * (1 - s_x_y / R);
- debug_alpham(p) = alpha * m_x_y * alpham_debug_factor;
- debug_alphacond(p) = (s_x_y < (alpha * m_x_y / 2.));
-# endif // !SCRIBO_SAUVOLA_DEBUG
-
- return t_x_y;
- }
-
-
-
- template <typename P, typename J>
- double
- compute_sauvola_threshold(const P& p,
- const J& simple,
- const J& squared,
- int win_width)
- {
- return compute_sauvola_threshold(p, simple, squared, win_width,
- SCRIBO_DEFAULT_SAUVOLA_K,
- SCRIBO_DEFAULT_SAUVOLA_R);
- }
-
-
-#endif // ! MLN_INCLUDE_ONLY
-
- } // end of namespace scribo::binarization::internal
-
- } // end of namespace scribo::binarization
-
-} // end of namespace scribo
-
-#endif // ! SCRIBO_BINARIZATION_INTERNAL_COMPUTE_SAUVOLA_THRESHOLD_HH
diff --git a/scribo/scribo/binarization/internal/first_pass_functor.hh b/scribo/scribo/binarization/internal/first_pass_functor.hh
index 0b1a7ac..8da401b 100644
--- a/scribo/scribo/binarization/internal/first_pass_functor.hh
+++ b/scribo/scribo/binarization/internal/first_pass_functor.hh
@@ -37,7 +37,11 @@
# include <mln/value/int_u8.hh>
# include <mln/data/fill.hh>
-# include <scribo/binarization/sauvola_threshold_image.hh>
+# include <scribo/binarization/internal/sauvola_formula.hh>
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+# include <scribo/binarization/internal/local_threshold_debug.hh>
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
namespace scribo
@@ -67,8 +71,11 @@ namespace scribo
mln::util::array<int> dp;
double K_;
+ double R_;
+
+ sauvola_formula formula_;
- first_pass_functor(const I& input, double K);
+ first_pass_functor(const I& input, double K, double R);
void exec(double mean, double stddev);
void finalize();
@@ -88,10 +95,11 @@ namespace scribo
template <typename I>
- first_pass_functor<I>::first_pass_functor(const I& input, double K)
+ first_pass_functor<I>::first_pass_functor(const I& input, double K, double R)
: input(input),
pxl(input),
- K_(K)
+ K_(K),
+ R_(R)
{
res = 0;
pxl.start();
@@ -100,10 +108,10 @@ namespace scribo
initialize(parent, input);
initialize(msk, input);
-# ifdef SCRIBO_SAUVOLA_DEBUG
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
initialize(debug_mean, input);
initialize(debug_stddev, input);
-# endif // ! SCRIBO_SAUVOLA_DEBUG
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
mln::extension::fill(msk, false);
@@ -124,9 +132,7 @@ namespace scribo
unsigned p = pxl.offset();
value::int_u8 t_p;
- mln::convert::from_to(sauvola_threshold_formula(mean, stddev,
- K_,
- SCRIBO_DEFAULT_SAUVOLA_R),
+ mln::convert::from_to(formula_(mean, stddev, K_, R_),
t_p);
msk.element(p) = input.element(p) < t_p;
diff --git a/scribo/scribo/binarization/internal/local_threshold_debug.hh b/scribo/scribo/binarization/internal/local_threshold_debug.hh
new file mode 100644
index 0000000..a9da06c
--- /dev/null
+++ b/scribo/scribo/binarization/internal/local_threshold_debug.hh
@@ -0,0 +1,88 @@
+// Copyright (C) 2010, 2011 EPITA Research and Development Laboratory
+// (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#ifndef SCRIBO_BINARIZATION_INTERNAL_LOCAL_THRESHOLD_DEBUG_HH
+# define SCRIBO_BINARIZATION_INTERNAL_LOCAL_THRESHOLD_DEBUG_HH
+
+/// \file
+///
+/// \brief Declare all debug related variables for local based
+/// algorithms.
+
+
+/// FIXME: A struct may be a bit better...
+
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+
+# ifndef MLN_INCLUDE_ONLY
+
+
+namespace scribo
+{
+
+ namespace binarization
+ {
+
+ using namespace mln;
+
+ namespace internal
+ {
+
+ char* stddev_image_output = 0;
+ char* mean_image_output = 0;
+ char* threshold_image_output = 0;
+
+ char* scale_image_output = 0;
+
+ char* alpham_image_output = 0;
+ char* alphacond_image_output = 0;
+
+ // Declare debug images.
+ image2d<double> debug_stddev;
+ image2d<double> debug_mean;
+ image2d<double> debug_threshold;
+
+ image2d<double> debug_alpham;
+ image2d<bool> debug_alphacond;
+
+ double mean_debug_factor = 1.0;
+ double stddev_debug_factor = 1.0;
+ double alpham_debug_factor = 2.0;
+
+ } // end of namespace scribo::binarization::internal
+
+ } // end of namespace scribo::binarization
+
+} // end of namespace scribo
+
+
+# endif // ! MLN_INCLUDE_ONLY
+
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
+
+
+#endif // ! SCRIBO_BINARIZATION_INTERNAL_LOCAL_THRESHOLD_DEBUG_HH
diff --git a/scribo/scribo/binarization/internal/niblack_formula.hh b/scribo/scribo/binarization/internal/niblack_formula.hh
new file mode 100644
index 0000000..54dbc9b
--- /dev/null
+++ b/scribo/scribo/binarization/internal/niblack_formula.hh
@@ -0,0 +1,105 @@
+// Copyright (C) 2011 EPITA Research and Development Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#ifndef SCRIBO_BINARIZATION_INTERNAL_NIBLACK_FORMULA_HH
+# define SCRIBO_BINARIZATION_INTERNAL_NIBLACK_FORMULA_HH
+
+
+/// \file
+///
+/// \brief Routines computing a threshold using Niblack's binarization
+/// formula.
+
+// \fixme Having an unused parameter to fulfill the required interface
+// may not be the best solution...
+
+// Setup default Niblack's formula parameters values.
+# define SCRIBO_DEFAULT_NIBLACK_K -0.2
+
+
+
+namespace scribo
+{
+
+ namespace binarization
+ {
+
+ namespace internal
+ {
+
+ struct niblack_formula
+ {
+
+ /*! \brief compute a threshold using Niblack's formula.
+
+ \param[in] m_x_y Mean value.
+ \param[in] s_x_y Standard deviation.
+ \param[in] k Control the threshold value in the local
+ window. The higher, the lower the threshold
+ form the local mean m(x, y).
+ \param[in] R Maximum value of the standard deviation (128
+ for grayscale documents). Unused in this formula.
+
+ \return A threshold.
+ */
+ double operator()(const double m_x_y, const double s_x_y,
+ const double K, const double R) const;
+
+ /*!
+ \overload K = 0.34.
+ */
+ double operator()(const double m_x_y, const double s_x_y) const;
+
+ };
+
+
+# ifndef MLN_INCLUDE_ONLY
+
+ inline
+ double
+ niblack_formula::operator()(const double m_x_y, const double s_x_y,
+ const double K, const double /*R*/) const
+ {
+ return m_x_y + K * s_x_y;
+ }
+
+ inline
+ double
+ niblack_formula::operator()(const double m_x_y, const double s_x_y) const
+ {
+ return (*this)(m_x_y, s_x_y,
+ SCRIBO_DEFAULT_NIBLACK_K, 128);
+ }
+
+
+# endif // ! MLN_INCLUDE_ONLY
+
+ } // end of namespace scribo::binarization::internal
+
+ } // end of namespace scribo::binarization
+
+} // end of namespace scribo
+
+#endif // ! SCRIBO_BINARIZATION_INTERNAL_NIBLACK_FORMULA_HH
diff --git a/scribo/scribo/binarization/internal/sauvola_debug.hh b/scribo/scribo/binarization/internal/sauvola_debug.hh
deleted file mode 100644
index 0f8ccf0..0000000
--- a/scribo/scribo/binarization/internal/sauvola_debug.hh
+++ /dev/null
@@ -1,87 +0,0 @@
-// Copyright (C) 2010 EPITA Research and Development Laboratory (LRDE)
-//
-// This file is part of Olena.
-//
-// Olena is free software: you can redistribute it and/or modify it under
-// the terms of the GNU General Public License as published by the Free
-// Software Foundation, version 2 of the License.
-//
-// Olena is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-// General Public License for more details.
-//
-// You should have received a copy of the GNU General Public License
-// along with Olena. If not, see <http://www.gnu.org/licenses/>.
-//
-// As a special exception, you may use this file as part of a free
-// software project without restriction. Specifically, if other files
-// instantiate templates or use macros or inline functions from this
-// file, or you compile this file and link it with other files to produce
-// an executable, this file does not by itself cause the resulting
-// executable to be covered by the GNU General Public License. This
-// exception does not however invalidate any other reasons why the
-// executable file might be covered by the GNU General Public License.
-
-#ifndef SCRIBO_BINARIZATION_INTERNAL_SAUVOLA_DEBUG_HH
-# define SCRIBO_BINARIZATION_INTERNAL_SAUVOLA_DEBUG_HH
-
-/// \file
-///
-/// \brief Declare all debug related variables for Sauvola*
-/// algorithms.
-
-
-/// FIXME: A struct may be a bit better...
-
-
-# ifdef SCRIBO_SAUVOLA_DEBUG
-
-# ifndef MLN_INCLUDE_ONLY
-
-
-namespace scribo
-{
-
- namespace binarization
- {
-
- using namespace mln;
-
- namespace internal
- {
-
- char* stddev_image_output = 0;
- char* mean_image_output = 0;
- char* threshold_image_output = 0;
-
- char* scale_image_output = 0;
-
- char* alpham_image_output = 0;
- char* alphacond_image_output = 0;
-
- // Declare debug images.
- image2d<double> debug_stddev;
- image2d<double> debug_mean;
- image2d<double> debug_threshold;
-
- image2d<double> debug_alpham;
- image2d<bool> debug_alphacond;
-
- double mean_debug_factor = 1.0;
- double stddev_debug_factor = 1.0;
- double alpham_debug_factor = 2.0;
-
- } // end of namespace scribo::binarization::internal
-
- } // end of namespace scribo::binarization
-
-} // end of namespace scribo
-
-
-# endif // ! MLN_INCLUDE_ONLY
-
-# endif // ! SCRIBO_SAUVOLA_DEBUG
-
-
-#endif // ! SCRIBO_BINARIZATION_INTERNAL_SAUVOLA_DEBUG_HH
diff --git a/scribo/scribo/binarization/internal/sauvola_formula.hh b/scribo/scribo/binarization/internal/sauvola_formula.hh
new file mode 100644
index 0000000..adbef13
--- /dev/null
+++ b/scribo/scribo/binarization/internal/sauvola_formula.hh
@@ -0,0 +1,121 @@
+// Copyright (C) 2011 EPITA Research and Development Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#ifndef SCRIBO_BINARIZATION_INTERNAL_SAUVOLA_FORMULA_HH
+# define SCRIBO_BINARIZATION_INTERNAL_SAUVOLA_FORMULA_HH
+
+
+/// \file
+///
+/// \brief Routines computing a threshold using Sauvola's binarization
+/// formula.
+
+
+// Setup default Sauvola's formula parameters values.
+// These macros may be used in other variant of Sauvola's algorithms.
+//
+// Values are set according to the following reference: "Automatic
+// Evaluation of Document Binarization Results", Badekas and al, 2005
+//
+// Badekas et al. said 0.34 was best for Sauvola.
+# define SCRIBO_DEFAULT_SAUVOLA_K 0.34
+//
+// 128 is best for grayscale documents.
+# define SCRIBO_DEFAULT_SAUVOLA_R 128
+
+
+namespace scribo
+{
+
+ namespace binarization
+ {
+
+ namespace internal
+ {
+
+ struct sauvola_formula
+ {
+
+ /*! \brief Compute a threshold using Sauvola's formula.
+
+ \param[in] m_x_y Mean value.
+ \param[in] s_x_y Standard deviation.
+ \param[in] k Control the threshold value in the local
+ window. The higher, the lower the threshold
+ form the local mean m(x, y).
+ \param[in] R Maximum value of the standard deviation (128
+ for grayscale documents).
+
+ \return A threshold.
+ */
+ double operator()(const double m_x_y, const double s_x_y,
+ const double K, const double R) const;
+
+ /*!
+ \overload K = 0.34 and R = 128.
+ */
+ double operator()(const double m_x_y, const double s_x_y) const;
+
+ };
+
+
+# ifndef MLN_INCLUDE_ONLY
+
+ // bool b;
+ // double skewness_;
+
+ inline
+ double
+ sauvola_formula::operator()(const double m_x_y, const double s_x_y,
+ const double K, const double R) const
+ {
+ // if (b)
+ // std::cout << skewness_ << " - " << (K * -1 * skewness_) << std::endl;
+ // volatile double new_t = ((skewness_ < 0) ? -skewness_ : 1 * m_x_y * (1.0 + K * ((s_x_y / R) - 1.0)));
+ // volatile double old_t = (m_x_y * (1.0 + K * ((s_x_y / R) - 1.0)));
+ // if (skewness_ > 0)
+ // if (new_t != old_t)
+ // std::cout << skewness_ << " - " << new_t << " vs " << old_t << std::endl;
+
+ return m_x_y * (1.0 + K * ((s_x_y / R) - 1.0));
+ }
+
+ inline
+ double
+ sauvola_formula::operator()(const double m_x_y, const double s_x_y) const
+ {
+ return (*this)(m_x_y, s_x_y,
+ SCRIBO_DEFAULT_SAUVOLA_K, SCRIBO_DEFAULT_SAUVOLA_R);
+ }
+
+# endif // ! MLN_INCLUDE_ONLY
+
+ } // end of namespace scribo::binarization::internal
+
+ } // end of namespace scribo::binarization
+
+} // end of namespace scribo
+
+#endif // ! SCRIBO_BINARIZATION_INTERNAL_SAUVOLA_FORMULA_HH
diff --git a/scribo/scribo/binarization/niblack.hh b/scribo/scribo/binarization/niblack.hh
new file mode 100644
index 0000000..e66e7b4
--- /dev/null
+++ b/scribo/scribo/binarization/niblack.hh
@@ -0,0 +1,218 @@
+// Copyright (C) 2011 EPITA Research and Development Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#ifndef SCRIBO_BINARIZATION_NIBLACK_HH
+# define SCRIBO_BINARIZATION_NIBLACK_HH
+
+/// \file
+///
+///
+
+# include <mln/core/concept/image.hh>
+# include <mln/data/transform.hh>
+# include <mln/value/int_u8.hh>
+
+# include <scribo/binarization/niblack_threshold.hh>
+# include <scribo/binarization/local_threshold.hh>
+# include <scribo/binarization/internal/local_threshold_debug.hh>
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+# include <mln/io/pgm/save.hh>
+# include <mln/io/pbm/save.hh>
+# include <mln/data/saturate.hh>
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
+
+namespace scribo
+{
+
+ namespace binarization
+ {
+
+ using namespace mln;
+
+
+ /*! \brief Convert an image into a binary image.
+
+ \input[in] input An image.
+ \input[in] window_size The window size.
+ \input[in] K Niblack's formulae constant.
+
+ \return A binary image.
+
+ */
+ template <typename I>
+ mln_ch_value(I, bool)
+ niblack(const Image<I>& input, unsigned window_size, double K);
+
+
+
+ /*! \brief Convert an image into a binary image.
+
+ Niblack's formulae constant K is set to 0.34.
+
+ \input[in] input An image.
+ \input[in] window_size The window size.
+
+ \return A binary image.
+
+ */
+ template <typename I>
+ mln_ch_value(I, bool)
+ niblack(const Image<I>& input, unsigned window_size);
+
+
+ /// \overload
+ /// The window size is set to 11.
+ //
+ template <typename I>
+ mln_ch_value(I, bool)
+ niblack(const Image<I>& input);
+
+
+# ifndef MLN_INCLUDE_ONLY
+
+
+ // Implementations.
+
+ namespace impl
+ {
+
+ namespace generic
+ {
+
+ template <typename I>
+ mln_ch_value(I, bool)
+ niblack(const Image<I>& input, unsigned window_size, double K)
+ {
+ trace::entering("scribo::binarization::impl::generic::niblack");
+ mln_precondition(exact(input).is_valid());
+
+ mln_ch_value(I,value::int_u8)
+ threshold_image = binarization::niblack_threshold(input, window_size, K);
+
+ mln_ch_value(I, bool)
+ output = local_threshold(input, threshold_image);
+
+ trace::exiting("scribo::binarization::impl::generic::niblack");
+ return output;
+ }
+
+ } // end of namespace scribo::binarization::impl::generic
+
+
+ } // end of namespace scribo::binarization::impl
+
+
+
+ // Dispatch
+
+ namespace internal
+ {
+
+ template <typename I>
+ mln_ch_value(I, bool)
+ niblack_dispatch(const mln_value(I)&,
+ const Image<I>& input, unsigned window_size,
+ double K)
+ {
+ return impl::generic::niblack(input, window_size, K);
+ }
+
+
+ template <typename I>
+ mln_ch_value(I, bool)
+ niblack_dispatch(const Image<I>& input, unsigned window_size,
+ double K)
+ {
+ typedef mln_value(I) V;
+ return niblack_dispatch(V(), input, window_size, K);
+ }
+
+ } // end of namespace scribo::binarization::internal
+
+
+
+ // Facades
+
+ template <typename I>
+ mln_ch_value(I, bool)
+ niblack(const Image<I>& input, unsigned window_size, double K)
+ {
+ trace::entering("scribo::binarization::niblack");
+
+ mln_precondition(exact(input).is_valid());
+
+ mln_ch_value(I, bool)
+ output = internal::niblack_dispatch(input, window_size, K);
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+ if (internal::stddev_image_output)
+ io::pgm::save(data::saturate(value::int_u8(), internal::debug_stddev),
+ internal::stddev_image_output);
+ if (internal::mean_image_output)
+ io::pgm::save(data::saturate(value::int_u8(), internal::debug_mean),
+ internal::mean_image_output);
+ if (internal::threshold_image_output)
+ io::pgm::save(data::saturate(value::int_u8(), internal::debug_threshold),
+ internal::threshold_image_output);
+
+ if (internal::alpham_image_output)
+ io::pgm::save(data::saturate(value::int_u8(), internal::debug_alpham),
+ internal::alpham_image_output);
+ if (internal::alphacond_image_output)
+ io::pbm::save(internal::debug_alphacond, internal::alphacond_image_output);
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
+
+
+ trace::exiting("scribo::binarization::niblack");
+ return output;
+ }
+
+
+ template <typename I>
+ mln_ch_value(I, bool)
+ niblack(const Image<I>& input, unsigned window_size)
+ {
+ return niblack(input, window_size, SCRIBO_DEFAULT_NIBLACK_K);
+ }
+
+
+ template <typename I>
+ mln_ch_value(I, bool)
+ niblack(const Image<I>& input)
+ {
+ return niblack(input, 11);
+ }
+
+
+# endif // ! MLN_INCLUDE_ONLY
+
+
+ } // end of namespace scribo::binarization
+
+} // end of namespace scribo
+
+
+#endif // ! SCRIBO_BINARIZATION_NIBLACK_HH
diff --git a/scribo/scribo/binarization/niblack_threshold.hh b/scribo/scribo/binarization/niblack_threshold.hh
new file mode 100644
index 0000000..db4a74e
--- /dev/null
+++ b/scribo/scribo/binarization/niblack_threshold.hh
@@ -0,0 +1,299 @@
+// Copyright (C) 2011 EPITA Research and Development Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#ifndef SCRIBO_BINARIZATION_NIBLACK_THRESHOLD_HH
+# define SCRIBO_BINARIZATION_NIBLACK_THRESHOLD_HH
+
+/// \file
+///
+/// Compute an image of local threshold using Niblack algorithm.
+
+/// \fixme return type too restrictive!
+/// \fixme Revamp code and merge with sauvola_threshold.hh.
+
+# include <algorithm>
+# include <cmath>
+
+# include <mln/core/image/image2d.hh>
+# include <mln/value/int_u.hh>
+# include <mln/value/int_u8.hh>
+
+# include <scribo/core/init_integral_image.hh>
+# include <scribo/binarization/internal/compute_local_threshold.hh>
+# include <scribo/binarization/internal/niblack_formula.hh>
+
+
+
+namespace scribo
+{
+
+ namespace binarization
+ {
+
+ using namespace mln;
+
+ /*! \brief Compute an image of local threshold using Niblack algorithm.
+
+ \input[in] input A gray level image.
+ \input[in] window_size The window size.
+ \input[out] simple The sum of all intensities of \p input.
+ \input[out] squared The sum of all squared intensities of \p
+ input.
+
+ \return An image of local thresholds.
+
+ */
+ template <typename I, typename J>
+ mln_ch_value(I, value::int_u8)
+ niblack_threshold(const Image<I>& input, unsigned window_size,
+ double K,
+ Image<J>& simple,
+ Image<J>& squared);
+
+ /// \overload
+ template <typename I>
+ mln_ch_value(I, value::int_u8)
+ niblack_threshold(const Image<I>& input, unsigned window_size,
+ double K);
+
+ /// \overload
+ /// K is set to 0.34
+ template <typename I>
+ mln_ch_value(I, value::int_u8)
+ niblack_threshold(const Image<I>& input, unsigned window_size);
+
+
+ /// \overload
+ /// The window size is set to 11.
+ //
+ template <typename I>
+ mln_ch_value(I, value::int_u8)
+ niblack_threshold(const Image<I>& input);
+
+
+
+# ifndef MLN_INCLUDE_ONLY
+
+
+ // Implementation
+
+
+ namespace impl
+ {
+
+ namespace generic
+ {
+
+ template <typename I, typename J>
+ inline
+ mln_concrete(I)
+ niblack_threshold(const Image<I>& input_, unsigned window_size,
+ double K,
+ Image<J>& simple_,
+ Image<J>& squared_)
+ {
+ trace::entering("scribo::binarization::impl::generic::niblack_threshold");
+
+ const I& input = exact(input_);
+ J& simple = exact(simple_);
+ J& squared = exact(squared_);
+
+ mln_assertion(input.is_valid());
+ mln_assertion(simple.is_valid());
+ mln_assertion(squared.is_valid());
+
+ typedef mln_value(I) V;
+ typedef mln_site(I) P;
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+ initialize(internal::debug_mean, input);
+ initialize(internal::debug_stddev, input);
+ initialize(internal::debug_threshold, input);
+ initialize(internal::debug_alpham, input);
+ initialize(internal::debug_alphacond, input);
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
+
+ mln_concrete(I) output;
+ initialize(output, input);
+
+ const mln::def::coord
+ nrows = static_cast<mln::def::coord>(input.nrows()),
+ ncols = static_cast<mln::def::coord>(input.ncols());
+
+
+ internal::niblack_formula formula;
+ for(mln::def::coord row = 0; row < nrows; ++row)
+ for(mln::def::coord col = 0; col < ncols; ++col)
+ {
+ // FIXME: Setting R parameter to 128 should not be
+ // hard-coded. Even though it is not used in Niblack's
+ // formula, this parameter is used for debug images and
+ // should be adapted to the data range values.
+ double t = internal::compute_local_threshold(P(row, col), simple,
+ squared, window_size,
+ K,
+ 128,
+ formula);
+ mln::convert::from_to(t, output.at_(row, col));
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+ internal::debug_threshold.at_(row, col) = t;
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
+ }
+
+ trace::exiting("scribo::binarization::impl::generic::niblack_threshold");
+ return output;
+ }
+
+ } // end of namespace scribo::binarization::impl::generic
+
+
+
+ template <typename I, typename J>
+ inline
+ mln_concrete(I)
+ niblack_threshold_gl(const I& input, unsigned window_size,
+ double K,
+ Image<J>& simple,
+ Image<J>& squared)
+ {
+ return impl::generic::niblack_threshold(input, window_size, K,
+ simple, squared);
+ }
+
+
+ } // end of namespace scribo::binarization::impl
+
+
+
+
+ // Dispatch
+
+ namespace internal
+ {
+
+ template <unsigned n, typename I, typename J>
+ inline
+ mln_ch_value(I, value::int_u<n>)
+ niblack_threshold_dispatch(const value::int_u<n>&, const I& input,
+ unsigned window_size,
+ double K,
+ J& simple,
+ J& squared)
+ {
+ return impl::niblack_threshold_gl(input, window_size, K,
+ simple, squared);
+ }
+
+
+ template <typename I, typename J>
+ inline
+ mln_ch_value(I, value::int_u8)
+ niblack_threshold_dispatch(const mln_value(I)&, const I& input,
+ unsigned window_size,
+ double K,
+ J& simple,
+ J& squared)
+ {
+ // No dispatch for this kind of value type.
+ mlc_abort(I)::check();
+
+ typedef mln_ch_value(I,bool) output_t;
+ return output_t();
+ }
+
+
+ } // end of namespace scribo::binarization::internal
+
+
+
+ template <typename I, typename J>
+ mln_ch_value(I, value::int_u8)
+ niblack_threshold(const Image<I>& input, unsigned window_size,
+ double K,
+ Image<J>& simple,
+ Image<J>& squared)
+ {
+ trace::entering("scribo::binarization::niblack_threshold");
+
+ mln_precondition(mln_site_(I)::dim == 2);
+ mln_precondition(exact(input).is_valid());
+
+ typedef mln_value(I) value_t;
+ mln_ch_value(I, value::int_u8)
+ output = internal::niblack_threshold_dispatch(value_t(),
+ exact(input),
+ window_size,
+ K,
+ exact(simple),
+ exact(squared));
+
+ trace::exiting("scribo::text::ppm2pbm");
+ return output;
+ }
+
+
+ template <typename I>
+ inline
+ mln_ch_value(I, value::int_u8)
+ niblack_threshold(const Image<I>& input, unsigned window_size,
+ double K)
+ {
+ mln_ch_value(I, double)
+ simple = init_integral_image(input, scribo::internal::identity_),
+ squared = init_integral_image(input, scribo::internal::square_);
+
+ return niblack_threshold(input, window_size,
+ K, simple, squared);
+ }
+
+
+ template <typename I>
+ inline
+ mln_ch_value(I, value::int_u8)
+ niblack_threshold(const Image<I>& input, unsigned window_size)
+ {
+ return niblack_threshold(input, window_size,
+ SCRIBO_DEFAULT_NIBLACK_K);
+ }
+
+
+ template <typename I>
+ inline
+ mln_ch_value(I, value::int_u8)
+ niblack_threshold(const Image<I>& input)
+ {
+ return niblack_threshold(input, 11);
+ }
+
+
+# endif // ! MLN_INCLUDE_ONLY
+
+ } // end of namespace scribo::binarization
+
+} // end of namespace scribo
+
+
+#endif // ! SCRIBO_BINARIZATION_NIBLACK_THRESHOLD_HH
diff --git a/scribo/scribo/binarization/sauvola.hh b/scribo/scribo/binarization/sauvola.hh
index 45891c3..fc3e104 100644
--- a/scribo/scribo/binarization/sauvola.hh
+++ b/scribo/scribo/binarization/sauvola.hh
@@ -1,5 +1,5 @@
-// Copyright (C) 2009, 2010 EPITA Research and Development Laboratory
-// (LRDE)
+// Copyright (C) 2009, 2010, 2011 EPITA Research and Development
+// Laboratory (LRDE)
//
// This file is part of Olena.
//
@@ -35,15 +35,15 @@
# include <mln/data/transform.hh>
# include <mln/value/int_u8.hh>
-# include <scribo/binarization/sauvola_threshold_image.hh>
+# include <scribo/binarization/sauvola_threshold.hh>
# include <scribo/binarization/local_threshold.hh>
-# include <scribo/binarization/internal/sauvola_debug.hh>
+# include <scribo/binarization/internal/local_threshold_debug.hh>
-# ifdef SCRIBO_SAUVOLA_DEBUG
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
# include <mln/io/pgm/save.hh>
# include <mln/io/pbm/save.hh>
# include <mln/data/saturate.hh>
-# endif // ! SCRIBO_SAUVOLA_DEBUG
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
namespace scribo
{
@@ -110,11 +110,11 @@ namespace scribo
trace::entering("scribo::binarization::impl::generic::sauvola");
mln_precondition(exact(input).is_valid());
+ mln_ch_value(I,value::int_u8)
+ threshold_image = binarization::sauvola_threshold(input, window_size, K);
+
mln_ch_value(I, bool)
- output = local_threshold(input,
- binarization::sauvola_threshold_image(input,
- window_size,
- K));
+ output = local_threshold(input, threshold_image);
trace::exiting("scribo::binarization::impl::generic::sauvola");
return output;
@@ -168,7 +168,7 @@ namespace scribo
mln_ch_value(I, bool)
output = internal::sauvola_dispatch(input, window_size, K);
-# ifdef SCRIBO_SAUVOLA_DEBUG
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
if (internal::stddev_image_output)
io::pgm::save(data::saturate(value::int_u8(), internal::debug_stddev),
internal::stddev_image_output);
@@ -184,7 +184,7 @@ namespace scribo
internal::alpham_image_output);
if (internal::alphacond_image_output)
io::pbm::save(internal::debug_alphacond, internal::alphacond_image_output);
-# endif // ! SCRIBO_SAUVOLA_DEBUG
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
trace::exiting("scribo::binarization::sauvola");
diff --git a/scribo/scribo/binarization/sauvola_ms.hh b/scribo/scribo/binarization/sauvola_ms.hh
index c1a3414..36629f9 100644
--- a/scribo/scribo/binarization/sauvola_ms.hh
+++ b/scribo/scribo/binarization/sauvola_ms.hh
@@ -60,16 +60,15 @@
# include <scribo/core/macros.hh>
-# include <scribo/binarization/sauvola_threshold_image.hh>
# include <scribo/binarization/internal/first_pass_functor.hh>
# include <scribo/canvas/integral_browsing.hh>
-# ifdef SCRIBO_SAUVOLA_DEBUG
-# include <scribo/binarization/internal/sauvola_debug.hh>
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+# include <scribo/binarization/internal/local_threshold_debug.hh>
# include <mln/io/pgm/save.hh>
# include <scribo/make/debug_filename.hh>
-# endif // ! SCRIBO_SAUVOLA_DEBUG
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
@@ -179,7 +178,7 @@ namespace scribo
// 1st pass
scribo::binarization::internal::first_pass_functor< image2d<int_u8> >
- f(sub, K);
+ f(sub, K, SCRIBO_DEFAULT_SAUVOLA_R);
scribo::canvas::integral_browsing(integral_sum_sum_2,
ratio,
w_local_w, w_local_h,
@@ -259,10 +258,10 @@ namespace scribo
} // end of 2nd pass
-# ifdef SCRIBO_SAUVOLA_DEBUG
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
io::pbm::save(f.msk,
scribo::make::debug_filename(internal::threshold_image_output).c_str());
-# endif // ! SCRIBO_SAUVOLA_DEBUG
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
return f.t_sub;
}
@@ -923,18 +922,18 @@ namespace scribo
}
-# ifdef SCRIBO_SAUVOLA_DEBUG
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
if (internal::scale_image_output)
io::pgm::save(e_2, internal::scale_image_output);
-# endif // ! SCRIBO_SAUVOLA_DEBUG
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
// Propagate scale values.
e_2 = transform::influence_zone_geodesic(e_2, c8());
-// # ifdef SCRIBO_SAUVOLA_DEBUG
+// # ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
// if (internal::scale_image_output)
// io::pgm::save(e_2, internal::scale_image_output);
-// # endif // ! SCRIBO_SAUVOLA_DEBUG
+// # endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
// Binarize
image2d<bool>
diff --git a/scribo/scribo/binarization/sauvola_threshold.hh b/scribo/scribo/binarization/sauvola_threshold.hh
new file mode 100644
index 0000000..df46e95
--- /dev/null
+++ b/scribo/scribo/binarization/sauvola_threshold.hh
@@ -0,0 +1,296 @@
+// Copyright (C) 2009, 2010, 2011 EPITA Research and Development
+// Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#ifndef SCRIBO_BINARIZATION_SAUVOLA_THRESHOLD_HH
+# define SCRIBO_BINARIZATION_SAUVOLA_THRESHOLD_HH
+
+/// \file
+///
+/// Compute an image of local threshold using Sauvola algorithm.
+
+/// \fixme return type too restrictive!
+
+# include <algorithm>
+# include <cmath>
+
+# include <mln/core/image/image2d.hh>
+# include <mln/value/int_u.hh>
+# include <mln/value/int_u8.hh>
+
+# include <scribo/core/init_integral_image.hh>
+# include <scribo/binarization/internal/compute_local_threshold.hh>
+# include <scribo/binarization/internal/sauvola_formula.hh>
+
+
+
+namespace scribo
+{
+
+ namespace binarization
+ {
+
+ using namespace mln;
+
+ /*! \brief Compute an image of local threshold using Sauvola algorithm.
+
+ \input[in] input A gray level image.
+ \input[in] window_size The window size.
+ \input[out] simple The sum of all intensities of \p input.
+ \input[out] squared The sum of all squared intensities of \p
+ input.
+
+ \return An image of local thresholds.
+
+ */
+ template <typename I, typename J>
+ mln_ch_value(I, value::int_u8)
+ sauvola_threshold(const Image<I>& input, unsigned window_size,
+ double K,
+ Image<J>& simple,
+ Image<J>& squared);
+
+ /// \overload
+ template <typename I>
+ mln_ch_value(I, value::int_u8)
+ sauvola_threshold(const Image<I>& input, unsigned window_size,
+ double K);
+
+ /// \overload
+ /// K is set to 0.34
+ template <typename I>
+ mln_ch_value(I, value::int_u8)
+ sauvola_threshold(const Image<I>& input, unsigned window_size);
+
+
+ /// \overload
+ /// The window size is set to 11.
+ //
+ template <typename I>
+ mln_ch_value(I, value::int_u8)
+ sauvola_threshold(const Image<I>& input);
+
+
+
+# ifndef MLN_INCLUDE_ONLY
+
+
+ // Implementation
+
+
+ namespace impl
+ {
+
+ namespace generic
+ {
+
+ template <typename I, typename J>
+ inline
+ mln_concrete(I)
+ sauvola_threshold(const Image<I>& input_, unsigned window_size,
+ double K,
+ Image<J>& simple_,
+ Image<J>& squared_)
+ {
+ trace::entering("scribo::binarization::impl::generic::sauvola_threshold");
+
+ const I& input = exact(input_);
+ J& simple = exact(simple_);
+ J& squared = exact(squared_);
+
+ mln_assertion(input.is_valid());
+ mln_assertion(simple.is_valid());
+ mln_assertion(squared.is_valid());
+
+ typedef mln_value(I) V;
+ typedef mln_site(I) P;
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+ initialize(internal::debug_mean, input);
+ initialize(internal::debug_stddev, input);
+ initialize(internal::debug_threshold, input);
+ initialize(internal::debug_alpham, input);
+ initialize(internal::debug_alphacond, input);
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
+
+ // Sauvola Algorithm with I.I.
+
+ mln_concrete(I) output;
+ initialize(output, input);
+
+ const mln::def::coord
+ nrows = static_cast<mln::def::coord>(input.nrows()),
+ ncols = static_cast<mln::def::coord>(input.ncols());
+
+ internal::sauvola_formula formula;
+ for(mln::def::coord row = 0; row < nrows; ++row)
+ for(mln::def::coord col = 0; col < ncols; ++col)
+ {
+ double t = internal::compute_local_threshold(P(row, col), simple,
+ squared, window_size,
+ K,
+ SCRIBO_DEFAULT_SAUVOLA_R,
+ formula);
+ mln::convert::from_to(t, output.at_(row, col));
+
+# ifdef SCRIBO_LOCAL_THRESHOLD_DEBUG
+ internal::debug_threshold.at_(row, col) = t;
+# endif // ! SCRIBO_LOCAL_THRESHOLD_DEBUG
+ }
+
+ trace::exiting("scribo::binarization::impl::generic::sauvola_threshold");
+ return output;
+ }
+
+ } // end of namespace scribo::binarization::impl::generic
+
+
+
+ template <typename I, typename J>
+ inline
+ mln_concrete(I)
+ sauvola_threshold_gl(const I& input, unsigned window_size,
+ double K,
+ Image<J>& simple,
+ Image<J>& squared)
+ {
+ return impl::generic::sauvola_threshold(input, window_size, K,
+ simple, squared);
+ }
+
+
+ } // end of namespace scribo::binarization::impl
+
+
+
+
+ // Dispatch
+
+ namespace internal
+ {
+
+ template <unsigned n, typename I, typename J>
+ inline
+ mln_ch_value(I, value::int_u<n>)
+ sauvola_threshold_dispatch(const value::int_u<n>&, const I& input,
+ unsigned window_size,
+ double K,
+ J& simple,
+ J& squared)
+ {
+ return impl::sauvola_threshold_gl(input, window_size, K,
+ simple, squared);
+ }
+
+
+ template <typename I, typename J>
+ inline
+ mln_ch_value(I, value::int_u8)
+ sauvola_threshold_dispatch(const mln_value(I)&, const I& input,
+ unsigned window_size,
+ double K,
+ J& simple,
+ J& squared)
+ {
+ // No dispatch for this kind of value type.
+ mlc_abort(I)::check();
+
+ typedef mln_ch_value(I,bool) output_t;
+ return output_t();
+ }
+
+
+ } // end of namespace scribo::binarization::internal
+
+
+
+ template <typename I, typename J>
+ mln_ch_value(I, value::int_u8)
+ sauvola_threshold(const Image<I>& input, unsigned window_size,
+ double K,
+ Image<J>& simple,
+ Image<J>& squared)
+ {
+ trace::entering("scribo::binarization::sauvola_threshold");
+
+ mln_precondition(mln_site_(I)::dim == 2);
+ mln_precondition(exact(input).is_valid());
+
+ typedef mln_value(I) value_t;
+ mln_ch_value(I, value::int_u8)
+ output = internal::sauvola_threshold_dispatch(value_t(),
+ exact(input),
+ window_size,
+ K,
+ exact(simple),
+ exact(squared));
+
+ trace::exiting("scribo::text::ppm2pbm");
+ return output;
+ }
+
+
+ template <typename I>
+ inline
+ mln_ch_value(I, value::int_u8)
+ sauvola_threshold(const Image<I>& input, unsigned window_size,
+ double K)
+ {
+ mln_ch_value(I, double)
+ simple = init_integral_image(input, scribo::internal::identity_),
+ squared = init_integral_image(input, scribo::internal::square_);
+
+ return sauvola_threshold(input, window_size,
+ K, simple, squared);
+ }
+
+
+ template <typename I>
+ inline
+ mln_ch_value(I, value::int_u8)
+ sauvola_threshold(const Image<I>& input, unsigned window_size)
+ {
+ return sauvola_threshold(input, window_size,
+ SCRIBO_DEFAULT_SAUVOLA_K);
+ }
+
+
+ template <typename I>
+ inline
+ mln_ch_value(I, value::int_u8)
+ sauvola_threshold(const Image<I>& input)
+ {
+ return sauvola_threshold(input, 11);
+ }
+
+
+# endif // ! MLN_INCLUDE_ONLY
+
+ } // end of namespace scribo::binarization
+
+} // end of namespace scribo
+
+
+#endif // ! SCRIBO_BINARIZATION_SAUVOLA_THRESHOLD_HH
diff --git a/scribo/scribo/binarization/sauvola_threshold_image.hh b/scribo/scribo/binarization/sauvola_threshold_image.hh
deleted file mode 100644
index 94cd688..0000000
--- a/scribo/scribo/binarization/sauvola_threshold_image.hh
+++ /dev/null
@@ -1,301 +0,0 @@
-// Copyright (C) 2009, 2010 EPITA Research and Development Laboratory
-// (LRDE)
-//
-// This file is part of Olena.
-//
-// Olena is free software: you can redistribute it and/or modify it under
-// the terms of the GNU General Public License as published by the Free
-// Software Foundation, version 2 of the License.
-//
-// Olena is distributed in the hope that it will be useful,
-// but WITHOUT ANY WARRANTY; without even the implied warranty of
-// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-// General Public License for more details.
-//
-// You should have received a copy of the GNU General Public License
-// along with Olena. If not, see <http://www.gnu.org/licenses/>.
-//
-// As a special exception, you may use this file as part of a free
-// software project without restriction. Specifically, if other files
-// instantiate templates or use macros or inline functions from this
-// file, or you compile this file and link it with other files to produce
-// an executable, this file does not by itself cause the resulting
-// executable to be covered by the GNU General Public License. This
-// exception does not however invalidate any other reasons why the
-// executable file might be covered by the GNU General Public License.
-
-#ifndef SCRIBO_BINARIZATION_SAUVOLA_THRESHOLD_IMAGE_HH
-# define SCRIBO_BINARIZATION_SAUVOLA_THRESHOLD_IMAGE_HH
-
-/// \file
-///
-/// Compute an image of local threshold using Sauvola algorithm.
-
-/// \fixme return type too restrictive!
-
-# include <algorithm>
-# include <cmath>
-
-# include <mln/core/image/image2d.hh>
-# include <mln/value/int_u.hh>
-# include <mln/value/int_u8.hh>
-
-# include <scribo/core/init_integral_image.hh>
-# include <scribo/binarization/internal/compute_sauvola_threshold.hh>
-
-
-
-namespace scribo
-{
-
- namespace binarization
- {
-
- using namespace mln;
-
- /*! \brief Compute an image of local threshold using Sauvola algorithm.
-
- \input[in] input An image.
- \input[in] window_size The window size.
- \input[out] simple The sum of all intensities of \p input.
- \input[out] squared The sum of all squared intensities of \p
- input.
-
- \return An image of local thresholds.
-
- */
- template <typename I, typename J>
- mln_ch_value(I, value::int_u8)
- sauvola_threshold_image(const Image<I>& input, unsigned window_size,
- double K,
- Image<J>& simple,
- Image<J>& squared);
-
- /// \overload
- template <typename I>
- mln_ch_value(I, value::int_u8)
- sauvola_threshold_image(const Image<I>& input, unsigned window_size,
- double K);
-
- /// \overload
- /// K is set to 0.34
- template <typename I>
- mln_ch_value(I, value::int_u8)
- sauvola_threshold_image(const Image<I>& input, unsigned window_size);
-
-
- /// \overload
- /// The window size is set to 11.
- //
- template <typename I>
- mln_ch_value(I, value::int_u8)
- sauvola_threshold_image(const Image<I>& input);
-
-
-
-# ifndef MLN_INCLUDE_ONLY
-
-
- // Implementation
-
-
- namespace impl
- {
-
- namespace generic
- {
-
- template <typename I, typename J>
- inline
- mln_concrete(I)
- sauvola_threshold_image(const Image<I>& input_, unsigned window_size,
- double K,
- Image<J>& simple_,
- Image<J>& squared_)
- {
- trace::entering("scribo::binarization::impl::generic::sauvola_threshold_image");
-
- const I& input = exact(input_);
- J& simple = exact(simple_);
- J& squared = exact(squared_);
-
- mln_assertion(input.is_valid());
- mln_assertion(simple.is_valid());
- mln_assertion(squared.is_valid());
-
- typedef mln_value(I) V;
- typedef mln_site(I) P;
-
-# ifdef SCRIBO_SAUVOLA_DEBUG
- initialize(internal::debug_mean, input);
- initialize(internal::debug_stddev, input);
- initialize(internal::debug_threshold, input);
- initialize(internal::debug_alpham, input);
- initialize(internal::debug_alphacond, input);
-# endif // ! SCRIBO_SAUVOLA_DEBUG
-
- // Sauvola Algorithm with I.I.
-
- mln_concrete(I) output;
- initialize(output, input);
-
- const mln::def::coord
- nrows = static_cast<mln::def::coord>(input.nrows()),
- ncols = static_cast<mln::def::coord>(input.ncols());
-
-
- for(mln::def::coord row = 0; row < nrows; ++row)
- for(mln::def::coord col = 0; col < ncols; ++col)
- {
-# ifdef SCRIBO_SAUVOLA_DEBUG
-
- double t = internal::compute_sauvola_threshold(P(row, col), simple,
- squared, window_size,
- K,
- SCRIBO_DEFAULT_SAUVOLA_R);
- mln::convert::from_to(t, output.at_(row, col));
- internal::debug_threshold.at_(row, col) = t;
-# else
- mln::convert::from_to(
- internal::compute_sauvola_threshold(P(row, col), simple,
- squared, window_size,
- K,
- SCRIBO_DEFAULT_SAUVOLA_R),
- output.at_(row, col));
-# endif // ! SCRIBO_SAUVOLA_DEBUG
- }
-
- trace::exiting("scribo::binarization::impl::generic::sauvola_threshold");
- return output;
- }
-
- } // end of namespace scribo::binarization::impl::generic
-
-
-
- template <typename I, typename J>
- inline
- mln_concrete(I)
- sauvola_threshold_image_gl(const I& input, unsigned window_size,
- double K,
- Image<J>& simple,
- Image<J>& squared)
- {
- return impl::generic::sauvola_threshold_image(input, window_size, K,
- simple, squared);
- }
-
-
- } // end of namespace scribo::binarization::impl
-
-
-
-
- // Dispatch
-
- namespace internal
- {
-
- template <unsigned n, typename I, typename J>
- inline
- mln_ch_value(I, value::int_u<n>)
- sauvola_threshold_image_dispatch(const value::int_u<n>&, const I& input,
- unsigned window_size,
- double K,
- J& simple,
- J& squared)
- {
- return impl::sauvola_threshold_image_gl(input, window_size, K,
- simple, squared);
- }
-
-
- template <typename I, typename J>
- inline
- mln_ch_value(I, value::int_u8)
- sauvola_threshold_image_dispatch(const mln_value(I)&, const I& input,
- unsigned window_size,
- double K,
- J& simple,
- J& squared)
- {
- // No dispatch for this kind of value type.
- mlc_abort(I)::check();
-
- typedef mln_ch_value(I,bool) output_t;
- return output_t();
- }
-
-
- } // end of namespace scribo::binarization::internal
-
-
-
- template <typename I, typename J>
- mln_ch_value(I, value::int_u8)
- sauvola_threshold_image(const Image<I>& input, unsigned window_size,
- double K,
- Image<J>& simple,
- Image<J>& squared)
- {
- trace::entering("scribo::binarization::sauvola_threshold_image");
-
- mln_precondition(mln_site_(I)::dim == 2);
- mln_precondition(exact(input).is_valid());
-
- typedef mln_value(I) value_t;
- mln_ch_value(I, value::int_u8)
- output = internal::sauvola_threshold_image_dispatch(value_t(),
- exact(input),
- window_size,
- K,
- exact(simple),
- exact(squared));
-
- trace::exiting("scribo::text::ppm2pbm");
- return output;
- }
-
-
- template <typename I>
- inline
- mln_ch_value(I, value::int_u8)
- sauvola_threshold_image(const Image<I>& input, unsigned window_size,
- double K)
- {
- mln_ch_value(I, double)
- simple = init_integral_image(input, scribo::internal::identity_),
- squared = init_integral_image(input, scribo::internal::square_);
-
- return sauvola_threshold_image(input, window_size,
- K, simple, squared);
- }
-
-
- template <typename I>
- inline
- mln_ch_value(I, value::int_u8)
- sauvola_threshold_image(const Image<I>& input, unsigned window_size)
- {
- return sauvola_threshold_image(input, window_size,
- SCRIBO_DEFAULT_SAUVOLA_K);
- }
-
-
- template <typename I>
- inline
- mln_ch_value(I, value::int_u8)
- sauvola_threshold_image(const Image<I>& input)
- {
- return sauvola_threshold_image(input, 11);
- }
-
-
-# endif // ! MLN_INCLUDE_ONLY
-
- } // end of namespace scribo::binarization
-
-} // end of namespace scribo
-
-
-#endif // ! SCRIBO_BINARIZATION_SAUVOLA_THRESHOLD_IMAGE_HH
diff --git a/scribo/src/binarization/Makefile.am b/scribo/src/binarization/Makefile.am
index 315e621..567972a 100644
--- a/scribo/src/binarization/Makefile.am
+++ b/scribo/src/binarization/Makefile.am
@@ -46,6 +46,7 @@ if HAVE_MAGICKXX
sauvola_ms_debug
utilexec_PROGRAMS = \
+ niblack \
otsu \
sauvola \
sauvola_ms \
@@ -60,6 +61,13 @@ if HAVE_MAGICKXX
$(MAGICKXX_LDFLAGS)
+ niblack_SOURCES = niblack.cc
+ niblack_CPPFLAGS = $(AM_CPPFLAGS) \
+ $(MAGICKXX_CPPFLAGS)
+ niblack_LDFLAGS = $(AM_LDFLAGS) \
+ $(MAGICKXX_LDFLAGS)
+
+
otsu_SOURCES = otsu.cc
otsu_CPPFLAGS = $(AM_CPPFLAGS) \
$(MAGICKXX_CPPFLAGS)
@@ -80,7 +88,7 @@ if HAVE_MAGICKXX
sauvola_debug_SOURCES = sauvola_debug.cc
sauvola_debug_CPPFLAGS = $(AM_CPPFLAGS) \
- -DSCRIBO_SAUVOLA_DEBUG \
+ -DSCRIBO_LOCAL_THRESHOLD_DEBUG \
$(MAGICKXX_CPPFLAGS)
sauvola_debug_LDFLAGS = $(AM_LDFLAGS) \
$(MAGICKXX_LDFLAGS)
@@ -94,7 +102,7 @@ if HAVE_MAGICKXX
sauvola_ms_debug_SOURCES = sauvola_ms_debug.cc
sauvola_ms_debug_CPPFLAGS = $(AM_CPPFLAGS) \
- -DSCRIBO_SAUVOLA_DEBUG \
+ -DSCRIBO_LOCAL_THRESHOLD_DEBUG \
$(MAGICKXX_CPPFLAGS)
sauvola_ms_debug_LDFLAGS = $(AM_LDFLAGS) \
$(MAGICKXX_LDFLAGS)
diff --git a/scribo/src/binarization/niblack.cc b/scribo/src/binarization/niblack.cc
new file mode 100644
index 0000000..4b7ed91
--- /dev/null
+++ b/scribo/src/binarization/niblack.cc
@@ -0,0 +1,106 @@
+// Copyright (C) 2011 EPITA Research and Development Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+#include <mln/core/image/image2d.hh>
+#include <mln/value/int_u8.hh>
+#include <mln/io/magick/load.hh>
+#include <mln/io/pbm/save.hh>
+#include <mln/data/transform.hh>
+#include <mln/fun/v2v/rgb_to_luma.hh>
+
+#include <scribo/binarization/niblack.hh>
+#include <scribo/debug/option_parser.hh>
+#include <scribo/debug/logger.hh>
+
+static const scribo::debug::arg_data arg_desc[] =
+{
+ { "input.*", "An image." },
+ { "output.pbm", "A binary image." },
+ {0, 0}
+};
+
+
+// --enable/disable-<name>
+static const scribo::debug::toggle_data toggle_desc[] =
+{
+ // name, description, default value
+ {0, 0, false}
+};
+
+
+// --<name> <args>
+static const scribo::debug::opt_data opt_desc[] =
+{
+ // name, description, arguments, check args function, number of args, default arg
+ { "debug-prefix", "Enable debug image outputs. Prefix image name with that "
+ "given prefix.", "<prefix>", 0, 1, 0 },
+ { "k", "Niblack's formulae parameter", "<value>", 0, 1, "-0.2" },
+ { "verbose", "Enable verbose mode", 0, 0, 0, 0 },
+ { "win-size", "Window size", "<size>", 0, 1, "101" },
+ {0, 0, 0, 0, 0, 0}
+};
+
+
+
+int main(int argc, char *argv[])
+{
+ using namespace mln;
+
+ scribo::debug::option_parser options(arg_desc, toggle_desc, opt_desc);
+
+ if (!options.parse(argc, argv))
+ return 1;
+
+ // Enable debug output.
+ if (options.is_set("debug-prefix"))
+ {
+ scribo::debug::logger().set_filename_prefix(options.opt_value("debug-prefix").c_str());
+ scribo::debug::logger().set_level(scribo::debug::All);
+ }
+
+ Magick::InitializeMagick(*argv);
+
+ trace::entering("main");
+
+ bool verbose = options.is_set("verbose");
+ unsigned w = atoi(options.opt_value("win-size").c_str());
+ double k = atof(options.opt_value("k").c_str());
+
+ if (verbose)
+ std::cout << "Using w=" << w << " and k=" << k << std::endl;
+
+ image2d<value::rgb8> input;
+ io::magick::load(input, options.arg("input.*"));
+
+ // Convert to Gray level image.
+ image2d<value::int_u8>
+ input_1_gl = data::transform(input, mln::fun::v2v::rgb_to_luma<value::int_u8>());
+
+ image2d<bool> out = scribo::binarization::niblack(input_1_gl, w, k);
+
+ io::pbm::save(out, options.arg("output.pbm"));
+
+ trace::exiting("main");
+}
diff --git a/scribo/src/binarization/pgm_sauvola_threshold_image.cc b/scribo/src/binarization/pgm_sauvola_threshold_image.cc
index a38784a..69e2e15 100644
--- a/scribo/src/binarization/pgm_sauvola_threshold_image.cc
+++ b/scribo/src/binarization/pgm_sauvola_threshold_image.cc
@@ -1,4 +1,5 @@
-// Copyright (C) 2010 EPITA Research and Development Laboratory (LRDE)
+// Copyright (C) 2010, 2011 EPITA Research and Development Laboratory
+// (LRDE)
//
// This file is part of Olena.
//
@@ -25,7 +26,7 @@
#include <mln/io/pgm/all.hh>
-#include <scribo/binarization/sauvola.hh>
+#include <scribo/binarization/sauvola_threshold.hh>
#include <scribo/debug/usage.hh>
const char *args_desc[][2] =
@@ -67,7 +68,7 @@ int main(int argc, char *argv[])
image2d<value::int_u8> input;
io::pgm::load(input, argv[1]);
- image2d<value::int_u8> out = scribo::binarization::sauvola_threshold_image(input, w, k);
+ image2d<value::int_u8> out = scribo::binarization::sauvola_threshold(input, w, k);
io::pgm::save(out, argv[2]);
diff --git a/scribo/tests/binarization/Makefile.am b/scribo/tests/binarization/Makefile.am
index b8ab2d9..a2962bb 100644
--- a/scribo/tests/binarization/Makefile.am
+++ b/scribo/tests/binarization/Makefile.am
@@ -21,6 +21,7 @@
include $(top_srcdir)/scribo/tests/tests.mk
EXTRA_DIST = \
+ niblack.res.pbm \
sauvola_ms.ref.pbm \
sauvola.ref.pbm \
otsu.ref.pbm
@@ -28,6 +29,7 @@ EXTRA_DIST = \
check_PROGRAMS = \
global_threshold \
local_threshold \
+ niblack \
otsu \
sauvola \
sauvola_ms
@@ -35,6 +37,7 @@ check_PROGRAMS = \
global_threshold_SOURCES = global_threshold.cc
local_threshold_SOURCES = local_threshold.cc
+niblack_SOURCES = niblack.cc
otsu_SOURCES = otsu.cc
sauvola_SOURCES = sauvola.cc
sauvola_ms_SOURCES = sauvola_ms.cc
diff --git a/scribo/tests/binarization/niblack.cc b/scribo/tests/binarization/niblack.cc
new file mode 100644
index 0000000..99a58e2
--- /dev/null
+++ b/scribo/tests/binarization/niblack.cc
@@ -0,0 +1,52 @@
+// Copyright (C) 2011 EPITA Research and Development Laboratory (LRDE)
+//
+// This file is part of Olena.
+//
+// Olena is free software: you can redistribute it and/or modify it under
+// the terms of the GNU General Public License as published by the Free
+// Software Foundation, version 2 of the License.
+//
+// Olena is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with Olena. If not, see <http://www.gnu.org/licenses/>.
+//
+// As a special exception, you may use this file as part of a free
+// software project without restriction. Specifically, if other files
+// instantiate templates or use macros or inline functions from this
+// file, or you compile this file and link it with other files to produce
+// an executable, this file does not by itself cause the resulting
+// executable to be covered by the GNU General Public License. This
+// exception does not however invalidate any other reasons why the
+// executable file might be covered by the GNU General Public License.
+
+/// \file
+
+#include <mln/core/image/image2d.hh>
+#include <mln/data/compare.hh>
+#include <mln/value/int_u8.hh>
+#include <mln/io/pgm/load.hh>
+#include <mln/io/pbm/load.hh>
+#include <mln/io/pbm/save.hh>
+
+#include <scribo/binarization/niblack.hh>
+
+#include "tests/data.hh"
+
+int main()
+{
+ using namespace mln;
+
+ image2d<value::int_u8> input;
+ io::pgm::load(input, MILENA_IMG_DIR "/lena.pgm");
+
+ image2d<bool> bin = scribo::binarization::niblack(input, 101);
+
+ image2d<bool> ref;
+ io::pbm::load(ref, SCRIBO_TESTS_DIR "binarization/niblack.ref.pbm");
+
+ mln_assertion(bin == ref);
+}
diff --git a/scribo/tests/binarization/niblack.ref.pbm b/scribo/tests/binarization/niblack.ref.pbm
new file mode 100644
index 0000000000000000000000000000000000000000..7a3435193f1961f8161b71f8f60f3102d5ebbf87
GIT binary patch
literal 16498
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
literal 0
HcmV?d00001
--
1.7.2.5
1
0
olena-2.0-12-g769726b Move Otsu's threshold computation in a separate routine.
by Guillaume Lazzara 29 Nov '11
by Guillaume Lazzara 29 Nov '11
29 Nov '11
* scribo/binarization/otsu.hh,
* scribo/binarization/otsu_threshold.hh: Move threshold
computation in a separate routine.
---
scribo/ChangeLog | 8 +++
scribo/scribo/binarization/otsu.hh | 56 +-------------------
.../binarization/{otsu.hh => otsu_threshold.hh} | 31 +++++------
3 files changed, 23 insertions(+), 72 deletions(-)
copy scribo/scribo/binarization/{otsu.hh => otsu_threshold.hh} (84%)
diff --git a/scribo/ChangeLog b/scribo/ChangeLog
index 0923b28..6381a60 100644
--- a/scribo/ChangeLog
+++ b/scribo/ChangeLog
@@ -1,5 +1,13 @@
2011-10-17 Guillaume Lazzara <z(a)lrde.epita.fr>
+ Move Otsu's threshold computation in a separate routine.
+
+ * scribo/binarization/otsu.hh,
+ * scribo/binarization/otsu_threshold.hh: Move threshold
+ computation in a separate routine.
+
+2011-10-17 Guillaume Lazzara <z(a)lrde.epita.fr>
+
Add Niblack's binarization algorithm.
* scribo/binarization/all.hh: Update includes.
diff --git a/scribo/scribo/binarization/otsu.hh b/scribo/scribo/binarization/otsu.hh
index c96a207..6b9d492 100644
--- a/scribo/scribo/binarization/otsu.hh
+++ b/scribo/scribo/binarization/otsu.hh
@@ -27,12 +27,8 @@
# define SCRIBO_BINARIZATION_OTSU_HH
# include <mln/core/concept/image.hh>
-# include <mln/util/array.hh>
-# include <mln/geom/nsites.hh>
-# include <mln/geom/ncols.hh>
-# include <mln/geom/nrows.hh>
-# include <mln/histo/compute.hh>
+# include <scribo/binarization/otsu_threshold.hh>
# include <scribo/binarization/global_threshold.hh>
namespace scribo
@@ -72,55 +68,7 @@ namespace scribo
mlc_is_a(mln_value(I), value::Scalar)::check();
// FIXME: Check that input value is gray level.
- mln_value(I) maxval = mln_max(mln_value(I));
- unsigned nsites = geom::nsites(input);
-
- /* Histogram generation */
- histo::array<mln_value(I)> hist = mln::histo::compute(input);
-
-
- /* calculation of probability density */
- util::array<double> pdf(hist.nvalues()); //probability distribution
- for(int i = 0; i< maxval; ++i)
- pdf[i] = (double)hist[i] / nsites;
-
-
- util::array<double> cdf(hist.nvalues()); //cumulative probability distribution
- util::array<double> myu(hist.nvalues()); // mean value for separation
-
- /* cdf & myu generation */
- cdf[0] = pdf[0];
- myu[0] = 0.0; /* 0.0 times prob[0] equals zero */
-
- for(int i = 1; i < maxval; ++i)
- {
- cdf[i] = cdf[i-1] + pdf[i];
- myu[i] = myu[i-1] + i*pdf[i];
- }
-
- /* sigma maximization
- sigma stands for inter-class variance
- and determines optimal threshold value */
- int threshold = 0;
- double max_sigma = 0.0;
- util::array<double> sigma(hist.nvalues()); // inter-class variance
-
- for(int i = 0; i < maxval - 1; ++i)
- {
- if(cdf[i] != 0.0 && cdf[i] != 1.0)
- {
- double p1p2 = cdf[i] * (1.0 - cdf[i]);
- double mu1mu2diff = myu[maxval - 1] * cdf[i] - myu[i];
- sigma[i] = mu1mu2diff * mu1mu2diff / p1p2;
- }
- else
- sigma[i] = 0.0;
- if(sigma[i] > max_sigma)
- {
- max_sigma = sigma[i];
- threshold = i;
- }
- }
+ mln_value(I) threshold = otsu_threshold(input);
// Computing final result.
mln_ch_value(I,bool) output = global_threshold(input, threshold);
diff --git a/scribo/scribo/binarization/otsu.hh b/scribo/scribo/binarization/otsu_threshold.hh
similarity index 84%
copy from scribo/scribo/binarization/otsu.hh
copy to scribo/scribo/binarization/otsu_threshold.hh
index c96a207..ab663d0 100644
--- a/scribo/scribo/binarization/otsu.hh
+++ b/scribo/scribo/binarization/otsu_threshold.hh
@@ -23,8 +23,8 @@
// exception does not however invalidate any other reasons why the
// executable file might be covered by the GNU General Public License.
-#ifndef SCRIBO_BINARIZATION_OTSU_HH
-# define SCRIBO_BINARIZATION_OTSU_HH
+#ifndef SCRIBO_BINARIZATION_OTSU_THRESHOLD_HH
+# define SCRIBO_BINARIZATION_OTSU_THRESHOLD_HH
# include <mln/core/concept/image.hh>
# include <mln/util/array.hh>
@@ -33,8 +33,6 @@
# include <mln/geom/nrows.hh>
# include <mln/histo/compute.hh>
-# include <scribo/binarization/global_threshold.hh>
-
namespace scribo
{
@@ -43,29 +41,28 @@ namespace scribo
using namespace mln;
- /*! An implementation of Otsu's binarization algorithm.
+ /*! Compute a global binarization threshold using Otsu's algorithm.
It is based on Ocropus's implementation.
http://code.google.com/p/ocropus/
\param[in] input A gray-scale image.
- \return A binary image. True for foreground, False for
- background.
+ \return A global threshold value.
*/
template <typename I>
- mln_ch_value(I,bool)
- otsu(const Image<I>& input);
+ mln_value(I)
+ otsu_threshold(const Image<I>& input);
# ifndef MLN_INCLUDE_ONLY
template <typename I>
- mln_ch_value(I,bool)
- otsu(const Image<I>& input_)
+ mln_value(I)
+ otsu_threshold(const Image<I>& input_)
{
- trace::entering("scribo::binarization::otsu");
+ trace::entering("scribo::binarization::otsu_threshold");
const I& input = exact(input_);
mln_precondition(input.is_valid());
@@ -101,7 +98,7 @@ namespace scribo
/* sigma maximization
sigma stands for inter-class variance
and determines optimal threshold value */
- int threshold = 0;
+ mln_value(I) threshold = literal::zero;
double max_sigma = 0.0;
util::array<double> sigma(hist.nvalues()); // inter-class variance
@@ -122,10 +119,8 @@ namespace scribo
}
}
- // Computing final result.
- mln_ch_value(I,bool) output = global_threshold(input, threshold);
-
- return output;
+ trace::exiting("scribo::binarization::otsu_threshold");
+ return threshold;
}
# endif // ! MLN_INCLUDE_ONLY
@@ -134,4 +129,4 @@ namespace scribo
} // end of namespace scribo
-#endif // ! SCRIBO_BINARIZATION_OTSU_HH
+#endif // ! SCRIBO_BINARIZATION_OTSU_THRESHOLD_HH
--
1.7.2.5
1
0
---
configure.ac | 2 +
doc/.gitignore | 9 +
doc/Doxyfile.in | 361 +++++++++
doc/DoxygenLayout.xml | 184 +++++
doc/Makefile.am | 155 ++++
doc/doxygen.css | 856 ++++++++++++++++++++
doc/footer.html | 5 +
doc/header.html | 46 ++
doc/logo.jpg | Bin 0 -> 7477 bytes
doc/mainpage.hh | 38 +
doc/olena.qhcp | 12 +
doc/subdoc_footer.html | 6 +
milena/doc/Doxyfile.in | 42 +-
milena/doc/DoxygenLayout.xml | 184 +++++
milena/doc/milena.qhcp | 11 +
scribo/doc/.gitignore | 13 +
scribo/doc/Doxyfile.in | 373 +++++++++
scribo/doc/DoxygenLayout.xml | 184 +++++
scribo/doc/Makefile.am | 250 ++++++
{milena => scribo}/doc/doxyfuns.sty | 0
.../doc/examples-outputs.mk | 0
scribo/doc/examples.mk | 4 +
.../doc/examples/dummy.cc | 0
.../doc/figures.mk | 0
{milena => scribo}/doc/gen-examples-outputs-mk | 0
{milena => scribo}/doc/gen-figures-mk | 0
{milena => scribo}/doc/gen-make-variable | 0
{milena => scribo}/doc/gen-split-examples-mk | 0
{milena => scribo}/doc/gen-split-outputs-mk | 0
{milena => scribo}/doc/graphicx.hva | 0
scribo/doc/outputs.mk | 4 +
.../doc/outputs/dummy.txt | 0
.../doc/programs-examples.mk | 0
scribo/doc/scribo.qhcp | 11 +
milena/doc/milena.sty => scribo/doc/scribo.sty | 0
.../doc/split-examples.mk | 0
.../doc/split-outputs.mk | 0
{milena => scribo}/doc/tools/todoxygen.sh | 0
.../doc/tutorial.tex | 0
39 files changed, 2735 insertions(+), 15 deletions(-)
create mode 100644 doc/.gitignore
create mode 100644 doc/Doxyfile.in
create mode 100644 doc/DoxygenLayout.xml
create mode 100644 doc/Makefile.am
create mode 100644 doc/doxygen.css
create mode 100644 doc/footer.html
create mode 100644 doc/header.html
create mode 100644 doc/logo.jpg
create mode 100644 doc/mainpage.hh
create mode 100644 doc/olena.qhcp
create mode 100644 doc/subdoc_footer.html
create mode 100644 milena/doc/DoxygenLayout.xml
create mode 100644 milena/doc/milena.qhcp
create mode 100644 scribo/doc/.gitignore
create mode 100644 scribo/doc/Doxyfile.in
create mode 100644 scribo/doc/DoxygenLayout.xml
create mode 100644 scribo/doc/Makefile.am
copy {milena => scribo}/doc/doxyfuns.sty (100%)
copy milena/doc/outputs/accu-right-instantiation.txt => scribo/doc/examples-outputs.mk (100%)
create mode 100644 scribo/doc/examples.mk
copy milena/doc/outputs/accu-right-instantiation.txt => scribo/doc/examples/dummy.cc (100%)
copy milena/doc/outputs/accu-right-instantiation.txt => scribo/doc/figures.mk (100%)
copy {milena => scribo}/doc/gen-examples-outputs-mk (100%)
copy {milena => scribo}/doc/gen-figures-mk (100%)
copy {milena => scribo}/doc/gen-make-variable (100%)
copy {milena => scribo}/doc/gen-split-examples-mk (100%)
copy {milena => scribo}/doc/gen-split-outputs-mk (100%)
copy {milena => scribo}/doc/graphicx.hva (100%)
create mode 100644 scribo/doc/outputs.mk
copy milena/doc/outputs/accu-right-instantiation.txt => scribo/doc/outputs/dummy.txt (100%)
copy milena/doc/outputs/accu-right-instantiation.txt => scribo/doc/programs-examples.mk (100%)
create mode 100644 scribo/doc/scribo.qhcp
copy milena/doc/milena.sty => scribo/doc/scribo.sty (100%)
copy milena/doc/outputs/accu-right-instantiation.txt => scribo/doc/split-examples.mk (100%)
copy milena/doc/outputs/accu-right-instantiation.txt => scribo/doc/split-outputs.mk (100%)
copy {milena => scribo}/doc/tools/todoxygen.sh (100%)
copy milena/doc/outputs/accu-right-instantiation.txt => scribo/doc/tutorial.tex (100%)
diff --git a/configure.ac b/configure.ac
index a53bcf8..d07ecdb 100644
--- a/configure.ac
+++ b/configure.ac
@@ -339,6 +339,7 @@ AC_CONFIG_FILES([
scribo/demo/review/Makefile
scribo/demo/viewer/Makefile
scribo/demo/xml2doc/Makefile
+ scribo/doc/Makefile
scribo/src/Makefile
scribo/src/binarization/Makefile
scribo/src/contest/Makefile
@@ -406,6 +407,7 @@ AC_CONFIG_FILES([milena/doc/tools/data.hh])
# Ask for the Makefile creations.
AC_CONFIG_FILES([
Makefile
+ doc/Makefile
external/Makefile
milena/Makefile
milena/doc/Makefile
diff --git a/doc/.gitignore b/doc/.gitignore
new file mode 100644
index 0000000..9b600ce
--- /dev/null
+++ b/doc/.gitignore
@@ -0,0 +1,9 @@
+/Doxyfile_user
+/user-refman
+/user-refman.pdf
+
+/Doxyfile_devel
+/devel-refman
+/devel-refman.pdf
+
+/figures/*.png
diff --git a/doc/Doxyfile.in b/doc/Doxyfile.in
new file mode 100644
index 0000000..106c58c
--- /dev/null
+++ b/doc/Doxyfile.in
@@ -0,0 +1,361 @@
+# Copyright (C) 2011 EPITA Research and Development Laboratory (LRDE)
+#
+# This file is part of Olena.
+#
+# Olena is free software: you can redistribute it and/or modify it under
+# the terms of the GNU General Public License as published by the Free
+# Software Foundation, version 2 of the License.
+#
+# Olena is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Olena. If not, see <http://www.gnu.org/licenses/>.
+#
+# Doxyfile 1.5.1
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "Olena"
+PROJECT_NUMBER = "@PACKAGE_VERSION@"
+PROJECT_BRIEF = "An Image Processing Platform"
+PROJECT_LOGO = @top_srcdir@/doc/logo.jpg
+OUTPUT_DIRECTORY = @builddir@/user-refman.tmp
+CREATE_SUBDIRS = NO
+OUTPUT_LANGUAGE = English
+BRIEF_MEMBER_DESC = YES
+REPEAT_BRIEF = YES
+ABBREVIATE_BRIEF =
+ALWAYS_DETAILED_SEC = YES
+INLINE_INHERITED_MEMB = YES
+FULL_PATH_NAMES = NO
+STRIP_FROM_PATH = @top_srcdir@
+STRIP_FROM_INC_PATH =
+SHORT_NAMES = YES
+JAVADOC_AUTOBRIEF = YES
+MULTILINE_CPP_IS_BRIEF = NO
+INHERIT_DOCS = YES
+SEPARATE_MEMBER_PAGES = NO
+TAB_SIZE = 8
+ALIASES =
+OPTIMIZE_OUTPUT_FOR_C = NO
+OPTIMIZE_OUTPUT_JAVA = NO
+BUILTIN_STL_SUPPORT = YES
+IDL_PROPERTY_SUPPORT = NO
+DISTRIBUTE_GROUP_DOC = NO
+SUBGROUPING = YES
+#---------------------------------------------------------------------------
+# Build related configuration options
+#---------------------------------------------------------------------------
+EXTRACT_ALL = NO
+EXTRACT_PRIVATE = NO
+EXTRACT_STATIC = NO
+EXTRACT_LOCAL_CLASSES = NO
+EXTRACT_LOCAL_METHODS = NO
+HIDE_UNDOC_MEMBERS = NO
+HIDE_UNDOC_CLASSES = NO
+HIDE_FRIEND_COMPOUNDS = YES
+HIDE_IN_BODY_DOCS = YES
+INTERNAL_DOCS = NO
+CASE_SENSE_NAMES = YES
+HIDE_SCOPE_NAMES = NO
+SHOW_INCLUDE_FILES = NO
+INLINE_INFO = YES
+SORT_MEMBER_DOCS = YES
+SORT_BRIEF_DOCS = YES
+SORT_BY_SCOPE_NAME = YES
+GENERATE_TODOLIST = NO
+GENERATE_TESTLIST = NO
+GENERATE_BUGLIST = NO
+GENERATE_DEPRECATEDLIST= NO
+ENABLED_SECTIONS =
+MAX_INITIALIZER_LINES = 30
+SHOW_USED_FILES = NO # Disabled for light doc
+SHOW_DIRECTORIES = NO # Disabled for light doc
+SHOW_FILES = NO # Disabled for light doc
+SHOW_NAMESPACES = YES
+FILE_VERSION_FILTER =
+#---------------------------------------------------------------------------
+# configuration options related to warning and progress messages
+#---------------------------------------------------------------------------
+QUIET = YES
+WARNINGS = YES
+WARN_IF_UNDOCUMENTED = YES
+WARN_IF_DOC_ERROR = YES
+WARN_NO_PARAMDOC = NO
+WARN_FORMAT = "$file:$line: $text"
+WARN_LOGFILE =
+#---------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = @top_srcdir@/doc
+FILE_PATTERNS = *.cc \
+ *.hh \
+ *.hxx \
+ *.hcc
+RECURSIVE = YES
+EXCLUDE = @top_srcdir@/milena/ \
+ @top_srcdir@/scribo/
+EXCLUDE_SYMLINKS = YES
+EXCLUDE_PATTERNS = *spe.hh
+EXCLUDE_SYMBOLS = *::internal* *_ mln::trait::*
+EXAMPLE_PATH =
+EXAMPLE_PATTERNS = *.cc \
+ *.cc.raw \
+ *.txt
+EXAMPLE_RECURSIVE = NO
+IMAGE_PATH =
+INPUT_FILTER =
+FILTER_PATTERNS =
+FILTER_SOURCE_FILES = NO
+INPUT_ENCODING = ISO-8859-1
+
+#---------------------------------------------------------------------------
+# configuration options related to source browsing
+#---------------------------------------------------------------------------
+SOURCE_BROWSER = NO
+INLINE_SOURCES = NO
+STRIP_CODE_COMMENTS = YES
+REFERENCED_BY_RELATION = YES
+REFERENCES_RELATION = YES
+REFERENCES_LINK_SOURCE = NO
+USE_HTAGS = NO
+VERBATIM_HEADERS = YES
+#---------------------------------------------------------------------------
+# configuration options related to the alphabetical class index
+#---------------------------------------------------------------------------
+ALPHABETICAL_INDEX = NO
+COLS_IN_ALPHA_INDEX = 5
+IGNORE_PREFIX = mln::
+#---------------------------------------------------------------------------
+# configuration options related to the HTML output
+#---------------------------------------------------------------------------
+GENERATE_HTML = YES
+HTML_OUTPUT = html
+HTML_FILE_EXTENSION = .html
+HTML_HEADER = @top_srcdir@/doc/header.html
+HTML_FOOTER = @top_srcdir@/doc/footer.html
+HTML_STYLESHEET = @top_srcdir@/doc/doxygen.css
+LAYOUT_FILE = @top_srcdir@/doc/DoxygenLayout.xml
+HTML_ALIGN_MEMBERS = YES
+GENERATE_HTMLHELP = NO
+CHM_FILE =
+HHC_LOCATION =
+GENERATE_CHI = NO
+BINARY_TOC = NO
+TOC_EXPAND = NO
+DISABLE_INDEX = NO
+ENUM_VALUES_PER_LINE = 4
+GENERATE_TREEVIEW = NO
+TREEVIEW_WIDTH = 250
+#---------------------------------------------------------------------------
+# configuration options related to the LaTeX output
+#---------------------------------------------------------------------------
+GENERATE_LATEX = NO
+LATEX_OUTPUT = latex
+LATEX_CMD_NAME = latex
+MAKEINDEX_CMD_NAME = makeindex
+COMPACT_LATEX = NO
+PAPER_TYPE = a4wide
+EXTRA_PACKAGES =
+LATEX_HEADER =
+PDF_HYPERLINKS = YES
+USE_PDFLATEX = YES
+LATEX_BATCHMODE = YES
+LATEX_HIDE_INDICES = NO
+#---------------------------------------------------------------------------
+# configuration options related to the RTF output
+#---------------------------------------------------------------------------
+GENERATE_RTF = NO
+RTF_OUTPUT = rtf
+COMPACT_RTF = NO
+RTF_HYPERLINKS = NO
+RTF_STYLESHEET_FILE =
+RTF_EXTENSIONS_FILE =
+#---------------------------------------------------------------------------
+# configuration options related to the man page output
+#---------------------------------------------------------------------------
+GENERATE_MAN = NO
+MAN_OUTPUT = man
+MAN_EXTENSION = .3
+MAN_LINKS = NO
+#---------------------------------------------------------------------------
+# configuration options related to the XML output
+#---------------------------------------------------------------------------
+GENERATE_XML = NO
+XML_OUTPUT = xml
+XML_SCHEMA =
+XML_DTD =
+XML_PROGRAMLISTING = YES
+#---------------------------------------------------------------------------
+# configuration options for the AutoGen Definitions output
+#---------------------------------------------------------------------------
+GENERATE_AUTOGEN_DEF = NO
+#---------------------------------------------------------------------------
+# configuration options related to the Perl module output
+#---------------------------------------------------------------------------
+GENERATE_PERLMOD = NO
+PERLMOD_LATEX = NO
+PERLMOD_PRETTY = YES
+PERLMOD_MAKEVAR_PREFIX =
+#---------------------------------------------------------------------------
+# Configuration options related to the preprocessor
+#---------------------------------------------------------------------------
+ENABLE_PREPROCESSING = YES
+MACRO_EXPANSION = YES
+EXPAND_ONLY_PREDEF = YES
+SEARCH_INCLUDES = YES
+INCLUDE_PATH =
+INCLUDE_FILE_PATTERNS =
+PREDEFINED = "for_all(x)=for(x.start(); x.is_valid(); x.next())" \
+ "for_all_2(x1, x2)=for(x1.start(), x2.start(); x1.is_valid(); x1.next(), x2.next())" \
+ "for_all_3(x1, x2, x3)=for(x1.start(), x2.start(), x3.start(); x1.is_valid(); x1.next(), x2.next(), x3.next())" \
+ "for_all_remaining(x)=if (! x.is_valid()) {} else while (x.next(), x.is_valid())" \
+ "mlc_unqualif(T)=typename mln::metal::unqualif<T>::ret" \
+ "mlc_equal(T1,T2)=mln::metal::equal<T1,T2>" \
+ "mln_piter(T)=typename T::piter" \
+ "mln_fwd_piter(T)=typename T::fwd_piter" \
+ "mln_bkd_piter(T)=typename T::bkd_piter" \
+ "mln_qiter(T)=typename T::qiter" \
+ "mln_fwd_qiter(T)=typename T::fwd_qiter" \
+ "mln_bkd_qiter(T)=typename T::bkd_qiter" \
+ "mln_niter(T)=typename T::niter" \
+ "mln_fwd_niter(T)=typename T::fwd_niter" \
+ "mln_bkd_niter(T)=typename T::bkd_niter" \
+ "mln_viter(T)=typename T::viter" \
+ "mln_fwd_viter(T)=typename T::fwd_viter" \
+ "mln_bkd_viter(T)=typename T::bkd_viter" \
+ "mln_result(T)=typename T::result" \
+ "mln_enc(T)=typename T::enc" \
+ "mln_value(T)=typename T::value" \
+ "mln_qlf_value(T)=typename T::qlf_value" \
+ "mln_domain(T)=typename T::domain_t" \
+ "mln_sum(T)=typename mln::value::props<T>::sum" \
+ "mln_vset(T)=typename T::vset" \
+ "mln_rvalue(T)=typename T::rvalue" \
+ "mln_lvalue(T)=typename T::lvalue" \
+ "mln_mesh(T)=typename T::mesh" \
+ "mln_coord(T)=typename T::coord" \
+ "mln_site(T)=typename T::site" \
+ "mln_psite(T)=typename T::psite" \
+ "mln_dpsite(T)=typename T::dpsite" \
+ "mln_accu_with(A, T)=typename A::template with< T >::ret" \
+ "mln_trait_op_div(L, R)=typename mln::trait::op::div< L , R >::ret" \
+ "mln_trait_op_less(L, R)=typename mln::trait::op::less< L , R >::ret" \
+ "mln_trait_op_minus(L, R)=typename mln::trait::op::minus< L , R >::ret" \
+ "mln_trait_op_mod(L, R)=typename mln::trait::op::mod< L , R >::ret" \
+ "mln_trait_op_plus(L, R)=typename mln::trait::op::plus< L , R >::ret" \
+ "mln_trait_op_times(L, R)=typename mln::trait::op::times< L , R >::ret" \
+ "mln_trait_op_uminus(T)=typename mln::trait::op::uminus< T >::ret" \
+ "mln_ch_value(I, V)=typename mln::trait::ch_value< I, V >::ret" \
+ "mlc_unqualif_(T)=mln::metal::unqualif<T>::ret" \
+ "mln_piter_(T)=T::piter" \
+ "mln_fwd_piter_(T)=T::fwd_piter" \
+ "mln_bkd_piter_(T)=T::bkd_piter" \
+ "mln_qiter_(T)=T::qiter" \
+ "mln_fwd_qiter_(T)=T::fwd_qiter" \
+ "mln_bkd_qiter_(T)=T::bkd_qiter" \
+ "mln_niter_(T)=T::niter" \
+ "mln_fwd_niter_(T)=T::fwd_niter" \
+ "mln_bkd_niter_(T)=T::bkd_niter" \
+ "mln_viter_(T)=T::viter" \
+ "mln_fwd_viter_(T)=T::fwd_viter" \
+ "mln_bkd_viter_(T)=T::bkd_viter" \
+ "mln_result_(T)=T::result" \
+ "mln_enc_(T)=T::enc" \
+ "mln_value_(T)=T::value" \
+ "mln_qlf_value_(T)=T::qlf_value" \
+ "mln_domain_(T)=T::domain_t" \
+ "mln_sum_(T)=mln::value::props<T>::sum" \
+ "mln_vset_(T)=T::vset" \
+ "mln_rvalue_(T)=T::rvalue" \
+ "mln_lvalue_(T)=T::lvalue" \
+ "mln_mesh_(T)=T::mesh" \
+ "mln_coord_(T)=T::coord" \
+ "mln_site_(T)=T::site" \
+ "mln_psite_(T)=T::psite" \
+ "mln_dpsite_(T)=T::dpsite" \
+ "mln_accu_with_(A, T)=A::template with< T >::ret" \
+ "mln_trait_op_plus_(L, R)=mln::trait::op::plus< L , R >::ret" \
+ "mln_trait_op_minus_(L, R)=mln::trait::op::minus< L , R >::ret" \
+ "mln_trait_op_times_(L, R)=mln::trait::op::times< L , R >::ret" \
+ "mln_trait_op_div_(L, R)=mln::trait::op::div< L , R >::ret" \
+ "mln_trait_op_mod_(L, R)=mln::trait::op::mod< L , R >::ret" \
+ "mln_trait_op_uminus_(T)=mln::trait::op::uminus< T >::ret" \
+ "mln_ch_value_(I, V)=typename mln::trait::ch_value< I, V >::ret" \
+ "mln_ch_value(I, V)_=mln::trait::ch_value< I, V >::ret" \
+ "mln_morpher_lvalue(I)=typename internal::morpher_lvalue_<I>::ret" \
+ "mln_concrete(I)=typename mln::trait::concrete< I >::ret" \
+ "mln_concrete_ch_value(I, V)=typename mln::trait::ch_value< typename mln::trait::concrete< I >::ret, V >::ret" \
+ "mlc_const(T)=typename mln::metal::const_< T >::ret" \
+ "mlc_const_return(T)=typename mln::metal::const_return_< T >::ret" \
+ "mln_element(T)=typename T::element" \
+ "mln_element_(T)=T::element" \
+ "mln_delta(T)=typename T::delta" \
+ "mln_delta_(T)=T::delta" \
+ "mln_dpoint(T)=typename T::dpoint" \
+ "mln_dpoint_(T)=T::dpoint" \
+ "mln_point(T)=typename T::point" \
+ "mln_point_(T)=T::point" \
+ "mln_gradient_component(I)=typename mln::trait::ch_value< I, mln::value::props< typename I::value >::sum >::ret" \
+ "mln_gradient(I)=mln::value::stack_image< I::point::dim, mln::trait::ch_value< I, mln::value::props< typename I::value >::sum >::ret >" \
+ "mln_trait_value_sum_product(T, U)=typename mln::trait::value_< mln_trait_op_times(T,U) >::sum" \
+ "mln_sum_product(T, U)=typename mln::trait::value_< mln_trait_op_times(T,U) >::sum" \
+ "mln_deduce(T, A1, A2)=typename T::A1::A2" \
+ "mln_graph_element(T)=typename T::graph_element" \
+ "mln_graph_element_(T)=T::graph_element" \
+ "mln_fun_vv2v(F, L, R)=mln::fun::vv2v::F< mln_value(L), mln_value(R) >" \
+ "mln_fun_vv2v_result(F, L, R)=typename mln_fun_vv2v(F, L, R)::result" \
+ "mln_ch_fun_vv2v(F, L, R)=typename mln::trait::ch_value< L, typename mln_fun_vv2v(F, L, R)::result >::ret"
+
+
+
+
+EXPAND_AS_DEFINED =
+SKIP_FUNCTION_MACROS = YES
+#---------------------------------------------------------------------------
+# Configuration::additions related to external references
+#---------------------------------------------------------------------------
+TAGFILES = @builddir@/../scribo/doc/scribo.tag=../../scribo/doc/user-refman/html \
+ @builddir@/../milena/doc/milena.tag=../../milena/doc/user-refman/html
+GENERATE_TAGFILE =
+ALLEXTERNALS = NO
+EXTERNAL_GROUPS = YES
+PERL_PATH = /usr/bin/perl
+#---------------------------------------------------------------------------
+# Configuration options related to the dot tool
+#---------------------------------------------------------------------------
+CLASS_DIAGRAMS = NO
+HIDE_UNDOC_RELATIONS = YES
+HAVE_DOT = YES
+CLASS_GRAPH = NO
+COLLABORATION_GRAPH = NO # Disabled for light doc
+GROUP_GRAPHS = NO # Disabled for light doc
+UML_LOOK = NO
+TEMPLATE_RELATIONS = NO
+INCLUDE_GRAPH = NO # Disabled for light doc
+INCLUDED_BY_GRAPH = NO # Disabled for light doc
+CALL_GRAPH = NO
+CALLER_GRAPH = NO
+GRAPHICAL_HIERARCHY = NO
+DIRECTORY_GRAPH = NO # Disabled for light doc
+DOT_IMAGE_FORMAT = png
+DOT_PATH =
+DOTFILE_DIRS =
+MAX_DOT_GRAPH_DEPTH = 1000
+DOT_TRANSPARENT = NO
+DOT_MULTI_TARGETS = NO
+GENERATE_LEGEND = NO # Disabled for light doc
+DOT_CLEANUP = YES
+#---------------------------------------------------------------------------
+# Configuration::additions related to the search engine
+#---------------------------------------------------------------------------
+SEARCHENGINE = NO
+
+
+# Local Variables:
+# mode: Makefile
+# End:
diff --git a/doc/DoxygenLayout.xml b/doc/DoxygenLayout.xml
new file mode 100644
index 0000000..a279910
--- /dev/null
+++ b/doc/DoxygenLayout.xml
@@ -0,0 +1,184 @@
+<doxygenlayout version="1.0">
+ <!-- Navigation index tabs for HTML output -->
+ <navindex>
+ <tab type="mainpage" visible="yes" title="Home"/>
+ <tab type="pages" visible="no" title=""/>
+ <tab type="modules" visible="no" title=""/>
+ <tab type="namespaces" visible="no" title="">
+ <tab type="namespaces" visible="no" title=""/>
+ <tab type="namespacemembers" visible="no" title=""/>
+ </tab>
+ <tab type="classes" visible="no" title="">
+ <tab type="classes" visible="no" title=""/>
+ <tab type="classindex" visible="$ALPHABETICAL_INDEX" title=""/>
+ <tab type="hierarchy" visible="no" title=""/>
+ <tab type="classmembers" visible="no" title=""/>
+ </tab>
+ <tab type="files" visible="no" title="">
+ <tab type="files" visible="no" title=""/>
+ <tab type="globals" visible="no" title=""/>
+ </tab>
+ <tab type="dirs" visible="no" title=""/>
+ <tab type="examples" visible="no" title=""/>
+ </navindex>
+
+ <!-- Layout definition for a class page -->
+ <class>
+ <briefdescription visible="yes"/>
+ <includes visible="$SHOW_INCLUDE_FILES"/>
+ <inheritancegraph visible="$CLASS_GRAPH"/>
+ <collaborationgraph visible="$COLLABORATION_GRAPH"/>
+ <allmemberslink visible="yes"/>
+ <memberdecl>
+ <nestedclasses visible="yes" title=""/>
+ <publictypes title=""/>
+ <publicslots title=""/>
+ <signals title=""/>
+ <publicmethods title=""/>
+ <publicstaticmethods title=""/>
+ <publicattributes title=""/>
+ <publicstaticattributes title=""/>
+ <protectedtypes title=""/>
+ <protectedslots title=""/>
+ <protectedmethods title=""/>
+ <protectedstaticmethods title=""/>
+ <protectedattributes title=""/>
+ <protectedstaticattributes title=""/>
+ <packagetypes title=""/>
+ <packagemethods title=""/>
+ <packagestaticmethods title=""/>
+ <packageattributes title=""/>
+ <packagestaticattributes title=""/>
+ <properties title=""/>
+ <events title=""/>
+ <privatetypes title=""/>
+ <privateslots title=""/>
+ <privatemethods title=""/>
+ <privatestaticmethods title=""/>
+ <privateattributes title=""/>
+ <privatestaticattributes title=""/>
+ <friends title=""/>
+ <related title="" subtitle=""/>
+ <membergroups visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ <memberdef>
+ <typedefs title=""/>
+ <enums title=""/>
+ <constructors title=""/>
+ <functions title=""/>
+ <related title=""/>
+ <variables title=""/>
+ <properties title=""/>
+ <events title=""/>
+ </memberdef>
+ <usedfiles visible="$SHOW_USED_FILES"/>
+ <authorsection visible="yes"/>
+ </class>
+
+ <!-- Layout definition for a namespace page -->
+ <namespace>
+ <briefdescription visible="yes"/>
+ <memberdecl>
+ <nestednamespaces visible="yes" title=""/>
+ <classes visible="yes" title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ <membergroups visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ <memberdef>
+ <typedefs title=""/>
+ <enums title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ </memberdef>
+ <authorsection visible="yes"/>
+ </namespace>
+
+ <!-- Layout definition for a file page -->
+ <file>
+ <briefdescription visible="yes"/>
+ <includes visible="$SHOW_INCLUDE_FILES"/>
+ <includegraph visible="$INCLUDE_GRAPH"/>
+ <includedbygraph visible="$INCLUDED_BY_GRAPH"/>
+ <sourcelink visible="yes"/>
+ <memberdecl>
+ <classes visible="yes" title=""/>
+ <namespaces visible="yes" title=""/>
+ <defines title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ <membergroups visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ <memberdef>
+ <defines title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ </memberdef>
+ <authorsection/>
+ </file>
+
+ <!-- Layout definition for a group page -->
+ <group>
+ <briefdescription visible="yes"/>
+ <groupgraph visible="$GROUP_GRAPHS"/>
+ <memberdecl>
+ <classes visible="yes" title=""/>
+ <namespaces visible="yes" title=""/>
+ <dirs visible="yes" title=""/>
+ <nestedgroups visible="yes" title=""/>
+ <files visible="yes" title=""/>
+ <defines title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <enumvalues title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ <signals title=""/>
+ <publicslots title=""/>
+ <protectedslots title=""/>
+ <privateslots title=""/>
+ <events title=""/>
+ <properties title=""/>
+ <friends title=""/>
+ <membergroups visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ <memberdef>
+ <pagedocs/>
+ <defines title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <enumvalues title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ <signals title=""/>
+ <publicslots title=""/>
+ <protectedslots title=""/>
+ <privateslots title=""/>
+ <events title=""/>
+ <properties title=""/>
+ <friends title=""/>
+ </memberdef>
+ <authorsection visible="yes"/>
+ </group>
+
+ <!-- Layout definition for a directory page -->
+ <directory>
+ <briefdescription visible="yes"/>
+ <directorygraph visible="yes"/>
+ <memberdecl>
+ <dirs visible="yes"/>
+ <files visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ </directory>
+</doxygenlayout>
diff --git a/doc/Makefile.am b/doc/Makefile.am
new file mode 100644
index 0000000..ac2fd2e
--- /dev/null
+++ b/doc/Makefile.am
@@ -0,0 +1,155 @@
+# Copyright (C) 2007, 2008, 2009, 2010 EPITA Research and Development
+# Laboratory (LRDE).
+#
+# This file is part of Olena.
+#
+# Olena is free software: you can redistribute it and/or modify it under
+# the terms of the GNU General Public License as published by the Free
+# Software Foundation, version 2 of the License.
+#
+# Olena is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Olena. If not, see <http://www.gnu.org/licenses/>.
+
+
+# Look for Milena headers in srcdir and for (generated) test headers
+# (like data.hh) in builddir.
+AM_CPPFLAGS = -I$(top_srcdir)/milena -I$(top_builddir)/milena
+
+DOXYGEN = doxygen
+
+DOXYFILE = Doxyfile
+
+
+## --------------------- ##
+## LaTeX configuration. ##
+## --------------------- ##
+
+include $(top_srcdir)/build-aux/tex.mk
+
+TEXI2DVI_FLAGS += \
+ -I $(srcdir) -I $(srcdir)/outputs -I $(srcdir)/outputs/split \
+ -I $(srcdir)/img -I $(srcdir)/examples/split
+
+# Additional files for LaTeX compilations.
+DOC_PACKAGES = doxyfuns.sty milena.sty
+
+
+# ----------------------- #
+# User Reference Manual. #
+# ----------------------- #
+
+all-local: $(srcdir)/$(USER_REFMAN)
+
+# Run "make regen-doc" to forcefully rebuild the Doxygen documentation.
+.PHONY: regen-doc
+regen-doc:
+ rm -f $(srcdir)/user-refman.stamp
+ $(MAKE) $(AM_MAKEFLAGS) $(srcdir)/user-refman.stamp
+
+DOXYFILE_USER = Doxyfile_user
+
+REFMAN_deps = $(srcdir)/footer.html \
+ $(srcdir)/header.html \
+ $(srcdir)/doxygen.css \
+ $(srcdir)/mainpage.hh \
+ $(srcdir)/DoxygenLayout.xml
+
+# Sed is used to generate Doxyfile from Doxyfile.in instead of
+# configure, because the former is way faster than the latter.
+#
+## FIXME: This is because, as in TC, we depend on $Id$ from the
+## ChangeLog. Maybe we should depend from something less prone to
+## change. See Bison's build system.
+edit = sed -e "s|@ID@|$$Id|" \
+ -e 's,@PACKAGE_NAME\@,$(PACKAGE_NAME),g' \
+ -e 's,@PACKAGE_VERSION\@,$(PACKAGE_VERSION),g' \
+ -e 's,@top_srcdir\@,$(top_srcdir),g' \
+ -e 's,@top_builddir\@,$(top_builddir),g' \
+ -e 's,@srcdir\@,$(srcdir),g' \
+ -e 's,@builddir\@,$(builddir),g'
+
+$(DOXYFILE_USER): $(srcdir)/$(DOXYFILE).in
+ Id=`grep '^\$$Id' $(top_srcdir)/milena/ChangeLog \
+ | sed -e 's/\\\$$//g'`; \
+ $(edit) $< >$@
+MAINTAINERCLEANFILES = $(DOXYFILE_USER)
+
+USER_REFMAN = user-refman
+
+
+# HTML.
+EXTRA_DIST = $(srcdir)/user-refman.stamp
+MAINTAINERCLEANFILES += $(srcdir)/user-refman.stamp
+$(srcdir)/user-refman.stamp: $(srcdir)/$(DOXYFILE).in $(REFMAN_deps)
+ @rm -f $@.tmp
+ @touch $@.tmp
+ rm -rf $(USER_REFMAN).tmp
+ $(MAKE) $(AM_MAKE_FLAGS) $(DOXYFILE_USER)
+ $(DOXYGEN) $(DOXYFILE_USER)
+ rm -rf $(srcdir)/$(USER_REFMAN)
+## FIXME: Moving directories between file systems is not portable.
+ mv $(USER_REFMAN).tmp $(srcdir)/$(USER_REFMAN)
+ @mv -f $@.tmp $@
+
+$(srcdir)/$(USER_REFMAN): $(srcdir)/user-refman.stamp
+## Recover from the removal of $@.
+ @if test -d $@; then :; else \
+ rm -f $<; \
+ $(MAKE) $(AM_MAKEFLAGS) $<; \
+ fi
+
+# Installing a directory located in the source dir is not supported by
+# Automake by default, so we cannot simply add `$(USER_REFMAN)/html'
+# to `dist_doc_DATA'. The rule `install-data-local' (see below) used
+# to work around this limitation is borrowed from the Vaucanson
+# project.
+EXTRA_DIST += $(USER_REFMAN)
+
+
+
+
+
+## ---------- ##
+## Cleaning. ##
+## ---------- ##
+
+MAINTAINERCLEANFILES += $(dist_pdf_DATA)
+
+maintainer-clean-local:
+ -rm -rf $(USER_REFMAN).tmp $(srcdir)/$(USER_REFMAN)
+ -rm -rf $(DEVEL_REFMAN).tmp $(srcdir)/$(DEVEL_REFMAN)
+ -for d in $(DATA_html_dirs); do \
+ rm -rf $$d.tmp $(srcdir)/$$d; \
+ done
+
+
+## -------------- ##
+## Installation. ##
+## -------------- ##
+
+
+# We install by hand, otherwise Automake produces "install .../srcdoc
+# .../srcdoc", which installs our dir into the previous one, instead
+# of replacing it.
+install-data-local:
+ $(mkdir_p) $(DESTDIR)$(htmldir)
+# The user reference manual is located in a subdirectory, hence this
+# special case.
+ rm -rf $(DESTDIR)$(htmldir)/$(USER_REFMAN)
+ cp -r $(srcdir)/$(USER_REFMAN)/html $(DESTDIR)$(htmldir)/$(USER_REFMAN)
+## Try GNU chmod's X mode before resorting to something slower but
+## more standard.
+ chmod -R a+rX $(DESTDIR)$(htmldir) || \
+ find $(DESTDIR)$(htmldir) \( -type d -a -exec chmod a+rx {} \; \) \
+ -o -exec chmod a+r {} \;
+
+uninstall-local:
+# Same remark as above regarding the special case of the user
+# reference manual.
+ chmod -R 700 $(DESTDIR)$(htmldir)/$(USER_REFMAN)
+ rm -rf $(DESTDIR)$(htmldir)/$(USER_REFMAN)
diff --git a/doc/doxygen.css b/doc/doxygen.css
new file mode 100644
index 0000000..104c7dd
--- /dev/null
+++ b/doc/doxygen.css
@@ -0,0 +1,856 @@
+/* The standard CSS for doxygen */
+
+body, table, div, p, dl {
+ font-family: Lucida Grande, Verdana, Geneva, Arial, sans-serif;
+ font-size: 12px;
+}
+
+/* @group Heading Levels */
+
+h1 {
+ font-size: 150%;
+}
+
+.title {
+ font-size: 150%;
+ font-weight: bold;
+ margin: 10px 2px;
+}
+
+h2 {
+ font-size: 120%;
+}
+
+h3 {
+ font-size: 100%;
+}
+
+dt {
+ font-weight: bold;
+}
+
+div.multicol {
+ -moz-column-gap: 1em;
+ -webkit-column-gap: 1em;
+ -moz-column-count: 3;
+ -webkit-column-count: 3;
+}
+
+p.startli, p.startdd, p.starttd {
+ margin-top: 2px;
+}
+
+p.endli {
+ margin-bottom: 0px;
+}
+
+p.enddd {
+ margin-bottom: 4px;
+}
+
+p.endtd {
+ margin-bottom: 2px;
+}
+
+/* @end */
+
+caption {
+ font-weight: bold;
+}
+
+span.legend {
+ font-size: 70%;
+ text-align: center;
+}
+
+h3.version {
+ font-size: 90%;
+ text-align: center;
+}
+
+div.qindex, div.navtab{
+ background-color: #EBEFF6;
+ border: 1px solid #A3B4D7;
+ text-align: center;
+ margin: 2px;
+ padding: 2px;
+}
+
+div.qindex, div.navpath {
+ width: 100%;
+ line-height: 140%;
+}
+
+div.navtab {
+ margin-right: 15px;
+}
+
+/* @group Link Styling */
+
+a {
+ color: #3D578C;
+ font-weight: normal;
+ text-decoration: none;
+}
+
+.contents a:visited {
+ color: #4665A2;
+}
+
+a:hover {
+ text-decoration: underline;
+}
+
+a.qindex {
+ font-weight: bold;
+}
+
+a.qindexHL {
+ font-weight: bold;
+ background-color: #9CAFD4;
+ color: #ffffff;
+ border: 1px double #869DCA;
+}
+
+.contents a.qindexHL:visited {
+ color: #ffffff;
+}
+
+a.el {
+ font-weight: bold;
+}
+
+a.elRef {
+}
+
+a.code {
+ color: #4665A2;
+}
+
+a.codeRef {
+ color: #4665A2;
+}
+
+/* @end */
+
+dl.el {
+ margin-left: -1cm;
+}
+
+.fragment {
+ font-family: monospace, fixed;
+ font-size: 105%;
+}
+
+pre.fragment {
+ border: 1px solid #C4CFE5;
+ background-color: #FBFCFD;
+ padding: 4px 6px;
+ margin: 4px 8px 4px 2px;
+ overflow: auto;
+ word-wrap: break-word;
+ font-size: 9pt;
+ line-height: 125%;
+}
+
+div.ah {
+ background-color: black;
+ font-weight: bold;
+ color: #ffffff;
+ margin-bottom: 3px;
+ margin-top: 3px;
+ padding: 0.2em;
+ border: solid thin #333;
+ border-radius: 0.5em;
+ -webkit-border-radius: .5em;
+ -moz-border-radius: .5em;
+ box-shadow: 2px 2px 3px #999;
+ -webkit-box-shadow: 2px 2px 3px #999;
+ -moz-box-shadow: rgba(0, 0, 0, 0.15) 2px 2px 2px;
+ background-image: -webkit-gradient(linear, left top, left bottom, from(#eee), to(#000),color-stop(0.3, #444));
+ background-image: -moz-linear-gradient(center top, #eee 0%, #444 40%, #000);
+}
+
+div.groupHeader {
+ margin-left: 16px;
+ margin-top: 12px;
+ font-weight: bold;
+}
+
+div.groupText {
+ margin-left: 16px;
+ font-style: italic;
+}
+
+body {
+ background: white;
+ color: black;
+ margin: 0;
+}
+
+div.contents {
+ margin-top: 10px;
+ margin-left: 10px;
+ margin-right: 5px;
+}
+
+td.indexkey {
+ background-color: #EBEFF6;
+ font-weight: bold;
+ border: 1px solid #C4CFE5;
+ margin: 2px 0px 2px 0;
+ padding: 2px 10px;
+}
+
+td.indexvalue {
+ background-color: #EBEFF6;
+ border: 1px solid #C4CFE5;
+ padding: 2px 10px;
+ margin: 2px 0px;
+}
+
+tr.memlist {
+ background-color: #EEF1F7;
+}
+
+p.formulaDsp {
+ text-align: center;
+}
+
+img.formulaDsp {
+
+}
+
+img.formulaInl {
+ vertical-align: middle;
+}
+
+div.center {
+ text-align: center;
+ margin-top: 0px;
+ margin-bottom: 0px;
+ padding: 0px;
+}
+
+div.center img {
+ border: 0px;
+}
+
+address.footer {
+ text-align: right;
+ padding-right: 12px;
+}
+
+img.footer {
+ border: 0px;
+ vertical-align: middle;
+}
+
+/* @group Code Colorization */
+
+span.keyword {
+ color: #008000
+}
+
+span.keywordtype {
+ color: #604020
+}
+
+span.keywordflow {
+ color: #e08000
+}
+
+span.comment {
+ color: #800000
+}
+
+span.preprocessor {
+ color: #806020
+}
+
+span.stringliteral {
+ color: #002080
+}
+
+span.charliteral {
+ color: #008080
+}
+
+span.vhdldigit {
+ color: #ff00ff
+}
+
+span.vhdlchar {
+ color: #000000
+}
+
+span.vhdlkeyword {
+ color: #700070
+}
+
+span.vhdllogic {
+ color: #ff0000
+}
+
+/* @end */
+
+/*
+.search {
+ color: #003399;
+ font-weight: bold;
+}
+
+form.search {
+ margin-bottom: 0px;
+ margin-top: 0px;
+}
+
+input.search {
+ font-size: 75%;
+ color: #000080;
+ font-weight: normal;
+ background-color: #e8eef2;
+}
+*/
+
+td.tiny {
+ font-size: 75%;
+}
+
+.dirtab {
+ padding: 4px;
+ border-collapse: collapse;
+ border: 1px solid #A3B4D7;
+}
+
+th.dirtab {
+ background: #EBEFF6;
+ font-weight: bold;
+}
+
+hr {
+ height: 0px;
+ border: none;
+ border-top: 1px solid #4A6AAA;
+}
+
+hr.footer {
+ height: 1px;
+}
+
+/* @group Member Descriptions */
+
+table.memberdecls {
+ border-spacing: 0px;
+ padding: 0px;
+}
+
+.mdescLeft, .mdescRight,
+.memItemLeft, .memItemRight,
+.memTemplItemLeft, .memTemplItemRight, .memTemplParams {
+ background-color: #F9FAFC;
+ border: none;
+ margin: 4px;
+ padding: 1px 0 0 8px;
+}
+
+.mdescLeft, .mdescRight {
+ padding: 0px 8px 4px 8px;
+ color: #555;
+}
+
+.memItemLeft, .memItemRight, .memTemplParams {
+ border-top: 1px solid #C4CFE5;
+}
+
+.memItemLeft, .memTemplItemLeft {
+ white-space: nowrap;
+}
+
+.memItemRight {
+ width: 100%;
+}
+
+.memTemplParams {
+ color: #4665A2;
+ white-space: nowrap;
+}
+
+/* @end */
+
+/* @group Member Details */
+
+/* Styles for detailed member documentation */
+
+.memtemplate {
+ font-size: 80%;
+ color: #4665A2;
+ font-weight: normal;
+ margin-left: 9px;
+}
+
+.memnav {
+ background-color: #EBEFF6;
+ border: 1px solid #A3B4D7;
+ text-align: center;
+ margin: 2px;
+ margin-right: 15px;
+ padding: 2px;
+}
+
+.mempage {
+ width: 100%;
+}
+
+.memitem {
+ padding: 0;
+ margin-bottom: 10px;
+ margin-right: 5px;
+}
+
+.memname {
+ white-space: nowrap;
+ font-weight: bold;
+ margin-left: 6px;
+}
+
+.memproto {
+ border-top: 1px solid #A8B8D9;
+ border-left: 1px solid #A8B8D9;
+ border-right: 1px solid #A8B8D9;
+ padding: 6px 0px 6px 0px;
+ color: #253555;
+ font-weight: bold;
+ text-shadow: 0px 1px 1px rgba(255, 255, 255, 0.9);
+ /* opera specific markup */
+ box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15);
+ border-top-right-radius: 8px;
+ border-top-left-radius: 8px;
+ /* firefox specific markup */
+ -moz-box-shadow: rgba(0, 0, 0, 0.15) 5px 5px 5px;
+ -moz-border-radius-topright: 8px;
+ -moz-border-radius-topleft: 8px;
+ /* webkit specific markup */
+ -webkit-box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15);
+ -webkit-border-top-right-radius: 8px;
+ -webkit-border-top-left-radius: 8px;
+ background-image:url('nav_f.png');
+ background-repeat:repeat-x;
+ background-color: #E2E8F2;
+
+}
+
+.memdoc {
+ border-bottom: 1px solid #A8B8D9;
+ border-left: 1px solid #A8B8D9;
+ border-right: 1px solid #A8B8D9;
+ padding: 2px 5px;
+ background-color: #FBFCFD;
+ border-top-width: 0;
+ /* opera specific markup */
+ border-bottom-left-radius: 8px;
+ border-bottom-right-radius: 8px;
+ box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15);
+ /* firefox specific markup */
+ -moz-border-radius-bottomleft: 8px;
+ -moz-border-radius-bottomright: 8px;
+ -moz-box-shadow: rgba(0, 0, 0, 0.15) 5px 5px 5px;
+ background-image: -moz-linear-gradient(center top, #FFFFFF 0%, #FFFFFF 60%, #F7F8FB 95%, #EEF1F7);
+ /* webkit specific markup */
+ -webkit-border-bottom-left-radius: 8px;
+ -webkit-border-bottom-right-radius: 8px;
+ -webkit-box-shadow: 5px 5px 5px rgba(0, 0, 0, 0.15);
+ background-image: -webkit-gradient(linear,center top,center bottom,from(#FFFFFF), color-stop(0.6,#FFFFFF), color-stop(0.60,#FFFFFF), color-stop(0.95,#F7F8FB), to(#EEF1F7));
+}
+
+.paramkey {
+ text-align: right;
+}
+
+.paramtype {
+ white-space: nowrap;
+}
+
+.paramname {
+ color: #602020;
+ white-space: nowrap;
+}
+.paramname em {
+ font-style: normal;
+}
+
+.params, .retval, .exception, .tparams {
+ border-spacing: 6px 2px;
+}
+
+.params .paramname, .retval .paramname {
+ font-weight: bold;
+ vertical-align: top;
+}
+
+.params .paramtype {
+ font-style: italic;
+ vertical-align: top;
+}
+
+.params .paramdir {
+ font-family: "courier new",courier,monospace;
+ vertical-align: top;
+}
+
+
+
+
+/* @end */
+
+/* @group Directory (tree) */
+
+/* for the tree view */
+
+.ftvtree {
+ font-family: sans-serif;
+ margin: 0px;
+}
+
+/* these are for tree view when used as main index */
+
+.directory {
+ font-size: 9pt;
+ font-weight: bold;
+ margin: 5px;
+}
+
+.directory h3 {
+ margin: 0px;
+ margin-top: 1em;
+ font-size: 11pt;
+}
+
+/*
+The following two styles can be used to replace the root node title
+with an image of your choice. Simply uncomment the next two styles,
+specify the name of your image and be sure to set 'height' to the
+proper pixel height of your image.
+*/
+
+/*
+.directory h3.swap {
+ height: 61px;
+ background-repeat: no-repeat;
+ background-image: url("yourimage.gif");
+}
+.directory h3.swap span {
+ display: none;
+}
+*/
+
+.directory > h3 {
+ margin-top: 0;
+}
+
+.directory p {
+ margin: 0px;
+ white-space: nowrap;
+}
+
+.directory div {
+ display: none;
+ margin: 0px;
+}
+
+.directory img {
+ vertical-align: -30%;
+}
+
+/* these are for tree view when not used as main index */
+
+.directory-alt {
+ font-size: 100%;
+ font-weight: bold;
+}
+
+.directory-alt h3 {
+ margin: 0px;
+ margin-top: 1em;
+ font-size: 11pt;
+}
+
+.directory-alt > h3 {
+ margin-top: 0;
+}
+
+.directory-alt p {
+ margin: 0px;
+ white-space: nowrap;
+}
+
+.directory-alt div {
+ display: none;
+ margin: 0px;
+}
+
+.directory-alt img {
+ vertical-align: -30%;
+}
+
+/* @end */
+
+div.dynheader {
+ margin-top: 8px;
+}
+
+address {
+ font-style: normal;
+ color: #2A3D61;
+}
+
+table.doxtable {
+ border-collapse:collapse;
+ /* new */
+ width:80%;
+ table-layout:fixed;
+}
+
+table.doxtable td, table.doxtable th {
+ border: 1px solid #2D4068;
+ padding: 3px 7px 2px;
+}
+
+table.doxtable th {
+ background-color: #374F7F;
+ color: #FFFFFF;
+ font-size: 110%;
+ padding-bottom: 4px;
+ padding-top: 5px;
+
+ /* Changed */
+ text-align:center;
+}
+
+.tabsearch {
+ top: 0px;
+ left: 10px;
+ height: 36px;
+ background-image: url('tab_b.png');
+ z-index: 101;
+ overflow: hidden;
+ font-size: 13px;
+}
+
+.navpath ul
+{
+ font-size: 11px;
+ background-image:url('tab_b.png');
+ background-repeat:repeat-x;
+ height:30px;
+ line-height:30px;
+ color:#8AA0CC;
+ border:solid 1px #C2CDE4;
+ overflow:hidden;
+ margin:0px;
+ padding:0px;
+}
+
+.navpath li
+{
+ list-style-type:none;
+ float:left;
+ padding-left:10px;
+ padding-right:15px;
+ background-image:url('bc_s.png');
+ background-repeat:no-repeat;
+ background-position:right;
+ color:#364D7C;
+}
+
+.navpath li.navelem a
+{
+ height:32px;
+ display:block;
+ text-decoration: none;
+ outline: none;
+}
+
+.navpath li.navelem a:hover
+{
+ color:#6884BD;
+}
+
+.navpath li.footer
+{
+ list-style-type:none;
+ float:right;
+ padding-left:10px;
+ padding-right:15px;
+ background-image:none;
+ background-repeat:no-repeat;
+ background-position:right;
+ color:#364D7C;
+ font-size: 8pt;
+}
+
+
+div.summary
+{
+ float: right;
+ font-size: 8pt;
+ padding-right: 5px;
+ width: 50%;
+ text-align: right;
+}
+
+div.summary a
+{
+ white-space: nowrap;
+}
+
+div.ingroups
+{
+ font-size: 8pt;
+ padding-left: 5px;
+ width: 50%;
+ text-align: left;
+}
+
+div.ingroups a
+{
+ white-space: nowrap;
+}
+
+div.header
+{
+ background-image:url('nav_h.png');
+ background-repeat:repeat-x;
+ background-color: #F9FAFC;
+ margin: 0px;
+ border-bottom: 1px solid #C4CFE5;
+}
+
+div.headertitle
+{
+ padding: 5px 5px 5px 10px;
+}
+
+dl
+{
+ padding: 0 0 0 10px;
+}
+
+dl.note, dl.warning, dl.attention, dl.pre, dl.post, dl.invariant, dl.deprecated, dl.todo, dl.test, dl.bug
+{
+ border-left:4px solid;
+ padding: 0 0 0 6px;
+}
+
+dl.note
+{
+ border-color: #D0C000;
+}
+
+dl.warning, dl.attention
+{
+ border-color: #FF0000;
+}
+
+dl.pre, dl.post, dl.invariant
+{
+ border-color: #00D000;
+}
+
+dl.deprecated
+{
+ border-color: #505050;
+}
+
+dl.todo
+{
+ border-color: #00C0E0;
+}
+
+dl.test
+{
+ border-color: #3030E0;
+}
+
+dl.bug
+{
+ border-color: #C08050;
+}
+
+#projectlogo
+{
+ text-align: center;
+ vertical-align: bottom;
+ border-collapse: separate;
+}
+
+#projectlogo img
+{
+ border: 0px none;
+}
+
+#projectname
+{
+ /* Changed */
+ font: 32px Tahoma, Arial,sans-serif;
+
+ margin: 0px;
+ padding: 2px 0px;
+}
+
+#projectbrief
+{
+ /* Changed */
+ font: 13px Tahoma, Arial,sans-serif;
+
+ margin: 0px;
+ padding: 0px;
+}
+
+#projectnumber
+{
+ font: 50% Tahoma, Arial,sans-serif;
+ margin: 0px;
+ padding: 0px;
+}
+
+#titlearea
+{
+ padding: 0px;
+ margin: 0px;
+ width: 100%;
+ border-bottom: 1px solid #5373B4;
+}
+
+.image
+{
+ text-align: center;
+}
+
+.dotgraph
+{
+ text-align: center;
+}
+
+.mscgraph
+{
+ text-align: center;
+}
+
+.caption
+{
+ font-weight: bold;
+}
+
+
+/* ===> NEW */
+
+table.itable th
+{
+ font-size: 17px;
+}
+
+table.itable li
+{
+ font-size: 16px;
+}
\ No newline at end of file
diff --git a/doc/footer.html b/doc/footer.html
new file mode 100644
index 0000000..d0e98ec
--- /dev/null
+++ b/doc/footer.html
@@ -0,0 +1,5 @@
+<hr class="footer"/><address class="footer"><small>
+<span style="position:absolute;text-align:left;">Copyright (C) 2011 EPITA Research and Development Laboratory (LRDE)</span><span align='right'>Olena 2.0</span>
+</small></address>
+</body>
+</html>
diff --git a/doc/header.html b/doc/header.html
new file mode 100644
index 0000000..a94502d
--- /dev/null
+++ b/doc/header.html
@@ -0,0 +1,46 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<title>$title</title>
+<link href="$relpath$tabs.css" rel="stylesheet" type="text/css"/>
+<link href="$relpath$doxygen.css" rel="stylesheet" type="text/css" />
+$treeview
+$search
+$mathjax
+</head>
+<body>
+<div id="top"><!-- do not remove this div! -->
+<!--BEGIN TITLEAREA-->
+<div id="titlearea">
+<table cellspacing="0" cellpadding="0">
+ <tbody>
+ <tr style="height: 56px;">
+ <!--BEGIN PROJECT_LOGO-->
+ <td id="projectlogo"><a href="$relpath$index.html"><img alt="Logo" src="$relpath$$projectlogo"></a></td>
+ <!--END PROJECT_LOGO-->
+ <!--BEGIN PROJECT_NAME-->
+ <td style="padding-left: 0.5em;">
+ <div id="projectname">Olena
+ <!--BEGIN PROJECT_NUMBER--><!--  <span id="projectnumber">$projectnumber</span> --><!--END PROJECT_NUMBER-->
+ </div>
+ <!--BEGIN PROJECT_BRIEF--><div id="projectbrief">$projectbrief</div><!--END PROJECT_BRIEF-->
+ </td>
+ <!--END PROJECT_NAME-->
+ <!--BEGIN !PROJECT_NAME-->
+ <!--BEGIN PROJECT_BRIEF-->
+ <td style="padding-left: 0.5em;">
+ <div id="projectbrief">$projectbrief</div>
+ </td>
+ <!--END PROJECT_BRIEF-->
+ <!--END !PROJECT_NAME-->
+ <!--BEGIN DISABLE_INDEX-->
+ <!--BEGIN SEARCHENGINE-->
+ <td>$searchbox</td>
+ <!--END SEARCHENGINE-->
+ <!--END DISABLE_INDEX-->
+ </tr>
+ </tbody>
+</table>
+</div>
+<!--END TITLEAREA-->
diff --git a/doc/logo.jpg b/doc/logo.jpg
new file mode 100644
index 0000000000000000000000000000000000000000..a68a505583cdf475c11054066db4ded69dafd17a
GIT binary patch
literal 7477
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
literal 0
HcmV?d00001
diff --git a/doc/mainpage.hh b/doc/mainpage.hh
new file mode 100644
index 0000000..0704753
--- /dev/null
+++ b/doc/mainpage.hh
@@ -0,0 +1,38 @@
+/** \mainpage Documentation of Olena
+
+ <center>
+ <h1>Olena Reference Documentation</h1>
+
+ <table class="doxtable itable">
+
+ <tr>
+ <th>General Presentation</th>
+ <th>Modules</th>
+ <th>Applications</th>
+ </tr>
+ <tr>
+ <td><ul><li>What is Olena ?</li><li>Bibliography</li><li>Contributors</li></ul></td>
+ <td><ul><li>List of Available modules</li><li><a href='../../../milena/doc/user-refman/html/index.html'>Milena</a></li><li><a href='../../../scribo/doc/user-refman/html/index.html'>Scribo</a></li><li>Swilena</li></ul></td>
+ <td><ul><li>Online Demos</li><li>Papers Related Programs</li><li>Olena Powered Programs</li></ul></td>
+ </tr>
+
+
+ <tr>
+ <th>Contributing</th>
+ <th>Licensing</th>
+ <th> </th>
+ </tr>
+ <tr>
+ <td><ul><li>Report Bugs and Make Suggestions</li><li>Get the Sources</li><li>Online Resources</li></ul></td>
+ <td><ul><li>GNU GPL</li><li>Commercial Use</li></ul></td>
+ <td> </td>
+ </tr>
+
+ </table>
+
+ </center>
+
+ <br>
+ */
+
+
diff --git a/doc/olena.qhcp b/doc/olena.qhcp
new file mode 100644
index 0000000..595d34e
--- /dev/null
+++ b/doc/olena.qhcp
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<QHelpCollectionProject version="1.0">
+ <assistant>
+ <startPage>qthelp://fr.epita.lrde.olena/milena-2.0/index.html</startPage>
+ </assistant>
+ <docFiles>
+ <register>
+ <file>../milena/doc/user-refman/html/milena.qch</file>
+ <file>../scribo/doc/user-refman/html/scribo.qch</file>
+ </register>
+ </docFiles>
+</QHelpCollectionProject>
\ No newline at end of file
diff --git a/doc/subdoc_footer.html b/doc/subdoc_footer.html
new file mode 100644
index 0000000..3548c1e
--- /dev/null
+++ b/doc/subdoc_footer.html
@@ -0,0 +1,6 @@
+<hr class="footer"/><address class="footer"><small>
+<span style="position:absolute;bottom:0;left:5px;text-align:left;">Copyright (C) 2011 EPITA Research and Development Laboratory (LRDE)</span>
+<span style="position:absolute;bottom:0;right:5px;text-align:right;">Olena 2.0</span>
+</small></address>
+</body>
+</html>
diff --git a/milena/doc/Doxyfile.in b/milena/doc/Doxyfile.in
index 843280a..494d99c 100644
--- a/milena/doc/Doxyfile.in
+++ b/milena/doc/Doxyfile.in
@@ -1,5 +1,5 @@
-# Copyright (C) 2007, 2008, 2009, 2010 EPITA Research and Development
-# Laboratory (LRDE)
+# Copyright (C) 2007, 2008, 2009, 2010, 2011 EPITA Research and
+# Development Laboratory (LRDE)
#
# This file is part of Olena.
#
@@ -20,8 +20,10 @@
#---------------------------------------------------------------------------
# Project related configuration options
#---------------------------------------------------------------------------
-PROJECT_NAME = "Milena (@PACKAGE_NAME@)"
-PROJECT_NUMBER = "User documentation @PACKAGE_VERSION@ @ID@"
+PROJECT_NAME = "Milena"
+PROJECT_NUMBER = "@PACKAGE_VERSION@"
+PROJECT_BRIEF = "An Image Processing Platform"
+PROJECT_LOGO = @top_srcdir@/doc/logo.jpg
OUTPUT_DIRECTORY = @builddir@/user-refman.tmp
CREATE_SUBDIRS = YES
OUTPUT_LANGUAGE = English
@@ -54,8 +56,8 @@ EXTRACT_PRIVATE = NO
EXTRACT_STATIC = NO
EXTRACT_LOCAL_CLASSES = NO
EXTRACT_LOCAL_METHODS = NO
-HIDE_UNDOC_MEMBERS = YES
-HIDE_UNDOC_CLASSES = YES
+HIDE_UNDOC_MEMBERS = NO
+HIDE_UNDOC_CLASSES = NO
HIDE_FRIEND_COMPOUNDS = YES
HIDE_IN_BODY_DOCS = YES
INTERNAL_DOCS = NO
@@ -144,9 +146,10 @@ IGNORE_PREFIX = mln::
GENERATE_HTML = YES
HTML_OUTPUT = html
HTML_FILE_EXTENSION = .html
-HTML_HEADER =
-HTML_FOOTER =
-HTML_STYLESHEET =
+HTML_HEADER = @top_srcdir@/doc/header.html
+HTML_FOOTER = @top_srcdir@/doc/subdoc_footer.html
+HTML_STYLESHEET = @top_srcdir@/doc/doxygen.css
+LAYOUT_FILE = @top_srcdir@/doc/DoxygenLayout.xml
HTML_ALIGN_MEMBERS = YES
GENERATE_HTMLHELP = NO
CHM_FILE =
@@ -327,26 +330,26 @@ SKIP_FUNCTION_MACROS = YES
# Configuration::additions related to external references
#---------------------------------------------------------------------------
TAGFILES =
-GENERATE_TAGFILE =
+GENERATE_TAGFILE = milena.tag
ALLEXTERNALS = NO
EXTERNAL_GROUPS = YES
PERL_PATH = /usr/bin/perl
#---------------------------------------------------------------------------
# Configuration options related to the dot tool
#---------------------------------------------------------------------------
-CLASS_DIAGRAMS = YES
-HIDE_UNDOC_RELATIONS = YES
+CLASS_DIAGRAMS = NO
+HIDE_UNDOC_RELATIONS = NO
HAVE_DOT = YES
-CLASS_GRAPH = YES
+CLASS_GRAPH = NO
COLLABORATION_GRAPH = NO # Disabled for light doc
GROUP_GRAPHS = NO # Disabled for light doc
UML_LOOK = NO
-TEMPLATE_RELATIONS = YES
+TEMPLATE_RELATIONS = NO
INCLUDE_GRAPH = NO # Disabled for light doc
INCLUDED_BY_GRAPH = NO # Disabled for light doc
CALL_GRAPH = NO
CALLER_GRAPH = NO
-GRAPHICAL_HIERARCHY = YES
+GRAPHICAL_HIERARCHY = NO
DIRECTORY_GRAPH = NO # Disabled for light doc
DOT_IMAGE_FORMAT = png
DOT_PATH =
@@ -360,6 +363,15 @@ DOT_CLEANUP = YES
# Configuration::additions related to the search engine
#---------------------------------------------------------------------------
SEARCHENGINE = YES
+#---------------------------------------------------------------------------
+# Configuration::additions related to the Qt help engine
+#---------------------------------------------------------------------------
+GENERATE_QHP = yes
+QHP_NAMESPACE = "fr.epita.lrde.olena.scribo"
+QHP_VIRTUAL_FOLDER = "scribo-2.0"
+QCH_FILE = "@builddir@/scribo.qch"
+QHG_LOCATION = "qhelpgenerator"
+
# Local Variables:
# mode: Makefile
diff --git a/milena/doc/DoxygenLayout.xml b/milena/doc/DoxygenLayout.xml
new file mode 100644
index 0000000..ff1e5e4
--- /dev/null
+++ b/milena/doc/DoxygenLayout.xml
@@ -0,0 +1,184 @@
+<doxygenlayout version="1.0">
+ <!-- Navigation index tabs for HTML output -->
+ <navindex>
+ <tab type="mainpage" visible="yes" title="Milena"/>
+ <tab type="pages" visible="yes" title=""/>
+ <tab type="modules" visible="yes" title=""/>
+ <tab type="namespaces" visible="yes" title="">
+ <tab type="namespaces" visible="yes" title=""/>
+ <tab type="namespacemembers" visible="yes" title=""/>
+ </tab>
+ <tab type="classes" visible="yes" title="">
+ <tab type="classes" visible="yes" title=""/>
+ <tab type="classindex" visible="$ALPHABETICAL_INDEX" title=""/>
+ <tab type="hierarchy" visible="yes" title=""/>
+ <tab type="classmembers" visible="yes" title=""/>
+ </tab>
+ <tab type="files" visible="yes" title="">
+ <tab type="files" visible="yes" title=""/>
+ <tab type="globals" visible="yes" title=""/>
+ </tab>
+ <tab type="dirs" visible="yes" title=""/>
+ <tab type="examples" visible="yes" title=""/>
+ </navindex>
+
+ <!-- Layout definition for a class page -->
+ <class>
+ <briefdescription visible="yes"/>
+ <includes visible="$SHOW_INCLUDE_FILES"/>
+ <inheritancegraph visible="$CLASS_GRAPH"/>
+ <collaborationgraph visible="$COLLABORATION_GRAPH"/>
+ <allmemberslink visible="yes"/>
+ <memberdecl>
+ <nestedclasses visible="yes" title=""/>
+ <publictypes title=""/>
+ <publicslots title=""/>
+ <signals title=""/>
+ <publicmethods title=""/>
+ <publicstaticmethods title=""/>
+ <publicattributes title=""/>
+ <publicstaticattributes title=""/>
+ <protectedtypes title=""/>
+ <protectedslots title=""/>
+ <protectedmethods title=""/>
+ <protectedstaticmethods title=""/>
+ <protectedattributes title=""/>
+ <protectedstaticattributes title=""/>
+ <packagetypes title=""/>
+ <packagemethods title=""/>
+ <packagestaticmethods title=""/>
+ <packageattributes title=""/>
+ <packagestaticattributes title=""/>
+ <properties title=""/>
+ <events title=""/>
+ <privatetypes title=""/>
+ <privateslots title=""/>
+ <privatemethods title=""/>
+ <privatestaticmethods title=""/>
+ <privateattributes title=""/>
+ <privatestaticattributes title=""/>
+ <friends title=""/>
+ <related title="" subtitle=""/>
+ <membergroups visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ <memberdef>
+ <typedefs title=""/>
+ <enums title=""/>
+ <constructors title=""/>
+ <functions title=""/>
+ <related title=""/>
+ <variables title=""/>
+ <properties title=""/>
+ <events title=""/>
+ </memberdef>
+ <usedfiles visible="$SHOW_USED_FILES"/>
+ <authorsection visible="yes"/>
+ </class>
+
+ <!-- Layout definition for a namespace page -->
+ <namespace>
+ <briefdescription visible="yes"/>
+ <memberdecl>
+ <nestednamespaces visible="yes" title=""/>
+ <classes visible="yes" title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ <membergroups visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ <memberdef>
+ <typedefs title=""/>
+ <enums title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ </memberdef>
+ <authorsection visible="yes"/>
+ </namespace>
+
+ <!-- Layout definition for a file page -->
+ <file>
+ <briefdescription visible="yes"/>
+ <includes visible="$SHOW_INCLUDE_FILES"/>
+ <includegraph visible="$INCLUDE_GRAPH"/>
+ <includedbygraph visible="$INCLUDED_BY_GRAPH"/>
+ <sourcelink visible="yes"/>
+ <memberdecl>
+ <classes visible="yes" title=""/>
+ <namespaces visible="yes" title=""/>
+ <defines title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ <membergroups visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ <memberdef>
+ <defines title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ </memberdef>
+ <authorsection/>
+ </file>
+
+ <!-- Layout definition for a group page -->
+ <group>
+ <briefdescription visible="yes"/>
+ <groupgraph visible="$GROUP_GRAPHS"/>
+ <memberdecl>
+ <classes visible="yes" title=""/>
+ <namespaces visible="yes" title=""/>
+ <dirs visible="yes" title=""/>
+ <nestedgroups visible="yes" title=""/>
+ <files visible="yes" title=""/>
+ <defines title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <enumvalues title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ <signals title=""/>
+ <publicslots title=""/>
+ <protectedslots title=""/>
+ <privateslots title=""/>
+ <events title=""/>
+ <properties title=""/>
+ <friends title=""/>
+ <membergroups visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ <memberdef>
+ <pagedocs/>
+ <defines title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <enumvalues title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ <signals title=""/>
+ <publicslots title=""/>
+ <protectedslots title=""/>
+ <privateslots title=""/>
+ <events title=""/>
+ <properties title=""/>
+ <friends title=""/>
+ </memberdef>
+ <authorsection visible="yes"/>
+ </group>
+
+ <!-- Layout definition for a directory page -->
+ <directory>
+ <briefdescription visible="yes"/>
+ <directorygraph visible="yes"/>
+ <memberdecl>
+ <dirs visible="yes"/>
+ <files visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ </directory>
+</doxygenlayout>
diff --git a/milena/doc/milena.qhcp b/milena/doc/milena.qhcp
new file mode 100644
index 0000000..1a4e7ca
--- /dev/null
+++ b/milena/doc/milena.qhcp
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<QHelpCollectionProject version="1.0">
+ <assistant>
+ <startPage>qthelp://fr.epita.lrde.olena/milena-2.0/index.html</startPage>
+ </assistant>
+ <docFiles>
+ <register>
+ <file>user-refman/html/milena.qch</file>
+ </register>
+ </docFiles>
+</QHelpCollectionProject>
\ No newline at end of file
diff --git a/scribo/doc/.gitignore b/scribo/doc/.gitignore
new file mode 100644
index 0000000..c858430
--- /dev/null
+++ b/scribo/doc/.gitignore
@@ -0,0 +1,13 @@
+/Doxyfile_user
+/user-refman
+/user-refman.pdf
+
+/Doxyfile_devel
+/devel-refman
+/devel-refman.pdf
+
+/figures/*.png
+
+/tutorial.hh
+/tutorial.pdf
+/tutorial/
diff --git a/scribo/doc/Doxyfile.in b/scribo/doc/Doxyfile.in
new file mode 100644
index 0000000..d279d76
--- /dev/null
+++ b/scribo/doc/Doxyfile.in
@@ -0,0 +1,373 @@
+# Copyright (C) 2011 EPITA Research and Development Laboratory (LRDE)
+#
+# This file is part of Olena.
+#
+# Olena is free software: you can redistribute it and/or modify it under
+# the terms of the GNU General Public License as published by the Free
+# Software Foundation, version 2 of the License.
+#
+# Olena is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Olena. If not, see <http://www.gnu.org/licenses/>.
+#
+# Doxyfile 1.5.1
+
+#---------------------------------------------------------------------------
+# Project related configuration options
+#---------------------------------------------------------------------------
+PROJECT_NAME = "Scribo"
+PROJECT_NUMBER = "User documentation @PACKAGE_VERSION@"
+PROJECT_BRIEF = "An Image Processing Platform"
+PROJECT_LOGO = @top_srcdir@/doc/logo.jpg
+OUTPUT_DIRECTORY = @builddir@/user-refman.tmp
+CREATE_SUBDIRS = YES
+OUTPUT_LANGUAGE = English
+BRIEF_MEMBER_DESC = YES
+REPEAT_BRIEF = YES
+ABBREVIATE_BRIEF =
+ALWAYS_DETAILED_SEC = YES
+INLINE_INHERITED_MEMB = YES
+FULL_PATH_NAMES = NO
+STRIP_FROM_PATH = @top_srcdir@/scribo
+STRIP_FROM_INC_PATH =
+SHORT_NAMES = YES
+JAVADOC_AUTOBRIEF = YES
+MULTILINE_CPP_IS_BRIEF = NO
+INHERIT_DOCS = YES
+SEPARATE_MEMBER_PAGES = NO
+TAB_SIZE = 8
+ALIASES =
+OPTIMIZE_OUTPUT_FOR_C = NO
+OPTIMIZE_OUTPUT_JAVA = NO
+BUILTIN_STL_SUPPORT = YES
+IDL_PROPERTY_SUPPORT = NO
+DISTRIBUTE_GROUP_DOC = NO
+SUBGROUPING = YES
+#---------------------------------------------------------------------------
+# Build related configuration options
+#---------------------------------------------------------------------------
+EXTRACT_ALL = NO
+EXTRACT_PRIVATE = NO
+EXTRACT_STATIC = NO
+EXTRACT_LOCAL_CLASSES = NO
+EXTRACT_LOCAL_METHODS = NO
+HIDE_UNDOC_MEMBERS = NO
+HIDE_UNDOC_CLASSES = NO
+HIDE_FRIEND_COMPOUNDS = YES
+HIDE_IN_BODY_DOCS = YES
+INTERNAL_DOCS = NO
+CASE_SENSE_NAMES = YES
+HIDE_SCOPE_NAMES = NO
+SHOW_INCLUDE_FILES = YES
+INLINE_INFO = YES
+SORT_MEMBER_DOCS = YES
+SORT_BRIEF_DOCS = YES
+SORT_BY_SCOPE_NAME = YES
+GENERATE_TODOLIST = NO
+GENERATE_TESTLIST = YES
+GENERATE_BUGLIST = YES
+GENERATE_DEPRECATEDLIST= YES
+ENABLED_SECTIONS =
+MAX_INITIALIZER_LINES = 30
+SHOW_USED_FILES = NO # Disabled for light doc
+SHOW_DIRECTORIES = NO # Disabled for light doc
+SHOW_FILES = NO # Disabled for light doc
+SHOW_NAMESPACES = YES
+FILE_VERSION_FILTER =
+#---------------------------------------------------------------------------
+# configuration options related to warning and progress messages
+#---------------------------------------------------------------------------
+QUIET = YES
+WARNINGS = YES
+WARN_IF_UNDOCUMENTED = YES
+WARN_IF_DOC_ERROR = YES
+WARN_NO_PARAMDOC = NO
+WARN_FORMAT = "$file:$line: $text"
+WARN_LOGFILE =
+#---------------------------------------------------------------------------
+# configuration options related to the input files
+#---------------------------------------------------------------------------
+INPUT = @top_srcdir@/scribo
+FILE_PATTERNS = *.cc \
+ *.hh \
+ *.hxx \
+ *.hcc
+RECURSIVE = YES
+EXCLUDE = @top_srcdir@/scribo/demo \
+ @top_srcdir@/scribo/sandbox \
+ @top_srcdir@/scribo/doc/user-refman \
+ @top_srcdir@/scribo/doc/devel-refman \
+ @top_srcdir@/scribo/tests/unit_test
+EXCLUDE_SYMLINKS = YES
+EXCLUDE_PATTERNS = *spe.hh
+EXCLUDE_SYMBOLS = *::internal* *_ mln::trait::*
+EXAMPLE_PATH = @top_srcdir@/scribo/doc/examples \
+ @top_srcdir@/scribo/doc/outputs \
+ @top_srcdir@/scribo/doc/examples/split \
+ @top_srcdir@/scribo/doc/outputs/split
+EXAMPLE_PATTERNS = *.cc \
+ *.cc.raw \
+ *.txt
+EXAMPLE_RECURSIVE = NO
+IMAGE_PATH = @top_srcdir@/scribo/doc/img \
+ @top_srcdir@/scribo/doc/figures
+INPUT_FILTER =
+FILTER_PATTERNS =
+FILTER_SOURCE_FILES = NO
+INPUT_ENCODING = ISO-8859-1
+
+#---------------------------------------------------------------------------
+# configuration options related to source browsing
+#---------------------------------------------------------------------------
+SOURCE_BROWSER = YES
+INLINE_SOURCES = NO
+STRIP_CODE_COMMENTS = YES
+REFERENCED_BY_RELATION = YES
+REFERENCES_RELATION = YES
+REFERENCES_LINK_SOURCE = NO
+USE_HTAGS = NO
+VERBATIM_HEADERS = YES
+#---------------------------------------------------------------------------
+# configuration options related to the alphabetical class index
+#---------------------------------------------------------------------------
+ALPHABETICAL_INDEX = YES
+COLS_IN_ALPHA_INDEX = 5
+IGNORE_PREFIX = mln::
+#---------------------------------------------------------------------------
+# configuration options related to the HTML output
+#---------------------------------------------------------------------------
+GENERATE_HTML = YES
+HTML_OUTPUT = html
+HTML_FILE_EXTENSION = .html
+HTML_HEADER = @top_srcdir@/doc/header.html
+HTML_FOOTER = @top_srcdir@/doc/subdoc_footer.html
+HTML_STYLESHEET = @top_srcdir@/doc/doxygen.css
+LAYOUT_FILE = @top_srcdir@/scribo/doc/DoxygenLayout.xml
+HTML_ALIGN_MEMBERS = YES
+GENERATE_HTMLHELP = NO
+CHM_FILE =
+HHC_LOCATION =
+GENERATE_CHI = NO
+BINARY_TOC = NO
+TOC_EXPAND = NO
+DISABLE_INDEX = NO
+ENUM_VALUES_PER_LINE = 4
+GENERATE_TREEVIEW = YES
+TREEVIEW_WIDTH = 250
+#---------------------------------------------------------------------------
+# configuration options related to the LaTeX output
+#---------------------------------------------------------------------------
+GENERATE_LATEX = YES
+LATEX_OUTPUT = latex
+LATEX_CMD_NAME = latex
+MAKEINDEX_CMD_NAME = makeindex
+COMPACT_LATEX = NO
+PAPER_TYPE = a4wide
+EXTRA_PACKAGES =
+LATEX_HEADER =
+PDF_HYPERLINKS = YES
+USE_PDFLATEX = YES
+LATEX_BATCHMODE = YES
+LATEX_HIDE_INDICES = NO
+#---------------------------------------------------------------------------
+# configuration options related to the RTF output
+#---------------------------------------------------------------------------
+GENERATE_RTF = NO
+RTF_OUTPUT = rtf
+COMPACT_RTF = NO
+RTF_HYPERLINKS = NO
+RTF_STYLESHEET_FILE =
+RTF_EXTENSIONS_FILE =
+#---------------------------------------------------------------------------
+# configuration options related to the man page output
+#---------------------------------------------------------------------------
+GENERATE_MAN = NO
+MAN_OUTPUT = man
+MAN_EXTENSION = .3
+MAN_LINKS = NO
+#---------------------------------------------------------------------------
+# configuration options related to the XML output
+#---------------------------------------------------------------------------
+GENERATE_XML = NO
+XML_OUTPUT = xml
+XML_SCHEMA =
+XML_DTD =
+XML_PROGRAMLISTING = YES
+#---------------------------------------------------------------------------
+# configuration options for the AutoGen Definitions output
+#---------------------------------------------------------------------------
+GENERATE_AUTOGEN_DEF = NO
+#---------------------------------------------------------------------------
+# configuration options related to the Perl module output
+#---------------------------------------------------------------------------
+GENERATE_PERLMOD = NO
+PERLMOD_LATEX = NO
+PERLMOD_PRETTY = YES
+PERLMOD_MAKEVAR_PREFIX =
+#---------------------------------------------------------------------------
+# Configuration options related to the preprocessor
+#---------------------------------------------------------------------------
+ENABLE_PREPROCESSING = YES
+MACRO_EXPANSION = YES
+EXPAND_ONLY_PREDEF = YES
+SEARCH_INCLUDES = YES
+INCLUDE_PATH =
+INCLUDE_FILE_PATTERNS =
+PREDEFINED = "for_all(x)=for(x.start(); x.is_valid(); x.next())" \
+ "for_all_2(x1, x2)=for(x1.start(), x2.start(); x1.is_valid(); x1.next(), x2.next())" \
+ "for_all_3(x1, x2, x3)=for(x1.start(), x2.start(), x3.start(); x1.is_valid(); x1.next(), x2.next(), x3.next())" \
+ "for_all_remaining(x)=if (! x.is_valid()) {} else while (x.next(), x.is_valid())" \
+ "mlc_unqualif(T)=typename mln::metal::unqualif<T>::ret" \
+ "mlc_equal(T1,T2)=mln::metal::equal<T1,T2>" \
+ "mln_piter(T)=typename T::piter" \
+ "mln_fwd_piter(T)=typename T::fwd_piter" \
+ "mln_bkd_piter(T)=typename T::bkd_piter" \
+ "mln_qiter(T)=typename T::qiter" \
+ "mln_fwd_qiter(T)=typename T::fwd_qiter" \
+ "mln_bkd_qiter(T)=typename T::bkd_qiter" \
+ "mln_niter(T)=typename T::niter" \
+ "mln_fwd_niter(T)=typename T::fwd_niter" \
+ "mln_bkd_niter(T)=typename T::bkd_niter" \
+ "mln_viter(T)=typename T::viter" \
+ "mln_fwd_viter(T)=typename T::fwd_viter" \
+ "mln_bkd_viter(T)=typename T::bkd_viter" \
+ "mln_result(T)=typename T::result" \
+ "mln_enc(T)=typename T::enc" \
+ "mln_value(T)=typename T::value" \
+ "mln_qlf_value(T)=typename T::qlf_value" \
+ "mln_domain(T)=typename T::domain_t" \
+ "mln_sum(T)=typename mln::value::props<T>::sum" \
+ "mln_vset(T)=typename T::vset" \
+ "mln_rvalue(T)=typename T::rvalue" \
+ "mln_lvalue(T)=typename T::lvalue" \
+ "mln_mesh(T)=typename T::mesh" \
+ "mln_coord(T)=typename T::coord" \
+ "mln_site(T)=typename T::site" \
+ "mln_psite(T)=typename T::psite" \
+ "mln_dpsite(T)=typename T::dpsite" \
+ "mln_accu_with(A, T)=typename A::template with< T >::ret" \
+ "mln_trait_op_div(L, R)=typename mln::trait::op::div< L , R >::ret" \
+ "mln_trait_op_less(L, R)=typename mln::trait::op::less< L , R >::ret" \
+ "mln_trait_op_minus(L, R)=typename mln::trait::op::minus< L , R >::ret" \
+ "mln_trait_op_mod(L, R)=typename mln::trait::op::mod< L , R >::ret" \
+ "mln_trait_op_plus(L, R)=typename mln::trait::op::plus< L , R >::ret" \
+ "mln_trait_op_times(L, R)=typename mln::trait::op::times< L , R >::ret" \
+ "mln_trait_op_uminus(T)=typename mln::trait::op::uminus< T >::ret" \
+ "mln_ch_value(I, V)=typename mln::trait::ch_value< I, V >::ret" \
+ "mlc_unqualif_(T)=mln::metal::unqualif<T>::ret" \
+ "mln_piter_(T)=T::piter" \
+ "mln_fwd_piter_(T)=T::fwd_piter" \
+ "mln_bkd_piter_(T)=T::bkd_piter" \
+ "mln_qiter_(T)=T::qiter" \
+ "mln_fwd_qiter_(T)=T::fwd_qiter" \
+ "mln_bkd_qiter_(T)=T::bkd_qiter" \
+ "mln_niter_(T)=T::niter" \
+ "mln_fwd_niter_(T)=T::fwd_niter" \
+ "mln_bkd_niter_(T)=T::bkd_niter" \
+ "mln_viter_(T)=T::viter" \
+ "mln_fwd_viter_(T)=T::fwd_viter" \
+ "mln_bkd_viter_(T)=T::bkd_viter" \
+ "mln_result_(T)=T::result" \
+ "mln_enc_(T)=T::enc" \
+ "mln_value_(T)=T::value" \
+ "mln_qlf_value_(T)=T::qlf_value" \
+ "mln_domain_(T)=T::domain_t" \
+ "mln_sum_(T)=mln::value::props<T>::sum" \
+ "mln_vset_(T)=T::vset" \
+ "mln_rvalue_(T)=T::rvalue" \
+ "mln_lvalue_(T)=T::lvalue" \
+ "mln_mesh_(T)=T::mesh" \
+ "mln_coord_(T)=T::coord" \
+ "mln_site_(T)=T::site" \
+ "mln_psite_(T)=T::psite" \
+ "mln_dpsite_(T)=T::dpsite" \
+ "mln_accu_with_(A, T)=A::template with< T >::ret" \
+ "mln_trait_op_plus_(L, R)=mln::trait::op::plus< L , R >::ret" \
+ "mln_trait_op_minus_(L, R)=mln::trait::op::minus< L , R >::ret" \
+ "mln_trait_op_times_(L, R)=mln::trait::op::times< L , R >::ret" \
+ "mln_trait_op_div_(L, R)=mln::trait::op::div< L , R >::ret" \
+ "mln_trait_op_mod_(L, R)=mln::trait::op::mod< L , R >::ret" \
+ "mln_trait_op_uminus_(T)=mln::trait::op::uminus< T >::ret" \
+ "mln_ch_value_(I, V)=typename mln::trait::ch_value< I, V >::ret" \
+ "mln_ch_value(I, V)_=mln::trait::ch_value< I, V >::ret" \
+ "mln_morpher_lvalue(I)=typename internal::morpher_lvalue_<I>::ret" \
+ "mln_concrete(I)=typename mln::trait::concrete< I >::ret" \
+ "mln_concrete_ch_value(I, V)=typename mln::trait::ch_value< typename mln::trait::concrete< I >::ret, V >::ret" \
+ "mlc_const(T)=typename mln::metal::const_< T >::ret" \
+ "mlc_const_return(T)=typename mln::metal::const_return_< T >::ret" \
+ "mln_element(T)=typename T::element" \
+ "mln_element_(T)=T::element" \
+ "mln_delta(T)=typename T::delta" \
+ "mln_delta_(T)=T::delta" \
+ "mln_dpoint(T)=typename T::dpoint" \
+ "mln_dpoint_(T)=T::dpoint" \
+ "mln_point(T)=typename T::point" \
+ "mln_point_(T)=T::point" \
+ "mln_gradient_component(I)=typename mln::trait::ch_value< I, mln::value::props< typename I::value >::sum >::ret" \
+ "mln_gradient(I)=mln::value::stack_image< I::point::dim, mln::trait::ch_value< I, mln::value::props< typename I::value >::sum >::ret >" \
+ "mln_trait_value_sum_product(T, U)=typename mln::trait::value_< mln_trait_op_times(T,U) >::sum" \
+ "mln_sum_product(T, U)=typename mln::trait::value_< mln_trait_op_times(T,U) >::sum" \
+ "mln_deduce(T, A1, A2)=typename T::A1::A2" \
+ "mln_graph_element(T)=typename T::graph_element" \
+ "mln_graph_element_(T)=T::graph_element" \
+ "mln_fun_vv2v(F, L, R)=mln::fun::vv2v::F< mln_value(L), mln_value(R) >" \
+ "mln_fun_vv2v_result(F, L, R)=typename mln_fun_vv2v(F, L, R)::result" \
+ "mln_ch_fun_vv2v(F, L, R)=typename mln::trait::ch_value< L, typename mln_fun_vv2v(F, L, R)::result >::ret"
+
+
+
+
+EXPAND_AS_DEFINED =
+SKIP_FUNCTION_MACROS = YES
+#---------------------------------------------------------------------------
+# Configuration::additions related to external references
+#---------------------------------------------------------------------------
+TAGFILES = @builddir@/../../milena/doc/milena.tag=../../../../milena/doc/user-refman/html
+GENERATE_TAGFILE = scribo.tag
+ALLEXTERNALS = NO
+EXTERNAL_GROUPS = YES
+PERL_PATH = /usr/bin/perl
+#---------------------------------------------------------------------------
+# Configuration options related to the dot tool
+#---------------------------------------------------------------------------
+CLASS_DIAGRAMS = NO
+HIDE_UNDOC_RELATIONS = YES
+HAVE_DOT = YES
+CLASS_GRAPH = NO
+COLLABORATION_GRAPH = NO # Disabled for light doc
+GROUP_GRAPHS = NO # Disabled for light doc
+UML_LOOK = NO
+TEMPLATE_RELATIONS = NO
+INCLUDE_GRAPH = NO # Disabled for light doc
+INCLUDED_BY_GRAPH = NO # Disabled for light doc
+CALL_GRAPH = NO
+CALLER_GRAPH = NO
+GRAPHICAL_HIERARCHY = NO
+DIRECTORY_GRAPH = NO # Disabled for light doc
+DOT_IMAGE_FORMAT = png
+DOT_PATH =
+DOTFILE_DIRS =
+MAX_DOT_GRAPH_DEPTH = 1000
+DOT_TRANSPARENT = NO
+DOT_MULTI_TARGETS = NO
+GENERATE_LEGEND = NO # Disabled for light doc
+DOT_CLEANUP = YES
+#---------------------------------------------------------------------------
+# Configuration::additions related to the search engine
+#---------------------------------------------------------------------------
+SEARCHENGINE = YES
+
+GENERATE_QHP = yes
+QHP_NAMESPACE = "fr.epita.lrde.olena.scribo"
+QHP_VIRTUAL_FOLDER = "scribo-2.0"
+QCH_FILE = "@builddir@/scribo.qch"
+QHG_LOCATION = "qhelpgenerator"
+
+
+# Local Variables:
+# mode: Makefile
+# End:
diff --git a/scribo/doc/DoxygenLayout.xml b/scribo/doc/DoxygenLayout.xml
new file mode 100644
index 0000000..ac34f54
--- /dev/null
+++ b/scribo/doc/DoxygenLayout.xml
@@ -0,0 +1,184 @@
+<doxygenlayout version="1.0">
+ <!-- Navigation index tabs for HTML output -->
+ <navindex>
+ <tab type="mainpage" visible="yes" title="Scribo"/>
+ <tab type="pages" visible="yes" title=""/>
+ <tab type="modules" visible="yes" title=""/>
+ <tab type="namespaces" visible="yes" title="">
+ <tab type="namespaces" visible="yes" title=""/>
+ <tab type="namespacemembers" visible="yes" title=""/>
+ </tab>
+ <tab type="classes" visible="yes" title="">
+ <tab type="classes" visible="yes" title=""/>
+ <tab type="classindex" visible="$ALPHABETICAL_INDEX" title=""/>
+ <tab type="hierarchy" visible="yes" title=""/>
+ <tab type="classmembers" visible="yes" title=""/>
+ </tab>
+ <tab type="files" visible="yes" title="">
+ <tab type="files" visible="yes" title=""/>
+ <tab type="globals" visible="yes" title=""/>
+ </tab>
+ <tab type="dirs" visible="yes" title=""/>
+ <tab type="examples" visible="yes" title=""/>
+ </navindex>
+
+ <!-- Layout definition for a class page -->
+ <class>
+ <briefdescription visible="yes"/>
+ <includes visible="$SHOW_INCLUDE_FILES"/>
+ <inheritancegraph visible="$CLASS_GRAPH"/>
+ <collaborationgraph visible="$COLLABORATION_GRAPH"/>
+ <allmemberslink visible="yes"/>
+ <memberdecl>
+ <nestedclasses visible="yes" title=""/>
+ <publictypes title=""/>
+ <publicslots title=""/>
+ <signals title=""/>
+ <publicmethods title=""/>
+ <publicstaticmethods title=""/>
+ <publicattributes title=""/>
+ <publicstaticattributes title=""/>
+ <protectedtypes title=""/>
+ <protectedslots title=""/>
+ <protectedmethods title=""/>
+ <protectedstaticmethods title=""/>
+ <protectedattributes title=""/>
+ <protectedstaticattributes title=""/>
+ <packagetypes title=""/>
+ <packagemethods title=""/>
+ <packagestaticmethods title=""/>
+ <packageattributes title=""/>
+ <packagestaticattributes title=""/>
+ <properties title=""/>
+ <events title=""/>
+ <privatetypes title=""/>
+ <privateslots title=""/>
+ <privatemethods title=""/>
+ <privatestaticmethods title=""/>
+ <privateattributes title=""/>
+ <privatestaticattributes title=""/>
+ <friends title=""/>
+ <related title="" subtitle=""/>
+ <membergroups visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ <memberdef>
+ <typedefs title=""/>
+ <enums title=""/>
+ <constructors title=""/>
+ <functions title=""/>
+ <related title=""/>
+ <variables title=""/>
+ <properties title=""/>
+ <events title=""/>
+ </memberdef>
+ <usedfiles visible="$SHOW_USED_FILES"/>
+ <authorsection visible="yes"/>
+ </class>
+
+ <!-- Layout definition for a namespace page -->
+ <namespace>
+ <briefdescription visible="yes"/>
+ <memberdecl>
+ <nestednamespaces visible="yes" title=""/>
+ <classes visible="yes" title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ <membergroups visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ <memberdef>
+ <typedefs title=""/>
+ <enums title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ </memberdef>
+ <authorsection visible="yes"/>
+ </namespace>
+
+ <!-- Layout definition for a file page -->
+ <file>
+ <briefdescription visible="yes"/>
+ <includes visible="$SHOW_INCLUDE_FILES"/>
+ <includegraph visible="$INCLUDE_GRAPH"/>
+ <includedbygraph visible="$INCLUDED_BY_GRAPH"/>
+ <sourcelink visible="yes"/>
+ <memberdecl>
+ <classes visible="yes" title=""/>
+ <namespaces visible="yes" title=""/>
+ <defines title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ <membergroups visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ <memberdef>
+ <defines title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ </memberdef>
+ <authorsection/>
+ </file>
+
+ <!-- Layout definition for a group page -->
+ <group>
+ <briefdescription visible="yes"/>
+ <groupgraph visible="$GROUP_GRAPHS"/>
+ <memberdecl>
+ <classes visible="yes" title=""/>
+ <namespaces visible="yes" title=""/>
+ <dirs visible="yes" title=""/>
+ <nestedgroups visible="yes" title=""/>
+ <files visible="yes" title=""/>
+ <defines title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <enumvalues title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ <signals title=""/>
+ <publicslots title=""/>
+ <protectedslots title=""/>
+ <privateslots title=""/>
+ <events title=""/>
+ <properties title=""/>
+ <friends title=""/>
+ <membergroups visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ <memberdef>
+ <pagedocs/>
+ <defines title=""/>
+ <typedefs title=""/>
+ <enums title=""/>
+ <enumvalues title=""/>
+ <functions title=""/>
+ <variables title=""/>
+ <signals title=""/>
+ <publicslots title=""/>
+ <protectedslots title=""/>
+ <privateslots title=""/>
+ <events title=""/>
+ <properties title=""/>
+ <friends title=""/>
+ </memberdef>
+ <authorsection visible="yes"/>
+ </group>
+
+ <!-- Layout definition for a directory page -->
+ <directory>
+ <briefdescription visible="yes"/>
+ <directorygraph visible="yes"/>
+ <memberdecl>
+ <dirs visible="yes"/>
+ <files visible="yes"/>
+ </memberdecl>
+ <detaileddescription title=""/>
+ </directory>
+</doxygenlayout>
diff --git a/scribo/doc/Makefile.am b/scribo/doc/Makefile.am
new file mode 100644
index 0000000..f1fae6c
--- /dev/null
+++ b/scribo/doc/Makefile.am
@@ -0,0 +1,250 @@
+# Copyright (C) 2011 EPITA Research and Development Laboratory (LRDE).
+#
+# This file is part of Olena.
+#
+# Olena is free software: you can redistribute it and/or modify it under
+# the terms of the GNU General Public License as published by the Free
+# Software Foundation, version 2 of the License.
+#
+# Olena is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+# General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with Olena. If not, see <http://www.gnu.org/licenses/>.
+
+
+# Look for Scribo headers in srcdir and for (generated) test headers
+# (like data.hh) in builddir.
+AM_CPPFLAGS = -I$(top_srcdir)/scribo -I$(top_builddir)/scribo
+
+DOXYGEN = doxygen
+
+DOXYFILE = Doxyfile
+
+DATA_html_dirs =
+
+## --------------------- ##
+## LaTeX configuration. ##
+## --------------------- ##
+
+include $(top_srcdir)/build-aux/tex.mk
+
+TEXI2DVI_FLAGS += \
+ -I $(srcdir) -I $(srcdir)/outputs -I $(srcdir)/outputs/split \
+ -I $(srcdir)/img -I $(srcdir)/examples/split
+
+# Additional files for LaTeX compilations.
+DOC_PACKAGES = doxyfuns.sty scribo.sty
+
+
+# ----------------------- #
+# User Reference Manual. #
+# ----------------------- #
+
+all-local: $(srcdir)/$(USER_REFMAN)
+
+# Run "make regen-doc" to forcefully rebuild the Doxygen documentation.
+.PHONY: regen-doc
+regen-doc:
+ rm -f $(srcdir)/user-refman.stamp
+ $(MAKE) $(AM_MAKEFLAGS) $(srcdir)/user-refman.stamp
+
+DOXYFILE_USER = Doxyfile_user
+
+# Sed is used to generate Doxyfile from Doxyfile.in instead of
+# configure, because the former is way faster than the latter.
+#
+## FIXME: This is because, as in TC, we depend on $Id$ from the
+## ChangeLog. Maybe we should depend from something less prone to
+## change. See Bison's build system.
+edit = sed -e "s|@ID@|$$Id|" \
+ -e 's,@PACKAGE_NAME\@,$(PACKAGE_NAME),g' \
+ -e 's,@PACKAGE_VERSION\@,$(PACKAGE_VERSION),g' \
+ -e 's,@top_srcdir\@,$(top_srcdir),g' \
+ -e 's,@top_builddir\@,$(top_builddir),g' \
+ -e 's,@srcdir\@,$(srcdir),g' \
+ -e 's,@builddir\@,$(builddir),g'
+
+$(DOXYFILE_USER): $(srcdir)/$(DOXYFILE).in
+ Id=`grep '^\$$Id' $(top_srcdir)/scribo/ChangeLog \
+ | sed -e 's/\\\$$//g'`; \
+ $(edit) $< >$@
+MAINTAINERCLEANFILES = $(DOXYFILE_USER)
+
+USER_REFMAN = user-refman
+
+# PDF.
+USER_REFMAN_PDF = user-refman.pdf
+dist_pdf_DATA = $(srcdir)/$(USER_REFMAN_PDF)
+
+$(srcdir)/$(USER_REFMAN_PDF): $(srcdir)/$(USER_REFMAN)
+ cd $(srcdir)/$(USER_REFMAN)/latex && $(MAKE) $(AM_MAKEFLAGS) pdf
+ cp -f $(srcdir)/$(USER_REFMAN)/latex/refman.pdf $@
+
+# HTML.
+EXTRA_DIST = $(srcdir)/user-refman.stamp
+MAINTAINERCLEANFILES += $(srcdir)/user-refman.stamp
+$(srcdir)/user-refman.stamp: $(srcdir)/$(DOXYFILE).in $(REFMAN_deps)
+ @rm -f $@.tmp
+ @touch $@.tmp
+ rm -rf $(USER_REFMAN).tmp
+ $(MAKE) $(AM_MAKE_FLAGS) $(DOXYFILE_USER)
+ $(DOXYGEN) $(DOXYFILE_USER)
+## Doxygen may generate an incomplete output and exit with success!
+## Check some files before deeming the output as acceptable.
+ test -f $(USER_REFMAN).tmp/latex/refman.tex
+ rm -rf $(srcdir)/$(USER_REFMAN)
+## FIXME: Moving directories between file systems is not portable.
+ mv $(USER_REFMAN).tmp $(srcdir)/$(USER_REFMAN)
+ @mv -f $@.tmp $@
+
+$(srcdir)/$(USER_REFMAN): $(srcdir)/user-refman.stamp
+## Recover from the removal of $@.
+ @if test -d $@; then :; else \
+ rm -f $<; \
+ $(MAKE) $(AM_MAKEFLAGS) $<; \
+ fi
+
+# Installing a directory located in the source dir is not supported by
+# Automake by default, so we cannot simply add `$(USER_REFMAN)/html'
+# to `dist_doc_DATA'. The rule `install-data-local' (see below) used
+# to work around this limitation is borrowed from the Vaucanson
+# project.
+EXTRA_DIST += $(USER_REFMAN)
+
+
+# ---------------------------- #
+# Developer Reference Manual. #
+# ---------------------------- #
+
+# Run "make regen-devel-doc" to forcefully rebuild the Doxygen
+# developer documentation.
+.PHONY: regen-devel-doc
+regen-devel-doc:
+ rm -f $(srcdir)/devel-refman.stamp
+ $(MAKE) $(AM_MAKEFLAGS) $(srcdir)/devel-refman.stamp
+
+DOXYFILE_DEVEL = Doxyfile_devel
+
+edit_devel = sed \
+ -e 's,OUTPUT_DIRECTORY = @builddir@/user-refman.tmp,OUTPUT_DIRECTORY = @builddir@/devel-refman.tmp,' \
+ -e 's,EXTRACT_ALL = NO,EXTRACT_ALL = YES,' \
+ -e 's,EXTRACT_PRIVATE = NO,EXTRACT_PRIVATE = YES,' \
+ -e 's,EXTRACT_STATIC = NO,EXTRACT_STATIC = YES,' \
+ -e 's,EXTRACT_LOCAL_CLASSES = NO,EXTRACT_LOCAL_CLASSES = YES,' \
+ -e 's,HIDE_UNDOC_MEMBERS = YES,HIDE_UNDOC_MEMBERS = NO,' \
+ -e 's,HIDE_UNDOC_CLASSES = YES,HIDE_UNDOC_CLASSES = NO,' \
+ -e 's,HIDE_FRIEND_COMPOUNDS = YES,HIDE_FRIEND_COMPOUNDS = NO,' \
+ -e 's,HIDE_IN_BODY_DOCS = YES,HIDE_IN_BODY_DOCS = NO,' \
+ -e 's,INTERNAL_DOCS = NO,INTERNAL_DOCS = YES,' \
+ -e 's,GENERATE_TODOLIST = NO,GENERATE_TODOLIST = YES,' \
+ -e 's,PROJECT_NUMBER = \"User documentation ,PROJECT_NUMBER = \",' \
+ -e 's,EXCLUDE_SYMBOLS = \*::internal\* \*_ mln::trait::\*,EXCLUDE_SYMBOLS =,'
+
+$(DOXYFILE_DEVEL): $(srcdir)/$(DOXYFILE).in
+ rm -f $@.tmp
+ Id=`grep '^\$$Id' $(top_srcdir)/scribo/ChangeLog \
+ | sed -e 's/\\\$$//g'`; \
+ $(edit) $< >$@.tmp
+ $(edit_devel) $@.tmp >$@
+ rm -f $@.tmp
+MAINTAINERCLEANFILES += $(DOXYFILE_DEVEL)
+
+DEVEL_REFMAN = devel-refman
+
+# PDF.
+DEVEL_REFMAN_PDF = devel-refman.pdf
+# Be warned, most LaTeX installations will not be able to compile the
+# PDF development documentation as-is, as TeX's default memory
+# capacities are usually too small to handle such a large document.
+$(srcdir)/$(DEVEL_REFMAN_PDF): $(srcdir)/$(DEVEL_REFMAN)
+ cd $(srcdir)/$(DEVEL_REFMAN)/latex && $(MAKE) $(AM_MAKEFLAGS) pdf
+ cp -f $(srcdir)/$(DEVEL_REFMAN)/latex/refman.pdf $@
+
+# HTML.
+MAINTAINERCLEANFILES += $(srcdir)/devel-refman.stamp
+$(srcdir)/devel-refman.stamp: $(srcdir)/$(DOXYFILE).in $(REFMAN_deps)
+ @rm -f $@.tmp
+ @touch $@.tmp
+ rm -rf $(DEVEL_REFMAN).tmp
+ $(MAKE) $(AM_MAKE_FLAGS) $(DOXYFILE_DEVEL)
+ $(DOXYGEN) $(DOXYFILE_DEVEL)
+## Doxygen may generate an incomplete output and exit with success!
+## Check some files before deeming the output as acceptable.
+ test -f $(DEVEL_REFMAN).tmp/latex/refman.tex
+ rm -rf $(srcdir)/$(DEVEL_REFMAN)
+## FIXME: Moving directories between file systems is not portable.
+ mv $(DEVEL_REFMAN).tmp $(srcdir)/$(DEVEL_REFMAN)
+ @mv -f $@.tmp $@
+
+$(srcdir)/$(DEVEL_REFMAN): $(srcdir)/devel-refman.stamp
+## Recover from the removal of $@.
+ @if test -d $@; then :; else \
+ rm -f $<; \
+ $(MAKE) $(AM_MAKEFLAGS) $<; \
+ fi
+
+## -------------- ##
+## Distribution. ##
+## -------------- ##
+
+EXTRA_DIST += \
+ $(DATA_html_dirs) \
+ $(DOXYFILE).in \
+ doxyfuns.sty \
+ scribo.sty \
+ tools/clearbanner.sh \
+ tools/sample_utils.hh \
+ tools/split_sample.sh \
+ tools/todoxygen.sh
+
+
+## ---------- ##
+## Cleaning. ##
+## ---------- ##
+
+MAINTAINERCLEANFILES += $(dist_pdf_DATA)
+
+maintainer-clean-local:
+ -rm -rf $(USER_REFMAN).tmp $(srcdir)/$(USER_REFMAN)
+ -rm -rf $(DEVEL_REFMAN).tmp $(srcdir)/$(DEVEL_REFMAN)
+ -for d in $(DATA_html_dirs); do \
+ rm -rf $$d.tmp $(srcdir)/$$d; \
+ done
+
+
+## -------------- ##
+## Installation. ##
+## -------------- ##
+
+# We install by hand, otherwise Automake produces "install .../srcdoc
+# .../srcdoc", which installs our dir into the previous one, instead
+# of replacing it.
+install-data-local:
+ $(mkdir_p) $(DESTDIR)$(htmldir)
+# The user reference manual is located in a subdirectory, hence this
+# special case.
+ rm -rf $(DESTDIR)$(htmldir)/$(USER_REFMAN)
+ cp -r $(srcdir)/$(USER_REFMAN)/html $(DESTDIR)$(htmldir)/$(USER_REFMAN)
+# Other HTML directories can be processed uniformly.
+ for d in $(DATA_html_dirs_inst); do \
+ rm -rf $(DESTDIR)$(htmldir)/$$d; \
+ cp -r $(srcdir)/$$d $(DESTDIR)$(htmldir); \
+ done
+## Try GNU chmod's X mode before resorting to something slower but
+## more standard.
+ chmod -R a+rX $(DESTDIR)$(htmldir) || \
+ find $(DESTDIR)$(htmldir) \( -type d -a -exec chmod a+rx {} \; \) \
+ -o -exec chmod a+r {} \;
+
+uninstall-local:
+ for d in $(DATA_html_dirs_inst); do \
+ chmod -R 700 $(DESTDIR)$(htmldir)/$$d; \
+ rm -rf $(DESTDIR)$(htmldir)/$$d; \
+ done
+# Same remark as above regarding the special case of the user
+# reference manual.
+ chmod -R 700 $(DESTDIR)$(htmldir)/$(USER_REFMAN)
+ rm -rf $(DESTDIR)$(htmldir)/$(USER_REFMAN)
diff --git a/milena/doc/doxyfuns.sty b/scribo/doc/doxyfuns.sty
similarity index 100%
copy from milena/doc/doxyfuns.sty
copy to scribo/doc/doxyfuns.sty
diff --git a/milena/doc/outputs/accu-right-instantiation.txt b/scribo/doc/examples-outputs.mk
similarity index 100%
copy from milena/doc/outputs/accu-right-instantiation.txt
copy to scribo/doc/examples-outputs.mk
diff --git a/scribo/doc/examples.mk b/scribo/doc/examples.mk
new file mode 100644
index 0000000..c7181cc
--- /dev/null
+++ b/scribo/doc/examples.mk
@@ -0,0 +1,4 @@
+## Generated by gen-make-variable. Do not edit by hand.
+
+EXAMPLES = \
+ $(srcdir)/examples/dummy.cc
diff --git a/milena/doc/outputs/accu-right-instantiation.txt b/scribo/doc/examples/dummy.cc
similarity index 100%
copy from milena/doc/outputs/accu-right-instantiation.txt
copy to scribo/doc/examples/dummy.cc
diff --git a/milena/doc/outputs/accu-right-instantiation.txt b/scribo/doc/figures.mk
similarity index 100%
copy from milena/doc/outputs/accu-right-instantiation.txt
copy to scribo/doc/figures.mk
diff --git a/milena/doc/gen-examples-outputs-mk b/scribo/doc/gen-examples-outputs-mk
similarity index 100%
copy from milena/doc/gen-examples-outputs-mk
copy to scribo/doc/gen-examples-outputs-mk
diff --git a/milena/doc/gen-figures-mk b/scribo/doc/gen-figures-mk
similarity index 100%
copy from milena/doc/gen-figures-mk
copy to scribo/doc/gen-figures-mk
diff --git a/milena/doc/gen-make-variable b/scribo/doc/gen-make-variable
similarity index 100%
copy from milena/doc/gen-make-variable
copy to scribo/doc/gen-make-variable
diff --git a/milena/doc/gen-split-examples-mk b/scribo/doc/gen-split-examples-mk
similarity index 100%
copy from milena/doc/gen-split-examples-mk
copy to scribo/doc/gen-split-examples-mk
diff --git a/milena/doc/gen-split-outputs-mk b/scribo/doc/gen-split-outputs-mk
similarity index 100%
copy from milena/doc/gen-split-outputs-mk
copy to scribo/doc/gen-split-outputs-mk
diff --git a/milena/doc/graphicx.hva b/scribo/doc/graphicx.hva
similarity index 100%
copy from milena/doc/graphicx.hva
copy to scribo/doc/graphicx.hva
diff --git a/scribo/doc/outputs.mk b/scribo/doc/outputs.mk
new file mode 100644
index 0000000..09a1efd
--- /dev/null
+++ b/scribo/doc/outputs.mk
@@ -0,0 +1,4 @@
+## Generated by gen-make-variable. Do not edit by hand.
+
+OUTPUTS = \
+ $(srcdir)/outputs/dummy.txt
diff --git a/milena/doc/outputs/accu-right-instantiation.txt b/scribo/doc/outputs/dummy.txt
similarity index 100%
copy from milena/doc/outputs/accu-right-instantiation.txt
copy to scribo/doc/outputs/dummy.txt
diff --git a/milena/doc/outputs/accu-right-instantiation.txt b/scribo/doc/programs-examples.mk
similarity index 100%
copy from milena/doc/outputs/accu-right-instantiation.txt
copy to scribo/doc/programs-examples.mk
diff --git a/scribo/doc/scribo.qhcp b/scribo/doc/scribo.qhcp
new file mode 100644
index 0000000..77269b5
--- /dev/null
+++ b/scribo/doc/scribo.qhcp
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<QHelpCollectionProject version="1.0">
+ <assistant>
+ <startPage>qthelp://fr.epita.lrde.olena/scribo-2.0/index.html</startPage>
+ </assistant>
+ <docFiles>
+ <register>
+ <file>user-refman/html/scribo.qch</file>
+ </register>
+ </docFiles>
+</QHelpCollectionProject>
\ No newline at end of file
diff --git a/milena/doc/milena.sty b/scribo/doc/scribo.sty
similarity index 100%
copy from milena/doc/milena.sty
copy to scribo/doc/scribo.sty
diff --git a/milena/doc/outputs/accu-right-instantiation.txt b/scribo/doc/split-examples.mk
similarity index 100%
copy from milena/doc/outputs/accu-right-instantiation.txt
copy to scribo/doc/split-examples.mk
diff --git a/milena/doc/outputs/accu-right-instantiation.txt b/scribo/doc/split-outputs.mk
similarity index 100%
copy from milena/doc/outputs/accu-right-instantiation.txt
copy to scribo/doc/split-outputs.mk
diff --git a/milena/doc/tools/todoxygen.sh b/scribo/doc/tools/todoxygen.sh
similarity index 100%
copy from milena/doc/tools/todoxygen.sh
copy to scribo/doc/tools/todoxygen.sh
diff --git a/milena/doc/outputs/accu-right-instantiation.txt b/scribo/doc/tutorial.tex
similarity index 100%
copy from milena/doc/outputs/accu-right-instantiation.txt
copy to scribo/doc/tutorial.tex
--
1.7.2.5
1
0
29 Nov '11
---
doc/doc.bib | 12 ++++++++++++
milena/doc/Doxyfile.in | 2 +-
2 files changed, 13 insertions(+), 1 deletions(-)
create mode 100644 doc/doc.bib
diff --git a/doc/doc.bib b/doc/doc.bib
new file mode 100644
index 0000000..b116a98
--- /dev/null
+++ b/doc/doc.bib
@@ -0,0 +1,12 @@
+(a)Article{besl.92.pami,
+ author = "P.J. Besl and N.D. McKay",
+ title = "A Method for Registration of 3-D Shapes",
+ journal = "IEEE Transactions on Pattern Analysis and Machine Intelligence",
+ volume = "14",
+ issn = "0162-8828",
+ year = "1992",
+ pages = "239--256",
+ doi = "http://doi.ieeecomputersociety.org/10.1109/34.121791",
+ publisher = "IEEE Computer Society",
+ address = "Los Alamitos, CA, USA"
+}
\ No newline at end of file
diff --git a/milena/doc/Doxyfile.in b/milena/doc/Doxyfile.in
index 494d99c..c1b0bc6 100644
--- a/milena/doc/Doxyfile.in
+++ b/milena/doc/Doxyfile.in
@@ -122,7 +122,7 @@ INPUT_FILTER =
FILTER_PATTERNS =
FILTER_SOURCE_FILES = NO
INPUT_ENCODING = ISO-8859-1
-
+CITE_BIB_FILES = $top_srcdir$/doc/doc.bib
#---------------------------------------------------------------------------
# configuration options related to source browsing
#---------------------------------------------------------------------------
--
1.7.2.5
1
0
---
Makefile.am | 4 +-
doc/Doxyfile.in | 2 +-
doc/Makefile.am | 18 ++-
doc/bibliography.hh | 19 ++
doc/mainpage.hh | 44 +++--
doc/modules_list.hh | 9 +
doc/olena.bib | 415 ++++++++++++++++++++++++++++++++++++++++
milena/doc/Doxyfile.in | 4 +-
milena/doc/Makefile.am | 10 +-
milena/mln/registration/icp.hh | 2 +
scribo/Makefile.am | 2 +-
scribo/doc/Makefile.am | 15 +-
12 files changed, 512 insertions(+), 32 deletions(-)
create mode 100644 doc/bibliography.hh
create mode 100644 doc/modules_list.hh
create mode 100644 doc/olena.bib
diff --git a/Makefile.am b/Makefile.am
index 66dc10c..677a9c3 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -17,7 +17,7 @@
ACLOCAL_AMFLAGS = -I m4
-SUBDIRS = build-aux external milena
+SUBDIRS = build-aux doc external milena
if ENABLE_SWILENA
SUBDIRS += swilena
@@ -164,3 +164,5 @@ snapshot:
&& $(MAKE) $(AM_MAKEFLAGS) dist \
&& mv -f $(srcdir)/configure.ac.old $(srcdir)/configure.ac
#>>
+
+
diff --git a/doc/Doxyfile.in b/doc/Doxyfile.in
index 106c58c..a0fcf00 100644
--- a/doc/Doxyfile.in
+++ b/doc/Doxyfile.in
@@ -112,7 +112,7 @@ INPUT_FILTER =
FILTER_PATTERNS =
FILTER_SOURCE_FILES = NO
INPUT_ENCODING = ISO-8859-1
-
+CITE_BIB_FILES = @top_srcdir@/doc/olena.bib
#---------------------------------------------------------------------------
# configuration options related to source browsing
#---------------------------------------------------------------------------
diff --git a/doc/Makefile.am b/doc/Makefile.am
index ac2fd2e..e733ab9 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -53,11 +53,13 @@ regen-doc:
DOXYFILE_USER = Doxyfile_user
-REFMAN_deps = $(srcdir)/footer.html \
- $(srcdir)/header.html \
- $(srcdir)/doxygen.css \
- $(srcdir)/mainpage.hh \
- $(srcdir)/DoxygenLayout.xml
+REFMAN_deps = $(srcdir)/footer.html \
+ $(srcdir)/header.html \
+ $(srcdir)/doxygen.css \
+ $(srcdir)/mainpage.hh \
+ $(srcdir)/DoxygenLayout.xml \
+ $(srcdir)/modules_list.hh \
+ $(srcdir)/olena.bib
# Sed is used to generate Doxyfile from Doxyfile.in instead of
# configure, because the former is way faster than the latter.
@@ -142,6 +144,12 @@ install-data-local:
# special case.
rm -rf $(DESTDIR)$(htmldir)/$(USER_REFMAN)
cp -r $(srcdir)/$(USER_REFMAN)/html $(DESTDIR)$(htmldir)/$(USER_REFMAN)
+# Update paths to milena documentation directory
+ $(DESTDIR)$(htmldir)/$(USER_REFMAN)/installdox \
+ -l milena.tag@$(DESTDIR)$(htmldir)/$(USER_REFMAN)/milena \
+ `find $(DESTDIR)$(htmldir)/$(USER_REFMAN)/ -name '*.html'` \
+ -l scribo.tag@$(DESTDIR)$(htmldir)/$(USER_REFMAN)/scribo \
+ `find $(DESTDIR)$(htmldir)/$(USER_REFMAN)/ -name '*.html'`
## Try GNU chmod's X mode before resorting to something slower but
## more standard.
chmod -R a+rX $(DESTDIR)$(htmldir) || \
diff --git a/doc/bibliography.hh b/doc/bibliography.hh
new file mode 100644
index 0000000..841372b
--- /dev/null
+++ b/doc/bibliography.hh
@@ -0,0 +1,19 @@
+/** \page bibliography Bibliography
+
+ Here you can find all the articles related to the Olena platform.
+
+ \li \cite burrus.03.mpool
+ \li \cite darbon.02.ismm
+ \li \cite darbon.04.ecoopphd
+ \li \cite duret.00.gcse
+ \li \cite geraud.00.icpr
+ \li \cite geraud.01.ai
+ \li \cite geraud.08.mpool
+ \li \cite geraud.99.gretsi
+ \li \cite lazzara.11.icdar
+ \li \cite levillain.09.ismm
+ \li \cite levillain.10.icip
+ \li \cite levillain.10.wadgmm
+ \li \cite levillain.11.gretsi
+
+ */
diff --git a/doc/mainpage.hh b/doc/mainpage.hh
index 0704753..116c69a 100644
--- a/doc/mainpage.hh
+++ b/doc/mainpage.hh
@@ -6,26 +6,46 @@
<table class="doxtable itable">
<tr>
- <th>General Presentation</th>
- <th>Modules</th>
- <th>Applications</th>
+ <th>General Presentation</th>
+ <th>Modules</th>
+ <th>Applications</th>
</tr>
<tr>
- <td><ul><li>What is Olena ?</li><li>Bibliography</li><li>Contributors</li></ul></td>
- <td><ul><li>List of Available modules</li><li><a href='../../../milena/doc/user-refman/html/index.html'>Milena</a></li><li><a href='../../../scribo/doc/user-refman/html/index.html'>Scribo</a></li><li>Swilena</li></ul></td>
- <td><ul><li>Online Demos</li><li>Papers Related Programs</li><li>Olena Powered Programs</li></ul></td>
+ <td>
+ \li What is Olena ?
+ \li \ref bibliography
+ \li Contributors
+ </td>
+ <td>
+ \li \ref moduleslist
+ \li <a class="el" doxygen="milena.tag:../../../milena/doc/user-refman/html" href="../../../milena/doc/user-refman/html/index.html">Milena</a>
+ \li <a class="el" doxygen="scribo.tag:../../../scribo/doc/user-refman/html" href="../../../scribo/doc/user-refman/html/index.html">Scribo</a>
+ \li Swilena
+ </td>
+ <td>
+ \li Online Demos
+ \li Papers Related Programs
+ \li Olena Powered Programs
+ </td>
</tr>
<tr>
- <th>Contributing</th>
- <th>Licensing</th>
- <th> </th>
+ <th>Contributing</th>
+ <th>Licensing</th>
+ <th> </th>
</tr>
<tr>
- <td><ul><li>Report Bugs and Make Suggestions</li><li>Get the Sources</li><li>Online Resources</li></ul></td>
- <td><ul><li>GNU GPL</li><li>Commercial Use</li></ul></td>
- <td> </td>
+ <td>
+ \li Report Bugs and Make Suggestions
+ \li Get the Sources
+ \li Online Resources
+ </td>
+ <td>
+ \li GNU GPL
+ \li Commercial Use
+ </td>
+ <td> </td>
</tr>
</table>
diff --git a/doc/modules_list.hh b/doc/modules_list.hh
new file mode 100644
index 0000000..e3f2b8d
--- /dev/null
+++ b/doc/modules_list.hh
@@ -0,0 +1,9 @@
+/** \page moduleslist List of available modules
+
+As a platform, Olena is divided in several modules:
+
+\li Milena, a generic image processing library.
+\li Scribo, a framework for document image analysis.
+\li Swilena, Python bindings for Milena.
+
+ */
diff --git a/doc/olena.bib b/doc/olena.bib
new file mode 100644
index 0000000..248a22d
--- /dev/null
+++ b/doc/olena.bib
@@ -0,0 +1,415 @@
+@InProceedings{ burrus.03.mpool,
+ author = {Nicolas Burrus and Alexandre Duret-Lutz and {\relax
+ Th}ierry G\'eraud and David Lesage and Rapha\"el Poss},
+ title = {A static {C++} object-oriented programming ({SCOOP})
+ paradigm mixing benefits of traditional {OOP} and generic
+ programming},
+ booktitle = {Proceedings of the Workshop on Multiple Paradigm with
+ Object-Oriented Languages (MPOOL)},
+ year = 2003,
+ address = {Anaheim, CA, USA},
+ month = oct,
+ project = {Olena},
+ urllrde = {200310-MPOOL},
+ abstract = {Object-oriented and generic programming are both supported
+ in C++. OOP provides high expressiveness whereas GP leads
+ to more efficient programs by avoiding dynamic typing. This
+ paper presents SCOOP, a new paradigm which enables both
+ classical OO design and high performance in C++ by mixing
+ OOP and GP. We show how classical and advanced OO features
+ such as virtual methods, multiple inheritance, argument
+ covariance, virtual types and multimethods can be
+ implemented in a fully statically typed model, hence
+ without run-time overhead.}
+}
+
+
+@InProceedings{ darbon.02.ismm,
+ author = {J\'er\^ome Darbon and {\relax Th}ierry G\'eraud and
+ Alexandre Duret-Lutz},
+ title = {Generic implementation of morphological image operators},
+ booktitle = {Mathematical Morphology, Proceedings of the 6th
+ International Symposium (ISMM)},
+ pages = {175--184},
+ year = 2002,
+ address = {Sydney, Australia},
+ month = apr,
+ publisher = {CSIRO Publishing},
+ project = {Olena},
+ urllrde = {200204-Ismm},
+ abstract = {Several libraries dedicated to mathematical morphology
+ exist. But they lack genericity, that is to say, the
+ ability for operators to accept input of different natures
+ ---2D binary images, graphs enclosing floating values, etc.
+ We describe solutions which are integrated in Olena, a
+ library providing morphological operators. We demonstrate
+ with some examples that translating mathematical formulas
+ and algorithms into source code is made easy and safe with
+ Olena. Moreover, experimental results show that no extra
+ costs at run-time are induced.}
+}
+
+@InProceedings{ darbon.04.ecoopphd,
+ author = {J\'er\^ome Darbon and {\relax Th}ierry G\'eraud and
+ Patrick Bellot},
+ title = {Generic algorithmic blocks dedicated to image processing},
+ booktitle = {Proceedings of the ECOOP Workshop for PhD Students},
+ year = 2004,
+ address = {Oslo, Norway},
+ month = jun,
+ project = {Olena},
+ urllrde = {200406-ECOOPPHD},
+ abstract = {This paper deals with the implementation of algorithms in
+ the specific domain of image processing. Although many
+ image processing libraries are available, they generally
+ lack genericity and flexibility. Many image processing
+ algorithms can be expressed as compositions of elementary
+ algorithmic operations referred to as blocks. Implementing
+ these compositions is achieved using generic programming.
+ Our solution is compared to previous ones and we
+ demonstrate it on a class image processing algorithms.}
+}
+
+@InProceedings{ duret.00.gcse,
+ author = {Alexandre Duret-Lutz},
+ title = {Olena: a component-based platform for image processing,
+ mixing generic, generative and {OO} programming},
+ booktitle = {Proceedings of the 2nd International Symposium on
+ Generative and Component-Based Software Engineering
+ (GCSE)---Young Researchers Workshop; published in
+ ``Net.ObjectDays2000''},
+ pages = {653--659},
+ year = 2000,
+ address = {Erfurt, Germany},
+ month = oct,
+ isbn = {3-89683-932-2},
+ project = {Olena},
+ urllrde = {200010-NetObjectDays},
+ abstract = {This paper presents Olena, a toolkit for programming and
+ designing image processing chains in which each processing
+ is a component. But since there exist many image types
+ (different structures such as 2D images, 3D images or
+ graphs, as well as different value types) the platform has
+ been designed with genericity and reusability in mind: each
+ component is written as a generic C++ procedure, \`a la
+ STL. Other libraries, such as Khoros [Kon94] have a
+ different approach where a processing component contains an
+ implementation for each type supported by the library. This
+ makes code maintenance hard and prevents easy addition of
+ new image types. Still, Olena is not only a generic
+ component library [Jaz95], it shall contain additional
+ tools such as a visual programming environment (VPE). Those
+ tools may be programmed in a classical object-oriented
+ fashion (using operation and inclusion polymorphism) which
+ may seems antagonist with the generic programming paradigm
+ used in the library. Section 2 outlines the architecture of
+ Olena and elaborates more on the design problems resulting
+ from the use of generic components. Section 3 presents the
+ solution chosen to address these problems.}
+}
+
+
+@InProceedings{ geraud.00.icpr,
+ author = {{\relax Th}ierry G\'eraud and Yoann Fabre and Alexandre
+ Duret-Lutz and Dimitri Papadopoulos-Orfanos and
+ Jean-Fran\c{c}ois Mangin},
+ title = {Obtaining genericity for image processing and pattern
+ recognition algorithms},
+ booktitle = {Proceedings of the 15th International Conference on
+ Pattern Recognition (ICPR)},
+ year = 2000,
+ month = sep,
+ address = {Barcelona, Spain},
+ volume = 4,
+ pages = {816--819},
+ publisher = {IEEE Computer Society},
+ project = {Olena},
+ urllrde = {200009-Icpr},
+ abstract = {Algorithm libraries dedicated to image processing and
+ pattern recognition are not reusable; to run an algorithm
+ on particular data, one usually has either to rewrite the
+ algorithm or to manually ``copy, paste, and modify''. This
+ is due to the lack of genericity of the programming
+ paradigm used to implement the libraries. In this paper, we
+ present a recent paradigm that allows algorithms to be
+ written once and for all and to accept input of various
+ types. Moreover, this total reusability can be obtained
+ with a very comprehensive writing and without significant
+ cost at execution, compared to a dedicated algorithm. This
+ new paradigm is called ``generic programming'' and is fully
+ supported by the C++ language. We show how this paradigm
+ can be applied to image processing and pattern recognition
+ routines. The perspective of our work is the creation of a
+ generic library.}
+}
+
+@InProceedings{ geraud.01.ai,
+ author = {{\relax Th}ierry G\'eraud and Yoann Fabre and Alexandre
+ Duret-Lutz},
+ title = {Applying generic programming to image processing},
+ booktitle = {Proceedings of the IASTED International Conference on
+ Applied Informatics (AI)---Symposium on Advances in
+ Computer Applications},
+ year = 2001,
+ publisher = {ACTA Press},
+ editor = {M.H.~Hamsa},
+ address = {Innsbruck, Austria},
+ pages = {577--581},
+ month = feb,
+ project = {Olena},
+ urllrde = {200102-Ai},
+ abstract = {This paper presents the evolution of algorithms
+ implementation in image processing libraries and discusses
+ the limits of these implementations in terms of
+ reusability. In particular, we show that in C++, an
+ algorithm can have a general implementation; said
+ differently, an implementation can be generic, i.e.,
+ independent of both the input aggregate type and the type
+ of the data contained in the input aggregate. A total
+ reusability of algorithms can therefore be obtained;
+ moreover, a generic implementation is more natural and does
+ not introduce a meaningful additional cost in execution
+ time as compared to an implementation dedicated to a
+ particular input type.}
+}
+
+
+@InProceedings{ geraud.08.mpool,
+ author = {{\relax Th}ierry G\'eraud and Roland Levillain},
+ title = {Semantics-Driven Genericity: A Sequel to the Static {C++}
+ Object-Oriented Programming Paradigm ({SCOOP 2})},
+ booktitle = {Proceedings of the 6th International Workshop on
+ Multiparadigm Programming with Object-Oriented Languages
+ (MPOOL)},
+ year = 2008,
+ address = {Paphos, Cyprus},
+ month = jul,
+ project = {Olena},
+ urllrde = {200807-MPOOL},
+ abstract = {Classical (unbounded) genericity in \Cxx{}03 defines the
+ interactions between generic data types and algorithms in
+ terms of concepts. Concepts define the requirements over a
+ type (or a parameter) by expressing constraints on its
+ methods and dependent types (typedefs). The upcoming
+ \Cxx{}0x standard will promote concepts from abstract
+ entities (not directly enforced by the tools) to language
+ constructs, enabling compilers and tools to perform
+ additional checks on generic constructs as well as enabling
+ new features (e.g., concept-based overloading). Most modern
+ languages support this notion of signature on generic
+ types. However, generic types built on other types and
+ relying on concepts to both ensure type conformance and
+ drive code specialization, restrain the interface and the
+ implementation of the newly created type: specific methods
+ and associated types not mentioned in the concept will not
+ be part of the new type. The paradigm of concept-based
+ genericity lacks the required semantics to transform types
+ while retaining or adapting their intrinsic capabilities.
+ We present a new form of semantically-enriched genericity
+ allowing static generic type transformations through a
+ simple form of type introspection based on type metadata
+ called properties. This approach relies on a new Static
+ \Cxx Object-Oriented Programming (SCOOP) paradigm, and is
+ adapted to the creation of generic and efficient libraries,
+ especially in the field of scientific computing. Our
+ proposal uses a metaprogramming facility built into a \Cxx
+ library called Static, and doesn't require any language
+ extension nor additional processing (preprocessor,
+ transformation tool).}
+}
+
+@InProceedings{ geraud.99.gretsi,
+ author = {{\relax Th}ierry G\'eraud and Yoann Fabre and Dimitri
+ Papadopoulos-Orfanos and Jean-Fran\c{c}ois Mangin},
+ title = {Vers une r\'eutilisabilit\'e totale des algorithmes de
+ traitement d'images},
+ booktitle = {Proceedings of the 17th Symposium on Signal and Image
+ Processing (GRETSI)},
+ category = {national},
+ pages = {331--334},
+ volume = 2,
+ year = 1999,
+ address = {Vannes, France},
+ month = sep,
+ note = {In French},
+ project = {Olena},
+ urllrde = {199909-Gretsi},
+ abstract = {Cet article pr\'esente l'\'evolution des techniques de
+ programmation d'algorithmes de traitement d'images et
+ discute des limites de la r\'eutilisabilit\'e de ces
+ algorithmes. En particulier, nous montrons qu'en C++ un
+ algorithme peut s'\'ecrire sous une forme g\'en\'erale,
+ ind\'ependante aussi bien du type des donn\'ees que du type
+ des structures de donn\'ees sur lesquelles il peut
+ s'appliquer. Une r\'eutilisabilit\'e totale des algorithmes
+ peut donc \^etre obtenue ; mieux, leur \'ecriture est plus
+ naturelle et elle n'introduit pas de surco\^ut significatif
+ en temps d'ex\'ecution.}
+}
+
+
+@InProceedings{ lazzara.11.icdar,
+ author = {Guillaume Lazzara and Roland Levillain and {\relax
+ Th}ierry G\'eraud and Yann Jacquelet and Julien Marquegnies
+ and Arthur Cr\'epin-Leblond},
+ title = {The {SCRIBO} Module of the {Olena} Platform: a Free
+ Software Framework for Document Image Analysis},
+ booktitle = {Proceedings of the 11th International Conference on
+ Document Analysis and Recognition (ICDAR)},
+ year = 2011,
+ address = {Beijing, China},
+ month = sep,
+ organization = {International Association for Pattern Recognition (IAPR)},
+ note = {Accepted},
+ project = {Olena},
+ urllrde = {201109-ICDAR},
+ abstract = {Electronic documents are being more and more usable thanks
+ to better and more affordable network, storage and
+ computational facilities. But in order to benefit from
+ computer-aided document management, paper documents must be
+ digitized and analyzed. This task may be challenging at
+ several levels. Data may be of multiple types thus
+ requiring different adapted processing chains. The tools to
+ be developed should also take into account the needs and
+ knowledge of users, ranging from a simple graphical
+ application to a complete programming framework. Finally,
+ the data sets to process may be large. In this paper, we
+ expose a set of features that a Document Image Analysis
+ framework should provide to handle the previous issues. In
+ particular, a good strategy to address both flexibility and
+ efficiency issues is the Generic Programming (GP) paradigm.
+ These ideas are implemented as an open source module,
+ SCRIBO, built on top of Olena, a generic and efficient
+ image processing platform. Our solution features services
+ such as preprocessing filters, text detection, page
+ segmentation and document reconstruction (as XML, PDF or
+ HTML documents). This framework, composed of reusable
+ software components, can be used to create full-fledged
+ graphical applications, small utilities, or processing
+ chains to be integrated into third-party projects.},
+ keywords = {Document Image Analysis, Software Design, Reusability,
+ Free Software}
+}
+
+@InProceedings{ levillain.09.ismm,
+ author = {Roland Levillain and {\relax Th}ierry G\'eraud and Laurent
+ Najman},
+ title = {{Milena}: Write Generic Morphological Algorithms Once, Run
+ on Many Kinds of Images},
+ booktitle = {Mathematical Morphology and Its Application to Signal and
+ Image Processing -- Proceedings of the Ninth International
+ Symposium on Mathematical Morphology (ISMM)},
+ pages = {295--306},
+ year = 2009,
+ editor = {Michael H. F. Wilkinson and Jos B. T. M. Roerdink},
+ series = {Lecture Notes in Computer Science},
+ address = {Groningen, The Netherlands},
+ month = aug,
+ publisher = {Springer Berlin / Heidelberg},
+ volume = 5720,
+ project = {Olena},
+ urllrde = {200908-ISMM},
+ abstract = {We present a programming framework for discrete
+ mathematical morphology centered on the concept of
+ genericity. We show that formal definitions of
+ morphological algorithms can be translated into actual
+ code, usable on virtually any kind of compatible images,
+ provided a general definition of the concept of image is
+ given. This work is implemented in Milena, a generic,
+ efficient, and user-friendly image processing library.},
+ keywords = {mathematical morphology, image processing operator,
+ genericity, programming}
+}
+
+@InProceedings{ levillain.10.icip,
+ author = {Roland Levillain and {\relax Th}ierry G\'eraud and Laurent
+ Najman},
+ title = {Why and How to Design a Generic and Efficient Image
+ Processing Framework: The Case of the {Milena} Library},
+ booktitle = {Proceedings of the IEEE International Conference on Image
+ Processing (ICIP)},
+ pages = {1941--1944},
+ year = 2010,
+ address = {Hong Kong},
+ month = sep,
+ project = {Olena},
+ urllrde = {201009-ICIP},
+ abstract = {Most image processing frameworks are not generic enough to
+ provide true reusability of data structures and algorithms.
+ In fact, genericity allows users to write and experiment
+ virtually any method on any compatible input(s). In this
+ paper, we advocate the use of generic programming in the
+ design of image processing software, while preserving
+ performances close to dedicated code. The implementation of
+ our proposal, Milena, a generic and efficient library,
+ illustrates the benefits of our approach.},
+ keywords = {Genericity, Image Processing, Software Design,
+ Reusability, Efficiency}
+}
+
+@InProceedings{ levillain.10.wadgmm,
+ author = {Roland Levillain and {\relax Th}ierry G\'eraud and Laurent
+ Najman},
+ title = {Writing Reusable Digital Geometry Algorithms in a Generic
+ Image Processing Framework},
+ booktitle = {Proceedings of the Workshop on Applications of Digital
+ Geometry and Mathematical Morphology (WADGMM)},
+ pages = {96--100},
+ year = 2010,
+ address = {Istanbul, Turkey},
+ month = aug,
+ url = {http://mdigest.jrc.ec.europa.eu/wadgmm2010/},
+ project = {Olena},
+ urllrde = {201008-WADGMM},
+ abstract = {Digital Geometry software should reflect the generality of
+ the underlying mathematics: mapping the latter to the
+ former requires genericity. By designing generic solutions,
+ one can effectively reuse digital geometry data structures
+ and algorithms. We propose an image processing framework
+ centered on the Generic Programming paradigm in which an
+ algorithm on the paper can be turn into a single code,
+ written once and usable with various input types. This
+ approach enables users to design and implement new methods
+ at a lower cost, try cross-domain experiments and help
+ generalize results.},
+ keywords = {Generic Programming, Interface, Skeleton, Complex}
+}
+
+@InProceedings{ levillain.11.gretsi,
+ author = {Roland Levillain and {\relax Th}ierry G\'eraud and Laurent
+ Najman},
+ title = {Une approche g\'en\'erique du logiciel pour le traitement
+ d'images pr\'eservant les performances},
+ booktitle = {Proceedings of the 23rd Symposium on Signal and Image
+ Processing (GRETSI)},
+ category = {national},
+ year = 2011,
+ address = {Bordeaux, France},
+ month = sep,
+ note = {In French. Accepted},
+ project = {Olena},
+ urllrde = {201109-GRETSI},
+ abstract = {De plus en plus d'outils logiciels modernes pour le
+ traitement d'images sont con\,c{}us en prenant en compte le
+ probl\`eme de la g\'en\'ericit\'e du code, c'est-\`a-dire
+ la possibilit\'e d'\'ecrire des algorithmes
+ r\'eutilisables, compatibles avec de nombreux types
+ d'entr\'ees. Cependant, ce choix de conception se fait
+ souvent au d\'etriment des performances du code
+ ex\'ecut\'e. Du fait de la grande vari\'et\'e des types
+ d'images existants et de la n\'ecessit\'e d'avoir des
+ impl\'ementations rapides, g\'en\'ericit\'e et performance
+ apparaissent comme des qualit\'es essentielles du logiciel
+ en traitement d'images. Cet article pr\'esente une approche
+ pr\'eservant les performances dans un framework logiciel
+ g\'en\'erique tirant parti des caract\'eristiques des types
+ de donn\'ees utilis\'es. Gr\^ace \`a celles-ci, il est
+ possible d'\'ecrire des variantes d'algorithmes
+ g\'en\'eriques offrant un compromis entre g\'en\'ericit\'e
+ et performance. Ces alternatives sont capables de
+ pr\'eserver une partie des aspects g\'en\'eriques d'origine
+ tout en apportant des gains substantiels \`a l'ex\'ecution.
+ D'apr\`es nos essais, ces optimisations g\'en\'eriques
+ fournissent des performances supportant la comparaison avec
+ du code d\'edi\'e, allant parfois m\^eme jusqu'\`a surpasser des routines optimis\'ees manuellement.}
+}
diff --git a/milena/doc/Doxyfile.in b/milena/doc/Doxyfile.in
index c1b0bc6..7790ce6 100644
--- a/milena/doc/Doxyfile.in
+++ b/milena/doc/Doxyfile.in
@@ -122,7 +122,7 @@ INPUT_FILTER =
FILTER_PATTERNS =
FILTER_SOURCE_FILES = NO
INPUT_ENCODING = ISO-8859-1
-CITE_BIB_FILES = $top_srcdir$/doc/doc.bib
+CITE_BIB_FILES = @top_srcdir@/doc/doc.bib
#---------------------------------------------------------------------------
# configuration options related to source browsing
#---------------------------------------------------------------------------
@@ -149,7 +149,7 @@ HTML_FILE_EXTENSION = .html
HTML_HEADER = @top_srcdir@/doc/header.html
HTML_FOOTER = @top_srcdir@/doc/subdoc_footer.html
HTML_STYLESHEET = @top_srcdir@/doc/doxygen.css
-LAYOUT_FILE = @top_srcdir@/doc/DoxygenLayout.xml
+LAYOUT_FILE = @top_srcdir@/milena/doc/DoxygenLayout.xml
HTML_ALIGN_MEMBERS = YES
GENERATE_HTMLHELP = NO
CHM_FILE =
diff --git a/milena/doc/Makefile.am b/milena/doc/Makefile.am
index 2132c7e..99dd4c6 100644
--- a/milena/doc/Makefile.am
+++ b/milena/doc/Makefile.am
@@ -739,11 +739,11 @@ DATA_html_dirs_inst = $(WHITE_PAPER)
# .../srcdoc", which installs our dir into the previous one, instead
# of replacing it.
install-data-local:
- $(mkdir_p) $(DESTDIR)$(htmldir)
+ $(mkdir_p) $(DESTDIR)$(htmldir)/$(USER_REFMAN)
# The user reference manual is located in a subdirectory, hence this
# special case.
- rm -rf $(DESTDIR)$(htmldir)/$(USER_REFMAN)
- cp -r $(srcdir)/$(USER_REFMAN)/html $(DESTDIR)$(htmldir)/$(USER_REFMAN)
+ rm -rf $(DESTDIR)$(htmldir)/$(USER_REFMAN)/milena
+ cp -r $(srcdir)/$(USER_REFMAN)/html $(DESTDIR)$(htmldir)/$(USER_REFMAN)/milena
# Other HTML directories can be processed uniformly.
for d in $(DATA_html_dirs_inst); do \
rm -rf $(DESTDIR)$(htmldir)/$$d; \
@@ -762,5 +762,5 @@ uninstall-local:
done
# Same remark as above regarding the special case of the user
# reference manual.
- chmod -R 700 $(DESTDIR)$(htmldir)/$(USER_REFMAN)
- rm -rf $(DESTDIR)$(htmldir)/$(USER_REFMAN)
+ chmod -R 700 $(DESTDIR)$(htmldir)/$(USER_REFMAN)/milena
+ rm -rf $(DESTDIR)$(htmldir)/$(USER_REFMAN)/milena
diff --git a/milena/mln/registration/icp.hh b/milena/mln/registration/icp.hh
index 9448a2f..4c3bd51 100644
--- a/milena/mln/registration/icp.hh
+++ b/milena/mln/registration/icp.hh
@@ -107,6 +107,8 @@ namespace mln
*
* \pre \p P_ and \p X must not be empty.
*
+ * \cite besl.92.pami
+ *
* Reference article: "A Method for Registration of 3-D Shapes", Paul J.
* Besl and Neil D. McKay, IEEE, 2, February 1992.
*
diff --git a/scribo/Makefile.am b/scribo/Makefile.am
index b9a590a..cf8a4c6 100644
--- a/scribo/Makefile.am
+++ b/scribo/Makefile.am
@@ -15,7 +15,7 @@
# You should have received a copy of the GNU General Public License
# along with Olena. If not, see <http://www.gnu.org/licenses/>.
-SUBDIRS = demo tests src
+SUBDIRS = demo doc tests src
.PHONY: bin
diff --git a/scribo/doc/Makefile.am b/scribo/doc/Makefile.am
index f1fae6c..6469ab9 100644
--- a/scribo/doc/Makefile.am
+++ b/scribo/doc/Makefile.am
@@ -223,11 +223,16 @@ maintainer-clean-local:
# .../srcdoc", which installs our dir into the previous one, instead
# of replacing it.
install-data-local:
- $(mkdir_p) $(DESTDIR)$(htmldir)
+ $(mkdir_p) $(DESTDIR)$(htmldir)/$(USER_REFMAN)
# The user reference manual is located in a subdirectory, hence this
# special case.
- rm -rf $(DESTDIR)$(htmldir)/$(USER_REFMAN)
- cp -r $(srcdir)/$(USER_REFMAN)/html $(DESTDIR)$(htmldir)/$(USER_REFMAN)
+ rm -rf $(DESTDIR)$(htmldir)/$(USER_REFMAN)/scribo
+ cp -r $(srcdir)/$(USER_REFMAN)/html \
+ $(DESTDIR)$(htmldir)/$(USER_REFMAN)/scribo
+# Update paths to milena documentation directory
+ $(DESTDIR)$(htmldir)/$(USER_REFMAN)/scribo/installdox \
+ -l milena.tag@$(DESTDIR)$(htmldir)/$(USER_REFMAN)/milena \
+ `find $(DESTDIR)$(htmldir)/$(USER_REFMAN)/scribo/ -name '*.html'`
# Other HTML directories can be processed uniformly.
for d in $(DATA_html_dirs_inst); do \
rm -rf $(DESTDIR)$(htmldir)/$$d; \
@@ -246,5 +251,5 @@ uninstall-local:
done
# Same remark as above regarding the special case of the user
# reference manual.
- chmod -R 700 $(DESTDIR)$(htmldir)/$(USER_REFMAN)
- rm -rf $(DESTDIR)$(htmldir)/$(USER_REFMAN)
+ chmod -R 700 $(DESTDIR)$(htmldir)/$(USER_REFMAN)/scribo
+ rm -rf $(DESTDIR)$(htmldir)/$(USER_REFMAN)/scribo
--
1.7.2.5
1
0