Proste Oznaczanie

Proste Oznaczanie określa, jak cechy muszą być oznakowane.

Obsługiwane opcje to:

Właściwość	Opis
LabelAttribute	Określa nazwę atrybutu, który ma być używany jako źródło etykiet.
LabelExpression	Zapewnia sposób na dostosowanie i sformatowanie tekstu etykiety. Nadpisuje LabelAttribute
FontFamily	Określa rodzinę czcionek, której należy użyć do renderowania tekstu. Domyślna wartość zależy od systemu.
FontStyle	Styl do zastosowania do tekstu. - FontStyle.Regular - zwykły tekst. - FontStyle.Bold - pogrubiony tekst. - FontStyle.Italic - kursywa. - FontStyle.Underine - podkreślony tekst. - FontStyle.StrikeOut - tekst z linią przez środek.
FontSize	Określa rozmiar tekstu.
FontColor	Określa kolor tekstu.
HaloSize	Określa rozmiar halo (lub obrysu) wokół tekstu.
HaloColor	Określa kolor halo wokół tekstu.
GeometryExpression	Wyrażenie geometrii, które ma być używane do transformacji geometrii przed przekazaniem jej do silnika oznaczania.
MultipartMode	Określa zachowanie renderowania dla geometrii wieloczęściowych. - MultipartMode.All - umieść etykietę w pobliżu każdej części geometrii. - MultipartMode.Any - umieść jedną etykietę w pobliżu dowolnej części geometrii. - MultipartMode.Largest - umieść etykietę w pobliżu największej części geometrii.
Placement	Określa, jak etykiety są umieszczane względem geometrii. - PointLabelPlacement - umieszcza etykietę w pobliżu środka geometrii. - LineLabelPlacement - umieszcza etykietę wzdłuż geometrii lub jej obwodu.
Priority	Określa priorytet etykiety w przypadku nakładania się z inną etykietą. Etykieta o niższym priorytecie nie jest renderowana. Domyślna wartość to 1000.

Przykłady

Przykłady Oznaczania Punktów

Domyślnie SimpleLabeling rysuje tekst nad punktami:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(500, 200))
	{
	var symbol = new SimpleMarker
	{
	FillColor = Color.LightGray,
	StrokeStyle = StrokeStyle.None
	};

	var labeling = new SimpleLabeling(labelAttribute: "name");

	map.Add(VectorLayer.Open(dataDir + "points.geojson", Drivers.GeoJson), symbol, labeling);
	map.Padding = 50;
	map.Render(dataDir + "points_labeling_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-PointsLabeling.cs hosted with ❤ by GitHub

Oto jak stylizować czcionkę:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(500, 200))
	{
	var symbol = new SimpleMarker
	{
	FillColor = Color.LightGray,
	StrokeStyle = StrokeStyle.None
	};

	var labeling = new SimpleLabeling(labelAttribute: "name")
	{
	HaloSize = 2,
	HaloColor = Color.LightGray,
	FontSize = 15,
	FontStyle = FontStyle.Italic,
	};

	map.Add(VectorLayer.Open(dataDir + "points.geojson", Drivers.GeoJson), symbol, labeling);
	map.Padding = 50;
	map.Render(dataDir + "points_labeling_styled_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-PointsLabelingStyled.cs hosted with ❤ by GitHub

Aby kontrolować pozycję tekstu względem cechy punktowej, należy ustawić właściwość placement:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(500, 200))
	{
	var symbol = new SimpleMarker
	{
	FillColor = Color.LightGray,
	StrokeStyle = StrokeStyle.None
	};

	var labeling = new SimpleLabeling(labelAttribute: "name")
	{
	HaloSize = 1,
	Placement = new PointLabelPlacement
	{
	VerticalAnchorPoint = VerticalAnchor.Bottom,
	HorizontalAnchorPoint = HorizontalAnchor.Left,
	HorizontalOffset = 2,
	VerticalOffset = 2,
	Rotation = 10,
	}
	};

	map.Add(VectorLayer.Open(dataDir + "points.geojson", Drivers.GeoJson), symbol, labeling);
	map.Padding = 50;
	map.Render(dataDir + "points_labeling_placed_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-PointsLabelingPlaced.cs hosted with ❤ by GitHub

W bardziej zaawansowanych scenariuszach możesz chcieć wybrać różne etykietowanie dla cech. Oto jak to zrobić:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(500, 200))
	{
	var symbolizer = new SimpleMarker {FillColor = Color.LightGray, StrokeStyle = StrokeStyle.None};

	var labeling = new RuleBasedLabeling();
	// Set labeling to be used for small cities.
	labeling.Add(f => f.GetValue<int>("population") <= 2500, new SimpleLabeling("name")
	{
	FontStyle = FontStyle.Italic,
	HaloSize = 1,
	FontSize = 10,
	FontColor = Color.Green,
	Priority = 1,
	Placement = new PointLabelPlacement
	{
	VerticalAnchorPoint = VerticalAnchor.Bottom,
	HorizontalAnchorPoint = HorizontalAnchor.Center,
	}
	});
	// Set labeling to be used for all other cities.
	labeling.AddElseRule(new SimpleLabeling("name")
	{
	HaloSize = 1,
	FontSize = 15,
	FontColor = Color.Red,
	Priority = 2,
	Placement = new PointLabelPlacement
	{
	VerticalAnchorPoint = VerticalAnchor.Bottom,
	HorizontalAnchorPoint = HorizontalAnchor.Center,
	}
	});

	map.Add(VectorLayer.Open(dataDir + "points.geojson", Drivers.GeoJson), symbolizer, labeling);
	map.Padding = 40;
	map.Render(dataDir + "rule_based_labeling_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-RuleBasedLabeling.cs hosted with ❤ by GitHub

Przykłady Oznaczania Linii

Domyślnie SimpleLabeling rysuje etykietę w pobliżu środka linii:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(1000, 634))
	{
	var symbolizer = new SimpleLine { Width = 1.5, Color = Color.FromArgb(0xAE, 0xD9, 0xFD) };

	var labeling = new SimpleLabeling(labelAttribute: "name");

	map.Add(VectorLayer.Open(dataDir + "lines.geojson", Drivers.GeoJson), symbolizer, labeling);
	map.Padding = 50;
	map.Render(dataDir + "lines_labeling_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-LinesLabeling.cs hosted with ❤ by GitHub

Aby obrócić etykiety, aby były równoległe do linii, można użyć LineLabelPlacement z LineLabelAlignment.Parallel:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(1000, 634))
	{
	var symbolizer = new SimpleLine { Width = 1.5, Color = Color.FromArgb(0xAE, 0xD9, 0xFD) };

	var labeling = new SimpleLabeling(labelAttribute: "name")
	{
	HaloSize = 1,
	Placement = new LineLabelPlacement
	{
	Alignment = LineLabelAlignment.Parallel,
	}
	};

	map.Add(VectorLayer.Open(dataDir + "lines.geojson", Drivers.GeoJson), symbolizer, labeling);
	map.Padding = 50;
	map.Render(dataDir + "lines_labeling_parallel_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-LinesLabelingParallel.cs hosted with ❤ by GitHub

Jeśli chcesz, aby teksty precyzyjnie podążały za linią, można użyć LineLabelPlacement z LineLabelAlignment.Curved:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(1000, 634))
	{
	var symbolizer = new SimpleLine { Width = 1.5, Color = Color.FromArgb(0xAE, 0xD9, 0xFD) };

	var labeling = new SimpleLabeling(labelAttribute: "name")
	{
	HaloSize = 1,
	Placement = new LineLabelPlacement
	{
	Alignment = LineLabelAlignment.Curved,
	}
	};

	map.Add(VectorLayer.Open(dataDir + "lines.geojson", Drivers.GeoJson), symbolizer, labeling);
	map.Padding = 50;
	map.Render(dataDir + "lines_labeling_curved_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-LinesLabelingCurved.cs hosted with ❤ by GitHub

Jeśli nie chcesz, aby teksty nakładały się na linię, użyj LineLabelPlacement.Offset:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(1000, 634))
	{
	var symbolizer = new SimpleLine { Width = 1.5, Color = Color.FromArgb(0xAE, 0xD9, 0xFD) };

	var labeling = new SimpleLabeling(labelAttribute: "name")
	{
	HaloSize = 1,
	Placement = new LineLabelPlacement
	{
	Alignment = LineLabelAlignment.Curved,
	Offset = 5,
	}
	};

	map.Add(VectorLayer.Open(dataDir + "lines.geojson", Drivers.GeoJson), symbolizer, labeling);
	map.Padding = 50;
	map.Render(dataDir + "lines_labeling_curved_offset_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-LinesLabelingCurvedWithOffset.cs hosted with ❤ by GitHub

W bardziej zaawansowanych scenariuszach możesz chcieć dostosować styl etykiet dynamicznie w oparciu o wartości atrybutów cech. Oto jak to zrobić:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(1000, 634))
	{
	var lineSymbolizer = new SimpleLine { Width = 1.5, Color = Color.FromArgb(0xae, 0xd9, 0xfd) };
	lineSymbolizer.FeatureBasedConfiguration = (feature, symbolizer) =>
	{
	if (feature.GetValue<string>("NAM") == "UNK")
	{
	symbolizer.Width = 1;
	symbolizer.Style = StrokeStyle.Dash;
	}
	};


	var lineLabeling = new SimpleLabeling(labelAttribute: "name")
	{
	HaloSize = 1,
	Placement = new LineLabelPlacement
	{
	Alignment = LineLabelAlignment.Parallel,
	},
	FontSize = 20,
	FeatureBasedConfiguration = (feature, labeling) =>
	{
	if (feature.GetValue<string>("NAM") == "UNK")
	{
	// change labeling properties for some features.
	labeling.FontStyle = FontStyle.Italic;
	labeling.FontSize = 10;
	labeling.Priority = -1;

	var placement = (LineLabelPlacement) labeling.Placement;
	placement.Alignment = LineLabelAlignment.Curved;
	placement.Offset = 5;
	}
	}
	};

	map.Add(VectorLayer.Open(dataDir + "lines.geojson", Drivers.GeoJson), lineSymbolizer, lineLabeling);
	map.Padding = 50;
	map.Render(dataDir + "lines_labeling_feature_based_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-LinesLabelingFeatureBased.cs hosted with ❤ by GitHub

Etykietowanie oparte na regułach