API Reference > imodeljs-frontend > Tiles > TileTreeReference

TileTreeReference Class

A reference to a TileTree suitable for drawing within a Viewport. The reference does not own its tile tree - it merely refers to it by way of the tree TileTreeOwner. The specific TileTree referenced by this object may change based on the current state of the Viewport in which it is drawn - for example, as a result of changing the RenderMode, or animation settings, or classification settings, etc. A reference to a TileTree is typically associated with a ViewState, a DisplayStyleState, or a Viewport. Multiple TileTreeReferences can refer to the same TileTree with different parameters and logic - for example, the same background map tiles can be displayed in two viewports with differing levels of transparency.

see TiledGraphicsProvider to supply custom TileTreeReferences to be drawn within a Viewport.

Extended by

  • RealityModelTileTree.Reference

Methods

Name Description
constructor(): TileTreeReference    
accumulateTransformedRange(range: Range3d, matrix: Matrix4d, frustumPlanes?: FrustumPlanes): void    
addLogoCards(_cards: HTMLTableElement, _vp: ScreenViewport): void Add attribution logo cards for the tile tree source logo cards to the viewport's logo div.  
addToScene(context: SceneContext): void Adds this reference's graphics to the scene.  
computeTransform(tree: TileTree): Transform Protected Compute a transform from this tile tree reference's coordinate space to the IModelConnection's coordinate space.  
computeWorldContentRange(): Range3d Compute the range of this tile tree's contents in world coordinates.  
createDrawArgs(context: SceneContext): undefined | TileDrawArgs Create context for drawing the tile tree, if it is ready for drawing.  
decorate(_context: DecorateContext): void Optionally add any decorations specific to this reference.  
discloseTileTrees(trees: DisclosedTileTreeSet): void Disclose all TileTrees use by this reference.  
draw(args: TileDrawArgs): void Adds this reference's graphics to the scene.  
getAppearanceProvider(_tree: TileTree): undefined | FeatureAppearanceProvider Protected Return a provider that can supplement the view's symbology overrides.  
getClipVolume(tree: TileTree): undefined | RenderClipVolume Protected Return the clip volume applied to this reference's tile tree, if any.  
getHiddenLineSettings(_tree: TileTree): undefined | Settings Protected Return hidden line settings to replace those defined for the view.  
getLocation(): undefined | Transform Supply transform from this tile tree reference's location to iModel coordinate space.  
getSymbologyOverrides(_tree: TileTree): undefined | FeatureSymbology.Overrides Protected Return overrides that replace any defined for the view.  
getToolTip(_hit: HitDetail): Promise<undefined | string | HTMLElement> Optionally return a tooltip describing the hit.  
getViewFlagOverrides(tree: TileTree): ViewFlagOverrides Protected Supply overrides that should be applied to the ViewState's ViewFlags when drawing this tile tree reference.  
unionFitRange(union: Range3d): void Unions this reference's range with the supplied range to help compute a volume in world space for fitting a viewport to its contents.  

Properties

Name Type Description
_isLoadingComplete Accessor ReadOnly boolean Override if additional asynchronous loading is required after the tile tree is successfully loaded, to indicate when that loading has completed.  
castsShadows Accessor ReadOnly boolean Return whether the geometry exposed by this tile tree reference should cast shadows on other geometry.  
isGlobal Accessor ReadOnly boolean Return whether this reference has global coverage.  
isLoadingComplete Accessor ReadOnly boolean Return true if the tile tree is fully loaded and ready to draw.  
treeOwner Accessor AbstractReadOnly TileTreeOwner The owner of the currently-referenced TileTree.  

Defined in

Last Updated: 12 June, 2024