klyff 0.1.2

Text rendering library for games with MSDF support
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68

mod material_encoder;
mod mesh_encoder;
mod pipeline;
mod screen_size_uniform;

pub use material_encoder::{GlyphMaterial, MaterialEncoder};
pub use mesh_encoder::MeshEncoder;
pub use pipeline::{MsdfTextPipeline, RasterizedTextPipeline};
pub use screen_size_uniform::ScreenSizeUniform;

use wgpu::util::DeviceExt as _;

use crate::TextureAtlas;

pub use crate::DecodedGlyph;

/// Resources borrowed during encoding.
///
/// This struct groups related dependencies that are commonly consumed by different functions and
/// methods.
pub struct EncoderContext<'a> {
    pub atlas: &'a mut TextureAtlas,
    pub device: &'a wgpu::Device,
    pub queue: &'a wgpu::Queue,
    pub cmd_encoder: &'a mut wgpu::CommandEncoder,
    pub font_system: &'a mut cosmic_text::FontSystem,
}

const DEFAULT_BUFFER_SIZE: u64 = 1024;

/// Uploads `data` into `buffer`, growing the buffer (and returning `true`) if needed.
fn upload_buf(
    device: &wgpu::Device,
    queue: &wgpu::Queue,
    buffer: &mut wgpu::Buffer,
    data: &[u8],
    usage: wgpu::BufferUsages,
    label: &str,
) -> bool {
    if data.is_empty() {
        return false;
    }
    let padded_len = data
        .len()
        .next_multiple_of(wgpu::COPY_BUFFER_ALIGNMENT as usize);

    if buffer.size() >= padded_len as u64 {
        queue.write_buffer(buffer, 0, data);
        return false;
    }

    *buffer = if padded_len == data.len() {
        device.create_buffer_init(&wgpu::util::BufferInitDescriptor {
            label: Some(label),
            contents: data,
            usage,
        })
    } else {
        let mut padded = data.to_vec();
        padded.resize(padded_len, 0u8);
        device.create_buffer_init(&wgpu::util::BufferInitDescriptor {
            label: Some(label),
            contents: &padded,
            usage,
        })
    };
    true
}