#region ================== Copyright (c) 2007 Pascal vd Heiden /* * Copyright (c) 2007 Pascal vd Heiden, www.codeimp.com * This program is released under GNU General Public License * * This program 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 General Public License for more details. * */ #endregion #region ================== Namespaces using System; using System.Collections.Generic; using System.Globalization; using System.Windows.Forms; using System.Reflection; using System.Diagnostics; using CodeImp.DoomBuilder.Actions; using CodeImp.DoomBuilder.Geometry; using CodeImp.DoomBuilder.Config; using CodeImp.DoomBuilder.Windows; #endregion namespace CodeImp.DoomBuilder.Editing { /// /// Provides basic user input interface functionality for a Doom Builder editing mode. /// public abstract class EditMode { #region ================== Constants public const int DRAG_START_MOVE_PIXELS = 5; #endregion #region ================== Variables // Attributes protected EditModeAttribute attributes; //mxd. private -> protected // Disposing protected bool isdisposed; #endregion #region ================== Properties public bool IsDisposed { get { return isdisposed; } } public EditModeAttribute Attributes { get { return attributes; } } // Unless overriden, this returns the name of this mode // for checking the appropriate button on the toolbar. public virtual string EditModeButtonName { get { return GetType().Name; } } // Override this to provide a highlighted object, if applicable public virtual object HighlightedObject { get { return null; } } #endregion #region ================== Constructor / Disposer /// /// Provides basic user input interface functionality for a Doom Builder editing mode. /// protected EditMode() { // Fetch attributes object[] attrs = this.GetType().GetCustomAttributes(true); foreach(object a in attrs) { EditModeAttribute attribute = a as EditModeAttribute; if(attribute != null) { attributes = attribute; break; } } // No attributes found? if(attributes == null) throw new Exception("Editing mode \"" + this.GetType().Name + "\" is missing EditMode attributes!"); // We have no destructor GC.SuppressFinalize(this); } // Disposer public virtual void Dispose() { // Not already disposed? if(!isdisposed) { // Clean up // Done isdisposed = true; } } #endregion #region ================== Static Methods // This creates an instance of a specific mode public static EditMode Create(Type modetype, object[] args) { try { // Create new mode return (EditMode)General.ThisAssembly.CreateInstance(modetype.FullName, false, BindingFlags.Default, null, args, CultureInfo.CurrentCulture, new object[0]); } // Catch errors catch(TargetInvocationException e) { // Throw the actual exception Debug.WriteLine(DateTime.Now.ToShortDateString() + " " + DateTime.Now.ToShortTimeString()); Debug.WriteLine(e.InnerException.Source + " throws " + e.InnerException.GetType().Name + ":"); Debug.WriteLine(e.InnerException.Message); Debug.WriteLine(e.InnerException.StackTrace); throw e.InnerException; } } #endregion #region ================== Methods //mxd public virtual void UpdateSelectionInfo() { // Collect info List info = new List(); if(General.Map.Map.SelectedSectorsCount > 0) info.Add(General.Map.Map.SelectedSectorsCount + (General.Map.Map.SelectedSectorsCount == 1 ? " sector" : " sectors")); if(General.Map.Map.SelectedLinedefsCount > 0) info.Add(General.Map.Map.SelectedLinedefsCount + (General.Map.Map.SelectedLinedefsCount == 1 ? " linedef" : " linedefs")); if(General.Map.Map.SelectedVerticessCount > 0) info.Add(General.Map.Map.SelectedVerticessCount + (General.Map.Map.SelectedVerticessCount == 1 ? " vertex" : " vertices")); if(General.Map.Map.SelectedThingsCount > 0) info.Add(General.Map.Map.SelectedThingsCount + (General.Map.Map.SelectedThingsCount == 1 ? " thing" : " things")); // Display results string result = string.Empty; if(info.Count > 0) { result = string.Join(", ", info.ToArray()); int pos = result.LastIndexOf(",", StringComparison.Ordinal); if(pos != -1) result = result.Remove(pos, 1).Insert(pos, " and"); result += " selected."; } General.Interface.DisplayStatus(StatusType.Selection, result); } #endregion #region ================== Events // // Order in which events occur for the old and new modes: // // - Constructor of new mode is called // - Disengage of old mode is called // ----- Mode switches ----- // - Engage of new mode is called // - Dispose of old mode is called // // Mode engages public virtual void OnEngage() { // Bind any methods General.Actions.BindMethods(this); //mxd. Show hints for this mode General.Hints.ShowHints(this.GetType(), HintsManager.GENERAL); //mxd. Display new mode name General.Interface.HideInfo(); } // Mode disengages public virtual void OnDisengage() { // Unbind any methods General.Actions.UnbindMethods(this); } // Called when the user presses F1 for Help public virtual void OnHelp() { } // This forces the mode to cancel and return to the "parent" mode public virtual void OnCancel() { } public virtual void OnAccept() { } // Called before copying. Return false when copying should be cancelled. // The edit mode should mark all vertices, lines and sectors // that need to be copied. public virtual bool OnCopyBegin() { return false; } // Called when the marked geometry has been copied. public virtual void OnCopyEnd() { } // Called before pasting. Override this and return true to indicate that paste is allowed to contiue. public virtual bool OnPasteBegin(PasteOptions options) { return false; } // Called after new geometry has been pasted in. The new geometry is marked. public virtual void OnPasteEnd(PasteOptions options) { } // Called when undo/redo is used // Return false to cancel undo action public virtual bool OnUndoBegin() { return true; } public virtual bool OnRedoBegin() { return true; } public virtual void OnUndoEnd() { General.Map.Renderer2D.UpdateExtraFloorFlag(); } //mxd public virtual void OnRedoEnd() { General.Map.Renderer2D.UpdateExtraFloorFlag(); } //mxd // Interface events public virtual void OnMouseClick(MouseEventArgs e) { } public virtual void OnMouseDoubleClick(MouseEventArgs e) { } public virtual void OnMouseDown(MouseEventArgs e) { } public virtual void OnMouseEnter(EventArgs e) { } public virtual void OnMouseLeave(EventArgs e) { } public virtual void OnMouseMove(MouseEventArgs e) { } public virtual void OnMouseUp(MouseEventArgs e) { } public virtual void OnKeyDown(KeyEventArgs e) { } public virtual void OnKeyUp(KeyEventArgs e) { } public virtual void OnMouseInput(Vector2D delta) { } // Rendering events public virtual void OnRedrawDisplay() { } public virtual void OnPresentDisplay() { } // Processing events public virtual void OnProcess(long deltatime) { } public virtual void OnClockReset() { } //mxd // Generic events public virtual void OnReloadResources() { } public virtual void OnMapSetChangeBegin() { } public virtual void OnMapSetChangeEnd() { } //mxd. map testing events public virtual bool OnMapTestBegin(bool testFromCurrentPosition) { return true; } //called before test map is launched. Returns false if map launch is impossible public virtual void OnMapTestEnd(bool testFromCurrentPosition) { } //called after game engine is closed // Script events public virtual bool OnScriptRunBegin() { return true; } public virtual void OnScriptRunEnd() { } // This should be called by global actions (i.e. that are not part of an editing mode) when they changed map elements, // so that the mode can react to it (for example by rebuilding a blockmap) public virtual void OnMapElementsChanged() { } public virtual bool OnAutoSaveBegin() { return attributes.Volatile ? false : true; } // Called before autosave is done. Returns false if autosave should not be done. By default volatile modes prevent autosave public virtual void OnAutoSaveEnd() { } #endregion } }