Struct Scene 

pub struct Scene { /* private fields */ }

A 3D scene. Renders one <div data-three="scene"> element.

use autumn_plugin_three::{Camera, Color, Controls, Light, Mesh, Scene};
use autumn_web::html;

let scene = Scene::new()
    .label("A spinning orange torus knot")
    .camera(Camera::perspective().position([0.0, 0.0, 4.0]))
    .controls(Controls::OrbitNoZoom)
    .add(Mesh::torus_knot(0.8, 0.25).color(Color::hex(0xff7a18)).spin([0.0, 45.0, 0.0]))
    .add(Light::directional().position([3.0, 5.0, 2.0]))
    .fallback(html! { p { "3D preview needs WebGL." } });

let html = html! { (scene) }.into_string();
assert!(html.starts_with(r#"<div role="img""#), "{html}");
assert!(html.contains(r#"data-three="scene""#));
assert!(html.contains(r#"data-three-mesh="torus-knot""#));

Implementations

impl Scene

pub fn new() -> Self

Makes an empty scene with the defaults.

pub fn id(self, id: impl Into<String>) -> Self

Sets the element id.

pub fn class(self, class: impl Into<String>) -> Self

Sets the element class, for your own size or layout CSS.

pub fn label(self, label: impl Into<String>) -> Self

Sets an accessible label. The element gets role="img" and aria-label.

pub const fn aspect(self, aspect: Aspect) -> Self

Sets the aspect ratio. Default: Aspect::Wide (16 / 9).

pub const fn background(self, color: Color) -> Self

Sets a solid background color. Default: transparent.

pub const fn camera(self, camera: Camera) -> Self

Sets the camera.

pub const fn controls(self, controls: Controls) -> Self

Sets the camera controls. Default: Controls::None.

pub const fn environment(self, environment: Environment) -> Self

Sets the image-based light.

pub const fn turntable(self, degrees_per_second: f32) -> Self

Turns the whole scene around the Y axis, in degrees per second. Negative values turn clockwise (seen from above).

pub const fn animate_reduced_motion(self) -> Self

Keeps automatic motion (spin, turntable, clips) when the user prefers reduced motion. Default: automatic motion stops.

pub fn add(self, object: impl Into<SceneObject>) -> Self

Adds a mesh, model, or light.

pub fn fallback(self, markup: Markup) -> Self

Sets fallback content. It shows without JavaScript, without WebGL, and when a model fails to load.

Trait Implementations

impl Clone for Scene

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Scene

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

Formats the value using the given formatter.

impl Default for Scene

fn default() -> Self

Returns the “default value” for a type.

impl Render for Scene

fn render(&self) -> Markup

Renders self as a block of Markup.

fn render_to(&self, buffer: &mut String)

Appends a representation of self to the given buffer.