ft: refactor materials/texture decoupling

made it so all materials can use a texture for colour source. this
should be extendable if we want to do e.g. coded patterns in future
This commit is contained in:
2026-09-13 14:53:28 +02:00
parent 968c232388
commit eddde10023
12 changed files with 89 additions and 69 deletions

View File

@@ -13,15 +13,15 @@
"focus_dist": 15.68 "focus_dist": 15.68
}, },
"materials": [ "materials": [
{ "type": "lambertian", "albedo": [0.2, 0.2, 0.2], "prob": 0.8 }, { "type": "lambertian", "colour": [0.2, 0.2, 0.2], "prob": 0.8 },
{ "type": "lambertian", "albedo": [0.9, 0.9, 0.0], "prob": 1.0, "fuzz": 0.1 }, { "type": "lambertian", "colour": [0.9, 0.9, 0.0], "prob": 1.0, "fuzz": 0.1 },
{ "type": "dielectric", "refraction_index": 1.5}, { "type": "dielectric", "refraction_index": 1.5},
{ "type": "normal"} { "type": "normal"}
], ],
"objects": [ "objects": [
{ "type": "sphere", "center": [0.0, 0.0, -1.2], "radius": 0.5, "material": { "type": "metal", "albedo": [0.7, 0.4, 0.2], "prob": 1.0, "fuzz": 0.1 }}, { "type": "sphere", "center": [0.0, 0.0, -1.2], "radius": 0.5, "material": { "type": "metal", "colour": [0.7, 0.4, 0.2], "prob": 1.0, "fuzz": 0.1 }},
{ "type": "sphere", "center": [-1, 0, -1], "radius": 0.4, "material": 3}, { "type": "sphere", "center": [-1, 0, -1], "radius": 0.4, "material": 3},
{ "type": "sphere", "center": [1, 0, -1], "radius": 0.5, "material": { "type": "metal", "albedo": [0.8, 0.6, 0.2], "prob": 1.0, "fuzz": 1.0 }}, { "type": "sphere", "center": [1, 0, -1], "radius": 0.5, "material": { "type": "metal", "colour": [0.8, 0.6, 0.2], "prob": 1.0, "fuzz": 1.0 }},
{ "type": "triangle", "p1": [-4, 0, -4], "p2": [0, 0, -4], "p3": [-2, 2, -4], "material": 1}, { "type": "triangle", "p1": [-4, 0, -4], "p2": [0, 0, -4], "p3": [-2, 2, -4], "material": 1},
{ "type": "triangle", "p1": [0, 0, -4], "p2": [4, 0, -4], "p3": [2, 2, -4], "material": 1}, { "type": "triangle", "p1": [0, 0, -4], "p2": [4, 0, -4], "p3": [2, 2, -4], "material": 1},
{ "type": "triangle", "p1": [-2, 2, -4], "p2": [2, 2, -4], "p3": [0, 4, -4], "material": 3}, { "type": "triangle", "p1": [-2, 2, -4], "p2": [2, 2, -4], "p3": [0, 4, -4], "material": 3},
@@ -30,7 +30,7 @@
{ "type": "quad", "p1": [-20, -1, 20], "p2": [20, -1, 20], "p3": [20, -1, -20], "p4": [-20, -1, -20], "material": 0}, { "type": "quad", "p1": [-20, -1, 20], "p2": [20, -1, 20], "p3": [20, -1, -20], "p4": [-20, -1, -20], "material": 0},
{ "type": "quad", "p1": [20, -1, 20], "p2": [20, -1, -20], "p3": [20, 20, -20], "p4": [20, 20, 20], "material": 0}, { "type": "quad", "p1": [20, -1, 20], "p2": [20, -1, -20], "p3": [20, 20, -20], "p4": [20, 20, 20], "material": 0},
{ "type": "cube", "p1": [8, 0, 2], "p2": [12, 0, 2], "p3": [12, 4, 2], "p4": [8, 4, 2], "p5": [8, 0, -2], "p6": [12, 0, -2], "p7": [12, 4, -2], "p8": [8, 4, -2], "material": 3}, { "type": "cube", "p1": [8, 0, 2], "p2": [12, 0, 2], "p3": [12, 4, 2], "p4": [8, 4, 2], "p5": [8, 0, -2], "p6": [12, 0, -2], "p7": [12, 4, -2], "p8": [8, 4, -2], "material": 3},
{ "type": "circle", "center": [-9, 3, 0], "radius": 3, "normal": [0, 1, 0.5], "material": {"type": "metal", "albedo": [0.9, 0.9, 0.9], "prob": 1.0, "fuzz": 0.3}} { "type": "circle", "center": [-9, 3, 0], "radius": 3, "normal": [0, 1, 0.5], "material": {"type": "metal", "colour": [0.9, 0.9, 0.9], "prob": 1.0, "fuzz": 0.3}}
] ]
} }

View File

@@ -13,13 +13,13 @@
"focus_dist": 15.68 "focus_dist": 15.68
}, },
"materials": [ "materials": [
{ "type": "metal", "albedo": [0.2, 0.4, 0.8 ], "prob": 1.0, "fuzz": 0.1}, { "type": "metal", "colour": [0.2, 0.4, 0.8 ], "prob": 1.0, "fuzz": 0.1},
{ "type": "metal", "albedo": [0.7, 0.4, 0.2 ], "prob": 1.0, "fuzz": 0.1}, { "type": "metal", "colour": [0.7, 0.4, 0.2 ], "prob": 1.0, "fuzz": 0.1},
{ "type": "lambertian", "albedo": [0.8, 0.8, 0.0 ], "prob": 1.0}, { "type": "lambertian", "colour": [0.8, 0.8, 0.0 ], "prob": 1.0},
{ "type": "lambertian", "albedo": [0.1, 0.2, 0.5 ], "prob": 1.0}, { "type": "lambertian", "colour": [0.1, 0.2, 0.5 ], "prob": 1.0},
{ "type": "dielectric", "refraction_index": 1.5}, { "type": "dielectric", "refraction_index": 1.5},
{ "type": "dielectric", "refraction_index": 0.67}, { "type": "dielectric", "refraction_index": 0.67},
{ "type": "metal", "albedo": [0.8, 0.6, 0.2 ], "prob": 1.0, "fuzz": 1.0} { "type": "metal", "colour": [0.8, 0.6, 0.2 ], "prob": 1.0, "fuzz": 1.0}
], ],
"objects": [ "objects": [

View File

@@ -13,15 +13,15 @@
"focus_dist": 15.68 "focus_dist": 15.68
}, },
"materials": [ "materials": [
{ "type": "lambertian", "albedo": [0.2, 0.2, 0.2], "prob": 0.8 }, { "type": "lambertian", "colour": [0.2, 0.2, 0.2], "prob": 0.8 },
{ "type": "lambertian", "albedo": [0.9, 0.9, 0.0], "prob": 1.0, "fuzz": 0.1 }, { "type": "lambertian", "colour": "./textures/ballnold.png", "prob": 1.0, "fuzz": 0.1 },
{ "type": "dielectric", "refraction_index": 1.5}, { "type": "dielectric", "refraction_index": 1.5},
{ "type": "normal"} { "type": "normal"}
], ],
"objects": [ "objects": [
{ "type": "sphere", "center": [0.0, 0.0, -1.2], "radius": 0.5, "material": { "type": "metal", "albedo": [0.7, 0.4, 0.2], "prob": 1.0, "fuzz": 0.1 }}, { "type": "sphere", "center": [0.0, 0.0, -1.2], "radius": 0.5, "material": { "type": "metal", "colour": [0.7, 0.4, 0.2], "prob": 1.0, "fuzz": 0.1 }},
{ "type": "sphere", "center": [-1, 0, -1], "radius": 0.4, "material": 3}, { "type": "sphere", "center": [-1, 0, -1], "radius": 0.4, "material": 3},
{ "type": "sphere", "center": [1, 0, -1], "radius": 0.5, "material": { "type": "metal", "albedo": [0.8, 0.6, 0.2], "prob": 1.0, "fuzz": 1.0 }}, { "type": "sphere", "center": [1, 0, -1], "radius": 0.5, "material": { "type": "metal", "colour": [0.8, 0.6, 0.2], "prob": 1.0, "fuzz": 1.0 }},
{ "type": "triangle", "p1": [-4, 0, -4], "p2": [0, 0, -4], "p3": [-2, 2, -4], "material": 1}, { "type": "triangle", "p1": [-4, 0, -4], "p2": [0, 0, -4], "p3": [-2, 2, -4], "material": 1},
{ "type": "triangle", "p1": [0, 0, -4], "p2": [4, 0, -4], "p3": [2, 2, -4], "material": 1}, { "type": "triangle", "p1": [0, 0, -4], "p2": [4, 0, -4], "p3": [2, 2, -4], "material": 1},
{ "type": "triangle", "p1": [-2, 2, -4], "p2": [2, 2, -4], "p3": [0, 4, -4], "material": 3}, { "type": "triangle", "p1": [-2, 2, -4], "p2": [2, 2, -4], "p3": [0, 4, -4], "material": 3},
@@ -30,7 +30,7 @@
{ "type": "quad", "p1": [-20, -1, 20], "p2": [20, -1, 20], "p3": [20, -1, -20], "p4": [-20, -1, -20], "material": 0}, { "type": "quad", "p1": [-20, -1, 20], "p2": [20, -1, 20], "p3": [20, -1, -20], "p4": [-20, -1, -20], "material": 0},
{ "type": "quad", "p1": [20, -1, 20], "p2": [20, -1, -20], "p3": [20, 20, -20], "p4": [20, 20, 20], "material": 0}, { "type": "quad", "p1": [20, -1, 20], "p2": [20, -1, -20], "p3": [20, 20, -20], "p4": [20, 20, 20], "material": 0},
{ "type": "cube", "p1": [8, 0, 2], "p2": [12, 0, 2], "p3": [12, 4, 2], "p4": [8, 4, 2], "p5": [8, 0, -2], "p6": [12, 0, -2], "p7": [12, 4, -2], "p8": [8, 4, -2], "material": 3}, { "type": "cube", "p1": [8, 0, 2], "p2": [12, 0, 2], "p3": [12, 4, 2], "p4": [8, 4, 2], "p5": [8, 0, -2], "p6": [12, 0, -2], "p7": [12, 4, -2], "p8": [8, 4, -2], "material": 3},
{ "type": "circle", "center": [-9, 3, 0], "radius": 3, "normal": [0, 1, 0.5], "material": {"type": "metal", "albedo": [0.9, 0.9, 0.9], "prob": 1.0, "fuzz": 0.3}} { "type": "circle", "center": [-9, 3, 0], "radius": 3, "normal": [0, 1, 0.5], "material": {"type": "metal", "colour": [0.9, 0.9, 0.9], "prob": 1.0, "fuzz": 0.3}}
] ]
} }

View File

@@ -1,10 +1,10 @@
{ {
"filename": "textured.png", "filename": "textured2.png",
"image_width": 1920, "image_width": 1920,
"image_height": 1080, "image_height": 1080,
"max_depth": 50, "max_depth": 50,
"camera": { "camera": {
"anti_alias_rate": 2, "anti_alias_rate": 5,
"fov": 50.0, "fov": 50.0,
"look_from": [-3, 4, 10], "look_from": [-3, 4, 10],
"look_at": [-3, 0.0, -10.0], "look_at": [-3, 0.0, -10.0],
@@ -13,13 +13,15 @@
"focus_dist": 15.68 "focus_dist": 15.68
}, },
"materials": [ "materials": [
{ "type": "lambertian", "albedo": [0.2, 0.2, 0.2], "prob": 0.8 }, { "type": "lambertian", "colour": [0.2, 0.2, 0.2], "prob": 0.8 },
{ "type": "lambertian", "albedo": { "source": "./textures/earthmap1k.png" }, "prob": 1.0 }, { "type": "dielectric", "refraction_index": 1.5, "colour": [0.9, 0.1, 0.4]},
{ "type": "lambertian", "albedo": { "source": "./textures/bluegrid.png" }, "prob": 0.5 } { "type": "metal", "colour": "./textures/ballnold.png", "prob": 1.0, "fuzz": 0.1 },
{ "type": "dielectric", "refraction_index": 1.5}
], ],
"objects": [ "objects": [
{ "type": "sphere", "center": [0.0, 0.0, -1.2], "radius": 0.9, "material": 2}, { "type": "sphere", "center": [0.0, 0.0, -1.2], "radius": 0.9, "material": 2},
{ "type": "sphere", "center": [-2, 0, -1], "radius": 0.8, "material": 1}, { "type": "sphere", "center": [-2, 0, -1], "radius": 0.8, "material": 1},
{ "type": "sphere", "center": [-2, 4, -1], "radius": 0.9, "material": 3},
{ "type": "triangle", "p1": [0, 0, -4], "p2": [4, 0, -4], "p3": [2, 2, -4], "material": 2}, { "type": "triangle", "p1": [0, 0, -4], "p2": [4, 0, -4], "p3": [2, 2, -4], "material": 2},
{ "type": "triangle", "p1": [-2, 2, -4], "p2": [2, 2, -4], "p3": [0, 4, -4], "material": 1}, { "type": "triangle", "p1": [-2, 2, -4], "p2": [2, 2, -4], "p3": [0, 4, -4], "material": 1},
{ "type": "quad", "p1": [-20, -1, -20], "p2": [20, -1, -20], "p3": [20, 20, -20], "p4": [-20, 20, -20], "material": 0}, { "type": "quad", "p1": [-20, -1, -20], "p2": [20, -1, -20], "p3": [20, 20, -20], "p4": [-20, 20, -20], "material": 0},

View File

@@ -27,10 +27,8 @@ fn main() {
if args.len() > 1 { if args.len() > 1 {
json_file = &args[1]; json_file = &args[1];
} }
println!("we done serializingiaonosnl");
let json_str = fs::read_to_string(json_file).expect("Reading specified scene file failed!"); let json_str = fs::read_to_string(json_file).expect("Reading specified scene file failed!");
let mut scene: Scene = serde_json::from_str(&json_str).unwrap(); let mut scene: Scene = serde_json::from_str(&json_str).unwrap();
let mut scene: Scene = Scene::random();
render(&mut scene); render(&mut scene);
} }

View File

@@ -1,33 +1,16 @@
use serde::Deserialize; use serde::Deserialize;
use crate::{objects::{hit::Hit, materials::texture::Texture}, vec3::Colour}; use crate::{
objects::{hit::Hit, materials::texture::Texture},
vec3::Colour,
};
#[derive(Debug)]
// FIXME (high priority): we can't deserialize this enum as-is, because of the texture.
// To fix this we'll have to pull the same trick we did for materialDef/sceneDef and the texture
// pointer, but i'm not sure what that implies for all materials.. maybe theres a clever way to
// solve that somehow, but from where im looking at it we'll need to manually deserialize everything
// that uses coloursource ://
pub enum ColourSource { pub enum ColourSource {
Colour(Colour), Colour(Colour),
Texture(Texture), Texture(Texture),
} }
// REFACTOR: not entirely happy having this serialization code here. move that.
#[derive(Deserialize)]
#[serde(untagged)]
enum RawColourSource {
Colour(Colour),
Texture(RawTexture),
}
#[derive(Deserialize)]
pub(crate) struct RawTexture {
pub source: String,
}
impl ColourSource { impl ColourSource {
pub fn get_colour(&self, hit: &Hit) -> Colour { pub fn get_colour(&self, hit: &Hit) -> Colour {
match self { match self {
@@ -35,13 +18,30 @@ impl ColourSource {
ColourSource::Texture(texture) => texture.colour_at(hit), ColourSource::Texture(texture) => texture.colour_at(hit),
} }
} }
pub fn rgb(r: f32, g: f32, b: f32) -> Self {
Self::Colour(Colour::new(r, g, b))
}
}
impl Default for ColourSource {
fn default() -> Self {
Self::rgb(1., 1., 1.)
}
}
#[derive(Deserialize)]
#[serde(untagged)]
enum RawColourSource {
Colour(Colour),
Texture(String),
} }
impl From<RawColourSource> for ColourSource { impl From<RawColourSource> for ColourSource {
fn from(value: RawColourSource) -> Self { fn from(value: RawColourSource) -> Self {
match value { match value {
RawColourSource::Colour(c) => Self::Colour(c), RawColourSource::Colour(c) => Self::Colour(c),
RawColourSource::Texture(t) => Self::Texture(Texture::new(&t.source)), RawColourSource::Texture(t) => Self::Texture(Texture::new(&t)),
} }
} }
} }

View File

@@ -4,21 +4,33 @@ use rand::RngExt;
use serde::Deserialize; use serde::Deserialize;
use crate::{ use crate::{
objects::{hit::Hit, materials::traits::Material}, objects::{
hit::Hit,
materials::{colour_source::ColourSource, traits::Material},
},
ray::Ray, ray::Ray,
vec3::Colour, vec3::Colour,
}; };
// TODO (low priority): add support for coloured dielectrics (add colour to the struct, return that // THOUGHT: not entirely happy with this implementation; i ideally want to specify transparent
// instead of 1,1,1) // dielectrics, but that will require a more substantial refactor wrt compositing + vec4 colours.
#[derive(Debug, Deserialize)] #[derive(Debug, Deserialize)]
pub struct Dielectric { pub struct Dielectric {
#[serde(default)]
colour: ColourSource,
refraction_index: f32, refraction_index: f32,
} }
impl Dielectric { impl Dielectric {
pub fn new(refraction_index: f32) -> Self { pub fn new(refraction_index: f32) -> Self {
Self { refraction_index } Self::new_coloured(refraction_index, ColourSource::rgb(1., 1., 1.))
}
pub fn new_coloured(refraction_index: f32, colour: ColourSource) -> Self {
Self {
refraction_index,
colour,
}
} }
fn reflectance(cos: f32, refraction_index: f32) -> f32 { fn reflectance(cos: f32, refraction_index: f32) -> f32 {
@@ -52,6 +64,6 @@ impl Material for Dielectric {
} else { } else {
unit.refract(hit.n(), ri) unit.refract(hit.n(), ri)
}; };
Some((Some(Ray::new(*hit.p(), dir)), Colour::new(1., 1., 1.))) Some((Some(Ray::new(*hit.p(), dir)), self.colour.get_colour(hit)))
} }
} }

View File

@@ -3,24 +3,28 @@ use serde::Deserialize;
use std::fmt::Debug; use std::fmt::Debug;
use crate::{ use crate::{
objects::{hit::Hit, materials::{colour_source::ColourSource, traits::Material}}, ray::Ray, vec3::{Colour, Vec3}, objects::{
hit::Hit,
materials::{colour_source::ColourSource, traits::Material},
},
ray::Ray,
vec3::{Colour, Vec3},
}; };
#[derive(Deserialize)] #[derive(Deserialize)]
pub struct Lambertian { pub struct Lambertian {
albedo: ColourSource, colour: ColourSource,
// albedo: Colour,
prob: f32, prob: f32,
} }
impl Lambertian { impl Lambertian {
pub fn new(albedo: ColourSource, prob: f32) -> Self { pub fn new(colour: ColourSource, prob: f32) -> Self {
Self { albedo, prob } Self { colour, prob }
} }
pub fn rgb(r: f32, g: f32, b: f32, prob: f32) -> Self { pub fn rgb(r: f32, g: f32, b: f32, prob: f32) -> Self {
Self { Self {
albedo: ColourSource::Colour(Colour::new(r, g, b)), colour: ColourSource::rgb(r, g, b),
prob, prob,
} }
} }
@@ -28,9 +32,10 @@ impl Lambertian {
impl Debug for Lambertian { impl Debug for Lambertian {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
f.debug_struct("Lambertian").field("prob", &self.prob).finish() f.debug_struct("Lambertian")
// .field("albedo", &self.albedo) .field("prob", &self.prob)
// FIXME: readd albedo field w proper syntax ^ .field("colour", &self.colour)
.finish()
} }
} }
@@ -43,7 +48,7 @@ impl Material for Lambertian {
dir = *hit.n(); dir = *hit.n();
} }
let scattered = Ray::new(*hit.p(), dir); let scattered = Ray::new(*hit.p(), dir);
return Some((Some(scattered), self.albedo.get_colour(hit))); return Some((Some(scattered), self.colour.get_colour(hit)));
} }
None None
} }
@@ -51,19 +56,19 @@ impl Material for Lambertian {
#[derive(Debug, Deserialize)] #[derive(Debug, Deserialize)]
pub struct Metal { pub struct Metal {
albedo: Colour, colour: ColourSource,
prob: f32, prob: f32,
fuzz: f32, fuzz: f32,
} }
impl Metal { impl Metal {
pub fn new(albedo: Colour, prob: f32, fuzz: f32) -> Self { pub fn new(colour: ColourSource, prob: f32, fuzz: f32) -> Self {
Self { albedo, prob, fuzz } Self { colour, prob, fuzz }
} }
pub fn rgb(r: f32, g: f32, b: f32, prob: f32, fuzz: f32) -> Self { pub fn rgb(r: f32, g: f32, b: f32, prob: f32, fuzz: f32) -> Self {
Self { Self {
albedo: Colour::new(r, g, b), colour: ColourSource::rgb(r, g, b),
prob, prob,
fuzz, fuzz,
} }
@@ -76,7 +81,7 @@ impl Material for Metal {
if self.prob >= rng.random::<f32>() { if self.prob >= rng.random::<f32>() {
let mut refl = ray.dir().reflect(hit.n()); let mut refl = ray.dir().reflect(hit.n());
refl = refl.get_unit() + self.fuzz * Vec3::random_unit(); refl = refl.get_unit() + self.fuzz * Vec3::random_unit();
return Some((Some(Ray::new(*hit.p(), refl)), self.albedo)); return Some((Some(Ray::new(*hit.p(), refl)), self.colour.get_colour(hit)));
} }
None None
} }

View File

@@ -72,7 +72,7 @@ pub fn render_chunk(chunk: &mut [u8], scene: &Scene, y: u32) {
chunk[(i * 3) as usize + 1] = g; chunk[(i * 3) as usize + 1] = g;
chunk[(i * 3) as usize + 2] = b; chunk[(i * 3) as usize + 2] = b;
} }
trace!("Line {}\tfinished.", y); trace!("Line {:4} finished.", y);
} }
pub fn ray_colour(hittables: &Vec<Arc<dyn Hittable>>, r: &Ray, depth: u32) -> Colour { pub fn ray_colour(hittables: &Vec<Arc<dyn Hittable>>, r: &Ray, depth: u32) -> Colour {

View File

@@ -79,7 +79,10 @@ impl Scene {
world.push(Arc::new(Sphere::new( world.push(Arc::new(Sphere::new(
center, center,
0.2, 0.2,
Arc::new(Lambertian::new(ColourSource::Colour(Vec3::random() * Vec3::random()), 1.)), Arc::new(Lambertian::new(
ColourSource::Colour(Vec3::random() * Vec3::random()),
1.,
)),
))); )));
} else if mat < 0.95 { } else if mat < 0.95 {
// metal // metal
@@ -187,7 +190,7 @@ struct SceneDef {
pub max_depth: u32, pub max_depth: u32,
} }
// TODO (low priority): rn textures are tightly coupled to materials; what if we wnat different // TODO (low priority): rn textures are tightly coupled to materials; what if we want different
// materials to share a texture? apply the same technique we used for decoupling materials/objects // materials to share a texture? apply the same technique we used for decoupling materials/objects
// on textures/materials. // on textures/materials.
impl<'de> Deserialize<'de> for Scene { impl<'de> Deserialize<'de> for Scene {

BIN
textures/ballnold.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 746 KiB

BIN
textures/floppa.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 323 KiB