rafx-assets 0.0.16

Rendering framework built on an extensible asset pipeline
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
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

pub mod assets;

pub use assets::*;
use hydrate_pipeline::{AssetPlugin, AssetPluginSetupContext};
use std::sync::Arc;

mod asset_upload_queue;

mod asset_type_handler;
pub use asset_type_handler::*;

mod importer_image;
pub use importer_image::*;

#[cfg(feature = "basis-universal")]
mod importer_basis;
#[cfg(feature = "basis-universal")]
pub use importer_basis::*;

mod thumbnails;
pub use thumbnails::*;

#[cfg(feature = "ddsfile")]
mod importer_dds;
use crate::assets::image::builder_compressed_image::{
    GpuCompressedImageBuilder, GpuCompressedImageJobProcessor,
};
#[cfg(feature = "ddsfile")]
pub use importer_dds::*;

mod builder_compressed_image;

pub struct GpuImageAssetPlugin;

impl AssetPlugin for GpuImageAssetPlugin {
    fn setup(context: AssetPluginSetupContext) {
        // This demonstrates using filenames to hint default settings for images on import for normal
        // maps and roughness/metalness maps by using filenames. Otherwise, the user has to remember to
        // edit the .meta file.
        let pbr_map_suffix = vec!["_pbr."];
        let normal_map_suffix = vec!["_n."];

        // Default config
        let mut image_importer_config = ImageImporterConfig::new(ImageImporterRuleOptions {
            mip_generation: ImageAssetMipGeneration::Runtime,
            color_space: ImageAssetColorSpaceConfig::Srgb,
            data_format: ImageAssetDataFormatConfig::Uncompressed,
        });

        for suffix in normal_map_suffix {
            // Override for normal maps
            image_importer_config.add_filename_contains_override(
                suffix,
                ImageImporterRuleOptions {
                    mip_generation: ImageAssetMipGeneration::Runtime,
                    color_space: ImageAssetColorSpaceConfig::Linear,
                    data_format: ImageAssetDataFormatConfig::Uncompressed,
                },
            );
        }

        // Override for PBR masks (ao, roughness, metalness)
        for suffix in pbr_map_suffix {
            image_importer_config.add_filename_contains_override(
                suffix,
                ImageImporterRuleOptions {
                    mip_generation: ImageAssetMipGeneration::Runtime,
                    color_space: ImageAssetColorSpaceConfig::Linear,
                    data_format: ImageAssetDataFormatConfig::Uncompressed,
                },
            );
        }

        let image_importer_config = Arc::new(image_importer_config);

        context
            .importer_registry
            .register_handler_instance::<GpuImageImporterSimple>(GpuImageImporterSimple {
                image_importer_config,
            });
        context
            .builder_registry
            .register_handler::<GpuImageBuilder>();
        context
            .job_processor_registry
            .register_job_processor::<GpuImageJobProcessor>();

        #[cfg(feature = "ddsfile")]
        context
            .importer_registry
            .register_handler::<GpuCompressedImageImporterDds>();

        context
            .thumbnail_provider_registry
            .register_thumbnail_provider::<GpuCompressedImageThumbnailProvider>();

        #[cfg(feature = "basis-universal")]
        context
            .importer_registry
            .register_handler::<GpuCompressedImageImporterBasis>();

        context
            .builder_registry
            .register_handler::<GpuCompressedImageBuilder>();
        context
            .job_processor_registry
            .register_job_processor::<GpuCompressedImageJobProcessor>();

        context
            .thumbnail_provider_registry
            .register_thumbnail_provider::<GpuImageThumbnailProvider>();
    }
}