はじめに

PointWeaverでは、点群ファイルを開き、ノードグラフで処理を組み、3Dビューで結果を確認します。 ユーザーが主に編集するのはExpressionノードの中身です。

基本操作

Expressionノード

Expressionノードは、入力点群を受け取り、各点の属性を書き換えて出力します。 ノードを複数つなぐと、Sourceに近いノードから順番に式が実行されます。

X = round(X)
Y = round(Y)
Z = round(Z)
R = remap(Z, minZ, maxZ, 0, 255)

構文の基本

1行に1つの代入式を書きます。左辺は書き換える属性、右辺は数値式です。 空行は無視されます。

属性 = 式
属性 = 式
属性 = 式

最小例

Z = round(Z)

各点の Z を丸め、その値を同じ点の Z に書き戻します。

複数行

X = round(X)
Y = round(Y)
Z = round(Z)

行は上から順番に実行されます。同じノード内で前の行が書き換えた値を、 後続行から参照できます。

コメントについて

現在のMVPではコメント構文はありません。説明を残したい場合は、 プロジェクト外のメモに残してください。

属性

属性名は式の中で読み書きできます。大文字表記の座標・色属性と、 小文字の属性名を使います。

統計値

式の中では、処理中の点群範囲を表す統計値を参照できます。 高さで色を付ける処理では minZ と maxZ をよく使います。

複数ノードをつないだ場合、後段ノードの統計値は前段ノードの処理結果を反映します。 例えば先に Z = round(Z) を実行した場合、次ノードの minZ / maxZ は丸めた後のZ範囲になります。

演算子

比較式の値

比較式は条件として使います。主な用途は if(condition, a, b) の第1引数です。

R = if(Z > 10, 255, 0)

関数

関数は name(arg1, arg2, ...) の形で呼び出します。 引数には属性、統計値、数値、別の関数呼び出しを書けます。

remapの考え方

R = remap(Z, minZ, maxZ, 0, 255)

Z == minZ の点は R = 0、 Z == maxZ の点は R = 255 になります。 入力値が範囲外なら、その分だけ外挿されます。

型と範囲

式は数値式として評価されます。代入先の属性に応じて保存時・表示時の扱いが変わります。

式の例

座標を1mグリッドへスナップ

X = round(X)
Y = round(Y)
Z = round(Z)

Z高さを赤色に割り当て

R = remap(Z, minZ, maxZ, 0, 255)

高さで赤から青へグラデーション

R = remap(Z, minZ, maxZ, 0, 255)
G = 0
B = remap(Z, minZ, maxZ, 255, 0)

指定高さより上だけ分類を変更

classification = if(Z > 10, 2, classification)

反射強度をグレースケール表示

R = remap(intensity, 0, 65535, 0, 255)
G = remap(intensity, 0, 65535, 0, 255)
B = remap(intensity, 0, 65535, 0, 255)

Z方向を誇張

Z = Z * 2

波形を加える

Z = Z + sin(X * 0.1) * 2

プレビュー

3Dプレビュー右下の Preview Controls を開くと、 プレビューサンプル数、描画上限、点サイズ、ビュー方向、ギズモ表示を調整できます。

Geometry Spreadsheet

View > Geometry Spreadsheet から別ウィンドウで開きます。 点ごとの ptnum、座標、色、反射強度、分類を表で確認できます。

エラー表示

式に問題がある場合、エディタ下部に行番号・列番号つきで表示されます。 ノードキャンバス上では、問題のあるノードに警告表示が付きます。