Vertex

Description

A single vertex: a required 2D or 3D position plus any per-vertex attributes your shader declares (commonly uv and color, but any key the shader’s vertex stage reads is fair game). Build vertices and feed them into a Mesh to draw.

Example

Rust

use fragmentcolor::mesh::Vertex;
let v = Vertex::new([0.0, 0.0, 0.0]).set("uv", [0.5, 0.5]);

JavaScript

import { Vertex } from "fragmentcolor";
const v = new Vertex([0.0, 0.0, 0.0]).set("uv", [0.5, 0.5]);

Python

from fragmentcolor import Vertex
v = Vertex([0.0, 0.0, 0.0]).set("uv", [0.5, 0.5])

Swift

import FragmentColor
let v = try Vertex([0.0, 0.0, 0.0]).set("uv", [0.5, 0.5])

Kotlin

import org.fragmentcolor.*
val v = Vertex(listOf(0.0f, 0.0f, 0.0f)).set("uv", floatArrayOf(0.5f, 0.5f))

Methods

---

Vertex::new

Construct a Vertex from a 2D or 3D position. Set additional attributes (uv, color, custom keys) with set to match the per-vertex inputs your shader declares.

Example

Rust

use fragmentcolor::mesh::Vertex;
let v = Vertex::new([0.0, 0.0]);

JavaScript

import { Vertex } from "fragmentcolor";
const v = new Vertex([0.0, 0.0]);

Python

from fragmentcolor import Vertex
v = Vertex([0.0, 0.0])

Swift

import FragmentColor
let v = try Vertex([0.0, 0.0])

Kotlin

import org.fragmentcolor.*
val v = Vertex(listOf(0.0f, 0.0f))

---

Vertex::set

Attach an arbitrary property to the vertex.

Locations and mapping:

• When you call set(key, value) for the first time for a given key, the Vertex assigns the next available @location(N) to that property (starting after position). Subsequent calls reuse the same location.
• At render time, shader vertex inputs (declared with @location(N)) are derived from the Shader and matched to Vertex/Instance properties by:
  1. explicit location (instance first, then vertex), then
  2. name (instance first, then vertex).
• There is no special-case for location(0) in the mapping; position is just another vertex attribute exposed as position with a 2- or 3-component format depending on how you constructed the Vertex.

Planned explicit control:

• You will be able to pin a property to a specific location using a fluent API: vertex.set(key, value).at(index).
• Vertex construction may also support Vertex::from_shader(&Shader) to derive an initial layout directly from the shader AST.

Example

Rust

use fragmentcolor::mesh::{Vertex, VertexValue};
let v = Vertex::new([0.0, 0.0, 0.0]).set("weight", 1.0).set("color",[1.0, 0.0, 0.0]);

JavaScript

import { Vertex } from "fragmentcolor";
const v = new Vertex([0.0, 0.0, 0.0]).set("weight", 1.0).set("color",[1.0, 0.0, 0.0]);

Python

from fragmentcolor import Vertex
v = Vertex([0.0, 0.0, 0.0]).set("weight", 1.0).set("color",[1.0, 0.0, 0.0])

Swift

import FragmentColor
let v = try Vertex([0.0, 0.0, 0.0]).set("weight", 1.0).set("color",[1.0, 0.0, 0.0])

Kotlin

import org.fragmentcolor.*
val v = Vertex(listOf(0.0f, 0.0f, 0.0f)).set("weight", 1.0).set("color", listOf(1.0f, 0.0f, 0.0f))

---

Vertex::create_instance

Create an Instance that inherits this vertex’s attributes. Use this when you want a starting point for an instance whose per-instance values mostly match the source vertex, then call set on the result to change the fields that differ.

Example

Rust

use fragmentcolor::mesh::Vertex;
let v = Vertex::new([0.0, 0.0]);
let inst = v.create_instance();
1 collapsed line
_ = inst;

JavaScript

import { Vertex } from "fragmentcolor";
const v = new Vertex([0.0, 0.0]);
const inst = v.createInstance();

Python

from fragmentcolor import Vertex
v = Vertex([0.0, 0.0])
inst = v.create_instance()

Swift

import FragmentColor
let v = try Vertex([0.0, 0.0])
let inst = v.createInstance()

Kotlin

import org.fragmentcolor.*
val v = Vertex(listOf(0.0f, 0.0f))
val inst = v.createInstance()