shade 0.0.5

Another graphics library
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

use std::collections::HashMap;
use crate::handle::Handle;

/// Trait for resources and their associated Handle type.
pub trait Resource {
	type Handle: Handle;
}

/// Generic resource map for OpenGL resources.
///
/// Maps handles to values, names to handles and manages the next available ID.
pub struct ResourceMap<T: Resource> {
	map: HashMap<<T::Handle as Handle>::Raw, T>,
	names: HashMap<String, <T::Handle as Handle>::Raw>,
	next: T::Handle,
}

impl<T: Resource> ResourceMap<T> {
	/// Creates a new resource map.
	pub fn new() -> ResourceMap<T> {
		ResourceMap {
			map: HashMap::new(),
			names: HashMap::new(),
			next: <T::Handle as Default>::default(),
		}
	}

	/// Inserts a new resource into the map and creates a handle.
	pub fn insert(&mut self, name: Option<&str>, resource: T) -> T::Handle {
		self.next = self.next.next();
		let raw = self.next.id();
		let id = <T::Handle as Handle>::create(raw);
		self.map.insert(raw, resource);
		if let Some(name) = name {
			self.names.insert(name.to_string(), raw);
		}
		id
	}

	/// Returns a reference to the resource with the given handle.
	pub fn get(&self, id: T::Handle) -> Option<&T> {
		let raw = <T::Handle as Handle>::id(&id);
		self.map.get(&raw)
	}

	/// Returns a mutable reference to the resource with the given handle.
	pub fn get_mut(&mut self, id: T::Handle) -> Option<&mut T> {
		let raw = <T::Handle as Handle>::id(&id);
		self.map.get_mut(&raw)
	}

	/// Finds a resource by name and returns its handle.
	pub fn find_id(&self, name: &str) -> Option<T::Handle> {
		self.names.get(name).map(|id| <T::Handle as Handle>::create(*id))
	}

	/// Removes a resource from the map and returns it.
	pub fn remove(&mut self, id: T::Handle) -> Option<T> {
		let raw = <T::Handle as Handle>::id(&id);
		self.map.remove(&raw)
	}
}