xtreme3d_4.0 [Xtreme3D Wiki]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Xtreme3D 4.0 ======
Четвертое поколение [[Xtreme3D]], графического движка для [[GameMaker]].

Основные особенности:
  * Переход на 64-битную архитектуру. 32-битная архитектура больше не поддерживается
  * Использование [[Delphi]] 10/11 и [[GLScene]] 2.2
  * Совместимость с современными версиями GameMaker (бывший GameMaker Studio 2)
  * Все строки в движке принимаются только в 8-битном представлении (ASCII/UTF-8), поддержка других кодировок удалена
  * Большинство функций не изменились, все мелкие изменения API перечислены ниже
  * Реализованы привязки к [[Python]] 3 и [[C]]/[[C++]]
  * Обновлена справка, актуализированы уроки и документация ко многим функциям.

[[https://github.com/xtreme3d/xtreme3d/tree/4.0|Репозиторий проекта]]

**Текущий статус:** стабильный релиз версии 4.0.0

===== История =====
В 2022 году [[GameMaker|GameMaker Studio 2]] полностью перешел на 64-битную архитектуру, вследствие чего потерял совместимость со старыми 32-битными расширениями. Для того, чтобы продолжить поддержку классической связки Xtreme3D+GameMaker, было решено портировать Xtreme3D на современный Delphi и актуальную версию [[GLScene]]. Поскольку порт частично ломает обратную совместимость, он будет развиваться в рамках новой ветки Xtreme3D - 4.x. В обозримом будущем обе ветки будут поддерживаться параллельно.

Xtreme3D 4.0 пишется на Delphi 10 и выше с использованием библиотеки GLScene 2.2. Будет поддерживаться только 64-битная архитектура и (пока) только ОС Windows.

Проект осуществляется в два этапа. На первом были реализованы базовые функции-врапперы, основанные на встроенных классах GLScene, и выпущена [[https://github.com/xtreme3d/xtreme3d/releases/tag/v4.0.0-alpha.1|первая альфа-версия]]. На втором были реализованы аналоги тех возможностей, для которых пришлось добавлять новые классы GLScene и менять методы встроенных. По итогам II этапа была выпущена вторая альфа-версия. Также на II этапе был подготовлен биндинг для Python 3.

Дорожная карта разработки:
  * ✔️ **Milestone I** (2022-2023)
  * ✔️ **Milestone II** (2023-2024)
  * ✔️ **Xtreme3D 4.0.0 beta** (начало 2025 года)
  * ✔️ **Xtreme3D 4.0.0** (апрель 2025 года)
  * ⏳ **Xtreme3D 4.1.0** (ориентировочно конец 2025 года)

===== Отличия от Xtreme3D 3.9 =====
Большинство функций движка остаются без изменений. Изменения, ломающие обратную совместимость, перечислены ниже.

  * Функция Update теперь называется EngineUpdate
  * Функция TrisRendered удалена
  * Функция ViewerRenderEx удалена
  * Новые функции ViewerBeginRender, ViewerClear, ViewerRenderObject, ViewerEndRender
  * Изменился смысл функции EngineSetMaxLights. Теперь она задает максимальное количество источников света, которые учитываются основной системой освещения и системой LightFX. По умолчанию это количество равно 8 (максимум для основной системы освещения). Если вы хотите использовать больше источников света для системы LightFX, нужно использовать эту функцию
  * Функция ViewerGetPickedObjectsList теперь работает с объектами-списками PickList, которые нужно создавать вручную
  * Новые функции PickListCreate, PickListClear, PickListGetCount, PickListGetHit
  * Функция ViewerRenderToFilePNG удалена - сохранение в PNG теперь поддерживается в ViewerRenderToFile
  * Поддерживаются новые константы для ViewerSetAntiAliasing: aa6x = 6, aa8x = 7, aa16x = 8, csa8x = 9, csa8xHQ = 10, csa16x = 11, csa16xHQ = 12
  * Функция CameraZoomAll теперь требует указания Viewer во втором параметре
  * Новая функция MaterialLibraryGetTextureByName
  * Функция SpriteNoZWrite удалена, используйте вместо нее MaterialSetDepthWrite
  * Функция MaterialCullFrontFaces удалена
  * Функция MaterialSetZWrite теперь называется MaterialSetDepthWrite
  * Новая функция MaterialSetDepthTest
  * Переделана система TextureEx у материалов. Удалены функции MaterialLoadTextureEx, MaterialSetTextureEx, MaterialSetTextureExFromLibrary, MaterialGenTextureEx, MaterialEnableTextureEx
  * Новая функция MaterialSetTextureFormatEx
  * Новая константа для MaterialSetTextureFormat: tfExtended = 12
  * Новая константа для MaterialSetTextureImageAlpha: tiaBottomRightPointColorTransparent = 9
  * Новые функции MaterialSetTextureCompareMode, MaterialSetTextureDepthCompareFunc
  * Удалены функции ObjectGetCollisionPosition, ObjectGetCollisionNormal - вместо них теперь EngineGetLastRaycastPosition, EngineGetLastRaycastNormal, которые делают то же самое
  * Функции Polygon удалены
  * Функции TTFontSetEncoding, TTFontLoadCodePage удалены
  * Шрифты TTFont теперь работают на базе SDL_ttf вместо чистого Freetype
  * Функции TextRead, TextConvertANSIToUTF8 удалены
  * Функция OdeAddCone удалена
  * Новая функция BaseMeshBuildSilhouetteConnectivityData
  * Новая функция ActorSetReference
  * Новые функции ObjectNotifyChange, ObjectStructureChanged, ObjectClearStructureChanged
  * Новые функции ObjectListCreate, ObjectListAdd, ObjectListGetCount
  * Переделана система FBO. Объект FBO теперь является частью графа сцены. Удалены функции FBOSetViewer, FBORenderObject, FBORenderObjectEx, FBOSetOverrideMaterial, FBOSetColorTextureFormat. Новые функции FBOSetActive, FBOSetAspect, FBOSetPickableTarget, FBOSetSize, FBOSetRootObject, FBOSetBackgroundColor, FBOSetEnabledRenderBuffers, FBOSetSceneScaleFactor, FBOSetTargetVisibility, FBOSetMaterialLibrary, FBOSetColorTextureName, FBOSetDepthTextureName, FBOSetClearOptions, FBOSetStencilPrecision, FBOSetShadowMapMode
  * Переделаны тени ShadowMap. Удалены функции ShadowMapSetCaster, ShadowMapSetProjectionSize, ShadowMapSetZScale, ShadowMapSetZClippingPlanes, ShadowMapRender. Новые функции ShadowMapUpdate, ShadowMapSetViewer
  * Добавлен новый объект ShadowCamera, который используется в ShadowMap. Новые функции ShadowCameraCreate, ShadowCameraSetProjectionSize, ShadowCameraSetZClippingPlanes
  * Новые функции GLSLShaderForceDisableStencilTest, GLSLShaderSetOptions
  * Новые функции LoggerCreate, LoggerEnable, LoggerLog
  * Функция PtrToReal теперь называется PointerToReal