GIS编程

开发平台：
C#

LabelLayer.cs：源码内容
							// Copyright 2005, 2006 - Morten Nielsen (www.iter.dk)
//
// This file is part of SharpMap.
// SharpMap is free software; you can redistribute it and/or modify
// it under the terms of the GNU Lesser General Public License as published by
// the Free Software Foundation; either version 2 of the License, or
// (at your option) any later version.
// 
// SharpMap 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 Lesser General Public License for more details.
// You should have received a copy of the GNU Lesser General Public License
// along with SharpMap; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA 
using System;
using System.Collections.Generic;
using System.Text;
namespace SharpMap.Layers
{
	/// <summary>
	/// Label layer class
	/// </summary>
	/// <example>
	/// Creates a new label layer and sets the label text to the "Name" column in the FeatureDataTable of the datasource
	/// <code lang="C#">
	/// //Set up a label layer
	/// SharpMap.Layers.LabelLayer layLabel = new SharpMap.Layers.LabelLayer("Country labels");
	/// layLabel.DataSource = layCountries.DataSource;
	/// layLabel.Enabled = true;
	/// layLabel.LabelColumn = "Name";
	/// layLabel.Style = new SharpMap.Styles.LabelStyle();
	/// layLabel.Style.CollisionDetection = true;
	/// layLabel.Style.CollisionBuffer = new SizeF(20, 20);
	/// layLabel.Style.ForeColor = Color.White;
	/// layLabel.Style.Font = new Font(FontFamily.GenericSerif, 8);
	/// layLabel.MaxVisible = 90;
	/// layLabel.Style.HorizontalAlignment = SharpMap.Styles.LabelStyle.HorizontalAlignmentEnum.Center;
	/// </code>
	/// </example>
	public class LabelLayer : Layer, IDisposable
	{
		/// <summary>
		/// Labelling behaviour for Multipart geometry collections
		/// </summary>
		public enum MultipartGeometryBehaviourEnum
		{
			/// <summary>
			/// Place label on all parts (default)
			/// </summary>
			All,
			/// <summary>
			/// Place label on object which the greatest length or area.
			/// </summary>
			/// <remarks>
			/// Multipoint geometries will default to <see cref="First"/>
			/// </remarks>
			Largest,
			/// <summary>
			/// The center of the combined geometries
			/// </summary>
			CommonCenter,
			/// <summary>
			/// Center of the first geometry in the collection (fastest method)
			/// </summary>
			First
		}
		/// <summary>
		/// Delegate method for creating advanced label texts
		/// </summary>
		/// <param name="fdr"></param>
		/// <returns></returns>
		public delegate string GetLabelMethod(SharpMap.Data.FeatureDataRow fdr);
		/// <summary>
		/// Creates a new instance of a LabelLayer
		/// </summary>
		public LabelLayer(string layername)
		{
			_Style = new SharpMap.Styles.LabelStyle();
			this.LayerName = layername;
			this.SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.AntiAlias;
			this.TextRenderingHint = System.Drawing.Text.TextRenderingHint.AntiAlias;
			_MultipartGeometryBehaviour = MultipartGeometryBehaviourEnum.All;
			_LabelFilter = SharpMap.Rendering.LabelCollisionDetection.SimpleCollisionDetection;
		}
		private MultipartGeometryBehaviourEnum _MultipartGeometryBehaviour;
		/// <summary>
		/// Gets or sets labelling behavior on multipart geometries
		/// </summary>
		/// <remarks>Default value is <see cref="MultipartGeometryBehaviourEnum.All"/></remarks>
		public MultipartGeometryBehaviourEnum MultipartGeometryBehaviour
		{
			get { return _MultipartGeometryBehaviour; }
			set { _MultipartGeometryBehaviour = value; }
		}
		private SharpMap.Rendering.LabelCollisionDetection.LabelFilterMethod _LabelFilter;
		/// <summary>
		/// Filtermethod delegate for performing filtering
		/// </summary>
		/// <remarks>
		/// Default method is <see cref="SharpMap.Rendering.LabelCollisionDetection.SimpleCollisionDetection"/>
		/// </remarks>
		public SharpMap.Rendering.LabelCollisionDetection.LabelFilterMethod LabelFilter
		{
			get { return _LabelFilter; }
			set { _LabelFilter = value; }
		}
	
		private System.Drawing.Drawing2D.SmoothingMode _SmoothingMode;
		/// <summary>
		/// Render whether smoothing (antialiasing) is applied to lines and curves and the edges of filled areas
		/// </summary>
		public System.Drawing.Drawing2D.SmoothingMode SmoothingMode
		{
			get { return _SmoothingMode; }
			set { _SmoothingMode = value; }
		}
		private System.Drawing.Text.TextRenderingHint _TextRenderingHint;
		/// <summary>
		/// Specifies the quality of text rendering
		/// </summary>
		public System.Drawing.Text.TextRenderingHint TextRenderingHint
		{
			get { return _TextRenderingHint; }
			set { _TextRenderingHint = value; }
		}	
		private SharpMap.Data.Providers.IProvider _DataSource;
		/// <summary>
		/// Gets or sets the datasource
		/// </summary>
		public SharpMap.Data.Providers.IProvider DataSource
		{
			get { return _DataSource; }
			set { _DataSource = value; }
		}
		private SharpMap.Styles.LabelStyle _Style;
		/// <summary>
		/// Gets or sets the rendering style of the label layer.
		/// </summary>
		public SharpMap.Styles.LabelStyle Style
		{
			get { return _Style; }
			set { _Style = value; }
		}
		private SharpMap.Rendering.Thematics.ITheme _theme;
		/// <summary>
		/// Gets or sets thematic settings for the layer. Set to null to ignore thematics
		/// </summary>
		public SharpMap.Rendering.Thematics.ITheme Theme
		{
			get { return _theme; }
			set { _theme = value; }
		}
		private string _LabelColumn;
		/// <summary>
		/// Data column or expression where label text is extracted from.
		/// </summary>
		/// <remarks>
		/// This property is overriden by the <see cref="LabelStringDelegate"/>.
		/// </remarks>
		public string LabelColumn
		{
			get { return _LabelColumn; }
			set { _LabelColumn = value; }
		}
		private GetLabelMethod _getLabelMethod;
		/// <summary>
		/// Gets or sets the method for creating a custom label string based on a feature.
		/// </summary>
		/// <remarks>
		/// <para>If this method is not null, it will override the <see cref="LabelColumn"/> value.</para>
		/// <para>The label delegate must take a <see cref="SharpMap.Data.FeatureDataRow"/> and return a string.</para>
		/// <example>
		/// Creating a label-text by combining attributes "ROADNAME" and "STATE" into one string, using
		/// an anonymous delegate:
		/// <code lang="C#">
		/// myLabelLayer.LabelStringDelegate = delegate(SharpMap.Data.FeatureDataRow fdr)
		///				{ return fdr["ROADNAME"].ToString() + ", " + fdr["STATE"].ToString(); };
		/// </code>
		/// </example>
		/// </remarks>
		public GetLabelMethod LabelStringDelegate
		{
			get { return _getLabelMethod; }
			set { _getLabelMethod = value; }
		}
	
		
		private string _RotationColumn;
		/// <summary>
		/// Data column from where the label rotation is derived.
		/// If this is empty, rotation will be zero, or aligned to a linestring.
		/// Rotation are in degrees (positive = clockwise).
		/// </summary>
		public string RotationColumn
		{
			get { return _RotationColumn; }
			set { _RotationColumn = value; }
		}
		
		private int _Priority;
		/// <summary>
		/// A value indication the priority of the label in cases of label-collision detection
		/// </summary>
		public int Priority
		{
			get { return _Priority; }
			set { _Priority = value; }
		}
		/// <summary>
		/// Renders the layer
		/// </summary>
		/// <param name="g">Graphics object reference</param>
		/// <param name="map">Map which is rendered</param>
		public override void Render(System.Drawing.Graphics g, Map map)
		{
			if (this.Style.Enabled && this.Style.MaxVisible >= map.Zoom && this.Style.MinVisible < map.Zoom)
			{
				if (this.DataSource == null)
					throw (new ApplicationException("DataSource property not set on layer '" + this.LayerName + "'"));
				g.TextRenderingHint = this.TextRenderingHint;
				g.SmoothingMode = this.SmoothingMode;
				SharpMap.Geometries.BoundingBox envelope = map.Envelope; //View to render
				if (this.CoordinateTransformation != null)
					envelope = SharpMap.CoordinateSystems.Transformations.GeometryTransform.TransformBox(envelope, this.CoordinateTransformation.MathTransform.Inverse());
			
				SharpMap.Data.FeatureDataSet ds = new SharpMap.Data.FeatureDataSet();
				this.DataSource.Open();
				this.DataSource.ExecuteIntersectionQuery(envelope, ds);
				this.DataSource.Close();
				if (ds.Tables.Count == 0)
				{
					base.Render(g,map);
					return;
				}
				SharpMap.Data.FeatureDataTable features = (SharpMap.Data.FeatureDataTable)ds.Tables[0];
				//Initialize label collection
				List<Rendering.Label> labels = new List<SharpMap.Rendering.Label>();
			
				//List<System.Drawing.Rectangle> LabelBoxes; //Used for collision detection
				//Render labels
				for (int i = 0; i < features.Count; i++)
				{
					SharpMap.Data.FeatureDataRow feature = features[i];
					if (this.CoordinateTransformation != null)
							features[i].Geometry = SharpMap.CoordinateSystems.Transformations.GeometryTransform.TransformGeometry(features[i].Geometry, this.CoordinateTransformation.MathTransform);
					SharpMap.Styles.LabelStyle style = null;
					if (this.Theme != null) //If thematics is enabled, lets override the style
						 style = this.Theme.GetStyle(feature) as SharpMap.Styles.LabelStyle;
					else
						style = this.Style;
					float rotation = 0;
					if (!String.IsNullOrEmpty(this.RotationColumn))
						float.TryParse(feature[this.RotationColumn].ToString(), System.Globalization.NumberStyles.Any,SharpMap.Map.numberFormat_EnUS, out rotation);
					string text;
					if (_getLabelMethod != null)
						text = _getLabelMethod(feature);
					else
						text = feature[this.LabelColumn].ToString();
					if (text != null && text != String.Empty)
					{
						if (feature.Geometry is SharpMap.Geometries.GeometryCollection)
						{
							if (this.MultipartGeometryBehaviour == MultipartGeometryBehaviourEnum.All)
							{
								foreach (SharpMap.Geometries.Geometry geom in (feature.Geometry as Geometries.GeometryCollection))
								{
									SharpMap.Rendering.Label lbl = CreateLabel(geom, text, rotation, style, map, g);
									if (lbl != null)
										labels.Add(lbl);
								}
							}
							else if (this.MultipartGeometryBehaviour == MultipartGeometryBehaviourEnum.CommonCenter)
							{
								SharpMap.Rendering.Label lbl = CreateLabel(feature.Geometry, text, rotation, style, map, g);
								if (lbl != null)
									labels.Add(lbl);
							}
							else if (this.MultipartGeometryBehaviour == MultipartGeometryBehaviourEnum.First)
							{
								if ((feature.Geometry as Geometries.GeometryCollection).Collection.Count > 0)
								{
									SharpMap.Rendering.Label lbl = CreateLabel((feature.Geometry as Geometries.GeometryCollection).Collection[0], text, rotation, style, map, g);
									if (lbl != null)
										labels.Add(lbl);
								}
							}
							else if (this.MultipartGeometryBehaviour == MultipartGeometryBehaviourEnum.Largest)
							{
								Geometries.GeometryCollection coll = (feature.Geometry as Geometries.GeometryCollection);
								if (coll.NumGeometries > 0)
								{
									double largestVal = 0;
									int idxOfLargest = 0;
									for (int j = 0; j < coll.NumGeometries; j++)
									{
										SharpMap.Geometries.Geometry geom = coll.Geometry(j);
										if (geom is Geometries.LineString && ((Geometries.LineString)geom).Length > largestVal)
										{
											largestVal = ((Geometries.LineString)geom).Length;
											idxOfLargest = j;
										}
										if (geom is Geometries.MultiLineString && ((Geometries.MultiLineString)geom).Length > largestVal)
										{
											largestVal = ((Geometries.LineString)geom).Length;
											idxOfLargest = j;
										}
										if (geom is Geometries.Polygon && ((Geometries.Polygon)geom).Area > largestVal)
										{
											largestVal = ((Geometries.Polygon)geom).Area;
											idxOfLargest = j;
										}
										if (geom is Geometries.MultiPolygon && ((Geometries.MultiPolygon)geom).Area > largestVal)
										{
											largestVal = ((Geometries.MultiPolygon)geom).Area;
											idxOfLargest = j;
										}
									}
									SharpMap.Rendering.Label lbl = CreateLabel(coll.Geometry(idxOfLargest), text, rotation, style, map, g);
									if (lbl != null)
										labels.Add(lbl);
								}
							}
						}
						else
						{
							SharpMap.Rendering.Label lbl = CreateLabel(feature.Geometry, text, rotation, style, map, g);
							if (lbl != null)
								labels.Add(lbl);
						}
					}
				}
				if (labels.Count > 0) //We have labels to render...
				{
					if (this.Style.CollisionDetection && this._LabelFilter!=null)
						this._LabelFilter(labels);
					for (int i = 0; i < labels.Count;i++ )
						SharpMap.Rendering.VectorRenderer.DrawLabel(g, labels[i].LabelPoint, labels[i].Style.Offset, labels[i].Style.Font, labels[i].Style.ForeColor, labels[i].Style.BackColor, Style.Halo, labels[i].Rotation, labels[i].Text, map);
				}
				labels = null;
			}
			base.Render(g, map);
		}
		
		private SharpMap.Rendering.Label CreateLabel(SharpMap.Geometries.Geometry feature,string text, float rotation, SharpMap.Styles.LabelStyle style, Map map, System.Drawing.Graphics g)
		{
			System.Drawing.SizeF size = g.MeasureString(text, style.Font);
			
			System.Drawing.PointF position = map.WorldToImage(feature.GetBoundingBox().GetCentroid());
			position.X = position.X - size.Width * (short)style.HorizontalAlignment * 0.5f;
			position.Y = position.Y - size.Height * (short)style.VerticalAlignment * 0.5f;
			if (position.X-size.Width > map.Size.Width || position.X+size.Width < 0 ||
				position.Y-size.Height > map.Size.Height || position.Y+size.Height < 0)
				return null;
			else
			{
				SharpMap.Rendering.Label lbl;
			
				if (!style.CollisionDetection)
					lbl = new SharpMap.Rendering.Label(text, position, rotation, this.Priority, null, style);
				else
				{
					//Collision detection is enabled so we need to measure the size of the string
					lbl = new SharpMap.Rendering.Label(text, position, rotation, this.Priority,
						new SharpMap.Rendering.LabelBox(position.X - size.Width * 0.5f - style.CollisionBuffer.Width, position.Y + size.Height * 0.5f + style.CollisionBuffer.Height,
						size.Width + 2f * style.CollisionBuffer.Width, size.Height + style.CollisionBuffer.Height * 2f), style);
				}
				if (feature.GetType() == typeof(SharpMap.Geometries.LineString))
				{
					SharpMap.Geometries.LineString line = feature as SharpMap.Geometries.LineString;
					if (line.Length / map.PixelSize > size.Width) //Only label feature if it is long enough
						CalculateLabelOnLinestring(line, ref lbl, map);
					else
						return null;
				}
			
				return lbl;
			}
		}
		private void CalculateLabelOnLinestring(SharpMap.Geometries.LineString line, ref SharpMap.Rendering.Label label, Map map)
		{
			double dx, dy;
			double tmpx, tmpy;
			double angle = 0.0;
			// first find the middle segment of the line
			int midPoint = (line.Vertices.Count - 1) / 2;
			if (line.Vertices.Count > 2)
			{
				dx = line.Vertices[midPoint + 1].X - line.Vertices[midPoint].X;
				dy = line.Vertices[midPoint + 1].Y - line.Vertices[midPoint].Y;
			}
			else
			{
				midPoint = 0;
				dx = line.Vertices[1].X - line.Vertices[0].X;
				dy = line.Vertices[1].Y - line.Vertices[0].Y;
			}
			if (dy == 0)
				label.Rotation = 0;
			else if (dx == 0)
				label.Rotation = 90;
			else
			{
				// calculate angle of line					
				angle = -Math.Atan(dy / dx) + Math.PI * 0.5;
				angle *= (180d / Math.PI); // convert radians to degrees
				label.Rotation = (float)angle - 90; // -90 text orientation
			}
			tmpx = line.Vertices[midPoint].X + (dx * 0.5);
			tmpy = line.Vertices[midPoint].Y + (dy * 0.5);
			label.LabelPoint = map.WorldToImage(new SharpMap.Geometries.Point(tmpx, tmpy));
		}
		
		/// <summary>
		/// Gets the boundingbox of the entire layer
		/// </summary>
		public override SharpMap.Geometries.BoundingBox Envelope
		{
			get {
				if (this.DataSource == null)
					throw (new ApplicationException("DataSource property not set on layer '" + this.LayerName + "'"));
				
				bool wasOpen = this.DataSource.IsOpen;
				if (!wasOpen)
					this.DataSource.Open();
				SharpMap.Geometries.BoundingBox box = this.DataSource.GetExtents();
				if (!wasOpen) //Restore state
					this.DataSource.Close();
				return box;
			}
		}
		/// <summary>
		/// Gets or sets the SRID of this VectorLayer's data source
		/// </summary>
		public override int SRID
		{
			get {
				if (this.DataSource == null)
					throw (new ApplicationException("DataSource property not set on layer '" + this.LayerName + "'"));
				return this.DataSource.SRID; }
			set { this.DataSource.SRID = value; }
		}
		/// <summary>
		/// Clones the object
		/// </summary>
		/// <returns></returns>
		public override object Clone()
		{
			throw new NotImplementedException();
		}
		#region IDisposable Members
		/// <summary>
		/// Disposes the object
		/// </summary>
		public void Dispose()
		{
			if (DataSource is IDisposable)
				((IDisposable)DataSource).Dispose();
		}
		#endregion
	}
}

						