Редактирование: Winerr.NET

{{Инфобокс Программное обеспечение
| название          = Winerr.NET
| логотип           = <!-- Можно добавить лого, если есть -->
| автор             = [[DimaYastrebov]]
| первая версия     = 0.9.8.389 (12 сентября 2025)
| последняя версия  = 1.0.2 (25 сентября 2025)
| язык              = C#, TypeScript
| лицензия          = ISC
| сайт              = [https://github.com/DimaYastrebov/Winerr.NET GitHub]<br>[https://winerr-net.yastre.top/ Официальный WebUI]
}}

'''Winerr.NET''' — это генератор [[Смешные ошибки|смешных ошибок]] на C# (.NET) от [[DimaYastrebov]], который позволяет создавать реалистичные изображения фейковых окон ошибок.

Проект решает ту же задачу, что и [[Winerr]] от [[Shikoshib]], но написан полностью с нуля на других технологиях и не является его прямым наследником.

== Состав проекта ==

Проект имеет модульную структуру, что позволяет использовать его компоненты как вместе, так и по отдельности.

; '''<code>Winerr.NET.Core</code>'''
: Сердце проекта. Это основная библиотека, в которой реализована вся логика по отрисовке окон: работа со шрифтами, построение рамок, расстановка кнопок и иконок.

; '''<code>Winerr.NET.Cli</code>'''
: Утилита для работы через командную строку (терминал). Позволяет генерировать ошибки с помощью текстовых команд, что удобно для автоматизации и скриптов.

; '''<code>Winerr.NET.WebServer</code>'''
: Локальный веб-сервер, который предоставляет API для доступа к генератору по сети. Используется веб-интерфейсом для выполнения всех операций.

; '''<code>Winerr.NET.WebUI</code>'''
: Веб-интерфейс, написанный на Next.js. Предоставляет удобный графический интерфейс в браузере для создания фейковых окон ошибок.

== История разработки ==

История разработки велась поэтапно, от простого консольного инструмента к полноценному веб-приложению.

Первый публичный релиз, версия '''0.9.8.389''' (12 сентября 2025), включал в себя базовый функционал: ядро для рендеринга (<code>Winerr.NET.Core</code>) и утилиту командной строки (<code>Winerr.NET.Cli</code>).

С выходом версии '''0.10.0''' (18 сентября 2025) был добавлен веб-сервер (<code>Winerr.NET.WebServer</code>), что позволило работать с генератором по сети через API.

Начиная с версии '''1.0.0''' (22 сентября 2025), проект обзавелся полноценным веб-интерфейсом (<code>Winerr.NET.WebUI</code>), который сделал процесс создания ошибок визуальным и доступным для широкого круга пользователей.

== Использование ==

Существует три основных способа работы с Winerr.NET.

=== Веб-интерфейс ===

Это самый простой способ для большинства пользователей. Веб-интерфейс проекта (<code>Winerr.NET.WebUI</code>) предоставляет следующие возможности:
* Создание ошибок в одиночном и пакетном (batch) режимах.
* Конструктор кнопок с возможностью ручной сортировки.
* Предпросмотр результата в реальном времени.
* Импорт и экспорт конфигураций в формате JSON.

Официально развернутый веб-интерфейс доступен по адресу: [https://winerr-net.yastre.top/].

=== Утилита командной строки (CLI) ===

Для генерации изображения используется команда `generate` с набором параметров. Это полезно для быстрой генерации или для использования в скриптах.

==== Windows (cmd / PowerShell) ====
<syntaxhighlight lang="bash">
Winerr.NET.Cli.exe generate --style "Win7_Aero" --title "Пример" --content "Текст\nошибки" --icon 48 --output "example.png"
</syntaxhighlight>

==== Linux / macOS ====
<syntaxhighlight lang="bash">
./Winerr.NET.Cli generate --style "Win7_Aero" --title "Пример" --content "Текст\nошибки" --icon 48 --output "example.png"
</syntaxhighlight>

Для получения полного списка доступных стилей можно использовать команду:
<syntaxhighlight lang="bash">
# Для Windows
Winerr.NET.Cli.exe list-styles

# Для Linux / macOS
./Winerr.NET.Cli list-styles
</syntaxhighlight>

=== Использование в качестве библиотеки ===

Библиотеку <code>Winerr.NET.Core</code> можно подключить к любому .NET-проекту для программной генерации ошибок.

{{Плашка
| тип = warning
| заголовок = Важно!
| текст = Библиотека <code>Winerr.NET.Core</code> напрямую зависит от <code>Winerr.NET.Assets</code>. Для корректной работы необходимо, чтобы оба файла (<code>Winerr.NET.Core.dll</code> и <code>Winerr.NET.Assets.dll</code>) находились в директории с твоим приложением.
}}

Процесс сводится к созданию объекта конфигурации <code>ErrorConfig</code>, настройке всех параметров (стиль, текст, иконки) и вызову метода <code>Generate</code> у класса <code>ErrorRenderer</code>.

==== Пример на C# ====
<syntaxhighlight lang="csharp">
using Winerr.NET.Core.Configs;
using Winerr.NET.Core.Enums;
using Winerr.NET.Core.Renderers;

// Обязательно нужно один раз загрузить ассеты при старте приложения
Winerr.NET.Core.Managers.AssetManager.Instance.LoadAssets();

// 1. Создание конфигурации окна
var config = new ErrorConfig
{
    // Выбираем стиль окна
    SystemStyle = SystemStyle.Windows7Aero,

    // Задаем текст
    Title = "Пример из кода",
    Content = "Это окно было сгенерировано\nпрограммно с помощью Winerr.NET.Core.",
    
    // Указываем ID иконки
    IconId = 48,

    // Настраиваем кнопки
    Buttons = new List<ButtonConfig>
    {
        new ButtonConfig
        {
            Text = "OK",
            Type = ButtonType.Recommended,
            TextConfig = new TextRenderConfig { DrawMnemonic = false }
        },
        new ButtonConfig
        {
            Text = "Отмена",
            Type = ButtonType.Default
        }
    },

    // Другие параметры
    ButtonAlignment = ButtonAlignment.Right,
    IsCrossEnabled = true
};

// 2. Создание рендерера и генерация изображения
var renderer = new ErrorRenderer();
using var image = renderer.Generate(config);

// 3. Сохранение результата в файл
image.SaveAsPng("error_from_code.png");
</syntaxhighlight>

== См. также ==
* [[Winerr]]
* [[Winerr.js]]
* [[Смешные ошибки]]