#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
#endregion
}
}