dlib.core.ownership и хазард с порядком вызова деструкторов

На эту проблему я обратил внимание, когда писал расширение Dagon для работы с Newton. Она неочевидная и довольно трудная для понимания, но, к сожалению, при использовании dlib.core.ownership для серьезных задач знать о ней необходимо.

В dlib деструктор класса вызывается, когда объект удаляется функцией Delete. В цепочке наследования деструкторы вызываются снизу вверх, от производного класса к базовому. Это означает, что если объект участвует в системе владения (то есть, наследует от Owner), то по умолчанию все объекты, которыми он владеет, будут удалены после вызова его собственного деструктора.

Чаще всего это имеет значение, когда объекты управляют внешним состоянием — например, библиотечным. Объект-контейнер уничтожит свое внешнее состояние до того, как будут удалены объекты-итемы, зависящие от этого состояния. Например:

import dlib.core.memory;
import dlib.core.ownership;

class Container: Owner
{
    bool externalContextValid;
    
    this(Owner owner)
    {
        super(owner);
        externalContextValid = true;
    }
    
    ~this()
    {
        // Pretend that the library invalidates the context:
        externalContextValid = false;
    }
}

class Item: Owner
{
    Container container;
    
    this(Container con)
    {
        super(con);
        this.container = con;
    }
    
    ~this()
    {
        if (!container.externalContextValid)
            writeln("Problem: external context is invalid! Destruction order is broken!");
    }
}

void main()
{
    Container con = New!Container(null);
    Item item = New!Item(con);
    Delete(con);
}

Проблема тут в том, что по умолчанию Owner.clearOwnedObjects в деструкторе родительского Owner вызывается после деструктора Container, когда контест уже не валиден! Чтобы это правильно разрулить, нужно в Container вручную удалить объекты-собственность до инвалидации контекста:

~this()
{
    clearOwnedObjects();
    externalContextValid = false;
}

Dagon 1.9.0

Продолжается работа над редактором: реализовано выделение объектов мышью во вьюпорте, мультивыделение через Shift, групповая трансформация объектов, изменение родителя у объекта, создание источников света и изменение их свойств, создание камер и и изменение их свойств, создание пустых объектов, отображение маркеров для источников света и камер во вьюпорте. Исправлен рендеринг ограничивающих боксов у объектов. Добавлена (де)сериализация настроен вьюпорта. Обновлена документация к редактору.

В ядро движка добвален загрузчик сцен, сделанных в редакторе — SceneAsset, а также соответствующий метод сцены Scene.addSceneAsset.

Обновлен интерфейс TriangleSet, который в функции-итераторе для opApply теперь принимает структуру Triangle по указателю, а не по значению. Добавлен интерфейсный метод numTriangles.

Добавлены новый метод World.getEntity, новое свойство Material.index. Исправлена генерация ограничивающих боксов у мешей.

В компоненте FirstPersonViewComponent реализована поддержка инерционного вращения.

https://github.com/gecko0307/dagon/releases/tag/v1.9.0

Upd: вдогонку небольшое обновление Dagon 1.9.1 с новыми методами  SceneAsset.getEntity, SceneAsset.getMaterial. Сборка редактора под Windows включена в релиз 1.9.1 на GitHub:

https://github.com/gecko0307/dagon/releases/tag/v1.9.1

Редактор — новые фичи

За последнюю неделю сильно продвинулся в разработке редактора: добавил выделение объектов кликом во вьюпорте, мультивыделение через Shift и групповую трансформацию, создание и настройку источников света всех типов. Также в следующей версии Dagon будет наконец-то загрузчик сцен, сделанных в редакторе.

Dagon 1.8.0

Продолжается работа над редактором: реализован импорт текстур, создание и сохранение материалов, оптимизирован браузер ресурсов (в частности, генератор миниатюр изображений теперь работает в отдельном потоке). Добавлен новый сериализатор JSON-файлов. Исправлены баги совместимости редактора с Linux. Добавлен экран-заставка, отображающийся во время инициализации перед появлением основного окна приложения.

В ядре движка реализована встроенная поддержка архивов ZIP. В частности, движок теперь может опционально загружать рантайм-данные (data/__internal) из архива data.zip в папке с приложением. Код игры может монтировать в виртуальную файловую систему архивы для чтения своих данных.

Добавлены свойства класса Application, связанные с системным оконным менеджером: hdc и hInstance под Windows, x11WindowID, x11Display, waylandSurface и waylandDisplay под Linux. Добавлены методы hideWindow, showWindow, minimizeWindow. Также появилась возможность стартовать со скрытым окном, если прописать startHidden: false в settings.conf.

Исправлены баги загрузчика текстур. В частности, исправлена поддержка файлов TGA и обеспечена корректная загрузка некоторых нечасто встречающихся старых файлов DDS. Исправлен баг с неправильными путями к текстурам в загрузчике материалов (MaterialAsset).

Добавлено новое расширение dagon:openxr, которое добавляет в движок интеграцию OpenXR, открытого API виртуальной реальности, который пришел на смену SteamVR/OpenVR. Расширение экспериментальное и тестировалось ограниченно. Оно реализует базовый минимум функций, необходимых для создания VR-приложения и синхронизации виртуальной камеры с гарнитурой. Стереорендеринг в Dagon пока на ранней стадии развития — полноценной реализации deferred-рендера под VR пока нет, реализован только базовый рендеринг без сложных эффектов.

К движку теперь прилагается PDF-руководство (которое компилируется из Markdown-файлов в репозитории командой pandoc -d pandoc.yaml). В нем содержится важная информация для начинающих, подробные сведения об архитектуре Dagon и работе отдельных его компонентов. Руководство можно скачать на странице релиза.

https://github.com/gecko0307/dagon/releases/tag/v1.8.0

Осторожно: киберсквоттинг xtreme3d.ru!

Многие, наверное, знают, что я много лет являюсь администратором русскоязычного сообщества движка Xtreme3D. Его сайт в данный момент размещен на https://xtreme3d.org. Ранее это был xtreme3d.ru, но по ряду причин от *.ru пришлось отказаться. Домен xtreme3d.ru был, однако, почти сразу выкуплен киберсквоттерами — то есть, людьми, которые регистрируют домены, выглядящие как сайты крупных компаний, либо просто имеющие историю. На этом домене был создан фишинговый сайт-клон, который представляет собой сгенерированную нейросетью рерайт-копию xtreme3d.org. Сайт полон ошибок и неточностей, на нем нет ровным счетом ничего полезного и, кроме того, замечены потенциально вредоносные ссылки. Я не рекомендую его посещать и что-либо оттуда скачивать, особенно софт. Я уже подал жалобу в Google по поводу введения посетителей в заблуждение.

Dagon 1.7.0

1.7.0 — первая версия движка, к которой прилагается редактор. Он пока на ранней стадии разработки, присутствуют только базовые возможности, и в самом Dagon пока нет встроенных инструментов для работы с файлами сцен, которые он создает (впрочем, это JSON с очень простой, интуитивно понятной структурой, которые легко адаптировать к любому проекту).

Что уже реализовано:

  • Загрузка/сохранение сцен
  • Браузер ресурсов с поддержкой миниатюр для изображений. Редактор видит папку, в которой находится файл сцены, и может импортировать ресурсы из нее. Ресурсы всегда вставляются как локальные ссылки, редактор их не конвертирует и не перемещает, так что при обновлении файлов другими программами все изменения будут подхвачены. Пока, правда, нет отслеживания и перезагрузки файлов в случае внешних изменений
  • Импорт моделей OBJ. Другие форматы пока не поддерживаются, но в перспективе редактор, скорее всего, будет понимать все популярные форматы благодаря Assimp
  • Импорт материалов
  • Базовые инструменты редактирования объектов: трансформация, изменение основных свойств. Для трансформаций поддерживаются отмена и возврат
  • Инспектор с деревом объектов сцены
  • Настройки материала
  • Настройки пост-процессинга.

В самом движке изменения косметические. Обновлен синтаксис языка конфигураций — я решил портировать улучшения, сделанные в рамках Dagon 2, а именно поддержку переменных (свойства могут ссылаться на другие свойства), интерполяции строк ("${propName}") и платформоспецифичных постфиксов (something.windows or something.linux). Добавлены новые свойства приложения Application.wintabLibraryPath, Application.loadedWintabSupport, свойство менеджера событий EventManager.autoExit для отключения автоматического выхода при закрытии окна. Исправлено падение при вызове Entity.setParent с параметром null. Исправлен забагованный колбэк отладочных сообщений OpenGL.

https://github.com/gecko0307/dagon/releases/tag/v1.7.0

Редактор для Dagon 1.0

Попыток написать редактор сцен у меня было уже две — когда-то на Gtk, потом на Nuklear. Третья итерация использует ImGui. В данный момент уже готовы базовые фичи — инспектор, гизмо для трансформации объектов сцены, панель свойств, а также встроенный браузер ресурсов с отображением миниатюр для картинок.

Формат сцен находится в разработке, он скорее всего будет на основе JSON. Пока под вопросом совместимость с Dagon 2 и его форматом DAF — не исключено, что она тоже будет реализована.