texture_catalog

texture_catalog

English | 日本語

概要

texture_catalogは、webgコアのProcedural Texture presetを選択・編集し、立方体とColor/Height/Normal mapで確認するサンプルです。完成した設定はJavaScriptまたはJSON、生成したColor/Height/Normal mapはPNGまたはJPEGとして保存できます。

実行

リポジトリrootでHTTP serverを起動し、samples/texture_catalog/texture_catalog.htmlを開きます。

python3 -m http.server 8000

最小API

import ProceduralMaterials from "../../webg/ProceduralMaterials.js";

const materials = new ProceduralMaterials(gpu);
const oak = await materials.createPreset("wood.oak.plank");
oak.applyTo(shape);

Shapeは事前にUVを持つ必要があります。同じmaterial handleは複数Shapeへ登録できます。終了時はmaterials.destroy()で生成したGPU resourceを解放します。

初期preset

木材、コンクリート、窯業系セメント、レンガ、ビニール、セラミック、樹脂、石材の23 presetを収録しています。13 pattern(柾目、板目、柾目・板目mixを含む)を確認できます。Oak、Walnut、Cedarには板目とmixのpresetがあり、mixはvariation単位で柾目/板目を半数ずつ割り当てます。

丸い石粒と砂利

Categoryをstoneにすると、次の3種類を選べます。

Preset ID内容
stone.pebbles.gray石だけ。丸い大粒、高さ上界40mm
stone.pebbles-gravel.gray石と砂利。石の隙間に高さ6mmの小粒
stone.gravel.gray砂利だけ。小粒、高さ上界6mm

いずれも新しいpebbles pattern、目地なし、2m四方の周期面です。
Pattern scale mは粒を配置する間隔の尺度です。各粒の直径は、その尺度とseedに基づく個体差から決まります。
大粒は0.12m、小粒は0.065mを基準に、半径・縦横比・向きをseedで変えます。

粒の色は暗色・中間色・明色を連続した濃淡から選びます。
Color amountは粒の色の濃淡、Pattern height mは粒の高さです。
Height/Normalは色の濃淡から独立して設定でき、暗い粒も上向きに盛り上がります。
専用欄の「丸み」は0が平頂、1が丸い上面です。Color mapの濃淡を保ちながら、上面の丸みを調整できます。
「敷き詰め」は粒の大きさと中心位置のばらつきを調整し、隙間を狭めます。
「配置の乱雑さ」は0〜1で、位置のずれ、粒径、縦横比のばらつきを増やします。
「石だけ」は乱雑さ・粒の密度・敷き詰めを1にし、中央が高い丸い石を密に配置します。
「隙間の砂利の量」は0で大粒だけ、1で隙間へ小粒を合成します。
砂利の配置尺度・高さ・色の濃淡も独立して編集できます。

const stones = await materials.createPreset("stone.pebbles-gravel.gray", {
  tile: {
    pattern: {
      colorAmount: 0.10,
      heightMeters: 0.040,
      pebbles: { roundness: 1, gravelAmount: 1, gravelHeightMeters: 0.006 }
    }
  }
});
stones.applyTo(shape);

左下にColor・Height・Normalを並べて表示します。Heightは低い面が暗く、高い面が明るい画像です。
グレースケールは各材質のheightRangeMetersを基準に正規化した値です。メートル単位の高さを得るときは、その範囲で復号します。
Height rangeで復号に必要な範囲を確認でき、Download Heightで画像も保存できます。
Height/Normalを再利用する場合はPNGを選んでください。

立方体の輪郭は元のgeometryで決まり、Normalで表面の細かな起伏を照明へ反映します。
実際の起伏へ光線を当てるアプリではHeightを復号し、高さ場の交差に使います。

中心が高い石を敷き詰めた表示

編集と出力

解像度、Base/Dirt/Joint色、タイル間の色変化、部材寸法、長軸、variation cell、目地、配置、pattern、surface detail、random seed、roughness、specular、metallic、Normal strengthを編集できます。Thickness mは部材寸法の参考値としてdefinitionへ保存します。画像の凹凸はpatternとsurface detailの高さで設定します。変更は入力と同時にコード表示とGPU textureへ反映されます。GenerateまたはGキーは、同じdefinitionを手動で再生成する操作です。

Definition metadataでは、出力する部材のMaterial ID、Category、日英のLabel、Tile preset IDを編集できます。最初のCategoryは既存presetを絞り込む選択欄で、Definition metadata内のCategoryが出力definitionへ保存される分類です。既存presetを選択してからこれらの値を変更すると、同じtileとappearanceを元に別の部材definitionを作成できます。

コンクリートの砂による細かなざらつきを試す場合は、Patternのmottleを大きな色むらとして残し、Surface detail scale mを0.010〜0.0125、Surface noise height mを0.00020〜0.00030から調整します。色むらの粗さはPattern scale m、色の強さはColor amount、凹凸の強さはSurface noise height mで別々に変更できます。pixelsPerMeterは細部を記録する画素数を指定します。凹凸の高さはSurface noise height mで指定します。200 pixels/mで細部が潰れる場合だけ400 pixels/mを試します。

例えば、fiber cement siding用にmetadataを設定すると、JavaScript出力の先頭は次の形になります。tile内の他の設定も画面で編集した完成値が続きます。

export default {
  "id": "fiber.cement.siding",
  "schemaVersion": 1,
  "category": "cement",
  "label": {
    "ja": "窯業系サイディング",
    "en": "Fiber cement siding"
  },
  "tile": {
    "presetId": "fiber.cement.siding",
    // resolution、unit、layout、color、patternなどの完成値
  }
};

このsampleはdefinitionファイルを出力します。コアpresetへの登録は別の操作として扱います。出力したdefinitionをコアpresetへ追加または既存presetと入れ替える場合は、内容を確認したうえでコア側へ個別に反映します。

LayoutのstackはRow offsetを0にします。running-bondへ変更した時にRow offsetが0なら、違いが見える標準値として1/2へ切り替えます。running-bondのoffsetを0、1/3、1/4へ変更すると、選択した値で再生成されます。

木材presetの初期配置は、Oakがrunning-bondの1/2、Walnutが1/3、Cedarが1/4です。Walnutは1/3の周期を閉じるため、variation cellを2列×6行で生成します。

寸法、配置、反射

項目変更する内容
Pixels per meter生成解像度。部材寸法、目地幅、edge roundはこの解像度で整数pixelに揃えられる
Long/Short size m一部材の長辺と短辺。textureの一周期と実寸Repeatに影響する
Thickness mode/Thickness m部材厚の参考値として保存。画像の凹凸はpatternとsurface detailの高さで設定
Long axis長辺をtextureのuまたはvへ割り当てる方向
Variation columns/rowstexture内で異なる部材variationを配置する数
Joint edge round m目地から部材面へ戻る縁の丸み
Dirt color/Dirt amount部材表面へ加える汚れの色と量
MetallicPBRマテリアルの金属度

Patternとnoise

項目変更する内容
Tile color variationタイルまたは部材ごとの明暗差。0で均一になり、大きいほどタイル間の色変化が強くなる。入力範囲は0~0.25
Pattern scale m木理、石目、斑、粒など材質固有patternの基準寸法。小さいほど細かく、大きいほど粗くなる
Pattern color amountpatternによるColor mapの明暗振幅
Pattern height mpatternをHeight/Normal mapへ反映する物理的な凹凸振幅
Surface detail scale m材質patternとは独立した共通Perlin detailの基準寸法
Surface noise height msurface detailをHeight/Normal mapへ加える微細な凹凸振幅
Random seed部材variation、Perlin noise、Voronoi点、Terrazzo chipなどの配置を変更する再現用整数

Patternとsurface detailは別の層です。例えば木理の間隔だけを変える場合はPattern scale m、木理を保ったまま表面の細かなざらつきを変える場合はSurface detail scale mとSurface noise height mを調整します。同じseedと同じ設定は同じtextureを再生成します。

数値の入力とshortcut

すべての数値欄は、右端のspin buttonだけでなく、欄を選択して数値を直接入力できます。数値欄へfocusがある間は↑/↓で次のstepずつ変更します。panel外では↑/↓はcamera操作です。

数値欄↑/↓のstep
Pixels per meter1
Long/Short size、Joint width0.005 m
Joint edge round0.0001 m
Joint depth0.0001 m
Pattern scale、Surface detail scale0.0025 m
Pattern color amount0.005
Pattern height、Surface noise height0.00001 m
Random seed1
Dirt amount0.005
Metallic、Roughness、Specular0.01
Normal strength0.05

GはGenerate buttonと同じ操作です。Canvas上でも数値欄へfocusがあるときでも使用できます。Ctrl+G、Command+G、Alt+Gはbrowser/OS側の操作を優先します。Generateはキーを押した時点で1回実行し、次の実行はキーを離してから再び押したときに受け付けます。

数値を直接入力している間はcode表示だけを更新し、入力完了時にGPU textureを生成します。↑/↓のspin buttonも値が確定した時点で生成します。これにより0.01のような小数も、最後まで入力した値で生成できます。step、min、max、解像度の整数pixel条件から外れた値は、最も近い入力可能な値へ丸め、info欄に変更内容を表示します。
Gは文字列入力欄とtextareaでは入力文字として扱われ、それ以外のcontrolとCanvasではGenerate shortcutとして動作します。

Copy CodeとDownload JSは省略なしの完成definitionをES moduleとして出力します。Download JSONも同じdefinitionを保存し、Import JSONで再読込できます。数値がstep、min、max、解像度の整数pixel条件から外れる場合は、入力可能な近い値へ丸めてinfo欄へ表示します。

Texture imagesでPNGまたはJPEGを選び、Color・Height・Normal mapを生成元と同じpixel寸法で個別に保存できます。設定変更後に自動生成が完了してからダウンロードしてください。PNGは可逆です。Height/Normal mapを材質へ再利用する場合は、channel値を元の精度で保存するPNGを使用してください。