Extra Resources

Advanced Logging

When using InputLayers, you are likely to notice the formatted logging that it uses. This is the result of custom versions of default Unity classes with built-in extended logging functionality:

Original Class	Custom Class
MonoBehavior🔗	LowryBehavior
ScriptableObject🔗	LowryScriptable
Editor🔗	LowryEditor
EditorWindow🔗	LowryEditorWindow
PropertyDrawer🔗	LowryPropertyDrawer

These custom classes offer a number of logging tools designed to perform well, and offer better visual clarity when reading logs in the Unity Editor, as well as when exported. Here is a list of the built-in features, and how they can be used/configured:

Logging Methods

The core idea is to replace standard logging methods with custom variants that inject visual information to help identify the class they originate from, and display objects in a human-readable way using JSON.

Original Class	Custom Class
Debug.Log()🔗	LogMsg()
Debug.LogWarning()🔗	LogWarning()
Debug.LogError()🔗	LogError()

Note: Some variants, like LowryEditor may not include the full suite of logging tools as InputLayers does not require them in that context.

Example

// Standard approach to logging
Debug.LogWarning("Beware!");
Debug.Log("Something happened", _contextObject);

// Custom logging approach
LogWarning("Beware!");
LogMsg(_objectToDisplayAsJson, "Something happened");

Optimization

For optimization purposes, it is recommended to avoid passing formatted strings, and instead pas elements as arguments:

// DO NOT DO THIS
LogMsg("A log about {_name}").

// Do this instead
LogMsg("A log about {0}", _name)

Automatic Styling

When using the above methods, a colorful title can be injected before the log. This is designed to help quickly and easily distinguish the source of the log.

In order to use this functionality, your class inhabiting from a custom "Lowry" class will need to override the d_logHeader value:

protected override string d_logHeader => "[The name of the class, or some other identifyer]";

For visual clarity, InputLayers always puts these titles betwee, brackets.

Color

By default, different colors are used for various class types:

Class	Default Color
LowryBehavior	headerOrange
LowryScriptable	headerPink
LowryEditor	headerGreen
LowryEditorWindow	headerGreen
LowryPropertyDrawer	headerGreen

However, in the case of LowryBehavior and LowryScriptable classes, the color can be overridden like this:

protected override Log.Colors d_logHeaderColor => Log.Colors.headerGrass;

Here is the list of available colors; which can be modified by editing the Lowry.Utils.Logs file:

• headerOrange
• headerPink
• headerGrass
• headerPurple
• headerGreen
• headerWine

Other Usefull Classes

The following are tool classes included with InputLayers:

• PseudoSerializableDictionary
• StackableList