Merge reviewed preview changes and retain normal convention controls

This commit is contained in:
Rafael Mendes committed 2026-11-05 14:35:58 -03:00
commit cd4c2dfa43
10 files changed
+171 -3

No files matched your search

+1 -1
View File
@@ -80,7 +80,7 @@ Types: `move`, `down`, `up`, `click`, `doubleClick`, `drag`, `scroll`, `key` (eg
| `graph.node.function` | `{id?, param, function}` drives a parameter by a function graph of the graph's inputs (dynamic parameter); `{id?, param, remove: true}` removes it |
| `graph.preset.save` / `.apply` / `.delete` | `{name}`: store, restore or remove the current input values |
| `graph.createFromSelection` | `{name?, ids?}`: move nodes into a sub-graph and replace them with an instance |
| `view.2d` / `view.3d` | which node the 2D view shows, channel, tiling, histogram; scene, environment, camera, tiling, `heightScale` (how far the height output raises the mesh, in mesh radii) and `heightLevel` (the height that stays on the surface; 0 = the relief rises out of it), `transparency` (see through where the alpha is below one: the opacity output, else the base color's alpha), `alphaView` (show the alpha channel) |
| `view.2d` / `view.3d` | which node the 2D view shows, channel, tiling, histogram; scene, environment, camera, tiling, `heightScale` (how far the height output raises the mesh, in mesh radii) and `heightLevel` (the height that stays on the surface; 0 = the relief rises out of it), `normalYFlip` (interpret DirectX normal maps; default false/OpenGL), `transparency` (see through where the alpha is below one: the opacity output, else the base color's alpha), `alphaView` (show the alpha channel) |
| `view.3d.loadMesh` | `{path}` shows an OBJ, glTF or GLB mesh (scene `custom`) |
| `library.list` | `{filter?, category?}`: every node with ports and parameters |
+6
View File
@@ -89,6 +89,12 @@ session.
## Alpha in the 3D view
The 3D view reads OpenGL normal maps by default, matching the Normal node's default format.
For a DirectX normal map, enable **Display ▸ Flip normal map Y (DirectX)**, or run
`view.3d {"normalYFlip": true}`. Choose the corresponding format in the Normal node's properties.
The setting affects both the interactive view and headless renders, appears as `view3d.normalYFlip`
in `session.inspect`, and returns to OpenGL when the scene is reset.
<p align="center">
<img src="images/materialcraft-alpha-channel.png" alt="The same sphere in the alpha channel view: the opaque grid lines are white and the clear gaps black" width="100%">
<br><sub>The alpha channel view: white is opaque, black is clear</sub>