Additional Components

Additional Components

World Map 2D Edition includes four extra components that extend the map's functionality. Each can be enabled from the Inspector (buttons at the bottom of the WorldMap2D component) or from code via accessor properties.

Calculator

Converts coordinates between different systems and calculates real-world distances.

Inspector

Coordinate Conversion from Code

Access via map.calc. The conversion workflow:

1. Set the source unit: calc.fromUnit = UNIT_TYPE.DecimalDegrees
2. Assign source values: calc.fromLatDec = -15.281f
3. Call calc.Convert()
4. Read results from calc.to* fields

WorldMap2D map = WorldMap2D.instance;

// Convert from Decimal Degrees
map.calc.fromUnit = UNIT_TYPE.DecimalDegrees;
map.calc.fromLatDec = 40.4168f;
map.calc.fromLonDec = -3.7038f;
map.calc.Convert();
Debug.Log($"Plane: ({map.calc.toX}, {map.calc.toY})");

// Convert from Degrees (DMS)
map.calc.fromUnit = UNIT_TYPE.Degrees;
map.calc.fromLatDegrees = 40; map.calc.fromLatMinutes = 25; map.calc.fromLatSeconds = 0;
map.calc.fromLonDegrees = -3; map.calc.fromLonMinutes = 42; map.calc.fromLonSeconds = 14;
map.calc.Convert();

// Convert from Plane Coordinates
map.calc.fromUnit = UNIT_TYPE.PlaneCoordinates;
map.calc.fromX = 0.12f; map.calc.fromY = 0.34f;
map.calc.Convert();

Distance Calculator

Calculate real-world distance in meters between two points:

// By coordinates
float dist = map.calc.Distance(40.4168f, -3.7038f, 48.8566f, 2.3522f);

// By city objects
float dist = map.calc.Distance(city1, city2);

Ticker

Displays scrolling or static text banners over the map. Useful for news tickers, alerts, and notifications.

Inspector

Ticker Bands

There are 9 available ticker bands (configurable). Each band has:

Ticker Text Options

Ticker API

WorldMap2D map = WorldMap2D.instance;
map.ticker.ResetTickerBands();

// Configure a red static band
TickerBand band = map.ticker.tickerBands[0];
band.verticalOffset = 0.2f;
band.backgroundColor = new Color(1, 0, 0, 0.9f);
band.scrollSpeed = 0;   // static
band.visible = true;
band.autoHide = true;

// Add a blinking text
TickerText text = new TickerText(0, "WARNING!!");
text.textColor = Color.yellow;
text.blinkInterval = 0.2f;
text.horizontalOffset = 0.1f;
text.duration = 10f;
map.ticker.AddTickerText(text);

// Configure a scrolling blue band
TickerBand band2 = map.ticker.tickerBands[1];
band2.verticalOffset = 0.1f;
band2.verticalSize = 0.05f;
band2.backgroundColor = new Color(0, 0, 1, 0.9f);
band2.visible = true;
band2.autoHide = true;

TickerText text2 = new TickerText(1, "INCOMING MESSAGE!!");
text2.textColor = Color.white;
map.ticker.AddTickerText(text2);

Ticker API Reference

Decorator

Customizes the visual appearance of individual countries: labels, colors, and textures.

Decorator API

CountryDecorator Properties

Map Editor

An in-editor tool for modifying borders, countries, provinces, and cities interactively. Open it by clicking Open Editor at the bottom of the WorldMap2D inspector.

Configuration

Toolbar Modes

Reshape Tools

Create Mode

Countries and provinces consist of one or more regions. You can add new regions to an existing entity or create entirely new countries/provinces. The main region is always the largest by area.

Gear Menu Options

World Flags & Weather Symbols

Available as a separate purchase, this package includes 270+ vector and raster country flag images. Flag file names match the country names used in the map, enabling easy texture mapping:

WorldMap2D map = WorldMap2D.instance;
string countryName = "China";

Texture2D flag = Resources.Load<Texture2D>("Flags/png/" + countryName);
int idx = map.GetCountryIndex(countryName);
map.ToggleCountryMainRegionSurface(idx, true, flag);