TiledSharp — библиотека на языке C# для разбора и импорта карт в формате TMX и тайлсетов в формате TSX, применяемых в редакторе карт Tiled. Проект предназначен для создания внутренних представлений карт и связанных с ними объектов в приложениях на платформе .NET без средств рендеринга, предоставляя разработчикам структуру данных и инструменты для чтения метаданных, слоёв, тайлов, объектов и свойств из XML-файлов, создаваемых редактором Tiled.
Библиотека обычно используется в игровых движках и инструментах разработки, где требуется программный доступ к содержимому карт (размещение тайлов, определение областей коллизий, импорт метаданных объектов и пользовательских свойств) без зависимости от визуализации. Исторически TiledSharp возник как лёгкая обёртка для парсинга формата TMX с фокусом на совместимость с .NET и простоту интеграции в существующий код, включая поддержку различных типов слоёв, тайлсетов с внешними TSX-файлами и базовых форматов данных, применяемых в экспортируемых XML.
- Парсинг TMX/TSX: чтение карт TMX и внешних/встроенных TSX-тайлсетов, включая атрибуты карт и тайлсетов.
- Структуры данных: предоставление классов для карты, слоёв (tilelayer, objectgroup, imagelayer), тайлов, объектов и свойств для последующей обработки в приложении.
- Поддержка различных форматов данных тайлов: обработка индексов GID и флагов трансформации тайлов (поворот, отражение) в соответствии с форматом TMX.
- Обработка пользовательских свойств: чтение свойств, присвоенных картам, слоям, группам объектов и отдельным объектам/тайлам.
- Совместимость с .NET: написана на C#, легко интегрируется в проекты .NET Framework и .NET Core/NET.
- Без рендеринга: библиотека фокусируется исключительно на представлении данных и не включает функции отрисовки или визуализации.
- Простота использования: интуитивно понятный API для загрузки файлов и доступа к структурам карты, пригодный для скриптовых и инструментальных задач.
- Обработка слоёв и объектов: поддержка чтения слоёв тайлов, слоёв объектов с различными типами (прямоугольники, эллипсы, полигоны, полилинии) и их атрибутов.