Struct MaterialGraph 

pub struct MaterialGraph {
    pub nodes: Vec<MatNode>,
    pub textures: [String; 3],
    pub next_id: u32,
    pub mode: GraphMode,
}

A whole material.

Fields

nodes: Vec<MatNode>

All nodes, including the single Output node.

textures: [String; 3]

Images bound to the Texture node slots: albedo, normal map, ORM (occlusion/roughness/metallic).

next_id: u32

Next free node id.

mode: GraphMode

What the graph produces.

Implementations

impl MaterialGraph

pub fn default_graph() -> Self

A new graph with only an Output node (grey, rough).

pub fn default_graph_for(mode: GraphMode) -> Self

A starter graph for the given kind: the result node plus one connected node.

pub fn add_node(&mut self, kind: &str, pos: [f32; 2]) -> u32

Adds a node of a known type with its default values.

pub fn connect(&mut self, from: u32, to: u32, input: usize) -> bool

Connects from’s main output to input input of node to. Returns false for self-links or cycles.

pub fn connect_output( &mut self, from: u32, output: u8, to: u32, input: usize, convert: u8, ) -> bool

Connects output output of from to input input of to, converting with convert (see crate::material_nodes_v4::CONVERSIONS).

pub fn remove_node(&mut self, id: u32)

Removes a node (the Output node stays) and every link that used it.

pub fn from_json(text: &str) -> Result<Self, String>

Parses a .kmat file.

pub fn to_json(&self) -> String

Serialises to pretty JSON.

pub fn validate(&self) -> Result<(), String>

Checks graph identity, sockets and links before generating executable shader code. Unconnected nodes are checked too, so saving an invalid graph cannot hide broken links.

Trait Implementations

impl Clone for MaterialGraph

fn clone(&self) -> MaterialGraph

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MaterialGraph

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for MaterialGraph

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for MaterialGraph

where MaterialGraph: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for MaterialGraph

fn eq(&self, other: &MaterialGraph) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for MaterialGraph

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for MaterialGraph