User Tools

Site Tools


ig:gfx:uv-coordinates

This is an old revision of the document!


* Type: string

  • Enum: CUBIC, AUTO
  • Default: CUBIC
  • CUBIC — Applies a cubic projection to the panel, useful for simple box-like geometry.
  • AUTO — Automatically calculates UVs based on the geometry, suitable for irregular or complex shapes.

Note: This setting overrides the global UV projection behavior for the panel it is applied to.

[] *Figure: Comparison of uvType methods. Left: CUBIC — single projection along X/Y/Z axes. Right: AUTO — multiple UV islands separated by seams.*

"uv": {
	"patchSize": 150,
	"uvorigin": "ORIGIN",
	"uOffset": 0,
	"vOffset": 0,
	"uvType": "CUBIC"
},
 
"frame": [
	{
		"board": "1",
		"position": { "x": 0, "y": 0 },
		"profile": "board",
		"uv": {
			"patchSize": 150,
			"uvorigin": "ORIGIN",
			"uOffset": 0,
			"vOffset": 0,
			"rotation": 90,    // 90° clockwise
			"uvType": "AUTO"   // Automatic mapping for irregular shapes
		}
	},
	{
		"board": "2",
		"position": { "x": 609.6, "y": 0 },
		"profile": "board",
		"uv": {
			"rotation": -45,   // 45° counter-clockwise
			"uvType": "CUBIC"  // Cubic projection
		}
	}
]

UV Rotation ("rotation")

The rotation parameter is applied only within a frame array, where it overrides the global UV rotation (which defaults to 0.0°). It is specified per board and must be given in degrees—negative values are accepted.

  • Only valid inside the frame array for individual boards.
  • Overrides the global UV rotation value of 0.0°.
  • Expressed in degrees; e.g., “rotation”: 90 for a 90° clockwise turn, or “rotation”: -45 for a 45° counter-clockwise turn.

Usage Example

"uv": {
	"patchSize": 150,
	"uvorigin": "ORIGIN",
	"uOffset": 0,
	"vOffset": 0
},
 
"frame": [
	{
		"board": "1",
		"position": { "x": 0, "y": 0 },
		"profile": "board",
		"uv": {
			"patchSize": 150,
			"uvorigin": "ORIGIN",
			"uOffset": 0,
			"vOffset": 0,
			"rotation": 90    // 90° clockwise
		}
	},
	{
		"board": "2",
		"position": { "x": 609.6, "y": 0 },
		"profile": "board",
		"uv": {
			"rotation": -45    // 45° counter-clockwise
		}
	}
]

**

ig/gfx/uv-coordinates.1761732925.txt.gz · Last modified: 2025/10/29 11:15 by ig_ii