<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<html xmlns:o="urn:schemas-microsoft-com:office:office"
xmlns:w="urn:schemas-microsoft-com:office:word"
xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv=Content-Type content="text/html; charset=windows-1252">
<meta name=ProgId content=Word.Document>
<meta name=Generator content="Microsoft Word 9">
<meta name=Originator content="Microsoft Word 9">
<link rel=File-List href="./default_files/filelist.xml">
<title>Building Mapserver on Windows 2000 Professional</title>
<style>
<!--
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{mso-style-parent:"";
margin:0in;
margin-bottom:.0001pt;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";
color:black;}
h1
{margin-right:0in;
mso-margin-top-alt:auto;
mso-margin-bottom-alt:auto;
margin-left:0in;
mso-pagination:widow-orphan;
mso-outline-level:1;
font-size:24.0pt;
font-family:"Times New Roman";
color:black;
mso-font-kerning:18.0pt;
font-weight:bold;}
h2
{mso-style-next:Normal;
margin-top:12.0pt;
margin-right:0in;
margin-bottom:3.0pt;
margin-left:0in;
mso-pagination:widow-orphan;
page-break-after:avoid;
mso-outline-level:2;
font-size:14.0pt;
font-family:Arial;
color:black;
font-weight:bold;
font-style:italic;}
h3
{margin-right:0in;
mso-margin-top-alt:auto;
mso-margin-bottom-alt:auto;
margin-left:0in;
mso-pagination:widow-orphan;
mso-outline-level:3;
font-size:13.5pt;
font-family:"Times New Roman";
color:black;
font-weight:bold;}
h4
{mso-style-next:Normal;
margin-right:0in;
mso-margin-top-alt:auto;
mso-margin-bottom-alt:auto;
margin-left:0in;
text-indent:.5in;
mso-pagination:widow-orphan;
page-break-after:avoid;
mso-outline-level:4;
font-size:12.0pt;
font-family:"Times New Roman";
color:red;
font-weight:normal;
text-decoration:underline;
text-underline:single;}
h5
{margin-right:0in;
mso-margin-top-alt:auto;
mso-margin-bottom-alt:auto;
margin-left:0in;
mso-pagination:widow-orphan;
mso-outline-level:5;
font-size:10.0pt;
font-family:"Times New Roman";
color:black;
font-weight:bold;}
p.MsoBodyTextIndent, li.MsoBodyTextIndent, div.MsoBodyTextIndent
{margin-right:0in;
mso-margin-top-alt:auto;
mso-margin-bottom-alt:auto;
margin-left:1.0in;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";
color:black;}
p.MsoBodyTextIndent2, li.MsoBodyTextIndent2, div.MsoBodyTextIndent2
{margin-right:0in;
mso-margin-top-alt:auto;
mso-margin-bottom-alt:auto;
margin-left:.5in;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Courier New";
mso-fareast-font-family:"Times New Roman";
color:black;}
p.MsoBodyTextIndent3, li.MsoBodyTextIndent3, div.MsoBodyTextIndent3
{margin-right:0in;
mso-margin-top-alt:auto;
mso-margin-bottom-alt:auto;
margin-left:2.0in;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Courier New";
mso-fareast-font-family:"Times New Roman";
color:black;}
a:link, span.MsoHyperlink
{color:blue;
text-decoration:underline;
text-underline:single;}
a:visited, span.MsoHyperlinkFollowed
{color:purple;
text-decoration:underline;
text-underline:single;}
p
{margin-right:0in;
mso-margin-top-alt:auto;
mso-margin-bottom-alt:auto;
margin-left:0in;
mso-pagination:widow-orphan;
font-size:12.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";
color:black;}
@page Section1
{size:8.5in 11.0in;
margin:1.0in 1.25in 1.0in 1.25in;
mso-header-margin:.5in;
mso-footer-margin:.5in;
mso-paper-source:0;}
div.Section1
{page:Section1;}
/* List Definitions */
@list l0
{mso-list-id:244653890;
mso-list-type:hybrid;
mso-list-template-ids:-632159582 -1945216774 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l0:level1
{mso-level-start-at:0;
mso-level-number-format:bullet;
mso-level-text:-;
mso-level-tab-stop:90.6pt;
mso-level-number-position:left;
margin-left:90.6pt;
text-indent:-18.6pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
@list l1
{mso-list-id:617295798;
mso-list-type:hybrid;
mso-list-template-ids:1199055508 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l1:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:.75in;
mso-level-number-position:left;
margin-left:.75in;
text-indent:-.25in;
font-family:Symbol;}
@list l2
{mso-list-id:684553769;
mso-list-type:hybrid;
mso-list-template-ids:1660826886 -1453924570 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l2:level1
{mso-level-tab-stop:37.8pt;
mso-level-number-position:left;
margin-left:37.8pt;
text-indent:-19.8pt;}
@list l3
{mso-list-id:851072441;
mso-list-type:hybrid;
mso-list-template-ids:-861110950 -1945216774 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l3:level1
{mso-level-start-at:0;
mso-level-number-format:bullet;
mso-level-text:-;
mso-level-tab-stop:90.6pt;
mso-level-number-position:left;
margin-left:90.6pt;
text-indent:-18.6pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
@list l4
{mso-list-id:878976176;
mso-list-type:hybrid;
mso-list-template-ids:-1498408904 -1945216774 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l4:level1
{mso-level-start-at:0;
mso-level-number-format:bullet;
mso-level-text:-;
mso-level-tab-stop:90.6pt;
mso-level-number-position:left;
margin-left:90.6pt;
text-indent:-18.6pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
@list l4:level2
{mso-level-number-format:bullet;
mso-level-text:o;
mso-level-tab-stop:1.5in;
mso-level-number-position:left;
margin-left:1.5in;
text-indent:-.25in;
font-family:"Courier New";
mso-bidi-font-family:"Times New Roman";}
@list l5
{mso-list-id:895121582;
mso-list-type:hybrid;
mso-list-template-ids:-196601694 -1945216774 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l5:level1
{mso-level-start-at:0;
mso-level-number-format:bullet;
mso-level-text:-;
mso-level-tab-stop:90.6pt;
mso-level-number-position:left;
margin-left:90.6pt;
text-indent:-18.6pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
@list l6
{mso-list-id:1015183965;
mso-list-type:hybrid;
mso-list-template-ids:1287020686 67698689 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l6:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
margin-left:1.0in;
text-indent:-.25in;
font-family:Symbol;}
@list l7
{mso-list-id:1021204738;
mso-list-type:hybrid;
mso-list-template-ids:-912074850 -1945216774 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l7:level1
{mso-level-start-at:0;
mso-level-number-format:bullet;
mso-level-text:-;
mso-level-tab-stop:90.6pt;
mso-level-number-position:left;
margin-left:90.6pt;
text-indent:-18.6pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
@list l8
{mso-list-id:1040201633;
mso-list-type:hybrid;
mso-list-template-ids:-1312242734 -1945216774 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l8:level1
{mso-level-start-at:0;
mso-level-number-format:bullet;
mso-level-text:-;
mso-level-tab-stop:90.6pt;
mso-level-number-position:left;
margin-left:90.6pt;
text-indent:-18.6pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
@list l9
{mso-list-id:1396122113;
mso-list-type:hybrid;
mso-list-template-ids:1981342504 67698703 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l9:level2
{mso-level-number-format:alpha-lower;
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
text-indent:-.25in;}
@list l10
{mso-list-id:1441799138;
mso-list-type:hybrid;
mso-list-template-ids:834194618 -1945216774 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l10:level1
{mso-level-start-at:0;
mso-level-number-format:bullet;
mso-level-text:-;
mso-level-tab-stop:90.6pt;
mso-level-number-position:left;
margin-left:90.6pt;
text-indent:-18.6pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
@list l11
{mso-list-id:1658804234;
mso-list-type:hybrid;
mso-list-template-ids:2005321994 -1945216774 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l11:level1
{mso-level-start-at:0;
mso-level-number-format:bullet;
mso-level-text:-;
mso-level-tab-stop:90.6pt;
mso-level-number-position:left;
margin-left:90.6pt;
text-indent:-18.6pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
@list l12
{mso-list-id:1703088520;
mso-list-type:hybrid;
mso-list-template-ids:1606324824 -1945216774 67698691 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l12:level1
{mso-level-start-at:0;
mso-level-number-format:bullet;
mso-level-text:-;
mso-level-tab-stop:90.6pt;
mso-level-number-position:left;
margin-left:90.6pt;
text-indent:-18.6pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
@list l13
{mso-list-id:1780485405;
mso-list-type:hybrid;
mso-list-template-ids:2094146056 67698689 300819282 67698693 67698689 67698691 67698693 67698689 67698691 67698693;}
@list l13:level1
{mso-level-number-format:bullet;
mso-level-text:\F0B7;
mso-level-tab-stop:1.0in;
mso-level-number-position:left;
margin-left:1.0in;
text-indent:-.25in;
font-family:Symbol;}
@list l13:level2
{mso-level-start-at:0;
mso-level-number-format:bullet;
mso-level-text:-;
mso-level-tab-stop:108.6pt;
mso-level-number-position:left;
margin-left:108.6pt;
text-indent:-18.6pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
@list l14
{mso-list-id:1852794568;
mso-list-type:hybrid;
mso-list-template-ids:-1916083746 -1126150300 67698713 67698715 67698703 67698713 67698715 67698703 67698713 67698715;}
@list l14:level1
{mso-level-tab-stop:.75in;
mso-level-number-position:left;
margin-left:.75in;
text-indent:-.25in;}
ol
{margin-bottom:0in;}
ul
{margin-bottom:0in;}
-->
</style>
<meta name=CREATED content="20030430;16022959">
<meta name=CHANGED content="20030430;16033915">
<!--[if gte mso 9]><xml>
<u1:DocumentProperties>
<u1:Author>Geoanalytic Inc.</u1:Author>
<u1:LastAuthor>Geoanalytic Inc.</u1:LastAuthor>
<u1:Revision>29</u1:Revision>
<u1:TotalTime>4370</u1:TotalTime>
<u1:Created>2003-02-19T16:30:00Z</u1:Created>
<u1:LastSaved>2003-04-30T16:29:00Z</u1:LastSaved>
<u1:Pages>6</u1:Pages>
<u1:Words>1624</u1:Words>
<u1:Characters>9258</u1:Characters>
<u1:Company>GeoAnalytic Inc.</u1:Company>
<u1:Lines>77</u1:Lines>
<u1:Paragraphs>18</u1:Paragraphs>
<u1:CharactersWithSpaces>11369</u1:CharactersWithSpaces>
<u1:Version>9.2720</u1:Version>
</u1:DocumentProperties>
</xml><![endif]--><!--[if gte mso 9]><xml>
<u2:WordDocument>
<u2:DisplayHorizontalDrawingGridEvery>0</u2:DisplayHorizontalDrawingGridEvery>
<u2:DisplayVerticalDrawingGridEvery>0</u2:DisplayVerticalDrawingGridEvery>
<u2:UseMarginsForDrawingGridOrigin/>
<u2:Compatibility>
<u2:FootnoteLayoutLikeWW8/>
<u2:ShapeLayoutLikeWW8/>
<u2:AlignTablesRowByRow/>
<u2:ForgetLastTabAlignment/>
<u2:LayoutRawTableWidth/>
<u2:LayoutTableRowsApart/>
</u2:Compatibility>
</u2:WordDocument>
</xml><![endif]--><!--[if gte mso 9]><xml>
<u3:shapedefaults u4:ext="edit" spidmax="1027"/>
</xml><![endif]--><!--[if gte mso 9]><xml>
<u5:shapelayout u6:ext="edit">
<u5:idmap u6:ext="edit" data="1"/>
</u5:shapelayout>
</xml><![endif]-->
</head>
<body lang=EN-US link=blue vlink=purple style='tab-interval:.5in'>
<div class=Section1>
<p class=MsoNormal align=center style='mso-margin-top-alt:auto;mso-margin-bottom-alt:
auto;text-align:center'><b><span style='font-size:16.0pt'>An Introduction to
Building Mapserver on Windows 2000 Professional</span></b></p>
<p class=MsoNormal align=center style='mso-margin-top-alt:auto;mso-margin-bottom-alt:
auto;text-align:center'><b><span style='font-size:16.0pt'>August 6, 2003<o:p></o:p></span></b></p>
<p class=MsoNormal align=center style='mso-margin-top-alt:auto;mso-margin-bottom-alt:
auto;text-align:center'><b><span style='font-size:16.0pt'>(updated Oct 1, 2003)</span></b></p>
<p class=MsoNormal align=center style='mso-margin-top-alt:auto;mso-margin-bottom-alt:
auto;text-align:center'><b><span style='font-size:16.0pt'>Brent Fraser</span></b></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<h1><span style='font-size:16.0pt'>What is MapServer?</span></h1>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
Mapserver is a web mapping tool.</p>
<h1><span style='font-size:16.0pt'>How do I install it?</span></h1>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
Set up IIS on your Windows server, put the mapserv.exe in the cgi-bin
directory, build a mapserver-compliant web site.</p>
<h1><span style='font-size:16.0pt'>Why compile it?</span></h1>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in;text-indent:-.25in;mso-list:l13 level1 lfo2;tab-stops:list 1.0in'><![if !supportLists]><span
style='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span><![endif]>debug it to track down problems</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in;text-indent:-.25in;mso-list:l13 level1 lfo2;tab-stops:list 1.0in'><![if !supportLists]><span
style='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span><![endif]>debug it to find out what it’s doing (compensate for
lacking documentation!)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in;text-indent:-.25in;mso-list:l13 level1 lfo2;tab-stops:list 1.0in'><![if !supportLists]><span
style='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span><![endif]>add features (standard options and possibly your own
code)</p>
<h1><span style='font-size:16.0pt'>What do I need?</span></h1>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in;text-indent:-.25in;mso-list:l6 level1 lfo4;tab-stops:list 1.0in'><![if !supportLists]><span
style='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span><![endif]>access to the Internet to download source code (and a
couple of tools)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in;text-indent:-.25in;mso-list:l6 level1 lfo4;tab-stops:list 1.0in'><![if !supportLists]><span
style='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span><![endif]>Microsoft’s Visual C++ compiler</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in;text-indent:-.25in;mso-list:l6 level1 lfo4;tab-stops:list 1.0in'><![if !supportLists]><span
style='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span><![endif]>knowledge of how to create projects in VC++</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in;text-indent:-.25in;mso-list:l6 level1 lfo4;tab-stops:list 1.0in'><![if !supportLists]><span
style='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span><![endif]>knowledge of how to use the Windows Command Prompt</p>
<p> </p>
<h1><span style='font-size:16.0pt'>1.<span style="mso-spacerun: yes">
</span>Build enviroment Choices</span></h1>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
Mapserver is written almost entirely in ANSI C. It has been compiled on
Win95, 98, 2000, XP, ME, XP, MacOS, Linux, Sun Unix, and likely other operating
systems.</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
To build Mapserver on Windows you will need <b><u>either</u></b>:</p>
<p>
Visual
Studio: nmake,
VC++
(covered in this document)</p>
<p>
Flex and
Bison parser tools (<a
href="http://www.monmouth.com/~wstreett/lex-yacc/lex-yacc.html">http://www.monmouth.com/~wstreett/lex-yacc/lex-yacc.html</a>)
(covered in this document)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
<b><u>or<o:p></o:p></u></b></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
cygwin, gnu
c
compiler
(<b><u>NOT</u></b> covered in this document)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<h1><span style='font-size:16.0pt'>2. Dependancies</span></h1>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
<b><u>Required</u></b><u> Source Code:</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
Mapserver 4.0 2003-08-01 (or greater) <a
href="http://mapserver.gis.umn.edu/dload.html">http://mapserver.gis.umn.edu/dload.html</a>
</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
Regex <span
style="mso-spacerun: yes"> </span> <a
href="ftp://ftp.gnu.org/pub/gnu/regex/regex-0.12.tar.gz">ftp://ftp.gnu.org/pub/gnu/regex/regex-0.12.tar.gz</a></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
- regular
expresssion parser</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
GD 2.0.15 (or
greater)
<a href="http://www.boutell.com/gd/">http://www.boutell.com/gd/</a></p>
<p>
- graphics draw library</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
<b><u>Recommended</u></b><u> Source Code:</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
Proj 4.4.7 (or
greater)
<a href="http://www.remotesensing.org/proj/">http://www.remotesensing.org/proj/</a></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
- map projections</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
FreeType 2.1.4 (or
greater)
<a href="http://sourceforge.net/project/showfiles.php?group_id=3157">http://sourceforge.net/project/showfiles.php?group_id=3157</a></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
- vector font rendering (rotation, scaling)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
GDAL 1.1.9 (or
greater)
<a href="http://www.remotesensing.org/gdal/index.html">http://www.remotesensing.org/gdal/index.html</a></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>24-bit rendering</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>raster re-projection</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>lots of additional input formats<u><o:p></o:p></u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
<u>Optional Libraries:</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
ECW libraries</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
- adds reading of ECW compressed imagery</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
PostgreSQL database application</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
- adds reading of spatial data from a relational database</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
<u>Mapserver Options Not Covered Here:</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><span
style='mso-tab-count:1'> </span>WFS Client and Server<span
style='mso-tab-count:1'> </span>- OGIS Web Feature Service (send
vectors to the client)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><span
style='mso-tab-count:1'> </span>WMS Client<span style='mso-tab-count:
3'> </span>- OGIS Web Mapping Service Client
(request maps from other servers)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
SDE
- ESRI spatial-enabled data store</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
MING_Flash -
output format</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
EPPL7
- image processing</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
OracleSpatial -
relational data store</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
MapScript (PHP) -
server-side scripting</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<h1><span style='font-size:16.0pt'>3. Filesystem Organization</span></h1>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
The following is my recommended organization of the libraries, but it is not
required:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
..\ MapServer </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
20030801
(MapServer release date or nightly build date)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'>\ freetype-2.1.4</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'>\ gd-2.0.15</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='mso-tab-count:1'> </span>\ gd</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'>\ gdal-1.1.9</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'>\ mapserver-4.0</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='mso-tab-count:1'> </span>\ mapserver
(library)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='mso-tab-count:1'> </span>\ mapserv
(exe)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'>\ proj-4.4.7</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'>\ regex-0.12</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='mso-tab-count:1'> </span>\ regex</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
There are other ways to organize the code but this method:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:.75in;text-indent:-.25in;mso-list:l1 level1 lfo8;tab-stops:list .75in'><![if !supportLists]><span
style='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span><![endif]>supports multiple nightly builds in development
computer</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:.75in;text-indent:-.25in;mso-list:l1 level1 lfo8;tab-stops:list .75in'><![if !supportLists]><span
style='font-family:Symbol'>·<span style='font:7.0pt "Times New Roman"'>
</span></span><![endif]>allows you to reliably upgrade to new versions of
source code (but it can waste disk space since the dependancies may be
duplicated.)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<h1><span style='font-size:16.0pt'>4. Building From the Ground Up</span></h1>
<h2> The preliminaries</h2>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:37.8pt;text-indent:-19.8pt;mso-list:l2 level1 lfo10;tab-stops:list 37.8pt'><![if !supportLists]>1.<span
style='font:7.0pt "Times New Roman"'> </span><![endif]>Install
VC++ 6.0 (or Visual Studio with VC++ 6.0) on your software development
computer. Make sure the VC98\bin directory is in your path so you can run
nmake from the command line.</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:37.8pt;text-indent:-19.8pt;mso-list:l2 level1 lfo10;tab-stops:list 37.8pt'><![if !supportLists]>2.<span
style='font:7.0pt "Times New Roman"'> </span><![endif]>Create
a directory called “MapServer”. It can be a subdirectory anywhere on your
development computer. This is optional.</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:37.8pt;text-indent:-19.8pt;mso-list:l2 level1 lfo10;tab-stops:list 37.8pt'><![if !supportLists]>3.<span
style='font:7.0pt "Times New Roman"'> </span><![endif]>Create
a sub-directory called “20030801”. The name corresponds to the date of
the Mapserver nightly build or release date. This is not a requirement,
but it is useful in separating MapServer’s source code snapshots if you intend
to build pre-release source code.</p>
<h2>Building the dependencies</h2>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>1.<span
style='font-size:7.5pt'> </span><u>Building
"proj"</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l11 level1 lfo12;tab-stops:
list 90.6pt'><![if !supportLists]>-<span style='font:7.0pt "Times New Roman"'>
</span><![endif]>download (<a href="http://www.remotesensing.org/proj/">http://www.remotesensing.org/proj/</a>)
into your “nightly build” (eg 20030801) dir and unpack</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l11 level1 lfo12;tab-stops:
list 90.6pt'><![if !supportLists]>-<span style='font:7.0pt "Times New Roman"'>
</span><![endif]>in the src directory, change PVALUE to PJ_VALUE in:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'>src\projects.h (line 162, line 348)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'>src\pj_param.c (line 39, line 43)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>edit src\makefile.vc to enable debug build.<span
style="mso-spacerun: yes"> </span>Comment out line 11, Uncomment line 12:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>#OPTFLAGS=<span
style='mso-tab-count:1'> </span>/nologo /Ox /ML<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>OPTFLAGS=<span
style='mso-tab-count:1'> </span>/nologo /Zi /Fdproj.pdb</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>from the command line, execute the following:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>cd proj-4.4.5\src</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>vcvars32</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>nmake /f makefile.vc
all</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>2.<span
style='font-size:7.5pt'> </span><u>Building
“gdal”</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>download (<a
href="http://www.remotesensing.org/gdal/index.html">http://www.remotesensing.org/gdal/index.html</a>)
and unpack</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>edit the nmake.opt file to enable debug build.<span
style="mso-spacerun: yes"> </span>Comment out line 11, Uncomment line 12:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in;text-indent:.5in'><span style='font-family:"Courier New"'>#OPTFLAGS=<span
style='mso-tab-count:1'> </span>/nologo /Ox /ML<o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.5in'><span style='font-family:"Courier New"'>OPTFLAGS=<span
style='mso-tab-count:1'> </span>/nologo /Zi /Fd$(GDAL_ROOT)\gdal.pdb<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>GDAL 1.1.9 requires a change in the nmake.opt to change the
reference from “core” to “gcore” (Frank is aware of this and it will be fixed
in the next release):</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>INC<span
style='mso-tab-count:1'> </span>=<span style='mso-tab-count:1'> </span>-I$(GDAL_ROOT)\port
-I$(GDAL_ROOT)\ogr -I$(GDAL_ROOT)\core<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>INC<span
style='mso-tab-count:1'> </span>=<span style='mso-tab-count:1'> </span>-I$(GDAL_ROOT)\port
-I$(GDAL_ROOT)\ogr -I$(GDAL_ROOT)\gcore<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>from the command line:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>cd gdal-1.1.9</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>nmake /f makefile.vc</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>3.<span
style='font-size:7.5pt'> </span><u>Building
“freetype”</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>download (<a
href="http://sourceforge.net/project/showfiles.php?group_id=3157">http://sourceforge.net/project/showfiles.php?group_id=3157</a>)
(look under freetype2 for something that looks like <span style='font-family:
"Courier New"'>ft214.zip</span>) and unpack.</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>use the FreeType supplied VC++ workspace file in <span
style='font-family:"Courier New"'>builds\win32\visualc</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>build the library</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>4.<span
style='font-size:7.5pt'> </span><u>Building
“regex”</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l0 level1 lfo14;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>download (<a
href="ftp://ftp.gnu.org/pub/gnu/regex/regex-0.12.tar.gz">ftp://ftp.gnu.org/pub/gnu/regex/regex-0.12.tar.gz</a>)
and unpack.</p>
<p class=MsoNormal style='margin-left:90.6pt;text-indent:-18.6pt;mso-list:l0 level1 lfo14;
tab-stops:list 90.6pt'><![if !supportLists]>-<span style='font:7.0pt "Times New Roman"'>
</span><![endif]>create a VC++ Win32 static library project “regex” in the regex-0.12
directory</p>
<p class=MsoNormal style='margin-left:90.6pt;text-indent:-18.6pt;mso-list:l0 level1 lfo14;
tab-stops:list 90.6pt'><![if !supportLists]>-<span style='font:7.0pt "Times New Roman"'>
</span><![endif]>add <span style='font-family:"Courier New"'>regex.c</span> to
project (right click the project name in the file view panel, the select Add
Files to Project)</p>
<p class=MsoNormal style='margin-left:90.6pt;text-indent:-18.6pt;mso-list:l0 level1 lfo14;
tab-stops:list 90.6pt'><![if !supportLists]>-<span style='font:7.0pt "Times New Roman"'>
</span><![endif]>under Project -> Settings -> C/C++ -> Category:
Preprocessor, add Preprocessor Definitions: </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>,HAVE_STRING_H,REGEX_MALLOC</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l3 level1 lfo16;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>build the library</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <span
style='mso-tab-count:2'> </span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>5.<span
style='font-size:7.5pt'> </span><u>Building “gd”</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>download (<a href="http://www.boutell.com/gd/">http://www.boutell.com/gd/</a>)
(select “Download .zip”) and unpack.</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>create a VC++ Win32 static library project called “gd” in the
gd-2.0.15 directory</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>add the files specified below to the project.<span
style="mso-spacerun: yes"> </span>Select the File View tab in VC++, right
click on “gd files” and select “add Files to Project” from the pop-up
menu.<span style="mso-spacerun: yes"> </span>Go up a directory to the gd-2.0.15
directory. Cut and paste the line below into the “file name:” text box in the
open file dialog:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>"wbmp.c"
"gd.c" "gd_gd.c" "gd_gd2.c" "gd_io.c"
"gd_io_dp.c" "gd_io_file.c" "gd_io_ss.c"
"gd_jpeg.c" "gd_png.c" "gd_ss.c"
"gd_topal.c" "gd_wbmp.c" "gdcache.c"
"gdfontg.c" "gdfontl.c" "gdfontmb.c"
"gdfonts.c" "gdfontt.c" "gdft.c" "gdhelpers.c"
"gdkanji.c" "gdtables.c" "gdxpm.c" <o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>set preprocessor definitions: </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>,HAVE_LIBPNG,HAVE_LIBZ,HAVE_LIBFREETYPE,HAVE_LIBJPEG</span></p>
<p class=MsoBodyTextIndent style='margin-left:90.6pt;text-indent:-18.6pt;
mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>set additional include directories:</p>
<p class=MsoBodyTextIndent style='margin-left:1.5in'><span style='font-family:
"Courier New"'>,..\,..\..\gdal-1.1.9\frmts\zlib,..\..\gdal-1.1.9\frmts\png\libpng,
..\..\gdal-1.1.9\frmts\jpeg\libjpeg, ..\..\freetype-2.1.4\include<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>build the library</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <span
style='color:red'>NOTE:<span style="mso-spacerun: yes"> </span>There is now an
“nmake.opt” file delivered with Mapserver to deal with a lot of the details
covered below.<span style="mso-spacerun: yes"> </span>This is the preferred method
of building Mapserver, but if you are having trouble with it, follow steps 6
and 7 below:<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>6.<span
style='font-size:7.5pt'> </span><u>Building
the mapserver library</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>download mapserver-4.0.tar.gz from <a
href="http://mapserver.gis.umn.edu/dload.html">http://mapserver.gis.umn.edu/dload.html</a>
and save in your <span style='font-family:"Courier New"'>20030801</span>
directory.</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>unpack all files from tar file to create a <span
style='font-family:"Courier New"'>mapserver-4.0</span> directory within your <span
style='font-family:"Courier New"'>20030801</span> directory.</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l10 level1 lfo6;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>download <span style='font-family:"Courier New"'>flex.exe</span>,
<span style='font-family:"Courier New"'>bison.exe</span>, and <span
style='font-family:"Courier New"'>bison.simple</span> (<a
href="http://www.monmouth.com/~wstreett/lex-yacc/lex-yacc.html">http://www.monmouth.com/~wstreett/lex-yacc/lex-yacc.html</a>)
into the <span style='font-family:"Courier New"'>mapserver-4.0</span>
directory.<span style="mso-spacerun: yes"> </span>Using a text editor, create <span
style='font-family:"Courier New"'>parser.bat</span>:</p>
<p class=MsoNormal style='margin-left:1.0in;text-indent:.5in'><span
style='font-family:"Courier New"'>flex.exe -Pmsyy -i -omaplexer.c maplexer.l<o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.0in;text-indent:.5in'><span
style='font-family:"Courier New"'>bison.exe -p msyy -d -omapparser.c
mapparser.y<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l5 level1 lfo18;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>run <span style='font-family:"Courier New"'>parser.bat</span>
once to create mapparser.h.</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l5 level1 lfo18;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>create a VC++ static library workspace named “mapserver” in
the <span style='font-family:"Courier New"'>mapserver-4.0</span> directory
(VC++ will create a <span style='font-family:"Courier New"'>mapserver</span>
sub-dir)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l5 level1 lfo18;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>add <span style='font-family:"Courier New"'>cgiutil.c</span>
and all the <span style='font-family:"Courier New"'>map*.c</span> (<b><u>except</u></b><u>
</u><span style='font-family:"Courier New"'>mapserv.c</span><b> and </b><span
style='font-family:"Courier New"'>mapserv_fcgi.c</span>) files to the project</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l5 level1 lfo18;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>add the following preprocessor definitions:</p>
<p class=MsoNormal style='margin-left:1.5in'><span style='font-family:"Courier New"'>,USE_GDAL,
USE_TTF, USE_PROJ, NEED_STRNCASECMP, NEED_STRCASECMP, USE_GD_FT, USE_GD_PNG,
USE_GD_JPEG, IGNORE_MISSING_DATA, USE_OGR, USE_TIFF, USE_JPEG, HAVE_BOOLEAN<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l8 level1 lfo20;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>add the following Additional Include directories:</p>
<p class=MsoBodyTextIndent style='margin-left:1.5in'><span style='font-family:
"Courier New"'>..\..\gdal-1.1.9\gcore,..\..\gdal-1.1.9\port,..\..\gdal-1.1.9\alg,..\..\gdal-1.1.9\ogr,..\..\gdal-1.1.9\ogr\ogrsf_frmts,..\..\gdal-1.1.9\frmts\jpeg\libjpeg,..\..\gdal-1.1.9\frmts\gtiff\libtiff,..\..\gd-2.0.15,..\..\regex-0.12,..\..\proj-4.4.7\src<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l8 level1 lfo20;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]><b><span style='font-size:14.0pt;mso-bidi-font-size:12.0pt'>compile
to mapserver.lib</span></b></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>7.<span
style='font-size:7.5pt'> </span><u>Building the
mapserver executable</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l8 level1 lfo20;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>create console application called mapserv in the <span
style='font-family:"Courier New"'>mapserver-4.0</span> directory</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l8 level1 lfo20;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>add <span style='font-family:"Courier New"'>mapserv.c</span>
to the project</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l8 level1 lfo20;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>add the following <u>Preprocessor definitions</u>:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'>
<span style='font-family:"Courier New"'>,USE_PROJ,USE_WMS_SVR<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l4 level1 lfo22;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>add <u>Additional include dirs:<o:p></o:p></u></p>
<p class=MsoBodyTextIndent style='margin-left:1.5in'><span style='font-family:
"Courier New"'>..\..\gd-2.0.15,..\..\regex-0.12,..\..\proj-4.4.7\src<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l4 level1 lfo22;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>add <u>additional Object/library modules:</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><i>Debug version</i>:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>..\mapserver\debug\mapserver.lib
..\..\regex-0.12\regex\debug\regex.lib ..\..\proj-4.4.7\src\proj.lib ..\..\gd-2.0.15\gd\debug\gd.lib
..\..\gdal-1.1.9\gdal.lib ..\..\freetype-2.1.4\objs\freetype214ST_D.lib<o:p></o:p></span></p>
<p style='margin-left:1.5in'><i>Release version</i>:</p>
<p style='margin-left:1.5in'><span style='font-family:"Courier New"'>..\mapserver\release\mapserver.lib
..\..\regex-0.12\regex\release\regex.lib ..\..\proj-4.4.7\src\proj.lib
..\..\gd-2.0.15\gd\release\gd.lib ..\..\gdal-1.1.9\gdal.lib
..\..\freetype-2.1.4\objs\freetype214.lib<br style='mso-special-character:line-break'>
<![if !supportLineBreakNewLine]><br style='mso-special-character:line-break'>
<![endif]><o:p></o:p></span></p>
<p style='margin-left:90.6pt;text-indent:-18.6pt;mso-list:l8 level1 lfo20;
tab-stops:list 90.6pt'><![if !supportLists]><span style='font-size:14.0pt;
mso-bidi-font-size:12.0pt'>-<span style='font:7.0pt "Times New Roman"'>
</span></span><![endif]><b><span style='font-size:14.0pt;mso-bidi-font-size:
12.0pt'>compile to mapserv.exe</span></b><span style='font-size:14.0pt;
mso-bidi-font-size:12.0pt'><o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;page-break-before:always;mso-list:l12 level1 lfo24;
tab-stops:list 90.6pt'><![if !supportLists]>-<span style='font:7.0pt "Times New Roman"'>
</span><![endif]><u>Test</u> your mapserv.exe by opening a command prompt
window, cd to it’s location, and execute it with the “-v” option:</p>
<p style='margin-left:.5in;text-indent:.5in'><span style='font-family:"Courier New"'>cd
C:\Development\MapServer\20030428\mapserver_dev\mapserv<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:.5in;text-indent:.5in'><span style='font-family:"Courier New"'>mapserv
–v</span></p>
<p class=MsoBodyTextIndent><span style='font-family:"Courier New"'>MapServer
version 4.0 OUTPUT=PNG OUTPUT=JPEG SUPPORTS=PROJ SUPPORTS=FREETYPE
SUPPORTS=WMS_SERVER INPUT=TIFF INPUT=JPEG INPUT=OGR INPUT=GDAL INPUT=SHAPEFILE<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'><u>The output means:</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'><span style='font-family:"Courier New"'>MapServer version
4.0<span style='mso-tab-count:3'> </span> </span>– version 4.0</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'><span style='font-family:"Courier New"'>OUTPUT=PNG
</span>- this exe will create PNG graphic files for output</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'><span style='font-family:"Courier New"'>OUTPUT=JPEG
</span>- this exe will create JPEG graphic files for output</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'><span style='font-family:"Courier New"'>SUPPORTS=PROJ
</span>- this exe will re-project data if projection is specified in map file</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'><span style='font-family:"Courier New"'>SUPPORTS=FREETYPE
</span>- this exe will allow the use of TrueType fonts</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'><span style='font-family:"Courier New"'>SUPPORTS=WMS_SERVER
</span>- this exe will will act as a OGIS WMS server</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'><span style='font-family:"Courier New"'>INPUT=TIFF
</span>- this exe will read TIFF images without going thru GDAL</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'><span style='font-family:"Courier New"'>INPUT=JPEG
</span>- this exe will read jpeg images without going thru GDAL</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'><span style='font-family:"Courier New"'>INPUT=OGR
</span>- this exe will read OGR supported vector formats (e.g TAB, shapefile,
etc)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'><span style='font-family:"Courier New"'>INPUT=GDAL
</span>- this exe will read and write GDAL raster formats (e.g jpg, tif,
Geotif, BIL, etc)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'><span style='font-family:"Courier New"'>INPUT=SHAPEFILE
</span>- this exe will shapefiles without going thru GDAL/OGR</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>8.<span
style='font-size:7.5pt'> </span><u>Building
Shp2img</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
text-indent:.5in'><span style='font-family:"Courier New"'>shp2img.exe</span> is
a stand-alone executable (a web server is not required) that can do all the map
graphic rendering mapserv.exe can do, but does not render scale bar or
reference map graphic and does not do querying.</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l12 level1 lfo24;tab-stops:
list 90.6pt'><![if !supportLists]>-<span style='font:7.0pt "Times New Roman"'>
</span><![endif]>create console application called shp2img in the mapserver_dev
directory</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l12 level1 lfo24;tab-stops:
list 90.6pt'><![if !supportLists]>-<span style='font:7.0pt "Times New Roman"'>
</span><![endif]>add shp2img.c to the project</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l12 level1 lfo24;tab-stops:
list 90.6pt'><![if !supportLists]>-<span style='font:7.0pt "Times New Roman"'>
</span><![endif]>add the following <u>Preprocessor definitions</u>:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:2.0in'><span style='font-family:"Courier New"'>,USE_PROJ<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l7 level1 lfo26;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>set <u>Additional include directories:</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:126.6pt'><span style='font-family:"Courier New"'>..\..\gd-2.0.15,..\..\regex-0.12,..\..\proj-4.4.7\src</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l7 level1 lfo26;tab-stops:list 90.6pt'><![if !supportLists]>-<span
style='font:7.0pt "Times New Roman"'>
</span><![endif]>set <u>Object/library modules:</u></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.0in'><i>Debug version:</i></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:1.5in'><span style='font-family:"Courier New"'>..\mapserver\debug\mapserver.lib
..\..\regex-0.12\regex\debug\regex.lib ..\..\proj-4.4.7\src\proj.lib
..\..\gd-2.0.15\gd\debug\gd.lib ..\..\gdal-1.1.9\gdal.lib
..\..\freetype-2.1.4\objs\freetype214ST_D.lib<o:p></o:p></span></p>
<p style='margin-left:1.0in'><i>Release version:</i></p>
<p style='margin-left:1.5in'><span style='font-family:"Courier New"'>..\mapserver\release\mapserver.lib
..\..\regex-0.12\release\regex.lib ..\proj-4.4.7\src\proj.lib ..\
..\gd-2.0.15\gd\release\gd.lib ..\..\gdal-1.1.9\gdal.lib
..\freetype-2.1.4\objs\freetype214ST.lib<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:90.6pt;text-indent:-18.6pt;mso-list:l7 level1 lfo26;tab-stops:list 90.6pt'><![if !supportLists]><span
style='font-size:14.0pt;mso-bidi-font-size:12.0pt'>-<span style='font:7.0pt "Times New Roman"'>
</span></span><![endif]><b><span style='font-size:14.0pt;mso-bidi-font-size:
12.0pt'>compile to shp2img.exe</span></b><span style='font-size:14.0pt;
mso-bidi-font-size:12.0pt'><o:p></o:p></span></p>
<p> </p>
<h1><span style='font-size:16.0pt'>5. Testing the Mapserver Build</span></h1>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>Test
with shp2img</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
Create a map file and test using shp2img:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:.5in;text-indent:.5in'><span style='font-family:"Courier New"'>shp2img
-m C:\Inetpub\wwwroot\test\test.map -o test.jpg</span></p>
<p class=MsoNormal><span style='mso-bidi-font-family:Arial'>Test mapserv.exe on
the command line</span><span style='font-size:10.0pt;font-family:Arial'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:.5in'><span style='mso-bidi-font-family:
Arial'><span style='mso-tab-count:1'> </span></span><span
style='font-family:"Courier New"'>mapserv QUERY_STRING=xxxxxxxxxxxx</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>Test
mapserv.exe with the Itasca demo</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:.5in'>Download and install the Itasca demo</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:.5in'>Move your mapserv.exe to your cgi-bin directory.</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:.5in'>Browse to your Itasca demo</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
<more info TBD></p>
<h1><span style='font-size:16.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></h1>
<h1><span style='font-size:16.0pt'>6. Debugging Mapserver</span></h1>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>Map
Rendering problems</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>Map
Query Problems</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
<more info TBD></p>
<h1><span style='font-size:16.0pt'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></h1>
<h1><span style='font-size:16.0pt'>7. Enabling Other Capabilities of MapServer</span></h1>
<h3 style='margin-left:.5in;text-indent:-.25in;mso-list:l9 level1 lfo28;
tab-stops:list .5in'><![if !supportLists]>1.<span style='font:7.0pt "Times New Roman"'>
</span><![endif]>Adding ECW Reading Capabilities</h3>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:.5in'>Download ERMapper’s “ECW Compression/Decompression SDK for
Windows” from <a href="http://www.ermapper.com/">www.ermapper.com</a> -
downloads, and install.</p>
<p class=MsoBodyTextIndent2><span style='font-family:"Times New Roman"'>Edit
GDAL’s nmake.opt file. Uncomment and change the ECWDIR assignment to
point to the location of the ECW libraries. The path must be in MSDOS
format (use “dir /X” to show name in MSDOS format):<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:.5in;text-indent:.5in'><span style='font-family:"Courier New"'>ECWDIR
= C:\PROGRA~1\ERMapp~1\ECWCom~1.1</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
text-indent:.5in'>Uncomment the next two lines as well:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:.5in;text-indent:.5in'><span style='font-family:"Courier New"'>ECWLIB
= $(ECWDIR)\lib\NCSEcw.lib $(ECWDIR)\lib\NCSEcwC.lib \</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><span
style='font-family:"Courier New"'>
<span style='mso-tab-count:1'> </span>
$(ECWDIR)\lib\NCSUtil.lib</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
text-indent:.5in'>From the command line execute:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><span
style='font-family:"Courier New"'> <span
style='mso-tab-count:1'> </span>cd gdal-1.1.9</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><span
style='font-family:"Courier New"'> <span
style='mso-tab-count:1'> </span>nmake /f makefile.vc clean</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><span
style='font-family:"Courier New"'> <span
style='mso-tab-count:1'> </span>nmake /f makefile.vc</span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
text-indent:.5in'>Add the following Object/library modules to the Link dialog
for mapserv.exe (and shp2img if you want).</p>
<p class=MsoBodyTextIndent2 style='margin-left:1.0in'>C:\PROGRA~1\ERMapp~1\ECWCom~1.1\lib\NCSEcw.lib
C:\PROGRA~1\ERMapp~1\ECWCom~1.1\lib\NCSEcwC.lib
C:\PROGRA~1\ERMapp~1\ECWCom~1.1\lib\NCSUtil.lib</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
text-indent:.5in'>These ECW libraries are just the “stubs” of the functions
allowing the exe to be linked without any errors. Before you can use an
exe (like mapserv.exe) that makes use of the functions, you must copy the
corresponding ECW DLLs into the same directory as the exe, or into the O/S
system32 directory.</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> <span
style='mso-tab-count:1'> </span>To use ECW raster files, simply reference
them as you would other raster files in the DATA statement in the LAYER object
of your map file.</p>
<p> </p>
<h3 style='margin-left:.5in;text-indent:-.25in;mso-list:l9 level1 lfo28;
tab-stops:list .5in'><![if !supportLists]>2.<span style='font:7.0pt "Times New Roman"'>
</span><![endif]>Adding PostGIS Reading Capabilities</h3>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
text-indent:.5in'>PostGIS is a spatial enabling layer added to the open source
database PostgreSQL. MapServer requires the PostGIS functions to be added
to PostgreSQL (MapServer will not read geometry data from a PostgreSQL database
without it) PostgreSQL is primarily built for Unix/Linux but will run on
Windows. While there is a Windows version of PostgreSQL available for
running with Cygwin (a Unix-like environment for Windows), we use the native
Windows port created by Multera/PeerDirect. </p>
<h4>NOTE:<span style="mso-spacerun: yes"> </span>The port was a beta, and is
no longer available</h4>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
text-indent:.5in'>Download the Multera binaries from <a
href="ftp://209.61.187.152/multera/postgres_beta2.zip">ftp://209.61.187.152/multera/postgres_beta2.zip</a>.<span
style="mso-spacerun: yes"> </span>Unpack and <u>follow the install
documentation included in the zip file</u>. Add the PostGIS layer to
PostgreSQL by downloading it from <a href="http://postgis.refractions.net/">http://postgis.refractions.net</a>.
Unpack and install. There are a couple of ways of creating data in
PostGIS, but one of the easiest is the shp2pgsql utility included in the
PostGIS download.</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> Make
the following changes to the mapserver lib project:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
Add the following <u>Preprocessor definition</u>:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto;
margin-left:.5in'><span style='font-family:"Courier New"'>,USE_POSTGIS<o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
Add the following <u>Additional include directories:</u> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
<span style='font-family:"Courier New"'>, C:\programs\Postgresql\include </span>(or
where ever you’ve installed PostgreSQL)</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><span
style="mso-spacerun: yes"> </span>Add the following Object/library module in
the mapserv exe project’s link dialog:</p>
<p class=MsoBodyTextIndent2>C:\programs\PostgreSQL\lib\libpq.lib<span
style='font-family:"Times New Roman"'> (or where ever you’ve installed
PostgreSQL)<o:p></o:p></span></p>
<p> </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>Do
a <span style='font-family:"Courier New"'>mapserv –v</span>. You should
see <span style='font-family:"Courier New"'>INPUT=POSTGIS</span> included in
the capabilities list.</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'> To
access data stored in PostGIS, add a layer to your map file using the following
example as a guide:</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
CONNECTIONTYPE postgis </p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
CONNECTION "user=myaccount password=mypass dbname=mydb
host=www.myserver.com"</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'>
DATA "alberta from (select name from cities where province like
'Alberta') as foo using unique city_id using SRID=-1"</p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
<h3 style='margin-left:.5in;text-indent:-.25in;mso-list:l9 level1 lfo28;
tab-stops:list .5in'><![if !supportLists]>3.<span style='font:7.0pt "Times New Roman"'>
</span><![endif]>Adding WMS Server Capabilities <this section is under
construction></h3>
<h5>Building the dependencies<span style='font-family:Arial;mso-bidi-font-family:
"Times New Roman"'><o:p></o:p></span></h5>
<p class=MsoNormal style='margin-left:.75in;text-indent:-.25in;mso-list:l14 level1 lfo30;
tab-stops:list .75in'><![if !supportLists]><span style='font-size:10.0pt;
font-family:Arial;mso-bidi-font-family:"Times New Roman"'>1.<span
style='font:7.0pt "Times New Roman"'> </span></span><![endif]><u>Building
"zlib"</u><u><span style='font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></u></p>
<p class=MsoNormal style='margin-left:1.0in'>- create a <span style='font-family:
"Courier New"'>zlib-1.1.4 </span><span style='mso-bidi-font-family:Arial'>dir</span>
into your “nightly build” (eg 20030202) dir<span style='font-size:10.0pt;
font-family:Arial;mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.0in'>- download zlib from <a
href="http://www.gzip.org/zlib">http://www.gzip.org/zlib</a> into your new zlib
dir<span style='font-size:10.0pt;font-family:Arial;mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.0in'>- unpack<span style='font-size:
10.0pt;font-family:Arial;mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.0in'>- copy makfile.nt and zlib.dnt
from zlib’s nt dir up one level to the zlib dir<span style='font-size:10.0pt;
font-family:Arial;mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.0in'>- from the command line, execute
the following:<span style='font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.5in'><span style='font-family:"Courier New"'>vcvars32</span><span
style='font-size:10.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.5in'><span style='font-family:"Courier New"'>nmake
/f makefile.nt</span><span style='font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
"Times New Roman"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:.75in;text-indent:-.25in;mso-list:l14 level1 lfo30;
tab-stops:list .75in'><![if !supportLists]><span style='font-size:10.0pt;
font-family:Arial;mso-bidi-font-family:"Times New Roman"'>2.<span
style='font:7.0pt "Times New Roman"'> </span></span><![endif]><u>Building
"libcurl"</u><u><span style='font-size:10.0pt;font-family:Arial;
mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></u></p>
<p class=MsoNormal style='margin-left:1.0in'>- download libcurl from <a
href="http://curl.haxx.se/download.html">http://curl.haxx.se/download.html</a>
(the zip package) into your “nightly build” (eg 20030202) dir<span
style='font-size:10.0pt;font-family:Arial;mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.0in'>- unpack<span style='font-size:
10.0pt;font-family:Arial;mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.0in'>- cd to the libcurl directory<span
style='font-size:10.0pt;font-family:Arial;mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.0in'>- from the command line, execute
the following:<span style='font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.5in'><span style='font-family:"Courier New"'>vcvars32</span><span
style='font-size:10.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.5in'><span style='font-family:"Courier New"'>nmake
vc</span><span style='font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.0in'>- really only the library needs to
be made (the above builds the library and curl.exe).<span style="mso-spacerun:
yes"> </span>If you want to build only the library, cd to the lib dir and do:<span
style='font-size:10.0pt;font-family:Arial;mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.5in'><span style='font-family:"Courier New"'>vcvars32</span><span
style='font-size:10.0pt;font-family:"Courier New"'><o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:1.5in'><span style='font-family:"Courier New"'>nmake
-f Makefile.vc6 CFG=debug-dll</span><span style='font-size:10.0pt;font-family:
Arial;mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal><span style='mso-tab-count:2'> </span>(requires
ws2_32.lib to be linked in)</p>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
"Times New Roman"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
"Times New Roman"'><span style='mso-tab-count:1'> </span>Add the
following preprocesser directive to the mapserver and mapserv projects:<o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:.5in;text-indent:.5in'><span
style='font-family:"Courier New"'>, USE_WMS_SVR</span><span style='font-size:
10.0pt;font-family:Arial;mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
"Times New Roman"'><![if !supportEmptyParas]> <![endif]><o:p></o:p></span></p>
<h3 style='margin-left:.5in;text-indent:-.25in;mso-list:l9 level1 lfo28;
tab-stops:list .5in'><![if !supportLists]>4.<span style='font:7.0pt "Times New Roman"'>
</span><![endif]>Adding WFS Server Capabilities <this section is under
construction></h3>
<p class=MsoNormal><span style='font-size:10.0pt;font-family:Arial;mso-bidi-font-family:
"Times New Roman"'><span style='mso-tab-count:1'> </span>Add the
following preprocesser directive to the mapserver and mapserv projects:<o:p></o:p></span></p>
<p class=MsoNormal style='margin-left:.5in;text-indent:.5in'><span
style='font-family:"Courier New"'>, USE_WFS_SVR</span><span style='font-size:
10.0pt;font-family:Arial;mso-bidi-font-family:"Times New Roman"'><o:p></o:p></span></p>
<p class=MsoNormal style='mso-margin-top-alt:auto;mso-margin-bottom-alt:auto'><![if !supportEmptyParas]> <![endif]><o:p></o:p></p>
</div>
</body>
</html>