gaclen 0.0.14

A library for handling anything a game client needs to do.
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

//! Currently **gaclen** simply uses `vulkano` images directly.

use super::device::Device;

use std::sync::Arc;

use vulkano::sync::GpuFuture;
use vulkano::format::{AcceptsPixels, FormatDesc};

pub use vulkano::format::{Format};
pub use vulkano::image::{AttachmentImage, Dimensions, ImmutableImage, ImageCreationError};
pub use vulkano::sampler::{BorderColor, Filter, Sampler, SamplerCreationError, SamplerAddressMode, MipmapMode};
pub use vulkano::pipeline::depth_stencil::Compare as CompareOp;

/// Create an [`ImmutableImage`](struct.ImmutableImage.html) from a data iterator.
/// 
/// Builds an intermediate memory-mapped buffer, writes data to it, builds a copy (upload) command buffer and executes it.
/// 
/// # Panic.
/// 
/// - Panics if fails to submit the copy command buffer.
pub fn create_immutable_image_from_iter<P, I, F>(device: &Device, data_iterator: I, dimensions: Dimensions, format: F)
-> Result<Arc<ImmutableImage<F>>, ImageCreationError>
where
	P : Send + Sync + Clone + 'static,
	F : FormatDesc + AcceptsPixels<P> + Send + Sync + 'static,
	I : ExactSizeIterator<Item = P>,
	Format: AcceptsPixels<P>,
{
	let (image, future) = ImmutableImage::from_iter(data_iterator, dimensions, format, device.transfer_queue.clone())?;

	// TODO: handle synchronization between separate queues in a performant way
	future.flush().unwrap();

	// let time: Box<dyn GpuFuture> = match self.before_frame.take() {
	// 	Some(time) => Box::new(time.join(future)),
	// 	None => Box::new(future),
	// };
	// self.before_frame = Some(time);

	Ok(image)
}