Expand description
Bones lib prelude
Re-exports§
pub use crate::Game;
pub use crate::GamePlugin;
pub use crate::Session;
pub use crate::SessionCommand;
pub use crate::SessionOptions;
pub use crate::SessionPlugin;
pub use crate::SessionRunner;
pub use crate::Sessions;
pub use crate::time::*;
Modules§
- Simple reflection system based on the
#[repr(C)]
memory layout. - This module contains types that can be used to implement atomic borrowing.
Macros§
- Shorthand for combining bitsets with bit_or.
- Shorthand for setting bits on the bitset container.
- Implements the
BitSet
trait members for your type throughDerefMut
.
Structs§
- A mutable memory location with dynamically checked borrow rules This type behaves mostly like
core::cell::RefCell
. The main difference is that this type uses atomic operations for borrowing. Thus allowing to use it in multi-threaded environment. - A handle to a resource from a
Resources
collection. - BitSet formatter.
- The type of bitsets used to track entities in component storages. Mostly used to create caches.
- Error thrown when a resource cell cannot be inserted because it already exists.
- A resource containing the
Commands
command queue. - A
SystemParam
that can be used to schedule systems that will be run at the end of the currentSystemStage
. - A typed wrapper around
UntypedComponentStore
. - A collection of
ComponentStore<T>
. - Resource that is automatically added to the world while a system stage is being run that specifies the unique ID of the stage that being run.
- Holds a list of alive entities.
- Iterator over entities returned by
Entities::iter_with
. - An entity index.
- Iterator over entities using the provided bitset.
- Helper for accessing the inner data of a schema ref at runtime.
- Helper for accessing the inner data of a schema ref at runtime.
- Schema data for an enum.
- A wrapper type that implements [
IntoIterator<Item = FieldIdx>
] for an inner string to make it easier to use withSchemaRefAccess::field_path()
and other field path methods. - The system input parameter.
- A
Ulid
with a human-readable ascii prefix. - Wrapper for the
Comp
SystemParam
used asQueryItem
to iterate over entities optionally retrieving components fromComponentStore
. Entities iterated over will not be filtered byOptionalQueryItem
. - Wrapper for the
CompMut
SystemParam
used asQueryItem
to iterate over entities optionally and mutably retrieving components fromComponentStore
. Entities iterated over will not be filtered byOptionalQueryItemMut
. - Wrapper for a borrowed
AtomicCell
that will released lock on drop. - Wrapper for mutably borrowed
AtomicCell
that will released lock on drop. SystemParam
for getting read access to a resource.SystemParam
for getting read access to a resource and initialzing it if it doesn’t already exist.SystemParam
for getting mutable access to a resource.SystemParam
for getting mutable access to a resource and initializing it if it doesn’t already exist.- A collection of resources.
- A typed version of
SchemaBox
. - Typed version of a
SchemaMap
. - A typed version of a
SchemaVec
. - A owning, type-erased
Box
-like container for types with a [Schema
]. - Schema information describing the memory layout of a type.
- Derivable schema
type_data
for types that implementDeserialize
. - A struct that implements
DeserializeSeed
and can be used to deserialize values matching a given [Schema
]. - Error returned when a field is not found in a schema.
- A unique identifier for a schema registered in the
SCHEMA_REGISTRY
. - Layout information computed for
SchemaData
. - Untyped schema-aware “HashMap”.
- Access helper for a
SchemaMap
. - Mutable
SchemaMap
access helper. - Error type when attempting to cast between types with mis-matched schemas.
- An untyped reference that knows the [
Schema
] of the pointee and that can be cast to a matching type. - An untyped mutable reference that knows the [
Schema
] of the pointee and that can be cast to a matching type. - A schema registry that alloates
SchemaId
s forSchemaData
s and returns a registered [&'static Schema
][Schema]. - A type-erased
Vec
-like collection that for items with the same [Schema
]. - Access helper for a
SchemaVec
. - Mutable
SchemaVec
access helper. - A collection of systems that will be run in order.
- Struct containing a static system.
- A field in a
StructSchemaInfo
. - Helper for accessing the inner data of a schema ref at runtime.
- Iterator for
StructRefAccess::fields()
. - A field returned by
StructRefFieldIter
. - Helper for accessing the inner data of a schema ref at runtime.
- Iterator for
StructRefAccess::fields()
. - A field returned by
StructRefFieldIter
. - Schema data for a struct.
- An ordered collection of
SystemStage
s. - A Ulid is a unique 128-bit lexicographically sortable identifier
- A wrapper struct that marks it unsafe to both create and access the inner value.
- Iterates over components using a provided bitset. Each time the bitset has a 1 in index i, the iterator will fetch data from the storage at index i and return it.
- Iterates over components using a provided bitset. Each time the bitset has a 1 in index i, the iterator will fetch data from the storage at index i.
- Iterate over component store returning
Option<SchemaRef<'a>>
, filtered by bitset of iterator, but not bitset of own ComponentStore. Returns None on bitset entries that do not have this Component. - Iterate mutably over component store returning
Option<SchemaRef<'a>>
, filtered by bitset of iterator, but not bitset of own ComponentStore. Returns None on bitset entries that do not have this Component. - Holds components of a given type indexed by
Entity
. - Mutable iterator over pointers in an untyped component store.
- Mutable iterator over pointers in an untyped component store.
- An untyped resource that may be inserted into
UntypedResources
. - Storage for un-typed resources.
- A handle representing a string in the global string cache.
- Information about an enum variant for
EnumSchemaInfo
.
Enums§
- A
StageLabel
for the 5 core stages. - A type for an enum tag for
EnumSchemaInfo
. - The index of a field in a struct in a [
Schema
]. - Error creating a
LabeledId
. - Errors that can happen while parsing a
LabeledId
. - A type of primitive.
- Helper for accessing the inner data of a schema ref at runtime.
- Helper for accessing the inner data of a schema ref at runtime.
- An error that may occur when querying for a single entity. For example, via
Entities::get_single_with
, or more directly withComponentStore::get_single_with_bitset
orComponentStore::get_single_mut_with_bitset
. - A schema describes the data layout of a type, to enable dynamic access to the type’s data through a pointer.
- Helper for accessing the inner data of a schema ref at runtime.
- Access a schema
Constants§
- A fast, non-cryptographic, thread-local random number generator powered by turborand.
Statics§
Traits§
- The BitSet API.
- This trait factors out functions for iterating with bitset over component store. Separated from
impl ComponentStore
for usage in generic trait types that must be able to createComponentBitsetIterator
and related types. - Trait implemented for types that can produce an instance of themselves from a Rust type.
- Creates an instance of the type this trait is implemented for using data from the supplied
World
. - This trait provides the means to easily generate all integer types, provided the main method underpinning this is implemented:
GenCore::gen
. Once implemented, the rest of the trait provides default implementations for generating all integer types, though it is not recommended to override these. - Trait implemented for types that have a [
Schema
]. - Converts a function into a
System
. - A type representing a component-joining entity query.
- Trait for things that may be used to identify a system stage.
- Trait implemented by systems.
- Trait used to implement parameters for
System
functions. - Trait for system stages. A stage is a
- Extension trait for automatically implementing all
TurboRand
methods, as long as the struct implements [TurboCore
] &GenCore
. All methods are provided as default implementations that build on top of [TurboCore
] andGenCore
, and thus are not recommended to be overridden, lest you potentially change the expected outcome of the methods. - Extension trait for
Ulid
. - Helper trait for unwraping each item in an array.
Functions§
- Helper func to construct a
OptionalQueryItem
wrapping aComp
SystemParam
. Used to iterate over enities optionally retrieving components fromComponentStore
. Entities iterated over will not be filtered by thisQueryItem
. - Helper func to construct a
OptionalQueryItemMut
wrapping aCompMut
SystemParam
. Used to iterate over enities optionally and mutably retrieving components fromComponentStore
. Entities iterated over will not be filtered by thisQueryItem
. - Creates a bitset big enough to contain the index of each entity. Mostly used to create caches.
- An ergonomic abbreviation for
Default::default()
to make initializing structs easier. This is especially helpful when combined with “struct update syntax”. - Shortens a type name to remove all module paths.
- Hints to the compiler that the branch condition is likely to be true. Returns the value passed to it.
- Hints to the compiler that the branch condition is unlikely to be true. Returns the value passed to it.
- Create a new Ustr from the given &str.
Type Aliases§
- An atomic component store.
- An untyped, atomic resource cell.
SystemParam
for getting read access to aComponentStore
.SystemParam
for getting mutable access to aComponentStore
.- Read-only iterator over components matching a given bitset
- Mutable iterator over components matching a given bitset
- Read-only iterator over components matching a given bitset. Returns None for entities matching bitset but not in this ComponentStore.
- Mutable iterator over components matching a given bitset. Returns None for entities matching bitset but not in this ComponentStore.
- A [
HashMap
][hashbrown::HashMap] implementing aHash, a high speed keyed hashing algorithm intended for use in in-memory hashmaps. - A [
HashSet
][hashbrown::HashSet] implementing aHash, a high speed keyed hashing algorithm intended for use in in-memory hashmaps. - An untyped atomic component store.
- A standard
HashMap
usingUstr
as the key type with a customHasher
that just uses the precomputed hash for speed instead of calculating it - A standard
HashSet
usingUstr
as the key type with a customHasher
that just uses the precomputed hash for speed instead of calculating it