DebugConsole

From Unify Community Wiki
(Difference between revisions)
Jump to: navigation, search
(Updated script to newest version and reworked the usage.)
 
(20 intermediate revisions by 9 users not shown)
Line 4: Line 4:
 
[[Category: MonoBehaviour]]
 
[[Category: MonoBehaviour]]
 
Author: Jeremy Hollingsworth (jeremyace)
 
Author: Jeremy Hollingsworth (jeremyace)
 +
<BR>
 +
Modifications by:
 +
* Simon Waite (opless) 22 Feb 2006
 +
*Shinsuke Sugita (shinriyo) Dec 2015
 +
 
== Description ==
 
== Description ==
This script will control a GUIText object to generate a scrolling console-like debug feeback pane.  Allows you to set one of three colors (normal, warning, error) to each line to get more feedback.
+
This script will create a scrolling debug console.  Allows you to set one of three colors (normal, warning, error) to each line to get more feedback and is mouse draggable at runtime.
  
 
== Usage ==
 
== Usage ==
<b>This C# script _must_ be placed in the Standard Assets folder to be called from JavaScript.</b>
+
Drop the DebugConsole script into your Standard Assets folder (This is a <b>requirement</b>).  It is now fully usable.
  
<BR><b>UPDATED:</b> You no longer have to set your own GUIText in the scene.  This script will create a GUIText at <i>Vector3 defaultGuiPosition</i> with a scale of <i>Vector3 defaultGuiScale</i>.  If you wish to provide your own GUIText object to set your own font, etc, then drag your GUIText to the Debug GUI field of the DebugGUIController script.
+
If you want to change the default settings (like colors, or change the GUIText object), then create an empty GameObject and drag this script onto it from the standard assets folderYou now have access to all of the default settings in the inspector. The settings are explained below. 
 
+
<BR><b>Create a new blank GameObject (GameObject->Create Empty) and then drag the DebugGUIController.cs script to it.  It is now fully usable with the default settings.</b>
+
  
 
<BR><b>Settings:</b>
 
<BR><b>Settings:</b>
* Debug GUI : Drag the guiText you created here if you wish to override the default.
+
* <b>Debug GUI</b> : Drag the guiText you created here if you wish to override the default.
* defaultGuiPosition : A vector for the starting position of the first line of output.  If you provide your own GUIText then it's position overrides this property.
+
* <b>defaultGuiPosition</b> : A vector for the starting position of the first line of output.  If you provide your own GUIText then it's position overrides this property.
* defaultGuiScale : A vector for the scale of the individual lines.  Again, this is overridden if you provide your own GUIText.  
+
* <b>defaultGuiScale</b> : A vector for the scale of the individual lines.  Again, this is overridden if you provide your own GUIText.  
* The three colors are for normal, warning, and error.  Set to whatever you like or leave alone.
+
* <b>The three colors</b> : are for normal, warning, and error.  Set to whatever you like or leave alone.
* Max messages : How many message lines we will put on the screen at once.  This number depends on the size of your guiText.
+
* <b>Max messages</b> : How many message lines we will put on the screen at once.
* Line Spacing : A float for how far down we will move each new line.
+
* <b>Line Spacing</b> : A float for how far down we will move each new line.
* Show On Screen : The default setting for visibility of the debug output.  If set to false (unchecked), you can send data but it wont show until you tell it to, if set to true (checked) it will show all debug output until you tell it not to.
+
* <b>Draggable</b> : True means you can drag the output around with the mouse at runtime, false means position is locked from mouse input.  To drag output at runtime, click once on the uppermost output line to connect it to the mouse, then move to where you want the output displayed and click the mouse again to release it.
 +
* <b>Visible</b> : The default setting for visibility of the debug output.  If set to false (unchecked), you can send data but it wont show until you tell it to, if set to true (checked) it will show all debug output until you tell it not to.
 +
* <b>PixelCorrect</b> : If set to <i>true</i> and LineSpacing to be on-screen pixels or not, very much like the GUIText property of the same name. Default: <i>false</i> LineSpacing will be in screen coordinates (0.0 - 1.0)
  
<BR><b>Using the Debug script from your scripts:</b>
+
<BR><b>Using the DebugConsole script from your scripts:</b>
<BR>To call the DebugGUIController script from your scripts, just type:
+
<BR>To call the DebugConsole script from your scripts, just type:
  
<BR>DebugGUIController.instance.<i><b>someFunction()</b></i>
+
<BR><b>DebugConsole</b>.<i>someFunction()</i>
  
<BR>Replace <i><b>someFunction()</b></i> with any of the following:
+
<BR>Replace <i>someFunction()</i> with any of the following:
  
<BR><b>AddMessage</b>(<b>string</b> <i>message</i>, <b>string</b> <i>color</i>)
+
<BR><b>Log</b> (<b>string</b> <i>message</i>, <b>string</b> <i>color</i>)
 
* Adds a message to the list.  The color is a string either <i>"normal", "warning" or "error"</i>.  The color argument is optional and if omitted, the color will default to "normal".
 
* Adds a message to the list.  The color is a string either <i>"normal", "warning" or "error"</i>.  The color argument is optional and if omitted, the color will default to "normal".
  
<BR><b>ClearMessages()</b>
+
<BR><b>Clear()</b>
 
* Clears all of the messages from the list and the screen.
 
* Clears all of the messages from the list and the screen.
  
<BR><b>Hide()</b>
+
<BR><B>To toggle the visibility use:</b>
* Hides the display of the output. Does not reset the contents of the list (same as setting Show On Screen to false in the inspector)
+
<BR><b>isVisible</b> (true, false)
 +
* The property to set the visiblility of the debug output. This property _not_ clear the message list, just hides it. You need to use the Clear() method to clear the list.
  
<BR><b>Show()</b>
+
<BR><B>To toggle the mouse drag functionality use:</b>
* Shows the previously hidden display.
+
<BR><b>isDraggable</b> (true, false)
  
 
<BR>So for a simple example, to add hello world in warning color (yellow), we type:
 
<BR>So for a simple example, to add hello world in warning color (yellow), we type:
DebugGUIController.instance.AddMessage("hello world", "warning");
+
DebugConsole.Log("hello world", "warning");
  
== C# - DebugGUIController.cs ==
+
<BR>To hide the output we type:
The script _must_ be named DebugGUIController.cs
+
DebugConsole.isVisible = false;
<csharp>
+
//------ DebugGUIController.cs -------------------
+
// Script for handling multi-line, multi-colored
+
// GUI debugging output.
+
// Author: Jeremy Hollingsworth (jeremyace)
+
// Version: 1.0
+
//------------------------------------------------
+
using UnityEngine;
+
using System.Collections;
+
  
 +
== C# - DebugConsole.cs ==
 +
The script _must_ be named DebugConsole.cs
  
public class DebugGUIController : MonoBehaviour
+
<syntaxhighlight lang="csharp">
{
+
/*==== DebugConsole.cs ====================================================
 +
* Class for handling multi-line, multi-color debugging messages.
 +
* Original Author: Jeremy Hollingsworth
 +
* Based On: Version 1.2.1 Mar 02, 2006
 +
*
 +
* Modified: Simon Waite
 +
* Date: 22 Feb 2007
 +
*
 +
* Modified: Shinsuke Sugita
 +
* Date: 1 Dec 2015
 +
*
 +
* Modification to original script to allow pixel-correct line spacing
 +
*
 +
* Setting the boolean pixelCorrect changes the units in lineSpacing property
 +
* to pixels, so you have a pixel correct gui font in your console.
 +
*
 +
* It also checks every frame if the screen is resized to make sure the
 +
* line spacing is correct (To see this; drag and let go in the editor
 +
* and the text spacing will snap back)
 +
*
 +
* USAGE:
 +
* ::Drop in your standard assets folder (if you want to change any of the
 +
* default settings in the inspector, create an empty GameObject and attach
 +
* this script to it from you standard assets folder.  That will provide
 +
* access to the default settings in the inspector)
 +
*
 +
* ::To use, call DebugConsole.functionOrProperty() where
 +
* functionOrProperty = one of the following:
 +
*
 +
* -Log(string message, string color)  Adds "message" to the list with the
 +
* "color" color. Color is optional and can be any of the following: "error",
 +
* "warning", or "normal".  Default is normal.
 +
*
 +
* Clear() Clears all messages
 +
*
 +
* isVisible (true,false)  Toggles the visibility of the output.  Does _not_
 +
* clear the messages.
 +
*
 +
* isDraggable (true, false)  Toggles mouse drag functionality
 +
* =========================================================================*/
  
    public GameObject DebugGui = null;            // The GUI that will be duplicated
 
    public Vector3 defaultGuiPosition = new Vector3(0.01F, 0.98F, 0F);
 
    public Vector3 defaultGuiScale = new Vector3(0.7F, 0.7F, 0F);
 
    public Color normal = Color.green;
 
    public Color warning = Color.yellow;
 
    public Color error = Color.red;
 
    public int maxMessages = 20;                  // The max number of messages displayed
 
    public float lineSpacing = 0.02F;              // The amount of space between lines
 
    public ArrayList messages = new ArrayList();
 
    public ArrayList names = new ArrayList();
 
    public ArrayList colors = new ArrayList();
 
    public bool showOnScreen = true;
 
  
 +
using UnityEngine;
 +
using System.Collections;
  
    // s_Instance is used to cache the instance found in the scene so we don't have to look it up every time.
 
    private static DebugGUIController s_Instance = null;
 
  
    // This defines a static instance property that attempts to find the manager object in the scene and
+
public class DebugConsole : MonoBehaviour
    // returns it to the caller.
+
{
    public static DebugGUIController instance
+
public GameObject DebugGui = null;            // The GUI that will be duplicated
    {
+
public Vector3 defaultGuiPosition = new Vector3(0.01F, 0.98F, 0F);
        get
+
public Vector3 defaultGuiScale = new Vector3(0.5F, 0.5F, 1F);
        {
+
public Color normal = Color.green;
            if (s_Instance == null)
+
public Color warning = Color.yellow;
            {
+
public Color error = Color.red;
                s_Instance = FindObjectOfType(typeof(DebugGUIController)) as DebugGUIController;
+
public int maxMessages = 30;                  // The max number of messages displayed
                if (s_Instance == null)
+
public float lineSpacing = 0.02F;              // The amount of space between lines
                    Debug.Log("Could not locate a DebugGUIController object. You have to have exactly one DebugGUIController in the scene.");
+
public ArrayList messages = new ArrayList();
            }
+
public ArrayList guis = new ArrayList();
 
+
public ArrayList colors = new ArrayList();
            return s_Instance;
+
public bool draggable = true;                  // Can the output be dragged around at runtime by default?
        }
+
public bool visible = true;                    // Does output show on screen by default or do we have to enable it with code?
    }
+
public bool pixelCorrect = false; // set to be pixel Correct linespacing
 
+
public static bool isVisible
    void Awake()
+
{                                     
    {
+
get
        s_Instance = this;
+
{
        if (DebugGui == null)
+
return DebugConsole.instance.visible;
        {
+
}
            DebugGui = new GameObject();
+
            DebugGui.AddComponent("GUIText");
+
set
            DebugGui.name = "DebugGUI";
+
{
            DebugGui.transform.position = defaultGuiPosition;
+
DebugConsole.instance.visible = value;
            DebugGui.transform.localScale = defaultGuiScale;
+
if (value == true)
        }
+
{
 
+
DebugConsole.instance.Display();
        // Create our GUI objects to our maxMessages count
+
}
        Vector3 position = new Vector3(0.01F, DebugGui.transform.position.y, 0F);
+
else if (value == false)
        int x = 0;
+
{
        while (x < maxMessages)
+
DebugConsole.instance.ClearScreen();
        {
+
}
            position.y -= lineSpacing;
+
}
            Object clone = null;
+
}
            clone = Instantiate(DebugGui, position, transform.rotation);
+
            string name = "DebugGui(" + x + ")";  
+
public static bool isDraggable
            names.Add(name);                      
+
{                                     
            clone.name = name;                    
+
get
            x += 1;
+
{
        }
+
return DebugConsole.instance.draggable;
 
+
}
    }
+
 
+
set
 
+
{
 
+
DebugConsole.instance.draggable = value;
    //---------- void AddMesage(string message, string color) ------
+
    //Adds a mesage to the list
+
}
    //--------------------------------------------------------------
+
}
 
+
    public void AddMessage(string message, string color)
+
    {
+
private static DebugConsole s_Instance = null;  // Our instance to allow this script to be called without a direct connection.
        messages.Add(message);
+
public static DebugConsole instance
        colors.Add(color);
+
{
        Display();
+
get
    }
+
{
    //++++++++++ OVERLOAD for AddMessage ++++++++++++++++++++++++++++
+
if (s_Instance == null)
    // Overloads AddMessage to only require one argument(message)
+
{
    //+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
+
s_Instance = FindObjectOfType(typeof(DebugConsole)) as DebugConsole;
    public void AddMessage(string message)
+
if (s_Instance == null)
    {
+
{
        messages.Add(message);
+
GameObject console = new GameObject();
        colors.Add("normal");
+
console.AddComponent<DebugConsole>();
        Display();
+
console.name = "DebugConsoleController";
    }
+
s_Instance = FindObjectOfType(typeof(DebugConsole)) as DebugConsole;
 
+
DebugConsole.instance.InitGuis();
 
+
}
 
+
    //----------- void ClearMessages() ------------------------------
+
}
    // Clears the messages from the screen and the lists
+
    //---------------------------------------------------------------
+
return s_Instance;
    public void ClearMessages()
+
}
    {
+
}
        messages.Clear();
+
        colors.Clear();
+
void Awake()
        ClearScreen();
+
{
    }
+
s_Instance = this;
 
+
InitGuis();
 
+
    //--------- void Hide() -----------------------------------------
+
}
    // Hides the display with a variable, but does NOT clear arrays
+
    //---------------------------------------------------------------
+
protected bool guisCreated = false;
    public void Hide()
+
protected float screenHeight =-1;
    {
+
public void InitGuis()
        showOnScreen = false;
+
{
        ClearScreen();
+
float usedLineSpacing = lineSpacing;
    }
+
screenHeight = Screen.height;
 
+
if(pixelCorrect)
 
+
usedLineSpacing = 1.0F / screenHeight * usedLineSpacing; 
    //--------- void Show() ----------------------------------------
+
    // Shows the hidden display on the screen
+
if (guisCreated == false)
    //--------------------------------------------------------------
+
{
    public void Show()
+
if (DebugGui == null) // If an external GUIText is not set, provide the default GUIText
    {
+
{
        showOnScreen = true;
+
DebugGui = new GameObject();
        Display();
+
DebugGui.AddComponent<GUIText>();
    }
+
DebugGui.name = "DebugGUI(0)";
 
+
DebugGui.transform.position = defaultGuiPosition;
 
+
DebugGui.transform.localScale = defaultGuiScale;
 
+
}
    //-------- void ClearScreen() ----------------------------------
+
    // Clears all output from all GUI objects
+
// Create our GUI objects to our maxMessages count
    //--------------------------------------------------------------
+
Vector3 position = DebugGui.transform.position;
    void ClearScreen()
+
guis.Add(DebugGui);
    {
+
int x = 1;
        int x = 0;
+
        while (x < names.Count)
+
while (x < maxMessages)
        {
+
{
            GameObject gui = GameObject.Find((string)names[x]);   
+
position.y -= usedLineSpacing;
            gui.guiText.text = "";
+
GameObject clone = null;
            //increment and loop
+
clone = (GameObject)Instantiate(DebugGui, position, transform.rotation);
            x += 1;
+
clone.name = string.Format("DebugGUI({0})", x);
 
+
guis.Add(clone);
        }//end loop
+
position = clone.transform.position;
    }
+
x += 1;
 
+
}
 
+
 
+
x = 0;
    //---------- void Prune() ---------------------------------------
+
while (x < guis.Count)
    // Prunes the array to fit within the maxMessages limit
+
{
    //---------------------------------------------------------------
+
GameObject temp = (GameObject)guis[x];
    void Prune()
+
temp.transform.parent = DebugGui.transform;
    {
+
x++;
        int diff;
+
}
        if (messages.Count > maxMessages)
+
guisCreated = true;
        {
+
} else {
            if (messages.Count <= 0)
+
// we're called on a screensize change, so fiddle with sizes
            {
+
Vector3 position = DebugGui.transform.position;
                diff = 0;
+
for(int x=0;x < guis.Count; x++)
            }
+
{
            else
+
position.y -= usedLineSpacing;
            {
+
GameObject temp = (GameObject)guis[x];
                diff = messages.Count - maxMessages;
+
temp.transform.position= position;
            }
+
}   
            messages.RemoveRange(0, (int)diff);
+
}
            colors.RemoveRange(0, (int)diff);
+
}
        }
+
 
+
    }
+
 
+
bool connectedToMouse = false; 
    //---------- void Display() -------------------------------------
+
void Update()
    // Displays the list and handles coloring
+
{
    //---------------------------------------------------------------
+
// If we are visible and the screenHeight has changed, reset linespacing
    public void Display()
+
if (visible == true && screenHeight != Screen.height)
    {
+
{
        //check if we are set to display
+
InitGuis();
        if (showOnScreen == false)
+
}
        {
+
if (draggable == true)
            ClearScreen();
+
{
        }
+
if (Input.GetMouseButtonDown(0))
        else
+
{
        {
+
if (connectedToMouse == false && DebugGui.GetComponent<GUIText>().HitTest((Vector3)Input.mousePosition) == true)
            if (messages.Count > maxMessages)
+
{
            {
+
connectedToMouse = true;
                Prune();
+
}
            }
+
else if (connectedToMouse == true)
 
+
{
            // Carry on with display
+
connectedToMouse = false;
            int x = 0;
+
}
            while (x < messages.Count)
+
            {
+
}
 
+
                GameObject gui = GameObject.Find((string)names[x])//find our gui object
+
if (connectedToMouse == true)
 
+
{
                //set our color
+
float posX = DebugGui.transform.position.x;
                switch ((string)colors[x])
+
float posY = DebugGui.transform.position.y;
                {
+
posX = Input.mousePosition.x / Screen.width;
                    case "normal": gui.guiText.material.color = normal;
+
posY = Input.mousePosition.y / Screen.height;
                        break;
+
DebugGui.transform.position = new Vector3(posX, posY, 0F);
                    case "warning": gui.guiText.material.color = warning;
+
}
                        break;
+
}
                    case "error": gui.guiText.material.color = error;
+
                        break;
+
}
                }
+
//+++++++++ INTERFACE FUNCTIONS ++++++++++++++++++++++++++++++++
                //now set the text for this element
+
public static void Log(string message, string color)
                gui.guiText.text = (string)messages[x];
+
{
 
+
DebugConsole.instance.AddMessage(message, color);
                //increment and loop
+
                x += 1;
+
}
 
+
//++++ OVERLOAD ++++
            }//end loop
+
public static void Log(string message)
 
+
{
 
+
DebugConsole.instance.AddMessage(message);
 
+
}
        }//end display check
+
 
+
public static void Clear()
    }
+
{
 
+
DebugConsole.instance.ClearMessages();
}// End Class
+
}
</csharp>
+
//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 +
 +
 +
//---------- void AddMesage(string message, string color) ------
 +
//Adds a mesage to the list
 +
//--------------------------------------------------------------
 +
 +
public void AddMessage(string message, string color)
 +
{
 +
messages.Add(message);
 +
colors.Add(color);
 +
Display();
 +
}
 +
//++++++++++ OVERLOAD for AddMessage ++++++++++++++++++++++++++++
 +
// Overloads AddMessage to only require one argument(message)
 +
//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 +
public void AddMessage(string message)
 +
{
 +
messages.Add(message);
 +
colors.Add("normal");
 +
Display();
 +
}
 +
 +
 +
//----------- void ClearMessages() ------------------------------
 +
// Clears the messages from the screen and the lists
 +
//---------------------------------------------------------------
 +
public void ClearMessages()
 +
{
 +
messages.Clear();
 +
colors.Clear();
 +
ClearScreen();
 +
}
 +
 +
 +
//-------- void ClearScreen() ----------------------------------
 +
// Clears all output from all GUI objects
 +
//--------------------------------------------------------------
 +
void ClearScreen()
 +
{
 +
if (guis.Count < maxMessages)
 +
{
 +
//do nothing as we haven't created our guis yet
 +
}
 +
else
 +
{
 +
int x = 0;
 +
while (x < guis.Count)
 +
{
 +
GameObject gui = (GameObject)guis[x];   
 +
gui.GetComponent<GUIText>().text = "";
 +
//increment and loop
 +
x += 1;
 +
}
 +
}
 +
}  
 +
 +
 +
//---------- void Prune() ---------------------------------------
 +
// Prunes the array to fit within the maxMessages limit
 +
//---------------------------------------------------------------
 +
void Prune()
 +
{
 +
int diff;
 +
if (messages.Count > maxMessages)
 +
{
 +
if (messages.Count <= 0)
 +
{
 +
diff = 0;
 +
}
 +
else
 +
{
 +
diff = messages.Count - maxMessages;
 +
}
 +
messages.RemoveRange(0, (int)diff);
 +
colors.RemoveRange(0, (int)diff);
 +
}
 +
 +
}
 +
 +
//---------- void Display() -------------------------------------
 +
// Displays the list and handles coloring
 +
//---------------------------------------------------------------
 +
void Display()
 +
{
 +
//check if we are set to display
 +
if (visible == false)
 +
{
 +
ClearScreen();
 +
}
 +
else if (visible == true)
 +
{
 +
 +
 +
if (messages.Count > maxMessages)
 +
{
 +
Prune();
 +
}
 +
 +
// Carry on with display
 +
int x = 0;
 +
if (guis.Count < maxMessages)
 +
{
 +
//do nothing as we havent created our guis yet
 +
}
 +
else
 +
{
 +
while (x < messages.Count)
 +
{
 +
GameObject gui = (GameObject)guis[x];   
 +
 +
//set our color
 +
switch ((string)colors[x])
 +
{
 +
case "normal": gui.GetComponent<GUIText>().material.color = normal;
 +
break;
 +
case "warning": gui.GetComponent<GUIText>().material.color = warning;
 +
break;
 +
case "error": gui.GetComponent<GUIText>().material.color = error;
 +
break;
 +
}
 +
 +
//now set the text for this element
 +
gui.GetComponent<GUIText>().text = (string)messages[x];
 +
 +
//increment and loop
 +
x += 1;
 +
}
 +
}
 +
 +
}
 +
}
 +
 +
 +
}// End DebugConsole Class
 +
</syntaxhighlight>

Latest revision as of 03:38, 1 December 2015

Author: Jeremy Hollingsworth (jeremyace)
Modifications by:

  • Simon Waite (opless) 22 Feb 2006
  • Shinsuke Sugita (shinriyo) Dec 2015

[edit] Description

This script will create a scrolling debug console. Allows you to set one of three colors (normal, warning, error) to each line to get more feedback and is mouse draggable at runtime.

[edit] Usage

Drop the DebugConsole script into your Standard Assets folder (This is a requirement). It is now fully usable.

If you want to change the default settings (like colors, or change the GUIText object), then create an empty GameObject and drag this script onto it from the standard assets folder. You now have access to all of the default settings in the inspector. The settings are explained below.


Settings:

  • Debug GUI : Drag the guiText you created here if you wish to override the default.
  • defaultGuiPosition : A vector for the starting position of the first line of output. If you provide your own GUIText then it's position overrides this property.
  • defaultGuiScale : A vector for the scale of the individual lines. Again, this is overridden if you provide your own GUIText.
  • The three colors : are for normal, warning, and error. Set to whatever you like or leave alone.
  • Max messages : How many message lines we will put on the screen at once.
  • Line Spacing : A float for how far down we will move each new line.
  • Draggable : True means you can drag the output around with the mouse at runtime, false means position is locked from mouse input. To drag output at runtime, click once on the uppermost output line to connect it to the mouse, then move to where you want the output displayed and click the mouse again to release it.
  • Visible : The default setting for visibility of the debug output. If set to false (unchecked), you can send data but it wont show until you tell it to, if set to true (checked) it will show all debug output until you tell it not to.
  • PixelCorrect : If set to true and LineSpacing to be on-screen pixels or not, very much like the GUIText property of the same name. Default: false LineSpacing will be in screen coordinates (0.0 - 1.0)


Using the DebugConsole script from your scripts:
To call the DebugConsole script from your scripts, just type:


DebugConsole.someFunction()


Replace someFunction() with any of the following:


Log (string message, string color)

  • Adds a message to the list. The color is a string either "normal", "warning" or "error". The color argument is optional and if omitted, the color will default to "normal".


Clear()

  • Clears all of the messages from the list and the screen.


To toggle the visibility use:
isVisible (true, false)

  • The property to set the visiblility of the debug output. This property _not_ clear the message list, just hides it. You need to use the Clear() method to clear the list.


To toggle the mouse drag functionality use:
isDraggable (true, false)


So for a simple example, to add hello world in warning color (yellow), we type: DebugConsole.Log("hello world", "warning");


To hide the output we type: DebugConsole.isVisible = false;

[edit] C# - DebugConsole.cs

The script _must_ be named DebugConsole.cs

/*==== DebugConsole.cs ====================================================
 * Class for handling multi-line, multi-color debugging messages.
 * Original Author: Jeremy Hollingsworth
 * Based On: Version 1.2.1 Mar 02, 2006
 * 
 * Modified: Simon Waite
 * Date: 22 Feb 2007
 *
 * Modified: Shinsuke Sugita
 * Date: 1 Dec 2015
 * 
 * Modification to original script to allow pixel-correct line spacing
 *
 * Setting the boolean pixelCorrect changes the units in lineSpacing property
 * to pixels, so you have a pixel correct gui font in your console.
 *
 * It also checks every frame if the screen is resized to make sure the 
 * line spacing is correct (To see this; drag and let go in the editor 
 * and the text spacing will snap back)
 *
 * USAGE:
 * ::Drop in your standard assets folder (if you want to change any of the
 * default settings in the inspector, create an empty GameObject and attach
 * this script to it from you standard assets folder.  That will provide
 * access to the default settings in the inspector)
 * 
 * ::To use, call DebugConsole.functionOrProperty() where 
 * functionOrProperty = one of the following:
 * 
 * -Log(string message, string color)  Adds "message" to the list with the
 * "color" color. Color is optional and can be any of the following: "error",
 * "warning", or "normal".  Default is normal.
 * 
 * Clear() Clears all messages
 * 
 * isVisible (true,false)  Toggles the visibility of the output.  Does _not_
 * clear the messages.
 * 
 * isDraggable (true, false)  Toggles mouse drag functionality
 * =========================================================================*/
 
 
using UnityEngine;
using System.Collections;
 
 
public class DebugConsole : MonoBehaviour
{
	public GameObject DebugGui = null;             // The GUI that will be duplicated
	public Vector3 defaultGuiPosition = new Vector3(0.01F, 0.98F, 0F);
	public Vector3 defaultGuiScale = new Vector3(0.5F, 0.5F, 1F);
	public Color normal = Color.green;
	public Color warning = Color.yellow;
	public Color error = Color.red;
	public int maxMessages = 30;                   // The max number of messages displayed
	public float lineSpacing = 0.02F;              // The amount of space between lines
	public ArrayList messages = new ArrayList();
	public ArrayList guis = new ArrayList();
	public ArrayList colors = new ArrayList();
	public bool draggable = true;                  // Can the output be dragged around at runtime by default? 
	public bool visible = true;                    // Does output show on screen by default or do we have to enable it with code? 
	public bool pixelCorrect = false; // set to be pixel Correct linespacing
	public static bool isVisible
	{                                      
		get
		{
			return DebugConsole.instance.visible;
		}
 
		set
		{
			DebugConsole.instance.visible = value;
			if (value == true)
			{
				DebugConsole.instance.Display();
			}
			else if (value == false)
			{
				DebugConsole.instance.ClearScreen();
			}
		}
	}
 
	public static bool isDraggable
	{                                      
		get
		{
			return DebugConsole.instance.draggable;
		}
 
		set
		{
			DebugConsole.instance.draggable = value;
 
		}
	}
 
 
	private static DebugConsole s_Instance = null;   // Our instance to allow this script to be called without a direct connection.
	public static DebugConsole instance
	{
		get
		{
			if (s_Instance == null)
			{
				s_Instance = FindObjectOfType(typeof(DebugConsole)) as DebugConsole;
				if (s_Instance == null)
				{
					GameObject console = new GameObject();
					console.AddComponent<DebugConsole>();
					console.name = "DebugConsoleController";
					s_Instance = FindObjectOfType(typeof(DebugConsole)) as DebugConsole;
					DebugConsole.instance.InitGuis();
				}
 
			}
 
			return s_Instance;
		}
	}
 
	void Awake()
	{
		s_Instance = this;
		InitGuis();
 
	}
 
	protected bool guisCreated = false;
	protected float screenHeight =-1;
	public void InitGuis()
	{
		float usedLineSpacing = lineSpacing;
		screenHeight = Screen.height;
		if(pixelCorrect)
			usedLineSpacing = 1.0F / screenHeight * usedLineSpacing;  
 
		if (guisCreated == false)
		{
			if (DebugGui == null)  // If an external GUIText is not set, provide the default GUIText
			{
				DebugGui = new GameObject();
				DebugGui.AddComponent<GUIText>();
				DebugGui.name = "DebugGUI(0)";
				DebugGui.transform.position = defaultGuiPosition;
				DebugGui.transform.localScale = defaultGuiScale;
			}
 
			// Create our GUI objects to our maxMessages count
			Vector3 position = DebugGui.transform.position;
			guis.Add(DebugGui);
			int x = 1;
 
			while (x < maxMessages)
			{
				position.y -= usedLineSpacing;
				GameObject clone = null;
				clone = (GameObject)Instantiate(DebugGui, position, transform.rotation);
				clone.name = string.Format("DebugGUI({0})", x);
				guis.Add(clone);
				position = clone.transform.position;
				x += 1;
			}
 
			x = 0;
			while (x < guis.Count)
			{
				GameObject temp = (GameObject)guis[x];
				temp.transform.parent = DebugGui.transform;
				x++;
			}
			guisCreated = true;
		} else {
			// we're called on a screensize change, so fiddle with sizes
			Vector3 position = DebugGui.transform.position;
			for(int x=0;x < guis.Count; x++)
			{
				position.y -= usedLineSpacing;
				GameObject temp = (GameObject)guis[x];
				temp.transform.position= position;
			}    	
		}
	}
 
 
 
	bool connectedToMouse = false;  
	void Update()
	{
		// If we are visible and the screenHeight has changed, reset linespacing
		if (visible == true && screenHeight != Screen.height)
		{
			InitGuis();
		}
		if (draggable == true)
		{
			if (Input.GetMouseButtonDown(0))
			{
				if (connectedToMouse == false && DebugGui.GetComponent<GUIText>().HitTest((Vector3)Input.mousePosition) == true)
				{
					connectedToMouse = true;
				}
				else if (connectedToMouse == true)
				{
					connectedToMouse = false;
				}
 
			}
 
			if (connectedToMouse == true)
			{
				float posX = DebugGui.transform.position.x;
				float posY = DebugGui.transform.position.y;
				posX = Input.mousePosition.x / Screen.width;
				posY = Input.mousePosition.y / Screen.height;
				DebugGui.transform.position = new Vector3(posX, posY, 0F);
			}
		}
 
	}
	//+++++++++ INTERFACE FUNCTIONS ++++++++++++++++++++++++++++++++
	public static void Log(string message, string color)
	{
		DebugConsole.instance.AddMessage(message, color);
 
	}
	//++++ OVERLOAD ++++
	public static void Log(string message)
	{
		DebugConsole.instance.AddMessage(message);
	}
 
	public static void Clear()
	{
		DebugConsole.instance.ClearMessages();
	}
	//++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 
 
	//---------- void AddMesage(string message, string color) ------
	//Adds a mesage to the list
	//--------------------------------------------------------------
 
	public void AddMessage(string message, string color)
	{
		messages.Add(message);
		colors.Add(color);
		Display();
	}
	//++++++++++ OVERLOAD for AddMessage ++++++++++++++++++++++++++++
	// Overloads AddMessage to only require one argument(message)
	//+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
	public void AddMessage(string message)
	{
		messages.Add(message);
		colors.Add("normal");
		Display();
	}
 
 
	//----------- void ClearMessages() ------------------------------
	// Clears the messages from the screen and the lists
	//---------------------------------------------------------------
	public void ClearMessages()
	{
		messages.Clear();
		colors.Clear();
		ClearScreen();
	}
 
 
	//-------- void ClearScreen() ----------------------------------
	// Clears all output from all GUI objects
	//--------------------------------------------------------------
	void ClearScreen()
	{
		if (guis.Count < maxMessages)
		{
			//do nothing as we haven't created our guis yet
		}
		else
		{
			int x = 0;
			while (x < guis.Count)
			{
				GameObject gui = (GameObject)guis[x];   
				gui.GetComponent<GUIText>().text = "";
				//increment and loop
				x += 1;
			}
		}
	}   
 
 
	//---------- void Prune() ---------------------------------------
	// Prunes the array to fit within the maxMessages limit
	//---------------------------------------------------------------
	void Prune()
	{
		int diff;
		if (messages.Count > maxMessages)
		{
			if (messages.Count <= 0)
			{
				diff = 0;
			}
			else
			{
				diff = messages.Count - maxMessages;
			}
			messages.RemoveRange(0, (int)diff);
			colors.RemoveRange(0, (int)diff);
		}
 
	}
 
	//---------- void Display() -------------------------------------
	// Displays the list and handles coloring
	//---------------------------------------------------------------
	void Display()
	{
		//check if we are set to display
		if (visible == false)
		{
			ClearScreen();
		}
		else if (visible == true)
		{
 
 
			if (messages.Count > maxMessages)
			{
				Prune();
			}
 
			// Carry on with display
			int x = 0;
			if (guis.Count < maxMessages)
			{
				//do nothing as we havent created our guis yet
			}
			else
			{
				while (x < messages.Count)
				{
					GameObject gui = (GameObject)guis[x];   
 
					//set our color
					switch ((string)colors[x])
					{
					case "normal": gui.GetComponent<GUIText>().material.color = normal;
						break;
					case "warning": gui.GetComponent<GUIText>().material.color = warning;
						break;
					case "error": gui.GetComponent<GUIText>().material.color = error;
						break;
					}
 
					//now set the text for this element
					gui.GetComponent<GUIText>().text = (string)messages[x];
 
					//increment and loop
					x += 1;
				}
			}
 
		}
	}
 
 
}// End DebugConsole Class
Personal tools
Namespaces

Variants
Actions
Navigation
Extras
Toolbox