/* * Copyright (c) Contributors, http://opensimulator.org/ * See CONTRIBUTORS.TXT for a full list of copyright holders. * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions are met: * * Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * * Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * * Neither the name of the OpenSimulator Project nor the * names of its contributors may be used to endorse or promote products * derived from this software without specific prior written permission. * * THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ using System; using System.Collections.Generic; using System.IO; using System.Reflection; using log4net; using Nini.Config; using OpenMetaverse; using OpenSim.Framework; using OpenSim.Region.CoreModules.Framework.InterfaceCommander; using OpenSim.Region.CoreModules.World.Terrain.FileLoaders; using OpenSim.Region.CoreModules.World.Terrain.FloodBrushes; using OpenSim.Region.CoreModules.World.Terrain.PaintBrushes; using OpenSim.Region.Framework.Interfaces; using OpenSim.Region.Framework.Scenes; namespace OpenSim.Region.CoreModules.World.Terrain { public class TerrainModule : INonSharedRegionModule, ICommandableModule, ITerrainModule { #region StandardTerrainEffects enum /// /// A standard set of terrain brushes and effects recognised by viewers /// public enum StandardTerrainEffects : byte { Flatten = 0, Raise = 1, Lower = 2, Smooth = 3, Noise = 4, Revert = 5, // Extended brushes Erode = 255, Weather = 254, Olsen = 253 } #endregion private static readonly ILog m_log = LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType); private readonly Commander m_commander = new Commander("terrain"); private readonly Dictionary m_floodeffects = new Dictionary(); private readonly Dictionary m_loaders = new Dictionary(); private readonly Dictionary m_painteffects = new Dictionary(); private ITerrainChannel m_channel; private Dictionary m_plugineffects; private ITerrainChannel m_revert; private Scene m_scene; private volatile bool m_tainted; #region ICommandableModule Members public ICommander CommandInterface { get { return m_commander; } } #endregion #region INonSharedRegionModule Members /// /// Creates and initialises a terrain module for a region /// /// Region initialising /// Config for the region public void Initialise(IConfigSource config) { } public void AddRegion(Scene scene) { m_scene = scene; // Install terrain module in the simulator lock (m_scene) { if (m_scene.Heightmap == null) { m_channel = new TerrainChannel(); m_scene.Heightmap = m_channel; m_revert = new TerrainChannel(); UpdateRevertMap(); } else { m_channel = m_scene.Heightmap; m_revert = new TerrainChannel(); UpdateRevertMap(); } m_scene.RegisterModuleInterface(this); m_scene.EventManager.OnNewClient += EventManager_OnNewClient; m_scene.EventManager.OnPluginConsole += EventManager_OnPluginConsole; m_scene.EventManager.OnTerrainTick += EventManager_OnTerrainTick; InstallInterfaces(); } InstallDefaultEffects(); LoadPlugins(); } public void RegionLoaded(Scene scene) { } public void RemoveRegion(Scene scene) { lock (m_scene) { // remove the commands m_scene.UnregisterModuleCommander(m_commander.Name); // remove the event-handlers m_scene.EventManager.OnTerrainTick -= EventManager_OnTerrainTick; m_scene.EventManager.OnPluginConsole -= EventManager_OnPluginConsole; m_scene.EventManager.OnNewClient -= EventManager_OnNewClient; // remove the interface m_scene.UnregisterModuleInterface(this); } } public void Close() { } public string Name { get { return "TerrainModule"; } } #endregion #region ITerrainModule Members /// /// Loads a terrain file from disk and installs it in the scene. /// /// Filename to terrain file. Type is determined by extension. public void LoadFromFile(string filename) { foreach (KeyValuePair loader in m_loaders) { if (filename.EndsWith(loader.Key)) { lock (m_scene) { try { ITerrainChannel channel = loader.Value.LoadFile(filename); if (channel.Width != Constants.RegionSize || channel.Height != Constants.RegionSize) { // TerrainChannel expects a RegionSize x RegionSize map, currently throw new ArgumentException(String.Format("wrong size, use a file with size {0} x {1}", Constants.RegionSize, Constants.RegionSize)); } m_log.DebugFormat("[TERRAIN]: Loaded terrain, wd/ht: {0}/{1}", channel.Width, channel.Height); m_scene.Heightmap = channel; m_channel = channel; UpdateRevertMap(); } catch (NotImplementedException) { m_log.Error("[TERRAIN]: Unable to load heightmap, the " + loader.Value + " parser does not support file loading. (May be save only)"); throw new TerrainException(String.Format("unable to load heightmap: parser {0} does not support loading", loader.Value)); } catch (FileNotFoundException) { m_log.Error( "[TERRAIN]: Unable to load heightmap, file not found. (A directory permissions error may also cause this)"); throw new TerrainException( String.Format("unable to load heightmap: file {0} not found (or permissions do not allow access", filename)); } catch (ArgumentException e) { m_log.ErrorFormat("[TERRAIN]: Unable to load heightmap: {0}", e.Message); throw new TerrainException( String.Format("Unable to load heightmap: {0}", e.Message)); } } CheckForTerrainUpdates(); m_log.Info("[TERRAIN]: File (" + filename + ") loaded successfully"); return; } } m_log.Error("[TERRAIN]: Unable to load heightmap, no file loader available for that format."); throw new TerrainException(String.Format("unable to load heightmap from file {0}: no loader available for that format", filename)); } /// /// Saves the current heightmap to a specified file. /// /// The destination filename public void SaveToFile(string filename) { try { foreach (KeyValuePair loader in m_loaders) { if (filename.EndsWith(loader.Key)) { loader.Value.SaveFile(filename, m_channel); return; } } } catch (NotImplementedException) { m_log.Error("Unable to save to " + filename + ", saving of this file format has not been implemented."); throw new TerrainException(String.Format("Unable to save heightmap: saving of this file format not implemented")); } catch (IOException ioe) { m_log.Error(String.Format("[TERRAIN]: Unable to save to {0}, {1}", filename, ioe.Message)); throw new TerrainException(String.Format("Unable to save heightmap: {0}", ioe.Message)); } } /// /// Loads a terrain file from a stream and installs it in the scene. /// /// Filename to terrain file. Type is determined by extension. /// public void LoadFromStream(string filename, Stream stream) { foreach (KeyValuePair loader in m_loaders) { if (@filename.EndsWith(loader.Key)) { lock (m_scene) { try { ITerrainChannel channel = loader.Value.LoadStream(stream); m_scene.Heightmap = channel; m_channel = channel; UpdateRevertMap(); } catch (NotImplementedException) { m_log.Error("[TERRAIN]: Unable to load heightmap, the " + loader.Value + " parser does not support file loading. (May be save only)"); throw new TerrainException(String.Format("unable to load heightmap: parser {0} does not support loading", loader.Value)); } } CheckForTerrainUpdates(); m_log.Info("[TERRAIN]: File (" + filename + ") loaded successfully"); return; } } m_log.Error("[TERRAIN]: Unable to load heightmap, no file loader available for that format."); throw new TerrainException(String.Format("unable to load heightmap from file {0}: no loader available for that format", filename)); } /// /// Modify Land /// /// Land-position (X,Y,0) /// The size of the brush (0=small, 1=medium, 2=large) /// 0=LAND_LEVEL, 1=LAND_RAISE, 2=LAND_LOWER, 3=LAND_SMOOTH, 4=LAND_NOISE, 5=LAND_REVERT /// UUID of script-owner public void ModifyTerrain(UUID user, Vector3 pos, byte size, byte action, UUID agentId) { client_OnModifyTerrain(user, (float)pos.Z, (float)0.25, size, action, pos.Y, pos.X, pos.Y, pos.X, agentId); } /// /// Saves the current heightmap to a specified stream. /// /// The destination filename. Used here only to identify the image type /// public void SaveToStream(string filename, Stream stream) { try { foreach (KeyValuePair loader in m_loaders) { if (filename.EndsWith(loader.Key)) { loader.Value.SaveStream(stream, m_channel); return; } } } catch (NotImplementedException) { m_log.Error("Unable to save to " + filename + ", saving of this file format has not been implemented."); throw new TerrainException(String.Format("Unable to save heightmap: saving of this file format not implemented")); } } public void TaintTerrain () { CheckForTerrainUpdates(); } #region Plugin Loading Methods private void LoadPlugins() { m_plugineffects = new Dictionary(); // Load the files in the Terrain/ dir string[] files = Directory.GetFiles("Terrain"); foreach (string file in files) { m_log.Info("Loading effects in " + file); try { Assembly library = Assembly.LoadFrom(file); foreach (Type pluginType in library.GetTypes()) { try { if (pluginType.IsAbstract || pluginType.IsNotPublic) continue; string typeName = pluginType.Name; if (pluginType.GetInterface("ITerrainEffect", false) != null) { ITerrainEffect terEffect = (ITerrainEffect) Activator.CreateInstance(library.GetType(pluginType.ToString())); InstallPlugin(typeName, terEffect); } else if (pluginType.GetInterface("ITerrainLoader", false) != null) { ITerrainLoader terLoader = (ITerrainLoader) Activator.CreateInstance(library.GetType(pluginType.ToString())); m_loaders[terLoader.FileExtension] = terLoader; m_log.Info("L ... " + typeName); } } catch (AmbiguousMatchException) { } } } catch (BadImageFormatException) { } } } public void InstallPlugin(string pluginName, ITerrainEffect effect) { lock (m_plugineffects) { if (!m_plugineffects.ContainsKey(pluginName)) { m_plugineffects.Add(pluginName, effect); m_log.Info("E ... " + pluginName); } else { m_plugineffects[pluginName] = effect; m_log.Warn("E ... " + pluginName + " (Replaced)"); } } } #endregion #endregion /// /// Installs into terrain module the standard suite of brushes /// private void InstallDefaultEffects() { // Draggable Paint Brush Effects m_painteffects[StandardTerrainEffects.Raise] = new RaiseSphere(); m_painteffects[StandardTerrainEffects.Lower] = new LowerSphere(); m_painteffects[StandardTerrainEffects.Smooth] = new SmoothSphere(); m_painteffects[StandardTerrainEffects.Noise] = new NoiseSphere(); m_painteffects[StandardTerrainEffects.Flatten] = new FlattenSphere(); m_painteffects[StandardTerrainEffects.Revert] = new RevertSphere(m_revert); m_painteffects[StandardTerrainEffects.Erode] = new ErodeSphere(); m_painteffects[StandardTerrainEffects.Weather] = new WeatherSphere(); m_painteffects[StandardTerrainEffects.Olsen] = new OlsenSphere(); // Area of effect selection effects m_floodeffects[StandardTerrainEffects.Raise] = new RaiseArea(); m_floodeffects[StandardTerrainEffects.Lower] = new LowerArea(); m_floodeffects[StandardTerrainEffects.Smooth] = new SmoothArea(); m_floodeffects[StandardTerrainEffects.Noise] = new NoiseArea(); m_floodeffects[StandardTerrainEffects.Flatten] = new FlattenArea(); m_floodeffects[StandardTerrainEffects.Revert] = new RevertArea(m_revert); // Filesystem load/save loaders m_loaders[".r32"] = new RAW32(); m_loaders[".f32"] = m_loaders[".r32"]; m_loaders[".ter"] = new Terragen(); m_loaders[".raw"] = new LLRAW(); m_loaders[".jpg"] = new JPEG(); m_loaders[".jpeg"] = m_loaders[".jpg"]; m_loaders[".bmp"] = new BMP(); m_loaders[".png"] = new PNG(); m_loaders[".gif"] = new GIF(); m_loaders[".tif"] = new TIFF(); m_loaders[".tiff"] = m_loaders[".tif"]; } /// /// Saves the current state of the region into the revert map buffer. /// public void UpdateRevertMap() { int x; for (x = 0; x < m_channel.Width; x++) { int y; for (y = 0; y < m_channel.Height; y++) { m_revert[x, y] = m_channel[x, y]; } } } /// /// Loads a tile from a larger terrain file and installs it into the region. /// /// The terrain file to load /// The width of the file in units /// The height of the file in units /// Where to begin our slice /// Where to begin our slice public void LoadFromFile(string filename, int fileWidth, int fileHeight, int fileStartX, int fileStartY) { int offsetX = (int) m_scene.RegionInfo.RegionLocX - fileStartX; int offsetY = (int) m_scene.RegionInfo.RegionLocY - fileStartY; if (offsetX >= 0 && offsetX < fileWidth && offsetY >= 0 && offsetY < fileHeight) { // this region is included in the tile request foreach (KeyValuePair loader in m_loaders) { if (filename.EndsWith(loader.Key)) { lock (m_scene) { ITerrainChannel channel = loader.Value.LoadFile(filename, offsetX, offsetY, fileWidth, fileHeight, (int) Constants.RegionSize, (int) Constants.RegionSize); m_scene.Heightmap = channel; m_channel = channel; UpdateRevertMap(); } return; } } } } /// /// Performs updates to the region periodically, synchronising physics and other heightmap aware sections /// private void EventManager_OnTerrainTick() { if (m_tainted) { m_tainted = false; m_scene.PhysicsScene.SetTerrain(m_channel.GetFloatsSerialised()); m_scene.SaveTerrain(); // Clients who look at the map will never see changes after they looked at the map, so i've commented this out. //m_scene.CreateTerrainTexture(true); } } /// /// Processes commandline input. Do not call directly. /// /// Commandline arguments private void EventManager_OnPluginConsole(string[] args) { if (args[0] == "terrain") { if (args.Length == 1) { m_commander.ProcessConsoleCommand("help", new string[0]); return; } string[] tmpArgs = new string[args.Length - 2]; int i; for (i = 2; i < args.Length; i++) tmpArgs[i - 2] = args[i]; m_commander.ProcessConsoleCommand(args[1], tmpArgs); } } /// /// Installs terrain brush hook to IClientAPI /// /// private void EventManager_OnNewClient(IClientAPI client) { client.OnModifyTerrain += client_OnModifyTerrain; client.OnBakeTerrain += client_OnBakeTerrain; } /// /// Checks to see if the terrain has been modified since last check /// but won't attempt to limit those changes to the limits specified in the estate settings /// currently invoked by the command line operations in the region server only /// private void CheckForTerrainUpdates() { CheckForTerrainUpdates(false); } /// /// Checks to see if the terrain has been modified since last check. /// If it has been modified, every all the terrain patches are sent to the client. /// If the call is asked to respect the estate settings for terrain_raise_limit and /// terrain_lower_limit, it will clamp terrain updates between these values /// currently invoked by client_OnModifyTerrain only and not the Commander interfaces /// should height map deltas be limited to the estate settings limits /// private void CheckForTerrainUpdates(bool respectEstateSettings) { bool shouldTaint = false; float[] serialised = m_channel.GetFloatsSerialised(); int x; for (x = 0; x < m_channel.Width; x += Constants.TerrainPatchSize) { int y; for (y = 0; y < m_channel.Height; y += Constants.TerrainPatchSize) { if (m_channel.Tainted(x, y)) { // if we should respect the estate settings then // fixup and height deltas that don't respect them if (respectEstateSettings && LimitChannelChanges(x, y)) { // this has been vetoed, so update // what we are going to send to the client serialised = m_channel.GetFloatsSerialised(); } SendToClients(serialised, x, y); shouldTaint = true; } } } if (shouldTaint) { m_tainted = true; } } /// /// Checks to see height deltas in the tainted terrain patch at xStart ,yStart /// are all within the current estate limits /// true if changes were limited, false otherwise /// private bool LimitChannelChanges(int xStart, int yStart) { bool changesLimited = false; double minDelta = m_scene.RegionInfo.RegionSettings.TerrainLowerLimit; double maxDelta = m_scene.RegionInfo.RegionSettings.TerrainRaiseLimit; // loop through the height map for this patch and compare it against // the revert map for (int x = xStart; x < xStart + Constants.TerrainPatchSize; x++) { for (int y = yStart; y < yStart + Constants.TerrainPatchSize; y++) { double requestedHeight = m_channel[x, y]; double bakedHeight = m_revert[x, y]; double requestedDelta = requestedHeight - bakedHeight; if (requestedDelta > maxDelta) { m_channel[x, y] = bakedHeight + maxDelta; changesLimited = true; } else if (requestedDelta < minDelta) { m_channel[x, y] = bakedHeight + minDelta; //as lower is a -ve delta changesLimited = true; } } } return changesLimited; } /// /// Sends a copy of the current terrain to the scenes clients /// /// A copy of the terrain as a 1D float array of size w*h /// The patch corner to send /// The patch corner to send private void SendToClients(float[] serialised, int x, int y) { m_scene.ForEachClient( delegate(IClientAPI controller) { controller.SendLayerData( x / Constants.TerrainPatchSize, y / Constants.TerrainPatchSize, serialised); } ); } private void client_OnModifyTerrain(UUID user, float height, float seconds, byte size, byte action, float north, float west, float south, float east, UUID agentId) { bool god = m_scene.Permissions.IsGod(user); bool allowed = false; if (north == south && east == west) { if (m_painteffects.ContainsKey((StandardTerrainEffects) action)) { bool[,] allowMask = new bool[m_channel.Width,m_channel.Height]; allowMask.Initialize(); int n = size + 1; if (n > 2) n = 4; int zx = (int) (west + 0.5); int zy = (int) (north + 0.5); int dx; for (dx=-n; dx<=n; dx++) { int dy; for (dy=-n; dy<=n; dy++) { int x = zx + dx; int y = zy + dy; if (x>=0 && y>=0 && x west) { if (y < north && y > south) { if (m_scene.Permissions.CanTerraformLand(agentId, new Vector3(x,y,0))) { fillArea[x, y] = true; allowed = true; } } } } } if (allowed) { m_floodeffects[(StandardTerrainEffects) action].FloodEffect( m_channel, fillArea, size); CheckForTerrainUpdates(!god); //revert changes outside estate limits } } else { m_log.Debug("Unknown terrain flood type " + action); } } } private void client_OnBakeTerrain(IClientAPI remoteClient) { // Not a good permissions check (see client_OnModifyTerrain above), need to check the entire area. // for now check a point in the centre of the region if (m_scene.Permissions.CanIssueEstateCommand(remoteClient.AgentId, true)) { InterfaceBakeTerrain(null); //bake terrain does not use the passed in parameter } } #region Console Commands private void InterfaceLoadFile(Object[] args) { LoadFromFile((string) args[0]); CheckForTerrainUpdates(); } private void InterfaceLoadTileFile(Object[] args) { LoadFromFile((string) args[0], (int) args[1], (int) args[2], (int) args[3], (int) args[4]); CheckForTerrainUpdates(); } private void InterfaceSaveFile(Object[] args) { SaveToFile((string) args[0]); } private void InterfaceBakeTerrain(Object[] args) { UpdateRevertMap(); } private void InterfaceRevertTerrain(Object[] args) { int x, y; for (x = 0; x < m_channel.Width; x++) for (y = 0; y < m_channel.Height; y++) m_channel[x, y] = m_revert[x, y]; CheckForTerrainUpdates(); } private void InterfaceFlipTerrain(Object[] args) { String direction = (String)args[0]; if (direction.ToLower().StartsWith("y")) { for (int x = 0; x < Constants.RegionSize; x++) { for (int y = 0; y < Constants.RegionSize / 2; y++) { double height = m_channel[x, y]; double flippedHeight = m_channel[x, (int)Constants.RegionSize - 1 - y]; m_channel[x, y] = flippedHeight; m_channel[x, (int)Constants.RegionSize - 1 - y] = height; } } } else if (direction.ToLower().StartsWith("x")) { for (int y = 0; y < Constants.RegionSize; y++) { for (int x = 0; x < Constants.RegionSize / 2; x++) { double height = m_channel[x, y]; double flippedHeight = m_channel[(int)Constants.RegionSize - 1 - x, y]; m_channel[x, y] = flippedHeight; m_channel[(int)Constants.RegionSize - 1 - x, y] = height; } } } else { m_log.Error("Unrecognised direction - need x or y"); } CheckForTerrainUpdates(); } private void InterfaceRescaleTerrain(Object[] args) { double desiredMin = (double)args[0]; double desiredMax = (double)args[1]; // determine desired scaling factor double desiredRange = desiredMax - desiredMin; //m_log.InfoFormat("Desired {0}, {1} = {2}", new Object[] { desiredMin, desiredMax, desiredRange }); if (desiredRange == 0d) { // delta is zero so flatten at requested height InterfaceFillTerrain(new Object[] { args[1] }); } else { //work out current heightmap range double currMin = double.MaxValue; double currMax = double.MinValue; int width = m_channel.Width; int height = m_channel.Height; for (int x = 0; x < width; x++) { for (int y = 0; y < height; y++) { double currHeight = m_channel[x, y]; if (currHeight < currMin) { currMin = currHeight; } else if (currHeight > currMax) { currMax = currHeight; } } } double currRange = currMax - currMin; double scale = desiredRange / currRange; //m_log.InfoFormat("Current {0}, {1} = {2}", new Object[] { currMin, currMax, currRange }); //m_log.InfoFormat("Scale = {0}", scale); // scale the heightmap accordingly for (int x = 0; x < width; x++) { for (int y = 0; y < height; y++) { double currHeight = m_channel[x, y] - currMin; m_channel[x, y] = desiredMin + (currHeight * scale); } } CheckForTerrainUpdates(); } } private void InterfaceElevateTerrain(Object[] args) { int x, y; for (x = 0; x < m_channel.Width; x++) for (y = 0; y < m_channel.Height; y++) m_channel[x, y] += (double) args[0]; CheckForTerrainUpdates(); } private void InterfaceMultiplyTerrain(Object[] args) { int x, y; for (x = 0; x < m_channel.Width; x++) for (y = 0; y < m_channel.Height; y++) m_channel[x, y] *= (double) args[0]; CheckForTerrainUpdates(); } private void InterfaceLowerTerrain(Object[] args) { int x, y; for (x = 0; x < m_channel.Width; x++) for (y = 0; y < m_channel.Height; y++) m_channel[x, y] -= (double) args[0]; CheckForTerrainUpdates(); } private void InterfaceFillTerrain(Object[] args) { int x, y; for (x = 0; x < m_channel.Width; x++) for (y = 0; y < m_channel.Height; y++) m_channel[x, y] = (double) args[0]; CheckForTerrainUpdates(); } private void InterfaceShowDebugStats(Object[] args) { double max = Double.MinValue; double min = double.MaxValue; double sum = 0; int x; for (x = 0; x < m_channel.Width; x++) { int y; for (y = 0; y < m_channel.Height; y++) { sum += m_channel[x, y]; if (max < m_channel[x, y]) max = m_channel[x, y]; if (min > m_channel[x, y]) min = m_channel[x, y]; } } double avg = sum / (m_channel.Height * m_channel.Width); m_log.Info("Channel " + m_channel.Width + "x" + m_channel.Height); m_log.Info("max/min/avg/sum: " + max + "/" + min + "/" + avg + "/" + sum); } private void InterfaceEnableExperimentalBrushes(Object[] args) { if ((bool) args[0]) { m_painteffects[StandardTerrainEffects.Revert] = new WeatherSphere(); m_painteffects[StandardTerrainEffects.Flatten] = new OlsenSphere(); m_painteffects[StandardTerrainEffects.Smooth] = new ErodeSphere(); } else { InstallDefaultEffects(); } } private void InterfaceRunPluginEffect(Object[] args) { if ((string) args[0] == "list") { m_log.Info("List of loaded plugins"); foreach (KeyValuePair kvp in m_plugineffects) { m_log.Info(kvp.Key); } return; } if ((string) args[0] == "reload") { LoadPlugins(); return; } if (m_plugineffects.ContainsKey((string) args[0])) { m_plugineffects[(string) args[0]].RunEffect(m_channel); CheckForTerrainUpdates(); } else { m_log.Warn("No such plugin effect loaded."); } } private void InstallInterfaces() { // Load / Save string supportedFileExtensions = ""; foreach (KeyValuePair loader in m_loaders) supportedFileExtensions += " " + loader.Key + " (" + loader.Value + ")"; Command loadFromFileCommand = new Command("load", CommandIntentions.COMMAND_HAZARDOUS, InterfaceLoadFile, "Loads a terrain from a specified file."); loadFromFileCommand.AddArgument("filename", "The file you wish to load from, the file extension determines the loader to be used. Supported extensions include: " + supportedFileExtensions, "String"); Command saveToFileCommand = new Command("save", CommandIntentions.COMMAND_NON_HAZARDOUS, InterfaceSaveFile, "Saves the current heightmap to a specified file."); saveToFileCommand.AddArgument("filename", "The destination filename for your heightmap, the file extension determines the format to save in. Supported extensions include: " + supportedFileExtensions, "String"); Command loadFromTileCommand = new Command("load-tile", CommandIntentions.COMMAND_HAZARDOUS, InterfaceLoadTileFile, "Loads a terrain from a section of a larger file."); loadFromTileCommand.AddArgument("filename", "The file you wish to load from, the file extension determines the loader to be used. Supported extensions include: " + supportedFileExtensions, "String"); loadFromTileCommand.AddArgument("file width", "The width of the file in tiles", "Integer"); loadFromTileCommand.AddArgument("file height", "The height of the file in tiles", "Integer"); loadFromTileCommand.AddArgument("minimum X tile", "The X region coordinate of the first section on the file", "Integer"); loadFromTileCommand.AddArgument("minimum Y tile", "The Y region coordinate of the first section on the file", "Integer"); // Terrain adjustments Command fillRegionCommand = new Command("fill", CommandIntentions.COMMAND_HAZARDOUS, InterfaceFillTerrain, "Fills the current heightmap with a specified value."); fillRegionCommand.AddArgument("value", "The numeric value of the height you wish to set your region to.", "Double"); Command elevateCommand = new Command("elevate", CommandIntentions.COMMAND_HAZARDOUS, InterfaceElevateTerrain, "Raises the current heightmap by the specified amount."); elevateCommand.AddArgument("amount", "The amount of height to add to the terrain in meters.", "Double"); Command lowerCommand = new Command("lower", CommandIntentions.COMMAND_HAZARDOUS, InterfaceLowerTerrain, "Lowers the current heightmap by the specified amount."); lowerCommand.AddArgument("amount", "The amount of height to remove from the terrain in meters.", "Double"); Command multiplyCommand = new Command("multiply", CommandIntentions.COMMAND_HAZARDOUS, InterfaceMultiplyTerrain, "Multiplies the heightmap by the value specified."); multiplyCommand.AddArgument("value", "The value to multiply the heightmap by.", "Double"); Command bakeRegionCommand = new Command("bake", CommandIntentions.COMMAND_HAZARDOUS, InterfaceBakeTerrain, "Saves the current terrain into the regions revert map."); Command revertRegionCommand = new Command("revert", CommandIntentions.COMMAND_HAZARDOUS, InterfaceRevertTerrain, "Loads the revert map terrain into the regions heightmap."); Command flipCommand = new Command("flip", CommandIntentions.COMMAND_HAZARDOUS, InterfaceFlipTerrain, "Flips the current terrain about the X or Y axis"); flipCommand.AddArgument("direction", "[x|y] the direction to flip the terrain in", "String"); Command rescaleCommand = new Command("rescale", CommandIntentions.COMMAND_HAZARDOUS, InterfaceRescaleTerrain, "Rescales the current terrain to fit between the given min and max heights"); rescaleCommand.AddArgument("min", "min terrain height after rescaling", "Double"); rescaleCommand.AddArgument("max", "max terrain height after rescaling", "Double"); // Debug Command showDebugStatsCommand = new Command("stats", CommandIntentions.COMMAND_STATISTICAL, InterfaceShowDebugStats, "Shows some information about the regions heightmap for debugging purposes."); Command experimentalBrushesCommand = new Command("newbrushes", CommandIntentions.COMMAND_HAZARDOUS, InterfaceEnableExperimentalBrushes, "Enables experimental brushes which replace the standard terrain brushes. WARNING: This is a debug setting and may be removed at any time."); experimentalBrushesCommand.AddArgument("Enabled?", "true / false - Enable new brushes", "Boolean"); //Plugins Command pluginRunCommand = new Command("effect", CommandIntentions.COMMAND_HAZARDOUS, InterfaceRunPluginEffect, "Runs a specified plugin effect"); pluginRunCommand.AddArgument("name", "The plugin effect you wish to run, or 'list' to see all plugins", "String"); m_commander.RegisterCommand("load", loadFromFileCommand); m_commander.RegisterCommand("load-tile", loadFromTileCommand); m_commander.RegisterCommand("save", saveToFileCommand); m_commander.RegisterCommand("fill", fillRegionCommand); m_commander.RegisterCommand("elevate", elevateCommand); m_commander.RegisterCommand("lower", lowerCommand); m_commander.RegisterCommand("multiply", multiplyCommand); m_commander.RegisterCommand("bake", bakeRegionCommand); m_commander.RegisterCommand("revert", revertRegionCommand); m_commander.RegisterCommand("newbrushes", experimentalBrushesCommand); m_commander.RegisterCommand("stats", showDebugStatsCommand); m_commander.RegisterCommand("effect", pluginRunCommand); m_commander.RegisterCommand("flip", flipCommand); m_commander.RegisterCommand("rescale", rescaleCommand); // Add this to our scene so scripts can call these functions m_scene.RegisterModuleCommander(m_commander); } #endregion } }