本章では、部材の寸法、色、目地、模様、凹凸を数値で指定し、繰り返し利用できる手続きテクスチャを生成する方法を説明します。 生成したColor map、Height map、Normal mapがそれぞれ何を表すかを確認し、PBRマテリアルへ接続します。 さらに、形状の寸法からUVを設定し、直方体や平面へ実寸を保って繰り返し表示するまでの処理を組み立てます。
tileとappearanceだけを変更するPrimitive.mapRealCuboid()でメートル単位のUVを作るProceduralMaterial.applyTo()でShapeへテクスチャとPBR値を登録するShape.endShape()でGPUへ確定する実際に二つの直方体へ異なるプリセットを適用する例は、examples/29_01.htmlで実行できます。複数のプリセットを一覧から選び、数値を変更し、生成画像を確認し、設定を保存する場合は、samples/texture_catalog/texture_catalog.htmlを使用します。後者は単なる一覧ではなく、利用者が目的の表面を探してdefinitionを作るための実験環境です。
07章のマテリアルと08章のPrimitive・ModelAsset・Shapeを知っていると読みやすくなります。
プリセット、Color・Height・Normal、基本パラメーター、マテリアルへの適用を先に読んでください。
実寸UV(テクスチャ座標)、mapRealCuboid、定義の保存、CPU(中央処理装置)版とCompute版は物理寸法を扱うときに参照してください。
計算で生成した画像を物理ベースレンダリング(PBR)マテリアルへ接続し、形状寸法に合うテクスチャ密度を設定できます。
手続きテクスチャでは、生成する表面の値、GPUで生成した画像、Shapeへ登録するPBR値を分けて扱います。
ProceduralTileSpec
├─ Color map
├─ Height map
└─ Normal map
ProceduralMaterial
├─ Color mapとNormal map
├─ roughness、specular、metallic
└─ Shapeへ適用する実寸周期
ProceduralMaterialsは、登録済みプリセットの選択、値の上書き、GPUテクスチャの生成をまとめて行います。通常はCPUで画像を作ってからGPUへ転送するのではなく、ComputeProceduralTileがGPU上でColor、Height、Normalを生成し、そのまま描画へ渡します。
利用側が最初に知っておくAPIは次の三つです。
| API | 用途 |
|---|---|
ProceduralMaterials.createPreset() |
プリセットから画像を生成 |
ProceduralMaterials.create() |
完全なdefinitionから生成 |
ProceduralMaterial.applyTo() |
生成済みテクスチャとPBR値をShapeへ登録する |
コードを先に書いて値を推測するより、まずtexture_catalogでプリセットの初期状態と変更結果を確認すると、どのパラメータを動かすべきかを判断しやすくなります。画面には立方体の表示、Color map、Height map、Normal map、生成されたdefinitionが同時に表示されます。立方体では光源との関係を、Color mapでは色の変化を、Height mapでは高さの分布を、Normal mapでは凹凸の方向と強さを個別に確認できます。

リポジトリのルートでHTTP serverを起動し、次のページを開きます。
python3 -m http.server 8000
http://localhost:8000/samples/texture_catalog/texture_catalog.html
利用者が行う作業は次の順序です。
Categoryで材質分類を選び、Presetで初期状態を選ぶPattern、Surface detail、PBR値を変更するCopy Code、Download JS、Download JSONのいずれかで完成definitionを保存するDownload ColorとDownload Normalで生成画像を保存する通常の数値欄は入力を確定した時点で自動生成されます。GenerateボタンとGキーは同じdefinitionを明示的に再生成する操作です。Material IDやLabelのような文字列欄では、入力が完成してから生成を開始します。Gは文字列入力欄とtextareaでは文字として入力され、それ以外のcontrolとCanvasではGenerate shortcutとして動作します。小数入力を完了してからGPU生成へ進むため、0.01のような値も最後まで入力できます。
数値がHTMLのstep、min、max、または解像度で表現できる整数pixel条件から外れた場合、texture_catalogは入力可能な近い値へ丸め、その内容をinfo欄へ表示します。変更内容を確定時に利用者へ知らせ、生成できないdefinitionはエラーとして扱うことで、指定ミスを確認できるようにします。
設定を保存する場合はDownload JSまたはDownload JSONを使用します。JavaScriptは次のようなES moduleとして出力され、保存した値をProceduralMaterials.create()へ渡せます。
import ProceduralMaterials from "../../webg/ProceduralMaterials.js";
import definition from "./fiber_cement_white.js";
const materials = new ProceduralMaterials(app.getGPU());
const material = await materials.create(definition);
material.applyTo(shape);
texture_catalogは出力definitionを作成するためのツールです。画面操作で作ったdefinitionはファイルへ保存し、コアへプリセットとして登録する場合は、出力内容を確認してからコアのregistryへ明示的に反映します。既存presetを元にMaterial ID、Category、日英Label、tile.presetIdを変更すれば、新しい部材を既存の生成仕様から定義できます。
createPreset()へプリセットIDを渡すと、プリセットの初期値でColor、Height、Normalが生成されます。scaleを省略した場合、Shapeにはすでに作成済みのUVがそのまま使われます。
import ProceduralMaterials from "../../webg/ProceduralMaterials.js";
const materials = new ProceduralMaterials(app.getGPU());
const oak = await materials.createPreset("wood.oak.plank");
// shapeはUVを持つShapeとして、あらかじめ作成しておく
oak.applyTo(shape);
同じProceduralMaterialは複数のShapeへ適用できます。ただし、scaleを指定したマテリアルはShapeごとにUVを変換するため、各Shapeへ一回だけ適用します。ページを終了するときは、生成したGPU resourceをまとめて解放します。
window.addEventListener("pagehide", () => {
materials.destroy();
}, { once: true });
プリセットIDは、完成画像のファイル名ではなく、生成仕様を選ぶ名前です。IDはProceduralMaterials.listPresetIds()、表示名や初期値はProceduralMaterials.listPresetDefinitions()から取得できます。以下の表では、横に広がる比較表を避けるため、プリセットごとに項目と値を示します。
プリセット識別子はwood.oak.plankです。
| 項目 | 値 |
|---|---|
| 分類 | 木材 |
| 部材寸法 | 短辺0.15 m、長辺1.80 m、厚さなし |
| 配置 | running-bond、行ずらし1/2 |
| variation cell | 2列×4行 |
| pattern | quarter-sawn-grain、周期0.010 m、色変化0.075、凹凸0.00020 m |
| PBR | roughness 0.56、specular 0.50、normalStrength 1.12 |

プリセット識別子はwood.oak.flat-sawnです。
| 項目 | 値 |
|---|---|
| 分類 | 木材 |
| 部材寸法 | 短辺0.15 m、長辺1.80 m、厚さなし |
| 配置 | running-bond、行ずらし1/2 |
| variation cell | 2列×4行 |
| pattern | flat-sawn-grain、周期0.010 m、色変化0.090、凹凸0.00024 m |
| PBR | roughness 0.58、specular 0.48、normalStrength 1.18 |

プリセット識別子はwood.oak.mixed-sawnです。
| 項目 | 値 |
|---|---|
| 分類 | 木材 |
| 部材寸法 | 短辺0.15 m、長辺1.80 m、厚さなし |
| 配置 | running-bond、行ずらし1/2 |
| variation cell | 2列×4行 |
| pattern | mixed-sawn-grain、周期0.010 m、色変化0.085、凹凸0.00022 m |
| PBR | roughness 0.57、specular 0.49、normalStrength 1.15 |

プリセット識別子はwood.walnut.plankです。
| 項目 | 値 |
|---|---|
| 分類 | 木材 |
| 部材寸法 | 短辺0.15 m、長辺1.80 m、厚さなし |
| 配置 | running-bond、行ずらし1/3 |
| variation cell | 2列×6行 |
| pattern | longitudinal-grain、周期0.010 m、色変化0.038、凹凸0.00018 m |
| PBR | roughness 0.54、specular 0.50、normalStrength 1.16 |

プリセット識別子はwood.walnut.flat-sawnです。
| 項目 | 値 |
|---|---|
| 分類 | 木材 |
| 部材寸法 | 短辺0.15 m、長辺1.80 m、厚さなし |
| 配置 | running-bond、行ずらし1/3 |
| variation cell | 2列×6行 |
| pattern | flat-sawn-grain、周期0.010 m、色変化0.060、凹凸0.00016 m |
| PBR | roughness 0.54、specular 0.50、normalStrength 1.12 |

プリセット識別子はwood.walnut.mixed-sawnです。
| 項目 | 値 |
|---|---|
| 分類 | 木材 |
| 部材寸法 | 短辺0.15 m、長辺1.80 m、厚さなし |
| 配置 | running-bond、行ずらし1/3 |
| variation cell | 2列×6行 |
| pattern | mixed-sawn-grain、周期0.010 m、色変化0.055、凹凸0.00016 m |
| PBR | roughness 0.54、specular 0.50、normalStrength 1.14 |

プリセット識別子はwood.cedar.deckです。
| 項目 | 値 |
|---|---|
| 分類 | 木材 |
| 部材寸法 | 短辺0.15 m、長辺1.80 m、厚さなし |
| 配置 | running-bond、行ずらし1/4 |
| variation cell | 2列×4行 |
| pattern | longitudinal-grain、周期0.010 m、色変化0.055、凹凸0.00028 m |
| PBR | roughness 0.66、specular 0.42、normalStrength 1.28 |

プリセット識別子はwood.cedar.flat-sawnです。
| 項目 | 値 |
|---|---|
| 分類 | 木材 |
| 部材寸法 | 短辺0.15 m、長辺1.80 m、厚さなし |
| 配置 | running-bond、行ずらし1/4 |
| variation cell | 2列×4行 |
| pattern | flat-sawn-grain、周期0.010 m、色変化0.080、凹凸0.00024 m |
| PBR | roughness 0.64、specular 0.44、normalStrength 1.20 |

プリセット識別子はwood.cedar.mixed-sawnです。
| 項目 | 値 |
|---|---|
| 分類 | 木材 |
| 部材寸法 | 短辺0.15 m、長辺1.80 m、厚さなし |
| 配置 | running-bond、行ずらし1/4 |
| variation cell | 2列×4行 |
| pattern | mixed-sawn-grain、周期0.010 m、色変化0.072、凹凸0.00024 m |
| PBR | roughness 0.65、specular 0.43、normalStrength 1.24 |

プリセット識別子はconcrete.slab.lightです。
| 項目 | 値 |
|---|---|
| 分類 | コンクリート |
| 部材寸法 | 短辺0.90 m、長辺1.80 m、厚さ0.010 m |
| 解像度 | 200 pixels/m |
| 配置 | stack、行ずらし0 |
| variation cell | 1列×1行 |
| pattern | mottle、周期0.075 m、色変化0.075、凹凸0.00030 m |
| surface | 周期0.0125 m、凹凸0.00025 m。砂による細かなざらつき |
| PBR | roughness 0.90、specular 0.22、normalStrength 1.35 |

プリセット識別子はconcrete.block.grayです。
| 項目 | 値 |
|---|---|
| 分類 | コンクリート |
| 部材寸法 | 短辺0.19 m、長辺0.39 m、厚さ0.10 m |
| 解像度 | 200 pixels/m |
| 配置 | running-bond、行ずらし1/2 |
| variation cell | 2列×4行 |
| pattern | mottle、周期0.060 m、色変化0.070、凹凸0.00045 m |
| surface | 周期0.010 m、凹凸0.00030 m。砂による細かなざらつき |
| PBR | roughness 0.94、specular 0.18、normalStrength 1.50 |

プリセット識別子はfiber.cement.whiteです。
| 項目 | 値 |
|---|---|
| 分類 | セメント |
| 部材寸法 | 短辺0.05 m、長辺0.25 m、厚さなし |
| 解像度 | 200 pixels/m |
| 配置 | running-bond、行ずらし1/4 |
| variation cell | 4列×8行 |
| pattern | speckle、周期0.010 m、色変化0、凹凸0.00020 m |
| surface | 周期0.015 m、凹凸0.00010 m |
| PBR | roughness 0.56、specular 0.50、normalStrength 1.10 |

プリセット識別子はfiber.cement.grayです。
| 項目 | 値 |
|---|---|
| 分類 | セメント |
| 部材寸法 | 短辺0.05 m、長辺1.00 m、厚さなし |
| 解像度 | 200 pixels/m |
| 配置 | stack、行ずらし0 |
| variation cell | 1列×5行 |
| pattern | speckle、周期0.010 m、色変化0、凹凸0.00020 m |
| surface | 周期0.015 m、凹凸0.00010 m |
| PBR | roughness 0.56、specular 0.50、normalStrength 1.10 |

プリセット識別子はbrick.running.redです。
| 項目 | 値 |
|---|---|
| 分類 | レンガ |
| 部材寸法 | 短辺0.10 m、長辺0.21 m、厚さ0.06 m |
| 配置 | running-bond、行ずらし1/2 |
| variation cell | 4列×8行 |
| pattern | speckle、周期0.015 m、色変化0.050、凹凸0.00035 m |
| PBR | roughness 0.90、specular 0.20、normalStrength 1.35 |

プリセット識別子はvinyl.tile.marbleです。
| 項目 | 値 |
|---|---|
| 分類 | ビニール |
| 部材寸法 | 短辺0.30 m、長辺0.30 m、厚さなし |
| 配置 | stack、行ずらし0 |
| variation cell | 4列×4行 |
| pattern | veined、周期0.0375 m、色変化0.100、凹凸0.000030 m |
| PBR | roughness 0.28、specular 0.68、normalStrength 1.00 |

プリセット識別子はceramic.white.squareです。
| 項目 | 値 |
|---|---|
| 分類 | セラミック |
| 部材寸法 | 短辺0.20 m、長辺0.20 m、厚さ0.008 m |
| 配置 | stack、行ずらし0 |
| variation cell | 4列×4行 |
| pattern | none、周期0.025 m、色変化0、凹凸0 |
| PBR | roughness 0.16、specular 0.76、normalStrength 0.82 |

プリセット識別子はresin.mosaic.voronoiです。
| 項目 | 値 |
|---|---|
| 分類 | 樹脂 |
| 部材寸法 | 短辺0.30 m、長辺0.30 m、厚さなし |
| 配置 | stack、行ずらし0 |
| variation cell | 4列×4行 |
| pattern | voronoi、周期0.050 m、色変化0.140、凹凸0.00010 m |
| PBR | roughness 0.80、specular 0.70、normalStrength 1.00 |

プリセット識別子はvinyl.cloudy.blueです。
| 項目 | 値 |
|---|---|
| 分類 | ビニール |
| 部材寸法 | 短辺0.45 m、長辺0.45 m、厚さなし |
| 配置 | stack、行ずらし0 |
| variation cell | 2列×2行 |
| pattern | cloudy、周期0.055 m、色変化0.095、凹凸0.000025 m |
| PBR | roughness 0.34、specular 0.60、normalStrength 0.90 |

プリセット識別子はvinyl.linen.beigeです。
| 項目 | 値 |
|---|---|
| 分類 | ビニール |
| 部材寸法 | 短辺0.30 m、長辺0.60 m、厚さなし |
| 配置 | running-bond、行ずらし1/2 |
| variation cell | 2列×4行 |
| pattern | linen、周期0.015 m、色変化0.085、凹凸0.00010 m |
| PBR | roughness 0.42、specular 0.52、normalStrength 1.05 |

プリセット識別子はstone.terrazzo.grayです。
| 項目 | 値 |
|---|---|
| 分類 | 石材 |
| 部材寸法 | 短辺0.40 m、長辺0.40 m、厚さ0.012 m |
| 配置 | stack、行ずらし0 |
| variation cell | 3列×3行 |
| pattern | terrazzo、周期0.028 m、色変化0.160、凹凸0.00030 m |
| PBR | roughness 0.62、specular 0.42、normalStrength 1.30 |

Walnutは1/3の行周期を閉じるため、variationCell.rowCountが6です。mixed-sawn-grainは一枚の板の中で二つの模様を混ぜるのではなく、variation単位で柾目または板目を選びます。
pebblesは、粒の色の濃淡と丸いHeightを別々に生成するpatternです。
暗い石も上向きに盛り上がり、色を薄くしてもHeightやNormalは変わりません。
各粒の色は暗色から中間色、明色まで連続した濃淡から選びます。
stone.pebbles.gray:石だけ。高さ上界0.040m。stone.pebbles-gravel.gray:石と砂利。隙間の砂利は高さ上界0.006m。stone.gravel.gray:砂利だけ。高さ上界0.006m。いずれも目地なし、2m四方の周期面です。
粒の配置尺度は大粒0.12m、小粒0.065mで、粒ごとの半径や向きはseedで変わります。
Pattern scale mは配置の尺度であり、全粒の直径を揃える指定ではありません。
const material = await materials.createPreset("stone.pebbles-gravel.gray", {
tile: {
pattern: {
colorAmount: 0.10,
heightMeters: 0.040,
pebbles: {
roundness: 1,
gravelAmount: 1,
gravelHeightMeters: 0.006
}
}
}
});
material.applyTo(shape);
pattern.pebblesはmode: "pebbles"だけで使えます。省略値は次のとおりです。
| 項目 | 省略値 | 内容 |
|---|---|---|
density |
0.95 | 粒を置く確率。0〜1 |
packing |
0 | 敷き詰め。粒を大きくして隙間を狭める。0〜1 |
irregularity |
0.8 | 位置・粒径・縦横比のばらつき。0〜1 |
roundness |
1 | 0は平頂、1は丸い上面。0〜1 |
gravelAmount |
0 | 隙間の砂利の量。0〜1 |
gravelScaleMeters |
0.065 | 小粒の配置尺度。0より大きい値 |
gravelHeightMeters |
0.006 | 小粒の高さ上界。0以上 |
gravelColorAmount |
0.10 | 小粒の色の濃淡。0〜0.25 |
「石だけ」はdensity: 1、packing: 1で隙間を狭めます。
irregularity: 1で配置を乱し、大小と縦横比の異なる粒を混ぜます。
packingは大粒だけに作用し、小粒の密度と丸みは大粒と共通です。丸みを変えてもColorは変わりません。
色は別の濃淡値、高さは中心が高い楕円形の曲面から作り、重なる粒の上面は最大値で合成します。
粒の縁は滑らかに底へつなぎ、大粒の隙間へ小粒の高さと色を合成します。
samples/texture_catalog/texture_catalog.htmlのstone分類から選び、
Color・Height・Normalを見比べてください。Height画像はheightRangeMetersで復号します。
NormalをShapeへ設定しただけでは輪郭は変位しません。
実際の起伏へ光線を当てる場合はHeightを復号し、アプリ側の高さ場交差へ使います。
石砂利を水底へ使うPBR統合例はsamples/water/water.htmlです。
この例は集光のON/OFFを同じ法線・材質で比較するため、底面を水平にし、
石粒のColor mapを使います。生成したHeightによる頂点変位やNormalは使いません。
35章のコア集光も水平基準面の照度を投影する近似なので、
石のHeightへ光線を当てる処理が自動で追加されるわけではありません。
材質の模様、表面法線、実際の幾何形状、集光の照度を分けて確認してください。
createPreset()の第2引数には、tile、appearance、scaleを指定できます。指定しなかった値は、選択したプリセットの値を使います。
const material = await materials.createPreset("wood.oak.plank", {
tile: {
pattern: {
scaleMeters: 0.016
}
},
appearance: {
roughness: 0.62
},
scale: 1.5
});
tileの設定| 階層 | 項目 | 内容と入力条件 |
|---|---|---|
resolution |
pixelsPerMeter |
1 mあたりの画素数。整数、1〜2048 |
unit |
shortSizeMeters |
部材の短辺。0より大きい値 |
unit |
longSizeMeters |
部材の長辺。短辺以上の値 |
unit |
thicknessMeters |
部材厚。nullまたは0より大きい値 |
unit |
longAxis |
長手方向。uまたはv |
layout |
mode |
stackまたはrunning-bond |
layout |
rowOffsetRatio |
0、1/2、1/3、1/4。stackでは0 |
variationCell |
longUnitCount |
横方向のvariation数。整数、1〜64 |
variationCell |
rowCount |
縦方向のvariation数。整数、1〜64 |
joint |
widthMeters |
目地幅。0以上。0なら目地を生成しない |
joint |
color |
目地のRGB値。各値は0〜1 |
joint |
depthMeters |
目地の凹み。0以上。0なら目地の凹みを生成しない |
joint |
edgeRoundMeters |
目地周辺の丸み。0以上 |
color |
base |
部材の基準RGB値。各値は0〜1 |
color |
unitVariation |
部材単位の色変化量。0〜0.25 |
color |
dirtColor |
汚れのRGB値。各値は0〜1 |
color |
dirtAmount |
汚れ量。0〜1 |
pattern |
mode |
13種類から選択 |
pattern |
scaleMeters |
patternの基準周期。0より大きい値 |
pattern |
colorAmount |
patternの色変化量。0〜0.25 |
pattern |
heightMeters |
patternによる凹凸。0以上 |
surface |
detailScaleMeters |
共通surface detailの周期。0より大きい値 |
surface |
heightNoiseMeters |
微細凹凸の高さ。0以上 |
random |
seed |
再現性を決める整数。0〜2147483647 |
thicknessMetersは、プリセットが表す部材の実寸を「短辺 × 長辺 × 厚さ」の参考値として記録します。現在の手続きテクスチャ生成は部材表面のColor mapとNormal mapを作り、テクスチャの幅と高さ、目地や模様の周期をshortSizeMetersとlongSizeMetersから決めます。厚みを持つ直方体は、Primitive.mapRealCuboid(width, height, depth)など形状を作る処理でdepthを指定します。表面材の厚さを記録する対象がない場合はnullを指定します。
pattern modeは材質名ではなく、生成する模様の種類を表します。同じmottleでも、色と凹凸の振幅を変えれば、淡い色むらだけにも、凹凸を持つコンクリート面にもできます。
| mode | 表現と使いどころ |
|---|---|
none |
材質固有の模様を加えず、surface detailだけを使いたいとき |
longitudinal-grain |
長手方向へ流れる一般的な木理 |
quarter-sawn-grain |
柾目。平行木理と短い放射組織の斑 |
flat-sawn-grain |
板目。長手方向へ開くアーチ状の木理 |
mixed-sawn-grain |
variation単位で柾目または板目を選ぶ |
mottle |
コンクリートの大きめの斑、緩やかな濃淡 |
speckle |
レンガや窯業系部材の粒状の濃淡。大きめの粒と細かな粒を混ぜる |
veined |
大理石の脈。細い線状の色変化 |
voronoi |
多角形状の区画と境界。モザイクや割れ目のような表現 |
cloudy |
尺度の異なる雲状の濃淡。ビニールや塗膜の均一でない色 |
linen |
長手と短手の繊維を交差させた布状の表面 |
terrazzo |
決定的に配置した砕石粒。テラゾーや骨材入り樹脂 |
pebbles |
色の濃淡と丸いHeightを別々に生成する石粒と砂利 |
生成処理は、材質固有のpatternと、材質を問わず使える共通のsurface detailを別々に計算します。既存patternのscalar値とsurface detailのscalar値は、それぞれColor mapと物理Heightへ使われます。pebblesでは粒の色の濃淡と曲面Heightを別のfieldとして計算します。
pattern.mode + pattern.scaleMeters
├─ pattern.colorAmount → Color mapの色の変化
└─ pattern.heightMeters → Heightの凹凸
surface.detailScaleMeters + surface.heightNoiseMeters
├─ surface detail × dirtAmount → Dirt colorの混合
└─ surface detail × heightNoiseMeters → Heightの細かな凹凸
物理Height
= 目地の深さ
+ pattern.heightMetersによる凹凸
+ surface.heightNoiseMetersによる凹凸
↓ 隣接pixelの中央差分
Normal map
Pattern scale mは材質固有patternの一周期をメートルで指定します。0.060 mなら、おおむね6 cmを基準とした斑になります。値を小さくすると斑や木理は細かくなり、大きくすると粗くなります。これは色と凹凸の両方に共通する模様の位置を変えるため、patternの色だけを薄くしたい場合はscaleではなくPattern color amountを変更します。
Color amountは、patternのscalarを基準色へ加える量です。概念的には次の計算です。
patternedColor = baseColor
+ unitRandom × unitVariation
+ patternValue × colorAmount
0なら主patternはColor mapへ影響せず、patternの凹凸だけを残せます。pebblesの隙間の砂利は別のgravelColorAmountで調整します。大きくすると明暗差が強くなりますが、基準色の範囲を超えるほど大きくすると色が不自然になりやすいため、通常は0.02〜0.12程度から確認します。入力範囲は0〜0.25です。
Pattern height mはpatternの物理的な高さの振幅です。pebblesでは底面から上向きに盛り上がる高さの上界です。0.00020 mは0.20 mmに相当します。値を大きくするとHeight mapの差が増え、その隣接差から作られるNormal mapの傾斜も強くなります。Color amountを増やさずに、光の当たり方だけを変えたい場合に使えます。
Surface detail scale mは、mottleや木理とは別の、表面全体へ加える細かなPerlin detailの基準寸法です。材質固有patternを保ったまま砂、微細な凹凸、塗膜の粒を変えたい場合に使います。小さくすると細かいdetailになりますが、生成pixelがその変化を十分にサンプリングできなければ、細部が潰れるか周期的な粗い変化に見えます。
Surface noise height mは、surface detailの物理的な高さです。Color mapの模様を直接強くする値ではなく、主にHeight mapとNormal mapへ影響します。砂によるざらつきを強くしたいときは、まずこの値を少しずつ増やし、Normal mapの白黒の模様ではなく、実際の立方体へ光を当てたときの細かな陰影で判断します。
concrete.slab.lightとconcrete.block.grayは、mottleを大きな色むらとして残し、surface detailを砂による細かな凹凸として使う設定です。コンクリート全体の色を細かく斑点化するのではなく、色むらと表面のざらつきを分離することが目的です。
const roughConcrete = await materials.createPreset("concrete.slab.light", {
tile: {
pattern: {
mode: "mottle",
scaleMeters: 0.075,
colorAmount: 0.075,
heightMeters: 0.00020
},
surface: {
detailScaleMeters: 0.0125,
heightNoiseMeters: 0.00025
}
},
appearance: {
roughness: 0.94,
specular: 0.20,
normalStrength: 1.35
}
});
この例では、mottleの周期75 mmがコンクリートの緩やかな色むらを作り、surface detailの周期12.5 mmと高さ0.25 mmが砂に近い細かな凹凸を作ります。色むらまで細かくしたい場合はPattern scale mを小さくしますが、ざらつきだけを細かくしたい場合はSurface detail scale mを小さくし、Pattern scale mは維持します。凹凸が強すぎる場合はSurface noise height mを下げ、細かさが足りない場合はSurface detail scale mを下げます。
concrete.block.grayは初期値でsurface detailの周期10 mm、高さ0.30 mmを使用します。ブロックの大きさや目地の形状はそのままに、表面だけを細かくした値です。roughnessは広い範囲の反射のぼけ、specularは鏡面反射の強さ、normalStrengthは生成済みNormal mapの影響倍率であり、三つともsurfaceの周波数や物理高さとは別の値です。
pixelsPerMeterは1 mを何pixelで表すかを決めます。高くすると、細かなdetailをより多くのpixelで記録できます。物理的な凹凸の高さはHeightのメートル値で決まり、Normal mapは物理Heightの隣接差とpixelsPerMeterから作られるため、同じメートル単位の高さとscaleを保つと解像度を上げても表面の大きさを維持できます。
目安として、scaleMeters × pixelsPerMeterが基準detailのpixel幅です。例えば0.0125 mを200 pixels/mで生成すると約2.5 pixelになり、100 pixels/mでは約1.25 pixelです。前者は細かな模様を確認しやすく、後者は情報が不足しやすくなります。まず200 pixels/mで確認し、近距離で粒が潰れる場合だけ400 pixels/mへ上げます。解像度を上げるとGPU生成、メモリ、画像downloadの容量も増えるため、視認距離に合わせて解像度を選びます。
寸法値は、pixelsPerMeterとの積を整数画素へそろえて生成します。例えば、pixelsPerMeter: 200でjoint.widthMeters: 0.005を指定すると1 pixelになり、0.006 mは1.2 pixelとして丸められます。値を変更する場合は、解像度と寸法の組み合わせも確認します。
appearanceの設定| 項目 | 内容と入力条件 |
|---|---|
roughness |
粗さ。0は滑らか、1は粗い。0〜1 |
specular |
鏡面反射の強さ。0〜1 |
metallic |
金属度。通常の木材、石材、タイルは0。0〜1 |
normalStrength |
Normal mapの影響。0〜8 |
この生成APIのroughnessは0〜1を受け付けます。PBRの描画へ渡す場合は、30章の材質検証に合わせて0.04以上に設定します。
tileを変更するとColor、Height、Normalを再生成します。appearanceだけを変更する場合は、画像を再生成せずShapeへの登録値だけを変更できます。
mapRealCuboid()で直方体へ適用する実寸テクスチャを表示するには、物体側のUVもメートル単位で作ります。Primitive.mapRealCuboid(width, height, depth)は、各面の辺の長さをそのままUVへ設定します。
import Primitive from "../../webg/Primitive.js";
import ProceduralMaterials from "../../webg/ProceduralMaterials.js";
import Shape from "../../webg/Shape.js";
const materials = new ProceduralMaterials(app.getGPU());
const concrete = await materials.createPreset("concrete.slab.light", {
tile: {
pattern: {
colorAmount: 0.06,
heightMeters: 0.00020
},
surface: {
detailScaleMeters: 0.010,
heightNoiseMeters: 0.00025
}
},
appearance: {
roughness: 0.94,
specular: 0.20,
normalStrength: 1.35
}
});
const shape = new Shape(app.getGPU());
shape.setShader(app.shader);
shape.applyPrimitiveAsset(
Primitive.mapRealCuboid(2.0, 3.0, 4.0)
);
// mapRealCuboid()のUVはメートル単位なので、部材寸法を保ったままtextureを反復できる
concrete.applyTo(shape);
shape.endShape();
const node = app.space.addNode(null, "brick-cuboid");
node.addShape(shape);
window.addEventListener("pagehide", () => {
materials.destroy();
}, { once: true });
この例の直方体は幅2 m、高さ3 m、奥行き4 mです。上面と底面では2 m×4 m、前面と背面では2 m×3 m、側面では4 m×3 mのUV範囲になります。生成したtextureの一周期は、プリセットの部材寸法とvariation cellから決まります。
mapCube()との違いは次のとおりです。
Primitive.mapCube()
UVの意味:各面を0〜1へ割り当てる
使う場面:一般的な立方体、atlas
Primitive.mapRealCuboid()
UVの意味:各面の長さをメートルで表す
使う場面:タイル、木材、レンガなどの実寸表示
scaleは生成textureの一周期を変更する倍率です。scale: 2.0なら一周期は初期値の2倍になり、同じ面に並ぶ部材数は半分になって、タイルは2倍のサイズで表示されます。scale: 0.5なら一周期は半分になり、部材数は2倍になります。
mapRealCuboid()を使わずに平面を作る場合は、生成結果のtileSizeMetersから反復回数を求めます。
const oak = await materials.createPreset("wood.oak.plank");
const surfaceWidthMeters = 6.0;
const surfaceHeightMeters = 4.0;
const repeatU = surfaceWidthMeters / oak.tileSizeMeters[0];
const repeatV = surfaceHeightMeters / oak.tileSizeMeters[1];
const shape = new Shape(app.getGPU());
shape.setTextureMappingMode(1);
shape.setAutoCalcNormals(true);
const vertices = [
shape.addVertexUV(0, 0, 0, 0, 0) - 1,
shape.addVertexUV(surfaceWidthMeters, 0, 0, repeatU, 0) - 1,
shape.addVertexUV(surfaceWidthMeters, surfaceHeightMeters, 0, repeatU, repeatV) - 1,
shape.addVertexUV(0, surfaceHeightMeters, 0, 0, repeatV) - 1
];
shape.addPlane(vertices, 0);
shape.endShape();
oak.applyTo(shape);
この例ではscaleを指定していないため、UVを作成してからendShape()した後でもapplyTo()できます。scaleを指定する場合は、前の直方体の例と同じくendShape()より前に適用します。
tileSizeMetersを使わずUVを0〜1へ固定すると、texture一周期が平面全体へ引き伸ばされます。床や壁の部材寸法を維持したい場合は、面の寸法をtileSizeMetersで割ってRepeat UVを作ります。
applyTo()でShape単位のPBR値を変更する同じColor mapとNormal mapを使いながら、ShapeごとにPBR値だけを変えることもできます。
brick.applyTo(shape, {
roughness: 0.68,
specular: 0.35,
normalStrength: 1.2
});
createPreset()のappearanceとapplyTo()の違いは次のとおりです。
createPreset(..., { appearance })
applyTo(shape, options)
createPreset(..., { tile })
applyTo()では、slot、materialId、roughness、specular、metallic、normalStrength、alpha、ambient、power、emissive、flatShadingを指定できます。未知の項目は無視されず、入力ミスとして例外になります。
プリセットからの差分ではなく、全ての値を含むdefinitionを保存する場合はcreate()を使います。texture_catalogのCopy CodeとDownload JSはこの形式を出力します。
const definition = {
id: "custom.red-brick-wall",
schemaVersion: 1,
category: "brick",
label: {
ja: "カスタム赤レンガ",
en: "Custom Red Brick"
},
tile: {
resolution: { pixelsPerMeter: 200 },
unit: {
shortSizeMeters: 0.10,
longSizeMeters: 0.21,
thicknessMeters: 0.06,
longAxis: "u"
},
layout: { mode: "running-bond", rowOffsetRatio: 0.5 },
variationCell: { longUnitCount: 4, rowCount: 8 },
joint: {
widthMeters: 0.005,
color: [0.42, 0.42, 0.42],
depthMeters: 0.008,
edgeRoundMeters: 0.005
},
color: {
base: [0.48, 0.17, 0.10],
unitVariation: 0.06,
dirtColor: [0.19, 0.075, 0.045],
dirtAmount: 0.08
},
pattern: {
mode: "speckle",
scaleMeters: 0.012,
colorAmount: 0.07,
heightMeters: 0.00035
},
surface: {
detailScaleMeters: 0.010,
heightNoiseMeters: 0.00055
},
random: { seed: 2026081410 }
},
appearance: {
roughness: 0.78,
specular: 0.25,
metallic: 0.0,
normalStrength: 1.5
}
};
const customBrick = await materials.create(definition, { scale: 1.2 });
customBrick.applyTo(shape);
完全なdefinitionを保存すると、将来プリセットの初期値が変わっても、保存時の材質を再現できます。id、schemaVersion、label、tile、appearanceは省略せずに保存します。
指定値をそのまま確認できるように、ProceduralTileSpecは近い値への自動変換や別のプリセットへの置換を行わず、次の条件を生成開始前に検証します。
stackのrow offsetが0であることrunning-bondのrow offsetとrowCountの周期が一致することmixed-sawn-grainに複数のvariation unitがあることscale付きマテリアルをendShape()後に適用していないこと失敗時は、入力を補正せず例外を発生させます。表示が意図と異なる場合は、まずプリセットID、tileの階層、pixelsPerMeter、UV作成の順序を確認します。
通常の描画ではCompute生成の結果をそのまま使います。CPU版は、同じ生成仕様から期待されるColor、Height、Normalを作る基準です。GPU結果をCPUへ読み戻す処理は、比較や保存など同期が必要な場合だけ行います。
生成処理は次の三つに分けて考えます。
ProceduralTileSpec
├─ CPU reference: 値と画像の比較基準
├─ ComputeProceduralTile: GPU上のColor/Height/Normal生成
└─ ProceduralMaterial: Shapeへのtexture/PBR登録
同じrandom.seedと同じtile設定を使えば、部材のvariation、Perlin noise、Voronoi点、Terrazzo粒を再現できます。CPU版とCompute版で乱数の入力順と32 bit hashの規則を合わせることで、表示結果の差を数値で調べられます。
examples/29_01.htmlでは、次の処理を実際に確認できます。
WebgAppの初期化
→ ProceduralMaterialsの生成
→ ceramic.white.square と vinyl.cloudy.blue の生成
→ mapRealCuboid(2, 3, 4)
→ applyTo()
→ endShape()
→ Nodeへ追加
→ pagehideでdestroy()
上面、前面、側面を見れば、面ごとの長さに応じてUV範囲が変わり、部材の寸法が面全体へ引き伸ばされていないことを確認できます。samples/texture_catalog/texture_catalog.htmlでは、23プリセットの選択、主要なtile値とPBR値の変更、Color/Height/Normal preview、JavaScript/JSON出力、Color/Height/Normal画像の保存を確認できます。
手続きテクスチャを利用するときは、まずプリセットを選び、必要なtileまたはappearanceだけを変更します。直方体にはmapRealCuboid()を使い、scale付きマテリアルをendShape()より前に適用します。独自平面ではtileSizeMetersからRepeat UVを計算します。
この順序を守ると、部材の寸法、模様の周期、PBRの見え方、GPU resourceの生成と破棄を別々に確認できます。続く30章では、ここで作ったColor mapとNormal mapを、直接光、IBL、金属反射、粗さ、露出へ接続します。