C

构建 Qt 3D Studio OpenGL 运行时

构建设置

要配置运行时功能，您可以修改 ogl-runtime\commonplatform.pri 文件。此文件包含定义，这些定义可以打开/关闭特定功能。

性能日志

启用 QT3DS_ENABLE_PERF_LOGGING 以构建带有性能日志的运行时。在运行时，要查看日志，还应启用 qt3ds.perf_info 类别，例如使用 "QT_LOGGING_RULES=qt3ds.perf_info=true"。有关 Qt 日志类别的更多信息，请参阅https://doc.qt.ac.cn/qt-5/qloggingcategory.html

在应用程序启动过程中，控制台输出应包含以下内容

qt3ds.perf_info: 1. (1) Application: Begin Load - 1.145900ms = 1.146200ms
qt3ds.perf_info: 2. (1) Context: CreateRenderContext - 192.358500ms = 193.522300ms
qt3ds.perf_info: 3. (1) Binding: Initial Batch Image Load - 0.003200ms = 193.551800ms
qt3ds.perf_info: 4. (1) Binding: Initialize Scenes - 0.000100ms = 193.563500ms
qt3ds.perf_info: 5. (1) SceneManager: OnGraphicsInitialized - 0.023800ms = 193.567600ms
qt3ds.perf_info: 6. (1) Application: EndLoad - 0.000500ms = 193.574900ms
qt3ds.perf_info: 7. (1) Application: GetMetaData - 59.171400ms = 252.875800ms
qt3ds.perf_info: 8. (3) BatchLoader: Image Decompression - 15.395400ms = 294.876900ms
...
qt3ds.perf_info: 36. (1) Application: NotifyDataOutputs - 0.080800ms = 477.483800ms
qt3ds.perf_info: *** First frame rendered ***
qt3ds.perf_info: Runtime startup time: 477ms
qt3ds.perf_info: Application startup time: 1601ms
qt3ds.perf_info: Render Statistics: 33.62fps, frame count 34
qt3ds.perf_info: Render Statistics: 59.92fps, frame count 60
qt3ds.perf_info: Render Statistics: 59.92fps, frame count 60
...

日志格式为：(n) [任务名称] - [时间] = [累积时间] 其中

(n) = 在启动期间 [任务名称] 运行的次数。
[任务名称] = 正在记录日志的方法/任务。
[时间] = [任务名称] 运行 (n) 次总共花费的毫秒数。
[累积时间] = 当 [任务名称] 的最后运行结束时，已通过的总毫秒数。

注意：在分析结果时，请注意任务重叠，有些任务包含其他任务等。 运行时启动时间 包含运行时方法内部的耗时，而 应用程序启动时间 包含整个启动时间。

注意：QT3DS_ENABLE_PERF_LOGGING 不应在发布版本中启用，因为日志会增加性能开销。

阴影和光照

为了优化支持阴影和光照的数量，您可以定义 QT3DS_MAX_NUM_LIGHTS 和 QT3DS_MAX_NUM_SHADOWS。

传统 ASTC

要启用传统 ASTC，即 ASTC 文件在需要用于纹理创建之前不加载，请定义 LEGACY_ASTC_LOADING。

预乘 ASTC

要强制将所有 ASTC 压缩图像视为预乘的，您可以启用此功能。或者，如果您想在运行时执行此操作，请设置环境变量 QT3DS_ALL_ASTC_PREMULTIPLIED。

构建说明

适用于某些 Qt 许可证。
了解更多。