using System;
using StardewModdingAPI.Events;
using StardewValley;
namespace StardewModdingAPI.Framework.Events
{
/// Events related to UI and drawing to the screen.
internal class ModDisplayEvents : ModEventsBase, IDisplayEvents
{
/*********
** Accessors
*********/
/// Raised after a game menu is opened, closed, or replaced.
public event EventHandler MenuChanged
{
add => this.EventManager.MenuChanged.Add(value);
remove => this.EventManager.MenuChanged.Remove(value);
}
/// Raised before the game draws anything to the screen in a draw tick, as soon as the sprite batch is opened. The sprite batch may be closed and reopened multiple times after this event is called, but it's only raised once per draw tick. This event isn't useful for drawing to the screen, since the game will draw over it.
public event EventHandler Rendering
{
add => this.EventManager.Rendering.Add(value);
remove => this.EventManager.Rendering.Remove(value);
}
/// Raised after the game draws to the sprite patch in a draw tick, just before the final sprite batch is rendered to the screen. Since the game may open/close the sprite batch multiple times in a draw tick, the sprite batch may not contain everything being drawn and some things may already be rendered to the screen. Content drawn to the sprite batch at this point will be drawn over all vanilla content (including menus, HUD, and cursor).
public event EventHandler Rendered
{
add => this.EventManager.Rendered.Add(value);
remove => this.EventManager.Rendered.Remove(value);
}
/// Raised before the game world is drawn to the screen. This event isn't useful for drawing to the screen, since the game will draw over it.
public event EventHandler RenderingWorld
{
add => this.EventManager.RenderingWorld.Add(value);
remove => this.EventManager.RenderingWorld.Remove(value);
}
/// Raised after the game world is drawn to the sprite patch, before it's rendered to the screen. Content drawn to the sprite batch at this point will be drawn over the world, but under any active menu, HUD elements, or cursor.
public event EventHandler RenderedWorld
{
add => this.EventManager.RenderedWorld.Add(value);
remove => this.EventManager.RenderedWorld.Remove(value);
}
/// When a menu is open ( isn't null), raised before that menu is drawn to the screen. This includes the game's internal menus like the title screen. Content drawn to the sprite batch at this point will appear under the menu.
public event EventHandler RenderingActiveMenu
{
add => this.EventManager.RenderingActiveMenu.Add(value);
remove => this.EventManager.RenderingActiveMenu.Remove(value);
}
/// When a menu is open ( isn't null), raised after that menu is drawn to the sprite batch but before it's rendered to the screen. Content drawn to the sprite batch at this point will appear over the menu and menu cursor.
public event EventHandler RenderedActiveMenu
{
add => this.EventManager.RenderedActiveMenu.Add(value);
remove => this.EventManager.RenderedActiveMenu.Remove(value);
}
/// Raised before drawing the HUD (item toolbar, clock, etc) to the screen. The vanilla HUD may be hidden at this point (e.g. because a menu is open). Content drawn to the sprite batch at this point will appear under the HUD.
public event EventHandler RenderingHud
{
add => this.EventManager.RenderingHud.Add(value);
remove => this.EventManager.RenderingHud.Remove(value);
}
/// Raised after drawing the HUD (item toolbar, clock, etc) to the sprite batch, but before it's rendered to the screen. The vanilla HUD may be hidden at this point (e.g. because a menu is open). Content drawn to the sprite batch at this point will appear over the HUD.
public event EventHandler RenderedHud
{
add => this.EventManager.RenderedHud.Add(value);
remove => this.EventManager.RenderedHud.Remove(value);
}
/// Raised after the game window is resized.
public event EventHandler WindowResized
{
add => this.EventManager.WindowResized.Add(value);
remove => this.EventManager.WindowResized.Remove(value);
}
/*********
** Public methods
*********/
/// Construct an instance.
/// The mod which uses this instance.
/// The underlying event manager.
internal ModDisplayEvents(IModMetadata mod, EventManager eventManager)
: base(mod, eventManager) { }
}
}