# 陷落柱
# 加载陷落柱
1️⃣ 使用引擎（Engine）的loadCollapseColumns接口加载陷落柱。
// 加载陷落柱
engine.loadCollapseColumns( 'assets/jsons/陷落柱.json' ).then( ( entities ) => {
// 遍历陷落柱实体
for ( let i = 0, il = entities.length; i < il; i++ ) {
// TODO:
}
} );
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
2️⃣ 使用引擎（Engine）的loadCollapseColumnsByData接口加载陷落柱。
// 加载陷落柱数据
const entities = engine.loadCollapseColumnsByData( data );
// 遍历陷落柱实体
for ( let i = 0, il = entities.length; i < il; i++ ) {
// TODO:
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
# 陷落柱纹理平铺间距设置
通过 tilingSpacing 初始属性设置纹理U方向和V方向的平铺间距（单位：米），tilingSpacing 初始属性需要再数据中设置，如下所示：
[{
"name": "陷落柱0",
"tilingSpacing": [ 20.0, 20.0 ], // 陷落柱0在U方向和V方向间隔20米平铺一次
"vertices": []
},{
"name": "陷落柱1",
"tilingSpacing": [ 10.0, 10.0 ], // 陷落柱1在U方向和V方向间隔20米平铺一次
"vertices": []
}]
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
注意
如果数据中未设置 tilingSpacing 属性，程序会使用默认值，即[ 20.0, 20.0 ]！
提示
# 陷落柱属性
提示
陷落柱使用CollapseColumn组件渲染，更新属性或调用接口时需要先获取陷落柱渲染组件。
import { CollapseColumn } from '@tx3d/core';
// 获取陷落柱渲染组件
const collapseColumn = entity.getComponent( CollapseColumn );
1
2
3
4
2
3
4
🌏 code 陷落柱编码，只读。
// 获取陷落柱编码
const code = collapseColumn.code;
1
2
2
🌏 wireframe 陷落柱线框模式，读写。
// 获取陷落柱是否是线框模式
const wireframe = collapseColumn.wireframe;
// 设置陷落柱为线框模式
collapseColumn.wireframe = true;
1
2
3
4
5
2
3
4
5
🌏 opacity 陷落柱透明度，读写。
// 获取陷落柱透明度
const opacity = collapseColumn.opacity;
// 设置陷落柱透明度
collapseColumn.opacity = 1.0;
1
2
3
4
5
2
3
4
5
# 陷落柱接口
🌏 setHighlight 设置陷落柱高亮。
// 高亮陷落柱
collapseColumn.setHighlight( true, { color: '#00ff00', opacity: 0.5 } );
// 取消陷落柱高亮
collapseColumn.setHighlight( false );
1
2
3
4
5
2
3
4
5
提示
高亮设置参数，详见HighlightParameters。