Struct basalt::BstOptions

source · [−]

pub struct BstOptions { /* private fields */ }

Expand description

Options for Basalt’s creation and operation.

Implementations

source

impl BstOptions

source

pub fn app_loop(self) -> Self

Configure Basalt to run in app mode. The swapchain will be managed by Basalt and all renderering to the swapchain will be done by Basalt. Additional rendering to the swapchain will be unavailable. This is useful for applications that are UI only.

source

pub fn use_exclusive_fullscreen(self, to: bool) -> Self

Enables the device extension required for exclusive fullscreen. Generally this extension is only present on Windows. Basalt will return an error upon creation if this feature isn’t supported. With this option enabled BasaltWindow::enable_fullscreen() will use exclusive fullscreen; otherwise, borderless window will be used.

Default: false

Notes

Basalt will return an Err if the extension is not present.

source

pub fn ignore_dpi(self, to: bool) -> Self

Ignore dpi hints provided by the platform.

Default: false

source

pub fn window_size(self, width: u32, height: u32) -> Self

Set the inner size of the window to be created

Default: 1920, 1080

source

pub fn title<T: AsRef<str>>(self, title: T) -> Self

Set the title of the window to be created

Default: "Basalt"

source

pub fn scale(self, to: f32) -> Self

Set the initial scale of the UI

Default: 1.0

Notes

This is independant of DPI Scaling.

source

pub fn msaa(self, to: BstMSAALevel) -> Self

Set the the amount of MSAA of the UI

Default: BstMSAALevel::Four

source

pub fn prefer_integrated_gpu(self) -> Self

Prefer integrated graphics if they are available

source

pub fn instance_ext_union(self, ext: &InstanceExtensions) -> Self

Add additional instance extensions

source

pub fn device_ext_union(self, ext: &DeviceExtensions) -> Self

Add additional device extensions

source

pub fn enable_validation(self) -> Self

Enables validation layer

Notes

Basalt will return an Err if the layer is not present or extension is not available.

source

pub fn with_features(self, features: VkFeatures) -> Self

Specifify a custom set of vulkan features. This should be used with basalt_required_vk_features() to ensure Basalt functions correctly. For example:

.with_features(
    Features {
        storage_buffer16_bit_access: true,
        .. basalt_required_vk_features()
    }
)

Default: basalt_required_vk_features()

source

pub fn composite_alpha(self, to: CompositeAlpha) -> Self

Set the composite alpha mode used when creating the swapchain. Only effective when using app loop.

Default: CompositeAlpha::Opaque

source

pub fn force_unix_backend_x11(self, to: bool) -> Self

Setting this to true, will set the environment variable WINIT_UNIX_BACKEND=x11 forcing winit to use x11 over wayland. It is recommended to set this to true if you intend to use Basalt::capture_cursor(). With winit on wayland, MouseMotion will not be emitted.

Default: false

source

pub fn imt_gpu_accelerated(self, to: bool) -> Self

Basalt uses ilmenite in the backend for text. Setting this option to true will allow ilmenite to use a gpu code path which will have some performance gain; however, this code path may be broken on some systems.

Default: true

source

pub fn imt_fill_quality(self, q: ImtFillQuality) -> Self

Basalt uses ilmenite in the backend for text. This option allows for modifying the fill quality (the amount of casted rays) that ilmenite will use.

Default: ImtFillQuality::Normal

source

pub fn imt_sample_quality(self, q: ImtSampleQuality) -> Self

Basalt uses ilmenite in the backend for text. This option allows for modifying the sample quality (the amount of samples in a subpixel) that ilmenite will use.

Default:: ImtSampleQuality::Normal

source