Changes between Version 3 and Version 4 of CodeSamples/ASP.Net/ScribbleApp

Timestamp:

Nov 21, 2007, 11:02:47 AM (16 years ago)

Author:

jbirch

Comment:

--

CodeSamples/ASP.Net/ScribbleApp

@@ -3 +3 @@
 This page is one of the !MapGuide Community CodeSamples.  Visit the CodeSamples page to view more!
 
-== Dennis' Cool Application ==
+== About Scribble ==
+
+Scribble was designed to be an adjunct to any map/layout we created here at MIA. A “kinda-sorta” universal plugin application for pdf output and html table output from a MG selection. The markup came along as part of the generalization process.
+
+== Acknowledgements ==
+
+First and foremost I must acknowledge the following legends of the open source community:
+
+iText – Bruno Lowagie and Paulo Soares
+http://www.lowagie.com/iText/
+I am amazed at how many commercial packages are based on and actually include this work.
+
+IKVM – Jeroen Frijiters
+http://www.ikvm.net/
+Pretty much single-handedly brought on the demise of Microsoft’s J#
+
+== Requirements ==
+
+Here is the platform information:
+      MapGuide Open Source 1.1
+      Windows XP
+      Windows Server 2003
+      .Net Framework 2.0
+      Visual Studio 2005
+      ASP.NET Ajax 1.0
+      ASP.NET 1.0 AjaxControlToolkit - http://www.codeplex.com/
+
+I also borrowed extensively from the “gt” MGOS sample application. Easily said that this was the starting point for the geometry portion of this application.
+  
+== Notes ==
+
+This application was designed to run within the taskFrame of MG as an iframe within an AjaxlToolkit TabPanel. Specifically I set this up to be instantiated thusly:
+
+{{{
+        HtmlControl frame1 = new System.Web.UI.HtmlControls.HtmlGenericControl("iframe");
+        frame1.Attributes["src"] = "http://" + dnsname + "/mapguide/Scribble/scribble.aspx?SESSION="
+                                    + args["SESSION"] ;
+        frame1.Attributes["frameborder"] = "0";
+        frame1.Attributes["scrolling"] = "auto";
+        frame1.Attributes["width"] = "100%";
+        frame1.Attributes["height"] = "400px";
+        frame1.Attributes["allowTransparency"] = "true";
+        theFrameScribble.Controls.Add(frame1);
+}}}
+
+This then explains the “parent.parent.parent.mapFrame” references within the javascript.
+
+Needless to say you may do what you wish. (As an aside, I actually have 4 separate applications in 4 tabpanels all interacting with the map). 
+
+=== Preparing iText and IKVM ===
+
+This step is optional, since the DLLs are included in the package, but worth understanding.
+
+If you know nothing of [http://www.lowagie.com/iText/ iText] and [http://www.ikvm.net/ IKVM] I recommend you spend some time reading.  These apps are impossible to explain in a few words. I will just tell you what I have done.
+
+I used the following ikvmc commands to create the itext and bouncycastle dll’s
+{{{
+ ::REM
+ ikvmc -target:library -reference:IKVM.GNU.Classpath.dll bcpg-jdk15-137.jar 
+ ikvmc -target:library -reference:IKVM.GNU.Classpath.dll -reference:bcpg-jdk15-137.dll bctsp-jdk15-137.jar 
+ ikvmc -target:library -reference:IKVM.GNU.Classpath.dll -reference:bcpg-jdk15-137.dll -reference:bctsp-jdk15-137.dll bcprov-jdk15-137.jar
+ ikvmc -target:library -reference:IKVM.GNU.Classpath.dll -reference:bcpg-jdk15-137.dll -reference:bctsp-jdk15-137.dll -reference:bcprov-jdk15-137.dll bcmail-jdk15-137.jar
+
+ :: FINALLY
+ ikvmc -target:library -reference:IKVM.GNU.Classpath.dll -reference:bcmail-jdk15-137.dll -reference:bcprov-jdk15-137.dll itext-2.0.6.jar 
+ ::REM
+
+}}}
+
+THAT’S IT !!!! You just created .NET dll’s from jars!! 
+(As another aside: there are LOTS of GIS related jars out there) 
+
+Do NOT be overly concerned with the warnings coming out of bouncycastle. Most of these have to do with encryption and stamping and mailing. I do not understand fully but I never have had to use those methods anyway. Please keep in mind the older iText stuff works great to! I have used versions from 1.4 – 2.0 without any difficulty. Again the bouncycastle stuff is recent. You are going to be amazed at how simple this really is!!
+
+I currently use these dll’s
+{{{
+ itext-2.0.6.dll
+ IKVM.Runtime.dll
+ IKVM.GNU.Classpath.dll
+ bcprov-jdk15-137.dll
+ bcmail-jdk15-137.dll
+}}}
+
+Drop these dll’s into your applications bin directory, make your references to them and start “using”
+using java.io;
+using ikvm.lang;
+using com.lowagie.text;
+using com.lowagie.text.pdf;
+using com.lowagie.text.pdf.codec;
+
+=== Getting Started with Scribble ===
+
+Take a look at scribblemethodsmgr.cs and most everything will become obvious.
+(For all you .NET purists out there the [WEBMETHOD] decoration on some of these methods is pointless I know, but it looks nice.) 
+
+{{{
+ public byte[] MaterializeMapImagePage(string session, string mapname, int width, int height, string imageflavor)
+}}}
+
+ AND 
+
+{{{
+public byte[] MaterializeMapPDFPage(string session, string mapname, int width, int height, string imageflavor)
+}}}
+
+If you don’t like my approach in using ajax calls just rip out the pdf creation stuff and put it directly into the .ashx helper. This will work just as well and you won’t have to be bothered with the other stuff. I just like keeping the file count down and like the consolidation of codebehind  that my approach gives. To each is own.
+
+I have zipped up just the source and the overall structure so you will be able to get a feel of the overall architecture.  I also included the web.config and put it into a separate directory.
+
+Enjoy ....
+dennis