PointCloud¶

点群データを表現するクラス

const provider = new mapray.StandardPointCloudProvider({
    resource: {
        prefix: "https://..."
    }
});
const point_cloud = viewer.point_cloud_collection.add( provider );
point_cloud.setPointShape( mapray.PointCloud.PointShapeType.GRADIENT_CIRCLE );

See¶

PointCloudProvider

Constructors¶

new PointCloud()¶

new PointCloud(scene, option): PointCloud

Parameters¶

Parameter	Type	Description
`scene`	`Scene`	所属するシーン
`option`	`Option` \| `PointCloudProvider`	-

Returns¶

PointCloud

Accessors¶

atmosphere_lighting_mode¶

get atmosphere_lighting_mode(): AtmosphereLightingMode

大気ライティングモード (既定 INHERIT)

See¶

PointCloud.setAtmosphereLightingMode

Returns¶

AtmosphereLightingMode

plane_threshold¶

get plane_threshold(): number

点が平面上に分布しているかの閾値

Returns¶

number

provider¶

get provider(): PointCloudProvider

プロバイダ

Returns¶

PointCloudProvider

Methods¶

addEventListener()¶

Experimental

addEventListener(type, listener): void

指定した種類のイベントリスナーを登録します。

Parameters¶

Parameter	Type	Description
`type`	`EventType`	イベント種別
`listener`	`Listener`	リスナー

Returns¶

void

clearFilter()¶

Experimental

clearFilter(): void

Returns¶

void

forEach()¶

Experimental

forEach(callback): void

読み込み済みの Box を引数として、指定されたコールバック関数を呼び出します。読み込み済みとは、Box.status == PointCloud.Status.LOADED を満たす Box を指します。

Parameters¶

Parameter	Type	Description
`callback`	(`box`) => `void`	コールバック関数

Returns¶

void

getBounds()¶

getBounds(): GeoRegion

バウンディングボックスを算出

Returns¶

GeoRegion

getDebugPlugin()¶

Experimental

getDebugPlugin(): undefined | PointCloudDebugPlugin

デバッグ表示プラグインを取得

Returns¶

undefined | PointCloudDebugPlugin

getFilter()¶

Experimental

getFilter(): undefined | PointCloudFilter

Returns¶

undefined | PointCloudFilter

getMaterial()¶

getMaterial(): PointCloudMaterial

マテリアルを取得

Returns¶

PointCloudMaterial

getMatrix()¶

getMatrix(dst): Matrix

行列を取得

Parameters¶

Parameter	Type	Description
`dst`	`Matrix`	結果を保持する行列

Returns¶

Matrix

getNearestPointPosition()¶

Experimental

getNearestPointPosition(pos, max_distance): undefined | Vector3

渡された座標に最も近い点のGOCS座標を返す。最大距離よりも近い点が見つからない場合はundefinedを返す。

Parameters¶

Parameter	Type	Default value	Description
`pos`	`Vector3`	`undefined`	GOCS座標系
`max_distance`	`number`	`5`	最大距離（デフォルト: 5m）

Returns¶

undefined | Vector3

getPointShape()¶

getPointShape(): PointShapeType

点を描画する際の形状

Returns¶

PointShapeType

PointCloud.PointShapeType

getPointSize()¶

getPointSize(): number

点を描画する際のサイズ point_size_typeにより単位が異なる

Returns¶

number

See¶

PointCloud.getPointSizeType

getPointSizeLimit()¶

getPointSizeLimit(): number

点を描画する際の最大ピクセルサイズ

Returns¶

number

getPointSizeType()¶

getPointSizeType(): PointSizeType

点を描画する際のサイズの指定方法

Returns¶

PointSizeType

getPointsPerPixel()¶

getPointsPerPixel(): number

点群Box読み込みを行う際の解像度[points/pixel]

Returns¶

number

getVisibility()¶

getVisibility(): boolean

可視性フラグを取得

Returns¶

boolean

removeEventListener()¶

Experimental

removeEventListener(type, listener): void

指定した種類のイベントリスナーを削除します。

Parameters¶

Parameter	Type	Description
`type`	`EventType`	イベント種別
`listener`	`Listener`	リスナー

Returns¶

void

setAtmosphereLightingMode()¶

setAtmosphereLightingMode(val): void

大気ライティングモードを設定する。

mapray.AtmosphereLightingMode.INHERIT (既定): viewer.atmosphere の全体デフォルトに追随 (Atmosphere.setDefaultLightingMode による「まとめ変更」に従う)。
AUTO : エンジンが自動判定する。点群は法線を持たないため SIMPLE に解決される。
PHYSICAL: 天頂近似の直達光 + アンビエント + 空気遠近の合成 (明示指定時のみ)。
SIMPLE : 正午基準で正規化した簡略変調 (空気遠近なし、軽量)。点群で推奨。
OFF : 大気エフェクト無効。点の色をそのまま表示。

シェーダは実効モード別に再ビルド・キャッシュされ、次フレームから反映される。

Parameters¶

Parameter	Type	Description
`val`	`AtmosphereLightingMode`	設定する mapray.AtmosphereLightingMode

Returns¶

void

setDebugPlugin()¶

Experimental

setDebugPlugin(plugin?): void

デバッグ表示プラグインを設定。 undefined を設定するとデバッグ関連の処理は一切実行されなくなる。

Parameters¶

Parameter	Type
`plugin`?	`PointCloudDebugPlugin`

Returns¶

void

setFilter()¶

Experimental

setFilter(filter?): void

Parameters¶

Parameter	Type
`filter`?	`PointCloudFilter`

Returns¶

void

setMaterial()¶

setMaterial(material): void

マテリアルを設定

Parameters¶

Parameter	Type	Description
`material`	`PointCloudMaterial`	マテリアル

Returns¶

void

setMatrix()¶

setMatrix(mat): void

行列を設定

Parameters¶

Parameter	Type
`mat`	`Matrix`

Returns¶

void

setPlaneThreshold()¶

setPlaneThreshold(val): void

点が平面上に分布しているかの閾値を設定。

Box 内の点の分布の最も薄い方向の広がりが、Box の一辺に対してこの比率より小さい場合に平面上に分布しているとみなし、解像度計算を平面向けに切り替える。値を大きくするほど平面と判定されやすくなる。既定値は 0.8。 0 を設定すると全てを平面でないと判定する。

Parameters¶

Parameter	Type	Description
`val`	`number`	設定する値

Returns¶

void

setPointShape()¶

setPointShape(val): void

点を描画する際の形状を設定

Parameters¶

Parameter	Type	Description
`val`	`PointShapeType`	設定する値

Returns¶

void

setPointSize()¶

setPointSize(val): void

点を描画する際のサイズを設定。 PointCloud.setPointSizeTypeにより指定された値によって解釈される単位が異なる。

Parameters¶

Parameter	Type	Description
`val`	`number`	設定する値

Returns¶

void

setPointSizeLimit()¶

setPointSizeLimit(val): void

点を描画する際の最大ピクセルサイズを設定

Parameters¶

Parameter	Type	Description
`val`	`number`	設定する値

Returns¶

void

setPointSizeType()¶

setPointSizeType(val): void

点を描画する際のサイズの指定方法を設定

Parameters¶

Parameter	Type	Description
`val`	`PointSizeType`	設定する値

Returns¶

void

setPointsPerPixel()¶

setPointsPerPixel(val): void

点群Box読み込みを行う際の解像度[points/pixel]を設定

Parameters¶

Parameter	Type	Description
`val`	`number`	設定する値

Returns¶

void

setVisibility()¶

setVisibility(visibility): void

可視性フラグを設定

Parameters¶

Parameter	Type	Description
`visibility`	`boolean`	可視性フラグ

Returns¶

void