feat: example

Author: dsgallups

Cargo.toml

@@ -862,6 +862,19 @@ description = "Renders text to multiple windows with different scale factors usi
 category = "2D Rendering"
 wasm = true
 
+
+[[example]]
+name = "system_fonts"
+path = "examples/2d/system_fonts.rs"
+doc-scrape-examples = true
+
+[package.metadata.example.system_fonts]
+name = "System Fonts"
+description = "Uses a system font to display text"
+category = "2D Rendering"
+# Loading asset folders is not supported in Wasm, but required to create the atlas.
+wasm = false
+
 [[example]]
 name = "texture_atlas"
 path = "examples/2d/texture_atlas.rs"

examples/2d/system_fonts.rs

@@ -0,0 +1,44 @@
+//! Uses a system font to display text
+use bevy::prelude::*;
+
+fn main() {
+    App::new()
+        .add_plugins(DefaultPlugins)
+        .add_systems(Startup, setup)
+        .run();
+}
+
+fn setup(mut commands: Commands, mut fonts: ResMut<Assets<Font>>) {
+    commands.spawn(Camera2d);
+
+    let font = fonts.add(Font::System {
+        families: vec![
+            Family::Name("Liberation Sans".to_string()),
+            Family::Name("Ubuntu".to_string()),
+            Family::Name("Noto Sans".to_string()),
+        ],
+        weight: Weight::NORMAL,
+        stretch: Stretch::Normal,
+        style: Style::Normal,
+    });
+
+    commands.spawn((
+        Node {
+            width: percent(100.),
+            height: percent(100.),
+            display: Display::Flex,
+            padding: UiRect::all(px(20.)),
+            justify_content: JustifyContent::Center,
+            ..default()
+        },
+        children![(
+            Text::new("System Font UI Text"),
+            TextFont::default().with_font(font.clone()),
+        )],
+    ));
+
+    commands.spawn((
+        Text2d::new("System Font 2D Text"),
+        TextFont::default().with_font(font),
+    ));
+}

examples/README.md

@@ -128,6 +128,7 @@ Example | Description
 [Sprite Sheet](../examples/2d/sprite_sheet.rs) | Renders an animated sprite
 [Sprite Slice](../examples/2d/sprite_slice.rs) | Showcases slicing sprites into sections that can be scaled independently via the 9-patch technique
 [Sprite Tile](../examples/2d/sprite_tile.rs) | Renders a sprite tiled in a grid
+[System Fonts](../examples/2d/system_fonts.rs) | Uses a system font to display text
 [Text 2D](../examples/2d/text2d.rs) | Generates text in 2D
 [Texture Atlas](../examples/2d/texture_atlas.rs) | Generates a texture atlas (sprite sheet) from individual sprites
 [Tilemap Chunk](../examples/2d/tilemap_chunk.rs) | Renders a tilemap chunk