SceneView
构造函数
SceneView
SceneView 类用于显示 3D 地图场景，并提供与场景交互的方法和属性。
new SceneView(options)
参数
- options:
anySceneView 的构造选项，用于配置视图的初始状态和行为。
返回：SceneView SceneView对象
属性
alphaCompositingEnabled
alphaCompositingEnabled: any
类型: any
analyses
analyses: any
类型: any
analysisViewManager
analysisViewManager: any
类型: any
basemapTerrain
basemapTerrain: any
类型: any
canvas
canvas: any
类型: any
constraints
constraints: any
类型: any
deactivatedWebGLExtensions
deactivatedWebGLExtensions: any
类型: any
debugWebGLExtensions
debugWebGLExtensions: any
类型: any
deconflictor
deconflictor: any
类型: any
elevationProvider
elevationProvider: any
类型: any
environment
environment: any
类型: any
environmentManager
environmentManager: any
类型: any
featureTiles
featureTiles: any
类型: any
floors
floors: any
类型: any
fullOpacity
fullOpacity: any
类型: any
graphicsView
graphicsView: any
类型: any
groundView
groundView: any
类型: any
inputManager
inputManager: any
类型: any
labeler
labeler: any
类型: any
map
map: any
类型: any
pointsOfInterest
pointsOfInterest: any
类型: any
preserveDrawingBufferEnabled
preserveDrawingBufferEnabled: any
类型: any
qualitySettings
qualitySettings: any
类型: any
renderCanvas
renderCanvas: any
类型: any
renderCoordsHelper
renderCoordsHelper: any
类型: any
sceneIntersectionHelper
sceneIntersectionHelper: any
类型: any
screenSizePerspectiveEnabled
screenSizePerspectiveEnabled: any
类型: any
spatialReference
spatialReference: any
类型: any
state
state: any
类型: any
stateManager
stateManager: any
类型: any
supersampleScreenshotsEnabled
supersampleScreenshotsEnabled: any
类型: any
textures
textures: any
类型: any
type
type: any
类型: any
ui
ui: any
类型: any
updatingProgress
updatingProgress: any
类型: any
访问器
animation
获取当前场景视图的动画状态。
get animation(): any
返回: any 获取当前场景视图的动画状态。
basemapSpatialReference
获取底图的空间参考。
get basemapSpatialReference(): any
返回: any 获取底图的空间参考。
camera
获取场景视图的相机对象，用于控制观察位置和方向。
get camera(): any
返回: any 获取场景视图的相机对象，用于控制观察位置和方向。
设置场景视图的相机位置。
set camera(cameraValue: any): void
参数
- cameraValue:
any
返回: void
center
获取场景视图的中心点。
get center(): any
返回: any 获取场景视图的中心点。
设置场景视图的中心点。
set center(centerValue: any): void
参数
- centerValue:
any
返回: void
clippingArea
获取或设置场景视图的裁剪区域。裁剪区域用于限制场景中可见的区域范围。
get clippingArea(): any
返回: any 获取或设置场景视图的裁剪区域。裁剪区域用于限制场景中可见的区域范围。
设置场景视图的裁剪区域。裁剪区域仅在本地查看模式下受支持。
set clippingArea(clippingArea: any): void
参数
- clippingArea:
any
返回: void
contentCamera
获取内容相机对象，用于控制场景内容的视角和位置。
get contentCamera(): any
返回: any 获取内容相机对象，用于控制场景内容的视角和位置。
设置场景视图的内容相机。
set contentCamera(camera: any): void
参数
- camera:
any
返回: void
dataExtent
获取场景的数据范围。该范围考虑了地面和图层的范围，并与裁剪区域相交。
get dataExtent(): any
返回: any 获取场景的数据范围。该范围考虑了地面和图层的范围，并与裁剪区域相交。
defaultsFromMapSettings
获取地图设置的默认配置。
get defaultsFromMapSettings(): object
返回: object 获取地图设置的默认配置。
extent
获取场景视图的当前范围。
get extent(): any
返回: any 获取场景视图的当前范围。
设置场景视图的范围。
set extent(extentValue: any): void
参数
- extentValue:
any
返回: void
frustum
获取当前场景视图的视锥体。
get frustum(): any
返回: any 获取当前场景视图的视锥体。
heightModelInfo
获取场景视图的高度模型信息。
get heightModelInfo(): any
返回: any 获取场景视图的高度模型信息。
highlightOptions
获取或设置场景视图的高亮选项。
get highlightOptions(): any
返回: any 获取或设置场景视图的高亮选项。
设置场景视图的高亮选项。
set highlightOptions(options: any): void
参数
- options:
any
返回: void
initialExtentRequired
获取是否需要初始范围的标志。
get initialExtentRequired(): boolean
返回: boolean 获取是否需要初始范围的标志。
interacting
指示用户当前是否正在与视图进行交互。
get interacting(): any
返回: any 指示用户当前是否正在与视图进行交互。
navigating
指示视图当前是否正在导航中。
get navigating(): any
返回: any 指示视图当前是否正在导航中。
padding
获取或设置场景视图的内边距。
get padding(): any
返回: any 获取或设置场景视图的内边距。
设置场景视图的内边距。
set padding(paddingValue: any): void
参数
- paddingValue:
any
返回: void
performanceInfo
获取场景视图的性能信息对象。
get performanceInfo(): any
返回: any 获取场景视图的性能信息对象。
quality
获取场景视图的质量因子，该因子影响内存使用和渲染质量。
get quality(): any
返回: any 获取场景视图的质量因子，该因子影响内存使用和渲染质量。
qualityProfile
获取或设置场景视图的质量配置文件。
get qualityProfile(): any
返回: any 获取或设置场景视图的质量配置文件。
设置场景视图的质量配置文件。
set qualityProfile(profile: any): void
参数
- profile:
any
返回: void
renderDataExtent
获取渲染数据范围。在全球视图模式下返回null，否则返回数据范围或转换后的范围。
get renderDataExtent(): any
返回: any 获取渲染数据范围。在全球视图模式下返回null，否则返回数据范围或转换后的范围。
renderSpatialReference
获取渲染空间参考。
get renderSpatialReference(): any
返回: any 获取渲染空间参考。
resolution
获取视图的分辨率，即每个像素代表的地图单位数。
get resolution(): any
返回: any 获取视图的分辨率，即每个像素代表的地图单位数。
resolutionScale
获取场景视图的分辨率比例，该比例基于当前质量设置计算得出。
get resolutionScale(): number
返回: number 获取场景视图的分辨率比例，该比例基于当前质量设置计算得出。
resourceController
获取场景视图的资源控制器。
get resourceController(): any
返回: any 获取场景视图的资源控制器。
scale
获取当前场景视图的比例尺。
get scale(): any
返回: any 获取当前场景视图的比例尺。
设置场景视图的比例尺。
set scale(scaleValue: any): void
参数
- scaleValue:
any
返回: void
screenCenter
获取屏幕中心点的坐标。
get screenCenter(): any
返回: any 获取屏幕中心点的坐标。
slicePlane
设置场景的切片平面，用于在3D视图中切割显示场景内容。
set slicePlane(plane: any): void
参数
- plane:
any
返回: void
stationary
指示视图当前是否处于静止状态。当视图没有动画、没有调整大小且状态为静止时返回 true。
get stationary(): any
返回: any 指示视图当前是否处于静止状态。当视图没有动画、没有调整大小且状态为静止时返回 true。
test
获取测试相关属性或方法。
get test(): void
返回: void 获取测试相关属性或方法。
tileInfo
获取与场景视图相关的基础地图地形切片方案信息。
get tileInfo(): any
返回: any 获取与场景视图相关的基础地图地形切片方案信息。
typeSpecificPreconditionsReady
获取特定类型的前提条件是否已准备就绪。
get typeSpecificPreconditionsReady(): boolean
返回: boolean 获取特定类型的前提条件是否已准备就绪。
updating
指示场景视图是否正在更新中。当视图正在处理数据、渲染或执行其他后台任务时，此属性为 true。
get updating(): any
返回: any 指示场景视图是否正在更新中。当视图正在处理数据、渲染或执行其他后台任务时，此属性为 true。
viewingMode
获取场景视图的查看模式，可以是 'global'（全球）或 'local'（本地）。
get viewingMode(): any
返回: any 获取场景视图的查看模式，可以是 'global'（全球）或 'local'（本地）。
设置场景的视图模式，可以是全局模式或局部模式。
set viewingMode(mode: any): void
参数
- mode:
any
返回: void
viewpoint
获取场景的当前视点，包括相机位置、观察方向和缩放级别等信息。
get viewpoint(): any
返回: any 获取场景的当前视点，包括相机位置、观察方向和缩放级别等信息。
设置场景的视点，控制观察者查看场景的位置和方向。
set viewpoint(viewpointValue: any): void
参数
- viewpointValue:
any
返回: void
visibleArea
获取当前视图的可见区域。
get visibleArea(): any
返回: any 获取当前视图的可见区域。
zoom
获取当前视图的缩放级别。
get zoom(): any
返回: any 获取当前视图的缩放级别。
设置场景视图的缩放级别。
set zoom(zoomLevel: any): void
参数
- zoomLevel:
any
返回: void
方法
_completeSettings
完成截图设置配置，处理渲染设置和超级采样设置。
_completeSettings(settings): Promise
参数
- settings:
any需要完成的截图设置对象。
返回：Promise
_createGraphicsViewAsync
异步创建图形视图实例。
_createGraphicsViewAsync(options): Promise
参数
- options:
any创建选项，可能包含中止信号。
返回：Promise
_createGraphicsViewIfNeeded
在需要时创建图形视图。如果已存在图形视图或正在创建中，则不执行任何操作。
_createGraphicsViewIfNeeded(): void
返回：void
_disposeGraphicsView
释放图形视图资源并清理相关引用。
_disposeGraphicsView(): void
返回：void
_exitCoordinateSystem
退出坐标系统，清理与渲染坐标相关的资源。
_exitCoordinateSystem(): void
返回：void
_exitGlobe
退出地球视图模式，清理相关资源和状态。
_exitGlobe(): void
返回：void
_exitSurface
清理并销毁场景视图中的共享符号资源，并退出地球和舞台模式。
_exitSurface(): void
返回：void
_initCoordinateSystem
初始化场景视图的坐标系统，设置渲染坐标辅助器并处理空间参考相关的逻辑。
_initCoordinateSystem(): void
返回：void
_initGlobe
初始化场景视图的地球组件，包括坐标系统、初始相机、底图地形、兴趣点和要素瓦片等核心组件。
_initGlobe(): void
返回：void
_initStage
初始化场景视图的渲染阶段，设置WebGL渲染器、相交检测助手和事件处理程序。
_initStage(): void
返回：void
_initSurface
初始化场景表面，包括退出当前表面、初始化舞台和地球，并创建共享符号资源。
_initSurface(viewingMode): void
参数
- viewingMode:
any视图模式，用于确定如何渲染场景。
返回：void
_makeSpatialReferenceConstraints
根据给定的空间参考、切片信息和查看模式创建空间参考约束。
_makeSpatialReferenceConstraints(spatialRef, tileInfo, viewingMode): object
参数
- spatialRef:
any空间参考对象。 - tileInfo:
any切片信息对象。 - viewingMode:
any查看模式。
返回：object
_pixelFormat
获取像素格式配置，用于渲染视图。
_pixelFormat(): object
返回：object
_prepareScreenshotOverlay
准备截图覆盖层，确保覆盖层已准备就绪。
_prepareScreenshotOverlay(): Promise
返回：Promise
_renderScreenshotOverlay
将覆盖层渲染到截图图像数据上。
_renderScreenshotOverlay(canvas, disableDecorations, imageData): any
参数
- canvas:
any用于渲染的画布元素。 - disableDecorations:
any是否禁用装饰的标志。 - imageData:
any要渲染的图像数据。
返回：any
_startup
初始化场景视图，设置必要的组件和事件监听器，并解析待处理的就绪回调。
_startup(): void
返回：void
_takeScreenshot
内部方法，用于捕获场景视图的屏幕截图。
_takeScreenshot(options): Promise
参数
- options:
any屏幕截图的配置选项。
返回：Promise
_takeScreenshotWithObjectAndLayerId
使用对象ID和图层ID截取屏幕截图的内部方法。
_takeScreenshotWithObjectAndLayerId(screenshotConfig): Promise
参数
- screenshotConfig:
any截图配置对象。
返回：Promise
_teardown
清理并销毁场景视图所使用的资源和事件连接。
_teardown(): void
返回：void
_updateDefaultHitTestOptions
更新默认的点击测试选项，排除不透明度小于1的地面和集成网格图层。
_updateDefaultHitTestOptions(): void
返回：void
_updateDefaultToMapOptions
更新默认的地图选项，包含地面和集成网格图层。
_updateDefaultToMapOptions(): void
返回：void
_updateUpdatingMonitors
更新视图的更新监视器，用于跟踪图层视图的更新状态。
_updateUpdatingMonitors(updateEvent): void
参数
- updateEvent:
any=null更新事件对象，默认为null。如果事件类型为MOVE，则不执行更新。
返回：void
_validateSpatialReference
验证空间参考是否被当前视图支持。
_validateSpatialReference(spatialReference): boolean
参数
- spatialReference:
any要验证的空间参考对象。
返回：boolean
_validateSpatialReferenceForViewingMode
验证空间参考是否适用于指定的查看模式。
_validateSpatialReferenceForViewingMode(spatialReference, viewingMode, extent): boolean
参数
- spatialReference:
any要验证的空间参考。 - viewingMode:
any查看模式。 - extent:
any范围信息。
返回：boolean
addUpdatingPromise
添加一个Promise到更新处理列表中，用于跟踪视图的更新状态。
addUpdatingPromise(promise): any
参数
- promise:
any需要跟踪的Promise对象。
返回：any
castEnvironment
转换环境对象为 SceneView 可用的环境实例。
castEnvironment(environment): any
参数
- environment:
any要转换的环境对象。
返回：any
destroy
销毁场景视图并释放所有相关资源。
destroy(): void
返回：void
forceDOMReadyCycle
强制执行DOM就绪循环，确保视图准备就绪。
forceDOMReadyCycle(): void
返回：void
getColorToObjectAndLayerIdMapping
获取颜色到对象和图层ID的映射关系。
getColorToObjectAndLayerIdMapping(): any
返回：any
getDefaultSpatialReference
获取默认的空间参考。
getDefaultSpatialReference(): any
返回：any
getSpatialReferenceSupport
获取指定空间参考在特定视图模式下的支持信息。
getSpatialReferenceSupport(spatialReference, mode): object
参数
- spatialReference:
any要检查的空间参考。 - mode:
any视图模式。
返回：object
getViewForGraphic
获取与指定图形关联的视图。
getViewForGraphic(graphic): any
参数
- graphic:
any要获取视图的图形对象。
返回：any
goTo
将视图导航到指定的目标位置或范围。
goTo(target, duration): any
参数
- target:
any导航目标，可以是几何图形、范围、视点或相机。 - duration:
any导航动画的持续时间（毫秒）。
返回：any
graphicChanged
处理图形变化事件，通知关联的图形视图更新显示。
graphicChanged(graphic): void
参数
- graphic:
any发生变化的图形对象。
返回：void
hasEventListener
检查指定类型的事件是否已注册监听器。
hasEventListener(eventType): any
参数
- eventType:
any要检查的事件类型。
返回：any
hasLayerViewModule
检查指定图层是否具有对应的图层视图模块。
hasLayerViewModule(layer): any
参数
- layer:
any要检查的图层。
返回：any
hitTest
在场景视图中执行点击测试，检测与屏幕点相交的图形和要素。
hitTest(event_, options): any
参数
- event_:
any鼠标事件或屏幕坐标点。 - options:
any点击测试的配置选项。
返回：any
importLayerView
导入图层视图到场景视图中。
importLayerView(layer): any
参数
- layer:
any要导入的图层。
返回：any
initialize
初始化场景视图，设置资源控制器、地面视图和更新监视器，并添加必要的事件处理程序。
initialize(): void
返回：void
installContentCameraReset
安装内容相机重置功能，用于控制相机在特定条件下的重置行为。
installContentCameraReset(options): any
参数
- options:
boolean=false配置选项对象，包含 sticky 属性。 ###### sticky 指示相机重置是否为粘性的布尔值，默认为 false。
返回：any
maskOccludee
遮蔽指定图形的遮挡物，使其在视图中可见。
maskOccludee(graphic): any
参数
- graphic:
any需要被遮蔽遮挡物的图形。
返回：any
on
为视图事件注册事件处理程序。
on(eventType, handler, index, context): any
参数
- eventType:
any要监听的事件类型。 - handler:
any事件触发时执行的回调函数。 - index:
any事件处理程序的索引。 - context:
any执行处理程序的上下文对象。
返回：any
overlayPixelSizeInMapUnits
计算在指定缩放级别下，覆盖图层中一个像素在地图单位中的大小。
overlayPixelSizeInMapUnits(zoomLevel): any
参数
- zoomLevel:
any要计算像素大小的缩放级别。
返回：any
pixelSizeAt
计算指定点处的像素大小（以地图单位表示）。
pixelSizeAt(point, targetSpatialReference): any
参数
- point:
any要计算像素大小的点。 - targetSpatialReference:
any目标空间参考，用于转换像素大小。如果未提供，则使用渲染空间参考。
返回：any
popupHitTest
执行弹窗命中测试，确定与点击事件相关的图形或要素。
popupHitTest(hitEvent): Promise
参数
- hitEvent:
any命中测试事件对象，包含点击位置等信息。
返回：Promise
takeScreenshot
捕获场景视图的屏幕截图。
takeScreenshot(options): Promise
参数
- options:
any屏幕截图选项配置。
返回：Promise
takeScreenshotWithObjectAndLayerId
获取包含对象和图层ID信息的屏幕截图。此方法需要启用对象和图层ID渲染功能。
takeScreenshotWithObjectAndLayerId(screenshotOptions): Promise
参数
- screenshotOptions:
any屏幕截图选项配置。
返回：Promise
toMap
将屏幕坐标转换为地图坐标。
toMap(point, options): any
参数
- point:
any要转换的屏幕坐标点。 - options:
any转换选项。
返回：any
toScreen
将地图坐标点转换为屏幕坐标点。
toScreen(point): any
参数
- point:
any要转换的地图坐标点。
返回：any
trackGraphicState
跟踪图形状态的变化，返回一个可用于停止跟踪的句柄。
trackGraphicState(graphicState): any
参数
- graphicState:
any要跟踪的图形状态对象。
返回：any
validate
验证 SceneView 是否能在当前浏览器环境中正常运行，检查浏览器兼容性。
validate(): Promise
返回：Promise
whenAnalysisView
获取指定分析的视图。如果分析尚未添加到视图的分析集合中，则会抛出错误。
whenAnalysisView(analysis): Promise
参数
- analysis:
any要获取视图的分析对象。
返回：Promise
whenLayerView
获取指定图层的图层视图。当图层视图可用时返回一个解析为图层视图的承诺。
whenLayerView(layer): any
参数
- layer:
any要获取视图的图层。
返回：any
whenReady
返回一个Promise，该Promise在场景视图准备就绪时解析。
whenReady(): Promise
返回：Promise
whenViewForGraphic
获取与指定图形相关联的图层视图。
whenViewForGraphic(graphic, options): Promise
参数
- graphic:
any要获取视图的图形。 - options:
any可选参数，包含 waitForLayer 等配置。
返回：Promise
BIMFlux AI
