@realsee/five
Version:
Realsee Renderer SDK
342 lines (337 loc) • 29.8 kB
HTML
<html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>features/material | 如视 Five SDK</title><meta name="description" content="Documentation for 如视 Five SDK"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script><script async src="../assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar"><div class="tsd-toolbar-contents container"><a href="../index.html" class="title">如视 Five SDK</a><div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/><ul role="listbox" id="tsd-search-results"></ul><div id="tsd-search-status" aria-live="polite" aria-atomic="true"><div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header><div class="container container-main"><div class="col-content"><div class="tsd-page-title"><ul class="tsd-breadcrumb" aria-label="Breadcrumb"><li><a href="" aria-current="page">features/material</a></li></ul></div><div class="tsd-panel tsd-typography"><h1 id="material-parameters-材质参数" class="tsd-anchor-link">Material Parameters (材质参数)<a href="#material-parameters-材质参数" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h1>
<ul>
<li><strong>Summary</strong>: 配置 3D 模型与全景图过渡的视觉表现、渲染样式及特效。</li>
<li><strong>Schema</strong>: 对应 <code>ParameterMaterialValue</code> 接口,定义了材质、点云、楼层等外观属性。</li>
<li><strong>Concepts</strong>: Transparency (透明度), Point Cloud (点云), Floor Style (楼层样式), PBR (物理渲染)。</li>
<li><strong>Configuration</strong>: 包含透明度、混合模式、点云大小/形状、阴影设置等详细参数。</li>
<li><strong>Examples</strong>: 模型透明度调整、点云样式定制。</li>
</ul>
<h2 id="schema" class="tsd-anchor-link">Schema<a href="#schema" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
<blockquote>
<p><strong>Definition</strong>: <a href="../../five/model/parameter.d.ts">ParameterMaterialValue</a></p>
</blockquote>
<p>以下是 <code>ParameterMaterialValue</code> 的 TypeScript 定义摘要:</p>
<pre><code class="typescript"><span class="hl-10">export</span><span class="hl-1"> </span><span class="hl-3">interface</span><span class="hl-1"> </span><span class="hl-7">ParameterMaterialValue</span><span class="hl-1"> {</span><br/><span class="hl-1"> </span><span class="hl-8">/** 模型整体透明度 [0, 1] */</span><br/><span class="hl-1"> </span><span class="hl-6">opacity</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1"> </span><span class="hl-8">/** 点云基础缩放比例 */</span><br/><span class="hl-1"> </span><span class="hl-6">pointScale</span><span class="hl-1">: </span><span class="hl-7">number</span><span class="hl-1">;</span><br/><span class="hl-1"> </span><span class="hl-8">/** 点云大小绘制方式 ('ATTENUATION' | 'FIXED') */</span><br/><span class="hl-1"> </span><span class="hl-6">pointSize</span><span class="hl-1">: </span><span class="hl-7">PBMPointSize</span><span class="hl-1">;</span><br/><span class="hl-1"> </span><span class="hl-8">/** 楼层显示样式 ('OPACITY' | 'VISIBILITY') */</span><br/><span class="hl-1"> </span><span class="hl-6">floorStyle</span><span class="hl-1">: </span><span class="hl-7">PBMFloorStyle</span><span class="hl-1">;</span><br/><span class="hl-1"> </span><span class="hl-8">// ... 更多字段见下方配置表</span><br/><span class="hl-1">}</span>
</code><button type="button">Copy</button></pre>
<h2 id="concepts" class="tsd-anchor-link">Concepts<a href="#concepts" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
<h3 id="1-transparency-blending-透明度与混合" class="tsd-anchor-link">1. Transparency & Blending (透明度与混合)<a href="#1-transparency-blending-透明度与混合" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
<p>材质系统提供了两种维度的透明度控制:</p>
<ul>
<li><strong>Opacity (<code>opacity</code>)</strong>: 控制模型整体的不透明度 (0-1)。</li>
<li><strong>Model Alpha (<code>modelAlpha</code>)</strong>: 控制纹理混合的权重。
<ul>
<li><code>0</code>: 仅显示模型自带的 UV 纹理(通常是颜色单一的白模或人工烘焙的纹理)。</li>
<li><code>1</code>: 仅显示从全景图投影到模型上的纹理(真实感强,但可能存在投影误差)。</li>
<li><code>0.5</code>: 两者混合。</li>
</ul>
</li>
</ul>
<h3 id="2-point-cloud-rendering-点云渲染" class="tsd-anchor-link">2. Point Cloud Rendering (点云渲染)<a href="#2-point-cloud-rendering-点云渲染" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
<p>Five 支持高性能的点云渲染(PBM),并提供灵活的样式配置:</p>
<ul>
<li><strong>Size Attenuation</strong>: 通过 <code>pointSize: 'ATTENUATION'</code> 开启近大远小的透视效果,增强空间感。</li>
<li><strong>Pixel Limits</strong>: 通过 <code>pointMinPixel</code> 和 <code>pointMaxPixel</code> 限制点在屏幕上的最小/最大像素尺寸,防止远处点消失或近处点过大遮挡视线。</li>
</ul>
<h3 id="3-floor-management-楼层管理" class="tsd-anchor-link">3. Floor Management (楼层管理)<a href="#3-floor-management-楼层管理" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
<p>对于多楼层场景,可以通过参数控制楼层的显示策略:</p>
<ul>
<li><strong>Floor Style (<code>floorStyle</code>)</strong>: 控制非当前楼层的显示方式(如 <code>OPACITY</code> 半透明、<code>VISIBILITY</code> 隐藏等)。</li>
<li><strong>Shown Floor (<code>shownFloorIndex</code>)</strong>: 指定当前高亮显示的楼层索引。</li>
</ul>
<h3 id="4-vertex-marks-semantic-filtering-顶点标记与语义过滤" class="tsd-anchor-link">4. Vertex Marks & Semantic Filtering (顶点标记与语义过滤)<a href="#4-vertex-marks-semantic-filtering-顶点标记与语义过滤" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
<p><code>vertexMarks</code> 是一个<strong>全局开关</strong>,用于控制是否启用模型顶点上的语义标记(<code>_feature_id_rsmask</code>)逻辑。</p>
<ul>
<li><strong>机制</strong>: 模型顶点预置了 <code>_feature_id_rsmask</code> 属性,不同的值代表不同的语义部分。</li>
<li><strong>当前支持</strong>: 目前主要支持 <code>_feature_id_rsmask=1</code>(通常标记为天花板/房顶)。
<ul>
<li>当 <code>vertexMarks</code> 开启时,标记为 <code>1</code> 的顶点部分会在特定视角(如俯视)下自动隐藏,实现“开盖”效果,优化室内布局观测体验。</li>
</ul>
</li>
<li><strong>未来扩展</strong>: 该机制设计支持更多标记值,未来可能用于控制其他特定模型部件的显示效果。</li>
</ul>
<h2 id="configuration" class="tsd-anchor-link">Configuration<a href="#configuration" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
<p>以下表格列出了控制材质与外观的可用参数,按使用频率和场景分类。</p>
<h3 id="common-configuration-常用配置" class="tsd-anchor-link">Common Configuration (常用配置)<a href="#common-configuration-常用配置" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
<table>
<thead>
<tr>
<th style="text-align:left">Parameter</th>
<th style="text-align:left">Type</th>
<th style="text-align:left">Default</th>
<th style="text-align:left">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>opacity</code></td>
<td style="text-align:left"><code>number</code></td>
<td style="text-align:left"><code>1.0</code></td>
<td style="text-align:left">模型整体透明度 [0, 1]。0 为完全透明,1 为完全不透明。</td>
</tr>
<tr>
<td style="text-align:left"><code>pointScale</code></td>
<td style="text-align:left"><code>number</code></td>
<td style="text-align:left"><code>0.02</code></td>
<td style="text-align:left">点的基础缩放比例(控制点的大小)。</td>
</tr>
<tr>
<td style="text-align:left"><code>pointSize</code></td>
<td style="text-align:left"><code>PBMPointSize</code></td>
<td style="text-align:left"><code>'ATTENUATION'</code></td>
<td style="text-align:left">点云大小绘制方式。<br><code>'ATTENUATION'</code>: 随距离衰减(近大远小);<br><code>'FIXED'</code>: 固定像素大小。</td>
</tr>
<tr>
<td style="text-align:left"><code>pointShape</code></td>
<td style="text-align:left"><code>PBMPointShape</code></td>
<td style="text-align:left"><code>'CIRCLE'</code></td>
<td style="text-align:left">点云形状。<br><code>'CIRCLE'</code>: 圆形;<br><code>'SQUARE'</code>:方形。</td>
</tr>
<tr>
<td style="text-align:left"><code>pointBack</code></td>
<td style="text-align:left"><code>PBMPointBack</code></td>
<td style="text-align:left"><code>'DARK'</code></td>
<td style="text-align:left">点云背面绘制方式。</td>
</tr>
<tr>
<td style="text-align:left"><code>pointMinPixel</code></td>
<td style="text-align:left"><code>number</code></td>
<td style="text-align:left"><code>0</code></td>
<td style="text-align:left">点云最小像素尺寸。</td>
</tr>
<tr>
<td style="text-align:left"><code>pointMaxPixel</code></td>
<td style="text-align:left"><code>number</code></td>
<td style="text-align:left"><code>40</code></td>
<td style="text-align:left">点云最大像素尺寸。</td>
</tr>
<tr>
<td style="text-align:left"><code>pointAppearAnimation</code></td>
<td style="text-align:left"><code>boolean</code></td>
<td style="text-align:left"><code>true</code></td>
<td style="text-align:left">是否开启点云出现动画。</td>
</tr>
<tr>
<td style="text-align:left"><code>vertexMarks</code></td>
<td style="text-align:left"><code>boolean</code></td>
<td style="text-align:left"><code>true</code></td>
<td style="text-align:left">是否显示/生效标注。</td>
</tr>
<tr>
<td style="text-align:left"><code>brightness</code></td>
<td style="text-align:left"><code>number</code></td>
<td style="text-align:left"><code>1.0</code></td>
<td style="text-align:left">场景亮度倍数。</td>
</tr>
<tr>
<td style="text-align:left"><code>floorStyle</code></td>
<td style="text-align:left"><code>PBMFloorStyle</code></td>
<td style="text-align:left"><code>'OPACITY'</code></td>
<td style="text-align:left">楼层显示样式。</td>
</tr>
<tr>
<td style="text-align:left"><code>shownFloorIndex</code></td>
<td style="text-align:left"><code>number</code></td>
<td style="text-align:left"><code>-1</code></td>
<td style="text-align:left">当前显示的楼层索引。<code>-1</code> 表示显示所有楼层。</td>
</tr>
<tr>
<td style="text-align:left"><code>castShadow</code></td>
<td style="text-align:left"><code>boolean</code></td>
<td style="text-align:left"><code>false</code></td>
<td style="text-align:left">模型是否产生阴影。</td>
</tr>
<tr>
<td style="text-align:left"><code>receiveShadow</code></td>
<td style="text-align:left"><code>boolean</code></td>
<td style="text-align:left"><code>false</code></td>
<td style="text-align:left">模型是否接收阴影。</td>
</tr>
<tr>
<td style="text-align:left"><code>useAddBlend</code></td>
<td style="text-align:left"><code>boolean</code></td>
<td style="text-align:left"><code>false</code></td>
<td style="text-align:left">是否使用半透明叠加渲染。</td>
</tr>
<tr>
<td style="text-align:left"><code>customShaders</code></td>
<td style="text-align:left"><code>PBMCustomShader[]</code></td>
<td style="text-align:left"><code>[]</code></td>
<td style="text-align:left">自定义 Shader 配置。</td>
</tr>
<tr>
<td style="text-align:left"><code>panoFilter</code></td>
<td style="text-align:left"><code>PBMPanoFilter</code></td>
<td style="text-align:left"><code>null</code></td>
<td style="text-align:left">全景图滤镜 (亮度、对比度、色温等)。详情见 <a href="features_pano-filter.html">Pano Filter</a>。</td>
</tr>
<tr>
<td style="text-align:left"><code>clippers</code></td>
<td style="text-align:left"><code>PBMClipperParameter[]</code></td>
<td style="text-align:left"><code>[]</code></td>
<td style="text-align:left">模型裁切参数。</td>
</tr>
<tr>
<td style="text-align:left"><code>boundingBox</code></td>
<td style="text-align:left"><code>THREE.Box3</code></td>
<td style="text-align:left"><code>Infinity</code></td>
<td style="text-align:left">模型包围盒。</td>
</tr>
</tbody>
</table>
<h3 id="advanced-appearance-进阶外观配置" class="tsd-anchor-link">Advanced Appearance (进阶外观配置)<a href="#advanced-appearance-进阶外观配置" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
<blockquote>
<p>这些参数较少使用,仅在需要精细调整特殊视觉效果时修改。</p>
</blockquote>
<table>
<thead>
<tr>
<th style="text-align:left">Parameter</th>
<th style="text-align:left">Type</th>
<th style="text-align:left">Default</th>
<th style="text-align:left">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>colorSaturation</code></td>
<td style="text-align:left"><code>number</code></td>
<td style="text-align:left"><code>0.0</code></td>
<td style="text-align:left">饱和度调整值。</td>
</tr>
<tr>
<td style="text-align:left"><code>colorBrightness</code></td>
<td style="text-align:left"><code>number</code></td>
<td style="text-align:left"><code>0.0</code></td>
<td style="text-align:left">亮度调整值(与 <code>brightness</code> 叠加)。</td>
</tr>
<tr>
<td style="text-align:left"><code>colorStyle</code></td>
<td style="text-align:left"><code>PBMColorStyle</code></td>
<td style="text-align:left"><code>'RGB'</code></td>
<td style="text-align:left">颜色显示样式。</td>
</tr>
<tr>
<td style="text-align:left"><code>constantColor</code></td>
<td style="text-align:left"><code>THREE.Vector3</code></td>
<td style="text-align:left"><code>(0.6, 0.6, 0.6)</code></td>
<td style="text-align:left">模型纯色模式下的颜色值。</td>
</tr>
<tr>
<td style="text-align:left"><code>outlineGain</code></td>
<td style="text-align:left"><code>number</code></td>
<td style="text-align:left"><code>0.0</code></td>
<td style="text-align:left">轮廓线增益。</td>
</tr>
<tr>
<td style="text-align:left"><code>distanceGain</code></td>
<td style="text-align:left"><code>number</code></td>
<td style="text-align:left"><code>0.0</code></td>
<td style="text-align:left">距离增益。</td>
</tr>
<tr>
<td style="text-align:left"><code>gaussianSplattingSHDegree</code></td>
<td style="text-align:left"><code>number</code></td>
<td style="text-align:left"><code>0</code></td>
<td style="text-align:left">3D Gaussian Splatting 的球谐阶数。</td>
</tr>
</tbody>
</table>
<h3 id="internal-low-level-内部与底层配置" class="tsd-anchor-link">Internal & Low-Level (内部与底层配置)<a href="#internal-low-level-内部与底层配置" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
<blockquote>
<p><strong>注意</strong>: 以下参数主要用于引擎内部状态同步或特定底层逻辑,<strong>不建议开发者手动修改</strong>,以免引起渲染异常。</p>
</blockquote>
<table>
<thead>
<tr>
<th style="text-align:left">Parameter</th>
<th style="text-align:left">Type</th>
<th style="text-align:left">Default</th>
<th style="text-align:left">Description</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align:left"><code>modelAlpha</code></td>
<td style="text-align:left"><code>number</code></td>
<td style="text-align:left"><code>1.0</code></td>
<td style="text-align:left">模型纹理混合系数。通常由 Five 内部模式切换控制。</td>
</tr>
<tr>
<td style="text-align:left"><code>useHQWeight</code></td>
<td style="text-align:left"><code>boolean</code></td>
<td style="text-align:left"><code>false</code></td>
<td style="text-align:left">是否使用高质量权重计算(影响渲染质量)。</td>
</tr>
<tr>
<td style="text-align:left"><code>useHQDepth</code></td>
<td style="text-align:left"><code>boolean</code></td>
<td style="text-align:left"><code>false</code></td>
<td style="text-align:left">是否使用高质量深度遮罩。</td>
</tr>
<tr>
<td style="text-align:left"><code>progress</code></td>
<td style="text-align:left"><code>number</code></td>
<td style="text-align:left"><code>0</code></td>
<td style="text-align:left">全景图混合进度。</td>
</tr>
<tr>
<td style="text-align:left"><code>transition</code></td>
<td style="text-align:left"><code>PBMTransition</code></td>
<td style="text-align:left"><code>'FADE'</code></td>
<td style="text-align:left">全景图过渡混合模式。</td>
</tr>
<tr>
<td style="text-align:left"><code>gradientTexture</code></td>
<td style="text-align:left"><code>THREE.Texture</code></td>
<td style="text-align:left"><code>default</code></td>
<td style="text-align:left">高程着色材质纹理。</td>
</tr>
<tr>
<td style="text-align:left"><code>pano0</code></td>
<td style="text-align:left"><code>PBMPanoPicture</code></td>
<td style="text-align:left"><code>null</code></td>
<td style="text-align:left">起始点全景图信息。</td>
</tr>
<tr>
<td style="text-align:left"><code>pano1</code></td>
<td style="text-align:left"><code>PBMPanoPicture</code></td>
<td style="text-align:left"><code>null</code></td>
<td style="text-align:left">结束点全景图信息。</td>
</tr>
<tr>
<td style="text-align:left"><code>pano0Depth</code></td>
<td style="text-align:left"><code>PBMPanoDepth</code></td>
<td style="text-align:left"><code>null</code></td>
<td style="text-align:left">起始点深度信息。</td>
</tr>
<tr>
<td style="text-align:left"><code>pano1Depth</code></td>
<td style="text-align:left"><code>PBMPanoDepth</code></td>
<td style="text-align:left"><code>null</code></td>
<td style="text-align:left">结束点深度信息。</td>
</tr>
<tr>
<td style="text-align:left"><code>refinedScreen</code></td>
<td style="text-align:left"><code>PBMRefinedScreen</code></td>
<td style="text-align:left"><code>null</code></td>
<td style="text-align:left">细化瓦片的屏幕渲染配置。</td>
</tr>
</tbody>
</table>
<h2 id="examples" class="tsd-anchor-link">Examples<a href="#examples" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
<h3 id="1-adjusting-model-transparency-and-style-调整模型透明度与样式" class="tsd-anchor-link">1. Adjusting Model Transparency and Style (调整模型透明度与样式)<a href="#1-adjusting-model-transparency-and-style-调整模型透明度与样式" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
<pre><code class="typescript"><span class="hl-8">// 设置半透明</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">modelScene</span><span class="hl-1">.</span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-9">'opacity'</span><span class="hl-1">, </span><span class="hl-11">0.5</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 仅显示原始 UV 贴图</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">modelScene</span><span class="hl-1">.</span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-9">'modelAlpha'</span><span class="hl-1">, </span><span class="hl-11">0.0</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 设置楼层样式</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">modelScene</span><span class="hl-1">.</span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-9">'floorStyle'</span><span class="hl-1">, </span><span class="hl-9">'wireframe'</span><span class="hl-1">);</span>
</code><button type="button">Copy</button></pre>
<h3 id="2-configuring-point-cloud-appearance-配置点云外观" class="tsd-anchor-link">2. Configuring Point Cloud Appearance (配置点云外观)<a href="#2-configuring-point-cloud-appearance-配置点云外观" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h3>
<pre><code class="typescript"><span class="hl-8">// 大小随距离衰减</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">modelScene</span><span class="hl-1">.</span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-9">'pointSize'</span><span class="hl-1">, </span><span class="hl-9">'ATTENUATION'</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 基础大小</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">modelScene</span><span class="hl-1">.</span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-9">'pointScale'</span><span class="hl-1">, </span><span class="hl-11">0.05</span><span class="hl-1">);</span><br/><br/><span class="hl-8">// 最大像素限制</span><br/><span class="hl-6">five</span><span class="hl-1">.</span><span class="hl-6">modelScene</span><span class="hl-1">.</span><span class="hl-6">parameter</span><span class="hl-1">.</span><span class="hl-5">set</span><span class="hl-1">(</span><span class="hl-9">'pointMaxPixel'</span><span class="hl-1">, </span><span class="hl-11">20</span><span class="hl-1">);</span>
</code><button type="button">Copy</button></pre>
<h2 id="related" class="tsd-anchor-link">Related<a href="#related" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="../assets/icons.svg#icon-anchor"></use></svg></a></h2>
<ul>
<li><a href="features_parameter.html">Parameter</a>: 配置系统入口与继承逻辑。</li>
<li><a href="features_pano-filter.html">Pano Filter</a>: 了解全景图滤镜的详细用法。</li>
<li><a href="features_3dtile.html">3DTile Params</a>: 性能与加载相关参数。</li>
</ul>
<hr>
<pre><code class="yaml"><span class="hl-0">tags</span><span class="hl-1">: [</span><span class="hl-2">材质</span><span class="hl-1">, </span><span class="hl-2">透明度</span><span class="hl-1">, </span><span class="hl-2">点云</span><span class="hl-1">, </span><span class="hl-2">楼层</span><span class="hl-1">, </span><span class="hl-2">阴影</span><span class="hl-1">, </span><span class="hl-2">亮度</span><span class="hl-1">, </span><span class="hl-2">天花板</span><span class="hl-1">, </span><span class="hl-2">开盖</span><span class="hl-1">, </span><span class="hl-2">顶点标记</span><span class="hl-1">, </span><span class="hl-2">渲染样式</span><span class="hl-1">, </span><span class="hl-2">material</span><span class="hl-1">, </span><span class="hl-2">appearance</span><span class="hl-1">, </span><span class="hl-2">pointcloud</span><span class="hl-1">, </span><span class="hl-2">parameter</span><span class="hl-1">, </span><span class="hl-2">roof</span><span class="hl-1">, </span><span class="hl-2">ceiling</span><span class="hl-1">, </span><span class="hl-2">config</span><span class="hl-1">, </span><span class="hl-2">opacity</span><span class="hl-1">]</span>
</code><button type="button">Copy</button></pre>
</div></div><div class="col-sidebar"><div class="page-menu"><div class="tsd-navigation settings"><details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>Settings</h3></summary><div class="tsd-accordion-details"><div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span><ul id="tsd-filter-options"><li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li></ul></div><div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div><details open class="tsd-accordion tsd-page-navigation"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg><h3>On This Page</h3></summary><div class="tsd-accordion-details"><a href="#material-parameters-材质参数"><span>Material <wbr/>Parameters (材质参数)</span></a><ul><li><a href="#schema"><span>Schema</span></a></li><li><a href="#concepts"><span>Concepts</span></a></li><li><ul><li><a href="#1-transparency-blending-透明度与混合"><span>1. <wbr/>Transparency & <wbr/>Blending (透明度与混合)</span></a></li><li><a href="#2-point-cloud-rendering-点云渲染"><span>2. <wbr/>Point <wbr/>Cloud <wbr/>Rendering (点云渲染)</span></a></li><li><a href="#3-floor-management-楼层管理"><span>3. <wbr/>Floor <wbr/>Management (楼层管理)</span></a></li><li><a href="#4-vertex-marks-semantic-filtering-顶点标记与语义过滤"><span>4. <wbr/>Vertex <wbr/>Marks & <wbr/>Semantic <wbr/>Filtering (顶点标记与语义过滤)</span></a></li></ul></li><li><a href="#configuration"><span>Configuration</span></a></li><li><ul><li><a href="#common-configuration-常用配置"><span>Common <wbr/>Configuration (常用配置)</span></a></li><li><a href="#advanced-appearance-进阶外观配置"><span>Advanced <wbr/>Appearance (进阶外观配置)</span></a></li><li><a href="#internal-low-level-内部与底层配置"><span>Internal & <wbr/>Low-<wbr/>Level (内部与底层配置)</span></a></li></ul></li><li><a href="#examples"><span>Examples</span></a></li><li><ul><li><a href="#1-adjusting-model-transparency-and-style-调整模型透明度与样式"><span>1. <wbr/>Adjusting <wbr/>Model <wbr/>Transparency and <wbr/>Style (调整模型透明度与样式)</span></a></li><li><a href="#2-configuring-point-cloud-appearance-配置点云外观"><span>2. <wbr/>Configuring <wbr/>Point <wbr/>Cloud <wbr/>Appearance (配置点云外观)</span></a></li></ul></li><li><a href="#related"><span>Related</span></a></li></ul></div></details></div><div class="site-menu"><nav class="tsd-navigation"><a href="../modules.html">如视 Five SDK</a><ul class="tsd-small-nested-navigation" id="tsd-nav-container"><li>Loading...</li></ul></nav></div></div></div><footer><p class="tsd-generator">Generated using <a href="https://typedoc.org/" target="_blank">TypeDoc</a></p></footer><div class="overlay"></div></body></html>