A viewport-aligned image positioned in the 3D scene, that is created
and rendered using a BillboardCollection A billboard is created and its initial
properties are set by calling BillboardCollection#add
Example billboards
alias Billboard
performance Reading a property, e.g., Billboard#show, is constant time.
Assigning to a property is constant time but results in
CPU to GPU traffic when BillboardCollection#update is called. The per-billboard traffic is
the same regardless of how many properties were updated. If most billboards in a collection need to be
updated, it may be more efficient to clear the collection with BillboardCollection#removeAll
and add new billboards instead of modifying each one.
exception {DeveloperError} scaleByDistance.far must be greater than scaleByDistance.near
exception {DeveloperError} translucencyByDistance.far must be greater than translucencyByDistance.near
exception {DeveloperError} pixelOffsetScaleByDistance.far must be greater than pixelOffsetScaleByDistance.near
A viewport-aligned image positioned in the 3D scene, that is created and rendered using a BillboardCollection A billboard is created and its initial properties are set by calling BillboardCollection#add
Example billboards
alias Billboard
performance Reading a property, e.g., Billboard#show, is constant time. Assigning to a property is constant time but results in CPU to GPU traffic when BillboardCollection#update is called. The per-billboard traffic is the same regardless of how many properties were updated. If most billboards in a collection need to be updated, it may be more efficient to clear the collection with BillboardCollection#removeAll and add new billboards instead of modifying each one.
exception {DeveloperError} scaleByDistance.far must be greater than scaleByDistance.near exception {DeveloperError} translucencyByDistance.far must be greater than translucencyByDistance.near exception {DeveloperError} pixelOffsetScaleByDistance.far must be greater than pixelOffsetScaleByDistance.near
Label demo Sandcastle Billboard Demo
BillboardCollection#add
BillboardCollection