# This is the config file used to configure basic settings for Panda3D.
# The pipeline loads it at startup to ensure the environment is setup properly.
# Panda3D 基础设置文件，管线启动时会加载以确保环境配置正确。

# --------------  Development options  --------------
# 开发环境选项

pstats-gpu-timing #t
gl-debug #t
gl-debug-object-labels #t

# -------------- Production options ---------------
# 生产环境选项（发布可用）

# pstats-gpu-timing #f
# gl-debug #f
# gl-debug-object-labels #f

# ----------------- Misc Settings -----------------
# 杂项设置

# Disable V-Sync
# 关闭垂直同步
sync-video #f

# Limit the pstats-rate. This causes huge lag on windows 10.
# 限制 pstats 速率，避免 Win10 上的巨大卡顿
pstats-max-rate 200

# No stack trace on assertion, set this to true to make panda crash on assertions
# (which will allow to debug it)
# 断言时不打印堆栈；设为 true 会在断言时直接崩溃便于调试
# assert-abort #t
# show-dll-error-dialog #f

# File system should be case sensitive
# NOTICE: Set this to #f if you are using tempfile, since it returns
# wrong cased directory paths
# 文件系统区分大小写；若使用 tempfile 目录大小写错误则改为 #f
vfs-case-sensitive #t

# Enable state cache, this seems to actually help the performance by a lot
# 启用状态缓存，通常能显著提升性能
state-cache #t
transform-cache #t

# Hide frame rate meter (we have our own)
# 隐藏 Panda3D 自带帧率计数（管线有自定义）
show-frame-rate-meter #f

# Set text settings
# 文本相关设置
text-minfilter linear
text-magfilter linear
text-page-size 512 512
text-rwap-mode WM_border_clor

# Better text performance since rdb's patch
# 配合 rdb 补丁的文本性能设置
text-flatten 0
text-dynamic-merge 1

# For smoother animations
# even-animation #t
# 更平滑的动画（需要时启用 even-animation）

# Threading, really buggy!
#threading-model App/Cull/Draw
# 多线程模式，存在问题慎用

# Disable stencil, not supported/required
# 关闭模板缓冲，未使用也不需要
support-stencil #f
framebuffer-stencil #f

# Don't use srgb correction, we do that in the final shader
# 不使用内置 sRGB 校正，最终着色器中处理
framebuffer-srgb #f

# Don't use multisamples
# 不启用多重采样
framebuffer-multisample #f
multisamples 0

# Don't rescale textures which are no power-of-2
# 非 2 次幂纹理不缩放
textures-power-2 none

# Set default texture filters
# 默认纹理过滤器
texture-anisotropic-degree 16
texture-magfilter linear
texture-minfilter linear
texture-quality-level fastest

# Enable seamless cubemap filtering, important for environment filtering
# 启用无缝立方体贴图过滤，对环境滤波很关键
gl-cube-map-seamless #t

# Disable caching of textures
# 关闭纹理缓存
model-cache-textures #f

# Disable the annoying SRGB warning from pnmimage
# 关闭 pnmimage 的 SRGB 警告
notify-level-pnmimage error

# Disable the buffer viewer, we have our own
# 关闭内置缓冲查看器（管线自带）
show-buffers #f

# Use the default coordinate system, this makes our matrix transformations
# faster because we don't have have to transform them to a different coordinate
# system before
# 使用默认坐标系，避免矩阵转换到其他坐标系的额外开销
gl-coordinate-system default

# This makes animations smoother, especially if they were exported at 30 FPS
# and are played at 60 FPS
# 让动画更平滑，特别是 30FPS 输出播放到 60FPS 时
interpolate-frames #t

# Disable workarround in panda which causes our shadow atlas to take twice
# the amount of vram it should, due to an intel driver bug.
# 关闭 Intel 驱动相关的临时修复，避免阴影图集显存翻倍
gl-force-fbo-color #f

# ----------- OpenGL / Performance Settings ------------
# OpenGL 与性能相关设置

# Require OpenGL 4.3 at least, necessary for Intel drivers on Linux
# 至少需要 OpenGL 4.3（Linux Intel 驱动需要）
gl-version 4 3

# Animations on the gpu. The default shader has to get adjusted to support this
# feature before this option can be turned on.
# hardware-animated-vertices #t
# GPU 动画，开启需修改默认着色器以支持

# Try this options for performance
# uniquify-matrix #t
# uniquify-transforms #t
# uniquify-states #t
# uniquify-attribs #f
# 可尝试的性能优化选项

# Enable garbarge collection
# 启用状态垃圾回收
garbage-collect-states #t
# garbage-collect-states-rate 0.2

# Compress textures on the drivers?
# driver-compress-textures #t
# 是否让驱动压缩纹理

# Faster animations? (Have to test)
# matrix-palette #t
# display-list-animation #t
# 可能加速动画的选项（需测试）

# Better GL performance by not using gl-finish and so on
# 通过关闭 gl-finish 等获取更好 GL 性能
gl-finish #f
gl-force-no-error #t
gl-check-errors #f
gl-force-no-flush #t
gl-force-no-scissor #t

# Eventually disable memory barriers, have to check if this is faster
# 如需可禁用内存屏障，需测试是否更快
gl-enable-memory-barriers #f

# Disable threading
# 禁用线程化
lock-to-one-cpu #t
support-threads #f

# Let the driver generate the mipmaps
# 由驱动生成 mipmap
driver-generate-mipmaps #t

# Use immutable texture storage, it is *supposed* to be faster, but might not be
# XXX: Seems to produce an GL_INVALID_VALUE when disabled
# 使用不可变纹理存储，理论更快；禁用时可能出现 GL_INVALID_VALUE
gl-immutable-texture-storage #t

# Default window settings
# depth-bits 0
color-bits 0
framebuffer-depth #f
# 默认窗口设置（深度位、颜色位等）

# Small performance gain by specifying fixed vertex attribute locations.
# Might cause issues with some (incorrectly converted/loaded) meshes though
# 固定顶点属性位置可略增性能，但可能与部分模型不兼容
gl-fixed-vertex-attrib-locations #f

# Disable the fragment shader performance warning
# 关闭片段着色器性能警告/重复编译提示
gl-validate-shaders #f
gl-skip-shader-recompilation-warnings #t

alpha-scale-via-texture #f
pstats-name Render Pipeline Stats
rescale-normals #f
screenshot-extension png

# Required for correct velocity
# 正确计算速度所需
always-store-prev-transform #t
allow-incomplete-render #t


no-singular-invert #f