RobustToolbox/Robust.Client/Graphics/IClyde.cs

using System;
using System.Collections.Generic;
using System.Diagnostics.Contracts;
using System.IO;
using System.Numerics;
using System.Threading.Tasks;
using Robust.Shared.GameObjects;
using Robust.Shared.Graphics;
using Robust.Shared.Maths;
using SixLabors.ImageSharp;
using SixLabors.ImageSharp.PixelFormats;
using Color = Robust.Shared.Maths.Color;

namespace Robust.Client.Graphics
{
    public delegate void CopyPixelsDelegate<T>(Image<T> pixels) where T : unmanaged, IPixel<T>;

    [NotContentImplementable]
    public interface IClyde
    {
        internal bool IsInitialized { get; }

        IClydeWindow MainWindow { get; }
        IRenderTarget MainWindowRenderTarget => MainWindow.RenderTarget;

        Vector2i ScreenSize { get; }

        bool IsFocused { get; }

        IEnumerable<IClydeWindow> AllWindows { get; }

        /// <summary>
        ///     The default scale ratio for window contents, given to us by the OS.
        /// </summary>
        Vector2 DefaultWindowScale { get; }

        void SetWindowTitle(string title);
        void SetWindowMonitor(IClydeMonitor monitor);

        /// <summary>
        ///     This is the magic method to make the game window ping you in the task bar.
        /// </summary>
        void RequestWindowAttention();

        event Action<WindowResizedEventArgs> OnWindowResized;

        event Action<WindowFocusedEventArgs> OnWindowFocused;

        event Action<WindowContentScaleEventArgs> OnWindowScaleChanged;

        OwnedTexture LoadTextureFromPNGStream(Stream stream, string? name = null,
            TextureLoadParameters? loadParams = null);

        OwnedTexture LoadTextureFromImage<T>(Image<T> image, string? name = null,
            TextureLoadParameters? loadParams = null) where T : unmanaged, IPixel<T>;

        /// <summary>
        ///     Creates a blank texture of the specified parameters.
        ///     This texture can later be modified using <see cref="OwnedTexture.SetSubImage{T}"/>
        /// </summary>
        /// <param name="size">The size of the new texture, in pixels.</param>
        /// <param name="name">A name for the texture that can show up in debugging tools like renderdoc.</param>
        /// <param name="loadParams">
        ///     Load parameters for the texture describing stuff such as sample mode.
        /// </param>
        /// <typeparam name="T">
        ///     The type of pixels to "store" in the texture.
        ///     This is the same type you should pass to <see cref="OwnedTexture.SetSubImage{T}"/>,
        ///     and also determines how the texture is stored internally.
        /// </typeparam>
        /// <returns>
        ///     An owned, mutable texture object.
        /// </returns>
        OwnedTexture CreateBlankTexture<T>(
            Vector2i size,
            string? name = null,
            in TextureLoadParameters? loadParams = null)
            where T : unmanaged, IPixel<T>;

        /// <summary>
        /// Gets the clear color for the specified map viewport.
        /// </summary>
        [Pure]
        Color GetClearColor(EntityUid mapUid);

        /// <summary>
        /// Applies a blur to the specified render target. Requires a separate buffer with similar properties to draw intermediate steps into.
        /// </summary>
        /// <param name="viewport">The viewport being used for drawing.</param>
        /// <param name="target">The blur target.</param>
        /// <param name="blurBuffer">The separate buffer to draw into.</param>
        /// <param name="eye">The eye being drawn with.</param>
        /// <param name="multiplier">Scale of how much blur to blur by.</param>
        void BlurRenderTarget(IClydeViewport viewport, IRenderTarget target, IRenderTarget blurBuffer, IEye eye, float multiplier);

        IRenderTexture CreateLightRenderTarget(Vector2i size, string? name = null, bool depthStencil = true);

        IRenderTexture CreateRenderTarget(Vector2i size, RenderTargetFormatParameters format,
            TextureSampleParameters? sampleParameters = null, string? name = null);

        // Cursor API.
        /// <summary>
        ///     Gets a cursor object representing standard cursors that match the OS styling.
        /// </summary>
        /// <remarks>
        ///     Cursor objects returned from this method are cached and you cannot not dispose them.
        /// </remarks>
        ICursor GetStandardCursor(StandardCursorShape shape);

        /// <summary>
        ///     Create a custom cursor object from an image.
        /// </summary>
        /// <param name="image"></param>
        /// <param name="hotSpot"></param>
        /// <returns></returns>
        ICursor CreateCursor(Image<Rgba32> image, Vector2i hotSpot);

        /// <summary>
        ///     Sets the active cursor for the primary window.
        /// </summary>
        /// <param name="cursor">The cursor to set to, or <see langword="null"/> to reset to the default cursor.</param>
        /// <exception cref="ObjectDisposedException">Thrown if the cursor object passed has been disposed.</exception>
        void SetCursor(ICursor? cursor);

        /// <summary>
        ///     Make a screenshot of the game, next render frame.
        /// </summary>
        /// <param name="type">What kind of screenshot to take</param>
        /// <param name="callback">The callback to run when the screenshot has been made.</param>
        /// <param name="subRegion">
        ///     The subregion of the framebuffer to copy.
        ///     If null, the whole framebuffer is copied.
        /// </param>
        /// <seealso cref="ScreenshotAsync"/>
        /// <seealso cref="IRenderTarget.CopyPixelsToMemory{T}"/>
        void Screenshot(ScreenshotType type, CopyPixelsDelegate<Rgb24> callback, UIBox2i? subRegion = null);

        /// <summary>
        ///     Async version of <see cref="Screenshot"/>.
        /// </summary>
        Task<Image<Rgb24>> ScreenshotAsync(ScreenshotType type, UIBox2i? subRegion = null)
        {
            var tcs = new TaskCompletionSource<Image<Rgb24>>();

            Screenshot(type, image => tcs.SetResult(image));

            return tcs.Task;
        }

        IClydeViewport CreateViewport(Vector2i size, string? name = null)
        {
            return CreateViewport(size, default, name);
        }

        IClydeViewport CreateViewport(Vector2i size, TextureSampleParameters? sampleParameters, string? name = null);

        IEnumerable<IClydeMonitor> EnumerateMonitors();

        IClydeWindow CreateWindow(WindowCreateParameters parameters);
    }
}