C

属性名称

以下列表列出了可以通过 Q3DSPresentation::setAttribute() 或 Q3DSElement::setAttribute() 在各种场景对象上设置的属性。

注意：向量（例如组或模型的 rotation）和颜色（例如材质的 diffuse）属性允许在一个操作中设置/获取所有组件，并分别映射到 QVector3D 和 QColor。

注意：从 Qt 3D Studio 2.1 开始，并非所有属性都可以在运行时动态更改。一般来说，在 Qt 3D Studio 应用程序中可被动画处理的属性也可以在运行时自由更改。

注意：建议应用程序尽可能依赖 Qt 3D Studio 的 data input 功能。这样可以避免引用硬编码的属性名称，并允许设计者将有趣的属性以任意数据输入名暴露给应用程序开发者，从而从 3D 展示到应用程序代码提供一个固定、已知的应用接口。有关更多信息，请参阅 Q3DSDataInput、DataInput、Q3DSDataOutput 和 DataOutput。

场景
名称 name string
启用背景颜色 bgcolorenable boolean
背景颜色 R backgroundcolor.r number
背景颜色 G backgroundcolor.g number
背景颜色 B backgroundcolor.b number
场景以外的元素
元素名称 name string
(眼球) eyeball boolean
时间栏开始 starttime number 以整数毫秒为单位
时间栏结束 endtime number 以整数毫秒为单位
层
禁用深度测试 disabledepthtest boolean
渐进式 AA progressiveaa string 值： 'None'、'2x'、'4x'、'8x'
多重采样 AA multisampleaa string 值： 'None'、'2x'、'4x'
时间性 AA temporalaa boolean
层背景 background string 值： 'Transparent'、'Unspecified'、'SolidColor'
背景颜色 R backgroundcolor.r number
背景颜色 G backgroundcolor.g number
背景颜色 B backgroundcolor.b number
混合类型 blendtype string 值： 'Normal'、'Screen'、'Multiply'、'Add'、'*Overlay'、'*ColorBurn'、'*ColorDodge'
水平字段 horzfields string 值： 'Left/Width'、'Left/Right'、'Width/Right'
左边 left number
左边单位 leftunits string 值： 'pixels'、'percent'
宽度 width number
宽度单位 widthunits string 值： 'pixels'、'percent'
右边 right number
右边单位 rightunits string 值： 'pixels'、'percent'
垂直字段 vertfields string 值： 'Top/Height'、'Top/Bottom'、'Height/Bottom'
顶部 top number
顶部单位 topunits string 值： 'pixels'、'percent'
高度 height number
高度单位 heightunits string 值： 'pixels'、'percent'
底部 bottom number
底部单位 bottomunits string 值： 'pixels'、'percent'
环境光遮挡 aostrength number 值介于 0 和 100 之间
AO 距离 aodistance number
AO 软度 aosoftness number
AO 阈值 aobias number
AO 样本率 aosamplerate number
AO 扫描抖动 aodither boolean
阴影强度 shadowstrength number
阴影距离 shadowdist number
阴影柔软度 shadowsoftness number
阴影阈值 shadowbias number
光探针 lightprobe 图像元素
IBL 天际线截止 probehorizon number 值从 -1（无天际线）到 -0.001（硬边缘）
子演示 sourcepath string 要显示的子演示的 id
节点
位置 X position.x number
位置 Y position.y number
位置 Z position.z number
旋转 X rotation.x number
旋转 Y rotation.y number
旋转 Z rotation.z number
缩放 X scale.x number
缩放 Y scale.y number
缩放 Z scale.z number
枢轴 X pivot.x number
枢轴 Y pivot.y number
枢轴 Z pivot.z number
不透明度 opacity number
方向 string 值：'左手法则'，'右手法则'
旋转顺序 string 值：'XYZ'，'YZX'，'ZXY'，'XZY'，'YXZ'，'ZYX'，'XYZr'，'YZXr'，'ZXYr'，'XZYr'，'YXZr'，'ZYXr'
忽略父节点 boolean 防止父节点变换应用 [自 2.0 起被忽略]
别名
引用 referencednode string 相对或绝对元素路径
相机
正交 orthographic boolean
视场 fov number
剪裁开始 clipnear number
剪裁结束 clipfar number
运行时缩放模式 scalemode string 值：'Fit'，'Same Size'
运行时缩放锚点 scaleanchor string 值：'Center'，'NW'，'N'，'NE'，'E'，'SE'，'S'，'SW'，'W'
灯光
范围 scope string 元素的全路径
灯光类型 lighttype string 值：'Directional'，'Point'，'Area'
灯光颜色 R lightdiffuse.r number
灯光颜色 G lightdiffuse.g number
灯光颜色 B lightdiffuse.b number
镜面反射颜色 R lightspecular.r number
镜面反射颜色 G lightspecular.g number
镜面反射颜色 B lightspecular.b number
环境光颜色 R lightambient.r number
环境光颜色 G lightambient.g number
环境光颜色 B lightambient.b number
亮度 brightness number 仅适用于点光源
线性淡出 linearfade number 仅适用于点光源
指数淡出 expfade number 仅适用于点光源
投掷阴影？ castshadow boolean
阴影黑暗度 shdwfactor number
阴影柔软度 shdwfilter number
阴影分辨率 shdwmapres string 值：'256'，'512'，'1024'，'2048'
阴影深度偏差 shdwbias number
阴影远剪裁 shdwmapfar number
阴影视场 shdwmapfov number
组
导入 sourcepath string
文本
文本字符串 textstring string
文本颜色 R textcolor.r number
文本颜色 G textcolor.g number
文本颜色 B textcolor.b number
字体 font string
字体大小 size number
水平对齐 horzalign string 值：'Left'，'Center'，'Right'
垂直对齐 vertalign string 值：'Top'，'Middle'，'Bottom'
leading leading number
tracking tracking number
模型
网格 sourcepath string
细分模式 tessellation string 值：'None'，'Linear'，'Phong'，'NPatch' [自 2.0 起被忽略]
边细分 edgetess number 自 2.0 起被忽略
内部细分 innertess number 自 2.0 起被忽略
标准材质
照明 shaderlighting string 值：'Vertex'，'Pixel'，'None'
混合模式 blendmode string 值：'Normal'，'Screen'，'Multiply'
漫反射颜色 R diffuse.r number
漫反射颜色 G diffuse.g number
漫反射颜色 B diffuse.b number
漫反射贴图 diffusemap 图像元素 要更改图像，请将图像元素上的 sourcepath 属性设置为。
漫反射贴图 2 diffusemap2 图像元素 要更改图像，请将图像元素上的 sourcepath 属性设置为。
漫反射贴图 3 diffusemap3 图像元素 要更改图像，请将图像元素上的 sourcepath 属性设置为。
镜面反射 specularreflection 图像元素 要更改图像，请将图像元素上的 sourcepath 属性设置为。
镜面着色 R speculartint.r number
镜面着色 G speculartint.g number
镜面着色 B speculartint.b number
镜面强度 specularamount number
镜面贴图 specularmap 图像元素 要更改图像，请将图像元素上的 sourcepath 属性设置为。
镜面模型 specularmodel string 值: '默认', 'KGGX', 'KWard'
菲涅耳功率 fresnelPower number
折射指数 ior number
镜面粗糙度 specularroughness number
凹凸贴图 bumpmap 图像元素 要更改图像，请将图像元素上的 sourcepath 属性设置为。
法线贴图 normalmap 图像元素 要更改图像，请将图像元素上的 sourcepath 属性设置为。
凹凸强度 bumpamount number 影响凹凸和法线贴图
位移贴图 displacementmap 图像元素 要更改图像，请将图像元素上的 sourcepath 属性设置为。
位移强度 displaceamount number
不透明度 opacity number
不透明度贴图 opacitymap 图像元素 要更改图像，请将图像元素上的 sourcepath 属性设置为。
发射强度 emissivepower number
发射贴图 emissivemap 图像元素 要更改图像，请将图像元素上的 sourcepath 属性设置为。
材质引用
引用材质 referencedmaterial string 相对或绝对元素路径
图像
U 重复 scaleu number
V 重复 scalev number
纹理映射 mappingmode string 值: 'UV 映射', '环境映射'
U 平铺 tilingmodehorz string 值: '平铺', '镜像', '无平铺'
V 平铺 tilingmodevert string 值: '平铺', '镜像', '无平铺'
UV 旋转 rotationuv number
U 位置 positionu number
V 位置 positionv number
U 轴心 pivotu number
V 轴心 pivotv number
子演示 子表现形式 string 要显示的子演示的 id
源路径 sourcepath string 图像的路径

自定义材质和效果具有其自定义属性集，这些属性在 .material 或 .effect 文件中定义。例如，具有以下元数据的效果的实例将具有一个类型为 number 的 HBlurBias 属性，可以像内置属性一样设置和查询。

<Effect>
    <MetaData>
        <Property name="HBlurBias" formalName="Horizontal Blur" min="0" max="10" default="2" description="Amount of corona horizontally."/>
        ...

在某些 Qt 许可证下可用。
了解更多。