Struct duku::Target

pub struct Target { /* fields omitted */ }

Active render target.

Records rendering commands and settings. Received from the draw or draw_on_canvas functions.

Implementations

impl Target

pub fn background(&mut self, color: impl Into<Rgb>)

Set background color of canvas

pub fn fill(&mut self, color: impl Into<Rgb>)

Set fill color for shapes and text

pub fn stroke(&mut self, color: impl Into<Rgb>)

Set stroke color for borders and lines

pub fn tint(&mut self, color: impl Into<Rgb>)

Set tint color for meshes and textures

pub fn material(&mut self, m: &Handle<Material>)

Set material for meshes

pub fn no_material(&mut self)

Use default material for meshes

pub fn shader(&mut self, s: &Handle<Shader>)

Set shader for meshes

pub fn no_shader(&mut self)

Use default shader for meshes

pub fn skybox(&mut self, s: &Handle<Cubemap>)

Set skybox for rendering

pub fn font(&mut self, f: &Handle<Font>)

Set font for text

pub fn no_font(&mut self)

Use default font for text

pub fn shadows(&mut self)

Enable casting shadows for meshes

Uses the first directional light for casting the shadows.

pub fn no_shadows(&mut self)

Disable casting shadows for meshes

pub fn shadow_depth(&mut self, d: f32)

Set max shadow depth

pub fn shadow_split(&mut self, s: f32)

Set shadow split coefficient

0 to 1, higher values make closer shadows look better.

pub fn shadow_softness(&mut self, pcf: Pcf)

Set how soft shadows appear

pub fn light(&mut self, l: Light)

Add light to scene

Max is 4. When lights are full, removes first lights.

pub fn ambient(&mut self, color: impl Into<Rgbf>, brightness: f32)

Set the ambient light that affects the entire scene

pub fn exposure(&mut self, e: f32)

Set the exposure for tone mapping

pub fn stroke_weight(&mut self, w: f32)

Set the stroke weight for lines and borders

pub fn font_size(&mut self, s: u32)

Set font size for text

pub fn border_mode(&mut self, mode: BorderMode)

Set border mode

pub fn shape_mode(&mut self, mode: ShapeMode)

Set shape mode

pub fn filter(&mut self, f: Filter)

Set filter for textures

pub fn wrap(&mut self, w: Wrap)

Set wrap mode for textures

pub fn transform(&mut self, matrix: impl Into<Mat4>)

Transform points by matrix

pub fn reset_transform(&mut self)

Reset transform to default

pub fn translate(&mut self, v: impl Into<Vec3>)

Move transform by vector

pub fn translate_x(&mut self, x: f32)

Move transform on X axis

pub fn translate_y(&mut self, y: f32)

Move transform on Y axis

pub fn translate_z(&mut self, z: f32)

Move transform on Z axis

pub fn scale(&mut self, v: impl Into<Vec3>)

Scale transform by vector

pub fn rotate(&mut self, q: impl Into<Quat>)

Rotate transform by quaternion

pub fn rotate_x(&mut self, d: f32)

Rotate transform on the X axis

This angle is in degrees.

pub fn rotate_y(&mut self, d: f32)

Rotate transform on the Y axis

This angle is in degrees.

pub fn rotate_z(&mut self, d: f32)

Rotate transform on the Z axis

This angle is in degrees.

pub fn line(&mut self, p1: impl Into<Vec2>, p2: impl Into<Vec2>)

Draw a 2D line

pub fn lines(&mut self, points: &[Vec2])

Draw mitered 2D lines

pub fn mesh(&mut self, mesh: &Handle<Mesh>)

Draw a custom 3D mesh

pub fn wireframe(&mut self, mesh: &Handle<Mesh>)

Draw a wireframe for a 3D mesh

pub fn cube(&mut self, scale: impl Into<Vec3>)

Draw a scaled cube

pub fn sphere_uv(&mut self, scale: impl Into<Vec3>)

Draw a scaled uv sphere

pub fn sphere_ico(&mut self, scale: impl Into<Vec3>)

Draw a scaled ico sphere

pub fn plane(&mut self, scale: impl Into<Vec2>)

Draw a scaled plane

pub fn surface(&mut self, shader: &Handle<Shader>)

Draw a surface with a custom shader

pub fn fullscreen(&mut self, canvas: &Handle<Canvas>)

Draw a fullscreen canvas

pub fn model(&mut self, model: &Handle<Model>)

Draw all of the meshes of a model

pub fn debug_line<V: Into<Vec3>>(&mut self, p1: V, p2: V)

Draw a 3D debug line that isn't controlled by stroke_weight

pub fn debug_grid(&mut self)

Draw 3D guide grid for X and Z axis

pub fn text(&mut self, text: impl AsRef<str>, pos: impl Into<Vec2>)

Draw text string

pub fn shape(&mut self, points: &[Vec2])

Draw a custom shape from points

Shape must be convex

pub fn rect(&mut self, pos: impl Into<Vec2>, size: impl Into<Vec2>)

Draw a rectangle

pub fn square(&mut self, pos: impl Into<Vec2>, size: f32)

Draw a square

pub fn ellipse(&mut self, pos: impl Into<Vec2>, size: impl Into<Vec2>)

Draw an ellipse

pub fn circle(&mut self, pos: impl Into<Vec2>, size: f32)

Draw a circle

pub fn texture(
    &mut self,
    texture: &Handle<Texture>,
    pos: impl Into<Vec2>,
    size: impl Into<Vec2>
)

Draw a textured quad

pub fn texture_part(
    &mut self,
    texture: &Handle<Texture>,
    pos: impl Into<Vec2>,
    size: impl Into<Vec2>,
    part_pos: impl Into<Vec2>,
    part_size: impl Into<Vec2>
)

Draw a quad with part of a texture

Part is defined in pixels

pub fn text_width(&self, text: impl AsRef<str>) -> f32

Get text width for current font

pub fn text_height(&self, text: impl AsRef<str>) -> f32

Get text height for current font

pub fn push(&mut self)

Save target settings to stack

pub fn pop(&mut self)

Restore target settings from stack