diff --git a/pr-preview/pr-494/CubosLogo.png b/pr-preview/pr-494/CubosLogo.png new file mode 100644 index 000000000..fd0cc2a08 Binary files /dev/null and b/pr-preview/pr-494/CubosLogo.png differ diff --git a/pr-preview/pr-494/aabb_8hpp.html b/pr-preview/pr-494/aabb_8hpp.html new file mode 100644 index 000000000..f167f0271 --- /dev/null +++ b/pr-preview/pr-494/aabb_8hpp.html @@ -0,0 +1,134 @@ + + + + + engine/collisions/aabb.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/collisions/aabb.hpp file +

+

Component cubos::engine::ColliderAABB.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::data
+
Data module.
+
+
+
+

Classes

+
+
+ struct cubos::engine::ColliderAABB +
+
Component which stores the AABB of an entity with a collider component.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/accessors_8hpp.html b/pr-preview/pr-494/accessors_8hpp.html new file mode 100644 index 000000000..33d292623 --- /dev/null +++ b/pr-preview/pr-494/accessors_8hpp.html @@ -0,0 +1,148 @@ + + + + + core/ecs/accessors.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/accessors.hpp file +

+

Class cubos::core::ecs::Read and related types.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
+
+
+

Classes

+
+
+
template<typename T>
+ class cubos::core::ecs::Read +
+
System argument which provides read access to the resource T, or query argument which provides read access to the component T.
+
+
template<typename T>
+ class cubos::core::ecs::Write +
+
System argument which provides write access to the resource T, or query argument which provides write access to the component T.
+
+
template<typename T>
+ class cubos::core::ecs::OptRead +
+
System argument which provides read access to the resource T if it exists, or query argument which provides read access to the component T if it exists.
+
+
template<typename T>
+ class cubos::core::ecs::OptWrite +
+
System argument which provides write access to the resource T if it exists, or query argument which provides write access to the component T if it exists.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/action_8hpp.html b/pr-preview/pr-494/action_8hpp.html new file mode 100644 index 000000000..5b630a583 --- /dev/null +++ b/pr-preview/pr-494/action_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/input/action.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/input/action.hpp file +

+

Class cubos::engine::InputAction.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::InputAction +
+
Stores the state of a single input action, such as "jump" or "attack".
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/annotated.html b/pr-preview/pr-494/annotated.html new file mode 100644 index 000000000..d31277e67 --- /dev/null +++ b/pr-preview/pr-494/annotated.html @@ -0,0 +1,498 @@ + + + + + CUBOS. + + + + + + + +
+
+
+
+
+

Classes

+
    +
  • + namespace cubos CUBOS. libraries namespace. +
      + + +
    +
    • +
  • struct MyAsset A simple serializable type which we will be saving and loading.
    • +
  • class TextBridge
    • +
+ +
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/archive_8hpp.html b/pr-preview/pr-494/archive_8hpp.html new file mode 100644 index 000000000..ed49773aa --- /dev/null +++ b/pr-preview/pr-494/archive_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/data/fs/archive.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/data/fs/archive.hpp file +

+

Class cubos::core::data::Archive.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::data
+
Data module.
+
+
+
+

Classes

+
+
+ class cubos::core::data::Archive +
+
Interface for a bridge between the CUBOS. virtual file system and the real world.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/asset_8hpp.html b/pr-preview/pr-494/asset_8hpp.html new file mode 100644 index 000000000..361fa7582 --- /dev/null +++ b/pr-preview/pr-494/asset_8hpp.html @@ -0,0 +1,139 @@ + + + + + engine/assets/asset.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/assets/asset.hpp file +

+

Classes cubos::engine::AnyAsset and cubos::engine::Asset.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::data
+
Data module.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::AnyAsset +
+
Handle to an asset of any type. May either be weak or strong. Weak handles do not guarantee the asset is loaded, while strong handles do.
+
+
template<typename T>
+ class cubos::engine::Asset +
+
Handle to an asset of a specific type.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/assets_2bridge_8hpp.html b/pr-preview/pr-494/assets_2bridge_8hpp.html new file mode 100644 index 000000000..32733210e --- /dev/null +++ b/pr-preview/pr-494/assets_2bridge_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/assets/bridge.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/assets/bridge.hpp file +

+

Class cubos::engine::AssetBridge.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::AssetBridge +
+
Bridges are the objects responsible for loading and saving assets from/to disk. They form the bridge between the asset manager and the virtual file system.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/assets_2plugin_8hpp.html b/pr-preview/pr-494/assets_2plugin_8hpp.html new file mode 100644 index 000000000..c7016afa3 --- /dev/null +++ b/pr-preview/pr-494/assets_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/assets/plugin.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/assets/plugin.hpp file +

+

Plugin entry point.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Functions

+
+
+ void assetsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/assets_8hpp.html b/pr-preview/pr-494/assets_8hpp.html new file mode 100644 index 000000000..64b26c639 --- /dev/null +++ b/pr-preview/pr-494/assets_8hpp.html @@ -0,0 +1,154 @@ + + + + + engine/assets/assets.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/assets/assets.hpp file +

+

Resource cubos::engine::Assets.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::Assets +
+
Resource which manages all assets. Responsible for loading and unloading assets, storing them in memory, and providing access to them.
+
+
+
+

Typedefs

+
+
+ using AssetMetaRead = core::memory::ReadGuard<AssetMeta, std::shared_lock<std::shared_mutex>> +
+
Read-only guard for an asset's metadata.
+
+ using AssetMetaWrite = core::memory::WriteGuard<AssetMeta, std::unique_lock<std::shared_mutex>> +
+
Read-write guard for an asset's metadata.
+
+
template<typename T>
+ using AssetRead = core::memory::ReadGuard<T, std::shared_lock<std::shared_mutex>> +
+
Read-only guard for an asset's data.
+
+
template<typename T>
+ using AssetWrite = core::memory::WriteGuard<T, std::unique_lock<std::shared_mutex>> +
+
Read-write guard for an asset's data.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/audio__device_8hpp.html b/pr-preview/pr-494/audio__device_8hpp.html new file mode 100644 index 000000000..35ef6a93a --- /dev/null +++ b/pr-preview/pr-494/audio__device_8hpp.html @@ -0,0 +1,169 @@ + + + + + core/al/audio_device.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/al/audio_device.hpp file +

+

Class cubos::core::al::AudioDevice and related types.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::al
+
Audio module.
+
namespace cubos::core::al::impl
+
Namespace to store the abstract types implemented by the audio device implementations.
+
+
+
+

Classes

+
+
+ class cubos::core::al::AudioDevice +
+
Audio device interface used to wrap low-level audio rendering APIs.
+
+ class cubos::core::al::impl::Buffer +
+
Abstract audio buffer.
+
+ class cubos::core::al::impl::Source +
+
Abstract audio source.
+
+
+
+

Enums

+
+
+ enum class Format { Mono8, + Mono16, + Stereo8, + Stereo16 } +
+
Possible audio formats.
+
+
+
+

Typedefs

+
+
+ using Buffer = std::shared_ptr<impl::Buffer> +
+
Handle to an audio buffer.
+
+ using Source = std::shared_ptr<impl::Source> +
+
Handle to an audio source.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/axis_8hpp.html b/pr-preview/pr-494/axis_8hpp.html new file mode 100644 index 000000000..9bc9907b6 --- /dev/null +++ b/pr-preview/pr-494/axis_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/input/axis.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/input/axis.hpp file +

+

Class cubos::engine::InputAxis.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::InputAxis +
+
Stores the state of a single input axis, such as "move forward" or "move right".
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/binary_8hpp.html b/pr-preview/pr-494/binary_8hpp.html new file mode 100644 index 000000000..6779e5292 --- /dev/null +++ b/pr-preview/pr-494/binary_8hpp.html @@ -0,0 +1,131 @@ + + + + + engine/assets/bridges/binary.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/assets/bridges/binary.hpp file +

+

Class cubos::engine::BinaryBridge.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+
template<typename T>
+ class cubos::engine::BinaryBridge +
+
Bridge for loading and saving assets which are serialized to and from a binary file.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/bindings_8hpp.html b/pr-preview/pr-494/bindings_8hpp.html new file mode 100644 index 000000000..378747964 --- /dev/null +++ b/pr-preview/pr-494/bindings_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/input/bindings.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/input/bindings.hpp file +

+

Class cubos::engine::InputBindings.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::InputBindings +
+
Stores the input bindings for a single player.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/bloom_8hpp.html b/pr-preview/pr-494/bloom_8hpp.html new file mode 100644 index 000000000..bc4dc23f4 --- /dev/null +++ b/pr-preview/pr-494/bloom_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/renderer/pps/bloom.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/renderer/pps/bloom.hpp file +

+

Post processing pass implementation cubos::engine::PostProcessingBloom.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::PostProcessingBloom +
+
A post processing pass that adds a "bloom" effect to any bright objects in the scene.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/blueprint_8hpp.html b/pr-preview/pr-494/blueprint_8hpp.html new file mode 100644 index 000000000..a2cf79882 --- /dev/null +++ b/pr-preview/pr-494/blueprint_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/ecs/blueprint.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/blueprint.hpp file +

+

Class cubos::core::ecs::Blueprint.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
+
+
+

Classes

+
+
+ class cubos::core::ecs::Blueprint +
+
Stores a bundle of entities and their respective components, which can be easily spawned into a world. This is in a way the 'Prefab' of CUBOS., but lower level.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/broad__phase__collisions_8hpp.html b/pr-preview/pr-494/broad__phase__collisions_8hpp.html new file mode 100644 index 000000000..d4e1974be --- /dev/null +++ b/pr-preview/pr-494/broad__phase__collisions_8hpp.html @@ -0,0 +1,138 @@ + + + + + engine/collisions/broad_phase_collisions.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/collisions/broad_phase_collisions.hpp file +

+

Resource cubos::engine::BroadPhaseCollisions.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ struct cubos::engine::BroadPhaseCollisions +
+
Resource which stores data used in broad phase collision detection.
+
+ struct cubos::engine::BroadPhaseCollisions::CandidateHash +
+
Hash function to allow Candidates to be used as keys in an unordered_set.
+
+ struct cubos::engine::BroadPhaseCollisions::SweepMarker +
+
Marker used for sweep and prune.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/buffer__stream_8hpp.html b/pr-preview/pr-494/buffer__stream_8hpp.html new file mode 100644 index 000000000..5a88913d4 --- /dev/null +++ b/pr-preview/pr-494/buffer__stream_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/memory/buffer_stream.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/memory/buffer_stream.hpp file +

+

Class cubos::core::memory::BufferStream.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::memory
+
Memory module.
+
+
+
+

Classes

+
+
+ class cubos::core::memory::BufferStream +
+
Stream implementation which writes to/reads from a buffer.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/camera_8hpp.html b/pr-preview/pr-494/camera_8hpp.html new file mode 100644 index 000000000..360ce5242 --- /dev/null +++ b/pr-preview/pr-494/camera_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/gl/camera.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/gl/camera.hpp file +

+

Class cubos::core::gl::Camera.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::gl
+
Graphics module.
+
+
+
+

Classes

+
+
+ struct cubos::core::gl::Camera +
+
Describes a camera.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classTextBridge.html b/pr-preview/pr-494/classTextBridge.html new file mode 100644 index 000000000..ffa207759 --- /dev/null +++ b/pr-preview/pr-494/classTextBridge.html @@ -0,0 +1,208 @@ + + + + + TextBridge class | CUBOS. + + + + + + + +
+
+
+
+
+

+ TextBridge class +
#include <assets/bridge/main.cpp>
+

+ +

This bridge inherits from the FileBridge, since it will be loading/saving assets from/to single files.

+
+

Base classes

+
+
+ class cubos::engine::FileBridge +
+
Abstract bridge type defined to reduce boilerplate code in bridge implementations which open a single file to load and save assets.
+
+
+
+

Public functions

+
+
+ auto loadFromFile(Assets& assets, + const AnyAsset& handle, + Stream& stream) -> bool override +
+
Loads an asset from a file stream.
+
+ auto saveToFile(const Assets& assets, + const AnyAsset& handle, + Stream& stream) -> bool override +
+
Saves an asset to a file stream.
+
+
+
+

Function documentation

+
+

+ bool TextBridge::loadFromFile(Assets& assets, + const AnyAsset& handle, + Stream& stream) override +

+

Loads an asset from a file stream.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to write into.
handleHandle of the asset being loaded.
streamFile stream.
ReturnsWhether the asset was successfully loaded.
+
+
+

+ bool TextBridge::saveToFile(const Assets& assets, + const AnyAsset& handle, + Stream& stream) override +

+

Saves an asset to a file stream.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to read from.
handleHandle of the asset being saved.
streamFile stream.
ReturnsWhether the asset was successfully saved.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1Settings.html b/pr-preview/pr-494/classcubos_1_1core_1_1Settings.html new file mode 100644 index 000000000..914c5061f --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1Settings.html @@ -0,0 +1,434 @@ + + + + + cubos::core::Settings class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::Settings class final +
#include <core/settings.hpp>
+

+

Stores settings as key-value pairs and provides methods to retrieve them.

+ +
+

Public functions

+
+
+ void clear() +
+
Clears all the settings.
+
+ void setBool(const std::string& key, + const bool& value) +
+
Defines a new boolean setting.
+
+ auto getBool(const std::string& key, + const bool& defaultValue) const -> bool +
+
Retrieves the bool setting with the given key.
+
+ void setString(const std::string& key, + const std::string& value) +
+
Defines a new string setting.
+
+ auto getString(const std::string& key, + const std::string& defaultValue) const -> std::string +
+
Retrieves the string setting with the given key.
+
+ void setInteger(const std::string& key, + int value) +
+
Defines a new integer setting.
+
+ auto getInteger(const std::string& key, + int defaultValue) const -> int +
+
Retrieves the integer setting with the given key.
+
+ void setDouble(const std::string& key, + double value) +
+
Defines a new double setting.
+
+ auto getDouble(const std::string& key, + double defaultValue) const -> double +
+
Retrieves the double setting with the given key.
+
+ void merge(const Settings& settingsToMerge) +
+
Merges the settings from settingsToMerge.
+
+ auto getValues() const -> const std::unordered_map<std::string, std::string>& +
+
+
+ auto getValues() -> std::unordered_map<std::string, std::string>& +
+
+
+
+
+

Function documentation

+
+

+ void cubos::core::Settings::setBool(const std::string& key, + const bool& value) +

+

Defines a new boolean setting.

+ + + + + + + + + + + + + + +
Parameters
keyKey.
valueValue.
+

If the setting already exists, overwrites its value.

+
+
+

+ bool cubos::core::Settings::getBool(const std::string& key, + const bool& defaultValue) const +

+

Retrieves the bool setting with the given key.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
keyKey.
defaultValueDefault value.
ReturnsCurrent value.
+

If no setting exists with such key, returns defaultValue. If the setting exists but its value is not "true", returns false.

+
+
+

+ void cubos::core::Settings::setString(const std::string& key, + const std::string& value) +

+

Defines a new string setting.

+ + + + + + + + + + + + + + +
Parameters
keyKey.
valueValue.
+

If the setting already exists, overwrites its value.

+
+
+

+ std::string cubos::core::Settings::getString(const std::string& key, + const std::string& defaultValue) const +

+

Retrieves the string setting with the given key.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
keyKey.
defaultValueDefault value.
ReturnsCurrent value.
+

If no setting exists with such key, returns defaultValue.

+
+
+

+ void cubos::core::Settings::setInteger(const std::string& key, + int value) +

+

Defines a new integer setting.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
keyKey.
valueValue.
ReturnsCurrent value.
+

If the setting already exists, overwrites its value.

+
+
+

+ int cubos::core::Settings::getInteger(const std::string& key, + int defaultValue) const +

+

Retrieves the integer setting with the given key.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
keyKey.
defaultValueDefault value.
ReturnsCurrent value.
+

If no setting exists with such key, returns defaultValue. If the setting exists but its value is not a valid integer, returns defaultValue.

+
+
+

+ void cubos::core::Settings::setDouble(const std::string& key, + double value) +

+

Defines a new double setting.

+ + + + + + + + + + + + + + +
Parameters
keyKey.
valueValue.
+

If the setting already exists, overwrites its value.

+
+
+

+ double cubos::core::Settings::getDouble(const std::string& key, + double defaultValue) const +

+

Retrieves the double setting with the given key.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
keyKey.
defaultValueDefault value.
ReturnsCurrent value.
+

If no setting exists with such key, returns the default value. If the setting exists but its value is not a valid double, returns the default value.

+
+
+

+ void cubos::core::Settings::merge(const Settings& settingsToMerge) +

+

Merges the settings from settingsToMerge.

+ + + + + + + + + + +
Parameters
settingsToMergeSettings to be merged to this instance.
+

If a setting from settingsToMerge is already defined in this instance, its value is overwritten.

+
+
+

+ const std::unordered_map<std::string, std::string>& cubos::core::Settings::getValues() const +

+ + + + + + + +
ReturnsUnderlying std::unordered_map with the settings.
+
+
+

+ std::unordered_map<std::string, std::string>& cubos::core::Settings::getValues() +

+ + + + + + + +
ReturnsUnderlying std::unordered_map with the settings.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ThreadPool.html b/pr-preview/pr-494/classcubos_1_1core_1_1ThreadPool.html new file mode 100644 index 000000000..8c9dc5c64 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ThreadPool.html @@ -0,0 +1,181 @@ + + + + + cubos::core::ThreadPool class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ThreadPool class final +
#include <core/thread_pool.hpp>
+

+

Manages a pool of threads, to which tasks can be submitted.

+ + +
+

Constructors, destructors, conversion operators

+
+
+ ThreadPool(std::size_t numThreads) +
+
Constructs a pool with numThreads, starting them immediately.
+
+ ThreadPool(const ThreadPool&) deleted +
+
Forbid copy construction.
+
+ ThreadPool(ThreadPool&&) deleted +
+
Forbid move construction.
+
+
+
+

Public functions

+
+
+ void addTask(std::function<void()> task) +
+
Adds a task to the thread pool. Starts when a thread becomes available.
+
+ void wait() +
+
Blocks until all tasks finish.
+
+
+
+

Function documentation

+
+

+ cubos::core::ThreadPool::ThreadPool(std::size_t numThreads) +

+

Constructs a pool with numThreads, starting them immediately.

+ + + + + + + + + + +
Parameters
numThreadsNumber of threads to create.
+
+
+

+ void cubos::core::ThreadPool::addTask(std::function<void()> task) +

+

Adds a task to the thread pool. Starts when a thread becomes available.

+ + + + + + + + + + +
Parameters
taskTask to add.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1al_1_1AudioDevice.html b/pr-preview/pr-494/classcubos_1_1core_1_1al_1_1AudioDevice.html new file mode 100644 index 000000000..f2f287c75 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1al_1_1AudioDevice.html @@ -0,0 +1,290 @@ + + + + + cubos::core::al::AudioDevice class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::al::AudioDevice class +
#include <core/al/audio_device.hpp>
+

+

Audio device interface used to wrap low-level audio rendering APIs.

+ +
+

Public static functions

+
+
+ static auto create(const std::string& specifier = "") -> std::shared_ptr<AudioDevice> +
+
Creates an audio device from a given device specifier.
+
+ static void enumerateDevices(std::vector<std::string>& devices) +
+
Enumerates the available devices.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ AudioDevice(const AudioDevice&) deleted +
+
Forbid copy construction.
+
+
+
+

Public functions

+
+
+ auto createBuffer() -> Buffer pure virtual +
+
Creates a new audio buffer.
+
+ auto createSource() -> Source pure virtual +
+
Creates a new audio source.
+
+ void setListenerPosition(const glm::vec3& position) pure virtual +
+
Sets the position of the listener.
+
+ void setListenerOrientation(const glm::vec3& forward, + const glm::vec3& up) pure virtual +
+
Sets the orientation of the listener.
+
+ void setListenerVelocity(const glm::vec3& velocity) pure virtual +
+
Sets the velocity of the listener. Used to implement the doppler effect.
+
+
+
+

Function documentation

+
+

+ static std::shared_ptr<AudioDevice> cubos::core::al::AudioDevice::create(const std::string& specifier = "") +

+

Creates an audio device from a given device specifier.

+ + + + + + + + + + + + + + + + +
Parameters
specifierDevice specifier (empty for default).
ReturnsAudio device, or nullptr on failure.
+ +
+
+

+ static void cubos::core::al::AudioDevice::enumerateDevices(std::vector<std::string>& devices) +

+

Enumerates the available devices.

+ + + + + + + + + + +
Parameters
devices outVector to fill with the available devices.
+
+
+

+ Buffer cubos::core::al::AudioDevice::createBuffer() pure virtual +

+

Creates a new audio buffer.

+ + + + + + + +
ReturnsHandle of the new buffer.
+
+
+

+ Source cubos::core::al::AudioDevice::createSource() pure virtual +

+

Creates a new audio source.

+ + + + + + + +
ReturnsHandle of the new source.
+
+
+

+ void cubos::core::al::AudioDevice::setListenerPosition(const glm::vec3& position) pure virtual +

+

Sets the position of the listener.

+ + + + + + + + + + +
Parameters
positionPosition.
+
+
+

+ void cubos::core::al::AudioDevice::setListenerOrientation(const glm::vec3& forward, + const glm::vec3& up) pure virtual +

+

Sets the orientation of the listener.

+ + + + + + + + + + + + + + +
Parameters
forwardForward direction of the listener.
upUp direction of the listener.
+
+
+

+ void cubos::core::al::AudioDevice::setListenerVelocity(const glm::vec3& velocity) pure virtual +

+

Sets the velocity of the listener. Used to implement the doppler effect.

+ + + + + + + + + + +
Parameters
velocityVelocity of the listener.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1al_1_1impl_1_1Buffer.html b/pr-preview/pr-494/classcubos_1_1core_1_1al_1_1impl_1_1Buffer.html new file mode 100644 index 000000000..631f83fda --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1al_1_1impl_1_1Buffer.html @@ -0,0 +1,159 @@ + + + + + cubos::core::al::impl::Buffer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::al::impl::Buffer class +
#include <core/al/audio_device.hpp>
+

+

Abstract audio buffer.

+ +
+

Public functions

+
+
+ void fill(Format format, + std::size_t size, + const void* data, + std::size_t frequency) pure virtual +
+
Fills the buffer with data.
+
+
+
+

Function documentation

+
+

+ void cubos::core::al::impl::Buffer::fill(Format format, + std::size_t size, + const void* data, + std::size_t frequency) pure virtual +

+

Fills the buffer with data.

+ + + + + + + + + + + + + + + + + + + + + + +
Parameters
formatAudio format of the data.
sizeSize of the buffer in bytes.
dataBuffer data.
frequencyAudio frequency.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1al_1_1impl_1_1Source.html b/pr-preview/pr-494/classcubos_1_1core_1_1al_1_1impl_1_1Source.html new file mode 100644 index 000000000..cc30314f4 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1al_1_1impl_1_1Source.html @@ -0,0 +1,377 @@ + + + + + cubos::core::al::impl::Source class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::al::impl::Source class +
#include <core/al/audio_device.hpp>
+

+

Abstract audio source.

+ +
+

Public functions

+
+
+ void setBuffer(std::shared_ptr<Buffer> buffer) pure virtual +
+
Sets the buffer to be played by the source.
+
+ void setPosition(const glm::vec3& position) pure virtual +
+
Sets the position of the source, by default, in the world space.
+
+ void setVelocity(const glm::vec3& velocity) pure virtual +
+
Sets the velocity of the source, by default, in the world space.
+
+ void setGain(float gain) pure virtual +
+
Sets the gain of the source.
+
+ void setPitch(float pitch) pure virtual +
+
Sets the pitch of the source.
+
+ void setLooping(bool looping) pure virtual +
+
Sets whether the source plays in a loop.
+
+ void setRelative(bool relative) pure virtual +
+
Sets whether the source position and velocity is relative to the listener or not.
+
+ void setDistance(float maxDistance) pure virtual +
+
Sets the maximum distance at which the source is audible.
+
+ void setConeAngle(float coneAngle) pure virtual +
+
Sets the cone angle of the source, in degrees. By default, 360.
+
+ void setConeGain(float coneGain) pure virtual +
+
Sets the cone gain of the source.
+
+ void setConeDirection(const glm::vec3& direction) pure virtual +
+
Sets the cone direction of the source.
+
+ void setReferenceDistance(float referenceDistance) pure virtual +
+
Sets the distance under which the volume for the source would normally drop by half.
+
+ void play() pure virtual +
+
Plays the source.
+
+
+
+

Function documentation

+
+

+ void cubos::core::al::impl::Source::setBuffer(std::shared_ptr<Buffer> buffer) pure virtual +

+

Sets the buffer to be played by the source.

+ + + + + + + + + + +
Parameters
bufferBuffer.
+
+
+

+ void cubos::core::al::impl::Source::setPosition(const glm::vec3& position) pure virtual +

+

Sets the position of the source, by default, in the world space.

+ + + + + + + + + + +
Parameters
positionPosition.
+ +
+
+

+ void cubos::core::al::impl::Source::setVelocity(const glm::vec3& velocity) pure virtual +

+

Sets the velocity of the source, by default, in the world space.

+ + + + + + + + + + +
Parameters
velocityVelocity.
+
+
+

+ void cubos::core::al::impl::Source::setGain(float gain) pure virtual +

+

Sets the gain of the source.

+ + + + + + + + + + +
Parameters
gainGain.
+
+
+

+ void cubos::core::al::impl::Source::setPitch(float pitch) pure virtual +

+

Sets the pitch of the source.

+ + + + + + + + + + +
Parameters
pitchPitch.
+
+
+

+ void cubos::core::al::impl::Source::setLooping(bool looping) pure virtual +

+

Sets whether the source plays in a loop.

+ + + + + + + + + + +
Parameters
loopingLooping flag.
+
+
+

+ void cubos::core::al::impl::Source::setRelative(bool relative) pure virtual +

+

Sets whether the source position and velocity is relative to the listener or not.

+ + + + + + + + + + +
Parameters
relativeRelative flag.
+
+
+

+ void cubos::core::al::impl::Source::setDistance(float maxDistance) pure virtual +

+

Sets the maximum distance at which the source is audible.

+ + + + + + + + + + +
Parameters
maxDistanceMaximum distance.
+
+
+

+ void cubos::core::al::impl::Source::setConeAngle(float coneAngle) pure virtual +

+

Sets the cone angle of the source, in degrees. By default, 360.

+ + + + + + + + + + +
Parameters
coneAngleAngle, in degrees.
+
+
+

+ void cubos::core::al::impl::Source::setConeGain(float coneGain) pure virtual +

+

Sets the cone gain of the source.

+ + + + + + + + + + +
Parameters
coneGainGain.
+
+
+

+ void cubos::core::al::impl::Source::setConeDirection(const glm::vec3& direction) pure virtual +

+

Sets the cone direction of the source.

+ + + + + + + + + + +
Parameters
directionDirection.
+
+
+

+ void cubos::core::al::impl::Source::setReferenceDistance(float referenceDistance) pure virtual +

+

Sets the distance under which the volume for the source would normally drop by half.

+ + + + + + + + + + +
Parameters
referenceDistanceDistance.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Archive.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Archive.html new file mode 100644 index 000000000..0dd525580 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Archive.html @@ -0,0 +1,396 @@ + + + + + cubos::core::data::Archive class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::Archive class +
#include <core/data/fs/archive.hpp>
+

+

Interface for a bridge between the CUBOS. virtual file system and the real world.

+ +

By real world, we mean something such as a file on the OS file system or a network connection. The archive is responsible for creating and destroying files, supplying streams for reading and writing, and retrieving information about existing files.

Each file in an archive is represented by a unique integer identifier. The identifier 0 is reserved for errors, and the identifier 1 is reserved for the root file of the archive.

The root file may be a directory or a regular file. If its a directory, when mounted, the archive will take the form of a directory, with the root file being placed on the mount point. If the root file is a regular file, then the mount point will be a regular file.

This class is not meant to be thread-safe - it is the responsibility of the File class to ensure that the same file is not accessed or modified by multiple threads at the same time.

Implementations should crash when called with invalid arguments - since they're only called by File, its okay to assume the arguments are correct (please do use asserts though).

+
+

Derived classes

+
+
+ class EmbeddedArchive +
+
Archive implementation which reads data embedded in the application. Meant to be used with the quadrados embed tool.
+
+ class StandardArchive +
+
Archive implementation which reads and writes from/into the OS file system using the standard library.
+
+
+
+

Public functions

+
+
+ auto create(std::size_t parent, + std::string_view name, + bool directory = false) -> std::size_t pure virtual +
+
Creates a new file in the archive.
+
+ auto destroy(std::size_t id) -> bool pure virtual +
+
Destroys a regular file or empty directory in the archive.
+
+ auto name(std::size_t id) const -> std::string pure virtual +
+
Gets the name of the file with the given id.
+
+ auto directory(std::size_t id) const -> bool pure virtual +
+
Checks whether the file with the given id is a directory.
+
+ auto readOnly() const -> bool pure virtual +
+
Checks whether the archive is read-only.
+
+ auto parent(std::size_t id) const -> std::size_t pure virtual +
+
Gets the identifier of the parent file of the file with the given id.
+
+ auto sibling(std::size_t id) const -> std::size_t pure virtual +
+
Gets the identifier of the sibling of the file with the given id.
+
+ auto child(std::size_t id) const -> std::size_t pure virtual +
+
Gets the identifier of the first child of the file with the given id.
+
+ auto open(std::size_t id, + File::Handle handle, + File::OpenMode mode) -> std::unique_ptr<memory::Stream> pure virtual +
+
Opens a file in the archive.
+
+
+
+

Function documentation

+
+

+ std::size_t cubos::core::data::Archive::create(std::size_t parent, + std::string_view name, + bool directory = false) pure virtual +

+

Creates a new file in the archive.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
parentParent directory of the new file.
nameName of the new file.
directoryWhether the new file is a directory or not.
ReturnsIdentifier of the file, or 0 if the file could not be created.
+

The first child of the parent will have its sibling set to the new file and then be replaced by the new file.

+
+
+

+ bool cubos::core::data::Archive::destroy(std::size_t id) pure virtual +

+

Destroys a regular file or empty directory in the archive.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsWhether the file was destroyed successfully.
+

Will be replaced in the tree by its sibling.

+
+
+

+ std::string cubos::core::data::Archive::name(std::size_t id) const pure virtual +

+

Gets the name of the file with the given id.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsName of the file.
+
+
+

+ bool cubos::core::data::Archive::directory(std::size_t id) const pure virtual +

+

Checks whether the file with the given id is a directory.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsWhether the file is a directory or not.
+
+
+

+ bool cubos::core::data::Archive::readOnly() const pure virtual +

+

Checks whether the archive is read-only.

+ + + + + + + +
ReturnsWhether the archive is read-only.
+
+
+

+ std::size_t cubos::core::data::Archive::parent(std::size_t id) const pure virtual +

+

Gets the identifier of the parent file of the file with the given id.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsIdentifier of the parent file, or 0 if the file is the root file.
+
+
+

+ std::size_t cubos::core::data::Archive::sibling(std::size_t id) const pure virtual +

+

Gets the identifier of the sibling of the file with the given id.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsIdentifier of the sibling, or 0 if there are no more files in the parent.
+
+
+

+ std::size_t cubos::core::data::Archive::child(std::size_t id) const pure virtual +

+

Gets the identifier of the first child of the file with the given id.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsIdentifier of the first child, or 0 if the file is not a directory or is empty.
+
+
+

+ std::unique_ptr<memory::Stream> cubos::core::data::Archive::open(std::size_t id, + File::Handle handle, + File::OpenMode mode) pure virtual +

+

Opens a file in the archive.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
handleHandle to the file.
modeMode to open the file in.
ReturnsFile stream, or nullptr if the file could not be opened.
+

Although a bit hacky, the handle parameter is used to keep a reference to the respective File alive, preventing the file from being destroyed while the stream is open.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1BinaryDeserializer.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1BinaryDeserializer.html new file mode 100644 index 000000000..52a1d8698 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1BinaryDeserializer.html @@ -0,0 +1,489 @@ + + + + + cubos::core::data::BinaryDeserializer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::BinaryDeserializer class +

+ +

Implementation of the abstract Deserializer class for deserializing from raw binary data. This class allows data to be deserialized from both little and big endian formats.

+
+

Base classes

+
+
+ class Deserializer +
+
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ BinaryDeserializer(memory::Stream& stream, + bool readLittleEndian = true) +
+
+
+
+
+

Public functions

+
+
+ void readI8(int8_t& value) override +
+
+
+ void readI16(int16_t& value) override +
+
+
+ void readI32(int32_t& value) override +
+
+
+ void readI64(int64_t& value) override +
+
+
+ void readU8(uint8_t& value) override +
+
+
+ void readU16(uint16_t& value) override +
+
+
+ void readU32(uint32_t& value) override +
+
+
+ void readU64(uint64_t& value) override +
+
+
+ void readF32(float& value) override +
+
+
+ void readF64(double& value) override +
+
+
+ void readBool(bool& value) override +
+
+
+ void readString(std::string& value) override +
+
+
+ void beginObject() override +
+
+
+ void endObject() override +
+
+
+ auto beginArray() -> std::size_t override +
+
+
+ void endArray() override +
+
+
+ auto beginDictionary() -> std::size_t override +
+
+
+ void endDictionary() override +
+
+
+
+
+

Function documentation

+
+

+ cubos::core::data::BinaryDeserializer::BinaryDeserializer(memory::Stream& stream, + bool readLittleEndian = true) +

+ + + + + + + + + + + + + + +
Parameters
streamThe stream to deserialize from.
readLittleEndianIf true, the data will be read in little endian format (big endian otherwise).
+
+
+

+ void cubos::core::data::BinaryDeserializer::readI8(int8_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 8 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::BinaryDeserializer::readI16(int16_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 16 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::BinaryDeserializer::readI32(int32_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 32 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::BinaryDeserializer::readI64(int64_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 64 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::BinaryDeserializer::readU8(uint8_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 8 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::BinaryDeserializer::readU16(uint16_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 16 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::BinaryDeserializer::readU32(uint32_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 32 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::BinaryDeserializer::readU64(uint64_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 64 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::BinaryDeserializer::readF32(float& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a float. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::BinaryDeserializer::readF64(double& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a double. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::BinaryDeserializer::readBool(bool& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a boolean. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::BinaryDeserializer::readString(std::string& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a string. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::BinaryDeserializer::beginObject() override +

+

Indicates that a object is currently being deserialized. The fail bit is set on failure.

+
+
+

+ void cubos::core::data::BinaryDeserializer::endObject() override +

+

Indicates that a object is no longer being deserialized. The fail bit is set on failure.

+
+
+

+ std::size_t cubos::core::data::BinaryDeserializer::beginArray() override +

+ + + + + + + +
ReturnsThe length of the array.
+

Indicates that an array is currently being deserialized. The fail bit is set on failure.

+
+
+

+ void cubos::core::data::BinaryDeserializer::endArray() override +

+

Indicates that an array is no longer being deserialized. The fail bit is set on failure.

+
+
+

+ std::size_t cubos::core::data::BinaryDeserializer::beginDictionary() override +

+ + + + + + + +
ReturnsThe length of the dictionary (always 0 on failure).
+

Indicates that a dictionary is being deserialized. The fail bit is set on failure.

+
+
+

+ void cubos::core::data::BinaryDeserializer::endDictionary() override +

+

Indicates that a dictionary is no longer being deserialized. The fail bit is set on failure.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1BinarySerializer.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1BinarySerializer.html new file mode 100644 index 000000000..27afffb0d --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1BinarySerializer.html @@ -0,0 +1,572 @@ + + + + + cubos::core::data::BinarySerializer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::BinarySerializer class +

+ +

Implementation of the abstract Serializer class for serializing to binary data. This class allows data to be serialized in both little and big endian formats.

+
+

Base classes

+
+
+ class Serializer +
+
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ BinarySerializer(memory::Stream& stream, + bool writeLittleEndian = true) +
+
+
+
+
+

Public functions

+
+
+ void writeI8(int8_t value, + const char* name) override +
+
+
+ void writeI16(int16_t value, + const char* name) override +
+
+
+ void writeI32(int32_t value, + const char* name) override +
+
+
+ void writeI64(int64_t value, + const char* name) override +
+
+
+ void writeU8(uint8_t value, + const char* name) override +
+
+
+ void writeU16(uint16_t value, + const char* name) override +
+
+
+ void writeU32(uint32_t value, + const char* name) override +
+
+
+ void writeU64(uint64_t value, + const char* name) override +
+
+
+ void writeF32(float value, + const char* name) override +
+
+
+ void writeF64(double value, + const char* name) override +
+
+
+ void writeBool(bool value, + const char* name) override +
+
+
+ void writeString(const char* str, + const char* name) override +
+
+
+ void beginObject(const char* name) override +
+
+
+ void endObject() override +
+
Indicates that a object is no longer being serialized.
+
+ void beginArray(std::size_t length, + const char* name) override +
+
+
+ void endArray() override +
+
Indicates that a array is no longer being serialized.
+
+ void beginDictionary(std::size_t length, + const char* name) override +
+
+
+ void endDictionary() override +
+
Indicates that a dictionary is no longer being serialized.
+
+
+
+

Function documentation

+
+

+ cubos::core::data::BinarySerializer::BinarySerializer(memory::Stream& stream, + bool writeLittleEndian = true) +

+ + + + + + + + + + + + + + +
Parameters
streamThe stream to serialize to.
writeLittleEndianIf true, the data will be written in little endian format (big endian otherwise).
+
+
+

+ void cubos::core::data::BinarySerializer::writeI8(int8_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a signed 8 bit integer.

+
+
+

+ void cubos::core::data::BinarySerializer::writeI16(int16_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 16 bit integer.

+
+
+

+ void cubos::core::data::BinarySerializer::writeI32(int32_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 32 bit integer.

+
+
+

+ void cubos::core::data::BinarySerializer::writeI64(int64_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 64 bit integer.

+
+
+

+ void cubos::core::data::BinarySerializer::writeU8(uint8_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 8 bit integer.

+
+
+

+ void cubos::core::data::BinarySerializer::writeU16(uint16_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 16 bit integer.

+
+
+

+ void cubos::core::data::BinarySerializer::writeU32(uint32_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 32 bit integer.

+
+
+

+ void cubos::core::data::BinarySerializer::writeU64(uint64_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 64 bit integer.

+
+
+

+ void cubos::core::data::BinarySerializer::writeF32(float value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a float.

+
+
+

+ void cubos::core::data::BinarySerializer::writeF64(double value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a double.

+
+
+

+ void cubos::core::data::BinarySerializer::writeBool(bool value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a boolean.

+
+
+

+ void cubos::core::data::BinarySerializer::writeString(const char* str, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
strThe string to serialize.
nameThe name of the value (optional).
+

Serializes a string.

+
+
+

+ void cubos::core::data::BinarySerializer::beginObject(const char* name) override +

+ + + + + + + + + + +
Parameters
nameThe name of the object (optional).
+

Indicates that a object is currently being serialized.

+
+
+

+ void cubos::core::data::BinarySerializer::beginArray(std::size_t length, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
lengthThe length of the array.
nameThe name of the array (optional).
+

Indicates that a array is currently being serialized.

+
+
+

+ void cubos::core::data::BinarySerializer::beginDictionary(std::size_t length, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
lengthThe length of the dictionary.
nameThe name of the dictionary (optional).
+

Indicates that a dictionary is currently being serialized.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Context.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Context.html new file mode 100644 index 000000000..9dc13036a --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Context.html @@ -0,0 +1,246 @@ + + + + + cubos::core::data::Context class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::Context class final +

+ +

Stores the context necessary to serialize or deserialize data. This is done through a type map, which stores an instance for each type added (akin to the ECS resources).

+
+

Public functions

+
+
+
template<typename T>
+ void push(T data) +
+
+
+ void pushSubContext(Context& context) +
+
+
+ void pop() +
+
+
+
template<typename T>
+ auto get() -> T& +
+
+
+
template<typename T>
+ auto has() const -> bool +
+
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ void cubos::core::data::Context::push(T data) +

+ + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the data.
Parameters
dataThe data to push.
+

Pushes a new value to the stack.

+
+
+

+ void cubos::core::data::Context::pushSubContext(Context& context) +

+ + + + + + + + + + +
Parameters
contextThe context to push.
+

Pushes a new sub-context to the stack. The sub-context acts as a group of values associated with a single push. The reference must be valid until the sub-context is popped.

+
+
+

+ void cubos::core::data::Context::pop() +

+

Pops the top value or sub-context from the stack. This must be called once for each push.

+
+
+

+
+ template<typename T> +
+ T& cubos::core::data::Context::get() +

+ + + + + + + + + + + + + + + + +
Template parameters
TThe type of the data.
Returnsthe data associated with the given type.
+

Gets the data associated with the given type. If the type is present multiple times, the topmost one is returned. Aborts if the data is not present.

+
+
+

+
+ template<typename T> +
+ bool cubos::core::data::Context::has() const +

+ + + + + + + + + + + + + + + + +
Template parameters
TThe type of the data.
ReturnsTrue if the data is present, false otherwise.
+

Checks if there is data associated with the given type.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1DebugSerializer.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1DebugSerializer.html new file mode 100644 index 000000000..a35066af8 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1DebugSerializer.html @@ -0,0 +1,578 @@ + + + + + cubos::core::data::DebugSerializer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::DebugSerializer class +

+ +

Implementation of the abstract Serializer class for debugging purposes. This class is used internally by the logging functions.

+
+

Base classes

+
+
+ class Serializer +
+
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ DebugSerializer(memory::Stream& stream, + bool pretty = false, + bool typeNames = false) +
+
+
+
+
+

Public functions

+
+
+ void writeI8(int8_t value, + const char* name) override +
+
+
+ void writeI16(int16_t value, + const char* name) override +
+
+
+ void writeI32(int32_t value, + const char* name) override +
+
+
+ void writeI64(int64_t value, + const char* name) override +
+
+
+ void writeU8(uint8_t value, + const char* name) override +
+
+
+ void writeU16(uint16_t value, + const char* name) override +
+
+
+ void writeU32(uint32_t value, + const char* name) override +
+
+
+ void writeU64(uint64_t value, + const char* name) override +
+
+
+ void writeF32(float value, + const char* name) override +
+
+
+ void writeF64(double value, + const char* name) override +
+
+
+ void writeBool(bool value, + const char* name) override +
+
+
+ void writeString(const char* str, + const char* name) override +
+
+
+ void beginObject(const char* name) override +
+
+
+ void endObject() override +
+
Indicates that a object is no longer being serialized.
+
+ void beginArray(std::size_t length, + const char* name) override +
+
+
+ void endArray() override +
+
Indicates that a array is no longer being serialized.
+
+ void beginDictionary(std::size_t length, + const char* name) override +
+
+
+ void endDictionary() override +
+
Indicates that a dictionary is no longer being serialized.
+
+
+
+

Function documentation

+
+

+ cubos::core::data::DebugSerializer::DebugSerializer(memory::Stream& stream, + bool pretty = false, + bool typeNames = false) +

+ + + + + + + + + + + + + + + + + + +
Parameters
streamThe stream to serialize to.
prettyWhether to pretty-print the output.
typeNamesWhether to print the type names.
+
+
+

+ void cubos::core::data::DebugSerializer::writeI8(int8_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a signed 8 bit integer.

+
+
+

+ void cubos::core::data::DebugSerializer::writeI16(int16_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 16 bit integer.

+
+
+

+ void cubos::core::data::DebugSerializer::writeI32(int32_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 32 bit integer.

+
+
+

+ void cubos::core::data::DebugSerializer::writeI64(int64_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 64 bit integer.

+
+
+

+ void cubos::core::data::DebugSerializer::writeU8(uint8_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 8 bit integer.

+
+
+

+ void cubos::core::data::DebugSerializer::writeU16(uint16_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 16 bit integer.

+
+
+

+ void cubos::core::data::DebugSerializer::writeU32(uint32_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 32 bit integer.

+
+
+

+ void cubos::core::data::DebugSerializer::writeU64(uint64_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 64 bit integer.

+
+
+

+ void cubos::core::data::DebugSerializer::writeF32(float value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a float.

+
+
+

+ void cubos::core::data::DebugSerializer::writeF64(double value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a double.

+
+
+

+ void cubos::core::data::DebugSerializer::writeBool(bool value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a boolean.

+
+
+

+ void cubos::core::data::DebugSerializer::writeString(const char* str, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
strThe string to serialize.
nameThe name of the value (optional).
+

Serializes a string.

+
+
+

+ void cubos::core::data::DebugSerializer::beginObject(const char* name) override +

+ + + + + + + + + + +
Parameters
nameThe name of the object (optional).
+

Indicates that a object is currently being serialized.

+
+
+

+ void cubos::core::data::DebugSerializer::beginArray(std::size_t length, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
lengthThe length of the array.
nameThe name of the array (optional).
+

Indicates that a array is currently being serialized.

+
+
+

+ void cubos::core::data::DebugSerializer::beginDictionary(std::size_t length, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
lengthThe length of the dictionary.
nameThe name of the dictionary (optional).
+

Indicates that a dictionary is currently being serialized.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Deserializer.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Deserializer.html new file mode 100644 index 000000000..71d2b03ca --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Deserializer.html @@ -0,0 +1,555 @@ + + + + + cubos::core::data::Deserializer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::Deserializer class +

+ +

Abstract class for deserializing data in a format-agnostic way. Each deserializer implementation is responsible for implementing its own primitive deserialization methods: readI8, readString, etc.

More complex types can be deserialized by implementing a specialization of the cubos::core::data::deserialize function:

struct MyType
+{
+    int32_t a;
+};
+
+// In the corresponding .cpp file.
+void cubos::core::data::deserialize<MyType>(Deserializer& d, MyType& obj)
+{
+    d.read(obj.a, "a");
+}
+
+// Alternatively, the type can define a `deserialize` method.
+
+class MyType
+{
+public:
+    void deserialize(Deserializer& d);
+
+private:
+    int32_t a;
+}; 
+
+
+

Derived classes

+
+
+ class BinaryDeserializer +
+
+
+ class JSONDeserializer +
+
Implementation of the abstract Deserializer class for deserializing from JSON.
+
+ class Unpackager +
+
Responsible for deserializing packages into types.
+
+
+
+

Public functions

+
+
+ void readI8(int8_t& value) pure virtual +
+
+
+ void readI16(int16_t& value) pure virtual +
+
+
+ void readI32(int32_t& value) pure virtual +
+
+
+ void readI64(int64_t& value) pure virtual +
+
+
+ void readU8(uint8_t& value) pure virtual +
+
+
+ void readU16(uint16_t& value) pure virtual +
+
+
+ void readU32(uint32_t& value) pure virtual +
+
+
+ void readU64(uint64_t& value) pure virtual +
+
+
+ void readF32(float& value) pure virtual +
+
+
+ void readF64(double& value) pure virtual +
+
+
+ void readBool(bool& value) pure virtual +
+
+
+ void readString(std::string& value) pure virtual +
+
+
+
template<typename T>
+ void read(T& obj) +
+
+
+ void beginObject() pure virtual +
+
+
+ void endObject() pure virtual +
+
+
+ auto beginArray() -> std::size_t pure virtual +
+
+
+ void endArray() pure virtual +
+
+
+ auto beginDictionary() -> std::size_t pure virtual +
+
+
+ void endDictionary() pure virtual +
+
+
+ auto failed() const -> bool +
+
Checks if the deserializer has failed.
+
+ void fail() +
+
Sets the fail bit.
+
+ auto context() -> Context& +
+
+
+
+
+

Protected variables

+
+
+ bool mFailBit +
+
Indicates if the deserializer has failed.
+
+
+
+

Function documentation

+
+

+ void cubos::core::data::Deserializer::readI8(int8_t& value) pure virtual +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 8 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Deserializer::readI16(int16_t& value) pure virtual +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 16 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Deserializer::readI32(int32_t& value) pure virtual +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 32 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Deserializer::readI64(int64_t& value) pure virtual +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 64 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Deserializer::readU8(uint8_t& value) pure virtual +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 8 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Deserializer::readU16(uint16_t& value) pure virtual +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 16 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Deserializer::readU32(uint32_t& value) pure virtual +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 32 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Deserializer::readU64(uint64_t& value) pure virtual +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 64 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Deserializer::readF32(float& value) pure virtual +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a float. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Deserializer::readF64(double& value) pure virtual +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a double. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Deserializer::readBool(bool& value) pure virtual +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a boolean. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Deserializer::readString(std::string& value) pure virtual +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a string. The fail bit is set if the deserialization fails.

+
+
+

+
+ template<typename T> +
+ void cubos::core::data::Deserializer::read(T& obj) +

+ + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the object.
Parameters
objThe object to deserialize.
+

Deserializes an object. The cubos::core::data::deserialize function must be implemented for the given type. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Deserializer::beginObject() pure virtual +

+

Indicates that a object is currently being deserialized. The fail bit is set on failure.

+
+
+

+ void cubos::core::data::Deserializer::endObject() pure virtual +

+

Indicates that a object is no longer being deserialized. The fail bit is set on failure.

+
+
+

+ std::size_t cubos::core::data::Deserializer::beginArray() pure virtual +

+ + + + + + + +
ReturnsThe length of the array.
+

Indicates that an array is currently being deserialized. The fail bit is set on failure.

+
+
+

+ void cubos::core::data::Deserializer::endArray() pure virtual +

+

Indicates that an array is no longer being deserialized. The fail bit is set on failure.

+
+
+

+ std::size_t cubos::core::data::Deserializer::beginDictionary() pure virtual +

+ + + + + + + +
ReturnsThe length of the dictionary (always 0 on failure).
+

Indicates that a dictionary is being deserialized. The fail bit is set on failure.

+
+
+

+ void cubos::core::data::Deserializer::endDictionary() pure virtual +

+

Indicates that a dictionary is no longer being deserialized. The fail bit is set on failure.

+
+
+

+ Context& cubos::core::data::Deserializer::context() +

+ + + + + + + +
ReturnsThe context of the serializer.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1EmbeddedArchive.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1EmbeddedArchive.html new file mode 100644 index 000000000..35f61967e --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1EmbeddedArchive.html @@ -0,0 +1,464 @@ + + + + + cubos::core::data::EmbeddedArchive class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::EmbeddedArchive class +
#include <core/data/fs/embedded_archive.hpp>
+

+

Archive implementation which reads data embedded in the application. Meant to be used with the quadrados embed tool.

+ +

Can be used to create single-file applications, where all the data is embedded in the executable.

This archive accesses a global map of data, where embedded data can be registered with a given name. Then, to access that data, an instance of this archive is created pointing to that name.

The embed tool generates source files which define and register that data. By linking those files into your application, you're making the data available to be accessed through an instance of this archive.

+
+

Base classes

+
+
+ class Archive +
+
Interface for a bridge between the CUBOS. virtual file system and the real world.
+
+
+
+

Public types

+
+
+ struct Data +
+
Describes the structure of the embedded data.
+
+
+
+

Public static functions

+
+
+ static void registerData(const std::string& name, + const Data& data) +
+
Registers embedded archive data, which must remain valid for the lifetime of the application.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ EmbeddedArchive(const std::string& name) +
+
Constructs pointing to the data with the given name.
+
+
+
+

Public functions

+
+
+ auto create(std::size_t parent, + std::string_view name, + bool directory = false) -> std::size_t override +
+
Creates a new file in the archive.
+
+ auto destroy(std::size_t id) -> bool override +
+
Destroys a regular file or empty directory in the archive.
+
+ auto name(std::size_t id) const -> std::string override +
+
Gets the name of the file with the given id.
+
+ auto directory(std::size_t id) const -> bool override +
+
Checks whether the file with the given id is a directory.
+
+ auto readOnly() const -> bool override +
+
Checks whether the archive is read-only.
+
+ auto parent(std::size_t id) const -> std::size_t override +
+
Gets the identifier of the parent file of the file with the given id.
+
+ auto sibling(std::size_t id) const -> std::size_t override +
+
Gets the identifier of the sibling of the file with the given id.
+
+ auto child(std::size_t id) const -> std::size_t override +
+
Gets the identifier of the first child of the file with the given id.
+
+ auto open(std::size_t id, + File::Handle handle, + File::OpenMode mode) -> std::unique_ptr<memory::Stream> override +
+
Opens a file in the archive.
+
+
+
+

Function documentation

+
+

+ static void cubos::core::data::EmbeddedArchive::registerData(const std::string& name, + const Data& data) +

+

Registers embedded archive data, which must remain valid for the lifetime of the application.

+ + + + + + + + + + + + + + +
Parameters
nameName of the embedded archive data.
dataEmbedded archive data.
+

This function is called by the code generated by the embed tool.

+
+
+

+ cubos::core::data::EmbeddedArchive::EmbeddedArchive(const std::string& name) +

+

Constructs pointing to the data with the given name.

+ + + + + + + + + + +
Parameters
nameName of the data the embedded archive is going to access.
+

Aborts if no data with the given name was registered.

+
+
+

+ std::size_t cubos::core::data::EmbeddedArchive::create(std::size_t parent, + std::string_view name, + bool directory = false) override +

+

Creates a new file in the archive.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
parentParent directory of the new file.
nameName of the new file.
directoryWhether the new file is a directory or not.
ReturnsIdentifier of the file, or 0 if the file could not be created.
+

The first child of the parent will have its sibling set to the new file and then be replaced by the new file.

+
+
+

+ bool cubos::core::data::EmbeddedArchive::destroy(std::size_t id) override +

+

Destroys a regular file or empty directory in the archive.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsWhether the file was destroyed successfully.
+

Will be replaced in the tree by its sibling.

+
+
+

+ std::string cubos::core::data::EmbeddedArchive::name(std::size_t id) const override +

+

Gets the name of the file with the given id.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsName of the file.
+
+
+

+ bool cubos::core::data::EmbeddedArchive::directory(std::size_t id) const override +

+

Checks whether the file with the given id is a directory.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsWhether the file is a directory or not.
+
+
+

+ bool cubos::core::data::EmbeddedArchive::readOnly() const override +

+

Checks whether the archive is read-only.

+ + + + + + + +
ReturnsWhether the archive is read-only.
+
+
+

+ std::size_t cubos::core::data::EmbeddedArchive::parent(std::size_t id) const override +

+

Gets the identifier of the parent file of the file with the given id.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsIdentifier of the parent file, or 0 if the file is the root file.
+
+
+

+ std::size_t cubos::core::data::EmbeddedArchive::sibling(std::size_t id) const override +

+

Gets the identifier of the sibling of the file with the given id.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsIdentifier of the sibling, or 0 if there are no more files in the parent.
+
+
+

+ std::size_t cubos::core::data::EmbeddedArchive::child(std::size_t id) const override +

+

Gets the identifier of the first child of the file with the given id.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsIdentifier of the first child, or 0 if the file is not a directory or is empty.
+
+
+

+ std::unique_ptr<memory::Stream> cubos::core::data::EmbeddedArchive::open(std::size_t id, + File::Handle handle, + File::OpenMode mode) override +

+

Opens a file in the archive.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
handleHandle to the file.
modeMode to open the file in.
ReturnsFile stream, or nullptr if the file could not be opened.
+

Although a bit hacky, the handle parameter is used to keep a reference to the respective File alive, preventing the file from being destroyed while the stream is open.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1File.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1File.html new file mode 100644 index 000000000..3ed45f214 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1File.html @@ -0,0 +1,494 @@ + + + + + cubos::core::data::File class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::File class final +
#include <core/data/fs/file.hpp>
+

+

Represents a file in the virtual file system of the engine.

+ +

Instances of this class are always held through a File::Handle, which is just a smart shared pointer.

Files may either be regular files or directories. Directories can have children files, but no data. Regular files are only allowed inside mounted archives, since they must have data associated with them, while the directories are just a way to organize the files.

+
+

Public types

+
+
+ enum class OpenMode { Read, + Write, + ReadWrite } +
+
Possible modes to open files in.
+
+ using Handle = std::shared_ptr<File> +
+
Handle to a file in the CUBOS. virtual file system.
+
+
+
+

Public functions

+
+
+ auto mount(std::string_view path, + std::unique_ptr<Archive> archive) -> bool +
+
Mounts an archive to a path relative to this file.
+
+ auto unmount(std::string_view path) -> bool +
+
Unmounts an archive from a path relative to this file.
+
+ auto find(std::string_view path) -> Handle +
+
Gets a handle to a file relative to this file.
+
+ auto create(std::string_view path, + bool directory = false) -> Handle +
+
Creates a new file on a path relative to this file.
+
+ auto destroy() -> bool +
+
Marks this file for destruction.
+
+ auto open(OpenMode mode) -> std::unique_ptr<memory::Stream> +
+
Opens this file for reading or writing.
+
+ auto name() const -> std::string_view +
+
Gets the name of this file.
+
+ auto path() const -> std::string_view +
+
Gets the absolute path of this file.
+
+ auto directory() const -> bool +
+
Checks whether this file is a directory.
+
+ auto archive() const -> const std::shared_ptr<Archive>& +
+
Gets the archive this file is in.
+
+ auto id() const -> std::size_t +
+
Gets the identifier of this file on its archive.
+
+ auto parent() const -> Handle +
+
Gets the parent directory of this file.
+
+ auto sibling() const -> Handle +
+
Gets the next sibling of this file.
+
+ auto child() const -> Handle +
+
Gets the first child of this file.
+
+
+
+

Enum documentation

+
+

+ enum class cubos::core::data::File::OpenMode +

+

Possible modes to open files in.

+ + + + + + + + + + + + + + + + +
Enumerators
Read +

Open the file for reading.

+
Write +

Open the file for writing, overwriting any previous changes.

+
ReadWrite +

Open the file for reading or writing data.

+
+
+
+
+

Typedef documentation

+
+

+ using cubos::core::data::File::Handle = std::shared_ptr<File> +

+

Handle to a file in the CUBOS. virtual file system.

+

This is a smart shared pointer, so that files are not destroyed while being referenced.

+
+
+
+

Function documentation

+
+

+ bool cubos::core::data::File::mount(std::string_view path, + std::unique_ptr<Archive> archive) +

+

Mounts an archive to a path relative to this file.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
pathPath relative to this file to mount the archive on.
archiveArchive to mount.
ReturnsWhether the archive was successfully mounted.
+

Creates any parent directories that may be necessary, but the mount point itself must not already exist.

This method fails on the following conditions:

  • path is absolute or invalid.
  • a parent file in the path exists and is not a directory.
  • a parent directory in the path belongs to an archive.
  • a file already exists at the mount point.
+
+
+

+ bool cubos::core::data::File::unmount(std::string_view path) +

+

Unmounts an archive from a path relative to this file.

+ + + + + + + + + + + + + + + + +
Parameters
pathPath relative to this file to unmount the archive from.
ReturnsWhether the archive was successfully unmounted.
+

Removes all of the archive's files from the virtual file system.

This method fails on the following conditions:

  • path is absolute or invalid.
  • any of the files in the path do not exist.
  • the target path is not the mount point for an archive.
+
+
+

+ Handle cubos::core::data::File::find(std::string_view path) +

+

Gets a handle to a file relative to this file.

+ + + + + + + + + + + + + + + + +
Parameters
pathPath relative to this file to get the file from.
ReturnsHandle to the file, or nullptr on failure.
+

Fails if the file does not exist or if the path is absolute or invalid.

+
+
+

+ Handle cubos::core::data::File::create(std::string_view path, + bool directory = false) +

+

Creates a new file on a path relative to this file.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
pathRelative path to the file.
directoryWhether the new file should be a directory.
ReturnsHandle to the file, or nullptr on failure.
+

The destination location must be writeable - that is, it must be under a mounted writeable archive. If a file at the given path already exists, it is returned instead. Any parent directories that may be necessary are created.

This method fails on the following conditions:

  • path is absolute or invalid.
  • a parent directory in the path does not exist and cannot be created.
  • a parent directory in the path already exists as a regular file.
  • a file of a different type already exists at the destination.
+
+
+

+ bool cubos::core::data::File::destroy() +

+

Marks this file for destruction.

+ + + + + + + +
ReturnsWhether the file was successfully marked for destruction.
+

Although the file will only be deleted when no more references to it exist, it is immediately removed from the virtual file system and this method is called recursively on all its children.

This method fails on the following conditions:

  • this file is the mount point of an archive.
  • this file does not belong to an archive.
  • this file belongs to a read-only archive.
+
+
+

+ std::unique_ptr<memory::Stream> cubos::core::data::File::open(OpenMode mode) +

+

Opens this file for reading or writing.

+ + + + + + + + + + + + + + + + +
Parameters
modeMode to open the file in.
ReturnsHandle to a file stream, or nullptr on failure.
+

If the file is being written to, blocks until the other threads are done with the file.

This method fails on the following conditions:

  • this file is a directory.
  • this file belongs to a read-only archive and the mode is not OpenMode::Read.
+
+
+

+ std::string_view cubos::core::data::File::name() const +

+

Gets the name of this file.

+ + + + + + + +
ReturnsName of this file.
+
+
+

+ std::string_view cubos::core::data::File::path() const +

+

Gets the absolute path of this file.

+ + + + + + + +
ReturnsAbsolute path of this file.
+
+
+

+ bool cubos::core::data::File::directory() const +

+

Checks whether this file is a directory.

+ + + + + + + +
ReturnsWhether this file is a directory.
+
+
+

+ const std::shared_ptr<Archive>& cubos::core::data::File::archive() const +

+

Gets the archive this file is in.

+ + + + + + + +
ReturnsArchive this file is in, or nullptr if the file is not in an archive.
+
+
+

+ std::size_t cubos::core::data::File::id() const +

+

Gets the identifier of this file on its archive.

+ + + + + + + +
ReturnsIdentifier of this file on its archive, or 0 if it is not in an archive.
+
+
+

+ Handle cubos::core::data::File::parent() const +

+

Gets the parent directory of this file.

+ + + + + + + +
ReturnsFile's parent directory, or nullptr if there isn't one.
+
+
+

+ Handle cubos::core::data::File::sibling() const +

+

Gets the next sibling of this file.

+ + + + + + + +
ReturnsNext sibling, or nullptr if this file is the last child of its parent.
+
+
+

+ Handle cubos::core::data::File::child() const +

+

Gets the first child of this file.

+ + + + + + + +
ReturnsFirst child, or nullptr if this file is not a directory or if it is empty.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1FileStream.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1FileStream.html new file mode 100644 index 000000000..c95f83f28 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1FileStream.html @@ -0,0 +1,350 @@ + + + + + cubos::core::data::FileStream class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/data/fs/file_stream.hpp>
+
template<typename T>
+ cubos::core::data::FileStream class final +

+

Wrapper around an implementation-specific file stream which keeps the file alive and does some sanity checks.

+ + + + + + + + + + +
Template parameters
TInner implementation-specific stream type.
+ +

The file is kept alive by storing a handle to it, which prevents it from being destroyed as long as the stream is alive.

+
+

Base classes

+
+
+ class cubos::core::memory::Stream +
+
Interface class for memory streams. Abstracts away sources or destinations of data.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ FileStream(File::Handle file, + File::OpenMode mode, + T&& stream) +
+
Constructs.
+
+
+
+

Public functions

+
+
+ auto read(void* data, + std::size_t size) -> std::size_t override +
+
Reads data from the stream.
+
+ auto write(const void* data, + std::size_t size) -> std::size_t override +
+
Writes data to the stream.
+
+ auto tell() const -> std::size_t override +
+
Gets the current position in the stream.
+
+ void seek(ptrdiff_t offset, + memory::SeekOrigin origin) override +
+
Seeks to a position in the stream.
+
+ auto eof() const -> bool override +
+
Checks if the stream still has content to read.
+
+ auto peek() const -> char override +
+
Peeks one byte from the stream.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::core::data::FileStream<T>::FileStream(File::Handle file, + File::OpenMode mode, + T&& stream) +

+

Constructs.

+ + + + + + + + + + + + + + + + + + +
Parameters
fileFile which the stream is reading/writing from/to.
modeMode to open the file in.
streamStream to read/write from/to.
+
+
+

+
+ template<typename T> +
+ std::size_t cubos::core::data::FileStream<T>::read(void* data, + std::size_t size) override +

+

Reads data from the stream.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
dataBuffer to read data into.
sizeSize of the buffer.
ReturnsNumber of bytes read.
+
+
+

+
+ template<typename T> +
+ std::size_t cubos::core::data::FileStream<T>::write(const void* data, + std::size_t size) override +

+

Writes data to the stream.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
dataBuffer to write data from.
sizeSize of the buffer.
ReturnsNumber of bytes written.
+
+
+

+
+ template<typename T> +
+ std::size_t cubos::core::data::FileStream<T>::tell() const override +

+

Gets the current position in the stream.

+ + + + + + + +
ReturnsCurrent position in the stream, or SIZE_MAX if the position is unknown.
+
+
+

+
+ template<typename T> +
+ void cubos::core::data::FileStream<T>::seek(ptrdiff_t offset, + memory::SeekOrigin origin) override +

+

Seeks to a position in the stream.

+ + + + + + + + + + + + + + +
Parameters
offsetOffset to seek to.
originOrigin of the offset.
+
+
+

+
+ template<typename T> +
+ bool cubos::core::data::FileStream<T>::eof() const override +

+

Checks if the stream still has content to read.

+ + + + + + + +
ReturnsWhether the stream has reached the end.
+
+
+

+
+ template<typename T> +
+ char cubos::core::data::FileStream<T>::peek() const override +

+

Peeks one byte from the stream.

+ + + + + + + +
ReturnsPeeked byte.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1FileSystem.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1FileSystem.html new file mode 100644 index 000000000..5e51c9501 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1FileSystem.html @@ -0,0 +1,325 @@ + + + + + cubos::core::data::FileSystem class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::FileSystem class final +
#include <core/data/fs/file_system.hpp>
+

+

Singleton which represents the virtual file system of the engine.

+ +

All filesystem operations in the engine should be done through this class or through a File obtained here.

+
+

Public static functions

+
+
+ static auto root() -> File::Handle +
+
Gets the root file of the virtual file system.
+
+ static auto mount(std::string_view path, + std::unique_ptr<Archive> archive) -> bool +
+
Mounts an archive to an absolute path.
+
+ static auto unmount(std::string_view path) -> bool +
+
Unmounts an archive from an absolute path.
+
+ static auto find(std::string_view path) -> File::Handle +
+
Gets a handle to a file.
+
+ static auto create(std::string_view path, + bool directory = false) -> File::Handle +
+
Creates a new file at the specified absolute path.
+
+ static auto destroy(std::string_view path) -> bool +
+
Marks a file for destruction.
+
+ static auto open(std::string_view path, + File::OpenMode mode) -> std::unique_ptr<memory::Stream> +
+
Opens a file in the virtual file system.
+
+
+
+

Function documentation

+
+

+ static File::Handle cubos::core::data::FileSystem::root() +

+

Gets the root file of the virtual file system.

+ + + + + + + +
ReturnsFile handle.
+
+
+

+ static bool cubos::core::data::FileSystem::mount(std::string_view path, + std::unique_ptr<Archive> archive) +

+

Mounts an archive to an absolute path.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
pathAbsolute path to mount the archive on.
archiveArchive to mount.
ReturnsWhether the archive was successfully mounted.
+

Creates any parent directories that may be necessary, but the mount point itself must not already exist.

This method fails on the following conditions:

  • path is relative or invalid.
  • a parent file in the path exists and is not a directory.
  • a parent directory in the path belongs to an archive.
  • a file already exists at the mount point.
+
+
+

+ static bool cubos::core::data::FileSystem::unmount(std::string_view path) +

+

Unmounts an archive from an absolute path.

+ + + + + + + + + + + + + + + + +
Parameters
pathPath to unmount the archive from.
ReturnsWhether the archive was successfully unmounted.
+

Removes all of the archive's files from the virtual file system.

This method fails on the following conditions:

  • path is relative or invalid.
  • any of the files in the path do not exist.
  • the target path is not the mount point of an archive.
+
+
+

+ static File::Handle cubos::core::data::FileSystem::find(std::string_view path) +

+

Gets a handle to a file.

+ + + + + + + + + + + + + + + + +
Parameters
pathAbsolute path to the file.
ReturnsFile handle or nullptr on failure.
+

Fails if the file does not exist or the path is relative or invalid.

+
+
+

+ static File::Handle cubos::core::data::FileSystem::create(std::string_view path, + bool directory = false) +

+

Creates a new file at the specified absolute path.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
pathAbsolute path to the file.
directoryWhether the new file should be a directory.
ReturnsFile or nullptr on failure.
+

The destination location must be writeable - that is, it must be under a mounted writeable archive.

If a file at the specified path already exists, it is returned instead. Any parent directories that may be necessary are created.

This method fails on the following conditions:

  • path is relative or invalid.
  • a parent directory in the path does not exist and cannot be created.
  • a parent directory in the path already exists as a regular file.
  • a file of a different type already exists at the destination.
+
+
+

+ static bool cubos::core::data::FileSystem::destroy(std::string_view path) +

+

Marks a file for destruction.

+ + + + + + + + + + + + + + + + +
Parameters
pathAbsolute path of the file to destroy.
ReturnsWhether the file was successfully marked for destruction.
+

Although The file will only be deleted when no more references to it exist, it is immediately removed from the virtual file system.

All children of the file are also marked for destruction.

This method fails on the following conditions:

  • path is relative or invalid.
  • the file does not exist.
  • the file is the mount point of an archive.
  • the file does not belong to an archive.
  • the file belongs to a read-only archive.
+
+
+

+ static std::unique_ptr<memory::Stream> cubos::core::data::FileSystem::open(std::string_view path, + File::OpenMode mode) +

+

Opens a file in the virtual file system.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
pathAbsolute path of the file.
modeMode to open the file in.
ReturnsFile stream, or nullptr if an error occurred.
+

If the file is being written to, blocks until the other threads are done with the file.

This method fails on the following conditions:

  • FileSystem::find(path) fails.
  • file->open(mode) fails.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1JSONDeserializer.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1JSONDeserializer.html new file mode 100644 index 000000000..08c981c33 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1JSONDeserializer.html @@ -0,0 +1,483 @@ + + + + + cubos::core::data::JSONDeserializer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::JSONDeserializer class +

+

Implementation of the abstract Deserializer class for deserializing from JSON.

+ +
+

Base classes

+
+
+ class Deserializer +
+
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ JSONDeserializer(const std::string& src) +
+
+
+
+
+

Public functions

+
+
+ void readI8(int8_t& value) override +
+
+
+ void readI16(int16_t& value) override +
+
+
+ void readI32(int32_t& value) override +
+
+
+ void readI64(int64_t& value) override +
+
+
+ void readU8(uint8_t& value) override +
+
+
+ void readU16(uint16_t& value) override +
+
+
+ void readU32(uint32_t& value) override +
+
+
+ void readU64(uint64_t& value) override +
+
+
+ void readF32(float& value) override +
+
+
+ void readF64(double& value) override +
+
+
+ void readBool(bool& value) override +
+
+
+ void readString(std::string& value) override +
+
+
+ void beginObject() override +
+
+
+ void endObject() override +
+
+
+ auto beginArray() -> std::size_t override +
+
+
+ void endArray() override +
+
+
+ auto beginDictionary() -> std::size_t override +
+
+
+ void endDictionary() override +
+
+
+
+
+

Function documentation

+
+

+ cubos::core::data::JSONDeserializer::JSONDeserializer(const std::string& src) +

+ + + + + + + + + + +
Parameters
srcThe string to deserialize from. Must correspond to a JSON literal/object/array.
+
+
+

+ void cubos::core::data::JSONDeserializer::readI8(int8_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 8 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::JSONDeserializer::readI16(int16_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 16 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::JSONDeserializer::readI32(int32_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 32 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::JSONDeserializer::readI64(int64_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 64 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::JSONDeserializer::readU8(uint8_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 8 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::JSONDeserializer::readU16(uint16_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 16 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::JSONDeserializer::readU32(uint32_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 32 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::JSONDeserializer::readU64(uint64_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 64 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::JSONDeserializer::readF32(float& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a float. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::JSONDeserializer::readF64(double& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a double. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::JSONDeserializer::readBool(bool& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a boolean. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::JSONDeserializer::readString(std::string& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a string. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::JSONDeserializer::beginObject() override +

+

Indicates that a object is currently being deserialized. The fail bit is set on failure.

+
+
+

+ void cubos::core::data::JSONDeserializer::endObject() override +

+

Indicates that a object is no longer being deserialized. The fail bit is set on failure.

+
+
+

+ std::size_t cubos::core::data::JSONDeserializer::beginArray() override +

+ + + + + + + +
ReturnsThe length of the array.
+

Indicates that an array is currently being deserialized. The fail bit is set on failure.

+
+
+

+ void cubos::core::data::JSONDeserializer::endArray() override +

+

Indicates that an array is no longer being deserialized. The fail bit is set on failure.

+
+
+

+ std::size_t cubos::core::data::JSONDeserializer::beginDictionary() override +

+ + + + + + + +
ReturnsThe length of the dictionary (always 0 on failure).
+

Indicates that a dictionary is being deserialized. The fail bit is set on failure.

+
+
+

+ void cubos::core::data::JSONDeserializer::endDictionary() override +

+

Indicates that a dictionary is no longer being deserialized. The fail bit is set on failure.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1JSONSerializer.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1JSONSerializer.html new file mode 100644 index 000000000..5e0be7f6f --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1JSONSerializer.html @@ -0,0 +1,572 @@ + + + + + cubos::core::data::JSONSerializer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::JSONSerializer class +

+ +

Implementation of the abstract Serializer class for serializing to JSON. Each time a top-level primitive/object/array/dictionary is written, its JSON output is written to the underlying stream.

+
+

Base classes

+
+
+ class Serializer +
+
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ JSONSerializer(memory::Stream& stream, + int indent = -1) +
+
+
+
+
+

Public functions

+
+
+ void writeI8(int8_t value, + const char* name) override +
+
+
+ void writeI16(int16_t value, + const char* name) override +
+
+
+ void writeI32(int32_t value, + const char* name) override +
+
+
+ void writeI64(int64_t value, + const char* name) override +
+
+
+ void writeU8(uint8_t value, + const char* name) override +
+
+
+ void writeU16(uint16_t value, + const char* name) override +
+
+
+ void writeU32(uint32_t value, + const char* name) override +
+
+
+ void writeU64(uint64_t value, + const char* name) override +
+
+
+ void writeF32(float value, + const char* name) override +
+
+
+ void writeF64(double value, + const char* name) override +
+
+
+ void writeBool(bool value, + const char* name) override +
+
+
+ void writeString(const char* str, + const char* name) override +
+
+
+ void beginObject(const char* name) override +
+
+
+ void endObject() override +
+
Indicates that a object is no longer being serialized.
+
+ void beginArray(std::size_t length, + const char* name) override +
+
+
+ void endArray() override +
+
Indicates that a array is no longer being serialized.
+
+ void beginDictionary(std::size_t length, + const char* name) override +
+
+
+ void endDictionary() override +
+
Indicates that a dictionary is no longer being serialized.
+
+
+
+

Function documentation

+
+

+ cubos::core::data::JSONSerializer::JSONSerializer(memory::Stream& stream, + int indent = -1) +

+ + + + + + + + + + + + + + +
Parameters
streamThe stream to serialize to.
indentThe JSON output indentantion (-1 means no indentation).
+
+
+

+ void cubos::core::data::JSONSerializer::writeI8(int8_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a signed 8 bit integer.

+
+
+

+ void cubos::core::data::JSONSerializer::writeI16(int16_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 16 bit integer.

+
+
+

+ void cubos::core::data::JSONSerializer::writeI32(int32_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 32 bit integer.

+
+
+

+ void cubos::core::data::JSONSerializer::writeI64(int64_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 64 bit integer.

+
+
+

+ void cubos::core::data::JSONSerializer::writeU8(uint8_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 8 bit integer.

+
+
+

+ void cubos::core::data::JSONSerializer::writeU16(uint16_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 16 bit integer.

+
+
+

+ void cubos::core::data::JSONSerializer::writeU32(uint32_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 32 bit integer.

+
+
+

+ void cubos::core::data::JSONSerializer::writeU64(uint64_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 64 bit integer.

+
+
+

+ void cubos::core::data::JSONSerializer::writeF32(float value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a float.

+
+
+

+ void cubos::core::data::JSONSerializer::writeF64(double value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a double.

+
+
+

+ void cubos::core::data::JSONSerializer::writeBool(bool value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a boolean.

+
+
+

+ void cubos::core::data::JSONSerializer::writeString(const char* str, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
strThe string to serialize.
nameThe name of the value (optional).
+

Serializes a string.

+
+
+

+ void cubos::core::data::JSONSerializer::beginObject(const char* name) override +

+ + + + + + + + + + +
Parameters
nameThe name of the object (optional).
+

Indicates that a object is currently being serialized.

+
+
+

+ void cubos::core::data::JSONSerializer::beginArray(std::size_t length, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
lengthThe length of the array.
nameThe name of the array (optional).
+

Indicates that a array is currently being serialized.

+
+
+

+ void cubos::core::data::JSONSerializer::beginDictionary(std::size_t length, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
lengthThe length of the dictionary.
nameThe name of the dictionary (optional).
+

Indicates that a dictionary is currently being serialized.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Package.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Package.html new file mode 100644 index 000000000..41133312f --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Package.html @@ -0,0 +1,847 @@ + + + + + cubos::core::data::Package class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::Package class final +

+

A utility object which is capable of storing the data of any trivially serializable object. One way to understand this class is to think of it as if it were a JSON representation of an object.

+ +

While packages are serialiable, they are not deserializable. This is because there's no way to know what type the package was serialized from. If you know what type the package was serialized from, and want to deserialize it, you can use the type's deserialization function.

Usage example:

auto pkg = Package::from(mySerializableObject);
+pkg.field("position").field("x").set(1.0f);
+pkg.field("position").field("y").set(2.0f);
+pkg.field("position").field("z").set(3.0f);
+pkg.into(myDeserializableObject);
+// myDeserializableObject will hold the same data as
+// mySerilizableObject but with the position set to (1, 2, 3).
+
+
+

Public types

+
+
+ enum class Type { None, + I8, + I16, + I32, + I64, + U8, + U16, + U32, + U64, + F32, + F64, + Bool, + String, + Object, + Array, + Dictionary } +
+
Used to identify the type of the packaged data.
+
+ using Fields = std::vector<std::pair<std::string, Package>> +
+
Type alias for the map used to store the object fields.
+
+ using Elements = std::vector<Package> +
+
Type alias for the vector used to store the array elements.
+
+ using Dictionary = std::vector<std::pair<Package, Package>> +
+
Type alias for the vector used to store the dictionary pairs.
+
+ using Data = std::variant<std::monostate, int8_t, int16_t, int32_t, int64_t, uint8_t, uint16_t, uint32_t, uint64_t, float, double, bool, std::string, Fields, Elements, Dictionary> +
+
+
+
+
+

Public static functions

+
+
+
template<typename T>
+ static auto from(const T& data, + Context* context = nullptr) -> Package +
+
+
+ static auto typeToString(Type type) -> const char* +
+
+
+
+
+

Public functions

+
+
+
template<typename T>
+ void set(const T& data, + Context* context = nullptr) +
+
+
+ auto change(int64_t data) -> bool +
+
+
+ auto change(uint64_t data) -> bool +
+
+
+ auto change(double data) -> bool +
+
+
+ auto change(bool data) -> bool +
+
+
+ auto change(const std::string& data) -> bool +
+
+
+
template<typename T>
+ auto into(T& data, + Context* context = nullptr) const -> bool +
+
+
+
template<typename T>
+ auto get(Context* context = nullptr) const -> requires std::default_initializable<T> T +
+
+
+ auto type() const -> Type +
+
+
+ auto size() const -> std::size_t +
+
+
+ auto isStructured() const -> bool +
+
+
+ auto field(const std::string& name) -> Package& +
+
+
+ auto fields() -> Fields& +
+
+
+ auto fields() const -> const Fields& +
+
+
+ auto removeField(std::string_view name) -> Package +
+
+
+ auto element(std::size_t index) -> Package& +
+
+
+ auto elements() -> Elements& +
+
+
+ auto elements() const -> const Elements& +
+
+
+ auto dictionary() -> Dictionary& +
+
+
+ auto dictionary() const -> const Dictionary& +
+
+
+
+
+

Enum documentation

+
+

+ enum class cubos::core::data::Package::Type +

+

Used to identify the type of the packaged data.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Enumerators
None +

The package doesn't contain anything.

+
I8 +

The package contains a signed 8-bit integer.

+
I16 +

The package contains a signed 16-bit integer.

+
I32 +

The package contains a signed 32-bit integer.

+
I64 +

The package contains a signed 64-bit integer.

+
U8 +

The package contains an unsigned 8-bit integer.

+
U16 +

The package contains an unsigned 16-bit integer.

+
U32 +

The package contains an unsigned 32-bit integer.

+
U64 +

The package contains an unsigned 64-bit integer.

+
F32 +

The package contains a 32-bit floating point number.

+
F64 +

The package contains a 64-bit floating point number.

+
Bool +

The package contains a boolean value.

+
String +

The package contains a string.

+
Object +

The package contains an object with fields.

+
Array +

The package contains an array.

+
Dictionary +

The packages contains a dictionary.

+
+
+
+
+

Typedef documentation

+
+

+ using cubos::core::data::Package::Data = std::variant<std::monostate, int8_t, int16_t, int32_t, int64_t, uint8_t, uint16_t, uint32_t, uint64_t, float, double, bool, std::string, Fields, Elements, Dictionary> +

+

Type alias for the variant used to store the package's data. The types must be defined in the same order as the Type enum.

+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ static Package cubos::core::data::Package::from(const T& data, + Context* context = nullptr) +

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the data to package.
Parameters
dataThe data to package.
contextOptional context to use when packaging the data.
+

Packages serializable data and returns the result.

+
+
+

+ static const char* cubos::core::data::Package::typeToString(Type type) +

+ + + + + + + + + + + + + + + + +
Parameters
typeThe type to convert.
ReturnsThe string representation of the type.
+

Converts a package type into its string representation.

+
+
+

+
+ template<typename T> +
+ void cubos::core::data::Package::set(const T& data, + Context* context = nullptr) +

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the data to package.
Parameters
dataThe data to package.
contextOptional context to use when packaging the data.
+

Packages the specified data into this package. This will change the type of the package. This may be a problem in some cases. For example, if an uint8_t is packaged, then set to a uint16_t, and then binary serialized, it won't be deserializable back to an uint8_t (only to a uint16_t). One way to avoid this problem is to use Package::change instead.

+
+
+

+ bool cubos::core::data::Package::change(int64_t data) +

+ + + + + + + + + + + + + + + + +
Parameters
dataThe data to package.
ReturnsTrue on success, false on failure.
+

Packages the specified int64_t into this package, without changing the type of the package. If the types aren't compatible, this will fail. For example, 255 would be compatible with uint8_t, but -1 or 256 would not.

+
+
+

+ bool cubos::core::data::Package::change(uint64_t data) +

+ + + + + + + + + + + + + + + + +
Parameters
dataThe data to package.
ReturnsTrue on success, false on failure.
+

Packages the specified uint64_t into this package, without changing the type of the package. If the types aren't compatible, this will fail. For example, 255 would be compatible with uint8_t, but 256 would not.

+
+
+

+ bool cubos::core::data::Package::change(double data) +

+ + + + + + + + + + + + + + + + +
Parameters
dataThe data to package.
ReturnsTrue on success, false on failure.
+

Packages the specified double into this package, without changing the type of the package. If the types aren't compatible, this will fail. If the underlying type is a float, the precision will be lowered.

+
+
+

+ bool cubos::core::data::Package::change(bool data) +

+ + + + + + + + + + + + + + + + +
Parameters
dataThe data to package.
ReturnsTrue on success, false on failure.
+

Packages the specified bool into this package, without changing the type of the package. If the package isn't a bool, this will fail.

+
+
+

+ bool cubos::core::data::Package::change(const std::string& data) +

+ + + + + + + + + + + + + + + + +
Parameters
dataThe data to package.
ReturnsTrue on success, false on failure.
+

Packages the specified string into this package, without changing the type of the package. If the package isn't a string already, this will fail.

+
+
+

+
+ template<typename T> +
+ bool cubos::core::data::Package::into(T& data, + Context* context = nullptr) const +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the data to unpackage.
Parameters
dataThe data to write to.
contextOptional context to use when unpackaging the data.
ReturnsTrue if the unpackaging succeeded, false otherwise.
+

Unpackages the package into data. If there is a field missing or there's a type mismatch, the unpackaging may fail. It is guaranteed that unpackaging a package created from a certain type to the same type never fails.

+
+
+

+
+ template<typename T> +
+ requires std::default_initializable<T> T cubos::core::data::Package::get(Context* context = nullptr) const +

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the data to unpackage.
Parameters
contextOptional context to use when unpackaging the data.
ReturnsThe data.
+

Alternative to Package::into for types which are default constructible. Unpackages the package and returns the data, and aborts if the type isn't the expected. Should only be used when you're sure the type is correct.

+
+
+

+ Type cubos::core::data::Package::type() const +

+ + + + + + + +
ReturnsThe type of the packaged data.
+
+
+

+ std::size_t cubos::core::data::Package::size() const +

+ + + + + + + +
ReturnsThe size of the packaged
+

Gets the size of the package. For empty packages, or scalars (including strings), this is always 0, or 1, respectively. For objects, arrays and dictionaries, this is, respectively, the field count, the element count and the key-value pair count.

+
+
+

+ bool cubos::core::data::Package::isStructured() const +

+ + + + + + + +
ReturnsTrue if the package is storing a structured data type, false otherwise.
+

Checks if the package is storing a structured data type (object, array or dictionary).

+
+
+

+ Package& cubos::core::data::Package::field(const std::string& name) +

+ + + + + + + + + + + + + + + + +
Parameters
nameThe name of the field.
ReturnsA reference to the field.
+

Gets a reference to a field of this package. If the package isn't storing an object or if the field doesn't exist, this method will abort.

+
+
+

+ Fields& cubos::core::data::Package::fields() +

+ + + + + + + +
ReturnsA map associating the field name to the field package.
+

Gets all of the fields in this package. If the package isn't storing an object, this method will abort.

+
+
+

+ const Fields& cubos::core::data::Package::fields() const +

+ + + + + + + +
ReturnsA map associating the field name to the field package.
+

Gets all of the fields in this package. If the package isn't storing an object, this method will abort.

+
+
+

+ Package cubos::core::data::Package::removeField(std::string_view name) +

+ + + + + + + + + + + + + + + + +
Parameters
nameThe name of the field.
ReturnsThe removed field, or an empty package if the field didn't exist.
+

Removes a field from this package. If the package isn't storing an object, this method will abort.

+
+
+

+ Package& cubos::core::data::Package::element(std::size_t index) +

+ + + + + + + + + + + + + + + + +
Parameters
indexThe index of the element in the array.
ReturnsA reference to the element.
+

Gets an element of the array stored in this package. If the package isn't an array, this method will abort. If the index is out of bounds, this method will abort.

+
+
+

+ Elements& cubos::core::data::Package::elements() +

+ + + + + + + +
ReturnsA vector of the packaged elements.
+

Gets the array stored in this package. If the package isn't an array, this method will abort.

+
+
+

+ const Elements& cubos::core::data::Package::elements() const +

+ + + + + + + +
ReturnsA vector of the packaged elements.
+

Gets the array stored in this package. If the package isn't an array, this method will abort.

+
+
+

+ Dictionary& cubos::core::data::Package::dictionary() +

+

Gets the dictionary stored in this package. The dictionary is returned as a vector of the packaged key-value pairs. If the package isn't a dictionary, this method will abort.

+
+
+

+ const Dictionary& cubos::core::data::Package::dictionary() const +

+

Gets the dictionary stored in this package. The dictionary is returned as a vector of the packaged key-value pairs. If the package isn't a dictionary, this method will abort.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1SerializationMap.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1SerializationMap.html new file mode 100644 index 000000000..c4cdd8fa6 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1SerializationMap.html @@ -0,0 +1,346 @@ + + + + + cubos::core::data::SerializationMap class | CUBOS. + + + + + + + +
+
+
+
+
+

+
template<typename R, typename I>
+ cubos::core::data::SerializationMap class final +

+ + + + + + + + + + + + + + +
Template parameters
RReference type.
ISerialized identifier type.
+ +

Class used to map between references and their serialized identifiers.

+
+

Constructors, destructors, conversion operators

+
+
+ SerializationMap(std::function<bool(const R&, I&)> serialize, + std::function<bool(R&, const I&)> deserialize) +
+
+
+
+
+

Public functions

+
+
+ void add(const R& reference, + const I& id) +
+
+
+ auto hasRef(const R& reference) const -> bool +
+
+
+ auto hasId(const I& id) const -> bool +
+
+
+ auto getRef(const I& id) const -> R +
+
+
+ auto getId(const R& reference) const -> I +
+
+
+ void clear() +
+
Clears the map.
+
+ auto size() const -> std::size_t +
+
+
+
+
+

Function documentation

+
+

+
+ template<typename R, typename I> +
+ cubos::core::data::SerializationMap<R, I>::SerializationMap(std::function<bool(const R&, I&)> serialize, + std::function<bool(R&, const I&)> deserialize) +

+ + + + + + + + + + + + + + +
Parameters
serializeFunction used to serialize references.
deserializeFunction used to deserialize references.
+

Makes the serialization map use functions instead of keeping a map.

+
+
+

+
+ template<typename R, typename I> +
+ void cubos::core::data::SerializationMap<R, I>::add(const R& reference, + const I& id) +

+ + + + + + + + + + + + + + +
Parameters
referenceReference to add.
idSerialized identifier to add.
+

Adds a reference <-> serialized identifier pair.

+
+
+

+
+ template<typename R, typename I> +
+ bool cubos::core::data::SerializationMap<R, I>::hasRef(const R& reference) const +

+ + + + + + + + + + + + + + + + +
Parameters
referenceReference to check.
ReturnsTrue if the reference is in the map, false otherwise.
+

Checks if a reference is in the map.

+
+
+

+
+ template<typename R, typename I> +
+ bool cubos::core::data::SerializationMap<R, I>::hasId(const I& id) const +

+ + + + + + + + + + + + + + + + +
Parameters
idSerialized identifier to check.
ReturnsTrue if the serialized identifier is in the map, false otherwise.
+

Checks if a serialized identifier is in the map.

+
+
+

+
+ template<typename R, typename I> +
+ R cubos::core::data::SerializationMap<R, I>::getRef(const I& id) const +

+ + + + + + + + + + + + + + + + +
Parameters
idSerialized identifier to get the reference of.
ReturnsReference of the serialized identifier.
+

Gets the reference of a serialized identifier.

+
+
+

+
+ template<typename R, typename I> +
+ I cubos::core::data::SerializationMap<R, I>::getId(const R& reference) const +

+ + + + + + + + + + + + + + + + +
Parameters
referenceReference to get the serialized identifier of.
ReturnsSerialized identifier of the reference.
+

Gets the serialized identifier of a reference.

+
+
+

+
+ template<typename R, typename I> +
+ std::size_t cubos::core::data::SerializationMap<R, I>::size() const +

+ + + + + + + +
ReturnsNumber of mapped references.
+

Gets the number of mapped references.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Serializer.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Serializer.html new file mode 100644 index 000000000..9f0347d60 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Serializer.html @@ -0,0 +1,654 @@ + + + + + cubos::core::data::Serializer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::Serializer class +

+ +

Abstract class for serializing data in a format-agnostic way. Each serializer implementation is responsible for implementing its own primitive serialization methods: writeI8, writeString, etc.

More complex types can be serialized by implementing a specialization of the cubos::core::data::serialize function:

struct MyType
+{
+    int32_t a;
+};
+
+// In the corresponding .cpp file.
+void cubos::core::data::serialize<MyType>(Serializer& s, const MyType& obj, const char* name)
+{
+    s.write(obj.a, "a");
+}
+
+// Alternatively, the type can define a `serialize` method.
+
+class MyType
+{
+public:
+    void serialize(Serializer& s, const char* name);
+
+private:
+    int32_t a;
+}; 
+
+
+

Derived classes

+
+
+ class BinarySerializer +
+
+
+ class DebugSerializer +
+
+
+ class JSONSerializer +
+
+
+ class Packager +
+
+
+
+
+

Public functions

+
+
+ void flush() virtual +
+
+
+ void writeI8(int8_t value, + const char* name) pure virtual +
+
+
+ void writeI16(int16_t value, + const char* name) pure virtual +
+
+
+ void writeI32(int32_t value, + const char* name) pure virtual +
+
+
+ void writeI64(int64_t value, + const char* name) pure virtual +
+
+
+ void writeU8(uint8_t value, + const char* name) pure virtual +
+
+
+ void writeU16(uint16_t value, + const char* name) pure virtual +
+
+
+ void writeU32(uint32_t value, + const char* name) pure virtual +
+
+
+ void writeU64(uint64_t value, + const char* name) pure virtual +
+
+
+ void writeF32(float value, + const char* name) pure virtual +
+
+
+ void writeF64(double value, + const char* name) pure virtual +
+
+
+ void writeBool(bool value, + const char* name) pure virtual +
+
+
+ void writeString(const char* str, + const char* name) pure virtual +
+
+
+
template<typename T>
+ void write(const T& obj, + const char* name) +
+
+
+ void beginObject(const char* name) pure virtual +
+
+
+ void endObject() pure virtual +
+
Indicates that a object is no longer being serialized.
+
+ void beginArray(std::size_t length, + const char* name) pure virtual +
+
+
+ void endArray() pure virtual +
+
Indicates that a array is no longer being serialized.
+
+ void beginDictionary(std::size_t length, + const char* name) pure virtual +
+
+
+ void endDictionary() pure virtual +
+
Indicates that a dictionary is no longer being serialized.
+
+ auto failed() const -> bool +
+
Checks if the serializer has failed.
+
+ auto context() -> Context& +
+
+
+
+
+

Protected variables

+
+
+ bool mFailBit +
+
Indicates if the serializer failed.
+
+
+
+

Function documentation

+
+

+ void cubos::core::data::Serializer::flush() virtual +

+

Flushes the serializer, guaranteeing that all data has already been processed. This is automatically called when the serializer is destroyed.

+
+
+

+ void cubos::core::data::Serializer::writeI8(int8_t value, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a signed 8 bit integer.

+
+
+

+ void cubos::core::data::Serializer::writeI16(int16_t value, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 16 bit integer.

+
+
+

+ void cubos::core::data::Serializer::writeI32(int32_t value, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 32 bit integer.

+
+
+

+ void cubos::core::data::Serializer::writeI64(int64_t value, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 64 bit integer.

+
+
+

+ void cubos::core::data::Serializer::writeU8(uint8_t value, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 8 bit integer.

+
+
+

+ void cubos::core::data::Serializer::writeU16(uint16_t value, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 16 bit integer.

+
+
+

+ void cubos::core::data::Serializer::writeU32(uint32_t value, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 32 bit integer.

+
+
+

+ void cubos::core::data::Serializer::writeU64(uint64_t value, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 64 bit integer.

+
+
+

+ void cubos::core::data::Serializer::writeF32(float value, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a float.

+
+
+

+ void cubos::core::data::Serializer::writeF64(double value, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a double.

+
+
+

+ void cubos::core::data::Serializer::writeBool(bool value, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a boolean.

+
+
+

+ void cubos::core::data::Serializer::writeString(const char* str, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
strThe string to serialize.
nameThe name of the value (optional).
+

Serializes a string.

+
+
+

+
+ template<typename T> +
+ void cubos::core::data::Serializer::write(const T& obj, + const char* name) +

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the object.
Parameters
objThe object to serialize.
nameThe name of the object (optional).
+

Serializes an object. The cubos::core::data::serialize function must be implemented for the given type.

+
+
+

+ void cubos::core::data::Serializer::beginObject(const char* name) pure virtual +

+ + + + + + + + + + +
Parameters
nameThe name of the object (optional).
+

Indicates that a object is currently being serialized.

+
+
+

+ void cubos::core::data::Serializer::beginArray(std::size_t length, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
lengthThe length of the array.
nameThe name of the array (optional).
+

Indicates that a array is currently being serialized.

+
+
+

+ void cubos::core::data::Serializer::beginDictionary(std::size_t length, + const char* name) pure virtual +

+ + + + + + + + + + + + + + +
Parameters
lengthThe length of the dictionary.
nameThe name of the dictionary (optional).
+

Indicates that a dictionary is currently being serialized.

+
+
+

+ Context& cubos::core::data::Serializer::context() +

+ + + + + + + +
ReturnsThe context of the serializer.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1StandardArchive.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1StandardArchive.html new file mode 100644 index 000000000..1f9813823 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1StandardArchive.html @@ -0,0 +1,432 @@ + + + + + cubos::core::data::StandardArchive class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::StandardArchive class +
#include <core/data/fs/standard_archive.hpp>
+

+

Archive implementation which reads and writes from/into the OS file system using the standard library.

+ +

Can represent both regular files and directories.

+
+

Base classes

+
+
+ class Archive +
+
Interface for a bridge between the CUBOS. virtual file system and the real world.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ StandardArchive(const std::filesystem::path& osPath, + bool isDirectory, + bool readOnly) +
+
Constructs pointing to the regular file or directory with the given osPath.
+
+
+
+

Public functions

+
+
+ auto create(std::size_t parent, + std::string_view name, + bool directory = false) -> std::size_t override +
+
Creates a new file in the archive.
+
+ auto destroy(std::size_t id) -> bool override +
+
Destroys a regular file or empty directory in the archive.
+
+ auto name(std::size_t id) const -> std::string override +
+
Gets the name of the file with the given id.
+
+ auto directory(std::size_t id) const -> bool override +
+
Checks whether the file with the given id is a directory.
+
+ auto readOnly() const -> bool override +
+
Checks whether the archive is read-only.
+
+ auto parent(std::size_t id) const -> std::size_t override +
+
Gets the identifier of the parent file of the file with the given id.
+
+ auto sibling(std::size_t id) const -> std::size_t override +
+
Gets the identifier of the sibling of the file with the given id.
+
+ auto child(std::size_t id) const -> std::size_t override +
+
Gets the identifier of the first child of the file with the given id.
+
+ auto open(std::size_t id, + File::Handle handle, + File::OpenMode mode) -> std::unique_ptr<memory::Stream> override +
+
Opens a file in the archive.
+
+
+
+

Function documentation

+
+

+ cubos::core::data::StandardArchive::StandardArchive(const std::filesystem::path& osPath, + bool isDirectory, + bool readOnly) +

+

Constructs pointing to the regular file or directory with the given osPath.

+ + + + + + + + + + + + + + + + + + +
Parameters
osPathThe path to the file/directory in the real file system.
isDirectoryWhether the path is a directory or a file.
readOnlyTrue if the archive is read-only, false otherwise.
+

If readOnly is false and there's no file or directory at osPath, then it is created.

+
+
+

+ std::size_t cubos::core::data::StandardArchive::create(std::size_t parent, + std::string_view name, + bool directory = false) override +

+

Creates a new file in the archive.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
parentParent directory of the new file.
nameName of the new file.
directoryWhether the new file is a directory or not.
ReturnsIdentifier of the file, or 0 if the file could not be created.
+

The first child of the parent will have its sibling set to the new file and then be replaced by the new file.

+
+
+

+ bool cubos::core::data::StandardArchive::destroy(std::size_t id) override +

+

Destroys a regular file or empty directory in the archive.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsWhether the file was destroyed successfully.
+

Will be replaced in the tree by its sibling.

+
+
+

+ std::string cubos::core::data::StandardArchive::name(std::size_t id) const override +

+

Gets the name of the file with the given id.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsName of the file.
+
+
+

+ bool cubos::core::data::StandardArchive::directory(std::size_t id) const override +

+

Checks whether the file with the given id is a directory.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsWhether the file is a directory or not.
+
+
+

+ bool cubos::core::data::StandardArchive::readOnly() const override +

+

Checks whether the archive is read-only.

+ + + + + + + +
ReturnsWhether the archive is read-only.
+
+
+

+ std::size_t cubos::core::data::StandardArchive::parent(std::size_t id) const override +

+

Gets the identifier of the parent file of the file with the given id.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsIdentifier of the parent file, or 0 if the file is the root file.
+
+
+

+ std::size_t cubos::core::data::StandardArchive::sibling(std::size_t id) const override +

+

Gets the identifier of the sibling of the file with the given id.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsIdentifier of the sibling, or 0 if there are no more files in the parent.
+
+
+

+ std::size_t cubos::core::data::StandardArchive::child(std::size_t id) const override +

+

Gets the identifier of the first child of the file with the given id.

+ + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
ReturnsIdentifier of the first child, or 0 if the file is not a directory or is empty.
+
+
+

+ std::unique_ptr<memory::Stream> cubos::core::data::StandardArchive::open(std::size_t id, + File::Handle handle, + File::OpenMode mode) override +

+

Opens a file in the archive.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
idIdentifier of the file.
handleHandle to the file.
modeMode to open the file in.
ReturnsFile stream, or nullptr if the file could not be opened.
+

Although a bit hacky, the handle parameter is used to keep a reference to the respective File alive, preventing the file from being destroyed while the stream is open.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Unpackager.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Unpackager.html new file mode 100644 index 000000000..63b660656 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1Unpackager.html @@ -0,0 +1,483 @@ + + + + + cubos::core::data::Unpackager class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::Unpackager class +

+

Responsible for deserializing packages into types.

+ +
+

Base classes

+
+
+ class Deserializer +
+
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ Unpackager(const Package& pkg) +
+
+
+
+
+

Public functions

+
+
+ void readI8(int8_t& value) override +
+
+
+ void readI16(int16_t& value) override +
+
+
+ void readI32(int32_t& value) override +
+
+
+ void readI64(int64_t& value) override +
+
+
+ void readU8(uint8_t& value) override +
+
+
+ void readU16(uint16_t& value) override +
+
+
+ void readU32(uint32_t& value) override +
+
+
+ void readU64(uint64_t& value) override +
+
+
+ void readF32(float& value) override +
+
+
+ void readF64(double& value) override +
+
+
+ void readBool(bool& value) override +
+
+
+ void readString(std::string& value) override +
+
+
+ void beginObject() override +
+
+
+ void endObject() override +
+
+
+ auto beginArray() -> std::size_t override +
+
+
+ void endArray() override +
+
+
+ auto beginDictionary() -> std::size_t override +
+
+
+ void endDictionary() override +
+
+
+
+
+

Function documentation

+
+

+ cubos::core::data::Unpackager::Unpackager(const Package& pkg) +

+ + + + + + + + + + +
Parameters
pkgThe package to read from.
+
+
+

+ void cubos::core::data::Unpackager::readI8(int8_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 8 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Unpackager::readI16(int16_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 16 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Unpackager::readI32(int32_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 32 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Unpackager::readI64(int64_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a signed 64 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Unpackager::readU8(uint8_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 8 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Unpackager::readU16(uint16_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 16 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Unpackager::readU32(uint32_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 32 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Unpackager::readU64(uint64_t& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes an unsigned 64 bit integer. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Unpackager::readF32(float& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a float. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Unpackager::readF64(double& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a double. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Unpackager::readBool(bool& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a boolean. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Unpackager::readString(std::string& value) override +

+ + + + + + + + + + +
Parameters
valueThe value to deserialize.
+

Deserializes a string. The fail bit is set if the deserialization fails.

+
+
+

+ void cubos::core::data::Unpackager::beginObject() override +

+

Indicates that a object is currently being deserialized. The fail bit is set on failure.

+
+
+

+ void cubos::core::data::Unpackager::endObject() override +

+

Indicates that a object is no longer being deserialized. The fail bit is set on failure.

+
+
+

+ std::size_t cubos::core::data::Unpackager::beginArray() override +

+ + + + + + + +
ReturnsThe length of the array.
+

Indicates that an array is currently being deserialized. The fail bit is set on failure.

+
+
+

+ void cubos::core::data::Unpackager::endArray() override +

+

Indicates that an array is no longer being deserialized. The fail bit is set on failure.

+
+
+

+ std::size_t cubos::core::data::Unpackager::beginDictionary() override +

+ + + + + + + +
ReturnsThe length of the dictionary (always 0 on failure).
+

Indicates that a dictionary is being deserialized. The fail bit is set on failure.

+
+
+

+ void cubos::core::data::Unpackager::endDictionary() override +

+

Indicates that a dictionary is no longer being deserialized. The fail bit is set on failure.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1impl_1_1Packager.html b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1impl_1_1Packager.html new file mode 100644 index 000000000..2889d38a6 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1data_1_1impl_1_1Packager.html @@ -0,0 +1,540 @@ + + + + + cubos::core::data::impl::Packager class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::impl::Packager class +

+ +

Responsible for serializing types into packages. Should never be used directly.

+
+

Base classes

+
+
+ class cubos::core::data::Serializer +
+
+
+
+
+

Public functions

+
+
+ void writeI8(int8_t value, + const char* name) override +
+
+
+ void writeI16(int16_t value, + const char* name) override +
+
+
+ void writeI32(int32_t value, + const char* name) override +
+
+
+ void writeI64(int64_t value, + const char* name) override +
+
+
+ void writeU8(uint8_t value, + const char* name) override +
+
+
+ void writeU16(uint16_t value, + const char* name) override +
+
+
+ void writeU32(uint32_t value, + const char* name) override +
+
+
+ void writeU64(uint64_t value, + const char* name) override +
+
+
+ void writeF32(float value, + const char* name) override +
+
+
+ void writeF64(double value, + const char* name) override +
+
+
+ void writeBool(bool value, + const char* name) override +
+
+
+ void writeString(const char* str, + const char* name) override +
+
+
+ void beginObject(const char* name) override +
+
+
+ void endObject() override +
+
Indicates that a object is no longer being serialized.
+
+ void beginArray(std::size_t length, + const char* name) override +
+
+
+ void endArray() override +
+
Indicates that a array is no longer being serialized.
+
+ void beginDictionary(std::size_t length, + const char* name) override +
+
+
+ void endDictionary() override +
+
Indicates that a dictionary is no longer being serialized.
+
+
+
+

Function documentation

+
+

+ void cubos::core::data::impl::Packager::writeI8(int8_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a signed 8 bit integer.

+
+
+

+ void cubos::core::data::impl::Packager::writeI16(int16_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 16 bit integer.

+
+
+

+ void cubos::core::data::impl::Packager::writeI32(int32_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 32 bit integer.

+
+
+

+ void cubos::core::data::impl::Packager::writeI64(int64_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an signed 64 bit integer.

+
+
+

+ void cubos::core::data::impl::Packager::writeU8(uint8_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 8 bit integer.

+
+
+

+ void cubos::core::data::impl::Packager::writeU16(uint16_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 16 bit integer.

+
+
+

+ void cubos::core::data::impl::Packager::writeU32(uint32_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 32 bit integer.

+
+
+

+ void cubos::core::data::impl::Packager::writeU64(uint64_t value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes an unsigned 64 bit integer.

+
+
+

+ void cubos::core::data::impl::Packager::writeF32(float value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a float.

+
+
+

+ void cubos::core::data::impl::Packager::writeF64(double value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a double.

+
+
+

+ void cubos::core::data::impl::Packager::writeBool(bool value, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
valueThe value to serialize.
nameThe name of the value (optional).
+

Serializes a boolean.

+
+
+

+ void cubos::core::data::impl::Packager::writeString(const char* str, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
strThe string to serialize.
nameThe name of the value (optional).
+

Serializes a string.

+
+
+

+ void cubos::core::data::impl::Packager::beginObject(const char* name) override +

+ + + + + + + + + + +
Parameters
nameThe name of the object (optional).
+

Indicates that a object is currently being serialized.

+
+
+

+ void cubos::core::data::impl::Packager::beginArray(std::size_t length, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
lengthThe length of the array.
nameThe name of the array (optional).
+

Indicates that a array is currently being serialized.

+
+
+

+ void cubos::core::data::impl::Packager::beginDictionary(std::size_t length, + const char* name) override +

+ + + + + + + + + + + + + + +
Parameters
lengthThe length of the dictionary.
nameThe name of the dictionary (optional).
+

Indicates that a dictionary is currently being serialized.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1AnySystemWrapper.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1AnySystemWrapper.html new file mode 100644 index 000000000..b46dd8c63 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1AnySystemWrapper.html @@ -0,0 +1,245 @@ + + + + + cubos::core::ecs::AnySystemWrapper class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/system.hpp>
+
template<typename R>
+ cubos::core::ecs::AnySystemWrapper class +

+

Base class for system wrappers.

+ + + + + + + + + + +
Template parameters
RReturn type of the wrapped system.
+ +
+

Constructors, destructors, conversion operators

+
+
+ AnySystemWrapper(SystemInfo&& info) +
+
Constructs.
+
+
+
+

Public functions

+
+
+ void prepare(World& world) pure virtual +
+
Prepares the system for being executed on the given world.
+
+ auto call(World& world, + CommandBuffer& commands) -> R pure virtual +
+
Calls the wrapped system with parameters taken from the given world.
+
+ auto info() const -> const SystemInfo& +
+
Gets information about the requirements of the system.
+
+
+
+

Function documentation

+
+

+
+ template<typename R> +
+ cubos::core::ecs::AnySystemWrapper<R>::AnySystemWrapper(SystemInfo&& info) +

+

Constructs.

+ + + + + + + + + + +
Parameters
infoInformation about the wrapped system.
+
+
+

+
+ template<typename R> +
+ void cubos::core::ecs::AnySystemWrapper<R>::prepare(World& world) pure virtual +

+

Prepares the system for being executed on the given world.

+ + + + + + + + + + +
Parameters
worldWorld to prepare the system for.
+

Requires exclusive access to the world and must be called before calling the system.

+
+
+

+
+ template<typename R> +
+ R cubos::core::ecs::AnySystemWrapper<R>::call(World& world, + CommandBuffer& commands) pure virtual +

+

Calls the wrapped system with parameters taken from the given world.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
worldWorld used by the system.
commandsBuffer where commands can be submitted to.
ReturnsReturn value of the system.
+

Can only be called after calling prepare() on the same world.

+
+
+

+
+ template<typename R> +
+ const SystemInfo& cubos::core::ecs::AnySystemWrapper<R>::info() const +

+

Gets information about the requirements of the system.

+ + + + + + + +
ReturnsInformation about the system.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Blueprint.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Blueprint.html new file mode 100644 index 000000000..16ba8a1df --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Blueprint.html @@ -0,0 +1,312 @@ + + + + + cubos::core::ecs::Blueprint class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::Blueprint class final +
#include <core/ecs/blueprint.hpp>
+

+

Stores a bundle of entities and their respective components, which can be easily spawned into a world. This is in a way the 'Prefab' of CUBOS., but lower level.

+ +
+

Constructors, destructors, conversion operators

+
+
+ Blueprint() defaulted +
+
Constructs an empty blueprint.
+
+ Blueprint(Blueprint&&) defaulted +
+
Move constructs.
+
+
+
+

Public functions

+
+
+
template<typename... ComponentTypes>
+ auto create(const std::string& name, + const ComponentTypes&... components) -> Entity +
+
Creates a new entity and returns its identifier.
+
+
template<typename... ComponentTypes>
+ void add(Entity entity, + const ComponentTypes&... components) +
+
Adds components to an entity.
+
+ auto addFromDeserializer(Entity entity, + const std::string& name, + data::Deserializer& deserializer) -> bool +
+
Deserializes a component and adds it to an entity.
+
+ auto entity(const std::string& name) const -> Entity +
+
Returns an entity from its name.
+
+ void merge(const std::string& prefix, + const Blueprint& other) +
+
Merges another blueprint into this one.
+
+ void clear() +
+
Clears the blueprint, removing any added entities and components.
+
+
+
+

Function documentation

+
+

+
+ template<typename... ComponentTypes> +
+ Entity cubos::core::ecs::Blueprint::create(const std::string& name, + const ComponentTypes&... components) +

+

Creates a new entity and returns its identifier.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypesComponent types.
Parameters
nameEntity name.
componentsComponents to add.
ReturnsEntity identifier.
+
+
+

+
+ template<typename... ComponentTypes> +
+ void cubos::core::ecs::Blueprint::add(Entity entity, + const ComponentTypes&... components) +

+

Adds components to an entity.

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypesComponent types.
Parameters
entityEntity identifier.
componentsComponents to add.
+
+
+

+ bool cubos::core::ecs::Blueprint::addFromDeserializer(Entity entity, + const std::string& name, + data::Deserializer& deserializer) +

+

Deserializes a component and adds it to an entity.

+ + + + + + + + + + + + + + + + + + +
Parameters
entityEntity identifier.
nameComponent type name.
deserializerDdeserializer to deserialize from.
+
+
+

+ Entity cubos::core::ecs::Blueprint::entity(const std::string& name) const +

+

Returns an entity from its name.

+ + + + + + + + + + + + + + + + +
Parameters
nameEntity name.
ReturnsEntity identifier, or null entity if not found.
+
+
+

+ void cubos::core::ecs::Blueprint::merge(const std::string& prefix, + const Blueprint& other) +

+

Merges another blueprint into this one.

+ + + + + + + + + + + + + + +
Parameters
prefixName to prefix with the merged blueprint.
otherOther blueprint to merge.
+ +
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1BlueprintBuilder.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1BlueprintBuilder.html new file mode 100644 index 000000000..0f68737c8 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1BlueprintBuilder.html @@ -0,0 +1,236 @@ + + + + + cubos::core::ecs::BlueprintBuilder class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::BlueprintBuilder class final +
#include <core/ecs/commands.hpp>
+

+

Used to edit a blueprint spawned by a Commands object.

+ +
+

Public functions

+
+
+ auto entity(const std::string& name) const -> Entity +
+
Gets an entity of the spawned blueprint.
+
+
template<typename ComponentType>
+ auto get(const std::string& name) -> ComponentType& +
+
Gets a reference to a component of an entity of the spawned blueprint.
+
+
template<typename... ComponentTypes>
+ auto add(const std::string& name, + ComponentTypes && ... components) -> BlueprintBuilder& +
+
Adds components to the blueprint.
+
+
+
+

Function documentation

+
+

+ Entity cubos::core::ecs::BlueprintBuilder::entity(const std::string& name) const +

+

Gets an entity of the spawned blueprint.

+ + + + + + + + + + + + + + + + +
Parameters
nameEntity name.
ReturnsEntity identifier.
+

Aborts if the name does not match any entity of the blueprint.

+
+
+

+
+ template<typename ComponentType> +
+ ComponentType& cubos::core::ecs::BlueprintBuilder::get(const std::string& name) +

+

Gets a reference to a component of an entity of the spawned blueprint.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypeComponent type.
Parameters
nameEntity name.
ReturnsReference to the component.
+

Aborts if name does not match any entity of the blueprint.

+
+
+

+
+ template<typename... ComponentTypes> +
+ BlueprintBuilder& cubos::core::ecs::BlueprintBuilder::add(const std::string& name, + ComponentTypes && ... components) +

+

Adds components to the blueprint.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypesComponent types.
Parameters
nameEntity name.
componentsComponents to add.
ReturnsReference to this builder, for chaining.
+

Aborts if name does not match any entity of the blueprint.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1CommandBuffer.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1CommandBuffer.html new file mode 100644 index 000000000..11fd170b2 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1CommandBuffer.html @@ -0,0 +1,317 @@ + + + + + cubos::core::ecs::CommandBuffer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::CommandBuffer class final +
#include <core/ecs/commands.hpp>
+

+

Stores commands to execute them later.

+ +
+

Constructors, destructors, conversion operators

+
+
+ CommandBuffer(World& world) +
+
Constructs.
+
+
+
+

Public functions

+
+
+
template<typename... ComponentTypes>
+ void add(Entity entity, + ComponentTypes && ... components) +
+
Adds components to an entity.
+
+
template<typename... ComponentTypes>
+ void remove(Entity entity) +
+
Removes components from an entity.
+
+
template<typename... ComponentTypes>
+ auto create(ComponentTypes && ... components) -> EntityBuilder +
+
Creates a new entity with the given components.
+
+ void destroy(Entity entity) +
+
Destroys an entity.
+
+ auto spawn(const Blueprint& blueprint) -> BlueprintBuilder +
+
Spawns a blueprint into the world.
+
+ void abort() +
+
Aborts the commands, rolling back any changes made.
+
+ void commit() +
+
Commits the commands to the world.
+
+
+
+

Function documentation

+
+

+ cubos::core::ecs::CommandBuffer::CommandBuffer(World& world) +

+

Constructs.

+ + + + + + + + + + +
Parameters
worldWorld to which the commands will be applied.
+
+
+

+
+ template<typename... ComponentTypes> +
+ void cubos::core::ecs::CommandBuffer::add(Entity entity, + ComponentTypes && ... components) +

+

Adds components to an entity.

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypesComponent types.
Parameters
entityEntity identifier.
componentsComponents to add.
+
+
+

+
+ template<typename... ComponentTypes> +
+ void cubos::core::ecs::CommandBuffer::remove(Entity entity) +

+

Removes components from an entity.

+ + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypesComponent types.
Parameters
entityEntity identifier.
+
+
+

+
+ template<typename... ComponentTypes> +
+ EntityBuilder cubos::core::ecs::CommandBuffer::create(ComponentTypes && ... components) +

+

Creates a new entity with the given components.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypesComponent types.
Parameters
componentsComponents to create with.
ReturnsEntity identifier.
+
+
+

+ void cubos::core::ecs::CommandBuffer::destroy(Entity entity) +

+

Destroys an entity.

+ + + + + + + + + + +
Parameters
entityEntity identifier.
+
+
+

+ BlueprintBuilder cubos::core::ecs::CommandBuffer::spawn(const Blueprint& blueprint) +

+

Spawns a blueprint into the world.

+ + + + + + + + + + + + + + + + +
Parameters
blueprintBlueprint to spawn.
ReturnsBlueprint builder.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Commands.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Commands.html new file mode 100644 index 000000000..318e4087a --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Commands.html @@ -0,0 +1,314 @@ + + + + + cubos::core::ecs::Commands class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::Commands class final +
#include <core/ecs/commands.hpp>
+

+

Used to write ECS commands and execute them at a later time.

+ +

Internally wraps a reference to a CommandBuffer object.

+
+

Constructors, destructors, conversion operators

+
+
+ Commands(CommandBuffer& buffer) +
+
Constructs.
+
+ Commands(Commands&&) defaulted +
+
Move constructor.
+
+
+
+

Public functions

+
+
+
template<typename... ComponentTypes>
+ void add(Entity entity, + ComponentTypes && ... components) +
+
Adds components to an entity.
+
+
template<typename... ComponentTypes>
+ void remove(Entity entity) +
+
Removes components from an entity.
+
+
template<typename... ComponentTypes>
+ auto create(ComponentTypes && ... components) -> EntityBuilder +
+
Creates a new entity with the given components.
+
+ void destroy(Entity entity) +
+
Destroys an entity.
+
+ auto spawn(const Blueprint& blueprint) -> BlueprintBuilder +
+
Spawns a blueprint into the world.
+
+
+
+

Function documentation

+
+

+ cubos::core::ecs::Commands::Commands(CommandBuffer& buffer) +

+

Constructs.

+ + + + + + + + + + +
Parameters
bufferCommand buffer to write to.
+
+
+

+
+ template<typename... ComponentTypes> +
+ void cubos::core::ecs::Commands::add(Entity entity, + ComponentTypes && ... components) +

+

Adds components to an entity.

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypesComponent types.
Parameters
entityEntity identifier.
componentsComponents to add.
+
+
+

+
+ template<typename... ComponentTypes> +
+ void cubos::core::ecs::Commands::remove(Entity entity) +

+

Removes components from an entity.

+ + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypesComponent types.
Parameters
entityEntity identifier.
+
+
+

+
+ template<typename... ComponentTypes> +
+ EntityBuilder cubos::core::ecs::Commands::create(ComponentTypes && ... components) +

+

Creates a new entity with the given components.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypesComponent types.
Parameters
componentsComponents to create with.
ReturnsEntity identifier.
+
+
+

+ void cubos::core::ecs::Commands::destroy(Entity entity) +

+

Destroys an entity.

+ + + + + + + + + + +
Parameters
entityEntity identifier.
+
+
+

+ BlueprintBuilder cubos::core::ecs::Commands::spawn(const Blueprint& blueprint) +

+

Spawns a blueprint into the world.

+ + + + + + + + + + + + + + + + +
Parameters
blueprintBlueprint to spawn.
ReturnsBlueprint builder.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1ComponentManager.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1ComponentManager.html new file mode 100644 index 000000000..ff9ccb5dc --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1ComponentManager.html @@ -0,0 +1,522 @@ + + + + + cubos::core::ecs::ComponentManager class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::ComponentManager class final +
#include <core/ecs/component_manager.hpp>
+

+

Holds and manages components.

+ +

Used internally by World.

+
+

Public functions

+
+
+
template<typename T>
+ void registerComponent() +
+
Registers a new component type with the component manager.
+
+ void registerComponent(std::type_index type) +
+
Registers a new component type with the component manager.
+
+ auto getIDFromIndex(std::type_index type) const -> std::size_t +
+
Gets the identifier of a registered component type.
+
+
template<typename T>
+ auto getID() const -> std::size_t +
+
Gets the identifier of a registered component type.
+
+ auto getType(std::size_t id) const -> std::type_index +
+
Gets the type of a component from its identifier.
+
+
template<typename T>
+ auto read() const -> ReadStorage<T> +
+
Locks a storage for reading and returns it.
+
+
template<typename T>
+ auto write() const -> WriteStorage<T> +
+
Locks a storage for writing and returns it.
+
+
template<typename T>
+ void add(uint32_t id, + T value) +
+
Adds a component to an entity.
+
+
template<typename T>
+ void remove(uint32_t id) +
+
Removes a component from an entity.
+
+ void remove(uint32_t id, + std::size_t componentId) +
+
Removes a component from an entity.
+
+ void removeAll(uint32_t id) +
+
Removes all components from an entity.
+
+ auto pack(uint32_t id, + std::size_t componentId, + data::Context* context) const -> data::Package +
+
Creates a package from a component of an entity.
+
+ auto unpack(uint32_t id, + std::size_t componentId, + const data::Package& package, + data::Context* context) -> bool +
+
Inserts a component into an entity, by unpacking a package.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ void cubos::core::ecs::ComponentManager::registerComponent() +

+

Registers a new component type with the component manager.

+ + + + + + + + + + +
Template parameters
TType of the component.
+

Must be called before any component of this type is used in any way.

+
+
+

+ void cubos::core::ecs::ComponentManager::registerComponent(std::type_index type) +

+

Registers a new component type with the component manager.

+ + + + + + + + + + +
Parameters
typeType of the component.
+

Must be called before any component of this type is used in any way.

+
+
+

+ std::size_t cubos::core::ecs::ComponentManager::getIDFromIndex(std::type_index type) const +

+

Gets the identifier of a registered component type.

+ + + + + + + + + + + + + + + + +
Parameters
typeComponent type.
ReturnsComponent identifier.
+
+
+

+
+ template<typename T> +
+ std::size_t cubos::core::ecs::ComponentManager::getID() const +

+

Gets the identifier of a registered component type.

+ + + + + + + + + + + + + + + + +
Template parameters
TComponent type.
ReturnsComponent identifier.
+
+
+

+ std::type_index cubos::core::ecs::ComponentManager::getType(std::size_t id) const +

+

Gets the type of a component from its identifier.

+ + + + + + + + + + + + + + + + +
Parameters
idComponent identifier.
ReturnsComponent type index.
+
+
+

+
+ template<typename T> +
+ ReadStorage<T> cubos::core::ecs::ComponentManager::read() const +

+

Locks a storage for reading and returns it.

+ + + + + + + + + + + + + + + + +
Template parameters
TComponent type.
ReturnsStorage lock.
+
+
+

+
+ template<typename T> +
+ WriteStorage<T> cubos::core::ecs::ComponentManager::write() const +

+

Locks a storage for writing and returns it.

+ + + + + + + + + + + + + + + + +
Template parameters
TComponent type.
ReturnsStorage lock.
+
+
+

+
+ template<typename T> +
+ void cubos::core::ecs::ComponentManager::add(uint32_t id, + T value) +

+

Adds a component to an entity.

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TComponent type.
Parameters
idEntity index.
valueInitial component value.
+
+
+

+
+ template<typename T> +
+ void cubos::core::ecs::ComponentManager::remove(uint32_t id) +

+

Removes a component from an entity.

+ + + + + + + + + + + + + + + + + + + +
Template parameters
TComponent type.
Parameters
idEntity index.
+
+
+

+ void cubos::core::ecs::ComponentManager::remove(uint32_t id, + std::size_t componentId) +

+

Removes a component from an entity.

+ + + + + + + + + + + + + + +
Parameters
idEntity index.
componentIdComponent identifier.
+
+
+

+ void cubos::core::ecs::ComponentManager::removeAll(uint32_t id) +

+

Removes all components from an entity.

+ + + + + + + + + + +
Parameters
idEntity index.
+
+
+

+ data::Package cubos::core::ecs::ComponentManager::pack(uint32_t id, + std::size_t componentId, + data::Context* context) const +

+

Creates a package from a component of an entity.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
idEntity index.
componentIdComponent identifier.
contextOptional context to use for serialization.
ReturnsPackage containing the component.
+
+
+

+ bool cubos::core::ecs::ComponentManager::unpack(uint32_t id, + std::size_t componentId, + const data::Package& package, + data::Context* context) +

+

Inserts a component into an entity, by unpacking a package.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
idEntity index.
componentIdComponent identifier.
packagePackage to unpack.
contextOptional context to use for deserialization.
ReturnsWhether the unpacking was successful.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Dispatcher.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Dispatcher.html new file mode 100644 index 000000000..abeb8d288 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Dispatcher.html @@ -0,0 +1,475 @@ + + + + + cubos::core::ecs::Dispatcher class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::Dispatcher class +
#include <core/ecs/dispatcher.hpp>
+

+

Used to add systems and relations between them and then dispatch them all at once.

+ +
+

Public functions

+
+
+ void addTag(const std::string& tag) +
+
Adds a tag, and sets it as the current tag for further settings.
+
+ void tagInheritTag(const std::string& tag) +
+
Makes the current tag inherit the settings of another tag.
+
+ void tagSetAfterTag(const std::string& tag) +
+
Makes the current tag run after the given tag.
+
+ void tagSetBeforeTag(const std::string& tag) +
+
Makes the current tag run before the given tag.
+
+
template<typename F>
+ void tagAddCondition(F func) +
+
Adds a condition to the current tag.
+
+
template<typename F>
+ void addSystem(F func) +
+
Adds a system, and sets it as the current system for further configuration.
+
+ void systemAddTag(const std::string& tag) +
+
Sets the tag for the current system.
+
+ void systemSetAfterTag(const std::string& tag) +
+
Sets the current system to run after the tag.
+
+
template<typename F>
+ void systemSetAfterSystem(F func) +
+
Sets the current system to run after a given system.
+
+ void systemSetBeforeTag(const std::string& tag) +
+
Sets the current system to run before the tag.
+
+
template<typename F>
+ void systemSetBeforeSystem(F func) +
+
Sets the current system to run before the system.
+
+
template<typename F>
+ void systemAddCondition(F func) +
+
Adds a condition to the current system.
+
+ void compileChain() +
+
Compiles the call chain. Required before callSystems() can be called.
+
+ void callSystems(World& world, + CommandBuffer& cmds) +
+
Calls all systems in the compiled call chain. compileChain() must be called prior to this.
+
+
+
+

Function documentation

+
+

+ void cubos::core::ecs::Dispatcher::addTag(const std::string& tag) +

+

Adds a tag, and sets it as the current tag for further settings.

+ + + + + + + + + + +
Parameters
tagTag to add.
+
+
+

+ void cubos::core::ecs::Dispatcher::tagInheritTag(const std::string& tag) +

+

Makes the current tag inherit the settings of another tag.

+ + + + + + + + + + +
Parameters
tagTag to inherit from.
+
+
+

+ void cubos::core::ecs::Dispatcher::tagSetAfterTag(const std::string& tag) +

+

Makes the current tag run after the given tag.

+ + + + + + + + + + +
Parameters
tagTag to run after.
+
+
+

+ void cubos::core::ecs::Dispatcher::tagSetBeforeTag(const std::string& tag) +

+

Makes the current tag run before the given tag.

+ + + + + + + + + + +
Parameters
tagTag to run before.
+
+
+

+
+ template<typename F> +
+ void cubos::core::ecs::Dispatcher::tagAddCondition(F func) +

+

Adds a condition to the current tag.

+ + + + + + + + + + + + + + + + + + + +
Template parameters
FCondition type.
Parameters
funcCondition to add.
+
+
+

+
+ template<typename F> +
+ void cubos::core::ecs::Dispatcher::addSystem(F func) +

+

Adds a system, and sets it as the current system for further configuration.

+ + + + + + + + + + + + + + + + + + + +
Template parameters
FSystem type.
Parameters
funcSystem to add.
+
+
+

+ void cubos::core::ecs::Dispatcher::systemAddTag(const std::string& tag) +

+

Sets the tag for the current system.

+ + + + + + + + + + +
Parameters
tagTag to run under.
+
+
+

+ void cubos::core::ecs::Dispatcher::systemSetAfterTag(const std::string& tag) +

+

Sets the current system to run after the tag.

+ + + + + + + + + + +
Parameters
tagTag to run after.
+
+
+

+
+ template<typename F> +
+ void cubos::core::ecs::Dispatcher::systemSetAfterSystem(F func) +

+

Sets the current system to run after a given system.

+ + + + + + + + + + + + + + + + + + + +
Template parameters
FSystem type.
Parameters
funcSystem to run after.
+
+
+

+ void cubos::core::ecs::Dispatcher::systemSetBeforeTag(const std::string& tag) +

+

Sets the current system to run before the tag.

+ + + + + + + + + + +
Parameters
tagTag to run before.
+
+
+

+
+ template<typename F> +
+ void cubos::core::ecs::Dispatcher::systemSetBeforeSystem(F func) +

+

Sets the current system to run before the system.

+ + + + + + + + + + + + + + + + + + + +
Template parameters
FSystem type.
Parameters
funcSystem to run before.
+
+
+

+
+ template<typename F> +
+ void cubos::core::ecs::Dispatcher::systemAddCondition(F func) +

+

Adds a condition to the current system.

+ + + + + + + + + + + + + + + + + + + +
Template parameters
FCondition type.
Parameters
funcCondition.
+
+
+

+ void cubos::core::ecs::Dispatcher::compileChain() +

+

Compiles the call chain. Required before callSystems() can be called.

+

Takes all pending systems and determines their execution order.

+
+
+

+ void cubos::core::ecs::Dispatcher::callSystems(World& world, + CommandBuffer& cmds) +

+

Calls all systems in the compiled call chain. compileChain() must be called prior to this.

+ + + + + + + + + + + + + + +
Parameters
worldWorld to call the systems in.
cmdsCommand buffer.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Entity.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Entity.html new file mode 100644 index 000000000..441279403 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Entity.html @@ -0,0 +1,196 @@ + + + + + cubos::core::ecs::Entity class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::Entity class +
#include <core/ecs/entity_manager.hpp>
+

+

Identifies an entity.

+ +

When serializing/deserializing, if there's a data::SerializationMap<Entity, std::string> in the context, it will be used to (de)serialize strings representing the entities. Otherwise, the identifiers will be (de)serialized as objects with two fields: their index and their generation.

+
+

Public types

+
+
+ using Mask = std::bitset<CUBOS_CORE_ECS_MAX_COMPONENTS+1> +
+
Type used to store which components an entity has.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ Entity(uint32_t index, + uint32_t generation) +
+
Constructs an entity from an index and a generation.
+
+
+
+

Public functions

+
+
+ auto isNull() const -> bool +
+
Checks if the entity is null, a special value returned on errors.
+
+
+
+

Public variables

+
+
+ uint32_t index +
+
Index in storages.
+
+ uint32_t generation +
+
Allows us to detect if the entity has been removed.
+
+
+
+

Function documentation

+
+

+ cubos::core::ecs::Entity::Entity(uint32_t index, + uint32_t generation) +

+

Constructs an entity from an index and a generation.

+ + + + + + + + + + + + + + +
Parameters
indexEntity index.
generationEntity generation.
+
+
+

+ bool cubos::core::ecs::Entity::isNull() const +

+

Checks if the entity is null, a special value returned on errors.

+ + + + + + + +
ReturnsWhether the entity is null.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EntityBuilder.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EntityBuilder.html new file mode 100644 index 000000000..08c0aa2d1 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EntityBuilder.html @@ -0,0 +1,209 @@ + + + + + cubos::core::ecs::EntityBuilder class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::EntityBuilder class final +
#include <core/ecs/commands.hpp>
+

+

Allows editing an entity created by a Commands object.

+ +
+

Public functions

+
+
+ auto entity() const -> Entity +
+
Gets the entity this builder is editing.
+
+
template<typename ComponentType>
+ auto get() -> ComponentType& +
+
Gets a reference to a component of the entity.
+
+
template<typename... ComponentTypes>
+ auto add(ComponentTypes && ... components) -> EntityBuilder& +
+
Adds components to the entity.
+
+
+
+

Function documentation

+
+

+ Entity cubos::core::ecs::EntityBuilder::entity() const +

+

Gets the entity this builder is editing.

+ + + + + + + +
ReturnsEntity identifier.
+
+
+

+
+ template<typename ComponentType> +
+ ComponentType& cubos::core::ecs::EntityBuilder::get() +

+

Gets a reference to a component of the entity.

+ + + + + + + + + + + + + + + + +
Template parameters
ComponentTypeComponent type.
ReturnsReference to the component.
+
+
+

+
+ template<typename... ComponentTypes> +
+ EntityBuilder& cubos::core::ecs::EntityBuilder::add(ComponentTypes && ... components) +

+

Adds components to the entity.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypesComponent types.
Parameters
componentsComponents to add.
ReturnsReference to this builder, for chaining.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EntityManager.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EntityManager.html new file mode 100644 index 000000000..7813cffcf --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EntityManager.html @@ -0,0 +1,378 @@ + + + + + cubos::core::ecs::EntityManager class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::EntityManager class final +
#include <core/ecs/entity_manager.hpp>
+

+

Holds and manages entities and their component masks.

+ +

Used internally by World.

+
+

Public types

+
+
+ class Iterator +
+
Used to iterate over all entities in a manager with a certain component mask.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ EntityManager(std::size_t initialCapacity) +
+
Constructs with a certain initial entity capacity.
+
+
+
+

Public functions

+
+
+ auto create(Entity::Mask mask) -> Entity +
+
Creates a new entity with a certain component mask.
+
+ void destroy(Entity entity) +
+
Removes an entity from the world.
+
+ void setMask(Entity entity, + Entity::Mask mask) +
+
Sets the component mask of an entity.
+
+ auto getMask(Entity entity) const -> const Entity::Mask& +
+
Gets the component mask of an entity.
+
+ auto isValid(Entity entity) const -> bool +
+
Checks if an entity is still valid.
+
+ auto isAlive(Entity entity) const -> bool +
+
Checks if an entity is alive.
+
+ auto begin() const -> Iterator +
+
Returns an iterator over all entities.
+
+ auto withMask(Entity::Mask mask) const -> Iterator +
+
Returns an iterator over all entities with a certain mask of components.
+
+ auto end() const -> Iterator +
+
Returns an iterator which points to the end of the entity manager.
+
+
+
+

Function documentation

+
+

+ cubos::core::ecs::EntityManager::EntityManager(std::size_t initialCapacity) +

+

Constructs with a certain initial entity capacity.

+ + + + + + + + + + +
Parameters
initialCapacityInitial capacity of the entity manager.
+
+
+

+ Entity cubos::core::ecs::EntityManager::create(Entity::Mask mask) +

+

Creates a new entity with a certain component mask.

+ + + + + + + + + + + + + + + + +
Parameters
maskComponent mask of the entity.
ReturnsEntity handle.
+
+
+

+ void cubos::core::ecs::EntityManager::destroy(Entity entity) +

+

Removes an entity from the world.

+ + + + + + + + + + +
Parameters
entityEntity to remove.
+
+
+

+ void cubos::core::ecs::EntityManager::setMask(Entity entity, + Entity::Mask mask) +

+

Sets the component mask of an entity.

+ + + + + + + + + + + + + + +
Parameters
entityEntity to set the mask of.
maskMask to set.
+
+
+

+ const Entity::Mask& cubos::core::ecs::EntityManager::getMask(Entity entity) const +

+

Gets the component mask of an entity.

+ + + + + + + + + + + + + + + + +
Parameters
entityEntity to get the mask of.
ReturnsComponent mask of the entity.
+
+
+

+ bool cubos::core::ecs::EntityManager::isValid(Entity entity) const +

+

Checks if an entity is still valid.

+ + + + + + + + + + + + + + + + +
Parameters
entityEntity to check.
ReturnsWhether the entity is valid.
+

Different from isAlive, as it will return true for entities which still have not been commited.

+
+
+

+ bool cubos::core::ecs::EntityManager::isAlive(Entity entity) const +

+

Checks if an entity is alive.

+ + + + + + + + + + + + + + + + +
Parameters
entityEntity to check.
ReturnsWhether the entity is alive.
+
+
+

+ Iterator cubos::core::ecs::EntityManager::begin() const +

+

Returns an iterator over all entities.

+ + + + + + + +
ReturnsIterator over all entities.
+
+
+

+ Iterator cubos::core::ecs::EntityManager::withMask(Entity::Mask mask) const +

+

Returns an iterator over all entities with a certain mask of components.

+ + + + + + + + + + + + + + + + +
Parameters
maskMask of the components to be iterated.
ReturnsIterator over all entities with the given component mask.
+
+
+

+ Iterator cubos::core::ecs::EntityManager::end() const +

+

Returns an iterator which points to the end of the entity manager.

+ + + + + + + +
ReturnsIterator which points to the end of the entity manager.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EntityManager_1_1Iterator.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EntityManager_1_1Iterator.html new file mode 100644 index 000000000..851430d66 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EntityManager_1_1Iterator.html @@ -0,0 +1,101 @@ + + + + + cubos::core::ecs::EntityManager::Iterator class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::EntityManager::Iterator class +
#include <core/ecs/entity_manager.hpp>
+

+

Used to iterate over all entities in a manager with a certain component mask.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EventPipe.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EventPipe.html new file mode 100644 index 000000000..06c77a1c6 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EventPipe.html @@ -0,0 +1,297 @@ + + + + + cubos::core::ecs::EventPipe class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/event_pipe.hpp>
+
template<typename T>
+ cubos::core::ecs::EventPipe class +

+

Resource which stores events of type T.

+ + + + + + + + + + +
Template parameters
TEvent type.
+ + +
+

Public functions

+
+
+ void push(T event, + unsigned int mask = DEFAULT_PUSH_MASK) +
+
Pushes an event into the event pipe.
+
+ auto getEventMask(std::size_t index) const -> unsigned int +
+
Returns the event mask from event pipe at the given index.
+
+ auto get(std::size_t index) const -> std::pair<const T&, unsigned int> +
+
Returns the event and mask with the given index.
+
+ void clear() +
+
Clears events that have been read by all readers.
+
+ auto sentEvents() const -> std::size_t +
+
Returns the number of events that already were sent.
+
+ auto size() const -> std::size_t +
+
Returns the number of events that are present on the pipe.
+
+ void addReader() +
+
Adds a new reader to reader count.
+
+ void removeReader() +
+
Removes a reader from reader count.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ void cubos::core::ecs::EventPipe<T>::push(T event, + unsigned int mask = DEFAULT_PUSH_MASK) +

+

Pushes an event into the event pipe.

+ + + + + + + + + + + + + + +
Parameters
eventEvent.
maskMask.
+
+
+

+
+ template<typename T> +
+ unsigned int cubos::core::ecs::EventPipe<T>::getEventMask(std::size_t index) const +

+

Returns the event mask from event pipe at the given index.

+ + + + + + + + + + + + + + + + +
Parameters
indexEvent index.
ReturnsEvent mask.
+
+
+

+
+ template<typename T> +
+ std::pair<const T&, unsigned int> cubos::core::ecs::EventPipe<T>::get(std::size_t index) const +

+

Returns the event and mask with the given index.

+ + + + + + + + + + + + + + + + +
Parameters
indexEvent index.
ReturnsEvent and mask.
+
+
+

+
+ template<typename T> +
+ std::size_t cubos::core::ecs::EventPipe<T>::sentEvents() const +

+

Returns the number of events that already were sent.

+ + + + + + + +
ReturnsNumber of events that already were sent.
+
+
+

+
+ template<typename T> +
+ std::size_t cubos::core::ecs::EventPipe<T>::size() const +

+

Returns the number of events that are present on the pipe.

+ + + + + + + +
ReturnsNumber of events that are present on the pipe.
+
+
+

+
+ template<typename T> +
+ void cubos::core::ecs::EventPipe<T>::addReader() +

+

Adds a new reader to reader count.

+

This is necessary to keep track of when its okay to delete events on clear().

+
+
+

+
+ template<typename T> +
+ void cubos::core::ecs::EventPipe<T>::removeReader() +

+

Removes a reader from reader count.

+ +
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EventReader.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EventReader.html new file mode 100644 index 000000000..4a235ec98 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EventReader.html @@ -0,0 +1,247 @@ + + + + + cubos::core::ecs::EventReader class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/event_reader.hpp>
+
template<typename T, unsigned int M = DEFAULT_FILTER_MASK>
+ cubos::core::ecs::EventReader class +

+

System arguments used to read events of type T.

+ + + + + + + + + + + + + + +
Template parameters
TEvent.
MFilter mask.
+ +

Filtering the received events by their mask is also possible via the parameter M. By default, the reader will read all events sent.

+
+

Public types

+
+
+ class Iterator +
+
Used to iterate over events received by a reader.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ EventReader(const EventPipe<T>& pipe, + std::size_t& index) +
+
Constructs.
+
+
+
+

Public functions

+
+
+ auto read() -> std::optional<std::reference_wrapper<const T>> +
+
Returns a reference to current event, and advances.
+
+ auto begin() -> Iterator +
+
Returns an iterator to the first event.
+
+ auto end() -> Iterator +
+
Returns an iterator to the end.
+
+
+
+

Function documentation

+
+

+
+ template<typename T, unsigned int M> +
+ cubos::core::ecs::EventReader<T, M>::EventReader(const EventPipe<T>& pipe, + std::size_t& index) +

+

Constructs.

+ + + + + + + + + + + + + + +
Parameters
pipeEvent pipe to read events from.
indexReference to the reader's index.
+

Uses the given index to know which events it has already read. Increments it whenever it reads an event.

+
+
+

+
+ template<typename T, unsigned int M> +
+ std::optional<std::reference_wrapper<const T>> cubos::core::ecs::EventReader<T, M>::read() +

+

Returns a reference to current event, and advances.

+ + + + + + + +
ReturnsReference to current event, or std::nullopt if there are no more events.
+
+
+

+
+ template<typename T, unsigned int M> +
+ Iterator cubos::core::ecs::EventReader<T, M>::begin() +

+

Returns an iterator to the first event.

+ + + + + + + +
ReturnsIterator.
+
+
+

+
+ template<typename T, unsigned int M> +
+ Iterator cubos::core::ecs::EventReader<T, M>::end() +

+

Returns an iterator to the end.

+ + + + + + + +
ReturnsIterator.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EventReader_1_1Iterator.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EventReader_1_1Iterator.html new file mode 100644 index 000000000..d718dda87 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EventReader_1_1Iterator.html @@ -0,0 +1,101 @@ + + + + + cubos::core::ecs::EventReader::Iterator class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::EventReader::Iterator class +
#include <core/ecs/event_reader.hpp>
+

+

Used to iterate over events received by a reader.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EventWriter.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EventWriter.html new file mode 100644 index 000000000..49e621855 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1EventWriter.html @@ -0,0 +1,193 @@ + + + + + cubos::core::ecs::EventWriter class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/event_writer.hpp>
+
template<typename T>
+ cubos::core::ecs::EventWriter class +

+

System argument which allows the system to send events of type T to other systems.

+ + + + + + + + + + +
Template parameters
T
+ + +
+

Constructors, destructors, conversion operators

+
+
+ EventWriter(EventPipe<T>& pipe) +
+
Constructs.
+
+
+
+

Public functions

+
+
+ void push(T event, + unsigned int mask = DEFAULT_PUSH_MASK) +
+
Sends the given event to the event pipe with the given mask.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::core::ecs::EventWriter<T>::EventWriter(EventPipe<T>& pipe) +

+

Constructs.

+ + + + + + + + + + +
Parameters
pipeEvent pipe to write events to.
+
+
+

+
+ template<typename T> +
+ void cubos::core::ecs::EventWriter<T>::push(T event, + unsigned int mask = DEFAULT_PUSH_MASK) +

+

Sends the given event to the event pipe with the given mask.

+ + + + + + + + + + + + + + +
Parameters
eventEvent.
maskMask.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1IStorage.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1IStorage.html new file mode 100644 index 000000000..fcc66bdcd --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1IStorage.html @@ -0,0 +1,243 @@ + + + + + cubos::core::ecs::IStorage class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::IStorage class +
#include <core/ecs/storage.hpp>
+

+

Abstract parent class for all storages.

+ +

Necessary to provide a type-erased interface for erasing and packaging/unpackaging components.

+
+

Derived classes

+
+
+
template<typename T>
+ class Storage +
+
Abstract container for a component type T.
+
+
+
+

Public functions

+
+
+ void erase(uint32_t index) pure virtual +
+
Remove a value from the storage.
+
+ auto pack(uint32_t index, + data::Context* context) const -> data::Package pure virtual +
+
Packages a value. If the value doesn't exist, undefined behavior will occur.
+
+ auto unpack(uint32_t index, + const data::Package& package, + data::Context* context) -> bool pure virtual +
+
Unpackages a value.
+
+ auto type() const -> std::type_index pure virtual +
+
Gets the type the components being stored here.
+
+
+
+

Function documentation

+
+

+ void cubos::core::ecs::IStorage::erase(uint32_t index) pure virtual +

+

Remove a value from the storage.

+ + + + + + + + + + +
Parameters
indexIndex of the value to be removed.
+
+
+

+ data::Package cubos::core::ecs::IStorage::pack(uint32_t index, + data::Context* context) const pure virtual +

+

Packages a value. If the value doesn't exist, undefined behavior will occur.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
indexIndex of the value to package.
contextOptional context used for serialization.
ReturnsPackaged value.
+
+
+

+ bool cubos::core::ecs::IStorage::unpack(uint32_t index, + const data::Package& package, + data::Context* context) pure virtual +

+

Unpackages a value.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
indexIndex of the value to unpackage.
packagePackage to unpackage.
contextOptional context used for deserialization.
ReturnsWhether the unpackaging was successful.
+
+
+

+ std::type_index cubos::core::ecs::IStorage::type() const pure virtual +

+

Gets the type the components being stored here.

+ + + + + + + +
ReturnsComponent type.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1MapStorage.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1MapStorage.html new file mode 100644 index 000000000..58d3068b6 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1MapStorage.html @@ -0,0 +1,257 @@ + + + + + cubos::core::ecs::MapStorage class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/map_storage.hpp>
+
template<typename T>
+ cubos::core::ecs::MapStorage class +

+

Storage implementation that uses an std::unordered_map.

+ + + + + + + + + + +
Template parameters
TComponent type.
+ +
+

Base classes

+
+
+
template<typename T>
+ class Storage<T> +
+
Abstract container for a component type T.
+
+
+
+

Public functions

+
+
+ auto insert(uint32_t index, + T value) -> T* override +
+
Inserts a value into the storage.
+
+ auto get(uint32_t index) -> T* override +
+
Gets a value from the storage.
+
+ auto get(uint32_t index) const -> const T* override +
+
Gets a value from the storage.
+
+ void erase(uint32_t index) override +
+
Remove a value from the storage.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ T* cubos::core::ecs::MapStorage<T>::insert(uint32_t index, + T value) override +

+

Inserts a value into the storage.

+ + + + + + + + + + + + + + +
Parameters
indexIndex where to insert the value.
valueValue to be inserted.
+
+
+

+
+ template<typename T> +
+ T* cubos::core::ecs::MapStorage<T>::get(uint32_t index) override +

+

Gets a value from the storage.

+ + + + + + + + + + + + + + + + +
Parameters
indexIndex of the value to be retrieved.
ReturnsPointer to the value.
+
+
+

+
+ template<typename T> +
+ const T* cubos::core::ecs::MapStorage<T>::get(uint32_t index) const override +

+

Gets a value from the storage.

+ + + + + + + + + + + + + + + + +
Parameters
indexIndex of the value to be retrieved.
ReturnsPointer to the value.
+
+
+

+
+ template<typename T> +
+ void cubos::core::ecs::MapStorage<T>::erase(uint32_t index) override +

+

Remove a value from the storage.

+ + + + + + + + + + +
Parameters
indexIndex of the value to be removed.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1NullStorage.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1NullStorage.html new file mode 100644 index 000000000..24847b043 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1NullStorage.html @@ -0,0 +1,257 @@ + + + + + cubos::core::ecs::NullStorage class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/null_storage.hpp>
+
template<typename T>
+ cubos::core::ecs::NullStorage class +

+

Storage implementation that doesn't keep any data, made for zero-sized components.

+ + + + + + + + + + +
Template parameters
TComponent type.
+ +
+

Base classes

+
+
+
template<typename T>
+ class Storage<T> +
+
Abstract container for a component type T.
+
+
+
+

Public functions

+
+
+ auto insert(uint32_t index, + T value) -> T* override +
+
Inserts a value into the storage.
+
+ auto get(uint32_t index) -> T* override +
+
Gets a value from the storage.
+
+ auto get(uint32_t index) const -> const T* override +
+
Gets a value from the storage.
+
+ void erase(uint32_t index) override +
+
Remove a value from the storage.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ T* cubos::core::ecs::NullStorage<T>::insert(uint32_t index, + T value) override +

+

Inserts a value into the storage.

+ + + + + + + + + + + + + + +
Parameters
indexIndex where to insert the value.
valueValue to be inserted.
+
+
+

+
+ template<typename T> +
+ T* cubos::core::ecs::NullStorage<T>::get(uint32_t index) override +

+

Gets a value from the storage.

+ + + + + + + + + + + + + + + + +
Parameters
indexIndex of the value to be retrieved.
ReturnsPointer to the value.
+
+
+

+
+ template<typename T> +
+ const T* cubos::core::ecs::NullStorage<T>::get(uint32_t index) const override +

+

Gets a value from the storage.

+ + + + + + + + + + + + + + + + +
Parameters
indexIndex of the value to be retrieved.
ReturnsPointer to the value.
+
+
+

+
+ template<typename T> +
+ void cubos::core::ecs::NullStorage<T>::erase(uint32_t index) override +

+

Remove a value from the storage.

+ + + + + + + + + + +
Parameters
indexIndex of the value to be removed.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1OptRead.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1OptRead.html new file mode 100644 index 000000000..d46ab5a22 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1OptRead.html @@ -0,0 +1,225 @@ + + + + + cubos::core::ecs::OptRead class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/accessors.hpp>
+
template<typename T>
+ cubos::core::ecs::OptRead class +

+

System argument which provides read access to the resource T if it exists, or query argument which provides read access to the component T if it exists.

+ + + + + + + + + + +
Template parameters
TResource or component type.
+ +

While the Read demands that the resource or component exists, this argument does not. Can be used as a pointer with both the -> and * operators.

+
+

Constructors, destructors, conversion operators

+
+
+ OptRead(const T* ptr) +
+
Creates a new optional read argument. ptr should be null if the resource or component does not exist.
+
+ operator bool() const +
+
Checks if the resource or component exists.
+
+
+
+

Public functions

+
+
+ auto operator->() const -> const T* +
+
Accesses the resource or component, aborting if it does not exist.
+
+ auto operator*() const -> const T& +
+
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::core::ecs::OptRead<T>::OptRead(const T* ptr) +

+

Creates a new optional read argument. ptr should be null if the resource or component does not exist.

+ + + + + + + + + + +
Parameters
ptrPointer to the resource or component.
+
+
+

+
+ template<typename T> +
+ cubos::core::ecs::OptRead<T>::operator bool() const +

+

Checks if the resource or component exists.

+ + + + + + + +
ReturnsWhether the resource or component exists.
+
+
+

+
+ template<typename T> +
+ const T* cubos::core::ecs::OptRead<T>::operator->() const +

+

Accesses the resource or component, aborting if it does not exist.

+ + + + + + + +
ReturnsReference to the resource or component.
+
+
+

+
+ template<typename T> +
+ const T& cubos::core::ecs::OptRead<T>::operator*() const +

+ + + + + + + +
ReturnsReference to the resource or component, aborting if it does not exist.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1OptWrite.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1OptWrite.html new file mode 100644 index 000000000..506214950 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1OptWrite.html @@ -0,0 +1,226 @@ + + + + + cubos::core::ecs::OptWrite class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/accessors.hpp>
+
template<typename T>
+ cubos::core::ecs::OptWrite class +

+

System argument which provides write access to the resource T if it exists, or query argument which provides write access to the component T if it exists.

+ + + + + + + + + + +
Template parameters
TResource or component type.
+ +

While the Write demands that the resource or component exists, this argument does not. Can be used as a pointer with both the -> and * operators.

+
+

Constructors, destructors, conversion operators

+
+
+ OptWrite(T* ptr) +
+
Creates a new optional write argument. ptr should be null if the resource or component does not exist.
+
+ operator bool() const +
+
Checks if the resource or component exists.
+
+
+
+

Public functions

+
+
+ auto operator->() -> T* +
+
Accesses the resource or component, aborting if it does not exist.
+
+ auto operator*() -> T& +
+
Accesses the resource or component, aborting if it does not exist.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::core::ecs::OptWrite<T>::OptWrite(T* ptr) +

+

Creates a new optional write argument. ptr should be null if the resource or component does not exist.

+ + + + + + + + + + +
Parameters
ptrPointer to the resource or component.
+
+
+

+
+ template<typename T> +
+ cubos::core::ecs::OptWrite<T>::operator bool() const +

+

Checks if the resource or component exists.

+ + + + + + + +
ReturnsWhether the resource or component exists.
+
+
+

+
+ template<typename T> +
+ T* cubos::core::ecs::OptWrite<T>::operator->() +

+

Accesses the resource or component, aborting if it does not exist.

+ + + + + + + +
ReturnsReference to the resource or component.
+
+
+

+
+ template<typename T> +
+ T& cubos::core::ecs::OptWrite<T>::operator*() +

+

Accesses the resource or component, aborting if it does not exist.

+ + + + + + + +
ReturnsReference to the resource or component.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Query.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Query.html new file mode 100644 index 000000000..333c462a3 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Query.html @@ -0,0 +1,272 @@ + + + + + cubos::core::ecs::Query class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/query.hpp>
+
template<typename... ComponentTypes>
+ cubos::core::ecs::Query class +

+

Holds the result of a query over all entities in world which match the given arguments.

+ + + + + + + + + + +
Template parameters
ComponentTypesComponent accessor types to be queried.
+ +

An example of a valid query is:

Query<Write<Position>, Read<Velocity>, OptWrite<Rotation>, OptRead<Scale>>

This query will return all entities with a Position and Velocity component. Accessors to Rotation and Scale components are also passed but may be null if the component is not present in the entity. Whenever mutability is not needed, Read/OptRead should be used.

+
+

Public types

+
+
+ class Iterator +
+
Used to iterate over the results of a query.
+
+
+
+

Public static functions

+
+
+ static auto info() -> QueryInfo +
+
Gets information about the query.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ Query(const World& world) +
+
Constructs a query over the given world.
+
+
+
+

Public functions

+
+
+ auto begin() -> Iterator +
+
Gets an iterator to the first entity which matches the query.
+
+ auto end() -> Iterator +
+
Gets an iterator to the end of the query.
+
+ auto operator[](Entity entity) -> std::optional<std::tuple<ComponentTypes...>> +
+
Accesses an entity's components directly, without iterating over the query.
+
+
+
+

Function documentation

+
+

+
+ template<typename... ComponentTypes> +
+ static QueryInfo cubos::core::ecs::Query<ComponentTypes>::info() +

+

Gets information about the query.

+ + + + + + + +
ReturnsQuery information.
+
+
+

+
+ template<typename... ComponentTypes> +
+ cubos::core::ecs::Query<ComponentTypes>::Query(const World& world) +

+

Constructs a query over the given world.

+ + + + + + + + + + +
Parameters
worldWorld to query.
+
+
+

+
+ template<typename... ComponentTypes> +
+ Iterator cubos::core::ecs::Query<ComponentTypes>::begin() +

+

Gets an iterator to the first entity which matches the query.

+ + + + + + + +
ReturnsIterator.
+
+
+

+
+ template<typename... ComponentTypes> +
+ Iterator cubos::core::ecs::Query<ComponentTypes>::end() +

+

Gets an iterator to the end of the query.

+ + + + + + + +
ReturnsIterator.
+
+
+

+
+ template<typename... ComponentTypes> +
+ std::optional<std::tuple<ComponentTypes...>> cubos::core::ecs::Query<ComponentTypes>::operator[](Entity entity) +

+

Accesses an entity's components directly, without iterating over the query.

+ + + + + + + + + + + + + + + + +
Parameters
entityEntity to access.
ReturnsRequested components, or std::nullopt if the entity does not match the query.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Query_1_1Iterator.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Query_1_1Iterator.html new file mode 100644 index 000000000..2980571d7 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Query_1_1Iterator.html @@ -0,0 +1,138 @@ + + + + + cubos::core::ecs::Query::Iterator class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::Query::Iterator class +
#include <core/ecs/query.hpp>
+

+

Used to iterate over the results of a query.

+ +
+

Public functions

+
+
+ auto operator*() const -> std::tuple<Entity, ComponentTypes...> +
+
Dereferences to a tuple containing the queried entity and its components.
+
+
+
+

Function documentation

+
+

+ std::tuple<Entity, ComponentTypes...> cubos::core::ecs::Query::Iterator::operator*() const +

+

Dereferences to a tuple containing the queried entity and its components.

+ + + + + + + +
ReturnsTuple containing the entity and its components.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Read.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Read.html new file mode 100644 index 000000000..217ca00b7 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Read.html @@ -0,0 +1,205 @@ + + + + + cubos::core::ecs::Read class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/accessors.hpp>
+
template<typename T>
+ cubos::core::ecs::Read class +

+

System argument which provides read access to the resource T, or query argument which provides read access to the component T.

+ + + + + + + + + + +
Template parameters
TResource or component type.
+ +

Can be used as a pointer with both the -> and * operators.

+
+

Constructors, destructors, conversion operators

+
+
+ Read(const T& ref) +
+
Creates a new read argument.
+
+
+
+

Public functions

+
+
+ auto operator->() const -> const T* +
+
Accesses the resource or component.
+
+ auto operator*() const -> const T& +
+
Accesses the resource or component.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::core::ecs::Read<T>::Read(const T& ref) +

+

Creates a new read argument.

+ + + + + + + + + + +
Parameters
refReference to the resource or component.
+
+
+

+
+ template<typename T> +
+ const T* cubos::core::ecs::Read<T>::operator->() const +

+

Accesses the resource or component.

+ + + + + + + +
ReturnsPointer to the resource or component.
+
+
+

+
+ template<typename T> +
+ const T& cubos::core::ecs::Read<T>::operator*() const +

+

Accesses the resource or component.

+ + + + + + + +
ReturnsReference to the resource or component.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1ReadResource.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1ReadResource.html new file mode 100644 index 000000000..4f4e86d32 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1ReadResource.html @@ -0,0 +1,183 @@ + + + + + cubos::core::ecs::ReadResource class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/resource_manager.hpp>
+
template<typename T>
+ cubos::core::ecs::ReadResource class +

+

Utility struct used to reference a resource of type T for reading.

+ + + + + + + + + + +
Template parameters
TResource type.
+ +
+

Constructors, destructors, conversion operators

+
+
+ ReadResource(ReadResource&& other) noexcept +
+
Move construct.
+
+
+
+

Public functions

+
+
+ auto get() const -> const T& +
+
Gets the underlying resource reference.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::core::ecs::ReadResource<T>::ReadResource(ReadResource&& other) noexcept +

+

Move construct.

+ + + + + + + + + + +
Parameters
otherOther resource to move from.
+
+
+

+
+ template<typename T> +
+ const T& cubos::core::ecs::ReadResource<T>::get() const +

+

Gets the underlying resource reference.

+ + + + + + + +
ReturnsResource reference.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1ReadStorage.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1ReadStorage.html new file mode 100644 index 000000000..6090dc6fa --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1ReadStorage.html @@ -0,0 +1,183 @@ + + + + + cubos::core::ecs::ReadStorage class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/component_manager.hpp>
+
template<typename T>
+ cubos::core::ecs::ReadStorage class +

+

Utility struct used to reference a storage of component type T for reading.

+ + + + + + + + + + +
Template parameters
TComponent type.
+ +
+

Constructors, destructors, conversion operators

+
+
+ ReadStorage(ReadStorage&& other) noexcept +
+
Move constructor.
+
+
+
+

Public functions

+
+
+ auto get() const -> const Storage<T>& +
+
Gets the underlying storage reference.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::core::ecs::ReadStorage<T>::ReadStorage(ReadStorage&& other) noexcept +

+

Move constructor.

+ + + + + + + + + + +
Parameters
otherOther instance to move from.
+
+
+

+
+ template<typename T> +
+ const Storage<T>& cubos::core::ecs::ReadStorage<T>::get() const +

+

Gets the underlying storage reference.

+ + + + + + + +
ReturnsUnderlying storage reference.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Registry.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Registry.html new file mode 100644 index 000000000..c6f96d5d0 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Registry.html @@ -0,0 +1,295 @@ + + + + + cubos::core::ecs::Registry class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::Registry class final +
#include <core/ecs/registry.hpp>
+

+

Singleton which holds a global registry for all component types.

+ +

It stores information regarding the components so that they can be handled in a type-erased manner.

+
+

Public static functions

+
+
+ static auto create(std::string_view name, + data::Deserializer& des, + Blueprint& blueprint, + Entity id) -> bool +
+
Instantiates a component with the given name from a deserializer into a blueprint.
+
+ static auto createStorage(std::type_index type) -> std::unique_ptr<IStorage> +
+
Instantiates a component storage for the given component type.
+
+
template<typename T, typename S>
+ static void add(std::string_view name) +
+
Registers a new component type.
+
+ static auto name(std::type_index type) -> std::optional<std::string_view> +
+
Gets the name of a component type.
+
+ static auto type(std::string_view name) -> std::optional<std::type_index> +
+
Gets the type index of a component type.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ Registry() deleted +
+
Deleted constructor.
+
+
+
+

Function documentation

+
+

+ static bool cubos::core::ecs::Registry::create(std::string_view name, + data::Deserializer& des, + Blueprint& blueprint, + Entity id) +

+

Instantiates a component with the given name from a deserializer into a blueprint.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
nameName of the component.
desDeserializer to read the component data from.
blueprintBlueprint to instantiate the component into.
idBlueprint entity to add the component to.
ReturnsWhether the instantiation was successful.
+
+
+

+ static std::unique_ptr<IStorage> cubos::core::ecs::Registry::createStorage(std::type_index type) +

+

Instantiates a component storage for the given component type.

+ + + + + + + + + + + + + + + + +
Parameters
typeType index of the component.
ReturnsSmart pointer to the storage, or nullptr if the component type was not found.
+
+
+

+
+ template<typename T, typename S> +
+ static void cubos::core::ecs::Registry::add(std::string_view name) +

+

Registers a new component type.

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TComponent type to register.
SStorage type to use for the component.
Parameters
nameName of the component.
+
+
+

+ static std::optional<std::string_view> cubos::core::ecs::Registry::name(std::type_index type) +

+

Gets the name of a component type.

+ + + + + + + + + + + + + + + + +
Parameters
typeType index of the component.
ReturnsName of the component, or std::nullopt if the component type was not found.
+
+
+

+ static std::optional<std::type_index> cubos::core::ecs::Registry::type(std::string_view name) +

+

Gets the type index of a component type.

+ + + + + + + + + + + + + + + + +
Parameters
nameName of the component.
ReturnsType index of the component, or std::nullopt if the component type was not found.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1ResourceManager.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1ResourceManager.html new file mode 100644 index 000000000..efe14abf0 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1ResourceManager.html @@ -0,0 +1,222 @@ + + + + + cubos::core::ecs::ResourceManager class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::ResourceManager class final +
#include <core/ecs/resource_manager.hpp>
+

+

Holds and manages resources.

+ +

Used internally by World.

+
+

Public functions

+
+
+
template<typename T, typename... TArgs>
+ void add(TArgs... args) +
+
Registers a new resource type in the resource manager.
+
+
template<typename T>
+ auto read() const -> ReadResource<T> +
+
Locks a resource for reading and returns it.
+
+
template<typename T>
+ auto write() const -> WriteResource<T> +
+
Locks a resource for writing and returns it.
+
+
+
+

Function documentation

+
+

+
+ template<typename T, typename... TArgs> +
+ void cubos::core::ecs::ResourceManager::add(TArgs... args) +

+

Registers a new resource type in the resource manager.

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TResource type.
TArgsTypes of the arguments of the constructor of the resource.
Parameters
argsArguments of the constructor of the resource.
+

This function is not thread-safe and should be called before any other function.

+
+
+

+
+ template<typename T> +
+ ReadResource<T> cubos::core::ecs::ResourceManager::read() const +

+

Locks a resource for reading and returns it.

+ + + + + + + + + + + + + + + + +
Template parameters
TResource type.
ReturnsResource lock.
+
+
+

+
+ template<typename T> +
+ WriteResource<T> cubos::core::ecs::ResourceManager::write() const +

+

Locks a resource for writing and returns it.

+ + + + + + + + + + + + + + + + +
Template parameters
TResource type.
ReturnsResource lock.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Storage.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Storage.html new file mode 100644 index 000000000..70c2a4583 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Storage.html @@ -0,0 +1,362 @@ + + + + + cubos::core::ecs::Storage class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/storage.hpp>
+
template<typename T>
+ cubos::core::ecs::Storage class +

+

Abstract container for a component type T.

+ + + + + + + + + + +
Template parameters
TComponent type.
+ +
+

Base classes

+
+
+ class IStorage +
+
Abstract parent class for all storages.
+
+
+
+

Derived classes

+
+
+
template<typename T>
+ class MapStorage +
+
Storage implementation that uses an std::unordered_map.
+
+
template<typename T>
+ class NullStorage +
+
Storage implementation that doesn't keep any data, made for zero-sized components.
+
+
template<typename T>
+ class VecStorage +
+
Storage implementation that uses a std::vector.
+
+
+
+

Public types

+
+
+ using Type = T +
+
Component type.
+
+
+
+

Public functions

+
+
+ auto insert(uint32_t index, + T value) -> T* pure virtual +
+
Inserts a value into the storage.
+
+ auto get(uint32_t index) -> T* pure virtual +
+
Gets a value from the storage.
+
+ auto get(uint32_t index) const -> const T* pure virtual +
+
Gets a value from the storage.
+
+ auto pack(uint32_t index, + data::Context* context) const -> data::Package override +
+
Packages a value. If the value doesn't exist, undefined behavior will occur.
+
+ auto unpack(uint32_t index, + const data::Package& package, + data::Context* context) -> bool override +
+
Unpackages a value.
+
+ auto type() const -> std::type_index override +
+
Gets the type the components being stored here.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ T* cubos::core::ecs::Storage<T>::insert(uint32_t index, + T value) pure virtual +

+

Inserts a value into the storage.

+ + + + + + + + + + + + + + +
Parameters
indexIndex where to insert the value.
valueValue to be inserted.
+
+
+

+
+ template<typename T> +
+ T* cubos::core::ecs::Storage<T>::get(uint32_t index) pure virtual +

+

Gets a value from the storage.

+ + + + + + + + + + + + + + + + +
Parameters
indexIndex of the value to be retrieved.
ReturnsPointer to the value.
+
+
+

+
+ template<typename T> +
+ const T* cubos::core::ecs::Storage<T>::get(uint32_t index) const pure virtual +

+

Gets a value from the storage.

+ + + + + + + + + + + + + + + + +
Parameters
indexIndex of the value to be retrieved.
ReturnsPointer to the value.
+
+
+

+
+ template<typename T> +
+ data::Package cubos::core::ecs::Storage<T>::pack(uint32_t index, + data::Context* context) const override +

+

Packages a value. If the value doesn't exist, undefined behavior will occur.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
indexIndex of the value to package.
contextOptional context used for serialization.
ReturnsPackaged value.
+
+
+

+
+ template<typename T> +
+ bool cubos::core::ecs::Storage<T>::unpack(uint32_t index, + const data::Package& package, + data::Context* context) override +

+

Unpackages a value.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
indexIndex of the value to unpackage.
packagePackage to unpackage.
contextOptional context used for deserialization.
ReturnsWhether the unpackaging was successful.
+
+
+

+
+ template<typename T> +
+ std::type_index cubos::core::ecs::Storage<T>::type() const override +

+

Gets the type the components being stored here.

+ + + + + + + +
ReturnsComponent type.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1SystemWrapper.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1SystemWrapper.html new file mode 100644 index 000000000..9ad613f0b --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1SystemWrapper.html @@ -0,0 +1,235 @@ + + + + + cubos::core::ecs::SystemWrapper class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/system.hpp>
+
template<typename F>
+ cubos::core::ecs::SystemWrapper class final +

+

Wrapper for a system of type F.

+ + + + + + + + + + +
Template parameters
FType of the system function/method/lambda.
+ +
+

Base classes

+
+
+
template<typename R>
+ class AnySystemWrapper<impl::SystemTraits<F>::Return> +
+
Base class for system wrappers.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ SystemWrapper(F system) +
+
Constructs.
+
+
+
+

Public functions

+
+
+ void prepare(World& world) override +
+
Prepares the system for being executed on the given world.
+
+ auto call(World& world, + CommandBuffer& commands) -> impl::SystemTraits<F>::Return override +
+
Calls the wrapped system with parameters taken from the given world.
+
+
+
+

Function documentation

+
+

+
+ template<typename F> +
+ cubos::core::ecs::SystemWrapper<F>::SystemWrapper(F system) +

+

Constructs.

+ + + + + + + + + + +
Parameters
systemSystem to wrap.
+
+
+

+
+ template<typename F> +
+ void cubos::core::ecs::SystemWrapper<F>::prepare(World& world) override +

+

Prepares the system for being executed on the given world.

+ + + + + + + + + + +
Parameters
worldWorld to prepare the system for.
+

Requires exclusive access to the world and must be called before calling the system.

+
+
+

+
+ template<typename F> +
+ impl::SystemTraits<F>::Return cubos::core::ecs::SystemWrapper<F>::call(World& world, + CommandBuffer& commands) override +

+

Calls the wrapped system with parameters taken from the given world.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
worldWorld used by the system.
commandsBuffer where commands can be submitted to.
ReturnsReturn value of the system.
+

Can only be called after calling prepare() on the same world.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1VecStorage.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1VecStorage.html new file mode 100644 index 000000000..58562386b --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1VecStorage.html @@ -0,0 +1,257 @@ + + + + + cubos::core::ecs::VecStorage class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/vec_storage.hpp>
+
template<typename T>
+ cubos::core::ecs::VecStorage class +

+

Storage implementation that uses a std::vector.

+ + + + + + + + + + +
Template parameters
TComponent type.
+ +
+

Base classes

+
+
+
template<typename T>
+ class Storage<T> +
+
Abstract container for a component type T.
+
+
+
+

Public functions

+
+
+ auto insert(uint32_t index, + T value) -> T* override +
+
Inserts a value into the storage.
+
+ auto get(uint32_t index) -> T* override +
+
Gets a value from the storage.
+
+ auto get(uint32_t index) const -> const T* override +
+
Gets a value from the storage.
+
+ void erase(uint32_t index) override +
+
Remove a value from the storage.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ T* cubos::core::ecs::VecStorage<T>::insert(uint32_t index, + T value) override +

+

Inserts a value into the storage.

+ + + + + + + + + + + + + + +
Parameters
indexIndex where to insert the value.
valueValue to be inserted.
+
+
+

+
+ template<typename T> +
+ T* cubos::core::ecs::VecStorage<T>::get(uint32_t index) override +

+

Gets a value from the storage.

+ + + + + + + + + + + + + + + + +
Parameters
indexIndex of the value to be retrieved.
ReturnsPointer to the value.
+
+
+

+
+ template<typename T> +
+ const T* cubos::core::ecs::VecStorage<T>::get(uint32_t index) const override +

+

Gets a value from the storage.

+ + + + + + + + + + + + + + + + +
Parameters
indexIndex of the value to be retrieved.
ReturnsPointer to the value.
+
+
+

+
+ template<typename T> +
+ void cubos::core::ecs::VecStorage<T>::erase(uint32_t index) override +

+

Remove a value from the storage.

+ + + + + + + + + + +
Parameters
indexIndex of the value to be removed.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1World.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1World.html new file mode 100644 index 000000000..1cbabd1cd --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1World.html @@ -0,0 +1,592 @@ + + + + + cubos::core::ecs::World class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::World class +
#include <core/ecs/world.hpp>
+

+

Holds entities, their components and resources.

+ + +
+

Public types

+
+
+ using Iterator = EntityManager::Iterator +
+
Used to iterate over all entities in a world.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ World(std::size_t initialCapacity = 1024) +
+
Constructs with the given initialCapacity.
+
+
+
+

Public functions

+
+
+
template<typename T, typename... TArgs>
+ void registerResource(TArgs... args) +
+
Registers and inserts a new resource type.
+
+
template<typename T>
+ void registerComponent() +
+
Registers a component type.
+
+
template<typename T>
+ auto read() const -> ReadResource<T> +
+
Locks a resource for reading and returns it.
+
+
template<typename T>
+ auto write() const -> WriteResource<T> +
+
Locks a resource for writing and returns it.
+
+
template<typename... ComponentTypes>
+ auto create(ComponentTypes... components) -> Entity +
+
Creates a new entity with the given components.
+
+ void destroy(Entity entity) +
+
Destroys an entity and its components.
+
+ auto isAlive(Entity entity) const -> bool +
+
Checks if an entity is still alive.
+
+
template<typename... ComponentTypes>
+ void add(Entity entity, + ComponentTypes && ... components) +
+
Adds components to an entity.
+
+
template<typename... ComponentTypes>
+ void remove(Entity entity) +
+
Removes components from an entity.
+
+
template<typename T>
+ auto has(Entity entity) const -> bool +
+
Checks if an entity has a component.
+
+ auto pack(Entity entity, + data::Context* context = nullptr) const -> data::Package +
+
Creates a package from the components of an entity.
+
+ auto unpack(Entity entity, + const data::Package& package, + data::Context* context = nullptr) -> bool +
+
Unpacks components specified in a package into an entity.
+
+ auto begin() const -> Iterator +
+
Returns an iterator which points to the first entity of the world.
+
+ auto end() const -> Iterator +
+
Returns an iterator which points to the end of the world.
+
+
+
+

Function documentation

+
+

+ cubos::core::ecs::World::World(std::size_t initialCapacity = 1024) +

+

Constructs with the given initialCapacity.

+ + + + + + + + + + +
Parameters
initialCapacityHow many entities to reserve space for.
+
+
+

+
+ template<typename T, typename... TArgs> +
+ void cubos::core::ecs::World::registerResource(TArgs... args) +

+

Registers and inserts a new resource type.

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TResource type.
TArgsTypes of the arguments of the constructor of the resource.
Parameters
argsArguments of the constructor of the resource.
+ +
+
+

+
+ template<typename T> +
+ void cubos::core::ecs::World::registerComponent() +

+

Registers a component type.

+ + + + + + + + + + +
Template parameters
TComponent type.
+ +
+
+

+
+ template<typename T> +
+ ReadResource<T> cubos::core::ecs::World::read() const +

+

Locks a resource for reading and returns it.

+ + + + + + + + + + + + + + + + +
Template parameters
TResource type.
ReturnsResource lock.
+
+
+

+
+ template<typename T> +
+ WriteResource<T> cubos::core::ecs::World::write() const +

+

Locks a resource for writing and returns it.

+ + + + + + + + + + + + + + + + +
Template parameters
TResource type.
ReturnsResource lock.
+
+
+

+
+ template<typename... ComponentTypes> +
+ Entity cubos::core::ecs::World::create(ComponentTypes... components) +

+

Creates a new entity with the given components.

+ + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypesTypes of the components.
Parameters
componentsInitial values for the components.
+
+
+

+ void cubos::core::ecs::World::destroy(Entity entity) +

+

Destroys an entity and its components.

+ + + + + + + + + + +
Parameters
entityEntity identifier.
+
+
+

+ bool cubos::core::ecs::World::isAlive(Entity entity) const +

+

Checks if an entity is still alive.

+ + + + + + + + + + + + + + + + +
Parameters
entityEntity identifier.
ReturnsWhether the entity is alive.
+
+
+

+
+ template<typename... ComponentTypes> +
+ void cubos::core::ecs::World::add(Entity entity, + ComponentTypes && ... components) +

+

Adds components to an entity.

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypesTypes of the components.
Parameters
entityEntity identifier.
componentsInitial values for the components.
+

If the entity already has one of the components, it is overwritten.

+
+
+

+
+ template<typename... ComponentTypes> +
+ void cubos::core::ecs::World::remove(Entity entity) +

+

Removes components from an entity.

+ + + + + + + + + + + + + + + + + + + +
Template parameters
ComponentTypesTypes of the components.
Parameters
entityEntity identifier.
+

If the entity doesn't have one of the components, nothing happens.

+
+
+

+
+ template<typename T> +
+ bool cubos::core::ecs::World::has(Entity entity) const +

+

Checks if an entity has a component.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TComponent type.
Parameters
entityEntity identifier.
ReturnsWhether the entity has the component.
+
+
+

+ data::Package cubos::core::ecs::World::pack(Entity entity, + data::Context* context = nullptr) const +

+

Creates a package from the components of an entity.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
entityEntity identifier.
contextOptional context for serializing the components.
ReturnsPackage containing the components of the entity.
+
+
+

+ bool cubos::core::ecs::World::unpack(Entity entity, + const data::Package& package, + data::Context* context = nullptr) +

+

Unpacks components specified in a package into an entity.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
entityEntity identifier.
packagePackage to unpack.
contextOptional context for deserializing the components.
ReturnsWhether the package was unpacked successfully.
+

Removes any components that are already present in the entity.

+
+
+

+ Iterator cubos::core::ecs::World::begin() const +

+

Returns an iterator which points to the first entity of the world.

+ + + + + + + +
ReturnsIterator.
+
+
+

+ Iterator cubos::core::ecs::World::end() const +

+

Returns an iterator which points to the end of the world.

+ + + + + + + +
ReturnsIterator.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Write.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Write.html new file mode 100644 index 000000000..38a5d43f5 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1Write.html @@ -0,0 +1,205 @@ + + + + + cubos::core::ecs::Write class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/accessors.hpp>
+
template<typename T>
+ cubos::core::ecs::Write class +

+

System argument which provides write access to the resource T, or query argument which provides write access to the component T.

+ + + + + + + + + + +
Template parameters
TResource or component type.
+ +

Can be used as a pointer with both the -> and * operators.

+
+

Constructors, destructors, conversion operators

+
+
+ Write(T& ref) +
+
Creates a new write argument.
+
+
+
+

Public functions

+
+
+ auto operator->() -> T* +
+
Accesses the resource or component.
+
+ auto operator*() -> T& +
+
Accesses the resource or component.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::core::ecs::Write<T>::Write(T& ref) +

+

Creates a new write argument.

+ + + + + + + + + + +
Parameters
refReference to the resource or component.
+
+
+

+
+ template<typename T> +
+ T* cubos::core::ecs::Write<T>::operator->() +

+

Accesses the resource or component.

+ + + + + + + +
ReturnsPointer to the resource or component.
+
+
+

+
+ template<typename T> +
+ T& cubos::core::ecs::Write<T>::operator*() +

+

Accesses the resource or component.

+ + + + + + + +
ReturnsReference to the resource or component.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1WriteResource.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1WriteResource.html new file mode 100644 index 000000000..91cac38fa --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1WriteResource.html @@ -0,0 +1,183 @@ + + + + + cubos::core::ecs::WriteResource class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/resource_manager.hpp>
+
template<typename T>
+ cubos::core::ecs::WriteResource class +

+

Utility struct used to reference a resource of type T for writing.

+ + + + + + + + + + +
Template parameters
TResource type.
+ +
+

Constructors, destructors, conversion operators

+
+
+ WriteResource(WriteResource&& other) noexcept +
+
Move construct.
+
+
+
+

Public functions

+
+
+ auto get() const -> T& +
+
Gets the underlying resource reference.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::core::ecs::WriteResource<T>::WriteResource(WriteResource&& other) noexcept +

+

Move construct.

+ + + + + + + + + + +
Parameters
otherOther resource to move from.
+
+
+

+
+ template<typename T> +
+ T& cubos::core::ecs::WriteResource<T>::get() const +

+

Gets the underlying resource reference.

+ + + + + + + +
ReturnsResource reference.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1WriteStorage.html b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1WriteStorage.html new file mode 100644 index 000000000..d58d97cb3 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1ecs_1_1WriteStorage.html @@ -0,0 +1,183 @@ + + + + + cubos::core::ecs::WriteStorage class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/component_manager.hpp>
+
template<typename T>
+ cubos::core::ecs::WriteStorage class +

+

Utility struct used to reference a storage of component type T for writing.

+ + + + + + + + + + +
Template parameters
TComponent type.
+ +
+

Constructors, destructors, conversion operators

+
+
+ WriteStorage(WriteStorage&& other) noexcept +
+
Move constructor.
+
+
+
+

Public functions

+
+
+ auto get() const -> Storage<T>& +
+
Gets the underlying storage reference.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::core::ecs::WriteStorage<T>::WriteStorage(WriteStorage&& other) noexcept +

+

Move constructor.

+ + + + + + + + + + +
Parameters
otherOther instance to move from.
+
+
+

+
+ template<typename T> +
+ Storage<T>& cubos::core::ecs::WriteStorage<T>::get() const +

+

Gets the underlying storage reference.

+ + + + + + + +
ReturnsUnderlying storage reference.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1Debug.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1Debug.html new file mode 100644 index 000000000..73b95f7a3 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1Debug.html @@ -0,0 +1,328 @@ + + + + + cubos::core::gl::Debug class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::Debug class +
#include <core/gl/debug.hpp>
+

+

Singleton with static methods used to draw primitive objects on screen for debugging purposes.

+ +
+

Public static functions

+
+
+ static void init(RenderDevice& renderDevice) +
+
Initializes the debug rendering system.
+
+ static void drawBox(geom::Box box, + glm::mat4 transform, + glm::vec3 color = glm::vec3(1), + float time = 0) +
+
Draws a filled box that will stay visible for a specified amount of time.
+
+ static void drawWireBox(geom::Box box, + glm::mat4 transform, + glm::vec3 color = glm::vec3(1), + float time = 0) +
+
Draws a wireframe box that will stay visible for a specified amount of time.
+
+ static void drawSphere(glm::vec3 center, + float radius, + float time, + glm::vec3 color = glm::vec3(1)) +
+
Draws a filled sphere that will stay visible for a specified amount of time.
+
+ static void drawWireSphere(glm::vec3 center, + float radius, + float time, + glm::vec3 color = glm::vec3(1)) +
+
Draws a wireframe sphere that will stay visible for a specified amount of time.
+
+ static void flush(glm::mat4 vp, + double deltaT) +
+
Renders all objects in the debug renderer's buffer and removes all objects that have exhausted their requested time.
+
+ static void terminate() +
+
Cleans up the debug rendering system's resources.
+
+
+
+

Function documentation

+
+

+ static void cubos::core::gl::Debug::init(RenderDevice& renderDevice) +

+

Initializes the debug rendering system.

+ + + + + + + + + + +
Parameters
renderDeviceRender device to use.
+
+
+

+ static void cubos::core::gl::Debug::drawBox(geom::Box box, + glm::mat4 transform, + glm::vec3 color = glm::vec3(1), + float time = 0) +

+

Draws a filled box that will stay visible for a specified amount of time.

+ + + + + + + + + + + + + + + + + + + + + + +
Parameters
boxBox to draw.
transformTransformation matrix to apply to the box.
colorColor of the drawn cube.
timeHow long will it be visible for? If 0, for a single frame.
+
+
+

+ static void cubos::core::gl::Debug::drawWireBox(geom::Box box, + glm::mat4 transform, + glm::vec3 color = glm::vec3(1), + float time = 0) +

+

Draws a wireframe box that will stay visible for a specified amount of time.

+ + + + + + + + + + + + + + + + + + + + + + +
Parameters
boxBox to draw.
transformTransformation matrix to apply to the box.
colorColor of the drawn cube.
timeHow long will it be visible for? If 0, for a single frame.
+
+
+

+ static void cubos::core::gl::Debug::drawSphere(glm::vec3 center, + float radius, + float time, + glm::vec3 color = glm::vec3(1)) +

+

Draws a filled sphere that will stay visible for a specified amount of time.

+ + + + + + + + + + + + + + + + + + + + + + +
Parameters
centerPosition of the sphere's center in world space.
radiusRadius of the sphere.
timeHow long will it be visible for? If 0, for a single frame.
colorColor of the drawn sphere.
+
+
+

+ static void cubos::core::gl::Debug::drawWireSphere(glm::vec3 center, + float radius, + float time, + glm::vec3 color = glm::vec3(1)) +

+

Draws a wireframe sphere that will stay visible for a specified amount of time.

+ + + + + + + + + + + + + + + + + + + + + + +
Parameters
centerPosition of the sphere's center in world space.
radiusRadius of the sphere.
timeHow long will it be visible for? If 0, for a single frame.
colorColor of the drawn sphere.
+
+
+

+ static void cubos::core::gl::Debug::flush(glm::mat4 vp, + double deltaT) +

+

Renders all objects in the debug renderer's buffer and removes all objects that have exhausted their requested time.

+ + + + + + + + + + + + + + +
Parameters
vpView-Projection matrix that the objects should be drawn with.
deltaTTime that has passed since the last call to flush.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1Grid.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1Grid.html new file mode 100644 index 000000000..fd7148d6b --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1Grid.html @@ -0,0 +1,365 @@ + + + + + cubos::core::gl::Grid class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::Grid class final +
#include <core/gl/grid.hpp>
+

+

Represents a voxel object using a 3D grid.

+ + +
+

Constructors, destructors, conversion operators

+
+
+ Grid() +
+
Constructs an empty single-voxel grid.
+
+ Grid(const glm::uvec3& size) +
+
Constructs an empty grid with the given size.
+
+ Grid(const glm::uvec3& size, + const std::vector<uint16_t>& indices) +
+
Constructs a grid with the given size and initial data.
+
+ Grid(Grid&& other) noexcept +
+
Move constructs.
+
+
+
+

Public functions

+
+
+ auto operator=(const Grid& rhs) -> Grid& +
+
Makes this grid a copy of another grid.
+
+ void setSize(const glm::uvec3& size) +
+
Resizes the grid. New voxels are initialized to 0.
+
+ auto size() const -> const glm::uvec3& +
+
Gets the size of the grid.
+
+ void clear() +
+
Sets all voxels to 0.
+
+ void set(const glm::ivec3& position, + uint16_t mat) +
+
Sets the material index of a voxel.
+
+ auto get(const glm::ivec3& position) const -> uint16_t +
+
Gets the material index of a voxel.
+
+ auto convert(const Palette& src, + const Palette& dst, + float minSimilarity) -> bool +
+
Converts the material indices of this grid from one palette to another.
+
+
+
+

Function documentation

+
+

+ cubos::core::gl::Grid::Grid(const glm::uvec3& size) +

+

Constructs an empty grid with the given size.

+ + + + + + + + + + +
Parameters
sizeSize of the grid.
+
+
+

+ cubos::core::gl::Grid::Grid(const glm::uvec3& size, + const std::vector<uint16_t>& indices) +

+

Constructs a grid with the given size and initial data.

+ + + + + + + + + + + + + + +
Parameters
sizeSize of the grid.
indicesMaterial indices of the voxels.
+ +
+
+

+ cubos::core::gl::Grid::Grid(Grid&& other) noexcept +

+

Move constructs.

+ + + + + + + + + + +
Parameters
otherOther grid.
+
+
+

+ Grid& cubos::core::gl::Grid::operator=(const Grid& rhs) +

+

Makes this grid a copy of another grid.

+ + + + + + + + + + + + + + + + +
Parameters
rhsOther grid.
ReturnsThis grid, for chaining.
+
+
+

+ void cubos::core::gl::Grid::setSize(const glm::uvec3& size) +

+

Resizes the grid. New voxels are initialized to 0.

+ + + + + + + + + + +
Parameters
sizeNew size of the grid.
+
+
+

+ const glm::uvec3& cubos::core::gl::Grid::size() const +

+

Gets the size of the grid.

+ + + + + + + +
ReturnsSize of the grid.
+
+
+

+ void cubos::core::gl::Grid::set(const glm::ivec3& position, + uint16_t mat) +

+

Sets the material index of a voxel.

+ + + + + + + + + + + + + + +
Parameters
positionVoxel coordinates.
matMaterial index to set.
+
+
+

+ uint16_t cubos::core::gl::Grid::get(const glm::ivec3& position) const +

+

Gets the material index of a voxel.

+ + + + + + + + + + + + + + + + +
Parameters
positionVoxel coordinates.
ReturnsMaterial index of the voxel.
+
+
+

+ bool cubos::core::gl::Grid::convert(const Palette& src, + const Palette& dst, + float minSimilarity) +

+

Converts the material indices of this grid from one palette to another.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
srcOriginal palette.
dstNew palette.
minSimilarityMinimum similarity between two materials to consider them the same.
ReturnsWhether the conversion was successful.
+

For each material, it will search for another material in the second palette which is similar enough to the original one. The conversion fails if no matching index is found.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1Palette.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1Palette.html new file mode 100644 index 000000000..5a4aec9ae --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1Palette.html @@ -0,0 +1,332 @@ + + + + + cubos::core::gl::Palette class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::Palette class final +
#include <core/gl/palette.hpp>
+

+

Holds a palette of materials. Supports up to 65535 materials.

+ +

Instead of storing the materials themselves in voxel data, CUBOS. uses palettes, and stores the index of the material in the palette instead.

This allows for more efficient storage of voxel data, since now instead of storing the whole material per each voxel, we just store a 16-bit integer.

+
+

Constructors, destructors, conversion operators

+
+
+ Palette(std::vector<Material>&& materials) +
+
Constructs a palette with the given materials.
+
+ Palette() defaulted +
+
Constructs an empty palette.
+
+
+
+

Public functions

+
+
+ auto data() const -> const Material* +
+
Gets a pointer to the array of materials on the palette.
+
+ auto size() const -> uint16_t +
+
Gets the number of materials in the palette, excluding the empty material.
+
+ auto get(uint16_t index) const -> const Material& +
+
Gets the material with the given index.
+
+ void set(uint16_t index, + const Material& material) +
+
Sets the material at the given index.
+
+ auto find(const Material& material) const -> uint16_t +
+
Searches for the index of the material most similar with the given material.
+
+ auto add(const Material& material, + float similarity = 1.0F) -> uint16_t +
+
Adds a material to the palette, if one not similar enough already exists.
+
+ void merge(const Palette& palette, + float similarity = 1.0F) +
+
Merges another palette into this one.
+
+
+
+

Function documentation

+
+

+ cubos::core::gl::Palette::Palette(std::vector<Material>&& materials) +

+

Constructs a palette with the given materials.

+ + + + + + + + + + +
Parameters
materialsMaterials to add to the palette.
+
+
+

+ const Material* cubos::core::gl::Palette::data() const +

+

Gets a pointer to the array of materials on the palette.

+ + + + + + + +
ReturnsPointer to the array of materials on the palette.
+ +
+
+

+ uint16_t cubos::core::gl::Palette::size() const +

+

Gets the number of materials in the palette, excluding the empty material.

+ + + + + + + +
ReturnsNumber of materials in the palette.
+
+
+

+ const Material& cubos::core::gl::Palette::get(uint16_t index) const +

+

Gets the material with the given index.

+ + + + + + + + + + + + + + + + +
Parameters
indexIndex of the material to get (1-based, 0 is empty).
ReturnsMaterial at the given index.
+
+
+

+ void cubos::core::gl::Palette::set(uint16_t index, + const Material& material) +

+

Sets the material at the given index.

+ + + + + + + + + + + + + + +
Parameters
indexIndex of the material to set (1-based, 0 is empty).
materialMaterial to set.
+
+
+

+ uint16_t cubos::core::gl::Palette::find(const Material& material) const +

+

Searches for the index of the material most similar with the given material.

+ + + + + + + + + + + + + + + + +
Parameters
materialMaterial to compare with.
ReturnsIndex of the material.
+
+
+

+ uint16_t cubos::core::gl::Palette::add(const Material& material, + float similarity = 1.0F) +

+

Adds a material to the palette, if one not similar enough already exists.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
materialMaterial to add.
similarityMinimum similarity for a material to be considered similar enough.
ReturnsIndex of the material in the palette (1-based, 0 is empty).
+ +
+
+

+ void cubos::core::gl::Palette::merge(const Palette& palette, + float similarity = 1.0F) +

+

Merges another palette into this one.

+ + + + + + + + + + + + + + +
Parameters
palettePalette to merge.
similarityMinimum similarity for two materials to be merged.
+ +
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1RenderDevice.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1RenderDevice.html new file mode 100644 index 000000000..1507da199 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1RenderDevice.html @@ -0,0 +1,1259 @@ + + + + + cubos::core::gl::RenderDevice class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::RenderDevice class +
#include <core/gl/render_device.hpp>
+

+

Interface used to wrap low-level rendering APIs such as OpenGL.

+ +

Using this interface, the engine never directly interacts with OpenGL or any other low-level rendering API. This allows use to use different rendering APIs without having to change the engine code, which is useful for porting the engine to different platforms.

+
+

Constructors, destructors, conversion operators

+
+
+ RenderDevice(const RenderDevice&) deleted +
+
Forbid copy construction.
+
+
+
+

Public functions

+
+
+ auto createFramebuffer(const FramebufferDesc& desc) -> Framebuffer pure virtual +
+
Creates a new framebuffer.
+
+ void setFramebuffer(Framebuffer fb) pure virtual +
+
Sets the current framebuffer.
+
+ auto createRasterState(const RasterStateDesc& desc) -> RasterState pure virtual +
+
Creates a new rasterizer state.
+
+ void setRasterState(RasterState rs) pure virtual +
+
Sets the current rasterizer state.
+
+ auto createDepthStencilState(const DepthStencilStateDesc& desc) -> DepthStencilState pure virtual +
+
Creates a new depth stencil state.
+
+ void setDepthStencilState(DepthStencilState dss) pure virtual +
+
Sets the current depth stencil state.
+
+ auto createBlendState(const BlendStateDesc& desc) -> BlendState pure virtual +
+
Creates a new blend state.
+
+ void setBlendState(BlendState bs) pure virtual +
+
Sets the current blend state.
+
+ auto createSampler(const SamplerDesc& desc) -> Sampler pure virtual +
+
Creates a new texture sampler.
+
+ auto createTexture1D(const Texture1DDesc& desc) -> Texture1D pure virtual +
+
Creates a new 1D texture.
+
+ auto createTexture2D(const Texture2DDesc& desc) -> Texture2D pure virtual +
+
Creates a new 2D texture.
+
+ auto createTexture2DArray(const Texture2DArrayDesc& desc) -> Texture2DArray pure virtual +
+
Creates a new 2D texture array.
+
+ auto createTexture3D(const Texture3DDesc& desc) -> Texture3D pure virtual +
+
Creates a new 3D texture.
+
+ auto createCubeMap(const CubeMapDesc& desc) -> CubeMap pure virtual +
+
Creates a new cube map.
+
+ auto createCubeMapArray(const CubeMapArrayDesc& desc) -> CubeMapArray pure virtual +
+
Creates a new cube map array.
+
+ auto createConstantBuffer(std::size_t size, + const void* data, + Usage usage) -> ConstantBuffer pure virtual +
+
Creates a new constant buffer.
+
+ auto createIndexBuffer(std::size_t size, + const void* data, + IndexFormat format, + Usage usage) -> IndexBuffer pure virtual +
+
Creates a new index buffer.
+
+ void setIndexBuffer(IndexBuffer ib) pure virtual +
+
Sets the current index buffer.
+
+ auto createVertexBuffer(std::size_t size, + const void* data, + Usage usage) -> VertexBuffer pure virtual +
+
Creates a new vertex buffer.
+
+ auto createVertexArray(const VertexArrayDesc& desc) -> VertexArray pure virtual +
+
Creates a new vertex array.
+
+ void setVertexArray(VertexArray va) pure virtual +
+
Sets the current vertex array.
+
+ auto createShaderStage(Stage stage, + const char* src) -> ShaderStage pure virtual +
+
Creates a new shader stage from GLSL source code.
+
+ auto createShaderPipeline(ShaderStage vs, + ShaderStage ps) -> ShaderPipeline pure virtual +
+
Creates a new shader pipeline from vertex and pixel shaders.
+
+ auto createShaderPipeline(ShaderStage vs, + ShaderStage gs, + ShaderStage ps) -> ShaderPipeline pure virtual +
+
Creates a new shader pipeline from vertex, pixel and geometry shaders.
+
+ auto createShaderPipeline(ShaderStage cs) -> ShaderPipeline pure virtual +
+
Creates a new shader pipeline from a compute shader. Unsupported on some platforms.
+
+ void setShaderPipeline(ShaderPipeline pipeline) pure virtual +
+
Sets the current shader pipeline used for rendering.
+
+ void clearColor(float r, + float g, + float b, + float a) pure virtual +
+
Clears the color buffer bit on the current framebuffer to a specific color.
+
+ void clearTargetColor(std::size_t target, + float r, + float g, + float b, + float a) pure virtual +
+
Clears the color buffer of a specific target on the current framebuffer to a specific color.
+
+ void clearDepth(float depth) pure virtual +
+
Clears the depth buffer bit on the current framebuffer to a specific value.
+
+ void clearStencil(int stencil) pure virtual +
+
Clears the stencil buffer bit on the current framebuffer to a specific value.
+
+ void drawTriangles(std::size_t offset, + std::size_t count) pure virtual +
+
Draws tringles.
+
+ void drawTrianglesIndexed(std::size_t offset, + std::size_t count) pure virtual +
+
Draws tringles with an index buffer.
+
+ void drawTrianglesInstanced(std::size_t offset, + std::size_t count, + std::size_t instanceCount) pure virtual +
+
Draws tringles multiple times.
+
+ void drawTrianglesIndexedInstanced(std::size_t offset, + std::size_t count, + std::size_t instanceCount) pure virtual +
+
Draws tringles multiple times with an index buffer.
+
+ void dispatchCompute(std::size_t x, + std::size_t y, + std::size_t z) pure virtual +
+
Dispatches a compute pipeline.
+
+ void memoryBarrier(MemoryBarriers barriers) pure virtual +
+
Defines a barrier ordering memory transactions. Unsupported on some platforms.
+
+ void setViewport(int x, + int y, + int w, + int h) pure virtual +
+
Sets the current viewport.
+
+ void setScissor(int x, + int y, + int w, + int h) pure virtual +
+
Sets the current scissor rectangle.
+
+ auto getProperty(Property prop) -> int pure virtual +
+
Gets a runtime property of the render device.
+
+
+
+

Function documentation

+
+

+ Framebuffer cubos::core::gl::RenderDevice::createFramebuffer(const FramebufferDesc& desc) pure virtual +

+

Creates a new framebuffer.

+ + + + + + + + + + + + + + + + +
Parameters
descFramebuffer description.
ReturnsFramebuffer handle, or nullptr on failure.
+
+
+

+ void cubos::core::gl::RenderDevice::setFramebuffer(Framebuffer fb) pure virtual +

+

Sets the current framebuffer.

+ + + + + + + + + + +
Parameters
fbFramebuffer handle.
+
+
+

+ RasterState cubos::core::gl::RenderDevice::createRasterState(const RasterStateDesc& desc) pure virtual +

+

Creates a new rasterizer state.

+ + + + + + + + + + + + + + + + +
Parameters
descRasterizer state description.
ReturnsRasterizer state handle, or nullptr on failure.
+
+
+

+ void cubos::core::gl::RenderDevice::setRasterState(RasterState rs) pure virtual +

+

Sets the current rasterizer state.

+ + + + + + + + + + +
Parameters
rsRasterizer state handle.
+
+
+

+ DepthStencilState cubos::core::gl::RenderDevice::createDepthStencilState(const DepthStencilStateDesc& desc) pure virtual +

+

Creates a new depth stencil state.

+ + + + + + + + + + + + + + + + +
Parameters
descDepth stencil state description.
ReturnsDepth stencil state handle, or nullptr on failure.
+
+
+

+ void cubos::core::gl::RenderDevice::setDepthStencilState(DepthStencilState dss) pure virtual +

+

Sets the current depth stencil state.

+ + + + + + + + + + +
Parameters
dssDepth stencil state handle.
+
+
+

+ BlendState cubos::core::gl::RenderDevice::createBlendState(const BlendStateDesc& desc) pure virtual +

+

Creates a new blend state.

+ + + + + + + + + + + + + + + + +
Parameters
descBlend state description.
ReturnsBlend state handle, or nullptr on failure.
+
+
+

+ void cubos::core::gl::RenderDevice::setBlendState(BlendState bs) pure virtual +

+

Sets the current blend state.

+ + + + + + + + + + +
Parameters
bsBlend state handle.
+
+
+

+ Sampler cubos::core::gl::RenderDevice::createSampler(const SamplerDesc& desc) pure virtual +

+

Creates a new texture sampler.

+ + + + + + + + + + + + + + + + +
Parameters
descSampler description.
ReturnsSampler handle, or nullptr on failure.
+
+
+

+ Texture1D cubos::core::gl::RenderDevice::createTexture1D(const Texture1DDesc& desc) pure virtual +

+

Creates a new 1D texture.

+ + + + + + + + + + + + + + + + +
Parameters
desc1D texture description.
ReturnsTexture handle, or nullptr on failure.
+
+
+

+ Texture2D cubos::core::gl::RenderDevice::createTexture2D(const Texture2DDesc& desc) pure virtual +

+

Creates a new 2D texture.

+ + + + + + + + + + + + + + + + +
Parameters
desc2D texture description.
ReturnsTexture handle, or nullptr on failure.
+
+
+

+ Texture2DArray cubos::core::gl::RenderDevice::createTexture2DArray(const Texture2DArrayDesc& desc) pure virtual +

+

Creates a new 2D texture array.

+ + + + + + + + + + + + + + + + +
Parameters
desc2D texture array description.
ReturnsTexture array handle, or nullptr on failure.
+
+
+

+ Texture3D cubos::core::gl::RenderDevice::createTexture3D(const Texture3DDesc& desc) pure virtual +

+

Creates a new 3D texture.

+ + + + + + + + + + + + + + + + +
Parameters
desc3D texture description.
ReturnsTexture handle, or nullptr on failure.
+
+
+

+ CubeMap cubos::core::gl::RenderDevice::createCubeMap(const CubeMapDesc& desc) pure virtual +

+

Creates a new cube map.

+ + + + + + + + + + + + + + + + +
Parameters
descCube map description.
ReturnsCube map handle, or nullptr on failure.
+
+
+

+ CubeMapArray cubos::core::gl::RenderDevice::createCubeMapArray(const CubeMapArrayDesc& desc) pure virtual +

+

Creates a new cube map array.

+ + + + + + + + + + + + + + + + +
Parameters
descCube map array description.
ReturnsCube map array handle, or nullptr on failure.
+
+
+

+ ConstantBuffer cubos::core::gl::RenderDevice::createConstantBuffer(std::size_t size, + const void* data, + Usage usage) pure virtual +

+

Creates a new constant buffer.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
sizeSize in bytes.
dataInitial data, can be nullptr.
usageUsage which the buffer will have.
ReturnsConstant buffer handle, or nullptr on failure.
+
+
+

+ IndexBuffer cubos::core::gl::RenderDevice::createIndexBuffer(std::size_t size, + const void* data, + IndexFormat format, + Usage usage) pure virtual +

+

Creates a new index buffer.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
sizeSize in bytes.
dataInitial data, can be nullptr.
formatIndex format.
usageUsage which the buffer will have.
ReturnsIndex buffer handle, or nullptr on failure.
+
+
+

+ void cubos::core::gl::RenderDevice::setIndexBuffer(IndexBuffer ib) pure virtual +

+

Sets the current index buffer.

+ + + + + + + + + + +
Parameters
ibIndex buffer handle.
+
+
+

+ VertexBuffer cubos::core::gl::RenderDevice::createVertexBuffer(std::size_t size, + const void* data, + Usage usage) pure virtual +

+

Creates a new vertex buffer.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
sizeSize in bytes.
dataInitial data, can be nullptr.
usageUsage which the buffer will have.
ReturnsVertex buffer handle, or nullptr on failure.
+
+
+

+ VertexArray cubos::core::gl::RenderDevice::createVertexArray(const VertexArrayDesc& desc) pure virtual +

+

Creates a new vertex array.

+ + + + + + + + + + + + + + + + +
Parameters
descVertex array description.
ReturnsVertex array handle, or nullptr on failure.
+
+
+

+ void cubos::core::gl::RenderDevice::setVertexArray(VertexArray va) pure virtual +

+

Sets the current vertex array.

+ + + + + + + + + + +
Parameters
vaVertex array handle.
+
+
+

+ ShaderStage cubos::core::gl::RenderDevice::createShaderStage(Stage stage, + const char* src) pure virtual +

+

Creates a new shader stage from GLSL source code.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
stageShader stage.
srcGLSL source code.
ReturnsShader stage handle, or nullptr on failure.
+ +
+
+

+ ShaderPipeline cubos::core::gl::RenderDevice::createShaderPipeline(ShaderStage vs, + ShaderStage ps) pure virtual +

+

Creates a new shader pipeline from vertex and pixel shaders.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
vsVertex shader stage.
psPixel shader stage.
ReturnsShader pipeline handle, or nullptr on failure.
+
+
+

+ ShaderPipeline cubos::core::gl::RenderDevice::createShaderPipeline(ShaderStage vs, + ShaderStage gs, + ShaderStage ps) pure virtual +

+

Creates a new shader pipeline from vertex, pixel and geometry shaders.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
vsVertex shader stage.
gsGeometry shader stage.
psPixel shader stage.
ReturnsShader pipeline handle, or nullptr on failure.
+
+
+

+ ShaderPipeline cubos::core::gl::RenderDevice::createShaderPipeline(ShaderStage cs) pure virtual +

+

Creates a new shader pipeline from a compute shader. Unsupported on some platforms.

+ + + + + + + + + + + + + + + + +
Parameters
csCompute shader stage.
ReturnsShader pipeline handle, or nullptr on failure.
+ +
+
+

+ void cubos::core::gl::RenderDevice::setShaderPipeline(ShaderPipeline pipeline) pure virtual +

+

Sets the current shader pipeline used for rendering.

+ + + + + + + + + + +
Parameters
pipelineShader pipeline handle.
+
+
+

+ void cubos::core::gl::RenderDevice::clearColor(float r, + float g, + float b, + float a) pure virtual +

+

Clears the color buffer bit on the current framebuffer to a specific color.

+ + + + + + + + + + + + + + + + + + + + + + +
Parameters
rRed component.
gGreen component.
bBlue component.
aAlpha component.
+
+
+

+ void cubos::core::gl::RenderDevice::clearTargetColor(std::size_t target, + float r, + float g, + float b, + float a) pure virtual +

+

Clears the color buffer of a specific target on the current framebuffer to a specific color.

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
targetTarget index.
rRed component.
gGreen component.
bBlue component.
aAlpha component.
+
+
+

+ void cubos::core::gl::RenderDevice::clearDepth(float depth) pure virtual +

+

Clears the depth buffer bit on the current framebuffer to a specific value.

+ + + + + + + + + + +
Parameters
depthDepth value.
+
+
+

+ void cubos::core::gl::RenderDevice::clearStencil(int stencil) pure virtual +

+

Clears the stencil buffer bit on the current framebuffer to a specific value.

+ + + + + + + + + + +
Parameters
stencilStencil value.
+
+
+

+ void cubos::core::gl::RenderDevice::drawTriangles(std::size_t offset, + std::size_t count) pure virtual +

+

Draws tringles.

+ + + + + + + + + + + + + + +
Parameters
offsetIndex of the first vertex to be drawn.
countNumber of vertices that will be drawn.
+
+
+

+ void cubos::core::gl::RenderDevice::drawTrianglesIndexed(std::size_t offset, + std::size_t count) pure virtual +

+

Draws tringles with an index buffer.

+ + + + + + + + + + + + + + +
Parameters
offsetIndex of the first indice to be drawn.
countNumber of indices that will be drawn.
+
+
+

+ void cubos::core::gl::RenderDevice::drawTrianglesInstanced(std::size_t offset, + std::size_t count, + std::size_t instanceCount) pure virtual +

+

Draws tringles multiple times.

+ + + + + + + + + + + + + + + + + + +
Parameters
offsetIndex of the first vertex to be drawn.
countNumber of vertices that will be drawn.
instanceCountNumber of instances drawn.
+
+
+

+ void cubos::core::gl::RenderDevice::drawTrianglesIndexedInstanced(std::size_t offset, + std::size_t count, + std::size_t instanceCount) pure virtual +

+

Draws tringles multiple times with an index buffer.

+ + + + + + + + + + + + + + + + + + +
Parameters
offsetIndex of the first indice to be drawn.
countNumber of indices that will be drawn.
instanceCountNumber of instances drawn.
+
+
+

+ void cubos::core::gl::RenderDevice::dispatchCompute(std::size_t x, + std::size_t y, + std::size_t z) pure virtual +

+

Dispatches a compute pipeline.

+ + + + + + + + + + + + + + + + + + +
Parameters
xX dimension of the work group.
yY dimension of the work group.
zZ dimension of the work group.
+
+
+

+ void cubos::core::gl::RenderDevice::memoryBarrier(MemoryBarriers barriers) pure virtual +

+

Defines a barrier ordering memory transactions. Unsupported on some platforms.

+ + + + + + + + + + +
Parameters
barriersBarriers to apply.
+

This ensure that all memory transactions before the barrier are completed before the barrier is executed.

+
+
+

+ void cubos::core::gl::RenderDevice::setViewport(int x, + int y, + int w, + int h) pure virtual +

+

Sets the current viewport.

+ + + + + + + + + + + + + + + + + + + + + + +
Parameters
xBottom left viewport corner X coordinate.
yBottom left viewport corner Y coordinate.
wViewport width.
hViewport height.
+
+
+

+ void cubos::core::gl::RenderDevice::setScissor(int x, + int y, + int w, + int h) pure virtual +

+

Sets the current scissor rectangle.

+ + + + + + + + + + + + + + + + + + + + + + +
Parameters
xBottom left scissor rectangle corner X coordinate.
yBottom left scissor rectangle corner Y coordinate.
wScissor rectangle width.
hScissor rectangle height.
+
+
+

+ int cubos::core::gl::RenderDevice::getProperty(Property prop) pure virtual +

+

Gets a runtime property of the render device.

+ + + + + + + + + + +
Parameters
propProperty name.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1BlendState.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1BlendState.html new file mode 100644 index 000000000..59a04ad5c --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1BlendState.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::impl::BlendState class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::BlendState class +
#include <core/gl/render_device.hpp>
+

+

Abstract blend state.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1ConstantBuffer.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1ConstantBuffer.html new file mode 100644 index 000000000..3929921d3 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1ConstantBuffer.html @@ -0,0 +1,142 @@ + + + + + cubos::core::gl::impl::ConstantBuffer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::ConstantBuffer class +
#include <core/gl/render_device.hpp>
+

+

Abstract constant buffer.

+ +
+

Public functions

+
+
+ auto map() -> void* pure virtual +
+
Maps the constant buffer to a region in memory. Must be matched with a call to unmap().
+
+ void unmap() pure virtual +
+
Unmaps the constant buffer, updating it with data written to the mapped region.
+
+
+
+

Function documentation

+
+

+ void* cubos::core::gl::impl::ConstantBuffer::map() pure virtual +

+

Maps the constant buffer to a region in memory. Must be matched with a call to unmap().

+ + + + + + + +
ReturnsPointer to the memory region.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1CubeMap.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1CubeMap.html new file mode 100644 index 000000000..6cf631e2d --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1CubeMap.html @@ -0,0 +1,181 @@ + + + + + cubos::core::gl::impl::CubeMap class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::CubeMap class +
#include <core/gl/render_device.hpp>
+

+

Abstract cube map.

+ +
+

Public functions

+
+
+ void update(std::size_t x, + std::size_t y, + std::size_t width, + std::size_t height, + const void* data, + CubeFace face, + std::size_t level = 0) pure virtual +
+
Updates a cube map's face with new data, which must have the same format used when the cube map was created.
+
+ void generateMipmaps() pure virtual +
+
Generates mipmaps on this cube map.
+
+
+
+

Function documentation

+
+

+ void cubos::core::gl::impl::CubeMap::update(std::size_t x, + std::size_t y, + std::size_t width, + std::size_t height, + const void* data, + CubeFace face, + std::size_t level = 0) pure virtual +

+

Updates a cube map's face with new data, which must have the same format used when the cube map was created.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
xDestination X coordinate.
yDestination Y coordinate.
widthWidth of the section which will be updated.
heightHeight of the section which will be updated.
dataPointer to the new data.
faceFace to update.
levelMip level to update.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1CubeMapArray.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1CubeMapArray.html new file mode 100644 index 000000000..93f9833bb --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1CubeMapArray.html @@ -0,0 +1,187 @@ + + + + + cubos::core::gl::impl::CubeMapArray class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::CubeMapArray class +
#include <core/gl/render_device.hpp>
+

+

Abstract cube map.

+ +
+

Public functions

+
+
+ void update(std::size_t x, + std::size_t y, + std::size_t i, + std::size_t width, + std::size_t height, + const void* data, + CubeFace face, + std::size_t level = 0) pure virtual +
+
Updates a cube map's face with new data, which must have the same format used when the cube map was created.
+
+ void generateMipmaps() pure virtual +
+
Generates mipmaps on this cube map.
+
+
+
+

Function documentation

+
+

+ void cubos::core::gl::impl::CubeMapArray::update(std::size_t x, + std::size_t y, + std::size_t i, + std::size_t width, + std::size_t height, + const void* data, + CubeFace face, + std::size_t level = 0) pure virtual +

+

Updates a cube map's face with new data, which must have the same format used when the cube map was created.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
xDestination X coordinate.
yDestination Y coordinate.
iIndex of the destination texture within the array.
widthWidth of the section which will be updated.
heightHeight of the section which will be updated.
dataPointer to the new data.
faceFace to update.
levelMip level to update.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1DepthStencilState.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1DepthStencilState.html new file mode 100644 index 000000000..5d3e3eb42 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1DepthStencilState.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::impl::DepthStencilState class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::DepthStencilState class +
#include <core/gl/render_device.hpp>
+

+

Abstract depth stencil state.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Framebuffer.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Framebuffer.html new file mode 100644 index 000000000..34392800b --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Framebuffer.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::impl::Framebuffer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::Framebuffer class +
#include <core/gl/render_device.hpp>
+

+

Abstract framebuffer.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1IndexBuffer.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1IndexBuffer.html new file mode 100644 index 000000000..d0295348a --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1IndexBuffer.html @@ -0,0 +1,142 @@ + + + + + cubos::core::gl::impl::IndexBuffer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::IndexBuffer class +
#include <core/gl/render_device.hpp>
+

+

Abstract index buffer.

+ +
+

Public functions

+
+
+ auto map() -> void* pure virtual +
+
Maps the index buffer to a region in memory. Must be matched with a call to unmap().
+
+ void unmap() pure virtual +
+
Unmaps the index buffer, updating it with data written to the mapped region.
+
+
+
+

Function documentation

+
+

+ void* cubos::core::gl::impl::IndexBuffer::map() pure virtual +

+

Maps the index buffer to a region in memory. Must be matched with a call to unmap().

+ + + + + + + +
ReturnsPointer to the memory region.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1RasterState.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1RasterState.html new file mode 100644 index 000000000..7e424012d --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1RasterState.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::impl::RasterState class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::RasterState class +
#include <core/gl/render_device.hpp>
+

+

Abstract rasterizer state.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Sampler.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Sampler.html new file mode 100644 index 000000000..e9cbecc9f --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Sampler.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::impl::Sampler class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::Sampler class +
#include <core/gl/render_device.hpp>
+

+

Abstract sampler.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderBindingPoint.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderBindingPoint.html new file mode 100644 index 000000000..c66675312 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderBindingPoint.html @@ -0,0 +1,622 @@ + + + + + cubos::core::gl::impl::ShaderBindingPoint class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::ShaderBindingPoint class +
#include <core/gl/render_device.hpp>
+

+

Abstract shader binding point.

+ +
+

Public functions

+
+
+ void bind(gl::Sampler sampler) pure virtual +
+
Binds a sampler to the binding point.
+
+ void bind(gl::Texture1D tex) pure virtual +
+
Binds a 1D texture to the binding point.
+
+ void bind(gl::Texture2D tex) pure virtual +
+
Binds a 2D texture to the binding point.
+
+ void bind(gl::Texture2DArray tex) pure virtual +
+
Binds a 2D texture array to the binding point.
+
+ void bind(gl::Texture3D tex) pure virtual +
+
Binds a 3D texture to the binding point.
+
+ void bind(gl::CubeMap cubeMap) pure virtual +
+
Binds a cube map to the binding point.
+
+ void bind(gl::CubeMapArray cubeMap) pure virtual +
+
Binds a cube map array to the binding point.
+
+ void bind(gl::ConstantBuffer cb) pure virtual +
+
Binds a constant buffer to the binding point.
+
+ void bind(gl::Texture2D tex, + int level, + Access access) pure virtual +
+
Binds a level of a 2D texture to an image unit.
+
+ void setConstant(glm::vec2 val) pure virtual +
+
Sets the value of the uniform tied to the binding point to the provided vec2 value.
+
+ void setConstant(glm::vec3 val) pure virtual +
+
Sets the value of the uniform tied to the binding point to the provided vec3 value.
+
+ void setConstant(glm::vec4 val) pure virtual +
+
Sets the value of the uniform tied to the binding point to the provided vec4 value.
+
+ void setConstant(glm::ivec2 val) pure virtual +
+
Sets the value of the uniform tied to the binding point to the provided integer vec2 value.
+
+ void setConstant(glm::ivec3 val) pure virtual +
+
Sets the value of the uniform tied to the binding point to the provided integer vec3 value.
+
+ void setConstant(glm::ivec4 val) pure virtual +
+
Sets the value of the uniform tied to the binding point to the provided integer vec4 value.
+
+ void setConstant(glm::uvec2 val) pure virtual +
+
Sets the value of the uniform tied to the binding point to the provided unsigned integer vec2 value.
+
+ void setConstant(glm::uvec3 val) pure virtual +
+
Sets the value of the uniform tied to the binding point to the provided unsigned integer vec3 value.
+
+ void setConstant(glm::uvec4 val) pure virtual +
+
Sets the value of the uniform tied to the binding point to the provided unsigned integer vec4 value.
+
+ void setConstant(glm::mat4 val) pure virtual +
+
Sets the value of the uniform tied to the binding point to the provided mat4 value.
+
+ void setConstant(float val) pure virtual +
+
Sets the value of the uniform tied to the binding point to the provided float value.
+
+ void setConstant(int val) pure virtual +
+
Sets the value of the uniform tied to the binding point to the provided int value.
+
+ void setConstant(unsigned int val) pure virtual +
+
Sets the value of the uniform tied to the binding point to the provided unsigned int value.
+
+ auto queryConstantBufferStructure(ConstantBufferStructure* structure) -> bool pure virtual +
+
Gets the constant buffer structure of this binding point.
+
+
+
+

Function documentation

+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::bind(gl::Sampler sampler) pure virtual +

+

Binds a sampler to the binding point.

+ + + + + + + + + + +
Parameters
samplerSampler to bind.
+

If this binding point doesn't support a sampler, an error is logged.

+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::bind(gl::Texture1D tex) pure virtual +

+

Binds a 1D texture to the binding point.

+ + + + + + + + + + +
Parameters
texTexture to bind.
+

If this binding point doesn't support a 1D texture, an error is logged.

+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::bind(gl::Texture2D tex) pure virtual +

+

Binds a 2D texture to the binding point.

+ + + + + + + + + + +
Parameters
texTexture to bind.
+

If this binding point doesn't support a 2D texture, an error is logged.

+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::bind(gl::Texture2DArray tex) pure virtual +

+

Binds a 2D texture array to the binding point.

+ + + + + + + + + + +
Parameters
texTexture array to bind.
+

If this binding point doesn't support a 2D texture array, an error is logged.

+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::bind(gl::Texture3D tex) pure virtual +

+

Binds a 3D texture to the binding point.

+ + + + + + + + + + +
Parameters
texTexture to bind.
+

If this binding point doesn't support a 3D texture, an error is logged.

+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::bind(gl::CubeMap cubeMap) pure virtual +

+

Binds a cube map to the binding point.

+ + + + + + + + + + +
Parameters
cubeMapCube map to bind.
+

If this binding point doesn't support a cube map, an error is logged.

+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::bind(gl::CubeMapArray cubeMap) pure virtual +

+

Binds a cube map array to the binding point.

+ + + + + + + + + + +
Parameters
cubeMapCube map to bind.
+

If this binding point doesn't support a cube map array, an error is logged.

+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::bind(gl::ConstantBuffer cb) pure virtual +

+

Binds a constant buffer to the binding point.

+ + + + + + + + + + +
Parameters
cbConstant buffer to bind.
+

If this binding point doesn't support a constant buffer, an error is logged.

+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::bind(gl::Texture2D tex, + int level, + Access access) pure virtual +

+

Binds a level of a 2D texture to an image unit.

+ + + + + + + + + + + + + + + + + + +
Parameters
texTexture to bind.
levelMip level to bind.
accessAccess mode.
+

If this binding point doesn't support an image unit, an error is logged.

+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::setConstant(glm::vec2 val) pure virtual +

+

Sets the value of the uniform tied to the binding point to the provided vec2 value.

+ + + + + + + + + + +
Parameters
valValue to set.
+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::setConstant(glm::vec3 val) pure virtual +

+

Sets the value of the uniform tied to the binding point to the provided vec3 value.

+ + + + + + + + + + +
Parameters
valValue to set.
+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::setConstant(glm::vec4 val) pure virtual +

+

Sets the value of the uniform tied to the binding point to the provided vec4 value.

+ + + + + + + + + + +
Parameters
valValue to set.
+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::setConstant(glm::ivec2 val) pure virtual +

+

Sets the value of the uniform tied to the binding point to the provided integer vec2 value.

+ + + + + + + + + + +
Parameters
valValue to set.
+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::setConstant(glm::ivec3 val) pure virtual +

+

Sets the value of the uniform tied to the binding point to the provided integer vec3 value.

+ + + + + + + + + + +
Parameters
valValue to set.
+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::setConstant(glm::ivec4 val) pure virtual +

+

Sets the value of the uniform tied to the binding point to the provided integer vec4 value.

+ + + + + + + + + + +
Parameters
valValue to set.
+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::setConstant(glm::uvec2 val) pure virtual +

+

Sets the value of the uniform tied to the binding point to the provided unsigned integer vec2 value.

+ + + + + + + + + + +
Parameters
valValue to set.
+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::setConstant(glm::uvec3 val) pure virtual +

+

Sets the value of the uniform tied to the binding point to the provided unsigned integer vec3 value.

+ + + + + + + + + + +
Parameters
valValue to set.
+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::setConstant(glm::uvec4 val) pure virtual +

+

Sets the value of the uniform tied to the binding point to the provided unsigned integer vec4 value.

+ + + + + + + + + + +
Parameters
valValue to set.
+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::setConstant(glm::mat4 val) pure virtual +

+

Sets the value of the uniform tied to the binding point to the provided mat4 value.

+ + + + + + + + + + +
Parameters
valValue to set.
+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::setConstant(float val) pure virtual +

+

Sets the value of the uniform tied to the binding point to the provided float value.

+ + + + + + + + + + +
Parameters
valValue to set.
+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::setConstant(int val) pure virtual +

+

Sets the value of the uniform tied to the binding point to the provided int value.

+ + + + + + + + + + +
Parameters
valValue to set.
+
+
+

+ void cubos::core::gl::impl::ShaderBindingPoint::setConstant(unsigned int val) pure virtual +

+

Sets the value of the uniform tied to the binding point to the provided unsigned int value.

+ + + + + + + + + + +
Parameters
valValue to set.
+
+
+

+ bool cubos::core::gl::impl::ShaderBindingPoint::queryConstantBufferStructure(ConstantBufferStructure* structure) pure virtual +

+

Gets the constant buffer structure of this binding point.

+ + + + + + + +
ReturnsWhether the query was successful.
+

If this binding point doesn't support a constant buffer, an error is logged.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderPipeline.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderPipeline.html new file mode 100644 index 000000000..72467c2c7 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderPipeline.html @@ -0,0 +1,138 @@ + + + + + cubos::core::gl::impl::ShaderPipeline class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::ShaderPipeline class +
#include <core/gl/render_device.hpp>
+

+

Abstract shader pipeline.

+ +
+

Public functions

+
+
+ auto getBindingPoint(const char* name) -> gl::ShaderBindingPoint pure virtual +
+
Gets a binding point from its name.
+
+
+
+

Function documentation

+
+

+ gl::ShaderBindingPoint cubos::core::gl::impl::ShaderPipeline::getBindingPoint(const char* name) pure virtual +

+

Gets a binding point from its name.

+ + + + + + + +
ReturnsBinding point, or nullptr if no binding point is found.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderStage.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderStage.html new file mode 100644 index 000000000..9dc01f959 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderStage.html @@ -0,0 +1,138 @@ + + + + + cubos::core::gl::impl::ShaderStage class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::ShaderStage class +
#include <core/gl/render_device.hpp>
+

+

Abstract shader stage.

+ +
+

Public functions

+
+
+ auto getType() -> Stage pure virtual +
+
Gets the shader stage type.
+
+
+
+

Function documentation

+
+

+ Stage cubos::core::gl::impl::ShaderStage::getType() pure virtual +

+

Gets the shader stage type.

+ + + + + + + +
ReturnsShader stage type.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Texture1D.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Texture1D.html new file mode 100644 index 000000000..49761a784 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Texture1D.html @@ -0,0 +1,163 @@ + + + + + cubos::core::gl::impl::Texture1D class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::Texture1D class +
#include <core/gl/render_device.hpp>
+

+

Abstract 1D texture.

+ +
+

Public functions

+
+
+ void update(std::size_t x, + std::size_t width, + const void* data, + std::size_t level = 0) pure virtual +
+
Updates the texture with new data, which must have the same format used when the texture was created.
+
+ void generateMipmaps() pure virtual +
+
Generates mipmaps on this texture.
+
+
+
+

Function documentation

+
+

+ void cubos::core::gl::impl::Texture1D::update(std::size_t x, + std::size_t width, + const void* data, + std::size_t level = 0) pure virtual +

+

Updates the texture with new data, which must have the same format used when the texture was created.

+ + + + + + + + + + + + + + + + + + + + + + +
Parameters
xDestination X coordinate.
widthWidth of the section which will be updated.
dataPointer to the new data.
levelMip level to update.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Texture2D.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Texture2D.html new file mode 100644 index 000000000..f97e24a4d --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Texture2D.html @@ -0,0 +1,175 @@ + + + + + cubos::core::gl::impl::Texture2D class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::Texture2D class +
#include <core/gl/render_device.hpp>
+

+

Abstract 2D texture.

+ +
+

Public functions

+
+
+ void update(std::size_t x, + std::size_t y, + std::size_t width, + std::size_t height, + const void* data, + std::size_t level = 0) pure virtual +
+
Updates the texture with new data, which must have the same format used when the texture was created.
+
+ void generateMipmaps() pure virtual +
+
Generates mipmaps on this texture.
+
+
+
+

Function documentation

+
+

+ void cubos::core::gl::impl::Texture2D::update(std::size_t x, + std::size_t y, + std::size_t width, + std::size_t height, + const void* data, + std::size_t level = 0) pure virtual +

+

Updates the texture with new data, which must have the same format used when the texture was created.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
xDestination X coordinate.
yDestination Y coordinate.
widthWidth of the section which will be updated.
heightHeight of the section which will be updated.
dataPointer to the new data.
levelMip level to update.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Texture2DArray.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Texture2DArray.html new file mode 100644 index 000000000..b23610106 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Texture2DArray.html @@ -0,0 +1,181 @@ + + + + + cubos::core::gl::impl::Texture2DArray class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::Texture2DArray class +
#include <core/gl/render_device.hpp>
+

+

Abstract 2D texture array.

+ +
+

Public functions

+
+
+ void update(std::size_t x, + std::size_t y, + std::size_t i, + std::size_t width, + std::size_t height, + const void* data, + std::size_t level = 0) pure virtual +
+
Updates the texture with new data, which must have the same format used when the texture was created.
+
+ void generateMipmaps() pure virtual +
+
Generates mipmaps on this texture.
+
+
+
+

Function documentation

+
+

+ void cubos::core::gl::impl::Texture2DArray::update(std::size_t x, + std::size_t y, + std::size_t i, + std::size_t width, + std::size_t height, + const void* data, + std::size_t level = 0) pure virtual +

+

Updates the texture with new data, which must have the same format used when the texture was created.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
xDestination X coordinate.
yDestination Y coordinate.
iIndex of the destination texture within the array.
widthWidth of the section which will be updated.
heightHeight of the section which will be updated.
dataPointer to the new data.
levelMip level to update.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Texture3D.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Texture3D.html new file mode 100644 index 000000000..8729c8c7c --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1Texture3D.html @@ -0,0 +1,187 @@ + + + + + cubos::core::gl::impl::Texture3D class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::Texture3D class +
#include <core/gl/render_device.hpp>
+

+

Abstract 3D texture.

+ +
+

Public functions

+
+
+ void update(std::size_t x, + std::size_t y, + std::size_t z, + std::size_t width, + std::size_t height, + std::size_t depth, + const void* data, + std::size_t level = 0) pure virtual +
+
Updates the texture with new data, which must have the same format used when the texture was created.
+
+ void generateMipmaps() pure virtual +
+
Generates mipmaps on this texture.
+
+
+
+

Function documentation

+
+

+ void cubos::core::gl::impl::Texture3D::update(std::size_t x, + std::size_t y, + std::size_t z, + std::size_t width, + std::size_t height, + std::size_t depth, + const void* data, + std::size_t level = 0) pure virtual +

+

Updates the texture with new data, which must have the same format used when the texture was created.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
xDestination X coordinate.
yDestination Y coordinate.
zDestination Z coordinate.
widthWidth of the section which will be updated.
heightHeight of the section which will be updated.
depthDepth of the section which will be updated.
dataPointer to the new data.
levelMip level to update.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1VertexArray.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1VertexArray.html new file mode 100644 index 000000000..d50bb9849 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1VertexArray.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::impl::VertexArray class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::VertexArray class +
#include <core/gl/render_device.hpp>
+

+

Abstract vertex array.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1VertexBuffer.html b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1VertexBuffer.html new file mode 100644 index 000000000..6ec8883ba --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1gl_1_1impl_1_1VertexBuffer.html @@ -0,0 +1,142 @@ + + + + + cubos::core::gl::impl::VertexBuffer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl::VertexBuffer class +
#include <core/gl/render_device.hpp>
+

+

Abstract vertex buffer.

+ +
+

Public functions

+
+
+ auto map() -> void* pure virtual +
+
Maps the vertex buffer to a region in memory. Must be matched with a call to unmap().
+
+ void unmap() pure virtual +
+
Unmaps the vertex buffer, updating it with data written to the mapped region.
+
+
+
+

Function documentation

+
+

+ void* cubos::core::gl::impl::VertexBuffer::map() pure virtual +

+

Maps the vertex buffer to a region in memory. Must be matched with a call to unmap().

+ + + + + + + +
ReturnsPointer to the memory region.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1io_1_1BaseWindow.html b/pr-preview/pr-494/classcubos_1_1core_1_1io_1_1BaseWindow.html new file mode 100644 index 000000000..8f2123f9a --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1io_1_1BaseWindow.html @@ -0,0 +1,442 @@ + + + + + cubos::core::io::BaseWindow class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::io::BaseWindow class +
#include <core/io/window.hpp>
+

+

Interface used to wrap low-level window API implementations.

+ +

Allows polling of input events and creates a gl::RenderDevice for rendering to the window.

+
+

Public functions

+
+
+ void pushEvent(WindowEvent&& event) +
+
Pushes an event to the event queue.
+
+ auto pollEvent() -> std::optional<WindowEvent> +
+
Polls the window for events.
+
+ void swapBuffers() pure virtual +
+
Swaps the window buffers.
+
+ auto renderDevice() const -> gl::RenderDevice& pure virtual +
+
Gets the render device associated with this window.
+
+ auto size() const -> glm::ivec2 pure virtual +
+
Gets the window size, which may differ from the framebuffer size.
+
+ auto framebufferSize() const -> glm::ivec2 pure virtual +
+
Gets the window framebuffer size, which may differ from the window size.
+
+ auto shouldClose() const -> bool pure virtual +
+
Checks whether the window should close.
+
+ auto time() const -> double pure virtual +
+
Gets the time since the window was created.
+
+ void mouseState(MouseState state) pure virtual +
+
Sets the mouse state when the window is focused.
+
+ auto mouseState() const -> MouseState pure virtual +
+
Gets the mouse state when the window is focused.
+
+ auto createCursor(Cursor::Standard standard) -> std::shared_ptr<Cursor> pure virtual +
+
Creates a new cursor with a standard shape.
+
+ void cursor(std::shared_ptr<Cursor> cursor) pure virtual +
+
Sets the current cursor. Pass nullptr to use the default cursor.
+
+ void clipboard(const std::string& text) pure virtual +
+
Sets the content of the clipboard.
+
+ auto clipboard() const -> const char* pure virtual +
+
Gets the content of the clipboard.
+
+ auto modifiers() const -> Modifiers pure virtual +
+
Gets the last used keyboard modifiers.
+
+ auto pressed(Key key, + Modifiers modifiers = Modifiers::None) const -> bool pure virtual +
+
Checks if a key is currently pressed with (at least) the given modifiers.
+
+
+
+

Protected functions

+
+
+ void pollEvents() pure virtual +
+
Asks the implementation to fill the event queue with new events.
+
+
+
+

Function documentation

+
+

+ void cubos::core::io::BaseWindow::pushEvent(WindowEvent&& event) +

+

Pushes an event to the event queue.

+ + + + + + + + + + +
Parameters
eventEvent to push.
+
+
+

+ std::optional<WindowEvent> cubos::core::io::BaseWindow::pollEvent() +

+

Polls the window for events.

+ + + + + + + +
ReturnsNext event, or std::nullopt if there are no more events.
+
+
+

+ gl::RenderDevice& cubos::core::io::BaseWindow::renderDevice() const pure virtual +

+

Gets the render device associated with this window.

+ + + + + + + +
ReturnsRender device associated with this window.
+
+
+

+ glm::ivec2 cubos::core::io::BaseWindow::size() const pure virtual +

+

Gets the window size, which may differ from the framebuffer size.

+ + + + + + + +
ReturnsWindow size, in screen coordinates.
+
+
+

+ glm::ivec2 cubos::core::io::BaseWindow::framebufferSize() const pure virtual +

+

Gets the window framebuffer size, which may differ from the window size.

+ + + + + + + +
ReturnsWindow framebuffer size, in pixels.
+
+
+

+ bool cubos::core::io::BaseWindow::shouldClose() const pure virtual +

+

Checks whether the window should close.

+ + + + + + + +
ReturnsWhether the window should close.
+
+
+

+ double cubos::core::io::BaseWindow::time() const pure virtual +

+

Gets the time since the window was created.

+ + + + + + + +
ReturnsTime since the window was created, in seconds.
+
+
+

+ void cubos::core::io::BaseWindow::mouseState(MouseState state) pure virtual +

+

Sets the mouse state when the window is focused.

+ + + + + + + + + + +
Parameters
stateMouse state.
+
+
+

+ MouseState cubos::core::io::BaseWindow::mouseState() const pure virtual +

+

Gets the mouse state when the window is focused.

+ + + + + + + +
ReturnsMouse state when the window is focused.
+
+
+

+ std::shared_ptr<Cursor> cubos::core::io::BaseWindow::createCursor(Cursor::Standard standard) pure virtual +

+

Creates a new cursor with a standard shape.

+ + + + + + + + + + + + + + + + +
Parameters
standardStandard cursor to use.
ReturnsNew cursor, or nullptr if creation failed.
+
+
+

+ void cubos::core::io::BaseWindow::cursor(std::shared_ptr<Cursor> cursor) pure virtual +

+

Sets the current cursor. Pass nullptr to use the default cursor.

+ + + + + + + + + + +
Parameters
cursorNew cursor.
+
+
+

+ void cubos::core::io::BaseWindow::clipboard(const std::string& text) pure virtual +

+

Sets the content of the clipboard.

+ + + + + + + + + + +
Parameters
textNew clipboard text.
+
+
+

+ const char* cubos::core::io::BaseWindow::clipboard() const pure virtual +

+

Gets the content of the clipboard.

+ + + + + + + +
ReturnsText from the clipboard. Guaranteed to be valid until the next call.
+ +
+
+

+ Modifiers cubos::core::io::BaseWindow::modifiers() const pure virtual +

+

Gets the last used keyboard modifiers.

+ + + + + + + +
ReturnsActive keyboard modifiers.
+
+
+

+ bool cubos::core::io::BaseWindow::pressed(Key key, + Modifiers modifiers = Modifiers::None) const pure virtual +

+

Checks if a key is currently pressed with (at least) the given modifiers.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
keyKey to check.
modifiersModifiers to check.
ReturnsWhether the key and modifiers (or a superset of) are currently pressed.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1io_1_1Cursor.html b/pr-preview/pr-494/classcubos_1_1core_1_1io_1_1Cursor.html new file mode 100644 index 000000000..196c59bde --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1io_1_1Cursor.html @@ -0,0 +1,204 @@ + + + + + cubos::core::io::Cursor class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::io::Cursor class +
#include <core/io/cursor.hpp>
+

+

Handle for a custom mouse cursor.

+ +
+

Public types

+
+
+ enum class Standard { Arrow, + IBeam, + Cross, + Hand, + EWResize, + NSResize, + NWSEResize, + NESWResize, + AllResize, + NotAllowed } +
+
Identifiers for the different standard cursors.
+
+
+
+

Enum documentation

+
+

+ enum class cubos::core::io::Cursor::Standard +

+

Identifiers for the different standard cursors.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Enumerators
Arrow +

Standard arrow cursor.

+
IBeam +

Standard I-beam cursor.

+
Cross +

Standard crosshair cursor.

+
Hand +

Standard hand cursor.

+
EWResize +

Standard horizontal resize cursor.

+
NSResize +

Standard vertical resize cursor.

+
NWSEResize +

Standard diagonal resize cursor (top-left to bottom-right).

+
NESWResize +

Standard diagonal resize cursor (top-right to bottom-left).

+
AllResize +

Standard all directions resize cursor.

+
NotAllowed +

Standard not allowed cursor.

+
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1BufferStream.html b/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1BufferStream.html new file mode 100644 index 000000000..56620746b --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1BufferStream.html @@ -0,0 +1,424 @@ + + + + + cubos::core::memory::BufferStream class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::memory::BufferStream class +
#include <core/memory/buffer_stream.hpp>
+

+

Stream implementation which writes to/reads from a buffer.

+ +
+

Base classes

+
+
+ class Stream +
+
Interface class for memory streams. Abstracts away sources or destinations of data.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ BufferStream(void* buffer, + std::size_t size, + bool readOnly = false) +
+
Constructs using an existing buffer.
+
+ BufferStream(const void* buffer, + std::size_t size) +
+
Constructs using a read-only buffer.
+
+ BufferStream(std::size_t size = 16) +
+
Constructs using a new buffer, managed internally and which grows as needed.
+
+ BufferStream(const BufferStream& other) +
+
Constructs a copy of another buffer stream. If the given buffer stream owns its buffer, the copy will also create its own buffer. Otherwise, it will share the buffer with the original.
+
+ BufferStream(BufferStream&& other) noexcept +
+
Move constructs.
+
+
+
+

Public functions

+
+
+ auto getBuffer() const -> const void* +
+
Gets the buffer of this stream.
+
+ auto read(void* data, + std::size_t size) -> std::size_t override +
+
Reads data from the stream.
+
+ auto write(const void* data, + std::size_t size) -> std::size_t override +
+
Writes data to the stream.
+
+ auto tell() const -> std::size_t override +
+
Gets the current position in the stream.
+
+ void seek(ptrdiff_t offset, + SeekOrigin origin) override +
+
Seeks to a position in the stream.
+
+ auto eof() const -> bool override +
+
Checks if the stream still has content to read.
+
+ auto peek() const -> char override +
+
Peeks one byte from the stream.
+
+
+
+

Function documentation

+
+

+ cubos::core::memory::BufferStream::BufferStream(void* buffer, + std::size_t size, + bool readOnly = false) +

+

Constructs using an existing buffer.

+ + + + + + + + + + + + + + + + + + +
Parameters
bufferBuffer to read/write from.
sizeSize of the buffer.
readOnlyWhether the buffer is read-only.
+
+
+

+ cubos::core::memory::BufferStream::BufferStream(const void* buffer, + std::size_t size) +

+

Constructs using a read-only buffer.

+ + + + + + + + + + + + + + +
Parameters
bufferBuffer to read/write from.
sizeSize of the buffer.
+
+
+

+ cubos::core::memory::BufferStream::BufferStream(std::size_t size = 16) +

+

Constructs using a new buffer, managed internally and which grows as needed.

+ + + + + + + + + + +
Parameters
sizeInitial size of the buffer.
+
+
+

+ cubos::core::memory::BufferStream::BufferStream(const BufferStream& other) +

+

Constructs a copy of another buffer stream. If the given buffer stream owns its buffer, the copy will also create its own buffer. Otherwise, it will share the buffer with the original.

+ + + + + + + + + + +
Parameters
otherBuffer stream to copy.
+
+
+

+ cubos::core::memory::BufferStream::BufferStream(BufferStream&& other) noexcept +

+

Move constructs.

+ + + + + + + + + + +
Parameters
otherBuffer stream to move.
+
+
+

+ const void* cubos::core::memory::BufferStream::getBuffer() const +

+

Gets the buffer of this stream.

+ + + + + + + +
ReturnsBuffer.
+
+
+

+ std::size_t cubos::core::memory::BufferStream::read(void* data, + std::size_t size) override +

+

Reads data from the stream.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
dataBuffer to read data into.
sizeSize of the buffer.
ReturnsNumber of bytes read.
+
+
+

+ std::size_t cubos::core::memory::BufferStream::write(const void* data, + std::size_t size) override +

+

Writes data to the stream.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
dataBuffer to write data from.
sizeSize of the buffer.
ReturnsNumber of bytes written.
+
+
+

+ std::size_t cubos::core::memory::BufferStream::tell() const override +

+

Gets the current position in the stream.

+ + + + + + + +
ReturnsCurrent position in the stream, or SIZE_MAX if the position is unknown.
+
+
+

+ void cubos::core::memory::BufferStream::seek(ptrdiff_t offset, + SeekOrigin origin) override +

+

Seeks to a position in the stream.

+ + + + + + + + + + + + + + +
Parameters
offsetOffset to seek to.
originOrigin of the offset.
+
+
+

+ bool cubos::core::memory::BufferStream::eof() const override +

+

Checks if the stream still has content to read.

+ + + + + + + +
ReturnsWhether the stream has reached the end.
+
+
+

+ char cubos::core::memory::BufferStream::peek() const override +

+

Peeks one byte from the stream.

+ + + + + + + +
ReturnsPeeked byte.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1ReadGuard.html b/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1ReadGuard.html new file mode 100644 index 000000000..424154145 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1ReadGuard.html @@ -0,0 +1,261 @@ + + + + + cubos::core::memory::ReadGuard class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/memory/guards.hpp>
+
template<typename T, typename Lock>
+ cubos::core::memory::ReadGuard class +

+

Provides safe read-only access to an object using a lock.

+ + + + + + + + + + + + + + +
Template parameters
TGuarded object type.
LockHeld lock type.
+ +

This class was created because there are multiple parts of the code that need to provide access to objects in a thread-safe manner.

Usage example

using AssetMetaRead = core::memory::ReadGuard<AssetMeta, std::shared_lock<std::shared_mutex>>;
+
+

Constructors, destructors, conversion operators

+
+
+ ReadGuard(const T& object, + Lock&& lock) +
+
Constructor.
+
+ ReadGuard(ReadGuard&& other) noexcept +
+
Move constructor.
+
+
+
+

Public functions

+
+
+ auto get() const -> const T& +
+
Gets a reference to the underlying object.
+
+ auto operator*() const -> const T& +
+
Gets a reference to the underlying object.
+
+ auto operator->() const -> const T* +
+
Gets a pointer to the underlying object.
+
+
+
+

Function documentation

+
+

+
+ template<typename T, typename Lock> +
+ cubos::core::memory::ReadGuard<T, Lock>::ReadGuard(const T& object, + Lock&& lock) +

+

Constructor.

+ + + + + + + + + + + + + + +
Parameters
objectObject to guard.
lockLock to hold.
+
+
+

+
+ template<typename T, typename Lock> +
+ cubos::core::memory::ReadGuard<T, Lock>::ReadGuard(ReadGuard&& other) noexcept +

+

Move constructor.

+ + + + + + + + + + +
Parameters
otherGuard to move from.
+
+
+

+
+ template<typename T, typename Lock> +
+ const T& cubos::core::memory::ReadGuard<T, Lock>::get() const +

+

Gets a reference to the underlying object.

+ + + + + + + +
ReturnsUnderlying object.
+
+
+

+
+ template<typename T, typename Lock> +
+ const T& cubos::core::memory::ReadGuard<T, Lock>::operator*() const +

+

Gets a reference to the underlying object.

+ + + + + + + +
ReturnsUnderlying object.
+
+
+

+
+ template<typename T, typename Lock> +
+ const T* cubos::core::memory::ReadGuard<T, Lock>::operator->() const +

+

Gets a pointer to the underlying object.

+ + + + + + + +
ReturnsUnderlying object.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1StandardStream.html b/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1StandardStream.html new file mode 100644 index 000000000..76d41e54b --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1StandardStream.html @@ -0,0 +1,331 @@ + + + + + cubos::core::memory::StandardStream class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::memory::StandardStream class +
#include <core/memory/standard_stream.hpp>
+

+

Stream implementation which wraps a libc file pointer.

+ +
+

Base classes

+
+
+ class Stream +
+
Interface class for memory streams. Abstracts away sources or destinations of data.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ StandardStream(FILE* file, + bool close = false) +
+
Constructs.
+
+ StandardStream(StandardStream&& other) noexcept +
+
Move constructs.
+
+
+
+

Public functions

+
+
+ auto read(void* data, + std::size_t size) -> std::size_t override +
+
Reads data from the stream.
+
+ auto write(const void* data, + std::size_t size) -> std::size_t override +
+
Writes data to the stream.
+
+ auto tell() const -> std::size_t override +
+
Gets the current position in the stream.
+
+ void seek(ptrdiff_t offset, + SeekOrigin origin) override +
+
Seeks to a position in the stream.
+
+ auto eof() const -> bool override +
+
Checks if the stream still has content to read.
+
+ auto peek() const -> char override +
+
Peeks one byte from the stream.
+
+
+
+

Function documentation

+
+

+ cubos::core::memory::StandardStream::StandardStream(FILE* file, + bool close = false) +

+

Constructs.

+ + + + + + + + + + + + + + +
Parameters
fileFile to read/write from.
closeShould the file be closed when this stream is destructed?
+
+
+

+ cubos::core::memory::StandardStream::StandardStream(StandardStream&& other) noexcept +

+

Move constructs.

+ + + + + + + + + + +
Parameters
otherMoved stream.
+
+
+

+ std::size_t cubos::core::memory::StandardStream::read(void* data, + std::size_t size) override +

+

Reads data from the stream.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
dataBuffer to read data into.
sizeSize of the buffer.
ReturnsNumber of bytes read.
+
+
+

+ std::size_t cubos::core::memory::StandardStream::write(const void* data, + std::size_t size) override +

+

Writes data to the stream.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
dataBuffer to write data from.
sizeSize of the buffer.
ReturnsNumber of bytes written.
+
+
+

+ std::size_t cubos::core::memory::StandardStream::tell() const override +

+

Gets the current position in the stream.

+ + + + + + + +
ReturnsCurrent position in the stream, or SIZE_MAX if the position is unknown.
+
+
+

+ void cubos::core::memory::StandardStream::seek(ptrdiff_t offset, + SeekOrigin origin) override +

+

Seeks to a position in the stream.

+ + + + + + + + + + + + + + +
Parameters
offsetOffset to seek to.
originOrigin of the offset.
+
+
+

+ bool cubos::core::memory::StandardStream::eof() const override +

+

Checks if the stream still has content to read.

+ + + + + + + +
ReturnsWhether the stream has reached the end.
+
+
+

+ char cubos::core::memory::StandardStream::peek() const override +

+

Peeks one byte from the stream.

+ + + + + + + +
ReturnsPeeked byte.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1Stream.html b/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1Stream.html new file mode 100644 index 000000000..8ffd493d7 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1Stream.html @@ -0,0 +1,1010 @@ + + + + + cubos::core::memory::Stream class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::memory::Stream class +
#include <core/memory/stream.hpp>
+

+

Interface class for memory streams. Abstracts away sources or destinations of data.

+ +

Motivation

Why do we have our own streams? Well, the standard library streams are hard to use and extend, and very template heavy. Using our own streams allows us to abstract away more easily where the data is coming from, or going to, allowing us, for example, to embed files into the executable and not have to worry about the code that reads them.

+
+

Derived classes

+
+
+
template<typename T>
+ class cubos::core::data::FileStream final +
+
Wrapper around an implementation-specific file stream which keeps the file alive and does some sanity checks.
+
+ class BufferStream +
+
Stream implementation which writes to/reads from a buffer.
+
+ class StandardStream +
+
Stream implementation which wraps a libc file pointer.
+
+
+
+

Public static variables

+
+
+ static Stream& stdIn +
+
Stream wrapper for stdin.
+
+ static Stream& stdOut +
+
Stream wrapper for stdout.
+
+ static Stream& stdErr +
+
Stream wrapper for stderr.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ Stream() defaulted +
+
Constructs.
+
+ Stream(Stream&&) defaulted +
+
Move constructs.
+
+ Stream(const Stream&) deleted +
+
Forbid copy construction.
+
+
template<typename T>
+ requires(::std::is_integral_v<T> && ::std::is_signed_v<T>) void print(T value +
+
Prints a signed integer to the stream.
+
+
template<typename T>
+ requires(::std::is_integral_v<T> && !::std::is_signed_v<T>) inline void print(T value +
+
Prints a signed integer to the stream.
+
+
+
+

Public functions

+
+
+ auto read(void* data, + std::size_t size) -> std::size_t pure virtual +
+
Reads data from the stream.
+
+ auto write(const void* data, + std::size_t size) -> std::size_t pure virtual +
+
Writes data to the stream.
+
+ auto tell() const -> std::size_t pure virtual +
+
Gets the current position in the stream.
+
+ void seek(ptrdiff_t offset, + SeekOrigin origin) pure virtual +
+
Seeks to a position in the stream.
+
+ auto eof() const -> bool pure virtual +
+
Checks if the stream still has content to read.
+
+ auto peek() const -> char pure virtual +
+
Peeks one byte from the stream.
+
+ auto get() -> char +
+
Gets one byte from the stream.
+
+ void put(char c) +
+
Puts one byte into the stream.
+
+ void print(int64_t value, + std::size_t base = 10) +
+
Prints a 64 bit signed integer to the stream.
+
+ void print(uint64_t value, + std::size_t base = 10) +
+
Prints a 64 bit unsigned integer to the stream.
+
+ void print(float value, + std::size_t decimalPlaces = 4) +
+
Prints a float to the stream.
+
+ void print(double value, + std::size_t decimalPlaces = 4) +
+
Prints a double to the stream.
+
+ void print(const char* str) +
+
Prints a string to the stream.
+
+ void print(const char* str, + std::size_t size) +
+
Prints a string to the stream.
+
+ void print(const ::std::string& str) +
+
Prints a string to the stream.
+
+
template<typename T, typename... TArgs>
+ void printf(const char* fmt, + T arg, + TArgs... args) +
+
Prints a formatted string the stream.
+
+ void printf(const char* fmt) +
+
Prints a string to the stream.
+
+ void parse(int8_t& value, + std::size_t base = 10) +
+
Parses a 8 bit signed integer from the stream.
+
+ void parse(int16_t& value, + std::size_t base = 10) +
+
Parses a 16 bit signed integer from the stream.
+
+ void parse(int32_t& value, + std::size_t base = 10) +
+
Parses a 32 bit signed integer from the stream.
+
+ void parse(int64_t& value, + std::size_t base = 10) +
+
Parses a 64 bit signed integer from the stream.
+
+ void parse(uint8_t& value, + std::size_t base = 10) +
+
Parses a 8 bit unsigned integer from the stream.
+
+ void parse(uint16_t& value, + std::size_t base = 10) +
+
Parses a 16 bit unsigned integer from the stream.
+
+ void parse(uint32_t& value, + std::size_t base = 10) +
+
Parses a 32 bit unsigned integer from the stream.
+
+ void parse(uint64_t& value, + std::size_t base = 10) +
+
Parses a 64 bit unsigned integer from the stream.
+
+ void parse(float& value) +
+
Parses a float from the stream.
+
+ void parse(double& value) +
+
Parses a double from the stream.
+
+ void readUntil(std::string& str, + const char* terminator) +
+
Reads a string from the stream until the terminator (or \0) is found.
+
+ auto readUntil(char* buffer, + std::size_t size, + const char* terminator) -> std::size_t +
+
Reads a string from the stream until the terminator (or \0) is found.
+
+ void ignore(std::size_t size) +
+
Ignores a number of bytes from the stream.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::core::memory::Stream::requires(::std::is_integral_v<T> && ::std::is_signed_v<T>) void print(T value +

+

Prints a signed integer to the stream.

+ + + + + + + + + + +
Template parameters
TType of the integer.
+
+
+

+
+ template<typename T> +
+ cubos::core::memory::Stream::requires(::std::is_integral_v<T> && !::std::is_signed_v<T>) inline void print(T value +

+

Prints a signed integer to the stream.

+ + + + + + + + + + +
Template parameters
TInteger type.
+
+
+

+ std::size_t cubos::core::memory::Stream::read(void* data, + std::size_t size) pure virtual +

+

Reads data from the stream.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
dataBuffer to read data into.
sizeSize of the buffer.
ReturnsNumber of bytes read.
+
+
+

+ std::size_t cubos::core::memory::Stream::write(const void* data, + std::size_t size) pure virtual +

+

Writes data to the stream.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
dataBuffer to write data from.
sizeSize of the buffer.
ReturnsNumber of bytes written.
+
+
+

+ std::size_t cubos::core::memory::Stream::tell() const pure virtual +

+

Gets the current position in the stream.

+ + + + + + + +
ReturnsCurrent position in the stream, or SIZE_MAX if the position is unknown.
+
+
+

+ void cubos::core::memory::Stream::seek(ptrdiff_t offset, + SeekOrigin origin) pure virtual +

+

Seeks to a position in the stream.

+ + + + + + + + + + + + + + +
Parameters
offsetOffset to seek to.
originOrigin of the offset.
+
+
+

+ bool cubos::core::memory::Stream::eof() const pure virtual +

+

Checks if the stream still has content to read.

+ + + + + + + +
ReturnsWhether the stream has reached the end.
+
+
+

+ char cubos::core::memory::Stream::peek() const pure virtual +

+

Peeks one byte from the stream.

+ + + + + + + +
ReturnsPeeked byte.
+
+
+

+ char cubos::core::memory::Stream::get() +

+

Gets one byte from the stream.

+ + + + + + + +
ReturnsRead byte.
+
+
+

+ void cubos::core::memory::Stream::put(char c) +

+

Puts one byte into the stream.

+ + + + + + + + + + +
Parameters
cByte to put.
+
+
+

+ void cubos::core::memory::Stream::print(int64_t value, + std::size_t base = 10) +

+

Prints a 64 bit signed integer to the stream.

+ + + + + + + + + + + + + + +
Parameters
valueValue to print.
baseBase to use.
+
+
+

+ void cubos::core::memory::Stream::print(uint64_t value, + std::size_t base = 10) +

+

Prints a 64 bit unsigned integer to the stream.

+ + + + + + + + + + + + + + +
Parameters
valueValue to print.
baseBase to use.
+
+
+

+ void cubos::core::memory::Stream::print(float value, + std::size_t decimalPlaces = 4) +

+

Prints a float to the stream.

+ + + + + + + + + + + + + + +
Parameters
valueValue to print.
decimalPlacesNumber of decimal places to print.
+
+
+

+ void cubos::core::memory::Stream::print(double value, + std::size_t decimalPlaces = 4) +

+

Prints a double to the stream.

+ + + + + + + + + + + + + + +
Parameters
valueValue to print.
decimalPlacesNumber of decimal places to print.
+
+
+

+ void cubos::core::memory::Stream::print(const char* str) +

+

Prints a string to the stream.

+ + + + + + + + + + +
Parameters
strString to print.
+
+
+

+ void cubos::core::memory::Stream::print(const char* str, + std::size_t size) +

+

Prints a string to the stream.

+ + + + + + + + + + + + + + +
Parameters
strString to print.
sizeSize of the string.
+
+
+

+ void cubos::core::memory::Stream::print(const ::std::string& str) +

+

Prints a string to the stream.

+ + + + + + + + + + +
Parameters
strValue to print.
+
+
+

+
+ template<typename T, typename... TArgs> +
+ void cubos::core::memory::Stream::printf(const char* fmt, + T arg, + TArgs... args) +

+

Prints a formatted string the stream.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TType of the first argument.
TArgsTypes of the remaining arguments.
Parameters
fmtFormat string.
argFirst argument to print.
argsRemaining arguments to print.
+
Usage
stream.printf("Hello, {}!\n", "world");
+stream.printf("{} + {} = {}\n", 1, 2, 3);
+stream.printf("\\{} {}\n", 1, 2); // This will print "{} 2"
+
+
+

+ void cubos::core::memory::Stream::printf(const char* fmt) +

+

Prints a string to the stream.

+ + + + + + + + + + +
Parameters
fmtFormat string.
+ +
+
+

+ void cubos::core::memory::Stream::parse(int8_t& value, + std::size_t base = 10) +

+

Parses a 8 bit signed integer from the stream.

+ + + + + + + + + + + + + + +
Parameters
value outParsed value.
baseBase to use.
+
+
+

+ void cubos::core::memory::Stream::parse(int16_t& value, + std::size_t base = 10) +

+

Parses a 16 bit signed integer from the stream.

+ + + + + + + + + + + + + + +
Parameters
value outParsed value.
baseBase to use.
+
+
+

+ void cubos::core::memory::Stream::parse(int32_t& value, + std::size_t base = 10) +

+

Parses a 32 bit signed integer from the stream.

+ + + + + + + + + + + + + + +
Parameters
value outParsed value.
baseBase to use.
+
+
+

+ void cubos::core::memory::Stream::parse(int64_t& value, + std::size_t base = 10) +

+

Parses a 64 bit signed integer from the stream.

+ + + + + + + + + + + + + + +
Parameters
value outParsed value.
baseBase to use.
+
+
+

+ void cubos::core::memory::Stream::parse(uint8_t& value, + std::size_t base = 10) +

+

Parses a 8 bit unsigned integer from the stream.

+ + + + + + + + + + + + + + +
Parameters
value outParsed value.
baseBase to use.
+
+
+

+ void cubos::core::memory::Stream::parse(uint16_t& value, + std::size_t base = 10) +

+

Parses a 16 bit unsigned integer from the stream.

+ + + + + + + + + + + + + + +
Parameters
value outParsed value.
baseBase to use.
+
+
+

+ void cubos::core::memory::Stream::parse(uint32_t& value, + std::size_t base = 10) +

+

Parses a 32 bit unsigned integer from the stream.

+ + + + + + + + + + + + + + +
Parameters
value outParsed value.
baseBase to use.
+
+
+

+ void cubos::core::memory::Stream::parse(uint64_t& value, + std::size_t base = 10) +

+

Parses a 64 bit unsigned integer from the stream.

+ + + + + + + + + + + + + + +
Parameters
value outParsed value.
baseBase to use.
+
+
+

+ void cubos::core::memory::Stream::parse(float& value) +

+

Parses a float from the stream.

+ + + + + + + + + + +
Parameters
value outParsed value.
+
+
+

+ void cubos::core::memory::Stream::parse(double& value) +

+

Parses a double from the stream.

+ + + + + + + + + + +
Parameters
value outParsed value.
+
+
+

+ void cubos::core::memory::Stream::readUntil(std::string& str, + const char* terminator) +

+

Reads a string from the stream until the terminator (or \0) is found.

+ + + + + + + + + + + + + + +
Parameters
str outRead string.
terminatorOptional terminator to use.
+
+
+

+ std::size_t cubos::core::memory::Stream::readUntil(char* buffer, + std::size_t size, + const char* terminator) +

+

Reads a string from the stream until the terminator (or \0) is found.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
bufferBuffer to read into.
sizeSize of the buffer.
terminatorOptional terminator to use.
ReturnsNumber of bytes read.
+
+
+

+ void cubos::core::memory::Stream::ignore(std::size_t size) +

+

Ignores a number of bytes from the stream.

+ + + + + + + + + + +
Parameters
sizeNumber of bytes to ignore.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1TypeMap.html b/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1TypeMap.html new file mode 100644 index 000000000..0fe134605 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1TypeMap.html @@ -0,0 +1,452 @@ + + + + + cubos::core::memory::TypeMap class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/memory/type_map.hpp>
+
template<typename V>
+ cubos::core::memory::TypeMap class +

+

A map that stores values of type V, using types as keys.

+ + + + + + + + + + +
Template parameters
VValues type.
+ +
+

Constructors, destructors, conversion operators

+
+
+ TypeMap() defaulted +
+
Constructs an empty map.
+
+ TypeMap(TypeMap&&) defaulted noexcept +
+
Move constructs.
+
+
+
+

Public functions

+
+
+ void set(std::type_index key, + V value) +
+
Sets the value associated to the given type.
+
+ auto at(std::type_index key) -> V* +
+
Gets the value associated to the given type.
+
+ auto at(std::type_index key) const -> const V* +
+
Gets the value associated to the given type.
+
+
template<typename K>
+ void set(V value) +
+
Sets the value associated to the given type.
+
+
template<typename K>
+ auto at() -> V* +
+
Gets the value associated to the given type.
+
+
template<typename K>
+ auto at() const -> const V* +
+
Gets the value associated to the given type.
+
+ void clear() +
+
Removes all values from the map.
+
+ void erase(std::type_index key) +
+
Removes the value with the given key from the map.
+
+
template<typename K>
+ void erase() +
+
Removes the value with the given key from the map.
+
+ auto size() const -> std::size_t +
+
Gets the number of values in the map.
+
+ auto begin() const -> auto +
+
Gets an iterator to the beginning of the map.
+
+ auto end() const -> auto +
+
Gets an iterator to the end of the map.
+
+
+
+

Function documentation

+
+

+
+ template<typename V> +
+ void cubos::core::memory::TypeMap<V>::set(std::type_index key, + V value) +

+

Sets the value associated to the given type.

+ + + + + + + + + + + + + + +
Parameters
keyIndex of the type to use as a key.
valueValue to store.
+
+
+

+
+ template<typename V> +
+ V* cubos::core::memory::TypeMap<V>::at(std::type_index key) +

+

Gets the value associated to the given type.

+ + + + + + + + + + + + + + + + +
Parameters
keyIndex of the type to use as a key.
ReturnsPointer to the value or null if it isn't stored.
+
+
+

+
+ template<typename V> +
+ const V* cubos::core::memory::TypeMap<V>::at(std::type_index key) const +

+

Gets the value associated to the given type.

+ + + + + + + + + + + + + + + + +
Parameters
keyIndex of the type to use as a key.
ReturnsPointer to the value or null if it isn't stored.
+
+
+

+
+ template<typename V> + template<typename K> +
+ void cubos::core::memory::TypeMap<V>::set(V value) +

+

Sets the value associated to the given type.

+ + + + + + + + + + + + + + + + + + + +
Template parameters
KType to use as a key.
Parameters
valueValue to store.
+
+
+

+
+ template<typename V> + template<typename K> +
+ V* cubos::core::memory::TypeMap<V>::at() +

+

Gets the value associated to the given type.

+ + + + + + + + + + + + + + + + +
Template parameters
KType to use as a key.
ReturnsPointer to the value or null if it isn't stored.
+
+
+

+
+ template<typename V> + template<typename K> +
+ const V* cubos::core::memory::TypeMap<V>::at() const +

+

Gets the value associated to the given type.

+ + + + + + + + + + + + + + + + +
Template parameters
KType to use as a key.
ReturnsPointer to the value or null if it isn't stored.
+
+
+

+
+ template<typename V> +
+ void cubos::core::memory::TypeMap<V>::erase(std::type_index key) +

+

Removes the value with the given key from the map.

+ + + + + + + + + + +
Parameters
keyIndex of the type to use as a key.
+
+
+

+
+ template<typename V> + template<typename K> +
+ void cubos::core::memory::TypeMap<V>::erase() +

+

Removes the value with the given key from the map.

+ + + + + + + + + + +
Template parameters
KType to use as a key.
+
+
+

+
+ template<typename V> +
+ std::size_t cubos::core::memory::TypeMap<V>::size() const +

+

Gets the number of values in the map.

+ + + + + + + +
ReturnsNumber of values in the map.
+
+
+

+
+ template<typename V> +
+ auto cubos::core::memory::TypeMap<V>::begin() const +

+

Gets an iterator to the beginning of the map.

+ + + + + + + +
ReturnsIterator to the beginning of the map.
+
+
+

+
+ template<typename V> +
+ auto cubos::core::memory::TypeMap<V>::end() const +

+

Gets an iterator to the end of the map.

+ + + + + + + +
ReturnsIterator to the end of the map.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1WriteGuard.html b/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1WriteGuard.html new file mode 100644 index 000000000..724358a03 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1core_1_1memory_1_1WriteGuard.html @@ -0,0 +1,324 @@ + + + + + cubos::core::memory::WriteGuard class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/memory/guards.hpp>
+
template<typename T, typename Lock>
+ cubos::core::memory::WriteGuard class +

+

Provides safe read-write access to an object using a lock.

+ + + + + + + + + + + + + + +
Template parameters
TGuarded object type.
LockHeld lock type.
+ +

This class was created because there are multiple parts of the code that need to provide access to objects in a thread-safe manner.

Usage example

using AssetMetaWrite = core::memory::WriteGuard<AssetMeta, std::unique_lock<std::shared_mutex>>;
+
+

Constructors, destructors, conversion operators

+
+
+ WriteGuard(T& object, + Lock&& lock) +
+
Constructor.
+
+ WriteGuard(WriteGuard&& other) noexcept +
+
Move constructs.
+
+
+
+

Public functions

+
+
+ auto get() -> T& +
+
Gets a reference to the underlying object.
+
+ auto operator*() -> T& +
+
Gets a reference to the underlying object.
+
+ auto operator->() -> T* +
+
Gets a pointer to the underlying object.
+
+ auto get() const -> const T& +
+
Gets a reference to the underlying object.
+
+ auto operator*() const -> const T& +
+
Gets a reference to the underlying object.
+
+ auto operator->() const -> const T* +
+
Gets a pointer to the underlying object.
+
+
+
+

Function documentation

+
+

+
+ template<typename T, typename Lock> +
+ cubos::core::memory::WriteGuard<T, Lock>::WriteGuard(T& object, + Lock&& lock) +

+

Constructor.

+ + + + + + + + + + + + + + +
Parameters
objectObject to guard.
lockLock to hold.
+
+
+

+
+ template<typename T, typename Lock> +
+ cubos::core::memory::WriteGuard<T, Lock>::WriteGuard(WriteGuard&& other) noexcept +

+

Move constructs.

+ + + + + + + + + + +
Parameters
otherGuard to move from.
+
+
+

+
+ template<typename T, typename Lock> +
+ T& cubos::core::memory::WriteGuard<T, Lock>::get() +

+

Gets a reference to the underlying object.

+ + + + + + + +
ReturnsUnderlying object.
+
+
+

+
+ template<typename T, typename Lock> +
+ T& cubos::core::memory::WriteGuard<T, Lock>::operator*() +

+

Gets a reference to the underlying object.

+ + + + + + + +
ReturnsUnderlying object.
+
+
+

+
+ template<typename T, typename Lock> +
+ T* cubos::core::memory::WriteGuard<T, Lock>::operator->() +

+

Gets a pointer to the underlying object.

+ + + + + + + +
ReturnsUnderlying object.
+
+
+

+
+ template<typename T, typename Lock> +
+ const T& cubos::core::memory::WriteGuard<T, Lock>::get() const +

+

Gets a reference to the underlying object.

+ + + + + + + +
ReturnsUnderlying object.
+
+
+

+
+ template<typename T, typename Lock> +
+ const T& cubos::core::memory::WriteGuard<T, Lock>::operator*() const +

+

Gets a reference to the underlying object.

+ + + + + + + +
ReturnsUnderlying object.
+
+
+

+
+ template<typename T, typename Lock> +
+ const T* cubos::core::memory::WriteGuard<T, Lock>::operator->() const +

+

Gets a pointer to the underlying object.

+ + + + + + + +
ReturnsUnderlying object.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1AnyAsset.html b/pr-preview/pr-494/classcubos_1_1engine_1_1AnyAsset.html new file mode 100644 index 000000000..286da24e4 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1AnyAsset.html @@ -0,0 +1,380 @@ + + + + + cubos::engine::AnyAsset class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::AnyAsset class +
#include <engine/assets/asset.hpp>
+

+

Handle to an asset of any type. May either be weak or strong. Weak handles do not guarantee the asset is loaded, while strong handles do.

+ +

Assets are identified by their UUID. This is a unique 128-bit number which is assigned to each asset when it is imported or created. Default constructed handles are null handles, which are not associated with any asset.

Serialization:

  • can be serialized or deserialized without context, i.e. the UUID is stored directly.
  • when deserialized, the handle is always a weak handle.
+
+

Derived classes

+
+
+
template<typename T>
+ class Asset +
+
Handle to an asset of a specific type.
+
+
template<typename T>
+ class Asset +
+
Handle to an asset of a specific type.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ AnyAsset(std::nullptr_t ptr = nullptr) +
+
Constructs a null handle.
+
+ AnyAsset(uuids::uuid id) +
+
Constructs a weak handle.
+
+ AnyAsset(std::string_view str) +
+
Constructs a weak handle. If the string is not a valid UUID, the handle will be null.
+
+ AnyAsset(const AnyAsset& other) +
+
Constructs a copy of the given handle.
+
+ AnyAsset(AnyAsset&& other) noexcept +
+
Constructs a handle from the given handle.
+
+
template<typename T>
+ operator Asset<T>() const +
+
Converts this handle to a handle of a specific type.
+
+
+
+

Public functions

+
+
+ auto operator=(const AnyAsset& other) -> AnyAsset& +
+
Overwrites this handle with a copy of the given handle.
+
+ auto operator=(AnyAsset&& other) -> AnyAsset& noexcept +
+
Overwrites this handle with the given handle.
+
+ auto getVersion() const -> int +
+
Gets the version of the asset last seen by this handle.
+
+ auto getId() const -> uuids::uuid +
+
Gets the UUID of the asset.
+
+ auto isNull() const -> bool +
+
Checks if the handle is null.
+
+ auto isStrong() const -> bool +
+
Checks if the handle is strong.
+
+ void makeWeak() +
+
Makes this handle a weak handle, decreasing the asset's reference count if it was strong.
+
+
+
+

Function documentation

+
+

+ cubos::engine::AnyAsset::AnyAsset(uuids::uuid id) +

+

Constructs a weak handle.

+ + + + + + + + + + +
Parameters
idUUID of the asset.
+
+
+

+ cubos::engine::AnyAsset::AnyAsset(std::string_view str) +

+

Constructs a weak handle. If the string is not a valid UUID, the handle will be null.

+ + + + + + + + + + +
Parameters
strString representation of the UUID.
+
+
+

+ cubos::engine::AnyAsset::AnyAsset(const AnyAsset& other) +

+

Constructs a copy of the given handle.

+ + + + + + + + + + +
Parameters
otherHandle to copy.
+
+
+

+ cubos::engine::AnyAsset::AnyAsset(AnyAsset&& other) noexcept +

+

Constructs a handle from the given handle.

+ + + + + + + + + + +
Parameters
otherHandle to move.
+
+
+

+
+ template<typename T> +
+ cubos::engine::AnyAsset::operator Asset<T>() const +

+

Converts this handle to a handle of a specific type.

+ + + + + + + + + + + + + + + + +
Template parameters
TType of the asset.
ReturnsHandle to the same asset, but of the specified type.
+
+
+

+ AnyAsset& cubos::engine::AnyAsset::operator=(const AnyAsset& other) +

+

Overwrites this handle with a copy of the given handle.

+ + + + + + + + + + +
Parameters
otherHandle to copy.
+
+
+

+ AnyAsset& cubos::engine::AnyAsset::operator=(AnyAsset&& other) noexcept +

+

Overwrites this handle with the given handle.

+ + + + + + + + + + +
Parameters
otherHandle to move.
+
+
+

+ int cubos::engine::AnyAsset::getVersion() const +

+

Gets the version of the asset last seen by this handle.

+ + + + + + + +
ReturnsAsset version.
+
+
+

+ uuids::uuid cubos::engine::AnyAsset::getId() const +

+

Gets the UUID of the asset.

+ + + + + + + +
ReturnsAsset UUID.
+
+
+

+ bool cubos::engine::AnyAsset::isNull() const +

+

Checks if the handle is null.

+ + + + + + + +
ReturnsWhether the handle is null.
+
+
+

+ bool cubos::engine::AnyAsset::isStrong() const +

+

Checks if the handle is strong.

+ + + + + + + +
ReturnsWhether the handle is strong.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1Asset.html b/pr-preview/pr-494/classcubos_1_1engine_1_1Asset.html new file mode 100644 index 000000000..0b5afdae9 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1Asset.html @@ -0,0 +1,330 @@ + + + + + cubos::engine::Asset class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <engine/assets/asset.hpp>
+
template<typename T>
+ cubos::engine::Asset class +

+

Handle to an asset of a specific type.

+ + + + + + + + + + +
Template parameters
TType of the asset.
+ + +
+

Base classes

+
+
+ class AnyAsset +
+
Handle to an asset of any type. May either be weak or strong. Weak handles do not guarantee the asset is loaded, while strong handles do.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ AnyAsset(std::nullptr_t ptr = nullptr) +
+
Constructs a null handle.
+
+ AnyAsset(uuids::uuid id) +
+
Constructs a weak handle.
+
+ AnyAsset(std::string_view str) +
+
Constructs a weak handle. If the string is not a valid UUID, the handle will be null.
+
+ AnyAsset(const AnyAsset& other) +
+
Constructs a copy of the given handle.
+
+ AnyAsset(AnyAsset&& other) noexcept +
+
Constructs a handle from the given handle.
+
+
+
+

Public functions

+
+
+ auto toAny() const -> AnyAsset +
+
Constructs a generic handle version of this handle.
+
+ auto operator=(const AnyAsset& other) -> Asset<T>& +
+
Overwrites this handle with a copy of the given handle.
+
+ auto operator=(AnyAsset&& other) -> Asset<T>& noexcept +
+
Overwrites this handle with the given handle.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::engine::Asset<T>::AnyAsset(uuids::uuid id) +

+

Constructs a weak handle.

+ + + + + + + + + + +
Parameters
idUUID of the asset.
+
+
+

+
+ template<typename T> +
+ cubos::engine::Asset<T>::AnyAsset(std::string_view str) +

+

Constructs a weak handle. If the string is not a valid UUID, the handle will be null.

+ + + + + + + + + + +
Parameters
strString representation of the UUID.
+
+
+

+
+ template<typename T> +
+ cubos::engine::Asset<T>::AnyAsset(const AnyAsset& other) +

+

Constructs a copy of the given handle.

+ + + + + + + + + + +
Parameters
otherHandle to copy.
+
+
+

+
+ template<typename T> +
+ cubos::engine::Asset<T>::AnyAsset(AnyAsset&& other) noexcept +

+

Constructs a handle from the given handle.

+ + + + + + + + + + +
Parameters
otherHandle to move.
+
+
+

+
+ template<typename T> +
+ AnyAsset cubos::engine::Asset<T>::toAny() const +

+

Constructs a generic handle version of this handle.

+ + + + + + + +
ReturnsGeneric handle to the same asset.
+
+
+

+
+ template<typename T> +
+ Asset<T>& cubos::engine::Asset<T>::operator=(const AnyAsset& other) +

+

Overwrites this handle with a copy of the given handle.

+ + + + + + + + + + + + + + + + +
Parameters
otherHandle to copy.
ReturnsReference to this object, for chaining.
+
+
+

+
+ template<typename T> +
+ Asset<T>& cubos::engine::Asset<T>::operator=(AnyAsset&& other) noexcept +

+

Overwrites this handle with the given handle.

+ + + + + + + + + + + + + + + + +
Parameters
otherHandle to move.
ReturnsReference to this object, for chaining.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1AssetBridge.html b/pr-preview/pr-494/classcubos_1_1engine_1_1AssetBridge.html new file mode 100644 index 000000000..9d02177a1 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1AssetBridge.html @@ -0,0 +1,248 @@ + + + + + cubos::engine::AssetBridge class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::AssetBridge class +
#include <engine/assets/bridge.hpp>
+

+

Bridges are the objects responsible for loading and saving assets from/to disk. They form the bridge between the asset manager and the virtual file system.

+ +

Not all bridges need to implement the save method. You could have an asset type which could be loaded but not saved, for example.

Bridges should take into account that the asset manager calls them from a different thread than the one that created them.

+
+

Derived classes

+
+
+ class FileBridge +
+
Abstract bridge type defined to reduce boilerplate code in bridge implementations which open a single file to load and save assets.
+
+ class SceneBridge +
+
Bridge which loads and saves Scene assets.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ AssetBridge(std::type_index index) explicit +
+
Constructs a bridge.
+
+
+
+

Public functions

+
+
+ auto load(Assets& assets, + const AnyAsset& handle) -> bool pure virtual +
+
Loads an asset.
+
+ auto save(const Assets& assets, + const AnyAsset& handle) -> bool virtual +
+
Saves an asset.
+
+ auto assetType() const -> std::type_index +
+
Gets the type of the assets the bridge loads.
+
+
+
+

Function documentation

+
+

+ cubos::engine::AssetBridge::AssetBridge(std::type_index index) explicit +

+

Constructs a bridge.

+ + + + + + + + + + +
Parameters
indexType of assets loaded by the bridge.
+
+
+

+ bool cubos::engine::AssetBridge::load(Assets& assets, + const AnyAsset& handle) pure virtual +

+

Loads an asset.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to write into.
handleHandle of the asset being loaded.
ReturnsWhether the asset was successfully loaded.
+

The metadata of the given asset should already be present in the asset manager.

+
+
+

+ bool cubos::engine::AssetBridge::save(const Assets& assets, + const AnyAsset& handle) virtual +

+

Saves an asset.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to read from.
handleHandle of the asset being saved.
ReturnsWhether the asset was successfully saved.
+

The asset should be loaded in the asset manager.

+
+
+

+ std::type_index cubos::engine::AssetBridge::assetType() const +

+

Gets the type of the assets the bridge loads.

+ + + + + + + +
ReturnsType of the asset.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1AssetMeta.html b/pr-preview/pr-494/classcubos_1_1engine_1_1AssetMeta.html new file mode 100644 index 000000000..7846057ca --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1AssetMeta.html @@ -0,0 +1,242 @@ + + + + + cubos::engine::AssetMeta class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::AssetMeta class final +
#include <engine/assets/meta.hpp>
+

+

Stores metadata about an asset - the data stored in .meta files. Each asset has a corresponding meta object, which contains load or import parameters.

+ +

Serialization:

  • can be serialized and deserialized without context.
  • when serialized with the type AssetMeta::Exclude in the context, the specified keys are excluded from the serialization.
+
+

Public types

+
+
+ struct Exclude +
+
Used as context to exclude parameters from being serialized.
+
+
+
+

Public functions

+
+
+ auto get(std::string_view key) const -> std::optional<std::string> +
+
Gets the value of a parameter on the asset's metadata.
+
+ void set(std::string_view key, + std::string_view value) +
+
Sets a parameter on the asset's metadata.
+
+ void remove(std::string_view key) +
+
Removes a parameter from the asset's metadata.
+
+ auto params() const -> const std::unordered_map<std::string, std::string>& +
+
Gets the parameters of the asset's metadata.
+
+ auto params() -> std::unordered_map<std::string, std::string>& +
+
Gets the parameters of the asset's metadata.
+
+
+
+

Function documentation

+
+

+ std::optional<std::string> cubos::engine::AssetMeta::get(std::string_view key) const +

+

Gets the value of a parameter on the asset's metadata.

+ + + + + + + + + + + + + + + + +
Parameters
keyKey of the parameter.
ReturnsThe value of the parameter, if the parameter exists.
+
+
+

+ void cubos::engine::AssetMeta::set(std::string_view key, + std::string_view value) +

+

Sets a parameter on the asset's metadata.

+ + + + + + + + + + + + + + +
Parameters
keyKey of the parameter.
valueValue of the parameter.
+
+
+

+ void cubos::engine::AssetMeta::remove(std::string_view key) +

+

Removes a parameter from the asset's metadata.

+ + + + + + + + + + +
Parameters
keyKey of the parameter.
+
+
+

+ const std::unordered_map<std::string, std::string>& cubos::engine::AssetMeta::params() const +

+

Gets the parameters of the asset's metadata.

+ + + + + + + +
ReturnsParameters of the asset.
+
+
+

+ std::unordered_map<std::string, std::string>& cubos::engine::AssetMeta::params() +

+

Gets the parameters of the asset's metadata.

+ + + + + + + +
ReturnsParameters of the asset.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1Assets.html b/pr-preview/pr-494/classcubos_1_1engine_1_1Assets.html new file mode 100644 index 000000000..8b2c5af58 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1Assets.html @@ -0,0 +1,674 @@ + + + + + cubos::engine::Assets class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::Assets class final +
#include <engine/assets/assets.hpp>
+

+

Resource which manages all assets. Responsible for loading and unloading assets, storing them in memory, and providing access to them.

+ +

Assets are all identified through Asset handles.

+
+

Public types

+
+
+ enum class Status { Unknown, + Unloaded, + Loading, + Loaded } +
+
Possible statuses for an asset.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ Assets() +
+
Constructs an empty manager without any bridges or metadata.
+
+ Assets(const Assets&) deleted +
+
Forbid copying.
+
+ Assets(Assets&&) deleted +
+
Forbid moving.
+
+
+
+

Public functions

+
+
+ void registerBridge(const std::string& extension, + std::shared_ptr<AssetBridge> bridge) +
+
Registers a new bridge for the given extension.
+
+ void cleanup() +
+
Cleans up all assets that are not in use. Should be called periodically to free up memory.
+
+ void loadMeta(std::string_view path) +
+
Loads all metadata from the virtual filesystem, in the given path. If the path points to a directory, it will be recursively searched for metadata files.
+
+ auto load(AnyAsset handle) const -> AnyAsset +
+
Loads the asset with the given handle, upgrading the handle to a strong one.
+
+ auto saveMeta(const AnyAsset& handle) const -> bool +
+
Saves changes made to an asset's metadata.
+
+ auto save(const AnyAsset& handle) const -> bool +
+
Saves changes made to the asset with the given handle.
+
+ auto readMeta(const AnyAsset& handle) const -> AssetMetaRead +
+
Gets read-only access to the metadata associated with the given handle.
+
+ auto writeMeta(const AnyAsset& handle) -> AssetMetaWrite +
+
Gets read-write access to the metadata associated with the given handle.
+
+
template<typename T>
+ auto read(Asset<T> handle) const -> AssetRead<T> +
+
Gets read-only access to the asset data associated with the given handle.
+
+
template<typename T>
+ auto write(Asset<T> handle) -> AssetWrite<T> +
+
Gets read-write access to the asset data associated with the given handle.
+
+ auto status(const AnyAsset& handle) const -> Status +
+
Gets the status of the asset with the given handle.
+
+ auto update(AnyAsset& handle) const -> bool +
+
Updates the given handle to the latest version of the asset.
+
+ void invalidate(const AnyAsset& handle) +
+
Unloads the given asset. Can be used to force assets to be reloaded.
+
+
template<typename T>
+ auto create(T data) -> Asset<T> +
+
Creates a new asset with a random UUID with the given data (and empty metadata).
+
+
template<typename T>
+ auto store(AnyAsset handle, + T data) -> AnyAsset +
+
Stores the given asset data in memory, associated with the given handle.
+
+ auto listAll() const -> std::vector<AnyAsset> +
+
Gets all assets that have been registered.
+
+ auto type(const AnyAsset& handle) const -> std::type_index +
+
Gets the type of an asset.
+
+
+
+

Enum documentation

+
+

+ enum class cubos::engine::Assets::Status +

+

Possible statuses for an asset.

+ + + + + + + + + + + + + + + + + + + + +
Enumerators
Unknown +

No metadata is associated with the asset.

+
Unloaded +

The asset is not loaded.

+
Loading +

The asset is being loaded.

+
Loaded +

The asset is loaded.

+
+
+
+
+

Function documentation

+
+

+ void cubos::engine::Assets::registerBridge(const std::string& extension, + std::shared_ptr<AssetBridge> bridge) +

+

Registers a new bridge for the given extension.

+ + + + + + + + + + + + + + +
Parameters
extensionExtension to register the bridge for.
bridgeBridge to register.
+

If more than one extension match a given asset's name, the longest extension is picked.

+
+
+

+ void cubos::engine::Assets::loadMeta(std::string_view path) +

+

Loads all metadata from the virtual filesystem, in the given path. If the path points to a directory, it will be recursively searched for metadata files.

+ + + + + + + + + + +
Parameters
pathPath to load metadata from.
+
+
+

+ AnyAsset cubos::engine::Assets::load(AnyAsset handle) const +

+

Loads the asset with the given handle, upgrading the handle to a strong one.

+ + + + + + + + + + + + + + + + +
Parameters
handleHandle to load the asset for.
ReturnsStrong handle to the asset, or a null handle if an error occurred.
+

This method doesn't block, thus the asset may have not yet been loaded when it returns. If the manager is unable to find the asset or a bridge for loading it, a null handle is returned. If an error occurs while loading the asset, it will only fail in read() or be visible through status().

+
+
+

+ bool cubos::engine::Assets::saveMeta(const AnyAsset& handle) const +

+

Saves changes made to an asset's metadata.

+ + + + + + + + + + + + + + + + +
Parameters
handleHandle identifying the asset to save.
ReturnsWhether the operation was successful.
+

This method blocks until the asset is saved.

+
+
+

+ bool cubos::engine::Assets::save(const AnyAsset& handle) const +

+

Saves changes made to the asset with the given handle.

+ + + + + + + + + + + + + + + + +
Parameters
handleHandle identifying the asset to save.
ReturnsWhether the operation was successful.
+

This method blocks until the asset is saved.

+
+
+

+ AssetMetaRead cubos::engine::Assets::readMeta(const AnyAsset& handle) const +

+

Gets read-only access to the metadata associated with the given handle.

+ + + + + + + + + + + + + + + + +
Parameters
handleHandle of the asset to get the metadata for.
ReturnsReference to the metadata.
+

Aborts if the asset is unknown.

+
+
+

+ AssetMetaWrite cubos::engine::Assets::writeMeta(const AnyAsset& handle) +

+

Gets read-write access to the metadata associated with the given handle.

+ + + + + + + + + + + + + + + + +
Parameters
handleHandle to get the metadata for.
ReturnsReference to the metadata.
+

If the asset is unknown, an empty metadata object is returned.

+
+
+

+
+ template<typename T> +
+ AssetRead<T> cubos::engine::Assets::read(Asset<T> handle) const +

+

Gets read-only access to the asset data associated with the given handle.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TType of the asset data.
Parameters
handleHandle to get the asset data for.
ReturnsReference to the asset data.
+

If the asset is not loaded, this blocks until it is. If the asset cannot be loaded, abort is called.

+
+
+

+
+ template<typename T> +
+ AssetWrite<T> cubos::engine::Assets::write(Asset<T> handle) +

+

Gets read-write access to the asset data associated with the given handle.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TType of the asset data.
Parameters
handleHandle to get the asset data for.
ReturnsReference to the asset data.
+

If the asset is not loaded, this blocks until it is. If the asset cannot be loaded, abort is called. This increases the asset's version.

+
+
+

+ Status cubos::engine::Assets::status(const AnyAsset& handle) const +

+

Gets the status of the asset with the given handle.

+ + + + + + + + + + + + + + + + +
Parameters
handleHandle to check the status for.
ReturnsStatus of the asset.
+
+
+

+ bool cubos::engine::Assets::update(AnyAsset& handle) const +

+

Updates the given handle to the latest version of the asset.

+ + + + + + + + + + + + + + + + +
Parameters
handleHandle to update.
ReturnsWhether the version was updated.
+

Can be used to implement hot-reloading.

+
+
+

+ void cubos::engine::Assets::invalidate(const AnyAsset& handle) +

+

Unloads the given asset. Can be used to force assets to be reloaded.

+ + + + + + + + + + +
Parameters
handleHandle to unload.
+
+
+

+
+ template<typename T> +
+ Asset<T> cubos::engine::Assets::create(T data) +

+

Creates a new asset with a random UUID with the given data (and empty metadata).

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TType of the asset data.
Parameters
dataAsset data to store.
ReturnsStrong handle to the new asset.
+
+
+

+
+ template<typename T> +
+ AnyAsset cubos::engine::Assets::store(AnyAsset handle, + T data) +

+

Stores the given asset data in memory, associated with the given handle.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TType of the asset data.
Parameters
handleHandle to associate the asset with.
dataAsset data to store.
ReturnsStrong handle to the asset.
+

If an asset with the same handle already exists, it will be replaced. If no metadata is associated with the handle, an empty one will be created. This increases the asset's version.

+
+
+

+ std::vector<AnyAsset> cubos::engine::Assets::listAll() const +

+

Gets all assets that have been registered.

+ + + + + + + +
ReturnsVector with all registered assets.
+
+
+

+ std::type_index cubos::engine::Assets::type(const AnyAsset& handle) const +

+

Gets the type of an asset.

+ + + + + + + + + + + + + + + + +
Parameters
handleHandle to check the type for.
ReturnsAsset type.
+

If the asset is not loaded, its type is deduced from its bridge. If there's also no associated bridge, aborts. If the asset does not exist, aborts.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1BaseRenderer.html b/pr-preview/pr-494/classcubos_1_1engine_1_1BaseRenderer.html new file mode 100644 index 000000000..4047cd3a6 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1BaseRenderer.html @@ -0,0 +1,385 @@ + + + + + cubos::engine::BaseRenderer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::BaseRenderer class +
#include <engine/renderer/renderer.hpp>
+

+

Interface which abstracts different rendering methods.

+ +

This abstraction allows us to, for example, switch between a raytracing and a deferred rendering method as we need to, without changing the API. This is useful since not all computers support realtime raytracing.

+
+

Derived classes

+
+
+ class DeferredRenderer +
+
Renderer implementation which uses deferred rendering.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ BaseRenderer(core::gl::RenderDevice& renderDevice, + glm::uvec2 size) +
+
Constructs.
+
+ BaseRenderer(const BaseRenderer&) deleted +
+
Deleted copy constructor.
+
+
+
+

Public functions

+
+
+ auto upload(const core::gl::Grid& grid) -> RendererGrid pure virtual +
+
Uploads a grid to the GPU and returns an handle which can be used to draw it.
+
+ void setPalette(const core::gl::Palette& palette) pure virtual +
+
Sets the current palette of the renderer.
+
+ void resize(glm::uvec2 size) +
+
Resizes the renderer's framebuffers.
+
+ auto size() const -> glm::uvec2 +
+
Gets the current size of the renderer's framebuffers.
+
+ void render(const core::gl::Camera& camera, + const RendererFrame& frame, + bool usePostProcessing = true, + const core::gl::Framebuffer& target = nullptr) +
+
Draws a frame.
+
+ auto pps() -> PostProcessingManager& +
+
Gets a reference to the post processing manager.
+
+
+
+

Protected functions

+
+
+ void onResize(glm::uvec2 size) pure virtual +
+
Called when resize() is called.
+
+ void onRender(const core::gl::Camera& camera, + const RendererFrame& frame, + core::gl::Framebuffer target) pure virtual +
+
Called when render() is called, before applying post processing effects.
+
+
+
+

Protected variables

+
+
+ core::gl::RenderDevice& mRenderDevice +
+
Render device being used.
+
+
+
+

Function documentation

+
+

+ cubos::engine::BaseRenderer::BaseRenderer(core::gl::RenderDevice& renderDevice, + glm::uvec2 size) +

+

Constructs.

+ + + + + + + + + + + + + + +
Parameters
renderDeviceRender device to use.
sizeSize of the window.
+ +
+
+

+ RendererGrid cubos::engine::BaseRenderer::upload(const core::gl::Grid& grid) pure virtual +

+

Uploads a grid to the GPU and returns an handle which can be used to draw it.

+ + + + + + + + + + + + + + + + +
Parameters
gridGrid to upload.
ReturnsHandle of the grid.
+
+
+

+ void cubos::engine::BaseRenderer::setPalette(const core::gl::Palette& palette) pure virtual +

+

Sets the current palette of the renderer.

+ + + + + + + + + + +
Parameters
palettePalette to set.
+
+
+

+ void cubos::engine::BaseRenderer::resize(glm::uvec2 size) +

+

Resizes the renderer's framebuffers.

+ + + + + + + + + + +
Parameters
sizeNew size of the window.
+
+
+

+ glm::uvec2 cubos::engine::BaseRenderer::size() const +

+

Gets the current size of the renderer's framebuffers.

+ + + + + + + +
ReturnsCurrent size.
+
+
+

+ void cubos::engine::BaseRenderer::render(const core::gl::Camera& camera, + const RendererFrame& frame, + bool usePostProcessing = true, + const core::gl::Framebuffer& target = nullptr) +

+

Draws a frame.

+ + + + + + + + + + + + + + + + + + + + + + +
Parameters
cameraCamera to use.
frameFrame to draw.
usePostProcessingWhether to use post processing.
targetTarget framebuffer to draw to.
+
+
+

+ PostProcessingManager& cubos::engine::BaseRenderer::pps() +

+

Gets a reference to the post processing manager.

+ + + + + + + +
ReturnsPost processing manager.
+
+
+

+ void cubos::engine::BaseRenderer::onResize(glm::uvec2 size) pure virtual protected +

+

Called when resize() is called.

+ + + + + + + + + + +
Parameters
sizeNew size of the framebuffer.
+

Renderer implementations should override this function to resize their framebuffers.

+
+
+

+ void cubos::engine::BaseRenderer::onRender(const core::gl::Camera& camera, + const RendererFrame& frame, + core::gl::Framebuffer target) pure virtual protected +

+

Called when render() is called, before applying post processing effects.

+ + + + + + + + + + + + + + + + + + +
Parameters
cameraCamera to use.
frameFrame to draw.
targetTarget framebuffer.
+

Renderer implementations should implement this function to draw the frame. When post processing is enabled, the target framebuffer will be the internal texture which will be used for post processing.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1BinaryBridge.html b/pr-preview/pr-494/classcubos_1_1engine_1_1BinaryBridge.html new file mode 100644 index 000000000..198daa0b5 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1BinaryBridge.html @@ -0,0 +1,257 @@ + + + + + cubos::engine::BinaryBridge class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <engine/assets/bridges/binary.hpp>
+
template<typename T>
+ cubos::engine::BinaryBridge class +

+

Bridge for loading and saving assets which are serialized to and from a binary file.

+ + + + + + + + + + +
Template parameters
TType of asset to load and save. Must be default constructible.
+ +

This bridge automatically serializes and deserializes assets of type T to from a binary file. Thus, T must be serializable and deserializable. No additional context is given to the serializer or deserializer.

+
+

Base classes

+
+
+ class FileBridge +
+
Abstract bridge type defined to reduce boilerplate code in bridge implementations which open a single file to load and save assets.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ BinaryBridge(bool littleEndian = true) +
+
Constructs a bridge.
+
+
+
+

Protected functions

+
+
+ auto loadFromFile(Assets& assets, + const AnyAsset& handle, + core::memory::Stream& stream) -> bool override +
+
Loads an asset from a file stream.
+
+ auto saveToFile(const Assets& assets, + const AnyAsset& handle, + core::memory::Stream& stream) -> bool override +
+
Saves an asset to a file stream.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::engine::BinaryBridge<T>::BinaryBridge(bool littleEndian = true) +

+

Constructs a bridge.

+ + + + + + + + + + +
Parameters
littleEndianWhether to use little endian byte order.
+
+
+

+
+ template<typename T> +
+ bool cubos::engine::BinaryBridge<T>::loadFromFile(Assets& assets, + const AnyAsset& handle, + core::memory::Stream& stream) override protected +

+

Loads an asset from a file stream.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to write into.
handleHandle of the asset being loaded.
streamFile stream.
ReturnsWhether the asset was successfully loaded.
+
+
+

+
+ template<typename T> +
+ bool cubos::engine::BinaryBridge<T>::saveToFile(const Assets& assets, + const AnyAsset& handle, + core::memory::Stream& stream) override protected +

+

Saves an asset to a file stream.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to read from.
handleHandle of the asset being saved.
streamFile stream.
ReturnsWhether the asset was successfully saved.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1Cubos.html b/pr-preview/pr-494/classcubos_1_1engine_1_1Cubos.html new file mode 100644 index 000000000..a88a8dd74 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1Cubos.html @@ -0,0 +1,435 @@ + + + + + cubos::engine::Cubos class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::Cubos class final +
#include <engine/cubos.hpp>
+

+

Represents the engine itself, and exposes the interface with which the game developer interacts with. Ties up all the different parts of the engine together.

+ +
+

Constructors, destructors, conversion operators

+
+
+ Cubos() +
+
Constructs an empty application without arguments.
+
+ Cubos(int argc, + char** argv) +
+
Constructs an empty application with arguments.
+
+
+
+

Public functions

+
+
+ auto addPlugin(void(*)(Cubos&) func) -> Cubos& +
+
Adds a new plugin to the engine. If the plugin had already been added, nothing happens. A plugin is just a function that operates on the Cubos object, further configuring it. It is useful for separating the code into modules.
+
+
template<typename R, typename... TArgs>
+ auto addResource(TArgs... args) -> Cubos& +
+
Adds a new resource to the engine.
+
+
template<typename C>
+ auto addComponent() -> Cubos& +
+
Adds a new component type to the engine.
+
+
template<typename E>
+ auto addEvent() -> Cubos& +
+
Adds a new event type to the engine.
+
+ auto tag(const std::string& tag) -> TagBuilder +
+
Returns a TagBuilder to configure the given tag.
+
+ auto startupTag(const std::string& tag) -> TagBuilder +
+
Returns a TagBuilder to configure the given startup tag.
+
+
template<typename F>
+ auto system(F func) -> SystemBuilder +
+
Adds a new system to the engine, which will be executed at every iteration of the main loop.
+
+
template<typename F>
+ auto startupSystem(F func) -> SystemBuilder +
+
Adds a new startup system to the engine, which will be executed only once, before the main loop starts.
+
+ void run() +
+
Runs the engine.
+
+
+
+

Function documentation

+
+

+ cubos::engine::Cubos::Cubos(int argc, + char** argv) +

+

Constructs an empty application with arguments.

+ + + + + + + + + + + + + + +
Parameters
argcArgument count.
argvArgument array.
+
+
+

+ Cubos& cubos::engine::Cubos::addPlugin(void(*)(Cubos&) func) +

+

Adds a new plugin to the engine. If the plugin had already been added, nothing happens. A plugin is just a function that operates on the Cubos object, further configuring it. It is useful for separating the code into modules.

+ + + + + + + + + + + + + + + + +
Parameters
funcEntry point of the plugin to add.
ReturnsReference to this object, for chaining.
+
+
+

+
+ template<typename R, typename... TArgs> +
+ Cubos& cubos::engine::Cubos::addResource(TArgs... args) +

+

Adds a new resource to the engine.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
RType of the resource.
TArgsTypes of the arguments passed to the resource's constructor.
Parameters
argsArguments passed to the resource's constructor.
ReturnsReference to this object, for chaining.
+
+
+

+
+ template<typename C> +
+ Cubos& cubos::engine::Cubos::addComponent() +

+

Adds a new component type to the engine.

+ + + + + + + + + + + + + + + + +
Template parameters
CType of the component.
ReturnsReference to this object, for chaining.
+
+
+

+
+ template<typename E> +
+ Cubos& cubos::engine::Cubos::addEvent() +

+

Adds a new event type to the engine.

+ + + + + + + + + + + + + + + + +
Template parameters
EType of the event.
ReturnsReference to this object, for chaining.
+
+
+

+ TagBuilder cubos::engine::Cubos::tag(const std::string& tag) +

+

Returns a TagBuilder to configure the given tag.

+ + + + + + + + + + + + + + + + +
Parameters
tagTag to configure.
ReturnsTagBuilder used to configure the tag.
+
+
+

+ TagBuilder cubos::engine::Cubos::startupTag(const std::string& tag) +

+

Returns a TagBuilder to configure the given startup tag.

+ + + + + + + + + + + + + + + + +
Parameters
tagTag to configure.
ReturnsTagBuilder used to configure the tag.
+
+
+

+
+ template<typename F> +
+ SystemBuilder cubos::engine::Cubos::system(F func) +

+

Adds a new system to the engine, which will be executed at every iteration of the main loop.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
FType of the system function.
Parameters
funcSystem function.
ReturnsSystemBuilder used to configure the system.
+
+
+

+
+ template<typename F> +
+ SystemBuilder cubos::engine::Cubos::startupSystem(F func) +

+

Adds a new startup system to the engine, which will be executed only once, before the main loop starts.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
FType of the system function.
Parameters
funcSystem function.
ReturnsSystemBuilder used to configure the system.
+
+
+

+ void cubos::engine::Cubos::run() +

+

Runs the engine.

+

Initially, dispatches all of the startup systems. Then, while ShouldQuit is false, dispatches all other systems.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1DeferredRenderer.html b/pr-preview/pr-494/classcubos_1_1engine_1_1DeferredRenderer.html new file mode 100644 index 000000000..262b829bc --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1DeferredRenderer.html @@ -0,0 +1,280 @@ + + + + + cubos::engine::DeferredRenderer class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::DeferredRenderer class +
#include <engine/renderer/deferred_renderer.hpp>
+

+

Renderer implementation which uses deferred rendering.

+ +

Voxel grids are first triangulated, and then the triangles are uploaded to the GPU. The rendering is done in two passes:

  1. Render the scene to the GBuffer textures: position, normal and material.
  2. Take the GBuffer textures and calculate the color of the pixels with the lighting applied.
+
+

Base classes

+
+
+ class BaseRenderer +
+
Interface which abstracts different rendering methods.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ DeferredRenderer(core::gl::RenderDevice& renderDevice, + glm::uvec2 size, + const core::Settings& settings) +
+
Constructs.
+
+
+
+

Public functions

+
+
+ auto upload(const core::gl::Grid& grid) -> RendererGrid override +
+
Uploads a grid to the GPU and returns an handle which can be used to draw it.
+
+ void setPalette(const core::gl::Palette& palette) override +
+
Sets the current palette of the renderer.
+
+
+
+

Protected functions

+
+
+ void onResize(glm::uvec2 size) override +
+
Called when resize() is called.
+
+ void onRender(const core::gl::Camera& camera, + const RendererFrame& frame, + core::gl::Framebuffer target) override +
+
Called when render() is called, before applying post processing effects.
+
+
+
+

Function documentation

+
+

+ cubos::engine::DeferredRenderer::DeferredRenderer(core::gl::RenderDevice& renderDevice, + glm::uvec2 size, + const core::Settings& settings) +

+

Constructs.

+ + + + + + + + + + + + + + + + + + +
Parameters
renderDeviceRender device to use.
sizeSize of the window.
settingsSettings to use.
+
+
+

+ RendererGrid cubos::engine::DeferredRenderer::upload(const core::gl::Grid& grid) override +

+

Uploads a grid to the GPU and returns an handle which can be used to draw it.

+ + + + + + + + + + + + + + + + +
Parameters
gridGrid to upload.
ReturnsHandle of the grid.
+
+
+

+ void cubos::engine::DeferredRenderer::setPalette(const core::gl::Palette& palette) override +

+

Sets the current palette of the renderer.

+ + + + + + + + + + +
Parameters
palettePalette to set.
+
+
+

+ void cubos::engine::DeferredRenderer::onResize(glm::uvec2 size) override protected +

+

Called when resize() is called.

+ + + + + + + + + + +
Parameters
sizeNew size of the framebuffer.
+

Renderer implementations should override this function to resize their framebuffers.

+
+
+

+ void cubos::engine::DeferredRenderer::onRender(const core::gl::Camera& camera, + const RendererFrame& frame, + core::gl::Framebuffer target) override protected +

+

Called when render() is called, before applying post processing effects.

+ + + + + + + + + + + + + + + + + + +
Parameters
cameraCamera to use.
frameFrame to draw.
targetTarget framebuffer.
+

Renderer implementations should implement this function to draw the frame. When post processing is enabled, the target framebuffer will be the internal texture which will be used for post processing.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1FileBridge.html b/pr-preview/pr-494/classcubos_1_1engine_1_1FileBridge.html new file mode 100644 index 000000000..cec05d8cd --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1FileBridge.html @@ -0,0 +1,330 @@ + + + + + cubos::engine::FileBridge class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::FileBridge class +
#include <engine/assets/bridges/file.hpp>
+

+

Abstract bridge type defined to reduce boilerplate code in bridge implementations which open a single file to load and save assets.

+ +

This bridge should be used as a base class for bridges which load and save assets. Child classes must implement the loadFromFile() and saveToFile() methods, which are called with a file stream to load and save the asset from and to, respectively.

+
+

Base classes

+
+
+ class AssetBridge +
+
Bridges are the objects responsible for loading and saving assets from/to disk. They form the bridge between the asset manager and the virtual file system.
+
+
+
+

Derived classes

+
+
+ class TextBridge +
+
+
+
template<typename T>
+ class BinaryBridge +
+
Bridge for loading and saving assets which are serialized to and from a binary file.
+
+
template<typename T>
+ class JSONBridge +
+
Bridge for loading and saving assets which are serialized to and from a JSON file.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ FileBridge(std::type_index index) explicit +
+
Constructs a bridge.
+
+
+
+

Public functions

+
+
+ auto load(Assets& assets, + const AnyAsset& handle) -> bool final +
+
Loads an asset.
+
+ auto save(const Assets& assets, + const AnyAsset& handle) -> bool final +
+
Saves an asset.
+
+
+
+

Protected functions

+
+
+ auto loadFromFile(Assets& assets, + const AnyAsset& handle, + core::memory::Stream& stream) -> bool pure virtual +
+
Loads an asset from a file stream.
+
+ auto saveToFile(const Assets& assets, + const AnyAsset& handle, + core::memory::Stream& stream) -> bool pure virtual +
+
Saves an asset to a file stream.
+
+
+
+

Function documentation

+
+

+ cubos::engine::FileBridge::FileBridge(std::type_index index) explicit +

+

Constructs a bridge.

+ + + + + + + + + + +
Parameters
indexType of assets loaded by the bridge.
+
+
+

+ bool cubos::engine::FileBridge::load(Assets& assets, + const AnyAsset& handle) final +

+

Loads an asset.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to write into.
handleHandle of the asset being loaded.
ReturnsWhether the asset was successfully loaded.
+

The metadata of the given asset should already be present in the asset manager.

+
+
+

+ bool cubos::engine::FileBridge::save(const Assets& assets, + const AnyAsset& handle) final +

+

Saves an asset.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to read from.
handleHandle of the asset being saved.
ReturnsWhether the asset was successfully saved.
+

The asset should be loaded in the asset manager.

+
+
+

+ bool cubos::engine::FileBridge::loadFromFile(Assets& assets, + const AnyAsset& handle, + core::memory::Stream& stream) pure virtual protected +

+

Loads an asset from a file stream.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to write into.
handleHandle of the asset being loaded.
streamFile stream.
ReturnsWhether the asset was successfully loaded.
+
+
+

+ bool cubos::engine::FileBridge::saveToFile(const Assets& assets, + const AnyAsset& handle, + core::memory::Stream& stream) pure virtual protected +

+

Saves an asset to a file stream.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to read from.
handleHandle of the asset being saved.
streamFile stream.
ReturnsWhether the asset was successfully saved.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1Input.html b/pr-preview/pr-494/classcubos_1_1engine_1_1Input.html new file mode 100644 index 000000000..84443e5bd --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1Input.html @@ -0,0 +1,326 @@ + + + + + cubos::engine::Input class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::Input class final +
#include <engine/input/input.hpp>
+

+

Resource which stores the input bindings for multiple players.

+ +

Its state is updated accordingly as events are received by the Input.

+
+

Public types

+
+
+ using Key = core::io::Key +
+
Alias for core::io::Key.
+
+ using Modifiers = core::io::Modifiers +
+
Alias for core::io::Modifiers.
+
+
+
+

Public functions

+
+
+ void clear() +
+
Clears all bindings.
+
+ void clear(int player) +
+
Clears all bindings for a specific player.
+
+ void bind(const InputBindings& bindings, + int player = 0) +
+
Sets the bindings for a specific player.
+
+ auto pressed(const char* actionName, + int player = 0) const -> bool +
+
Gets an action state for a specific player.
+
+ auto axis(const char* axisName, + int player = 0) const -> float +
+
Gets an axis value for a specific player.
+
+ void handle(const core::io::Window& window, + const core::io::KeyEvent& event) +
+
Handle a key event.
+
+ void handle(const core::io::Window& window, + const core::io::WindowEvent& event) +
+
Handle all other events - discards them.
+
+ auto bindings() const -> const std::unordered_map<int, InputBindings>& +
+
Gets the bindings for each player.
+
+
+
+

Function documentation

+
+

+ void cubos::engine::Input::clear(int player) +

+

Clears all bindings for a specific player.

+ + + + + + + + + + +
Parameters
playerPlayer whose bindings will be cleared.
+
+
+

+ void cubos::engine::Input::bind(const InputBindings& bindings, + int player = 0) +

+

Sets the bindings for a specific player.

+ + + + + + + + + + + + + + +
Parameters
bindingsBindings to set.
playerPlayer whose bindings will be set.
+
+
+

+ bool cubos::engine::Input::pressed(const char* actionName, + int player = 0) const +

+

Gets an action state for a specific player.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
actionNameName of the action.
playerPlayer whose action state will be retrieved.
ReturnsWhether the action exists and is pressed.
+
+
+

+ float cubos::engine::Input::axis(const char* axisName, + int player = 0) const +

+

Gets an axis value for a specific player.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
axisNameName of the axis.
playerPlayer whose axis value will be retrieved.
ReturnsAxis value if the axis exists, 0.0 otherwise.
+
+
+

+ void cubos::engine::Input::handle(const core::io::Window& window, + const core::io::KeyEvent& event) +

+

Handle a key event.

+ + + + + + + + + + + + + + +
Parameters
windowWindow that received the event.
eventKey event.
+
+
+

+ void cubos::engine::Input::handle(const core::io::Window& window, + const core::io::WindowEvent& event) +

+

Handle all other events - discards them.

+ + + + + + + + + + + + + + +
Parameters
windowWindow that received the event.
eventEvent to discard.
+

This is method exists so that std::visit can be used with core::io::WindowEvent on handle().

+
+
+

+ const std::unordered_map<int, InputBindings>& cubos::engine::Input::bindings() const +

+

Gets the bindings for each player.

+ + + + + + + +
ReturnsBindings for each player.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1InputAction.html b/pr-preview/pr-494/classcubos_1_1engine_1_1InputAction.html new file mode 100644 index 000000000..e1b8c2ba8 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1InputAction.html @@ -0,0 +1,227 @@ + + + + + cubos::engine::InputAction class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::InputAction class final +
#include <engine/input/action.hpp>
+

+

Stores the state of a single input action, such as "jump" or "attack".

+ +

Can be bound to multiple keys, and will be considered "pressed" if any of them are pressed.

+
+

Constructors, destructors, conversion operators

+
+
+ InputAction() defaulted +
+
Constructs without any bindings.
+
+ InputAction(std::vector<std::pair<core::io::Key, core::io::Modifiers>> keys) +
+
Constructs with existing bindings.
+
+
+
+

Public functions

+
+
+ auto keys() const -> const std::vector<std::pair<core::io::Key, core::io::Modifiers>>& +
+
Gets the key bindings.
+
+ auto keys() -> std::vector<std::pair<core::io::Key, core::io::Modifiers>>& +
+
Gets the key bindings.
+
+ auto pressed() const -> bool +
+
Checks if this action is pressed.
+
+ void pressed(bool pressed) +
+
Sets whether this action is pressed.
+
+
+
+

Function documentation

+
+

+ cubos::engine::InputAction::InputAction(std::vector<std::pair<core::io::Key, core::io::Modifiers>> keys) +

+

Constructs with existing bindings.

+ + + + + + + + + + +
Parameters
keysKey bindings.
+
+
+

+ const std::vector<std::pair<core::io::Key, core::io::Modifiers>>& cubos::engine::InputAction::keys() const +

+

Gets the key bindings.

+ + + + + + + +
ReturnsVector of keys.
+
+
+

+ std::vector<std::pair<core::io::Key, core::io::Modifiers>>& cubos::engine::InputAction::keys() +

+

Gets the key bindings.

+ + + + + + + +
ReturnsVector of keys.
+
+
+

+ bool cubos::engine::InputAction::pressed() const +

+

Checks if this action is pressed.

+ + + + + + + +
ReturnsWhether this action is pressed.
+
+
+

+ void cubos::engine::InputAction::pressed(bool pressed) +

+

Sets whether this action is pressed.

+ + + + + + + + + + +
Parameters
pressedNew pressed state.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1InputAxis.html b/pr-preview/pr-494/classcubos_1_1engine_1_1InputAxis.html new file mode 100644 index 000000000..00560deec --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1InputAxis.html @@ -0,0 +1,269 @@ + + + + + cubos::engine::InputAxis class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::InputAxis class final +
#include <engine/input/axis.hpp>
+

+

Stores the state of a single input axis, such as "move forward" or "move right".

+ +

Can be bound to multiple keys, and will have a value in the range [-1, 1] based on the the state of its bindings.

+
+

Constructors, destructors, conversion operators

+
+
+ InputAxis() defaulted +
+
Constructs without any bindings.
+
+ InputAxis(std::vector<std::pair<core::io::Key, core::io::Modifiers>> positive, + std::vector<std::pair<core::io::Key, core::io::Modifiers>> negative) +
+
Constructs with existing bindings.
+
+
+
+

Public functions

+
+
+ auto positive() const -> const std::vector<std::pair<core::io::Key, core::io::Modifiers>>& +
+
Gets the positive key bindings.
+
+ auto negative() const -> const std::vector<std::pair<core::io::Key, core::io::Modifiers>>& +
+
Gets the negative key bindings.
+
+ auto positive() -> std::vector<std::pair<core::io::Key, core::io::Modifiers>>& +
+
Gets the positive key bindings.
+
+ auto negative() -> std::vector<std::pair<core::io::Key, core::io::Modifiers>>& +
+
Gets the negative key bindings.
+
+ auto value() const -> float +
+
Gets the value.
+
+ void value(float value) +
+
Sets the value.
+
+
+
+

Function documentation

+
+

+ cubos::engine::InputAxis::InputAxis(std::vector<std::pair<core::io::Key, core::io::Modifiers>> positive, + std::vector<std::pair<core::io::Key, core::io::Modifiers>> negative) +

+

Constructs with existing bindings.

+ + + + + + + + + + + + + + +
Parameters
positivePositive key bindings.
negativeNegative key bindings.
+
+
+

+ const std::vector<std::pair<core::io::Key, core::io::Modifiers>>& cubos::engine::InputAxis::positive() const +

+

Gets the positive key bindings.

+ + + + + + + +
ReturnsVector of positive keys.
+
+
+

+ const std::vector<std::pair<core::io::Key, core::io::Modifiers>>& cubos::engine::InputAxis::negative() const +

+

Gets the negative key bindings.

+ + + + + + + +
ReturnsVector of negative keys.
+
+
+

+ std::vector<std::pair<core::io::Key, core::io::Modifiers>>& cubos::engine::InputAxis::positive() +

+

Gets the positive key bindings.

+ + + + + + + +
ReturnsVector of positive keys.
+
+
+

+ std::vector<std::pair<core::io::Key, core::io::Modifiers>>& cubos::engine::InputAxis::negative() +

+

Gets the negative key bindings.

+ + + + + + + +
ReturnsVector of negative keys.
+
+
+

+ float cubos::engine::InputAxis::value() const +

+

Gets the value.

+ + + + + + + +
ReturnsValue.
+
+
+

+ void cubos::engine::InputAxis::value(float value) +

+

Sets the value.

+ + + + + + + + + + +
Parameters
valueNew value.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1InputBindings.html b/pr-preview/pr-494/classcubos_1_1engine_1_1InputBindings.html new file mode 100644 index 000000000..5a861a815 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1InputBindings.html @@ -0,0 +1,193 @@ + + + + + cubos::engine::InputBindings class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::InputBindings class final +
#include <engine/input/bindings.hpp>
+

+

Stores the input bindings for a single player.

+ +

It contains a map of input actions and a map of input axes.

+
+

Public functions

+
+
+ auto actions() const -> const std::unordered_map<std::string, InputAction>& +
+
Gets the input actions map.
+
+ auto axes() const -> const std::unordered_map<std::string, InputAxis>& +
+
Gets the input axes map.
+
+ auto actions() -> std::unordered_map<std::string, InputAction>& +
+
Gets the input actions map.
+
+ auto axes() -> std::unordered_map<std::string, InputAxis>& +
+
Gets the input axes map.
+
+
+
+

Function documentation

+
+

+ const std::unordered_map<std::string, InputAction>& cubos::engine::InputBindings::actions() const +

+

Gets the input actions map.

+ + + + + + + +
ReturnsInput actions map.
+
+
+

+ const std::unordered_map<std::string, InputAxis>& cubos::engine::InputBindings::axes() const +

+

Gets the input axes map.

+ + + + + + + +
ReturnsInput axes map.
+
+
+

+ std::unordered_map<std::string, InputAction>& cubos::engine::InputBindings::actions() +

+

Gets the input actions map.

+ + + + + + + +
ReturnsInput actions map.
+
+
+

+ std::unordered_map<std::string, InputAxis>& cubos::engine::InputBindings::axes() +

+

Gets the input axes map.

+ + + + + + + +
ReturnsInput axes map.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1JSONBridge.html b/pr-preview/pr-494/classcubos_1_1engine_1_1JSONBridge.html new file mode 100644 index 000000000..9b98e3c94 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1JSONBridge.html @@ -0,0 +1,258 @@ + + + + + cubos::engine::JSONBridge class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <engine/assets/bridges/json.hpp>
+
template<typename T>
+ cubos::engine::JSONBridge class +

+

Bridge for loading and saving assets which are serialized to and from a JSON file.

+ + + + + + + + + + +
Template parameters
TType of asset to load and save. Must be default constructible.
+ +

This bridge automatically serializes and deserializes assets of type T to and from a JSON file. Thus, T must be serializable and deserializable. No additional context is given to the serializer or deserializer.

+
+

Base classes

+
+
+ class FileBridge +
+
Abstract bridge type defined to reduce boilerplate code in bridge implementations which open a single file to load and save assets.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ JSONBridge(int indentation = 4) +
+
Constructs a bridge.
+
+
+
+

Protected functions

+
+
+ auto loadFromFile(Assets& assets, + const AnyAsset& handle, + core::memory::Stream& stream) -> bool override +
+
Loads an asset from a file stream.
+
+ auto saveToFile(const Assets& assets, + const AnyAsset& handle, + core::memory::Stream& stream) -> bool override +
+
Saves an asset to a file stream.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::engine::JSONBridge<T>::JSONBridge(int indentation = 4) +

+

Constructs a bridge.

+ + + + + + + + + + +
Parameters
indentationIndentation level to use when saving the JSON file.
+

If the indentation level is set to -1, all whitespace is removed.

+
+
+

+
+ template<typename T> +
+ bool cubos::engine::JSONBridge<T>::loadFromFile(Assets& assets, + const AnyAsset& handle, + core::memory::Stream& stream) override protected +

+

Loads an asset from a file stream.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to write into.
handleHandle of the asset being loaded.
streamFile stream.
ReturnsWhether the asset was successfully loaded.
+
+
+

+
+ template<typename T> +
+ bool cubos::engine::JSONBridge<T>::saveToFile(const Assets& assets, + const AnyAsset& handle, + core::memory::Stream& stream) override protected +

+

Saves an asset to a file stream.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to read from.
handleHandle of the asset being saved.
streamFile stream.
ReturnsWhether the asset was successfully saved.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1PostProcessingBloom.html b/pr-preview/pr-494/classcubos_1_1engine_1_1PostProcessingBloom.html new file mode 100644 index 000000000..6e675a76f --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1PostProcessingBloom.html @@ -0,0 +1,391 @@ + + + + + cubos::engine::PostProcessingBloom class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::PostProcessingBloom class +
#include <engine/renderer/pps/bloom.hpp>
+

+

A post processing pass that adds a "bloom" effect to any bright objects in the scene.

+ +

Implementation based on the following tutorial.

+
+

Base classes

+
+
+ class PostProcessingPass +
+
A generic post processing pass.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ PostProcessingBloom(core::gl::RenderDevice& renderDevice, + glm::uvec2 size) +
+
Constructs with default arguments.
+
+ PostProcessingBloom(core::gl::RenderDevice& renderDevice, + glm::uvec2 size, + unsigned int iterations, + float threshold, + float softThreshold, + float intensity) +
+
Constructs with custom settings.
+
+
+
+

Public functions

+
+
+ auto getThreshold() const -> float +
+
Gets the threshold for the bloom effect.
+
+ auto getSoftThreshold() const -> float +
+
Gets the soft threshold ratio.
+
+ auto getIntensity() const -> float +
+
Gets the intensity of the bloom effect.
+
+ void setThreshold(float threshold) +
+
Sets the threshold for the bloom effect.
+
+ void setSoftThreshold(float softThreshold) +
+
Sets the soft threshold ratio.
+
+ void setIntensity(float intensity) +
+
Sets the intensity of the bloom effect.
+
+ void generateTextures() +
+
Generates the textures used by the pass.
+
+ void resize(glm::uvec2 size) override +
+
Called when the window framebuffer size changes.
+
+ void execute(std::map<PostProcessingInput, core::gl::Texture2D>& inputs, + core::gl::Texture2D prev, + core::gl::Framebuffer out) const override +
+
Called each frame.
+
+
+
+

Function documentation

+
+

+ cubos::engine::PostProcessingBloom::PostProcessingBloom(core::gl::RenderDevice& renderDevice, + glm::uvec2 size) +

+

Constructs with default arguments.

+ + + + + + + + + + + + + + +
Parameters
renderDeviceRender device to use.
sizeSize of the window.
+
+
+

+ cubos::engine::PostProcessingBloom::PostProcessingBloom(core::gl::RenderDevice& renderDevice, + glm::uvec2 size, + unsigned int iterations, + float threshold, + float softThreshold, + float intensity) +

+

Constructs with custom settings.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
renderDeviceRender device to use.
sizeSize of the window.
iterationsNumber of iterations for downsample/upsample step
thresholdPixel brightness threshold to be considered for bloom effect
softThresholdRatio for including pixels that don't pass the threshold test
intensityIntensity of the bloom effect.
+
+
+

+ float cubos::engine::PostProcessingBloom::getThreshold() const +

+

Gets the threshold for the bloom effect.

+ + + + + + + +
ReturnsThreshold for the bloom effect.
+
+
+

+ float cubos::engine::PostProcessingBloom::getSoftThreshold() const +

+

Gets the soft threshold ratio.

+ + + + + + + +
ReturnsSoft threshold ratio.
+
+
+

+ float cubos::engine::PostProcessingBloom::getIntensity() const +

+

Gets the intensity of the bloom effect.

+ + + + + + + +
ReturnsIntensity of the bloom effect.
+
+
+

+ void cubos::engine::PostProcessingBloom::setThreshold(float threshold) +

+

Sets the threshold for the bloom effect.

+ + + + + + + + + + +
Parameters
thresholdNew threshold.
+
+
+

+ void cubos::engine::PostProcessingBloom::setSoftThreshold(float softThreshold) +

+

Sets the soft threshold ratio.

+ + + + + + + + + + +
Parameters
softThresholdRatio for including pixels that don't pass the threshold test.
+
+
+

+ void cubos::engine::PostProcessingBloom::setIntensity(float intensity) +

+

Sets the intensity of the bloom effect.

+ + + + + + + + + + +
Parameters
intensityIntensity of the bloom effect.
+
+
+

+ void cubos::engine::PostProcessingBloom::resize(glm::uvec2 size) override +

+

Called when the window framebuffer size changes.

+ + + + + + + + + + +
Parameters
sizeNew size of the window.
+
+
+

+ void cubos::engine::PostProcessingBloom::execute(std::map<PostProcessingInput, core::gl::Texture2D>& inputs, + core::gl::Texture2D prev, + core::gl::Framebuffer out) const override +

+

Called each frame.

+ + + + + + + + + + + + + + + + + + +
Parameters
inputsAvailable extra input textures.
prevResulting texture of the previous pass.
outFramebuffer where the pass will render to.
+

The inputs argument is mutable to allow passes to their own inputs for future passes. This argument is used, for example, to pass the extra outputs of the deferred renderer to the post processing passes which might need them.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1PostProcessingCopy.html b/pr-preview/pr-494/classcubos_1_1engine_1_1PostProcessingCopy.html new file mode 100644 index 000000000..45d19ccfb --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1PostProcessingCopy.html @@ -0,0 +1,219 @@ + + + + + cubos::engine::PostProcessingCopy class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::PostProcessingCopy class +
#include <engine/renderer/pps/copy_pass.hpp>
+

+

A simple post processing pass that copies the input texture to the output.

+ +

This pass is useless and is only used as an example and for testing.

+
+

Base classes

+
+
+ class PostProcessingPass +
+
A generic post processing pass.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ PostProcessingCopy(core::gl::RenderDevice& renderDevice, + glm::uvec2 size) +
+
Constructs.
+
+
+
+

Public functions

+
+
+ void resize(glm::uvec2 size) override +
+
Called when the window framebuffer size changes.
+
+ void execute(std::map<PostProcessingInput, core::gl::Texture2D>& inputs, + core::gl::Texture2D prev, + core::gl::Framebuffer out) const override +
+
Called each frame.
+
+
+
+

Function documentation

+
+

+ cubos::engine::PostProcessingCopy::PostProcessingCopy(core::gl::RenderDevice& renderDevice, + glm::uvec2 size) +

+

Constructs.

+ + + + + + + + + + + + + + +
Parameters
renderDeviceRender device to use.
sizeSize of the window.
+
+
+

+ void cubos::engine::PostProcessingCopy::resize(glm::uvec2 size) override +

+

Called when the window framebuffer size changes.

+ + + + + + + + + + +
Parameters
sizeNew size of the window.
+
+
+

+ void cubos::engine::PostProcessingCopy::execute(std::map<PostProcessingInput, core::gl::Texture2D>& inputs, + core::gl::Texture2D prev, + core::gl::Framebuffer out) const override +

+

Called each frame.

+ + + + + + + + + + + + + + + + + + +
Parameters
inputsAvailable extra input textures.
prevResulting texture of the previous pass.
outFramebuffer where the pass will render to.
+

The inputs argument is mutable to allow passes to their own inputs for future passes. This argument is used, for example, to pass the extra outputs of the deferred renderer to the post processing passes which might need them.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1PostProcessingManager.html b/pr-preview/pr-494/classcubos_1_1engine_1_1PostProcessingManager.html new file mode 100644 index 000000000..8ae0929ef --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1PostProcessingManager.html @@ -0,0 +1,294 @@ + + + + + cubos::engine::PostProcessingManager class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::PostProcessingManager class final +
#include <engine/renderer/pps/manager.hpp>
+

+

Responsible for managing the post processing passes.

+ +

This class is renderer agnostic. It can be used with any renderer implementation. Passes are executed in the order they are added, and take as input the output of the previous pass and the outputs of the renderer.

+
+

Constructors, destructors, conversion operators

+
+
+ PostProcessingManager(core::gl::RenderDevice& renderDevice, + glm::uvec2 size) +
+
Constructs.
+
+
+
+

Public functions

+
+
+ void resize(glm::uvec2 size) +
+
Called when the window framebuffer size changes.
+
+ void provideInput(PostProcessingInput input, + core::gl::Texture2D texture) +
+
Provides a texture input to be used by the passes.
+
+
template<typename T>
+ auto addPass() -> std::size_t +
+
Adds a pass to the manager.
+
+ void removePass(std::size_t id) +
+
Removes a pass from the manager.
+
+ void execute(const core::gl::Framebuffer& out) +
+
Applies all post processing passes sequentially, and outputs the result to the given framebuffer.
+
+ auto passCount() const -> std::size_t +
+
Gets the number of passes in the manager.
+
+
+
+

Function documentation

+
+

+ cubos::engine::PostProcessingManager::PostProcessingManager(core::gl::RenderDevice& renderDevice, + glm::uvec2 size) +

+

Constructs.

+ + + + + + + + + + + + + + +
Parameters
renderDeviceRender device to use.
sizeSize of the window.
+
+
+

+ void cubos::engine::PostProcessingManager::resize(glm::uvec2 size) +

+

Called when the window framebuffer size changes.

+ + + + + + + + + + +
Parameters
sizeNew size of the window.
+
+
+

+ void cubos::engine::PostProcessingManager::provideInput(PostProcessingInput input, + core::gl::Texture2D texture) +

+

Provides a texture input to be used by the passes.

+ + + + + + + + + + + + + + +
Parameters
inputInput identifier.
textureTexture to provide.
+
+
+

+
+ template<typename T> +
+ std::size_t cubos::engine::PostProcessingManager::addPass() +

+

Adds a pass to the manager.

+ + + + + + + + + + + + + + + + +
Template parameters
TType of the pass to add.
ReturnsID of the pass.
+
+
+

+ void cubos::engine::PostProcessingManager::removePass(std::size_t id) +

+

Removes a pass from the manager.

+ + + + + + + + + + +
Parameters
idID of the pass.
+
+
+

+ void cubos::engine::PostProcessingManager::execute(const core::gl::Framebuffer& out) +

+

Applies all post processing passes sequentially, and outputs the result to the given framebuffer.

+ + + + + + + + + + +
Parameters
outFramebuffer to output to.
+

The lighting input must have been provided before calling this function, since it acts as the input for the first pass.

+
+
+

+ std::size_t cubos::engine::PostProcessingManager::passCount() const +

+

Gets the number of passes in the manager.

+ + + + + + + +
ReturnsNumber of passes.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1PostProcessingPass.html b/pr-preview/pr-494/classcubos_1_1engine_1_1PostProcessingPass.html new file mode 100644 index 000000000..5b2a9b435 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1PostProcessingPass.html @@ -0,0 +1,231 @@ + + + + + cubos::engine::PostProcessingPass class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::PostProcessingPass class +
#include <engine/renderer/pps/pass.hpp>
+

+

A generic post processing pass.

+ +

All passes must have the same constructor arguments: the render device and the size of the window. They should never be constructed directly, and instead should be created using the PostProcessingManager.

+
+

Derived classes

+
+
+ class PostProcessingBloom +
+
A post processing pass that adds a "bloom" effect to any bright objects in the scene.
+
+ class PostProcessingCopy +
+
A simple post processing pass that copies the input texture to the output.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ PostProcessingPass(core::gl::RenderDevice& renderDevice) +
+
Constructs.
+
+ PostProcessingPass(const PostProcessingPass&) deleted +
+
Deleted copy constructor.
+
+
+
+

Public functions

+
+
+ void resize(glm::uvec2 size) pure virtual +
+
Called when the window framebuffer size changes.
+
+ void execute(std::map<PostProcessingInput, core::gl::Texture2D>& inputs, + core::gl::Texture2D prev, + core::gl::Framebuffer out) const pure virtual +
+
Called each frame.
+
+
+
+

Protected variables

+
+
+ core::gl::RenderDevice& mRenderDevice +
+
Render device to use.
+
+
+
+

Function documentation

+
+

+ cubos::engine::PostProcessingPass::PostProcessingPass(core::gl::RenderDevice& renderDevice) +

+

Constructs.

+ + + + + + + + + + +
Parameters
renderDeviceRender device to use.
+
+
+

+ void cubos::engine::PostProcessingPass::resize(glm::uvec2 size) pure virtual +

+

Called when the window framebuffer size changes.

+ + + + + + + + + + +
Parameters
sizeNew size of the window.
+
+
+

+ void cubos::engine::PostProcessingPass::execute(std::map<PostProcessingInput, core::gl::Texture2D>& inputs, + core::gl::Texture2D prev, + core::gl::Framebuffer out) const pure virtual +

+

Called each frame.

+ + + + + + + + + + + + + + + + + + +
Parameters
inputsAvailable extra input textures.
prevResulting texture of the previous pass.
outFramebuffer where the pass will render to.
+

The inputs argument is mutable to allow passes to their own inputs for future passes. This argument is used, for example, to pass the extra outputs of the deferred renderer to the post processing passes which might need them.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1RendererFrame.html b/pr-preview/pr-494/classcubos_1_1engine_1_1RendererFrame.html new file mode 100644 index 000000000..d030c22d0 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1RendererFrame.html @@ -0,0 +1,390 @@ + + + + + cubos::engine::RendererFrame class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::RendererFrame class final +
#include <engine/renderer/frame.hpp>
+

+

Resource which describes a scene to be drawn by the renderer.

+ +

Each frame, the Renderer will query entities with renderer components, such as RenderableGrid and PointLight, and add them to the RendererFrame.

+
+

Public types

+
+
+ struct DrawCmd +
+
Data of a single draw command.
+
+
+
+

Public functions

+
+
+ void draw(RendererGrid grid, + glm::mat4 modelMat) +
+
Submits a draw command.
+
+ void ambient(const glm::vec3& color) +
+
Sets the ambient light of the scene.
+
+ void skyGradient(glm::vec3 bottom, + glm::vec3 top) +
+
Sets the sky gradient of the scene.
+
+ void light(const core::gl::SpotLight& light) +
+
Adds a spot light to the frame.
+
+ void light(const core::gl::DirectionalLight& light) +
+
Adds a directional light to the frame.
+
+ void light(const core::gl::PointLight& light) +
+
Adds a point light to the frame.
+
+ void clear() +
+
Clears the frame, removing all draw calls and lights.
+
+ auto drawCmds() const -> const std::vector<DrawCmd>& +
+
Gets all of the draw commands stored in the frame.
+
+ auto ambient() const -> const glm::vec3& +
+
Gets the ambient light of the scene.
+
+ auto skyGradient(int i) const -> const glm::vec3& +
+
Gets the sky gradient of the scene.
+
+ auto spotLights() const -> const std::vector<core::gl::SpotLight>& +
+
Gets the spot lights of the frame.
+
+ auto directionalLights() const -> const std::vector<core::gl::DirectionalLight>& +
+
Gets the directional lights of the frame.
+
+ auto pointLights() const -> const std::vector<core::gl::PointLight>& +
+
Gets the point lights of the frame.
+
+
+
+

Function documentation

+
+

+ void cubos::engine::RendererFrame::draw(RendererGrid grid, + glm::mat4 modelMat) +

+

Submits a draw command.

+ + + + + + + + + + + + + + +
Parameters
gridHandle of the grid to draw.
modelMatModel matrix of the grid, used for applying transformations.
+
+
+

+ void cubos::engine::RendererFrame::ambient(const glm::vec3& color) +

+

Sets the ambient light of the scene.

+ + + + + + + + + + +
Parameters
colorColor of the ambient light.
+
+
+

+ void cubos::engine::RendererFrame::skyGradient(glm::vec3 bottom, + glm::vec3 top) +

+

Sets the sky gradient of the scene.

+ + + + + + + + + + + + + + +
Parameters
bottomBottom sky color.
topTop sky color.
+
+
+

+ void cubos::engine::RendererFrame::light(const core::gl::SpotLight& light) +

+

Adds a spot light to the frame.

+ + + + + + + + + + +
Parameters
lightSpot light to add.
+
+
+

+ void cubos::engine::RendererFrame::light(const core::gl::DirectionalLight& light) +

+

Adds a directional light to the frame.

+ + + + + + + + + + +
Parameters
lightDirectional light to add.
+
+
+

+ void cubos::engine::RendererFrame::light(const core::gl::PointLight& light) +

+

Adds a point light to the frame.

+ + + + + + + + + + +
Parameters
lightPoint light to add.
+
+
+

+ const std::vector<DrawCmd>& cubos::engine::RendererFrame::drawCmds() const +

+

Gets all of the draw commands stored in the frame.

+ + + + + + + +
ReturnsDraw commands.
+
+
+

+ const glm::vec3& cubos::engine::RendererFrame::ambient() const +

+

Gets the ambient light of the scene.

+ + + + + + + +
ReturnsDmbient light.
+
+
+

+ const glm::vec3& cubos::engine::RendererFrame::skyGradient(int i) const +

+

Gets the sky gradient of the scene.

+ + + + + + + + + + + + + + + + +
Parameters
iIndex of the color (0 = bottom, 1 = top).
ReturnsAmbient light.
+
+
+

+ const std::vector<core::gl::SpotLight>& cubos::engine::RendererFrame::spotLights() const +

+

Gets the spot lights of the frame.

+ + + + + + + +
ReturnsSpot lights.
+
+
+

+ const std::vector<core::gl::DirectionalLight>& cubos::engine::RendererFrame::directionalLights() const +

+

Gets the directional lights of the frame.

+ + + + + + + +
ReturnsDirectional lights.
+
+
+

+ const std::vector<core::gl::PointLight>& cubos::engine::RendererFrame::pointLights() const +

+

Gets the point lights of the frame.

+ + + + + + + +
ReturnsPoint lights.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1SceneBridge.html b/pr-preview/pr-494/classcubos_1_1engine_1_1SceneBridge.html new file mode 100644 index 000000000..46fc0ba1c --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1SceneBridge.html @@ -0,0 +1,225 @@ + + + + + cubos::engine::SceneBridge class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::SceneBridge class +
#include <engine/scene/bridge.hpp>
+

+

Bridge which loads and saves Scene assets.

+ +

Scenes are stored as JSON files with two top-level objects:

  • "imports" - a dictionary of names to asset IDs of other scenes to import.
  • "entities" - a dictionary of names to serialized entities.

Entities imported from sub-scenes can be overriden by defining them in the current scene. For example:

{
+    "imports": {
+        "foo": "6f42ae5a-59d1-5df3-8720-83b8df6dd536"
+    },
+    "entities": {
+        "baz": {
+            "cubos/position": {
+                "x": 1,
+                "y": 2,
+                "z": 3
+            }
+        },
+        "foo.bar": {
+            "cubos/parent": "baz",
+        }
+    }
+}

This scene will import the subscene with ID 6f42ae5a-59d1-5df3-8720-83b8df6dd536, and prefix all of its entities with foo.. The entity foo.bar will override the entity bar from the imported scene, while the entity baz will be added to the scene.

+
+

Base classes

+
+
+ class AssetBridge +
+
Bridges are the objects responsible for loading and saving assets from/to disk. They form the bridge between the asset manager and the virtual file system.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ SceneBridge() +
+
Constructs a bridge.
+
+
+
+

Public functions

+
+
+ auto load(Assets& assets, + const AnyAsset& handle) -> bool override +
+
Loads an asset.
+
+ auto save(const Assets& assets, + const AnyAsset& handle) -> bool override +
+
Saves an asset.
+
+
+
+

Function documentation

+
+

+ bool cubos::engine::SceneBridge::load(Assets& assets, + const AnyAsset& handle) override +

+

Loads an asset.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to write into.
handleHandle of the asset being loaded.
ReturnsWhether the asset was successfully loaded.
+

The metadata of the given asset should already be present in the asset manager.

+
+
+

+ bool cubos::engine::SceneBridge::save(const Assets& assets, + const AnyAsset& handle) override +

+

Saves an asset.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
assetsManager to read from.
handleHandle of the asset being saved.
ReturnsWhether the asset was successfully saved.
+

The asset should be loaded in the asset manager.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1SystemBuilder.html b/pr-preview/pr-494/classcubos_1_1engine_1_1SystemBuilder.html new file mode 100644 index 000000000..7cf58e23b --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1SystemBuilder.html @@ -0,0 +1,354 @@ + + + + + cubos::engine::SystemBuilder class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::SystemBuilder class +
#include <engine/cubos.hpp>
+

+

Used to chain configurations related to systems.

+ +
+

Constructors, destructors, conversion operators

+
+
+ SystemBuilder(core::ecs::Dispatcher& dispatcher, + std::vector<std::string>& tags) +
+
Construct.
+
+
+
+

Public functions

+
+
+ auto tagged(const std::string& tag) -> SystemBuilder& +
+
Sets the current system's tag.
+
+ auto beforeTag(const std::string& tag) -> SystemBuilder& +
+
Sets the current system to be executed before another tag.
+
+ auto afterTag(const std::string& tag) -> SystemBuilder& +
+
Sets the current system to be executed after another tag.
+
+
template<typename F>
+ auto beforeSystem(F func) -> SystemBuilder& +
+
Sets the current system to be executed before another system.
+
+
template<typename F>
+ auto afterSystem(F func) -> SystemBuilder& +
+
Sets the current system to be executed after another system.
+
+
template<typename F>
+ auto runIf(F func) -> SystemBuilder& +
+
Adds a condition to the current system. If this condition returns false, the system will not be executed. For a system to run, all conditions must return true.
+
+
+
+

Function documentation

+
+

+ cubos::engine::SystemBuilder::SystemBuilder(core::ecs::Dispatcher& dispatcher, + std::vector<std::string>& tags) +

+

Construct.

+ + + + + + + + + + + + + + +
Parameters
dispatcherDispatcher being configured.
tagsVector which stores the tags for this dispatcher.
+
+
+

+ SystemBuilder& cubos::engine::SystemBuilder::tagged(const std::string& tag) +

+

Sets the current system's tag.

+ + + + + + + + + + + + + + + + +
Parameters
tagTag to be set.
ReturnsReference to this object, for chaining.
+
+
+

+ SystemBuilder& cubos::engine::SystemBuilder::beforeTag(const std::string& tag) +

+

Sets the current system to be executed before another tag.

+ + + + + + + + + + + + + + + + +
Parameters
tagTag to be executed before.
ReturnsReference to this object, for chaining.
+
+
+

+ SystemBuilder& cubos::engine::SystemBuilder::afterTag(const std::string& tag) +

+

Sets the current system to be executed after another tag.

+ + + + + + + + + + + + + + + + +
Parameters
tagTag to be executed after.
ReturnsReference to this object, for chaining.
+
+
+

+
+ template<typename F> +
+ SystemBuilder& cubos::engine::SystemBuilder::beforeSystem(F func) +

+

Sets the current system to be executed before another system.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
FSystem type.
Parameters
funcSystem to be executed before.
ReturnsReference to this object, for chaining.
+
+
+

+
+ template<typename F> +
+ SystemBuilder& cubos::engine::SystemBuilder::afterSystem(F func) +

+

Sets the current system to be executed after another system.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
FSystem type.
Parameters
funcSystem to be executed after.
ReturnsReference to this object, for chaining.
+
+
+

+
+ template<typename F> +
+ SystemBuilder& cubos::engine::SystemBuilder::runIf(F func) +

+

Adds a condition to the current system. If this condition returns false, the system will not be executed. For a system to run, all conditions must return true.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
FCondition system type.
Parameters
funcCondition system.
ReturnsReference to this object, for chaining.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1TagBuilder.html b/pr-preview/pr-494/classcubos_1_1engine_1_1TagBuilder.html new file mode 100644 index 000000000..28be7a7f2 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1TagBuilder.html @@ -0,0 +1,244 @@ + + + + + cubos::engine::TagBuilder class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::TagBuilder class +
#include <engine/cubos.hpp>
+

+

Used to chain configurations related to tags.

+ +
+

Constructors, destructors, conversion operators

+
+
+ TagBuilder(core::ecs::Dispatcher& dispatcher, + std::vector<std::string>& tags) +
+
Construct.
+
+
+
+

Public functions

+
+
+ auto beforeTag(const std::string& tag) -> TagBuilder& +
+
Sets the current tag to be executed before another tag.
+
+ auto afterTag(const std::string& tag) -> TagBuilder& +
+
Sets the current tag to be executed after another tag.
+
+
template<typename F>
+ auto runIf(F func) -> TagBuilder& +
+
Adds a condition to the current tag. If this condition returns false, systems with this tag will not be executed. For the tagged systems to run, all conditions must return true.
+
+
+
+

Function documentation

+
+

+ cubos::engine::TagBuilder::TagBuilder(core::ecs::Dispatcher& dispatcher, + std::vector<std::string>& tags) +

+

Construct.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
dispatcherDispatcher being configured
tagsVector which stores the tags for this dispatcher.
ReturnsReference to this object, for chaining.
+
+
+

+ TagBuilder& cubos::engine::TagBuilder::beforeTag(const std::string& tag) +

+

Sets the current tag to be executed before another tag.

+ + + + + + + + + + + + + + + + +
Parameters
tagTag to be executed before.
ReturnsReference to this object, for chaining.
+
+
+

+ TagBuilder& cubos::engine::TagBuilder::afterTag(const std::string& tag) +

+

Sets the current tag to be executed after another tag.

+ + + + + + + + + + + + + + + + +
Parameters
tagTag to be executed after.
ReturnsReference to this object, for chaining.
+
+
+

+
+ template<typename F> +
+ TagBuilder& cubos::engine::TagBuilder::runIf(F func) +

+

Adds a condition to the current tag. If this condition returns false, systems with this tag will not be executed. For the tagged systems to run, all conditions must return true.

+ + + + + + + + + + + + + + + + +
Parameters
funcCondition function.
ReturnsReference to this object, for chaining.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/classcubos_1_1engine_1_1impl_1_1RendererGrid.html b/pr-preview/pr-494/classcubos_1_1engine_1_1impl_1_1RendererGrid.html new file mode 100644 index 000000000..6a01e12f2 --- /dev/null +++ b/pr-preview/pr-494/classcubos_1_1engine_1_1impl_1_1RendererGrid.html @@ -0,0 +1,101 @@ + + + + + cubos::engine::impl::RendererGrid class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::impl::RendererGrid class +
#include <engine/renderer/renderer.hpp>
+

+

Represents a grid which was uploaded to the GPU.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/collisions_2plugin_8hpp.html b/pr-preview/pr-494/collisions_2plugin_8hpp.html new file mode 100644 index 000000000..e81375808 --- /dev/null +++ b/pr-preview/pr-494/collisions_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/collisions/plugin.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/collisions/plugin.hpp file +

+

Plugin entry point.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Functions

+
+
+ void collisionsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/commands_8hpp.html b/pr-preview/pr-494/commands_8hpp.html new file mode 100644 index 000000000..9de221f9a --- /dev/null +++ b/pr-preview/pr-494/commands_8hpp.html @@ -0,0 +1,144 @@ + + + + + core/ecs/commands.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/commands.hpp file +

+

Class cubos::core::ecs::Commands and related types.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
+
+
+

Classes

+
+
+ class cubos::core::ecs::EntityBuilder +
+
Allows editing an entity created by a Commands object.
+
+ class cubos::core::ecs::BlueprintBuilder +
+
Used to edit a blueprint spawned by a Commands object.
+
+ class cubos::core::ecs::Commands +
+
Used to write ECS commands and execute them at a later time.
+
+ class cubos::core::ecs::CommandBuffer +
+
Stores commands to execute them later.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/component__manager_8hpp.html b/pr-preview/pr-494/component__manager_8hpp.html new file mode 100644 index 000000000..7435159e7 --- /dev/null +++ b/pr-preview/pr-494/component__manager_8hpp.html @@ -0,0 +1,157 @@ + + + + + core/ecs/component_manager.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/component_manager.hpp file +

+

Class cubos::core::ecs::ComponentManager and related types.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
+
+
+

Classes

+
+
+
template<typename T>
+ class cubos::core::ecs::ReadStorage +
+
Utility struct used to reference a storage of component type T for reading.
+
+
template<typename T>
+ class cubos::core::ecs::WriteStorage +
+
Utility struct used to reference a storage of component type T for writing.
+
+ class cubos::core::ecs::ComponentManager +
+
Holds and manages components.
+
+
+
+

Functions

+
+
+
template<typename T>
+ auto getComponentName() -> std::optional<std::string_view> +
+
Gets the registered name of a component type.
+
+ auto getComponentName(std::type_index type) -> std::optional<std::string_view> +
+
Gets the registered name of a component type.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/contribution.html b/pr-preview/pr-494/contribution.html new file mode 100644 index 000000000..44c122394 --- /dev/null +++ b/pr-preview/pr-494/contribution.html @@ -0,0 +1,112 @@ + + + + + Contribution guidelines | CUBOS. + + + + + + + +
+
+
+
+
+

+ Contribution guidelines +

+

Guide on the project's conventions and code style.

+

Commits

Commits should be concise and small, such that they are easy to review. Avoid at all costs including non-related changes in a commit - use git add -p or something similar to force yourself to review the changes you are commiting, and to avoid accidentally commiting unrelated changes.

Commits should follow Conventional Commits and be written in imperative mood. We use the scopes core, engine and tools. When making a commit which affects more than one of these scopes, you can ommit the scope.

If your description is too long, you can add a body to the commit message. The body should be separated from the description by a blank line.

Examples of good commit messages:

feat(core): add CUBOS_FAIL, CUBOS_UNREACHABLE and CUBOS_DEBUG_ASSERT 
+test(core): move filesystem tests to data/fs
+fix(core): fix segfault when popping a sub context
+feat(engine): implement system for sweeping the markers  
+docs(engine): add comments to colliders
+chore: replace GoogleTest submodule with doctest

Examples of bad commit messages:

fix: fix bug
+make it work
+feat(core): Add CUBOS_FAIL
+docs(engine): added comments to colliders

Pull Requests

Pull requests should be concise and small, and if needed, split into multiple smaller PRs so that they are easier to review. If your PR is still not finished, mark it as a draft. When working on new features, draft PRs should be created so that other contributors can have an idea of what is being worked on.

Any features added in a PR should be covered by tests and documentation, including new examples demonstrating the feature.

Documentation

We use Doxygen for documentation, which means that the documentation is mostly written in the code itself. When adding new files, classes, functions, etc, make sure to at least add a triple slash comment (///) with a @brief section describing what it does, otherwise Doxygen will omit it from the documentation.

Make sure to document all function parameters, template parameters and return values. Take a look at other files to get a grasp of the documentation style we use.

When changing the code, the documentation should be updated accordingly.

Plugins

Engine plugins should document which components and resources they add, which tags and settings are used, and how to use them. Take a look at the documentation of other plugins such as the renderer plugin to get an idea of how it should look like.

Every type or function that is part of the public API of a plugin should be added to its corresponding group in the Doxygen documentation, using the @ingroup tag.

Code Style

Casing

We use camelCase for functions, methods, local variables and fields. Private fields are prefixed with m (e.g. mMyField). PascalCase is used for class names and constants. UPPER_CASE is used for macros. snake_case is used for namespaces, folders and files.

Formatting

Code is formatted using clang format. Although we have an action that runs clang format on every PR, it is recommended that you run it locally before commiting your changes, to make it easier for the reviewers to read your code.

We also check the code with clang tidy, which is a static analysis tool which picks up many common mistakes and code smell. This runs on every commit you push to your branch.

Macros

Avoid using macros whenever possible - use constexpr variables or functions instead. If you do need to use a macro to make an implementation more readable, restrict the macro to the source file where it is used. Defining macros in header files is heavily discouraged.

Namespaces

Avoid using namespace in header files. In source files, prefer using foo::bar::X over using namespace foo::bar. If your code is under the namespace foo::bar, you can use using namespace foo::bar in the source files, to make the code more readable.

When closing a namespace the namespace name should be added as a comment. E.g.:

namespace foo
+{
+    ...
+} // namespace foo
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/copy__pass_8hpp.html b/pr-preview/pr-494/copy__pass_8hpp.html new file mode 100644 index 000000000..bbbf69fe3 --- /dev/null +++ b/pr-preview/pr-494/copy__pass_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/renderer/pps/copy_pass.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/renderer/pps/copy_pass.hpp file +

+

Post processing pass implementation cubos::engine::PostProcessingCopy.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::PostProcessingCopy +
+
A simple post processing pass that copies the input texture to the output.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/core_2include_2cubos_2core_2data_2fs_2file_8hpp.html b/pr-preview/pr-494/core_2include_2cubos_2core_2data_2fs_2file_8hpp.html new file mode 100644 index 000000000..ed1596ec5 --- /dev/null +++ b/pr-preview/pr-494/core_2include_2cubos_2core_2data_2fs_2file_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/data/fs/file.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/data/fs/file.hpp file +

+

Class cubos::core::data::File.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::data
+
Data module.
+
+
+
+

Classes

+
+
+ class cubos::core::data::File +
+
Represents a file in the virtual file system of the engine.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/core_2include_2cubos_2core_2geom_2box_8hpp.html b/pr-preview/pr-494/core_2include_2cubos_2core_2geom_2box_8hpp.html new file mode 100644 index 000000000..c85ad9eaf --- /dev/null +++ b/pr-preview/pr-494/core_2include_2cubos_2core_2geom_2box_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/geom/box.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/geom/box.hpp file +

+

Class cubos::core::geom::Box.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::geom
+
Geometry module.
+
namespace cubos::core::data
+
Data module.
+
+
+
+

Classes

+
+
+ struct cubos::core::geom::Box +
+
Represents a box shape.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/core_2include_2cubos_2core_2geom_2capsule_8hpp.html b/pr-preview/pr-494/core_2include_2cubos_2core_2geom_2capsule_8hpp.html new file mode 100644 index 000000000..f160db3c6 --- /dev/null +++ b/pr-preview/pr-494/core_2include_2cubos_2core_2geom_2capsule_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/geom/capsule.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/geom/capsule.hpp file +

+

Class cubos::core::geom::Capsule.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::geom
+
Geometry module.
+
namespace cubos::core::data
+
Data module.
+
+
+
+

Classes

+
+
+ struct cubos::core::geom::Capsule +
+
Represents a capsule or sphere shape.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/core_2include_2cubos_2core_2geom_2plane_8hpp.html b/pr-preview/pr-494/core_2include_2cubos_2core_2geom_2plane_8hpp.html new file mode 100644 index 000000000..2fecf5af5 --- /dev/null +++ b/pr-preview/pr-494/core_2include_2cubos_2core_2geom_2plane_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/geom/plane.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/geom/plane.hpp file +

+

Class cubos::core::geom::Plane.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::geom
+
Geometry module.
+
namespace cubos::core::data
+
Data module.
+
+
+
+

Classes

+
+
+ struct cubos::core::geom::Plane +
+
Represents a plane shape.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/core_2include_2cubos_2core_2geom_2simplex_8hpp.html b/pr-preview/pr-494/core_2include_2cubos_2core_2geom_2simplex_8hpp.html new file mode 100644 index 000000000..886ce74d4 --- /dev/null +++ b/pr-preview/pr-494/core_2include_2cubos_2core_2geom_2simplex_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/geom/simplex.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/geom/simplex.hpp file +

+

Class cubos::core::geom::Simplex.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::geom
+
Geometry module.
+
namespace cubos::core::data
+
Data module.
+
+
+
+

Classes

+
+
+ struct cubos::core::geom::Simplex +
+
Represents a simplex shape, which may either be empty, a point, a line, a triangle or a tetrahedron.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/core_2include_2cubos_2core_2gl_2light_8hpp.html b/pr-preview/pr-494/core_2include_2cubos_2core_2gl_2light_8hpp.html new file mode 100644 index 000000000..52fabfc32 --- /dev/null +++ b/pr-preview/pr-494/core_2include_2cubos_2core_2gl_2light_8hpp.html @@ -0,0 +1,140 @@ + + + + + core/gl/light.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/gl/light.hpp file +

+

Classes cubos::core::gl::SpotLight, cubos::core::gl::DirectionalLight and cubos::core::gl::PointLight.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::gl
+
Graphics module.
+
+
+
+

Classes

+
+
+ struct cubos::core::gl::SpotLight +
+
Describes a spot light.
+
+ struct cubos::core::gl::DirectionalLight +
+
Describes a directional light.
+
+ struct cubos::core::gl::PointLight +
+
Describes a point light.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/core_2samples_2data_2fs_2embedded__archive_2main_8cpp.html b/pr-preview/pr-494/core_2samples_2data_2fs_2embedded__archive_2main_8cpp.html new file mode 100644 index 000000000..d5d815a1c --- /dev/null +++ b/pr-preview/pr-494/core_2samples_2data_2fs_2embedded__archive_2main_8cpp.html @@ -0,0 +1,101 @@ + + + + + data/fs/embedded_archive/main.cpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ data/fs/embedded_archive/main.cpp file +

+

Sample which showcases how the EmbeddedArchive class can be used.

+

The assets directory on the same directory as this file was embedded into embed.cpp using the command quadrados embed -r assets > embed.cpp. Since no further options were specified, quadrados registered the data with the name of the embedded file - assets.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/cubos_8hpp.html b/pr-preview/pr-494/cubos_8hpp.html new file mode 100644 index 000000000..5c7b4292e --- /dev/null +++ b/pr-preview/pr-494/cubos_8hpp.html @@ -0,0 +1,150 @@ + + + + + engine/cubos.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/cubos.hpp file +

+

Class cubos::engine::Cubos.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ struct cubos::engine::DeltaTime +
+
Resource which stores the time since the last iteration of the main loop started.
+
+ struct cubos::engine::ShouldQuit +
+
Resource used as a flag to indicate whether the main loop should stop running.
+
+ struct cubos::engine::Arguments +
+
Resource used for storing program arguments.
+
+ class cubos::engine::TagBuilder +
+
Used to chain configurations related to tags.
+
+ class cubos::engine::SystemBuilder +
+
Used to chain configurations related to systems.
+
+ class cubos::engine::Cubos +
+
Represents the engine itself, and exposes the interface with which the game developer interacts with. Ties up all the different parts of the engine together.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/cursor_8hpp.html b/pr-preview/pr-494/cursor_8hpp.html new file mode 100644 index 000000000..673da2595 --- /dev/null +++ b/pr-preview/pr-494/cursor_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/io/cursor.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/io/cursor.hpp file +

+

Class cubos::core::io::Cursor.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::io
+
Input and output module.
+
+
+
+

Classes

+
+
+ class cubos::core::io::Cursor +
+
Handle for a custom mouse cursor.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/debug_8hpp.html b/pr-preview/pr-494/debug_8hpp.html new file mode 100644 index 000000000..c01ee55d4 --- /dev/null +++ b/pr-preview/pr-494/debug_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/gl/debug.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/gl/debug.hpp file +

+

Class cubos::core::gl::Debug.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::gl
+
Graphics module.
+
+
+
+

Classes

+
+
+ class cubos::core::gl::Debug +
+
Singleton with static methods used to draw primitive objects on screen for debugging purposes.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/deferred__renderer_8hpp.html b/pr-preview/pr-494/deferred__renderer_8hpp.html new file mode 100644 index 000000000..491c8d973 --- /dev/null +++ b/pr-preview/pr-494/deferred__renderer_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/renderer/deferred_renderer.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/renderer/deferred_renderer.hpp file +

+

Renderer implementation cubos::engine::DeferredRenderer.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::DeferredRenderer +
+
Renderer implementation which uses deferred rendering.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_0835e003fa277f66ce5cf543d578f6a2.html b/pr-preview/pr-494/dir_0835e003fa277f66ce5cf543d578f6a2.html new file mode 100644 index 000000000..48aea1cff --- /dev/null +++ b/pr-preview/pr-494/dir_0835e003fa277f66ce5cf543d578f6a2.html @@ -0,0 +1,134 @@ + + + + + engine/assets/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/assets/ directory +

+

Assets plugin directory.

+ +
+

Directories

+
+
directory bridges/
+
cubos::engine::AssetBridge implementations directory.
+
+
+
+

Files

+
+
file asset.hpp
+
Classes cubos::engine::AnyAsset and cubos::engine::Asset.
+
file assets.hpp
+
Resource cubos::engine::Assets.
+
file bridge.hpp
+
Class cubos::engine::AssetBridge.
+
file meta.hpp
+
Class cubos::engine::AssetMeta.
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_2a3f20446d92cb0b384d0cf4f4d26d60.html b/pr-preview/pr-494/dir_2a3f20446d92cb0b384d0cf4f4d26d60.html new file mode 100644 index 000000000..9774e0b55 --- /dev/null +++ b/pr-preview/pr-494/dir_2a3f20446d92cb0b384d0cf4f4d26d60.html @@ -0,0 +1,118 @@ + + + + + engine/window/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/window/ directory +

+

Window plugin directory.

+ +
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_3733897ca737f1fa8773f329655abd67.html b/pr-preview/pr-494/dir_3733897ca737f1fa8773f329655abd67.html new file mode 100644 index 000000000..5595f7f84 --- /dev/null +++ b/pr-preview/pr-494/dir_3733897ca737f1fa8773f329655abd67.html @@ -0,0 +1,118 @@ + + + + + engine/tools/entity_selector/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/tools/entity_selector/ directory +

+

Entity selector plugin directory.

+ +
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_38e9fb064544086d3594e70a41f6b257.html b/pr-preview/pr-494/dir_38e9fb064544086d3594e70a41f6b257.html new file mode 100644 index 000000000..0213d5d7d --- /dev/null +++ b/pr-preview/pr-494/dir_38e9fb064544086d3594e70a41f6b257.html @@ -0,0 +1,122 @@ + + + + + engine/scene/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/scene/ directory +

+

Scene plugin directory.

+ +
+

Files

+
+
file bridge.hpp
+
Class cubos::engine::SceneBridge.
+
file plugin.hpp
+
Plugin entry point.
+
file scene.hpp
+
Class cubos::engine::Scene.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_3a267dbab794906b09058daa283b3fee.html b/pr-preview/pr-494/dir_3a267dbab794906b09058daa283b3fee.html new file mode 100644 index 000000000..3015902e4 --- /dev/null +++ b/pr-preview/pr-494/dir_3a267dbab794906b09058daa283b3fee.html @@ -0,0 +1,124 @@ + + + + + engine/collisions/colliders/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/collisions/colliders/ directory +

+

Collider components directory.

+ +
+

Files

+
+
file box.hpp
+
Component cubos::engine::BoxCollider.
+
file capsule.hpp
+
Component cubos::engine::CapsuleCollider.
+
file plane.hpp
+
Component cubos::engine::PlaneCollider.
+
file simplex.hpp
+
Component cubos::engine::SimplexCollider.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_459dda10180a6131eb62bc74e02d0b6e.html b/pr-preview/pr-494/dir_459dda10180a6131eb62bc74e02d0b6e.html new file mode 100644 index 000000000..b1c81a2b1 --- /dev/null +++ b/pr-preview/pr-494/dir_459dda10180a6131eb62bc74e02d0b6e.html @@ -0,0 +1,118 @@ + + + + + engine/imgui/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/imgui/ directory +

+

ImGui integration ImGui plugin directory.

+ +
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_5f701044e65d6c264a6c1dc66b1052c2.html b/pr-preview/pr-494/dir_5f701044e65d6c264a6c1dc66b1052c2.html new file mode 100644 index 000000000..2b8e53ec8 --- /dev/null +++ b/pr-preview/pr-494/dir_5f701044e65d6c264a6c1dc66b1052c2.html @@ -0,0 +1,126 @@ + + + + + engine/transform/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/transform/ directory +

+

Transform plugin directory.

+ +
+

Files

+
+
file local_to_world.hpp
+
Component cubos::engine::LocalToWorld.
+
file plugin.hpp
+
Plugin entry point.
+
file position.hpp
+
Component cubos::engine::Position.
+
file rotation.hpp
+
Component cubos::engine::Rotation.
+
file scale.hpp
+
Component cubos::engine::Scale.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_672562f1eb3ea0be7f3aa3e89e72ecd2.html b/pr-preview/pr-494/dir_672562f1eb3ea0be7f3aa3e89e72ecd2.html new file mode 100644 index 000000000..8527c5381 --- /dev/null +++ b/pr-preview/pr-494/dir_672562f1eb3ea0be7f3aa3e89e72ecd2.html @@ -0,0 +1,124 @@ + + + + + engine/renderer/pps/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/renderer/pps/ directory +

+

Post processing directory.

+ +
+

Files

+
+
file bloom.hpp
+
Post processing pass implementation cubos::engine::PostProcessingBloom.
+
file copy_pass.hpp
+
Post processing pass implementation cubos::engine::PostProcessingCopy.
+
file manager.hpp
+
Class cubos::engine::PostProcessingManager.
+
file pass.hpp
+
Class cubos::engine::PostProcessingPass.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_6c35851ea5afe98a2e16bb1923c0c18a.html b/pr-preview/pr-494/dir_6c35851ea5afe98a2e16bb1923c0c18a.html new file mode 100644 index 000000000..8db1ac582 --- /dev/null +++ b/pr-preview/pr-494/dir_6c35851ea5afe98a2e16bb1923c0c18a.html @@ -0,0 +1,118 @@ + + + + + engine/env_settings/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/env_settings/ directory +

+

Environment settings plugin directory.

+ +
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_6c897dd97bedf3914ee8a4d9f7f6549c.html b/pr-preview/pr-494/dir_6c897dd97bedf3914ee8a4d9f7f6549c.html new file mode 100644 index 000000000..d739d22e4 --- /dev/null +++ b/pr-preview/pr-494/dir_6c897dd97bedf3914ee8a4d9f7f6549c.html @@ -0,0 +1,144 @@ + + + + + core/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ directory +

+

Core module.

+ +
+

Directories

+
+
directory al/
+
Audio module.
+
directory data/
+
Data module.
+
directory ecs/
+
ECS module.
+
directory geom/
+
Geometry module.
+
directory gl/
+
Graphics module.
+
directory io/
+
Input and output module.
+
directory memory/
+
Memory module.
+
directory ui/
+
User Interface module.
+
+
+
+

Files

+
+
file log.hpp
+
Logging and assertion macros.
+
file settings.hpp
+
Class cubos::core::Settings.
+
file thread_pool.hpp
+
Class cubos::core::ThreadPool.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_7376bacbd9e6243f425bd4c56d48edd9.html b/pr-preview/pr-494/dir_7376bacbd9e6243f425bd4c56d48edd9.html new file mode 100644 index 000000000..3fda220d8 --- /dev/null +++ b/pr-preview/pr-494/dir_7376bacbd9e6243f425bd4c56d48edd9.html @@ -0,0 +1,122 @@ + + + + + core/io/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/io/ directory +

+

Input and output module.

+ +
+

Files

+
+
file cursor.hpp
+
Class cubos::core::io::Cursor.
+
file keyboard.hpp
+
Enums cubos::core::io::Key and cubos::core::io::Modifiers.
+
file window.hpp
+
Class cubos::core::io::Window and related types.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_764b6913e5a035b506325f3918f13ed7.html b/pr-preview/pr-494/dir_764b6913e5a035b506325f3918f13ed7.html new file mode 100644 index 000000000..77ef6d94a --- /dev/null +++ b/pr-preview/pr-494/dir_764b6913e5a035b506325f3918f13ed7.html @@ -0,0 +1,118 @@ + + + + + engine/tools/world_inspector/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/tools/world_inspector/ directory +

+

World inspector plugin directory.

+ +
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_79f402fdd7bbb1d73f9fd1aa85f618da.html b/pr-preview/pr-494/dir_79f402fdd7bbb1d73f9fd1aa85f618da.html new file mode 100644 index 000000000..653213c4c --- /dev/null +++ b/pr-preview/pr-494/dir_79f402fdd7bbb1d73f9fd1aa85f618da.html @@ -0,0 +1,128 @@ + + + + + core/data/fs/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/data/fs/ directory +

+

Filesystem utilities directory.

+ +
+

Files

+
+
file archive.hpp
+
Class cubos::core::data::Archive.
+
file embedded_archive.hpp
+
Class cubos::core::data::EmbeddedArchive.
+
file file.hpp
+
Class cubos::core::data::File.
+
file file_stream.hpp
+
Class cubos::core::data::FileStream.
+
file file_system.hpp
+
Class cubos::core::data::FileSystem.
+
file standard_archive.hpp
+
Class cubos::core::data::StandardArchive.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_87a7847ee77970235330560d79c37ce0.html b/pr-preview/pr-494/dir_87a7847ee77970235330560d79c37ce0.html new file mode 100644 index 000000000..25b26feb1 --- /dev/null +++ b/pr-preview/pr-494/dir_87a7847ee77970235330560d79c37ce0.html @@ -0,0 +1,136 @@ + + + + + engine/renderer/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/renderer/ directory +

+

Renderer plugin directory.

+ +
+

Directories

+
+
directory pps/
+
Post processing directory.
+
+
+
+

Files

+
+
file deferred_renderer.hpp
+
Renderer implementation cubos::engine::DeferredRenderer.
+
file environment.hpp
+
Resource cubos::engine::RendererEnvironment.
+
file frame.hpp
+
Resource cubos::engine::RendererFrame.
+
file light.hpp
+
Resource cubos::engine::AmbientLight and components cubos::engine::SpotLight, cubos::engine::DirectionalLight and cubos::engine::PointLight.
+
file plugin.hpp
+
Plugin entry point, resource cubos::engine::ActiveCameras and components cubos::engine::RenderableGrid and cubos::engine::Camera.
+
file renderer.hpp
+
Class cubos::engine::BaseRenderer and resource cubos::engine::Renderer.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_8e5f84d20b1aa89c94160461e78e26c4.html b/pr-preview/pr-494/dir_8e5f84d20b1aa89c94160461e78e26c4.html new file mode 100644 index 000000000..1e6b28fb7 --- /dev/null +++ b/pr-preview/pr-494/dir_8e5f84d20b1aa89c94160461e78e26c4.html @@ -0,0 +1,126 @@ + + + + + engine/input/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/input/ directory +

+

Input plugin directory.

+ +
+

Files

+
+
file action.hpp
+
Class cubos::engine::InputAction.
+
file axis.hpp
+
Class cubos::engine::InputAxis.
+
file bindings.hpp
+
Class cubos::engine::InputBindings.
+
file input.hpp
+
Resource cubos::engine::Input.
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_95549d37735ad5b142799f042eef0d37.html b/pr-preview/pr-494/dir_95549d37735ad5b142799f042eef0d37.html new file mode 100644 index 000000000..92f6310fa --- /dev/null +++ b/pr-preview/pr-494/dir_95549d37735ad5b142799f042eef0d37.html @@ -0,0 +1,118 @@ + + + + + core/data/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/data/ directory +

+

Data module.

+ +
+

Directories

+
+
directory fs/
+
Filesystem utilities directory.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_9b04cf786b414c0d644db09287f665e6.html b/pr-preview/pr-494/dir_9b04cf786b414c0d644db09287f665e6.html new file mode 100644 index 000000000..27879f035 --- /dev/null +++ b/pr-preview/pr-494/dir_9b04cf786b414c0d644db09287f665e6.html @@ -0,0 +1,118 @@ + + + + + engine/voxels/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/voxels/ directory +

+

Voxels plugin directory.

+ +
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_9bdaf8f561be1ffd03f616379797b70b.html b/pr-preview/pr-494/dir_9bdaf8f561be1ffd03f616379797b70b.html new file mode 100644 index 000000000..fd5f37741 --- /dev/null +++ b/pr-preview/pr-494/dir_9bdaf8f561be1ffd03f616379797b70b.html @@ -0,0 +1,128 @@ + + + + + core/memory/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/memory/ directory +

+

Memory module.

+ +
+

Files

+
+
file buffer_stream.hpp
+
Class cubos::core::memory::BufferStream.
+
file endianness.hpp
+
Endianness utility functions.
+
file guards.hpp
+
Classes cubos::core::memory::ReadGuard and cubos::core::memory::WriteGuard.
+
file standard_stream.hpp
+
Class cubos::core::memory::StandardStream.
+
file stream.hpp
+
Class cubos::core::memory::Stream.
+
file type_map.hpp
+
Class cubos::core::memory::TypeMap.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_b6daa990b896c2c0c53126427e4d978d.html b/pr-preview/pr-494/dir_b6daa990b896c2c0c53126427e4d978d.html new file mode 100644 index 000000000..d934b8412 --- /dev/null +++ b/pr-preview/pr-494/dir_b6daa990b896c2c0c53126427e4d978d.html @@ -0,0 +1,152 @@ + + + + + core/ecs/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/ directory +

+

ECS module.

+ +
+

Files

+
+
file accessors.hpp
+
Class cubos::core::ecs::Read and related types.
+
file blueprint.hpp
+
Class cubos::core::ecs::Blueprint.
+
file commands.hpp
+
Class cubos::core::ecs::Commands and related types.
+
file component_manager.hpp
+
Class cubos::core::ecs::ComponentManager and related types.
+
file dispatcher.hpp
+
Class cubos::core::ecs::Dispatcher.
+
file entity_manager.hpp
+
Class cubos::core::ecs::EntityManager and related types.
+
file event_pipe.hpp
+
Resource cubos::core::ecs::EventPipe.
+
file event_reader.hpp
+
Class cubos::core::ecs::EventReader.
+
file event_writer.hpp
+
Class cubos::core::ecs::EventWriter.
+
file map_storage.hpp
+
Class cubos::core::ecs::MapStorage.
+
file null_storage.hpp
+
Class cubos::core::ecs::NullStorage.
+
file query.hpp
+
Class cubos::core::ecs::Query and related types.
+
file registry.hpp
+
Class cubos::core::ecs::Registry and registration macro.
+
file resource_manager.hpp
+
Class cubos::core::ecs::ResourceManager and related types.
+
file storage.hpp
+
Class cubos::core::ecs::Storage and related types.
+
file system.hpp
+
Class cubos::core::ecs::SystemWrapper and related types.
+
file vec_storage.hpp
+
Class cubos::core::ecs::VecStorage.
+
file world.hpp
+
Class cubos::core::ecs::World.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_bafb7af0e03e95b24a45ff63060ab57b.html b/pr-preview/pr-494/dir_bafb7af0e03e95b24a45ff63060ab57b.html new file mode 100644 index 000000000..844302b84 --- /dev/null +++ b/pr-preview/pr-494/dir_bafb7af0e03e95b24a45ff63060ab57b.html @@ -0,0 +1,148 @@ + + + + + engine/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/ directory +

+

Engine module.

+ +
+

Directories

+
+
directory assets/
+
Assets plugin directory.
+
directory collisions/
+
Collisions plugin directory.
+
directory env_settings/
+
Environment settings plugin directory.
+
directory file_settings/
+
File settings plugin directory.
+
directory imgui/
+
ImGui integration ImGui plugin directory.
+
directory input/
+
Input plugin directory.
+
directory renderer/
+
Renderer plugin directory.
+
directory scene/
+
Scene plugin directory.
+
directory tools/
+
Tools plugins directory.
+
directory transform/
+
Transform plugin directory.
+
directory voxels/
+
Voxels plugin directory.
+
directory window/
+
Window plugin directory.
+
+
+
+

Files

+
+
file cubos.hpp
+
Class cubos::engine::Cubos.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_bd9be39c2ccf4132268583193b02b48c.html b/pr-preview/pr-494/dir_bd9be39c2ccf4132268583193b02b48c.html new file mode 100644 index 000000000..9e37c155c --- /dev/null +++ b/pr-preview/pr-494/dir_bd9be39c2ccf4132268583193b02b48c.html @@ -0,0 +1,122 @@ + + + + + engine/assets/bridges/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/assets/bridges/ directory +

+

cubos::engine::AssetBridge implementations directory.

+ +
+

Files

+
+
file binary.hpp
+
Class cubos::engine::BinaryBridge.
+
file file.hpp
+
Class cubos::engine::FileBridge.
+
file json.hpp
+
Class cubos::engine::JSONBridge.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_c185369e92e3603c6d00fa8343148da7.html b/pr-preview/pr-494/dir_c185369e92e3603c6d00fa8343148da7.html new file mode 100644 index 000000000..e81a45040 --- /dev/null +++ b/pr-preview/pr-494/dir_c185369e92e3603c6d00fa8343148da7.html @@ -0,0 +1,126 @@ + + + + + engine/tools/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/tools/ directory +

+

Tools plugins directory.

+ +
+

Directories

+
+
directory asset_explorer/
+
Asset explorer plugin directory.
+
directory entity_inspector/
+
Entity inspector plugin directory.
+
directory entity_selector/
+
Entity selector plugin directory.
+
directory settings_inspector/
+
Settings inspector plugin directory.
+
directory world_inspector/
+
World inspector plugin directory.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_c1deef5baf41393ad8a994c3fd53e62f.html b/pr-preview/pr-494/dir_c1deef5baf41393ad8a994c3fd53e62f.html new file mode 100644 index 000000000..5b393d166 --- /dev/null +++ b/pr-preview/pr-494/dir_c1deef5baf41393ad8a994c3fd53e62f.html @@ -0,0 +1,124 @@ + + + + + core/geom/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/geom/ directory +

+

Geometry module.

+ +
+

Files

+
+
file box.hpp
+
Class cubos::core::geom::Box.
+
file capsule.hpp
+
Class cubos::core::geom::Capsule.
+
file plane.hpp
+
Class cubos::core::geom::Plane.
+
file simplex.hpp
+
Class cubos::core::geom::Simplex.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_c396301357880712663814927d68a432.html b/pr-preview/pr-494/dir_c396301357880712663814927d68a432.html new file mode 100644 index 000000000..bf1dab929 --- /dev/null +++ b/pr-preview/pr-494/dir_c396301357880712663814927d68a432.html @@ -0,0 +1,118 @@ + + + + + engine/tools/asset_explorer/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/tools/asset_explorer/ directory +

+

Asset explorer plugin directory.

+ +
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_c4311188e9cc606330f5e3e0b9dd5059.html b/pr-preview/pr-494/dir_c4311188e9cc606330f5e3e0b9dd5059.html new file mode 100644 index 000000000..5c4b50dac --- /dev/null +++ b/pr-preview/pr-494/dir_c4311188e9cc606330f5e3e0b9dd5059.html @@ -0,0 +1,134 @@ + + + + + core/gl/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/gl/ directory +

+

Graphics module.

+ +
+

Files

+
+
file camera.hpp
+
Class cubos::core::gl::Camera.
+
file debug.hpp
+
Class cubos::core::gl::Debug.
+
file grid.hpp
+
Class cubos::core::gl::Grid.
+
file light.hpp
+
Classes cubos::core::gl::SpotLight, cubos::core::gl::DirectionalLight and cubos::core::gl::PointLight.
+
file material.hpp
+
Class cubos::core::gl::Material.
+
file palette.hpp
+
Class cubos::core::gl::Palette.
+
file render_device.hpp
+
Class cubos::core::gl::RenderDevice and related types.
+
file util.hpp
+
Function cubos::core::gl::generateScreenQuad.
+
file vertex.hpp
+
Class cubos::core::gl::Vertex and function cubos::core::gl::triangulate.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_d0ac2003a3c19c21d7ab7ff2f06fbec3.html b/pr-preview/pr-494/dir_d0ac2003a3c19c21d7ab7ff2f06fbec3.html new file mode 100644 index 000000000..abf658077 --- /dev/null +++ b/pr-preview/pr-494/dir_d0ac2003a3c19c21d7ab7ff2f06fbec3.html @@ -0,0 +1,118 @@ + + + + + engine/tools/entity_inspector/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/tools/entity_inspector/ directory +

+

Entity inspector plugin directory.

+ +
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_db86702e1371d7558db3699dd3786a14.html b/pr-preview/pr-494/dir_db86702e1371d7558db3699dd3786a14.html new file mode 100644 index 000000000..5f39d61d2 --- /dev/null +++ b/pr-preview/pr-494/dir_db86702e1371d7558db3699dd3786a14.html @@ -0,0 +1,130 @@ + + + + + engine/collisions/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/collisions/ directory +

+

Collisions plugin directory.

+ +
+

Directories

+
+
directory colliders/
+
Collider components directory.
+
+
+
+

Files

+
+
file aabb.hpp
+
Component cubos::engine::ColliderAABB.
+
file broad_phase_collisions.hpp
+
Resource cubos::engine::BroadPhaseCollisions.
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_e3da6a0d695fa4fab64ff7a1dec1a4bb.html b/pr-preview/pr-494/dir_e3da6a0d695fa4fab64ff7a1dec1a4bb.html new file mode 100644 index 000000000..362db3cb3 --- /dev/null +++ b/pr-preview/pr-494/dir_e3da6a0d695fa4fab64ff7a1dec1a4bb.html @@ -0,0 +1,118 @@ + + + + + engine/file_settings/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/file_settings/ directory +

+

File settings plugin directory.

+ +
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_e42c9d7813efab99826f1cb60398c3fa.html b/pr-preview/pr-494/dir_e42c9d7813efab99826f1cb60398c3fa.html new file mode 100644 index 000000000..d31748b3a --- /dev/null +++ b/pr-preview/pr-494/dir_e42c9d7813efab99826f1cb60398c3fa.html @@ -0,0 +1,118 @@ + + + + + engine/tools/settings_inspector/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/tools/settings_inspector/ directory +

+

Settings inspector plugin directory.

+ +
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_f556bbe30cd07922836d0e9d7f5fa0a5.html b/pr-preview/pr-494/dir_f556bbe30cd07922836d0e9d7f5fa0a5.html new file mode 100644 index 000000000..0a880aa67 --- /dev/null +++ b/pr-preview/pr-494/dir_f556bbe30cd07922836d0e9d7f5fa0a5.html @@ -0,0 +1,122 @@ + + + + + core/ui/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ui/ directory +

+

User Interface module.

+ +
+

Files

+
+
file ecs.hpp
+
Functions cubos::core::ui::showWorld and cubos::core::ui::editWorld.
+
file imgui.hpp
+
Functions for initializing and using ImGui.
+
file serialization.hpp
+
Functions for showing and editing serializable objects in the UI.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dir_f6f65ff657bd34b22e5078310628f4e7.html b/pr-preview/pr-494/dir_f6f65ff657bd34b22e5078310628f4e7.html new file mode 100644 index 000000000..a792ae5d3 --- /dev/null +++ b/pr-preview/pr-494/dir_f6f65ff657bd34b22e5078310628f4e7.html @@ -0,0 +1,118 @@ + + + + + core/al/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/al/ directory +

+

Audio module.

+ +
+

Files

+
+
file audio_device.hpp
+
Class cubos::core::al::AudioDevice and related types.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/dispatcher_8hpp.html b/pr-preview/pr-494/dispatcher_8hpp.html new file mode 100644 index 000000000..ea18e0c50 --- /dev/null +++ b/pr-preview/pr-494/dispatcher_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/ecs/dispatcher.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/dispatcher.hpp file +

+

Class cubos::core::ecs::Dispatcher.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
+
+
+

Classes

+
+
+ class cubos::core::ecs::Dispatcher +
+
Used to add systems and relations between them and then dispatch them all at once.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/ecs_8hpp.html b/pr-preview/pr-494/ecs_8hpp.html new file mode 100644 index 000000000..ec97c4850 --- /dev/null +++ b/pr-preview/pr-494/ecs_8hpp.html @@ -0,0 +1,139 @@ + + + + + core/ui/ecs.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ui/ecs.hpp file +

+

Functions cubos::core::ui::showWorld and cubos::core::ui::editWorld.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ui
+
User Interface module.
+
+
+
+

Functions

+
+
+ void showWorld(const ecs::World& world, + data::Context* context = nullptr) +
+
Adds a ImGui window which allows the user to inspect the entities and components in a ecs::World.
+
+ void editWorld(ecs::World& world, + data::Context* serContext = nullptr, + data::Context* desContext = nullptr) +
+
Adds a ImGui window which allows the user to edit the entities and components in a ecs::World.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/embedded__archive_8hpp.html b/pr-preview/pr-494/embedded__archive_8hpp.html new file mode 100644 index 000000000..015d48060 --- /dev/null +++ b/pr-preview/pr-494/embedded__archive_8hpp.html @@ -0,0 +1,140 @@ + + + + + core/data/fs/embedded_archive.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/data/fs/embedded_archive.hpp file +

+

Class cubos::core::data::EmbeddedArchive.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::data
+
Data module.
+
+
+
+

Classes

+
+
+ class cubos::core::data::EmbeddedArchive +
+
Archive implementation which reads data embedded in the application. Meant to be used with the quadrados embed tool.
+
+ struct cubos::core::data::EmbeddedArchive::Data +
+
Describes the structure of the embedded data.
+
+ struct cubos::core::data::EmbeddedArchive::Data::Entry +
+
Describes a file entry in the embedded data.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/endianness_8hpp.html b/pr-preview/pr-494/endianness_8hpp.html new file mode 100644 index 000000000..3bff84ecc --- /dev/null +++ b/pr-preview/pr-494/endianness_8hpp.html @@ -0,0 +1,157 @@ + + + + + core/memory/endianness.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/memory/endianness.hpp file +

+

Endianness utility functions.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::memory
+
Memory module.
+
+
+
+

Functions

+
+
+
template<typename T>
+ auto swapBytes(T value) -> T +
+
Swaps the bytes of a value, changing its endianness.
+
+ auto isLittleEndian() -> bool +
+
Checks if the current platform is little endian.
+
+
template<typename T>
+ auto fromLittleEndian(T value) -> T +
+
Converts a value from little endianness to local endianness.
+
+
template<typename T>
+ auto toLittleEndian(T value) -> T +
+
Converts a value from local endianness to little endianness.
+
+
template<typename T>
+ auto fromBigEndian(T value) -> T +
+
Converts a value from big endianness to local endianness.
+
+
template<typename T>
+ auto toBigEndian(T value) -> T +
+
Converts a value from local endianness to big endianness.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/engine_2include_2cubos_2engine_2assets_2bridges_2file_8hpp.html b/pr-preview/pr-494/engine_2include_2cubos_2engine_2assets_2bridges_2file_8hpp.html new file mode 100644 index 000000000..c17480299 --- /dev/null +++ b/pr-preview/pr-494/engine_2include_2cubos_2engine_2assets_2bridges_2file_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/assets/bridges/file.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/assets/bridges/file.hpp file +

+

Class cubos::engine::FileBridge.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::FileBridge +
+
Abstract bridge type defined to reduce boilerplate code in bridge implementations which open a single file to load and save assets.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/engine_2include_2cubos_2engine_2collisions_2colliders_2box_8hpp.html b/pr-preview/pr-494/engine_2include_2cubos_2engine_2collisions_2colliders_2box_8hpp.html new file mode 100644 index 000000000..8f68bab3e --- /dev/null +++ b/pr-preview/pr-494/engine_2include_2cubos_2engine_2collisions_2colliders_2box_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/collisions/colliders/box.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/collisions/colliders/box.hpp file +

+

Component cubos::engine::BoxCollider.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ struct cubos::engine::BoxCollider +
+
Component which adds a box collider to an entity.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/engine_2include_2cubos_2engine_2collisions_2colliders_2capsule_8hpp.html b/pr-preview/pr-494/engine_2include_2cubos_2engine_2collisions_2colliders_2capsule_8hpp.html new file mode 100644 index 000000000..e917e5e49 --- /dev/null +++ b/pr-preview/pr-494/engine_2include_2cubos_2engine_2collisions_2colliders_2capsule_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/collisions/colliders/capsule.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/collisions/colliders/capsule.hpp file +

+

Component cubos::engine::CapsuleCollider.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ struct cubos::engine::CapsuleCollider +
+
Component which adds a capsule collider to an entity.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/engine_2include_2cubos_2engine_2collisions_2colliders_2plane_8hpp.html b/pr-preview/pr-494/engine_2include_2cubos_2engine_2collisions_2colliders_2plane_8hpp.html new file mode 100644 index 000000000..856093954 --- /dev/null +++ b/pr-preview/pr-494/engine_2include_2cubos_2engine_2collisions_2colliders_2plane_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/collisions/colliders/plane.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/collisions/colliders/plane.hpp file +

+

Component cubos::engine::PlaneCollider.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ struct cubos::engine::PlaneCollider +
+
Component which adds a plane collider to an entity.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/engine_2include_2cubos_2engine_2collisions_2colliders_2simplex_8hpp.html b/pr-preview/pr-494/engine_2include_2cubos_2engine_2collisions_2colliders_2simplex_8hpp.html new file mode 100644 index 000000000..274937d9a --- /dev/null +++ b/pr-preview/pr-494/engine_2include_2cubos_2engine_2collisions_2colliders_2simplex_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/collisions/colliders/simplex.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/collisions/colliders/simplex.hpp file +

+

Component cubos::engine::SimplexCollider.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ struct cubos::engine::SimplexCollider +
+
Component which adds a simplex collider to an entity.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/engine_2include_2cubos_2engine_2renderer_2light_8hpp.html b/pr-preview/pr-494/engine_2include_2cubos_2engine_2renderer_2light_8hpp.html new file mode 100644 index 000000000..cfca13ef8 --- /dev/null +++ b/pr-preview/pr-494/engine_2include_2cubos_2engine_2renderer_2light_8hpp.html @@ -0,0 +1,142 @@ + + + + + engine/renderer/light.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/renderer/light.hpp file +

+

Resource cubos::engine::AmbientLight and components cubos::engine::SpotLight, cubos::engine::DirectionalLight and cubos::engine::PointLight.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ struct cubos::engine::AmbientLight +
+
Resource which stores the ambient light.
+
+ struct cubos::engine::SpotLight +
+
Component which makes an entity emit a spot light.
+
+ struct cubos::engine::DirectionalLight +
+
Component which makes an entity behave like a directional light.
+
+ struct cubos::engine::PointLight +
+
Component which makes an entity behave like a point light.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/engine_2samples_2assets_2bridge_2main_8cpp.html b/pr-preview/pr-494/engine_2samples_2assets_2bridge_2main_8cpp.html new file mode 100644 index 000000000..bfcf4d9e2 --- /dev/null +++ b/pr-preview/pr-494/engine_2samples_2assets_2bridge_2main_8cpp.html @@ -0,0 +1,121 @@ + + + + + assets/bridge/main.cpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ assets/bridge/main.cpp file +

+

A sample demonstrating how to create a custom asset bridge.

+ +

This sample demonstrates how we can create a custom asset bridge to load assets of a custom type. In this case, a bridge is created to load text files (.txt) as strings. The bridge is registered with the asset manager, and then a text file is loaded and printed to the console.

+
+

Classes

+
+
+ class TextBridge +
+
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/engine_2samples_2assets_2json_2main_8cpp.html b/pr-preview/pr-494/engine_2samples_2assets_2json_2main_8cpp.html new file mode 100644 index 000000000..ce5480681 --- /dev/null +++ b/pr-preview/pr-494/engine_2samples_2assets_2json_2main_8cpp.html @@ -0,0 +1,121 @@ + + + + + assets/json/main.cpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ assets/json/main.cpp file +

+

A sample demonstrating how to save and load JSON assets.

+ +

This sample demonstrates how we can use the JSONBridge to easily save and load serializable assets as JSON files. If we had a serializable asset and we wanted to store it as binary, we could simply replace the JSONBridge with a BinaryBridge and the sample would work the same way.

In this sample, we will be creating an asset of type MyAsset, saving it to a JSON file, and then loading it back from the file.

+
+

Classes

+
+
+ struct MyAsset +
+
A simple serializable type which we will be saving and loading.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/entity__manager_8hpp.html b/pr-preview/pr-494/entity__manager_8hpp.html new file mode 100644 index 000000000..aa5594f79 --- /dev/null +++ b/pr-preview/pr-494/entity__manager_8hpp.html @@ -0,0 +1,140 @@ + + + + + core/ecs/entity_manager.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/entity_manager.hpp file +

+

Class cubos::core::ecs::EntityManager and related types.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
+
+
+

Classes

+
+
+ class cubos::core::ecs::Entity +
+
Identifies an entity.
+
+ class cubos::core::ecs::EntityManager +
+
Holds and manages entities and their component masks.
+
+ class cubos::core::ecs::EntityManager::Iterator +
+
Used to iterate over all entities in a manager with a certain component mask.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/env__settings_2plugin_8hpp.html b/pr-preview/pr-494/env__settings_2plugin_8hpp.html new file mode 100644 index 000000000..90144bd3e --- /dev/null +++ b/pr-preview/pr-494/env__settings_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/env_settings/plugin.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/env_settings/plugin.hpp file +

+

Plugin entry point.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Functions

+
+
+ void envSettingsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/environment_8hpp.html b/pr-preview/pr-494/environment_8hpp.html new file mode 100644 index 000000000..a682ce836 --- /dev/null +++ b/pr-preview/pr-494/environment_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/renderer/environment.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/renderer/environment.hpp file +

+

Resource cubos::engine::RendererEnvironment.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ struct cubos::engine::RendererEnvironment +
+
Resource which stores the renderer's ambient light and sky colors.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/event__pipe_8hpp.html b/pr-preview/pr-494/event__pipe_8hpp.html new file mode 100644 index 000000000..7f66c0e4f --- /dev/null +++ b/pr-preview/pr-494/event__pipe_8hpp.html @@ -0,0 +1,133 @@ + + + + + core/ecs/event_pipe.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/event_pipe.hpp file +

+

Resource cubos::core::ecs::EventPipe.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
+
+
+

Classes

+
+
+
template<typename T>
+ class cubos::core::ecs::EventPipe +
+
Resource which stores events of type T.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/event__reader_8hpp.html b/pr-preview/pr-494/event__reader_8hpp.html new file mode 100644 index 000000000..125d85698 --- /dev/null +++ b/pr-preview/pr-494/event__reader_8hpp.html @@ -0,0 +1,137 @@ + + + + + core/ecs/event_reader.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/event_reader.hpp file +

+

Class cubos::core::ecs::EventReader.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
+
+
+

Classes

+
+
+
template<typename T, unsigned int M = DEFAULT_FILTER_MASK>
+ class cubos::core::ecs::EventReader +
+
System arguments used to read events of type T.
+
+ class cubos::core::ecs::EventReader::Iterator +
+
Used to iterate over events received by a reader.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/event__writer_8hpp.html b/pr-preview/pr-494/event__writer_8hpp.html new file mode 100644 index 000000000..704725b78 --- /dev/null +++ b/pr-preview/pr-494/event__writer_8hpp.html @@ -0,0 +1,133 @@ + + + + + core/ecs/event_writer.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/event_writer.hpp file +

+

Class cubos::core::ecs::EventWriter.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
+
+
+

Classes

+
+
+
template<typename T>
+ class cubos::core::ecs::EventWriter +
+
System argument which allows the system to send events of type T to other systems.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/examples-core-logging.html b/pr-preview/pr-494/examples-core-logging.html new file mode 100644 index 000000000..a1582a1bc --- /dev/null +++ b/pr-preview/pr-494/examples-core-logging.html @@ -0,0 +1,116 @@ + + + + + Examples » Core » Logging | CUBOS. + + + + + + + +
+
+
+
+
+

+ Examples » + Core » + Logging +

+

Using the logging system.

+

Logging in CUBOS. is done through the logging macros defined in core/log.hpp.

#include <cubos/core/log.hpp>

Before any logging is done, the logger must be initialized. This usually happens right at the beginning of the program.

int main()
+{
+    cubos::core::initializeLogger();

There are six logging levels, each with its own macro. In order of increasing severity, they are:

    CUBOS_TRACE("Trace message");
+    CUBOS_DEBUG("Debug message");
+    CUBOS_INFO("Info message");
+    CUBOS_WARN("Warning message");
+    CUBOS_ERROR("Error message");
+    CUBOS_CRITICAL("Critical message");

These macros can also take arguments:

    CUBOS_ERROR("Error message with {} argument", 1);

Serializable types can also be logged, using cubos::core::data::Debug.

#include <cubos/core/data/debug_serializer.hpp>
+
+using namespace cubos::core::data;

By wrapping the value in cubos::core::data::Debug, the type is serialized using the cubos::core::data::DebugSerializer, and the result is logged.

    CUBOS_INFO("Serializable type: {}", Debug(glm::vec3(0.0F, 1.0F, 2.0F)));
+    CUBOS_INFO("Again, but with type information: {:t}", Debug(glm::vec3(0.0F, 1.0F, 2.0F)));
+    CUBOS_INFO("Since unordered maps are serializable, we can do this: {}",
+               Debug((std::unordered_map<int, const char*>{{1, "one"}, {2, "two"}})));
+}
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/examples-core.html b/pr-preview/pr-494/examples-core.html new file mode 100644 index 000000000..60ea4c589 --- /dev/null +++ b/pr-preview/pr-494/examples-core.html @@ -0,0 +1,102 @@ + + + + + Examples » Core | CUBOS. + + + + + + + +
+
+
+
+
+

+ Examples » + Core +

+

Showcases features of the Core library.

+

Fully documented examples

The following examples have fully documented tutorials:

  • Logging - Using the logging system.

Undocumented examples

The following examples are not yet documented, but may still be useful to learn some of the features:

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/examples-engine.html b/pr-preview/pr-494/examples-engine.html new file mode 100644 index 000000000..af84c208d --- /dev/null +++ b/pr-preview/pr-494/examples-engine.html @@ -0,0 +1,102 @@ + + + + + Examples » Engine | CUBOS. + + + + + + + +
+
+
+
+
+

+ Examples » + Engine +

+

Showcases features of the Engine library.

+

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/examples.html b/pr-preview/pr-494/examples.html new file mode 100644 index 000000000..f4c814145 --- /dev/null +++ b/pr-preview/pr-494/examples.html @@ -0,0 +1,101 @@ + + + + + Examples | CUBOS. + + + + + + + +
+
+
+
+
+

+ Examples +

+

Contains examples of specific features of the libraries.

+

If you are just starting out, you should probably start by the engine examples. These cover the actual user-facing features, and are a good place to get a feel for how using the engine looks like, while the core examples are more directed at engine developers trying to understand how specific low-level features are used.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/favicon-dark.png b/pr-preview/pr-494/favicon-dark.png new file mode 100644 index 000000000..c2498580c Binary files /dev/null and b/pr-preview/pr-494/favicon-dark.png differ diff --git a/pr-preview/pr-494/features-ecs.html b/pr-preview/pr-494/features-ecs.html new file mode 100644 index 000000000..87e9440f5 --- /dev/null +++ b/pr-preview/pr-494/features-ecs.html @@ -0,0 +1,172 @@ + + + + + Feature Guide » ECS | CUBOS. + + + + + + + + +
+
+
+
+
+

+ Feature Guide » + ECS +

+

What is an ECS and how it's used in CUBOS.

+

Wikipedia defines ECS as:

Entity Component System (ECS) is a software architectural pattern mostly used in video game development for the representation of game world objects. An ECS comprises entities composed from components of data, with systems which operate on entities' components.

ECS follows the principle of composition over inheritance, meaning that every entity is defined not by a type hierarchy, but by the components that are associated with it. Systems act globally over all entities which have the required components.

The ECS thus is a vital part of the engine, since all of the rest is structured around it in some way. This sets the engine apart from other engines which follow a more traditional model, like Unity, Unreal and Godot.

A primer on ECS

Why are we using this?

ECS is a powerful pattern which has been becoming more popular over the years, and even Unity has started integrating it into its engine. The main advantages are flexibility and performance: it avoids a lot of the problems that come with traditional object-oriented programming, and regarding performance, it excels in situations where the number of entities is high, since it makes use of cache locality. Its also easier to parallelize the systems, since they have clearly defined dependencies.

Our implementation

CUBOS. ECS contains the following concepts:

  • World - the main object that holds all of the ECS state.
  • Entities - represent objects in the game world (e.g. a car, a player, a tree).
  • Components - data associated with an entity (e.g. Position, Rotation).
  • Resources - singleton-like objects which are stored per world and which do not belong to a specific entity (e.g. DeltaTime, Input).
  • Systems - functions which operate on resources and entities' components. This is where the logic is implemented.
  • Dispatcher - decides when each system is called and knows which systems are independent from each other so they can be called at the same time (parallel computing).

On the engine side, the Dispatcher is not exposed. Instead, the Cubos class is used to add systems and specify when they should be called.

One important thing to note is that in an ECS the data is completely decoupled from the logic. What this means is that entities and components do not and should not possess any functionality other than storing data. All of the logic is relegated to the systems.

How do we use it?

Lets say we want to have multiple objects with positions and velocities, and every frame we want to add their velocities to their positions.

In a traditional object-oriented approach, we would have something along the lines of:

class MyObject : public GameObject
+{
+public:
+    // ...
+
+    virtual void update(float deltaTime) override
+    {
+        this->position += this->velocity * deltaTime;
+    }
+
+private:
+    glm::vec3 position;
+    glm::vec3 velocity;
+}

In CUBOS. there are no game objects. Instead, we would define two components and a DeltaTime resource:

struct [[cubos::component("position")]] Position
+{
+    glm::vec3 vec = { 0.0f, 0.0f, 0.0f };
+};
+
+struct [[cubos::component("velocity")]] Velocity
+{
+    glm::vec3 vec = { 0.0f, 0.0f, 0.0f };
+};
+
+struct DeltaTime
+{
+    float value = 0.0f;
+};

So, where does the update logic belong? We put it in a system. Systems are functions whose arguments are of certain types, which you can read more about in the ECS module page.

To access a resource, we use the Read and Write arguments. In this case, we won't be modifying the delta time, so we will use Read<DeltaTime>. To access entities and their components, we use the Query argument. In this case we we want to access all entities with both positions and velocities, and modify their positions, so we will use Query<Write<Position>, Read<Velocity>>.

void velocitySystem(
+    Read<DeltaTime> dt,
+    Query<Write<Position>, Read<Velocity>> query)
+{
+    for (auto [entity, position, velocity] : query)
+    {
+        position->vec += velocity->vec * dt->value;
+    }
+}

We can then iterate over all queried entities and update their positions using their velocities and the delta time.

Going further

Registering resources and components

Before components and resources are used in a World, they must be registered on it. This should be done once, at the start of the program. For example, using the CUBOS. main class, for the previous example we would write:

cubos.addComponent<Position>();
+cubos.addComponent<Velocity>();
+cubos.addResource<DeltaTime>();

Commands

When you have direct access to the World, you can manipulate entities directly:

auto entity = world.create(Position {}, Velocity {});
+world.removeComponent<Velocity>(entity);
+world.addComponent(entity, Dead {});
+world.destroy(entity);

If necessary, you can access the world in a system through the arguments Read<World> or Write<World>. However, this is not recommended, since it becomes impossible for the dispatcher to know what the system is accessing, and thus it cannot parallelize it.

Instead, you should use the Commands argument. Through it you can queue operations to be executed at a later time, when its safe to do so.

Imagine we want to have spawners which create new entities on their position and then destroy themselves. We can implement this with a system like this:

void spawnerSystem(
+    Commands commands,
+    Query<Read<Spawner>, Read<Position>> spawners)
+{
+    for (auto [entity, spawner, position] : spawners)
+    {
+        commands.create(
+            Position { position->vec },
+            Velocity { glm::vec3(0.0f, 0.0f, 1.0f )}
+        );
+        commands.destroy(entity);
+    }
+}

This system iterates over all entities with Spawner and Position components. It creates new entities on their positions with a velocity of (0, 0, 1), and then destroys the spawner entity. The entities are only actually created and destroyed later on, when the commands are executed.

Blueprints

A common pattern in game engines is to have a way to create entities in bundles, such as Unity's prefabs. In CUBOS. we call these blueprints. A blueprint is a set of entities and their components, which can be spawned into the world as many times as needed.

For example, if we wanted to create a blueprint for a motorbike with two wheels:

auto motorbike = ecs::Blueprint();
+auto body = motorbike.create("body", Position{...}, ...);
+motorbike.create("front_wheel", Parent{body}, ...);
+motorbike.create("back_wheel", Parent{body}, ...);

To spawn the blueprint into the world:

// You can just spawn the bike as is.
+commands.spawn(motorbike);
+
+// Lets say we want to spawn the bike in a different position.
+// You can override components of the spawned entities.
+commands
+    .spawn(motorbike)
+    .add("body", Position{...});

Merging blueprints

It's possible to merge a blueprint into another one. Lets say we have a blueprint for the wheels of the motorbike:

auto wheel = ecs::Blueprint();
+wheel.create("wheel", ...);

When creating the motorbike blueprint, we can merge the wheel blueprint into it:

auto motorbike = ecs::Blueprint();
+auto body = motorbike.create("body", Position{...}, ...);
+motorbike.merge("front", wheel);
+motorbike.merge("back", wheel);

When spawning the motorbike blueprint, the entities of the wheel blueprint will be accessible with the prefix we gave them:

commands
+    .spawn(motorbike)
+    .add("front.wheel", ...)
+    .add("back.wheel", ...);
+
Feature Guide | Plugins »
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/features-plugins.html b/pr-preview/pr-494/features-plugins.html new file mode 100644 index 000000000..ef6c8393e --- /dev/null +++ b/pr-preview/pr-494/features-plugins.html @@ -0,0 +1,142 @@ + + + + + Feature Guide » Plugins | CUBOS. + + + + + + + + + +
+
+
+
+
+

+ Feature Guide » + Plugins +

+

What are plugins and how they can be used to organize your code.

+

Configuring the engine

Plugins are a feature of the cubos::engine::Cubos class. This class is the main thing you'll be interacting with when developing a game with CUBOS.. It is used to configure the engine and run the game loop. Through it, you can register new components, resources and configure systems to be run on specific conditions.

An application which just prints "Hello World!" and which does absolutely nothing else - not even open a window - would look like this:

#include <cubos/engine/cubos.hpp>
+
+#include <iostream>
+
+using Cubos = cubos::engine::Cubos;
+
+void helloWorld()
+{
+    std::cout << "Hello World!" << std::endl;
+}
+
+int main()
+{
+    Cubos cubos;
+    cubos.startupSystem(helloWorld);
+    cubos.run();
+}

What are plugins?

If you had to add every system, component and resource to your game's main source file, it would quickly become a mess. Plugins are just functions which receive a reference to the Cubos class. Nothing more.

The idiomatic way to use plugins is through the Cubos::addPlugin method. It receives a plugin function, and executes it only if it hasn't been executed before. This property is useful for solving dependency issues between plugins. For example, if B and C adds A and D adds B and C, you would be adding A twice.

If we were to put the hello world functionality on a plugin, the previous example would look like this:

#include <cubos/engine/cubos.hpp>
+
+#include <iostream>
+
+using Cubos = cubos::engine::Cubos;
+
+void helloWorld()
+{
+    std::cout << "Hello World!" << std::endl;
+}
+
+void helloWorldPlugin(Cubos& cubos)
+{
+    cubos.startupSystem(helloWorld);
+}
+
+int main()
+{
+    Cubos cubos;
+    cubos.addPlugin(helloWorldPlugin);
+    cubos.run();
+}

What plugins are there?

The engine is basically a big bundle of plugins which add all of kinds of functionality. You can find an exhaustive list of the plugins provided by the engine and their documentation on the engine module page. Check out the engine examples to see how they are used in practice.

+
« ECS | Feature Guide | Quadrados »
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/features-quadrados.html b/pr-preview/pr-494/features-quadrados.html new file mode 100644 index 000000000..4f960dfa3 --- /dev/null +++ b/pr-preview/pr-494/features-quadrados.html @@ -0,0 +1,170 @@ + + + + + Feature Guide » Quadrados | CUBOS. + + + + + + + + +
+
+
+
+
+

+ Feature Guide » + Quadrados +

+

How to use the Quadrados CLI tool.

+

Quadrados is the CLI tool used to work with CUBOS. At the moment, it contains the following commands:

  • quadrados help - shows the help message;
  • quadrados convert - converts a .qb voxel file into the internal format used by CUBOS., .grd and .pal.
  • quadrados embed - utility used to embed files directly into an executable for use with the EmbeddedArchive.
  • quadrados generate - generates component definition boilerplate code.

Convert

The need for this tool arose from the fact that CUBOS. works with a single palette of voxel materials, and voxel objects refer to specific materials by their index in this palette. For example, if we had a single voxel red object, the red color wouldn't be specified in the voxel object. Instead, this object would specify that its material is 1, and the palette would specify that the material 1 is red.

The issue is, voxel formats like .qb and .vox are not designed to store only the indices of materials, but the whole material definition, per voxel. This conflicts with the way CUBOS. works, so we need to convert these formats into the internal format used by CUBOS.. This is where quadrados convert comes in. It takes a .qb voxel file and splits it into a palette (.pal), and one or more voxel grids (.grd).

Usage

This guide will be based on four use cases:

  1. loading a .qb file and creating a new .pal;
  2. loading a .qb file and updating an existing .pal;
  3. loading a .qb file and using, without editing, an existing .pal;
  4. querying the contents of .qb model;

Example 1: Creating a new palette

This use case is most common when importing the first .qb file for a new project. There is no palette file yet, so we need to create one. Lets say the model we want to convert is a car.qb, which contains a single voxel object.

$ quadrados convert car.qb -p main.pal -g car.grd -w

First, we specify the .qb file to convert. Then, we specify the name of the palette we will be outputting. We also need to specify the output file for the voxel grid. Finally, we pass the -w flag which allows us to write to the palette file (which is necessary since there is none at the moment).

Example 2: Updating an existing palette

Lets say we now want to import a street.qb model which contains two voxel grids: the first one is a road and the second one is a tree. Since we already have a palette, we want to add any new materials to it.

$ quadrados convert street.qb -p main.pal -g0 road.grd -g1 tree.grd -w

Once again, we first specify the .qb file to convert. Then, we specify the name of the palette we will be using, which is the same as the one we created in the previous example. This time, we have two grids in the .qb file, so we need to specify the output files for both. This is done by adding an index in front of -g (e.g. -g0 for the first grid, -g1 for the second). Finally, we once again pass the -w flag which allows the palette file to be updated.

Example 3: Using an existing palette

What if we want to add another car model, but without adding materials to the palette? To do this, we will need to ommit the -w flag. This way, the palette will be read, and the most similar materials found will be used. By default, this will only succeed if the materials match exactly.

$ quadrados convert car2.qb -p main.pal -g car2.grd

If this fails, you may see the error message:

Failed to convert grid 0 from its palette to the palette chosen.

One work around is lowering the threshold for material matching. If you want to allow for slightly different materials to be considered as the same, you can pass the -s <SIMILARITY> option. This value is a number from 0 to 1, where 0 is completely different and 1 is completely the same. It represents the minimum similarity between two materials to consider them the same (default is 1).

So, if the materials which aren't matching are very similar, you could add, for example, -s 0.9 to the previous command. This way, the material chosen from the palette will have a similarity of at least 0.9 with the material in the original model.

Example 4: Querying the contents of a model

You may want to check the contents of a .qb file before converting it. One easy way to do this is to use the -v (verbose) flag. This can be added to any of the previous commands to get extra information about what is going on.

It can also be used without any other options, in which case the program will just print the contents of the .qb file. For example:

$ quadrados convert car.qb -v
+Found 1 QB matrices.
+Matrix 0:
+- Position: -7 -5 -16
+- Grid size: 15x11x32
+- Palette size: 10

This tells us that the car.qb model contains exactly one voxel grid, that its position within the model is (-7, -5, -16), that its size is 15x11x32, and that it uses 10 different materials.

Embed

The quadrados embed tool is used to embed files directly into an executable for use with the cubos::core::data::EmbeddedArchive. This is useful for example when you want to ship a game with a set of assets, but don't want to have to distribute them as separate files. This way, you are able to ship a single executable file.

Usage

This tool takes a file and generates a C++ source file which registers data to be used with cubos::core::data::EmbeddedArchive, outputting the code to the standard output. This source file can then be compiled and linked with your executable.

If no name is specified, the name of the file will be used. For example, if you run quadrados embed logo.png > logo.cpp, the name of the registered data will be logo.png.

The data can then be mounted like this:

#include <cubos/core/data/fs/file_system.hpp>
+#include <cubos/core/data/fs/embedded_archive.hpp>
+
+int main()
+{
+    using namespace cubos::core::data;
+
+    FileSystem::mount("/logo.png", std::make_shared<EmbeddedArchive>("logo.png"));
+
+    // ...
+
+    return 0;
+}

It's also possible to embed a whole directory, in which case you will need to use the -r flag. This will recursively embed all files in the directory.

Checkout the embedded_archive sample for a complete example.

Generate

For a type to be usable as a component, it must satisfy the following requirements:

  • it must be (de)serializable, taking optionally some context necessary (such as the mapping between Entitys and their IDs, or a function to read or write handles).
  • it must define a storage type, which will then be used to store the component's data in the World.
  • it must call the CUBOS_REGISTER_COMPONENT macro, passing the ID of the component type, which associates the type with a unique ID.

This means that, before quadrados generate, component definitions looked like:

struct MyComponent
+{
+    int x;
+    float y;
+    std::string z;
+};
+
+// The serialization functions must be defined in this namespace.
+namespace cubos::core::data
+{
+    inline static void serialize(Serializer& s, const MyComponent& c, const char* name)
+    {
+        s.beginObject(name);
+        s.write(c.x);
+        s.write(c.y);
+        s.write(c.z);
+        s.endObject();
+    }
+
+    inline static void deserialize(Deserializer& d, MyComponent& c)
+    {
+        d.beginObject();
+        d.read(c.x);
+        d.read(c.y);
+        d.read(c.z);
+        d.endObject();
+    }
+}
+
+// The storage type must be defined in this namespace.
+namespace cubos::core::ecs
+{
+    template <>
+    struct ComponentStorage<MyComponent>
+    {
+        using Type = VecStorage<MyComponent>;
+    };
+}
+
+CUBOS_REGISTER_COMPONENT(MyComponent, "my_component");

This amount of boilerplate is not acceptable, specially for user-facing code. The quadrados generate command makes use of a recent C++ feature called attributes. Attributes are usually used to provide hints to the compiler. However, on our case, we're using them to mark types as components.

With quadrados generate, the same component definition can be written as:

// Must be included in the file where the component is defined.
+#include <components/base.hpp>
+
+struct [[cubos::component("my_component", VecStorage)]] MyComponent
+{
+    int x;
+    float y;
+    std::string z;
+};

This tool then searches for all types marked with the cubos::component and generates a header file for each one. In this case, a header file would be generated which could be included with #include <components/my_component.hpp>.

When using the component, the user must include the generated header file, and not the original one. Otherwise, the compiler won't see the generated code.

If the component is identified with a slash, as, for example, game/my_component, the generated header file will be placed in the components/game directory. This is useful for organizing components into different modules. For example, cubos-engine names all its components with the cubos/ directory.

CMake

This tool can be configured to run automatically when building the project. To do this, you can include the QuadradosGenerate module in your CMakeLists.txt and call the quadrados_generate function with your target and the directory where the base component headers are located.

include(QuadradosGenerate)
+
+quadrados_generate(my_target ${CMAKE_CURRENT_SOURCE_DIR}/components)
+
« Plugins | Feature Guide
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/features.html b/pr-preview/pr-494/features.html new file mode 100644 index 000000000..4eb7a1b43 --- /dev/null +++ b/pr-preview/pr-494/features.html @@ -0,0 +1,100 @@ + + + + + Feature Guide | CUBOS. + + + + + + + +
+
+
+
+
+

+ Feature Guide +

+

This is a brief introduction to the CUBOS. engine and its features. Before diving into the documentation of each class and function, it's recommended to read through this guide.

Overview

The CUBOS. engine is divided into two libraries: Core and Engine. Each library has its own namespace, which corresponds to a sub-folder in the include path.

Core provides platform abstraction, containers, utilities, and the ECS module. Engine builds on top of Core and provides higher-level features such as rendering and collisions.

The core library is divided into modules, each of which covers a specific area of functionality. For example, graphics-related functionality is on the cubos::core::gl namespace, under the include path cubos/core/gl.

The engine library is divided into plugins, each of which extends the engine's functionality in some way. You'll learn more about plugins below. For each plugin, there is a corresponding directory in the include path. Categories of plugins are also divided into sub-folders, with their own namespaces.

Tooling

Other than the core and engine libraries, the project also contains Quadrados and Tesseratos. Quadrados is a CLI tool which contains utilities used during game development. Tesseratos is our in-house editor, which is still in its early stages of development.

Learn more

The following guides explain basic concepts of the engine. Its recommend to read through these first to understand the overall principles and only then dive into the documentation of each class and function.

  • ECS - What is an ECS and how it's used in CUBOS.
  • Plugins - What are plugins and how they can be used to organize your code.
  • Quadrados - How to use the Quadrados CLI tool.

What we don't have and where are we going

The engine is still in its early stages of development, and thus we're missing a lot of features. For example, we don't have physics yet, and the editor tools are very barebones - you can't even load a scene from a file yet. There's no scripting language, thus you will have to write all your game logic in C++.

Making a game with the engine is still very painful. Our goal is to make CUBOS. usable for game jams by people who are not on the team. This means a lot of work, but we're confident we can get there.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/file__settings_2plugin_8hpp.html b/pr-preview/pr-494/file__settings_2plugin_8hpp.html new file mode 100644 index 000000000..380236a55 --- /dev/null +++ b/pr-preview/pr-494/file__settings_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/file_settings/plugin.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/file_settings/plugin.hpp file +

+

Plugin entry point.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Functions

+
+
+ void fileSettingsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/file__stream_8hpp.html b/pr-preview/pr-494/file__stream_8hpp.html new file mode 100644 index 000000000..f4391be04 --- /dev/null +++ b/pr-preview/pr-494/file__stream_8hpp.html @@ -0,0 +1,133 @@ + + + + + core/data/fs/file_stream.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/data/fs/file_stream.hpp file +

+

Class cubos::core::data::FileStream.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::data
+
Data module.
+
+
+
+

Classes

+
+
+
template<typename T>
+ class cubos::core::data::FileStream +
+
Wrapper around an implementation-specific file stream which keeps the file alive and does some sanity checks.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/file__system_8hpp.html b/pr-preview/pr-494/file__system_8hpp.html new file mode 100644 index 000000000..a2dfcbba7 --- /dev/null +++ b/pr-preview/pr-494/file__system_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/data/fs/file_system.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/data/fs/file_system.hpp file +

+

Class cubos::core::data::FileSystem.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::data
+
Data module.
+
+
+
+

Classes

+
+
+ class cubos::core::data::FileSystem +
+
Singleton which represents the virtual file system of the engine.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/files.html b/pr-preview/pr-494/files.html new file mode 100644 index 000000000..f90c08e40 --- /dev/null +++ b/pr-preview/pr-494/files.html @@ -0,0 +1,372 @@ + + + + + CUBOS. + + + + + + + +
+
+
+
+
+

Files

+ + +
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/frame_8hpp.html b/pr-preview/pr-494/frame_8hpp.html new file mode 100644 index 000000000..2c8c6952d --- /dev/null +++ b/pr-preview/pr-494/frame_8hpp.html @@ -0,0 +1,134 @@ + + + + + engine/renderer/frame.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/renderer/frame.hpp file +

+

Resource cubos::engine::RendererFrame.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::RendererFrame +
+
Resource which describes a scene to be drawn by the renderer.
+
+ struct cubos::engine::RendererFrame::DrawCmd +
+
Data of a single draw command.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/getting-started.html b/pr-preview/pr-494/getting-started.html new file mode 100644 index 000000000..15f3dd0ab --- /dev/null +++ b/pr-preview/pr-494/getting-started.html @@ -0,0 +1,101 @@ + + + + + Getting started | CUBOS. + + + + + + + +
+
+
+
+
+

+ Getting started +

+

How to download, build and run the engine and where to go from there.

+

Building the engine from source

Getting the code

The CUBOS. source code is hosted on GitHub, so the easiest and only way to get the code right now is to clone the repository with git.

Dependencies

The following dependencies are used to compile CUBOS.:

NameImportanceSubmodule PathInstalled Separately
CMakeEssential-Yes
jsonEssential-No
gladEssential-No
glfwEssentialcore/lib/glfwOptionally
glmEssentialcore/lib/glmOptionally
fmtEssentialcore/lib/fmtOptionally
spdlogEssentialcore/lib/spdlogOptionally
stduuidEssentialcore/lib/stduuidNo
doctestRequired for testscore/lib/doctestOptionally

Dependencies marked as Essential are required to compile the engine. If they are installed separately, you must first install them manually. If they're not, it means they come as submodules and you can install them with the engine by cloning the whole repository with the --recursive flag. If you've already cloned the repository, you can install them by running the following command from the root directory of the repository:

git submodule update --init --recursive

Compiling

If you chose to install some dependencies separately, you must pass the corresponding -D flag to CMake. For example, if you installed GLFW, GLM and CMake separately you would pass the following flags to CMake:

cmake -H. -Bbuild -DGLFW_USE_SUBMODULE=OFF -DGLM_USE_SUBMODULE=OFF

If you are using submodules, you can simply run the following command from the root directory of the repository:

cmake -H. -Bbuild

The following is a list of all the options available to configure the engine:

NameDescription
WITH_GLFWUse GLFW? (Required for now)
WITH_OPENGLUse OpenGL? (Required for now)
GLFW_USE_SUBMODULECompile glfw from source?
GLM_USE_SUBMODULECompile glm from source?
DOCTEST_USE_SUBMODULECompile doctest from source?
SPDLOG_USE_SUBMODULECompile spdlog from source?
FMT_USE_SUBMODULECompile fmt from source?
BUILD_CORE_SAMPLESBuild CUBOS. core samples?
BUILD_CORE_TESTSBuild CUBOS. core tests?
BUILD_ENGINE_SAMPLESBuild CUBOS. engine samples?
BUILD_ENGINE_TESTSBuild CUBOS. engine tests?
BUILD_DOCUMENTATIONBuild the documentation?
ENABLE_COVERAGEEnable code coverage? (GCC only)
FIX_CLANG_TIDY_ERRORSFix clang-tidy errors automatically?

Running the examples and tests

Examples

Both the core and the engine contain examples which you can run to check if things are running correctly. To build them, you must enable the BUILD_CORE_SAMPLES and/or BUILD_ENGINE_SAMPLES options.

Testing

CUBOS. uses doctest for unit testing the engine. To build them, you must enable the BUILD_CORE_TESTS and/or BUILD_ENGINE_TESTS options.

Whats next?

We recommend you start by reading the feature guide, which introduces you to important concepts and features of the engine, such as what is an ECS and how it is used in CUBOS..

The examples page is also a good place to go if you want to see how specific parts of the engine are used in practice.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/grid_8hpp.html b/pr-preview/pr-494/grid_8hpp.html new file mode 100644 index 000000000..efe38bfd7 --- /dev/null +++ b/pr-preview/pr-494/grid_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/gl/grid.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/gl/grid.hpp file +

+

Class cubos::core::gl::Grid.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::gl
+
Graphics module.
+
namespace cubos::core::data
+
Data module.
+
+
+
+

Classes

+
+
+ class cubos::core::gl::Grid +
+
Represents a voxel object using a 3D grid.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__asset-explorer-tool-plugin.html b/pr-preview/pr-494/group__asset-explorer-tool-plugin.html new file mode 100644 index 000000000..7e51c5135 --- /dev/null +++ b/pr-preview/pr-494/group__asset-explorer-tool-plugin.html @@ -0,0 +1,153 @@ + + + + + Engine » Tools » Asset explorer module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Tools » + Asset explorer module

+

Allows viewing and selecting assets through a ImGui window.

+ +

Events

Dependencies

+
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Functions

+
+
+ void assetExplorerPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void assetExplorerPlugin(Cubos& cubos) +
#include <engine/tools/asset_explorer/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__assets-plugin.html b/pr-preview/pr-494/group__assets-plugin.html new file mode 100644 index 000000000..3b990beaf --- /dev/null +++ b/pr-preview/pr-494/group__assets-plugin.html @@ -0,0 +1,293 @@ + + + + + Engine » Assets module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Assets module

+

Adds asset management to CUBOS.

+ +

Settings

  • assets.io.enabled - whether asset I/O should be done (default: true).
  • assets.io.path - path to the assets directory - will be mounted to /assets/ (default: assets/).
  • assets.io.readOnly - if true, the assets directory will be mounted as read-only (default: true).

Events

  • AssetEvent - (TODO) emitted when an asset is either loaded, modified or unloaded.

Resources

  • Assets - the asset manager, used to access asset data.

Startup tags

  • cubos.assets.init - initializes the assets manager and loads the meta files (after cubos.settings).
  • cubos.assets.bridge - systes which add bridges to the asset manager should be tagged with this.
  • cubos.assets - systems which load assets should be tagged with this.

Tags

  • cubos.assets.cleanup - frees any assets no longer in use.
+
+

Files

+
+
file asset.hpp
+
Classes cubos::engine::AnyAsset and cubos::engine::Asset.
+
file assets.hpp
+
Resource cubos::engine::Assets.
+
file bridge.hpp
+
Class cubos::engine::AssetBridge.
+
file binary.hpp
+
Class cubos::engine::BinaryBridge.
+
file file.hpp
+
Class cubos::engine::FileBridge.
+
file json.hpp
+
Class cubos::engine::JSONBridge.
+
file meta.hpp
+
Class cubos::engine::AssetMeta.
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Classes

+
+
+ class cubos::engine::AnyAsset +
+
Handle to an asset of any type. May either be weak or strong. Weak handles do not guarantee the asset is loaded, while strong handles do.
+
+
template<typename T>
+ class cubos::engine::Asset +
+
Handle to an asset of a specific type.
+
+ class cubos::engine::Assets +
+
Resource which manages all assets. Responsible for loading and unloading assets, storing them in memory, and providing access to them.
+
+ class cubos::engine::AssetBridge +
+
Bridges are the objects responsible for loading and saving assets from/to disk. They form the bridge between the asset manager and the virtual file system.
+
+
template<typename T>
+ class cubos::engine::BinaryBridge +
+
Bridge for loading and saving assets which are serialized to and from a binary file.
+
+ class cubos::engine::FileBridge +
+
Abstract bridge type defined to reduce boilerplate code in bridge implementations which open a single file to load and save assets.
+
+
template<typename T>
+ class cubos::engine::JSONBridge +
+
Bridge for loading and saving assets which are serialized to and from a JSON file.
+
+ class cubos::engine::AssetMeta +
+
Stores metadata about an asset - the data stored in .meta files. Each asset has a corresponding meta object, which contains load or import parameters.
+
+
+
+

Typedefs

+
+
+ using AssetMetaRead = core::memory::ReadGuard<AssetMeta, std::shared_lock<std::shared_mutex>> +
+
Read-only guard for an asset's metadata.
+
+ using AssetMetaWrite = core::memory::WriteGuard<AssetMeta, std::unique_lock<std::shared_mutex>> +
+
Read-write guard for an asset's metadata.
+
+
template<typename T>
+ using AssetRead = core::memory::ReadGuard<T, std::shared_lock<std::shared_mutex>> +
+
Read-only guard for an asset's data.
+
+
template<typename T>
+ using AssetWrite = core::memory::WriteGuard<T, std::unique_lock<std::shared_mutex>> +
+
Read-write guard for an asset's data.
+
+
+
+

Functions

+
+
+ void assetsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Typedef documentation

+
+

+ using AssetMetaRead = core::memory::ReadGuard<AssetMeta, std::shared_lock<std::shared_mutex>> +
#include <engine/assets/assets.hpp>
+

+

Read-only guard for an asset's metadata.

+
+
+

+ using AssetMetaWrite = core::memory::WriteGuard<AssetMeta, std::unique_lock<std::shared_mutex>> +
#include <engine/assets/assets.hpp>
+

+

Read-write guard for an asset's metadata.

+
+
+

+
#include <engine/assets/assets.hpp>
+
+ template<typename T> +
+ using AssetRead = core::memory::ReadGuard<T, std::shared_lock<std::shared_mutex>> +

+

Read-only guard for an asset's data.

+ + + + + + + + + + +
Template parameters
TThe type of the data to guard.
+
+
+

+
#include <engine/assets/assets.hpp>
+
+ template<typename T> +
+ using AssetWrite = core::memory::WriteGuard<T, std::unique_lock<std::shared_mutex>> +

+

Read-write guard for an asset's data.

+ + + + + + + + + + +
Template parameters
TThe type of the data to guard.
+
+
+
+

Function documentation

+
+

+ void assetsPlugin(Cubos& cubos) +
#include <engine/assets/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__collisions-plugin.html b/pr-preview/pr-494/group__collisions-plugin.html new file mode 100644 index 000000000..3b879506e --- /dev/null +++ b/pr-preview/pr-494/group__collisions-plugin.html @@ -0,0 +1,197 @@ + + + + + Engine » Collisions module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Collisions module

+

Adds collision detection to CUBOS.

+ +

Components

Events

  • CollisionEvent - (TODO) emitted when a collision occurs.
  • TriggerEvent - (TODO) emitted when a trigger is entered or exited.

Resources

Tags

  • cubos.collisions.aabb.missing - missing aabb colliders are added.
  • cubos.collisions.aabb - collider aabbs are updated.
  • cubos.collisions.broad.markers - sweep markers are updated.
  • cubos.collisions.broad.sweep - sweep is performed.
  • cubos.collisions.broad - broad phase collision detection.
  • cubos.collisions - collisions are resolved.

Dependencies

+
+

Files

+
+
file aabb.hpp
+
Component cubos::engine::ColliderAABB.
+
file broad_phase_collisions.hpp
+
Resource cubos::engine::BroadPhaseCollisions.
+
file box.hpp
+
Component cubos::engine::BoxCollider.
+
file capsule.hpp
+
Component cubos::engine::CapsuleCollider.
+
file plane.hpp
+
Component cubos::engine::PlaneCollider.
+
file simplex.hpp
+
Component cubos::engine::SimplexCollider.
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Classes

+
+
+ struct cubos::engine::ColliderAABB +
+
Component which stores the AABB of an entity with a collider component.
+
+ struct cubos::engine::BroadPhaseCollisions +
+
Resource which stores data used in broad phase collision detection.
+
+ struct cubos::engine::BoxCollider +
+
Component which adds a box collider to an entity.
+
+ struct cubos::engine::CapsuleCollider +
+
Component which adds a capsule collider to an entity.
+
+ struct cubos::engine::PlaneCollider +
+
Component which adds a plane collider to an entity.
+
+ struct cubos::engine::SimplexCollider +
+
Component which adds a simplex collider to an entity.
+
+
+
+

Functions

+
+
+ void collisionsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void collisionsPlugin(Cubos& cubos) +
#include <engine/collisions/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__core-al.html b/pr-preview/pr-494/group__core-al.html new file mode 100644 index 000000000..ba4ed02ba --- /dev/null +++ b/pr-preview/pr-494/group__core-al.html @@ -0,0 +1,151 @@ + + + + + Core » Audio module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Core » + Audio module

+

Provides audio functionality.

+ +
+

Files

+
+
file audio_device.hpp
+
Class cubos::core::al::AudioDevice and related types.
+
+
+
+

Typedefs

+
+
+ using Buffer = std::shared_ptr<impl::Buffer> +
+
Handle to an audio buffer.
+
+ using Source = std::shared_ptr<impl::Source> +
+
Handle to an audio source.
+
+
+
+

Typedef documentation

+
+

+ using Buffer = std::shared_ptr<impl::Buffer> +
#include <core/al/audio_device.hpp>
+

+

Handle to an audio buffer.

+ +
+
+

+ using Source = std::shared_ptr<impl::Source> +
#include <core/al/audio_device.hpp>
+

+

Handle to an audio source.

+ +
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__core-data-fs.html b/pr-preview/pr-494/group__core-data-fs.html new file mode 100644 index 000000000..125dfdb60 --- /dev/null +++ b/pr-preview/pr-494/group__core-data-fs.html @@ -0,0 +1,160 @@ + + + + + Core » Data » Filesystem module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Core » + Data » + Filesystem module

+

Provides filesystem utilities.

+ +
+

Files

+
+
file archive.hpp
+
Class cubos::core::data::Archive.
+
file embedded_archive.hpp
+
Class cubos::core::data::EmbeddedArchive.
+
file file.hpp
+
Class cubos::core::data::File.
+
file file_stream.hpp
+
Class cubos::core::data::FileStream.
+
file file_system.hpp
+
Class cubos::core::data::FileSystem.
+
file standard_archive.hpp
+
Class cubos::core::data::StandardArchive.
+
+
+
+

Classes

+
+
+ class cubos::core::data::Archive +
+
Interface for a bridge between the CUBOS. virtual file system and the real world.
+
+ class cubos::core::data::EmbeddedArchive +
+
Archive implementation which reads data embedded in the application. Meant to be used with the quadrados embed tool.
+
+ class cubos::core::data::File +
+
Represents a file in the virtual file system of the engine.
+
+
template<typename T>
+ class cubos::core::data::FileStream +
+
Wrapper around an implementation-specific file stream which keeps the file alive and does some sanity checks.
+
+ class cubos::core::data::FileSystem +
+
Singleton which represents the virtual file system of the engine.
+
+ class cubos::core::data::StandardArchive +
+
Archive implementation which reads and writes from/into the OS file system using the standard library.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__core-data.html b/pr-preview/pr-494/group__core-data.html new file mode 100644 index 000000000..82798189f --- /dev/null +++ b/pr-preview/pr-494/group__core-data.html @@ -0,0 +1,118 @@ + + + + + Core » Data module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Core » + Data module

+

Provides filesystem and serialization utilities.

+ +
+

Modules

+
+
module Filesystem
+
Provides filesystem utilities.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__core-ecs.html b/pr-preview/pr-494/group__core-ecs.html new file mode 100644 index 000000000..dfed4083d --- /dev/null +++ b/pr-preview/pr-494/group__core-ecs.html @@ -0,0 +1,404 @@ + + + + + Core » ECS module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Core » + ECS module

+

Entity Component System library.

+ +

This module is arguably the heart of the engine, as it provides a means to organize and manage the data and logic of both the engine and games built with it. It is, as of now, a bit of a mess. Most of the exposed types are internal to the documentation, and thus it can get hard to navigate (TODO #377).

Data types

  • World - stores entities, components and resources, can be queried.
  • Dispatcher - stores and dispatches systems in the right order.
  • Blueprint - bundle of entities and components which can be spawned using Commands.

System argument types

  • Read<R> - used to read resource data of type R.
  • Write<R> - used to write resource data of type R.
  • Read<World> - used to read the world directly (not recommended, ruins parallelism, prefer Commands).
  • Write<World> - used to write the world directly (not recommended, ruins parallelism, prefer Commands).
  • Commands - used to queue entities to be created, destroyed and other operations.
  • EventReader<E> - reads events of type E sent from other systems.
  • EventWriter<E> - sends events of type E to other systems.
  • Query<Args...> - queries the world for entities which match its arguments.

Query argument types

  • Read<C> - matches entities with the component C, read-only access.
  • Write<C> - matches entities with the component C, write access.
  • OptRead<C> - matches all entities, read-only access when the component C is present.
  • OptWrite<C> - matches all entities, write access when the component C is present.
+
+

Files

+
+
file accessors.hpp
+
Class cubos::core::ecs::Read and related types.
+
file blueprint.hpp
+
Class cubos::core::ecs::Blueprint.
+
file commands.hpp
+
Class cubos::core::ecs::Commands and related types.
+
file component_manager.hpp
+
Class cubos::core::ecs::ComponentManager and related types.
+
file dispatcher.hpp
+
Class cubos::core::ecs::Dispatcher.
+
file entity_manager.hpp
+
Class cubos::core::ecs::EntityManager and related types.
+
file event_pipe.hpp
+
Resource cubos::core::ecs::EventPipe.
+
file event_reader.hpp
+
Class cubos::core::ecs::EventReader.
+
file event_writer.hpp
+
Class cubos::core::ecs::EventWriter.
+
file map_storage.hpp
+
Class cubos::core::ecs::MapStorage.
+
file null_storage.hpp
+
Class cubos::core::ecs::NullStorage.
+
file query.hpp
+
Class cubos::core::ecs::Query and related types.
+
file registry.hpp
+
Class cubos::core::ecs::Registry and registration macro.
+
file resource_manager.hpp
+
Class cubos::core::ecs::ResourceManager and related types.
+
file storage.hpp
+
Class cubos::core::ecs::Storage and related types.
+
file system.hpp
+
Class cubos::core::ecs::SystemWrapper and related types.
+
file vec_storage.hpp
+
Class cubos::core::ecs::VecStorage.
+
file world.hpp
+
Class cubos::core::ecs::World.
+
+
+
+

Classes

+
+
+
template<typename T>
+ class cubos::core::ecs::Read +
+
System argument which provides read access to the resource T, or query argument which provides read access to the component T.
+
+
template<typename T>
+ class cubos::core::ecs::Write +
+
System argument which provides write access to the resource T, or query argument which provides write access to the component T.
+
+
template<typename T>
+ class cubos::core::ecs::OptRead +
+
System argument which provides read access to the resource T if it exists, or query argument which provides read access to the component T if it exists.
+
+
template<typename T>
+ class cubos::core::ecs::OptWrite +
+
System argument which provides write access to the resource T if it exists, or query argument which provides write access to the component T if it exists.
+
+ class cubos::core::ecs::EntityBuilder +
+
Allows editing an entity created by a Commands object.
+
+ class cubos::core::ecs::BlueprintBuilder +
+
Used to edit a blueprint spawned by a Commands object.
+
+ class cubos::core::ecs::Commands +
+
Used to write ECS commands and execute them at a later time.
+
+ class cubos::core::ecs::CommandBuffer +
+
Stores commands to execute them later.
+
+
template<typename T>
+ class cubos::core::ecs::ReadStorage +
+
Utility struct used to reference a storage of component type T for reading.
+
+
template<typename T>
+ class cubos::core::ecs::WriteStorage +
+
Utility struct used to reference a storage of component type T for writing.
+
+ class cubos::core::ecs::ComponentManager +
+
Holds and manages components.
+
+ class cubos::core::ecs::Dispatcher +
+
Used to add systems and relations between them and then dispatch them all at once.
+
+ class cubos::core::ecs::Entity +
+
Identifies an entity.
+
+ class cubos::core::ecs::EntityManager +
+
Holds and manages entities and their component masks.
+
+
template<typename T>
+ class cubos::core::ecs::EventPipe +
+
Resource which stores events of type T.
+
+
template<typename T, unsigned int M = DEFAULT_FILTER_MASK>
+ class cubos::core::ecs::EventReader +
+
System arguments used to read events of type T.
+
+
template<typename T>
+ class cubos::core::ecs::EventWriter +
+
System argument which allows the system to send events of type T to other systems.
+
+
template<typename T>
+ class cubos::core::ecs::MapStorage +
+
Storage implementation that uses an std::unordered_map.
+
+
template<typename T>
+ class cubos::core::ecs::NullStorage +
+
Storage implementation that doesn't keep any data, made for zero-sized components.
+
+ struct cubos::core::ecs::QueryInfo +
+
Describes a query.
+
+
template<typename... ComponentTypes>
+ class cubos::core::ecs::Query +
+
Holds the result of a query over all entities in world which match the given arguments.
+
+ class cubos::core::ecs::Registry +
+
Singleton which holds a global registry for all component types.
+
+
template<typename T>
+ class cubos::core::ecs::ReadResource +
+
Utility struct used to reference a resource of type T for reading.
+
+
template<typename T>
+ class cubos::core::ecs::WriteResource +
+
Utility struct used to reference a resource of type T for writing.
+
+ class cubos::core::ecs::ResourceManager +
+
Holds and manages resources.
+
+ class cubos::core::ecs::IStorage +
+
Abstract parent class for all storages.
+
+
template<typename T>
+ class cubos::core::ecs::Storage +
+
Abstract container for a component type T.
+
+ struct cubos::core::ecs::SystemInfo +
+
Describes a system.
+
+
template<typename R>
+ class cubos::core::ecs::AnySystemWrapper +
+
Base class for system wrappers.
+
+
template<typename F>
+ class cubos::core::ecs::SystemWrapper +
+
Wrapper for a system of type F.
+
+
template<typename T>
+ class cubos::core::ecs::VecStorage +
+
Storage implementation that uses a std::vector.
+
+ class cubos::core::ecs::World +
+
Holds entities, their components and resources.
+
+
+
+

Functions

+
+
+
template<typename T>
+ auto getComponentName() -> std::optional<std::string_view> +
+
Gets the registered name of a component type.
+
+ auto getComponentName(std::type_index type) -> std::optional<std::string_view> +
+
Gets the registered name of a component type.
+
+
+
+

Defines

+
+
+ #define CUBOS_REGISTER_COMPONENT(type, + storageType, + name) +
+
Macro used to register a component type as an alternative to calling cubos::core::ecs::Registry::add() manually.
+
+
+
+

Function documentation

+
+

+
#include <core/ecs/component_manager.hpp>
+
+ template<typename T> +
+ std::optional<std::string_view> getComponentName() +

+

Gets the registered name of a component type.

+ + + + + + + + + + + + + + + + +
Template parameters
TComponent type.
ReturnsRegistered name of the component type.
+

If the component type is not registered, aborts the program.

+
+
+

+ std::optional<std::string_view> getComponentName(std::type_index type) +
#include <core/ecs/component_manager.hpp>
+

+

Gets the registered name of a component type.

+ + + + + + + + + + + + + + + + +
Parameters
typeComponent type.
ReturnsRegistered name of the component type.
+

If the component type is not registered, aborts the program.

+
+
+
+

Define documentation

+
+

+ #define CUBOS_REGISTER_COMPONENT(type, + storageType, + name) +
#include <core/ecs/registry.hpp>
+

+

Macro used to register a component type as an alternative to calling cubos::core::ecs::Registry::add() manually.

+ +
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__core-geom.html b/pr-preview/pr-494/group__core-geom.html new file mode 100644 index 000000000..b046d975c --- /dev/null +++ b/pr-preview/pr-494/group__core-geom.html @@ -0,0 +1,146 @@ + + + + + Core » Geometry module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Core » + Geometry module

+

Provides geometry utilities.

+ +
+

Files

+
+
file box.hpp
+
Class cubos::core::geom::Box.
+
file capsule.hpp
+
Class cubos::core::geom::Capsule.
+
file plane.hpp
+
Class cubos::core::geom::Plane.
+
file simplex.hpp
+
Class cubos::core::geom::Simplex.
+
+
+
+

Classes

+
+
+ struct cubos::core::geom::Box +
+
Represents a box shape.
+
+ struct cubos::core::geom::Capsule +
+
Represents a capsule or sphere shape.
+
+ struct cubos::core::geom::Plane +
+
Represents a plane shape.
+
+ struct cubos::core::geom::Simplex +
+
Represents a simplex shape, which may either be empty, a point, a line, a triangle or a tetrahedron.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__core-gl.html b/pr-preview/pr-494/group__core-gl.html new file mode 100644 index 000000000..678ea5630 --- /dev/null +++ b/pr-preview/pr-494/group__core-gl.html @@ -0,0 +1,1334 @@ + + + + + Core » Graphics module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Core » + Graphics module

+

Provides a graphics API abstraction and some voxel utilities.

+ +
+

Files

+
+
file camera.hpp
+
Class cubos::core::gl::Camera.
+
file debug.hpp
+
Class cubos::core::gl::Debug.
+
file grid.hpp
+
Class cubos::core::gl::Grid.
+
file light.hpp
+
Classes cubos::core::gl::SpotLight, cubos::core::gl::DirectionalLight and cubos::core::gl::PointLight.
+
file material.hpp
+
Class cubos::core::gl::Material.
+
file palette.hpp
+
Class cubos::core::gl::Palette.
+
file render_device.hpp
+
Class cubos::core::gl::RenderDevice and related types.
+
file util.hpp
+
Function cubos::core::gl::generateScreenQuad.
+
file vertex.hpp
+
Class cubos::core::gl::Vertex and function cubos::core::gl::triangulate.
+
+
+
+

Classes

+
+
+ struct cubos::core::gl::Camera +
+
Describes a camera.
+
+ class cubos::core::gl::Debug +
+
Singleton with static methods used to draw primitive objects on screen for debugging purposes.
+
+ class cubos::core::gl::Grid +
+
Represents a voxel object using a 3D grid.
+
+ struct cubos::core::gl::SpotLight +
+
Describes a spot light.
+
+ struct cubos::core::gl::DirectionalLight +
+
Describes a directional light.
+
+ struct cubos::core::gl::PointLight +
+
Describes a point light.
+
+ struct cubos::core::gl::Material +
+
Describes a voxel material.
+
+ class cubos::core::gl::Palette +
+
Holds a palette of materials. Supports up to 65535 materials.
+
+ struct cubos::core::gl::FramebufferDesc +
+
Describes a framebuffer.
+
+ struct cubos::core::gl::RasterStateDesc +
+
Decribes a rasterizer state.
+
+ struct cubos::core::gl::DepthStencilStateDesc +
+
Describes a depth stencil state.
+
+ struct cubos::core::gl::BlendStateDesc +
+
Describes a blend state.
+
+ struct cubos::core::gl::SamplerDesc +
+
Describes a sampler.
+
+ struct cubos::core::gl::Texture1DDesc +
+
Describes a 1D texture.
+
+ struct cubos::core::gl::Texture2DDesc +
+
Describes a 2D texture.
+
+ struct cubos::core::gl::Texture2DArrayDesc +
+
Describes a 2D texture array.
+
+ struct cubos::core::gl::Texture3DDesc +
+
Describes a 3D texture.
+
+ struct cubos::core::gl::CubeMapDesc +
+
Describes a cube map.
+
+ struct cubos::core::gl::CubeMapArrayDesc +
+
Describes a cube map array.
+
+ struct cubos::core::gl::ConstantBufferElement +
+
Describes an element in a constant buffer.
+
+ struct cubos::core::gl::ConstantBufferStructure +
+
Describes the structure of a constant buffer.
+
+ struct cubos::core::gl::VertexElement +
+
Describes a vertex element.
+
+ struct cubos::core::gl::VertexArrayDesc +
+
Describes a vertex array.
+
+ class cubos::core::gl::RenderDevice +
+
Interface used to wrap low-level rendering APIs such as OpenGL.
+
+ struct cubos::core::gl::Vertex +
+
Represents a voxel vertex.
+
+
+
+

Enums

+
+
+ enum class Property { MaxAnisotropy, + ComputeSupported } +
+
Render device properties that can be queried at runtime.
+
+ enum class Usage { Default, + Dynamic, + Static } +
+
Usage mode for buffers and textures.
+
+ enum class Type { Byte, + Short, + Int, + UByte, + UShort, + UInt, + NByte, + NShort, + NUByte, + NUShort, + Float } +
+
Data type.
+
+ enum class IndexFormat { UShort, + UInt } +
+
Index format.
+
+ enum class TextureFormat { R8SNorm, + R16SNorm, + RG8SNorm, + RG16SNorm, + RGBA8SNorm, + RGBA16SNorm, + R8UNorm, + R16UNorm, + RG8UNorm, + RG16UNorm, + RGBA8UNorm, + RGBA16UNorm, + R8SInt, + R16SInt, + RG8SInt, + RG16SInt, + RGBA8SInt, + RGBA16SInt, + R8UInt, + R16UInt, + RG8UInt, + RG16UInt, + RGBA8UInt, + RGBA16UInt, + R16Float, + R32Float, + RG16Float, + RG32Float, + RGB16Float, + RGB32Float, + RGBA16Float, + RGBA32Float, + Depth16, + Depth32, + Depth24Stencil8, + Depth32Stencil8 } +
+
Texture format.
+
+ enum class AddressMode { Repeat, + Mirror, + Clamp, + Border } +
+
Texture address mode.
+
+ enum class TextureFilter { None, + Nearest, + Linear } +
+
Texture filter type.
+
+ enum class Winding { CW, + CCW } +
+
Triangle winding mode.
+
+ enum class Face { Front, + Back, + FrontAndBack } +
+
Specifies a face.
+
+ enum class RasterMode { Wireframe, + Fill } +
+
Rasterizer mode.
+
+ enum class Compare { Never, + Less, + LEqual, + Greater, + GEqual, + Equal, + NEqual, + Always } +
+
Comparison function.
+
+ enum class StencilAction { Zero, + Keep, + Replace, + Increment, + IncrementWrap, + Decrement, + DecrementWrap, + Invert } +
+
Stencil action.
+
+ enum class BlendFactor { Zero, + One, + SrcColor, + InvSrcColor, + DstColor, + InvDstColor, + SrcAlpha, + InvSrcAlpha, + DstAlpha, + InvDstAlpha } +
+
Blend factor.
+
+ enum class BlendOp { Add, + Substract, + RevSubstract, + Min, + Max } +
+
Blend operation.
+
+ enum class Stage { Vertex, + Geometry, + Pixel, + Compute } +
+
Shader stage type.
+
+ enum class CubeFace { PositiveX = 0, + NegativeX = 1, + PositiveY = 2, + NegativeY = 3, + PositiveZ = 4, + NegativeZ = 5 } +
+
Cube map face.
+
+ enum class MemoryBarriers { None = 0, + VertexBuffer = 1, + IndexBuffer = 2, + ConstantBuffer = 4, + ImageAccess = 8, + TextureAccess = 16, + Framebuffer = 32, + All = VertexBuffer | IndexBuffer | ConstantBuffer | ImageAccess | TextureAccess | Framebuffer } +
+
Memory barrier flags for synchronization.
+
+ enum class Access { Read, + Write, + ReadWrite } +
+
Access mode for a resource.
+
+
+
+

Typedefs

+
+
+ using Framebuffer = std::shared_ptr<impl::Framebuffer> +
+
Handle to a framebuffer.
+
+ using RasterState = std::shared_ptr<impl::RasterState> +
+
Handle to a rasterizer state.
+
+ using DepthStencilState = std::shared_ptr<impl::DepthStencilState> +
+
Handle to a depth stencil state.
+
+ using BlendState = std::shared_ptr<impl::BlendState> +
+
Handle to a blend state.
+
+ using Sampler = std::shared_ptr<impl::Sampler> +
+
Handle to a sampler.
+
+ using Texture1D = std::shared_ptr<impl::Texture1D> +
+
Handle to a 1D texture.
+
+ using Texture2D = std::shared_ptr<impl::Texture2D> +
+
Handle to a 2D texture.
+
+ using Texture2DArray = std::shared_ptr<impl::Texture2DArray> +
+
Handle to a 2D texture array.
+
+ using Texture3D = std::shared_ptr<impl::Texture3D> +
+
Handle to a 3D texture.
+
+ using CubeMap = std::shared_ptr<impl::CubeMap> +
+
Handle to a cube map.
+
+ using CubeMapArray = std::shared_ptr<impl::CubeMapArray> +
+
Handle to a cube map array.
+
+ using ConstantBuffer = std::shared_ptr<impl::ConstantBuffer> +
+
Handle to a constant buffer.
+
+ using IndexBuffer = std::shared_ptr<impl::IndexBuffer> +
+
Handle to an index buffer.
+
+ using VertexBuffer = std::shared_ptr<impl::VertexBuffer> +
+
Handle to a vertex buffer.
+
+ using VertexArray = std::shared_ptr<impl::VertexArray> +
+
Handle to a vertex array.
+
+ using ShaderStage = std::shared_ptr<impl::ShaderStage> +
+
Handle to a shader stage.
+
+ using ShaderPipeline = std::shared_ptr<impl::ShaderPipeline> +
+
Handle to a shader pipeline.
+
+ using ShaderBindingPoint = impl::ShaderBindingPoint* +
+
Handle to a shader binding point.
+
+
+
+

Functions

+
+
+ void triangulate(const Grid& grid, + std::vector<Vertex>& vertices, + std::vector<uint32_t>& indices) +
+
Triangulates a grid of voxels into an indexed mesh.
+
+
+
+

Defines

+
+
+ #define CUBOS_CORE_GL_MAX_FRAMEBUFFER_RENDER_TARGET_COUNT +
+
Maximum number of render targets that can be set on a framebuffer.
+
+ #define CUBOS_CORE_GL_MAX_TEXTURE_2D_ARRAY_SIZE +
+
Maximum number of textures on a 2D texture array.
+
+ #define CUBOS_CORE_GL_MAX_CUBEMAP_ARRAY_SIZE +
+
Maximum number of cube maps on a cubemap array.
+
+ #define CUBOS_CORE_GL_MAX_MIP_LEVEL_COUNT +
+
Maximum mip level count.
+
+ #define CUBOS_CORE_GL_MAX_CONSTANT_BUFFER_ELEMENT_NAME_SIZE +
+
Maximum constant buffer element name size.
+
+ #define CUBOS_CORE_GL_MAX_CONSTANT_BUFFER_ELEMENT_COUNT +
+
Maximum constant buffer element count.
+
+ #define CUBOS_CORE_GL_MAX_VERTEX_ARRAY_ELEMENT_COUNT +
+
Maximum number of vertex array elements.
+
+ #define CUBOS_CORE_GL_MAX_VERTEX_ARRAY_BUFFER_COUNT +
+
Maximum number of buffers on a vertex array.
+
+
+
+

Enum documentation

+
+

+ enum class Property +
#include <core/gl/render_device.hpp>
+

+

Render device properties that can be queried at runtime.

+ + + + + + + + + + + + + +
Enumerators
MaxAnisotropy +

Specifies the upper bound of anisotropic filtering.

+
ComputeSupported +

Specifies whether compute shaders and memory barriers are supported (0 or 1).

+
+
+
+

+ enum class Usage +
#include <core/gl/render_device.hpp>
+

+

Usage mode for buffers and textures.

+
+
+

+ enum class Type +
#include <core/gl/render_device.hpp>
+

+

Data type.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Enumerators
Byte +

8 bits signed integer.

+
Short +

16 bits signed integer.

+
Int +

32 bits signed integer.

+
UByte +

8 bits unsigned integer.

+
UShort +

16 bits unsigned integer.

+
UInt +

32 bits unsigned integer.

+
NByte +

Normalized 8 bits signed integer.

+
NShort +

Normalized 16 bits signed integer.

+
NUByte +

Normalized 8 bits unsigned integer.

+
NUShort +

Normalized 16 bits unsigned integer.

+
Float +

32 bits floating point.

+
+
+
+

+ enum class IndexFormat +
#include <core/gl/render_device.hpp>
+

+

Index format.

+ + + + + + + + + + + + +
Enumerators
UShort +

16 bits unsigned integer.

+
UInt +

32 bits unsigned integer.

+
+
+
+

+ enum class TextureFormat +
#include <core/gl/render_device.hpp>
+

+

Texture format.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Enumerators
R8SNorm +

1 channel 8 bits normalized signed integer.

+
R16SNorm +

1 channel 16 bits normalized signed integer.

+
RG8SNorm +

2 channel 8 bits normalized signed integer.

+
RG16SNorm +

2 channel 16 bits normalized signed integer.

+
RGBA8SNorm +

4 channel 8 bits normalized signed integer.

+
RGBA16SNorm +

4 channel 16 bits normalized signed integer.

+
R8UNorm +

1 channel 8 bits normalized unsigned integer.

+
R16UNorm +

1 channel 16 bits normalized unsigned integer.

+
RG8UNorm +

2 channel 8 bits normalized unsigned integer.

+
RG16UNorm +

2 channel 16 bits normalized unsigned integer.

+
RGBA8UNorm +

4 channel 8 bits normalized unsigned integer.

+
RGBA16UNorm +

4 channel 16 bits normalized unsigned integer.

+
R8SInt +

1 channel 8 bits signed integer.

+
R16SInt +

1 channel 16 bits signed integer.

+
RG8SInt +

2 channel 8 bits signed integer.

+
RG16SInt +

2 channel 16 bits signed integer.

+
RGBA8SInt +

4 channel 8 bits signed integer.

+
RGBA16SInt +

4 channel 16 bits signed integer.

+
R8UInt +

1 channel 8 bits unsigned integer.

+
R16UInt +

1 channel 16 bits unsigned integer.

+
RG8UInt +

2 channel 8 bits unsigned integer.

+
RG16UInt +

2 channel 16 bits unsigned integer.

+
RGBA8UInt +

4 channel 8 bits unsigned integer.

+
RGBA16UInt +

4 channel 16 bits unsigned integer.

+
R16Float +

1 channel 16 bits floating point.

+
R32Float +

1 channel 32 bits floating point.

+
RG16Float +

2 channel 16 bits floating point.

+
RG32Float +

2 channel 32 bits floating point.

+
RGB16Float +

3 channel 16 bits floating point.

+
RGB32Float +

3 channel 32 bits floating point.

+
RGBA16Float +

4 channel 16 bits floating point.

+
RGBA32Float +

4 channel 32 bits floating point.

+
Depth16 +

16 depth bits.

+
Depth32 +

32 depth bits.

+
Depth24Stencil8 +

24 depth bits and 8 stencil bits.

+
Depth32Stencil8 +

32 depth bits and 8 stencil bits.

+
+
+
+

+ enum class AddressMode +
#include <core/gl/render_device.hpp>
+

+

Texture address mode.

+
+
+

+ enum class TextureFilter +
#include <core/gl/render_device.hpp>
+

+

Texture filter type.

+
+
+

+ enum class Winding +
#include <core/gl/render_device.hpp>
+

+

Triangle winding mode.

+ + + + + + + + + + + + +
Enumerators
CW +

Clockwise.

+
CCW +

Counterclockwise.

+
+
+
+

+ enum class Face +
#include <core/gl/render_device.hpp>
+

+

Specifies a face.

+
+
+

+ enum class RasterMode +
#include <core/gl/render_device.hpp>
+

+

Rasterizer mode.

+
+
+

+ enum class Compare +
#include <core/gl/render_device.hpp>
+

+

Comparison function.

+
+
+

+ enum class StencilAction +
#include <core/gl/render_device.hpp>
+

+

Stencil action.

+
+
+

+ enum class BlendFactor +
#include <core/gl/render_device.hpp>
+

+

Blend factor.

+
+
+

+ enum class BlendOp +
#include <core/gl/render_device.hpp>
+

+

Blend operation.

+
+
+

+ enum class Stage +
#include <core/gl/render_device.hpp>
+

+

Shader stage type.

+
+
+

+ enum class CubeFace +
#include <core/gl/render_device.hpp>
+

+

Cube map face.

+
+
+

+ enum class MemoryBarriers +
#include <core/gl/render_device.hpp>
+

+

Memory barrier flags for synchronization.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Enumerators
None +

Utility flag to indicate that no memory barrier is set.

+
VertexBuffer +

If set, data sourced from vertex buffers after the barrier will reflect the data written by shaders prior to the barrier.

+
IndexBuffer +

If set, data sourced from index buffers after the barrier will reflect the data written by shaders prior to the barrier.

+
ConstantBuffer +

If set, data sourced from constant buffers after the barrier will reflect the data written by shaders prior to the barrier.

+
ImageAccess +

If set, memory accesses using shader image load, store, and atomic built-in functions issued after the barrier will reflect the data written by shaders prior to the barrier.

+
TextureAccess +

If set, texture accesses from shaders after the barrier will reflect the data written by shaders prior to the barrier.

+
Framebuffer +

If set, reads and writes via framebuffer objects after the barrier will reflect the data written by shaders prior to the barrier.

+
All +

Utility flag to set all memory barriers.

+
+
+
+

+ enum class Access +
#include <core/gl/render_device.hpp>
+

+

Access mode for a resource.

+ + + + + + + + + + + + + + + + +
Enumerators
Read +

Read access.

+
Write +

Write access.

+
ReadWrite +

Read and write access.

+
+
+
+
+

Typedef documentation

+
+

+ using Framebuffer = std::shared_ptr<impl::Framebuffer> +
#include <core/gl/render_device.hpp>
+

+

Handle to a framebuffer.

+ +
+
+

+ using RasterState = std::shared_ptr<impl::RasterState> +
#include <core/gl/render_device.hpp>
+

+

Handle to a rasterizer state.

+ +
+
+

+ using DepthStencilState = std::shared_ptr<impl::DepthStencilState> +
#include <core/gl/render_device.hpp>
+

+

Handle to a depth stencil state.

+ +
+
+

+ using BlendState = std::shared_ptr<impl::BlendState> +
#include <core/gl/render_device.hpp>
+

+

Handle to a blend state.

+ +
+
+

+ using Sampler = std::shared_ptr<impl::Sampler> +
#include <core/gl/render_device.hpp>
+

+

Handle to a sampler.

+ +
+
+

+ using Texture1D = std::shared_ptr<impl::Texture1D> +
#include <core/gl/render_device.hpp>
+

+

Handle to a 1D texture.

+ +
+
+

+ using Texture2D = std::shared_ptr<impl::Texture2D> +
#include <core/gl/render_device.hpp>
+

+

Handle to a 2D texture.

+ +
+
+

+ using Texture2DArray = std::shared_ptr<impl::Texture2DArray> +
#include <core/gl/render_device.hpp>
+

+

Handle to a 2D texture array.

+ +
+
+

+ using Texture3D = std::shared_ptr<impl::Texture3D> +
#include <core/gl/render_device.hpp>
+

+

Handle to a 3D texture.

+ +
+
+

+ using CubeMap = std::shared_ptr<impl::CubeMap> +
#include <core/gl/render_device.hpp>
+

+

Handle to a cube map.

+ +
+
+

+ using CubeMapArray = std::shared_ptr<impl::CubeMapArray> +
#include <core/gl/render_device.hpp>
+

+

Handle to a cube map array.

+ +
+
+

+ using ConstantBuffer = std::shared_ptr<impl::ConstantBuffer> +
#include <core/gl/render_device.hpp>
+

+

Handle to a constant buffer.

+ +
+
+

+ using IndexBuffer = std::shared_ptr<impl::IndexBuffer> +
#include <core/gl/render_device.hpp>
+

+

Handle to an index buffer.

+ +
+
+

+ using VertexBuffer = std::shared_ptr<impl::VertexBuffer> +
#include <core/gl/render_device.hpp>
+

+

Handle to a vertex buffer.

+ +
+
+

+ using VertexArray = std::shared_ptr<impl::VertexArray> +
#include <core/gl/render_device.hpp>
+

+

Handle to a vertex array.

+ +
+
+

+ using ShaderStage = std::shared_ptr<impl::ShaderStage> +
#include <core/gl/render_device.hpp>
+

+

Handle to a shader stage.

+ +
+
+

+ using ShaderPipeline = std::shared_ptr<impl::ShaderPipeline> +
#include <core/gl/render_device.hpp>
+

+

Handle to a shader pipeline.

+ +
+
+

+ using ShaderBindingPoint = impl::ShaderBindingPoint* +
#include <core/gl/render_device.hpp>
+

+

Handle to a shader binding point.

+ +
+
+
+

Function documentation

+
+

+ void triangulate(const Grid& grid, + std::vector<Vertex>& vertices, + std::vector<uint32_t>& indices) +
#include <core/gl/vertex.hpp>
+

+

Triangulates a grid of voxels into an indexed mesh.

+ + + + + + + + + + + + + + + + + + +
Parameters
gridGrid to triangulate.
verticesVertices of the mesh.
indicesIndices of the mesh.
+
+
+
+

Define documentation

+
+

+ #define CUBOS_CORE_GL_MAX_FRAMEBUFFER_RENDER_TARGET_COUNT +
#include <core/gl/render_device.hpp>
+

+

Maximum number of render targets that can be set on a framebuffer.

+
+
+

+ #define CUBOS_CORE_GL_MAX_TEXTURE_2D_ARRAY_SIZE +
#include <core/gl/render_device.hpp>
+

+

Maximum number of textures on a 2D texture array.

+
+
+

+ #define CUBOS_CORE_GL_MAX_CUBEMAP_ARRAY_SIZE +
#include <core/gl/render_device.hpp>
+

+

Maximum number of cube maps on a cubemap array.

+
+
+

+ #define CUBOS_CORE_GL_MAX_MIP_LEVEL_COUNT +
#include <core/gl/render_device.hpp>
+

+

Maximum mip level count.

+
+
+

+ #define CUBOS_CORE_GL_MAX_CONSTANT_BUFFER_ELEMENT_NAME_SIZE +
#include <core/gl/render_device.hpp>
+

+

Maximum constant buffer element name size.

+
+
+

+ #define CUBOS_CORE_GL_MAX_CONSTANT_BUFFER_ELEMENT_COUNT +
#include <core/gl/render_device.hpp>
+

+

Maximum constant buffer element count.

+
+
+

+ #define CUBOS_CORE_GL_MAX_VERTEX_ARRAY_ELEMENT_COUNT +
#include <core/gl/render_device.hpp>
+

+

Maximum number of vertex array elements.

+
+
+

+ #define CUBOS_CORE_GL_MAX_VERTEX_ARRAY_BUFFER_COUNT +
#include <core/gl/render_device.hpp>
+

+

Maximum number of buffers on a vertex array.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__core-io.html b/pr-preview/pr-494/group__core-io.html new file mode 100644 index 000000000..c775e3ba3 --- /dev/null +++ b/pr-preview/pr-494/group__core-io.html @@ -0,0 +1,586 @@ + + + + + Core » Input and output module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Core » + Input and output module

+

Provides a window API abstraction.

+ +
+

Files

+
+
file cursor.hpp
+
Class cubos::core::io::Cursor.
+
file keyboard.hpp
+
Enums cubos::core::io::Key and cubos::core::io::Modifiers.
+
file window.hpp
+
Class cubos::core::io::Window and related types.
+
+
+
+

Classes

+
+
+ class cubos::core::io::Cursor +
+
Handle for a custom mouse cursor.
+
+ struct cubos::core::io::KeyEvent +
+
Event sent when a key is pressed or released.
+
+ struct cubos::core::io::ModifiersEvent +
+
Event sent when the modifiers change.
+
+ struct cubos::core::io::MouseButtonEvent +
+
Event sent when a mouse button state changes.
+
+ struct cubos::core::io::MouseMoveEvent +
+
Event sent when the mouse cursor moves.
+
+ struct cubos::core::io::MouseScrollEvent +
+
Event sent when the mouse wheel is scrolled.
+
+ struct cubos::core::io::ResizeEvent +
+
Event sent when the window framebuffer is resized.
+
+ struct cubos::core::io::TextEvent +
+
Event sent when a unicode character is input.
+
+ class cubos::core::io::BaseWindow +
+
Interface used to wrap low-level window API implementations.
+
+
+
+

Enums

+
+
+ enum class Key { Invalid = -1, + A, + B, + C, + D, + E, + F, + G, + H, + I, + J, + K, + L, + M, + N, + O, + P, + Q, + R, + S, + T, + U, + V, + W, + X, + Y, + Z, + Num0, + Num1, + Num2, + Num3, + Num4, + Num5, + Num6, + Num7, + Num8, + Num9, + Escape, + LControl, + LShift, + LAlt, + LSystem, + RControl, + RShift, + RAlt, + RSystem, + Menu, + LBracket, + RBracket, + SemiColon, + Comma, + Period, + Quote, + Slash, + BackSlash, + Tilde, + Equal, + Dash, + Space, + Return, + BackSpace, + Tab, + PageUp, + PageDown, + End, + Home, + Insert, + Delete, + Add, + Subtract, + Multiply, + Divide, + Left, + Right, + Up, + Down, + Numpad0, + Numpad1, + Numpad2, + Numpad3, + Numpad4, + Numpad5, + Numpad6, + Numpad7, + Numpad8, + Numpad9, + F1, + F2, + F3, + F4, + F5, + F6, + F7, + F8, + F9, + F10, + F11, + F12, + Pause, + Count } +
+
Keyboard key codes enum.
+
+ enum class Modifiers { None = 0, + Control = 1, + Shift = 2, + Alt = 4, + System = 8 } +
+
Keyboard modifier flags enum.
+
+ enum class MouseButton { Invalid = -1, + Left, + Right, + Middle, + Extra1, + Extra2 } +
+
Mouse buttons enum.
+
+ enum class MouseAxis { X, + Y, + Scroll } +
+
Mouse axes enums.
+
+ enum class MouseState { Default, + Locked, + Hidden } +
+
Possible mouse states.
+
+
+
+

Typedefs

+
+
+ using WindowEvent = std::variant<KeyEvent, ModifiersEvent, MouseButtonEvent, MouseMoveEvent, MouseScrollEvent, ResizeEvent, TextEvent> +
+
Variant that can hold any of the window events.
+
+ using Window = std::shared_ptr<BaseWindow> +
+
Handle to a window.
+
+
+
+

Functions

+
+
+ auto modifiersToString(Modifiers modifiers) -> std::string +
+
Converts a Modifiers enum to a string.
+
+ auto stringToModifiers(const std::string& str) -> Modifiers +
+
Converts a string to a Modifiers enum.
+
+ auto keyToString(Key key) -> std::string +
+
Converts a Key enum to a string.
+
+ auto stringToKey(const std::string& str) -> Key +
+
Convert a string to a Key enum.
+
+ auto openWindow(const std::string& title = "CUBOS.", + const glm::ivec2& size = {800, 600}) -> Window +
+
Opens a new window.
+
+
+
+

Enum documentation

+
+

+ enum class Key +
#include <core/io/keyboard.hpp>
+

+

Keyboard key codes enum.

+
+
+

+ enum class Modifiers +
#include <core/io/keyboard.hpp>
+

+

Keyboard modifier flags enum.

+
+
+

+ enum class MouseButton +
#include <core/io/window.hpp>
+

+

Mouse buttons enum.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Enumerators
Invalid +

Used for unknown mouse buttons.

+
Left +
Right +
Middle +
Extra1 +
Extra2 +
+
+
+

+ enum class MouseAxis +
#include <core/io/window.hpp>
+

+

Mouse axes enums.

+
+
+

+ enum class MouseState +
#include <core/io/window.hpp>
+

+

Possible mouse states.

+ + + + + + + + + + + + + + + + +
Enumerators
Default +

Default mouse state, mouse will function as is specified by the OS.

+
Locked +

Mouse cursor will be hidden and locked to the center of the window, useful for control schemes that require infinite mouse movement.

+
Hidden +

Mouse cursor will be hidden when over the window, otherwise functioning in the same way as MouseState::Default.

+
+
+
+
+

Typedef documentation

+
+

+ using WindowEvent = std::variant<KeyEvent, ModifiersEvent, MouseButtonEvent, MouseMoveEvent, MouseScrollEvent, ResizeEvent, TextEvent> +
#include <core/io/window.hpp>
+

+

Variant that can hold any of the window events.

+
+
+

+ using Window = std::shared_ptr<BaseWindow> +
#include <core/io/window.hpp>
+

+

Handle to a window.

+ +
+
+
+

Function documentation

+
+

+ std::string modifiersToString(Modifiers modifiers) +
#include <core/io/keyboard.hpp>
+

+

Converts a Modifiers enum to a string.

+ + + + + + + + + + + + + + + + +
Parameters
modifiersModifiers.
ReturnsString representation.
+
+
+

+ Modifiers stringToModifiers(const std::string& str) +
#include <core/io/keyboard.hpp>
+

+

Converts a string to a Modifiers enum.

+ + + + + + + + + + + + + + + + +
Parameters
strString to convert.
ReturnsModifiers.
+
+
+

+ std::string keyToString(Key key) +
#include <core/io/keyboard.hpp>
+

+

Converts a Key enum to a string.

+ + + + + + + + + + + + + + + + +
Parameters
keyKey to convert.
ReturnsString representation.
+
+
+

+ Key stringToKey(const std::string& str) +
#include <core/io/keyboard.hpp>
+

+

Convert a string to a Key enum.

+ + + + + + + + + + + + + + + + +
Parameters
strThe string to convert.
ReturnsKey.
+
+
+

+ Window openWindow(const std::string& title = "CUBOS.", + const glm::ivec2& size = {800, 600}) +
#include <core/io/window.hpp>
+

+

Opens a new window.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
titleWindow title.
sizeWindow size, in screen coordinates.
ReturnsNew window, or nullptr on failure.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__core-memory.html b/pr-preview/pr-494/group__core-memory.html new file mode 100644 index 000000000..de030e291 --- /dev/null +++ b/pr-preview/pr-494/group__core-memory.html @@ -0,0 +1,416 @@ + + + + + Core » Memory module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Core » + Memory module

+

Provides a stream library and memory utilities.

+ +
+

Files

+
+
file buffer_stream.hpp
+
Class cubos::core::memory::BufferStream.
+
file endianness.hpp
+
Endianness utility functions.
+
file guards.hpp
+
Classes cubos::core::memory::ReadGuard and cubos::core::memory::WriteGuard.
+
file standard_stream.hpp
+
Class cubos::core::memory::StandardStream.
+
file stream.hpp
+
Class cubos::core::memory::Stream.
+
file type_map.hpp
+
Class cubos::core::memory::TypeMap.
+
+
+
+

Classes

+
+
+ class cubos::core::memory::BufferStream +
+
Stream implementation which writes to/reads from a buffer.
+
+
template<typename T, typename Lock>
+ class cubos::core::memory::ReadGuard +
+
Provides safe read-only access to an object using a lock.
+
+
template<typename T, typename Lock>
+ class cubos::core::memory::WriteGuard +
+
Provides safe read-write access to an object using a lock.
+
+ class cubos::core::memory::StandardStream +
+
Stream implementation which wraps a libc file pointer.
+
+ class cubos::core::memory::Stream +
+
Interface class for memory streams. Abstracts away sources or destinations of data.
+
+
template<typename V>
+ class cubos::core::memory::TypeMap +
+
A map that stores values of type V, using types as keys.
+
+
+
+

Enums

+
+
+ enum class SeekOrigin { Begin, + Current, + End } +
+
Stream seek origin.
+
+
+
+

Functions

+
+
+
template<typename T>
+ auto swapBytes(T value) -> T +
+
Swaps the bytes of a value, changing its endianness.
+
+ auto isLittleEndian() -> bool +
+
Checks if the current platform is little endian.
+
+
template<typename T>
+ auto fromLittleEndian(T value) -> T +
+
Converts a value from little endianness to local endianness.
+
+
template<typename T>
+ auto toLittleEndian(T value) -> T +
+
Converts a value from local endianness to little endianness.
+
+
template<typename T>
+ auto fromBigEndian(T value) -> T +
+
Converts a value from big endianness to local endianness.
+
+
template<typename T>
+ auto toBigEndian(T value) -> T +
+
Converts a value from local endianness to big endianness.
+
+
+
+

Enum documentation

+
+

+ enum class SeekOrigin +
#include <core/memory/stream.hpp>
+

+

Stream seek origin.

+
+
+
+

Function documentation

+
+

+
#include <core/memory/endianness.hpp>
+
+ template<typename T> +
+ T swapBytes(T value) +

+

Swaps the bytes of a value, changing its endianness.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TValue type.
Parameters
valueValue to swap.
ReturnsSwapped value.
+
+
+

+ bool isLittleEndian() +
#include <core/memory/endianness.hpp>
+

+

Checks if the current platform is little endian.

+ + + + + + + +
ReturnsWhether its little endian.
+
+
+

+
#include <core/memory/endianness.hpp>
+
+ template<typename T> +
+ T fromLittleEndian(T value) +

+

Converts a value from little endianness to local endianness.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TValue type.
Parameters
valueValue to convert.
ReturnsConverted value.
+
+
+

+
#include <core/memory/endianness.hpp>
+
+ template<typename T> +
+ T toLittleEndian(T value) +

+

Converts a value from local endianness to little endianness.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TValue type.
Parameters
valueValue to convert.
ReturnsConverted value.
+
+
+

+
#include <core/memory/endianness.hpp>
+
+ template<typename T> +
+ T fromBigEndian(T value) +

+

Converts a value from big endianness to local endianness.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TValue type.
Parameters
valueValue to convert.
ReturnsConverted value.
+
+
+

+
#include <core/memory/endianness.hpp>
+
+ template<typename T> +
+ T toBigEndian(T value) +

+

Converts a value from local endianness to big endianness.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TValue type.
Parameters
valueValue to convert.
ReturnsConverted value.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__core-ui.html b/pr-preview/pr-494/group__core-ui.html new file mode 100644 index 000000000..a8b3de2fa --- /dev/null +++ b/pr-preview/pr-494/group__core-ui.html @@ -0,0 +1,444 @@ + + + + + Core » User Interface module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Core » + User Interface module

+

Provides ImGui integration and general UI utilities.

+ + +
+

Files

+
+
file ecs.hpp
+
Functions cubos::core::ui::showWorld and cubos::core::ui::editWorld.
+
file imgui.hpp
+
Functions for initializing and using ImGui.
+
file serialization.hpp
+
Functions for showing and editing serializable objects in the UI.
+
+
+
+

Functions

+
+
+ void showWorld(const ecs::World& world, + data::Context* context = nullptr) +
+
Adds a ImGui window which allows the user to inspect the entities and components in a ecs::World.
+
+ void editWorld(ecs::World& world, + data::Context* serContext = nullptr, + data::Context* desContext = nullptr) +
+
Adds a ImGui window which allows the user to edit the entities and components in a ecs::World.
+
+ void initialize(io::Window window) +
+
Initializes ImGui for use with the given window.
+
+ void terminate() +
+
Shuts down ImGui.
+
+ void beginFrame() +
+
Begins a new ImGui frame. ImGui calls should be made between this and endFrame().
+
+ void endFrame(const gl::Framebuffer& target = nullptr) +
+
Ends the current ImGui frame, and renders the ImGui draw data to the target framebuffer, or the default framebuffer if target is null.
+
+ auto handleEvent(const io::WindowEvent& event) -> bool +
+
Passes a window event to ImGui.
+
+ void showPackage(const data::Package& pkg, + const std::string& name) +
+
Shows a packaged object's properties in the UI. Should be called inside a ImGui::BeginTable(2) and ImGui::EndTable() block.
+
+ auto editPackage(data::Package& pkg, + const std::string& name) -> bool +
+
Shows a packaged object's properties in the UI, allowing the user to edit the object. Should be called inside a ImGui::BeginTable(3) and ImGui::EndTable() block.
+
+
template<typename T>
+ void show(const T& object, + const std::string& name) +
+
Shows a serializable object's properties in the UI. Should be called inside a ImGui::BeginTable(2) and ImGui::EndTable() block.
+
+
template<typename T>
+ auto edit(T& object, + const std::string& name) -> bool +
+
Shows a serializable object's properties in the UI. Should be called inside a ImGui::BeginTable(3) and ImGui::EndTable() block.
+
+
+
+

Function documentation

+
+

+ void showWorld(const ecs::World& world, + data::Context* context = nullptr) +
#include <core/ui/ecs.hpp>
+

+

Adds a ImGui window which allows the user to inspect the entities and components in a ecs::World.

+ + + + + + + + + + + + + + +
Parameters
worldWorld to show.
contextOptional context for serializing the world.
+
+
+

+ void editWorld(ecs::World& world, + data::Context* serContext = nullptr, + data::Context* desContext = nullptr) +
#include <core/ui/ecs.hpp>
+

+

Adds a ImGui window which allows the user to edit the entities and components in a ecs::World.

+ + + + + + + + + + + + + + + + + + +
Parameters
worldWorld to edit.
serContextOptional context for serializing the world.
desContextOptional context for deserializing the world.
+
+
+

+ void initialize(io::Window window) +
#include <core/ui/imgui.hpp>
+

+

Initializes ImGui for use with the given window.

+ + + + + + + + + + +
Parameters
windowThe window to use.
+ +
+
+

+ void terminate() +
#include <core/ui/imgui.hpp>
+

+

Shuts down ImGui.

+ +
+
+

+ void beginFrame() +
#include <core/ui/imgui.hpp>
+

+

Begins a new ImGui frame. ImGui calls should be made between this and endFrame().

+
+
+

+ void endFrame(const gl::Framebuffer& target = nullptr) +
#include <core/ui/imgui.hpp>
+

+

Ends the current ImGui frame, and renders the ImGui draw data to the target framebuffer, or the default framebuffer if target is null.

+ + + + + + + + + + +
Parameters
targetFramebuffer to render to.
+
+
+

+ bool handleEvent(const io::WindowEvent& event) +
#include <core/ui/imgui.hpp>
+

+

Passes a window event to ImGui.

+ + + + + + + + + + + + + + + + +
Parameters
eventEvent to pass.
ReturnsTrue if the event was handled by ImGui, false otherwise.
+
+
+

+ void showPackage(const data::Package& pkg, + const std::string& name) +
#include <core/ui/serialization.hpp>
+

+

Shows a packaged object's properties in the UI. Should be called inside a ImGui::BeginTable(2) and ImGui::EndTable() block.

+ + + + + + + + + + + + + + +
Parameters
pkgPackaged object to show.
nameName of the object.
+

The first column displays the name of the package and the second column displays the value of the package.

+
+
+

+ bool editPackage(data::Package& pkg, + const std::string& name) +
#include <core/ui/serialization.hpp>
+

+

Shows a packaged object's properties in the UI, allowing the user to edit the object. Should be called inside a ImGui::BeginTable(3) and ImGui::EndTable() block.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
pkgPackaged object to edit.
nameName of the object.
ReturnsTrue if the object was modified, false otherwise.
+

The first column displays the name of the package, the second column displays the value of the package and the third column is used for remove buttons in the case of arrays and dictionaries.

+
+
+

+
#include <core/ui/serialization.hpp>
+
+ template<typename T> +
+ void show(const T& object, + const std::string& name) +

+

Shows a serializable object's properties in the UI. Should be called inside a ImGui::BeginTable(2) and ImGui::EndTable() block.

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TType of the serializable object.
Parameters
objectObject to show.
nameName of the object.
+

Internally packages the object and calls showPackage().

+
+
+

+
#include <core/ui/serialization.hpp>
+
+ template<typename T> +
+ bool edit(T& object, + const std::string& name) +

+

Shows a serializable object's properties in the UI. Should be called inside a ImGui::BeginTable(3) and ImGui::EndTable() block.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TType of the serializable object.
Parameters
objectObject to edit.
nameName of the object.
ReturnsTrue if the object was edited, false otherwise.
+

Internally packages the object, calls editPackage() and then unpackages the object, if it was modified.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__core.html b/pr-preview/pr-494/group__core.html new file mode 100644 index 000000000..72c828c00 --- /dev/null +++ b/pr-preview/pr-494/group__core.html @@ -0,0 +1,532 @@ + + + + + Core module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Core module

+

CUBOS. core library.

+ +

The core library contains loose utilities and functionality on which the rest of the CUBOS. libraries and applications are built on. Lives in the cubos::core namespace.

This library can be further divided into modules, which are documented in their respective module pages. Each of these modules has its own namespace and directory in the source tree. For example, the ECS module lives in the cubos::core::ecs namespace.

+
+

Modules

+
+
module Audio
+
Provides audio functionality.
+
module Data
+
Provides filesystem and serialization utilities.
+
module ECS
+
Entity Component System library.
+
module Geometry
+
Provides geometry utilities.
+
module Graphics
+
Provides a graphics API abstraction and some voxel utilities.
+
module Input and output
+
Provides a window API abstraction.
+
module Memory
+
Provides a stream library and memory utilities.
+
module User Interface
+
Provides ImGui integration and general UI utilities.
+
+
+
+

Files

+
+
file log.hpp
+
Logging and assertion macros.
+
file settings.hpp
+
Class cubos::core::Settings.
+
file thread_pool.hpp
+
Class cubos::core::ThreadPool.
+
+
+
+

Classes

+
+
+ class cubos::core::Settings +
+
Stores settings as key-value pairs and provides methods to retrieve them.
+
+ class cubos::core::ThreadPool +
+
Manages a pool of threads, to which tasks can be submitted.
+
+
+
+

Functions

+
+
+ void initializeLogger() +
+
Must be called before any logging is done.
+
+ void disableLogging() +
+
Disables all logging except for critical errors.
+
+
+
+

Defines

+
+
+ #define CUBOS_LOG_LEVEL +
+
Log level to compile in.
+
+ #define CUBOS_LOG_LEVEL_TRACE +
+
Trace log level, lowest log level. Very verbose.
+
+ #define CUBOS_LOG_LEVEL_DEBUG +
+
Debug log level. Contains messages useful for debugging, but which are not necessary in release builds.
+
+ #define CUBOS_LOG_LEVEL_INFO +
+
Information log level. Contains important events that are not errors.
+
+ #define CUBOS_LOG_LEVEL_WARN +
+
Warn log level. Contains events that are not errors, but which are unexpected and may be problematic.
+
+ #define CUBOS_LOG_LEVEL_ERROR +
+
Error log level. Contains errors which are recoverable from.
+
+ #define CUBOS_LOG_LEVEL_CRITICAL +
+
Critical log level, highest log level. Contains errors which are unrecoverable from.
+
+ #define CUBOS_LOG_LEVEL_OFF +
+
Off log level, disables all logging.
+
+ #define CUBOS_TRACE(...) +
+
Used for logging very verbose information.
+
+ #define CUBOS_DEBUG(...) +
+
Used for logging information which is useful for debugging but not necessary in release builds.
+
+ #define CUBOS_INFO(...) +
+
Used for logging information which is useful in release builds.
+
+ #define CUBOS_WARN(...) +
+
Used for logging unexpected events.
+
+ #define CUBOS_ERROR(...) +
+
Used for logging recoverable errors.
+
+ #define CUBOS_CRITICAL(...) +
+
Used for logging unrecoverable errors.
+
+ #define CUBOS_FAIL(...) +
+
Aborts a program, optionally printing a critical error message.
+
+ #define CUBOS_UNREACHABLE(...) +
+
Marks a code path as supposedly unreachable. Aborts the program when reached.
+
+ #define CUBOS_ASSERT(cond, + ...) +
+
Asserts that a condition is true, aborting the program if it is not.
+
+ #define CUBOS_DEBUG_ASSERT(cond, + ...) +
+
In debug builds asserts that a condition is true, aborting the program if it is not.
+
+
+
+

Function documentation

+
+

+ void initializeLogger() +
#include <core/log.hpp>
+

+

Must be called before any logging is done.

+
+
+

+ void disableLogging() +
#include <core/log.hpp>
+

+

Disables all logging except for critical errors.

+
+
+
+

Define documentation

+
+

+ #define CUBOS_LOG_LEVEL +
#include <core/log.hpp>
+

+

Log level to compile in.

+

This macro essentially controls the minimum log level that will be compiled into the binary.

Should be set to one of the following:

By default, on debug builds, this is set to CUBOS_LOG_LEVEL_TRACE. On release builds, this is set to CUBOS_LOG_LEVEL_INFO.

+
+
+

+ #define CUBOS_LOG_LEVEL_TRACE +
#include <core/log.hpp>
+

+

Trace log level, lowest log level. Very verbose.

+ +
+
+

+ #define CUBOS_LOG_LEVEL_DEBUG +
#include <core/log.hpp>
+

+

Debug log level. Contains messages useful for debugging, but which are not necessary in release builds.

+ +
+
+

+ #define CUBOS_LOG_LEVEL_INFO +
#include <core/log.hpp>
+

+

Information log level. Contains important events that are not errors.

+ +
+
+

+ #define CUBOS_LOG_LEVEL_WARN +
#include <core/log.hpp>
+

+

Warn log level. Contains events that are not errors, but which are unexpected and may be problematic.

+ +
+
+

+ #define CUBOS_LOG_LEVEL_ERROR +
#include <core/log.hpp>
+

+

Error log level. Contains errors which are recoverable from.

+ +
+
+

+ #define CUBOS_LOG_LEVEL_CRITICAL +
#include <core/log.hpp>
+

+

Critical log level, highest log level. Contains errors which are unrecoverable from.

+ +
+
+

+ #define CUBOS_LOG_LEVEL_OFF +
#include <core/log.hpp>
+

+

Off log level, disables all logging.

+ +
+
+

+ #define CUBOS_TRACE(...) +
#include <core/log.hpp>
+

+

Used for logging very verbose information.

+ + + + + + + + + + +
Parameters
...Format string and arguments.
+ +
+
+

+ #define CUBOS_DEBUG(...) +
#include <core/log.hpp>
+

+

Used for logging information which is useful for debugging but not necessary in release builds.

+ + + + + + + + + + +
Parameters
...Format string and arguments.
+ +
+
+

+ #define CUBOS_INFO(...) +
#include <core/log.hpp>
+

+

Used for logging information which is useful in release builds.

+ + + + + + + + + + +
Parameters
...Format string and arguments.
+ +
+
+

+ #define CUBOS_WARN(...) +
#include <core/log.hpp>
+

+

Used for logging unexpected events.

+ + + + + + + + + + +
Parameters
...Format string and arguments.
+ +
+
+

+ #define CUBOS_ERROR(...) +
#include <core/log.hpp>
+

+

Used for logging recoverable errors.

+ + + + + + + + + + +
Parameters
...Format string and arguments.
+ +
+
+

+ #define CUBOS_CRITICAL(...) +
#include <core/log.hpp>
+

+

Used for logging unrecoverable errors.

+ + + + + + + + + + +
Parameters
...Format string and arguments.
+ +
+
+

+ #define CUBOS_FAIL(...) +
#include <core/log.hpp>
+

+

Aborts a program, optionally printing a critical error message.

+ + + + + + + + + + +
Parameters
...Optional format string and arguments.
+
+
+

+ #define CUBOS_UNREACHABLE(...) +
#include <core/log.hpp>
+

+

Marks a code path as supposedly unreachable. Aborts the program when reached.

+ + + + + + + + + + +
Parameters
...Optional format string and arguments.
+
+
+

+ #define CUBOS_ASSERT(cond, + ...) +
#include <core/log.hpp>
+

+

Asserts that a condition is true, aborting the program if it is not.

+ + + + + + + + + + + + + + +
Parameters
condCondition to assert.
...Optional format string and arguments.
+
+
+

+ #define CUBOS_DEBUG_ASSERT(cond, + ...) +
#include <core/log.hpp>
+

+

In debug builds asserts that a condition is true, aborting the program if it is not.

+ + + + + + + + + + + + + + +
Parameters
condCondition to assert.
...Optional format string and arguments.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__engine.html b/pr-preview/pr-494/group__engine.html new file mode 100644 index 000000000..150e8ef01 --- /dev/null +++ b/pr-preview/pr-494/group__engine.html @@ -0,0 +1,178 @@ + + + + + Engine module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine module

+

CUBOS. engine library.

+ +

The engine library is built on top of the core library and contains code exclusive to game execution. This includes the main loop, asset management, rendering and physics. It is built around the Cubos class and designed to be as modular as possible. Each sub-module corresponds to a plugin, or a set of plugins.

The library re-exports some of the core library functionality for convenience such that the user doesn't have to use the cubos::core namespace directly very often.

+
+

Modules

+
+
module Assets
+
Adds asset management to CUBOS.
+
module Collisions
+
Adds collision detection to CUBOS.
+
module Environment settings
+
Loads settings from the command line arguments.
+
module File settings
+
Loads settings from a file.
+
module ImGui integration
+
Initializes and configures ImGui for CUBOS.
+
module Input
+
Adds input handling to CUBOS.
+
module Renderer
+
Creates and handles the lifecycle of a renderer.
+
module Scene
+
Adds scenes to CUBOS.
+
module Tools
+
Plugins which add debug and development tooling to CUBOS.
+
module Transform
+
Adds transform components which assign positions, rotations and scaling to entities.
+
module Voxels
+
Adds grid and palette assets to CUBOS.
+
module Window
+
Creates and handles the lifecycle of a window.
+
+
+
+

Files

+
+
file cubos.hpp
+
Class cubos::engine::Cubos.
+
+
+
+

Classes

+
+
+ struct cubos::engine::DeltaTime +
+
Resource which stores the time since the last iteration of the main loop started.
+
+ struct cubos::engine::ShouldQuit +
+
Resource used as a flag to indicate whether the main loop should stop running.
+
+ struct cubos::engine::Arguments +
+
Resource used for storing program arguments.
+
+ class cubos::engine::TagBuilder +
+
Used to chain configurations related to tags.
+
+ class cubos::engine::SystemBuilder +
+
Used to chain configurations related to systems.
+
+ class cubos::engine::Cubos +
+
Represents the engine itself, and exposes the interface with which the game developer interacts with. Ties up all the different parts of the engine together.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__entity-inspector-tool-plugin.html b/pr-preview/pr-494/group__entity-inspector-tool-plugin.html new file mode 100644 index 000000000..447026053 --- /dev/null +++ b/pr-preview/pr-494/group__entity-inspector-tool-plugin.html @@ -0,0 +1,152 @@ + + + + + Engine » Tools » Entity inspector module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Tools » + Entity inspector module

+

Allows inspecting and modifying the components of the selected entity through a ImGui window.

+ +

Dependencies

+
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Functions

+
+
+ void entityInspectorPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void entityInspectorPlugin(Cubos& cubos) +
#include <engine/tools/entity_inspector/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__entity-selector-tool-plugin.html b/pr-preview/pr-494/group__entity-selector-tool-plugin.html new file mode 100644 index 000000000..6d6bdceea --- /dev/null +++ b/pr-preview/pr-494/group__entity-selector-tool-plugin.html @@ -0,0 +1,152 @@ + + + + + Engine » Tools » Entity selector module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Tools » + Entity selector module

+

Adds a resource used to select an entity.

+ +

This plugins exists to reduce coupling between plugins. For example, a plugin which allows selecting entities through a ImGui window only needs to depend on this plugin, instead of having to know about all the plugins which care about it. The same applies in the other direction.

Resources

+
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Functions

+
+
+ void entitySelectorPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void entitySelectorPlugin(Cubos& cubos) +
#include <engine/tools/entity_selector/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__env-settings-plugin.html b/pr-preview/pr-494/group__env-settings-plugin.html new file mode 100644 index 000000000..5aabfc136 --- /dev/null +++ b/pr-preview/pr-494/group__env-settings-plugin.html @@ -0,0 +1,151 @@ + + + + + Engine » Environment settings module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Environment settings module

+

Loads settings from the command line arguments.

+ +

This plugin needs the Arguments resource, and thus, the constructor Cubos::Cubos(int, char**) must be used to construct the application. Any previous setting will be overwritten if its set on the arguments.

Startup tags

  • cubos.settings - the settings are loaded.
  • cubos.settings.env - the settings are loaded.
+
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Functions

+
+
+ void envSettingsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void envSettingsPlugin(Cubos& cubos) +
#include <engine/env_settings/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__file-settings-plugin.html b/pr-preview/pr-494/group__file-settings-plugin.html new file mode 100644 index 000000000..d02e9812b --- /dev/null +++ b/pr-preview/pr-494/group__file-settings-plugin.html @@ -0,0 +1,152 @@ + + + + + Engine » File settings module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + File settings module

+

Loads settings from a file.

+ +

The settings file must be a JSON file. If the file does not exist or can't be parsed, the plugin aborts. Any previously set setting will be overwritten if its set on the file.

Settings

  • settings.path - path of the settings file (default: ./settings.json).

Startup tags

  • cubos.settings - the settings are loaded.
  • cubos.settings.file - the settings are loaded.
+
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Functions

+
+
+ void fileSettingsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void fileSettingsPlugin(Cubos& cubos) +
#include <engine/file_settings/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__imgui-plugin.html b/pr-preview/pr-494/group__imgui-plugin.html new file mode 100644 index 000000000..ea8312e4b --- /dev/null +++ b/pr-preview/pr-494/group__imgui-plugin.html @@ -0,0 +1,153 @@ + + + + + Engine » ImGui integration module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + ImGui integration module

+

Initializes and configures ImGui for CUBOS.

+ +

Startup tags

  • cubos.imgui.init - ImGui is initialized, after cubos.window.init.

Tags

  • cubos.imgui.begin - the ImGui frame begins (after cubos.window.poll).
  • cubos.imgui.end - the ImGui frame ends (before cubos.window.render).
  • cubos.imgui - runs between the previous two tags.

Dependencies

+
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Functions

+
+
+ void imguiPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void imguiPlugin(Cubos& cubos) +
#include <engine/imgui/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__input-plugin.html b/pr-preview/pr-494/group__input-plugin.html new file mode 100644 index 000000000..79a833c5b --- /dev/null +++ b/pr-preview/pr-494/group__input-plugin.html @@ -0,0 +1,185 @@ + + + + + Engine » Input module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Input module

+

Adds input handling to CUBOS.

+ +

Bridges

Events

  • InputEvent - (TODO) emitted when an input event occurs.

Resources

  • Input - stateful input manager, used to query the input state.

Tags

  • cubos.input.update - updates the input state.

Dependencies

+
+

Files

+
+
file action.hpp
+
Class cubos::engine::InputAction.
+
file axis.hpp
+
Class cubos::engine::InputAxis.
+
file bindings.hpp
+
Class cubos::engine::InputBindings.
+
file input.hpp
+
Resource cubos::engine::Input.
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Classes

+
+
+ class cubos::engine::InputAction +
+
Stores the state of a single input action, such as "jump" or "attack".
+
+ class cubos::engine::InputAxis +
+
Stores the state of a single input axis, such as "move forward" or "move right".
+
+ class cubos::engine::InputBindings +
+
Stores the input bindings for a single player.
+
+ class cubos::engine::Input +
+
Resource which stores the input bindings for multiple players.
+
+
+
+

Functions

+
+
+ void inputPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void inputPlugin(Cubos& cubos) +
#include <engine/input/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__renderer-plugin.html b/pr-preview/pr-494/group__renderer-plugin.html new file mode 100644 index 000000000..0c1c76520 --- /dev/null +++ b/pr-preview/pr-494/group__renderer-plugin.html @@ -0,0 +1,316 @@ + + + + + Engine » Renderer module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Renderer module

+

Creates and handles the lifecycle of a renderer.

+ +

Renders all entities with the RenderableGrid component, using as cameras entities with the Camera component selected by the ActiveCameras resource. Lights are rendered using entities with SpotLight, DirectionalLight or PointLight components.

The rendering environment, such as the ambient lighting and sky color, can be set through the resource RendererEnvironment.

Settings

  • cubos.renderer.ssao.enabled - whether SSAO is enabled.

Resources

Components

Startup tags

  • cubos.renderer.init - the renderer is initialized, after cubos.window.init.

Tags

  • cubos.renderer.frame - frame information is collected, after cubos.transform.update.
  • cubos.renderer.draw - frame is rendered to the window, after cubos.renderer.frame and before cubos.window.render.

Dependencies

+
+

Files

+
+
file deferred_renderer.hpp
+
Renderer implementation cubos::engine::DeferredRenderer.
+
file environment.hpp
+
Resource cubos::engine::RendererEnvironment.
+
file frame.hpp
+
Resource cubos::engine::RendererFrame.
+
file light.hpp
+
Resource cubos::engine::AmbientLight and components cubos::engine::SpotLight, cubos::engine::DirectionalLight and cubos::engine::PointLight.
+
file plugin.hpp
+
Plugin entry point, resource cubos::engine::ActiveCameras and components cubos::engine::RenderableGrid and cubos::engine::Camera.
+
file bloom.hpp
+
Post processing pass implementation cubos::engine::PostProcessingBloom.
+
file copy_pass.hpp
+
Post processing pass implementation cubos::engine::PostProcessingCopy.
+
file manager.hpp
+
Class cubos::engine::PostProcessingManager.
+
file pass.hpp
+
Class cubos::engine::PostProcessingPass.
+
file renderer.hpp
+
Class cubos::engine::BaseRenderer and resource cubos::engine::Renderer.
+
+
+
+

Classes

+
+
+ class cubos::engine::DeferredRenderer +
+
Renderer implementation which uses deferred rendering.
+
+ struct cubos::engine::RendererEnvironment +
+
Resource which stores the renderer's ambient light and sky colors.
+
+ class cubos::engine::RendererFrame +
+
Resource which describes a scene to be drawn by the renderer.
+
+ struct cubos::engine::AmbientLight +
+
Resource which stores the ambient light.
+
+ struct cubos::engine::SpotLight +
+
Component which makes an entity emit a spot light.
+
+ struct cubos::engine::DirectionalLight +
+
Component which makes an entity behave like a directional light.
+
+ struct cubos::engine::PointLight +
+
Component which makes an entity behave like a point light.
+
+ struct cubos::engine::RenderableGrid +
+
Component which makes a voxel grid be rendered by the renderer plugin.
+
+ struct cubos::engine::Camera +
+
Component which defines parameters of a camera used to render the world.
+
+ struct cubos::engine::ActiveCameras +
+
Resource which identifies the camera entities to be used by the renderer.
+
+ class cubos::engine::PostProcessingBloom +
+
A post processing pass that adds a "bloom" effect to any bright objects in the scene.
+
+ class cubos::engine::PostProcessingCopy +
+
A simple post processing pass that copies the input texture to the output.
+
+ class cubos::engine::PostProcessingManager +
+
Responsible for managing the post processing passes.
+
+ class cubos::engine::PostProcessingPass +
+
A generic post processing pass.
+
+ class cubos::engine::BaseRenderer +
+
Interface which abstracts different rendering methods.
+
+
+
+

Enums

+
+
+ enum class PostProcessingInput { Lighting, + Position, + Normal } +
+
Possible renderer outputs which can then be used as input for a post processing pass.
+
+
+
+

Typedefs

+
+
+ using RendererGrid = std::shared_ptr<impl::RendererGrid> +
+
Handle to a grid uploaded to the GPU, to be used for rendering.
+
+ using Renderer = std::shared_ptr<BaseRenderer> +
+
Resource which is an handle to a generic renderer.
+
+
+
+

Functions

+
+
+ void rendererPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Enum documentation

+
+

+ enum class PostProcessingInput +
#include <engine/renderer/pps/manager.hpp>
+

+

Possible renderer outputs which can then be used as input for a post processing pass.

+ + + + + + + + + + + + + + + + +
Enumerators
Lighting +

Renderer output with lighting applied.

+
Position +

GBuffer texture with the world position of the pixels.

+
Normal +

GBuffer texture with the world normal of the pixels.

+
+
+
+
+

Typedef documentation

+
+

+ using RendererGrid = std::shared_ptr<impl::RendererGrid> +
#include <engine/renderer/renderer.hpp>
+

+

Handle to a grid uploaded to the GPU, to be used for rendering.

+
+
+

+ using Renderer = std::shared_ptr<BaseRenderer> +
#include <engine/renderer/renderer.hpp>
+

+

Resource which is an handle to a generic renderer.

+
+
+
+

Function documentation

+
+

+ void rendererPlugin(Cubos& cubos) +
#include <engine/renderer/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__scene-plugin.html b/pr-preview/pr-494/group__scene-plugin.html new file mode 100644 index 000000000..5495d9626 --- /dev/null +++ b/pr-preview/pr-494/group__scene-plugin.html @@ -0,0 +1,170 @@ + + + + + Engine » Scene module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Scene module

+

Adds scenes to CUBOS.

+ +

Bridges

Dependencies

+
+

Files

+
+
file bridge.hpp
+
Class cubos::engine::SceneBridge.
+
file plugin.hpp
+
Plugin entry point.
+
file scene.hpp
+
Class cubos::engine::Scene.
+
+
+
+

Classes

+
+
+ class cubos::engine::SceneBridge +
+
Bridge which loads and saves Scene assets.
+
+ struct cubos::engine::Scene +
+
Asset equivalent to ECS blueprints - a bundle of entities and their components.
+
+
+
+

Functions

+
+
+ void scenePlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void scenePlugin(Cubos& cubos) +
#include <engine/scene/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__settings-inspector-tool-plugin.html b/pr-preview/pr-494/group__settings-inspector-tool-plugin.html new file mode 100644 index 000000000..7a89fcc72 --- /dev/null +++ b/pr-preview/pr-494/group__settings-inspector-tool-plugin.html @@ -0,0 +1,152 @@ + + + + + Engine » Tools » Settings inspector module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Tools » + Settings inspector module

+

Allows inspecting the current setting values through a ImGui window.

+ +

Dependencies

+
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Functions

+
+
+ void settingsInspectorPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void settingsInspectorPlugin(Cubos& cubos) +
#include <engine/tools/settings_inspector/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__tool-plugins.html b/pr-preview/pr-494/group__tool-plugins.html new file mode 100644 index 000000000..0ed852a63 --- /dev/null +++ b/pr-preview/pr-494/group__tool-plugins.html @@ -0,0 +1,126 @@ + + + + + Engine » Tools module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Tools module

+

Plugins which add debug and development tooling to CUBOS.

+ +
+

Modules

+
+
module Asset explorer
+
Allows viewing and selecting assets through a ImGui window.
+
module Entity inspector
+
Allows inspecting and modifying the components of the selected entity through a ImGui window.
+
module Entity selector
+
Adds a resource used to select an entity.
+
module Settings inspector
+
Allows inspecting the current setting values through a ImGui window.
+
module World inspector
+
Shows all of the entities in the world through a ImGui window, and allows selecting them.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__transform-plugin.html b/pr-preview/pr-494/group__transform-plugin.html new file mode 100644 index 000000000..6acaaff73 --- /dev/null +++ b/pr-preview/pr-494/group__transform-plugin.html @@ -0,0 +1,182 @@ + + + + + Engine » Transform module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Transform module

+

Adds transform components which assign positions, rotations and scaling to entities.

+ +

This plugin operates on entities with a LocalToWorld component and any combination of the Position, Rotation and Scale components. For example, if you have an entity which doesn't need rotation, but has a position and a scale, you do not need to add the Rotation component, and its transform will still be updated.

Components

  • LocalToWorld - holds the local to world transform matrix.
  • Position - holds the position of an entity.
  • Rotation - holds the rotation of an entity.
  • Scale - holds the scaling of an entity.

Tags

+
+

Files

+
+
file local_to_world.hpp
+
Component cubos::engine::LocalToWorld.
+
file plugin.hpp
+
Plugin entry point.
+
file position.hpp
+
Component cubos::engine::Position.
+
file rotation.hpp
+
Component cubos::engine::Rotation.
+
file scale.hpp
+
Component cubos::engine::Scale.
+
+
+
+

Classes

+
+
+ struct cubos::engine::LocalToWorld +
+
Component which stores the transformation matrix of an entity, from local to world space.
+
+ struct cubos::engine::Position +
+
Component which assigns a position to an entity.
+
+ struct cubos::engine::Rotation +
+
Component which assigns a rotation to an entity.
+
+ struct cubos::engine::Scale +
+
Component which assigns a uniform scale to an entity.
+
+
+
+

Functions

+
+
+ void transformPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void transformPlugin(Cubos& cubos) +
#include <engine/transform/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__voxels-plugin.html b/pr-preview/pr-494/group__voxels-plugin.html new file mode 100644 index 000000000..67079b0b5 --- /dev/null +++ b/pr-preview/pr-494/group__voxels-plugin.html @@ -0,0 +1,152 @@ + + + + + Engine » Voxels module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Voxels module

+

Adds grid and palette assets to CUBOS.

+ +

Bridges

Dependencies

+
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Functions

+
+
+ void voxelsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void voxelsPlugin(Cubos& cubos) +
#include <engine/voxels/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__window-plugin.html b/pr-preview/pr-494/group__window-plugin.html new file mode 100644 index 000000000..db96a2d59 --- /dev/null +++ b/pr-preview/pr-494/group__window-plugin.html @@ -0,0 +1,155 @@ + + + + + Engine » Window module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Window module

+

Creates and handles the lifecycle of a window.

+ +

Initially sets ShouldQuit to false, and sets it to true only when the window is closed.

Settings

  • window.title - the window's title (default: CUBOS.).
  • window.width - the window's width (default: 800).
  • window.height - the window's height (default: 600).

Events

Resources

Startup tags

  • cubos.window.init - window is opened, runs after cubos.settings.

Tags

  • cubos.window.poll - the window is polled for events, sending core::io::WindowEvent's.
  • cubos.window.render - the window's back buffers are swapped.
+
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Functions

+
+
+ void windowPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void windowPlugin(Cubos& cubos) +
#include <engine/window/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/group__world-inspector-tool-plugin.html b/pr-preview/pr-494/group__world-inspector-tool-plugin.html new file mode 100644 index 000000000..c10e5d7f2 --- /dev/null +++ b/pr-preview/pr-494/group__world-inspector-tool-plugin.html @@ -0,0 +1,152 @@ + + + + + Engine » Tools » World inspector module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Tools » + World inspector module

+

Shows all of the entities in the world through a ImGui window, and allows selecting them.

+ +

Dependencies

+
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Functions

+
+
+ void worldInspectorPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void worldInspectorPlugin(Cubos& cubos) +
#include <engine/tools/world_inspector/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/guards_8hpp.html b/pr-preview/pr-494/guards_8hpp.html new file mode 100644 index 000000000..fce581a46 --- /dev/null +++ b/pr-preview/pr-494/guards_8hpp.html @@ -0,0 +1,138 @@ + + + + + core/memory/guards.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/memory/guards.hpp file +

+

Classes cubos::core::memory::ReadGuard and cubos::core::memory::WriteGuard.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::memory
+
Memory module.
+
+
+
+

Classes

+
+
+
template<typename T, typename Lock>
+ class cubos::core::memory::ReadGuard +
+
Provides safe read-only access to an object using a lock.
+
+
template<typename T, typename Lock>
+ class cubos::core::memory::WriteGuard +
+
Provides safe read-write access to an object using a lock.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/imgui_2plugin_8hpp.html b/pr-preview/pr-494/imgui_2plugin_8hpp.html new file mode 100644 index 000000000..ba19a9ef5 --- /dev/null +++ b/pr-preview/pr-494/imgui_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/imgui/plugin.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/imgui/plugin.hpp file +

+

Plugin entry point.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Functions

+
+
+ void imguiPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/imgui_8hpp.html b/pr-preview/pr-494/imgui_8hpp.html new file mode 100644 index 000000000..53befbc33 --- /dev/null +++ b/pr-preview/pr-494/imgui_8hpp.html @@ -0,0 +1,148 @@ + + + + + core/ui/imgui.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ui/imgui.hpp file +

+

Functions for initializing and using ImGui.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ui
+
User Interface module.
+
+
+
+

Functions

+
+
+ void initialize(io::Window window) +
+
Initializes ImGui for use with the given window.
+
+ void terminate() +
+
Shuts down ImGui.
+
+ void beginFrame() +
+
Begins a new ImGui frame. ImGui calls should be made between this and endFrame().
+
+ void endFrame(const gl::Framebuffer& target = nullptr) +
+
Ends the current ImGui frame, and renders the ImGui draw data to the target framebuffer, or the default framebuffer if target is null.
+
+ auto handleEvent(const io::WindowEvent& event) -> bool +
+
Passes a window event to ImGui.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/index.html b/pr-preview/pr-494/index.html new file mode 100644 index 000000000..54b0f6e00 --- /dev/null +++ b/pr-preview/pr-494/index.html @@ -0,0 +1,100 @@ + + + + + Introduction | CUBOS. + + + + + + + +
+
+
+
+
+

+ Introduction +

+

Image

Voxel based engine

CUBOS. aims to be a simple, but powerful game engine for PC, where everything is made out of voxels.

It is open source and free to use for any purpose. Written in C++ and with data-oriented design in mind, its goal is to be both performant and highly flexible.

Getting started

The best way to get started is to read the getting started guide, which will guide you through the process of downloading and building the engine, as well as where to go from there.

There is also a feature guide which gives you a high-level overview of the engine's design and features. If you're just looking for a quick overview, this is the place to go. You can also take a look at the modules page, which describes each of the engine's modules.

In the examples page you can find examples on how to use specific parts of the engine.

If you're looking to contribute to the project, make sure you read the contribution guidelines, which introduces you to the project's conventions and code style.

Team

CUBOS. is developed by a small team at GameDev Técnico, a student group at Instituto Superior Técnico who make games. Our goal is to build a game engine from the ground up and have fun doing it.

Join us

If you're a student and interested in joining us, please fill out this form.

+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/input_2plugin_8hpp.html b/pr-preview/pr-494/input_2plugin_8hpp.html new file mode 100644 index 000000000..c84eb8bbb --- /dev/null +++ b/pr-preview/pr-494/input_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/input/plugin.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/input/plugin.hpp file +

+

Plugin entry point.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Functions

+
+
+ void inputPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/input_8hpp.html b/pr-preview/pr-494/input_8hpp.html new file mode 100644 index 000000000..8f06d62e1 --- /dev/null +++ b/pr-preview/pr-494/input_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/input/input.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/input/input.hpp file +

+

Resource cubos::engine::Input.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::Input +
+
Resource which stores the input bindings for multiple players.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/json_8hpp.html b/pr-preview/pr-494/json_8hpp.html new file mode 100644 index 000000000..ff6cbcc62 --- /dev/null +++ b/pr-preview/pr-494/json_8hpp.html @@ -0,0 +1,131 @@ + + + + + engine/assets/bridges/json.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/assets/bridges/json.hpp file +

+

Class cubos::engine::JSONBridge.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+
template<typename T>
+ class cubos::engine::JSONBridge +
+
Bridge for loading and saving assets which are serialized to and from a JSON file.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/keyboard_8hpp.html b/pr-preview/pr-494/keyboard_8hpp.html new file mode 100644 index 000000000..1ede28d4c --- /dev/null +++ b/pr-preview/pr-494/keyboard_8hpp.html @@ -0,0 +1,261 @@ + + + + + core/io/keyboard.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/io/keyboard.hpp file +

+

Enums cubos::core::io::Key and cubos::core::io::Modifiers.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::io
+
Input and output module.
+
+
+
+

Enums

+
+
+ enum class Key { Invalid = -1, + A, + B, + C, + D, + E, + F, + G, + H, + I, + J, + K, + L, + M, + N, + O, + P, + Q, + R, + S, + T, + U, + V, + W, + X, + Y, + Z, + Num0, + Num1, + Num2, + Num3, + Num4, + Num5, + Num6, + Num7, + Num8, + Num9, + Escape, + LControl, + LShift, + LAlt, + LSystem, + RControl, + RShift, + RAlt, + RSystem, + Menu, + LBracket, + RBracket, + SemiColon, + Comma, + Period, + Quote, + Slash, + BackSlash, + Tilde, + Equal, + Dash, + Space, + Return, + BackSpace, + Tab, + PageUp, + PageDown, + End, + Home, + Insert, + Delete, + Add, + Subtract, + Multiply, + Divide, + Left, + Right, + Up, + Down, + Numpad0, + Numpad1, + Numpad2, + Numpad3, + Numpad4, + Numpad5, + Numpad6, + Numpad7, + Numpad8, + Numpad9, + F1, + F2, + F3, + F4, + F5, + F6, + F7, + F8, + F9, + F10, + F11, + F12, + Pause, + Count } +
+
Keyboard key codes enum.
+
+ enum class Modifiers { None = 0, + Control = 1, + Shift = 2, + Alt = 4, + System = 8 } +
+
Keyboard modifier flags enum.
+
+
+
+

Functions

+
+
+ auto modifiersToString(Modifiers modifiers) -> std::string +
+
Converts a Modifiers enum to a string.
+
+ auto stringToModifiers(const std::string& str) -> Modifiers +
+
Converts a string to a Modifiers enum.
+
+ auto keyToString(Key key) -> std::string +
+
Converts a Key enum to a string.
+
+ auto stringToKey(const std::string& str) -> Key +
+
Convert a string to a Key enum.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/local__to__world_8hpp.html b/pr-preview/pr-494/local__to__world_8hpp.html new file mode 100644 index 000000000..f31030a09 --- /dev/null +++ b/pr-preview/pr-494/local__to__world_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/transform/local_to_world.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/transform/local_to_world.hpp file +

+

Component cubos::engine::LocalToWorld.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ struct cubos::engine::LocalToWorld +
+
Component which stores the transformation matrix of an entity, from local to world space.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/log_8hpp.html b/pr-preview/pr-494/log_8hpp.html new file mode 100644 index 000000000..dcbcf027c --- /dev/null +++ b/pr-preview/pr-494/log_8hpp.html @@ -0,0 +1,214 @@ + + + + + core/log.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/log.hpp file +

+

Logging and assertion macros.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
+
+
+

Functions

+
+
+ void initializeLogger() +
+
Must be called before any logging is done.
+
+ void disableLogging() +
+
Disables all logging except for critical errors.
+
+
+
+

Defines

+
+
+ #define CUBOS_LOG_LEVEL +
+
Log level to compile in.
+
+ #define CUBOS_LOG_LEVEL_TRACE +
+
Trace log level, lowest log level. Very verbose.
+
+ #define CUBOS_LOG_LEVEL_DEBUG +
+
Debug log level. Contains messages useful for debugging, but which are not necessary in release builds.
+
+ #define CUBOS_LOG_LEVEL_INFO +
+
Information log level. Contains important events that are not errors.
+
+ #define CUBOS_LOG_LEVEL_WARN +
+
Warn log level. Contains events that are not errors, but which are unexpected and may be problematic.
+
+ #define CUBOS_LOG_LEVEL_ERROR +
+
Error log level. Contains errors which are recoverable from.
+
+ #define CUBOS_LOG_LEVEL_CRITICAL +
+
Critical log level, highest log level. Contains errors which are unrecoverable from.
+
+ #define CUBOS_LOG_LEVEL_OFF +
+
Off log level, disables all logging.
+
+ #define CUBOS_TRACE(...) +
+
Used for logging very verbose information.
+
+ #define CUBOS_DEBUG(...) +
+
Used for logging information which is useful for debugging but not necessary in release builds.
+
+ #define CUBOS_INFO(...) +
+
Used for logging information which is useful in release builds.
+
+ #define CUBOS_WARN(...) +
+
Used for logging unexpected events.
+
+ #define CUBOS_ERROR(...) +
+
Used for logging recoverable errors.
+
+ #define CUBOS_CRITICAL(...) +
+
Used for logging unrecoverable errors.
+
+ #define CUBOS_FAIL(...) +
+
Aborts a program, optionally printing a critical error message.
+
+ #define CUBOS_UNREACHABLE(...) +
+
Marks a code path as supposedly unreachable. Aborts the program when reached.
+
+ #define CUBOS_ASSERT(cond, + ...) +
+
Asserts that a condition is true, aborting the program if it is not.
+
+ #define CUBOS_DEBUG_ASSERT(cond, + ...) +
+
In debug builds asserts that a condition is true, aborting the program if it is not.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/m-dark+documentation.compiled.css b/pr-preview/pr-494/m-dark+documentation.compiled.css new file mode 100644 index 000000000..7d091c2fa --- /dev/null +++ b/pr-preview/pr-494/m-dark+documentation.compiled.css @@ -0,0 +1,2925 @@ +/* Generated using `./postprocess.py m-dark.css m-documentation.css -o m-dark+documentation.compiled.css`. Do not edit. */ + +/* + This file is part of m.css. + + Copyright © 2017, 2018, 2019, 2020, 2021, 2022, 2023 + Vladimír Vondruš + + Permission is hereby granted, free of charge, to any person obtaining a + copy of this software and associated documentation files (the "Software"), + to deal in the Software without restriction, including without limitation + the rights to use, copy, modify, merge, publish, distribute, sublicense, + and/or sell copies of the Software, and to permit persons to whom the + Software is furnished to do so, subject to the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL + THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER + DEALINGS IN THE SOFTWARE. +*/ + +*, ::before, ::after { box-sizing: border-box; } +body { margin: 0; } +.m-container { + width: 100%; + margin: auto; + padding-left: 1rem; + padding-right: 1rem; +} +.m-row { + margin-left: -1rem; + margin-right: -1rem; +} +.m-row::after { + content: ' '; + clear: both; + display: table; +} +.m-row > [class*='m-col-'] { + position: relative; + padding: 1rem; +} +[class*='m-clearfix-']::after { + display: block; + content: ' '; + clear: both; +} +[class*='m-show-'] { + display: none; +} +.m-container-inflate, :not(.m-row) > [class*='m-col-'] { + margin-bottom: 1rem; +} +.m-container-inflate:last-child, :not(.m-row) > [class*='m-col-']:last-child { + margin-bottom: 0; +} +.m-container.m-nopad, [class*='m-col-'].m-nopad, +.m-container.m-nopadx, [class*='m-col-'].m-nopadx, +.m-container.m-nopadl, [class*='m-col-'].m-nopadl { + padding-left: 0; +} +.m-container.m-nopad, [class*='m-col-'].m-nopad, +.m-container.m-nopadx, [class*='m-col-'].m-nopadx, +.m-container.m-nopadr, [class*='m-col-'].m-nopadr { + padding-right: 0; +} +[class*='m-col-'].m-nopad, [class*='m-col-'].m-nopady, [class*='m-col-'].m-nopadt { + padding-top: 0; +} +[class*='m-col-'].m-nopad, [class*='m-col-'].m-nopady, [class*='m-col-'].m-nopadb, +.m-container-inflate.m-nopadb { + padding-bottom: 0; +} +[class*='m-col-t-'] { float: left; } +.m-left-t { + padding-right: 1rem; + float: left; +} +.m-right-t, [class*='m-col-t-'].m-right-t { + padding-left: 1rem; + float: right; +} +.m-center-t, [class*='m-col-t-'].m-center-t { + float: none; +} +.m-center-t, [class*='m-col-t-'].m-center-t { + margin-left: auto; + margin-right: auto; + float: none; +} +.m-col-t-1 { width: calc(1 * 100% / 12); } +.m-col-t-2 { width: calc(2 * 100% / 12); } +.m-col-t-3 { width: calc(3 * 100% / 12); } +.m-col-t-4 { width: calc(4 * 100% / 12); } +.m-col-t-5 { width: calc(5 * 100% / 12); } +.m-col-t-6 { width: calc(6 * 100% / 12); } +.m-col-t-7 { width: calc(7 * 100% / 12); } +.m-col-t-8 { width: calc(8 * 100% / 12); } +.m-col-t-9 { width: calc(9 * 100% / 12); } +.m-col-t-10 { width: calc(10 * 100% / 12); } +.m-col-t-11 { width: calc(11 * 100% / 12); } +.m-col-t-12 { width: calc(12 * 100% / 12); } +.m-push-t-1 { left: calc(1 * 100% / 12); } +.m-push-t-2 { left: calc(2 * 100% / 12); } +.m-push-t-3 { left: calc(3 * 100% / 12); } +.m-push-t-4 { left: calc(4 * 100% / 12); } +.m-push-t-5 { left: calc(5 * 100% / 12); } +.m-push-t-6 { left: calc(6 * 100% / 12); } +.m-push-t-7 { left: calc(7 * 100% / 12); } +.m-push-t-8 { left: calc(8 * 100% / 12); } +.m-push-t-9 { left: calc(9 * 100% / 12); } +.m-push-t-10 { left: calc(10 * 100% / 12); } +.m-push-t-11 { left: calc(11 * 100% / 12); } +.m-pull-t-1 { right: calc(1 * 100% / 12); } +.m-pull-t-2 { right: calc(2 * 100% / 12); } +.m-pull-t-3 { right: calc(3 * 100% / 12); } +.m-pull-t-4 { right: calc(4 * 100% / 12); } +.m-pull-t-5 { right: calc(5 * 100% / 12); } +.m-pull-t-6 { right: calc(6 * 100% / 12); } +.m-pull-t-7 { right: calc(7 * 100% / 12); } +.m-pull-t-8 { right: calc(8 * 100% / 12); } +.m-pull-t-9 { right: calc(9 * 100% / 12); } +.m-pull-t-10 { right: calc(10 * 100% / 12); } +.m-pull-t-11 { right: calc(11 * 100% / 12); } +@media screen and (min-width: 576px) { + .m-container { width: 560px; } + .m-container-inflatable .m-col-s-10 .m-container-inflate:not([class*='m-left-']):not([class*='m-right-']) { + margin-left: -10%; + margin-right: -10%; + } + .m-container-inflatable .m-col-s-10 .m-container-inflate.m-left-s { + margin-left: -10%; + } + .m-container-inflatable .m-col-s-10 .m-container-inflate.m-right-s { + margin-right: -10%; + } + [class*='m-col-s-'] { float: left; } + .m-left-s { + padding-right: 1rem; + float: left; + } + .m-right-s, [class*='m-col-s-'].m-right-s { + padding-left: 1rem; + float: right; + } + .m-center-s, [class*='m-col-s-'].m-center-s { + margin-left: auto; + margin-right: auto; + float: none; + } + .m-col-s-1 { width: calc(1 * 100% / 12); } + .m-col-s-2 { width: calc(2 * 100% / 12); } + .m-col-s-3 { width: calc(3 * 100% / 12); } + .m-col-s-4 { width: calc(4 * 100% / 12); } + .m-col-s-5 { width: calc(5 * 100% / 12); } + .m-col-s-6 { width: calc(6 * 100% / 12); } + .m-col-s-7 { width: calc(7 * 100% / 12); } + .m-col-s-8 { width: calc(8 * 100% / 12); } + .m-col-s-9 { width: calc(9 * 100% / 12); } + .m-col-s-10 { width: calc(10 * 100% / 12); } + .m-col-s-11 { width: calc(11 * 100% / 12); } + .m-col-s-12 { width: calc(12 * 100% / 12); } + .m-push-s-0 { left: calc(0 * 100% / 12); } + .m-push-s-1 { left: calc(1 * 100% / 12); } + .m-push-s-2 { left: calc(2 * 100% / 12); } + .m-push-s-3 { left: calc(3 * 100% / 12); } + .m-push-s-4 { left: calc(4 * 100% / 12); } + .m-push-s-5 { left: calc(5 * 100% / 12); } + .m-push-s-6 { left: calc(6 * 100% / 12); } + .m-push-s-7 { left: calc(7 * 100% / 12); } + .m-push-s-8 { left: calc(8 * 100% / 12); } + .m-push-s-9 { left: calc(9 * 100% / 12); } + .m-push-s-10 { left: calc(10 * 100% / 12); } + .m-push-s-11 { left: calc(11 * 100% / 12); } + .m-pull-s-0 { right: calc(0 * 100% / 12); } + .m-pull-s-1 { right: calc(1 * 100% / 12); } + .m-pull-s-2 { right: calc(2 * 100% / 12); } + .m-pull-s-3 { right: calc(3 * 100% / 12); } + .m-pull-s-4 { right: calc(4 * 100% / 12); } + .m-pull-s-5 { right: calc(5 * 100% / 12); } + .m-pull-s-6 { right: calc(6 * 100% / 12); } + .m-pull-s-7 { right: calc(7 * 100% / 12); } + .m-pull-s-8 { right: calc(8 * 100% / 12); } + .m-pull-s-9 { right: calc(9 * 100% / 12); } + .m-pull-s-10 { right: calc(10 * 100% / 12); } + .m-pull-s-11 { right: calc(11 * 100% / 12); } + .m-clearfix-t::after { display: none; } + .m-hide-s { display: none; } + .m-show-s { display: block; } + .m-col-s-none { + width: auto; + float: none; + } +} +@media screen and (min-width: 768px) { + .m-container { width: 750px; } + .m-container-inflatable .m-col-m-10 .m-container-inflate:not([class*='m-left-']):not([class*='m-right-']) { + margin-left: -10%; + margin-right: -10%; + } + .m-container-inflatable .m-col-m-10 .m-container-inflate.m-left-m { + margin-left: -10%; + } + .m-container-inflatable .m-col-m-10 .m-container-inflate.m-right-m { + margin-right: -10%; + } + [class*='m-col-m-'] { float: left; } + .m-left-m { + padding-right: 1rem; + float: left; + } + .m-right-m, [class*='m-col-m-'].m-right-m { + padding-left: 1rem; + float: right; + } + .m-center-m, [class*='m-col-m-'].m-center-m { + margin-left: auto; + margin-right: auto; + float: none; + } + .m-col-m-1 { width: calc(1 * 100% / 12); } + .m-col-m-2 { width: calc(2 * 100% / 12); } + .m-col-m-3 { width: calc(3 * 100% / 12); } + .m-col-m-4 { width: calc(4 * 100% / 12); } + .m-col-m-5 { width: calc(5 * 100% / 12); } + .m-col-m-6 { width: calc(6 * 100% / 12); } + .m-col-m-7 { width: calc(7 * 100% / 12); } + .m-col-m-8 { width: calc(8 * 100% / 12); } + .m-col-m-9 { width: calc(9 * 100% / 12); } + .m-col-m-10 { width: calc(10 * 100% / 12); } + .m-col-m-11 { width: calc(11 * 100% / 12); } + .m-col-m-12 { width: calc(12 * 100% / 12); } + .m-push-m-0 { left: calc(0 * 100% / 12); } + .m-push-m-1 { left: calc(1 * 100% / 12); } + .m-push-m-2 { left: calc(2 * 100% / 12); } + .m-push-m-3 { left: calc(3 * 100% / 12); } + .m-push-m-4 { left: calc(4 * 100% / 12); } + .m-push-m-5 { left: calc(5 * 100% / 12); } + .m-push-m-6 { left: calc(6 * 100% / 12); } + .m-push-m-7 { left: calc(7 * 100% / 12); } + .m-push-m-8 { left: calc(8 * 100% / 12); } + .m-push-m-9 { left: calc(9 * 100% / 12); } + .m-push-m-10 { left: calc(10 * 100% / 12); } + .m-push-m-11 { left: calc(11 * 100% / 12); } + .m-pull-m-0 { right: calc(0 * 100% / 12); } + .m-pull-m-1 { right: calc(1 * 100% / 12); } + .m-pull-m-2 { right: calc(2 * 100% / 12); } + .m-pull-m-3 { right: calc(3 * 100% / 12); } + .m-pull-m-4 { right: calc(4 * 100% / 12); } + .m-pull-m-5 { right: calc(5 * 100% / 12); } + .m-pull-m-6 { right: calc(6 * 100% / 12); } + .m-pull-m-7 { right: calc(7 * 100% / 12); } + .m-pull-m-8 { right: calc(8 * 100% / 12); } + .m-pull-m-9 { right: calc(9 * 100% / 12); } + .m-pull-m-10 { right: calc(10 * 100% / 12); } + .m-pull-m-11 { right: calc(11 * 100% / 12); } + .m-clearfix-s::after { display: none; } + .m-hide-m { display: none; } + .m-show-m { display: block; } + .m-col-m-none { + width: auto; + float: none; + } +} +@media screen and (min-width: 992px) { + .m-container { width: 960px; } + .m-container-inflatable .m-col-l-10 .m-container-inflate:not([class*='m-left-']):not([class*='m-right-']) { + margin-left: -10%; + margin-right: -10%; + } + .m-container-inflatable .m-col-l-10 .m-container-inflate.m-left-l { + margin-left: -10%; + } + .m-container-inflatable .m-col-l-10 .m-container-inflate.m-right-l { + margin-right: -10%; + } + [class*='m-col-l-'] { float: left; } + .m-left-l { + padding-right: 1rem; + float: left; + } + .m-right-l, [class*='m-col-l-'].m-right-l { + padding-left: 1rem; + float: right; + } + .m-center-l, [class*='m-col-l-'].m-center-l { + margin-left: auto; + margin-right: auto; + float: none; + } + .m-col-l-1 { width: calc(1 * 100% / 12); } + .m-col-l-2 { width: calc(2 * 100% / 12); } + .m-col-l-3 { width: calc(3 * 100% / 12); } + .m-col-l-4 { width: calc(4 * 100% / 12); } + .m-col-l-5 { width: calc(5 * 100% / 12); } + .m-col-l-6 { width: calc(6 * 100% / 12); } + .m-col-l-7 { width: calc(7 * 100% / 12); } + .m-col-l-8 { width: calc(8 * 100% / 12); } + .m-col-l-9 { width: calc(9 * 100% / 12); } + .m-col-l-10 { width: calc(10 * 100% / 12); } + .m-col-l-11 { width: calc(11 * 100% / 12); } + .m-col-l-12 { width: calc(12 * 100% / 12); } + .m-push-l-0 { left: calc(0 * 100% / 12); } + .m-push-l-1 { left: calc(1 * 100% / 12); } + .m-push-l-2 { left: calc(2 * 100% / 12); } + .m-push-l-3 { left: calc(3 * 100% / 12); } + .m-push-l-4 { left: calc(4 * 100% / 12); } + .m-push-l-5 { left: calc(5 * 100% / 12); } + .m-push-l-6 { left: calc(6 * 100% / 12); } + .m-push-l-7 { left: calc(7 * 100% / 12); } + .m-push-l-8 { left: calc(8 * 100% / 12); } + .m-push-l-9 { left: calc(9 * 100% / 12); } + .m-push-l-10 { left: calc(10 * 100% / 12); } + .m-push-l-11 { left: calc(11 * 100% / 12); } + .m-pull-l-0 { right: calc(0 * 100% / 12); } + .m-pull-l-1 { right: calc(1 * 100% / 12); } + .m-pull-l-2 { right: calc(2 * 100% / 12); } + .m-pull-l-3 { right: calc(3 * 100% / 12); } + .m-pull-l-4 { right: calc(4 * 100% / 12); } + .m-pull-l-5 { right: calc(5 * 100% / 12); } + .m-pull-l-6 { right: calc(6 * 100% / 12); } + .m-pull-l-7 { right: calc(7 * 100% / 12); } + .m-pull-l-8 { right: calc(8 * 100% / 12); } + .m-pull-l-9 { right: calc(9 * 100% / 12); } + .m-pull-l-10 { right: calc(10 * 100% / 12); } + .m-pull-l-11 { right: calc(11 * 100% / 12); } + .m-clearfix-m::after { display: none; } + .m-hide-l { display: none; } + .m-show-l { display: block; } + .m-col-l-none { + width: auto; + float: none; + } +} + +html { + font-size: 16px; + background-color: #2f363f; +} +body { + font-family: 'Source Sans Pro', sans-serif; + font-size: 1rem; + line-height: normal; + color: #dcdcdc; +} +h1, h2, h3, h4, h5, h6 { + margin-top: 0; + font-weight: 600; +} +h1 { + margin-bottom: 1rem; +} +h2, h3, h4, h5, h6 { + margin-bottom: 0.5rem; +} +p, ul, ol, dl { + margin-top: 0; +} +ul, ol { + padding-left: 2rem; +} +ul ol, ul ul, ol ol, ol ul { + margin-bottom: 0; +} +main p { + text-indent: 1.5rem; + text-align: justify; +} +main p.m-noindent, li > p, dd > p, table.m-table td > p { + text-indent: 0; + text-align: left; +} +blockquote { + margin-top: 0; + margin-left: 1rem; + margin-right: 1rem; + padding: 1rem; + border-left-style: solid; + border-left-width: 0.25rem; +} +hr { + width: 75%; + border-width: 0.0625rem; + border-style: solid; +} +blockquote, hr { + border-color: #405363; +} +strong, .m-text.m-strong { font-weight: bold; } +em, .m-text.m-em { font-style: italic; } +s, .m-text.m-s { text-decoration: line-through; } +sub, sup, .m-text.m-sub, .m-text.m-sup { + font-size: 0.75rem; + line-height: 0; + position: relative; + vertical-align: baseline; +} +sup, .m-text.m-sup { top: -0.35rem; } +sub, .m-text.m-sub { bottom: -0.2rem; } +abbr { + cursor: help; + text-decoration: underline dotted; +} +a { + color: #5b9dd9; +} +a.m-flat { + text-decoration: none; +} +a:hover, a:focus, a:active { + color: #a5c9ea; +} +a img { border: 0; } +svg a { cursor: pointer; } +mark { + padding: 0.0625rem; + background-color: #c7cf2f; + color: #2f83cc; +} +.m-link-wrap { + word-break: break-all; +} +pre, code { + font-family: 'Source Code Pro', monospace, monospace, monospace; + font-size: 0.9em; + color: #e6e6e6; + background-color: #282e36; +} +pre.m-console, code.m-console { + color: #e6e6e6; + background-color: #1a1c1d; +} +pre { + padding: 0.5rem 1rem; + border-radius: 0.2rem; + overflow-x: auto; + margin-top: 0; +} +pre.m-console-wrap { + white-space: pre-wrap; + word-break: break-all; +} +code { + padding: 0.125rem; +} +*:focus { outline-color: #5b9dd9; } +div.m-scroll { + max-width: 100%; + overflow-x: auto; +} +.m-fullwidth { + width: 100%; +} +.m-spacing-150 { + line-height: 1.5rem; +} +.m-text-center, .m-text-center.m-noindent, table.m-table th.m-text-center, .m-text-center p { + text-align: center; +} +.m-text-left, .m-text-left.m-noindent, table.m-table th.m-text-left, .m-text-right p { + text-align: left; +} +.m-text-right, .m-text-right.m-noindent, table.m-table th.m-text-right, .m-text-right p { + text-align: right; +} +.m-text-top, table.m-table th.m-text-top, table.m-table td.m-text-top { + vertical-align: top; +} +.m-text-middle, table.m-table th.m-text-middle, table.m-table td.m-text-middle { + vertical-align: middle; +} +.m-text-bottom, table.m-table th.m-text-bottom, table.m-table td.m-text-bottom { + vertical-align: bottom; +} +.m-text.m-tiny { font-size: 50.0%; } +.m-text.m-small { font-size: 85.4%; } +.m-text.m-big { font-size: 117%; } +h1 .m-thin, h2 .m-thin, h3 .m-thin, h4 .m-thin, h5 .m-thin, h6 .m-thin { + font-weight: normal; +} +ul.m-unstyled, ol.m-unstyled { + list-style-type: none; + padding-left: 0; +} +ul[class*='m-block-'], ol[class*='m-block-'] { + padding-left: 0; +} +ul[class*='m-block-'] li, ol[class*='m-block-'] li { + display: inline; +} +ul[class*='m-block-bar-'] li:not(:last-child)::after, ol[class*='m-block-bar-'] li:not(:last-child)::after { + content: " | "; +} +ul[class*='m-block-dot-'] li:not(:last-child)::after, ol[class*='m-block-dot-'] li:not(:last-child)::after { + content: " • "; +} +@media screen and (min-width: 576px) { + ul.m-block-bar-s, ol.m-block-bar-s, + ul.m-block-dot-s, ol.m-block-dot-s { padding-left: 2rem; } + ul.m-block-bar-s li, ol.m-block-bar-s li, + ul.m-block-dot-s li, ol.m-block-dot-s li { display: list-item; } + ul.m-block-bar-s li:not(:last-child)::after, ol.m-block-bar-s li:not(:last-child)::after, + ul.m-block-dot-s li:not(:last-child)::after, ol.m-block-dot-s li:not(:last-child)::after { content: ""; } +} +@media screen and (min-width: 768px) { + ul.m-block-bar-m, ol.m-block-bar-m, + ul.m-block-dot-m, ol.m-block-dot-m { padding-left: 2rem; } + ul.m-block-bar-m li, ol.m-block-bar-m li, + ul.m-block-dot-m li, ol.m-block-dot-m li { display: list-item; } + ul.m-block-bar-m li:not(:last-child)::after, ol.m-block-bar-m li:not(:last-child)::after, + ul.m-block-dot-m li:not(:last-child)::after, ol.m-block-dot-m li:not(:last-child)::after { content: ""; } +} +@media screen and (min-width: 992px) { + ul.m-block-bar-l, ol.m-block-bar-l, + ul.m-block-dot-l, ol.m-block-dot-l { padding-left: 2rem; } + ul.m-block-bar-l li, ol.m-block-bar-l li, + ul.m-block-dot-l li, ol.m-block-dot-l li { display: list-item; } + ul.m-block-bar-l li:not(:last-child)::after, ol.m-block-bar-l li:not(:last-child)::after, + ul.m-block-dot-l li:not(:last-child)::after, ol.m-block-dot-l li:not(:last-child)::after { content: ""; } +} +p.m-poem { + text-indent: 0; + text-align: left; + margin-left: 1.5rem; +} +p.m-transition { + color: #405363; + text-indent: 0; + text-align: center; + font-size: 2rem; +} +dl.m-diary { + margin-bottom: 1.25rem; +} +dl.m-diary:last-child { + margin-bottom: 0.25rem; +} +dl.m-diary dt { + font-weight: bold; + width: 6rem; + float: left; + clear: both; + padding-top: 0.25rem; +} +dl.m-diary dd { + padding-top: 0.25rem; + padding-left: 6rem; + margin-left: 0; +} +a.m-footnote, dl.m-footnote dd span.m-footnote { + top: -0.35rem; + font-size: 0.75rem; + line-height: 0; + position: relative; + vertical-align: baseline; +} +a.m-footnote, dl.m-footnote dd span.m-footnote a { + text-decoration: none; +} +a.m-footnote::before { content: '['; } +a.m-footnote::after { content: ']'; } +dl.m-footnote dt { + width: 1.5rem; + float: left; + clear: both; +} +dl.m-footnote dd { + margin-left: 1.5rem; +} +dl.m-footnote { + font-size: 85.4%; +} +dl.m-footnote dd span.m-footnote a { + font-weight: bold; + font-style: italic; +} +.m-note { + border-radius: 0.2rem; + padding: 1rem; +} +.m-frame { + background-color: #2f363f; + border-style: solid; + border-width: 0.125rem; + border-radius: 0.2rem; + border-color: #405363; + padding: 0.875rem; +} +.m-block { + border-style: solid; + border-width: 0.0625rem; + border-left-width: 0.25rem; + border-radius: 0.2rem; + border-color: #405363; + padding: 0.9375rem 0.9375rem 0.9375rem 0.75rem; +} +.m-block.m-badge::after { + content: ' '; + display: block; + clear: both; +} +.m-block.m-badge h3 { + margin-left: 5rem; +} +.m-block.m-badge p { + margin-left: 5rem; + text-indent: 0; +} +.m-block.m-badge img { + width: 4rem; + height: 4rem; + border-radius: 2rem; + float: left; +} +div.m-button { + text-align: center; +} +div.m-button a { + display: inline-block; + border-radius: 0.2rem; + padding-top: 0.75rem; + padding-bottom: 0.75rem; + padding-left: 1.5rem; + padding-right: 1.5rem; + text-decoration: none; + font-size: 1.17rem; +} +div.m-button.m-fullwidth a { + display: block; + padding-left: 0.5rem; + padding-right: 0.5rem; +} +div.m-button a .m-big:first-child { + font-size: 1.37rem; + font-weight: bold; +} +div.m-button a .m-small:last-child { + font-size: 0.854rem; +} +.m-label { + border-radius: 0.2rem; + font-size: 75%; + font-weight: normal; + padding: 0.125rem 0.25rem; + vertical-align: 7.5%; +} +.m-label.m-flat { + border-width: 0.0625rem; + border-style: solid; + border-color: #747474; + padding: 0.0625rem 0.1875rem; +} +table.m-table { + border-collapse: collapse; + margin-left: auto; + margin-right: auto; +} +table.m-table.m-big { + margin-top: 1.75rem; +} +div.m-scroll > table.m-table:last-child { + margin-bottom: 0.0625rem; +} +table.m-table:not(.m-flat) tbody tr:hover { + background-color: #405363; +} +table.m-table th, table.m-table td { + vertical-align: top; + border-style: solid; + border-top-width: 0.0625rem; + border-left-width: 0; + border-right-width: 0; + border-bottom-width: 0; + border-color: #405363; +} +table.m-table caption { + padding-bottom: 0.5rem; +} +table.m-table thead tr:first-child th, table.m-table thead tr:first-child td { + border-top-width: 0.125rem; +} +table.m-table thead th, table.m-table thead td { + border-bottom-width: 0.125rem; + vertical-align: bottom; +} +table.m-table tfoot th, table.m-table tfoot td { + border-top-width: 0.125rem; +} +table.m-table th, table.m-table td { + padding: 0.5rem; +} +table.m-table.m-big th, table.m-table.m-big td { + padding: 0.75rem 1rem; +} +table.m-table th { + text-align: left; +} +table.m-table th.m-thin { + font-weight: normal; +} +table.m-table td.m-default, table.m-table th.m-default, +table.m-table td.m-primary, table.m-table th.m-primary, +table.m-table td.m-success, table.m-table th.m-success, +table.m-table td.m-warning, table.m-table th.m-warning, +table.m-table td.m-danger, table.m-table th.m-danger, +table.m-table td.m-info, table.m-table th.m-info, +table.m-table td.m-dim, table.m-table th.m-dim { + padding-left: 0.4375rem; + padding-right: 0.4375rem; + border-left-width: 0.0625rem; +} +table.m-table.m-big td.m-default, table.m-table.m-big th.m-default, +table.m-table.m-big td.m-primary, table.m-table.m-big th.m-primary, +table.m-table.m-big td.m-success, table.m-table.m-big th.m-success, +table.m-table.m-big td.m-warning, table.m-table.m-big th.m-warning, +table.m-table.m-big td.m-danger, table.m-table.m-big th.m-danger, +table.m-table.m-big td.m-info, table.m-table.m-big th.m-info, +table.m-table.m-big td.m-dim, table.m-table.m-big th.m-dim { + padding-left: 0.9375rem; + padding-right: 0.9375rem; + border-left-width: 0.0625rem; +} +table.m-table tr.m-default td, table.m-table td.m-default, +table.m-table tr.m-default th, table.m-table th.m-default, +table.m-table tr.m-primary td, table.m-table td.m-primary, +table.m-table tr.m-primary th, table.m-table th.m-primary, +table.m-table tr.m-success td, table.m-table td.m-success, +table.m-table tr.m-success th, table.m-table th.m-success, +table.m-table tr.m-warning td, table.m-table td.m-warning, +table.m-table tr.m-warning th, table.m-table th.m-warning, +table.m-table tr.m-danger td, table.m-table td.m-danger, +table.m-table tr.m-danger th, table.m-table th.m-danger, +table.m-table tr.m-info td, table.m-table td.m-info, +table.m-table tr.m-info th, table.m-table th.m-info, +table.m-table tr.m-dim td, table.m-table td.m-dim, +table.m-table tr.m-dim th, table.m-table th.m-dim { + border-color: #2f363f; +} +.m-note pre, .m-note code, +table.m-table tr.m-default pre, table.m-table tr.m-default code, +table.m-table td.m-default pre, table.m-table td.m-default code, +table.m-table th.m-default pre, table.m-table th.m-default code, +table.m-table tr.m-primary pre, table.m-table tr.m-primary code, +table.m-table td.m-primary pre, table.m-table td.m-primary code, +table.m-table th.m-primary pre, table.m-table th.m-primary code, +table.m-table tr.m-success pre, table.m-table tr.m-success code, +table.m-table td.m-success pre, table.m-table td.m-success code, +table.m-table th.m-success pre, table.m-table th.m-success code, +table.m-table tr.m-warning pre, table.m-table tr.m-warning code, +table.m-table td.m-warning pre, table.m-table td.m-warning code, +table.m-table th.m-warning pre, table.m-table th.m-warning code, +table.m-table tr.m-danger pre, table.m-table tr.m-danger code, +table.m-table td.m-danger pre, table.m-table td.m-danger code, +table.m-table th.m-danger pre, table.m-table th.m-danger code, +table.m-table tr.m-info pre, table.m-table tr.m-info code, +table.m-table td.m-info pre, table.m-table td.m-info code, +table.m-table th.m-info pre, table.m-table th.m-info code, +table.m-table tr.m-dim pre, table.m-table tr.m-dim code, +table.m-table td.m-dim pre, table.m-table td.m-dim code, +table.m-table th.m-dim pre, table.m-table th.m-dim code { + background-color: rgba(34, 39, 46, 0.5); +} +img.m-image, svg.m-image { + display: block; + margin-left: auto; + margin-right: auto; +} +div.m-image { + text-align: center; +} +img.m-image, svg.m-image, div.m-image img, div.m-image svg { + max-width: 100%; + border-radius: 0.2rem; +} +div.m-image.m-fullwidth img, div.m-image.m-fullwidth svg { + width: 100%; +} +img.m-image.m-badge, div.m-image.m-badge img { + border-radius: 50%; +} +figure.m-figure { + max-width: 100%; + margin-top: 0; + margin-left: auto; + margin-right: auto; + position: relative; + display: table; +} +figure.m-figure::before { + position: absolute; + content: ' '; + top: 0; + bottom: 0; + left: 0; + right: 0; + z-index: -1; + border-style: solid; + border-width: 0.125rem; + border-radius: 0.2rem; + border-color: #405363; +} +figure.m-figure.m-flat::before { + border-color: transparent; +} +figure.m-figure > * { + margin-left: 1rem; + margin-right: 1rem; + display: table-caption; + caption-side: bottom; +} +figure.m-figure > *:first-child { + display: inline; +} +figure.m-figure > *:last-child { + margin-bottom: 1rem !important; +} +figure.m-figure img, figure.m-figure svg { + position: relative; + margin-left: 0; + margin-right: 0; + margin-bottom: 0; + border-top-left-radius: 0.2rem; + border-top-right-radius: 0.2rem; + max-width: 100%; +} +figure.m-figure.m-flat img, figure.m-figure.m-flat svg { + border-bottom-left-radius: 0.2rem; + border-bottom-right-radius: 0.2rem; +} +figure.m-figure a img, figure.m-figure a svg { + margin-left: -1rem; + margin-right: -1rem; +} +figure.m-figure.m-fullwidth, figure.m-figure.m-fullwidth > * { + display: block; +} +figure.m-figure.m-fullwidth > *:first-child { + display: inline; +} +figure.m-figure.m-fullwidth img, figure.m-figure.m-fullwidth svg { + width: 100%; +} +figure.m-figure.m-fullwidth::after { + content: ' '; + display: block; + margin-top: 1rem; + height: 1px; +} +.m-code-figure, .m-console-figure { + margin-top: 0; + margin-left: 0; + margin-right: 0; + position: relative; + padding: 1rem; +} +.m-code-figure::before, .m-console-figure::before { + position: absolute; + content: ' '; + top: 0; + bottom: 0; + left: 0; + right: 0; + z-index: -1; + border-style: solid; + border-width: 0.125rem; + border-radius: 0.2rem; +} +.m-code-figure::before { + border-color: #282e36; +} +.m-console-figure::before { + border-color: #1a1c1d; +} +.m-code-figure.m-flat::before, .m-console-figure.m-flat::before { + border-color: transparent; +} +.m-code-figure > pre:first-child, .m-console-figure > pre:first-child { + position: relative; + margin: -1rem -1rem 1rem -1rem; + border-bottom-left-radius: 0; + border-bottom-right-radius: 0; +} +.m-code-figure > pre.m-nopad, .m-console-figure > pre.m-nopad { + margin-left: -0.875rem; + margin-right: -0.875rem; + margin-top: -1rem; + margin-bottom: -0.875rem; + padding-left: 0.875rem; +} +figure.m-figure figcaption, .m-code-figure figcaption, .m-console-figure figcaption { + margin-top: 0.5rem; + margin-bottom: 0.5rem; + font-weight: 600; + font-size: 1.17rem; +} +figure.m-figure figcaption a, .m-code-figure figcaption a, .m-console-figure figcaption a { + text-decoration: none; +} +figure.m-figure figcaption .m-figure-description { + margin-top: 0.5rem; + font-weight: normal; + font-size: 1rem; +} +figure.m-figure figcaption .m-figure-description a { + text-decoration: underline; +} +.m-imagegrid > div { + background-color: #2f363f; +} +.m-imagegrid > div > figure { + display: block; + float: left; + position: relative; + margin: 0; +} +.m-imagegrid > div > figure > div, +.m-imagegrid > div > figure > figcaption, +.m-imagegrid > div > figure > a > div, +.m-imagegrid > div > figure > a > figcaption { + position: absolute; + top: 0; + left: 0; + width: 100%; + height: 100%; + border-color: #2f363f; + border-style: solid; + border-width: 0.25rem; + padding: 0.5rem; +} +.m-imagegrid > div > figure:first-child > div, +.m-imagegrid > div > figure:first-child > figcaption, +.m-imagegrid > div > figure:first-child > a > div, +.m-imagegrid > div > figure:first-child > a > figcaption { + border-left-width: 0; +} +.m-imagegrid > div > figure:last-child > div, +.m-imagegrid > div > figure:last-child > figcaption, +.m-imagegrid > div > figure:last-child > a > div, +.m-imagegrid > div > figure:last-child > a > figcaption { + border-right-width: 0; +} +.m-imagegrid > div > figure > figcaption, +.m-imagegrid > div > figure > a > figcaption { + color: transparent; + overflow: hidden; + text-overflow: ellipsis; + white-space: nowrap; + font-size: 0.75rem; +} +.m-imagegrid > div > figure > div::before, +.m-imagegrid > div > figure > figcaption::before, +.m-imagegrid > div > figure > a > div::before, +.m-imagegrid > div > figure > a > figcaption::before { + content: ''; + display: inline-block; + height: 100%; + vertical-align: bottom; + width: 0; +} +.m-imagegrid > div > figure:hover > figcaption, +.m-imagegrid > div > figure:hover > a > figcaption { + background: linear-gradient(transparent 0%, transparent 75%, rgba(0, 0, 0, 0.85) 100%); + color: #ffffff; +} +.m-imagegrid > div > figure > img, +.m-imagegrid > div > figure > a > img { + width: 100%; + height: 100%; +} +.m-imagegrid > div::after { + display: block; + content: ' '; + clear: both; +} +@media screen and (max-width: 767px) { + .m-imagegrid > div > figure { + float: none; + width: 100% !important; + } + .m-imagegrid > div > figure > div, + .m-imagegrid > div > figure > figcaption, + .m-imagegrid > div > figure > a > div, + .m-imagegrid > div > figure > a > figcaption { + border-left-width: 0; + border-right-width: 0; + } +} +.m-container-inflatable > .m-row > [class*='m-col-'] > .m-note, +.m-container-inflatable > .m-row > [class*='m-col-'] > .m-frame, +.m-container-inflatable > .m-row > [class*='m-col-'] > .m-block, +.m-container-inflatable > .m-row > [class*='m-col-'] > .m-imagegrid, +.m-container-inflatable > .m-row > [class*='m-col-'] > pre, +.m-container-inflatable > .m-row > [class*='m-col-'] > .m-code-figure, +.m-container-inflatable > .m-row > [class*='m-col-'] > .m-console-figure, +.m-container-inflatable > .m-row > [class*='m-col-'] section > .m-note, +.m-container-inflatable > .m-row > [class*='m-col-'] section > .m-frame, +.m-container-inflatable > .m-row > [class*='m-col-'] section > .m-block, +.m-container-inflatable > .m-row > [class*='m-col-'] section > .m-imagegrid, +.m-container-inflatable > .m-row > [class*='m-col-'] section > pre, +.m-container-inflatable > .m-row > [class*='m-col-'] section > .m-code-figure, +.m-container-inflatable > .m-row > [class*='m-col-'] section > .m-console-figure, +.m-container-inflatable [class*='m-center-'] > .m-note, +.m-container-inflatable [class*='m-center-'] > .m-frame, +.m-container-inflatable [class*='m-center-'] > .m-block, +.m-container-inflatable [class*='m-center-'] > .m-imagegrid, +.m-container-inflatable [class*='m-center-'] > pre, +.m-container-inflatable [class*='m-center-'] > .m-code-figure, +.m-container-inflatable [class*='m-center-'] > .m-console-figure, +.m-container-inflatable [class*='m-left-'] > .m-note, +.m-container-inflatable [class*='m-left-'] > .m-frame, +.m-container-inflatable [class*='m-left-'] > .m-block, +.m-container-inflatable [class*='m-left-'] > .m-imagegrid, +.m-container-inflatable [class*='m-left-'] > pre, +.m-container-inflatable [class*='m-left-'] > .m-code-figure, +.m-container-inflatable [class*='m-left-'] > .m-console-figure, +.m-container-inflatable [class*='m-right-'] > .m-note, +.m-container-inflatable [class*='m-right-'] > .m-frame, +.m-container-inflatable [class*='m-right-'] > .m-block, +.m-container-inflatable [class*='m-right-'] > .m-imagegrid, +.m-container-inflatable [class*='m-right-'] > pre, +.m-container-inflatable [class*='m-right-'] > .m-code-figure, +.m-container-inflatable [class*='m-right-'] > .m-console-figure, +.m-container-inflatable .m-container-inflate > .m-note, +.m-container-inflatable .m-container-inflate > .m-frame, +.m-container-inflatable .m-container-inflate > .m-block, +.m-container-inflatable .m-container-inflate > .m-imagegrid, +.m-container-inflatable .m-container-inflate > pre, +.m-container-inflatable .m-container-inflate > .m-code-figure, +.m-container-inflatable .m-container-inflate > .m-console-figure +{ + margin-left: -1rem; + margin-right: -1rem; +} +@media screen and (min-width: 576px) { + .m-container-inflatable .m-center-s > .m-note, + .m-container-inflatable .m-center-s > .m-frame, + .m-container-inflatable .m-center-s > .m-block, + .m-container-inflatable .m-center-s > .m-imagegrid, + .m-container-inflatable .m-center-s > pre, + .m-container-inflatable .m-center-s > .m-code-figure, + .m-container-inflatable .m-center-s > .m-console-figure { + margin-left: -1rem; + margin-right: -1rem; + } + .m-container-inflatable .m-left-s > .m-note, + .m-container-inflatable .m-left-s > .m-frame, + .m-container-inflatable .m-left-s > .m-block, + .m-container-inflatable .m-left-s > .m-imagegrid, + .m-container-inflatable .m-left-s > pre, + .m-container-inflatable .m-left-s > .m-code-figure, + .m-container-inflatable .m-left-s > .m-console-figure { + margin-left: -1rem; + margin-right: 0; + } + .m-container-inflatable .m-right-s > .m-note, + .m-container-inflatable .m-right-s > .m-frame, + .m-container-inflatable .m-right-s > .m-block, + .m-container-inflatable .m-right-s > .m-imagegrid, + .m-container-inflatable .m-right-s > pre, + .m-container-inflatable .m-right-s > .m-code-figure, + .m-container-inflatable .m-right-s > .m-console-figure { + margin-left: 0; + margin-right: -1rem; + } + .m-container-inflatable > .m-row > .m-col-s-10 > .m-imagegrid.m-container-inflate, + .m-container-inflatable > .m-row > .m-col-s-10 section > .m-imagegrid.m-container-inflate { + margin-left: -10%; + margin-right: -10%; + } +} +@media screen and (min-width: 768px) { + .m-container-inflatable .m-center-m > .m-note, + .m-container-inflatable .m-center-m > .m-frame, + .m-container-inflatable .m-center-m > .m-block, + .m-container-inflatable .m-center-m > .m-imagegrid, + .m-container-inflatable .m-center-m > pre, + .m-container-inflatable .m-center-m > .m-code-figure, + .m-container-inflatable .m-center-m > .m-console-figure { + margin-left: -1rem; + margin-right: -1rem; + } + .m-container-inflatable .m-left-m > .m-note, + .m-container-inflatable .m-left-m > .m-frame, + .m-container-inflatable .m-left-m > .m-block, + .m-container-inflatable .m-left-m > .m-imagegrid, + .m-container-inflatable .m-left-m > pre, + .m-container-inflatable .m-left-m > .m-code-figure, + .m-container-inflatable .m-left-m > .m-console-figure { + margin-left: -1rem; + margin-right: 0; + } + .m-container-inflatable .m-right-m > .m-note, + .m-container-inflatable .m-right-m > .m-frame, + .m-container-inflatable .m-right-m > .m-block, + .m-container-inflatable .m-right-m > .m-imagegrid, + .m-container-inflatable .m-right-m > pre, + .m-container-inflatable .m-right-m > .m-code-figure, + .m-container-inflatable .m-right-m > .m-console-figure { + margin-left: 0; + margin-right: -1rem; + } + .m-container-inflatable > .m-row > .m-col-m-10 > .m-imagegrid.m-container-inflate, + .m-container-inflatable > .m-row > .m-col-m-10 section > .m-imagegrid.m-container-inflate { + margin-left: -10%; + margin-right: -10%; + } +} +@media screen and (min-width: 992px) { + .m-container-inflatable .m-center-l > .m-note, + .m-container-inflatable .m-center-l > .m-frame, + .m-container-inflatable .m-center-l > .m-block, + .m-container-inflatable .m-center-l > .m-imagegrid, + .m-container-inflatable .m-center-l > pre, + .m-container-inflatable .m-center-l > .m-code-figure, + .m-container-inflatable .m-center-l > .m-console-figure { + margin-left: -1rem; + margin-right: -1rem; + } + .m-container-inflatable .m-left-l > .m-note, + .m-container-inflatable .m-left-l > .m-frame, + .m-container-inflatable .m-left-l > .m-block, + .m-container-inflatable .m-left-l > .m-imagegrid, + .m-container-inflatable .m-left-l > pre, + .m-container-inflatable .m-left-l > .m-code-figure, + .m-container-inflatable .m-left-l > .m-console-figure { + margin-left: -1rem; + margin-right: 0; + } + .m-container-inflatable .m-right-l > .m-note, + .m-container-inflatable .m-right-l > .m-frame, + .m-container-inflatable .m-right-l > .m-block, + .m-container-inflatable .m-right-l > .m-imagegrid, + .m-container-inflatable .m-right-l > pre, + .m-container-inflatable .m-right-l > .m-code-figure, + .m-container-inflatable .m-right-l > .m-console-figure { + margin-left: 0; + margin-right: -1rem; + } + .m-container-inflatable > .m-row > .m-col-l-10 > .m-imagegrid.m-container-inflate, + .m-container-inflatable > .m-row > .m-col-l-10 section > .m-imagegrid.m-container-inflate { + margin-left: -10%; + margin-right: -10%; + } +} +pre.m-code span.hll { + margin-left: -1.0rem; + margin-right: -1.0rem; + padding-left: 1.0rem; +} +.m-code.m-inverted > span, .m-console.m-inverted > span { + opacity: 0.3333; +} +.m-code.m-inverted > span.hll, .m-console.m-inverted > span.hll { + opacity: 1; + background-color: transparent; + border-color: transparent; +} +.m-code.m-inverted { color: rgba(230, 230, 230, 0.33); } +.m-console.m-inverted { color: rgba(230, 230, 230, 0.33); } +.m-code.m-inverted > span.hll { color: #e6e6e6; } +.m-cosole.m-inverted > span.hll { color: #e6e6e6; } +.m-code-color { + display: inline-block; + width: 0.75rem; + height: 0.75rem; + vertical-align: -0.05rem; + margin-left: 0.2rem; + margin-right: 0.1rem; + border-radius: 0.1rem; +} +div.m-math { + overflow-x: auto; + overflow-y: hidden; +} +div.m-math svg { + margin-left: auto; + margin-right: auto; + display: block; +} +div.m-button a svg.m-math { fill: #22272e; } +div.m-button.m-flat a svg.m-math { fill: #dcdcdc; } +div.m-button.m-flat a:hover svg.m-math, div.m-button.m-default a:focus svg.m-math, +div.m-button.m-default a:active svg.m-math { + fill: #a5c9ea; +} +.m-graph { font-size: 16px; } +div.m-plot svg, div.m-graph svg { + max-width: 100%; + margin-left: auto; + margin-right: auto; + display: block; +} +div.m-plot .m-background { fill: #34424d; } +div.m-plot svg .m-label { font-size: 11px; } +div.m-plot svg .m-title { font-size: 13px; } +div.m-plot svg .m-label, div.m-plot svg .m-title { fill: #dcdcdc; } +div.m-plot svg .m-line { + stroke: #dcdcdc; + stroke-width: 0.8; +} +div.m-plot svg .m-error { + stroke: #ffffff; + stroke-width: 1.5; +} +div.m-plot svg .m-label.m-dim { fill: #747474; } +.m-graph g.m-edge path, .m-graph g.m-cluster polygon, +.m-graph g.m-node.m-flat ellipse, +.m-graph g.m-node.m-flat polygon { + fill: none; +} +.m-graph g.m-node:not(.m-flat) text { + fill: #22272e; +} +figure.m-figure > svg.m-math:first-child, +figure.m-figure > svg.m-graph:first-child { + padding: 1rem; + box-sizing: content-box; +} +figure.m-figure:not(.m-flat) > svg.m-math:first-child, +figure.m-figure:not(.m-flat) > svg.m-graph:first-child { + background-color: #405363; +} +.m-block.m-default { border-left-color: #405363; } +.m-block.m-default h3, .m-block.m-default h4, .m-block.m-default h5, .m-block.m-default h6, +.m-text.m-default, .m-label.m-flat.m-default { + color: #dcdcdc; +} +.m-block.m-default h3 a, .m-block.m-default h4 a, .m-block.m-default h5 a, .m-block.m-default h6 a { + color: #5b9dd9; +} +.m-block.m-primary { border-left-color: #a5c9ea; } +.m-block.m-primary h3, .m-block.m-primary h4, .m-block.m-primary h5, .m-block.m-primary h6, +.m-block.m-primary h3 a, .m-block.m-primary h4 a, .m-block.m-primary h5 a, .m-block.m-primary h6 a, +.m-text.m-primary, .m-label.m-flat.m-primary { + color: #a5c9ea; +} +.m-block.m-success { border-left-color: #3bd267; } +.m-block.m-success h3, .m-block.m-success h4, .m-block.m-success h5, .m-block.m-success h6, +.m-block.m-success h3 a, .m-block.m-success h4 a, .m-block.m-success h5 a, .m-block.m-success h6 a, +.m-text.m-success, .m-label.m-flat.m-success { + color: #3bd267; +} +.m-block.m-warning { border-left-color: #c7cf2f; } +.m-block.m-warning h3, .m-block.m-warning h4, .m-block.m-warning h5, .m-block.m-warning h6, +.m-block.m-warning h3 a, .m-block.m-warning h4 a, .m-block.m-warning h5 a, .m-block.m-warning h6 a, +.m-text.m-warning, .m-label.m-flat.m-warning { + color: #c7cf2f; +} +.m-block.m-danger { border-left-color: #cd3431; } +.m-block.m-danger h3, .m-block.m-danger h4, .m-block.m-danger h5, .m-block.m-danger h6, +.m-block.m-danger h3 a, .m-block.m-danger h4 a, .m-block.m-danger h5 a, .m-block.m-danger h6 a, +.m-text.m-danger, .m-label.m-flat.m-danger { + color: #cd3431; +} +.m-block.m-info { border-left-color: #2f83cc; } +.m-block.m-info h3, .m-block.m-info h4, .m-block.m-info h5, .m-block.m-info h6, +.m-block.m-info h3 a, .m-block.m-info h4 a, .m-block.m-info h5 a, .m-block.m-info h6 a, +.m-text.m-info, .m-label.m-flat.m-info { + color: #2f83cc; +} +.m-block.m-dim { border-left-color: #747474; } +.m-block.m-dim, .m-text.m-dim, .m-label.m-flat.m-dim { + color: #747474; +} +.m-block.m-dim a, .m-text.m-dim a { color: #acacac; } +.m-block.m-dim a:hover, .m-block.m-dim a:focus, .m-block.m-dim a:active, +.m-text.m-dim a:hover, .m-text.m-dim a:focus, .m-text.m-dim a:active { + color: #747474; +} +.m-block.m-flat { border-color: transparent; } +.m-block.m-flat h3, .m-block.m-flat h4, .m-block.m-flat h5, .m-block.m-flat h6 { + color: #dcdcdc; +} +.m-block.m-default h3 a:hover, .m-block.m-default h3 a:focus, .m-block.m-default h3 a:active, +.m-block.m-default h4 a:hover, .m-block.m-default h4 a:focus, .m-block.m-default h4 a:active, +.m-block.m-default h5 a:hover, .m-block.m-default h5 a:focus, .m-block.m-default h5 a:active, +.m-block.m-default h6 a:hover, .m-block.m-default h6 a:focus, .m-block.m-default h6 a:active { + color: #a5c9ea; +} +.m-block.m-primary h3 a:hover, .m-block.m-primary h3 a:focus, .m-block.m-primary h3 a:active, +.m-block.m-primary h4 a:hover, .m-block.m-primary h4 a:focus, .m-block.m-primary h4 a:active, +.m-block.m-primary h5 a:hover, .m-block.m-primary h5 a:focus, .m-block.m-primary h5 a:active, +.m-block.m-primary h6 a:hover, .m-block.m-primary h6 a:focus, .m-block.m-primary h6 a:active { + color: #dcdcdc; +} +.m-block.m-success h3 a:hover, .m-block.m-success h3 a:focus, .m-block.m-success h3 a:active, +.m-block.m-success h4 a:hover, .m-block.m-success h4 a:focus, .m-block.m-success h4 a:active, +.m-block.m-success h5 a:hover, .m-block.m-success h5 a:focus, .m-block.m-success h5 a:active, +.m-block.m-success h6 a:hover, .m-block.m-success h6 a:focus, .m-block.m-success h6 a:active { + color: #acecbe; +} +.m-block.m-warning h3 a:hover, .m-block.m-warning h3 a:focus, .m-block.m-warning h3 a:active, +.m-block.m-warning h4 a:hover, .m-block.m-warning h4 a:focus, .m-block.m-warning h4 a:active, +.m-block.m-warning h5 a:hover, .m-block.m-warning h5 a:focus, .m-block.m-warning h5 a:active, +.m-block.m-warning h6 a:hover, .m-block.m-warning h6 a:focus, .m-block.m-warning h6 a:active { + color: #e9ecae; +} +.m-block.m-danger h3 a:hover, .m-block.m-danger h3 a:focus, .m-block.m-danger h3 a:active, +.m-block.m-danger h4 a:hover, .m-block.m-danger h4 a:focus, .m-block.m-danger h4 a:active, +.m-block.m-danger h5 a:hover, .m-block.m-danger h5 a:focus, .m-block.m-danger h5 a:active, +.m-block.m-danger h6 a:hover, .m-block.m-danger h6 a:focus, .m-block.m-danger h6 a:active { + color: #ff9391; +} +.m-block.m-info h3 a:hover, .m-block.m-info h3 a:focus, .m-block.m-info h3 a:active, +.m-block.m-info h4 a:hover, .m-block.m-info h4 a:focus, .m-block.m-info h4 a:active, +.m-block.m-info h5 a:hover, .m-block.m-info h5 a:focus, .m-block.m-info h5 a:active, +.m-block.m-info h6 a:hover, .m-block.m-info h6 a:focus, .m-block.m-info h6 a:active { + color: #5297d7; +} +div.m-button a, .m-label { color: #22272e; } +div.m-button.m-flat a { color: #dcdcdc; } +div.m-button.m-flat a:hover, div.m-button.m-default a:focus, div.m-button.m-default a:active { + color: #a5c9ea; +} +div.m-button.m-default a, .m-label:not(.m-flat).m-default { background-color: #dcdcdc; } +div.m-button.m-primary a, .m-label:not(.m-flat).m-primary { background-color: #a5c9ea; } +div.m-button.m-success a, .m-label:not(.m-flat).m-success { background-color: #3bd267; } +div.m-button.m-warning a, .m-label:not(.m-flat).m-warning { background-color: #c7cf2f; } +div.m-button.m-danger a, .m-label:not(.m-flat).m-danger { background-color: #cd3431; } +div.m-button.m-info a, .m-label:not(.m-flat).m-info { background-color: #2f83cc; } +div.m-button.m-dim a, .m-label:not(.m-flat).m-dim { background-color: #747474; } +div.m-button.m-default a:hover, div.m-button.m-default a:focus, div.m-button.m-default a:active { + background-color: #a5c9ea; +} +div.m-button.m-primary a:hover, div.m-button.m-primary a:focus, div.m-button.m-primary a:active { + background-color: #dcdcdc; +} +div.m-button.m-success a:hover, div.m-button.m-success a:focus, div.m-button.m-success a:active { + background-color: #acecbe; +} +div.m-button.m-warning a:hover, div.m-button.m-warning a:focus, div.m-button.m-warning a:active { + background-color: #e9ecae; +} +div.m-button.m-danger a:hover, div.m-button.m-danger a:focus, div.m-button.m-danger a:active { + background-color: #ff9391; +} +div.m-button.m-info a:hover, div.m-button.m-info a:focus, div.m-button.m-info a:active { + background-color: #5297d7; +} +div.m-button.m-dim a:hover, div.m-button.m-dim a:focus, div.m-button.m-dim a:active { + background-color: #acacac; +} +.m-note.m-default { background-color: #34424d; } +.m-note.m-default, +table.m-table tr.m-default td, table.m-table td.m-default, +table.m-table tr.m-default th, table.m-table th.m-default { + color: #dcdcdc; +} +.m-note.m-default a:hover, +table.m-table tr.m-default td a:hover, table.m-table td.m-default a:hover, +table.m-table tr.m-default th a:hover, table.m-table th.m-default a:hover, +.m-note.m-default a:focus, +table.m-table tr.m-default td a:focus, table.m-table td.m-default a:focus, +table.m-table tr.m-default th a:focus, table.m-table th.m-default a:focus, +.m-note.m-default a:active, +table.m-table tr.m-default td a:active, table.m-table td.m-default a:active, +table.m-table tr.m-default th a:active, table.m-table th.m-default a:active { + color: #a5c9ea; +} +.m-note.m-primary a, +table.m-table tr.m-primary td a, table.m-table td.m-primary a, +table.m-table tr.m-primary th a, table.m-table th.m-primary a { + color: #5b9dd9; +} +.m-note.m-primary, +table.m-table tr.m-primary td, table.m-table td.m-primary, +table.m-table tr.m-primary th, table.m-table th.m-primary { + background-color: #a5c2db; + color: #2f363f; +} +.m-note.m-primary a, +table.m-table tr.m-primary td a, table.m-table td.m-primary a, +table.m-table tr.m-primary th a, table.m-table th.m-primary a { + color: #2a75b6; +} +.m-note.m-primary a:hover, +table.m-table tr.m-primary td a:hover, table.m-table td.m-primary a:hover, +table.m-table tr.m-primary th a:hover, table.m-table th.m-primary a:hover, +.m-note.m-primary a:focus, +table.m-table tr.m-primary td a:focus, table.m-table td.m-primary a:focus, +table.m-table tr.m-primary th a:focus, table.m-table th.m-primary a:focus, +.m-note.m-primary a:active, +table.m-table tr.m-primary td a:active, table.m-table td.m-primary a:active, +table.m-table tr.m-primary th a:active, table.m-table th.m-primary a:active { + color: #2f363f; +} +.m-note.m-success, +table.m-table tr.m-success td, table.m-table td.m-success, +table.m-table tr.m-success th, table.m-table th.m-success { + background-color: #2a703f; + color: #acecbe; +} +.m-note.m-success a, +table.m-table tr.m-success td a, table.m-table td.m-success a, +table.m-table tr.m-success th a, table.m-table th.m-success a { + color: #3bd267; +} +.m-note.m-success a:hover, +table.m-table tr.m-success td a:hover, table.m-table td.m-success a:hover, +table.m-table tr.m-success th a:hover, table.m-table th.m-success a:hover, +.m-note.m-success a:focus, +table.m-table tr.m-success td a:focus, table.m-table td.m-success a:focus, +table.m-table tr.m-success th a:focus, table.m-table th.m-success a:focus, +.m-note.m-success a:active, +table.m-table tr.m-success td a:active, table.m-table td.m-success a:active, +table.m-table tr.m-success th a:active, table.m-table th.m-success a:active { + color: #acecbe; +} +.m-note.m-warning, table.m-table tr.m-warning td, table.m-table td.m-warning, + table.m-table tr.m-warning th, table.m-table th.m-warning { + background-color: #6d702a; + color: #e9ecae; +} +.m-note.m-warning a, table.m-table tr.m-warning td a, table.m-table td.m-warning a, + table.m-table tr.m-warning th a, table.m-table th.m-warning a { + color: #b8bf2b; +} +.m-note.m-warning a:hover, +table.m-table tr.m-warning td a:hover, table.m-table td.m-warning a:hover, +table.m-table tr.m-warning th a:hover, table.m-table th.m-warning a:hover, +.m-note.m-warning a:focus, +table.m-table tr.m-warning td a:focus, table.m-table td.m-warning a:focus, +table.m-table tr.m-warning th a:focus, table.m-table th.m-warning a:focus, +.m-note.m-warning a:active, +table.m-table tr.m-warning td a:active, table.m-table td.m-warning a:active, +table.m-table tr.m-warning th a:active, table.m-table th.m-warning a:active { + color: #e9ecae; +} +.m-note.m-danger, +table.m-table tr.m-danger td, table.m-table td.m-danger, +table.m-table tr.m-danger th, table.m-table th.m-danger { + background-color: #702b2a; + color: #ff9391; +} +.m-note.m-danger a, +table.m-table tr.m-danger td a, table.m-table td.m-danger a, +table.m-table tr.m-danger th a, table.m-table th.m-danger a { + color: #d85c59; +} +.m-note.m-danger a:hover, +table.m-table tr.m-danger td a:hover, table.m-table td.m-danger a:hover, +table.m-table tr.m-danger th a:hover, table.m-table th.m-danger a:hover, +.m-note.m-danger a:focus, +table.m-table tr.m-danger td a:focus, table.m-table td.m-danger a:focus, +table.m-table tr.m-danger th a:focus, table.m-table th.m-danger a:focus, +.m-note.m-danger a:active, +table.m-table tr.m-danger td a:active, table.m-table td.m-danger a:active, +table.m-table tr.m-danger th a:active, table.m-table th.m-danger a:active { + color: #ff9391; +} +.m-note.m-info, +table.m-table tr.m-info td, table.m-table td.m-info, +table.m-table tr.m-info th, table.m-table th.m-info { + background-color: #2a4f70; + color: #a5caeb; +} +.m-note.m-info a, +table.m-table tr.m-info td a, table.m-table td.m-info a, +table.m-table tr.m-info th a, table.m-table th.m-info a { + color: #5297d7; +} +.m-note.m-info a:hover, +table.m-table tr.m-info td a:hover, table.m-table td.m-info a:hover, +table.m-table tr.m-info th a:hover, table.m-table th.m-info a:hover, +.m-note.m-info a:focus, +table.m-table tr.m-info td a:focus, table.m-table td.m-info a:focus, +table.m-table tr.m-info th a:focus, table.m-table th.m-info a:focus, +.m-note.m-info a:active, +table.m-table tr.m-info td a:active, table.m-table td.m-info a:active, +table.m-table tr.m-info th a:active, table.m-table th.m-info a:active { + color: #a5caeb; +} +.m-note.m-dim, +table.m-table tr.m-dim td, table.m-table td.m-dim, +table.m-table tr.m-dim th, table.m-table th.m-dim { + background-color: #2d3236; + color: #747474; +} +.m-note.m-dim a, +table.m-table tr.m-dim td a, table.m-table td.m-dim a, +table.m-table tr.m-dim th a, table.m-table th.m-dim a { + color: #acacac; +} +.m-note.m-dim a:hover, +table.m-table tr.m-dim td a:hover, table.m-table td.m-dim a:hover, +table.m-table tr.m-dim th a:hover, table.m-table th.m-dim a:hover, +.m-note.m-dim a:focus, +table.m-table tr.m-dim td a:focus, table.m-table td.m-dim a:focus, +table.m-table tr.m-dim th a:focus, table.m-table th.m-dim a:focus, +.m-note.m-dim a:active, +table.m-table tr.m-dim td a:active, table.m-table td.m-dim a:active, +table.m-table tr.m-dim th a:active, table.m-table th.m-dim a:active { + color: #747474; +} +figure.m-figure.m-default::before { border-color: #34424d; } +figure.m-figure.m-default figcaption { color: #dcdcdc; } +figure.m-figure.m-primary::before { border-color: #a5c2db; } +figure.m-figure.m-primary figcaption { color: #a5c9ea; } +figure.m-figure.m-primary figcaption .m-figure-description { color: #dcdcdc; } +figure.m-figure.m-success::before { border-color: #2a703f; } +figure.m-figure.m-success figcaption { color: #3bd267; } +figure.m-figure.m-success figcaption .m-figure-description { color: #dcdcdc; } +figure.m-figure.m-warning::before { border-color: #6d702a; } +figure.m-figure.m-warning figcaption { color: #c7cf2f; } +figure.m-figure.m-warning figcaption .m-figure-description { color: #dcdcdc; } +figure.m-figure.m-danger::before { border-color: #702b2a; } +figure.m-figure.m-danger figcaption { color: #cd3431; } +figure.m-figure.m-danger figcaption .m-figure-description { color: #dcdcdc; } +figure.m-figure.m-info::before { border-color: #2a4f70; } +figure.m-figure.m-info figcaption { color: #2f83cc; } +figure.m-figure.m-info figcaption .m-figure-description { color: #dcdcdc; } +figure.m-figure.m-dim::before { border-color: #2d3236; } +figure.m-figure.m-dim { color: #747474; } +figure.m-figure.m-dim a { color: #acacac; } +figure.m-figure.m-dim a:hover, figure.m-figure.m-dim a:focus, figure.m-figure.m-dim a:active { + color: #747474; +} +.m-math { fill: #dcdcdc; } +.m-math.m-default, .m-math g.m-default, .m-math rect.m-default, +div.m-plot svg .m-bar.m-default, +.m-graph g.m-edge polygon, +.m-graph g.m-node:not(.m-flat) ellipse, +.m-graph g.m-node:not(.m-flat) polygon, +.m-graph g.m-edge text, +.m-graph g.m-node.m-flat text, +.m-graph g.m-cluster text, +.m-graph.m-default g.m-edge polygon, +.m-graph.m-default g.m-node:not(.m-flat) ellipse, +.m-graph.m-default g.m-node:not(.m-flat) polygon, +.m-graph.m-default g.m-edge text, +.m-graph.m-default g.m-node.m-flat text, +.m-graph.m-default g.m-cluster text { + fill: #dcdcdc; +} +.m-graph g.m-edge polygon, +.m-graph g.m-edge path, +.m-graph g.m-node ellipse, +.m-graph g.m-node polygon, +.m-graph g.m-node polyline, +.m-graph g.m-cluster polygon, +.m-graph.m-default g.m-edge polygon, +.m-graph.m-default g.m-edge path, +.m-graph.m-default g.m-node ellipse, +.m-graph.m-default g.m-node polygon, +.m-graph.m-default g.m-node polyline, +.m-graph.m-default g.m-cluster polygon { + stroke: #dcdcdc; +} +.m-math.m-primary, .m-math g.m-primary, .m-math rect.m-primary, +div.m-plot svg .m-bar.m-primary, +.m-graph.m-primary g.m-edge polygon, +.m-graph.m-primary g.m-node:not(.m-flat) ellipse, +.m-graph.m-primary g.m-node:not(.m-flat) polygon, +.m-graph.m-primary g.m-edge text, +.m-graph.m-primary g.m-node.m-flat text, +.m-graph.m-primary g.m-cluster text { + fill: #a5c9ea; +} +.m-graph.m-primary g.m-edge polygon, +.m-graph.m-primary g.m-edge path, +.m-graph.m-primary g.m-node ellipse, +.m-graph.m-primary g.m-node polygon, +.m-graph.m-primary g.m-node polyline, +.m-graph.m-primary g.m-cluster polygon { + stroke: #a5c9ea; +} +.m-math.m-success, .m-math g.m-success, .m-math rect.m-success, +div.m-plot svg .m-bar.m-success, +.m-graph.m-success g.m-edge polygon, +.m-graph.m-success g.m-node:not(.m-flat) ellipse, +.m-graph.m-success g.m-node:not(.m-flat) polygon, +.m-graph.m-success g.m-edge text, +.m-graph.m-success g.m-node.m-flat text, +.m-graph.m-success g.m-cluster text { + fill: #3bd267; +} +.m-graph.m-success g.m-edge polygon, +.m-graph.m-success g.m-edge path, +.m-graph.m-success g.m-node ellipse, +.m-graph.m-success g.m-node polygon, +.m-graph.m-success g.m-node polyline, +.m-graph.m-success g.m-cluster polygon { + stroke: #3bd267; +} +.m-math.m-warning, .m-math g.m-warning, .m-math rect.m-warning, +div.m-plot svg .m-bar.m-warning, +.m-graph.m-warning g.m-edge polygon, +.m-graph.m-warning g.m-node:not(.m-flat) ellipse, +.m-graph.m-warning g.m-node:not(.m-flat) polygon, +.m-graph.m-warning g.m-edge text, +.m-graph.m-warning g.m-node.m-flat text, +.m-graph.m-warning g.m-cluster text { + fill: #c7cf2f; +} +.m-graph.m-warning g.m-edge polygon, +.m-graph.m-warning g.m-edge path, +.m-graph.m-warning g.m-node ellipse, +.m-graph.m-warning g.m-node polygon, +.m-graph.m-warning g.m-node polyline, +.m-graph.m-warning g.m-cluster polygon { + stroke: #c7cf2f; +} +.m-math.m-danger, .m-math g.m-danger, .m-math rect.m-danger, +div.m-plot svg .m-bar.m-danger, +.m-graph.m-danger g.m-edge polygon, +.m-graph.m-danger g.m-node:not(.m-flat) ellipse, +.m-graph.m-danger g.m-node:not(.m-flat) polygon, +.m-graph.m-danger g.m-edge text, +.m-graph.m-danger g.m-node.m-flat text, +.m-graph.m-danger g.m-cluster text { + fill: #cd3431; +} +.m-graph.m-danger g.m-edge polygon, +.m-graph.m-danger g.m-edge path, +.m-graph.m-danger g.m-node ellipse, +.m-graph.m-danger g.m-node polygon, +.m-graph.m-danger g.m-node polyline, +.m-graph.m-danger g.m-cluster polygon { + stroke: #cd3431; +} +.m-math.m-info, .m-math g.m-info, .m-math rect.m-info, +div.m-plot svg .m-bar.m-info, +.m-graph.m-info g.m-edge polygon, +.m-graph.m-info g.m-node:not(.m-flat) ellipse, +.m-graph.m-info g.m-node:not(.m-flat) polygon, +.m-graph.m-info g.m-edge text, +.m-graph.m-info g.m-node.m-flat text, +.m-graph.m-info g.m-cluster text { + fill: #2f83cc; +} +.m-graph.m-info g.m-edge polygon, +.m-graph.m-info g.m-edge path, +.m-graph.m-info g.m-node ellipse, +.m-graph.m-info g.m-node polygon, +.m-graph.m-info g.m-node polyline, +.m-graph.m-info g.m-cluster polygon { + stroke: #2f83cc; +} +.m-math.m-dim, .m-math g.m-dim, .m-math rect.m-dim, +div.m-plot svg .m-bar.m-dim, +.m-graph.m-dim g.m-edge polygon, +.m-graph.m-dim g.m-node:not(.m-flat) ellipse, +.m-graph.m-dim g.m-node:not(.m-flat) polygon, +.m-graph.m-dim g.m-edge text, +.m-graph.m-dim g.m-node.m-flat text, +.m-graph.m-dim g.m-cluster text { + fill: #747474; +} +.m-graph.m-dim g.m-edge polygon, +.m-graph.m-dim g.m-edge path, +.m-graph.m-dim g.m-node ellipse, +.m-graph.m-dim g.m-node polygon, +.m-graph.m-dim g.m-node polyline, +.m-graph.m-dim g.m-cluster polygon { + stroke: #747474; +} +.m-graph g.m-edge.m-default polygon, +.m-graph g.m-node.m-default:not(.m-flat) ellipse, +.m-graph g.m-node.m-default:not(.m-flat) polygon, +.m-graph g.m-edge.m-default text, +.m-graph g.m-node.m-default.m-flat text, +.m-graph g.m-cluster.m-default text { + fill: #dcdcdc; +} +.m-graph g.m-edge.m-default polygon, +.m-graph g.m-edge.m-default path, +.m-graph g.m-node.m-default ellipse, +.m-graph g.m-node.m-default polygon, +.m-graph g.m-node.m-default polyline, +.m-graph g.m-cluster.m-default polygon { + stroke: #dcdcdc; +} +.m-graph g.m-edge.m-primary polygon, +.m-graph g.m-node.m-primary:not(.m-flat) ellipse, +.m-graph g.m-node.m-primary:not(.m-flat) polygon, +.m-graph g.m-edge.m-primary text, +.m-graph g.m-node.m-primary.m-flat text, +.m-graph g.m-cluster.m-primary text { + fill: #a5c9ea; +} +.m-graph g.m-edge.m-primary polygon, +.m-graph g.m-edge.m-primary path, +.m-graph g.m-node.m-primary ellipse, +.m-graph g.m-node.m-primary polygon, +.m-graph g.m-node.m-primary polyline, +.m-graph g.m-cluster.m-primary polygon { + stroke: #a5c9ea; +} +.m-graph g.m-edge.m-success polygon, +.m-graph g.m-node.m-success:not(.m-flat) ellipse, +.m-graph g.m-node.m-success:not(.m-flat) polygon, +.m-graph g.m-edge.m-success text, +.m-graph g.m-node.m-success.m-flat text, +.m-graph g.m-cluster.m-success text { + fill: #3bd267; +} +.m-graph g.m-edge.m-success polygon, +.m-graph g.m-edge.m-success path, +.m-graph g.m-node.m-success ellipse, +.m-graph g.m-node.m-success polygon, +.m-graph g.m-node.m-success polyline, +.m-graph g.m-cluster.m-success polygon { + stroke: #3bd267; +} +.m-graph g.m-edge.m-warning polygon, +.m-graph g.m-node.m-warning:not(.m-flat) ellipse, +.m-graph g.m-node.m-warning:not(.m-flat) polygon, +.m-graph g.m-edge.m-warning text, +.m-graph g.m-node.m-warning.m-flat text, +.m-graph g.m-cluster.m-warning text { + fill: #c7cf2f; +} +.m-graph g.m-edge.m-warning polygon, +.m-graph g.m-edge.m-warning path, +.m-graph g.m-node.m-warning ellipse, +.m-graph g.m-node.m-warning polygon, +.m-graph g.m-node.m-warning polyline, +.m-graph g.m-cluster.m-warning polygon { + stroke: #c7cf2f; +} +.m-graph g.m-edge.m-danger polygon, +.m-graph g.m-node.m-danger:not(.m-flat) ellipse, +.m-graph g.m-node.m-danger:not(.m-flat) polygon, +.m-graph g.m-edge.m-danger text, +.m-graph g.m-node.m-danger.m-flat text, +.m-graph g.m-cluster.m-danger text { + fill: #cd3431; +} +.m-graph g.m-edge.m-danger polygon, +.m-graph g.m-edge.m-danger path, +.m-graph g.m-node.m-danger ellipse, +.m-graph g.m-node.m-danger polygon, +.m-graph g.m-node.m-danger polyline, +.m-graph g.m-cluster.m-danger polygon { + stroke: #cd3431; +} +.m-graph g.m-edge.m-info polygon, +.m-graph g.m-node.m-info:not(.m-flat) ellipse, +.m-graph g.m-node.m-info:not(.m-flat) polygon, +.m-graph g.m-edge.m-info text, +.m-graph g.m-node.m-info.m-flat text, +.m-graph g.m-cluster.m-info text { + fill: #2f83cc; +} +.m-graph g.m-edge.m-info polygon, +.m-graph g.m-edge.m-info path, +.m-graph g.m-node.m-info ellipse, +.m-graph g.m-node.m-info polygon, +.m-graph g.m-node.m-info polyline, +.m-graph g.m-cluster.m-info polygon { + stroke: #2f83cc; +} +.m-graph g.m-edge.m-dim polygon, +.m-graph g.m-node.m-dim:not(.m-flat) ellipse, +.m-graph g.m-node.m-dim:not(.m-flat) polygon, +.m-graph g.m-edge.m-dim text, +.m-graph g.m-node.m-dim.m-flat text, +.m-graph g.m-cluster.m-dim text { + fill: #747474; +} +.m-graph g.m-edge.m-dim polygon, +.m-graph g.m-edge.m-dim path, +.m-graph g.m-node.m-dim ellipse, +.m-graph g.m-node.m-dim polygon, +.m-graph g.m-node.m-dim polyline, +.m-graph g.m-cluster.m-dim polygon { + stroke: #747474; +} +p, ul, ol, dl, blockquote, pre, .m-code-figure, .m-console-figure, hr, .m-note, +.m-frame, .m-block, div.m-button, div.m-scroll, table.m-table, div.m-image, +img.m-image, svg.m-image, figure.m-figure, .m-imagegrid, div.m-math, +div.m-graph, div.m-plot { + margin-bottom: 1rem; +} +p:last-child, p.m-nopadb, ul:last-child, ul.m-nopadb, +ol:last-child, ol.m-nopadb, dl:last-child, dl.m-nopadb, +blockquote:last-child, blockquote.m-nopadb, pre:last-child, pre.m-nopadb, +.m-code-figure:last-child, .m-code-figure.m-nopadb, +.m-console-figure:last-child, .m-console-figure.m-nopadb, +hr:last-child, hr.m-nopadb, .m-note:last-child, .m-note.m-nopadb, +.m-frame:last-child, .m-frame.m-nopadb, .m-block:last-child, .m-block.m-nopadb, +div.m-button:last-child, div.m-button.m-nopadb, +div.m-scroll:last-child, div.m-scroll.m-nopadb, +table.m-table:last-child, table.m-table.m-nopadb, +img.m-image:last-child, img.m-image.m-nopadb, +svg.m-image:last-child, svg.m-image.m-nopadb, +div.m-image:last-child, div.m-image.m-nopadb, +figure.m-figure:last-child, figure.m-figure.m-nopadb, +.m-imagegrid:last-child, .m-imagegrid.m-nopadb, +div.m-math:last-child, div.m-math.m-nopadb, +div.m-graph:last-child, div.m-graph.m-nopadb, +div.m-plot:last-child, div.m-plot.m-nopadb { + margin-bottom: 0; +} +li > p:last-child, li > blockquote:last-child, li > pre:last-child, +li > .m-code-figure:last-child, li > .m-console-figure:last-child, +li > .m-note:last-child, li > .m-frame:last-child, li > .m-block:last-child, +li > div.m-button:last-child, li > div.m-scroll:last-child, li > table.m-table:last-child, +li > img.m-image:last-child, li > svg.m-image:last-child, li > div.m-image:last-child, +li > figure.m-figure:last-child, li > div.m-math:last-child, +li > div.m-graph:last-child, li > div.m-plot:last-child { + margin-bottom: 1rem; +} +li:last-child > p:last-child, li:last-child > p.m-nopadb, +li:last-child > blockquote:last-child, li:last-child > blockquote.m-nopadb, +li:last-child > pre:last-child, li:last-child > pre.m-nopadb, +li:last-child > .m-code-figure:last-child, li:last-child > .m-code-figure.m-nopadb, +li:last-child > .m-console-figure:last-child, li:last-child > .m-console-figure.m-nopadb, +li:last-child > .m-note:last-child, li:last-child > .m-note.m-nopadb, +li:last-child > .m-frame:last-child, li:last-child > .m-frame.m-nopadb, +li:last-child > .m-block:last-child, li:last-child > .m-block.m-nopadb, +li:last-child > div.m-button:last-child, li:last-child > div.m-button.m-nopadb, +li:last-child > div.m-scroll:last-child, li:last-child > div.m-scroll.m-nopadb, +li:last-child > table.m-table:last-child, li:last-child > table.m-table.m-nopadb, +li:last-child > img.m-image:last-child, li:last-child > img.m-image.m-nopadb, +li:last-child > svg.m-image:last-child, li:last-child > svg.m-image.m-nopadb, +li:last-child > div.m-image:last-child, li:last-child > div.m-image.m-nopadb, +li:last-child > figure.m-figure:last-child, li:last-child > figure.m-figure.m-nopadb, +li:last-child > div.m-math:last-child, li:last-child > div.m-math.m-nopadb, +li:last-child > div.m-graph:last-child, li:last-child > div.m-graph.m-nopadb, +li:last-child > div.m-plot:last-child, li:last-child > div.m-plot.m-nopadb { + margin-bottom: 0; +} + +body > header > nav { + width: 100%; + background-color: #22272e; + min-height: 3rem; +} +body > header > nav.m-navbar-landing, +body > header > nav.m-navbar-cover { + background-color: transparent; + position: relative; +} +body > header > nav.m-navbar-landing { + opacity: 0.8; +} +body > header > nav.m-navbar-cover { + background-color: rgba(34, 39, 46, 0.25); + opacity: 1; +} +body > header > nav.m-navbar-landing:hover, +body > header > nav.m-navbar-cover:hover { + background-color: rgba(34, 39, 46, 0.75); + opacity: 1; +} +body> header > nav.m-navbar-landing:target, +body> header > nav.m-navbar-cover:target { + background-color: #22272e; + opacity: 1; +} +body > header > nav.m-navbar-landing #m-navbar-brand.m-navbar-brand-hidden { + visibility: hidden; +} +body > header > nav.m-navbar-landing:target #m-navbar-brand.m-navbar-brand-hidden { + visibility: visible; +} +body > header > nav { + margin-left: auto; + margin-right: auto; + color: #ffffff; +} +body > header > nav a { + text-decoration: none; + text-transform: none; + display: inline-block; + vertical-align: middle; + line-height: 2.75rem; + color: #ffffff; +} +body > header > nav #m-navbar-brand, body > header > nav a#m-navbar-show, body > header > nav a#m-navbar-hide { + font-weight: 600; + font-size: 1.125rem; + padding-left: 1rem; + padding-right: 1rem; +} +body > header > nav a#m-navbar-brand, body > header > nav #m-navbar-brand a { + text-transform: uppercase; +} +body > header > nav a#m-navbar-brand img, body > header > nav #m-navbar-brand a img { + width: 1.75rem; + height: 1.75rem; + vertical-align: -22.5%; + margin-right: 0.5rem; +} +body > header > nav #m-navbar-brand a { + padding-left: 0; + padding-right: 0; +} +body > header > nav #m-navbar-brand .m-thin { + font-weight: normal; +} +body > header > nav #m-navbar-brand .m-breadcrumb { + color: #747474; +} +body > header > nav a#m-navbar-show::before, body > header > nav a#m-navbar-hide::before { + content:'\2630'; +} +body > header > nav #m-navbar-collapse { + padding-bottom: 1rem; +} +body > header > nav #m-navbar-collapse li { + border-style: solid; + border-color: transparent; + border-width: 0 0 0 0.25rem; + margin-left: -1rem; +} +body > header > nav #m-navbar-collapse li a { + border-style: solid; + border-color: transparent; + line-height: 1.5rem; + margin-left: -0.25rem; + padding-left: 0.75rem; + border-width: 0 0 0 0.25rem; + width: 100%; +} +body > header > nav #m-navbar-collapse li a#m-navbar-current { + color: #5b9dd9; + border-color: #5b9dd9; +} +body > header > nav ol { + list-style-type: none; + margin: 0; +} +body > header > nav ol ol { + padding-left: 1.5rem; +} +body > header > nav .m-row > [class*='m-col-'] { + padding-top: 0; + padding-bottom: 0; +} +body > header > nav a:hover, body > header > nav a:focus, body > header > nav a:active { + color: #a5c9ea; +} +body > header > nav #m-navbar-collapse li:hover { + border-color: #a5c9ea; +} +body > header > nav #m-navbar-collapse li a:hover, +body > header > nav #m-navbar-collapse li a:focus, +body > header > nav #m-navbar-collapse li a:active { + border-color: #a5c9ea; + background-color: #292f37; +} +body > header > nav.m-navbar-landing #m-navbar-collapse li a:hover, +body > header > nav.m-navbar-cover #m-navbar-collapse li a:hover, +body > header > nav.m-navbar-landing #m-navbar-collapse li a:focus, +body > header > nav.m-navbar-cover #m-navbar-collapse li a:focus, +body > header > nav.m-navbar-landing #m-navbar-collapse li a:active, +body > header > nav.m-navbar-cover #m-navbar-collapse li a:active { + background-color: rgba(41, 47, 55, 0.5); +} +body > header > nav #m-navbar-hide { + display: none; +} +body > header > nav:target #m-navbar-collapse { + display: block; +} +body > header > nav:target #m-navbar-show { + display: none; +} +body > header > nav:target #m-navbar-hide { + display: inline-block; +} +@media screen and (min-width: 768px) { + body > header > nav #m-navbar-show, body > header > nav #m-navbar-hide, + body > header > nav:target #m-navbar-show, body > header > nav:target #m-navbar-hide { + display: none; + } + body > header > nav #m-navbar-collapse li a { + line-height: 2.75rem; + } + body > header > nav a, body > header > nav #m-navbar-collapse li a { + margin-left: 0; + padding-left: 1rem; + padding-right: 1rem; + white-space: nowrap; + } + body > header > nav #m-navbar-collapse { + padding-bottom: 0; + } + body > header > nav #m-navbar-collapse li ol { + background-color: #22272e; + } + body > header > nav #m-navbar-collapse ol ol li { + margin-left: 0; + padding-left: 0; + border-left-width: 0; + } + body > header > nav #m-navbar-collapse ol ol li a { + padding-left: 0.75rem; + } + body > header > nav #m-navbar-collapse > .m-row > ol > li { + margin-left: 0; + border-left-width: 0; + } + body > header > nav #m-navbar-collapse > .m-row > ol > li > a { + border-width: 0 0 0.25rem 0; + } + body > header > nav #m-navbar-collapse ol { + padding-left: 0; + padding-right: 0; + } + body > header > nav #m-navbar-collapse > .m-row > ol, body > header > nav #m-navbar-collapse > .m-row > ol > li { + float: left; + } + body > header > nav #m-navbar-collapse ol ol { + z-index: 99999; + position: absolute; + visibility: hidden; + } + body > header > nav #m-navbar-collapse li:hover ol { + visibility: visible; + } +} +body > footer { + width: 100%; +} +body > footer > nav { + padding-top: 1rem; + padding-bottom: 1rem; + font-size: 0.85rem; + text-align: center; + color: #c5c5c5; + background-color: #444e5c; +} +body > footer > nav h3, body > footer > nav h3 a { + text-transform: uppercase; + font-weight: normal; +} +body > footer > nav ul { + list-style-type: none; + padding: 0; + margin: 0; +} +body > footer > nav a { + text-decoration: none; + text-transform: none; + color: #ffffff; +} +body > footer > nav a:hover, body > footer > nav a:focus, body > footer > nav a:active { + color: #a5c9ea; +} +body > main { + padding-top: 1rem; + padding-bottom: 1rem; +} +article h1 { + font-size: 1.75rem; +} +article h1 .m-breadcrumb { + color: #747474; + font-weight: normal; +} +article h1 .m-breadcrumb a { + color: #a5c9ea; +} +article h1 .m-breadcrumb a:hover, article h1 a:focus, article h1 a:active { + color: #dcdcdc; +} +article > header h1 { + font-size: 2rem; + margin-bottom: 0.5rem; +} +article h1 a, article > header h1, article > header h1 a, +article section > h2, article section > h2 a, +article section > h3, article section > h3 a, +article section > h4, article section > h4 a, +article section > h5, article section > h5 a, +article section > h6, article section > h6 a { + color: #a5c9ea; +} +article h1 a:hover, article > header h1 a:hover, article > header h1 a:focus, article > header h1 a:active, +article section > h2 a:hover, article section > h2 a:focus, article section > h2 a:active, +article section > h3 a:hover, article section > h3 a:focus, article section > h3 a:active, +article section > h4 a:hover, article section > h4 a:focus, article section > h4 a:active, +article section > h5 a:hover, article section > h5 a:focus, article section > h5 a:active, +article section > h6 a:hover, article section > h6 a:focus, article section > h6 a:active { + color: #dcdcdc; +} +article > header .m-date { + display: block; + width: 2.5rem; + float: left; + text-align: center; + line-height: 95%; + font-size: 0.75rem; + font-weight: normal; + white-space: nowrap; + border-right-style: solid; + border-right-width: 0.125rem; + border-color: #a5c9ea; + padding-right: 0.75rem; + margin-top: -0.1rem; + margin-right: 0.75rem; + margin-bottom: 0.25rem; +} +article > header .m-date-day { + display: block; + font-weight: bold; + padding-top: 0.2rem; + padding-bottom: 0.15rem; + font-size: 1.25rem; +} +article > header p { + color: #f0f0f0; + font-size: 1.125rem; +} +article > header h1::after { + content: " "; + clear: both; + display: table; +} +article > footer { + color: #c5c5c5; +} +article > footer p { + font-style: italic; + font-size: 0.85rem; + text-indent: 0; +} +article section:target { + margin-left: -1.0rem; + border-left-style: solid; + border-left-width: 0.25rem; + padding-left: 0.75rem; + border-color: #a5c9ea; +} +article h1 a, article > header h1 a, article section > h2 a, article section > h3 a, +article section > h4 a, article section > h5 a, article section > h6 a { + text-decoration: none; +} +#m-landing-image, #m-cover-image, article#m-jumbo > header #m-jumbo-image { + background-size: cover; + background-color: #0f1217; + background-position: center center; + background-repeat: no-repeat; + margin-top: -4rem; + padding-top: 5rem; +} +#m-landing-image { + color: #ffffff; +} +#m-cover-image { + height: 30rem; + margin-bottom: -26rem; +} +#m-landing-cover h1 { + font-size: 2.8rem; + margin-top: -0.5rem; + padding-left: 1.5rem; + padding-bottom: 1rem; + text-transform: lowercase; +} +#m-landing-cover { + padding-bottom: 10rem; + margin-bottom: -6rem; +} +article#m-jumbo { + margin-top: -1rem; +} +#m-landing-cover, #m-cover-image > div, article#m-jumbo > header #m-jumbo-cover { + background: linear-gradient(transparent 0%, transparent 50%, #2f363f 100%); + width: 100%; + height: 100%; +} +article#m-jumbo > header h1, article#m-jumbo > header h2 { + text-align: center; + font-weight: bold; +} +article#m-jumbo > header a { + text-decoration: none; +} +article#m-jumbo > header #m-jumbo-cover { + padding-bottom: 5rem; +} +article#m-jumbo > header #m-jumbo-image { + font-size: 2vmin; + margin-bottom: -3rem; +} +article#m-jumbo > header h1 { + font-size: 8vmin; +} +article#m-jumbo > header h2 { + font-size: 3vmin; +} +@media screen and (max-height: 640px) , screen and (max-width: 640px) { + article#m-jumbo > header h1 { + font-size: 3rem; + } + article#m-jumbo > header #m-jumbo-image, article#m-jumbo > header h2 { + font-size: 1rem; + } +} +article#m-jumbo > header, article#m-jumbo > header h1, article#m-jumbo > header a { + color: #ffffff; +} +article#m-jumbo > header a:hover, article#m-jumbo > header a:focus, article#m-jumbo > header a:active { + color: #f0f0f0; +} +article#m-jumbo.m-inverted > header, article#m-jumbo.m-inverted > header h1, article#m-jumbo.m-inverted > header a { + color: #000000; +} +article#m-jumbo.m-inverted > header a:hover, article#m-jumbo.m-inverted > header a:focus, article#m-jumbo.m-inverted > header a:active { + color: #0f0f0f; +} +.m-landing-news h3 a { + color: #dcdcdc; + text-decoration: none; + text-transform: uppercase; +} +.m-landing-news h3 a:hover, .m-landing-news h3 a:hover, .m-landing-news h3 a:focus, .m-landing-news h3 a:active { + color: #a5c9ea; +} +.m-landing-news time { + display: inline-block; + margin-left: 1rem; + float: right; +} +.m-article-pagination { + text-align: center; + padding: 1rem; +} +nav.m-navpanel { + text-align: center; +} +nav.m-navpanel h3 { + text-transform: uppercase; + font-weight: normal; +} +nav.m-navpanel ol { + text-transform: lowercase; +} +nav.m-navpanel ol, nav.m-navpanel ul { + list-style-type: none; + padding: 0; +} +nav.m-navpanel a { + color: #ffffff; + text-decoration: none; +} +nav.m-navpanel a:hover, nav.m-navpanel a:focus, nav.m-navpanel a:active { + color: #a5c9ea; +} +ul.m-tagcloud li { display: inline; } +ul.m-tagcloud li.m-tag-1 { font-size: 0.75rem; } +ul.m-tagcloud li.m-tag-2 { font-size: 0.825rem; } +ul.m-tagcloud li.m-tag-3 { font-size: 1rem; } +ul.m-tagcloud li.m-tag-4 { font-size: 1.25rem; } +ul.m-tagcloud li.m-tag-5 { font-size: 1.5rem; } +article section:target figure.m-code-figure, article section:target figure.m-console-figure { + z-index: 1; +} +article, article > header, article section { margin-bottom: 1rem; } +article:last-child, article section:last-child { margin-bottom: 0; } +.m-container-inflatable section:target > .m-note, +.m-container-inflatable section:target > .m-frame, +.m-container-inflatable section:target > .m-block, +.m-container-inflatable section:target > pre, +.m-container-inflatable section:target > .m-code-figure > pre:first-child, +.m-container-inflatable section:target > .m-console-figure > pre:first-child, +.m-container-inflatable section:target section > .m-note, +.m-container-inflatable section:target section > .m-frame, +.m-container-inflatable section:target section > .m-block, +.m-container-inflatable section:target section > pre, +.m-container-inflatable section:target section > .m-code-figure > pre:first-child, +.m-container-inflatable section:target section > .m-console-figure > pre:first-child, +.m-container-inflatable section:target [class*='m-center-'] > .m-note, +.m-container-inflatable section:target [class*='m-center-'] > .m-frame, +.m-container-inflatable section:target [class*='m-center-'] > .m-block, +.m-container-inflatable section:target [class*='m-center-'] > pre, +.m-container-inflatable section:target [class*='m-center-'] > .m-code-figure > pre:first-child, +.m-container-inflatable section:target [class*='m-center-'] > .m-console-figure > pre:first-child, +.m-container-inflatable section:target [class*='m-left-'] > .m-note, +.m-container-inflatable section:target [class*='m-left-'] > .m-frame, +.m-container-inflatable section:target [class*='m-left-'] > .m-block, +.m-container-inflatable section:target [class*='m-left-'] > pre, +.m-container-inflatable section:target [class*='m-left-'] > .m-code-figure > pre:first-child, +.m-container-inflatable section:target [class*='m-left-'] > .m-console-figure > pre:first-child, +.m-container-inflatable section:target [class*='m-right-'] > .m-note, +.m-container-inflatable section:target [class*='m-right-'] > .m-frame, +.m-container-inflatable section:target [class*='m-right-'] > .m-block, +.m-container-inflatable section:target [class*='m-right-'] > pre, +.m-container-inflatable section:target [class*='m-right-'] > .m-code-figure > pre:first-child, +.m-container-inflatable section:target [class*='m-right-'] > .m-console-figure > pre:first-child, +.m-container-inflatable section:target .m-container-inflate > .m-note, +.m-container-inflatable section:target .m-container-inflate > .m-frame, +.m-container-inflatable section:target .m-container-inflate > .m-block, +.m-container-inflatable section:target .m-container-inflate > pre, +.m-container-inflatable section:target .m-container-inflate > .m-code-figure > pre:first-child, +.m-container-inflatable section:target .m-container-inflate > .m-console-figure > pre:first-child { + margin-left: -1.0rem; + border-left-style: solid; + border-left-width: 0.25rem; + border-top-left-radius: 0; + border-bottom-left-radius: 0; + padding-left: 0.75rem; +} +.m-container-inflatable section:target > .m-code-figure::before, +.m-container-inflatable section:target > .m-console-figure::before, +.m-container-inflatable section:target section > .m-code-figure::before, +.m-container-inflatable section:target section > .m-console-figure::before, +.m-container-inflatable section:target [class*='m-center-'] > .m-code-figure::before, +.m-container-inflatable section:target [class*='m-center-'] > .m-console-figure::before, +.m-container-inflatable section:target [class*='m-left-'] > .m-code-figure::before, +.m-container-inflatable section:target [class*='m-left-'] > .m-console-figure::before, +.m-container-inflatable section:target [class*='m-right-'] > .m-code-figure::before, +.m-container-inflatable section:target [class*='m-right-'] > .m-console-figure::before, +.m-container-inflatable section:target .m-container-inflate > .m-code-figure::before, +.m-container-inflatable section:target .m-container-inflate > .m-console-figure::before { + border-top-left-radius: 0; + border-bottom-left-radius: 0; + border-left-width: 0.25rem; +} +.m-container-inflatable section:target > .m-code-figure > pre.m-nopad, +.m-container-inflatable section:target > .m-console-figure > pre.m-nopad { + margin-left: -0.75rem; + padding-left: -0.75rem; +} +@media screen and (min-width: 576px) { + .m-container-inflatable section:target .m-center-s > .m-note, + .m-container-inflatable section:target .m-center-s > pre, + .m-container-inflatable section:target .m-center-s > figure.m-code-figure > pre:first-child, + .m-container-inflatable section:target .m-center-s > figure.m-console-figure > pre:first-child, + .m-container-inflatable section:target .m-right-s > figure.m-code-figure > pre:first-child, + .m-container-inflatable section:target .m-right-s > figure.m-console-figure > pre:first-child { + border-left-width: 0; + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + padding-left: 1rem; + } + .m-container-inflatable section:target .m-center-s > .m-block, + .m-container-inflatable section:target .m-right-s > .m-block { + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + } + .m-container-inflatable section:target .m-center-s > .m-frame, + .m-container-inflatable section:target .m-right-s > .m-frame { + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + border-left-width: 0.125rem; + padding-left: 0.875rem; + } + .m-container-inflatable section:target .m-right-s > .m-block, + .m-container-inflatable section:target .m-right-s > .m-frame { + margin-left: 0; + } + .m-container-inflatable section:target .m-right-s > .m-note, + .m-container-inflatable section:target .m-right-s > pre { + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + margin-left: 0; + border-left-width: 0; + padding-left: 1rem; + } + .m-container-inflatable section:target .m-center-s > figure.m-code-figure::before, + .m-container-inflatable section:target .m-center-s > figure.m-console-figure::before, + .m-container-inflatable section:target .m-right-s > figure.m-code-figure::before, + .m-container-inflatable section:target .m-right-s > figure.m-console-figure::before { + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + border-left-width: 0.125rem; + } +} +@media screen and (min-width: 768px) { + .m-container-inflatable section:target .m-center-m > .m-note, + .m-container-inflatable section:target .m-center-m > pre, + .m-container-inflatable section:target .m-center-m > figure.m-code-figure > pre:first-child, + .m-container-inflatable section:target .m-center-m > figure.m-console-figure > pre:first-child, + .m-container-inflatable section:target .m-right-m > figure.m-code-figure > pre:first-child, + .m-container-inflatable section:target .m-right-m > figure.m-console-figure > pre:first-child { + border-left-width: 0; + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + padding-left: 1rem; + } + .m-container-inflatable section:target .m-center-m > .m-block, + .m-container-inflatable section:target .m-right-m > .m-block { + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + } + .m-container-inflatable section:target .m-center-m > .m-frame, + .m-container-inflatable section:target .m-right-m > .m-frame { + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + border-left-width: 0.125rem; + padding-left: 0.875rem; + } + .m-container-inflatable section:target .m-right-m > .m-block, + .m-container-inflatable section:target .m-right-m > .m-frame { + margin-left: 0; + } + .m-container-inflatable section:target .m-right-m > .m-note, + .m-container-inflatable section:target .m-right-m > pre { + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + margin-left: 0; + border-left-width: 0; + padding-left: 1rem; + } + .m-container-inflatable section:target .m-center-m > figure.m-code-figure::before, + .m-container-inflatable section:target .m-center-m > figure.m-console-figure::before, + .m-container-inflatable section:target .m-right-m > figure.m-code-figure::before, + .m-container-inflatable section:target .m-right-m > figure.m-console-figure::before { + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + border-left-width: 0.125rem; + } +} +@media screen and (min-width: 992px) { + .m-container-inflatable section:target .m-center-l > .m-note, + .m-container-inflatable section:target .m-center-l > pre, + .m-container-inflatable section:target .m-center-l > figure.m-code-figure > pre:first-child, + .m-container-inflatable section:target .m-center-l > figure.m-console-figure > pre:first-child, + .m-container-inflatable section:target .m-right-l > figure.m-code-figure > pre:first-child, + .m-container-inflatable section:target .m-right-l > figure.m-console-figure > pre:first-child { + border-left-width: 0; + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + padding-left: 1rem; + } + .m-container-inflatable section:target .m-center-l > .m-block, + .m-container-inflatable section:target .m-right-l > .m-block { + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + } + .m-container-inflatable section:target .m-center-l > .m-frame, + .m-container-inflatable section:target .m-right-l > .m-frame { + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + border-left-width: 0.125rem; + padding-left: 0.875rem; + } + .m-container-inflatable section:target .m-right-l > .m-block, + .m-container-inflatable section:target .m-right-l > .m-frame { + margin-left: 0; + } + .m-container-inflatable section:target .m-right-l > .m-note, + .m-container-inflatable section:target .m-right-l > pre { + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + margin-left: 0; + border-left-width: 0; + padding-left: 1rem; + } + .m-container-inflatable section:target .m-center-l > figure.m-code-figure::before, + .m-container-inflatable section:target .m-center-l > figure.m-console-figure::before, + .m-container-inflatable section:target .m-right-l > figure.m-code-figure::before, + .m-container-inflatable section:target .m-right-l > figure.m-console-figure::before { + border-top-left-radius: 0.2rem; + border-bottom-left-radius: 0.2rem; + border-left-width: 0.125rem; + } +} +.m-container-inflatable section:target > figure.m-code-figure::before, +.m-container-inflatable section:target > figure.m-console-figure::before, +.m-container-inflatable section:target section > figure.m-code-figure::before, +.m-container-inflatable section:target section > figure.m-console-figure::before, +.m-container-inflatable section:target [class*='m-center-'] > figure.m-code-figure::before, +.m-container-inflatable section:target [class*='m-center-'] > figure.m-console-figure::before, +.m-container-inflatable section:target [class*='m-left-'] > figure.m-code-figure::before, +.m-container-inflatable section:target [class*='m-left-'] > figure.m-console-figure::before, +.m-container-inflatable section:target [class*='m-right-'] > figure.m-code-figure::before, +.m-container-inflatable section:target [class*='m-right-'] > figure.m-console-figure::before, +.m-container-inflatable section:target .m-container-inflatable > figure.m-code-figure::before, +.m-container-inflatable section:target .m-container-inflatable > figure.m-console-figure::before { + border-left-color: #405363; +} +@media screen and (min-width: 576px) { + .m-container-inflatable section:target .m-center-s > figure.m-code-figure::before, + .m-container-inflatable section:target .m-right-s > figure.m-code-figure::before { + border-color: #282e36; + } + .m-container-inflatable section:target .m-center-s > figure.m-console-figure::before, + .m-container-inflatable section:target .m-right-s > figure.m-console-figure::before { + border-color: #1a1c1d; + } +} +@media screen and (min-width: 768px) { + .m-container-inflatable section:target .m-center-m > figure.m-code-figure::before, + .m-container-inflatable section:target .m-right-m > figure.m-code-figure::before { + border-color: #282e36; + } + .m-container-inflatable section:target .m-center-m > figure.m-console-figure::before, + .m-container-inflatable section:target .m-right-m > figure.m-console-figure::before { + border-color: #1a1c1d; + } +} +@media screen and (min-width: 992px) { + .m-container-inflatable section:target .m-center-l > figure.m-code-figure::before, + .m-container-inflatable section:target .m-right-l > figure.m-code-figure::before { + border-color: #282e36; + } + .m-container-inflatable section:target .m-center-l > figure.m-console-figure::before, + .m-container-inflatable section:target .m-right-l > figure.m-console-figure::before { + border-color: #1a1c1d; + } +} +.m-container-inflatable section:target pre, +.m-container-inflatable section:target figure.m-code-figure > pre:first-child, +.m-container-inflatable section:target figure.m-console-figure > pre:first-child { + border-color: #405363; +} +.m-container-inflatable section:target .m-note.m-default { + border-color: #405363; +} +.m-container-inflatable section:target .m-note.m-primary { + border-color: #a5c9ea; +} +.m-container-inflatable section:target .m-note.m-success { + border-color: #3bd267; +} +.m-container-inflatable section:target .m-note.m-warning { + border-color: #c7cf2f; +} +.m-container-inflatable section:target .m-note.m-danger { + border-color: #cd3431; +} +.m-container-inflatable section:target .m-note.m-info { + border-color: #2f83cc; +} +.m-container-inflatable section:target .m-note.m-dim { + border-color: #747474; +} + +.m-code .hll { background-color: #34424d } +.m-code .c { color: #a5c9ea } +.m-code .k { color: #ffffff; font-weight: bold } +.m-code .n { color: #dcdcdc } +.m-code .o { color: #aaaaaa } +.m-code .p { color: #aaaaaa } +.m-code .ch { color: #a5c9ea } +.m-code .cm { color: #a5c9ea } +.m-code .cp { color: #3bd267 } +.m-code .cpf { color: #c7cf2f } +.m-code .c1 { color: #a5c9ea } +.m-code .cs { color: #a5c9ea } +.m-code .gd { color: #cd3431 } +.m-code .ge { color: #e6e6e6; font-style: italic } +.m-code .gh { color: #ffffff; font-weight: bold } +.m-code .gi { color: #3bd267 } +.m-code .gs { color: #e6e6e6; font-weight: bold } +.m-code .gu { color: #5b9dd9 } +.m-code .kc { color: #ffffff; font-weight: bold } +.m-code .kd { color: #ffffff; font-weight: bold } +.m-code .kn { color: #ffffff; font-weight: bold } +.m-code .kp { color: #ffffff; font-weight: bold } +.m-code .kr { color: #ffffff; font-weight: bold } +.m-code .kt { color: #ffffff; font-weight: bold } +.m-code .m { color: #c7cf2f } +.m-code .s { color: #e07f7c } +.m-code .na { color: #dcdcdc; font-weight: bold } +.m-code .nb { color: #ffffff; font-weight: bold } +.m-code .nc { color: #dcdcdc; font-weight: bold } +.m-code .no { color: #dcdcdc } +.m-code .nd { color: #dcdcdc } +.m-code .ni { color: #dcdcdc } +.m-code .ne { color: #dcdcdc } +.m-code .nf { color: #dcdcdc } +.m-code .nl { color: #dcdcdc } +.m-code .nn { color: #dcdcdc } +.m-code .nx { color: #dcdcdc } +.m-code .py { color: #dcdcdc } +.m-code .nt { color: #dcdcdc; font-weight: bold } +.m-code .nv { color: #c7cf2f } +.m-code .ow { color: #dcdcdc; font-weight: bold } +.m-code .mb { color: #c7cf2f } +.m-code .mf { color: #c7cf2f } +.m-code .mh { color: #c7cf2f } +.m-code .mi { color: #c7cf2f } +.m-code .mo { color: #c7cf2f } +.m-code .sa { color: #e07f7c } +.m-code .sb { color: #e07f7c } +.m-code .sc { color: #e07cdc } +.m-code .dl { color: #e07f7c } +.m-code .sd { color: #e07f7c } +.m-code .s2 { color: #e07f7c } +.m-code .se { color: #e07cdc } +.m-code .sh { color: #e07f7c } +.m-code .si { color: #a5c9ea } +.m-code .sx { color: #e07f7c } +.m-code .sr { color: #e07f7c } +.m-code .s1 { color: #e07f7c } +.m-code .ss { color: #e07f7c } +.m-code .bp { color: #ffffff; font-weight: bold } +.m-code .fm { color: #dcdcdc } +.m-code .vc { color: #c7cf2f } +.m-code .vg { color: #c7cf2f } +.m-code .vi { color: #c7cf2f } +.m-code .vm { color: #c7cf2f } +.m-code .il { color: #c7cf2f } + +.m-console .hll { background-color: #ffffcc } +.m-console .g-AnsiBackgroundBlack { background-color: #232627 } +.m-console .g-AnsiBackgroundBlue { background-color: #1d99f3 } +.m-console .g-AnsiBackgroundBrightBlack { background-color: #7f8c8d } +.m-console .g-AnsiBackgroundBrightBlue { background-color: #3daee9 } +.m-console .g-AnsiBackgroundBrightCyan { background-color: #16a085 } +.m-console .g-AnsiBackgroundBrightGreen { background-color: #1cdc9a } +.m-console .g-AnsiBackgroundBrightMagenta { background-color: #8e44ad } +.m-console .g-AnsiBackgroundBrightRed { background-color: #c0392b } +.m-console .g-AnsiBackgroundBrightWhite { background-color: #ffffff } +.m-console .g-AnsiBackgroundBrightYellow { background-color: #fdbc4b } +.m-console .g-AnsiBackgroundCyan { background-color: #1abc9c } +.m-console .g-AnsiBackgroundGreen { background-color: #11d116 } +.m-console .g-AnsiBackgroundMagenta { background-color: #9b59b6 } +.m-console .g-AnsiBackgroundRed { background-color: #ed1515 } +.m-console .g-AnsiBackgroundWhite { background-color: #fcfcfc } +.m-console .g-AnsiBackgroundYellow { background-color: #f67400 } +.m-console .g-AnsiBlack { color: #232627 } +.m-console .g-AnsiBlue { color: #1d99f3 } +.m-console .g-AnsiBrightBlack { color: #7f8c8d; font-weight: bold } +.m-console .g-AnsiBrightBlue { color: #3daee9; font-weight: bold } +.m-console .g-AnsiBrightCyan { color: #16a085; font-weight: bold } +.m-console .g-AnsiBrightDefault { color: #ffffff; font-weight: bold } +.m-console .g-AnsiBrightGreen { color: #1cdc9a; font-weight: bold } +.m-console .g-AnsiBrightInvertedDefault { color: #1a1c1d; font-weight: bold } +.m-console .g-AnsiBrightMagenta { color: #8e44ad; font-weight: bold } +.m-console .g-AnsiBrightRed { color: #c0392b; font-weight: bold } +.m-console .g-AnsiBrightWhite { color: #ffffff; font-weight: bold } +.m-console .g-AnsiBrightYellow { color: #fdbc4b; font-weight: bold } +.m-console .g-AnsiCyan { color: #1abc9c } +.m-console .g-AnsiGreen { color: #11d116 } +.m-console .g-AnsiInvertedDefault { color: #1a1c1d } +.m-console .g-AnsiMagenta { color: #9b59b6 } +.m-console .g-AnsiRed { color: #ed1515 } +.m-console .g-AnsiWhite { color: #fcfcfc } +.m-console .g-AnsiYellow { color: #f67400 } +.m-console .go { color: #fcfcfc } +.m-console .gp { color: #16a085; font-weight: bold } +.m-console .w { color: #fcfcfc } + +a.m-doc, a.m-doc-self, a.m-doc-external, +ul.m-doc li.m-doc-expansible > a:first-child, ul.m-doc li.m-doc-collapsible > a:first-child, +.m-code.m-inverted.m-doc-include > a { + text-decoration: none; +} +a.m-doc, a.m-doc-self { + font-weight: bold; +} +.m-thin a.m-doc, .m-thin a.m-doc-self { + font-weight: normal; +} +ul.m-doc li.m-doc-expansible > a:first-child, +ul.m-doc li.m-doc-collapsible > a:first-child, +ul.m-doc li.m-doc-expansible > a:first-child:hover, +ul.m-doc li.m-doc-expansible > a:first-child:focus, +ul.m-doc li.m-doc-expansible > a:first-child:active, +ul.m-doc li.m-doc-collapsible > a:first-child:hover, +ul.m-doc li.m-doc-collapsible > a:first-child:focus, +ul.m-doc li.m-doc-collapsible > a:first-child:active { + color: #dcdcdc; +} +a.m-doc-self, +ul.m-doc li.m-doc-expansible > a:first-child::before, +ul.m-doc li.m-doc-collapsible > a:first-child::before { + color: #a5c9ea; +} +a.m-doc-self:hover, a.m-doc-self:focus, a.m-doc-self:active, +ul.m-doc li.m-doc-expansible > a:first-child:hover::before, +ul.m-doc li.m-doc-expansible > a:first-child:focus::before, +ul.m-doc li.m-doc-expansible > a:first-child:active::before, +ul.m-doc li.m-doc-collapsible > a:first-child:hover::before, +ul.m-doc li.m-doc-collapsible > a:first-child:focus::before, +ul.m-doc li.m-doc-collapsible > a:first-child:active::before { + color: #dcdcdc; +} +h3 a.m-doc-external { + font-weight: normal; +} +span.m-doc-wrap-bumper { + margin-right: -1rem; +} +span.m-doc-wrap { + margin-left: 1rem; + display: inline-block; + vertical-align: text-top; + white-space: pre-line; + max-width: 100%; +} +dl.m-doc dd { + margin-bottom: 0.5rem; +} +dl.m-doc dd { + margin-left: 0; + padding-left: 2.5rem; +} +dl.m-doc dt:target, dl.m-doc dt:target + dd { + margin-left: -1.0rem; + border-left-style: solid; + border-left-width: 0.25rem; + border-color: #a5c9ea; +} +dl.m-doc dt:target { padding-left: 0.75rem; } +dl.m-doc dt:target + dd { padding-left: 3.25rem; } +ul.m-doc { + list-style: none; + margin-left: 1.0375rem; + padding-left: 0.9rem; + border-left-color: #405363; + border-left-width: 0.0625rem; + border-left-style: solid; +} +ul.m-doc li { + text-indent: -1rem; + padding-left: 1rem; +} +ul.m-doc li.m-doc-expansible > ul { + display: none; +} +ul.m-doc li.m-doc-expansible, ul.m-doc li.m-doc-collapsible { + padding-left: 0.6rem; +} +ul.m-doc li.m-doc-expansible > ul.m-doc, ul.m-doc li.m-doc-collapsible > ul.m-doc { + margin-left: 0.5rem; +} +ul.m-doc li.m-doc-expansible > a:first-child::before, ul.m-doc li.m-doc-collapsible > a:first-child::before { + background-color: #2f363f; + display: inline-block; + width: 0.4rem; + font-weight: bold; +} +ul.m-doc li.m-doc-expansible > a:first-child::before { content: '⊕'; } +ul.m-doc li.m-doc-collapsible > a:first-child::before { content: '⊖'; } +h1 .m-doc-template, h1 .m-doc-include { + font-size: 1.3rem; + font-weight: normal; +} +h1 .m-doc-include:last-child { + margin-bottom: -0.5rem; +} +h3 .m-doc-template, h3 .m-doc-include { + font-size: 1rem; + font-weight: normal; +} +.m-doc-template, dl.m-doc dd, ul.m-doc li > span.m-doc { + color: #747474; +} +dl.m-doc dd svg.m-math, ul.m-doc li > span.m-doc svg.m-math { + fill: #747474; +} +.m-doc-template a, dl.m-doc dd a, ul.m-doc li > span.m-doc a { + color: #acacac; +} +.m-doc-template a:hover, .m-doc-template a:focus, .m-doc-template a:active, +dl.m-doc dd a:hover, dl.m-doc dd a:focus, dl.m-doc dd a:active, +ul.m-doc li > span.m-doc a:hover, ul.m-doc li > span.m-doc a:focus, ul.m-doc li > span.m-doc a:active { + color: #747474; +} +.m-code.m-inverted.m-doc-include > a:link, +.m-code.m-inverted.m-doc-include > a:visited { + opacity: 0.6666; +} +.m-code.m-inverted.m-doc-include > a:hover, +.m-code.m-inverted.m-doc-include > a:focus, +.m-code.m-inverted.m-doc-include > a:active { + opacity: 1; +} +article section.m-doc-details > div { + margin-top: 0; + margin-left: 0; + margin-right: 0; + position: relative; + padding: 1rem; +} +article section.m-doc-details > div::before { + position: absolute; + content: ' '; + top: 0; + bottom: 0; + left: 0; + right: 0; + z-index: -1; + border-style: solid; + border-width: 0.125rem; + border-radius: 0.2rem; + border-color: #282e36; +} +article section.m-doc-details > div > h3:first-child { + position: relative; + margin: -1rem -1rem 1rem -1rem; + padding: 0.5rem 1rem; + background-color: #282e36; + border-top-left-radius: 0.2rem; + border-top-right-radius: 0.2rem; + border-bottom-left-radius: 0; + border-bottom-right-radius: 0; +} +article section.m-doc-details:target { + border-color: transparent; +} +article section.m-doc-details:target > div { + z-index: 1; +} +.m-container-inflatable > .m-row > [class*='m-col-'] section.m-doc-details > div { + margin-left: -1rem; + margin-right: -1rem; +} +.m-container-inflatable section.m-doc-details:target > div > h3:first-child, +.m-container-inflatable section.m-doc-details:target section > div > h3:first-child { + margin-left: -1.0rem; + border-left-style: solid; + border-left-color: #dcdcdc; + border-left-width: 0.25rem; + padding-left: 0.75rem; +} +.m-container-inflatable section.m-doc-details:target > div::before, +.m-container-inflatable section-dox-details:target section > div.m::before { + border-left-width: 0.25rem; + border-left-color: #a5c9ea; +} +a.m-doc-search-icon { + padding-left: 1rem; + padding-right: 1rem; +} +a.m-doc-search-icon svg { + fill: #ffffff; +} +body > header > nav #m-navbar-collapse a.m-doc-search-icon svg { + vertical-align: -5%; +} +a.m-doc-search-icon:focus svg, a.m-doc-search-icon:hover svg, a.m-doc-search-icon:active svg { + fill: #a5c9ea; +} +.m-doc-search { + display: none; + z-index: 10; + position: fixed; + left: 0; + right: 0; + top: 0; + bottom: 0; + background-color: rgba(34, 39, 46, 0.75); +} +.m-doc-search:target { + display: block; +} +.m-doc-search > a { + display: block; + position: absolute; + left: 0; + right: 0; + top: 0; + bottom: 0; +} +.m-doc-search-header { + margin-top: 2.5rem; + padding: 0.5rem 1rem; + height: 2rem; +} +.m-doc-search-header > div:first-child { + float: right; +} +.m-doc-search-content { + background-color: #22272e; + border-radius: 0.2rem; + padding: 1rem; +} +.m-doc-search input { + width: 100%; + height: 3rem; + font-size: 1.2rem; + border-width: 0; + color: #dcdcdc; + background-color: #34424d; + border-radius: 0.2rem; + margin-bottom: 1rem; + padding: 0 1rem; +} +.m-doc-search #search-notfound { + display: none; +} +.m-doc-search ul#search-results { + list-style-type: none; + padding-left: 0; + max-height: calc(100vh - 12.5rem); + overflow-y: auto; + display: none; +} +.m-doc-search ul#search-results li a { + display: block; + padding-left: 1rem; + padding-right: 1rem; + text-decoration: none; + width: 100%; + line-height: 1.5rem; + color: #dcdcdc; +} +.m-doc-search ul#search-results li a > div { + white-space: nowrap; + overflow: hidden; +} +.m-doc-search ul#search-results li a > div:not(.m-doc-search-alias) { + direction: rtl; +} +.m-doc-search ul#search-results li a .m-label { + float: right; + line-height: 1rem; + margin-top: 0.1rem; + margin-left: 0.25rem; +} +.m-doc-search ul#search-results li a .m-label.m-flat { + margin-right: -0.75rem; +} +.m-doc-search ul#search-results li#search-current a { + background-color: #34424d; +} +.m-doc-search ul#search-results li#search-current.m-doc-search-copied a { + background-color: #2a703f; +} +.m-doc-search-typed { + color: #5b9dd9; +} +.m-doc-search input[type="search"] { -webkit-appearance: textfield; } +.m-doc-search input[type="search"]::-webkit-search-decoration, +.m-doc-search input[type="search"]::-webkit-search-cancel-button, +.m-doc-search input[type="search"]::-webkit-search-results-button, +.m-doc-search input[type="search"]::-webkit-search-results-decoration { + display: none; +} diff --git a/pr-preview/pr-494/manager_8hpp.html b/pr-preview/pr-494/manager_8hpp.html new file mode 100644 index 000000000..bdb0a357c --- /dev/null +++ b/pr-preview/pr-494/manager_8hpp.html @@ -0,0 +1,142 @@ + + + + + engine/renderer/pps/manager.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/renderer/pps/manager.hpp file +

+

Class cubos::engine::PostProcessingManager.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::PostProcessingManager +
+
Responsible for managing the post processing passes.
+
+
+
+

Enums

+
+
+ enum class PostProcessingInput { Lighting, + Position, + Normal } +
+
Possible renderer outputs which can then be used as input for a post processing pass.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/map__storage_8hpp.html b/pr-preview/pr-494/map__storage_8hpp.html new file mode 100644 index 000000000..f81b52bc1 --- /dev/null +++ b/pr-preview/pr-494/map__storage_8hpp.html @@ -0,0 +1,133 @@ + + + + + core/ecs/map_storage.hpp file | CUBOS. + + + + + + + +
+
+ + + + + + diff --git a/pr-preview/pr-494/material_8hpp.html b/pr-preview/pr-494/material_8hpp.html new file mode 100644 index 000000000..b9e926da3 --- /dev/null +++ b/pr-preview/pr-494/material_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/gl/material.hpp file | CUBOS. + + + + + + + +
+
+ + + + + + diff --git a/pr-preview/pr-494/meta_8hpp.html b/pr-preview/pr-494/meta_8hpp.html new file mode 100644 index 000000000..3b03a0481 --- /dev/null +++ b/pr-preview/pr-494/meta_8hpp.html @@ -0,0 +1,134 @@ + + + + + engine/assets/meta.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/assets/meta.hpp file +

+

Class cubos::engine::AssetMeta.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ class cubos::engine::AssetMeta +
+
Stores metadata about an asset - the data stored in .meta files. Each asset has a corresponding meta object, which contains load or import parameters.
+
+ struct cubos::engine::AssetMeta::Exclude +
+
Used as context to exclude parameters from being serialized.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/modules.html b/pr-preview/pr-494/modules.html new file mode 100644 index 000000000..64ecf0025 --- /dev/null +++ b/pr-preview/pr-494/modules.html @@ -0,0 +1,159 @@ + + + + + CUBOS. + + + + + + + +
+
+
+
+
+

Modules

+
    +
  • + module Core CUBOS. core library. +
      +
    • module Audio Provides audio functionality.
      • +
    • + module Data Provides filesystem and serialization utilities. +
        +
      • module Filesystem Provides filesystem utilities.
        • +
      +
      • +
    • module ECS Entity Component System library.
      • +
    • module Geometry Provides geometry utilities.
      • +
    • module Graphics Provides a graphics API abstraction and some voxel utilities.
      • +
    • module Input and output Provides a window API abstraction.
      • +
    • module Memory Provides a stream library and memory utilities.
      • +
    • module User Interface Provides ImGui integration and general UI utilities.
      • +
    +
    • +
  • + module Engine CUBOS. engine library. +
      +
    • module Assets Adds asset management to CUBOS.
      • +
    • module Collisions Adds collision detection to CUBOS.
      • +
    • module Environment settings Loads settings from the command line arguments.
      • +
    • module File settings Loads settings from a file.
      • +
    • module ImGui integration Initializes and configures ImGui for CUBOS.
      • +
    • module Input Adds input handling to CUBOS.
      • +
    • module Renderer Creates and handles the lifecycle of a renderer.
      • +
    • module Scene Adds scenes to CUBOS.
      • +
    • + module Tools Plugins which add debug and development tooling to CUBOS. +
        +
      • module Asset explorer Allows viewing and selecting assets through a ImGui window.
        • +
      • module Entity inspector Allows inspecting and modifying the components of the selected entity through a ImGui window.
        • +
      • module Entity selector Adds a resource used to select an entity.
        • +
      • module Settings inspector Allows inspecting the current setting values through a ImGui window.
        • +
      • module World inspector Shows all of the entities in the world through a ImGui window, and allows selecting them.
        • +
      +
      • +
    • module Transform Adds transform components which assign positions, rotations and scaling to entities.
      • +
    • module Voxels Adds grid and palette assets to CUBOS.
      • +
    • module Window Creates and handles the lifecycle of a window.
      • +
    +
    • +
+ +
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos.html b/pr-preview/pr-494/namespacecubos.html new file mode 100644 index 000000000..d087267c1 --- /dev/null +++ b/pr-preview/pr-494/namespacecubos.html @@ -0,0 +1,120 @@ + + + + + cubos namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos namespace +

+

CUBOS. libraries namespace.

+ +
+

Namespaces

+
+
namespace core
+
Core namespace.
+
namespace engine
+
Engine module.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1core.html b/pr-preview/pr-494/namespacecubos_1_1core.html new file mode 100644 index 000000000..9191cda11 --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1core.html @@ -0,0 +1,160 @@ + + + + + cubos::core namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core namespace +

+

Core namespace.

+ +
+

Namespaces

+
+
namespace al
+
Audio module.
+
namespace data
+
Data module.
+
namespace ecs
+
ECS module.
+
namespace geom
+
Geometry module.
+
namespace gl
+
Graphics module.
+
namespace io
+
Input and output module.
+
namespace memory
+
Memory module.
+
namespace ui
+
User Interface module.
+
+
+
+

Classes

+
+
+ class Settings +
+
Stores settings as key-value pairs and provides methods to retrieve them.
+
+ class ThreadPool +
+
Manages a pool of threads, to which tasks can be submitted.
+
+
+
+

Functions

+
+
+ void initializeLogger() +
+
Must be called before any logging is done.
+
+ void disableLogging() +
+
Disables all logging except for critical errors.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1core_1_1al.html b/pr-preview/pr-494/namespacecubos_1_1core_1_1al.html new file mode 100644 index 000000000..34890a678 --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1core_1_1al.html @@ -0,0 +1,165 @@ + + + + + cubos::core::al namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::al namespace +

+

Audio module.

+ +
+

Namespaces

+
+
namespace impl
+
Namespace to store the abstract types implemented by the audio device implementations.
+
+
+
+

Classes

+
+
+ class AudioDevice +
+
Audio device interface used to wrap low-level audio rendering APIs.
+
+
+
+

Enums

+
+
+ enum class Format { Mono8, + Mono16, + Stereo8, + Stereo16 } +
+
Possible audio formats.
+
+
+
+

Typedefs

+
+
+ using Buffer = std::shared_ptr<impl::Buffer> +
+
Handle to an audio buffer.
+
+ using Source = std::shared_ptr<impl::Source> +
+
Handle to an audio source.
+
+
+
+

Enum documentation

+
+

+ enum class cubos::core::al::Format +
#include <core/al/audio_device.hpp>
+

+

Possible audio formats.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1core_1_1al_1_1impl.html b/pr-preview/pr-494/namespacecubos_1_1core_1_1al_1_1impl.html new file mode 100644 index 000000000..748d3016f --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1core_1_1al_1_1impl.html @@ -0,0 +1,124 @@ + + + + + cubos::core::al::impl namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::al::impl namespace +

+

Namespace to store the abstract types implemented by the audio device implementations.

+ +
+

Classes

+
+
+ class Buffer +
+
Abstract audio buffer.
+
+ class Source +
+
Abstract audio source.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1core_1_1data.html b/pr-preview/pr-494/namespacecubos_1_1core_1_1data.html new file mode 100644 index 000000000..54326484f --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1core_1_1data.html @@ -0,0 +1,792 @@ + + + + + cubos::core::data namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data namespace +

+

Data module.

+ +
+

Namespaces

+
+
namespace impl
+
+
+
+
+

Classes

+
+
+ class BinaryDeserializer +
+
+
+ class BinarySerializer +
+
+
+ class Context +
+
+
+
template<typename T>
+ struct Debug +
+
+
+ class DebugSerializer +
+
+
+ class Deserializer +
+
+
+ class Archive +
+
Interface for a bridge between the CUBOS. virtual file system and the real world.
+
+ class EmbeddedArchive +
+
Archive implementation which reads data embedded in the application. Meant to be used with the quadrados embed tool.
+
+ class File +
+
Represents a file in the virtual file system of the engine.
+
+
template<typename T>
+ class FileStream +
+
Wrapper around an implementation-specific file stream which keeps the file alive and does some sanity checks.
+
+ class FileSystem +
+
Singleton which represents the virtual file system of the engine.
+
+ class StandardArchive +
+
Archive implementation which reads and writes from/into the OS file system using the standard library.
+
+ class JSONDeserializer +
+
Implementation of the abstract Deserializer class for deserializing from JSON.
+
+ class JSONSerializer +
+
+
+ class Package +
+
A utility object which is capable of storing the data of any trivially serializable object. One way to understand this class is to think of it as if it were a JSON representation of an object.
+
+ class Unpackager +
+
Responsible for deserializing packages into types.
+
+ struct QBMatrix +
+
Represents the data read from a matrix in a QB file.
+
+
template<typename R, typename I>
+ class SerializationMap +
+
+
+ class Serializer +
+
+
+
+
+

Functions

+
+
+
template<typename T>
+ void deserialize(Deserializer& des, + T& obj) +
+
Overload the serialize function for types which define a serialize method.
+
+
template<typename T>
+ auto deserialize(Deserializer& des, + T& obj) -> requires HasDeserializeMethod<T> void +
+
Overload the serialize function for types which define a serialize method.
+
+ void deserialize(Deserializer& des, + std::vector<bool>::reference val) +
+
+
+
template<typename T>
+ void deserialize(Deserializer& des, + std::vector<T>& vec) +
+
+
+
template<typename K, typename V>
+ void deserialize(Deserializer& des, + std::unordered_map<K, V>& map) +
+
+
+
template<typename T, typename U>
+ void deserialize(Deserializer& des, + std::pair<T, U>& pair) +
+
+
+ auto parseQB(std::vector<QBMatrix>& matrices, + memory::Stream& stream) -> bool +
+
+
+
template<typename T>
+ void serialize(Serializer& ser, + const T& obj, + const char* name) +
+
Overload the serialize function for types which define a serialize method.
+
+
template<typename T>
+ auto serialize(Serializer& ser, + const T& obj, + const char* name) -> requires HasSerializeMethod<T> void +
+
Overload the serialize function for types which define a serialize method.
+
+ void serialize(Serializer& ser, + std::vector<bool>::const_reference val, + const char* name) +
+
+
+
template<std::size_t N>
+ void serialize(Serializer& ser, + char const (&str)[N], + const char* name) +
+
+
+
template<typename T>
+ void serialize(Serializer& ser, + const std::vector<T>& vec, + const char* name) +
+
+
+
template<typename K, typename V>
+ void serialize(Serializer& ser, + const std::unordered_map<K, V>& map, + const char* name) +
+
+
+
template<typename T, typename U>
+ void serialize(Serializer& ser, + const std::pair<T, U>& pair, + const char* name) +
+
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ void cubos::core::data::deserialize(Deserializer& des, + T& obj) +

+

Overload the serialize function for types which define a serialize method.

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the object to deserialize.
Parameters
desThe deserializer to use.
objThe object to deserialize.
+

Deserializes the given object using the given deserializer. Deserializable objects must implement a specialization (or overload) of this function. An implementation for types with a deserialize method is provided.

+
+
+

+
+ template<typename T> +
+ requires HasDeserializeMethod<T> void cubos::core::data::deserialize(Deserializer& des, + T& obj) +

+

Overload the serialize function for types which define a serialize method.

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the object to deserialize.
Parameters
desThe deserializer to use.
objThe object to deserialize.
+

Deserializes the given object using the given deserializer. Deserializable objects must implement a specialization (or overload) of this function. An implementation for types with a deserialize method is provided.

+
+
+

+ void cubos::core::data::deserialize(Deserializer& des, + std::vector<bool>::reference val) +

+ + + + + + + + + + + + + + +
Parameters
desThe deserializer.
valThe value to deserialize.
+

Overload for deserializing std::vector<bool>::reference. This is a special case because std::vector<bool> are stored as arrays of bits, and therefore need special handling.

+
+
+

+
+ template<typename T> +
+ void cubos::core::data::deserialize(Deserializer& des, + std::vector<T>& vec) +

+ + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the vector.
Parameters
desThe deserializer.
vecThe vector to deserialize.
+

Overload for deserializing std::vector.

+
+
+

+
+ template<typename K, typename V> +
+ void cubos::core::data::deserialize(Deserializer& des, + std::unordered_map<K, V>& map) +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
KThe key type of the map.
VThe value type of the map.
Parameters
desThe deserializer.
mapThe map to deserialize.
+

Overload for deserializing std::unordered_map.

+
+
+

+
+ template<typename T, typename U> +
+ void cubos::core::data::deserialize(Deserializer& des, + std::pair<T, U>& pair) +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the first value.
UThe type of the second value.
Parameters
desThe deserializer.
pairThe pair to deserialize.
+

Overload for serializing std::pair.

+
+
+

+ bool cubos::core::data::parseQB(std::vector<QBMatrix>& matrices, + memory::Stream& stream) +

+ + + + + + + + + + + + + + + + + + + + +
Parameters
matricesThe matrices to output.
streamThe stream to read from.
ReturnsTrue if the file was parsed successfully, otherwise false.
+

Parses a Qubicle file (.qb), pushing every matrix found in the file to the passed vector.

+
+
+

+
+ template<typename T> +
+ void cubos::core::data::serialize(Serializer& ser, + const T& obj, + const char* name) +

+

Overload the serialize function for types which define a serialize method.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the object to serialize.
Parameters
serThe serializer to use.
objThe object to serialize.
nameThe name of the object.
+

Serializes the given object using the given serializer. Serializable objects must implement a specialization (or overload) of this function. An implementation for types with a serialize method is provided.

+
+
+

+
+ template<typename T> +
+ requires HasSerializeMethod<T> void cubos::core::data::serialize(Serializer& ser, + const T& obj, + const char* name) +

+

Overload the serialize function for types which define a serialize method.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the object to serialize.
Parameters
serThe serializer to use.
objThe object to serialize.
nameThe name of the object.
+

Serializes the given object using the given serializer. Serializable objects must implement a specialization (or overload) of this function. An implementation for types with a serialize method is provided.

+
+
+

+ void cubos::core::data::serialize(Serializer& ser, + std::vector<bool>::const_reference val, + const char* name) +

+ + + + + + + + + + + + + + + + + + +
Parameters
serThe serializer.
valThe value to serialize.
nameThe name of the value (optional).
+

Overload for serializing std::vector<bool>::const_reference. This is a special case because std::vector<bool> are stored as arrays of bits, and therefore need special handling.

+
+
+

+
+ template<std::size_t N> +
+ void cubos::core::data::serialize(Serializer& ser, + char const (&str)[N], + const char* name) +

+ + + + + + + + + + + + + + + + + + +
Parameters
serThe serializer.
strThe string to serialize.
nameThe name of the string (optional).
+

Overload for serializing char arrays. Necessary because literal strings are treated as char arrays by the compiler. Without this overload, the linker would fail.

+
+
+

+
+ template<typename T> +
+ void cubos::core::data::serialize(Serializer& ser, + const std::vector<T>& vec, + const char* name) +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the vector.
Parameters
serThe serializer.
vecThe vector to serialize.
nameThe name of the vector (optional).
+

Overload for serializing std::vector.

+
+
+

+
+ template<typename K, typename V> +
+ void cubos::core::data::serialize(Serializer& ser, + const std::unordered_map<K, V>& map, + const char* name) +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
KThe type of the key.
VThe type of the value.
Parameters
serThe serializer.
mapThe map to serialize.
nameThe name of the map (optional).
+

Overload for serializing std::unordered_map.

+
+
+

+
+ template<typename T, typename U> +
+ void cubos::core::data::serialize(Serializer& ser, + const std::pair<T, U>& pair, + const char* name) +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TThe type of the first value.
UThe type of the second value.
Parameters
serThe serializer.
pairThe pair to serialize.
nameThe name of the pair (optional).
+

Overload for serializing std::pair.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1core_1_1data_1_1impl.html b/pr-preview/pr-494/namespacecubos_1_1core_1_1data_1_1impl.html new file mode 100644 index 000000000..0de6962d6 --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1core_1_1data_1_1impl.html @@ -0,0 +1,120 @@ + + + + + cubos::core::data::impl namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::impl namespace +

+ +

Implementation specific classes for the above functions are hidden in this namespace.

+
+

Classes

+
+
+ class Packager +
+
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1core_1_1ecs.html b/pr-preview/pr-494/namespacecubos_1_1core_1_1ecs.html new file mode 100644 index 000000000..2a2de030f --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1core_1_1ecs.html @@ -0,0 +1,289 @@ + + + + + cubos::core::ecs namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs namespace +

+

ECS module.

+ +
+

Namespaces

+
+
namespace impl
+
Contains functions used internally by the implementation of the ECS.
+
+
+
+

Classes

+
+
+
template<typename T>
+ class Read +
+
System argument which provides read access to the resource T, or query argument which provides read access to the component T.
+
+
template<typename T>
+ class Write +
+
System argument which provides write access to the resource T, or query argument which provides write access to the component T.
+
+
template<typename T>
+ class OptRead +
+
System argument which provides read access to the resource T if it exists, or query argument which provides read access to the component T if it exists.
+
+
template<typename T>
+ class OptWrite +
+
System argument which provides write access to the resource T if it exists, or query argument which provides write access to the component T if it exists.
+
+ class Blueprint +
+
Stores a bundle of entities and their respective components, which can be easily spawned into a world. This is in a way the 'Prefab' of CUBOS., but lower level.
+
+ class EntityBuilder +
+
Allows editing an entity created by a Commands object.
+
+ class BlueprintBuilder +
+
Used to edit a blueprint spawned by a Commands object.
+
+ class Commands +
+
Used to write ECS commands and execute them at a later time.
+
+ class CommandBuffer +
+
Stores commands to execute them later.
+
+
template<typename T>
+ class ReadStorage +
+
Utility struct used to reference a storage of component type T for reading.
+
+
template<typename T>
+ class WriteStorage +
+
Utility struct used to reference a storage of component type T for writing.
+
+ class ComponentManager +
+
Holds and manages components.
+
+ class Dispatcher +
+
Used to add systems and relations between them and then dispatch them all at once.
+
+ class Entity +
+
Identifies an entity.
+
+ class EntityManager +
+
Holds and manages entities and their component masks.
+
+
template<typename T>
+ class EventPipe +
+
Resource which stores events of type T.
+
+
template<typename T, unsigned int M = DEFAULT_FILTER_MASK>
+ class EventReader +
+
System arguments used to read events of type T.
+
+
template<typename T>
+ class EventWriter +
+
System argument which allows the system to send events of type T to other systems.
+
+
template<typename T>
+ class MapStorage +
+
Storage implementation that uses an std::unordered_map.
+
+
template<typename T>
+ class NullStorage +
+
Storage implementation that doesn't keep any data, made for zero-sized components.
+
+ struct QueryInfo +
+
Describes a query.
+
+
template<typename... ComponentTypes>
+ class Query +
+
Holds the result of a query over all entities in world which match the given arguments.
+
+ class Registry +
+
Singleton which holds a global registry for all component types.
+
+
template<typename T>
+ class ReadResource +
+
Utility struct used to reference a resource of type T for reading.
+
+
template<typename T>
+ class WriteResource +
+
Utility struct used to reference a resource of type T for writing.
+
+ class ResourceManager +
+
Holds and manages resources.
+
+ class IStorage +
+
Abstract parent class for all storages.
+
+
template<typename T>
+ class Storage +
+
Abstract container for a component type T.
+
+ struct SystemInfo +
+
Describes a system.
+
+
template<typename R>
+ class AnySystemWrapper +
+
Base class for system wrappers.
+
+
template<typename F>
+ class SystemWrapper +
+
Wrapper for a system of type F.
+
+
template<typename T>
+ class VecStorage +
+
Storage implementation that uses a std::vector.
+
+ class World +
+
Holds entities, their components and resources.
+
+
+
+

Functions

+
+
+
template<typename T>
+ auto getComponentName() -> std::optional<std::string_view> +
+
Gets the registered name of a component type.
+
+ auto getComponentName(std::type_index type) -> std::optional<std::string_view> +
+
Gets the registered name of a component type.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1core_1_1ecs_1_1impl.html b/pr-preview/pr-494/namespacecubos_1_1core_1_1ecs_1_1impl.html new file mode 100644 index 000000000..436fe39a3 --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1core_1_1ecs_1_1impl.html @@ -0,0 +1,137 @@ + + + + + cubos::core::ecs::impl namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::impl namespace +

+

Contains functions used internally by the implementation of the ECS.

+ +

Used to avoid cluttering the public namespace with implementation details.

+
+

Classes

+
+
+
template<typename T>
+ struct QueryFetcher +
+
Fetches the requested data from a world.
+
+
template<typename T>
+ struct SystemFetcher +
+
Fetches the requested data from a world.
+
+
template<typename F>
+ struct SystemTraits +
+
Template magic used to inspect the arguments of a system.
+
+
template<class T, class Tuple>
+ struct Index +
+
Used to get the index of a type in a tuple.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1core_1_1geom.html b/pr-preview/pr-494/namespacecubos_1_1core_1_1geom.html new file mode 100644 index 000000000..f0b1803bf --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1core_1_1geom.html @@ -0,0 +1,132 @@ + + + + + cubos::core::geom namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::geom namespace +

+

Geometry module.

+ +
+

Classes

+
+
+ struct Box +
+
Represents a box shape.
+
+ struct Capsule +
+
Represents a capsule or sphere shape.
+
+ struct Plane +
+
Represents a plane shape.
+
+ struct Simplex +
+
Represents a simplex shape, which may either be empty, a point, a line, a triangle or a tetrahedron.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1core_1_1gl.html b/pr-preview/pr-494/namespacecubos_1_1core_1_1gl.html new file mode 100644 index 000000000..7361c4cba --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1core_1_1gl.html @@ -0,0 +1,532 @@ + + + + + cubos::core::gl namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl namespace +

+

Graphics module.

+ +
+

Namespaces

+
+
namespace impl
+
Namespace to store the abstract types implemented by the render device implementations.
+
+
+
+

Classes

+
+
+ struct Camera +
+
Describes a camera.
+
+ class Debug +
+
Singleton with static methods used to draw primitive objects on screen for debugging purposes.
+
+ class Grid +
+
Represents a voxel object using a 3D grid.
+
+ struct SpotLight +
+
Describes a spot light.
+
+ struct DirectionalLight +
+
Describes a directional light.
+
+ struct PointLight +
+
Describes a point light.
+
+ struct Material +
+
Describes a voxel material.
+
+ class Palette +
+
Holds a palette of materials. Supports up to 65535 materials.
+
+ struct FramebufferDesc +
+
Describes a framebuffer.
+
+ struct RasterStateDesc +
+
Decribes a rasterizer state.
+
+ struct DepthStencilStateDesc +
+
Describes a depth stencil state.
+
+ struct BlendStateDesc +
+
Describes a blend state.
+
+ struct SamplerDesc +
+
Describes a sampler.
+
+ struct Texture1DDesc +
+
Describes a 1D texture.
+
+ struct Texture2DDesc +
+
Describes a 2D texture.
+
+ struct Texture2DArrayDesc +
+
Describes a 2D texture array.
+
+ struct Texture3DDesc +
+
Describes a 3D texture.
+
+ struct CubeMapDesc +
+
Describes a cube map.
+
+ struct CubeMapArrayDesc +
+
Describes a cube map array.
+
+ struct ConstantBufferElement +
+
Describes an element in a constant buffer.
+
+ struct ConstantBufferStructure +
+
Describes the structure of a constant buffer.
+
+ struct VertexElement +
+
Describes a vertex element.
+
+ struct VertexArrayDesc +
+
Describes a vertex array.
+
+ class RenderDevice +
+
Interface used to wrap low-level rendering APIs such as OpenGL.
+
+ struct Vertex +
+
Represents a voxel vertex.
+
+
+
+

Enums

+
+
+ enum class Property { MaxAnisotropy, + ComputeSupported } +
+
Render device properties that can be queried at runtime.
+
+ enum class Usage { Default, + Dynamic, + Static } +
+
Usage mode for buffers and textures.
+
+ enum class Type { Byte, + Short, + Int, + UByte, + UShort, + UInt, + NByte, + NShort, + NUByte, + NUShort, + Float } +
+
Data type.
+
+ enum class IndexFormat { UShort, + UInt } +
+
Index format.
+
+ enum class TextureFormat { R8SNorm, + R16SNorm, + RG8SNorm, + RG16SNorm, + RGBA8SNorm, + RGBA16SNorm, + R8UNorm, + R16UNorm, + RG8UNorm, + RG16UNorm, + RGBA8UNorm, + RGBA16UNorm, + R8SInt, + R16SInt, + RG8SInt, + RG16SInt, + RGBA8SInt, + RGBA16SInt, + R8UInt, + R16UInt, + RG8UInt, + RG16UInt, + RGBA8UInt, + RGBA16UInt, + R16Float, + R32Float, + RG16Float, + RG32Float, + RGB16Float, + RGB32Float, + RGBA16Float, + RGBA32Float, + Depth16, + Depth32, + Depth24Stencil8, + Depth32Stencil8 } +
+
Texture format.
+
+ enum class AddressMode { Repeat, + Mirror, + Clamp, + Border } +
+
Texture address mode.
+
+ enum class TextureFilter { None, + Nearest, + Linear } +
+
Texture filter type.
+
+ enum class Winding { CW, + CCW } +
+
Triangle winding mode.
+
+ enum class Face { Front, + Back, + FrontAndBack } +
+
Specifies a face.
+
+ enum class RasterMode { Wireframe, + Fill } +
+
Rasterizer mode.
+
+ enum class Compare { Never, + Less, + LEqual, + Greater, + GEqual, + Equal, + NEqual, + Always } +
+
Comparison function.
+
+ enum class StencilAction { Zero, + Keep, + Replace, + Increment, + IncrementWrap, + Decrement, + DecrementWrap, + Invert } +
+
Stencil action.
+
+ enum class BlendFactor { Zero, + One, + SrcColor, + InvSrcColor, + DstColor, + InvDstColor, + SrcAlpha, + InvSrcAlpha, + DstAlpha, + InvDstAlpha } +
+
Blend factor.
+
+ enum class BlendOp { Add, + Substract, + RevSubstract, + Min, + Max } +
+
Blend operation.
+
+ enum class Stage { Vertex, + Geometry, + Pixel, + Compute } +
+
Shader stage type.
+
+ enum class CubeFace { PositiveX = 0, + NegativeX = 1, + PositiveY = 2, + NegativeY = 3, + PositiveZ = 4, + NegativeZ = 5 } +
+
Cube map face.
+
+ enum class MemoryBarriers { None = 0, + VertexBuffer = 1, + IndexBuffer = 2, + ConstantBuffer = 4, + ImageAccess = 8, + TextureAccess = 16, + Framebuffer = 32, + All = VertexBuffer | IndexBuffer | ConstantBuffer | ImageAccess | TextureAccess | Framebuffer } +
+
Memory barrier flags for synchronization.
+
+ enum class Access { Read, + Write, + ReadWrite } +
+
Access mode for a resource.
+
+
+
+

Typedefs

+
+
+ using Framebuffer = std::shared_ptr<impl::Framebuffer> +
+
Handle to a framebuffer.
+
+ using RasterState = std::shared_ptr<impl::RasterState> +
+
Handle to a rasterizer state.
+
+ using DepthStencilState = std::shared_ptr<impl::DepthStencilState> +
+
Handle to a depth stencil state.
+
+ using BlendState = std::shared_ptr<impl::BlendState> +
+
Handle to a blend state.
+
+ using Sampler = std::shared_ptr<impl::Sampler> +
+
Handle to a sampler.
+
+ using Texture1D = std::shared_ptr<impl::Texture1D> +
+
Handle to a 1D texture.
+
+ using Texture2D = std::shared_ptr<impl::Texture2D> +
+
Handle to a 2D texture.
+
+ using Texture2DArray = std::shared_ptr<impl::Texture2DArray> +
+
Handle to a 2D texture array.
+
+ using Texture3D = std::shared_ptr<impl::Texture3D> +
+
Handle to a 3D texture.
+
+ using CubeMap = std::shared_ptr<impl::CubeMap> +
+
Handle to a cube map.
+
+ using CubeMapArray = std::shared_ptr<impl::CubeMapArray> +
+
Handle to a cube map array.
+
+ using ConstantBuffer = std::shared_ptr<impl::ConstantBuffer> +
+
Handle to a constant buffer.
+
+ using IndexBuffer = std::shared_ptr<impl::IndexBuffer> +
+
Handle to an index buffer.
+
+ using VertexBuffer = std::shared_ptr<impl::VertexBuffer> +
+
Handle to a vertex buffer.
+
+ using VertexArray = std::shared_ptr<impl::VertexArray> +
+
Handle to a vertex array.
+
+ using ShaderStage = std::shared_ptr<impl::ShaderStage> +
+
Handle to a shader stage.
+
+ using ShaderPipeline = std::shared_ptr<impl::ShaderPipeline> +
+
Handle to a shader pipeline.
+
+ using ShaderBindingPoint = impl::ShaderBindingPoint* +
+
Handle to a shader binding point.
+
+
+
+

Functions

+
+
+ void generateScreenQuad(RenderDevice& renderDevice, + const ShaderPipeline& pipeline, + VertexArray& va) +
+
Creates the resources required to draw a quad that fills the screen and returns its VertexArray.
+
+ void triangulate(const Grid& grid, + std::vector<Vertex>& vertices, + std::vector<uint32_t>& indices) +
+
Triangulates a grid of voxels into an indexed mesh.
+
+
+
+

Function documentation

+
+

+ void cubos::core::gl::generateScreenQuad(RenderDevice& renderDevice, + const ShaderPipeline& pipeline, + VertexArray& va) +
#include <core/gl/util.hpp>
+

+

Creates the resources required to draw a quad that fills the screen and returns its VertexArray.

+ + + + + + + + + + + + + + + + + + +
Parameters
renderDeviceRenderDevice to be used for generation of the quad.
pipelinePipeline to associate the quad's VertexArray with.
va outHandle of the quad's VertexArray.
+

The quad provided by this function consists of two one sided triangles, with vertices containing the 2D position and UV coordinates. This function assumes the shader pipeline provided takes as input attributes a vec2 position and a vec2 uv.

+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1core_1_1gl_1_1impl.html b/pr-preview/pr-494/namespacecubos_1_1core_1_1gl_1_1impl.html new file mode 100644 index 000000000..3debc0e80 --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1core_1_1gl_1_1impl.html @@ -0,0 +1,188 @@ + + + + + cubos::core::gl::impl namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::impl namespace +

+

Namespace to store the abstract types implemented by the render device implementations.

+ +
+

Classes

+
+
+ class Framebuffer +
+
Abstract framebuffer.
+
+ class RasterState +
+
Abstract rasterizer state.
+
+ class DepthStencilState +
+
Abstract depth stencil state.
+
+ class BlendState +
+
Abstract blend state.
+
+ class Sampler +
+
Abstract sampler.
+
+ class Texture1D +
+
Abstract 1D texture.
+
+ class Texture2D +
+
Abstract 2D texture.
+
+ class Texture2DArray +
+
Abstract 2D texture array.
+
+ class Texture3D +
+
Abstract 3D texture.
+
+ class CubeMap +
+
Abstract cube map.
+
+ class CubeMapArray +
+
Abstract cube map.
+
+ class ConstantBuffer +
+
Abstract constant buffer.
+
+ class IndexBuffer +
+
Abstract index buffer.
+
+ class VertexBuffer +
+
Abstract vertex buffer.
+
+ class VertexArray +
+
Abstract vertex array.
+
+ class ShaderStage +
+
Abstract shader stage.
+
+ class ShaderPipeline +
+
Abstract shader pipeline.
+
+ class ShaderBindingPoint +
+
Abstract shader binding point.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1core_1_1io.html b/pr-preview/pr-494/namespacecubos_1_1core_1_1io.html new file mode 100644 index 000000000..09edb58b7 --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1core_1_1io.html @@ -0,0 +1,331 @@ + + + + + cubos::core::io namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::io namespace +

+

Input and output module.

+ +
+

Classes

+
+
+ class Cursor +
+
Handle for a custom mouse cursor.
+
+ struct KeyEvent +
+
Event sent when a key is pressed or released.
+
+ struct ModifiersEvent +
+
Event sent when the modifiers change.
+
+ struct MouseButtonEvent +
+
Event sent when a mouse button state changes.
+
+ struct MouseMoveEvent +
+
Event sent when the mouse cursor moves.
+
+ struct MouseScrollEvent +
+
Event sent when the mouse wheel is scrolled.
+
+ struct ResizeEvent +
+
Event sent when the window framebuffer is resized.
+
+ struct TextEvent +
+
Event sent when a unicode character is input.
+
+ class BaseWindow +
+
Interface used to wrap low-level window API implementations.
+
+
+
+

Enums

+
+
+ enum class Key { Invalid = -1, + A, + B, + C, + D, + E, + F, + G, + H, + I, + J, + K, + L, + M, + N, + O, + P, + Q, + R, + S, + T, + U, + V, + W, + X, + Y, + Z, + Num0, + Num1, + Num2, + Num3, + Num4, + Num5, + Num6, + Num7, + Num8, + Num9, + Escape, + LControl, + LShift, + LAlt, + LSystem, + RControl, + RShift, + RAlt, + RSystem, + Menu, + LBracket, + RBracket, + SemiColon, + Comma, + Period, + Quote, + Slash, + BackSlash, + Tilde, + Equal, + Dash, + Space, + Return, + BackSpace, + Tab, + PageUp, + PageDown, + End, + Home, + Insert, + Delete, + Add, + Subtract, + Multiply, + Divide, + Left, + Right, + Up, + Down, + Numpad0, + Numpad1, + Numpad2, + Numpad3, + Numpad4, + Numpad5, + Numpad6, + Numpad7, + Numpad8, + Numpad9, + F1, + F2, + F3, + F4, + F5, + F6, + F7, + F8, + F9, + F10, + F11, + F12, + Pause, + Count } +
+
Keyboard key codes enum.
+
+ enum class Modifiers { None = 0, + Control = 1, + Shift = 2, + Alt = 4, + System = 8 } +
+
Keyboard modifier flags enum.
+
+ enum class MouseButton { Invalid = -1, + Left, + Right, + Middle, + Extra1, + Extra2 } +
+
Mouse buttons enum.
+
+ enum class MouseAxis { X, + Y, + Scroll } +
+
Mouse axes enums.
+
+ enum class MouseState { Default, + Locked, + Hidden } +
+
Possible mouse states.
+
+
+
+

Typedefs

+
+
+ using WindowEvent = std::variant<KeyEvent, ModifiersEvent, MouseButtonEvent, MouseMoveEvent, MouseScrollEvent, ResizeEvent, TextEvent> +
+
Variant that can hold any of the window events.
+
+ using Window = std::shared_ptr<BaseWindow> +
+
Handle to a window.
+
+
+
+

Functions

+
+
+ auto modifiersToString(Modifiers modifiers) -> std::string +
+
Converts a Modifiers enum to a string.
+
+ auto stringToModifiers(const std::string& str) -> Modifiers +
+
Converts a string to a Modifiers enum.
+
+ auto keyToString(Key key) -> std::string +
+
Converts a Key enum to a string.
+
+ auto stringToKey(const std::string& str) -> Key +
+
Convert a string to a Key enum.
+
+ auto openWindow(const std::string& title = "CUBOS.", + const glm::ivec2& size = {800, 600}) -> Window +
+
Opens a new window.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1core_1_1memory.html b/pr-preview/pr-494/namespacecubos_1_1core_1_1memory.html new file mode 100644 index 000000000..1d93b90ef --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1core_1_1memory.html @@ -0,0 +1,190 @@ + + + + + cubos::core::memory namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::memory namespace +

+

Memory module.

+ +
+

Classes

+
+
+ class BufferStream +
+
Stream implementation which writes to/reads from a buffer.
+
+
template<typename T, typename Lock>
+ class ReadGuard +
+
Provides safe read-only access to an object using a lock.
+
+
template<typename T, typename Lock>
+ class WriteGuard +
+
Provides safe read-write access to an object using a lock.
+
+ class StandardStream +
+
Stream implementation which wraps a libc file pointer.
+
+ class Stream +
+
Interface class for memory streams. Abstracts away sources or destinations of data.
+
+
template<typename V>
+ class TypeMap +
+
A map that stores values of type V, using types as keys.
+
+
+
+

Enums

+
+
+ enum class SeekOrigin { Begin, + Current, + End } +
+
Stream seek origin.
+
+
+
+

Functions

+
+
+
template<typename T>
+ auto swapBytes(T value) -> T +
+
Swaps the bytes of a value, changing its endianness.
+
+ auto isLittleEndian() -> bool +
+
Checks if the current platform is little endian.
+
+
template<typename T>
+ auto fromLittleEndian(T value) -> T +
+
Converts a value from little endianness to local endianness.
+
+
template<typename T>
+ auto toLittleEndian(T value) -> T +
+
Converts a value from local endianness to little endianness.
+
+
template<typename T>
+ auto fromBigEndian(T value) -> T +
+
Converts a value from big endianness to local endianness.
+
+
template<typename T>
+ auto toBigEndian(T value) -> T +
+
Converts a value from local endianness to big endianness.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1core_1_1ui.html b/pr-preview/pr-494/namespacecubos_1_1core_1_1ui.html new file mode 100644 index 000000000..96677ce10 --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1core_1_1ui.html @@ -0,0 +1,169 @@ + + + + + cubos::core::ui namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ui namespace +

+

User Interface module.

+ +
+

Functions

+
+
+ void showWorld(const ecs::World& world, + data::Context* context = nullptr) +
+
Adds a ImGui window which allows the user to inspect the entities and components in a ecs::World.
+
+ void editWorld(ecs::World& world, + data::Context* serContext = nullptr, + data::Context* desContext = nullptr) +
+
Adds a ImGui window which allows the user to edit the entities and components in a ecs::World.
+
+ void initialize(io::Window window) +
+
Initializes ImGui for use with the given window.
+
+ void terminate() +
+
Shuts down ImGui.
+
+ void beginFrame() +
+
Begins a new ImGui frame. ImGui calls should be made between this and endFrame().
+
+ void endFrame(const gl::Framebuffer& target = nullptr) +
+
Ends the current ImGui frame, and renders the ImGui draw data to the target framebuffer, or the default framebuffer if target is null.
+
+ auto handleEvent(const io::WindowEvent& event) -> bool +
+
Passes a window event to ImGui.
+
+ void showPackage(const data::Package& pkg, + const std::string& name) +
+
Shows a packaged object's properties in the UI. Should be called inside a ImGui::BeginTable(2) and ImGui::EndTable() block.
+
+ auto editPackage(data::Package& pkg, + const std::string& name) -> bool +
+
Shows a packaged object's properties in the UI, allowing the user to edit the object. Should be called inside a ImGui::BeginTable(3) and ImGui::EndTable() block.
+
+
template<typename T>
+ void show(const T& object, + const std::string& name) +
+
Shows a serializable object's properties in the UI. Should be called inside a ImGui::BeginTable(2) and ImGui::EndTable() block.
+
+
template<typename T>
+ auto edit(T& object, + const std::string& name) -> bool +
+
Shows a serializable object's properties in the UI. Should be called inside a ImGui::BeginTable(3) and ImGui::EndTable() block.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1engine.html b/pr-preview/pr-494/namespacecubos_1_1engine.html new file mode 100644 index 000000000..838e8347c --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1engine.html @@ -0,0 +1,403 @@ + + + + + cubos::engine namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine namespace +

+

Engine module.

+ +
+

Namespaces

+
+
namespace impl
+
Namespace to store the abstract types implemented by the renderer implementations.
+
namespace tools
+
Namespace for tool plugins.
+
+
+
+

Classes

+
+
+
template<typename T>
+ class Asset +
+
Handle to an asset of a specific type.
+
+ class AnyAsset +
+
Handle to an asset of any type. May either be weak or strong. Weak handles do not guarantee the asset is loaded, while strong handles do.
+
+ class Assets +
+
Resource which manages all assets. Responsible for loading and unloading assets, storing them in memory, and providing access to them.
+
+ class AssetBridge +
+
Bridges are the objects responsible for loading and saving assets from/to disk. They form the bridge between the asset manager and the virtual file system.
+
+
template<typename T>
+ class BinaryBridge +
+
Bridge for loading and saving assets which are serialized to and from a binary file.
+
+ class FileBridge +
+
Abstract bridge type defined to reduce boilerplate code in bridge implementations which open a single file to load and save assets.
+
+
template<typename T>
+ class JSONBridge +
+
Bridge for loading and saving assets which are serialized to and from a JSON file.
+
+ class AssetMeta +
+
Stores metadata about an asset - the data stored in .meta files. Each asset has a corresponding meta object, which contains load or import parameters.
+
+ struct ColliderAABB +
+
Component which stores the AABB of an entity with a collider component.
+
+ struct BroadPhaseCollisions +
+
Resource which stores data used in broad phase collision detection.
+
+ struct BoxCollider +
+
Component which adds a box collider to an entity.
+
+ struct CapsuleCollider +
+
Component which adds a capsule collider to an entity.
+
+ struct PlaneCollider +
+
Component which adds a plane collider to an entity.
+
+ struct SimplexCollider +
+
Component which adds a simplex collider to an entity.
+
+ struct DeltaTime +
+
Resource which stores the time since the last iteration of the main loop started.
+
+ struct ShouldQuit +
+
Resource used as a flag to indicate whether the main loop should stop running.
+
+ struct Arguments +
+
Resource used for storing program arguments.
+
+ class TagBuilder +
+
Used to chain configurations related to tags.
+
+ class SystemBuilder +
+
Used to chain configurations related to systems.
+
+ class Cubos +
+
Represents the engine itself, and exposes the interface with which the game developer interacts with. Ties up all the different parts of the engine together.
+
+ class InputAction +
+
Stores the state of a single input action, such as "jump" or "attack".
+
+ class InputAxis +
+
Stores the state of a single input axis, such as "move forward" or "move right".
+
+ class InputBindings +
+
Stores the input bindings for a single player.
+
+ class Input +
+
Resource which stores the input bindings for multiple players.
+
+ class DeferredRenderer +
+
Renderer implementation which uses deferred rendering.
+
+ struct RendererEnvironment +
+
Resource which stores the renderer's ambient light and sky colors.
+
+ class RendererFrame +
+
Resource which describes a scene to be drawn by the renderer.
+
+ struct AmbientLight +
+
Resource which stores the ambient light.
+
+ struct SpotLight +
+
Component which makes an entity emit a spot light.
+
+ struct DirectionalLight +
+
Component which makes an entity behave like a directional light.
+
+ struct PointLight +
+
Component which makes an entity behave like a point light.
+
+ struct RenderableGrid +
+
Component which makes a voxel grid be rendered by the renderer plugin.
+
+ struct Camera +
+
Component which defines parameters of a camera used to render the world.
+
+ struct ActiveCameras +
+
Resource which identifies the camera entities to be used by the renderer.
+
+ class PostProcessingBloom +
+
A post processing pass that adds a "bloom" effect to any bright objects in the scene.
+
+ class PostProcessingCopy +
+
A simple post processing pass that copies the input texture to the output.
+
+ class PostProcessingManager +
+
Responsible for managing the post processing passes.
+
+ class PostProcessingPass +
+
A generic post processing pass.
+
+ class BaseRenderer +
+
Interface which abstracts different rendering methods.
+
+ class SceneBridge +
+
Bridge which loads and saves Scene assets.
+
+ struct Scene +
+
Asset equivalent to ECS blueprints - a bundle of entities and their components.
+
+ struct LocalToWorld +
+
Component which stores the transformation matrix of an entity, from local to world space.
+
+ struct Position +
+
Component which assigns a position to an entity.
+
+ struct Rotation +
+
Component which assigns a rotation to an entity.
+
+ struct Scale +
+
Component which assigns a uniform scale to an entity.
+
+
+
+

Enums

+
+
+ enum class PostProcessingInput { Lighting, + Position, + Normal } +
+
Possible renderer outputs which can then be used as input for a post processing pass.
+
+
+
+

Typedefs

+
+
+ using AssetMetaRead = core::memory::ReadGuard<AssetMeta, std::shared_lock<std::shared_mutex>> +
+
Read-only guard for an asset's metadata.
+
+ using AssetMetaWrite = core::memory::WriteGuard<AssetMeta, std::unique_lock<std::shared_mutex>> +
+
Read-write guard for an asset's metadata.
+
+
template<typename T>
+ using AssetRead = core::memory::ReadGuard<T, std::shared_lock<std::shared_mutex>> +
+
Read-only guard for an asset's data.
+
+
template<typename T>
+ using AssetWrite = core::memory::WriteGuard<T, std::unique_lock<std::shared_mutex>> +
+
Read-write guard for an asset's data.
+
+ using RendererGrid = std::shared_ptr<impl::RendererGrid> +
+
Handle to a grid uploaded to the GPU, to be used for rendering.
+
+ using Renderer = std::shared_ptr<BaseRenderer> +
+
Resource which is an handle to a generic renderer.
+
+
+
+

Functions

+
+
+ void assetsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void collisionsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void envSettingsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void fileSettingsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void imguiPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void inputPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void rendererPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void scenePlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void transformPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void voxelsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void windowPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1engine_1_1impl.html b/pr-preview/pr-494/namespacecubos_1_1engine_1_1impl.html new file mode 100644 index 000000000..166608720 --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1engine_1_1impl.html @@ -0,0 +1,120 @@ + + + + + cubos::engine::impl namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::impl namespace +

+

Namespace to store the abstract types implemented by the renderer implementations.

+ +
+

Classes

+
+
+ class RendererGrid +
+
Represents a grid which was uploaded to the GPU.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespacecubos_1_1engine_1_1tools.html b/pr-preview/pr-494/namespacecubos_1_1engine_1_1tools.html new file mode 100644 index 000000000..da0d85ef4 --- /dev/null +++ b/pr-preview/pr-494/namespacecubos_1_1engine_1_1tools.html @@ -0,0 +1,150 @@ + + + + + cubos::engine::tools namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::tools namespace +

+

Namespace for tool plugins.

+ +
+

Classes

+
+
+ struct AssetSelectedEvent +
+
Event sent when an asset is selected.
+
+ struct EntitySelector +
+
Resource which identifies the currently selected entity.
+
+
+
+

Functions

+
+
+ void assetExplorerPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void entityInspectorPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void entitySelectorPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void settingsInspectorPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+ void worldInspectorPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/namespaces.html b/pr-preview/pr-494/namespaces.html new file mode 100644 index 000000000..9faa44551 --- /dev/null +++ b/pr-preview/pr-494/namespaces.html @@ -0,0 +1,160 @@ + + + + + CUBOS. + + + + + + + +
+
+
+
+
+

Namespaces

+ + +
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/null__storage_8hpp.html b/pr-preview/pr-494/null__storage_8hpp.html new file mode 100644 index 000000000..919eb3f31 --- /dev/null +++ b/pr-preview/pr-494/null__storage_8hpp.html @@ -0,0 +1,133 @@ + + + + + core/ecs/null_storage.hpp file | CUBOS. + + + + + + + +
+
+ + + + + + diff --git a/pr-preview/pr-494/pages.html b/pr-preview/pr-494/pages.html new file mode 100644 index 000000000..effb275c7 --- /dev/null +++ b/pr-preview/pr-494/pages.html @@ -0,0 +1,137 @@ + + + + + CUBOS. + + + + + + + +
+
+
+
+
+

Pages

+
    +
  • Getting started How to download, build and run the engine and where to go from there.
    • +
  • + Feature Guide +
      +
    • ECS What is an ECS and how it's used in CUBOS.
      • +
    • Plugins What are plugins and how they can be used to organize your code.
      • +
    • Quadrados How to use the Quadrados CLI tool.
      • +
    +
    • +
  • + Examples Contains examples of specific features of the libraries. +
      +
    • + Core Showcases features of the Core library. +
        +
      • Logging Using the logging system.
        • +
      +
      • +
    • Engine Showcases features of the Engine library.
      • +
    +
    • +
  • Contribution guidelines Guide on the project's conventions and code style.
    • +
+ +
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/palette_8hpp.html b/pr-preview/pr-494/palette_8hpp.html new file mode 100644 index 000000000..243e5394e --- /dev/null +++ b/pr-preview/pr-494/palette_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/gl/palette.hpp file | CUBOS. + + + + + + + +
+
+ + + + + + diff --git a/pr-preview/pr-494/pass_8hpp.html b/pr-preview/pr-494/pass_8hpp.html new file mode 100644 index 000000000..9a54137b4 --- /dev/null +++ b/pr-preview/pr-494/pass_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/renderer/pps/pass.hpp file | CUBOS. + + + + + + + +
+
+ + + + + + diff --git a/pr-preview/pr-494/position_8hpp.html b/pr-preview/pr-494/position_8hpp.html new file mode 100644 index 000000000..2d5f46b62 --- /dev/null +++ b/pr-preview/pr-494/position_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/transform/position.hpp file | CUBOS. + + + + + + + +
+
+ + + + + + diff --git a/pr-preview/pr-494/query_8hpp.html b/pr-preview/pr-494/query_8hpp.html new file mode 100644 index 000000000..b8cc42569 --- /dev/null +++ b/pr-preview/pr-494/query_8hpp.html @@ -0,0 +1,149 @@ + + + + + core/ecs/query.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/query.hpp file +

+

Class cubos::core::ecs::Query and related types.

+ +

This file is a bit scary, but it's not as bad as it looks. It's mostly template specializations to handle the different types of arguments a query can take.

+
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
namespace cubos::core::ecs::impl
+
Contains functions used internally by the implementation of the ECS.
+
+
+
+

Classes

+
+
+ struct cubos::core::ecs::QueryInfo +
+
Describes a query.
+
+
template<typename T>
+ struct cubos::core::ecs::impl::QueryFetcher +
+
Fetches the requested data from a world.
+
+
template<typename... ComponentTypes>
+ class cubos::core::ecs::Query +
+
Holds the result of a query over all entities in world which match the given arguments.
+
+ class cubos::core::ecs::Query::Iterator +
+
Used to iterate over the results of a query.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/registry_8hpp.html b/pr-preview/pr-494/registry_8hpp.html new file mode 100644 index 000000000..c1dcb16e3 --- /dev/null +++ b/pr-preview/pr-494/registry_8hpp.html @@ -0,0 +1,144 @@ + + + + + core/ecs/registry.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/registry.hpp file +

+

Class cubos::core::ecs::Registry and registration macro.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
+
+
+

Classes

+
+
+ class cubos::core::ecs::Registry +
+
Singleton which holds a global registry for all component types.
+
+
+
+

Defines

+
+
+ #define CUBOS_REGISTER_COMPONENT(type, + storageType, + name) +
+
Macro used to register a component type as an alternative to calling cubos::core::ecs::Registry::add() manually.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/render__device_8hpp.html b/pr-preview/pr-494/render__device_8hpp.html new file mode 100644 index 000000000..a050dbd26 --- /dev/null +++ b/pr-preview/pr-494/render__device_8hpp.html @@ -0,0 +1,594 @@ + + + + + core/gl/render_device.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/gl/render_device.hpp file +

+

Class cubos::core::gl::RenderDevice and related types.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::gl
+
Graphics module.
+
namespace cubos::core::gl::impl
+
Namespace to store the abstract types implemented by the render device implementations.
+
+
+
+

Classes

+
+
+ struct cubos::core::gl::FramebufferDesc +
+
Describes a framebuffer.
+
+ struct cubos::core::gl::FramebufferDesc::CubeMapTarget +
+
Describes a cube map target.
+
+ struct cubos::core::gl::FramebufferDesc::Texture2DTarget +
+
Describes a 2D texture target.
+
+ struct cubos::core::gl::FramebufferDesc::CubeMapArrayTarget +
+
Describes a cube map array target.
+
+ struct cubos::core::gl::FramebufferDesc::Texture2DArrayTarget +
+
Describes a 2D texture array target.
+
+ struct cubos::core::gl::FramebufferDesc::FramebufferTarget +
+
Describes a framebuffer target.
+
+ struct cubos::core::gl::RasterStateDesc +
+
Decribes a rasterizer state.
+
+ struct cubos::core::gl::DepthStencilStateDesc +
+
Describes a depth stencil state.
+
+ struct cubos::core::gl::DepthStencilStateDesc::Depth +
+
Decribes a depth state.
+
+ struct cubos::core::gl::DepthStencilStateDesc::Stencil +
+
Describes a stencil state.
+
+ struct cubos::core::gl::DepthStencilStateDesc::Stencil::Face +
+
Decribes a stencil face.
+
+ struct cubos::core::gl::BlendStateDesc +
+
Describes a blend state.
+
+ struct cubos::core::gl::SamplerDesc +
+
Describes a sampler.
+
+ struct cubos::core::gl::Texture1DDesc +
+
Describes a 1D texture.
+
+ struct cubos::core::gl::Texture2DDesc +
+
Describes a 2D texture.
+
+ struct cubos::core::gl::Texture2DArrayDesc +
+
Describes a 2D texture array.
+
+ struct cubos::core::gl::Texture3DDesc +
+
Describes a 3D texture.
+
+ struct cubos::core::gl::CubeMapDesc +
+
Describes a cube map.
+
+ struct cubos::core::gl::CubeMapArrayDesc +
+
Describes a cube map array.
+
+ struct cubos::core::gl::ConstantBufferElement +
+
Describes an element in a constant buffer.
+
+ struct cubos::core::gl::ConstantBufferStructure +
+
Describes the structure of a constant buffer.
+
+ struct cubos::core::gl::VertexElement +
+
Describes a vertex element.
+
+ struct cubos::core::gl::VertexArrayDesc +
+
Describes a vertex array.
+
+ class cubos::core::gl::RenderDevice +
+
Interface used to wrap low-level rendering APIs such as OpenGL.
+
+ class cubos::core::gl::impl::Framebuffer +
+
Abstract framebuffer.
+
+ class cubos::core::gl::impl::RasterState +
+
Abstract rasterizer state.
+
+ class cubos::core::gl::impl::DepthStencilState +
+
Abstract depth stencil state.
+
+ class cubos::core::gl::impl::BlendState +
+
Abstract blend state.
+
+ class cubos::core::gl::impl::Sampler +
+
Abstract sampler.
+
+ class cubos::core::gl::impl::Texture1D +
+
Abstract 1D texture.
+
+ class cubos::core::gl::impl::Texture2D +
+
Abstract 2D texture.
+
+ class cubos::core::gl::impl::Texture2DArray +
+
Abstract 2D texture array.
+
+ class cubos::core::gl::impl::Texture3D +
+
Abstract 3D texture.
+
+ class cubos::core::gl::impl::CubeMap +
+
Abstract cube map.
+
+ class cubos::core::gl::impl::CubeMapArray +
+
Abstract cube map.
+
+ class cubos::core::gl::impl::ConstantBuffer +
+
Abstract constant buffer.
+
+ class cubos::core::gl::impl::IndexBuffer +
+
Abstract index buffer.
+
+ class cubos::core::gl::impl::VertexBuffer +
+
Abstract vertex buffer.
+
+ class cubos::core::gl::impl::VertexArray +
+
Abstract vertex array.
+
+ class cubos::core::gl::impl::ShaderStage +
+
Abstract shader stage.
+
+ class cubos::core::gl::impl::ShaderPipeline +
+
Abstract shader pipeline.
+
+ class cubos::core::gl::impl::ShaderBindingPoint +
+
Abstract shader binding point.
+
+
+
+

Enums

+
+
+ enum class Property { MaxAnisotropy, + ComputeSupported } +
+
Render device properties that can be queried at runtime.
+
+ enum class Usage { Default, + Dynamic, + Static } +
+
Usage mode for buffers and textures.
+
+ enum class Type { Byte, + Short, + Int, + UByte, + UShort, + UInt, + NByte, + NShort, + NUByte, + NUShort, + Float } +
+
Data type.
+
+ enum class IndexFormat { UShort, + UInt } +
+
Index format.
+
+ enum class TextureFormat { R8SNorm, + R16SNorm, + RG8SNorm, + RG16SNorm, + RGBA8SNorm, + RGBA16SNorm, + R8UNorm, + R16UNorm, + RG8UNorm, + RG16UNorm, + RGBA8UNorm, + RGBA16UNorm, + R8SInt, + R16SInt, + RG8SInt, + RG16SInt, + RGBA8SInt, + RGBA16SInt, + R8UInt, + R16UInt, + RG8UInt, + RG16UInt, + RGBA8UInt, + RGBA16UInt, + R16Float, + R32Float, + RG16Float, + RG32Float, + RGB16Float, + RGB32Float, + RGBA16Float, + RGBA32Float, + Depth16, + Depth32, + Depth24Stencil8, + Depth32Stencil8 } +
+
Texture format.
+
+ enum class AddressMode { Repeat, + Mirror, + Clamp, + Border } +
+
Texture address mode.
+
+ enum class TextureFilter { None, + Nearest, + Linear } +
+
Texture filter type.
+
+ enum class Winding { CW, + CCW } +
+
Triangle winding mode.
+
+ enum class Face { Front, + Back, + FrontAndBack } +
+
Specifies a face.
+
+ enum class RasterMode { Wireframe, + Fill } +
+
Rasterizer mode.
+
+ enum class Compare { Never, + Less, + LEqual, + Greater, + GEqual, + Equal, + NEqual, + Always } +
+
Comparison function.
+
+ enum class StencilAction { Zero, + Keep, + Replace, + Increment, + IncrementWrap, + Decrement, + DecrementWrap, + Invert } +
+
Stencil action.
+
+ enum class BlendFactor { Zero, + One, + SrcColor, + InvSrcColor, + DstColor, + InvDstColor, + SrcAlpha, + InvSrcAlpha, + DstAlpha, + InvDstAlpha } +
+
Blend factor.
+
+ enum class BlendOp { Add, + Substract, + RevSubstract, + Min, + Max } +
+
Blend operation.
+
+ enum class Stage { Vertex, + Geometry, + Pixel, + Compute } +
+
Shader stage type.
+
+ enum class CubeFace { PositiveX = 0, + NegativeX = 1, + PositiveY = 2, + NegativeY = 3, + PositiveZ = 4, + NegativeZ = 5 } +
+
Cube map face.
+
+ enum class MemoryBarriers { None = 0, + VertexBuffer = 1, + IndexBuffer = 2, + ConstantBuffer = 4, + ImageAccess = 8, + TextureAccess = 16, + Framebuffer = 32, + All = VertexBuffer | IndexBuffer | ConstantBuffer | ImageAccess | TextureAccess | Framebuffer } +
+
Memory barrier flags for synchronization.
+
+ enum class Access { Read, + Write, + ReadWrite } +
+
Access mode for a resource.
+
+
+
+

Typedefs

+
+
+ using Framebuffer = std::shared_ptr<impl::Framebuffer> +
+
Handle to a framebuffer.
+
+ using RasterState = std::shared_ptr<impl::RasterState> +
+
Handle to a rasterizer state.
+
+ using DepthStencilState = std::shared_ptr<impl::DepthStencilState> +
+
Handle to a depth stencil state.
+
+ using BlendState = std::shared_ptr<impl::BlendState> +
+
Handle to a blend state.
+
+ using Sampler = std::shared_ptr<impl::Sampler> +
+
Handle to a sampler.
+
+ using Texture1D = std::shared_ptr<impl::Texture1D> +
+
Handle to a 1D texture.
+
+ using Texture2D = std::shared_ptr<impl::Texture2D> +
+
Handle to a 2D texture.
+
+ using Texture2DArray = std::shared_ptr<impl::Texture2DArray> +
+
Handle to a 2D texture array.
+
+ using Texture3D = std::shared_ptr<impl::Texture3D> +
+
Handle to a 3D texture.
+
+ using CubeMap = std::shared_ptr<impl::CubeMap> +
+
Handle to a cube map.
+
+ using CubeMapArray = std::shared_ptr<impl::CubeMapArray> +
+
Handle to a cube map array.
+
+ using ConstantBuffer = std::shared_ptr<impl::ConstantBuffer> +
+
Handle to a constant buffer.
+
+ using IndexBuffer = std::shared_ptr<impl::IndexBuffer> +
+
Handle to an index buffer.
+
+ using VertexBuffer = std::shared_ptr<impl::VertexBuffer> +
+
Handle to a vertex buffer.
+
+ using VertexArray = std::shared_ptr<impl::VertexArray> +
+
Handle to a vertex array.
+
+ using ShaderStage = std::shared_ptr<impl::ShaderStage> +
+
Handle to a shader stage.
+
+ using ShaderPipeline = std::shared_ptr<impl::ShaderPipeline> +
+
Handle to a shader pipeline.
+
+ using ShaderBindingPoint = impl::ShaderBindingPoint* +
+
Handle to a shader binding point.
+
+
+
+

Defines

+
+
+ #define CUBOS_CORE_GL_MAX_FRAMEBUFFER_RENDER_TARGET_COUNT +
+
Maximum number of render targets that can be set on a framebuffer.
+
+ #define CUBOS_CORE_GL_MAX_TEXTURE_2D_ARRAY_SIZE +
+
Maximum number of textures on a 2D texture array.
+
+ #define CUBOS_CORE_GL_MAX_CUBEMAP_ARRAY_SIZE +
+
Maximum number of cube maps on a cubemap array.
+
+ #define CUBOS_CORE_GL_MAX_MIP_LEVEL_COUNT +
+
Maximum mip level count.
+
+ #define CUBOS_CORE_GL_MAX_CONSTANT_BUFFER_ELEMENT_NAME_SIZE +
+
Maximum constant buffer element name size.
+
+ #define CUBOS_CORE_GL_MAX_CONSTANT_BUFFER_ELEMENT_COUNT +
+
Maximum constant buffer element count.
+
+ #define CUBOS_CORE_GL_MAX_VERTEX_ARRAY_ELEMENT_COUNT +
+
Maximum number of vertex array elements.
+
+ #define CUBOS_CORE_GL_MAX_VERTEX_ARRAY_BUFFER_COUNT +
+
Maximum number of buffers on a vertex array.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/renderer_2plugin_8hpp.html b/pr-preview/pr-494/renderer_2plugin_8hpp.html new file mode 100644 index 000000000..8c46dd6db --- /dev/null +++ b/pr-preview/pr-494/renderer_2plugin_8hpp.html @@ -0,0 +1,148 @@ + + + + + engine/renderer/plugin.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/renderer/plugin.hpp file +

+

Plugin entry point, resource cubos::engine::ActiveCameras and components cubos::engine::RenderableGrid and cubos::engine::Camera.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
+
+
+

Classes

+
+
+ struct cubos::engine::RenderableGrid +
+
Component which makes a voxel grid be rendered by the renderer plugin.
+
+ struct cubos::engine::Camera +
+
Component which defines parameters of a camera used to render the world.
+
+ struct cubos::engine::ActiveCameras +
+
Resource which identifies the camera entities to be used by the renderer.
+
+
+
+

Functions

+
+
+ void rendererPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/renderer_8hpp.html b/pr-preview/pr-494/renderer_8hpp.html new file mode 100644 index 000000000..a16a12824 --- /dev/null +++ b/pr-preview/pr-494/renderer_8hpp.html @@ -0,0 +1,150 @@ + + + + + engine/renderer/renderer.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/renderer/renderer.hpp file +

+

Class cubos::engine::BaseRenderer and resource cubos::engine::Renderer.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
namespace cubos::engine::impl
+
Namespace to store the abstract types implemented by the renderer implementations.
+
+
+
+

Classes

+
+
+ class cubos::engine::BaseRenderer +
+
Interface which abstracts different rendering methods.
+
+ class cubos::engine::impl::RendererGrid +
+
Represents a grid which was uploaded to the GPU.
+
+
+
+

Typedefs

+
+
+ using RendererGrid = std::shared_ptr<impl::RendererGrid> +
+
Handle to a grid uploaded to the GPU, to be used for rendering.
+
+ using Renderer = std::shared_ptr<BaseRenderer> +
+
Resource which is an handle to a generic renderer.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/resource__manager_8hpp.html b/pr-preview/pr-494/resource__manager_8hpp.html new file mode 100644 index 000000000..8bb32e97d --- /dev/null +++ b/pr-preview/pr-494/resource__manager_8hpp.html @@ -0,0 +1,142 @@ + + + + + core/ecs/resource_manager.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/resource_manager.hpp file +

+

Class cubos::core::ecs::ResourceManager and related types.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
+
+
+

Classes

+
+
+
template<typename T>
+ class cubos::core::ecs::ReadResource +
+
Utility struct used to reference a resource of type T for reading.
+
+
template<typename T>
+ class cubos::core::ecs::WriteResource +
+
Utility struct used to reference a resource of type T for writing.
+
+ class cubos::core::ecs::ResourceManager +
+
Holds and manages resources.
+
+
+
+
+
+
+ + + + + + diff --git a/pr-preview/pr-494/rotation_8hpp.html b/pr-preview/pr-494/rotation_8hpp.html new file mode 100644 index 000000000..ed6bb4ec4 --- /dev/null +++ b/pr-preview/pr-494/rotation_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/transform/rotation.hpp file | CUBOS. + + + + + + + +
+
+ + + + + + diff --git a/pr-preview/pr-494/scale_8hpp.html b/pr-preview/pr-494/scale_8hpp.html new file mode 100644 index 000000000..bcaa68b57 --- /dev/null +++ b/pr-preview/pr-494/scale_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/transform/scale.hpp file | CUBOS. + + + + + + + +
+
+ + + + + + diff --git a/pr-preview/pr-494/scene_2bridge_8hpp.html b/pr-preview/pr-494/scene_2bridge_8hpp.html new file mode 100644 index 000000000..ffe2aacb3 --- /dev/null +++ b/pr-preview/pr-494/scene_2bridge_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/scene/bridge.hpp file | CUBOS. + + + + + + + +
+
+ + + + + + diff --git a/pr-preview/pr-494/scene_2plugin_8hpp.html b/pr-preview/pr-494/scene_2plugin_8hpp.html new file mode 100644 index 000000000..b86fe2ef1 --- /dev/null +++ b/pr-preview/pr-494/scene_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/scene/plugin.hpp file | CUBOS. + + + + + + + +
+
+ + + + + + diff --git a/pr-preview/pr-494/scene_8hpp.html b/pr-preview/pr-494/scene_8hpp.html new file mode 100644 index 000000000..57218fbc5 --- /dev/null +++ b/pr-preview/pr-494/scene_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/scene/scene.hpp file | CUBOS. + + + + + + + +
+
+ + + + + + diff --git a/pr-preview/pr-494/search-v2.js b/pr-preview/pr-494/search-v2.js new file mode 100644 index 000000000..1fb71e1f8 --- /dev/null +++ b/pr-preview/pr-494/search-v2.js @@ -0,0 +1,897 @@ +/* + This file is part of m.css. + + Copyright © 2017, 2018, 2019, 2020, 2021, 2022, 2023 + Vladimír Vondruš + + Permission is hereby granted, free of charge, to any person obtaining a + copy of this software and associated documentation files (the "Software"), + to deal in the Software without restriction, including without limitation + the rights to use, copy, modify, merge, publish, distribute, sublicense, + and/or sell copies of the Software, and to permit persons to whom the + Software is furnished to do so, subject to the following conditions: + + The above copyright notice and this permission notice shall be included + in all copies or substantial portions of the Software. + + THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR + IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, + FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL + THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER + LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING + FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER + DEALINGS IN THE SOFTWARE. +*/ + +"use strict"; /* it summons the Cthulhu in a proper way, they say */ + +var Search = { + formatVersion: 2, /* the data filename contains this number too */ + + dataSize: 0, /* used mainly by tests, not here */ + symbolCount: '…', + trie: null, + map: null, + mapFlagsOffset: null, + typeMap: null, + maxResults: 0, + + /* Type sizes and masks. The data is always fetched as 16/32bit number and + then masked to 1, 2, 3 or 4 bytes. Fortunately on LE a mask is enough, + on BE we'd have to read N bytes before and then mask. */ + nameSizeBytes: null, + nameSizeMask: null, + resultIdBytes: null, + resultIdMask: null, + fileOffsetBytes: null, + fileOffsetMask: null, + lookaheadBarrierMask: null, + + /* Always contains at least the root node offset and then one node offset + per entered character */ + searchString: '', + searchStack: [], + + /* So items don't get selected right away when a cursor is over results but + only after mouse moves */ + mouseMovedSinceLastRender: false, + + /* Whether we can go back in history in order to hide the search box or + not. We can't do that if we arrived directly on #search from outside. */ + canGoBackToHideSearch: false, + + /* Autocompletion in the input field is whitelisted only for character + input (so not deletion, cut, or anything else). This is flipped in the + onkeypress event and reset after each oninput event. */ + autocompleteNextInputEvent: false, + + init: function(buffer, maxResults) { + let view = new DataView(buffer); + + /* The file is too short to contain at least the headers and empty + sections */ + if(view.byteLength < 31) { + console.error("Search data too short"); + return false; + } + + if(view.getUint8(0) != 'M'.charCodeAt(0) || + view.getUint8(1) != 'C'.charCodeAt(0) || + view.getUint8(2) != 'S'.charCodeAt(0)) { + console.error("Invalid search data signature"); + return false; + } + + if(view.getUint8(3) != this.formatVersion) { + console.error("Invalid search data version"); + return false; + } + + /* Fetch type sizes. The only value that can fail is result ID byte + count, where value of 3 has no assigned meaning. */ + let typeSizes = view.getUint8(4, true); + if((typeSizes & 0x01) >> 0 == 0) { + this.fileOffsetBytes = 3; + this.fileOffsetMask = 0x00ffffff; + this.lookaheadBarrierMask = 0x00800000; + } else /* (typeSizes & 0x01) >> 0 == 1 */ { + this.fileOffsetBytes = 4; + this.fileOffsetMask = 0xffffffff; + this.lookaheadBarrierMask = 0x80000000; + } + if((typeSizes & 0x06) >> 1 == 0) { + this.resultIdBytes = 2; + this.resultIdMask = 0x0000ffff; + } else if((typeSizes & 0x06) >> 1 == 1) { + this.resultIdBytes = 3; + this.resultIdMask = 0x00ffffff; + } else if((typeSizes & 0x06) >> 1 == 2) { + this.resultIdBytes = 4; + this.resultIdMask = 0xffffffff; + } else /* (typeSizes & 0x06) >> 1 == 3 */ { + console.error("Invalid search data result ID byte value"); + return false; + } + if((typeSizes & 0x08) >> 3 == 0) { + this.nameSizeBytes = 1; + this.nameSizeMask = 0x00ff; + } else /* (typeSizes & 0x08) >> 3 == 1 */ { + this.nameSizeBytes = 2; + this.nameSizeMask = 0xffff; + } + + /* Separate the data into the trie and the result / type map. Because + we're reading larger values than there might be and then masking out + the high bytes, keep extra 1/2 byte padding at the end to avoid + OOB errors. */ + let mapOffset = view.getUint32(12, true); + let typeMapOffset = view.getUint32(16, true); + /* There may be a 3-byte file offset at the end of the trie which we'll + read as 32-bit, add one safety byte in that case */ + this.trie = new DataView(buffer, 20, mapOffset - 20 + (4 - this.fileOffsetBytes)); + /* There may be a 3-byte file size (for zero results) which we'll read + as 32-bit, add one safety byte in that case */ + this.map = new DataView(buffer, mapOffset, typeMapOffset - mapOffset + (4 - this.fileOffsetBytes)); + /* No variable-size types in the type map at the moment */ + this.typeMap = new DataView(buffer, typeMapOffset); + + /* Offset of the first result map item is after N + 1 offsets and N + flags, calculate flag offset from that */ + this.mapFlagsOffset = this.fileOffsetBytes*(((this.map.getUint32(0, true) & this.fileOffsetMask) - this.fileOffsetBytes)/(this.fileOffsetBytes + 1) + 1); + + /* Set initial properties */ + this.dataSize = buffer.byteLength; + this.symbolCount = view.getUint32(8, true) + " symbols (" + Math.round(this.dataSize/102.4)/10 + " kB)"; + this.maxResults = maxResults ? maxResults : 100; + this.searchString = ''; + this.searchStack = [this.trie.getUint32(0, true)]; + + /* istanbul ignore if */ + if(typeof document !== 'undefined') { + document.getElementById('search-symbolcount').innerHTML = this.symbolCount; + document.getElementById('search-input').disabled = false; + document.getElementById('search-input').placeholder = "Type something here …"; + document.getElementById('search-input').focus(); + + /* Search for the input value (there might be something already, + for example when going back in the browser) */ + let value = document.getElementById('search-input').value; + + /* Otherwise check the GET parameters for `q` and fill the input + with that */ + if(!value.length) { + var args = decodeURIComponent(window.location.search.substr(1)).trim().split('&'); + for(var i = 0; i != args.length; ++i) { + if(args[i].substring(0, 2) != 'q=') continue; + + value = document.getElementById('search-input').value = args[i].substring(2); + break; + } + } + + if(value.length) Search.searchAndRender(value); + } + + return true; + }, + + download: /* istanbul ignore next */ function(url) { + var req = window.XDomainRequest ? new XDomainRequest() : new XMLHttpRequest(); + if(!req) return; + + req.open("GET", url, true); + req.responseType = 'arraybuffer'; + req.onreadystatechange = function() { + if(req.readyState != 4) return; + + Search.init(req.response); + } + req.send(); + }, + + base85decode: function(base85string) { + function charValue(char) { + if(char >= 48 && char < 58) /* 0-9 -> 0-9 */ + return char - 48 + 0; + if(char >= 65 && char < 91) /* A-Z -> 10-35 */ + return char - 65 + 10; + if(char >= 97 && char < 123) /* a-z -> 36-61 */ + return char - 97 + 36; + if(char == 33) /* ! -> 62 */ + return 62; + /* skipping 34 (') */ + if(char >= 35 && char < 39) /* #-& -> 63-66 */ + return char - 35 + 63; + /* skipping 39 (") */ + if(char >= 40 && char < 44) /* (-+ -> 67-70 */ + return char - 40 + 67; + /* skipping 44 (,) */ + if(char == 45) /* - -> 71 */ + return 71; + if(char >= 59 && char < 65) /* ;-@ -> 72-77 */ + return char - 59 + 72; + if(char >= 94 && char < 97) /* ^-` -> 78-80 */ + return char - 94 + 78; + if(char >= 123 && char < 127) /* {-~ -> 81-84 */ + return char - 123 + 81; + + return 0; /* Interpret padding values as zeros */ + } + + /* Pad the string for easier decode later. We don't read past the file + end, so it doesn't matter what garbage is there. */ + if(base85string.length % 5) { + console.log("Expected properly padded base85 data"); + return; + } + + let buffer = new ArrayBuffer(base85string.length*4/5); + let data8 = new DataView(buffer); + for(let i = 0; i < base85string.length; i += 5) { + let char1 = charValue(base85string.charCodeAt(i + 0)); + let char2 = charValue(base85string.charCodeAt(i + 1)); + let char3 = charValue(base85string.charCodeAt(i + 2)); + let char4 = charValue(base85string.charCodeAt(i + 3)); + let char5 = charValue(base85string.charCodeAt(i + 4)); + + data8.setUint32(i*4/5, char5 + + char4*85 + + char3*85*85 + + char2*85*85*85 + + char1*85*85*85*85, false); /* BE, yes */ + } + + return buffer; + }, + + load: function(base85string) { + return this.init(this.base85decode(base85string)); + }, + + /* http://ecmanaut.blogspot.com/2006/07/encoding-decoding-utf8-in-javascript.html */ + toUtf8: function(string) { return unescape(encodeURIComponent(string)); }, + fromUtf8: function(string) { return decodeURIComponent(escape(string)); }, + + autocompletedCharsToUtf8: function(chars) { + /* Strip incomplete UTF-8 chars from the autocompletion end */ + for(let i = chars.length - 1; i >= 0; --i) { + let c = chars[i]; + + /* We're safe, finish */ + if( + /* ASCII value at the end */ + (c < 128 && i + 1 == chars.length) || + + /* Full two-byte character at the end */ + ((c & 0xe0) == 0xc0 && i + 2 == chars.length) || + + /* Full three-byte character at the end */ + ((c & 0xf0) == 0xe0 && i + 3 == chars.length) || + + /* Full four-byte character at the end */ + ((c & 0xf8) == 0xf0 && i + 4 == chars.length) + ) break; + + /* Continuing UTF-8 character, go further back */ + if((c & 0xc0) == 0x80) continue; + + /* Otherwise the character is not complete, drop it from the end */ + chars.length = i; + break; + } + + /* Convert the autocompleted UTF-8 sequence to a string */ + let suggestedTabAutocompletionString = ''; + for(let i = 0; i != chars.length; ++i) + suggestedTabAutocompletionString += String.fromCharCode(chars[i]); + return suggestedTabAutocompletionString; + }, + + /* Returns the values in UTF-8, but input is in whatever shitty 16bit + encoding JS has */ + search: function(searchString) { + /* Normalize the search string first, convert to UTF-8 and trim spaces + from the left. From the right they're trimmed only if nothing is + found, see below. */ + searchString = this.toUtf8(searchString.toLowerCase().replace(/^\s+/,'')); + + /* TODO: maybe i could make use of InputEvent.data and others here */ + + /* Find longest common prefix of previous and current value so we don't + need to needlessly search again */ + let max = Math.min(searchString.length, this.searchString.length); + let commonPrefix = 0; + for(; commonPrefix != max; ++commonPrefix) + if(searchString[commonPrefix] != this.searchString[commonPrefix]) break; + + /* Drop items off the stack if it has has more than is needed for the + common prefix (it needs to have at least one item, though) */ + if(commonPrefix + 1 < this.searchStack.length) + this.searchStack.splice(commonPrefix + 1, this.searchStack.length - commonPrefix - 1); + + /* Add new characters from the search string */ + let foundPrefix = commonPrefix; + for(; foundPrefix != searchString.length; ++foundPrefix) { + /* Calculate offset and count of children */ + let offset = this.searchStack[this.searchStack.length - 1]; + + /* If there's a lot of results, the result count is a 16bit BE value + instead */ + let resultCount = this.trie.getUint8(offset); + let resultCountSize = 1; + if(resultCount & 0x80) { + resultCount = this.trie.getUint16(offset, false) & ~0x8000; + ++resultCountSize; + } + + let childCount = this.trie.getUint8(offset + resultCountSize); + + /* Go through all children and find the next offset */ + let childOffset = offset + resultCountSize + 1 + resultCount*this.resultIdBytes; + let found = false; + for(let j = 0; j != childCount; ++j) { + if(String.fromCharCode(this.trie.getUint8(childOffset + j)) != searchString[foundPrefix]) + continue; + + this.searchStack.push(this.trie.getUint32(childOffset + childCount + j*this.fileOffsetBytes, true) & this.fileOffsetMask & ~this.lookaheadBarrierMask); + found = true; + break; + } + + /* Character not found */ + if(!found) { + /* If we found everything except spaces at the end, pretend the + spaces aren't there. On the other hand, we *do* want to + try searching with the spaces first -- it can narrow down + the result list for page names or show subpages (which are + after a lookahead barrier that's a space). */ + if(!searchString.substr(foundPrefix).trim().length) + searchString = searchString.substr(0, foundPrefix); + + break; + } + } + + /* Save the whole found prefix for next time */ + this.searchString = searchString.substr(0, foundPrefix); + + /* If the whole thing was not found, return an empty result and offer + external search */ + if(foundPrefix != searchString.length) { + /* istanbul ignore if */ + if(typeof document !== 'undefined') { + let link = document.getElementById('search-external'); + if(link) + link.href = link.dataset.searchEngine.replace('{query}', encodeURIComponent(searchString)); + } + return [[], '']; + } + + /* Otherwise gather the results */ + let suggestedTabAutocompletionChars = []; + let results = []; + let leaves = [[this.searchStack[this.searchStack.length - 1], 0]]; + while(leaves.length) { + /* Pop offset from the queue */ + let current = leaves.shift(); + let offset = current[0]; + let suffixLength = current[1]; + + /* Calculate child count. If there's a lot of results, the count + "leaks over" to the child count storage. */ + /* TODO: hmmm. this is helluvalot duplicated code. hmm. */ + let resultCount = this.trie.getUint8(offset); + let resultCountSize = 1; + if(resultCount & 0x80) { + resultCount = this.trie.getUint16(offset, false) & ~0x8000; + ++resultCountSize; + } + + let childCount = this.trie.getUint8(offset + resultCountSize); + + /* Populate the results with all values associated with this node */ + for(let i = 0; i != resultCount; ++i) { + let index = this.trie.getUint32(offset + resultCountSize + 1 + i*this.resultIdBytes, true) & this.resultIdMask; + results.push(this.gatherResult(index, suffixLength, 0xffffff)); /* should be enough haha */ + + /* 'nuff said. */ + if(results.length >= this.maxResults) + return [results, this.autocompletedCharsToUtf8(suggestedTabAutocompletionChars)]; + } + + /* Dig deeper */ + let childOffset = offset + resultCountSize + 1 + resultCount*this.resultIdBytes; + for(let j = 0; j != childCount; ++j) { + let offsetBarrier = this.trie.getUint32(childOffset + childCount + j*this.fileOffsetBytes, true) & this.fileOffsetMask; + + /* Lookahead barrier, don't dig deeper */ + if(offsetBarrier & this.lookaheadBarrierMask) continue; + + /* Append to the queue */ + leaves.push([offsetBarrier & ~this.lookaheadBarrierMask, suffixLength + 1]); + + /* We don't have anything yet and this is the only path + forward, add the char to suggested Tab autocompletion. Can't + extract it from the leftmost 8 bits of offsetBarrier because + that would make it negative, have to load as Uint8 instead. + Also can't use String.fromCharCode(), because later doing + str.charCodeAt() would give me back UTF-16 values, which is + absolutely unwanted when all I want is check for truncated + UTF-8. */ + if(!results.length && leaves.length == 1 && childCount == 1) + suggestedTabAutocompletionChars.push(this.trie.getUint8(childOffset + j)); + } + } + + return [results, this.autocompletedCharsToUtf8(suggestedTabAutocompletionChars)]; + }, + + gatherResult: function(index, suffixLength, maxUrlPrefix) { + let flags = this.map.getUint8(this.mapFlagsOffset + index); + let resultOffset = this.map.getUint32(index*this.fileOffsetBytes, true) & this.fileOffsetMask; + + /* The result is an alias, parse the aliased prefix */ + let aliasedIndex = null; + if((flags & 0xf0) == 0x00) { + aliasedIndex = this.map.getUint32(resultOffset, true) & this.resultIdMask; + resultOffset += this.resultIdBytes; + } + + /* The result has a prefix, parse that first, recursively */ + let name = ''; + let url = ''; + if(flags & (1 << 3)) { + let prefixIndex = this.map.getUint32(resultOffset, true) & this.resultIdMask; + let prefixUrlPrefixLength = Math.min(this.map.getUint16(resultOffset + this.resultIdBytes, true) & this.nameSizeMask, maxUrlPrefix); + + let prefix = this.gatherResult(prefixIndex, 0 /*ignored*/, prefixUrlPrefixLength); + name = prefix.name; + url = prefix.url; + + resultOffset += this.resultIdBytes + this.nameSizeBytes; + } + + /* The result has a suffix, extract its length */ + let resultSuffixLength = 0; + if(flags & (1 << 0)) { + resultSuffixLength = this.map.getUint16(resultOffset, true) & this.nameSizeMask; + resultOffset += this.nameSizeBytes; + } + + let nextResultOffset = this.map.getUint32((index + 1)*this.fileOffsetBytes, true) & this.fileOffsetMask; + + /* Extract name */ + let j = resultOffset; + for(; j != nextResultOffset; ++j) { + let c = this.map.getUint8(j); + + /* End of null-delimited name */ + if(!c) { + ++j; + break; /* null-delimited */ + } + + name += String.fromCharCode(c); /* eheh. IS THIS FAST?! */ + } + + /* The result is an alias and we're not deep inside resolving a prefix, + extract the aliased name and URL */ + /* TODO: this abuses 0xffffff to guess how the call stack is deep and + that's just wrong, fix! */ + if(aliasedIndex != null && maxUrlPrefix == 0xffffff) { + let alias = this.gatherResult(aliasedIndex, 0 /* ignored */, 0xffffff); /* should be enough haha */ + + /* Keeping in UTF-8, as we need that for proper slicing (and concatenating) */ + return {name: name, + alias: alias.name, + url: alias.url, + flags: alias.flags, + cssClass: alias.cssClass, + typeName: alias.typeName, + suffixLength: suffixLength + resultSuffixLength}; + } + + /* Otherwise extract URL from here */ + let max = Math.min(j + maxUrlPrefix - url.length, nextResultOffset); + for(; j != max; ++j) { + url += String.fromCharCode(this.map.getUint8(j)); + } + + /* This is an alias, return what we have, without parsed CSS class and + type name as those are retrieved from the final target type */ + if(!(flags >> 4)) + return {name: name, + url: url, + flags: flags & 0x0f, + suffixLength: suffixLength + resultSuffixLength}; + + /* Otherwise, get CSS class and type name for the result label */ + let typeMapIndex = (flags >> 4) - 1; + let cssClass = [ + /* Keep in sync with _search.py */ + 'm-default', + 'm-primary', + 'm-success', + 'm-warning', + 'm-danger', + 'm-info', + 'm-dim' + ][this.typeMap.getUint8(typeMapIndex*2)]; + let typeNameOffset = this.typeMap.getUint8(typeMapIndex*2 + 1); + let nextTypeNameOffset = this.typeMap.getUint8((typeMapIndex + 1)*2 + 1); + let typeName = ''; + for(let j = typeNameOffset; j != nextTypeNameOffset; ++j) + typeName += String.fromCharCode(this.typeMap.getUint8(j)); + + /* Keeping in UTF-8, as we need that for proper slicing (and + concatenating). Strip the type from the flags, as it's now expressed + directly. */ + return {name: name, + url: url, + flags: flags & 0x0f, + cssClass: cssClass, + typeName: typeName, + suffixLength: suffixLength + resultSuffixLength}; + }, + + escape: function(name) { + return name.replace(/[\"&<>]/g, function (a) { + return { '"': '"', '&': '&', '<': '<', '>': '>' }[a]; + }); + }, + escapeForRtl: function(name) { + /* Besides the obvious escaping of HTML entities we also need + to escape punctuation, because due to the RTL hack to cut + text off on left side the punctuation characters get + reordered (of course). Prepending ‎ works for most + characters, parentheses we need to *soak* in it. But only + the right ones. And that for some reason needs to be also for &. + Huh. https://en.wikipedia.org/wiki/Right-to-left_mark */ + return this.escape(name).replace(/[:=]/g, '‎$&').replace(/(\)|>|&|\/)/g, '‎$&‎'); + }, + + renderResults: /* istanbul ignore next */ function(resultsSuggestedTabAutocompletion) { + if(!this.searchString.length) { + document.getElementById('search-help').style.display = 'block'; + document.getElementById('search-results').style.display = 'none'; + document.getElementById('search-notfound').style.display = 'none'; + return; + } + + document.getElementById('search-help').style.display = 'none'; + + /* Results found */ + if(resultsSuggestedTabAutocompletion[0].length) { + let results = resultsSuggestedTabAutocompletion[0]; + + document.getElementById('search-results').style.display = 'block'; + document.getElementById('search-notfound').style.display = 'none'; + + let list = ''; + for(let i = 0; i != results.length; ++i) { + /* Labels + */ + list += '
' + results[i].typeName + '
' + (results[i].flags & 2 ? '
deprecated
' : '') + (results[i].flags & 4 ? '
deleted
' : ''); + + /* Render the alias (cut off from the right) */ + if(results[i].alias) { + list += '
' + this.escape(results[i].name.substr(0, results[i].name.length - this.searchString.length - results[i].suffixLength)) + '' + this.escape(results[i].name.substr(results[i].name.length - this.searchString.length - results[i].suffixLength, this.searchString.length)) + '' + this.escapeForRtl(results[i].name.substr(results[i].name.length - results[i].suffixLength)) + ': ' + this.escape(results[i].alias) + ''; + + /* Render the normal thing (cut off from the left, have to + escape for RTL) */ + } else { + list += '
' + this.escapeForRtl(results[i].name.substr(0, results[i].name.length - this.searchString.length - results[i].suffixLength)) + '' + this.escapeForRtl(results[i].name.substr(results[i].name.length - this.searchString.length - results[i].suffixLength, this.searchString.length)) + '' + this.escapeForRtl(results[i].name.substr(results[i].name.length - results[i].suffixLength)); + } + + /* The closing */ + list += '
'; + } + document.getElementById('search-results').innerHTML = this.fromUtf8(list); + document.getElementById('search-current').scrollIntoView(true); + + /* Append the suggested tab autocompletion, if any, and if the user + didn't just delete it */ + let searchInput = document.getElementById('search-input'); + if(this.autocompleteNextInputEvent && resultsSuggestedTabAutocompletion[1].length && searchInput.selectionEnd == searchInput.value.length) { + let suggestedTabAutocompletion = this.fromUtf8(resultsSuggestedTabAutocompletion[1]); + + let lengthBefore = searchInput.value.length; + searchInput.value += suggestedTabAutocompletion; + searchInput.setSelectionRange(lengthBefore, searchInput.value.length); + } + + /* Nothing found */ + } else { + document.getElementById('search-results').innerHTML = ''; + document.getElementById('search-results').style.display = 'none'; + document.getElementById('search-notfound').style.display = 'block'; + } + + /* Don't allow things to be selected just by motionless mouse cursor + suddenly appearing over a search result */ + this.mouseMovedSinceLastRender = false; + + /* Reset autocompletion, if it was allowed. It'll get whitelisted next + time a character gets inserted. */ + this.autocompleteNextInputEvent = false; + }, + + searchAndRender: /* istanbul ignore next */ function(value) { + let prev = performance.now(); + let results = this.search(value); + let after = performance.now(); + this.renderResults(results); + if(this.searchString.length) { + document.getElementById('search-symbolcount').innerHTML = + results[0].length + (results[0].length >= this.maxResults ? '+' : '') + " results (" + Math.round((after - prev)*10)/10 + " ms)"; + } else + document.getElementById('search-symbolcount').innerHTML = this.symbolCount; + }, +}; + +/* istanbul ignore next */ +function selectResult(event) { + if(!Search.mouseMovedSinceLastRender) return; + + if(event.currentTarget.parentNode.id == 'search-current') return; + + let current = document.getElementById('search-current'); + current.removeAttribute('id'); + event.currentTarget.parentNode.id = 'search-current'; +} + +/* This is separated from showSearch() because we need non-destructive behavior + when appearing directly on a URL with #search */ /* istanbul ignore next */ +function updateForSearchVisible() { + /* Prevent accidental scrolling of the body, prevent page layout jumps */ + let scrolledBodyWidth = document.body.offsetWidth; + document.body.style.overflow = 'hidden'; + document.body.style.paddingRight = (document.body.offsetWidth - scrolledBodyWidth) + 'px'; + + document.getElementById('search-input').value = ''; + document.getElementById('search-input').focus(); + document.getElementById('search-results').style.display = 'none'; + document.getElementById('search-notfound').style.display = 'none'; + document.getElementById('search-help').style.display = 'block'; +} + +/* istanbul ignore next */ +function showSearch() { + window.location.hash = '#search'; + Search.canGoBackToHideSearch = true; + + updateForSearchVisible(); + document.getElementById('search-symbolcount').innerHTML = Search.symbolCount; + return false; +} + +/* istanbul ignore next */ +function hideSearch() { + /* If the search box was opened using showSearch(), we can go back in the + history. Otherwise (for example when we landed to #search from a + bookmark or another server), going back would not do the right thing and + in that case we simply replace the current history state. */ + if(Search.canGoBackToHideSearch) { + Search.canGoBackToHideSearch = false; + window.history.back(); + } else { + window.location.hash = '#!'; + window.history.replaceState('', '', window.location.pathname); + } + + /* Restore scrollbar, prevent page layout jumps */ + document.body.style.overflow = 'auto'; + document.body.style.paddingRight = '0'; + + return false; +} + +/* istanbul ignore next */ +function copyToKeyboard(text) { + /* Append to the popup, appending to document.body would cause it to + scroll when focused */ + let searchPopup = document.getElementsByClassName('m-doc-search')[0]; + let textarea = document.createElement("textarea"); + textarea.value = text; + searchPopup.appendChild(textarea); + textarea.focus(); + textarea.select(); + + document.execCommand('copy'); + + searchPopup.removeChild(textarea); + document.getElementById('search-input').focus(); +} + +/* Only in case we're running in a browser. Why a simple if(document) doesn't + work is beyond me. */ /* istanbul ignore if */ +if(typeof document !== 'undefined') { + document.getElementById('search-input').oninput = function(event) { + Search.searchAndRender(document.getElementById('search-input').value); + }; + + document.onkeydown = function(event) { + /* Search shown */ + if(window.location.hash == '#search') { + /* Close the search */ + if(event.key == 'Escape') { + hideSearch(); + + /* Focus the search input, if not already, using T or Tab */ + } else if((!document.activeElement || document.activeElement.id != 'search-input') && (event.key.toLowerCase() == 't' || event.key == 'Tab') && !event.shiftKey && !event.ctrlKey && !event.altKey && !event.metaKey) { + document.getElementById('search-input').focus(); + return false; /* so T doesn't get entered into the box */ + + /* Fill in the autocompleted selection */ + } else if(event.key == 'Tab' && !event.shiftKey && !event.ctrlKey && !event.altKey && !event.metaKey) { + /* But only if the input has selection at the end */ + let input = document.getElementById('search-input'); + if(input.selectionEnd == input.value.length && input.selectionStart != input.selectionEnd) { + input.setSelectionRange(input.value.length, input.value.length); + return false; /* so input won't lose focus */ + } + + /* Select next item */ + } else if(event.key == 'ArrowDown') { + let current = document.getElementById('search-current'); + if(current) { + let next = current.nextSibling; + if(next) { + current.id = ''; + next.id = 'search-current'; + next.scrollIntoView(false); + } + } + return false; /* so the keypress doesn't affect input cursor */ + + /* Select prev item */ + } else if(event.key == 'ArrowUp') { + let current = document.getElementById('search-current'); + if(current) { + let prev = current.previousSibling; + if(prev) { + current.id = ''; + prev.id = 'search-current'; + prev.scrollIntoView(false); + } + } + return false; /* so the keypress doesn't affect input cursor */ + + /* Go to result (if any) */ + } else if(event.key == 'Enter') { + let result = document.getElementById('search-current'); + if(result) { + result.firstElementChild.click(); + + /* We might be staying on the same page, so restore scrollbar, + and prevent page layout jumps */ + document.body.style.overflow = 'auto'; + document.body.style.paddingRight = '0'; + } + return false; /* so the form doesn't get sent */ + + /* Copy (Markdown) link to keyboard */ + } else if((event.key.toLowerCase() == 'l' || event.key.toLowerCase() == 'm') && event.metaKey) { + let result = document.getElementById('search-current'); + if(result) { + let plain = event.key.toLowerCase() == 'l'; + let link = plain ? result.firstElementChild.href : + '[' + result.firstElementChild.dataset.mdLinkTitle + '](' + result.firstElementChild.href + ')'; + + copyToKeyboard(link); + + /* Add CSS class to the element for visual feedback (this + will get removed on keyup), but only if it's not already + there (in case of key repeat, e.g.) */ + if(result.className.indexOf('m-doc-search-copied') == -1) + result.className += ' m-doc-search-copied'; + console.log("Copied " + (plain ? "link" : "Markdown link") + " to " + result.firstElementChild.dataset.mdLinkTitle); + } + + return false; /* so L doesn't get entered into the box */ + + /* Looks like the user is inserting some text (and not cutting, + copying or whatever), allow autocompletion for the new + character. The oninput event resets this back to false, so this + basically whitelists only keyboard input, including Shift-key + and special chars using right Alt (or equivalent on Mac), but + excluding Ctrl-key, which is usually not for text input. In the + worst case the autocompletion won't be allowed ever, which is + much more acceptable behavior than having no ability to disable + it and annoying the users. */ + } else if(event.key != 'Backspace' && event.key != 'Delete' && !event.metaKey && (!event.ctrlKey || event.altKey) + /* Don't ever attempt autocompletion with Android virtual + keyboards, as those report all `event.key`s as + `Unidentified` (on Chrome) or `Process` (on Firefox) with + `event.code` 229 and thus we have no way to tell if a text + is entered or deleted. See this WONTFIX bug for details: + https://bugs.chromium.org/p/chromium/issues/detail?id=118639 + Couldn't find any similar bugreport for Firefox, but I + assume the virtual keyboard is to blame. + + An alternative is to hook into inputEvent, which has the + data, but ... there's more cursed issues right after that: + + - setSelectionRange() in Chrome on Android only renders + stuff, but doesn't actually act as such. Pressing + Backspace will only remove the highlight, but the text + stays here. Only delay-calling it through a timeout will + work as intended. Possibly related SO suggestion (back + then not even the rendering worked properly): + https://stackoverflow.com/a/13235951 + Possibly related Chrome bug: + https://bugs.chromium.org/p/chromium/issues/detail?id=32865 + + - On Firefox Mobile, programmatically changing an input + value (for the autocompletion highlight) will trigger an + input event, leading to search *and* autocompletion being + triggered again. Ultimately that results in newly typed + characters not replacing the autocompletion but rather + inserting before it, corrupting the searched string. This + event has to be explicitly ignored. + + - On Firefox Mobile, deleting a highlight with the + backspace key will result in *three* input events instead + of one: + 1. `deleteContentBackward` removing the selection (same + as Chrome or desktop Firefox) + 2. `deleteContentBackward` removing *the whole word* + that contained the selection (or the whole text if + it's just one word) + 3. `insertCompositionText`, adding the word back in, + resulting in the same state as (1). + I have no idea WHY it has to do this (possibly some + REALLY NASTY workaround to trigger correct font shaping?) + but ultimately it results in the autocompletion being + added again right after it got deleted, making this whole + thing VERY annoying to use. + + I attempted to work around the above, but it resulted in a + huge amount of browser-specific code that achieves only 90% + of the goal, with certain corner cases still being rather + broken (such as autocompletion randomly triggering when + erasing the text, even though it shouldn't). So disabling + autocompletion on this HELLISH BROKEN PLATFORM is the best + option at the moment. */ + && event.key != 'Unidentified' && event.key != 'Process' + ) { + Search.autocompleteNextInputEvent = true; + /* Otherwise reset the flag, because when the user would press e.g. + the 'a' key and then e.g. ArrowRight (which doesn't trigger + oninput), a Backspace after would still result in + autocompleteNextInputEvent, because nothing reset it back. */ + } else { + Search.autocompleteNextInputEvent = false; + } + + /* Search hidden */ + } else { + /* Open the search on the T or Tab key */ + if((event.key.toLowerCase() == 't' || event.key == 'Tab') && !event.shiftKey && !event.ctrlKey && !event.altKey && !event.metaKey) { + showSearch(); + return false; /* so T doesn't get entered into the box */ + } + } + }; + + document.onkeyup = function(event) { + /* Remove highlight after key is released after a link copy */ + if((event.key.toLowerCase() == 'l' || event.key.toLowerCase() == 'm') && event.metaKey) { + let result = document.getElementById('search-current'); + if(result) result.className = result.className.replace(' m-doc-search-copied', ''); + } + }; + + /* Allow selecting items by mouse hover only after it moves once the + results are populated. This prevents a random item getting selected if + the cursor is left motionless over the result area. */ + document.getElementById('search-results').onmousemove = function() { + Search.mouseMovedSinceLastRender = true; + }; + + /* If #search is already present in the URL, hide the scrollbar etc. for a + consistent experience */ + if(window.location.hash == '#search') updateForSearchVisible(); +} + +/* For Node.js testing */ /* istanbul ignore else */ +if(typeof module !== 'undefined') { module.exports = { Search: Search }; } diff --git a/pr-preview/pr-494/searchdata-v2.js b/pr-preview/pr-494/searchdata-v2.js new file mode 100644 index 000000000..c870ac0e7 --- /dev/null +++ b/pr-preview/pr-494/searchdata-v2.js @@ -0,0 +1,2 @@ +/* Generated by https://mcss.mosra.cz/documentation/doxygen/. Do not edit. */ +Search.load('O+!-x00000v<3hGJf8so5^Vzj#-0HH0RR9100D9Y00001We5NO00CwW00001W)uJb00DIx000310RR92WhMXs00Cnv00001axee@00DJ200001Z#)1100LrjAOHYD00001I!FKj00BBu0Du4iZ&&~T00C)U00001WMlvU0RUqF00DGx00001VRQfh00C`!00001a)1B;00D1?00031{{;X6DUtvH0RjF6D3$<#00DBG00001WuyQA00CyI00001X0QMN00DKj000310R{j8DZ&5%0RaF8D8>MQ00C~y00001Z`1$)00C**00001bl?C000C*{00001bL;>B0RRUE00AlZ000321_mhn0Du4iXaWHM00CnP0RR92bPxdm00M7m@&Eu90RRC20|o#ADJB5`0RaLAC@KMf00DV00RR92bT|P300C(}0RR92V?+S}00D1G0RR92Y)}CJ00CuI0RRC21qJ{CDPjQt0RaRCC}shG00C}n0RR92X>0ssI3azFwA00Cu20ssI4Y-Z*G089b^00CuE0ssL34F&)KDPjTu0RapKC}skH00Cue0ssI3V{`%l00C}#0ssI3VSoYv00DG{0ssI3bBqE200C)|0ssL34+a1MDV_oV0RavMD53&@00CvF0ssI3Y_I|V00C#V0ssI3ZoC2j0RRyO00Ak;0ssL45C$mB0)PMkZqfn(00C**0ssI3Vc-G)0RR&Q00AlN0ssL45(X&n0)PMkZuSBI00D3Q0ssI3X#@iR00DFg0{{R4V-N!X00Ctd0{{R4avTEy00C(t0{{R6VP|B*0s!U$04M_h00Ct#0{{R4Zaf1300D180{{RBVsLh6Y;t5{yZ`_k0RUV90Du7iwgCWK0sxo-07wG>00DGP0{{R4WpD!k0RR^U00Aj{0{{U576vGQ1AqVld4>Z300Ci+0{{R4Y?K2400MJxb^`#K0{{R4I-mmp0Rb2WI;sPJ00CvN0{{R4W4HqV00DBo0{{R4b;JVz00D2x0{{U4IR^j%Db@o30RcD%DB1&n00C^^0{{R4Z0G|300C+40{{R4X7mF900BDs0{{U5ItMxc1b_emas~td00CtV1ONa5W)uVf00Cwi1ONa5bsz))00MJj&;tM_1ONa5IxGYL0Re{uIyMA=00C?~1ONa5a6|+E00C`E1ONd5od*B`DOLmk0Rfx`C|U%700CuS1ONa5V`u~b00C)k1ONa5c60;)00Cus1ONa5WPk(!00D1?1ONa5X^aE_00Cr@1ONa5b(jPI0RW!|00Aka1ONd6o(CwX1b_ema;^jb00CvT1ONa5X1oLd00Cyg1ONa5b;tw&0RW)~00Ak~1ONd6pa&?}1b_emW!?k;00Cp>1ONa5a_j^E00DLK1ONa5Z}100AjH1pom7q6a8I1%LnnZbk(F00D1K1poj6X;cLO00DGb1poj6X00D1`1poj6X^;f~00DHC1poj6VVng300DHO1poj6Zm0zS00CvL1poj6X|x3Z00DBk1pom6rw0H5DaHi=0Rg55D9QzZ00DW>1poj6bl3#|00C*<1poj6W8?(@00D361poj6Z14pD00Cw81poj8aBp^U1pvSW0Q?0200D9W1^@s7We^4c00C|m1^@s7WgG?o00DF&1^@s7b0`J?00C((1^@s7Y%~S{00DG51^@s7Wk3c10RXE900AjX1^@v8ss|`g27mwob5;fb00CuQ1^@s7V`K&Z00C)g1^@s7c5ns&00Cuo1^@s7WPAny00Cu!1^@s7bchB300Ci+1^@s7a+C%D00Cv11^@s7ZJ-7K00DKT1^@s7Zmb3X00d!Ub7h_c05$~xMg{<~1^@s7I=BV^0RgNBI?4us00Cvt1^@s7W7q}&00C*<1^@s7cH{;C00Cv{1^@s7Wbg(600D3I1^@s7Y5WEN00CqI2LJ#8bqEIl00U-eVT=F(Py_%D2LJ#8Iur*00RdzHIwA*v00MPvY5)Kz2LJ&81ONa5DLMxL0RaO5C_V>(0RRR700AjX2LJ&91pp{e2Y>(pHdY4!0RRX900Ajv2LJ&92LLE&2Y>(pGHwR|0RRdB00Aj{2LJ&92>>X72Y>(pG=>KN00cNOGd4sA0A2?Gb_W2C2LJ&83;+NDDW(Si0RamDD5?j50RRpF00Aku2LJ&94FD*-2Y>(pHo^x00RRvH00Ak`2LJ&94*)3C2Y>(pGTH|K0RR#J00AlJ2LJ&95dbLc2Y>(pH1Y=k00cNOGd8dX0Lljd;s*fw2LJ&86aWALDG~?(0Ra;LC>98S00A-_2mk>9761SNDJlp60Ra^NC@u(q00A^K2mk;AGd3g$06Yi)0RR{P00AjX2mk>A7XTA82~7B2!H?qXL<+#00C}-2mk;9X^02_00DB22mk;9bd(4H00n7vW@2-c2LJ#F073`=Y6t+D2mk;9WuOQE00DHi2mk;9X}kyk00DBs2mk>98~^|TDb5H00RbBTDAEXk00DH^2mk;9W8eq?00Cv@2mk;9YU~IA00Cn12mk>9AOHXXDgFom0RbNXC;|z900DUj2><{AVGs!b00D9q2><{AavTW&0RSWb00Ai|2><~BBLFBY34j0rc`^wA00DA32><{AVL%B000C}B2><{AZ%hdQ00C)I2><{AbXW-h00CoO2><{AX=Dii00VDfWcUaGA_)L$2><{AZg2?z00C)!2><{AXM_m=00Cu+2><~A9smFVDV7NU0RbHVD4Gd?00DHM2><{AW2gxL00CvL2><{AYP1Oe00CmU2><~AA^-pZDaHu^0RbTZD9Q2><{AVb}=(00DB|2><{Aa^wjB0RScd00AlR2><~BB>*V&34j0rdHM+e00D9W3IG5BVF(HU00C|e3IG5BZxjju00C(l3IG5BbRY@<00Cnr3IG5BX)Fo=00VDfWWWgk>Incc3IG5BWH<@{00C}B3IG5DcVcD82mp`?089!100BBu3IG8CCjdHN3V;9sa%Ktu00Cug3IG5BXLJex00Cio3IG5BYk&#>00Co$3IG5BVT=j@00D543IG5BI+zLo0RepoI-UxE00C^I3IG5BaI6Xd00C{X3IGNGMgT|vOaM>-P5?>(00Ak!3IG8BDFgrkbkYg{00C*%3IG5BV%!P<00C^`3IG5BY3K?700Cj{3IG5BX7maG0RSrm00Aig3jhHDDg-D53xELtEd&4oDH00+0Rb!oC>9HV00A}}3jhHCF9ZMqDJly90Rb)qC@u?t00A;I3jhHCF$4esDMAYX0Rb=sC`Jo_00A^i3jhEFI59Ie3JU-v3jjO|08|SA0RS@u00Aj%3jhHDG6X1a3xELtH3R?wDSit80Rc1wD1r-s00B0L3jhHCHv|9yDV7TW0Rc7yD4Gj^00AI(n@3;+QDKLh{)DH03-0RcV)C>9KW00C?q3;+NDZzK!=00D0*3;+QDK?DE+DK-oM0Rcb+C^`&)00Cz}3;+NDZb%FO00C)E3;+NDa#Rce00DGb3;+QDLj(W;DP{}+0R}<@X?12|b0}I10LBXd2n+x)3;)ap00D9e4FCWEVGs=f00C|m4FCWEZyXH(00C(t4FCWEbSMn~00Cnz4FCWEX*3N000VDfWXKEv@(chv4FCWEZa@tH00C)E4FCWEXH*RU00CuM4FCZEM+5)?DP|1-0Rct?C~6IW00DGx4FCWEV|Wb!00Cuw4FCWEYJ?2{00Cl(4FCZEO9TJ`DV7ZY0Rc(`D4Gp`00DWR4FCWEVW4gdfFZ;TEA00wPxVr6Dy`U(J;3;1Pw00DAx4*&oGWq1z&00DD;4*&oGXM_&`00DK14*&oGVvr9200Cu|4*&rGs{#N4DWVSm0RgH4D5ej90RXK600Akq4*&rHtO6*w4}bsxHogx40RXQ800Ak?4*&rHt^z2~4}bsxGS&|O0RXWA00AlF4*&rHumULP4}bsxH0}=o00cNOGd8Rb0LBjh-VXrw4*&rGvjPACDGm?-0RgfCC=w8W0RXiE00Ai=5C8!Iv;rt35P$#yHYyMR0RXoG00AjD5C8!IwgMwi00n7vW@2;v4*+No0ICoG(hvXw5dZ)IWe5=f00DF!5dZ)IX(SN<00D9;5dZ-I!vX*SDK-%R0Rh4SC^`{<00DGB5dZ)IV@MGI00CuA5dZ)IYE%&b00ClJ5dZ-I#{vKWDP|D>0RhGWC~6Ua00DV$5dZ)IVR#V$00DA-5dZ)Ia)c280RYPa00AkG5dZ-J$^s~q5r6;zd72Rb00DBM5dZ)IVW<%R00C~U5dZ)IZ?q8r00C*b5dZ)Ibife+00Cph5dZ)IY0MD-00VDfWMB~hiV*-v00C}x5&!@JZ+sE}00C)&5&!@JbchlF00Co;5&!@JX_OKG00VDfWGE55&!`K&H_5j5`X{!a?%n200Cv%5&!@Jdf*ZO00C*{5&!@JZ0r&M00Ck05&!@JY4{QV00DCT5&!@JWdsud0Rp)II&(G;fC>`;00CzZ6951KbsQ4_00MJj01p5n6951KWhfH>0RU0}00AjD6954LQ2;1B6Mz5#VnP!D00D7I6951KWl$3U00DDW6954KvI77CWnvQm00C}h6951KZ)_6)0RXcD0RXfE00B096954KwF3YFGKLcX0RXlG00A_R6951NI59IecoP7C699@60F)B|0RXoH0RXrI00B0z6954KxdQ+JGP)B00RXxK00A__6951NI59IetP=pV69B#w0LT*n0RX!L00A=K6954KyaNCMH0l!o00J{MxuQ0Gt&70s!a(>H`1)DXbL$0|CSX=L6{jD6$oR0RZL$00Ak)6#xMO;vut00Alf6#xSP#RKaD?E@$T7JvW&c?uQ)00D9q761SNVH_3!00C|y761SNZzvW300C((761SNbTk$K00Cn<761VN#sdHWVMZ1J00DGL761SOX<00Cr>7ytkPWtbQM00C^C7ytkPX`~nc00L}bfEWO(7ytnPf&%~nDY_T{0Re#nD83kg0RV&p00Ak?7ytnQg99kg7=Qo)Hr5yb0RV;r00AlF7ytnQg##$)7=Qo)GVT}v0RV^t00Ald7ytnQhXW`88Grx*GzJ*}00cNOGd9E+0Nxk?_80&T82|wQiUR-vDJB^J0Rf2vC@L9%0RW5x00AjD82|wRivuV;8Grx*HbNNy0RWBz00Ajb82|wRjRPoD8Grx*GFlk`0RWH#00Ajz82|wRj{_)d8Grx*G;$dL00cNOGd3_807@AEVi^E>82|wQk^=w%DUulg0RfQ%D3%$300A;cy8Grx*Y}Oe700D2_82|tQZ{!&O0RWf-00AlR82|wRmjfvD8Grx*XZjfc00C|S8UO$RX$Tqs00D9i8UO$RbQBr@0RWl<00Ai=8UO(XnFDEcW@2+F6d3@3834i=0O}b48X5p38h`)+Whxo~00DGH8UO$RX-pab00DAR8UO(RoC5#>DP9@?0Rfu>C}J9b00DGp8UO$RV{jS(00Cuo8UO$RYJ3_100Clx8UO(RpaTE_DUKQd0Rf)_D3Th000DWJ8UO$RVW1iS00DBQ8UO$Ra;zEv0RW@}00Aku8UO(SqXQ_s8h`)+dBPe100DB!8UO$RVbB@?00C~+8UO$RZ`>LH00C*@8UO$Rbm$rY00Cp}8UO$RY4jQZ00VDfWQZC7vKj#T8UO$RZU7qq00C(Z8vplZC00Ct_8vpR00Cj@9RL6UZSWlc00D0H9RL6UZ~Pqq00C(N9smFVbO;^*00L!UKpX%L9smFVdK4Z200C(p9smFVY$P5400Cht9smFVX)qoD00D9~9smIVSOEY5DMB6q0RdM5C`KND00Cu89smFVc2ph!00C)Q9smFVXkZ=y00CoW9smFVa%>&|00Cig9smFVWOyC`00DA-9smFVVT2w400Cr*9smFVZjc@T00Ci^9smIVW&r>JDWV<#0Rd$JD5f5O00C#L9smFVZnPc%00C*b9smFVY``7>00Cmg9smFWbZML(0L&f$0RUP700Al79smIWSpg{E9)JJ=W#%3L00DIF9smFVVe}pV00CwC9smIVXaN8LDFz<^0Rd+LC<-5d00CqW9{>OWY#1K^00C(p9{>OXa%cb_03;s(0RUV900Aj99{>RXTLCCIAAkS>c|IQi00D1C9{>OWa!elp00DGT9{>OWb66h$0RUhD00Ajv9{>RXUjZm+AAkS>d2Sy700DA#9{>OWZ+ssB00DG@9{>OWV~8IB00Cu=9{>OWa+Dtc00L!cULOFO9{>RWUI73BDXJd;0RdeBD6SuX00CvR9{>OWZM+`<00Cjb9{>RWVgUdFDb61N0RdqFDAFH*00DW}9{>OWY~UXN00D019{>OWZ|olc00Ct39{>OWVfY^a00CwG9{>RWWB~vHDGDF}0RdwHC=MWi00DFqAOHXXZX6&000CtpAOHXXaws4G00ChxAOHaXY5@QNDLNnk0Rd?NC_W&700C}9AOHXXWlSId00D4PAOHXdb7N#~a&T|b9snvI0H7ZL$R7X%AOJKV09YUZ00BB)AOHaYYXLfZAbcbn+ko00D0HAOHXXb^IUz00D0TApijY015yBWey<#00C_hApigYVHhC*0RRCC00DU_4-B7gt^VL~DR00DGLA^-sZ^#%X|DOMr?0Ri*|C|V+b00DVmA^-pZZ)hR_00DAtA^-pZbaWyB00DD)A^-sZ`33+1DTX2d0Ri|1D2gJ000DWBA^-pZa+o3j00D2FA^-pZbfh8x00CpFA^-pZWw0Uu00DBgA^-pbVP$DhA^?CQ0K6gq0RZs^00Ak`A^-sa@CGQo0RRC900AjrBLD#b00$^!BY*$_WNIS-00C@rBLDyaX?P<500MGoS|b2{BLD#a_XYp~DUKrm0Ri>~D3T+900Cu~BLDyaZJ;9n00Cj9BLD#a`vw33DY7E~0Rj33D7GVj00DWtBLDyaY{Vk~00C~wBLDyaZ_pzE00CsyBLD#a1qT2DDdHml0RaRDDCQ%800Cj_BLDyabo3(t00Ck8BLDyaWB?=p00D9aBme*bWeg+$00DFoBme*ba~LE500C(pBme*cVQ1VU03;*;00CtxBme;b{RRL5DLNzo0Rj95C_W^B00DGFBme*bZcHQq00CuEBme*ba#$n)00CiMBme;b{{{d7DQYAD0RjF7C~hQx00C!oBme*bZhRyF00C)&Bme*bY=|TP00Cl-Bme*bX_O=Y0RRIB00AkWBme;c0tYChB!B<`ZmJ{z00CvPBme*baJVD@00?AdV{USAb8o^T05Br}gd+f~BLFlc0AwTpnj`?eBme*bI>aOZ0RaXFI_4yR00Cv}Bme*bcJw3w00C+GBme*bXaFSu00CnLB>(^cattK^00ChVB>(^cWEdp?00CtlB>(^cWF#d300CqwB>(^cWiTZG00Ck)B>(^cZ9F9a0RTk-00AjTB>({dL;)yFC4c|{ZBiuw00CiIB>(^cWnd)$00DAlB>(^cbZjL600DDyB>(^cWq2h300C@%B>(^cX@n&J0RTq<00AkGB>({dMgb_4C4c|{WSS)a00Cj5B>(^cWvC?p0RTw>00AkqB>({dNC7CgC4c|{Wxgc<00DHyB>(^cY0M=600DB+B>({cO921@Dc&Uj0Rc(@DB>l600C_1B>(^cZ15!j00Cw8B>({cO#uJ_DFP+{0Rc<_C?;-03ap+J|+NSCIA2dI%p;U0Rd70I))~I00C``CIA2dVU#8S00Cv1CIA2da-b#v0RS`#00AkiCIA5eGYTlMCV&6|bhah{00D2lCIA2dZ^R}50RT1%00Ak`CIA5eH3}%yCV&6|blN5W00C~|CIA2db?7Dl00D3ACIA5dI0^s(Df%V=0RcA(DE=mZ00DFaCjbBeZVV>?00DIpCjbBeZx|;400C_tCjbBeZX_oF0RTD*00Aj5CjbEfISME=Cx8F}WI87R00C}7CjbBeX-Fpk0RTJ-00AjfCjbEfI|?XRCx8F}WnL!$00DGnCjbBeVQeP=00CukCjbBea(E{I0RTP<00Ak4CjbEfJqjp@Cx8F}d5$Ll00D27CjbBea-1gs00DHOCjbBebEqc(00CvLCjbEeKnef>DY_>B0RcY>D846v00C~qCjbBeWy~i400D5)CjbBka&2{HV`Oj2CIIv%04gT{PA33C;$Kfay%#i0ReaicS0xt00Cr3C;$KfVNfUl00CuIC;$Nfc?SRiWnw4*00DGnC;$KfX>2F}00DAxC;$Kga(7%P0C*?>00BCFC;$Ngdj~p*D1ZO~WsWES00Cr{C;$KfZ=5Iq0RV^x00AkeC;$NhhX-vaq9_2YD1ZO~Zn7u<00CvbC;$KfaKtD80RVgl00CvtC;$KfY}600AkWDF6Whmj@`MDS!Y0WU46u00C^WDF6TgX}Bo>00MGonkfLjDF6Wgh6exvDb6VX0Re>vDAFl_00DW}DF6TgZ{R5a00DC5DF6TgbnGbr00DFIDF6Wgjt2k%DgG${0RfE%C;}>g00DUjDgXchau6y200D0nDgXchbQ~%G00CnnDgXchWhg2D00D9?DgXciWoh^+05mE90RV~z00AjPDgXfii3cc1Du4h1Wlkyp00C`QDgXchVO%Nz0RW5#00AjzDgXfiiw7udDu4h1XmTn50RWT-00Ak0DgXfilLsh-Du4h1bc!kf00C~2DgXchWtb`e00MM!dMW^(DgXchVWcVm0RWH(00AkqDgXfij|V8YDu4h1Wxgr^00DN!DgXchY0N4B00C&yDgXchW7sMH00DB|DgXfhk_P|*De5W!0RfQ*DDEnN00Ct5DgXfhmInX-ab0PH9L7AXKsDFARO0K_Q(Iw}BSDgdr30OTqF{3-x4D*yliIyfr;0Rou^b2=g@0BS3M00CuiD*yliY|_;00DF)EC2ujWh^WJ0RTM$00AjDEC2xkJOU^@EPwz3b3!Zt00Ci2EC2ulaA#-`EC4br08lId00BByEC2xkJ_0&qEPwz3bZRUB00DS%EC2ujWq2$A00DGEdT%kazrfv00DAJEdT)k1_J;ADON220RaUAC|WIm00DVmEdT%ka%e3800CicEdT%kZgedG00D1$EdT%kX@D&N00DG{EdT%kV~i~T00C)|EdT%mZ((F6EdWq00GKTR00C~EEdT%kX{;>(00C#REdT%lX=U~-0Jtpx0RZL#00Ak;EdT)lH+`(De^4<0Ria(DE2LY00A=mEdT)k>;eD*DGDwC0Rig*C=M=w00A@DPArB0Riy>C}J*v00A;+E&u@l^a20@DRwRZ0Ri&@D0(h{00A_BE&u=oI59IeJ}v-QE&y;Y0EjLC0RZ*_00AkWE&u@m^#UlQE`R_5GO8{B0RZ>{00AkuE&u@m_W~%qE`R_5G{PF0RaaCD7r6z00DWxF8}}ma>y?L00CjnF8}}mZqzRT00D2>F8}}mY2Ysa00DI7F8}}mW9%;g00C+8F8}}oZ((GHF95JF0QfHe00CtFF8}}mZVWI000UxoWxg!{Rxbb&FaQ7nIv6kj0RagEIwmlH00D9=FaQ7nWi&7V00DYBFaQ7nX+SUl00C@9FaQ7nVN5Up00C)IFaQ7na#%0`00CuQFaQAnC<6ciDQYkP0RbliC~h!-00DAzFaQ7nWqdFI00DY}FaQ7nX^1cY00C@{FaQ7nVU#cc00C*5FaQ7na-c8(00CvDFaQ7nbF44`00CvPFaQ7nWVkQ@00DWvFaQ7na>OtI00CjjFaQ7nZqP6Q0RTb+00Al7FaQAoK?5k@Fn|C7bmlMs00Cp}FaQ7nW%Mur00C#900J{Mk}?3QG5`SpJ_7&&DY`NM0RcS&D84d)00C^oG5`PpZ_F|P00D2(G5`SpKmz~)Dc&*w0RcY)DB?1J00C#{G5`PpZtyYy00C+CG5`Ppa{Mv?00DFYGXMYuX?12|a{@8|ZZZI{G62{z00=Vx00CqUGXMYqVI(sE00CtxGXMbqL<0Z;DK;|z0Rck;C^|EM00DGBGXMYqV@NXq00CuAGXMYqYE&}-00ClJGXMbqNCN-?DP}VO0Rcw?C~7l+00DV$GXMYqVR$nD00DA-GXMYqa)dJg0RT(`00AkGGXMbrO9LpBGk^dAd73i-00DBMGXMYqVW=|z00C~UGXMYqZ?rQ200C*bGXMYqbigwJ00CphGXMYqY0NVK00VDfWMDG@iZcMxGXMYqWY{wR00D01GXMYsVsd4kF#s?#0PHgW00BDkGXMbrO#?arG=KmBat1U200CtVGynhrdK5GO00C(lGynhrY#=lM00ChpGynhrX)H7V00D9`GynhrWjHhd00DD8GynhrWkfUp00MJlWH10qGynhrc~CR}00DAZGynhrVPG@>00C}hGynhrX>2qA0RY7W00CrpGynhrX?!#Q00DA>Gynkr#smNXWsWoe00DH8GynhrbeJ>%00Cv5GynhrY@{>*0RYDY00C~WGynhrZ?rT300C*bGynhrbigzK00C*nGynhrbIddV00Loesx$!7GynhsXK;u#0N6AD00BDUGynks$OJm0RV9Y00Al3H2?tta0MvbHGlyCa|HkaDe5%<0ReIaDDE|Y00B1iH2?tsbp-$cDFQYC0ReOcC}O|00A^4HUIzwI59Ie;xz#LH2@Sg04z2D0RVXg00AjPHUI$ucm*g(Hh=&DGEO!C0RVdi00AjnHUI$udIcz8Hh=&DG-fsc00J{MRyF``HUI$teFXpkDSkEp0RemkD1tVC00C@>HUIztZ;&Bp00DFaHvj+uV+=O{00CtZHvj+uY8W>F00CkiHvjEd0saF00DAlHvj+uVQe=500C}tHvj+uZ+JHV00C)!Hvj+ubc8nm00Co)Hvj+uX^=Mn00VDfWF$8LPB#FSHvj+uZk#s&00C*LHvj+uXRtQ_00CvTHvjIRF3wY}h#f00C~^IRF3wZ{#@u00Cs`IRF3wVemNs00Cw8IRF6wP6z-2DFQkG0Rc@2CJOBXz!UzBXDNZ~90Rh1XC{jFt00C@RJOBUzZ(uwC00D1iJOBXz#0UTZDRMjj0Rh7ZD0V!600C!wJOBUzZiGAl00C)=JOBUza*#X#00DHCJOBU%X?12|bCx>*0z3djJOFGw0GvDk00Cv9JOBUzbhtbK00C*fJOBUza>P6U0RYAb00Ak`JOBX!#Rw?WJb(ZJblN-s00Cp-JOBUzW#~Kr00C<5JOBUzV)Q%!0RYMf00AigJpcg#$p|O}J%9iKc?vxM00ChVJpcd!au_`T00D9yJpcg!&IkYjDJnex0RhbjC@wvK00DV4Jpcd!ay&f%00Ch_Jpcd!Zb&@<00D1KJpcd!X;eJ`00DGbJpcd!V_-c100C)cJpcd$Z((HmJOCs;0Bk(~00C}tJpcd!X@ETd00C!)Jpcd!WsE%l0RYGd00AkOJpcg##|S8#J%9iKbfP@~00CpFJpcd!Ww1Q}00C;YJpcd!V!S;70RYSh00Ak;Jpcg#%LpjUJ%9iKdD1-q00CjzJpcd!a^O7x00DC5Jpcg!&J^%m#X@EWe00C@}NDXKmI0RamND6T$$00DBeJ^%m#WxPHB00DZ!J^%m#X~;eR00C^yJ^%m#VbneV00C**J^%m#a^OAy00Cv@J^%m#bL>6<00Cw4J^%m#WcWS+00D0PJ^%m#Zv;O800DCfKL7y$4hjGPDHcBf0RasPC>lS20RRvR00Ai|KL7y%4+fDegZ20RbHfDDppm00A=iKL7y$APN8hDF#3Q0RbNhC<;J;00A@*KmY&&Gd2J~02n|30RSQj00Ai|KmY*&AqprgK!5-NY%)Lq00D10KmY&%Z$Ll*0RSWl00AjXKmY*&BMK-`K!5-NXI4M}00C}ZKmY&%X=FeE00DApKmY&%bZ|fb00n7vW@2-2KLFf603JX9MnC{|KmY&%WPCsX00Ci=KmY&%Wtcz!0RScn00AkaKmY*&B?>60K!5-Nbgn=E00CpRKmY&%WxPND00C;kKmY&%V#q)M0RSor00Ak~KmY*&DGDgqK!5-NdEP((00Cjz>&au7iP00ChZK>z>&ZX7`X00D0zK>z>&X(&Me00DF^K>z>&V>Cek00C(_K>z>)Z((H4Kmhna06;+i00C}BK>z>&X;eV~00C!OK>z>&Wne)70RSip00Aj%K>z^(CkiNVL4W`Obap`i00CouK>z>&WrRTh00C->K>z>&Vvs=q0RSut00AkSK>z^(D+(x}L4W`Od8R=C00CjHK>z>&az^&FbV(xDaJtn0Rb-xD9S;A00DW>K>z>&a@aut00Cj%K>z>&Zsb7#00D36K>z>&Y4AY+00DINK>z>&WBfq?00C(NLI3~*Z((GXK>)x(00=?=00CqULI3~(ZX7}Y00e4sVr39N0G>bqW_PxWLjVB)C;$Kfb5=tD00DAZLjV8)Wne=900C)cLjV8)W^6+M00C)oLjV8)WOzdW00D1)LjV8)ZG=Mr00BCRLjVB*DF8Z00D1GMF0Q+a!^G800CoGMF0Q;Vr_GHL;&hU09-`?00CuUMF0Q+b8tlf00Lxn+Cu<#MF0Q+Z+t}n0RSoi00Cu;MF0Q+dXPl`00C*1MF0Q+bDTv000BCpMF0T-D*-yFMSuVSbgo4J00C~cMF0Q+WxPcI00DNwMF0Q+WynPU00CvrMF0Q+delV#00C**MF0Q+bKpe)00Cv@MF0T+SOfq8bn-<200D0HMF0Q+Y5YY100D0TMgRZ-a0o^K00CtVMgRZ-WE4gK00D0rMgRZ-V<1KV00BBCMgRc;Sp+&PMt}eTbTUQ&00C|~MgRZ-Wk5y%00DMJMgRZ-WlTl@00DGTMgRZ-cvwaN00CuQMgRc-`2+v~DQZRl0Ri{~C~ii800DG#MgRZ-ZhS@n00Cu!MgRZ-c8Ep*00Cu=MgRZ-Xp}|(00DEFMgRc-`vd?1DW*mM0RR~V00AkmMgRc;7zHS_Mt}hV`UEI*sz!jiMgRZ-bizge00C~!MgRZ-Wz4@iN200CxNM*si;bznyT00ClVM*si;aBN2a00CigM*sl;0R;d7DSk%)0RaF7D1t|T00Cu)M*si;dXPr|0RROB00AkSM*sl<1O+IdM}PnUWu`{}00DEZM*si;Z?s1M00C^eM*si;W57oM00CsiM*si;Y|KXh00DK$00Ct>NB{u<0|fv9DMm;D0RaL9C`w3x00CuCNB{r6a^?0Nq_(Wa~eqi00D9$NdN!=WhhAi00C((NdN!=W;96v00C(_NdN!>bz}-j06<9q00D1CNdN%=4Fv!JDOO1U0RapJC|XH?00DAfNdN!=Z)iyX00DDuNdN!=a&$=m00DJ+NdN!=V}MBj00Cu&NdN!=bc{&=00Ci=NdN!=Wtd3-0RRsL00AkaNdN%>4h1NvNq_(Wa;`}L00D2dNdN!=bG%6a00DBsNdN)>69o|k00Ak^NdN)?5(N+iDAY-S00Cs$NdN!=a^y(>00Cj@NdN!=Z}3R~00Cn5NdN!=aQsOC00C(NN&o-@a&>H;NdU-600>F|00(e$a%OaGV<<-eIvh#>0Rb8XIyy>#00DPEN&o->Z%9f200Cr9N&o->Zd6JD00C)QN&o->cVJ2Y00CuYN&o->b8Jcg00CigN&o=>vIhVGd45U&00Cu!N&o=>vj+eHWR6Mz00Cu^N&o->bC^m100DEJN&o->Wu!^~00DBUN&o-?YjB840I*5`00BC-N&o=?vWzW#CEx00DXCN&o->W$a1-0RXlK00DRSN&o->Z~RIC00D9WO8@}?z6SsSWe!UK00DXuO8@`?X&6fY00DCzO8@`?Wh6@g00D9;O8@`?Y%ogz00MGs2ulDqO8@}?w+8?LZAMD~00Ci2O8@`?Wl&2100ClFO8@}?xCa0Mb7D&X00DDmO8@`?Z){5d00DAxO8@}?xd#9NWPVEk00C}-O8@`?VTelr0RXxO00Cu`O8@`?dYDT900C*9O8@`?bEHcE00CvHO8@`?a}O#lD^Ivh;^0Ri*`IyOy!0RVUb00AjPO#lG_cL69!O@IIaa!ySE00CuIO#lD^XIxDH00C!WO#lD^Z)i;b00C@nO#lD^Wpqsd00DY>O#lD^X@E@t00C@a00UxSbFfYT#!dicPXGV`Wo%CX00DD)PXGV{WOY_f0Dw;b00D1?PXGY`ya50Kbe2y500C~APXGV`WuQ+000DNUPXGY{y#ZycPXGV`cd}0a00D2hPXGV`WWY}V00C~sPXGV`Y0OUm0RX`P00Al3PXGY{zyT=SPk;acbK*|`00DC9PXGV`W$;e`00C+CPXGV`X8cb800C(NPyhe{WC&0I00D0fPyhh{#Q^{TDH>1!0RhATC>~IN00DUC=00DQFPyhe{Zk$j600Cv9Pyhe{aHvoK00nDpcXMy5gGPyhe{I00D2}Q2+q|I{*LyDeh4K0RcJyDDqK&00CwAQ2+n|X8=+F00ChJQUCw}YYb8V00CnXQUCw}VHi>X0RTS$00Ai^QUC!1J^*)cDCkiD9#Q}(Qh)#fbS_c=00C(}QUCz}H2?qsDN0fR0Rc1sC{9v<00CuGQUCw}ZCp|S00CiQQUCw}a%fTj00CxhQUCw}WOPyh00LxgL{b2HQUCz}F8}}mDT-160Rb)mD2`Hq00Cu`QUCw}dYn=K00C*DQUCw}Y^YKI00CjHQUCw}X|z%R00DHmQUCw}X~0qd00C~sQUCz}F#rGoDbi8^0Rb=oDArPd00Cv(QUCw}bmUS100Cj@QUCw}Ztzk700C+CQUCw}ZTwOI00D9WQvd(~We8IM0RS@q00Ai!Qvd-0G5{zTQ-A;gWgb%i00C_#Qvd(~VJuSs00D9`Qvd(~W;jy-00C}3Qvd(~X+%>100C!8Qvd(~Wl&Q90RT4u00AjnQvd-0HUKDKQ-A;gbY@ck00C}pQvd(~Wpq;j00DM-Qvd(~Wq?xv00Cu&Qvd(~Y>ZO?00Cr@Qvd(~ZkSU500Cj1Qvd)4b7g6CVrafm0Dw{e%u)ajQvg;|0Hjj@00BCxQvd(~I>b|e00CvnQvd(~W6)Co00CjvQvd(~X53Q%00DC1Qvd(~W$04?00DIFQvd(~ZuCx;fQ~&`0K>z>&awb#&00D0*Q~&@0bTCu^00Ch(Q~&@0ay(Q300Ct}Q~&@0bVyVH0RY$q00AjfQ~&`1*99n8RDb{ha$Zyb00CuYQ~&@0WNcIb00CigQ~&@0Wq4Eo00DA-Q~&@0bc9p@00C}_Q~&@0Wsp<=0RY|w00AkSQ~&`1-32J1RDb{hWTsRA00MSymQ(<)Q~&`0+64dsDZW$y0RhyIDQ;B&0RdtIC~{SR00C=wRR911bAVL<00Ci!RR911ZH!d_00DH8RR911ZkSa700Cv5RR911cBEAR0RUwK00AkmRR943WCLX=s#O5ARe%5ibh=dl00CvjRR941X9EBMDbiH{0Rd(MDArYg00DB`RR911VdPZ+00Cv{RR911Z17b80RU+O00AldRR942Xagt!R)7Eja|Tub00DFkRsaA2ZWLAk00CthRsaA2b|6*&00CttRsaA2bSzc?00C|?RsaD2YXblQDLz&J0Rd_QC_+|%00Cu4RsaA2dQesX00L!cI932wRsaD2Z36%SDP~px0Re0SC~8)K00DAvRsaA2Wq4Kq00CrvRsaA2VT4uy00Cu+RsaA2a*$R400Cr{RsaA2WSmw20RV3U00AkeRsaD3ZUZQ+R)7Eja70XjK5rRRH!?09;l8qE-O*RsaA2I{a1u0ReCWIu=)e00CtjR{#J3a3og%00C(#R{#M3+ynptDK=LC0Rh_tC^}bw00DA9R{#J3Wk^>500DGPR{#J3X;fDL00DAZR{#J3cVJfl00DGnR{#J3ZfsWo00CukR{#J3c6e6+0RY|v00Ak4R{#M4-2^CzSAYNkXpUC^00DEBR{#J3b(~iK00L!jepdjZR{#J3I;d9w0Ri6xIS-0Rd$PC>~jW00CtrSpWb5bSzl_00Ch#SpWb5WjI*?00DA7SpWe5Xa@iRDN0!Y0Rd+RC{9^`00DVaSpWb5Z(Lab00DAhSpWb5bZA)s00DDuSpWb5Wpr5p0RUL_00DE7SpWb5VVGF}00C{DSpWb5bfj4T00CvHSpWe5YzF`VDYjVv0Rd|VD7smI00C>jSpWb5bI4f$00CjnSpWb5ZPZx+00DH`SpWb5W#Cx=0RV0X00AlNSpWe6Z3iguS%3fmWcFDA00C+KSpWb5Yy?^W00ChNS^xn6a0dVZDHd7)0Re9ZC>mOT00CtnS^xk6b|_i^00C((S^xk6Y&2Q`00MSl5Ly5_S^xn6dTS^xk6bGTXn00CjXS^xk6ZNypt00C&qS^xk6bkJG=00C*%S^xkDWn*M>XK7-06j=a7Spa%j0I*pA=2-x8S^%J00Nh#t00BDUS^xn7cLzEITYvxoatd1j00CtZTL1t7XBb-m00ChhTL1t7ZX{a(00ChtTL1w7LJ9x@Yc^W|00DD4TL1t7VL)2|0RTe^00DSRTL1t7Wl&oH00CrHTL1w7ND2S}DPmgy0Rcw}C}vxL00C@lTL1t7Y;;=y00DJ+TL1t7Zh%_=00M4vTw4H!TL1w7L<#@_ZkAgB00D2BTL1t7X`ovG00DHSTL1t7VXRvK00DBcTL1t7Ww=`a00C~kTL1t7WyD(m0RTn{00Ak`TL1w8MG7d?TYvxodD>e500DI3TL1t7Y3N%300DIFTL1t7ZuDCK00eDmXJtlP0E}Az%3A>XTL1t7IsjY%0Ru@2Vr@F4SO73v01{k)00DUzTmS$8bSPW^00C((TmS$8bTnK500MSy_*VcrTmS(8XaE2KDN0-b0Rd+KC{A2}00CuGTmS$8b6i{i00CiQTmS$8a%fxt0RUt<9XAE5c00ChVT>t<9au{6z00D0vT>t<9bR=B>0RVUc00Ct%T>t<9a5P;200DVAT>t?9dIA6eDMnoY0RedeC`w&`00CrBT>t?9fC2ykDPCOw0RevkC}LfJ00C!cT>tt?AdjcqgU4Q@qWr|$@00DB6T>t<9VVGS200D5GT>t<9Wu#pI00DBUT>t?9egXgiDYjhz0RepiD7syM00C&gT>t<9W5`_q00DH)T>t<9Wz<~&00eYlaArVV0Crsfuw4M!T>t<9I^bOZ0Re#mI`UnB00DCNT>t<9WdL3P00C$QUH||AV+>vZ00DFoUH||AWf)!n0Ra0600DC(UH||AbSPc`00C((UH||AVKiO<00DA3UH||BW^^8206<;<00C`AUH||AWl&xK00DGXUH||Ab6j2k00DVoUH}0ATLSx00DTkUH||AWw>4d00CsaUH||AZp2;y00VPzX=q*mu3iAjUH||AI?!GK0RbHWI^JG@00C^|UH||AaO_?H00MJuDqR5bUH}0AasU7Ua{^xg00CqMUjP6BZVX=l00ChVUjP6BZ5Uqw00C_tUjP6BZzNv;0RVFV00Cq$UjP6BY&2g000DA3UjP6BZ$MuF00LuoDqjFbUjP6Bb4*_V00CuIUjP6Bb6j5l0RVIW00CrZUjP6BVQgOj00CukUjP9BbpQYXZhl_?00Cu!UjP6BbckO700DH4UjP6BX_Q|800DBEUjP6Ca(8%N0H9w000DERUjP6BWw2iW00CpRUjP6Ba=c#v00DKvUjP6BZ^&N&00DE(UjP6BWz=5)0RVOY00Cs+UjP6BVdP%`00Cv{UjP9BcK`qZZuVaQ00CwCUjP6BbO2xg00DFcU;qFCX$)Wh00D9mU;qFDa(D1w02p8Z00DCzU;qFCbSPi|00C|;U;qFCWi(&_00C|~U;qICdjJ3dDMnxb0RegdC`w>}00CuCU;qFCY*=6b00ClNU;qFCX=Gpk00DGrU;qFDZ(%@S0B~Rc00D4zU;qFCZGd0^00D1?U;qICc>n+bDUx6S0ReabD3)M=00Cs2U;qFCX{2BP00C^OU;qFCVX$BT00eb%V|HR+0NP&wj9>t^U;qFCI=o;20RemfI?iB#00D2*U;qFCX53%^00C~|U;qICb_f6gDehnZ0ReRgDDq%{00DCNU;qFCWdLCS00D3YVE_ODa13Dp00ChVVE_ODau{I%00DO%VE_ODZ6sj;00CtxVE_ODbTDB600DD0VE_ODc|2hN0RVUi00AjTVE_REcL*pt00C@>VE_ODY>;6900Ci^VE_OFb8urqVE}kx0Gwd}00BCpVE_REdk8wPVSoSua<*Xr00CvbVE_ODaKvE%00D5yVE_ODVbEa!00DB=VE_OEX?N&g0Nh~!00C{{VE_ODW$a-900DIJVE_ODbNFEZ0RYtp00AikVgLdG$p_R2CZ~C}3iM00DGnVgLXEWpH8u0RYhl00Aj{VgLaF&<7}hVt@bvYldO~00Co;VgLXEVU%J30RYnn00AkWVgLaF(g!G{Vt@bvYpP-Z00CpNVgLXEVYp%d00D5mVgLXEZp2~$00neuXK-~SVgOWP0Cr*knqmOTVgLXEI?!SO0Rh$rI_6@400Cv}VgLXEXY^tK00Ck8VgLXEasXoh00D0XV*mgGd363^01RUQ0RVmg00Ai+V*mjGeE=vRV}JkwawcN{00Ct#V*mgFW;9~}00Cw?V*mgFbwFbP00Ck~V*mgFWK3fK00C}NV*mjFi~s-uDPCg$0Rf8uC}LxP00DGpV*mgGVQE-n0B~af00C`wV*mgFZGd9{0RV&m00AkCV*mjGg8(RyV}JkwWtL+A00DHKV*mgFVWeXK00CvHV*mgGZ*qoX0I*{K0RVsi00Ak$V*mjGe*h@NV}JkwWXfXz0RV~s00Al3V*mjGi2x|vV}JkwbmC(G00DC9V*mgFZ}4LP00LxU(qjPjV*mjFf&c&kDF$Q!0Re#kC<pGb{J#;00D0vWB>pGZ6ss>00CtxWB>sGh5!HoDK=yP0Re>oC^}?-00DVGWB>pGZ%AYS00DANWB>pGbW~&j00DDaWB>pGWng3g0RV^q00Aj%WB>sHhX5#WWPktxZgyk<00DP?WB>pGVT5D=00D4{WB>pKV_|Y+bGBmu{9^zxWB_Jl0FYz=00BCdWB>sHjQ~2VWPktxapGX24_s00CykWB>pGbpGZuDdT00Ck8WB>pGZ2)Be00C_VWdH#H?F0Y;DH3G>0Rij;C>CXa00CtjWdHyHbR=Z}00ChtWdHyHWiVv`00M7v3}pZ|WdH#H=>z})DMn=g0RiX)C`x6300CrBWdHyHWLRYY0RZa+00AjvWdH#I>I5igWq<$yWo~5v00DM(WdHyHZ+v9{00C`+WdHyHWr$?}0RZm=00AkKWdH#I?gS{9Wq<$yd7fne00D2NWdHyHa;#+l00DHeWdHyHbGT&y00CvbWdH#H@dN+?DavI40Riv?D9&Yo00C~)WdHyHcid$F00Cj*WdHyHaOho00D4fW&i*IZD?iy00D1qW&i*IV{~Q!00DA(W&i*IWq@V?00DG{W&i*IbBtyH00C)|W&i;In*aa-DV}Bk0Rfr-D57S700CsEW&i>Jp#Y-*00AksW&i;Ir2qf{DZ*v|0Rf}{D8^=h00C^wW&i*IY}94|0s^1_q5vpiyk>yfW&i*IW#DE200DOHW&i*IZ}esW00U=XZJ1^Nux0@IW&i*IWdLUY0RWW%00Ai!X8-{KlmI9gXMg|!cphf}00CttX8-^JWGrU@00C|?X8-^JX*g#900C`2X8-^JZ$xJR00DAJX8-{JmjD0(DOP6y0Rol)W++f+09t2&00CrRX8-{JnE(I*DRO530Rfl*D0XLn00CuuX8-^JaD-<700DW5X8-^KX>@F70FY+@00DHCX8-^JWuRvO0RWu<00AkiX8-{KoB$}WXMg|!WwvJk00DHqX8-^JX~bs$00DB!X8-{Jp8x;>Db{BI0Rf%>DB5R$00Cs+X8-^JWawuA0RX1}00AlVX8-{KrT{4TXMg|!YyM{d00CnLXaE2KVGL*h0RX8000Ai&XaE5Lr~oJ&Xn+6#Ya(a>00CnvXaE2KVK8U_00D3|XaE2KZaioJ00wercVTdK4rc(SX8_P=0Pbf15@-NIXaE2KI!I^$0RgH2I$~&m00DAnXaE2KWpHQ!00C!qXaE2KVSH!+00C}-XaE2KVTfn|00C`|XaE2Kbd+cS00C~AXaE2KWuRyP00C~MXaE2KZ>(ql00M1rE@l9-XaE2KZMbLv00D2pXaE5KL;?T-Db8pB0Rck-DAH(v00Cv#XaE2KW8i2200DC5XaE2Kb?j&W00D3EXaE2KbNFZg00CwGXaE2Kas+7r00CtRX#fBLbP#C(00C(hX#fBLavW&@0RTn<00Ai|X#fEMMFJ=+X@CF$bTVlG00Ct>X#fBMcV{AL06=K~00BBiX#fEMM*=!fX@CF$Wmahb00CoOX#fBLa%5=$00DJsX#fBLZ*XY<00DD$X#fBLWqfG>0RVyo00Ak8X#fEMfdnXwX@CF$Ws+$C00C#3X#fBLVW4RM00DBQX#fBLZ>(tm00DHeX#fBLbGT^$00CvbX#fBLbi`=@00C*rX#fBLa?oi20RV&q00Al7X#fEMg9IqxX@CF$bmnOQ00Cw0X#fBMcW2gV0Q6}900BDsX#fEMg#DK=^V0Rcn>C^~9@00Ct{Y5)KMbVzCd00C)EY5)KMa#U&n0RTq@00AjrY5)NNMg=HjYJdO%K5A+J0RTw_00Aj@Y5)NNNChZ-YJdO&Eh=(q0D@`&00DA}Y5)KMZYk&X&Wg=?;00DL?YXATNX)tR500C?^YXATNVLWR900MM#5^DfLYXAWN@&^C`DN<_y0Riy`C{}BL00CrNYXATNY-DQy00DApYXAWN`Ue03DRyfB0Rj03D0*vv00CuyYXATNbckyJ00C)^YXATOZ*p*J0F-M00RZ#|00AkaYXAWO^9LxXYk&X&Wv*)g00CpRYXATNa=dE*00DKvYXATNZ^&x^00DE(YXATNWz=f`0RZ*~00AlBYXAWO^#>^AYk&X&bn0sW00D0DYXATNW%z3V00D0PYXATNZv<=r00D3cYybcOZ4hh#00D0nYybcPa%0+S032)p00D9$YybcOWh`s}00DF|YybcOb2w}O00C(}YybfO_y+(1DN1Yr0Ri_1C{ApE00CrFYybfO1PA~DDPn8@0RaODC}wPc00CueYybcOc64k200D1$YybcQXJKtbYyezr0Dx=&00Cu&YybfO{09I5DVl5m0Rj65D4uM900CvBYybcObgXOu00CjLYybcOWw>kr00DBoYybfO{s#a7DavdB0RjC7D9&tv00DW_YybcOZ`^DE00DC1YybcObm(jV00DFEYybcOW%O(S0RRFB00AigZ2$oQ0SG7rZGZp)WD0En00CqYZ2$oP1_%HFDIRSA0RaUFC?aiu00DC-Z2$lPVK8j~0RRXH00AjHZ2$oQ2M8!YZGZp)YesDV00Co8Z2$lPVN`7Z0RRdJ00AjrZ2$oQ2?!`;ZGZp)Yiex(00CoiZ2$lPVR&r-00D4*Z2$lPZiH`}01Ih%a${s+XmE96Wk_oPnri@*YyiY;0QzhI7;OMHZ2($r0E%q@v~2*=Z2$lPI@oOh0RayPItFfl00CqSZU6uQY!q$)00D9uZU6uRa&PKt03dDv0RUkF00Aj5ZU6xRU;-#KZh!y*WIApD00Ch_ZU6uQWk_xS0RUqH00AjfZU6xRVge{wZh!y*K3;AB0RUwJ00Aj%ZU6xRWCAE~Zh!y+Eh=Vi0CsKw00DA-ZU6uQZ-{OH00DH4ZU6uQVU%tF00DBEZU6uQWuR^V00D5OZU6uRa&Jy<0IY5R00BC(ZU6xQg8~2nDZ*|50Re&nD8_Dp00CvpZU6uQW7KW{00DB^ZU6uQb>MCQ00D32ZU6uQbL?&a00Cw4ZU6uQa`n2o00DF$ZvX%RWhid|00MGn5N`l3ZvX%RIy7$p0Re^rIzDfJ00Cu0ZvX%RV@z)V00DARZvX%Rby#lz00D1aZvX%Rb7XG-00CucZvX)R)&>9pDRyrF0RhzpD0**z00CuyZvX%RXNYeA00Ci+ZvX%Ra+GfX00D2BZvX%Rbf9kl00DERZvX%RWUOxh00CjLZvX%RWw>tu0RY$r00Ak)ZvX)S*9IuaZ-4*+bk1)800CvzZvX%Sa%aA80Nif?00BDUZvX)S*#00Cr-aR2}TWR!6L0RV#t00AkWaR31Uf(R(2aex2;WU6rh00CjLaR2}TWw>zw0RV*v00Ak)aR31Uga|0eaex2;WzKN`00DH?aR2}TY20xD00DC1aR2}VVRCnxaR9z?0O)Z500BDgaR31Uh6pEIA00DA3asU7UbwF|e00D1CasU7WVP|tLZ~%O908DZK00CuEasUAU3j+WFDQ0p20RajFC~9(m00DV$asU7Ua(Hq800CuwasU7Ub%b&N0RRmH00AkGasUAV3800CR-asU7Ua`18h00D3IasU7Ubo_Dv00ChFa{vGVatLz(00CtVa{vGVa1?U@0RR&N00Ai=a{vJW5(6kCbASK=Zz^*D00Cw)a{vJVUIPFDDL!)m0RdeDC_;0900AmUa{vGVa!_*s00D1Sa{vGVbX;=)00CiQa{vGVa%gh^00Cuga{vGVaCCD300D1$a{vGVI)HNk0RdkFI)-zA00DB0a{vGVZq00DARbN~PWWmt3o00DJgbN~VX7Xujs00Aj#bN~VY76TXqC~$Ou00DG%bN~PWZh&+E00C)+bN~PWa*T8U00D54bN~PWWtemT00DKLbN~PWY@~Dm0RS5V00AkmbN~SX8UrY_bbtT>Wx8|#00DHubN~PWVaRj<00CvrbN~SWB?ABfDcW=Z0RbcfDBg5{00DC3bN~PWVeE7O00Cw4bN~PXa%|Le0QhtO0RSBX00AiobpQbX9|HgZDH3%60RbKZC>C{q00D9wbpQYXWh8X~00DX`bpQYXX)tvF00C?^bpQYXVLWvJ00C)2bpQYXa!7Rm00CuAbpQYXb5wNz00CuMbpQYXWMFjw00C`gbpQYXZ)|k{00DAxbpQbZ90Mq340V8bbpQYXWPWu300Cr*bpQbXAp-ybDVB8r0RbQbD4KPE00DWRbpQYXbf|Rz00C*PbpQYXbhLE<00C~gbpQbXBLe^dDaLgG0RbWdD9Uw!00CvtbpQYXXV`TB00DB|bpQYXW#n}L00m-WVP$QqbO8Qz0FZS6z;yuXbpQYXI`DM>0RZg<00Aisb^rkZ>;)(gc7Ol@c@}m600DF!b^rhYX(V<400DF=b^rhYZZLKL0RZm>00AjHb^rkZ?gc17c7Ol@bVhan00CuAb^rkY@dW?@DOz>_0Riv@C|-7e00CrVb^rhYWNdZ-00U)bVK#OERCWMzb^rhYI(T*f0Ri#_I)-+D00DB0b^rhYWt4UR00Cs0b^rhYY@l`k00C*Hb^rhYb*y#(0RkoiI${QPfUcK`tZRRaJ4DMohy0RdD4C`xyL00CuCcK`qZb69r(00CiMcK`qZa%6V^00U`fWgd3`Kz9IYcK`qZI&gOY0RdJ6I(~P600Cu$cK`qZXN-3M00Ci=cK`qZa+r4j00D2FcK`qZbfk9x00DEVcK`qZY_N9#00C^acK`qZb-Z@~0RRaE00Ak;cK`ta2m~n1cYpu^XVP~700CjzcK`tZ69fPODdu+o0Ra*ODC&2B00C|AcK`qZW%zdh00DIVcK`qZa|Cz*00DUlcmMzbbaUW$01$Wp00CqccmMzaWFU9|0RRgG00Aj1cmM$b3Ir%Hcz^%_XEt~M00Ch>cmMzabVPUn00DGLcmMzaX;63o00DAVcmMzaWn6dw00C%XcmMzaZfJM_0RRmI00AjcmMzaX5e@L00Cv@cmMzbVPdLy0PJ`G00DIJcmMzaW&C&m0RRyM00Aioc>nn+bX&`w300DF+c>n+bX)JjF00Cq&c>n+bZa8@W00D14c>n+bV?=oX00Cr5c>n+bWKekk00U`rVQzQ;0(k&dc>n+bXIyyz00CiYc>nQD0+E-00C!!c>n+bVTgGE0RSHa00AkKc>nn+bX{>nw00DHec>n+bX}Ea+00Csac>n+bZp3*200D2xc>n+cbYqTr0MK~=00Csyc>n+bWZ-!K0RR^S00AlNc>nn9(n0RS5W00AjndH?|d8U!d{dVl}{XJ&c;00CicdH?|c9RvUYDSCPU0RbEYD1Lf?00C`;dH?_cWsG_N00DH8dH?_cbC`Mn00DWPdH?_dbaQli0Hk^V00CvHdH?_ca7|ZW?<400C(tdjJ3dVJLe500C$&djJ3dV>EjJ00Ct>djJ3dY(RSe00C)6djJ3da7=pu00C`MdjJ6dBLn~eDPDU30RbWeC}Mkn00DDodjJ3dZE$-400CuodjJ3dbbNaN00DD?djJ3dd5C)e00DE3djJ3dY?ONd00C^8djJ3eZ(&$_0HAvS00d!lb7LlW0C0H#3VQ&idjJ3dILK^00DBydjJ3dWzc&700C&$djJ3dW88ZH00DI3djJ3dVd#4R00D6BdjJ3dbM$)v00C+GdjJ6d^aTI`DF%E10Ri&`C<=Ul00D9kd;kCeWf*(_00D3wd;kCea3p*H00Chtd;kCeaxi=V00DP4d;kCeZ9IGc00Ct}d;kCebVz&v00DDOd;kCec~pD=00DDad;kCed0>1100C}hd;kFe_5}a|DRO)O0Ri;|D0X~+00Cuud;kCea)f*U00Ci&d;kCeaFBce00Cu|d;kCea-4hs0RZ>~00Aked;kFf_XQ}de1HG}Y_fa+00C^ed;kCeVZeL<0RZ|100Ak?d;kFf`2{G@e1HG}Z`OPO00Cy+d;kCeZsdFb00d!hV`*%B0HS;V#(V(kd;kCeI`Dh|0Rj63Is$!w00D9ceEeE*KDQbNH0RdqKC~kd#00CrleETD3*SJ0RR^V00AkaegFXh76&M(et-Z0Y_5I)00D2degFUgZ@hj000CmcegFUiEh-?4egK?)0LXp-00DB&egFUgZ`^(W00DI3egFUgVd#DU00DCDegFUhbY*mY0Q7zU00D6NegFUgZv=k;00BA*e*ggi7za8Ke}Di1Wfp$`00DF!e*gdhX(WFD00D9;e*gdia(6_205E?500DG1e*gdha6o?m0RV6Y00AjXe*ggiZw4q(e}Di1bXI==00DAde*gdhWn_N<00DDqe*gdhZg7790swLbbOrzcDSUqb0s(Oba|S4ae}Di1bclZd00Cu^e*gghb_M_eDV~1-0ReReD58IW00CvFe*gdhbFhB^00CjPe*gdha=d>400U`fWp;l6n12Ame*gdhI>>(j0ReXgI@W)H00Cv(e*gdhXXJkX00Cj@e*gdha`1lu00D3Ie*gdhbo_q+00DCXfB*miV+eo%00CtVfB*pi%?1DgDH?zP0RhYgC?0@-00DF)fB*miax8!V00Ct(fB*mib2xwi00C}3fB*sj&j!&300AjVfB*sk&IZs1C{Tca00DGXfB*miWnh2+0RYnm00Aj%fB*pj(grASfPer2Wp;o700DD;fB*miVT6DH00DA}fB*mkX=i0bfBOz0s)8!iU=s~fPer2W%Pgm00C|OfB*miVFZBy00C|afdBvjbP$0600C|mfdBvjWgLM300C|yfdBvjZzzEP00D3=fdBvjZ8U)Z00D10fdBvjV?cob00DGHfdBvjWlVtp01stpb7OaMabj*{VQ+SAXFyy4_+9`KV*to#048n#U~&LtbO7#l0K#_w0DJ&seE>#(02F`#;(!2BfdBvjI#_`K0Rfl+I+lTe00DEHfdBvjW2Auq0RXQ600DEbfdBvjb+my100C*bfdBvjWWa#{00CjffdByjumAu7XwrcI00DH?fdBvjXWW4R00C~|fdBvjW$1wb0RXZ900AlVfdByku>dIefq(!3W&VKx00D9af&c&kWekD<00C$cf&c&ka2SFB0RXfB00Ai^f&c*lvj8Y4f`9-4bS{Db00C$=f&c&kXFP%c00C)2f&c&kWk`Ym00eSub7;(g0PcYR9)bW)f&c&kI#hxH0RgoDI%a}^00Cuef&c&kY;=ME00DJ+f&c&kbAW;X00D4@f&c&kVT^(R0RUA70RUMB00AkSf&c*mSO#+_n1TSHf`9-4bf$s;00C~Yf&c&kX}E#_00D2lf&c*kR|Wt9DawKX0RdJ9D9(a_00DW_f&c&kblidf00D5~f&c&kZRmmk0RUSD00AlVf&c*lS_UZif`9-4W&VNy00C|Wg8%>lX$*q^0RUYF00Ai&g8%^mTm~o{gMa`5Wg>$B00C?&g8%>lXE1{R00C|`g8%>lVLXEX00C)2g8%^lUj_gHDNcg`0RdhHC{lxf00C}Tg8%>lZ(xG}00DAlg8%>lWNd=~00Cukg8%>lXn2DF00Cisg8%>la)g5b00DH0g8%>ma%D(^0FZ+K00eMlY;?qe0PcbS5`zGig8%>lI-r990RdnJIlWx#^~00C^qg8%>laLj`M00C{%g8%>lY1o4R0RY?v00Cv>g8%>ldgy}y00C+4g8%>lbM%7%00CzDg8%>lYygA+00ChJga82m-Ua{xDH4PL0Ri0xC>Df(00Czlga7~mVI+hA00C(#ga82m;06EzDK>-v0Ri6zC_03I0RZ9#00AjTga82o;RZA)K!gBHgn$46b5eu=00DAdga7~mWn_c^00C}lga7~ma&UwI00D1yga7~oXk=pyga9yv0DOc100BCJga82n;|4mAgn$46c$S0!00D2Fga82m*9QOrY^sC+00CjHga7~mZM1{{00DBkga7~mZ@`2A00C~sga7~mI?RLs0Rh+tI?{xI00Cv#ga7~mZs3Ff00Cj^4E00DA(g#Z8nVSt4I00C@h5!HobU=mx00C)6h5!Hoa!iH*0RRF500DAXh5!HoVO)j)00CuUh5!Ko0|Ed6a&CqI00Cigh5!Ko1Ofm7WqyVL00DA>h5!HoVTgtR00D50h5!HoZIp%p00D2Bh5!HsWp{37V+@7>QicF%h5&em0HB5d00BCth5!Nq1p;mXI=qH}00C&ih5!Hobj*eT00D5)h5!HoW!Q!Q0RYJX00Cv>h5!Hoa_EKt00Cj{h5!HoaP)=%00C|Kh5!HoZvck?0RYMY00C?ahX4QpX%L4100ChZhX4Tp%K-oZb0UWT00DC*hX4QpVJwFL0RYSa00C?`hX4QpX*`Dj00Ch_hX4QpW=Mws00C%DhX4QpbX11`00D4XhX4QpWnhN@00d)ZaAXFD033$^GKTfN00C^;hX4QpV&I1W00Cj00CtlhyVcq90mXZYc7ZY00DC{hyVZqVK|5Y00C`2hyVZqWkiSo00DGLhyVZqX;6p&00DAVhyVcq9R>gaWnzc`00CoWhyVZqVQh#100CxlhyVZqYj}tN00CouhyVZqVT6bP00m}ca(80JhXC@204Rt6T!;XQhyVZqI*^C}0s$WeZvi@{h=2eAY^;a?00C*XhyVZqW4wp}00C~ohyVZqWypvC00DH)hyVZrWOLqz0Mv*800BDMhyVcrZ~;2xh=2eAW9oi2wirbU=v!00DDGi2wirXiSL!00DGTi2wlr2m$~BDPD;H0RaaBC}N3#00DGpi2wirX>f@E00C}xi2wlr3IYHDDT0Xr0RagDD29oE00DT6i2wirZ00BD2iU0ut6#_cgihuwCXWohc00DL8iU0rtaAH`A0PKnY0RT1!00DITiU0rsXaI`<00CzPivR!tX$*@100C?givR!tY#56G00ChhivR!tZX}BU00D0*ivR!tX)ucb00DG1ivR!tV?2uh00Ct}ivR!ta!88+00L!c@`?aXivR%tbpZeYDPD^J0ReOYC}N9%00CuaivR!taBzzN00DV+ivR!tbbN~d00DG@ivR!tWr&La00C!?ivR!tI+Tk50ReUaI+}}s00Cv7ivR!tXQ+z+00CjHivR!tbhL{A2>{Ol*#Xf3(*f53+X2-9-2vYL00Ak$ivS4$&H>l~&;il`)&bf9)B)T9-T^4oi+}(DWZH`W00D0DivR!tY50o(4FLB6^#S1l;{oLX^8x1p=>h8j?E&ur@d5b(00Aiki~tP*_5t((-~r+RH+Kl?g8)t_yH&&jDP?EbS8`d00C}Bi~s-uVN8qw00DGTi~s-ub6AW300C}Zi~s-uZ)A)B00Coai~s-uba0FS00Cuoi~s=u`vCv}DT0gu0Rj2}D29xH00Cu;i~s-ua+Hh!00DKHi~s-ubfAm?00CpBi~s-ub*zj400DBci~s-ubhwNF00DEpi~s-ua>R@P00Cvni~s-uX3&fP00Cy!i~s-ub=-^q00Cm+i~s-ubm)u#00D09i~s-uVf2gu00DIRi~s-ua{!G100C|WjQ{`vZw!q900CnXjQ{`vc^HiV00D9yjQ{`vWh9LN00DI>jQ{`xVsml+ivWC#05FXJ00BBSjQ{}w`~f;djer0FbV`i?00C}NjQ{`vX;_T_00D1ajQ{`vaAb`D00C!ejQ{`vZg7nN00C)sjQ{`vWPFVP00C}-jQ{`vX^4#g0RU|T00AkKjQ{}wYy>Enjer0Fbe@d>00C~MjQ{`vX{?O^00D2ZjQ{`vaJY>C00C#djQ{`vZp4iM00C*rjQ{`vWYCQO00C~+jQ{`vY21wf00Cm+jQ{`vbm)x$00Cw0jQ{`vXY`E#00BDsjQ{}wZUj02j(`9GWd@D_00C|ejsO4wX%vnC00C?ojsO4wWgw0K00D3&jsO4wX)KNa00VPkaJq{Cj*S2^jsO4wayX6v00Cu2jsO4wWK50#00CiAjsO7wT?GIEa$b%A00CuUjsO4wY-o-E00D4rjsO4wZFG(R00L-XSdIXCjsO7w(gFYhDT00DEvjsO4waLkSX00CjrjsO4wZP<B&00D9Wj{pDxWeAS|00C|ej{pDxWfYG900MPqw2lB8j{pDxIv|e#0RhzlIx3HV00DV0j{pDxVK|Qf00DA7j{pDxazu{+0RU7500Ajbj{pGyQw1ngkAMIHWm=B_00DGjj{pDxVQ7y400Crfj{pDxaCDCV0RUD700Ak0j{pGyRRt)7kAMIHbBd1u00D54j{pDxVVI8q00C{Dj{pDxaHNj_00C*Lj{pDxZLp6300CvTj{pDxbi9uM00Cjbj{pDxa>$PW00Cvrj{pDxZq$ze00Cv%j{pDyb!U2y0N{@R00BDYj{pGzR|R1@N{;~WkAMIHaQ2S?00ChFkN^MyZ3vJ600CtVkN^MyVib@70RY+v00Ai=kN^Pz*$5~kkbnRIa4L`h00Ch#kN^Py+z0>xDL#+@0Rh_xC_<2c00D4FkN^MyVNj3&00C`QkN^MyZd{N600M1wIFJBhkN^MyI%tpp0Ri0zI&zSJ00DA%kN^MyWq^D``00D3ukpKVzVI+|N0RU4500Aj5kpKY!QU)kAk$?aJa5|9y00Ch_kpKVzZAg&-00C}JkpKV!ZFMS<0926x00BB$kpKY!R0cX^k$?aJa%zzP00CukkpKVzW_XbR00CxxkpKVzb%c=s0RYDb00DWBkpKVzVU&>o00DBEkpKVza-fj_00LrRije@OkpKVzc&w2C00CvTkpKVzbi9!O00DBskpKVzWyp~L0RU_U00CvxkpKVzbl8yq00Cj%kpKVzbmWl$00DFAkpKVzWblyy00D0HkpKVzW&Du<00C?Qk^lh!c?JLhDGrhV0ReahC=!x@00Ctfk^le!bRd!d00Chpk^le!WGs>Z00D3^k^lh!djHj7Lh(%bqJLJ00DFkl>h(%codZY00Cthl>h+%DhB`oDJGQw0RbroC@PhJ00D3?l>h(%VK|il0RSuq00AjPl>h+&D+ee@m4E;Na88u~00CiEl>h(%ZCsTA00C}dl>h(&ZFN4C0BDr}00BB~l>h+&EeASym4E;Na(h(%W{i~p00Cx_l>h(%b(oa^00Cm2l>h(%c%+p800CvHl>h(%WU!S000C~cl>h+%FbDtvWx|yJ00DHyl>h(%Va$~P00DH;l>h(%bJ&#t00C^?l>h(%Y2=jv00Cp_l>h(%Zt#@=00Cw8l>h(%bo`Y700DCXmH+?&Xb6@700DFkmH+?&a1@pR00CthmH+_&O$q=3awe7l00CtxmH+?&W-yij00Cw;mH+?&bv%{;00Ck`mH+?&Wk{9)00C`ImH+?&VN{j?00DAZmH+?=b7OLLVsvR_W`K?W$dCXGkpRw-00@!*Ae8{Tl>i`?0AQ8?00BB?mH+_(fd)E^mVf{OY?77$00D5CmH+?&ZJ?F_0RSoj00DWdmH+?&cCeNJ00D2dmH+_&D*^xka>AAX00CjfmH+?&Wz3cU0RSul00DB?mH+?&VceDg00M4i(v|??mH+_&E&>1nZt|7@00D3ImH+?&Y5bM|00DFYmjD0(X$Y4900DCjmjD0(ZxojR0RS%o00CtnmjD0(dL)+s00C(#mjD0)aB~`$05F#T00DG1mjD0(azK{=00D1CmjD3)Edp>%mjD0(cT$%C00CuMmjD0(X<(NC00U-vcD$AV=#~IxmjD0(I&7B!0Rb=qI(nCY00CiumjD0(a)_4z00Cu=mjD0(ZIqV)0RW)_00Cj3mjD0(bflL600CjDmjD3(q5=Q`bheiO00C~gmjD0(b-5)00DOPm;e9)W&D@`00C?QnE(I*a0r0RWQ-00CuKnE(I*dR&I?9=V00CprnE(I*bJ&>x00Cv*nE(I*WaOCu00DXGnE(I*Vepv%00DCLnE(I*a{QS900LxTvX}q@ng9R+a0r?J00ChVng9R+Z5WyW00Ctlng9R+VkDXX0RR9500Ct%ng9R+dNi5<00C(_ng9U+0R#X6bViy000C}Fng9R+bx@iB00D1Sng9U+0t5g8V{=@Z0AiW|00DGnng9R+Zg83a00Cuong9R+ZG4&l00Cu!ng9R+Y>1iw00MJmK$-xKng9R+I+U6K0RaO9I-Z(<00CvBng9R+a;%yF00DKfng9R+bhw%T00CpZng9R+b;Ozg00DB!ng9R+bkLdr0RXB700Cv(ng9R+ZQz;!00CjoB#j;bVQs000DAJoB#j;Wl)>|00CxJoB#j;W?Y;A00DJkoB#j;VrZNI00CugoB#j;ZFHOf00CiooB#j;a)6uw0RVjj00Cu;oB#j;Y>=D)00Cr{oB#j;Zk(I|00Cj5oB#m;egpskWv-k600CpNoB#j;VYr+C00L-csGI=4oB#j;I>ej+0RevmI?kMc00DH=oB#j;W!#(q00C#>oB#j;a_F1@00Cj{oB#m;tp@-BW%`@|00C_NoB#j;WCWc600C|aod5s?00Ch_od5so00Cu!od5sY00DF)o&W#=Wh|Zm00Cz*o&W#=ayXs<00Ch>o&W&=r3nB5WlEj^00C@Ho&W#=WK^C200C}Vo&W#=VPKvB00C%bo&W#=I&7W*0Rg57I&z+X00DG(o&W#=Wq_Ul00C!)o&W#=a*Un;00Ci=o&W#=beNt100DWPo&W#=VWge_00DBUo&W#=aWe}eL00DFsp8x;>a~z)l00C$sp8x;>bSR$y00D3=p8x;>Wi+1v00d@ZbYzB{0F<2o@SXrVp8x;>IzXQQ0Rf`~I#Qp200CoIp8x;>b6}qU00CuYp8x;>WNe=R00DAxp8x;>Wq6+e00Cxxp8x;>W`v&r00DK1p8x;>VvwHz00Cu|p8x;>ZJeI~00Cj5p8x;>a;TpG0RT(_00DHgp8x;>Zn&QS00DKrp8x;>Z^WMf0RT+`00Luk%AWwxp8x;>bkv^!00C~^p8x;>W#pd#00C|4p8x;>W$>Q>00C_Fp8x>>P67Y{a{{0M00D9apa1{?WelJI00Cwapa1{?W*DFV00DI#pa1~?PXYh|Wh$Tm00C|;pa1{?X*8e!00C?|pa1{?Wk8?+00D4Dpa1{?X-uF100D4Ppa1{?a#)}M00CuQpa1{?WMrTK00CiYpa1{?XmFqa00U)WbNrtGB%lCxpa1{?I((o20Rd0~I*Oox00Co=pa1{?bC{q200Cv5pa1{?WTc<~00DWbpa1{?VX&Y800DBgpa1{?a=f4b0RTV+00C~upa1{?Z_Ju00DZ6p#T8@F$VwvWtO1;00Cs0p#T5@X`rD100DBQp#T5^X>^dG0IZ<^0RS=w00DHop#T5@Wx$~T00DExp#T5@X3U`g00Cywp#T8@GY0?xc;2A^00Cv0N9}b^q~M2q5uE^Ivk<^0Rc4!IyRz!00DG7q5uE^ZbYI000Cu6q5uE^ZBU{B00CuIq5uE^Y+RxM0Ruw?VLD~Ppa4{%fMTKm00DStq5uE^Wq6_h00DGt(00C(}qW}N_WkjO@0RYWy+=i00C#trT_o|VbrDo00DE_rT_r|oCE*?bmpc200Cj@rT_o|ZSbZ500DCLrT_o|Z~UeJ00m@icXei5rU0m>0K}#M;HCfqrvLx}ItZr#0Rf!^Iv%Hh00CnprvLx}b1bI-00Ct(rvLx}WH_e)00Cq^rvLy0GcqyGqX0&x07Rz%00Cu6rvLx}a#*JT00DJgrvLx}bY!Oh00DSvrvLx}WpJke0RROA00Aj{rvL!~1OzC6r+@$fWQL~z00Ci+rvLx}b(E(700D8DrvLx}ZlI?C00CvDrvLx}Wvr(F00DBcrvLx}W4NaP00DEprvLx}WyGfd00DH$rvLx}VbG@l00DB=rvLx}W!$F#00C~|rvL;1JO@GtJ_kSt00AlPrvL;2I|o4rJqJGrDEOy<00CtFrvLx}X$+_U0RT=100Ai&r~m;0O$R6(sDJ{1PX{Orsek|hbP}lm00D9usQ>^0Wgw{l00DL;sQ>^0ZY-$)00L}p0;vEpsQ>^3XK!<3FsJ}_r~uli063`t00BBesQ>{1Q3pCysek|hWLl{J00C)YsQ>^1Wpe1J0BETI0RXQC00CrpsQ>^0Wqhds00C@*sQ>^0Vu+~#00Ci+sQ>^0Zj`A200Cv1sQ>^0WT2@400C~MsQ>^0Wvr{0um%7DW4@^X00DBssQ>{0u?7GEbk3;&00DE-sQ>{0vIYPFaNel^0RXcG00DC7sQ>^0Z|tc600C_BsQ>^0Z}_PI0RXfH00ChHssI21Xb7qR00D3gssI21Y!s>h00v@nWN%|(xTyfhsQ}oi0OF|t{;2>OssI21Iv}b50RgoJIy$O=00Cn_ssI21b4aQH00CuAssI21WK^mE00CuMssI21bYQ9g00CiUssI21bZn{s00DDyssI21WO%9o00C}(ssI21WrV5#00C@@ssI51wFdwJbe5_B00C&4ssI21XP~M800C*HssI21Y^{ztAGFjbaJZz00Cuss{jE2r3e54DTb>60Rf~4D2l6q00Cr>s{jB2ZkVe800C*9s{jE2rw9N6DXOag0Rg56D6Xr300CsQs{jB2WW1{Y0RX8800Ak;s{jE3s0b*`tAGFjWzwqv00C#(s{jB2a^R}~00Cv@s{jB8aAb35W?^mqssJLZ0A8yAfU5wcs{q2Q0PL#(00BDks{jE3st7s|tbhOkWfrUe00DF!tN;K3bR?_*00CtxtN;K3Y%r_<00M7e#Hs)`tN;N3(g*+nbVjTI00C%9tN;K3XHcvF00C)MtN;K3Y+S4W00DGjtN;K3Z)mIl0RWl_00DAztN;K3Z+NT#00C@%tN;K3Z-lG>00Co)tN;K3a*(V500Cu|tN;K3WSp!300DBMtN;K3Z>X#Q0RWo`00DBetN;K3Ww@*W00DHqtN;K3Y{aYp00C*rtN;K3X3(qv0RWu|00DB`tN;K3W#Fs;00DI7tN;K3Z0xK600C+8tN;K3X85cC00D6RtN;K3VFaxJ00C_ZtpET5ZgAGD01&MJ0RWr{00D9!tpET4WhAWt00DF=tpET4Y%r|=00C(>tpET4W<0F`0RW*100DVOtpET4a7?WL00D1OtpET4a#*bZ00DGftpET4Z)B|i00DDqtpET4X>hFo00C}xtpET4VSKFs00L)tLahLTtpET5X<-(v0En#s0RWx}0RW!~0RW&000VV)cbu&NpsfI;tpET4bEvHV00DEhtpET4WxTBb00DBstpET4WXP=m00CsqtpET6Vr^lrtN@a&0MxAj00BDMtpEW5q6s?at$+XlWA3d000DFMtpET4W&EuG00CqIt^fc5atN*f00CtVt^fc5Y!t2l00D3st^fc5Z6K}y00MAfZma+%t^ff5i3tD!WHzn<00Ct>t^fc5Y(TC600Ck~t^fc5VN9+700C}Nt^ff5iU|M#WnQiT00CoSt^fc5VQ8)Z00L!ZSgrtWt^fc5Y;>*w00C@%t^fc5b%d?}0RW2$00Cu?t^fc5W0bA{00Ci|t^fc5W}vPB00DHSt^fc5Zmg~V00D2Zt^fc5a=5Ml0RW5%00Cvht^fc5WXP@n00D2#t^fc5ZPcy+00DB^t^fc5W#Fy=00DI7t^fc5bL_4F00Ck0t^ff5jR^n&Wd5!I00CtJuK)l6YzVIa00CkSuK)l6VHB?b00C|quK)l6WgxEr00D9)uK)l6Z!E6>00DC{uK)l6b2zU600C(}uK)l6V??h200d)Za&wBV0KTpO_^tp-uK)l6I#90w0RfH)I%2PY00CoYuK)l6b8xQ!00CuouK)l6WPGmx00Cu!uK)l6bcnA200Ci+uK)l6bd;|E00DEFuK)l6a-gpO00CvDuK)l6bgZuc00DEduK)o6s|f%BDZZ}&0RgHBD8jFR00CvluK)l6W6-Yv00C*%uK)l6cHFN300CvF4Q00D9wumAu7WhAfw00CwyumAu7W-zb-00DJ2umAu7Vmz<_00Ct}umAu7ZAh>H00Ci6umAu7a#XMY0RXWH00AjrumAx8un8z+uz&yoWoobh00DGzumAu7VR*0r00DGp0RglLD6+7C00CvVumAu7bil9x00CjfumAu7bj+{-00DE-umAu7Y}l{>00C*^700DINumAu7bNsLX00C$Mu>b%8bO^Bk00D3gu>b%8WfZXh0RXuP00Ai=u>b)9xCtmEv48*pWh$`%00DF|u>b%8VK}h>00DG9u>b%8b40NK00Cr5u>b%8ZcwoR00CuIu>b%8Y+SJb0RX)T00Ajzu>b)9ya_05v48*pa&oZ%00Cusu>b%8Y=E%<00D4@u>b%8ZH%!10RYzt00AkOu>b)9)(I$_v48*pWumbF00C#Ju>b%8VX(0P00DHiu>b=A-3i$V+X(;xDZ;S;0|DF#*a_MRD9W*b00Cvtu>b%8Zrrf|00C*@u>b%8Z0NB700Cw0u>b%8aP+YN00C+Gu>b%9b8x(|006Q800D9avH$=9We~Ce00CqcvH$=9VH~mm00LoXlCc0HvH$@9zX<>VDKfGE0Rg@VC^oWy00Cq?vH$@9!3h8XDN3>c0RY1Z00AjfvH$@A!U-r?vVZ^qd0w&r00CiUvH$=9a%{2y00DAxvH$@BzzHZ}PO^Y_vH$=9WPY*$0RY7b00AkGvH$@A#0e;rvVZ^qWSX)700S{HGeoigin0KrvH$=9WvH?M00DBgvH$=9b-c0w00DHuvH$=9c*wE<00CvrvH$@9#|Z!dDcZ6C0RYJf00AlFvH$@A$O$OuvVZ^qdG4|R00Ck4vH$=9a{RIY00D9Wvj71C#tA54-m-uQvj6}Aa1OHo00Chdvj6}AZ6LD%00Cttvj6}AVl1-&0RYPh00AjDvj71B$_Xeuvw#2raze8J00Cu6vj6}AW>B*L00CxJvj6}AbzHLm00ClRvj6}AbZD~x00C}pvj6}AVRW+q00DG*vj6}AbAYn|00C}>vj6}Bb#F4W0F1K$0RYVj00AkSvj71B%n2xa00CyYvj6}Ab-=R#00Cmgvj6}Ac+9f^00Cvvvj6}AWZ1I+00C~^vj71A(Fp(nDeAKT0RhknDDJa>00DCJvj6}AW&E=M00CwKv;Y7BW(c$Z00DIlv;YAB(+L0pDH^l@0RhqpC?2$c00DUUl00C$$wEzGCbTqX900D41wEzGCWk9t60RZO-00AjXwEzJD<_RcJwSWKtY*w`Z00C)UwEzGCV`Q}e00C}lwEzGCWpK3s00DG%wEzGFV{~M5&a?m=wE#x70DQFo00DA>wEzGCVU)E100Cv1wEzGDa%`lu0HC!10RXQF00AkmwEzJDt_di#wSWKta=Ntu00CvfwEzGCX2`Vw00CyswEzGCb=0*000Cm!wEzGCW#F{{00C|0wEzGCVeGX400DCHwEzJCvk3qJDgLzp0RgfJC<3;C00CtPwg3PDbP%=x00ChZwg3PDbR4z-00DC%wg3PDawxU{00Ct#wg3PDbTqaA00DD4wg3PDVL-M30RXoN00AjXwg3SEwh1UuwtxTuWmdKT00DGfwg3PDVPv)d00DGrwg3PDb8xl*00C@vwg3PDX?(T-00Coywg3PDZiu!300Cu=wg3PDbdr00Cwmw*UYEW+b-&00DI>w*UYEVlcM=00DS5w*UYEWjwb400Cq|w*UYEZb-KP0RYtr00Ajfw*UbF)Cnk9w}1cvd0w{w00CiUw*UYEa%{H%00DAxw*UYEVR*Ly00DS@w*UYEWrVi?00DH0w*UYEa*($G0RZ(000AkSw*UbF^a&`Sw}1cvbf&ie00DBYw*UYEZ?v}n00D5iw*UYEcfhv*00Cvjw*UYFWoeeT0L-@l0RZ0#00Al7w*UbF-U%q+w}1cvW#+d400D09w*UYEY4o=M00C_Jw*UYEWdOJU00D3YxBvhFX$-gk00D3kxBvhFau~P(00CtlxBvhFWF)u%00ChtxBvkF_Xz+2DK@wO0Ri?2C_1=+00DA9xBvhFZ%DWR00DDOxBvhFb5yth00C)QxBvhGXk#$A0ARQP00(ArWMXM{bNICYMz#RBwg3RP08Y06(zgI+xBvhFba1!;00Cu=xBvkF=?MS00AkaxBvkF?+E|_DXzEx0Rip_D6+VK00CsUxBvhFWx%)q00CphxBvhFZp^p<00CjrxBvhFblA8600DE}xBvhFZsfQC0Rrj?C~2s;fa00Cisxc~qGX@t1|00DA}xc~qGbdb3K00DQFxc~qGVVt=D0RZs{00Akexc~tH@ChiaxqtuxWwN;d00DHmxc~qGb-=j*00D5uxc~qGZOpj<00D2(xc~qGW7xR>00C&;xc~qGW8}F200DIBxc~qGVeq*C00D6Jxc~qGbNsmg00MGpqPYM9x&Q$H^9cX}DH6H>0Ri#}C>FYa00D9wx&QzHWhA-)00C(#x&QzHaxl6800D9~x&QzHVLZA300Ck`x&QzHc}Thd00DANx&QzHZ&bPf00C`Ux&QzHWnj7h0RZ_400Aj%x&Q$I_z5U*x_|%yd3L%000DGx&Q$I`UyJJx_|%yW!ky`00Cp-x&QzHY3RBD00DOHx&QzHW%RlL00CtBx&QzHasayk00CtNy8r+IWDL6i00C|iy8r+JVP&|l02sRf01RzpX=7$~bZ264b8_T`091Tm;00D2xy8r+IaL~H|00D5;y8r+Ib=A(gzyJUOb9Lyy02sgk0RRXI00C_*zyJUNaxlOE00D0{zyJXN6bS$UbV9%Y00C}BzyJUOZfQKg08GFD0RRpO00C`WzyJUNa$vv!00D1izyJXN8VLXabaKD|00C}xzyJUOZfR`50DQmz0RSNh00DH2zyJUNVUWN800D27zyJUNY@EOV00VP%W>UZag1`WxzyJUNHmJY=0RSQi00DHozyJUNVZguu00D2tzyJUNY|Ov_00CywzyJUNGT6WX00THNGa|qMw!i@1zyJXN9|-^fbn?Ie00Ck4zyJUNZ~VXj00C?Q!2kdOW(dIm00A}*!2kgOAPE2gbQ-|`00Chh!2kdOZzRD000C?&!2kdOW-!4300A;K!2kdQVKFo0zyK7%06f6}0RSEe00DGR!2kdOVN}5Y00D1W!2kdOY+%6v00CxZ!2kdOGHk&B00cNOVlybe0KC5dLcsuX!2kgO90>pcbc(?M00Ci+!2kdOZ0A#`d00BB`!T!vFyR0tq_6!+-z*bjHH~00Cjn!vFvQZPdd600DB^!vFvQZ{WiK0RT=300DCB!vFvQW$?oQ00Cz9!vFvQX8gkd00DIZ!~g&SW@6^U00_hY00DRo!~g&RWf;T&00Cqk!~g&RZY0D20RSio00Ct%!~g&RWHiJ800D10!~g&RZ9v2T00DDG!~g&Rb4`N@00DA(!~g*SJ_&b#!~g&RWQN2500Ci+!~g&RWt7AK0RTS<00Cv7!~g&Rbfm-p00C*L!~g&Ray9+00DE%!~g&RbJWBD00Cv%!~g&RW8lO900LxVWW)gG!~g*RDhUAqD+vGrclyKt00MVo_QU}G!~g&RV+6$j00BA<#Q*^TED1Uk#ee_-XBx!-00C|y#Q*>SX(+`200Cq!#Q*>SZZyRJ00C(_#Q*^SEeQYtWk$sS00Co4#Q*^SLJ0r?a#qCv00CuM#Q*>SW?;nt00CxZ#Q*>Sb!^1|00Clh#Q*>SWq8E^00C`&#Q*>SVT8p100LohP{ja>#Q*^SE(rhuWtznR00Cs4#Q*>SZ=}Tl0RTe@00CvN#Q*>SbhO0)00CjT#Q*>Sbil;`00M1us>J}t#Q*>Sa?Hg500Cvz#Q*>Sblk-N00DF2#Q*>SVd%vG0RS%v00Cw6#Q*>Sa`?pn00CkC#Q*>Sa0JEx0RT-200D9k#sB~TWfaB$00Cwi#sB~TW+27@00DI-#sB~TVl2i000DF|#sB~TZaBsO00Ch>#sB~TbVSAg00DDK#sB~UZEgz208qvN0RS`!00CuS#sB~TV`Rnv00CiY#sC2TObGx1d3MGC00Cio#sB~Ta)8DF00DA_#sC2UO9^3&#sB~TaFWIV00Ci|#sB~UW^HiB0HDSI00CvD#sB~TVz9;l00M7yR>lCf#sC2TFbMzwZpOv{00D2x#sB~TY0$<100DH?#sB~TW8B6700Cj*#sB~TZ0N=S00C+4#sB~TWAw%V00D0L#sC2TGYJ3zWd_Fp00CzT#{d8VWnlov01(Fj0RTn`00D9!#{d8UWhBP{00C?&#{d8Ua4^RJ00C__#{dBUQ3(J6WkSaQ00C!4#{d8UVNAyW00DGT#{dBUQV9S7WnRYs00C}d#{d8UX=uj)00C@n#{d8UWpu{?00D4%#{d8UX@JK70RU4800DH2#{d8UZji?S00C*1#{d8UZ=A;f00D5K#{d8UXQ;;j00C~U#{d8UX|%@x00CsW#{d8UZotO?00C*n#{d8Wb8uo<#{h=M0L;e#00DB+#{d8UW#GpE00Cs?#{d8UVeH2M00VSkXcor+JjVd?#{dBUF$n+xat6o%00D0b$N&HVbP&h@00Cnb$N&HVVI0T+0RS=y00D3)$N&KVMF{`_WirSB00DG1$N&HVVLZqH00DGD$N&HXW^Z#M$N((J07%FH00Cr9$N&HVZd}L!00CuU$N&HVY-q>;0RS}#00Cum$N&HVZg|K500D1)$N&KVHVFU$a*D_R00Cu=$N&HVW|YVP00Cy2$N&HVb)d)q00CmA$N&HVc&x|(00CvP$N&HVbhyX>00DBo$N&HVWyHt;0RT4%00DB)$N&HVWz@(300Cy&$N&HVX5h#G00DL8$N&HVV(iEO00DUN$N&HVW%$Sd00CtF$N&KVISBv(a|+1-00DCj$p8QWWfaK(00Cnf$p8QWV<5=@00Chp$p8QWWh}`600Cz*$p8QWVK~VE00M4p1jztC$p8TWI0*m&a!$zr00CuE$p8QWW?0Dp00CxR$p8QWb!5o^00ClZ$p8QWba2T400C}x$p8QWVSLE|00DG@$p8QWbBM_R00C}}$p8QWZ&U500DK*$p8QWbkxZJ00DT~$p8QWW#GvG0RTG*00DCB$p8QWW$?)W00Cz9$p8QWX8g$j00DIZ$^ZZXVhG9r00CtV$^ZZXZ4}A?00Chd$^ZZXav;h80RTJ+00C?)$^ZZXY%t0I00(Y%X=8L|VT8y4%E$mj$pD(k0OrX6CdvRd$^ZZXIy}k%0RcS;I$Fwr00DDg$^ZZXa%jo`00Cug$^ZZXX>`f}00DA($^ZZXa)8PJ00Ci!$^ZZXVvNcF00DWD$^ZZXa+t~h00D2F$^ZZXZKTQo00CvH$^ZcXL7~%K!iYcv#B-00CuU%K!iYbZE-}00DAt%K!iYWpv8`01j|-#Q>1S0Pe*Ayv6|d#{h1~0I%YXm@bHK|000Cph%K!iYY0S$200C&y%K!iYaM;TL00Cj%%K!iaWo&XDg#ci?0OZR60sy`MzyJUNDfr6(0s*}MzW^xy%YXm@a0JW%00ChR%m4rZZ4}G^00Cth%m4rZa3IV800DU>%m4xa$N<6s00Aj7%m4xb#{j_qC^*c300DG9%m4uZ)BpehDNf7)0RhthC{oOT00CuK%m4rZdSJ`|00L!cNX!6c%m4%c$^gs&!~n(s00Aj>%m4%d$pFg$!vMtqD1gj>00DG{%m4uZ&Hw-bDVodx0RhbbD4xuK00DBO%m4rZVXVvm00CvP%m4rZY`Dw-0sztg&;S4dDa6bG0s+wg&j2XO%zyv^Wzft300DE_%m4rZVc^UF0RY$l00AlN%m4ua*8nK+%zyv^WcJJe00MGu=F9;8%m4uZ)&KwjDGtp50RhzjC=$(p00C|o%>V!aX&}u200Czv%>V!aWh~7A00wk(VPj=tEX)9G%m9?k0KUus1kC_4%>V!aIylV$0RhV!aVPMSw00C`g%>V!aWo*p=00D4v%>V%az6JmRDSpiW0Rg=RD1yy^00C}@%>V!aVUW!L00C*1%>V!aWSq?a00C~I%>V!aWvI;n00CvL%>V!aY_!b)00DHm%>V!abimC300C*n%>V%a!Ug~VDbmdV0Rh1VDAvt@00C~?%>V!aVdTvK00C+0%>V!aWbn-Z00D0H%>V!aW&F(m00CzL&Hw-bX$Z~$00L}c%*_A}&Hw-cd2e{l02Iyu0st8T8v+0UDJaeW0s$BT8UiRT&VT>`Z8XjR00Ch>&Hw-bWkk*Z00DAJ&Hw-bbWqL!00DDW&Hw-bWL(Yw00DAh&Hw-bVQ9_(00Crf&Hw-bZgkE700Cio&Hw=bBLV;cDTdAf0RbWcD2mR200C=|&Hw-bWth$Y00MMnfX)D(&Hw=b9RdIWDXz`{0RbEWD6-Cg00CsU&Hw-bVZhD+00Cvj&Hw=b9|8aYDbmgW0RbKYDAvw^00Cv(&Hw-bbmYze00C+0&Hw-ba`4Uo0RSNa00Ald&Hw=cAOa`=&wu~{YzEH&00C?c&j0`cWfac<0RSZe00Ai=&j0}dBmyWT&wu~{W-8AB00D0@&j0}cCjtNgDL&5t0RbigC_>MG00C=A&j0`cWl+xm00CuI&j0`hb8>fdWpJd<0L;z+_Ratr&j2{j09?-i00BB;&j0}dC;~cs&wu~{ZGz7L00Ci&&j0`cWsuJR00DBA&j0`cbezus00DEN&j0`cWT?*o00DBY&j0`cVYJTx00CsW&j0`cZotm~0RW8!00C~y&j0}cjs*Y#bk@%R00DK{&j0}cj|Bh$a^}wf00DC9&j0`eX>VoF&j8@h0PxQM0|1c)lLeIp00Aik&;SDgkOh(jlm#dZ(0~8|Z4%G`00Chh&;S4dWhBr500Lxk_Rjz+&;S7dodo~^DLT*q0Rfx^C_d1D00C=6&;S4dWlYcj00MMnFwg)}&;S7dmjwU;DPqt70szqk(**zlDQwUH0s+tk(gi4T(0~8|Y&pC00C*v&;S4db=1%R00LogrqBS|&;S4dW#G^N0RWi=00AlR&;S7em<1^G(0~8|W%|$n00DFY(EtDeX$a8(00D9i(EtGen*{&?DH_oL0Rfr?C?3&(00C?y(EtDeY%I|L00Ct((EtGep9KH`DL&Bv0Rf%`C_>SI00Cx5(EtDeZ&1+y0RW)|00Ajn(EtGfpam#k(SQH}Yi7{^00Cug(EtGer3C;1DSFWW0Rf~1D1Om^00DG_(EtYkvjwjOu?4FIw*{>QwFLkHDU#6u0sy-Oxdi|LDX7r^0s*=OxCJP#(SQd6vIVXMum!3Gwgs#Ov;`<;qS1h~(EtDebiUC500C~+(EtDeY248O3INRo&jq~&zXibs!v)0!#|6m+%LM=dDd^Dv3IWUo&IP;$z6HPq!UekL00D41(*OVgVL;OW00VSochb@T3ex~a(*Obhkphzf00Ajl(*ObikOGndC}7io00CrX(*OVga&XfC00Cik(*OVgb$rtR00C!$(*OVgWr))N00DH4(*OVgX_V6d00DBE(*Obhl>(ar00Akc(*ObilmeOpD6G?f00DHe(*OVgWxUe>0sxl+odN&>Dag|R0s)o+oB}A$(|`g1nF5~z00Al9(*Obim;#;xDCE-4*DfZL=0RiX*DEicZ00BM#)c^njDlP8R00`9p00D9i)c^niZy41800DF!)c^niVIIFJb)qns2WLDJx00DAd)c^niVPw?+00DJs)c^niXK>X300Crn)c^niVSLp900Cu!)c^qix&{CNDUQ_u0Rg!ND3aBH00C~8)c^niVW8Cj00C*H)c^niWUSQy00C~Y)c^niWw_M<00Cvb)c^niY{b<700DH$)c^nibkNlR00C*%)c^niY~0lV00DF2)c^qiyaoUPDelz(0Rg)PDDu^S00D0J)c^niVF1)&Kzjzy<&TDMHo&0Rg`TC`Q(R00C}H)&KwjVN})t00C)Q)&KwjWMI|+00C}h)&KwjWo*^}00C!m)&KwjX?WHE00L}cJk|hy)&KwjZG_eU00D1~)&Kwja+KBp1pr$JUkF_YR|r`M00AkW)&K*8l+kV+a5NDMr@-0RdtNC`#9W00CrB*8l(kVOZAy00CuQ*8l+kWe5NPDQedM0RdzPC~nt)00Cum*8l(kbbQwU00C)&*8l(ka){Re0RU$R00AkK*8l+lW(X*l*MI;4Y@XKu00C^K*8l(kWvtf#0RU+T00Aku*8l+lXb330*MI;4Yr@w600Cvn*8l(kWzg3E0RU?V00Al7*8l+lY6vLc*MI;4X6Dxb00D3A*8l+kZ3qAXDf-s{0Re0XDE`-g00Cj700Cuo*#H0mbbQ$W00C}-*#H3mDg^)mDUR6y0RbrmD3aNL00Cu~*#H0mY@pcy00CmA*#H0mb*$L{00D2Z*#H0pVsmL^BG~{^*#L;y0Jzxz00DHq*#H0mWzg9G0RSKc00Al7*#H3n9|b7j*?<56Z06Yj00D3A*#H0mZ}iy!0RSWg00Aig+5iCoBLye~+JFE7XA0T?00C|i+5i9nX&Bl700D9y+5i9nbR^mU0RSik00Aj5+5iCoCj}@p+JFE7ayr@o00Ct}+5i9nXGq!r00CuA+5i9nbX3{^00C}V+5iCnECm1oDQ4OL0RbxoC~De(00Cui+5i9nYD%t>G+5nK+0L0n=00DH$+5i9nW#HNX0RS!q00AlN+5iCoEd?m>+JFE7W%k+t00C$I+5i9nas=A|00CtR+W-IrV{>P1{@4K4*#PF+01(>%00BA{+W-LpGX***+kgN8b1vHe00Cz<+W-IoZamun00C)2+W-IobV%C(00DGP+W-IoWmMY$0|4R(<_P2n00Ajr+W-Rr;Rxjj;|M5d+kgN8Y;M~C00D1$+W-IoZ-CnX00D4@+W-IoWQ^MY00Ci=+W-IoWtiIl00DBI+W-IoXr$W!0RZR-00Akm+W-Lp=LjgY+kgN8Yr5M200DEt+W-IoVaVG600DH)+W-IoWYpUL00Cs$+W-Lo>IeVj*j++<*W9Y#!VI00D0%+yDRpZ!FvZ00D3^+yDRpWH{Ua00Ch>+yDRpWklQn00DAJ+yDRpXi(e$0107aX?101ZF6)m2LMb%04`Ag98>_RfdJ~u0Myt3TH63t+yDRpI$YcU0RRF300D1^+yDRpX^h+e00Cr@+yDRpb(q`$0RTV%00CvB+yDRpW2oE!00CjH+yDRpX0+S@00DBk+yDRpWx(7300DHy+yDRpZp_>O00C*z+yDRpAlTdh00DB|+yDRpW#rrd00DFA+yDUp$N>NWboSf;00DLS+yDRpZ~)x^00DFc-2eaqbqw7A00D0j-2eaqAQ;^M00Cqk-2eaqZY13R00Cht-2eaqATZqk00DG1-2eaqbv)ew00D49-2eaqZb;n#0RTt>00C!I-2eaqZdly_00C)U-2eaqXJp*~00C!e-2eaqZ*biJ0RUG700DV?-2eaqa)8|c00DG{-2eaqWsKbb00C{1-2eaqZ4a?ZDpR^0Px%ZPTc@@-2lwp06g9RUfuw1-T(jrAavdU00Fy}-T(jr!kpd!0RV6S00D5Q-T(jraID?{00C&S-T(jrF1X$R00C{j-T(jrWyIb900DH$-T(jrbI{%Z0Ra3700D5^-T(jraNynm00C&`-T(jrF6`a_00C|C-T(jrVffwv00CwG-T(jras=N100Mb**4_XL-v9ssa}eJE0RV^z00D3y-v9ssa3tRV00C$!-v9stUoINo05IPG00Ct--v9ssY(U=t00C)6-v9vsu?GMFa8lm@00D4T-v9ssXk6a_00Ayy-v9ssWoX|300DMx-v9ssX>{KJ00C%v-v9ssV}RcP00DA_-v9ssVT|7Z00Cc;-v9ssWSHLo00Cv5-v9ssWTf8!00CsG-v9ssWw74>00CmQ-v9ssZM@$A0RYAa00D5w-v9ssaLnHT00C&y-v9ssF4*4y00Cv*-v9sscI4jx00C+0-v9ssXzOy2;)-vBt^0C?a40RjC1FMi;F00DE5-~a#tW|-gr0Rb`!FP`9l00Cj7-~a#tbgbY200CjL-~a&tt^fc5aK7LG00D5q-~a#tXvp9I00Az}-~a#tWz^sR00Cp#-~a#tY2e@h00DO9-~a#tW$fSp00Ct3-~a#tU-;kv00D3Q-~a#tX$0W_00CqQ;Q#;ubr9hI00ChZ;Q#>v^8_y(;eY@EY$D+R0RXlD00D3?;Q#;ua5Uin00C$^;Q#;uE0RRR900D5Y;Q#;uaJ1n700C&a;Q#;uF2Lac00Cvj;Q#;uXUyRM00Cjr;Q#;ua@gSj00D2_;Q#;ubmZXx00DFA;Q#;uU-01o00Cq6;Q#;uW&Gg)0RS@s00D3a;s5{va17!A00C$c;s5{vE*Rnf00D9y;s5{vWhCMN00DF=;s5{vX)xjd00D9~;s5~v%LV`ea6;k$00D4D;s5{vXiVY&00Ayi;s5{vWmw_>00D4b;s5{vX=LI60RX8900D4t;s5{vaCG7T00C%v;s5{vE`Z_y00DA_;s5{vWsKqg00Cr@;s5{vVVL3o00Cv5;s5{xcW`n%;s9#m0Hopo00CdB;s5{vbhzRG00C~k;s5{vWyInD0RV;x00D5&;s5{vaMa=e00C&);s5{vF5uz-00DC5;s5{vW$fYr00C$6;s5{vVff+z00D0P;s5{vVFcp<00C_Z;{X5wUl8K}00DUx;{X5wbR6RV00C(t;{X5wbSUEh00MSy%HjYn;{X8wivj=va6aPz00D49;{X5wXh`D#00Aye;{X5wZB*j`00CuM;{X5wbYSBE00DDm;{X8wfCK;maB|}S00D4z;{X5wXnf-U00Az7;{X5wWr*Vd00C!?;{X5wVU*(l00DBE;{X5wZ=mA<00Mb*Y~ui?;{X8wxdZ?KaJJ(B00D5i;{X5wXu#tD00Az>;{X5wa?IlZ00Cvv;{X5wXxQTb00Cp(;{X5wbmZdz00Cj@;{X5waPZ>*00DFM;{X5wY5d~=0RTP)00D3aw}00DKf00CeA00CpN00Axn<^TWzc?jkJ00D9i<^TWzbQIs00D1`<^TW!XLBaz0FdSY00Cu|<^TW;Vt00Bb7XC9V_|V}cHsc3;Q#{S05szOtm6Ozz00DE@<^TWzW8mfh0RR~R00D69<^TWzaPZ~;00C(B<^TWzF8t;I00C?Q=Kuf!ZwTiA00D0f=Kuf!a1`eN00Cbb=Kuf!WFY4N00Chp=Kuf!Wi00a00D9`=Kuf!XgKEp0RU_P00D4B=Kuf!a7gC>00C%D=Kuf!E>!0L00CuM=Kuf!V_@e100C)c=Kuf!c5LSW00Cuk=Kuf!WO(NQ00Ccq=Kuf!a)jpq00Cu+=Kuf!WRT|o00C~6=Kuf!Wt`^#0RWi+00D5Q=Kuf!aIEJ500C&S=Kuf!F1Y6a00C#d=Kuf!b;RcY00Cmk=Kuf!WzgpU0RXK700D5^=Kuf!aNy?v00C&`=Kuf!F6`$300C_B=Kuf!Vfg0&00C+K=Kuf!as=oA00CtR=l}o#bP(tO00ChZ=l}r#hy(xua3bgc00D3&=l}o#Xe{Ue00AyC=l}o#csS?)00Ct_=l}o#bVTR?00DAJ=l}o#Wl-n<0Ra3300D4Z=l}o#aA4>F00C%b=l}o#E^O!k00Cuk=l}o#ba?0h00DG<=l}o#WrXMe00C@@=l}o#VUXwm0RYGc00D5E=l}o#aG>Y_00C&G=l}o#F0AMP00C^W=l}o#X}IVB00DHq=l}r#*#`gtaLVWa00D5$=l}o#Xw>Kc00A!A=l}o#bl~U!00C&`=l}o#XYA+z00C+8=l}r#mk0m>aQ^5300D3U=>Px$Xb9;500Axz=>Px$WEAND00C(l=>Px$avPx$a4_ir00C$==>Px$EPx$a!Ba_00CuA=>Px$ZB*$100CiI=>Px;a%63GaCK~FW1{B(*5?2m=m1ve0G8+g#OMI{=l~|^0AT3=0RdbEFJ|e00RUPA00D56=>Px$aG2=;00C&8=>Px$E~M!I00CvH=>Px$Zm{V900CjP=>Px$Y`p0J0RW@~00D5w=>Px$aLnld00C&y=>Px$F4*Y+00DU3=>Px$W#s7q00C_3=>Px$aPa8>00C|G=>Px$Y5eH`0RZ;|00D3a>Hq)%a181I00C$c>Hq)%E*RHq)%ZzSpf0RUkM00D3?>Hq)%a5U-w00C$^>Hq)%EHq)%Y)t9^00DJU>Hq)%b6DyC00D4b>Hq)%VPxt600eMzVq?PT00Qa&D(V1g>Hq-&+6FIh>VNHq)&Y-Nn;0Fdec0RWl-00D5I>Hq)%aHQ%000C&K>Hq)%F0kqV00C*X>Hq)%b-d~T00C#h>Hq)%ZOG~X0RU|V00D5+>Hq)%aMHq)%F68O}00D05>Hq)%Z}92>00C+C>Hq)%bo}Z700ChF>i_@&dI;+P00C(Z>i_@&Y!vGN00Chd>i_@&X&~zW00D9)>i_@&Wi0Ce0RVvs00D3~>i_@&a6Ib(00C%1>i_@&E=cPD00DDO>i_@&V^r$^00U`rWzOmVGV1_Z>i_`(;0G^Y>wo|OX>RKP0RS-q00D4(>i_@&aDeLo00C%*>i_@&E{y8{00DE7>i_@&XPD~%00C~E>i_@&X{74_00DHW>i_@&bg=6H00CvT>i_`&X955LaKh^V00D5u>i_@&Xw2&X00A!2>i_@&ZP@Do00Cj%>i_@&W#sDs0RYqp00D6D>i_@&aP;c{00C(F>i_@&E&%KR00C_V>;M1(VGQg500CtZ>;M1(av1CY00DF!>;M1(b0q8l00Cbr>;M1(WH9Ui00D9~>;M1(VLa>r00Cq|>;M1(Zb<9^00MGh>gxbb>;M1(bX4pB0RU_Q00D4h>;M1(aA@oR00C%j>;M1(E_Cbw00DD)>;M1(WPt1d00DA_>;M1(VT|km00DK9>;M4(6$1bPaGvY{00D5K>;M1(XsGM}00Azp>;M1(aJ1|I00CjT>;M1(ZNTgR00Cdd>;M1(Wz6gV00D5)>;M1(dD!d#0RUVC00D61>;M1(aOms+00C(3>;M1(F7)gG00C|K>;M1(VF2v_00CtN?EnA)at!SN00DFo?EnA)a~SOa00Cbf?EnA)awP2l00Ctx?EnA)W-#pl00Cw;?EnA)bv*3=0RZd>00D4F?EnA)a7^t000C%H?EnA)E?DgV00DDe?EnA)b7buR00Cuc?EnA)ZgA}Y00C}x?EnA)VSMcX00C)&?EnA)WQgqm00C}}?EnA;b7yp7WnSz6nCt-F>;OXT0F>j1p#0MP9KrtSdF?f?V>2L~YmmjO-&Iv_8C+<>CqfYk1Q00L!h{_X&3ga82mWdHyHa31df00D3!?*IS+XejRh00Ay8?*IS+cr@<-00Ct>?*IS+Y(Vb-00D4D?*IS+ZA|X~00C)I?*IV+G6Dbra9-~K00D4f?*IS+XlU;M00Ay;?*IS+cy#Xo00D1$?*IV+Ndf=?aE9*y00D4{?*IS+Xprv!00AzR?*IS+Wt{H-00C^G?*IS+b*S$E00DEZ?*IS+aJ26L00CjT?*IV+{R032aK`Td00D5y?*IS+XwdHf00A!6?*IS+W!&!o00C~|?*IS+Vd(Dw00C_7?*IS0QBzw0Rd_PFZ%C*00DCh@Bjb-auo0Y00Cth@Bjb-WFYVW00C(x@Bjb-Y%K5q00C?=@Bjb-Z#eJ(0RR{Q00D4B@Bjb-a7gd~00C%D@Bjb-E>!RU00ClJ@Bjb-Vqow900CiU@Bje-+XesuaB}bf00D4z@Bjb-XngPh00Az7@Bjb-Ziw&z00C)^@Bjb-XO!>&00DKH@Bjb-Y@qM}0RZj@00D5U@Bjb-aIo+I00C&W@Bjb-F1+vn00DEt@Bjb-ZpiQe00D2#@Bjb-Y1Hrl00DE_@Bjb-Y2fex00C^~@Bjb-Z0zs=00D3E@Bjb-WBBj@00CeA@Bjb-Wd!j600DCf@c;k;VG!{E00C$g@c;k;a2)Xf00Cbj@c;k;WGL|f00Chx@c;k;Z#3}$00DA3@c;k>V_|S&KJWl+@BpUp06_5o0RVCV00Ajj@c;n00C*5@c;k;bD;4600C*H@c;k;Y^?DB00C^W@c;k;Z@BRQ00CpZ@c;k;I>hk+0t0gaaR4tma7OWf%JG1L@c;n;QVIY8bmH*<00D01@c;k;b?or~00D3E@c;k;WBBm^00BDw@c;nS{00C~A@&EtIVP;DZcUm0Ria;D8ll90RZd=00Ak`@&Ew=>jx;*@_+#V?gsz?DdO?~0R-&_czJp#w(?*}?O^MC*WVnXu(00Cl3^8f$=VNmk`00MJi4DbL}^8f$=a$NHO00CuY^8f$>b7VU50BrLB00C)o^8f+><^Zz>00DA>^8f$>Y;Sz?0EqJd00VPvUmjopj%Wb>60s@TyeE>QrtYm;7V}Jkwa_I8_00Cw8^8f$=X8iL200CwK^Z)<>bqMqT0|W8|<^<#fIw&p*W`N#gfH>s<00Lrj4)g#N^Z)<>WGM6i00C|?^Z)9^Z)?>A^`vaa8mRD00D4T^Z)<>Xk7FF00Ayy^Z)<>b7=Gc00DDu^Z)<>VRZBW00D4%^Z)<>Ux4%g00DW1^Z)?>{s901bCUD`00Cu|^Z)<>Zk+T000C*D^Z)<>Y^d}A00CvL^Z)<>WVG}E00C*b^Z)<>b-?rh00C#l^Z)<>Ak6dt00C~&^Z)<>Z`kwz00C*<^Z)<>bma5^00DLC^Z)<>V(|0;00C+C^Z)_?ssmL700Aii^#B6`J_4x&R0KLGWGsLP^?(2YbPn|Z00DR&^#A|@a%KGV03`JQ0|VU%O$j&&b7eZ#ngE2G0CJFk00D9|^#A|?Wk~e^00CxB^#A|?W>ob600DJc^#A|?Vqo^6a%^pIZe(>7?*NYT07&!zjPwA6^#Bw`0POJq00Cj_LI3~(Z#+!^01jnob7OaMabj*{VQ+SAKwJR$UH}qf0LW+nCT;*=asXs>0Pc1G!gl}wd;ny907icR6o3HYfB*miI=uA&0Rfl+I`;K|00DFS^#A|?V+8g900C?$2LJ#9Wo#aW0ARZS00DV;%>V!abkfoQ00ne&cXDDN_5ddK0D9B_h}8g!*Z=?lIxO}80RdkLIzsk<00DVO_5c6@a!~dF00D1S_5c6@ZCv&M00CuU_5c6@X&6)h010GiWnpJ+b#rvE^#Hc@01Ea15cU8T_5f)10B-gGTH63t+yDRpI&}5`0RbTaI-2%?00Cv7_5c6@a;WwI0sw;sg$4itDYW(g0s(>sga#00DC9_5c6@Z}9d200Cz9_5c6@bNu!I00C|S_W%F^VF>pC00D9i_W%I^y8r+IWg7PY00D3w_W%F^VI=ne00C$!_W%F_baNE<05JCe00BBS_W%I_yZ|~t_kaKaaz^(600CuA_W%F^WK{P600C)Q_W%F^Y+&~Q00C@f_W%F^Z*2Df00Coi_W%F^Wq9`h00C@%_W%F^b%gf-00DD~_W%I^Zv+4Vd6xG800DNI_W%F^Z=m-80RV6W00DBW_W%F^VX*fA00CvT_W%I^aRdMXa>Dlj00Cjf_W%F_Zf3mq0L=FQ00L%uruP8S_W%F^I^6dF0ReIZI_CF)00Cj__W%F^a`g8A00CwC_W%F_aBYzH008&^00DK@_5c9@hXw!vDHiwu0Re^vC>r>H00C|w_y7O_X(;#r00Cz%_y7O_bu{<@00C?|_y7R_i3R`xDMt7J0Re~xC`$N%00CuC_y7O_V_5hA00DAd_y7O_b!7Me00D1m_y7O_b8z?o00Cuo_y7R_iv|DzDT4R_0Rf5zD2Die00DH2_y7O_Zj|@{00Cv1_y7O_ZlL%800D2N_y7O_aIE+M00C{X_y7O_Z@BmX0RW8#00Ak)_y7R`j0Pyk_<#Tbbk6ty00C~+_y7O_W!(4x00DO5_y7O|aB^d1K==TB_yE560OR0KokK0RVCX00DW_{Qv*~blCj>00C*<{Qv*~bmaX200D05{Qv;~a{~YYZub2E00C+G{Qv*~Z2MDRTb+0RdkMD0csV00Cuu{{R31bcFu^00Ci&{{R31WRU*=00C*1{{R31WSsv100C~I{{R31VW|HA00L!WZ2thR{{R31WVHVP00LuVJpTZ`{{R61TnYdIDbD`@0RdYIDANCc00DW}{{R31bm0F000C*{{{R31bnO2C00D0D{{R31W%&O900CwG{{R31b_4(c00D0b00962Z4dwf00Ctd00966V{>g`a>o4tr2YW*{s6@P02}}T00BB800993WePet0D%Ajb3On800C}B00962Z%hCI00C)I00962b65ZY00C)U00962Y-9id00C@j00962Z*Tws00Com00962Wqbeu00DD?00962VTb?$00C%@00962aFhT600Cs000962VW0p300D2N00992n*jg;WwHPP00CpR00962X}kad00DNw00962Wyk;l00Csq00962a?}6;00Cv%00962WZ(b+00D0100962W$XX}00DCH009C3odKT#00Alf009C4oB^HzCaD00DXe0s#O4X$S%V0RX8100Ai!0s#R5r~xP#0)YSlavlN!00Ctt0s#O4WGn&!00MJv4gvu(0s#O4WjF!>0RXE300AjT0s#R5ssSiW0)YSlb5a5U00D4X0s#R4tpNZ5DP{rz0RgN5C~5+M00Cui0s#O4dUyf>00C)!0s#R4uK@r7DT)FC0RgT7D2@Vw00DB80s#O4Wt;*500Cs80s#O5b8dtJ0jL5200CvL0s#O4a<~Ek00C~k0s#OAZDMtEa&T|>00B?|0e}Gk<^cgh0s&wG0mK3U00BD60s#R5umL*g0)YSla_#~F00Cw80s#O4a{K}T00CtJ0|5X5WC#NR00C|e0|5X5WfTJe00D9u0|5X5Wgr6q00DC*0|5X8X>W32qWb`5`~a)~0W1Rn0RZX%00C}90|5X5cSr*P00D1K0|5X5Zd3yS0RZa&00CrR0|5X5Wn=>Z00Crb0|5X5VQ>Qh00D1y0|5X6YiwEr0ek}i00C}-0|5a5>;M1(XOaT}00C~60|5a5?EnA)WTFEB00L=coC5)-0|5X5WUK=L00CjP0|5X5Z@dEm00MPvi~|9}0|5X5I>-Y70RRdC00Al30|5d82?6c^Iw;Zuf!qUu00DF20|5X5b?^fL00DIN0|5a55&-}KDFOrm0Ra&KCT00CuE1_1#82mt^ADP9Hv0RjgBZ75g<0b&M$00Cua1_1y8baVy*00C)w1_1y8a)1T_0RRjE00AkC1_1#93jrvQ27v$pWtIj300DHK1_1y8VWb8D00CsG1_1y8aIgje0RRpG00Aky1_1#94FM>?27v$pWyS^p00DH)1_1y8Vblfz00Cs$1_1y8Y2XF{00C^~1_1y8VeAG000DOL1_1y8ZukZP0RR>O00Aik2LS;A6#*y+2Y~#iZ00DC%2mt^AZ7c`@00Ch#2mt^AaySS900Ch>2mt^EWoL78aHIzT!UqB12LTWW0YnG^00BBm2mt{BECxDY2!Q|rVP*&c00DGv2mt^AWpoGu0RWl?00Ak02mt{BnFc6?2!Q|rd5Q=D00C~22mt^AVVDR300D2F2mt~Bo(7x-00Akg2mt~Cod%l*D6j~D00BL=2mt^Aa=-`y00D2t2mt^Abj%0=00Cjr2mt^Aa@Ys~00Cv*2mt^AaO4O91puf9q6VM_rUs-200AlR2mu8Frv{-0p9ZA{qXsDa2!Q|rbOH$h00CtZ2>}2Ba~KH$00DCz2>}2BVI&Cw00DU_2>}2BZZHV}00VSyVWbEF>IeZg2>}2BIy?yh0RS2Y00Ajb2>}5C83!m-34s6sWm*XV00C!W2>}2BWM~Ni00C)k2>}2Ba&!p+0RSKe00Ak02>}5C9|tIe34s6sWr_&_00D542>}2Bd6)?S00LrkdI}2BbfgIZ00CvL2>}2BbF>Ko00DEl2>}5B90vdaDaHu_0RbBaD9Q}2BVb}=)00D2_2>}5B9tQvcDe4IU0RbHcDDDY?00Cw62>}2BcKite00ChF3IPBEVQh222?68@0SF2K00BA<3IPEDAqP4f3V{FtWg-dz00Czz3IPBCWH1T=00C(>3IPBCay$wF0R*WAb8R|eR0jci2mwk7fkFxa00DGJ3IPBCWn2mY00DDi3IPECN&)}@b8ZR&00Cuk3IPBCX?O|&00DG<3IPBCX@m*^00DH03IPBCZjcHA00Cu|3IPBCI-Cjt0Rc+_I-&}J00DET3IPBCVXz7T00DBg3IPBCWxNUj00C{n3IPBCVaN&r00Cpp3IPBCWz-4*00DN|3IPBCY2XS000DI73IPECS_1$9bn*%T00C(B3IPBCXZ#8Q00C(N3jqKDYzPYh00DFk3jqKDZWIdv00Cth3jqKDX&?&$00Ckq3jqND>jeM-b21A700DG13jqKDZafPC00Ct}3jqKDZAc3N00DJQ3jqKDXH*LT1pqk)GX^mRHwHBZ00Ajr3jqZII0iBXFa|aTGzKVa3xNOubaD#;00Cu!3jqKDbBGH800DE33jqKDVU!C200DWL3jqKDZlDVR0suV*I|cv&DXa?t0s%Y*ItD1R3xNRuNd^D`DZ&c@0Rcz`D8>tc00BPC3jqKDbkqw000BJO3jqKDbl?jC00Cv@3jqKDbL$ah0RS}t00Aku4gmoHGyy2Q4uJpxdBP3>00DH$4gmlGY0wS<00DE>4gmlGZrlz500Cv<4gmlGbm$HN00D094gmlIbaQD~4gsxIJOL;S4}kyya}o~$00Cth4*>uHav%=@00DI-4*>uHbSw`600DS14*>uHWjGH300DG94*>uHWke4F00DGL4*>uHVNeeN00DAV4*>uHWn2#d00MMw`VIkN4*>uHWoQop0RT4v00Aj@4*>xIHUTJn4}kyyWP%R?00C@@4*>uHZ;%fG00C&04*>uHbDR$W00Cv94*>uHa;Ogh00C&O4*>xHIRO9xDY_2<0RcDxD83JY00Csg4*>uHY|IY<00D2(4*>uHXxI+{00DE}4*>uHW#kV500DC94*>uHXz&jK00DIN4*>uHbo>ti00CwK5CH%IZwL?p0RTGz00Ai!5CH)JIsqsc5P<*zc^(h}00DF+5CH%IX)F){00DC{5CH%IZa5GD00Ct_5CH%IbVLvV00C}F5CH%KbaQF64*?Dk0ZTm0RTS%00Aj*5CH)JJ^?6n5P<*zWqJ?+00DY}5CH%IX^0R300DE35CH%IWt0#B0RTY(00AkW5CH)JKmjPE5P<*zWvUPX00DHe5CH%Ib+`}#00CpZ5CH%IWyBBx00DT)5CH%MaA$LJWfl$rat{G&5CNJH0niWu00BDI5CH)JLIFDL5P<*zZSoKS00D3M5CH%IZvYVi00C?U5di@JrUU>1DH0I@0Rg21C>9Zc00D9w5di=JWh4;+00Czz5di=JVK5N^00C|`5di=JVLTB500C`65di=JXGjqN00C}J5di=JX;cvb00DDa5di=Jb6^nx00CuY5di=JV{8!t00D1u5di=Ja(EE|00D4*5di=Jbc7KB00DD~5di@JsssQ5DV7ld0RgE5D4G$000DHM5di=Jb*K>m00D5W5di=JZnO~r00C*b5di=JWxx>u00Csi5di=JY0MD;00DN=5di=JZ`ct50RXZD00AlF5di@Ku>>gS5rF^!bnX!W00D0H5di=Jb^H+l00D0T5&-}KV+axf00DCj5&-}Ka}*K*00VDwVUQ64-Vp&B5&;1Ks0083DJ~KL0Rg83C^8a(00Ct<5&-}KdO#8Z00C)65&;1Kt^@!9DN+&v0RgQ9C{_}I00DDc5&-}Kb7T?$00CiY5&-}KaBva<00Cuo5&-}Kc6<^600D1;5&-}Lb8So#0f-U-00Cu=5&;1KtONi7DV`Dm0RgK7D54U900DET5&-}KbFdNt00CjP5&-}KaJ&)$00Cse5&-}KWXKW$0RXTB00Ak~5&;1LuLLOA5`h2#W!@4200DI75&-}Kb?g!W00Cq25&-}KW%v>S00DUZ5&-}NaB^W~AQAzX5&_N<0R$5P00BA*69EAMvjjRE6M+B$av~D}00Ctx69E7LXD|~100Ch(69E7LZafnK00Ch_69EALGz92h00DMh69E7LWn>cp00Crb69E7La&Qv?00Cuo69E7LWPB3=00C}-69E7LWr!0200DB269EDMHU&5Z00AkQ69EDNH3c^XD4-L800DER69E7LbFdQu00CjP69E7LaJ&-%00C#h69E7LZpae>00C*v69E7LbJP<700DE_69E7LW#AJ500Cp>69E7LZ|oBR00DCH69E7LaQG7e00DIV69E7La|9Ft00D0b6afJMIt2g$DHap~0RcG$C>j)j00Ctn6afGMdMFeD00C((6afGMb2JnI00Ct>6afJMJOuy&DMl0l0RcM&C`uH800CuC6afGMbXXJt00DJg6afGMV`LNo00Cuc6afGMcyJT}00eDta%Geg0T2`cKokLX6afGMI(!rX0RcS)I*t^900DE96afGMbDR_b00Cj56afJMBL@HhDXtU&0RbWhD6$lR00DWp6afGMaKID+00D2t6afGMW6Tr*00C#x6afGMZrBt700C*<6afGMbL12O00DFA6afGMW$+XM00Cq66afGMZ~PPi00D9W6#)PNa0nFv00DFk6#)PNa}*T;00D0r6#)SNB?kZjDJB&G0RbcjC@K|!00Ct%6#)PNdN>sU00C(}6#)PNb3_#Z00Cu66#)SNCkFrlDOME$0RbilC|VVP00CuS6#)PNbZ8X;00DJw6#)PNV{{b(00Cus6#)PNcz_iF00VGxWgry+P!$1&6#)PNI*b(o0RbonI+_)M00DWR6#)PNaHtgl00D2V6#)PQVr_6^3=siH69K3c0kjnX00C#Z6#)PNZp;+{00C*z6#)PNbJ!ID00DE}6#)PNW#knB00Cp_6#)PNZ}1fX00DCL6#)PNaQqbk0Ra9900CnN76AYOWegSp00DLq76AYOIv5rK0RjIBIvy5*00C|!76AYOZ!8u800C(-76AYObT}3P00MMr0u}*276AbOTLl0CbWRol00C%H76AYOXIK^i00C)U76AYOY-APz00DGr76AYOZg3U>00MJqL>2*d76AbOf(ZZtbcPlI00Cu+76AYObC4DR00Cx}76AYOW}FrQ0RV#u00CvF76AYOaI6*q00CjL76AYOXt)*u0RV&v00C~q76AYOX~-4<00C#t76AYOa?}<900Cjz76AYQZ*y&;76HB%0pJz^00BDY76AbPg$X+J7J&c(a{3kl00CtJ7XbhPWC#}l00C(Z7XbhPY!nv(00C?o7XbhPZy*-|00Cnr7XbhPWh@r~00C|?7XbhPVK^5700M7pd=>#d7XbkPRRI72bWRrm00CuE7XbhPb66Jv00DDe7XbhPVPqEp00BB`7XbkQRslM27l8l)baod300C}(7XbhPWrP<200DN27XbhPWsnyE00Cr{7XbhPWtlQA00Ct_7y$qQY(y9V00Cu67y$qQb5Ixo00DVc7y$qQbX*t#00C)Y7y$qQbZ8g>00C}p7y$qRVP)PI0dyDv00BCB7y$tRQ~^4K7=Zu*bBY)N00C^07y$qQZ00DK*7y$qQV$>J`00C#(7y$qQVc-}60RVRd00AlN7y$tRb_6K!7=Zu*XZ9EY00CkC7y$qQbOadz00CtR836zRau68-00D0n836zRW*iv-00Ctp836$Rc?19fDJ~fS0ReafC^8v=00Cz>836zRVL%xH00DGH836zRa!eTk00CuE836zRbXXYy00CxR836$RdjtRhDQX!30ReghC~g^n00Cxn836zRX?z(000C}-836zRb%+@O00eYmVRGge0Vo*(WElaD836zRI+Pg!0RemjI;I(c00DBW836zRWwaRq00CsW836zRY`_@-00C*n836zRb<7z700Cms836zRXV@7500M7eo)`h%836$R7XknQWbPRO00C+8836zRa`+hm00C$I836zRas(Oy00CtR8UX+Sau6B;00Ctd8UX+SWE>g+00C|y8UX+SWhfc}00D9?8UX+SIy4#q0Rc}2IyxGG00C@38UX+Sa7Y>f0svD2RRRD3DO4H(0s&G2R01ek8i4=-ZeSV#00D1m8UX+SX>b|=00DG%8UX+SV|*F`00Ciw8UX+Sbch-O00DK58UX+SaFiMW00C~A8UX?TSpruA00Akc8UX?USOQi8D6ATR00DEd8UX+SdAu3{00Cvf8UX?TT>@JI00Ak^8UX?UTmo7GDAXE(00Cs$8UX+SW#k$G00DFA8UX+SbMP7g00Cw88UX+Sa{L+r00U`jaG)9i$Ql6x8vy_TItUv90RdhDIu;v&00C|s8vy_TZzLN500C(#8vy_TbTAtM0svD7RR;h8DLfki0s&G7R0k+R8-V};b4VKj00C)I8vy_Tcvu?&00CiM8vy_TbYvR=00DJs8vy_TaBv#|00C}x8vz0UTL)JM00Ak28vz0VS_f7KD2N+@00Cu=8vy_Tc98000C?s9033UVI&*@00e1pZgzYd0lXUl{2Ku(9033UIxrjo0RdtMIzk+Q00DDI9033UX;2&i00LupHX8v}9039V>;~ut00Ajx9039W>jvirC~O>o00DDy9033UZhRa800D1;9033UX^0#F00DH49039V?gr`x00AkQ9039W?FQ)vD4-mH00DER9033UWw0Cp00LuplpF!J9033UVZ0mx00BD29036V?*=-|9Dx7R#9f1G=a#S4w00CiM9RUCVWn>)z00C@j9RUFV83+IYDRvzJ0RSTi00Ak09RUFWA_ypi9f1G=bBY}S00C!`9RUCVZkQbb0Rk8ZC~0~ffu0=!00CsA9RUCVZm=Bz00C*X9RUFV8wdaaDZ(8A0Rb8aD8?Ou00Cso9RUCVWz-!300DE_9RUCVbKo5T00Cv@9RUCVa_k)e0RSBc00AlZ9RUFW90(}<9f1G=a{?X#00C(V9svLWcn}@|0stQfAqW5gDI6XF0s$TfAP6WT9)SP>Whfp200C?=9svLWWH=rH00C}39svLWVMHDQ00(PrV`6Y&Xbv3#LLC8c9Ra)@0rDLI79Igg9svLWI#3<~0RtomVPZO590C3u0d5|F00DG#9svLWb%Y)P00D4{9svLXZEj8)0gxU60RV0S00AkW9svOXZ2~By9)SP>a;hEy00CvP9svLWa=0D=00Cvb9svLWWW*i;00C~w9svLWWzZf000DB=9svLWWZWJB00Cv<9svLWa_Alb00DCD9svLWW%M2a00CzD9svLWWdI)m0RV6U00Ais9{~XYZvrR~AAtY?WELL*00Chh9{~UXZzLZ900C?&9{~UXa4;VM0RVCW00AjH9{~XYaRMknAAtY?Wkw$X00DGP9{~UXbW|S!00CuM9{~UXY+xS&00CiU9{~UXaBLp|00DGz9{~UXWq2O}0RVIY00Ak49{~XYa{?%cAAtY?WsV;K00DZI9{~UXX`CMc0RVOa00Ake9{~XYbpj}?AAtY?aqBLM>dYzc4)ZV3PZDUKrn0|9FZZwYM)D3&9E00DHIBLM&bXs9Cr00C#NBLM&bX|y8&0RVCd00Ak$BLM*caS15IBY^+`a>^qC00CjrBLM&bW!NJD00C^?BLM*behB~pDe5Bu0ReppDDESH00DFKBLM&bbo?U$00C$MBmn>cX9y$#00C(ZBmn>cY!oB`00DFwBmn>cZXhH900C(xBmn>cZ!9DM00v}Xb8KU9vLXTSA_0UW0lFgrcIyfW&0RevrI#MKo00CuKBmn>cZD1q;00CiUBmn>ca%?0400L!ZpdkTrBmn>ca(E;G0RUnJ00DG}Bmn>cWsD>N00DE7Bmn>cbC@In0RUqK00DHQBmn>cWvCcX0#*$00CyYBmn^cWCZ{LWyT}{00C^uBmn>cWY8o500C~+Bmn>cVcaAE00UufXr3eiz$5|UBmn>cI_M+;0Rd$NI`$-i00CtDBmn>cX#^z!00D9eB>?~dXAmU;00CtdB>?~dY#b#400CkmB>?~eWnqFO0VpK_00D9?B>?~dWjG}P00Cq^B>?~dZbT&k0RX2700DGRB>?~dVN@jn00DJcB>?~dabP6@00BB?B>@2es0li3C4m3|ZgM3700D1$B>?~dX@DgG00DG{B>?~dVT>gK00DH8B>?~eWp7F)0hlEL0RSZg00DHUB>?~dWvnFu00DEdB>?~dX1FB*00CycB>@2dCIkQhWy&Q100D5$B>?~dVbmo700C&)B>@2dCj?~dXYeHf00DCLB>?~dVf-Zl00VDxZNw!3;3WY9CIJ8eItV5K0RbokIu<5@00D9wCIJ8eWh5p600CqwCIJ8eX)q=M00C?^CIJ8eY&<3b00D18CIJ8eV@M_e00DSTCIJ8eWmF~s00C@TCIJ8ea9}0@00C`gCIJBeUIYLEDRL$O0RdeED0U`+00DA*CIJ8eWrQXH00Cr*CIJ8eY>*}a00C*1CIJ8eb(|&v00Cm6CIJ8eZKx&z00CvLCIJ8ebhIV`00DElCIJ8edB7$C0RUhG00Ak?CIJBfUj!)7CV>C}WY#7D00Cv*CIJ8eXXGXU00C#}CIJ8eVelpa0RUnI00AldCIJBfVFV}uCxHL~X9gz$00ChRCjkKfW&{8MDH|$)00C_zCjkHfWh^HF00DF|CjkHfb2ujf00DVECjkHgbaNCZ0YoPO00Cu6CjkHfa#SY)00D1WCjkHfW?&})00CuYCjkKfWCQ>KDRL(P0RdwKD0U}-00C!wCjkHfVT30E0RU(O00AkGCjkKgX9OseCxHL~ZJH+m00Cv9CjkHfbf_l*00DEZCjkHfd9)`100MM#iYEcOCjkHfa=<4600CvnCjkHfbkHXO00Cy!CjkKfY6JiQDdHyq0Rd?QDCQ@D00Cy~CjkHfY4j%n00D0LCjkHfbpR*<00nb&VqtQ|CIR*)0cs^00CzfDggiiX&fp600C?wDggiibSNqT00D0l00C(}Dggiibwnxw00D7IDggiiWKb#r00C@PDggiibzCX|00D1eDggimX?bICXly0{Y$yQ&DgiVq0ca`#0RX!M00Ak4Dggljx&$bQDuDn2WsWKV00C!~DggiiWSlAi00C*DDggiia;Pc+00CmIDggiiWwa^*00C^eDggiiX}~H00RX)O00Ak?Dggli!2|#SDb^|h0Rg}SDB3E400Cv-DggiiZ0ITh00C+4DggiiX7nln00C|KDggiiZvZO+00D9aD**ulyaXs_&?_l$00D1aD**ulz6200CvfD**rjY{)AC00C*vD**uj*9ZUsblNKc00Cj%D**rjZR9Hf00BDcD**uk*a$lCD}ew3WcDio00C_ND**rjas(^^00D0bECB!kcMvQA00D0nECB!kbQ~-J00C?wECB!kVJIvC00CnzECB!kZ!|0c0RWK+00AjLECB%lkO?S6EP((4WlAgo00C!GECB!kWLPW#00C)UECB!ka%3z400ClZECB!kZg4CC00D1yECB!kb9^iT0RWQ;00Ak8ECB%lk_jk`EP((4Ws)ob00C^8ECB!kX`n0t00CyEECB!kZLBN-00D2ZECB!ka=0u300CycECB!kWW+2100CjjECB!kZ_q3O0RWW=00Al7ECB%llnE%{EP((4W#%ja00C_7ECB!kY4j`s00CzDECB!kZvZU;00DFcEdc-lWehC=00DLqEdc-lVHhm|00U}lbAl`Z)+_-YEdc-lIwUOt0Rff?Ix;PR00CtbEr9?5Wv(p&00C~cEdc-lX}m1~00C#hEdc-lZpbYG00v`aVRUnH-1Y#@Edd7k03`VU%J~57`2YX`I@B!z0RVgf00Cw6Edc-lWB4rr00CkCEdc-las(~`0RVjg00CzZE&%`mbrdcE00CkeE&%`mWgspA0RVmh00D0-E&%`mW-u-R00C|`E&%}me*pjiZbB{r00DAFE&%`mVN5Oo0RVsj00DAXE&%`mZ(J?`00DAhE&%`ma%e6A0RVvk00C@tE&%`mVR$Y900CouE&%`mX@o8T00DH0E&%`mX^<`f00DBAE&%}mf&l;lW}+?u00CyEE&%`sbYy9FWn*s&E&(Pk0X!}NQZ4~*E&-e_0jw?o0RejfU$QO%00C^!E&%`mW!NqO00DO1E&%`mW#lda00C_3E&%`mU+^vg00C$AE&%`mZ~QI+0RV&n00AioF987og8?WEFM$97WfCs|00CnfF984nVIVI700D9)F987nh5-NpDKaks0RWZ(00AjHF987ol>sO~FM$97bVe@$00DANF984nWmGQ#00DDaF984nb6_t400CiUF987pg#jpEHZOr}F984nXL2tA00DJ=F984nVuUXN00Cu+F987nhyefrDV8q*0Re{rD4H*U00D2HF984nW~eU#00C~UF987niU9xtDY`EK0Rf2tD84U&00C~qF984na?CFQ00CjrF987ni~#@vDc&yu0Rf8vDB>@H00DC7F984nZ}2Yx00DCLF984na{Mm=0RWBx00AioFaZGpjR7bOFo6I8Y!Wa500ChdFaZDoV<0dA00C(xFaZDobSy9d00C(-FaZGoRtW$BbUrWv00C}7FaZDobx1G)00D1KFaZDoV^lB!00CcGFaZDobYL(600CuYFaZDoXKXM500DAxFaZDoVR$eB00DG00Cb@F#!MpWk@jr00DANF#!MpbyP6{00DGbF#!MpcwjLB00CuYF#!PpSP1|DWpXhA00DY-F#!MpX?!sO00DD?F#!MpUx+aQ00DW9F#!MpVU#fe00DBEF#!Mpa-cB*00Cj9F#!MpU#u|!00D5aF#!MpVYo2?00C{jF#!MpWyCQ700CmkF#!PpS_uFFW!5nP00Da1F#!MpY2Yyd00DF6F#!MpU+ggf00Cw4F#!MpZTK+(00CkCF#!PpTL}OGbP6&700C|eG64VqbrdoI00D0rG64VrZes*80U$B~00CbnG64VqbTBdj00C|`G64VqWjrzg00C`6G64VqWk@ms00C@HG64VqWmGZ&00CcGG64Vqa$qt600CuYG64VqW^6J600CxlG64Vqb$BuX00CltG64VqUxYFN00DH0G64VqZjdqo00Ci^G64Vqbeu8)00DENG64VqZm2Q=00MPy&@ln7G64YqSqT6EbiOhH00C~oG64Vqb;vRS00D2#G64VqW7IMM00CdxG64VqY~V5h00Cv@G64VqcI+|%00Cw4G64VqZ1^$(00CeAG64Vqa0D{}00C(VGXVhrTnPXHbQUuK00C|qGXVerbs#eV00D0%GXVerV=OZP00CbzGXVerbT~5s00C}3GXVerWkfRp00C`EGXVerWl%E#00C@PGXVhrT?qgIbYe3B00C}hGXVerb!;;M00D1uGXVerV|X(G00CcqGXVera)dJh00Cu+GXVerW{@)h00Cx}GXVerb(}K+00L!VTr&ZpGXVerU#K$y00DWjGXVerVYo8^00DBoGXVera>O$M00CjjGXVerU(hoF00DT`GXVerW!y6X00DI3GXVera_BPw00Cw0GXVevW^`k1cJMF(Y%u|}G64`X0rWEg00Ce6GXVercn~xJ00ChZGywnsZ5%WK00CbjGywnsY$!AV00Cz%GywnsUoGywnsazHcz00MGvI4}W5GywqskO2SzDONNA0RfKzC|Wdu00C@ZGywnsX=pS700CicGywqsk^uk#DS9*k0RfQ#D1J1700Cu$GywnsY>YGk00Cl>GywnsVVE=l00C&8GywnsW27_z00CjDGywnsWw0~>00DBgGywnsZoD)B0RWT%00Ak;GywqtlL08qG=TsCbkZ~d00DB^GywnsW#BXc00DF6GywnsbL=z$0RW8%00AlZGywqtj0hC4Z00Cb*H30wtazHf!00Cu2H30wtbWAk?00DDSH30wtX;?J@00C!SH30wtWn?u001Iq%WNCM0V`g<>asn>_EH43&F9EbK0oX4A0x$tgGy!xp0m3u^@-zWzH30zt3JL%LaGo^*00D5KH30wtXs9&-1O)F0m&E4GIqdWe58Qs0Zu>g8+jEI|@SxSpo6}8Uu?2D05?CW^!b7X?B7(frvH%q&5MrHUV0&0I0A48nFP>vH;|>0A{oR00CvVHUR(ubo@2}00ChFHvs?wWp4;K0c=YE0svtNNdf=?a2PiM00D3wHvs?vXe2iQ0Ry!FI%6(of`D@O04g^D00Ct%Hvs?vY(O^w00DJIHvs?vb4)h@0swCWDgpojd000A00DMhHvs?vZ)7(C0swFXD*^xka&R{R00CikHvs?vWqdaQ0swIYECK)la)>tp00Ci+Hvs?wZf1fv0hBiZ00U-vc4{{Pnl}MvmjD0(I;1xN0s?XbFakO*vNwS|=>Px$VYoK|00DBwHvs?vWz07L0swjl_yqs~DcCmw0s?sm_XTq(j(Y&!H-P{FY~(iq00eMuZER9E0qXn!(l-I}HvtI%6$l&!N(UtaX9LavatS{O7YG0WDGE3N00M7e$g}{S{QwCD6bKsyNe3hYW&_OtaS1*M76>R~bYyd79yoy{H~}2B07kU{e6;{v{Qv+0a&9g-0d55W00CiIH~|0xWocwM0Rl<@1OS)^QV3`P0S5p9DReji1p$`_Q3z)N00#sLD1JDB00Cr#H~|0wY?L?w00L=Ynm7T@761SVZ*_8EY-nY7W0Lg%ST+F;Hv#xJ0ctn_pf~}b@&NY40RF@P0s^cDoCi86$_9X11b_emWzaYQ00Cp(H~|0wY2-Ko00DODH~|0wW$-uw0RsX6I$vZ`0D$=50QNWm00D3OH~|0wX$(0500CqYIROCxVgLXEa2`1U00D3!IRO9xXec=W00Ay8IROCx-~s>va5^~w00D45IRO9xXhb;y00MI^G&uoEIRO9xbWk|~00CuMIRO9xb6`0E00DDmIROCxtN;K3aB?{T00D4zIRO9xXnZ*V0RUVB00D4_IRO9xaEv(t00C%{IRO9xE|@t100C~EIRO9xZ=^W^00DEVIROCxe+U2paJD%C00D5iIRO9xXuvrE00Az>IRO9xWz0DN00C^$IRO9xY1lad0RW^400D61IRO9xaOgP!00C(3IRO9xF7!D800DXWIRO9xasWC300ChJIspIyZVWmB00C(dIspI!YGz`vIRV}|0T?;~0Ri>|FCIF90Ra6800D3`IspIya5y>v00Cn@IspIyE<`#300C}FIspIyX;3-=00CiEIspIyZCpA500S;_FM>G%EII*VI)MNIWoSA900C!qIspIyWPCaS00C)&IspIya)>$s0RZ&`00D56IspIyaF{v)00C&8IspIyE~GjE00C~QIspIyX|Os000C#VIspIyb-X$O00C^mIspLyU300D6PIspIyZ~!|200CnLI{^RzE(|*X00C|iI{^RzX&5^J00ChhI{^RzZ6rGZ00A#5JAnWJZZJCm00D0{I{^Rzb38i%00m)UaBXUAIRTD30mwQ5_BsJVI{^UzE(ibtDPB7P0Rb%tC}KN-00C}jI{^RzX>dCM00C!qI{^Rzb$mMk00C@*I{^a%?*Q`v@c<}rf&_txI{^UzDF^@oWS%<#00Cj5I{^RzWvDv=0RSop00CvRI{^RzbhtYK00C*fI{^Rza>P3U00MG%t~&wBI{^RzVbD7P00DH`I{^RzW#Bsj0RSrq00Cs|I{^RzVemTv00Cw8I{^UzEC>JrWdb|_00DFcJOKa!X$(9800D9mJOKa%b8T{WjynP7I|2MV0T?_100DF!JOKa!WiUJe00DD0JOKa!b38l&010zpa${_Fb!l{P1OY-k0Z;`2umu4y1_6c!0k#GK{ssXe2LS*9I!HVL1_mz(7Xj@E?*Q`v@c=I_Iw)muNIQWpIRS1wfr12qx)%Y6I{^Uz;s5{vDVjV10RiCvD4sll00C~KJOKa!X{x00C@1Jplj#a6~-;00DSPJplj#Wl%i<0RWE)00D4ZJplj#a9}+F00C%bJplj#E^Ivk00C}tJplj#X?Q&W00C!yJplj#b%Z?u00C@@Jplj#aF9I#0RjI3FP1%l00DBGJplj#Wu!d;00DBUJplj#Z?HW900C^aJplj#aJ)SM00DTyJplj#Wyn1N0Rt=sI&ybl2!XCU0m?f800CjtJplj#bmTn&00Cv{Jplp&AqN=;Iw%|pfm8{B00Cw8Jplj#X9PY000CqQJ^=s$X%IdE00D9qJ^=#@sRm*NRRMD#WnV6BI%0HkcXT`fRy_gqJOR!<0ZKUm@I3)a34t6w0iFo~{5t^{JOKa!bRs?h00CuIJ^=s$b6h?F0RcP-aw5>fe4=fdIFFHH3$s{rw9TF=>&iP9Ru+N00Ak6J^=s(ZFP2cK*Ru?tpK2{0Hmz|00M7wYWM)AJ^=s%VRM950JuH@00CvfJ^=s%XLHhb0K(e<00CjrJ^=s%VQjV%0Xp~q00M7excC65{{R32c5dSM0A~LH3>e*hc<@C7Jla&&WWV`ZQ|fp~QQ%sv6!J^>JT0OCFY>^=eZJ^=s$WB@+_00Luh&I$n@{{R31Wk5dx0RWl@00D4NKLG#%a8y4500C%PKLG#&b1rfm0boA?00C}hKLG#&c5g~Q0dPM700C)sKLG&(K?!d^}h-Kmh{+bqQw)^#g1u2nzwiB7pz_bS^*v00C}3Kmh;&Wkf&$00C)AKmh;&Vo*Q<0swggWCQ>KDO^AS0s(jgV+1H-K!E@OXJ|kH00CigKmh;(baQw>0lFsv00DA-Kmh;&Wr#ol00DH4Kmh^*`vvm_Iw%5tfC_wo00DBEKmh;&WvD;_00D5WKmh;&aI`=H00CjTKmh;&a=<_V00DQ#Kmh;&ZOlLc00CvvKmh;&bl5-v00DE}Kmh;&dE`I=3IM1EIR>HzGX|grF$SgvHwL5zH3k3yDeyo63j#_8rv^9%p$0Mrp9U}nr3N+zqXskvIw(>Nfd)Z=00DFiK>+{(Wh_Af00DC{K>+{(b2vc(00MJi>OcWLK>+{(c|<`001b6>Y-D0|VPkl5ZDwv5IRRom0dPJ6IzIvSV*rNC0A}z2q(1@HKLH>>0aic(lt2MaK>-E=ZU|ZkUI<(WRtQ)KIw(NcfUMSl00C`^K>+{(VW2?)00CvDK>+{(a;!lC0Rc_|bh1GK0|Pn-001-xb6+~RK>;4^000Dl00DBqK>+{(Wz<0d00Cy&K>+{)W^~{|0q{cr2>^iwMFb`aLIa!w900}$!vg*S00AlRK>-N?fCWSZB?>_Un*$pF#R$Rz{Q@WiLV*AQbP7TN00CnnLID5)Whg=c00C+)LID5)Vl+Yl2>^u!NdzhiMgyP&AOOk;#{vQa00AjLLIDW@gat?hDGEgcp93EN$q2>*0Rt#hLV*AQd0IjN00CigLID5)a(F@k00DA-LIDW?i3LprE(%Hmqyr=X&Iro_1_J;ADT+b?2?2-&Oav_oNduz;BLK|^$^r!gD4s%r00DWVLID5)a=bzT00CjbLID5)ZpcCb00D2#LID5)Y1Bdi00DH`LID5)W8gvo00C*{LIDK;4FlW-3<%Z$at8nbDe^)A1qBQP+XV{<)c|n^Z((F+C^|v`ghB!ALIF5a0RBRO00C|ULjeE*X(U4d0swaeVgvvIDKJ9;0s(deVFV~PLxBJRXFNjz00Ch}LjeE+baPBY0YoPO00CuELjeE*a$G|J00D1eLjeE+XJ#rx0cb-30svD1tN;K3aCk!j00D4*LjeE*XoN!n00S;_FN#9}EII*VI)MNIWspMw00C#7LjeE*WTZm@00MAdlmG!D@c;k;WUxa400CjTLjeE+X>Y1S0l-561Oz4n76TXq-~=u@C}Ke200wq|aCCsOb^rhYbkIWq00D05LjeE*Y4Ae<00DCLLjeE*aQs6700CtJL;(Q+Y6buSa1KNP00D3kL;(N+Xc$BR00Ax@L;(N+Z6rhi00D0*L;(T;Yz9RMWK^mE00Ct-L;(N+bU;J_00Ch}L;(N+bWB7600eVoW^YnN0h*}*BFF$N$N&HVWLQK200C}lL;(N;b#G+|L;)~F0dPbC0s`Ow+5kEzUi*M#`hWldWrRcl00C!`L;(N+WSB$&00C*9L;(N+a->870s;vG;{rM;CNO}SEPwz3a6~Cj&Yt05pJZFn|C7a`Z$200CtJMF9W-dI&`U00C(ZMF9W-Y!pQS00ChdMF9W-X&^-b00D9)MF9W-Wh_Mj00DC{MF9W-WjI9v00d%lWG<>i0q#TrK1BiaIRO9xc|=7400DAVMF9!`&jHy1(E-x|*8$rB)dAfB83^A200AjtMF9Z-o&*2^aDGJr00D4l~&;il`)&bf9)B)T97zo}0C~0^_fviOV00LoTTtxx0MF9W-ZqP*m0s!{}G6DbraNtD&00D63MF9W-XzWD+0tDj*;|F6dIw)HF0P;lvkc5C@@_+yXcyDs}MF9d70HUk_0|KxCoB^HzIw1G0S-n1W<~*eyZ{0L7zP0VI;sPJ00Cu^Mgaf;W1L0-00DBMMgaf;b*M%G00Luiz()W|DggiiWVA*B00C^iMgaf=cXe{2Q2@k70gAi;1OO)ig9*C;CIkQhW!Odm0s(dbQ3*Pli+}(DW#~o$00C$6Mgaf;VfaP?00DIVMgal=`~g!5Iz)|t00DFgM*#oaEM*#u?LI^SlIw;&7fLt7a00D5iM*#oO$IM)NPz$Wa&kxk00D1$NC5x=bbv?!00Co$NC5x=WsFDx00D54NC5x=bC^g000C~ENC5x=X{1O20RZ^}00AkmNC5!>_yZ`kNPz$WZn{VT00C*jNC5x=XUIqa00DK*NC5x=Y}7~r00D5?NC5x=a^Oe-00D32NC5x=bnHk000Cq2NC5x=W%x(|00D6RNC5x=a|B5N00C|aNdW)>X%I;P00DCrNdW)>XBX(&kn00DF^NdW)>bTml;00Ct>NdW)>b3jP}00BBiNdW-?`U5&lNr3bYMvV00CoWNdW)>Wo$_S00D4vNdW)>b9hMs00C}(NdW)>X@p4u0R=M!E?*#NI*jW8sz?EfNdXW^0Vvym00DE5NdW)>XQ)X500C~UNdW)?Xlbqw0kla000nP!X=q~z5CKft0F00Cv%NdW)?bY$d70YbL`00D05NdW=?qXBXP00AlbNdW=@q5*LNC;&=<00CtNN&x@?bP!4b00DFsN&x@?WgJQY00C?wN&x@^VQ*00D1CN&x@^Z*^=O*#Ncx0Q$B700VDnWwO}-k^%s-wg3PEY;sTm0Fbu;00L!cZb|{nw*UYFZ)var04@dq00L!UQUU-#wg3hW#{kCz!2qHNO9vzdD0FjaaARU*c4usIZDuS;fx1Zn#7P14NdYcO0Zd8(Qc3|}N&$FE0e}Gjf=U65N&%i(0Qj{41OS}{X$T_%O#uJ_Dcni{1Ol7|Xb2(#OaUlw=1PJ1(f|MfYwSt^00nY%Wo&L3NCB2g0scw>1{eV{RsaG3qy%LE00D3sO921@a3D(o00C$wO924`Ud#d00C!qOaTA^b$m<#00C@*OaTA`VsmgBOaV?z0fs0g@>J00BDcOaTG{+62@DIw%k+fp#c?00CwGOaTA^XADgN00CqYO#uJ_X&6lb00D9yO#uT1iUQ&UW&kfPI&fl+Oo1>=0r*UT#!LYuO#uJ_WhzYp00C}BO#uM_j{pDxa8gYH00D4TO#uJ_Xk1MJ0Rn&qE;?dO0q7}#00CuaO#uJ_Y;;Wl00U)VX-rK4dQAa7uK)r9YXn^cIw&G2fp#W=00DB2O#uJ_Wt>d`00Cs8O#uJ_Y^Y5E00C*PO#uJ_b+k`ehcUH||AZSqY400CthP5}S`bRbRv00DC*P5}Y{@dStf00Aj7P5}Y|@C1hdC^$}m00C}3P5}S`cSueF0s(6V(g<@*BLM&bbW~0O00C%TP5}S`XJk$R00C)gP5}S`Y;aBi00DG%P5}S|VQ6noP5}~v0DMjX1OT@L!vvKH-v9ssDUeP91Oc`L!UU8F-T)|?PJsXcWuQ(000C^SP5}S`X|zrO00CyYP5}S`Z@^9g1ONa5zXaI?9tQvcDa=j*1Oxv7z696=9S3x6D8^0!NCW}aPJsXcW!z2y0s&nGMhRpBt^fc5a`;XG00CtJPXPb{YzR*Q00D3gPXPb|c5U)b0TfRG0s?CRR{=UGd?0{E9)JJ=Wh74l00DL~PXPb{X*f>-00C$|PXPb{V?<8@00DAJPXPl0C;}J)8Ui{fe9wR`&VT>`ZB|bK00CiUPXPb{Wo%CY00DAxPXPb{ba+nz00Loi0^k57>;M4-zz1P-I$uyv0e(*bvP^)4PXPb{WR6b(00DBMPXPb{VW>|500CsKPXPb~bZ&BI_5%U5PXUhk01C$d0Rq+sE;@qa0On$V00CvpPXPb{XV^~x00L!U3j1LSfDF)p00C`2Pyqk|VN_5700L=cG*AIrPyql1VQ*z}WV%lQ?oR;}Pyt|20rt-T00MP+U`GHh(*OVgVt`Nq00D4{Pyqk}Wnq~90FY1t0|9plX$kfNDEuOU00DHMPyqk|ZmduN00CvPPyqk|X}C}U00CsaPyqk|VZ=}Y00DB!Pyqk|XV6dq00DW{Pyql8Z)jy{V|j34ba!iVu0{c{M*##&0oY3cfK34`P62{W0UA#MYES`|PyyUf0m7*O00M1pJS6}sA^-pkX=HG7WoBbyadly8xC#I=695<(0N5Y^6j1?)D*%uz0CF?{9yI{YH~`i<0H8tu00BB4Q2_w}2?_uKa8^+P00D4XQ2_t}V_;DM00Ay$Q2_t}ZfsEj00C)oQ2_t}VR%si00C`&Q2_t~E-zx=0EAJ200Cu+Q2_t}c9c;800C*5Q2_t}XrNI600CpBQ2_t}a;#AS00CjLQ2_t}U${{L00CsaQ2_t}WyDbd00CsmQ2_t}WYAFo00CvzQ2_t}V%$*y00C{{Q2_u1W@U3>Oy2^x%{s->_h5%>>MhIL1^#(o)00AjXQUM78g$Mly?gWJZX9qZO@00Ci=Qvm=0X_!+100DBIQvm=0Wu#L90|XTUxd68SIw&r4W>bL*4}iGm0IE{~00C#PQvm=0b;wfz0s$}xL}1We`*W00DFsQ~?791p?XvZUJ*{FhXA~WfXKlB1i}D5!T}5b7o?2Y>-j`KvMzEQvpa+0eBz*1OSc)N(f*9`33+1DP&Xu1Obf)NeEv7_y#C$RDl2id300(00DA>Q~?43uLm{}1XqZ$100C#7Q~>}1X{1yE00C^OQ~>}1Y_L=T00CjPQ~>}1ZoE_h00D2pQ~>}2Z)u2B0mxJV00DH)Q~>}1W7t#y00Cv*Q~?13Bm_Dx!h3+m;{X5wa_Uq800L!W_EZ7bxc~qGX#7+G00CnLRRI72bPQDi00ChVRRI73VQ@M_02oyP1OdeZ>jUir!2>7+7JvW&c_>u@00D9~RRI72VLVj<00C}7RRI72Z%9=E00C)ERRI72bW~LV00eS#V`1b}0UlKWT2%ogga82sWeH+;b7LrUnu!1eiU2f<03IR%C?bK7xc~qGcXCw$00Ci+RRI76VP$D@b4F4DPE-M4RRNS$0n(`e00d}xVQ*ND0AgMMdX50f0{{R5Wnm~90S1u(00L}v0+IkA1ONd6hX`Vxl>h(%c-B<`00Cv*RRI72WaL!=00D05RRI7CaC35Fadu*KX=G-S3IMQG0m4-Q$dCZ8UI5OK0L)bZAe8{{RRJKD0AQ8?00BDoRRIM7PX>nsfd(A`eF!=vR)GKlY;P)70e~q10RTe)00AjPRsjJ4LI5a8R)GKkZcbJK00C)MRsjG3XIxeR00DJkRsjG3Y-m;i00D4rRsjG3X>?Wr00DJ+RsjG3XMk1#00C`=RsjG3X^d6@00BCZRsjJ4L;yONR)GKkZk|>F00D2NRsjG3X{=TO00DHeRsjG3VYpTS00DBoRsjG3XT(+k00CvnRsjG3bkJ4-00C~+RsjG3Y1~!;0RXN800D65RsjG3aO_qA00C(7RsjG3F8Edf00D0PRsjG3X#`gR00CzTR{;P4br4qp00C?kR{;P4a2!_w0R&zJAaE`(;#L7}Rspc;03ug`00C(zR{;P4bv#!A00VGmVLDa;LRSGe$p8WZ^aOnaIxjX&fROHh0Rk=nC~S^WfNo6y00CuWR{;P4dT>_(00C)sR{;P4YSOEY5X*^f~00LupCRhPNSOEY5F1|kj00DDSSOEY5X;@eR00AywKLG#%Ze&;i00D1mSOEY5X>eEp00DG%SOEY6cw=5z0en~i00AzJMF9W-bBtI400C!`SOEY5ZkSjB00C*9SOEY5WTaRD00C~QSOEY5X|PxU0RRvP00D5kSOEY5aKKmr00C&mSOEY5F3eZ~00DH;SOEY5b=X(|00D5`SOEY5Zsb@20RYtq00D6DSOEY5aP(LK00C(FSOEY5E&y2p00C|WSpfh6X$)Bb00CzbSpfh6br@Lz00C?sSpfh9VPa`;f>;5zSOMx-0VG)g0RY4Y00AjHSpfk7!v`opS%ClnZbn%F00C)ESpfh6XH;1M00DJcSpfh6Y+zXd00D4jSpfh6bZl7x00DJ!Spfh6aClh(00C}(SpfhDX=`m`VsK$-gjoR&9RWfe0dO4wyd44Z9RU^|0ZJYL00BCRSpfqF#Rnt^X#yZ&FJd}yF8)^mNLT?XS%Ll>0jybpW?2EuSOEY5bh23i00DK@Spfk6;Q{~wZsJ)100D32Spfh6Y3x}600DIJSpfh6WB6GC00DLWSpfh6WCU6P00D0bS^)t9_6Txs5LyB1761YO69f7M00Ai?S^)w95(D`KC@5Ni00D0o_*SpgPW0XSL#Xj%cTS^)$BUjsn^d{GQTY&%pYwTMA3Ifap&IP;$z6HPq!UeO$cKF{00IFC^B4u00DG3Tmb+9Zb)1K00VPnVIo`sPFw*p2mt{A$^-xbaAI5m00D4jTmb+9Xlz^o0RqbbV=f310diac00DD&Tmb|FstB40m$_AZU|ig00ChRT>$_AE^=G}00DCvT>$_Ab0A#-00ChpT>$_AZ!kmw00C?=T>$_DV{LF^)La1+T>&gz0XSU&0s=P&ssS%3K3#!K0)YSlb5LCY0|G(;ECDV7Iw$_AZ**M&00D1$T>$_AY=B(>0s^xHr35-C920>S5rF^!a*SO800Cv1T>$_AXP{jH00Cj9T>$_AZmeAa00CjLT>$|A%LD)cXTDtl00C~oT>$_AX~$_AXw+Q+00C#(T>$_AY2aM}0RYSd00D07T>$_AZ}43K00C+CT>$_Abo^Zb00C(NUI73Ba|m7m00D0fUI76B%>)1eY#Lqx00ChhUI73BZ6sa+00D9;UI73BZ!lf~00V4rZsuJ96kY)~UI73BIy_zh0RhegI!a!F00DGRUI73Bby!{j00D4bUI73BZe(5o0|Gq-H3c^XIw+15fuIwC00DDwUI73BbAVm}00Ci!UI79ECUI73BZ|q(H00DCHUI73BaQI#U0RXW900D3WUjYCCa0p)k00C$YUjYRI{|U?lKn2GH{sS&L6kh=z7J&c(ZW>00C}>UjYCFb8u{FN?!p2ECB3A0E}M&1OTB0Q2}iTCjtNgDWqQk1OcE0PyuWRCITp~Ux5GtYqVbh00CvfUjYLEH3DG+-UI*vDb8O30|PVyU<2I*D05}jUxC^y0FFig00C&+UjYCDb9C@u0ff;21OQzETLKpa8wdaaDF9#r1_4|GS^^dY8VIuoSOX{uV1WPuWDsBh00CtpU;zLDb0}Z|0|0mk_62+b00Aj9U;zUGcL?jN>VSxYvGLm5d1ptTx3IMbSu>$M@00AkeVF3jJhXV-!vk0&P>jEgWVSxYvG`e8{00cNOGd4(J0eWEpqG18bVF3jIiUSM)wg|HV?g9V-DdJ%P1p$cz3jnnUvI6Y_DDGi_1ptf#4gk0awF2-000AikVgUsKivtY+w+OTX?*b?gVu1hwHWp$51ptl%5CFOew*vA400Aj1VgUsKjROw=xd^rb@d79~Vu1hwGCpDf1ptr(5&*mixdQY800AjfVgUsKj{^|^y9l@f^8zSfVu1hwG-hG}00cNOGdA>L0VZMrPGSLeVgUsJk^>X~z6iSl_5uI_DUM-+5!3e$r`2r~PVu1hwZ2DpW00D0bV*vmGZxCYv1pt@>8UVxy!2N0s=<@LjpP|P-%eDXn+6#WvpWX00CpVV*vmGa=>E&00DKzV*vmGZ_Hx>00DE-V*vmGW!Pf@0|KA|kOGndIw(BUfMC;r00Cs=V*vmGa`a;X00Ck8V*vmGbpT`m4GT&IL1)V*v(a0my2A00L!n3}gZRa{vGVbW~&k00C)UWB~yHtOEc6aB5@$00D4rWB~vHXmn%&00Ay~WB~vHZh&L~00C)+WB~vHXN+V400DK9WB~vHY?x#L00D5GWB~yI5eP4&WPtzya;jtj00D2ZWB~vHbhu;z00CpZWB~vHWyE9w00D5yWB~vHbI@b~00C~+WB~vHY20K10RSfm00AlJWB~yICI~3(WPtzyZt`RS00C+GWB~vHX8>gZ00DIdWdQ&IYz$=q00D3kWdQ&Iau{U+00D0vWdQ&IbR=Z~00CnvWdQ&IWiVv{00D3|WdQ&Ib3A1M00C}7WdQ&IX-H)O00Cr9WdQ&IY*b|d00DAZWdQ&IZ(wBs00DPqWdQ&II&5VD0RbooI&x)!00DA%WdQ&IZ-8Y100DG{WdQ&IV~k}100Cu^WdQ&IaF}HQ00DEJWdQ&IZlq-a00C*LWdQ;P4+!xGE?+t*AZd)@0ODi;25x{>Yk;t20Z3&500CsSWdQ&IY}91|00DB^WdQ*IjsgGyaOPzJ00D67WdQ&IXz*nL00A!cWdQ&IZv15d00C(NW&r>JX9#8i00DIlW&r>JY!qez00D3sW&r^J-v|H!DJEtC0Ri3!C@N-w00C|=W&r>JX*gy900Cz{W&r>Jbwp+X00C@DW&r>Ja8PCe00DPaW&r>JZ(L>p00CrTW&r>JZfIr!00C)kW&r>JcXVa}00BCBW&r~Q;0V0|vH@i;E;?|mPXHihfgtVxfM$VEW&r>JcZOyG00M7mqGkao#Q*>SWT<8V1^}Z1*aCM0ngo#uO$7h}Xt-tp00DHyW&r>LZe(<_W&zA*0nl0i00eSxX<=k!0pMi;(q;kv+W-jwo&$pgM+6=K$Oy#(00SrrL<0Z;De`6k2?3o0f(1qd9RSA&!~*{UCkjIYC1OqGzNCN-?DMDuf2?3!4h6PFlAppw=$N~ccD+)&gC{|~I00DViX8`~KVRUB!00DA(X8`~Ka)4(62>_-8iv>>vCIHX~%>oDmFbYfq00AkCX8{QTr2~ouP6Q(v00C~wX8`~KZ_sA}00C*%X8`~KblhhF00Cp-X8`~KY3OGG1pp5N-USW_*Z_7100AlVX8{EU4g=i<4G7l&bq8-@WM(L7JZAxhX94bK0d7(N0BC`N?EnA)I+#|000C|)XaN8LZ!l;900C(>XaN8LbUbJQ00Ch_XaN8La!600C)oXaN8Lb$Dn200L)lerN$m8UX4f$00C!mX#oHMb$Dq300C@%X#oHMaD-_A00DA}X#oHMZ;)vL00DHCX#oHMW1MLL00Cv9X#oHMaHwek00DEZX#oHMZnS9u00C*bX#oHMdBAA_00DHyX#oHMY0PN>00DH;X#oHMZrEu700Cv*X#oHMI^<~q00BDcX@LL%a`0&Z00D3IX#oHMbo^-n00CnHY5@QNWe92k00D3gY5@QNa};U;00C|qY5@TNPYM75DJE(G0Rc`5C@N}!00C|=Y5@QNX*g;D00Cz{Y5@QNbwp|b00C@DY5@QNa8POi00DAVY5@QNZ(M2t00DGjY5@QNV`ypt00CugY5@QNY;%ZI0pMx@00MI$P#6K`Y5@QNdGKlh00DIRY5@QNX#i^h00DFcYXJZOZVYPy00BBoNr3d(bM|Wi00C_NYXJZOZv<=s0RWf@00AiwYyklQmkB5oY=Hm)ZW?R>00C(tYykiPXDDm|00DI_YykiPY&2{E00D41YykiPZ9r@R00DAFYykiPZ%k|f00CxFYykiPb69Kv00C}ZYykiPVPtFp00DApYykiPbZ~3|00BC7YykiPI(%$_00C`+YykiPa)@jJ00D1~YykiPW|V9J00DEFYykiPZlG)d00Cj9YykiRZ((u@YysXG0jz8R0Ra~QI&M6H0R*WAb8R|ez-$3}2mwk7fkFxa00DH!YykiPW!!8500DF2YykiTb7O6CZs=?Q>ZGiv*ZVqh$00C(hZ2z0RbKXDE@7M00C|UZUF!RX$)=w00CzbZUF!Rbr@~|00C?sZUF!Ra3pR400DC;0RrL#I%4=tfi@`t00CvtZUF!RZrpAG00L!U;%))_DFFZlV`+JCXy|SMY$gG0C;>Do0ca`#0RXTA00AioZvg=TuLCFyZ-D>-ZW3<+00C(lZvg-SXCQ9@00DI-Zvg-SY%Fg900D3^Zvg-Sb2x7S00C@1Zvg-SWkhcQ00DSPZvg-SZ%}Um00DMZZvg-SI$Uo700BB;Z-D>-b7*e?00C@nZvg-SWpr-=00DSca%^w`00L!UdT;?KB>?~da)59F00Cu+Z~*`TWRP$H00C~6Z~*`UWpA8t0hlEL00BCHW`O_!cdT#$00D2ZZ~*`TWVmnv00C~kZ~*`TX~b{=01s(nVsv3;W^iP4c5-ZYYOrVl^k@Mx0|ByZ0q$%8^lbskZUICW0pK73@@@f!Zvmok0Xi%J%5VX2Edc-lI?!+d0RTh*00C|kaRC4UZy0d_00C(paRC4UbR=;B00ChtaRC4UaxifL00CzG00C(-bO8VXbU1VY00DG9bO8VXWkhrV00DDKbO8VXAW(Dx00CuIbO8VXY+Q5!00C)YbO8YXa{&MWb8d7200C}tbO8VXZ+LV800C)!bO8VXbA)sO00C)=bO8VXY>;#T00C^4bO8VXZ=7@i0RV~u00CvFbO8VXZme_x00CvPbO8VXW4Lqy0RXWB00DEvbO8VXY{+y000CvrbO8VXc+_+O00D2>bO8YX(*ytka^`da00Cv{bO8VXa`1Ek00Cw8bO8VXWc+ji00C|SbpZeYWe9Zv0RS%u00DCpbpZeYbQpC300CtlbpZeYb0l>E00DC00C&ab^!nZXTWv=00C*nb^!qaHwQ01U4Z}rbJBJJ0RWEz00D5|b^!nZaO8FY00C&~b^!nZF7S2%00D0Hb^!nZY5aBp00CzLcL4wabqIF>00MAq+I9gBcL4za76JePa2|I700D3!cL4waXef6900Ay8cL4waax`}V00Ct>cL4waazJ+h00Cu2cL4waWK4Gf00C}NcL4waWmtCs0RYJa00D4hcL4waaAcL4zb2nsLocYy!_ate3>00CtZcmV(bau|3400CtlcmV(bWF&Y200C|)cmV(bWiWUF00AyyO#uJ_WjuHR00C@5cmV(bVMurZ00Co8cmV(bE)-t@00C}VcmV(bZ(w)<00C)ccmV(bbZmG500C)ocmV(bb9i_G0RVFZ00D4>cmV(baEN#T00C%@cmV(bE|hoy00C~AcmV(bX`pxk00C#FcmV(bb*y*+00M7pes}@0cmV+bhXMcraKd;200D5ucmV(bXv}y400A!2cmV(bWY~BC00C^?cmV(ba^!dc00D36cmV(bckp-t00Ce2cmV(bZ~S-x00DFYc>w?cUkG^t00C?cc>w?cVH9}*00Cnfc>w?cZyw?ca4>lR00C$=c>w?cEw?cZ%BCo00C)Ec>w?cbX0i(00CiIc>w?cbYOV_00D1ic>w?fb8u{ORCocncmXDP0c?2z0Rc=3FLHT-00C`;c>w?ca*TNa00D23c>w?cW|(;a00DEJc>w?cZlrku00CjDc>w_ceg*&maJG2?00D5ic>w?cXux>^00Az>c>w?cZp?WB00C*zc>w?cXV`fG00DL0c>w?cY~*w_ds{k+Xd4T`{a`t%v00D3Qc>w?cbOd?<00CnPdI10dWe|D+00D3odI10da~ygB00C|ydI13d`vU+0a4vcQ00D3^dI10dXgGQS00AyOdI10dZbW(k00C)AdI10dXHa?p00DJYdI10dY+QN)00D4fdI13eLIN*ndVv4|a&CG700D1ydI10dbbNXN00CoydI10dWr%tK00C@{dI10dWt4gW00L=qD0%^!dI10dU!Zyc00DWbdI10dbg+5>00C*XdI10dbi8^200C~odI10dU(P)N00DH)dI10dWz>2B00DE_dI10dbKrUb00CdBNC5x=bL@Hn00C$6dI10dZuoiu00C+KdI10dbOd_=00DFgdjS9eWe|G-00Cd(WB~vHWE^_|00C?wdjS9eawvNN00D00RfBxFAjWx00DCpd;tIfXB>P100C|yd;tIfX()UF00DF^d;tIfbToVc00Ct>d;tIfb3l9n00Cb{d;tIfc1(N$00C}Nd;tLfeFgvla9(@?00D4fd;tIfXlQ%^00Ay;d;tIfZghMB00C)wd;tIfXMlVG00DJ|d;tIfY>a#X00D54d;tLgaRV=ye1QM~bDn$w00C^Kd;tIfWvqMw00DTid;tIfZ@7E`0RUSB00D5sd;tIfaL9ZC00C&ud;tIfF4TMh00C~=d;tIfY2bVT00C#_d;tIfb?kfr00C_Bd;tIfaQJ)y0RhPdFaCUi00DCZeE|RgXAFG-00C|ieE|RgX&8M000DF!eE|RgbR>NN00CtxeE|Rgb1;1Y00Cb%eE|RgWjuWW00C@5eE|RgX-Itm019Dab8>WdX=Qe1?sWk~b^&O10XBF6W_tmUdjZOO0a$zizI*{reE|dmXaeR2)BTdI6ex0Se;)0RrCwI&dBsflz7z00DBeeE|RgZ@_&400DHyeE|RgW6XU400CvveE|RgY}kDP00Cv*eE|dj2?s_BAp`9N00AlLeE|XjcL!q!Iw%BNfUa1800DCPeE|RgWe9!&00CzXegOahVHAD=00C|qegOahVIY110RdzQI_hbG00D9=egOahZ!~@Z00DG5egOahV?cfZ00Cu2egOaha7=yy00DDSegOahZdiT+0Rd17I(qF0g!$H1_((C2nR(9AOq|Lasyv;C}M3OX*#BT0pxuF^nHP(SO6w|0hWFNx@iFtTz~)qd1;`20eA`l00DH)egOaiX>!+{(Ddd0w1OcxEI|U{OKmjQ3fPnx3W%Pgn00DFYfdK#kbqIk000CnTfdK#kY%00C)MfdK#kXIy~+00C}dfdK#lV`WBx0ce2%00AIwfdK#kyLf>C00F{&fdK&lZU!KPfq?)4bBcih00Cu^fdK#kY?y%o00D5GfdK#kZKQz#00U)VV-$e_s(}HR2LS{Cp9N0=YX~I*00Ak!fdK>oo&`<;Y6v6(D9C|<00CysfdK*lOacJ}00DI3fdK#kZs>sl00DLGfdK#kZ}foy1p&kZ=L6{jO#%W0D6$oR0R!a&V{<6_fdK%50mv1A00DFmf&l;lZXkjI00Cttf&l;lZ7hNT00Ct(f&l;uZe(M2a&35TY;GfdM#z0k%s31OpQY6a};aC;(-2D6m5SDoy|tNq_(Wb7+DA00DA-f&l;lWrTtO00C)=f&l;lW{`pb00L=cmVyD&AprpbwgEb2icWx3L;wH*Zl;0(00D2Zf&l;lbhv^600DHqf&l;lb;N=J0|E*K2nD+VIw(d@fYwNW00Cvtf&l;lbl`#k00Cj84Ixk|b*npbtfNp~U00DV)g8={ma)^Tg00D1~g8>5oE(NIwBLe^dDVl=;0|6}ss0bnhD58Ub00CvFg8={mXS9O>00V7ubd-Yux`P4gIspO#=>S3nIxez>fb8c000C^yg8={mVcdfO00C*@g8={ma_EBr0Rh(tW$uFk0{|!igb61E00D0Ng8={mX#|7;00L)g3WNdV{s032DhE*p+6VvvDH?&VB0V)jvc!U8$tpK2e0Xka%0sxx~*g#iKpegi2400DG%g#iEoX?%qN00Clxg#iEoY>0&c00C)^g#iEoVU&dd0RZF%00DHMg#iEoWu%1x00DEVg#iEobFhU000CjPg#iEuZ)IU}X=Zskg8{&U0j7ij4ut`1g#ns{0lb9)0Rcb&I>b|e00Cv-g#iEoW9Wqe00Cj{g#iEoX7q&t00DCPg#iEoWdMc&00DFch5-NpZVZM200C(dh5-NpAQ*-L00MGz9)^0DR71X0s@Q$W(7JZkT`%SHGlvCa)5>b00Cu=h5-NpXOxBk1Of>N(g$k*r~oKodWM0Th5-NpYoLY!00CpNh5-NpVYr3?0{|=sQwH1!00Ak)h5-WsD+f{r+XyJkhJgS9aMFeW0sw#qI0^s(DddI$0s(&qHwq}~hJgS9bnu1&00D0Lh5-NpbpVF}00Loe-i84NhXDWtaBFOBzJ>u>0|9&k0St!$2LKEKR0Vkk#Rl95(gJV@00Ai|hXDrx3jtFFcm~7<+XvACZwM$jhk*bAWj==i00DGThXDWqVOWO&0sx@_Z~_1UDP)HM0s)`_ZvrT4hk*bAWN?Q800CiohXDWqZ-9pZ00LxeUWWmOhXDcr`3M0C00DHChXDct&;sBGFK%G#fSiW`019(%aA`O(Gd6T$Vuk@0hXIU-0iuTitP=pV69B#w0LT*nzUTnLyZ{0KF#r?-00Al5hXDcsFaQ$*DBy>I00Cv@hXDWqbnu4(00Ck4hXDWqZv2M<00C(NhyefrZ3u_~1OS@_O95vHAp!saDHMnS1Ob`_N&#jFAOa{Jh=BkBY$S*Q0s_beN(p2-!lM9UlYjsLWH^Wc0t0ghNeN^+bQq=pyp({Lo&W#=c}$1_00CiMhyefra%6}B00DAphyelw-v>wuWMOnV=A-~{hyg^N02Y*h00CrnhyeludgyZ`_RZfSL9Vsmd{WbTOp0Ez(?iUBl=0YZuaOo{)CX+<*8`IT6#@SU!UHb{C~aRlbj*o?=!pTw>;Qaj>cplIw%<2fN0x*00C@Diva)uZ(NH300D1eiva)vUvL`d0BDN=00Crfiva)uVR(xH00Cuwiva)ua)gTk0s?#lbObsmrWt{#7=Zu*a*&Gw00Cv5iva)uWTcA$00C^Oiva)uX|Rg{00DKjiva-!js|ISVP|3}Zg>C!c>q><0OTeCyo&)4`G5cdXL7=e0qUIq00(7xa&Ks1X|9O@vWfu?ivc)`0g8(O-iramNB{@|dM2L;*S|h9-baC4c|{Z4iwC00ChhjR61wWh9LO00D9;jR67yB?v(ZI{YVq00C__jR61wWk8Jq00DGHjR61wb4-l^00U)oc}{KtFpU9HjR67z#00toIw+Pafru)B00CuYjR61wXLOAL00CrrjR61wX@HFZ00DA_jR67xhzWlP00D54jR61waF~q&00C&8jR64$nFn7Wb7DF!(u@HLjR9DV0gR0SYAb-GjR61xWo)XA0pJ4w0|0^tItrx-00Ak`jR6Azfd@GXqzEY3je!6GWZsPd00V4gZpMuPcohKZjR6Az%>gY5egryxhkyVAWpw_H0m>->0syE3Q3L=1DHM(Y0s*H3Py{F%j)4FHWFU?K0s>M5$^m64Dvkj@4uAjwY%q=i00U!bate+CK8^uyh5!NpfCCZ&00AjdjsXGze*+N$C|Hhx00C%TjsXAxb7+nM00MPyZjJ$ny#NCPO$tH@I|*cTb8MdgM4SL*NB{rWd>jsXDxF9rYsa}JLI00D0jj{yJyWEhVD00Chhj{yJyawLxd00Cqwj{yJyVK9#Y00DJ2j{yMybO-jZ)Tp#UcaqW}N_DQu7d1_lEN>I8uRpa3QYq5vpia%OO4dXRzIW&qMw0GJm5a1sId{{R31Wq^*330st2R&jbJgWVnz400C*fkO2Sza>S4U0|(Ot&;$qyFD_?gI&fz2cY!W<0m_g8pdkTfaDgCj0dgb(00DB)kO2Y!{{*WE00AlbkO2b%`U(C7stG7M0Fi;zx_|%yWd@M}00CnbkpTb!X&jLO00DL)kpTb!WhjvW0R^Z5WnU;{Vf2sze&+xf0)Z}(0VpK_00D9|kpTb!WlWI)00CrDkpTk$_6LywlK=n#DPEBQ0|E61kN}bZC}xp?00DGtkpTb!Zg`Oa00CuwkpTb!ZiJBm00D1`kpTb!aFCG!00C{5kpTb!Z=8_<00d)VWOAaB0o()u03-m~YXATNa;T930t1x>}XIB$Lj?E-g9w`dVFCsLmjy=wV+b7r00AlVkpTb#Wnmr#0S1Tw0{~12VgdUG00Ai+k^ut&O9){B`UWT@l7RpLc`A|t00C?^k^uk#Zak6!0s@8tf&w}yK5u}=Zh!y*Wk`|%00CoGk^uk#a$J%D00DJkk^uk#Z)lPM00DDuk^uk#Wpt7O1ORCTD+CS-DgyukDS(mz1OaFTDg+G*DFY~ql7R#OYXvO?5DF{<00AkUk^uw(Y6UC=4+<*-D5#Qw00B0xk^uw&Z3Qm`5(+K@00Ak&k^uw(Yy~a^5eh8>D9n<900A=6k^uw&Zv`;~6bdi{00AlHk^uw(ZUry|6ACW_DDaYj00A`ik^uk&I59Iekdgtsk^$h70R)o)1ORabGXxe2G6MhsDIAjl1OadbG6WS0F#{+jlYs;Pa|Ja77z#8400AjFlK}()as@O57YZ{2C`6Ni00A~ilK}((bp>MJOcm$Dd3X<1Oa*lJOm#KI|C@{lYsyMH1LxF00J{M+LHnPlK}((eFZ-RA__hO00AiulmP?*d<8xPAqqVMC>WH100C?slmP$%Z!DAn00D0@lmP?)e+5AVBnm(S00AjJlmP?*eg!}TBMLtQC`gon00C!ClmP$%Zd{ZB00C)YlmP+)*#^}HIwC$00CuglmP$%XMB_a00CiwlmP$%a)^`x00MGvXp{ktlmP$%bd;0<0|M#=;sxLZIw(-pfQHn700CsAlmP$%adItajWz3WT00DH;lmP$%Y1otj00DB|lmQP6W&+s-LIn2*f(V)bU;+gJmIX!uVh9`pJ_&dSUj-;_Z#r^mb!K97XLk&effAAdLXrWzZh(4{0Sc1=rjr2#lmR%D0iKir#*_i%lmP$%Wa^Xw00(nzZf9X}W@3;5vXB8-kpb?J0Xmfd+Ry;_hX4WrKLtYxWPGmx00CuQl>q<&bZC_U00Cicl>q<&baa&g0st-vj0pe%Wq_3d00Cr%l>q<&Z;X`z00MJudX)i^l>q<&a+s9?00Cv9l>q<&bf}d900Lxlz<~g+l>q?)s0l7QJb3|ZC4m3|ZoZWP00D2xl>q<&Y0#Ac00DH?l>q<&VceAg00MMx;*|luCIA8edjx6(00AlTl>q_)dIV_%DEO6u00CzHl>q?)mIi4k2$liZ`G5ccZVr|K00?DaZ*@2^XEQ*R0ko9?=#>E)mH{rl0K&cic))}fI&d#yZ-Fvz0hoM&00DE}mH_|(Z19!=00Cw8mH_|(c>IUxH0o0ZOV3z;_mjMF+K?auqJqQ2+DH@jn0|Gz>mH<2mW++f+03w%x00M4j+ztUq+5i9nWjL1s00DGDmjM6*WNs*z0Z5kt0swUZnE(I*DOi^Q0s(XZm;fkVmw^BQWn`BD00D4rmjM9))(8LrWO|nY00CuwmjM6)bcB}y00DA}mjM6)VUU*r00DHCmjM6)bDWm}00AJPmjM6)XQ-C}00C~UmjM6+d1z^LmjO}^0koF^00M7xtPTMr+5i{;I|8Exl>!R~*an3HgaqXUMgp4x%?EM@&jwKgp$N|h)&q0~(FRikWdrX8BL+?f00Ak|mjM6+X>WDhjR5r704Uc000LoUzS;m{3;`GnIs&2vlmZF|*9L?Fg9PLSMFN@v%m;A>&IV8epa{+f)dO<|&<0WiWCQL6A_h$dX>@ZaWnyG@ZE|C9PL~0?mjTF^0R)(Vs#O3Am;sR502r77)L8&%9RNUq0HV480s}z;+6FphFA9Z#jNJfm>VN4Vm;siU0T7u10s;mETm?EWTDyQ|>3|0VQ3pE*K?gktKL^DGSOq#LE>x+2_@{sl=>Px$WHOln0RdhKI=ah%00DDUnE?O+V_ca500C)YnE?O+XlR)M00D4rnE?O-X<<&80d$!G00d=hb#fM&0VJ6LlI#F_nE?U-*$1rv00D58nE?O+aGaR|00C&CnE?X>YYA@&Z3!-ED5#kM$Xx-JBY^+`bgr2J00C&inE?O;XLD}InE@mQ0S1Er1OT-J!32{D-2eaqDcqR>1Oc=Jzyy*B+yE%%nSlTSW$c*&00C_JnE?O+X#ko500CwOngIX-Z48@&eSiP~WN4fL00CikoB;pD900CtJodEy=WC)!B00MJv=9~czodEy=WfYwO00D9yodE^_f(c^d2*cr00Cu+odE&{6axwaV>&2iX)Y3t0N8VYYI1;(UI0LJ0M6wA00DWHodEy=a?~eWnsFV0l=LB00MPl%AEliH2?wv(Fm&uIw)p7fZ#fS00DB|odEy=W$c{+00DaPodEy=Y51K100C_NodEy=VFaE500C(Vo&f*>auA*Y00Ctdo&f>^mI;svIw&$NfkZ5U00Ctpo&f*>XE2@t00Cq+o&f*>X*`|*00DABo&f>^F$xO`Iw(3qfUZ7(00DANo&f*>Wn7*C00DYpo&f*>X=t7S00C@no&f*>VRW7W00C)wo&f*>a)6!z00Cu&o&f*>bBvw=00Cu^o&f*_E^}fpWSBVt9G(G4o&hR5fta2F00C~Eo&f*>Z?v8P00DElo&f+DV_{-*WNC1BWo>nIXl8PDXKZe7YjJvNsyG2uK>=_^0pd^rnpFXkTLBnh0pMl7doBQfE&#GF0JSav2QL5%F91U?07fqWhc5uQF97^60BSG*ZZH7mFaYW>075YUMlk@BF#wh^0OT|DG5}370J1UwwlV-MGXOC&0HQMhrZWHvGyo1X0Bke>a5MmpGyttM01h<(5;XukH2{M(0EaaI&NTqiH2^a<05>)Oi#7m{HURB50P!{eMmGRTHvpqI0H-$q{WkysH~?2T09!Z!!Z-lNH~=L%04X^Dj5z?1IRN)L0Q)%rUpfF|Iske)0GT=f$2tJoIsh^|0AV`-nL7ZTI{@lC0PZ^gO*{ZmJOG9~0E#>S!aM-%JOCg)08~8yg*^beJpl4O04P2HVLkwtJ^-6O0Ovjc>plP|KLBPw0BSz~wLbv4KLGGQ0Q5fqIzRwEKmc|?0D3?Gx%k#0GvSpxj_K+K>+wc07F6mM?wIVLI9aU0M9}I(?S3iLjW2>08c{zQ$qlWLja9K0LDWA%0mDHL;wdw08K;yQA7ZZL;#UQ0P92m??eDoMF3Yt0G~ww*+l>VMgT`f0CPqFp+*4DMgRpz00~C`Kt}*XM*w_B0HH?!*+&4~M*tB>076IrZ%6>KNC4wV0Om*lAxQuwNdRR@0BK18rAYv(NdVMI0N6P03{3z>O#s480LD!K`%M58P5?np0B%kIxK04PP5|^y03uHSQBMGWPXMe>0NPIg3s3+KPykF&08mf>iBJHIPyqH&0Qyh>EKvY2Q2=sL0CrITvrz!IQ2_r@00UA0M^XSwQUH@u0GCn#+EM`CQUDuM03TBTS5p96Qvjh;0Hsp^FZQvfYg05MbmV^jcVQ~;t>0H#y`-c$hMQ~)Mb04h}gHB|smRRDTb0O?f#?NtCDRsc3u0HRg^rd9ydRsic(01;OJKvw{AR{*zH0O(f$6<7d6SO9%k0I662=U4zpSpZB~0KHiN!C3(QSpWiB07F^;M_K@cS^$Vz0K{4V$XWmhTL27O07zQ^Oj`hlTL6k%0L5DX$y)$4TmU#+0D)WppIiX-Tmbo806JX&K3xEYT>y$*0KZ)T!(9LmUH}tb07qT`OI`qgUI2t%0GVC@zg_^?UH}DO09IcBxL*LgUjPtb02E*VQD6X7U;ve10GVI_-e3UYU;rCo03TrhVPODeVF0LM0IXpE?O_1%VE{>D08L^5lwttFVgTP_01RUQJ7WNiV*v4E0QF-49b^DcWB^iR0GDI{(_{eFWB?Fl025^ZR%HNyWdN#W0Mlgv{ABEX8@UJ0G($5;%5NnX84XaL1%0Lf?o6=?t&X#i_!0B>mkglPboX#llp0Mcmy2WkLeY5-+w0IzBQvuXhOY5@Ie07`2BPHO;(YXFUF0K#hk#%lm7Yyd8709Tv)~asW|s0LF3v%5nheasU}~07Y{EadQBoa{#$>0P}MI_j3REO-EHcmQyC0Izrevv>gRcmVQv04sR_FL?lQc>r~J0MvN^*m(dedH`2?0DyV`w|W5PdH@=G07iQNaeDxudjPq60ONZAAAA5Kd;oiV0DpV{+k61ud;m6m06KjDm3;u2eE`~h0N#B75`F*`egH;(0BL>ztbPFSegO1-06l*IL4N>(e*lJm0M35^(tiL4fB*}C08fAbQ-A=6fB=ht0Kk9%#DD+`fdDLl09b(lg@FLEfdJis01ScvID!Cdf&h<#0N;WD3xfbVg8)B+0Dyx4go6OGg8;RI0ONxI=7Rtlga96d09Awlg@gdMgaFNi00xBsO@#nag#d+x0EvYFqJ;pyg#Z?Y07ixYgoXgPh5+b>02hY~0LO{|;)(zPivVwn0CS4~xr+e3ivS9Y01k`*ON;plK^Rx0GE>h)sp}!lmIT20CSW8ca#9WlmNn%011@<4V3^?l>k_k0G^cqqLl#Zl>qLQ05+BYI+g%}mH>v90LzvD&z1lcmjD@;0A7~>VwV80mjJYv0QHvu`Ii7Km;f-C0DYJMftUcam;kq!0124@4VeH%nE*(c0En3Y!od6%603)6NYMuaYo&dC-0Jxq20G|K^p8!ms08pO*n4bWgp8(;X0Og+mE1&=`pa68B0C=DP#-ISopa2V@01u%6L!kghp#YPi0GFWv%Ao+wp#UGE03)IRTcQA7q5!9&0OO(n=b``?qW~JC07#<%OQQgWqX3Gd0J)<8yrTf_qW}`507j$$Nu&UXqyUVh0O_Ov?W6!Zr2s#r0Ia0|u%!U`r2ze<08yp@Ri*%irT~bh0K%pK6sG_frvOl=092;{j;8>UrvS{S0MMrZ3a9`Mr~pT(086L0ssK2u06VGxZ>j)tssN{|0II40-KqfKssI|R03E9URjUA4s{o~|0O6|u<*NW2tN9I*gFu>ftc0HUz~&#?ggu>dNv09djBnz8`NvH0F1T(+O`1Rwg4ly04KKqXtw}tw*a8G0He16@V5Z;w*V)&04lfue7FFBxB$4g0K2#V^0)x@xBw`*04uowXt@BOxd6kt0O`2^LAn4%x&URm0Fb%>xw-)3x&RHk05`h;V7mZ{y8yJi0N%R*2)qC?yZ~Li0E)Z-x4Z!3yZ{uv06@I}ZoL4Wy#Ua?0Q|iGJiY)xz5sZ>0DQgxwY~tkz5wvP0Q9~9DZc?S07b$8dcpvG!T_kk0Ib3Q?ZN=@!T>D805HP0RF@PHpKu{#Q>?r0NKR=9mW7j#sGcB0IkLV1IGY!#{hT70E))|rN;p1#{lfd05-?~I>-Qp$N-7R0M*C<*~kDC$p9G108PmNQON+B$pD_o0PM*C@W}u$$^bOV0E5Z^hsprR$^gvD01C?h4$A;V%K%8r0F=uBn9Bgv%K!q*058k{UCaQV%mB~K00+$g3(WvU%>YTw0E5i{hs^-N%>c#C0RGJY0?q(E&HzEq0DR5>fX)EB&H%s80Qb%S`_2F~&j2{j0C3L$bk6{_&j7j40P4>G?#}=u&;TdU09()iUeExO&;XXu0Ljn*%+LS^(Eth20720JM9~0y(ExwZ0ItyhvC#nI(E#Sr04LG_LDB$n(g3W|0PE5K8q)ws(*Uv40JYNq_|pLV(*Q!$07ldRi_`#*)BwlS0L#<>0@VNp)c`lu06WzHc+~*C)d0cO01VauIMx7V)&P;#0KwJ(>(&5K*8o-50GrnUpVt87*8u3(02$Z-9oPU=*Z_jq0It{o*Vq8~*Z@7*072ORb=d%U*#MB)0LIw>-Pr*A*#Ixv05aMDmf8TC+5q9&0Oi^MBijHc+W=+T0BPF*sM`Rn+W_R-01(^&Puu`|+yJoL0NvaG3f%xW-2i&s0G-_c&)oq2-2gG(0A=0)tKIab7W0m0N?2V_2~dM>Hs?G0C(yDd+Gqj>Hx~>00HX&1?vDy>i|#d0Eg=Ui|YW(>j2N|00-;;P@-0G{js+3Wxs?EoI_08;G$RqX(a?EsGL0L$$F&+PyN?f?kx07&itOzr@P?f{JL0Kx76#qIzE?*Itz07LHpNACcR?*NkT0NU>W-tPb;@Bk?A0Ala}X7B)@@BpOn0P64n?(hI3@c<_A0AcX}k?{bO@c`xV0O|1nK=J@Y@&KOl0HX2$0`mX{^8ixw09Nw=sPh1<^8otu0RHm;QuF{;^Z=Fg0Gadv#Pk5j^Z@+y0RQv=F!cas^#Hl`0KN496ZQZX_5f1$09N(@!S(>f_5cj`05Jot`~b!L0QCF-ApHPO{Q!gg0I>Z4-u(a!{s2t=0FV9vll}n9{s7PZ015v94gUZ~{{Tz>0EPbmiT?n?{{Y7S009621pom+00Be*0e=7ig8%`$00F-M0r&s``~U$o0RcDx0eJxdeE|Wp0RgrF0qOw(?EwKI0s$og0ayY7TLJ-<0s)u;0nh>g(*gky0|7k)0c!&RnF9gJ0|Ctg0R{vC3IqX21OZG00gVI!kpuzR1OeRy0TKlP76k!X1p!_K0g?p)mIVRJ1p&_m0sRF500sdv1_3q(0jvfAum%Ax2LUn%0d@xgdItf&2LZze0R;#F2?zm92mw$C0gDI$j|c(R2m#v&0UrqgBMAX)2?1~k0jvoDun7V52?6*C0X+%-a0Ync0NDl#g4*`G=0lE(Xz7GNU4*~rT0Xh%?a1a5x5COdq0sRmG0TBUM5dmBg0do-nx)A}s5droQ0s0XEKN0~$5&?J;0elhx#1aAJ5&;7f0ZtPEQWF7~69JqP0pb$@<`V%O6agU=0a+9QT@(S96aktP0n`)$*c1U16#*9&0aFzLR}}%06#(s92@~s9067w0gW61ksJZa90AT80RbHW1RViJ9RW%m0eu|-vmF7_9RUs=0X!Z7Qyu|<9sz_N0kj?gw;loh9sw*L0bCyeUmpRV9|5Bu0rVdM_#XjYAOT_^0m~o(&maK@Apt=l0YxDJfFS{dApyQ20m2~x03rbdA^|!g0aqdcjUoZiA_4s(0TUwuPa^?SBLRsc0gWR8xFZ3)BLVay0r(>UG$a9-BmtZx0oEh|*(3oPB>_Pt0eU3?s3if`B?0Xv0Uag*ASMA@CIMe20iq@WrX~U8CIRRs0Usv;A}0Y=CjnR|0hlKNoF@U}CjsXt0U0O(9Vh`-C;?h10f;C8izorOC;{#$0rDsTH7Nl(DFJsW0edL{yeR>|DFOZ|0Rk!kMJfSFDglcs0goyH%qjuUDgpf}0Vyj1S1SR7D*>@90Rt=nH!J~SECG!y0k+8gE0ZFF#)nM0qQXU?lA!>G68Ke0dX<`r7{7jG6BFc0q!yZ88ZP%GXaV-0gf{P(=!3rGXWbk0UtC0Pc#8(Gy#S*0iiSj%rpVeGy(fG0sk}sF*N}+H34Ha0cJG;e>DNiH382x0V6g6CpH0OHUVfh0jM?stTqAhHUafE0WLQIGB*KqHvxDz0lPN=zc&E@H~|DW0bDo%U^oG`I03pi0RcGy7dZh=IRR2R0f0FHgE;}lIRVN!0pU3T1UdmZIsrX80dhJ4bvgm5IsvRY0qQyd?m7V`I{|Au0dG42wmSj3I{^ng0Si0Ox0YE^P}0nwNLjhYu0bfG_wnG8BLjmbS0UbmEAVdL&L;;IL0k%W|xkU0USjEA4LIDMFCYs0gFWek3|8*MFGe~0og?X97X{kMgd($0bxb~nMMJfMgikS0p~^mB}V}%M*(L?0c%GAsYd~=M*-tU0p~{nEJy(`NC9L>0cc18e@FqUNCDPJ0scqo@lu!Y;Pyy>u0TxjKMNt8LQ31J80p(Ev5mEs?QUPdE0hdw%#!>Spl(G0kv5H0$KqES^-m90asc9q*?)}S^@N00r*-0G+O~=TLGV20i#<1=34>kTLC6q0V!MoUR(iUTmhI|0i0X`-dq9VTmc$g0UlieTwMWRT>-0I0k2&F=3N2mT>&Is0VrMpb6x>=UIElz0oYyv4qpKhUjas60ZLy1d|v^XUjfoz0sUVAE?@y(U;$xZ0hC|?m|y|mU;*S{0W4twFku08VF7tz0o`E%;b8$qVgX5F0fJ%yhGGG;Vgb!!0ZU^6Ph$awV*%D<0ViYub7TR)WC0ju0UTukJY@lmWdXru0WW3&GiCvEW&w9*0k&oVx@H0RW&!+W0Xt^_KW71bX90m{0kLNRv}Xb7X94YJ0XAp>if93jXaUP;0ncaw4`~4tX#rSi0bFSTm1zN)X#v}50pDo>B5DC9Y5`|z0c&aj!)gJ?Y61Rg0ZnTGQELI9YXPKd0p@D~>T3ZsYymiI0ex%%fouW0YyrP)0RU|Q1Z@FKZ2?ei0flV=iERPRZ2{430R?UW32p&CZUI7W0flY>>23k-ZUHB60V;0+J#PU~Zvl#L0gi70#%}@2ZvhW*0TXZmRd4}xZ~=>O0jF>Q^KbzvaRDuH0b+3hW^nb^*F}0seLY0(SvNcL7Ux0f2V_&36IOcL5f70UCG#VR!*$cmb?<0kC)h_jm#OcmY9q0Y!NMjd=l)c>&pZ0o{24C3*oVdI4^F0djf)xOxG+dI14@0R?*jQ+okddjXhx0i1gQ(0c*XdjTMP0VI3@S9}3ld;zR{0kC`l=zIa|d;u_h0cw2#iG2aPeF5Qp0R?^mFn$4SegT?(0iAvU&3*yUegPYQ0ds!=cYgtwe*xEj0o#88A%FoTfB|NJ0cwB&v48=!fC1!y0q1}L9DxBtfdO-Y0knYu&4B?Uf&qMj0l$I)|AGNbg8`a@0p^1NG=u?zgaOcm0Um_`ZG{26g#iqP0a}IunT7%Ah5xrGj{y&m0b!5ye30T`A6Se5~smI3IN0X>%ik(UAJmjOJO0g{*j=9mF8nE`v50mzvF7McM*ngM^B0mYgD3!4E~n*p4g0p6PdBAfwcoB@xV0n?lT6`cV-odJiP0nMEO6rKTEo&lhq0qLFrHlG2qp8>X?0Un?Me4qi>paCzT0hyrz|Dge5q5;IB0o*%Ii&$Tr2&qm0g|Nw-K7EHr2!G90TiYIO{M`+rU8kj0ga{s%%%a*rU4750S~7EQKtb_rvZ_t0hOl#(x(9mr~xCW0a2&{ey9Pgr~&Gz0UD_RJE;MDsR6I40pFtN{nC0Y0n&pR56+tO3ca0sO21Ev*4wtpSp)0m7{T@~r_Pt^rrB0hO)+*RBEft^p*k0b8#Dhpz#mQu0d27Xaj^lsSu0VA>jC$a%|vH^Rt0ll&T!Lk7hvjGpY0bR2JVY30RvjMZS0SmMN53~VYv;kqX0jsnDue1RJwE+jU0cEuTX|(~-wE@+&0U5Rd9ku~^wgG*%0nfGp)3yN@w*ecs0cp1ZZMOl$w*knv0W7!yFt`DFxB-5+0m!%k%(wv?xd9)!0fD&zg}DL0xdFqu0sXlF0lEQEx&c+X0j#0mH-r`@{kM!~sXe0d>Uzq{RWJ#Q_1v0R_eZN5%n5#sP}P0glE2)y4tY#sM400UyT!ZpQ&~#{q}O0kg*e;Ku0W!(~Hp&5Q$^nMT0kX;g=gI*X%K=Wy0fx%~yUPLe%KhZx0Zq*Ths^mZU0eE;gsi~={si~={si~={si~={si~={si~={si~=`si~=`si~=`Na$Fpsi~={si~-`sHv%`si~={si~={sW?cfsW_>rsi~={si~={si~={si~={si~={si~={si`QK$S9bIsi~={si~={NSKJ|=;-L^=&7lxsaUD0si~={si~={si~=`si;Vpn5n3#si~={si~={si~={si~={si~={si~<*h?tm|=;*1bsi|0)si|1#=vb+!si~={si~={si~=`si~=`si~=`si~={si{b*si~={sYt1*I56nwsi|1l*x1;}si>{3t*xo4si>)`si~={si~={si~={si~={si~={si~={si~={NSK(ZsW>R9sW>Q@=;&DJ=;&DJSgEP0si~={si~={si~={si~-`si~<*SgEP0si~={si~={si~<*m?-F2si~={si~={si~={si~={si~={NSK)D=vb+#IH{;esi>)_u(-ImxVX5uvAMCivAMCivAMCivAMCivAMCiFesRq=&7l#t*NQ0si~={si~={sHv%`sYsZJ$jI2p$k^D}$ar|Esi~={si~={sW|B9=;&Cfsi~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={sYr+ri0J6(=;&COsi~={si~={si~={si;VpNU5o*si~={si~={si~={sYsaU=;-L^=vbJTn5n6$si~-`sHv$)=vXL-si~={NEn#tSm@~J=vauUsHv%`si~-`si~<*n5n6$si~<*m>7tNn3$=lsi~={si~={NO-BKsi~={si|10si~<*n5n5an23m&n5n6$si~-`sHv!_si~={sYvMP=;-L^SgEP0si~={si~={si~={si~={si~={si~={si~-`si~-`si~+)m?){Ksi;Wk=;-L^=;&DJSeOu)si~={si~={si~={si~={si~={si~={si~={si>)`si>)`si;V)si~-`sHv%`s7RQpsHv%`si~={si~={si~+)si~={si~={si~={si~={si~={si~={si~=`si>)_si>)_si;V)si~={si~<*=;&BjSeU7)NU5o*si~={sHv%`si~-`s7Q$D=ve6J=;-L^Scr(|si>)`si~={si~={si~={si~={si~={si~={si~=`si~=`si~=`si~=`NSK(Isi`>F*x1)`si~={si>)`si>)`si~={NSNs8SgENvn3$O8Sm@~JSgENf5UHuDsi~={si~={si~={si~={si~={si~-`sYvMP=ve5fsi~={si~={si~={si~={si~={si~={si~-`sHv!_sHv!_sHv%`sHvz(IOtfIn3$=lsi~={si~={si~={NU5nv=;-KJn5n6$si~={sYvMPSeU7)si{a)`si~={NU5o*sX&;isi~={si~={sYvMP=vbJT*x1;}czCI)IH{)`si~={si~={si~={si~={si~=`Na(4lt*xo4si{bqNa*P3SgEP0sHvz(=;-L^=;-KJsi~=`Na*NTScpi7=;&DJ=;&Cfsi~={si~={si~={si~={si~={si~={si~-`sHv!_sHv!_s7UDO=&7iwsjaQ4si~={si~={si~={sHv%`si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~<*si~=`si>)_NU5o*si~={si~<*SgEP0si~<*si~={si~={NSHXOsi~={si~={si~={si~={si~={si~={s7UDO=;-L^SeSsRsi~={si~={s7UBo7^$hLsi~={si~={si~={si~={si~={sHv$)n3#xwD5)_NU5o*si~={si~={si~={si~={si~<*7^$hLsHv$)n5n6$sHv!_sYt1*si~={si{b*si~={sYt1)si;Wk=;-L^=;&Bjh^eVasi>)`si~={si~={si~=`si~={si{b*sHv%`si~={sHv!_si~<*si~={si~={si~={si~={si~={NZ8oe$atx#si~={si~=`si~={si~={si~={si~={si{bqn60g;sHv!_si~={si~={sYvKpSeTgT=vY|T*x1)`si>)`si;U;n3$Ll=vb+!si;V)sW_>rt*x!Csi~=`NSKJ2AlTT*$k^D}*x1rsi~={si~={si~=`si~={si~={si~={NLZNY=;&COn3(A3=;-KJn5n6$si~<*si`>V=;-L^=;-KJkeKLL=vbJot*NQ0si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~<*SeTILSm@~J=;-L^Scs6Asi~={si~={si~={si~={si~={si~={si~=`si>)_si>)_si;VZsi>)`si~={si~={si{bK=;*1bsi{clScpiesW_O}$av`J=;*1bsi~=`si~={si;_&0Sh`hL3LzlZ#p_cb!KK|asVx1Y%XYYZEPcFVPa-CIXGcqFk&${FlJ*oVq#%3I5#pkI5}crVly;3WtRa9IyymhWNB|YI#X|Ta${uxEn#dfXmo9CBWGbSV`DQgVL4$oGB7qaW-~HmGc#p5Hf1w8V>U2kGh$|!0Sh3)yC6YzWNB{zEn#dfXmo9CCjc`QIy!f9X>?^tI4EgubU0shEFfcVZgX@XV`yP=Dk%UXVKZiBHaRskHZn3}HfA(6VPZHiG&wReGG;k4Hexe1GXnrs6DI&O7CJh2a%psBNijAkX>N2eHeYlsAY*TCb95kMXkl_HDF7p3H8?amWoBbGVqr67VKgu}F*7zaIb=CCH#RXgW@0g81prkPCjc`RIy!f9X>?^tGcqV?Zgev;Uvw-WV{dMAbRc7BVR9-d03%^AG&f>6IXO5qW;bCtVPaunG-Ek6FkxjhGhs9~H!(H`096zx05cXkI(KqubY)34G$?6qbT%|!bSxlaZ*FsRAY*7@aw;hRBVjNzGBGzbH!?S5HeoX`GB-6eW@ck%Vq#`9H8VLlF=hz>RTL)xGZs2JcXDZTWmPyRb!l#NIA3%uAY*TCb95kMXkl_HDF7p3VK8K6GcjW_HZo)~F)=e{GdD3eGdN~pVKFshGc#dj3jkFVCjc`SIy!f9X>?^(F*Yc5X>N2eHeYlsAY*TCb95kMXkl_HDF7p3WH2~2Win?^(GcqW3X>N2gGGBBoAY*TCb95kMXkl_HDF7p3H)c3CW@cnHH)CRCWi&8lHDod{H8f&0W-~W6H#TH24**paCjc`SIy!f9X>?^(HZ&-8X>N2jG+%TqAY*TCb95kMXkl_HDF7p3H)3L8Gd3|eG-5Y5GGaDmWiVqlIWRFbFkvt?Fk~?^qGcqVDqjI59RjWHdB0IWb~3WH)7EVrDisV>LD~Vqs(z096ww05cOhI(KqubY((sZ)_-HZ*OcYAY*TCb95kMXkl_HDF7p3G%__|IAk_AWnnZqFg0a1F*7t_W;A6mIbkt3WMnmA7XVceCjc`VIy!f9X>?^%baH8KXDDNDZgX@XV`yP=Dl8ylZ*FsRAY*7@aw;hRBVjjWVm2`}F*9Z|WnnfpFfuVSWi~QoF=93}H#0dnIWrjmRTw7#GYvXAVr6G(Zck!rWn*+GV{dMAbRc7BVR9-d03%^BIWaLYIXGoDI5s#rGBP${HDxnqGd5*0W;bFvFg0Ww096Yo05bwQI%RHTPhx6iV{|Af03%^AVKZVhVq`R7H#TH7HfAz8HZd_|GBaUhV`VaCG%zw9097XdGa5QNVr6G(Zb5Q#VRkWH~r6G&o^2HD)qoH(@zqI5{yjI5%WuVq#?<096<#05bwQI%RHTL2`0oc_=9WBVlD>GcjdhVPrL7HZ(CaH)UaAIWS^2W;HW0VmUW6IW{2xRVM&58ag^+WoKz_L}_DmX>V>}a(O6obYwa@b7^{IUvw-WV{dMAbRc7BVR9-d03%^zFk>)fWM(#DHD+OEWi?@8HDY5pIW{+AWivG~I50OO096<#05bwQI%RHTL}_DmX>V>}a(O5z03%^FG&V9fI5uT9WHmK6GB`71F*z_cGGaF}Vl_EoW@RuX09Abm06IEQVPk7yXJv8#V{Bn_b7OU4Z*yNUUom5Ea%EpJUom81bYWjHUomNIaBN>OUolW&V{2h&WpXZPbZu-Y05Cc_ZEs|0W@%+|a{wb@HDzNtGGaC}G-Y8jHf1q6VKy~0W;iirG&E!}H8*B8^aKDpI!$k6X=Z6n|X=Z6U#Z*pv8CM+OiVRT_SIzw-6bY*ySDk%Uhb!jeWbZu-SXJKPzFkv-0Gi5SnH!w9hVlXi_WnnO5H8C?ZVlyx@HfAaSHX)Y*3oSZ2RdZ!>AW3d?WpZX=V`VxzWn^h|S8sA`WGH20b2>U#Z*pv8CM+OiVRT_SIzw-6bY*ySDl8ymVRT_SIzw-6bY*ySDk%Uhb!jeWbZu-SXJIinH#IRcGBPq`Wo0)pFk&+^F*0OjW?^GuH8nA2G-50OHY=9_3k*6sRdZ!>AW3d?WpZX=V`VxzX>MtBX<=+>dSxhSZ#p_xX>Me1cPRiZb!jeWbZu-SXJKMwWo9&FWo0xrWo0)tI5jpgIW}ZtGB;r{Vqs)BH8m~(HVT&k3j#ViRdZ!>AW3d?WpZX=V`VxzbY*gFX>MV3Whf~CEp=%wXmo9CBWGb|IAvrxH#lTBH8^50HZx{sH#azDHZ@~oH#RY0IWsaa05+Ea3j#ViRdZ!>AW3d?WpZX=V`VxzVr6G(ZboupZDlAa04;TCE@*UZY$Io3Ffe2?WiVl6V>L1~HDNb1G&43aVm4(pW;JGFHfCWqG5|K00Sg#9I#qLJav(`=bY*g8VPj=FI%RHTMsi_oWhi5BZgX@XXKXq;Msi_oWny(^W@U0FDF7{XX)b7VZEPcFVK8H2F=J+CWHDwpWn*MyVqrHhGdE*4WM(*KW-?(jGc*7;7MB4F7&Wkq&nZgePPZ*FsRAZc$pI#+3KWN&vxc4cmKCMf_db!jeWbZu-SXJIojW@KY!VPZ9AI506}VK!qiI5sh5H)T0uI5}oDWj8heHWrrw3o1G~RdZ!>AW3d?WpZX=V`Vxzb7*gOP+?MmGDF7{XX)b7VZEPcFVL4-CI59F~Gcq}4VPY_3WM(iiF*al{IW#n6W;tasHaGw_D3<{XBsw}(b7gWMNp5sya%N#;WjZ=#WNCCzVPk7yXJsg4VRT_SI#6L_Yhh<)CM+OhZ*FsRAaitNIy!T7a%pa7CMf_db!jeWbZu-SXJI%wFf?LgIW}WuGG=BlHDzWtIXGrGIAt(oF)%kWIWRf^HX@e+3m!T;RdZ!>AW3d?WpZX=V`Vxzb7*gOC}VGKb95k7CM+OhZ*FsRAaitNIy!T7a%pa7CMf_db!jeWbZu-SXJI!nW-u@|V=-kgVKOsfGBjp3V=`ekV`DNhHD+TtIAS~iHXN4$3m7^&RdZ!>AW3d?WpZX=V`VxzWn^h|C{!jaAY*TCb95kcbYwa@b98cPZf7Pb04;TCE@*UZY$Io3H)LcmVl^-^Vl-uDH!wCcGh;VqGdVChIAk?7HDqNmJ^(frmjMeP!n+_G1Uol@XNpxj$VRUbDE@*UZY~%n32s%1RZAW!!AZc!NWoL3>bZKvHIyz}>XLV^%Y;|X8ZYV=_VsCRMDFA70XLV^UaBOvFX>KlPbZu-SXJKVFH8(dgIb>osVP;}CWiw(lVP<4CG&nRjI5}c5IW$55I|k$c2Oz?`AW3aUb!i}JZggd5a$$67Z*Bl-ZD)09EpTjgXK8LOXmo9CVE`i&Iyz)!b7gXAVQgu7Whg{tb7gXAVQgu7WpXAgAXFwP03%^CH#jz8I5J{6V>dN0VL4+rG+}0DH8MCgHDWd}H8nUz07VgD03#DRI%H*YWpZg@Y-xIBC`4s*WpZg@Y-xIBawaSwR3<3^BVlA=H)S|vGdMFbIc7LDW?^GFIAJ$9G&D72HDfnoI59^6MG;{DBP}{QWMy+@a%o{~X?kTSL}hbja%o{~X?kUHCM+OxbYwa@c4cF9Z*n|hZ*OcqIy!P?W@U0^ZewLB03%^$WMMTpV=*x|VlgseFfcYUF*ai|Ffn0aGchwXH8eL#07WZd03#qeI%H*YWpZg@Y-xIBC`4s*WpZg@Y-xIBawaSwb97`nI(B7abZ>GzR6Zst03%^$G&o^1W@a-oVKz2mVK+57IAJw1H(_BhV>vN1I5Ra%07V{Q03#|oI%H*YWpZg@Y-xIBC`4s*WpZg@Y-xIBawaSwb97`nI(2Sua%5$4Wn^D%VQ@T4EFe}sCMf_TVK-(rIW=T7VK-tiIWsjiVPiKmHf1q1F=jF_H92NCHBA6TC}992Av!u_Wpib6X<=+>dSxg?Wpib6X<=+>dS!AZEFg1qWI8%J|-yuBVlG_WMML7IWsvhI59C~VqrHqGh{b4F=S>iGh;P4Fl0{vMIT`RBPlvMaA9(DWl=&Xb97`nI(B7abZ>GzQ9?~&baH8UJ|-+6ZDnn5a(OyBQ*?4=VQnTU03%^yG&3_~F<~@eV>mTAWnyAvW@0yEHZ*2AH#0OiGd4I;07WNZ03#$iI&)=mX<=+>dSxh6WpZg@Y-xIBawaSwV{dMAbRbkFEFfcVZgX@XV`yP=Dk%UXVL4%BV>n?nG+{9@GBjgmVrDruHDh6AW;8TpG&wjjV^aV{B4Gd{Bsw~CWpZg@Y-xIBC{tx}X<=+>dS!AZEFfcVZgX@XR3dSxh6WpZg@Y-xIBawaSwb97`nI(B7abZ>GzVsCG3J~}#MZ*FsRUvgz;WpZV1V`VJjfTk$`BVl1OIb}39GcaU1WHvN3Gd4LhV>mQ0IW#e4W;8J|Ff>;HMKfUlBP}{Qb7gXAVQgu7Whhf+a%o{~X?kUHCM+OhXkl_7V{dMAbRZ}uDO*lmEFfcVZgX@XV`yP=Dk%UXVP-RBG&MJ2HZWv3F*Gz~V>f0vH8(V7F=1w6G%`0fWLW@3D`5a5F*-VPWpZg@Y-xIBC{tx}X<=+>dS!AZEFfcVZgX@Xb97`nI(B7abZ>GzR6ZswAY*TCb95kMXkl_HDF7p3H)b?uGd4D6G&Ey1VK!rBIb~&KW-v5kVP!IAHZwLcTL48bVE`jFIy!S@a%o{~X?kTSQ)O~#VQgu7WpXAgAY*TCb95kcbYwa@b#8BRWMy(?WM6Gza6C&aAXYvmEFfcV;((?p03%^AG+{O~Gi5R|Wi?}BH8o{oVmUK5G-WelGi5k6Wj8Th07Wxl03$LwI&)=mX<=+>dSxh6WpZg@Y-xIBawaSwV{dMAbRctdWI8%J|-+6V{dMAbRc7BVR9-d03%^yVr61DGB#yqV>M-BI5;^uH#RmfVKHW5F)%b?Gi5bj07Wn%0TwzsWMOn+0ADd*F=SzMVJ>KNZEWob054&4b7gdME@*IY0AX`;Wps02IB0NiE@*UZY-9i-Iyy#ga&2LB03%^EWH>M}V>K}~HDO~nVm32oW@0imVl-u8WMeWgF=8_z0TwzsVQc_jF<&uZY%XYYZER`+055ZCZE$R5crIvgZ~$d)XK8L_UovTKV{CO~WnVI5bz*OGUovHGXK8L_UovBFY;0+BX>V?GUovBFY;0*{WpZ<0GIMEdaBO9GUpQ!Ra4u+cZEPV11TS-AWo~5vGdN{AW@0clG&M9dFgP}3Gc`FhWj8QkG%;p2Vlp*1E@*UZY;OQ63OYJva$$32D0OLWbTcwvbSVHMVKy)`I5aRgF*!FjWn?pAWHU5kGch+XVlp{6Fk~??HfI1#2yXx?AUZm5VPk73b!l#NGcsRvEFffIbYVI=LvL<$Wq5QdDIjBSZgX@1BVl4>HZ^29V`DgDWH4niGBPzYIAJk2Vq{`vFk>?_VPk0kOdf9lDlj@ab#8EBV{0gNX>N2gGGBBoAY*TCb95kNVRT_SI#6L_Yhh<)CM+OiVRT_SIzw-6bY*ySDk%UXVKp>mG&eRjIWjY3He_TmV`MisVmD`~VP|CkV{Bn_b7OU4Z*yNUUom5Ea%EpJUomB4b6+uEF-cQ&Z*pO0WiDuRZEXDk054`~Y-L|_d2@7SZ7yhVZ~$g$Y-L|xb9r-gWo=(LXmD^YXmo9CAqE65V{dG1X>)0BZgT)+VmLN8FfwH^GdD40H#IdlWMVTmIXPrxGdDOkVKFo=Xmo9Cd;l#vI(2hpb3<=!ZDDR?a{wb@WH~WmG&VCcHfCcrI5%N3FfnB|Heq68WjAJJV`gMAd;l#vI(2hpb60P2Y-9iN3G&3?~VKy^0F*Gt`VSE5BIy!P?b8mHWV`XzvWnp9hBVjRRIc7F8Ff}wWGc`FdVrDpIH8^55W@ceFI5aahGcMwmIbkv~GBz|hVKRIGEjl`5Z*6dIZe?zCb5dntWB?;!HZe6fVKp@|F*Z3lVm4%AWn*JBWMwruW;HWmGh{M2d;l#vI%98baBps9Zgg{3a%psQWo`f?VPs`DWi?`EG&o@~I50FfFg7?bIASp}W;kJGH#IgiWqbfF2s%1;VQgt+C@COgZ*FsR03%^IFf?N|VPi8iIXE{mV`gSCV>V(nIAdcqV`DTqVqr6Q08a*d04*6hI%98baA9<5Vr*q7V{dMAbRbiCb97~GNp5CuCMh6eZ*FsR03%^AH8(LdVly;jFk>(UD~W;QrEVPrUAW;rxwGG=3BW@2SyHDon5F=l-LQ3j0wFCRKOVPs?|MQ(Iyba^ZwLvL+xZ*FC7bX0k8Wpf}VCLk^@E-3&bVPrNlVK!!BGBz+}G&DFfHezOFF*!6eF=94mIbvcnGk*Y49gP4l2s%1)Wo>VEWhg~%bZK;XDF7p3H90Y1Ff?OhH!(D2W-vH4I5TB1W@BbGHexYmHaKQ5fdEkkjQ}qfIyz%=Wnpw>C_`^;aBps9Zgf<6aAk8KCMF;*E-onmBVjmZIbt<8V`DNjHDzHlGcjZ|WH>iAWHL8oGBr46Ghu@OQ5B50W|RO_6{-L-2s%1vWpqhIC@COgZ*FsR03%^!Fk~?|Ib}CFH!)&jVKikhVK6piIXNN2gGGBBoAXF&;BVjo-Hf3cpFgY@0WHLEsH#askFf=qUI5}f9Vq`F8VKtrrR12yAG7366a%F9Ac4a7aX>N2gGGBBl03%^IGBIUlG-NO|Vq{@uWny7wV>dQtH!?XgGBzVEWkGCgD0OLWbTcwvbSVHMVPQFCV`gMGGB;x}GGS&iGht+5WMeflW->8kF=An6WTXI82&w=wEjl`IVPk73b!l#NGcsRvEFg1qWI8%?X?kT}bSxlbVRT_SIzw-6bY*ySDk&giZ*FsR03%^BVP!R9I5syjVlXyhG-fqrVP!HfIb&rpIW{?EHDoxZ08}fg05UZ?I(2SvVPk73b!l#NGcsRvEFg1qWI8%?X?kT}bSxlaZ*FsRAY@^5VLCccVPk7yXJsZVAY@^5;((?p03%^DIXN;jGB!A5HZo&mGB-0aGd5;5F)=t|FfchVV>CIa08}%W0RTEWLvL+xZ*FC7bWLGyVP|D>0Ap-nb8};LVsCR_F<&ubZ*pZ{F<&udV{>0IUok^(ZE$aHWo~p$VQyh(WpXZPbZu;W0|YN+ZggpMd0%O6b8uy2bZ>G1WH4c4GB7YRVKZYfIb$+0WH(`AH)dusW-vBpVr649E@*UZZ0!gDFJf|OWM^eAXmD@mW8IX5+9WH&N0V>vi8HD+aFH#TLp04oPNI&*MnWpZUGW^8X^bSVHMVK!tmG%zq>FfnC0Ha0dlG-fzAHDfb2I5;z6W@cnEWw8KF1+@Sx2s%1wWoc(`3eIzwS_b9HQG0CRM5bz^j6bz*OGUol@XV{dY0Uol@XXJv0~Uol@XLt$`pb!=rWXmo9CQ33!jVr+F~aB^vGbS`LcZ~$U#b!BjJX>N31IB0NiE@*UZY`Fj_3OYJOWny(_C}VGKb95k7CMf_TVPs=uFf=hVWin$pVP!EkIAu37Wi??oVKibhH)A$qX14%K2w?yKIyyvUVs&Q#b98cbV{~J6VsCR_F<&ubZ*pZ{F<&ucVRT_%F<&u6Wny(_E@*UZY`g$1Iy!W6VQzC~Z*pw_BVjQyW;0_qV`4R7F=RJ2GGa1fHZx{sVmCQtWHe?tFf_aXEjl`LXkl<=03%^GW;bRwWo9ulIW=Q3H#cH6FkxmfVrFGIWoBe%G%#f51^_xbLt$`pb!=rrZ)|L7WMy&yb98cbV{~J6VsCR_F<&udZf9w3WnVF0F+*W+b9HQGLvL(sX=G(`E@*UZY}o)T0y;WWd2nS-VQ?rZ03%^FV`5=qG+{O{WnnO6Wj8rtH#ssiWivE0Gh$<8V`5>w08ZHeEDJh1RC#b^O<`~-RC#b^O<`~*CMf_TVP!BdI50J2W;Hl6Vl!i6Gh<<9G%#a0G&eOgGdMM3WWNAT3E2QF6goO{WppTWbYwa@ba`-PUukY+Wq2$gRw)1@VKp&kFkv`1V=!hiV>4ngGGb;mGc+_cVKikjHZ@@~Il%x<64?MO5jr|ybSQIlWI8%@d2nT4X>Md?cqsrQVPr8jF)}k^F*Y(bH)S(9W-&K0W;Qr6Wi&ElVKZc9WWxYX55oX17a(JAZgX@1VP<47W;kMIG-G5mW@R~LHeoS2VKOi>GG#erW@2PB#Q;tf*#Im9Iy!S@bSPFS03%^FIb<|BG-YHlGC4A0Wj16nG-6_5IW{>sH!)>5WMgH=08Rnf04xGJI$?AuDF7p3V>dT2WjHuEW@KbJH8nOjVKF#lWivBmIALL8Ffe90$pB8t04@k1V{dMAbO2>!F=jO|G-Wb1Vq`EdIb&fpH!wFdI5A^5IAt<3W;V+JP6pWkECM<@V{Bz%awsVPBVjNzIAJnjH8){lWHL8nIWjggW;A3tFg0a2W-?-7WM<6(PT2q~5jr|$a$$32D06gVIy!WDaAjXAIAl07HexnnI5s(BF=8<=WHUB4IA$?pHZ?hA(Ev`_04xYPI&*1yWhf~iV{dMAbO0k^VmLN9VPY{eFgY|~V`O7BG&o{6G&VRhWHn=EGh<{n(*RBe*#ImEIyz!yXK8LIDIjBSZgX@1BVjZ#VmW1FI51&1V>M-FVm4%EW-wwlF*0O1W@0yHV=~nMP6pWkEC@O}Wo~3BDIjBSZgX@1BVl7PW@a>DV`efkGi5k1FlJ>pWn(d8F*##oH8VJ3G&9!#P6l5I06IEUd2nS-VQ>IrY+-YAV|8M0b6+uEF=KCXWnVF0F>PgSZ*qBGF<&uMd2nS-VQ?;JbZuGG${pW-&Km+yF~2-~cH#Iy!SVAc{(~%bmD-fDF7p3H8M9dGh<<5G-PHsHa0XiG&f~4HezHnG%;g1WM(oo-T+H8<^}*dIznk~VRCswa%p5|WdLJrVRLh1bz*OGUol@XWo~C_Ze?FFUok>yZeenHLUL(jXJsyEbZuKlPbZu-SXJI#GG&3<|WHm8jWHvK2V>2~nF*Gw`H8El^F*h_bH8J4;Ne2A|2Oz?`AVG6;Wpp5AcyMfQa%FM=VRLh3bS-6gaBOdKWpXWaZ*OcZaBOvFX>KlPbZu-!Zf9w3WdLV#Z*_2AUuAA*X>MgMXmo9C=>RG^Iz?@8ba?f1HGc!43V>dWrHextrH8nJ2GwA>-Iyz%-Y;SS^BVjjUIb=C7IWuK2V>2}|FgQ6mVPj@xGBPt{FfubZVPWY2Di=CBb7^g9Y+-U~ba^OaZ*FsRAWdO(WpZg@Y$honV{dMAbO0k^F*r6eW-~J~W@a&DFf%eXWjAIpH!(OeWi~isF*z|a=KxF<1_S^)I!$48WpZg@Yyfj~a&=>LV|8M0b6+uEF=KCXWnVF0F=uRFF<&uFVRU73X<=+GXmo9C?f^wPI#q6KZf|#P0AV;dF*q|~IW#t7V>MdKmH)ZYsMLIfFZftL1WMyOkVPQ34Wil{fVK-)EVKri8GdN;qFl1w8IXGoDHDY8kWbOb(Iyy{mVPt7;X8>U_HezOCW;tUtHZnIhGGk^jV`5=6F*7t}V>L5lH83>p07W`FOmAUiWn=(hH#0afWHdN8WHC56G&N!~H#syiGBYwYV=!SiHaKK97Xc$WI#YCEbait8BVjdSHDP3AWMVa8Gc`9hHf1(4F*9anF=JvhVPs-uIW`voBLX@)L349ubaN;v03%^zG&N>sHZVA2F*i9eH!?XnFfuY_H(_BjG-We5GGaLI07Vx8BM&+{L349ubaNx7EHDhHoWnyAvVPRorVmUH6V`O7vVl*&hV>U5n@c=~)7Xc#*Iyymfb7gdMC_!^`Wpr~UCMf_TVKQbjG-WkmVL4?qHf1tpGBGe^W;8H1Vlp{qIb$|6X7d0=2p0h(GCDePWoKz~bY*fva%p5|Whi5BZgX@Xb97`nI&*Y#X>MmGEFg1qWI8%?Xkl_?WM6P}ay&tEb7gcwa%p5|Wj-kYBVjmVWMwlsVKrtlVKq50VmUWqW;JAFIXPiDF*P_jWjFNzMKBiuBLX@)V{Bz%Zgp@dDF7p3VL3KAVL4$jWMnX7GdN;lW;ii3I5ab2W@R)oIAvxr_W(r~0V5JRI&5!YWKCssVJLHSWI8%?baH8KXJ2+{Wp^n6BVlDWG%+_eVPZ8nF*rA4H)CWtVr6AEF=jY7F*Y$cWi$BzMGzMOBM>?|Y;R#?C_!#{L349ubSWTXZ*FsR03%^#Gd5;pW-(@BF<~?`V>35lG%z${Ghtz3G&5l}V>Dv>07VWL0V5YWI&)!mWld#tVJKs7ZgX@XL2h|Lb8}^MCMh6eZ*FsR03%^GWHezmGBIIeHDP68Vlg%{Fk)mfV`F4vVlg&1HaIZ-07VrS0V5YWI&)!mWhi5BZgX@XL2h|Lb8}^MCMh6eZ*FsR03%^$VL3N4GiGKpVKX#jGBY+ZHDowAW?^MwVq#-5H8(c@07VrS0V5YWI&x)UWKCssVJKs7ZgX@XL2h|Lb8}^MCMh6eZ*FsR03%^zI5Ie7V_{}vIXGl6VP$1yGBaf~GBG)2HaBK9V=*}a0Yw!T0V5GQI(KqubY)FtbYUoCZ*FsRAVF??|a%Ev;C_!^`Wpq4LJ}Dq$Z*FsR03%^BH8D12IALKpWH&K5G-hOGVq-RDH#227V`DZlHDYB20YwfM0V4`JI(KqubY&<(b8}^MJXAg@03%^zVl**fWH~Z6H#0anGc++YGBr0aHZn0YV>C82WMpOs0YwNG0V5YWI&*YkbaitmV{dMAbRa=)c|mh?WppMfAY*TCb94YBVP<7zFl07jFf(ChVlZN3VKZehG-hToF*ssnW;9_pHwghn6&C>`5jr|`aAaY0Whg;zc|mh?WppMfAY*TCb94YBVKO*jH(_LEVlZJhF)?LhGh<^lVKXo}Vl_E8Ff%Y>VG9984;KL=5jr|)Zgyd8X=Gt^Whi5BZgX@XL2h|Lb8}^MCMf_TVPZFAV`gSEI5J{kVPi04I51%|WHvc6GdVIhH#IOZVGRLA4;KL=13Efma%Ew3WhhiB03%^!V`gJ9IXN{jV>M+oHaBEqWiUB6FfutcHfA2~kVPa)AGGSsfHeoq4H8NslH90V1IAsw5MGF@JBM3S=Y-w|JL2PU&DIjBSZgX@1BVjl>Ib$?rFgZ6lW?^J9FgG?fWH@0kFl99~Gd46iV>A;1MFtlEBNsY4ba`-PC}VGKb95jmE4F*g+fMHQ(A9diJ4E@*UZY;gbpFJWO~VlHTKZ~$RpVq#x7XmD^YXmo9CP6hxkbZByAVPs!$Z*OcaXmD@Mn8Iyz-;c2i|^bZKs9b5Lw`XK8LILv>Mn80Cp{NWps3DZfA2XaBOvFX>KlPbZu;y0UbIzX>D+90ADd*F==gZY%XYYZEWNK2M9VkMrmwiAaiAObZKs9b2>U^X>4UvWps3DZfA2)Y;|X8ZYV=_VsCRMDF9|^Y-KHTWps3DZfA2XaBOvFX>KlPbZu-SXJKMAHDok7V`VTjV=-noVlg;3VP-jIVKHGbWH)3qIA$IJLk8pk2Oz?`AVz6yWgv59baZKMXLA5%X>4UJb7gdNX>Mn8EpTjgXK8LOXmo9C?+6Y$I%98gWdL6>Uom5Ea%C=PbZu-m2LLZ)Z*X~EaA9+EE@*IY0Ap`(d0$^}VRLg|IB0NiE@*UZY$X9ZIyz-;baH8Ba{wb@GiG5qH)Jt4W@0ciW-w-EGGsDgG%+?aGiG5mV=`l5B>_7+I%RHja(P2LV|8M0b6+uEF=KCXWnVF0F==mKF<&uKWpinIWkq&nZgehabZu-x0Wc*xI#6$ObWn0{V`X!5X>MmiY;SLEC}VGOWjZ=%Y&tqpWo~3;aztfzX=7z3EFfoWZ8|!2c4cESDF7p3V=`i6IWuK2HaKK6WHT^0V_{=qGh#3`VliPhG-Nn2ECEs@LIE%}Iyz8qb97L0Z)0V1b7^j8LTqnuZ75@Ja%DO?XKXq;Qe|#rWpYGic4=c}CM+OlY;8I^b#`TAGAtlQ_xrYQg;VL31~GcqwVF=IDnF=R1iIb<|AWHe)DWnyA9W@R#EG%f*BGeQ9{2s%1vWpq?%a%FR9Z){{JDIjBSZgX@1BVjZ(W@0rnVrDZjV`XDAW;r!wWI1IuG&DCjVL3EqWiv1VQU*c+FbFz2XJvF#Z)S8Wo~n6ba^OdY;R$7DF7p3Wi>KmVrDTpGh=08VPs=AVmUE2GcYqTGc{&qVKQZ6IssAzLIE%WIyz@%Ze?;|bY)a!cyx7gWpgMg03%^#IXN(4I50G0H)J_xH8(S4VPZ2hFf}(~GdX2pWi~TB0a8K%Fbq06a%FRAdSxhQY;8I^b#`TAGARHfVK!tnG&N>6G+{MlW@ch!IW}TtH#s?GFfutgVl+5pH$DMU3PJ%eJ32aLcx7XCbY&=WbYwa@ZDDXcP;YZ|P;zf$Wpi_BZf8kuaCLMnAY*TGWjZ=%Y&tqrWq5RTa%D2&fTk%RV{dMAbO0k^W-?MmiY;SLE0Ap-nb8};LVsCR_F<&udZf9w3WnVF0F;H)FbWn0{V`X!5X>MmiY;SLEE@*UZY*Y#@NMUnm0ADd*F+*W)WNBn!bY)0kb7(GTbZu->0WBjsI!0-1Wm9x=Wnpb7MrmwiIyy*UZe(m_EFeZ{Y-Kt+PjF>!O>bmnEFe@SCMf_TVPZ2jVK!trWH>c5H#0anGcYn_W@2SFF)%S^VKXu^WJCc^AyNS?6goO`Wnp9}c5i89Dl8y#bYwa@b7^{IUvwz|BVjQ(WHLE9WjQrvI5lHoGC4M4GGa7jWi~TrGiG8nVKznqPZClAEgCvHcXDZTWhi5BZgX@Xc5i89Dl8y#bYwa@b7^{IUvwz|BVjdSWo9rjF=RA1F*s&5HZU<|IWRG0Vqr2dG&D3eV`fMJPZ&}GEeJX~bY*O8C@COgZ*FsR03%^$H)1ejVKFjfIc8)uGBz?|F*Rm3Wo0&GVmV?rH8?g(0Z#@}0WBXoI&)=ZYbbDZa%5>{W?ytHAZ=xBZ*qA$I#Xq3Yfo}%XK8LJ03%^zWi&W8FgQ3eHZWs3WHMnnGcz+~GB9OgWMernW-?<;0Z$!L0WAnRI%RKWC@COgZ*FsR03%^JH)1n5Gh|~oWHB;jI5jpiF=1h4Gc;l|FgRf`F*P?%0Z#@}0WAnRI&fuWYbYroV{dMAbO0k^Ha28AIc7O9W;tOpV>dKmH8wFeV=**gVrFDGVKXu~PytT{nFk_MbaG{3Z2(hra%Ev{E@*UZY-RueFJf|OWM^eAXmD@8La{ym4UomuVZ)|feXmo9CRslIWI$?8jWpn@|VP-ivF)%e@VK-tmGi5h3V`eflVl-knH8C(SW;0_lHdFxsIyymfb7gc>Wo%_*bY)~kc4cmK0CRM5bz^j6bz*OGUol@XWo~C_Ze?FFUomuVZ)|g4F<&u3b8}^MQ)O&rV{~O?MRsLwbS`LgZER}+GAcScQ*>c&WMOh-L2_egX?A5OV{dMAbRctdWI8%#X>4V4d2@7SZ8|z|VRUFFEFfZUZ)_|eVsCG3DF7p3VlXr_FfuVWHD+QtV=-lBG%;pjV`gPEW@a{KV>mf6R{>NgYXLGPIyz%=Wnpw>D06gVIy!S{dSzd9EFg1qWI8%?baH8KXJ2+{Wp^wfVsCG3DF7p3G&VChWHvK1V`VciV=`i7Gh=2lFl9F~GcsjkHa0n7SpifdYXLG1Iyz)!b98cVc_?#qWI8%?X?kT}bSVHMVPrREVPR%vIXN;nWi~Q6HDP5pW-~BiVKHPlH!?XjHCq8x3u^%~6FNF>VQpn7b97`nI&*1yWnXkDAY*TCb94YBVKZVkHaRq8HaTWtV>dQ9GC4LmVl`qkH83=0G-NqAVO;@K5o-Z56FNF%X>w&_bZ>HbD06gVIy!S{dSzd9DIjBSZgX@1BVjaQVq`QkW->NpFkxmkIWRe4IAl3xVmL50VrDoqWiwv^R1s?dG6*_4a%Ev;Pi|~^C@COgZ*FsR03%^EHDX~nWI1JFH8nP4G%+(bH8x~1IAb|vGGQ|_H)b(m0aONS0WuRhI&fifWo~pRb97`nI&*1yWnXkDAY*TCb94YBVP!QqWn*J7HDx(tWo0m8H)JqkIW%E6Vlg&3Ff=h{Fk=B!5o-Z56FNF`X<}??Zf7WSbYwa@b7^{IUvw!TV{dMAbO0k^I5IFYF=8=cHDon8F*#v3WMnunH!);2IX5ykGBq_eWdT$XYXLG7Iyz%$X>4RDb97`nI&*1yWnXkDAY*TCb94YBVK+B4IW;#qHf3dEFgP}1VKHK5V`4QnWi&E3VK6XdFlPZ&5o-Z5D>^!FaAj^Nb97`nI&*1yWnXkGAVz6yWjZ=YVQyq>Wh@{@X>4UWI!|zAZcT4wWhnq7VPs-4W@9rqI5uQBV>vi8IWT21HZWo{Hf3gIHZnLiIB5Y?DPaHrIyzHyVQyq$a%4erV`yo1WdLJrVRLh1bz*OGUol@XV{dY0Uol@XWMOn+Uol@XQ*>c&WMOh-L2_egX?A5UXmo9CTm=9xa%FC0WpZC+Wp-&}WiDuNZ~$^;Ze(S0UteTpc4=c}UpQ!Ra4u+cZER5j055lMa%^NSXmD@c;Wkh9jV*qn>a&=>LV|8M0b6+uEF=KCXWnVF0F=uRFF<&u6WpH$8Q*>o+V`*$tbYXO5L}hbhE@*UZY~%n32s%1LZ)|L7b7^mGb2>U>Z)|L7b7^mGb5Lw`XK8LILv>)0BZgVYgY;|X8ZZ2qaZEPcFVL4$nWi~l5F*r3aFl9AlH8Wx{Wiw)0BZgT)*Z)|L7b7^mGb1iUeb!TaAE@*UZY<2-O0y;WpWpq?|aAhbd03%^FGBh_cIWS^lHDNPkH)dflFfnE^Vq#`7Fl9J7GB9Lx0ak$q06IETXklb!a#M6+XJr6mY+-YAV|8M0b6+uEF=KCXWnVF0F=uRFF<&uhZE$Q~F<&uLXklb!a#M6+XJsyEbZu;x0T2Q@I%#fcbZKF1X?kT$Z)ay^awsVPBWGb^GBY?ZF)}kWVmM}IF=b;nFf}kXFf%!0H)LZpH8Wv%0W+5Y5CS?nWNC9@Vr*qhZ)ay|Zf7Vd03&B%FlI72H)1w8WHmW9Wie!AVr4O8GGk_CVKX#2F*!G5c>yy+RYFfwUrbL&Ura?-MN9x^a&L8TUteQya%C=PbZu-SXJKM9Fkv|}G%`3gG&eLeW@R^KFgRl}Wny75VK+H8VrF{*6JJzPK|@6VGGRAiVrDflG&o~7WjSIpWo0-yW;S7BWH323WM(#HdjS()L`6bXM*uW2F*IRgV>K~1G-fhoHZ(UiGBIQ|GBaUjIb>ruHZ^+z6JJSAMo$1SVq`WoG-YKoIAdlpGBag1Ha9tBVPh~gH)At7VKZcV0TW+WK~hctV_`92IW{z8F*PwWFg0d5VP!HkVl!f8Gh<^pF*GLQhj)Nlr#jC@wB8DFA13Z*_2AUt@1_WiDuRZEPcFVPQ34GcqzVW;if4Gc+|eGGS(AIAt<8WH2x>IXN_BG=~8*0|i4>LQhj)S3y!vC@wB8DFA13Z*_2AUt@1_WiDuRZEPcFVK6ylWnyMBI5=ZCWH~ltF=IA1HZfvmFg7(|G-NknG>HK-0|i4>LQhj)MN(2vQYbDiE-3(Ka&L8TUteQya%C=PbZu-SXJIlqV_{}7F*s&5FgRv4H!w6aF)}$bIXPowVq-XAVK<8bGXn)fRYFfwUqez!R7pcYOeiicE-3(Ka&L8TUteQya%C=PbZu-SXJIorH)1ejFkxdkVKFpfWjJJFI5#z8H)J(qIW#jiWH5~ZGXn)fRYFfwUq(SmOeiicE-3(Ka&L8TUteQya%C=PbZu-SXJIijG-PICW-()BV`VX9Fk&?_Wj8Q0F)%VRW;tYKGc=C@GXn)fRYFfwUsX<0ML|PIK|)MLC@wB8DFA13Z*_2AUt@1_WiDuRZEPcFVKp^3W@9yCGB;v0W@0#EH)Ak4GBIT}H#aaeW-w%BHjx1{0}De{LQhj)K~qyjQdB5oZ*F8PATBO0DFA13Z*_2AUt@1_WiDuRZEPcFVK6mhG+|{mWHd8mVL4%8FkxY2Wie%9I5K59VPa!pGm`-`2@6A2LQhj)L`6bXM_)lxQ$|zZ*pZWXmo9CBWGbYFf?K{VPR!CWH>f7WM*VHVl`oAWnyAuIWaV5HaRwx0W%3hZ*pY-XL4_Ka9>|zZ*pZWXmo9CApsUTI%Q*X0ADd*F=bHkF=jC|GBz|ZF*RajIAdcoWiT`_G%z$ZW1Im?Bd`G}6*@XXVRL0tWo~3;a%FNTV{dMAbRa@ub7fLxZe(S0WpXAd03%^BVm38lV=yo_VmW1HVKHPkWnnfjIAvlmW@IrqIbkuL0ZS9G0Vx+cI(2YtZ((F8V{dMAbRc7Ia%DO?XKXq;M{;RoCMf_TVPZKmWnp75Fg9XhV=**2GGS$5HDX~hWM(okF=jY7H=qGa6|ey*8ag_2Wpq$sY-MzGWhi5BZgX@XV{dY0Iyz@;Iyz8cY-MzGWhN;ABVjQ!GBz@0I5;>sV_`WrHZ*28Vr4coI5=W3VPs`DG%=z9OBk>LDGWL~a%FRAdSxhQY;8I^b#`TAGARHfVPZKqF=b|AVr5}7G&eOgVKO&0Gi5npGGQ?^VK_K9Go%4a3a|kw2s%1*X?kTSDIjBSZgX@1BVji+WivN2H8Er`F=AmgWiex8IAvxxIb}0rF=9C~V>YG%O9rq3DK$Dea%FC0WpXHEZ*FsRAY*TGWjZ=%Y&tqaVQpn{VJ0jfV{dMAbRbe?Ze(S0WpYMxVQpn5EFfayfTk$`BVjmWHa1~0H)LWlW;HoBVP#@CIWRe6FfukZH#IXeGdHLKOEa(mDFQk=aBy=dDF7p3G%;ggGc+(UVP#`BIbvlvV>vW3I5s(BW@cqGHaIaissT%|0VxbRI&W@LWpinIWhiHCZ8|!2c4cESDF7p3G-fq2HDfkoH8wJ2GG#S0Ib&jBIWS^0WMN}uG-fh5tN}|3umLGGIy!G|Qe|#rWpXHEZ*FsRAY*TGWjZ=%Y&tqaVQpn{VJ0jfV{dMAbRbe?Ze(S0WpYMxVQpn5EFfdzfTk$`BVl1MVrDmDI5uTAHaIk5V`XDBVPa%CG&wjiWMVXBIW(>TOEcyM06IECVRL0tWo~3;a%FM=V{Bn_b7OU4Z*yNUUomBFXK8L_Uol@XLSb`dQe|#rWpZV5E@*UZY)lFOFK};jX>@6CZZ2qWZ~$;`b7^#GZ*E^WXmD^YXmo9CAqE65cWG{9Z+8GPVKZhjFf=qaWH~ZpVlZMeI5cE1V`emFG-NV1WHvA^Xmo9CmjMepI!SJDb#x$MZe$>Db#!obbUHdqWqANCX>TrQbZu-SXJIsBGB9FcWoBbJVKz26IA$?7W->T4Vl`o5GB+|aG%=R}3pzSUZg6#UAYpD~Aa8YaaCLM#I!$k6X=Z6TrQbZu-SXJKSHVq!LBWH2!~WMnxwG-f$8Wn*PCI5uT7F=jM0IWx8a6*@XeZgyd8X=DIrVKX!}Wi&HnW;Zf4H8eOgVL38oWHU51WH&ftGc+({HDNSjVq!REIW{+BVK!tjVKy-^H90n9H!?LhF*iA5GGdnj3pzSUZg6#UAYpD~Aa8YaaCLM#I!$kNb7ewxbaZcS04-^6E@*UZY$Io3Gc+}2G&5voH!?IeG&nP1IWlErGc+}1H#lQ6G%#c}mjMepI!SJDb#x$MZe$>Db#!obbUHdsZ*_BJL3n9%04-^6E@*UZY$Io3WH>NoW??d8V>vfDG&wglVK!wpWiT-{F*G?eV`VZny8#tCIz(k=VRdYD0B2z~VL34{I5lE0Gh{YmIW}ZuW-~ToFk)djVL4%CH#lNpH(@b3GB9K|F)=kZVPa!2HDNX|F*7w`WoBhKVq-Qpy8#tCI!te4Yh`2rXJIyBIWaIeHDWL`WHw?sHe_UGGd5x{VqrO9IbmftIAURBFlI7kH8VFhGC4S7I5;piHZ?FeH)1t5HD+dHH)LeH0TntrNNHqbWo`gxVK!koF)%naVlXpgHexw8WMpPDHexVhVL4$rVP!WsVqrI7V`OGHHDfk8V`DR8H8U_ZG&MG1GC4CfGBh(dHf5Iq3pzSUZg6#UAYpD~Aa8YaaCLM#I!$kNb7fO>VRU5xEopBqXmo9CBWGbYVL34{I5lE0Gh{YmIW}ZuW-~ToFk)djVL4%CH#lOw0TxAeWo~o;V=^>0WH326WMefjIA&%wF)?LiI5{ynV>U5iHeoa{mjMepI!SJDb#x$MZe$>Db#!obbUHd$X>Me1cK|JEZ!TzbZEPcFVPaxtFf=)0F*ap1IW;$9G-P5iIbvdEI5s&sWMMZkIhO$o3pzSUZg6#UAYpD~Aa8YaaCLM#I&E)cX=Z6Z)9m^X=QSADF7{LZ!TzbZEPcFVPau9H#K25GBsg2GGSt7G&eJ5Wo9&CI5ILfH)doxFunmc36}v26goOdZg6#UAYpD~Aa8YaaCLM#I&*Y#X>Mm!Z%uDxX=Z6TrQbZu-SXJKMvFk~?~W@0pBI5ssoHDNe2V=`f4HDxwpWMnutW@EqsHWHTs3k5nlNp5g;bRc1FWFT*KbZ~WaIy!4*c~oyxbaH8KXDCZ$c_{!bX>TrQbZu-SXJIxuH#cQ6WMg44Gd40fVmD$pWHvHmH)AtpWH@9rHZj5hHUpOd3lus!Np5g;bRc1FWFT*KbZ~WaIy!T7a%pa7RBuaVc_?FVZgX@Xb97`nI&*Y#X>MmGDF7{LZ!TzbZEPcFVK6ghG&E#oG&5s0VKrlBW-u^0Gc-A5GG${oV>L5oIm7`r5|;rBCptPwZg6#UAYpD~Aa8YaaCLM#I&W}gZdYk;WN&vUV{dMAbRctdWI8%?baH8KXC^ElV{dMAbRcJJZ8|z>c4cESCMf_dX>TrQbZu-SXJIg5GB`IeFga#9V`4WrW@a&CIW=ZEF=1n2Fg0amGG@jBHYJw<3n0R~AW3d;b#x$MZe$>Db#!obbO0@BZ!TzbZEVc}N;*1YZ*6d4a%BJ`VP!aBIW%TBV_{@7IWjY2W@TnGIW=TAW@KS7I59XgW6c3dIyz=yX>0%^VP-NnWjSMGIWuE1GB{&nVPP~gIAvpEG%;l`G&wLhIL!e{Iy!J+b8`SAVP!KjIAvxxV`DXBH#a#rV_{)1VmUHoG-PEsW@KhCG0g!=Iyz)!aCB%!VQFjtBVjT%HDfh6Ff=zdH8f&oH#A~mIb|_5GBqMdFXKXq;Q(2H#cE2HfA$4Vq#-7IWlH6HZo;2F=J-X0bLFJ0Xq*mI$~*VWGH8BIyzKkcyx7gWimu503%^!I51>mVmUN0HZ^20VPP{iIbt|wG+|;jH8Wx`F*!HV0bLFJ0Xq~rI$~*VWGH8BIyzKkcyx7gWimuTa&lpLDF7p3VKp`|W-u@{Vlgl?G&VS4GBG$aFflMOHZw6}Vl^~1)B#-*`~f=;Iyz!$Ze%EDY&tqrWq5RTa%D3_DF7p3Wiv2kIA&yJW;ro4Wi??oH(@nmV`O4sFflo0IAUR9)&X4&`~f=+Iyz!$Ze%EDY&tqabz)^rVQ?t`BVji%Wnp1rIW=NqV>o6xGBi0dW;JFsWi&BjFflb`W@Fd^T?_mHI}$oNVrgzuL5c~l<6goO$X>MdFXKXq;LvL<#bYX6ELUm?lWpXJ1BVlA^GC5;6I51^qHa1~mVK-%EF=k~kG&wP4H8LN2ZAVFheWpi^W03%^$V`4aFVKibeFk@t4V>C1{Gh{VpVlrYlGG;P1WjJNt0bLsW0XqviI&)=oLvL<#bYX6EC}(VKIy!b`V=^fKBVjc)G%{l~WHwL2mVl!l6IWlEqG&4ChI51>0G%`6dX5s-|3H$*&3pzS;WpqPtZgX^DZgePTY;8I^c4cEUDF7p3Wi&H1Fk)gkG-G2pF*!FdIWjP0GGb;nV`VgEWH~Z9c4cESDF7p3G%__|H)dmEI51;1IAUfwVL3HoG%{s4VKp}~Hf1$2<^f#_`~f=*Iy!S@bVF}$b97;DbSP(RZ8|z>c4cETDF7p3G-5MiG%+`1IWS@|Wo2SFGdMIjVl^{lIb&onGh{P4=mA{{`~f=*Iy!S@bVF}$b97;DbSP(RZ8|z>c4cEUDF7p3I50IcGcYkXVq-WnF*RmkIWRG0I5lB8I5jY3Vq;}C>H%E}`~f=*Iy!S@bVF}$b97;DbSP(RZ8|!2c4cESDF7p3HZ?OhW-?=BFk@jhW->51WHB%{WHn+qG%zzZIW{pe>;YX0`~f=*Iy!S@bVF}$b97;DbSP(RZ8|!2c4cETDF7p3Wn*SCIW;z7IAtosG&5vo?g3p2`~f=*Iy!S@bVF}$b97;DbSP(RZ8|!2c4cEUDF7p3HDYCCVmB}~W;8HiG&410I5c87W-?|pIX5{oW;8fA@Bv*4`~f=)Iy!S@bVF}$b97;DbSP(RZ8|z_VRSSp03%^FWnyMCF=aD3Gd474HDon8W;8ZAIWRD0F=ID1F*7&v0bL3F0XqjeI&)=oLvL<#bYX6EC}wPLVRR_~BVjmWFfuhbH!)^6Ght&eF=AvhWHB{jW@BVzWH2~pFgf%AT?PCBI|VvAb7gcxZ*FsRVQzFNX>N2W03%^$I5A^3HZd|dHe@wrF*P$}Heoe1V`E`uI5uHnHfA#R0bK+90Xq&lI&)=oLvL<#bYX6ED0OagX=iR_WFTp7bSVHMVKrrDH(@e2W;8fBV>D)BV>V?uHDhBrVPR!8Wiv4`WcUGH4EzB*8ag_0b!BpSLvL<#bYX6ELUm?lWpYz=a&=>Lb#i4WLvL<#bYX6ELUm?lWpYz=a&=>Lb#i4YDF7p3WjHrBVq!TrVK6m0WI1IuH#aacHeqIEH8D9fVrDou`T<=Sfd&9NI#Xz2WMy(fX>Md`Zf8($X>N1?V{Bn_b7OU4Z*yNUUom5Ea%EpJUomHFUol@XX>D+9Uol@XQ)ppiWpYAkZe(e0XHaixZgehabZu-h3Is1^a{xCvW;8G|W@KbHVq#)3WH&QrIc8)rVPQBmW;QW6WMM97bZu-yZ*FvQX<~JBX>V>IXLV_0Wo&6~Wpe;yZ*FvQX<~JBX>V>WXmo9Cd;E@*IY0Cr_#Ute={Z*pO0WnVaGaBwbYbZu-E0wxbSI%#fcbSP3~Ze(S0L}hkqV`U~O03%^!G+{Y2WivT6IWl54G%+_YWI19mH8nOiV=yu{V`MT10!R%N0wyRrI%INTcS3J?C}(AFZ8|zaZ+I*qXKZacI&EQeG%O%zY;8I^c4cETEFflVZ((#P03%^$W;bMGH#25AVKZemVl!nmVKZVkIAUWrIWc8rW@a`C0!Stm0wyRrI%INTcUNh0WkPRwC}(AFZ8|zaZ+I*qXKZacI&EQeG%O%zY;8I^c4cETEFflVZ((#P03%^!HZo&kVK+25H#jw8W-~KpV=!W4W;Z!8Wo2eEGBjfg0!Stm0wyFnI%INTcT;d^WpZUGXKZacI(B7aGb|uxY;R$7EFflVZ((#SAZKiCIy!b`V>2lLBVjQxH#RdlWjQf4F)?K^IWsk7Ib$+pG-6~pVl*&jWikx{NFo&iCL}sKWO8A5S7~x(Q*dZya%CuIY;8I^c4cETEFflVZ((#SAZBcDVRS4YXKZacI(B7aGbsQgVKg{0IX7fuW?^JxFl9J6F=b?CH8Es2IAmovWHd82GYMV3Whf~CBVl1?IAu6vI5lQBH#lKoV`4NhW@KYBH)J?CGcjQ`GB6VYNCpG|IyyvUVs&Q#V{Bn_b7OU4Z*yNUUom5Ea%EpJUomHFUol@XL}g-iXD(=TZEOe%055W7Ze(S0WpXZPaBu)}Wo~3;a%FN~IB0NiE@*UZY)=LNIyzEiZe(S0WpYPyX=DInY+-YAV|8M0b6+uEF=cLNX>Mg-F<&uhZE$Q~F<&uKWo~3;a%FNya%p5PXmo9CC;~GLIyzHyVQyq$a%59rF=Aq4H)J?sHZn9hGh;brF*jpkG%+{W?ytHAX8;!Yfo}%XK8LJ03%^!GBjZ}F=J&gH)LfpW-w!7WM*SBGi5k5H)dovGczzE0#y|#0y79YI%RKWC@COgZ*FsR03%^AH8nXoGdDG1F=1h1GBY$|W;QlrHDqEqI5##oFkxdP0#ybm0y79YI&fuWYbYroV{dMAbO0k^G-ES1IA&&KHDhBqV=!f8HaIaiGi5emVq{}tGiEVnCIVFkUkLy@I#YCEZe(F{WK(oc&WMOh-Q*?4=VQnsGbZu-m2LLZ^VQyh(WpXZPaBu)^VQyh(WpZCQXmD^YXmo9CFajt#I%aQnSpXwpFfwE^GG=07HDhHoHfA(rHDNL^H8x>mI5A~nI5IXkFajt#I(klJVR8T?VPr64Gch@4V=yyeFfn9hGc`CcGC5{8WHvZ7G&f~tHZTGxIy!nrVR8T?VKFdeVKy~1HDNF~VK+86Ghs0{Wi&A}VKikpG&D6ZH827wIy!b~Wp@B0VP#`6W-%}_I5=WqV=*)`W-w(lFl071GGjM0W@I@yG%W%vaBp&SP;YZ-bZKvH05&#cHaKE9HZ(9}IXE>lV_`8eI503XV>LK6He+QnEdnZVZ*p`~X?kS3Fl01lF=Aq4G-YFAHDNeoHaBKwF*sy1IWlHr1_S^)IzwS?WpZHvb98cbV{~J6VsCR_F<&ubZ*pZ{F<&ufY+o^7F+*W(WpZIIXmo9CP6hxkb7gdNX>Mn8E@*IY0CQz@bZKs9b6+@UaBwbYbZu;E0st>!Z+I?faBu)+Zf9w3WnVIBZewh9WMyA6V|8M0b6+xLZf9w3WnVI5Z)|L7b7^mGb6+xJZ)|L7WMy)5Uov8EcwabZaBwbYbZu-=0st>%c4cmKUw3k8bY*fbXmD@U2iH!w6ZHUdltJ_0HNIy!J~a40DNBVl4c4GBssoGGZ|}Gh;MkW@0d9H!?M1Fg7(bF*!T}Oa@^906IEDZ*FvDcys_`Y+-YAV|8M0b6+uEF=KCXWnVF0F=SzMVP7#{F+*=|bY*ySE@*UZY(N4=Iy!A>a7<-(Wo!T=VP-HnG%#T>WH~rBI5uTrIc79uVPiQtHZWo|VL4?vGNS}6Iyy#jVQpn%b!KK|a#Ue*XJvE%Uol@XMsi_oWny(^W@U0zVRC0>bS`LgZEPU{7CJg-Wp8Z&Uol@XXJv0~E@*UZY@sCb7gF0V{~tF05dl;GdMXnV_`QlH)b(rVK_H8GiEa~IW{#lVPa%9H!f&&ZEQyZFA+LAS8{1|Wm08xZ*_8GWhhs2X>?^$Wpi(Ja${vCCMf_TVPZ95H8NplGBjf~F=96{HfAwqGB9E@IWlB0F<~+>G(!SW4@Uwo2s%1vWppShAY*TCb94YBVKFr`GBz`1GiEe2GBh_fHf3csV>C81IXO6DWMVToV?_c{21*4YQe|^*b#h~608(XhZ*_8GWiDuRZEObz4Isk1AWUy(XK8L{04;29XJ=_{XD(=TZER`+054-V?GUovBFY;0*{WpZ<0GGk$Ib9HQGUpQ!Ra4u+cZEQ;dD>^!5ZggpMX=QT&BVjo?He)ztG&VFdH!?RlGh;Y4HZeFcVmM?pHD+NoF=gfk06IEBV{~bDWkX?YWpZJ20CRM5bz^j6bz*OGUol@XWo~C_Ze?FFUok;rbZK^FLt$-Ya$$2WXmo9CPy#VJI%RBSZDnqBLvM9%bO0k^W;tbJWnwZmI5Rn6IAvrxWjAJFIW#b4HDNh0F)(2>Py#VJI%RBSZDnqBa{wb@H)c06H!(ReV>C2lFf?K}H#9k7G-5eqGdVapVL38kPy#VJI%0KZW@U1703%^xVPs}FH8?ggG&3_ZH#j&qV`DftHaKE8HfA(AWj13_0x>!|b7)~?WpYqyaAj<1Ze;)?VKrnhVq-QmIX5w3F<~=gGc_J%V*o*Na$$KyWpiULXmo9CP6h-oWn*&yVm4%9VL3T4VmLWAV=`kfV>L4|GBz|aH)S+rIX5_DE@*UZY+eE=0y;WLZg6#UL1T1jZ*C|l03%^JGGt?AHexw9HZV6gFk)dbH8MG4Ha9gnH83V>Qb97`nI(B7abZ>Gzb97`nI&fiWay(;ia%DO?X>U3@OJ#X1AY*TGWjZ=(Z#p_n;((?p03%^GHD)q1HZo;nG&4D2GGsC|WMninIb~)zF)=u1FflV!0!lMj0xAd~V{dMAbO1AAGBh(|F=ID1WjSSHV=^@}V=*%^HDzKrWjQlpW;IphV{dMAbO0k^F=04kH8nUjWnp78W;rxvF)}%0Hf3WmWi&Z9W->B3S^`Q2UIHivIy!K2Wpi_7WGG^9Z)_<5BVlDUF*RW_W@KYDGGRA3W@0&GV=y=|FgP?}IW=Z9Ffd#KN(3Yb9YJGsX>V=-L1T1jZ*DGVbZu;A001v@V`Xk-E@*IY0CQtyZe?FMXmD^YXmo9CW&$P(IyzEiVPq&{Z*FsRAXFwP03%^FH)CRBGh{VoF)%V=F*h+{W@9loH8o;3H!?UeF=1t30!RpE0wxGLI&W}ga$$6DaxFe6DIjBSZgX@1BVjTzW;Zx9F*G?jG%{v5FfwH_Vq`QkG&E*2HeoboG-6@`NCsvCCI~t@Z*XODVRUbDDkv!+V{dMAbO0k^GB7q`HDon1FlI4hIb>onH)1$7Vm32lHZeIjF*#;rWCBPAm;nGfI#Oj}WB_AqVRLh1bz*OGUol@XV{dY0Uol@XWn*(+F<&uKWnpA4Xmo9CjRF8Kb98cLVQnsGaBu)~baG{3ZC^NOaBwbYbZu;I1_&U+yC6kwXK8L_04-&1XK8L_E@*UZY#{~&FKKRYb#wqYWi@6vG-NU`VliQ1I5}fEG%+?XG&V71H#lW7He)m{Xmo9CaR3A_V{dG1X=G(`a{x18GB!74Vqs!8IW##iHexV2Ff}-2VPP^jGh#DlWo0gCbZu;D0st>zcxiJkXmD@5H8C_dH83}2GB-4B0#7q{0xcIhI(2YtZ((F8V{dMAbRc7Ia%DO?XKXq;M{;RoCMf_TVP!ZnWnwciGcaRiI5sdaWMnonFk)daVKp;mW;0eA-6?XzH8ag_2Wpq$sY-MzGWhi5BZgX@XV{dY0Iyz@;Iyz8cY-MzGWhN;ABVl4@FgRs1WMVR8H)3HiWMXA9Vlp%~I5jmkWn*PGFl2E8PZ)OsEetw3Z*Ed$b7^{IC}(VKIy!ZBWn(fa03%^BGB;*4F=k~qV>LBpVlZVmIAt<0WMO1wH!?C|W@Bb^0#6Ee0xdNdZ5VK6r}W->NpGBss6H+2F}Gv)>WIyyvUW@U16Wn@xiZe(S0WpV&xY+-YAV|8M0b6+uEF=cLNX>Mg-F<&u6WoBh^a%E&vWo~3;a%FNZXmo9CfdV)>I#hXZWdI{#W??sFH8NvmW@BSxGchCBoVP$4HHZVA3VtWEw27v-NAUZl`Wpra`C|7TCY-A=ZAVY6$ZDDR?LUm?lWpXAgAX9WCE@0$Lt{0yqddI$?5WC{%fHWhN#m03%^yWHK}`Gc+_gIA%0uHe)e2He@woG-WtsIbvjDGdDMX0$K(g0RTEWQ+acAWo<@fbYo~`asYF5a&=>LV|8M0b6+uEF=KCXWnVF0F=bD+9Uol@XQ+acAWo<@fbYo~`axQ3eZES`DE)Y68Qe|OeQe|^*b#h~6C{kr%WKv~wZ*_8GWhN#m03%^HH!@>mVPQ36IW;#pI59OeIb|_4H!xx_Ibkw5IAb<~0#FWy0xk$TI%j2cC@COgZ*FsR03%^BWoBhCGcsdhGc;mlWHC57F*ju~H8VIlF*7h`VPj&10#F8K0wGdmb8mHWV`TtRWpi(Ja${vKXmo9CObP%mY;R*>Y+rP5Uw3bEY-BEIaBu)@Z)0I>Ute@@Utf1`a%^N@IB0NiE@*UZY~%n32s%1bV`Xk-Iy!S>Wo~6qY;|X8ZYV=_VsCRMDFAb0Wo~6HaBOvFX>KlPbZu-SXJKM6GGs6~F*9Z{G-NnrG&g2sW@0unGcq(YWjHuCGBk(+I|k$c2Oz?`AX8&yZe;*-V`Xk-EpTjgXK8LOXmo9CQ33!jb9r-gWo<5KaBu)~d2@7SZC^NOaBwbYbZu-Q1_UoMOQXmD^YXmo9C2nql%aBOvFX>KlPaBu)}Wo~3;a%FN~GH`5lXK8LmQ2F*G?jHZ)-|F=jY7IW;vkH)3UGWi~Q3WjQo4kOEN(paL%rIyzT!X>?^rbzyR3C|7c6bY(|%VRB?9CMf_TVKFmiIXF2mF=Jw4GB`6eW@b5LFf=nWV=`kgW@I-uWRe0=44?up0y;WpWppSh03%^$IWssgVPi04W-?_sG-YFCWHVzjH)CdEIXN&lVl_FG0#Tp>F9JF`Z*XODVRUbDDkv!cBVjl=Vlgx}Vq!L7IW;q5F*0RhF*Gz~Vqs!pFgG+}IWd+3QJ?}Z0y;WxaAk5~bZ>GkJ}4;wBVlDWHDWPlF=04kH#lK4Wi(=BVr4gFW-wtlIc7CDVKtZnQIrBP2q0r`ZgX@1Fl8}iFgay8W@RyEHDfe0W-&B1W;iuvG&x~mWi?}DngUS?^rbzyR30Ap-nb8};LVsCR_F<&ubZ*pZ{F<&ulWo>VAd0#PKF;{YFbY(|%VRB?HXmo9CrvfcHI%HvVVE`jxGdE>sGdVIaGBq=1WH&J}Vqr5iWMVKjG&C|WVmD=GrvfcHI&EoiOl5XuY(sB#Zgc=6VL4+kWMnfjH)c69IX5vkHDhHnH8C(aWMySIWi@3sFsA}7Iy!f0WOQf%BVl1>F*IT}Gd5y4WMpJHWHx4GI59M3Vl_ErH85i}IXR~SEjl`AWoc(mKlV`XA6GGbw5F*YzUVmCKAW2XWwIyz==a&2LB03%^!IWRalF=jbpW@KeIHaIppG%_<}IX7i9H(_NpF)}v>1OPfZLv>VAc{(~%baG{3Z6+)rVsCG3EFfZUZ)_<5BVjT$Wi~K2He@$AGB-CfW-?)6H)A<4F*sylGB#ynVP&WSR2$9$G8H;HcXDZTWl1N2lUvw-WV{dMAbRc7BVR9-d03%^CH8Wx|WidA}Ff}tZVmCH3Fl8_?Gc#l`HZ@`}HDYF}0#p;u0x}jlI(KqubY)2~HYjOsbTKwxbSxlaZ*FsRAY*7@aw;hRBVjpWVKFmgGcq|eVrDTnFf%qWIASs}G-f$7V`VupVl%7)R20qvG8Q^IcXDZTWl1wKC~0nVGcsRvEFfcVZgX@XV`yP=Dk%UXVKHGbIX5{mH#lZ6H!w9ZH8(e8H#B24I5{yhH928rG_C?v6wU%N7CJh2a%psBNj5YnX>N2jG+%TqAY*TCb95kMXkl_HDF7p3V`5=pVl!bmH8VIlG+{AjHa9k6FgY?aIXE|EHaKN8umV&R&H^$PIy!f9X>?^(I4E^#ZgeVMzhWo9&CGBGnYIAl0wF*rA4G%z=0F<~+=F)%s00#p*t0x}gkI(KqubY(_1G$>?mbz*E~EFfcVZgX@XV`yP=Dk%UXVPa!4W@0sFW-u@@VKrkjFfceWFfe5}VlrZ8G&yB3IlKZ?6V3uM6FNF~a%psBLT_(uC}MAKY%CySZ*FsRAY*7@aw;hRBVjc+V`MTiI5=T6Gh{I|HfCgDG&E*oGc`D3HZ?UeWn#VpR1wYsG8#HMcXDZTWm9x=X>MmIV{dMAbRc7BVR9-gAY*TCb95kMXkl_HDF7p3H)LgIIA%FDG%ztYWHmQ4VK`x7IXPi9I5aU~WH&H0zyeel&H^$GIyz!yXK8LvVrpe$bSPtQZgX@XV`yP=Dk%UXVKz2qGdE>5V_`94GBjdhF*IQ^H#svmVl^}|H#RvmWWoYe3(f*E0y;WnZe&klYGq?|C@BCVVL4_uFgP(aFk)t6HDftrG%__bGGS$9F=jP6Ha282V#ESe&H^$TIyz!yXK8Lha&lpLD06gVIy!S{dSzd9EFfcVZgX@XV`yP=Dk%UXVL4%BIbu0xIWT22G&W{sVPj=7HD)(sW@a!kGcz?|HO2x|7|sGR0y;WnZe&4na$$KWDF7p3W@I&HIbt?4Fk>`1FgRmnGht;mWHB=|HZx>lFgZD8$O2T(0x}vpI$~vKX>LSmV{~b6ZeenHD06gVIy!S{dSzd9EFfcVZgX@XV`yP=Dk%UXVK6gdWi~T8Gh;SkG&5mkGh$^qWHUK4GBGh>G&x~rIm!Z57|sGR0y;WnZe&DhV{~b6ZeenHC@BCVVKXu|F*spjVPZ2hV>edS!AhXmo9CO$GojaBOvFX>KlPaBu*0Z*OdKUovxLbaZKMXLDa)X>N0HWn*-2a$hoVY;|X8ZeKWPaBwbYbZu-Q0Twzsb!h-!F<&utX)b7VZEV#7H8naqb#P>1bY&=WbYwa@b7^{IUvw-Wb97`nI&*1yWnXkGAaitNIy!S{dSzd9EFg1qWI8%?X?kVifTk$`BVl1VV>e}EW@a^IW;A6qG-Nd}I51@}H#25sF)%VQVl>eLS2NWDH3B+1XJu|>a$$63O=)m#VQ_OODF7p3F*7-4V>vlAFfcb|WMeUAH8U_cVP<1BGGaJ6F*#u}(*jpl1uH>va$$J@L2`0oc`j&lZEW2FFFHD8VRT^tBVji%F=I42VmCErVq#%tV`XGyVKF#0W-(d$sc4cfsZ*^{T03%^#Gh<;jVPLKoHa0RfH)J_7GBjdlFfuUR0xvo`b#q~7WdI{#Wi~c6W@a@uG&W*3IAJn5GdD9cVlXfV=-X>Md?crIvkZETDJ055QCb!TaAE@*IY0A+4=Ute=&baZKMXLDaNaBOvFX>MOQXmD^YXmo9C2?H}1IyypWZeenHQ)O~#VQgu7WpXHOWo>VAc{(~%baG{3Z6+)rVsCG3DF7p3GB`IiWM(&FW@9okH#cKqIAb(6Ibt_4Wo0xqH#Rjl;{sI`2?H|~Iy!f9X>?^tI4EgubU0shEFfcVZgX@XV`yP=Dk%UXVKO#0VKp~5V>LB7HZfs0WimN3F*7n@VPR%CW;tbMWaR=?6A1$|7CJh2a%psBNijAkX>N2eHeYlsAY*TCb95kMXkl_HDF7p3Vq`HfWo9-wH8f;4Gcq$|F*9Q|W;bFsV=^}|Wj0|j=K@s}2?H}0Iy!f9X>?^tGcqV?Zgev;Uvw-WV{dMAbRc7BVR9-d03%^EH8?ppWH(`9I5;slHD)$BHf1q6VmUcAGB7w~V`DPu0#y_V12YynI(KqubY)34G$?6qbT%|!bSxlaZ*FsRAY*7@aw;hRBVjW+VPs`DWnyD7VK*~kIbmWnGGa4kW-(?nVl+56HZki0RTK#WGZs2JcXDZTWmPyRb!l#NIA3%uAY*TCb95kMXkl_HDF7p3H#9UkWivT5H)1z7GGt|CW@I)qH92B8H8N!}WjQf8?E+O42?H}1Iy!f9X>?^(F*Yc5X>N2eHeYlsAY*TCb95kMXkl_HDF7p3Wn?inGh}8mVlpr=HDoblH#lZDWH)4FF*jvmWMyV#?*dg72?H}1Iy!f9X>?^(GcqW3X>N2gGGBBoAY*TCb95kMXkl_HDF7p3I59CeVKFf_HDx$BGG;I{W->N4F=Sz6GdMOiVKrf7@d8y92?H}1Iy!f9X>?^(HZ&-8X>N2jG+%TqAY*TCb95kMXkl_HDF7p3WH&Z3V_`TrW;rosF=Aw8Fk?3|Ib>lsIX7l9F*r6c^8!^B2?H|}Iy!f9X>?^qGcqVxCxWHDm*0#y?U12YpkI(KqubY((sZ)_-HZ*OcYAY*TCb95kMXkl_HDF7p3VKy>3WHd23H)dmGF*rFkIbk$4F=RP8VKOvjF*z|X`2tlD2?H}4Iy!f9X>?^%baH8KXDDNDZgX@XV`yP=Dl8ylZ*FsRAY*7@aw;hRBVl1RWil~2IWsUgWMVcqVlgo_F=b|EWj17FVl`!CHa7bLRTv2aGYvXAVr6G(Zck!rWn*+GV{dMAbRc7BVR9-d03%^EFgG?gH83$|H)A(4F)%e^GBRN_H)J$7W->7`V`Vk{0#yqM12Y0TI%RHTPhx6iV{|Af03%^!G&g23IW=T9GG;e5VP#`BF*r3eVmM|wGd4M9V_`7=0#ykEGa5QNVr6G(Zb5Q#VRf3W-~HjVl-qoGGk&gW?^A6IWsmmVm4$oWnnP^163Fa12Y0TI%RHTL2`0oc_=9WBVjOPIb$D%CGG#erH!?M1VPyjYRS5$#8ag^+WoKz_L}_DmX>V>}a(O6obYwa@b7^{IUvw-WV{dMAbRc7BVR9-d03%^#Vl`qlH)LZlGBhz_I5RgfIXN~pIAb_CV`DcsHDYB2163Fa12Y0TI%RHTL}_DmX>V>}a(O5z03%^JGdMG3VPaxrW-&K5V`4UCVl_56HDhKmG-G8mW;i$p165%F06IECX>MV1c~fO_X<=+>dS!9|V{Bn_b7OU4Z*yNUUom5Ea%EpJUom81bYWjHUok>yZeenHQ)O~#VQgu7WpXZPbZu-D11AnTI#G3Ha(O6YZ*FsRAXjg4Y-A=W03%^BIAJtmGh$|CG%+$UHD)klHZx;0IW{*lVq-aCFf=v_14#@N11ADHI$~vKX>KSf03%^AI5uWwWimHpGcq?cFfcPSV=!T3W;ZisVPs=vWH4h414$GECjvS;Wo~3BDF7p3He_RCGB`0XG-fk0WMnWgWHUB3WHC56Wi&EoF=1ph4g*OP11AVNI&W}ga$$6Da$8*}MQ(Iyba^QNBVjW*Wj8l6H8wRdHaIshI503{F=k{mHDxenVrDjEF)$DVNd^=HCjvS;X>Mk3C@BCVVKFf^VK_K6V_{=8He+EjVl!rDGc{%~H!(9|G-Ee7G7C}VGKb95kcbYwa@b98cPZf7PeAY*TCb95j>Z*6dIZe?zCRC#b^b0#h>E-3&bVPmT2IT`~^EG7dhB04%@WMn8sZggpMc`P7fZ*FsRAVY6$aBps9Zgf<6aAk8QE-o%903%^BWo2SAF*s&5Ib$$4H90wCW@0fnH#1`~VKq58Gd5!!15F?%11m8)I$>mFMsja$L}hbja%o{~X?kUHC`E2`X>@rkAY*TCb95kcbYwa@b98cPZf7PeAY@^5VLCcQWpib6X<=+>dS!AZDF7p3WH~Z6V>U8jWi~TrWidEmV=^!>VliPjH)UfvHZe0Z9s^A;CIc%PIyz-;bZK;XC}VGKb95kcbYwa@b98cPZf7PbAY*TCb94YBVKHPkHfAzmV=^)}H)A$5W@KSGHa0gfH)SwmIW#yqW*`Gi7$yTNCOSH8WpZa_C}VGKb95kcbYwa@b98cPZf7PeAY*TCb95j=Y;|RDa%paKCMf_TVP!KgWHe?nH)1g~HaRdbH)J+4F=JyhGdX25H#uW6Vj=@gBqjqZ0y;WlY-M3`C@BCVVL3QrG&C?`H83?bGcYkYWMVZmG-NhoWjJFuVr5}AVI%`hm;nGfIznu9WpHw7Zgc=+Y+-YAV|8M0b6+uEF=KCXWnVF0F=bVAc{(~%baG{3Z6+)rVsCG3DF7p3GchnUVK6y0H!v|dIbmiwIb=6CF*7)1FfuSCH3Cj(a%O#?LvIy!P?VPr`-C~0nVIA3%oDF7p3H#j*sV_{)1VmUTqGd5#1HfCXDIXE#iHaRdgGdN*lDFasrO#?LwIy!P?VPr`$HYjOsbTKwxbS5bPBVjRSG&p2sF*0T~VP;}vHeoVhVKy{1V`VuoVmD%CFk&kMR|ri5H3~X9a%Ev;Ni#AiX>N2gGGBBiDF7p3HZwV8VK8B1V=`u8H85dfW@cnFW??fkHDYEmF=8_{Edy5wO#?LwIy!P?VPr`*G$?6qbT%|!bS5bPBVlD>F*Ig2VmUQoGi5V3H85r|HZfu~HZ?S2Ib$(1HDoUXR|ri5H3~X9a%Ev;RX8YhX>N2lUvwrZ03%^FIc7IxG-5PnI59A0F)=q}Fl96~GBP$cH)1m}Ibks|16K%512qdeI&x)UWK}UXD0OLWbTKwxbS5bPBVlD^H8D3dWMMdFG&3}2F)?8@I5;sjWHmNqVlg>3V=*%WR|!o6H48dAa%Ev;RWmXub!l#NGcsRvCMf_TVKZSiF)%h|G&eOgH#sq4WMMdFH8^2qIASwmWic`}WHkd<2~7hv3pzS-WnpAhHZ&-8X>N2jG+%TkDF7p3W;SCpH)CZuHZm|VI5}f7H!(RdVrDsGGC4G4GBq(|Hv?A*O#?LuIy!P?VPr-#GAL$jZ((#MDF7p3G+|;mWjADHG-72oWHm5kWidBnGh<;jVl!r8H#jynIRjS)O#?LvIy!P?VPr-&G$>?mbz*E~CMf_TVKieoHDWO}H!?FhIA%6xI5ab2Ff%waVPQ8iGht;mI6DJZ2TcPt2Rb@(WnpAOZ*OcUVsCG3CMf_TVKXx@Vm38oWj8W1WHC88H8^HBI5Ie7VKy{lWj8QkH$4Ma1x*7r4mvt=WnpAfbaH8KXDD-YWI8%?baH8KXC^5CBVjQ$Gc+?fHfA|tIA&pGG-G2qVP;`AV`elpWHL1~V=_MjR}4)9H3B+1Vr6G(Zck!rWn*+GDF7p3He)z3WnnQnVPP>aH)S|wGGs9{Ibt|9Ib|?oVPiHlK?7G!12qCVI%RHTPhx6iV{|Af03%^yGchzZH8W%~VPs`uFlA;lHDfh1WivHqVP$1EI5cKM16NH0H3B+1Vr6G(Zb5Q#VRmH5VKZYiG%+dS!9|V{Bn_b7OU4Z*yNUUom5Ea%EpJUom81bYWjHUok>yZeenHL}hbja%o{~X?kUHE@*UZY*qs;4LUk$ZgXXFbSQOcZgev;Uvw-WR4D)>VKX*2IX5yeWMMWjIASz0G-5JlF)}b>Vm3BnWivBkG)@Cg3swUy3OYJxWppTYX>N2gGGBBl03%^HGiGBlW;8cqHZnFhF*jm2HaRmnG%zq>H!)%{F*7t!15XH011}IDV{dMAbO2>!H8?OhG&f;oWH2;1W@0lnIWb~3Wn^JxHaKHrG-Xl)PYzZCEebk1WpZJ2WhixNZgev;Uvwz|BVl7?WjHftI5jgeWi~KnW;A6pWH@CoWMegCF*r0gW-(L)PY9R+06IEOb!==?bZ>HDXJr6mY+-YAV|8M0b6+uEF=KCXWnVF0F=b`~VP|D7Xmo9CSpzaUI%0KnbZ>3|BVl7PVK+2pVL3TAF=k>gIXPltHfA$0Wo9yCW@I#BV`NzaGCDeNa%FRKWn=&&VKHMjI5IS1Gc-14Hf1?uGc{o{V=`kmH8?XiVK-$nIrIboIyy~nb#rAxb#!!ZZbf!wZgc>1baHiLbYpd5Z*yNUUom5Ea%EpJUomNKUol@XO>cE`WkPjybZ>4&c4cmKE@*UZY~}_4IyymZVrgY=bWCYyXmkK`baHiLbYpd5Z*yNUUomBFXK8L_Uol@XL2Y7bWo~p#X=iA3E@*UZY#jjrIyzBxWpa5&Wpra`WpV&>baHiLbYpd5Z*yNUUom5Ea%EpJUomB4b6+uEF==gZY+o^7F;R78a(PB&bYo~`axQ3eZEW@g0558DZ*DGVaBu)>b8l{6IB0NiE@*UZY+nO22s%1%aAk5~bZ>GhC@COgZ*FsR03%^$Ibtv~IWb`|Ff%h`GBY@4VPZ06H8?RfIbk+5HaRt2162kT10p&)Npxj$VRUbD0ADd*F-de~a$$6DaxQ3eZESD@D-k+6aCLKNC{!#Ub#8NMXKrO=AZc!NDF7p3IAk|4Vq`NkH92KAGB-6bF*0N_G%+wVF*js6GB`OmU;|ALa04q7Iyz@%bVYV$Zgfpyb89GbbYwa@b7^{IUvw!TV{dMAbO0k^Wo2eHV>MzoIAdcnH!(3`WM*b#VmUG~H8n9fFgZCjVgpSPa04q7Iyz@%bSQIlWI8%?X?kT}bSWTXZ*FsR03%^AV>d7{VP!UCHZV70Gh;L{VPiHiWnyAEI5;yiIAStn15FWd11kbLI%8~QVR9%b03%^#I5IRhHe)a_F*so|GBGeTF*Y?YF=00`H90jlI5uWx15I!PD+oF|b7gLHMRsLwbaN;vAY*TCb94YBVPRx7VK+8rGh;VnFga#pGc{v2VKHVmGGt*mGG=08IA{Y+25iW??utV>o3uGG#JmGdVFZI5Rb4Winx7GGS^1O$KlSD*`$?VPs@dWnpAxawsVPBVl7@Wi>T6GBqe_tGc_?}Fk?A6GB9FcH8wV7HDqi9O>hG%0y;W!Wo>VEWm08fWMy(FDF7p3H!?C~H83+bHe@n3Fg7z`W;r%uGG;YpH#cH1H8f>pZUar20RTEWMRsLwbWmwwE@*UZY#{~&FLrNuWo&Z*Ibtw0V`euvHexg}G-EJiHZ(M3VlX)}I5%cCHZ^57E@*UZY;*%bIyz-;bZK;X03%^AGhtyjF)(CiFfun}WnwltWHDrAGGt*hFlA&kF=I4z13@}EX>(0!ZU7@;IbmjHGB7w|IA%96I5#$8HZwP3I5%TrW@ceDHDoqnWeP1iI#YLLWpGVla%*LB0ADd*F;jPCWpGVla%*LBE@*UZYa7<-(Wo$!lb#8P3BVjZ#H8)~5IWl23HDxe4G%`45Gh#D0V>CHsF=1jbG+}!KFFHDRX=HS003%^!WM(vGWHmHnVmB~kVl-o9V`MioIAb+rH92K8GC5>>11~x{Xk}?D|F*ap4WjA4DFg0N^FgQ0kFna?pIy!Z8VP|CkBVjT#WHV$nWMN@tV>mW2VL3KpVK+5nH#cK6IXN+7H!*tyFFHDAZ*py6bO0k^G&wgnWi&A{I5;sjV>2^iVPiFAH8U|cIAmrvHDY8p1_S^)I#gwNbairNGDJjWb7KH=baHiLbYpd5Z*yNUUom5Ea%EpJUomHFUol@XRAqQ{b#i4gL_}qCV=icPZEPV11TS=NZ)|e_V=*{2Gd4M8IWlE4HZU_|He@g`W??upG&3?^tI4EgubU0shEFfcVZgX@XV`yP=Dk%UXVP-QjW@2SCWM(!tI5cBpVK^{iVP-jIIW{;nG&wUlIDrFC6RQI)7CJh2a%psBNijAkX>N2eHeYlsAY*TCb95kMXkl_HDF7p3GG=5kIAbtoI5TE5H#ufDI5{z5Vm4zmVq`WsG&MFeg9A?#s{<_-Iy!f9X>?^tGcqV?Zgev;Uvw-WV{dMAbRc7BVR9-d03%^JFlAvjH)1qoWoBbHHDowAFk?6|IWssiVm2~2GcquR15XsI11%OhI(KqubY)34G$?6qbT%|!bSxlaZ*FsRAY*7@aw;hRBVlGaW@I@xGcYn_F*P+ZHDzLAWH&H0Wo2PvFgY+aV_}B_PZX;IEfzXDcXDZTWmPyRb!l#NIA3%uAY*TCb95kMXkl_HDF7p3FgRv3IXPouW@9lqI5{;jF*Rm4H!?Y9H8NymFl940i33j*s{<_;Iy!f9X>?^(F*Yc5X>N2eHeYlsAY*TCb95kMXkl_HDF7p3IW#jeV`Va7F*7zaWI1AHHext8H8^E9Fk&+|Wi~lxivv#;s{<_;Iy!f9X>?^(GcqW3X>N2gGGBBoAY*TCb95kMXkl_HDF7p3G&EymHZ?UgF*7tVH#Iq8IAS<9Vq`F6Wiw+rIWaV2jRQ{=s{<_;Iy!f9X>?^(HZ&-8X>N2jG+%TqAY*TCb95kMXkl_HDF7p3HaRmgHaBE2IAdisGB+|aHa1~1H)AnkFk(14W@9!tj{{E?s{<_*Iy!f9X>?^qGcqVO5~~9(6*@Y1a%psBMm97kWN&q1Y-KDUV{dMAbRc7BVR9-d03%^DHZnIjGd46dIXE(AGG%5oIbk_5GBsgjWH&HjH90bq15XpH11%FeI(KqubY((sZ)_-HZ*OcYAY*TCb95kMXkl_HDF7p3G%#W^GBh}1H8e71IAJn0G&46gGiEn4HZfr`VmD?pl><)^s{<_>Iy!f9X>?^%baH8KXDDNDZgX@XV`yP=Dl8ylZ*FsRAY*7@aw;hRBVlAQVl-koI5A{mG&E*0Fk>(|Ghtz3VK_8mWHe%8WMh{DPZ+BMEf+dEcXDZTWhi5BZgX@XR3LzqYGq?|C}VGKb95kMXkl_HDF7p3I59CaGBaT|H!(6ZVKHN7WMeX7Gc#mlW@RxrW;rotn*&b^s{<_pIyz-;WKUvhWn*+GDF7p3F*7taVmUH0HaRtBV>Dx9Ib~upWinwlGiEV3H)1w6odZv+11%alI$~vKX>LJsa$$KWb97`nI&*1yWnXkGAY*TCb95kMXkl_HDF7p3V>U52G+{9`H#j&oG&yEtWier7He_UGW;tYJHDoq0p94=As{<_pIyz-;WI=LrVRM)AI5uW8Fk@ymGB;&0WH~TnWj8XR15c|1EgCvHVr6G(ZbWHgbZKvHVRCsWb97`nI&*1yWnXkGAY*TCb95kMXkl_HDF7p3WivEnGG;V6W@KYxVl+26V>vW6Ib$|qH90UeGGZ|@qXSPEs{<_pIyz-;WJGCWbZKvHVRCsWDF7p3Wie)BW@Tk$F*IRgFf(OlG-Wn1W-($pHDoz9I5#*or2|i^11$(TI%Z*MY-MC9DIjBSZgX@1BVjQ#VmUK4V`gDEI59aiGBP$XHDWnrH#0anHaIXaVKS!!PX?<4Edn|^V{dMBWq5QbDF7p3FgGdS!AhXmo9C5eNV;aBOvFX>KlPaBu*0Z*OdKUov-Za%^N@UukZ0aAjk3Z*pHUaBOvFX>MOQXmD^YXmo9CTm=9xZDDj}a%o{~E@*IY0BvD(WpZg@Y+pENaBwbYbZu;21pqH_Y;|X8ZZ2qWZ~$p-XLV^`GH`5lXK8LV9Z+K;Fb5Lw`XK8LILv>Du9W@b2HG&nP4WMnxrVP!NmVKFvhVKHVfFs}nV2IK$-Ai}#KR&RJ^Y;yp1Z+K;Fb1iUeb!TaAE@*UZY{COfIyz2oZe;*rHeqCDIX7lFGht(9HZ(OeWHezmVKibfFgGw}GdDFf!UIe?I!QPHVKrf8W;A6pWnnWnIc8xnWnwa7W;8NnIX5{pG&4CcGQtB)Iyy-)HUME_V`MisG-fzCF=91lIb>!xFgZD9Gi6~nHDqCAW;kTR157$PNi#A4VPrTrIAvirFfle_W@RujH!?XjG&o{rG&C|~Wi??qV!{JVIyy-3Wn(xqI50S3VP;`9W-`J9OgcJMGco{SV>n`DHDYCCW@b2LW-&Q3WHUKoIW{t3W@9jAF*#*r!UIe?I#o6_0AVvRWHvQpV`F4CH90e7G%+wSWMVlpW@0!uIALOAVPV1pOgcJ7Gco{SG&EskG-YNrVK+8qHeq2lW@0mCGiG5hH#uQ7G-hOB!UIe?Iz~1$0AVpVPi5jW-&EoI5uT7WMwpCGdVb6I5IagGB+||Vqq{dG{OT+IyzHya%pa70AVsWF)=tZGBz+UHe@q6GC4LjH(@j|FkxgeGh{VnIXJ=tOgcJGVrpe$bO2#AIX5sfF*i9hG%++`H8nCcGc{&8FflbTVPi95H8f(v157$PL2`0oc>rNFG%+w`V>2{lIb}9uF<~}1F)%P=VK8H5Ff%h|Vlg+u157$PL}_DmX>V>}a(Mt@Gh$_8H#KB2H8wM4Vq-EgGBqGBz=0VP!KgH!xu^GB;r}Fkvt`Ff=k@H8wXkH)it#DmpqvY-Md_Zgg`1BVlD@W@a&BG&nb7Fg0RkV`F78WjHuEG&VOdGdDIeFg5c7DmpquX=8M0Z*F07c>p6}G-Nd~He)zsVK8PmFk)n7I5#vhGcq(|IAt<9VK-wo^8+e6Iz(Y~VE`jxG%;m4G&MG5WiVklF*IdmH#K5rHZ(Y8H)1p}IbkvixHf1?sW;HZ3IAJn4FgG=0V`MitWier4$pcIW^8+dhIyz%$VQyz-D0OLWbT%|!bSVHMVL351I5TB1WH&ZAI5K2oG%_?~Vl^;gWMecqH)SwoGRp%@2=fCf2s%1rXkl(=Whi8Cbz*E~DF7p3I5lQwHZwCcVKp;kV`XMIHe_OCF*h_cHZfr~H8Eu|%>zsZ^8+ddIyz%$VQyz-C}MAKY$*UEVKg~pI5A^nH!(6ZG-fnpGdN{2V>n}BVmC8pW;r)FH_ro11oHzb6goO%Xkl(=Whi5BZgX@Xb97`nI&*Y#X>MmGDF7p3V>n_mF*7t}Ib%3wWn?xsVPh~fWn*PyI5S~oHe+OA(F05p^8+drIyz}?bZ;nBCM+OBZ*FvDcyuZ$AY*TCb94YBVPj%uHaRskFfcMQG&VRkW-u~gVlpr{HD)<5VlibmIMV}667vHp5IQ<%WppS*Z*FvDcyuZ$AY*TCb94YBVPiLBVKZbkH!)^oFl0DoV>mHpVK*^iVKX#2GGR7kX4L~s4)X&l2s%1+d2nSYDIjBSZgX@1BVji*Ib}FvHaIdjHZo>2GG;e8IbmcsVPR!uGBag0Fk;sOOa}7hV{dMAbO0k^G%#W@V=*;mH)CNlVKrkgG&4D5F=H`iW;QT5HZ(J4+XGAn^8+drIyz=)Wo%?9V{dMAbRctdWI8%?baH8KXC^5CBVjQ$VK-r9Wj17HVr4mDV>n@CFg9g2WMVfmH)AqkI5FJ=OcL`0Dgrt>W@%+?WOFDf03%^CF=H?@Vl^;hV>U8mFl0G2Fkvw{G-hUDWietkFfwJ|15DooEC?WDZ*FsR05oDXFl96~WiT`}H)LfoGhsPoH8nFiVP-R9I5J^kIpG6L2J-_d5;{6^Wo>VEWkzXbY-A{NbYwa@b98cPZf9S1X=QgQ03%^$V>x6nWMeclGBGhUF=RA1HaTTCG%+UN9GGt;nF*9W{WHdQ50{baN;v03%^AWH>T7Vq{}DGGRD3G-EenG-6^nIAmcnHZw9cG&wQn15D=wEC?WDZ*FsR0A)5aV>viAW??pBF=S*lF)%n}I5%NpI5IaeVqr5hHt7RQ2J-_d0y;WmX=8M0Z*F07c_=9WBVl4@W@BV9H#256Vq!TrHZ?IgGG#F~H#lZuVL4?tHeu@nOzQ(I2q0r`ZgX@1WHLBoGd5u`H#ae2W;A1BW-v54VmLQAWjSIqIW{w6?E_2(^8+drIyz=@Z*3@JZ*FsRAXFwSAVY6%bY*ySDk%UXVK_2nFk>+?I5J~5HZwIjF*#v5H90V5WHK~2HaIXgG4BIR67vHp20A))d2nS^Z&P$~X>MmIRC#b^DF7p3H)UltW;9_oH!wIcIX5seV`VXAVKz2pGdDS9VmL8k@dHc*VE_O+I#6L_Yhh<)0Ap-nb8};LVsCR_F<&ubZ*pZ{F<&ucVRT_%F<&uIVPk7yXJsyEbZu-*3IH#1Z**aFX>V>WXmD@2^jV`DZlG4}&8Iy!S}c}H?#WNBq?bO0k^VKz22W;i%9Wi&T6W-~Q8VPRurW@9iiFkv)dIWc51<^}*dI#OkBWMy(?az$=-X>xCFZDnqB0CRM5bz^j6bz*OGUol@XWo~C_Ze?FFUolc;Ze(S0WpYJsc4=~NZf#|5bS`LgZEWNK2M9VkRBvx=b2>UxWps3DZfA2KX>N0HWn*-2aymM5Wps3DZfA2zZgX&DV{~tFP;7N)X>KS(bz*OGCMf`OWps3DZfA2XX>N0HWn*-2axHXkZ)`1aY;|X8ZZ2qaZEPcFVPaxoI5{+7F*P$bGBY?fGG#b5V=`qmH#0UfWMMZrV)z412K@yGAi}#KQ)P5?X>Mn8AZc!MaAjk3Z*l;0Wps3DZfA2XX>N0HWn*-2axHXkZ)`1aY;|X8ZZ2qaZEQjU055QCb!TaAE@*IY0CaC}Y;#{SWo~q7ba`K2b7gF0V{~tFUovoPb!TaAUpQ!Ra4u+cZESr5054;8a&vETE@*IY0AqD>b8m8AIB0NiE@*UZY-$1kFK}#OZe=cLaBu)+Zf9w3WnVIBZewh9WMyA6V|8M0b6+xLZf9w3WnVI5Z)|L7b7^mGb6+xJZ)|L7WMy)5UovoPVQyt#IB0NiE@*UZZ2to=Iy!J~b7^#GZ*Bl1VKq5pGcq`1Ibu07Vl*;kGGRDmWi@3qI5=fwW;8iCVe|w5Iyy~nb#rA+Z+2xxc4cmK0CRM5bz^j6bz*OGUol@XV{dY0Uol@XX>VUKUolN@b#rA+Z+2xxc4cmKE@*UZYy$*2Iy!S{dSw73VK^`|F*9Z~Vl+51Hf1z4GB;vlH8^B6HfCmHG&L|WGXn%UIyz-+Wo>0{bVF}-Zgc=6VKz22Vqs%BF=jM2F*i3eG-EY0WMnZlGBY(aIb=C9I0FPZIyz-+Wo>0{baMbBVL3K8VPZIDVq#)rH)CREFlIJlH(_QtI5%TCI50LhIR*p(IyysdZgX^DZgfI*W@cq_Q*?55V{~LV|8M0b6+uEF=KCXWnVF0F=uRFF<&u5Z*FsRVQzFnb!KK|a#M72bz^jOa%C=PbZu+~1R*s#I%j2WWpZJ3Wm98vWo2$rbzx*EQe|#rWpYGic4=c}CM+OhZ*FsRAX8{zWMy(tX>et1X>MgEEFe~8a&%>QL2`0o;((?p03%^$WjJGIV>UH1H)Az3Vl`!CHaIwCI5;;sHZV6gVKin01Vb|+0TwzsXKVmpF<&ufY%XYYZEQwmVRUtJWgtg&X=G&pW@TY?b#i5ME@*UZY$OCM6goO#WMoufXDDNDZgX@Xb97`nI&*Y#X>MmGDF7p3I5IUgGht&iVq`csGh#AfFfnCeG&M6}F)=V=WH>ir2n0?NBm^uJIy!V=XGv~oWpZhBRAFZ*V{dMAbRctdWI8%?baH8KXC^5CBVlDYWo0m8I5amjIbtz0V>o6qH#aq9IXN{pFl9M4G%yMTP7)*pEEGCAbYW*xWpqJibY*f>VP_~~Z*FsRAaitNIy!T7a%pa7CMf_TVPj=8HaRgiF*PxrVlX*nG&46hH8VD0WDEpO5+npH6goO|VP{iibV6ljZ*pZ+VP_~~Z*FsRAaitNIy!T7a%pa7CMf_TVPiIAH8D72Ha9poGcY(XI50CYWHdH2GGQ_}H(@q3H4X$$5+npH13Ef%VP`>PWJ7OmWNCD1Z*C|?DF7p3H8wdoIWRV5I5IgjI5Ib4W;Hi5VlX#0IWl2oF=b*m5Cl#EBm^u2IyzxwWK(%_bY*QQMkxRzVK`)DHeoYkH8?dhVmD?uW;HT4Vr4L8Wo9=wIW{>mVG;yR0VD)06goO{d2@7SZ9!yYRAFZ*V{dMAbRctdWI8%?baH8KXC^5CBVjf%Fg7zeWn*JzIW##jGh{V6WHe-EG-fn2GczzYIb{?CP7)*pEEGCAb9r-gWo=VsbU|ixWpY$uXDDNDZgX@Xb97`nI&*Y#X>MmGDF7p3H8f;qIb%6FIWjP2H8V6YH8e6cGB;*qVlg;nW;HfB76eWbBm^u2Iy!TCb97~GQ)P5PW^`q8Q+acAWo;-%DF7p3WMgJyGBPq_W??iqGdX24I5aggH8*B5Vl*>jHZx{67z9oMBm^uJIy!TCb97~GQ)P5QWoB=3WmI8jC}VGKb95kcbYwa@b98cPZf7Pb03%^AWH~f9WimH7GGsC`GB;!~HZwP2F*Y$UW-~c5VK^}w1Wpnp1S|tOI&*n*bY*Q*WpqMiW^Zz3Q+acAWo;-%DF7p3G&f{7VKOsiIb|_9VPP>fGd4FdVPQF9IWRV1VKrnm90X1QBm^u2Iy!TCb97~GL1bh@Z*F91bZKvHC`Ks&BVjjYG-hNqF)%SPH8W#0VKrtqW@ct#G&VLkVKHW5V`Lr#P5~qYECM<@V{dJ6X>4UfXklq?C@BCVVK8AhIWjUiIA%05Ff=(hGcq)0HeqHkWMyPDIb||pG9Uy_Bm^uNIyz%vY;03`b97~Gb0}ADa%^NKEFeQ~ZEaz0WI}ajW@U0FDF7p3W;QT6F)}e^V=*#jGB#mlH8W#oG-WqtV>mT4V`MRAA_Ptrm;nGfIz(x6aA9;~Xk~H$V{Bn_b7OU4Z*yNUUom5Ea%EpJUomB4b6+uEF+^!|aA9;~Xk~IPXmo9CCI@`VP<18I50OhF=S#gVlrf7WHB=^I5S~3VK8DdV`4WrW#$F|IyzHnZE$R5ctdY&Y-wa=asYF5a&=>LV|8M0b6+uEF=cLNX>Mg-F<&uLX>D+9Wq3nxY;0*{WpXZPbZu-_1TQ)|ZAM{fY(i;t03%^#WjHcpG-Ee4HaR$EH8wP1F=8_?Vl^~oV>dTtGGk^|1TP6XI&x)UWJx$EX>N2lUvwrZ03%^xGchwTVmD?oVL31`GBP(|VKQN6IXE{qH)Jz0G+|;Y1W^Z81TP9YI&x)UWJxhLC~0nVF*aXxCMf_TVKXviHZo*kVmLWtGBq+WWiT{hVlrYgW@R)vFk)dcI4lHF2v!6y3OYJ+WnpAVGcqV?Zgev;UvwrZ03%^BHa9RcW-v4|I50CYGcaRfGBq?bI5}oHI5RdkIAvun1W^c91TP9YI&x)UWJxwOC~0nVHZ)&!CMf_TVPs=7I59IeFlAmGht#lIc7F9HZo>5IWz=O304Fz3pzS-WnpAhGcqW3X>N2gGGBBiDF7p3WHdA|Wi&K4FkxmhI50LeH#jslGGj6{IWu7}I5RP0HUv=#Rs=5#Iy!P?VPsV{G$?gxZge&@UvwrZ03%^EF*rA7H!(D3W;HN3WnwmCF)%PTWMVgAV=`npVK_H91W^fA1TP3WI&x)UWJWVGC}wPLVRR-b03%^HF)(6fFgP(WVP-KlIWc24VPa%uFfcSSV>V?uH!?9g1W^W71TP6XI&x)UWJWeLC}eMSVr*q5DF7p3F*9W_IAb|sGBh$|Ghs1hGdDG6IXGl6VP!L9VrF45JOoh(Rs=5xIy!P?VPryYZ)_-HZ*OcSDF7p3Ff}+fWjHosGB;#0G-5b7Fkv`1GBq`3IA&ooHf1noJ_Jz(Rs=5&Iy!P?VPsQua%pa7D06gVIy!T7a%pa7CMf_TVP!NjW-(znVPQEmWiVo4GBY+~IX7W2VmCA}H8?djFhB%R3|0g$1Ufo$Wnp9}R3<3^BVjaVWjA7CIc701H8Em2WH~Z2WH)3rWjQlAF)}bPGG;;qQ36&3F9JF`Vr6G(Zck!rWn*+GDF7p3V_`HmGdW>7F=S#fVK^{1V`DI4HaBH9GB{*oH#ashLdD}G-PCBIAdc*1W{H5F9JF`Vr6G(Zb5Q#VRLN9IAk(pV`DXAVrF7yGdVF~IA$|7H!wA3GD-wdRs=5sIyz!yXK8LkX=8M0Z*F07c_=9WBVjl;GBq4U=C@COgZ*FsR03%^!FlIJkFfuk}WiVkdG&MIcV_{)8Wj1CrWH&T2H8f*T1W^W71TO+QI%Z*MY$z!JBVjdTH8445H!x-~VKQN4Gcz$|W;Qc8Fg7+}I50FgGhtE$QC0*m0y;WlZ*FvDcyuT!03%^yWHn(iF=b*iHDY09Ff(N}WHK>iHDzODV`E}6Gh{YY1W{oC06IEEWpib6X<=+>dS!9|V{Bn_b7OU4Z*yNUUom5Ea%EpJUom81bYWjHUok{wb7gXAVQgu7WpXZPbZu;x0Sh3)yC6qpZ*66Ca(MtPXJv0~E@*UZY*_>=Iyz%-WMyz~X>N1?BVjaTI5atAWI16uVlZJaWMX4EWil}}V>vM~W@KeKW-#;w06IEUWq5Q&c4cmK0CRM5bz^j6bz*OGUol@XV{dY0Uol@XX>VUKUoli=cyvW}Wo~pXXmo9C+6DkGaBN|2WiDuNZ~$X(a%EpKX>Ma|b!25Mn8UovoPb!TaAUpQ!Ra4u+cZETGK054*7W@cq_UvqSFWnpbDXmD@UiX>)L4bYo~`awaSwb97`nI(B7abZ>Gzb97`nI&*Y#X>MmeCMf_TVPQ5nIWsqAW;0|oW;kXsHZo*oWHL1~Ffn5}Wn(ooGF=2rF>3@W6goO|VP|J$WGG{AZgX@Xb97`nI&*Y#X>MmGDF7p3WHvW3H83BlG&D0~Uj$4NYXmA3Iyz!yW^Zz3RAFZ*V{dMAbRctdWI8%?baH8KXC^5CBVl7RVm3E3WMpMBI5uQvWimHqH8f;2WHB*0GBPzWWinv|OcHAZDik_8VPsXWpYz_b97~GC`Ks&BVjZ&H8nFaVKOmfWHnM=W++A}03%^DW;8K1W;A1DHa0UbWim2jVKXr@I5s&nHa0LdGB!DB1WW4R=asXp&VRLh1bz*OGUol@XWo~C_Ze?FFUolg8b97~GLUn0uWMy(LXmo9CZUi?CIyz@%bV6xvWNB_^P;Y5&bSPtQZgX@XV`yP=Dk%UXVKHK4H8?miV`VurG&W-}IWsmhW-wzpWo0%uW@KSzHEaY~3xNgzIyzHmVPs`;P-$>wY-w&~0Ap-nb8};LVsCR_F<&ubZ*pZ{F<&ufY+o^7F==gZY+o^7F;i$^WMy(tX>et1X>MgMXmo9Cas(tgI%aQnSpXwpH8e9cGchnSH8e6|FgP`4Wie!BHa0kBG%`43HZnM4as(tgI(klJVR8T?VPZBiGGb#fH8f;nG-WtAGBIK@I5#;rVq|4xWi~Q2GI9hYIy!nrVR8T?VP-ZoGdMV9W;S7AWi>Q0IAt|4Wn^VEVlrW7Wiv2lIOYZbIyysPZDn#{0CRM5bz^j6bz*OGUol@XWo~C_Ze?FFUok^rZDn#{E@*UZY)lFOFK}#iXK8LOXmD@UiX>)L4bYo~`awaSwb97`nI(B7abZ>Gzb97`nI&*Y#X>MmeCMf_TVPrI9Ib>#IW-~NlF=aPpG&MCdFk?AoGBIW{H#9UkVsr#aF?<9k6goO$WoB=3WmI8jC}VGKb95kcbYwa@b98cPZf7Pb03%^FW@RvBGB7zbIWuB7W@KSxG%__eIb}C9GdMOiFkxeM1W6Kn1Sb?aI$>sXWpY$uXDDNDZgX@Xb97`nI&*Y#X>MmGDF7p3Wj8iCG-NYmWHmB4IW{>nVPj@7H8?XjIAJ+rG&E!}cmzojd;}*0Iy!Q7Zb@b+MkxRzVP-R7WH@3mIXGl8GBPD!8F*Y$XF*#&1HZr3GEIK+vbz)^rVQ^Goa%W|90ADd*F++7?WldplRAF*wWpplRbZu-=0st>_bZ>HDXJsyEaBu)~bZ>HDXJubFXmD^YXmo9Cg#<1TIyzT!X>?^%bZ>HDXJsf?a%psBQ*>`~VP|C~CMf_TVP$4EH#0b8V=!hgIXO5oFg0OhV>n_rV`MQgH!(IcVu1uu4uu3R2s%1vWppShAY*TCb94YBVPa-sF*jx~G&N&oI59S3WHmEpWH~Z4VKX#gHDY08VuJ)w21*4YQ*>`~VP|CkQ*>`~VP|D7Xmo9C<^}*dIz(k`bYWC!ZDjy+baHiLbYpd5Z*yNUUomBFXK8L_Uol@XL}hGrVN_{tWiDuRZER!!96CB_ZE$P=Uol@XX>D+9E@*UZY+MBZFLq^ebY*xhXmD@{mRIyzEiXK8bEa(O5z03%^BIc7IAVq!I6VL3BmH8(RbVPj@EHDqQsF*YzTVq#>81Wc6#Dm6MfV{&C-bY&=WbYwa@b98cPZf9S1X=QgTAY@^5VLCcQWpib6X<=+>dS!AZEFeN`b!BjJX>N4lfTk$`BVlASWH>c3VPr5dGB9B^VKg~0F=At7VrDR5WMgDAIbw?hOf!`PDiJz5V{&C-bY)X?Z*pO0WhirWWI8%@d2nT4X>Md?cqsrQVKZZ7IAk?AF=a6_V>vQ8Gi75mIWb~4Wi@6vIb||2G>rsI50wNe5;{6zWMn9FbYwa@b98cPZf9S1X=QgQ03%^HGBh|dI5=ZsHe)n7VKp=`H!(D0WHn`GW-?(kFl9K81WXW>1S%0aI&NWYWhirWWI8%@d2nT4X>Md?cqsrQVKZejGGjAjGG#DjVKg;1V>CE2I5T56H)J$5V=ypeW|0I;50wNe5;{6`d2nSYb97`nI&*Y#X>Mm)XPc>rTUEpV>e_nI51*2Ffle|IALToF*#;AWH&W3GBY+bECv8NIz@P6Y;|O10CRM5bz^j6bz*OGUol@XWo~C_Ze?FFUok;*b7gc*WprU*F<&u7cw=mJWMwXBbZu;%1TQ)|WMOn+03%^$HaBK5HaBKrGB#l}W-()CG&eFfGh<~qVPY_3Gc`Az1TQ)|ZE0{!Wp-t3LvM9%bO0k^W;kLvF*#;AW;Zc1F)}nTH8*86Ff}=0H#K50VlZZAodhpBI(KPgbZ7u0VKz87WnwTkH8f^0GdD6~FlI9~VKOl@FgY@0Gc+`2Ih_PAIy!Z8VP|CkBVjc*H#0LbF*IdiFl1sfWo9>FGGsD2WHmG}G%++`H)EXyFFHDAZ*py6bO0k^GB;#oWi?@9G&VLjG&nM2F=8}fFl93_V=_57HZ?Xi1_S^)I#gwNbairNF+@aVb7KH=baHiLbYpd5Z*yNUUom5Ea%EpJUomHFUol@XRAqQ{b#i4fL_}qCV=icPZER@*054)`Ze(e0XLBxSaBu)(X>Md`ZfA2}IB0NiE@*UZY@-A*IyzKga%W|9RC#b^03%^IV>x0oHa0LbF<~$@H#9S0F=aS5H)Az4H#jpnVlptJ1Ti`~bYXI5Wpr}@BVlG{HZ?M2V`OGzIb=9xVPrTlW;A4DV_`HjI59CYF*TzEF*-VQVRC0>bVF}-Zgc=6VPh~cGc`73Fk&$^WjQcrHD)w2Vlic7GGsJ2W??uvH=_hGIyz)!aCB%>bY*U1X>0%^VP#=6V`eckGBPzXIAk?3GBRd4Vl-lAGh${lW;8H2V+I5OIyy#jVQpn%b!KK|aztfwV*qn>a&=>LV|8M0b6+uEF=KCXWnVF0F=uRFF<&u8a$#*{Vs&O_WpYGib7L-ObZuD+9Wq2-VaBu))Z*pZ{GHGsOY;|O1UovBLVsCR_GGlLYWnVI9Wp8a?GIMEdaBO9GUpQ!Ra4u+cZEUjyG9@}XP;YZ|P;zf$Wpi_BZf8wlZeeF-awubOa%DO?XKXq;Qe|#rWpYGic4=c}CM+OlY;8I^b#`TAGARHfVKX!}G&DIlGBaW_WHUKqH!)){W->Q7GG#Y7WMg79F{K1lBeMiD3_3b;WpinIWhiHCZ8|!2c4cESDF7p3HaR$CI5RLbVPi2fWjAGEG-Nq2IWRF|VrDaAV>M+srvy|Avjj3KIy!K2Z+2;9Wl3&ub#y3DZ*z1|a&Kd0b8~5KXGv~wb#yEsV{dY0Iyz@;IyzKkcyx7gWimu503%^EF=Aq3GGa1gH8VM7HDWhmH90gkWj1CoVPP~iGdE+Y1XL)q1Tq3TI$>mFP+@a(C@BCVVP-NkH)T0AHD)w4WHmQoV>C5pGG;MkWMW}rFlJ^mGphttvjj2?Iy!P?ZEtpEP+@a(D06gVIy!S{dSzd9DF7p3GdDA4I5B2pWHvQ5H#Rh6GBIIgI5;siGc+?eFk?4ltprpHvjj38Iyz-|Wn*=8Whi5BZgX@XV{dY0Iyz@;Iyy#jVQpn%b!KK|awaJNBVlDQV>x6rHfA$sWjSOsV>w}CVL3EoH)CctH92B6IXABaR2;JeG6*_4aA9+ELvM9%bSNnxV{dMAbO0k^G%+$WF*rG9IX7ZCHD)q0He_NqIA$_6WH(}EV_`5gu>@2G<^}*dI#6$ObWn0{V`X!5X>MmtVQyh(WpV&xY+-YAV|8M0b6+uEF=cLNX>Mg-F<&uIZ*z1|a&Kd0b8~5KXH8*lVP|D>E@*UZY`6pzBRV>4Z((Fca&K)$X>4UEL349ubaN&wAY*TCb95jKa%Ev{CMf_TVKp*gI5#w8GBROfFf=tXV`VvFG&5voI5#sgWHvH1VYCD`A-Dt-DLOiHVRmIyZ$@csWhi5BZgX@XL349ubaN&wAY*TCb95jKa%Ev{CMf_TVPZ5lWM()pHDNb7Gcz(_Wic>iH8Wv0VK_84H!(9eGqwaaCsbv4bV71zWM^dnV{Bn_b5vz`bV71zWM^eAXmo9CQ33)lWNCA7VRU0?WpXZPaBu)~aA9;~Xk~I=IB0NiE@*UZY{Ud75jr|XX>4Uea%p5|WhirWWI8%@d2nT4X>Md?cqsrQVP-gCFkxh5Ib$?2Ib<B>kHZeFcH#K5pIJyK$55xo~8ag^`Z((F8L349ubaN&wAY*TCb95j4tiX1)YT9>fGEF*-VIZ((Fca&K)$X>4UEL349ubaN&wAY*TCb95j4UEV{dMAbRa=Mg-F<&u8X>4Uea%p5|WiDuRZEVN{EIK-8a%p4$BVjmXG&wmlVq;}wGc#p1He_XHF*P(aV_{=rVKz2nGB?NsEIK-HVQgh|bY%b|VKF!{Wo0xmW@0d6Ha9h5Ib<+nFgY?XF*h+|GiEhpHOK@kIy!J~b7^#GZ*Bl1VP!HhH8o*0Wil}`WjSLqWi&Z5WiU54G&yEAGBIX1Hemn&IyzB8O<{C$X?Os0baHiLbYpd5Z*yNUUom5Ea%EpJUom81bYWjHUolZaO<{C$X?QMZbZu-13IH!=a$#*{E@*IY0A_MwZDn6LXmD^YXmo9CHwOSOaA9+EE@*IY0B~V*b6+@UaBwbYbZue|qIWS`|&IBDgI#6$OX>@6CZUARtWI16nH)Sw2Gch${HfCWpF=aGjGc;snVPs=9Win+nVKp*lHDxejV>384IbvfqW;JCpH8C?VVm4zpWjHuEG0p@XIyz2oa&2L30B2!jIbkw4WiT}}F*RZ~W??lkWi(KlPbZu-SXJKSHVKO&mFf}tVHDWeqVKp&jG-5L}WMyGwV>M+mWi-$P9!GL%WB@l}Gh#4hH#RnAGBY$XF)}wcH#1{2VK_KpW?^DvG&tk{2Rb@ZWo~3;a%FNlI#OkBWMy(?asYB=Ze(S0WpXWWY;|X8ZZ2qaZEPcFVKy{1IWRe8Fk(4lHZ(J0HaIvpWn?%rVK8JcI5jzBW8?q_2s%1aWo~3;a%FNlI&x)hWMy(?a!_n_XK8LILv>KlPbZuDpX=G<*C@BCVVKOl|WnwX7WjJLtW@0pDF)%qaW@9)pVliSdFgG<~G}Hu2+5{*XIy!7`VPq&lb8}^Mb0#bxV{dMAbRa=)c|mh?WppMf03%^#Ib=CEV>CHoGBRaiW@2VBWHn_nWidE7V>vWrVKOt;1WFj%1SlXnI&)!mWhi5BZgX@XL349ubaN&wAY*TCb95jb#rJaR4gEMZgXj8Ze?U3X>N2W03%^EG&3+TVlg>5IASzqW;SMKVl^^mIc7LEWMMctVPZ7h1Wyl`0RTEWMRsLwbXRg|bY*e?V{Bn_b7OU4Z*yNUUom5Ea%EpJUomB4b6+uEF-3M|Zgf|2X>?_BE@*UZY~lnXIyz!(b!BjJX>N1?BVlAVG%zqZVK-rBWH~o8IAS1ZE$aLbaMbBVK_EnHDfk8Wn(clHa0nBGBad1V`E`tGGsP2HfCWlFy;mTIyzHhWo~5vb98cbV{~J6VsCR_F<&udZf9w3WnVF0F;in@Ze=cLbZu;x0Sh3)yC6hibYTE3WMOn+E@*UZZ1Myu5IQmFC`E2`X>@rkAVY6$aBps9Zgf<6aAk8KCMF;*E-onmBVjTyH8wCZGc{!~GBaagGiEX|GG%3CWHK~iH#0b6Fl6WiOdawBDhN6{a%F9Ac4a6@rh03%^JW;ZZ4G&DJ4V>o3wVq-C4FgP$_F=k<5GGjS5GdDHv1WX3<1S%3bI&*MgcWx+SZ*FsRAVO?)WpHw7ZgeIo03%^AV>dNpW@KeHGdD9iFf=zgIAUQjF*jm4HZnJ3WHn~+1WXW^0RTEWLvL+uVQyq|0Ap-nb8};LVsCR_F<&ubZ*pZ{F<&udV{>0IUok^(ZEaz0WOFWPbZu--1_Uo*Yyf69W;QiuW;Qi9Vq`NkVlpyiH83|gGchnWGB{>5Wj8KpbZu-Q0TwzsX>R~uF<&uhZ!TzbZEWob055QCb!TaAE@*IY0AX`;Wps02GH`5lXK8LMa|b!25~$0WMw&JGcqBLu_wzWhf~iV{dMAbO0k^He)bjG-NX{FgYc;WhhN=b#rA?bYXO5DF7p3HDhElVliYhVqs%sV=!bkWMyPCIbmWkG&nLfWHM%C2n9_F8U-r|Iy!A{b#rA?bYXO5C@COgZ*FsR03%^DVq-KgVKiYfWjA3mHexd}H8EsiHDWV2HZ@{7Ib<{n1x*GT1uGIdI%9HWVRU6fb#ilWawtP}a&vETIyzHyVQyq$a%3q0BVjgTFk)phVlZT4WHn-DI5S~kI5;t6W;kUvWjHxFHe(D0O%NIdD;YXEV|8+KZ*nMebYwa@b7*05Wn^D)baFgHb#ilWay}^lBVlD^Ff?X0I5IUkW;S7CGB#p4H8W;1Vq`cqW@I!qWo8ZqO&1ykD-=39V{B<~VsBw`WGG{AZgX@Xb97`nI&*Y#X>MmGDF7p3GBz+bV`DI8VPi06IX5>nWim2lF=k?7GcaZ`Vq;-35Cu&V8U-r|Iyz%)X>ek1VRB?BDIjBSZgX@1BVjjUVqs-vG&M6ZV>3BoHa9gkHf1q1H8VM8F*7nSV=xj0O$HhTD+oF|ZEs|0W@%+|b0{ewV{dMAbO0k^H8Wx~H#9dlVK6f`F*qrqGdMLc6a`HN8U-sBIy!K2Wpi_7WGG8zc`P7JZ)9m^X=QSADIjBSZgX@1BVji&H8?n8V>4nkGC4P5W-vH6Ib<|pGh;S1IWaLdI5idpO%xghD*`$?aBpmEMRsLwbaN;v03%^xI5IF{Fk~<@W-(-CH#TB6H#9IfW;0_rG%{f|VPa$$1x@q>06IECVRL0yX>Me1cK~B-VRLh1bz*OGUol@XV{dY0Uol@XX>VUKUok>qb7fa)Ze(wFE@*UZY%>KT0y;WlY-M3`C@BCVVK-wpWi>H3F*sy0W;SCoVlg>3H#Ik8HZ)-|W@IuoIU5BMmGEFfcVZgX@XVsCG3CMf_TVK`vc9IWjR}V>dHqGc{u~F)}z}Heoh5F=8|_V;u!WA2S6bCptQ3WpqMsZ)_-IZ*FsRAaitNIy!T7a%pa7CM+OhZ*FsRAYyNCY$honV{dMAbO0k^V>UBkW;Z!GWMMI4HD)(9HDh5oV>C81Vr67DWin)C9|c7vGX*0kIy!S@bW?P4X>MmIV{dMAbRctdWI8%?baH8KXC^ElV{dMAbRctdWI8%?baH8KXC^5CBVl4;GdVb6H8V9cHe)t7VrDQjFfcPPV>MwiW;r-!V>uxOMJ6)^BQ82RXJvF#baH8KXDDNDZgX@Xb97`nI&*Y#X>MmGEFfcVZgX@Xb97`nI&*Y#X>MmGDIjBSZgX@1BVlD^HZwV5Ibt$qG&o{5W;bSJIX7ZqWM(;LF*PdQ4H!wFfWMnfmHf1tnF*Pz_HaB8oFkxddH8&*%MHe##BOf|CXJvFrZggd5WpXHEZ*FsRAaitNIy!T7a%pa7CM+OnZgeRiV{dMAbO0k^Vqq~fG-PEnH8Ex|V`4dGF=8+_WHDqhG&D3hWn?lqCj~_vGX*0YIy!S@bVP4;Vr*q7V{dMAbRctdWI8%?baH8KXC^ElWN&q1Y-K3`BVlD>H)A(pHZf&pV`ea9Fg0OiIb=9CF)?CeVK+5pGC3&)MH({&BO*FFXJvFmZ*^j9Whi5BZgX@Xb97`nI&*Y#X>MmGEFffWbz*E~DIjBSZgX@1BVjl>GdMRhH8y2qGiG5nIAb<3HaIylIc8=vHDftrWH&1XMIbW;BM~|}ZDn$2Whi5BZgX@XQ)P5?X>Mn8CMf_TVKX&3W-vE4F)(2>Vqsx7Vq-C6F*0N|HaRh2F*h<|Wi16o4>1KL2q0r`ZgX@1HDh8pGdVdjWn(xtVL3H8I5T8nWivN8G+|{nGGQ<Mn80Ap-nb8};LVsCR_F<&ubZ*pZ{F<&uLWps3DZfA2YXmo9CJq0g1I&D&AZe(S0L}hkqV`Ts%VPs=AW@0loGGaMpWH2^2Fk&+~WH&K0Vqs=tVrDlrFg*n?89F*pZ*z1|a&Kd0b8~5KXHa2tb0}kPa%DO?XKXq;Qe|#rWpYGic4=c}CMf_TVPiNlHDP6BH!w6gI5jn7G&DJ6FgYMmpZg6#UEFfcVa%DO?XKXq;RAqQ{b#i4g;((?pAY*TCb94YBVK_EpG&eRiWHvH0GBjm2Fk@k1WHe$hG%{l_W-u@^H9G}SIpzicIyz8qb97L0Z)0V1b7^j8P+@a(0Ap-nb8};LVsCR_F<&udZf9w3WnVF0F;H)FbWn0{V`X!5X>MmwVRLgXXmo9CQ33!jZDDXUpQ!Ra4u+cZES%C06IESVRLk4a#M6+bY%czY+-YAV|8M0b6+uEF=KCXWnVF0F=uRFF<&uhZE$Q~F<&uKVRLk4a#M6+bY(7RbZu-y1t>Z?aBp*IbZKvH03%^xH)UmIVmUE1F*!3bWH31~HDxeiVPZKoH#TN6GczZ?Zf|mJVQc^+VKq57HZnCdGdVReVKXpeI5RM1H#lQBW@a}tF*Gw`W2{mHZ?XiGd4CfWCjEPIyzQma&%>Q0CRM5bz^j6bz*OGUol@XV{dY0Uol@XXKY_FUolo?a&%>QE@*UZY)SVq1t$VJI&W}ga$$6Daw;e(03%^BGBq+{Fflb_GB;r}WidEqHDoe5Ib~!pV=y!}Gc`6y1xc6z06IEXa%psB0Ap-nb8};LVsCR_F<&ubZ*pZ{F<&udV{>0IUols5X>?^SXmo9CQUx?RI%HvVVE`jxIb$_rF*RalV=*!}Wnp17H!x#lHDoY2Wj8rxG+|;kQUx?RI&EoiOl5XuY(sB#Zgc=6VKHT7GBRW^Gd49jIW##pIWjadH#cQuH#lT5GdDRiWl{w+Iy!f0WOQf%BVl1TWMX4AGBi16HeoPhH)CWsV=!YhG&5v1WHmB3Vq{VUG&(wHWoc(tZDDY8C@BCVVL4+nF=b(7V>V+kW@BPwVKrtoGh$|8WMMcpHZo>1F;xXpfd&9NIzx40Wldpl0Ap-nb8};LVsCR_F<&ubZ*pZ{F<&ufY+o^7F==gZY+o^7F++7?WldplE@*UZY+402Iyz@^X=DH+VKFfLV|8M0b6+uEF=cLNX>Mg-F<&uKWo~3;a%FNxa$#*{Uol@XL~>zwLv3U(Xmo9C<^}*dI#6$EZgfm(XJ~W)b98cbV{~J6VsCR_F<&udZf9w3WnVF0F;H)5Zgfm(XJ~XTXmo9CP6h-oXKVmtG&3utFf}dKqFfwE?Vm4(iXmo9CVFfHYI&x)UWB?;!Vl_B5GGk$5W;kRrG&49hW;tRpFg7@0VqrBmH840cVFfHYI(KqubaZ8I03%^GVlZVfIAvmGVlpvdWH>iBF*ho0tG-WYiWHB=o0{}^GW^VvFf(H~WivJ~VKiblW?^A5WnwpGVmD<4EIK-9VQyq>WdI{#Wj8P|H(_EoH#TK7WiU5kWMnlpHZ(b7F*7(aW;iu7<^}*dI#OkBWMy(;Vr*qca%p4$b98cbV{~J6VsCR_F<&udZf9w3WnVF0F;Zo2WMy(;Vr*qca%p5PXmo9Cj0G(aIyzNuaA9L>VP|D>C}VGKb95k3VPk7yXJsZS03%^$H#cNCF=H?{HZ(amF*IXkVlp{qIbvfsW-(%6H#szB1y2r)1uY3WI&x)UWJx$EX>N2lUvwrZ03%^BH#spfV`DdCVr4gDG%{o~IW;(CH!?I~VL4?qH(@qt1y2Wz1uY6XI&x)UWJxhLC~0nVF*aXxCMf_TVK_NAFf}nbVPQBhGc++dHDWL_V>xDHV`E`tGdMP7HfjY=2#f_S3OYJ+WnpAVGcqV?Zgev;UvwrZ03%^#I50FaW-&ElVr5}5I5T51W@9%qGB!0eGBIOgWj8l$1y2Z!1uY6XI&x)UWJxwOC~0nVHZ)&!CMf_TVK!lAHezBiH)LgIV>mfwI5spnVKQN1VK8E2V>o1HWNrmd2#f_S3OYJ+WnpAhI4E^#ZgeN2gGGBBiDF7p3IWjdjWjJPJH8o-~F*9Q}IA%0vW-&7~G-WwCVPj!3bOlcdj0G(VIy!P?VPsV{G$?gxZge&@UvwrZ03%^AG-6~hG%zzXH!x*2VmUZuWMwsFIX7cBIXGrGHe_RV1y2c#1uY0VI&x)UWJWVGC}wPLVRR-b03%^zG&eCaGdMUkHeoYiH#uTqWn(g9W?^GyW;ru5IW;qQ1y2Ty1uY3WI&x)UWJWeLC}eMSVr*q5DF7p3GBP$aGBh|gH!x*pGBh@3He+HpG&3?`F)(2{Vlp^kdIe7hj0G(RIy!P?VPryYZ)_-HZ*OcSDF7p3HDhEjWi??iIW}cDWnwiqG-EJjWi@0rW@IrqVL3H7d<9Phj0G(YIy!P?VPsQua%pa7D06gVIy!T7a%pa7CMf_TVKOx_Gh||7VK`+pW-?+oV`X78I5;q3V>CE2HZV9iV}1os42%UW0y;WkWoKz_Phx6iV{|Af03%^IGBY_iW-~Z9IAJw8I59IfHaRphIbvfoG%z@3FgP)Q1y76xEdn|^Wo~3oVrpe$bSNnRBVl7RWjHftVPrKnIX5_CWH~W0Ffle_IXEykW;bIpGBbh&PmBdE0y;WkWoKz_L2`0oc_=9WBVlG^VrF4CG-f$7Gi79CGGk+8WH~i3V`4F7H8C?|HD!baPmBdE0y;WnZe&4na$$KWDF7p3VKX#gW-w!9WMVO6H#0afGBRdjG-GCFV=^{4H#Rjih6PWI1uX(PI$~vKX>LSmV{~b6ZeenHC@BCVVK8N8H#9Y6F=aC{IW;#lV>vcqW;ru6Wic{hF*jr}Gl&IGj0G(MIyz-;WJGCWbZKvHVRCsWDF7p3V_{@sFf}$gI509}WMO4AF=8-cGB{;qFgGzWVPQ5niUm($0025VRc>%$V{2h&WpV&xY+-YAV|8M0b6+uEF=KCXWnVF0F=SzMVP7#{F;#AGVPk7yXJv9OXmo9C)&(m%I&*YnNp1imVKFjcVK`)FW;0_rW@9ljGh{esHDY69W;Qc2FfceYGu8zwIy!T7WKVT;03%^xF*0Q}WnnX7F*IT`HD+RAVmUZ6WMeThH#KB6G-YAd1uHr_b97`ya&iD8VPiQsGcaQ_H8wV8VqrODVlX&1WjAIsI5uK4W-w%8G}Z+x0y;WVbaG{3Z73-KBVl7TGB`6aWMedDI5RmjHa9XjHZ(S4Gh#V2H8VM6VKdQsF=aV7GdMG5H#K5rGBjo|HZ?Y7GBY(}IXRLAO$gQnD-Sw4Q*?4=VQna5Z*FsRAX9X5Wnpb5DF7p3GGs9|WHmB1IAUgFWH>iBF*RZ^W;QT1VmW1DF*Gt|lm$%<)&(mRIy!P?VPq(FZ)s#IEFg1qWI8%?X?kT}bSVHMVK_N6GGaJ0HfA_5G-5YpWM*b!W-&B0WM*MBG&VFgG?oQT64nJP8ag_6a%psBC}VGKb95kfZ)s#IEFg1qWI8%?X?kT}bSVHMVK+E7HDxtrVK!o8H92B1V>mZrV=*#iV>xCvIAJn1W|##{7}fdE1GcY+YG%_(XFl07lF=jY4V>M$oHD#IwO$OElD;GLCb7f^~C~$OgWNBt*Uvw-WQ)OjqPjYEzX>KV1BVjl)FfcYZVPRusG&NyjVPY{jWo9&EH#s$AGdN>mWj34zO%>J!D+oF|Wp8FEDIjBSZgX@1BVlD?H)CTkGc#p0W?^GCW-&BkFl1t6WHMznVKq2rGBlnAO$OElD+oF|aAjp{C@COgZ*FsR03%^zWoBk(I5uQ6H)CWuVrFDAH!(0cG%+${IAt|4HZ(P$1x*Il1uFtNI%j2cC@BCVVKp^0W;0|qH#KB7W;kPJVq{}7W@BMwFl8`gH8wFZGol4e)&(mDIy!K5bSPtJVR9(|BVlGSG%_<~G&V3WFgG(~I5}i8G&C|YVlg*jG&VD2F=nI%O$62jD@8gwa%FLKX>w(AC^|ZGbYwa@X>(s`Zggd5a$#&=c05!*ASNatIy!T7WI8%&b6<05XKrO=Uv@lHJ}Dq}Z)s#8aB^vGbSP9Hc42IFWdI{#F=I0{HDWSiGBspnF*7t|He+FBV>LH1WI1GIH!(3erUgwy)&(m~Iy!P?adl~OWpgMxI&*YnIyz}{UukZ1WoL3>Y+rUfR6ZakCLkd?I&*YnIyz}{Uvp_^Ze?U&c05!*DIjTXY-w&~Aa-wQWFT;IX>N2VR3LU?Y;|P-BVlAVG-G9BH#9k7GG#M2F*7k`IW%K6VKz58Wil{kVPdESO-t4VD;7FBaB^vGbSPhGB-CcVrDmHFk>(@HZwD3WoBbBH#j$9V`O8j1x*#!1uGOfI&gAnZgePSY;R$7EFg1qWI8%?X?kT}bSVHMVK^{2Vq!HlFg9g3H8f*pFfw8>Ffe5|W@2SGFk&<_VXg&D64nJP6*@X_a%paKC}eMSVr*qBAaitNIy!S{dSzd9DF7p3G&49kIAUTrWHLB6WM*SCWH2*0G-75nW;Ql5H(@w8umw#M)&(mKIy!K2X>N2VV{dMAbRc7BVR9-d03%^CVPQ5oV`gD6V_`5dW;11FWi)1GF*i6fV`OGBF*G@{1x*Xq1uGglI&gAnZgePPZ*FsRAY*7@aw;q!b97`nI&*1yWnXkD03%^DFgG=1FlJ;qWier7H8eP5VKOjbIb$(mI5{;rFg9eg1x*;%1uGUhI&gAnZgePPZ*FsRAUZm8bYwa@b98cPZf7Pb03%^GF)}kVW@I^GHDNe5GBh$|VK6l~W@R>JG&L|dFflo{1x*yz1uGglI&gAnZggfSV{dMAbRc7BVR9-gAXF?MR6%lQb1p6}DF7p3WHwN38C}VGKb95kMXkl_HDF7p3VK8AbGBhzVWi~f3WHU8oIWuHtG&VRiVP!aCHaRyjx&=)O)&(mTIy!J+a&u)UX>N2lUvwrcAaitNIy!S{dSzd9DF7p3Vq;}yFlIAlH)3WsI5lNCG&E*5I5;t6H)1w5F)(E{yai1Z)&(mUIy!J+a&u)UX>N2eHeYlmEFg1qWI8%?X?kT}bSVHMVP!EgFf}tbVPs-vGcjXjGGa7jW@KSvHZ(Y7HDot3H@*c;71jkS7dkp{VRCb2C~0nVGcsRvCM+OxbYwa@b7^{IUvwz|BVl1RGiEk6VPj=5W@ct$GBYqWHDqIEGBh|aFgRs1Gd92lO%>J!D;GLCaA9(DWhiNGbT%|!bS5kyb97`nI&*1yWnXkD03%^HW;bMHHDqFCVq!F7H#0FaH#s#mF*9N^GB7bRWHKN2lUvwrcAaitNIy!S{dSzd9DF7p3F*##7IXO5pVPQBmW;r=!Wo9)pH!)>3WiT=}WHL25#05U52I5B28H!?RiF*am0IWsb0IAvxwW@ceF$OTOn)&(mVIy!J+a&u)Ub!l#NHZ)&!CM+OxbYwa@b7^{IUvwz|BVl1=IbvftGiGKvGB;*9Vl!r8GC4VAI5T5oIA$2HSbYwa@b98cPZf7PeAY*TCb95kMXkl_HDF7p3H8V0aWid7|H#K8nGBq@2W;kOvVPa)wGB-6fVKQcB&;?By)&(meIy!P?VPsWqbZKlTV`yP=Dl8y#bYwa@b7^{IUvw-WV{dMAbRc7BVR9-d03%^$WHn@CFfwK~WMO77WHB;0H#Ih9VmV@DW->ToWHdO^1x+8;1uG3YI%#KaZ*pZQb97`nI&*1yWnXkD03%^EH!(CgIc8-xWMO4xVl`$oIAdaAG%_}0VPax4Vq#^~1x*WI2>?1eQ*?4=VQm0oY+-YAV|8M0b6+uEF=KCXWnVF0F>PgSZ*qBGF<&uLbaG{3Z7yhZZEW8KEh9QQMRsLwbW&wuWMy(FV{dMAbRb1`Wo~p(X>escR6ZswAaitNIy!S{dSzd9CMf_TVPs`tGGjF`I5IRaVPr5cH840eFgaynV`OGDW;0@DG}i@BA>Rcp0y;W!Wnp9}DF7p3WH>lsVP!WtG-YIEVK8H3GcYzcG&nS4WiT^kGch?Z*#%GE1uX(PI$~vKX>KSf03%^#He+OCG-Ek4I503}FgGKmH#aq6WH2}~G%_+VVmM_sV>vNoH!?9~W#9!+5b6ak4LUkfWnpATbzyR3C{kr%WJh&ja%3hZDF7p3WnnilHf3UCWo0#HFkv=iWMwmBIWaJ0GB##1WHM!C;ssC(>IE(cIyz@%bSNnxV{dMAbO0k^H!)&iGBPz{HfCjIFg9W{HZWmkW@2S9I51&jWHmQ8IE(cIy!G~WpZJ3Z*nRqDIjBSZgX@1BVjpYHZnFdFk&}3VL3H1W?^PxWn(ZjVmM)CH#adgG-T!lPzLG+E(kh0Z*XODVRUbDEj}nIAY*TCb94YBVKp%~H8x`~W-v4|W;r-GWH>ZtHa9t9F)=eRVKX>lFz5wP244vPIyzEiVPr>jVRB>uV{Bn_b7OU4Z*yNUUom5Ea%EpJUomZEZEtdUUol@XQe|OeM|ELxWG-lQZEWTS06IEBa%XjIWo~qH0CRM5bz^j6bz*OGUol@XWo~C_Ze?FFUok;)XLW65Zgg`lXmo9C@&z&)Iyz-;bZK;XC}VGKb95kcbYwa@b98cPZf7PbAY*TCb94YBVPr8mVlgr^GdVOgIWjn8WHUH3IAmdBVmUc6H8C(bGVBFZ81e-&6goO*WppTGZ*FsRAaitNIy!T7a%pa7CMf_TVK6c{Gchz`Gch(WV>C86Gh<<6HaRk6V=!bkW-&2hX6^-467mHyD>^!1WMn8~Z*FsRAaitNIy!T7a%pa7CM+OBZ*6dIZe?zCRC#b^b08)rATBO0DF7p3H#IdfGGQ=eF*P+cI5lN4H#smlGB#p4H8?h6G%`42@C8&UCIcoyb!lv5WpV&Qb!lv5WpXZPbZu<=1u_mgIzeuEQ+acAWo=h-VQ_F|awt=Ib97~GNp5CuCMGEWBVjRQIAUZuHa0P3I5=ftW@I)tV>4x8H8eCiH8WvkGd1%CR1EtCG6*_4aB^jEVRB_CS8sA`WF{#9BVjdTHZ?V4Gh{L}HaKBqF)?LjVmUA|VPj!5G-YODGB))ER0jJ6G8j5KV_|G;C|7TCY-A=ZAVY6$ZDDR?LUm?lWpXAd03%^#WoBbDV>xAHVmC2iV=yx|Ib|_7H#sq5F*P}1V=-j+1ymOM1u_UaI%#fZZzw4sV{dMAbO0k^W@TY!G-NO`Wi(V>QV{dMAbRcJJZ8|!3Wn(iYDF7p3W@ceCVPY^aVKX^6WM(usVlZPlIWRC{VK-)CIWajn00vPI7zQsAIy!S@bXH|-Z)0h6c_?FVZgX@XXKZacI(B7aGbSkjBVl1-H8nFhVlg&1WMVL6I5IM2GB7z~GG#boGGsVqGcf`NQ4kmgF9$k0b7gc#VQFqCW^8X^bSVHMVL31~WH(|lH)AlWMMZsVlp>lIbvfrV=-nnWoBk!GBz_fG6n`w1sDb|20A)(Wpqq$Z*XaDXDDKCZ)_<5BVl4TVq;`BV`DcnV`VomW@ckFH8W;4IbvZmGG$~qW;O^0Q3MzUF9td~b7gc=Wo%(|X?A5OVsCG3DF7p3HDqQoWHT@~IAk$1Ic769V>3B3F*Y}5GdVdoG&wOf3I6HDhHlHez8lG&eG2VmDV+qWo2bHH8Wx~Gc_|fHDxwsW@0g8VPa-xVPg;mQ3V(VFA_RBb7gcxZ*FBoX>w&_bZKvHC}VGKb95kQY;8I^c4cETCMf_TVPP;cV`4XDW@cq(GGt|8He+KmF*Y_eV`MmGH#jphW)cQb5Euq82Rb@)Wpq+yW@U0^ZewLcX>)X8ZewLAW^8X^bSVHMVKX=|Gc;y1Fk?43Wo2bIWn(fhH#RqAV`MNjVmCH8W)ucd1sDb|0y;WyY+-pQDF7p3VmLEpWH~f4GiGLDWidB1VPP;iFf=qVG&3UBnVP#}AWHmD|F=I71W@R`z9|l4?I&x)UWKCgnYXBo*H8LL1`IWuHoGB7e?WFH1XIyz=@Z*Fu(VPj0&rF<&uLbY*U1X>2ZNbZu-=0st>=b!=>3b98TVVP|D7XmD@sHZw3bFkxafH)1YmbZu-b1|}FfI%j2cD06gVIy!T7a%pa7Uv_C_cPSuaZ*FsR03%^#G&eXkV>dEnIA%3rG-WY0W-&K5IX5sfIWu7~H8eLO21phx1|}prI&)=oD06gVIy!T7a%pa7Uv_C_cPt=tbYwa@b98cPZf9S1X=QgQ03%^#Fl9L~VKFu|IAdWoH8(IaFlA#gFkxe2G-GCAGcY$K21p_-1|||ZI&x)gZ+2xUb97`nI&*Y#X>MmpH#TE7WH&iwVm3E5H8f>0G%=$DEIK+=Wq5RTa%D0^RAF*wWpn^vF<&uMWq5RTa%D0^RAF*wWpplRbZu-01PCC)yC6|@VPtY)WN&i-Epc^WWO89-Z*wkabZu-(1|<+WIzeuEL349ubSQIlWI8%-b!=>KbaG#GDF7p3W;HoBHa0mpHD)(vG&L|}GdD10Ff%!2IX5;kWMedAFa}2sN(LnjIyymac|mh?WppTYb!lXCIy!ZAX=Et?BVlG`F*!3fG&5s2W@IvBF=1peGBYq{GdVG3WH&ivIXE%~M+-^@B@#M1L2h|Lb8}^MD06gVIy!T7a%pa7Uv_C_cPRiPVPj%3WMnrqGhsA1Hf1njH!);pWnwuvWi>J|VKOmeWHbgx5K0Cm5jr|SZh1j-b7gcWV{dMAbRa=)c|mh?WppMf03%^BGG;VkWMpD8V>f0qH#cK3H8^HAF*ji{G-WU`FgIZ~21gG{1|pVKZf8GBsf^FgRj521gG{1|+`IXPx!Ic765WjHxyGcz|hVrDoqJ_bhyN(LneIyz@%bV+0=DIjBSZgX@1BVji&WHvWpF=b^lH)A(5IWjk4IW%Q4W-?(oIALXFGBiL2M+Qm;B?vk?X>(3>Y-}hgAY*TCb94YBVK*^iWic^jG&nLdFfm~`H!@)`WI1LvF*G+gW;8Q1G(rYP21*7c2s%1xb5nG3Z*FHODIjBSZgX@1BVjZ(H!@~0V`egDIWjjlVr4aAI50CdWHm5hVPiKpVK+nuM+Qm;B?3A+ZDDI=S7l*qC@BCVVKXx@W;ta!IWaajWo9v9VmV}DWHK``Wn^J8GGk;lHAV(UN(LneIy!G~WpZJ3Z*m|(b8}^MJXAg?DIjBSZgX@1BVl1VIAdfsV`E`7WMyJwF*i6iW@a!jWH(}FWj8QkGBHR7M+W8w06IEBZh1j-b7gb@V{Bn_b7OU4Z*yNUUomBFXK8L_Uol@XL2h|Lb8}^ME@*UZY*7LLFJo_QaBps9ZggL5VQyh(WpXZPaBu))Z*6dIZe?zCUteuuZeeF-a$h)TaBwbYbZu;X0{|~~X>Me1cP?mfZ~%8{Ze(wFUpQ!Ra4u+cZESo41TS-CbaZKMXLDa^ZgX&DV{~tF0A(~XV>x6uI59J2W?^DEIXE&lW-()8HZU_eIAb$rVJ>KNZERz2a%BKyX>wmSV>mfCWMnxvVr67zGdVFdWo0;FG-NquH)b|9G&y4~Xmo9C<^~u#I%#ciYye*|UomNIaBMDUbZu-@1~mdYI&EQaC@BCVVPs}7F*0LeH#RtBI5spkG&MG4V>2~1W-u~0He@q5GEfFrR0cHyIy!Z3ZDDXIDF7p3W-~H2V>2{kH8MFiWn(a9VKOo>WnnNgHZ)^qVq;}8QU+In1^_xbR%LQ@Wq3k$W@cq_0Ap-nb8};LVsCR_F<&ubZ*pZ{F<&ufY+o^7F==gZY+o^7F;-=AbY*x#b!KK|axQ3eZERo$D>^!GZ)t9Ha{wb@GdW^8VrDrrFlI9`G&V40W@9yFGBr15HZU}0Wo9sCU2cx03%^yV>LH5VKQMjV=`i4Wi&WtF*jl~G&5piW-v5lW;kJ322BuP1}h{wI&5ifWhi5BZgX@XXKZacI(B7aGbSt`V{dMAbRcJJZ8|!3Wn(iYDF7p3H#9akVKFc^Fk@k4HaRdfF*0RjG&C?aGB;#3FgP=1S_VxbUY-K28Z*FsRAZKiCIy!b`V>2c!AY*TCb95kQY;8I^c4cETCM+OhZ*FsRAZKiCIy!dZfTk$`BVlGSHZ?h9W->83V=!beIb$$2Gh#9^VKq2rGGjJoGB8{QO*3EyD>XVgbY*mMVQ6J!a&K-ZV{dMAbRcJJZ8|!3Wn(iYEFfcVZgX@XXKZacI(B7aGbSt`V{dMAbRcJJZ8|!3;((?p03%^xW-w$oWHn+iWHU5oIWc2lVKp=~V>n_qWoBYHVL3Bi22C?T0suNXQ)z8*Y-M-=b98cbV{~J6VsCR_F<&ubZ*pZ{F<&ufWp8a?F<&uLX>D+9Wq2-VbZu;D1}O?UI!|zPQe|OeC}VGKb95k7Dk%UXVPrQpGh;VqI5J~2VPs=sHeoO@H8V0fF*9Z~F*PtXWnl(O2x$f>2s%1%aAk5~bZ>GkJ}4<5V{dMAbO0k^H8x^0GG$^kGGR72F*7(cIW;meWH~uDFkxaaFk~|@V+KnGX$C0>Iy!G~WpZJ3Z*nRqDIjBSZgX@1BVjaRV`4F7F=8_^VmLHrV>o0sHZd_XIc7OxGh{VnFf?TbO9p8MDF`|`Z*XODVRUbDAYyNCY$z!pV{dMAbO0k^G%;f{I51;oVlg;nGht*mG&V9YWj1CwH83|gGdDCbX9i0Km;nGfI!|zPQe|Oe0Ap-nb8};LVsCR_F<&ubZ*pZ{F<&udV{>0IUolT`bW&wuWG-lQZEQCO054)}Z*OfbXmD@LV|8M0b6+uEF=cLNX>Mg-F<&uLaBp->X=iA3E@*UZY=H&V>{IB0NiE@*UZY(;osZE$R5a{y&{VQp}1WpgfQbZu;R1}qIaI%#fmWpZ>Vb!l#NGcsRvEFe@V03%^JI5aUgV>V%8Gh|^fVq-93WHe+rWHdH0VlrbfIXEzH22Kli1}q9XI%j2cD0OLWbTcwvbSVHMVP!UDHDY6AGi72jFfch~V>f0pWHe$lGBIU0H)J+9FmVP>2yq535Flf3ZgX@1G&4CkF*Gw`IAk$1H#RU~Gh=2jIX5&hV_`WsW@9yGa|TWhcLpp9Iyz-?VRL0Db!l#NGcsRvDF7p3W;rurG-5e0GBz}3Wiw=BH8(ggV>xCqIb$(oWH)9sbp}odm;nGfI#y+4Q*>`~VP|CkV{Bn_b7OU4Z*yNUUom5Ea%EpJUomB4b6+uEF;-<`Q*>`~VP|D7Xmo9CdD+9Uol@XRAqQ{b#i4fL@sD_ZESG^055QCb!TaAE@*IY0CsP9Wo&a_GH`5lXK8L8Lb6+xLZggpMd0$^?ZgX&DV{~tFUovoPb!TaAUpQ!Ra4u+cZES!BBRV=}VPkY}asVS?GhsG1V`MR5F=IGnVL34~WMwcgW;Z!9IWuB6Wo0op<^}*dI#Xj|Y-Ip*baHiLbYpd5Z*yNUUomBFXK8L_Uol@XQ)6LlWiDuRZEOYv96CB_ZE$P=Uol@XX>D+9E@*UZY?uZj0y;WFbz*OGC@BCVVPs}uF)%e|IXPovGiEtCF=I6}GB`3dG&C?VFg7tcH-ZL4mN2ZAY*7@aw;k*03%^FG&C_`IAmjEF*q?|GdMIgWo0rkGc!3gF=RP4Wn?jg21E;(1|ktUI$>mFP;7N)X>KTXZ)s#GDk&&Kbz*OGCMhWZBVjXPVliZ4H#RdeH)JzoGchzUH8y5sWM*SEGBIQ_H8X|=L=Tt-A__V>VPs@dWpi(Ja${vER6%lQb1p6}DF7p3Ibu0CIbkwnFl0DnHZn6eIW{&nH8D10WMO15Gc__fhz3LmmMmGDF7p3WMyV#W;r=HWo9)sFgIakHf1+7V>M-BHZWpiW-u{kjs`>$mQ6H)CNmV`gMEFf=tWFf}+eF*7)0V>mQsFp>sD0hk6N13Ef$bYXIIb#PO8b97~GC`Ks&BVlA>H8?Y7VL4mQ8H#Rb2G&VFgIX9FBL;;uvA_6)(a&>MfDF7p3H)J_CVlXf;Gc++WGB9E>VL4=BIWsmgFgQ3cH8W)}mIg%T1^_xbLv>B`~VlXx}Ibt2-_V>C4~G&VVAFq;NM52*$s3_3b*aAk5~bZ>G!C_!#{L349ubS5S#03%^JG&W=~F)=k}IWl8rW-?`AH8U_YWid5mWH2}|V`FBW21E*}1|kqTIzeuEL349ubSQIlWI8%-b!=>KbaG#GDF7p3W;HoBHa0mpHD)(vG&L|}GdD10Ff%!2IX5;kWMedAp9Vw@sRkkqIyymac|mh?WppTYb!lXCIy!ZAX=Et?BVlG`F*!3fG&5s2W@IvBF=1peGBYq{GdVG3WH&ivIXIyPL<^|~A`&_}L2h|Lb8}^MD06gVIy!T7a%pa7Uv_C_cPRiPVPj%3WMnrqGhsA1Hf1njH!);pWnwuvWi>J|VKOmeWTOT|5UBf0qH#cK3H8^HAF*ji{G-WU`FgIbP21F031|kePIzeuEL349ubSOb?c|mh?WppMcDF7p3Wid84Ib|?0H8^BuW;HcoVKq2nG+|~kF*7kRIWuNsrv^j{<^}*dIze-DWpn^zY+-YAV|8M0b6+uEF=cLNX>Mg-F<&u3b8}^ME@*UZY_0}3Iy!D)ZDjx>VK+5pW-&Q1WI19rIAvluIX7WsFfuY^Wo0!oHaKKBVy*@^Iy!G=W^-k903%^IW;bRqI5{*iF*7$}Ght$6H8(UlIbu07HDNF{G&f?d1~)o7b7^{I03%^DWH>f6Fk@ypHeoPkVKp#iWn(ZnGcq_iH!(3|WHdOg1~)o7b98cPWMu#&VPa!uI5{#hW;ZxwG%z?bWHDxDIWT23VmLE5G-WtAG6nL22Hexn0Wi>c7F*i6dF=9DmGBji|Ff(K^V=}b{FgiM9b94YBVPrUAIA&&LVKXo?H)c6yW-~crGcYqUHDfe0Wi(}BWVHq`Iy!G~03%^CVPRu4G%ztSI5=WBHaIysG&eG0F*YzcIAvipF=I5f1~580V{dG4asVS?HZ(G0H(_NkH(@X`VKz55H8Wy4FflbbF)=eSV`5@BwFWRcI$>;ZXkh>&VKZT3WM(lkWn^PxH#9XgHZU_bW-(-DHZU|dIbvouI0gg&IyypZWo~3sbYXO5L}hbh0CRM5bz^j6bz*OGUol@XV{dY0Uol@XXKY_FUok>#Wo~3sbYXO5L}hbhE@*UZY?lEGIyy~dZEtdUIyzHjWou7zX=iC}04;50ZEtdUE@*UZY$Io3GhsPnVPrWtGc;r{GB;*9Wo0-qIW%E2V`XAFWn^M7mjMd{Iyy~dZEtdUIy!TAVQ@lubY*iWR4D*0ZDnn5a(OOjbZu-SXJKVFIAu0tGh{bmVP<48H#1~3WjHc8Vl_21WM(ulV`jGoIsumf3j#ViO=WFwa(OyBX>&|zbaZTGMQ&tiVQwfX04;50ZEtdUE@*UZY$Io3H#lWDW->HoVm2@`Gh#V8V=^-`V=`kmHZd|eHZx>6xdu9y0Sf~nVlXu~VPR!tI5RmoF)%qXIWjpkF*Gv0208(k0Sf~VAc`j&lZEPcFVKg`~FgZ3dV>V$iGh<;fIALXFF*sp4H#KEtV>UBmX1@kH0ha*_13EfQWo>VAc{)0DZ$fEjMQ&tiVQwf?DF7{PWo>VAc`j&lZEPcFVKp=|V_`HmHDNR}IWl8qWMMfnHD+OAHe@+6Ffd{=Ho*ou0ha*_Ai}#KO=WFwa(MtPZDnn5a(OOjbZutZDDY8C@BCVVK+56V=*)|W-%}@WiVqgFgG_fV_`TqG&M0eW-vKrWyS_nfd&9NI#gwNbairNGeiJmY+-YAV|8M0b6+uEF=KCXWnVF0F=uRFF<&uhZE$Q~F<&uMWq5RTa%D3_E@*UZY#{~&FJ@_MWnXh;baZKMXLA5$Gh|^lVK8JiIW=ZsG-hF9HZ*2tH(@bkWn(d6G-6^dXmo9CQ33!jVPj)ub8~NUb1rCbZ~$RrV`X!5Z*p^AIB0NiE@*UZY*7LLFJ*RRZggL8X>esOXmD@esVKp%{HZ(ajFg7(eGG;h3GB7zeGGj7iF=RD1Wo0sDGRy`}3)BWI3OYJxWppTYX>N2gGGBBl03%^HIAk_vF*h_ZGB#l{W-wtgGBG%0Ha2B2V`eZoWivU>22Kdh1}+dFV{dMAbO1RrI5T5mF*!G8G-P2iH)1n1F)%S>V=*^nFgQ0fWHrzRP7c%tEDAb0WpZJ2WhixNZgev;Uvwz|BVjgVVKg%|VPZIAVKX%|GC5;rWnwmFW;8i4Gh#AiH#5=(P6(I*06IENVQ^D)Z*pO0WdLJrVRLh1bz*OGUol@XV{dY0Uol@XWn*(+F<&uFVQ^D)Z*pO0WiDuRZEV>FEe|?6Qe|OeQ*>`~VP|D1Qe|OeQ*>`~VP|C~CMf_TVKZhlVq#%sGBGz{GB{>8W@9-vH8(M0H8o>3I51^4H`NAD4cP`Q2s%1vWppShAY*TCb94YBVPRr8GGsJ4GB`3}H8EylV`MimWMN@tHDfh5HaRn5G1mr924(^wQ*>`~VP|CkQ*>`~VP|D7Xmo9CP6h-oXJv0~0An#^Wo2eHVqs=9F*7+cVPrUAIXN_AGiGEpGi5e1W-e%SZESG>055QCb!TaAE@*IY0Ap`#Y-w|8Z*Fs6GH`5lXK8L(ZNfP4*Cloq5V{dY9WpZ;gC}(VKIy!b`V>4ScT`3@AZ*FsR03%^xG%+<|GBROgH)dftI5J~4WH@0rW-~W1V>DrAGGS%k21yd*1}79cI%98gZe?4SgT`3@AZ*FsR03%^zGGa7lIW;giH(@YlI59V5Gd5*oVKgx?GBjjnWieyn21yb@0suNXLT`8gb98cbV{~J6VsCR_F<&ubZ*pZ{F<&ufWp8a?F<&u4Z+I?fbZu-+c|mh?Wpn^@baHiLbWM3db8}^ME@*UZY*7LLFL8Bca(OOjaBu)|b!BpSUpQ!Ra4u+cZEWud4mvtzZf9w3WdL6>UomBFXK8L_E@*UZZ0iOr2q0r`ZgX@1GB-FfVL31{GGSviGchnZWHn@BV`MfmVKZZ7W;rls=LSp$?FK9eAY*TCb94YXW;i)yVr4cpGdD42W@IvDW@9yDIAmftWHvW7HaRls222L;1}XwNI$>jUX>V?GC@BCVVPj-wWMgDBF=H|_F)=YRG-5S0F*IZ~G%_$VGh{U|GwTLS?*=LYIyzx^WpgMg03%^DHf3ZmGBPmGF223Of9YSetWNB_^a{xkVZe(e0XLBxSbZu+~2Qm~oIz??_Wn^S!WI=LcXlZt3C}VGKb95kcbYwa@b98cPZf7Pb03%^GH#9gmVlpx}F*G+eHZ(IgG&M0XWH@3sW@a~HWHvYO22>IT2Qno(I%9HWVRU6Eb97`nI&*1yWnXkGAaitNIy!T7a%pa7Uv_C_cPt=cZ*OcV03%^IFfuqWH8e3cHD+crVPP{kIXE*iWoBh!IW}Q5WHMp$22>*k2Qm#hI%H*YbaHQbD06gVIy!S{dSzd9DF7p3W-v20G&o~6GcsdhIXE~mW-w+oWMnpFGGaDjV>4nh^afN51_v?|Iy!D)ZDlBPbYwa@b7^{IUvw!TV{dMAbO0k^Gh{I_V_`BiVKrhjGB+||I5{vfV_{)pH90aeVKrej_6AfD1_v?|Iyz)&a%E$5Z*qAkb97`nI&*1yWnXkDAY*TCb94YBVPs@AF=a3`Ff(H_GBYt|I5%WCHfA$rH)LTkVPaupV)zDB5e5e`2s%1)WnpAbZftodDIjBSZgX@1BVjf(HZ(UhWjHW1VmUK5VmVV?n{03AJ1_v?|Iy!S{Vr*${XDD-YWI8%?X?kT}bSWTXZ*FsR03%^IW@0fnFgZ9dGBsl{Gcz$cVl`%CIbmiuHDO{iGC4H<22>FS2Qm{nI%8;QY-A{NbYwa@b7^{IUvw!TV{dMAbO0k^IAk$qG&W>nVqs)3V>V-BWH)1CI5=WqVKZShG%{ji00&eN1_v@LIy!G~Wo{^QbYwa@b7^{IUvw-WMrmwiIyy*UZe(m_EFeZ{Y-Kt+PjF>!O>bmnDF7p3H8o>5Gh}2oWi~l6FfleWF*G-1WH&Z5IbvloWH&To0tZwn1_v@BIy!P?XK8bEWpYGebYUoCZ*FsRAaitNIy!T7a%pa7CM+OhZ*FsRAVgtwVJ0a6BVlD_GBY_iVmUH7H!))~Gc#f^V`gSDW@BMDW;Z!uIAsI}R3Bjg06IEFZDM6)WMyPQa${&|c4Yu#Y+-YAV|8M0b6+uEF=KCXWnVF0F=SzMVP7#{F-2`+Wn^S!WI=LcXlZt3E@*UZY;Fb!Ai}#KLvM0r04-y0a%C=PbZu-72QLUZI%RHjX>@rgDIjBSZgX@1BVlGSW@9!uG&ne8W-&BkFfuhYF=koI$>mFC_`^;aBps9Zgf<6aAk8KCMF;*E-onmBVlAUG&p5uWjJMKGcsmlIA%6xIW=Q2V>e?sVl^>gWH<~5Q58uFBSLj)Y-D9}077+XY-D9}E@*UZY*7LLFLGsPX>)XPc`j&hZ~$^;XK8bEa(Q1kXmD^YXmo9C7zZi@Iyz5qbXRg|bY&=1Dk%UXVKXx`I5cKuG&y27Ic8=!GG<{lIWjS2WH@CpGGsG3We^8U0vHD>0y;WxaAk5~bZ>GkJ}4;wBVjN&W;ir8IW#deGdVUmVKO&mG&f>pWH>lwFg0XjGd2GhC@BCVVKFy3HDNS4GGt;nGGa9}V>w|mI5#;lIAS+8F*GqUWfTWY7zZi{Iy!G~WpZJ3Z*m}FZ*OcUDIjBSZgX@1BVjQzI5;*iF*Gw{F=Aq6I5=ZCGdDRoIAt?@(V{Bn_b7OU4Z*yNUUom5Ea%EpJUomB4b6+uEF;8%GS8{1|WiDuRZEPV2C=oh3L349ubV71zWM^e4b97`nI&^t(WnXD-WMz0M03%^yVK-qhVP-aEV=*)|G&M3cH8VG6VKZW3Ha9V3H8L_82TBhi2PhgkI&5!YWGF#%b7gdMCM+OhZ*FsRAVF?MmjZ*X}4V{Bn_b7OU4Z*yNUUomBFXK8L_Uol@XP;YZ|P;zf$Wpi_BZf8SpaCt6hbZu-c2Q&gYI&EQaC@BCVVPs@sH8Eo}F)?I0IAk|sH#lKsH8(LiWHvQsH)c6yWGM$$EeA9LIy!Z3ZDDXIDF7p3HZ*29HDqHmHe)b1G&g27Gh{P2WMgADH#ufBH#asgD+gAA1^_xbNp56ictUk%W@T~!V{Bn_b7OU4Z*yNUUom5Ea%EpJUomHFUol@XX>D+9Uol@XNp56ictUk%W@U0NXmo9CH3u&`I&NWYWdI{#HDWboG+||CIW#daGBz_aGBjakH)S?6FlIM2Hf1nmH3u&`I&^t(WdI{#VK_84Gc+?cWn*PHG+{9@WMMQgIX5scVly*0W;S6nH3u&`I&*1yWdI{#WnwsDHe+LBG-hHqIbt_tW;tYLVl*>hWo0;IHe_KpH3u&`I&*Y#X=G&pBVlD?H8(V4WHmN5WM*PyFgRsnH)UaBHZfviH)Jy~F)}p=FFHDJW@d9`bO0k^G-G9EWjHlBF=J#hVmMxwHZwRdV>JgaIyz!?W@cq_03%^HH)b<1FfwChG-NbmFl010IWS>3WjJPLGB7x1W-&EG1tUdlWo>0{bO1$cWo>0{bS`LgZEOYv06IEEX>w&_bZKvHVQfrkXJ~W)b98cbV{~J6VsCR_F<&ubZ*pZ{F<&ufY+o^7F+^!{Wn*+{Z*F01OlfCmbS`LgZEOe%1TS!Ka{x9sGBq|bW-(=AGi6~gVr4gGGhtyfWjHxyH!@{oWHK&jbZu-p2QM!=I%a8XY$!%=a&2LBEFg1qWI8%?X?kT}bSxlaZ*FsRAa-wQWGXBmb97`nI&*1yWnXkD03%^GHfA<4GBaW^IXN?8GC43dG-P5kHD+WnV`VmDGh#D12T?7D1OPfZLUm?lWpV&xY+-YAV|8M0b6+uEF=KCXWnVF0F=1?9F<&uhZE$Q~F<&u4b!KK|axQ3eZER5oB?3A+M{;RoC@BCVVPrEnWH2{kG-6{oWHMqgH8wP4Vl_E6HaIahWMgGFW;+K*Q3oXxIyy&kX=Es4Z*FsRAZKiCIy!ZBWn(iYDF7p3VKilCFf=tcV=-kgGG#YqW;8i4GBG$YHZ(J4V`gMGJqJe-Q3oY4Iyy&kX=Es4Z*FsRAZKiCIy!ZBWn(iYEFfcVZgX@Xb97`nI(B7abZ>Gzb!l#NF*aXxJ|-yuBVjo?V>4keGdMRjHa9RcW;SCuIWlH6Hf1$2GBjjkHDx~sM=wzaB?vk?M{;RoC`WQ>WF{sl03%^BW;J0mVKO*lG&3X?kTSV{dMAbRcJJZ8|!2c4cETCMf_TVKic8Heq2jHDWb2FfcY@H#jn8WinwiHa1~0G&5ypG(`tT5m5&v2s%1*X?kTSDIjBSZgX@1BVjZ!H8D73Wj8Z4GiGEoWMwpCVPaurIALRAFgGw}Vq-@KM+Q*`B?3A+V{Bz%awsVPBVjZ%I5st9W@a>IF*IgoWi&TtF*as2HaIypH)duzGi6B!M^OhQ9XdL5WppTGZ*FsRAZKiCIyz}~Wn(iYEFg7hZgep=Uvwz|BVl7>I5T82Vm3B6H#cQBH)3HjVm4tnGBsl|W;rl0G-XQ%M;lQGB^f$8XJvFKV{dMAbRcJJZ8|z>c4cETCMh6eZ*FsR03%^EW;ixuHZo>3Gc`3hF=b;lI5A~mIAJ+vVK6W;Fflew2S*oC2PG#uI%98cc4cyOC}VGKb95k3VQgh|bY&(iAY*TCb95k3VQgh|bY&(iAZBcDVRR_~BVl4NGGjPqHD)(3WHM!BIA%CGHZeIfF<~<@VPrBgHZV^IMlVK+E8H8(gkVNwT3Vh1KQIyy;iaCLM+cxiJeb97`nI(B7abZ>Gzb97`nI&fiWay(;ia%DO?X>U3@OJ#X1AY*TGWjZ=(Z#p_n;((?p03%^zW;bIqGh{MiGC4CgIAt_8Vl_2kI5c85W@ctLWn?*22S_to2Pg<2V{dMAbO2*wVPR!qVqq|4WHUHnGcsZ{G&V6fGBz+YIAk?rH91xXNCsR7CHfA+pGd4LjFfw8>VKXu~WHmE5S_epC2POhKI&NiWVRUJBWhf~CBVjjYGG#DhGc+?cWH~T5IW;mcGi7EqGB;#qI509{VlZ3>NMZ*j2s%1;VQh6}C@COgZ*FsR03%^EWH)AGGh{PkW->8jIW%E0GdE;7Hf3aEGd40dGB`C}2S^5D2POwPI(A`fb!8}KY;R$7DF7p3I5lE0Vm4+nVK8GiVKrr8V>LH3H90qAVq<1DH!v_YUD06gVIy!S{dSzd9DF7p3VmW0nWMw!vGcsajF*9XjVK+5mFgY+{Wj8Z7F*h|eV+TC`E2`X>@ryI!$47YbgLDVPiNnVlyyeH)Ak2W;8K4HZ(LiVKzB6W?^J7H#swAFl7f(40i`F2s%1sWpi|LZ+R$1ZggpMc_{!RVPrODF*7$cH!@~qG-F{hW;ilpFlA;rF*GzdGC5;mHfIM>26qQ97CJg}Wpqtpb89F?ZggpMc`P7BZggpMc{(~xVRLIK03%^JWo2YHVlZPgGBP)1Vl^^iI5RXjGB`LnI5T54GBPr02T>Gv2QLmfI%j2cO<{9uC`E2`X>@rhAY*TCb94YBVP-aEHZoymVKgu{I5sz7HDzODH!?IcV>w|lH85f`WNQae40i`F4mvt%b5>z&X=ErxZggpMc_|=cZ*FsR03%^HH843gWHmTrIX7fBG-We2V>e}DF*7-4WH4hgH8f*w2T=@n2QLmfI%#u3Y-x67C`E2`X>@rhAY*TCb94YBVK!toVm2`_GG;b0WH>itV>UHmHfA_vHe)$rIb!2T=xh2QL&lI(KPwXiZ^rYbZr-bZK;XIyy~Zb89IeV{dMAbO0k^WnyD9Wi&Q3GG;PjHaBB1W;HNnH)T0tH#BB8Gh{Gka|clpcLy&BIyz-;WGE>hV{dMAbO0k^IW=N2H#B52GdN{8IXPrCWivT3GBq+WV>DqhH8nJ0bq7%fNeUxPVQyh(WpV&bVQyh(WpXZPbZu;V2T3|QQe|Oe0AV*_F<~`kGi5h9W@KYIF=b?CGG;YpVPrXEHa1~mVl;aPNjf@La%psB0AVpPGC5-~Wi(_oGiEYmF)}eWH8Np0GcYnYF*0LjW;S>SOILDfbY%cAVKQMjG%z?gWHc}}VKQYiW-(nVKZiBG&eLiH8wb8Wj2`yCptPvVQyq>WdI{#Wi&EjVPY^gF*7-2Ic7O#W;JDFWn?&HI5{#fIW#h4nFl8Mm7VK!tmV>LHoV>38mI5K?)Nh+BKClWe3b#85Mb#8Phb97`nI&*Y#X>MmQ0H(@a{FlA$b2T2f_2PYUhI%9HWVRU6Eb97`nI&*Y#X>Mmi8F*h(UVqt>^Nfwz0CjvS;WMy-7a&LJkDF7p3W@BYGVm4x9IAdgCWH4kiIWuN4VL4+sI5jafH!w0Yg$GHQ2PXG+{JlH!);pVKQPiVl*-~WHK-`V`MNgHaR&rF))t@Nd}n*CkQ$^X=ErVAY*TCb94YBVKrklFfcPUVPRorVmC5oVq`ZrGi7CEV>2{3Vq!HjG?52M2AKyZ2s%1&VRB_|bSNnxV{dMAbO0k^IA$|qG-5I`GGu0AGchzUH8Wx|IWc4~Gcq|iF=a71lLtu#nFl8bIy!S{Vr*${XDBHkV{dMAbO0k^HDP5pI5uHpH8W#1Ib<<8Gc-0eFlA*mV>mNmW@9)sl?O=%nFl8bIyz%$X>4RDDIjBSZgX@1BVjo+H)AM4TxV{Bn_b7OU4Z*yNUUom5Ea%EpJUom81bYWjHUol2$Y-KKJbZu;D0st>zV{~b6ZZ2qWZ~$RrbZKvHUpQ!Ra4u+cZER)$055QCb!TaAE@*IY0CQtyZe?FGaBOvFX>MOQXmD^YXmo9CtOqOLUm?lWpXGf03%^xHZnCgFfuqWFf=t{G&wb6Vq-QmG%#g2GGb(9Wn?p+2TrU9ECM<@V{&C-bY)X-b#h~6C@BCVVKXo|GGQ?=VmLHrWHvcuG-5GiVKgvfG-6{oIb}C9FrWuctOqO-Iy!S@bWCY;bY*U3a!_w`X>@6CZYX1KZgX@XXKZacI(B7aGbSkjBVjQzGGsVmGB7tcVKOu`V=*;hF=aMpG%#UdH8(S1H#njPP7tgIEF?NQb7gc)X>)XCZe?;$a%p95bYXO9Z*C}KZ*FsRAZKiCIy!b`V>2c!AY*TCb95kQY;8I^c4cETCMf_TVKp&fI5;;rWH)6qV=yx{Vm2{hFlI0@V>dT3VmD%BGo%MjBCH225;{6_Wpqqwb97~HWpY+!Y;R*}ba^OaZ*FsRAZKiCIy!b`V>2cx03%^IIAk_5VlZJcV=yx_V>e=EH)1(tGC5>2He+RCG&MP<2Tl;I2P_miI%9HWVRU6EV{dMAbRctdWI8%?baH8KXC^5CBVjpWI5J~4Gc;y2H8o^mW@R=oI5II~F*adiGBh+ZVq&NVP7K0W@M@dP8nnX06IEBb!2I8L}hkqV`TtiY+-YAV|8M0b6+uEF=KCXWnVF0F=1?9F<&u3b!2I8L}hkqV`VOAbZu;|2S++OXkl(-Y-Io=VP-cuV=*%|FfcG-IWjRdVl**1HDfknH)b#~Vl+57Frx%4IyysjVr5NXa6xi%VR=+xa%W|90ADd*F++7?WldplL2`0oc~oI?XJvFQXmo9C<^}*dIz(x5Wn*+{Z*F01OlfCmbO3X7a&=>LV|8M0b6+uEF=cLNX>Mg-F<&u6X>w&_bZKvHVQfrkXJ~XTXmo9CeFFe5Yh`(2Z((v|E@*IY0BdD=VsBw`WM4RFaBwbYbZu1baHiLbYpd5Z*yNUUom5Ea%EpJUomNKUol@XOJ#XQc4cmKE@*UZYz71XIyz8qX>N2(X=iA30CRM5bz^j6bz*OGUol@XV{dY0Uol@XXKY_FUolW`X>N2(X=iA3E@*UZY`_OeIyymea&LD4VK8PiWier4VPa%3H#9alIbt_tGi709I5IS3F=b^qWxxkXIyy;0WnpaqVKif5IASz6HZU<|H(@w5Gi5R}WH2!^Ibk?qG-hTtF~A2&IyysgZ*y}1VP!WqVl*^4VmW4GI5jgiVP-cqH8*BvVKy@|F=R3}Ilu==Iyy*UZe##qVK+EpF=1mdHe)bjWH2%@HaIXjH)dlwVL4)CH#RUdzz0b>Iz?AfWpinIWdLDeVP!RCGhsGiV>B=~GiGCAWMemGVKF#mGGa9~W;JEN2T3|QPE%54b7^{I0AVvWGcq?hF=k|9FfnE_Wn^P8I5sgfIAl3wH#9jmW;VbFNjf@CS5rk&WpinIWdLDjIWb`|Gcq2{4IAu0Dzz0b>Izen~Qe|^#dSw7%F*Ra0Vqs=wG-hIEWM(&JWjQ!7Fl1zAIXGc8V>CBqzz0b>I!n_qH)3OEIAS+7V>dN6HZx;6GdMS7H#uT5H1q@jIyysja&vET0Ap-nb8};LVsCR_F<&ubZ*pZ{F<&uhZ(lKAF++87b8m7kXmo9CQ33!jV{dJ3VQyq|E@*IY0Ap`$ZDDR?b6+@UaBwbYbZuM?JbWm({XK8LILv>M?JbS-dfb!TaAE@*UZY$Io3Wo0lqVL3B0H8e0VWiVtnWI19rFf%kaH#uT9H!@{8!v{MCN06a&#zlX>N2gGGBBoAXF&;BVjQyV>B}~V>dWvVmC4~F*PzcHaRmmV`egDGd5vnGcd{rOAFQqDGE9|XJvFKb!l#NGcsRvDF7p3V>V-BW;QuFIb&lvVm321I5T57WHmW9VKq24Gh{P1%m+&d%m*tFAY*TCb94Y^H8Ey2Ibk+pWH2>1H8wCfI5;&kF=a40W??X7G%_^K2TKmt2Pq&rI&fiQYbbSTZgev;Uvw-WWMOn+IyysdZggdMbSfzzV{dMAbO0k^Wj8T3W@I*EI5=WtGGaA2IWse5H8Ey4H)LfoGGt{k&<9H%)(0stIy!Z3aA9L>D0OLWbTcwvbSxlaZ*FsRAY@^5VLCccVPk7yXJsZVAY@^5VLCcPZ*FvDcyuZ$03%^!H8?q8H8n9}Ib$_qW@ckzFlIP7Ibk<3HaIq7GchyL2TLy22Pp_TI&^t(Whf~iV{dMAbO0k^WnyMBGdN;qW-w-DH8wM5IAmcmWiVo6G-5VnG%_?{)CWrjm;nGfI#YCSa$#p>0Ap-nb8};LVsCR_F<&ubZ*pZ{F<&udV{>0IUolg3Z*pO0WiDuRZEV;FDLOiCZ*py6Yycx+WMw&HVP-TiH8^57V>C5mVq;-3HaR#sW;ZioFf}-1K>`3eI#6t3Ze;*-baHiLbYpd5Z*yNUUom5Ea%EpJUomH8Z*5;OUolW@VQytEXmo9CTm=9xY-wj`bS`LcZ~$X(a%EpKX>Ma|b!25xCFZDnqBE@*IY0A+4=X>xCFZDnqBUpQ!Ra4u+cZEW8MGBr9nb#P>1bY&=WbYwa@b7^{IUvw-Wb97`nI&*1yWnXkGAaitNIy!S{dSzd9EFg1qWI8%?X?kVifTk$`BVjW)VK^}{Wi??qVl^~kI5Re5Ff(B`VKOv1VmMa$$63O=)m#VQ_OODF7p3H(@nqWMX4CIX5*mFl1ynH(@k4WHvE1W@b4vVq|7F-3L^G1^_xbRAqQ{b#i4gL;z!KVRLh1bz*OGUol@XV{dY0Uol@XXKY_FUomNIaBN>OUoli=cyx7gWimuAXmo9CP6h-ob!h-*H8nP3Vr4ThV`MNlIWjUhGd5%}WjSOwW;JGEFkv+=Xmo9C?*}S6I&Eog03%^DIW{t6VmCEnIWlB7IWlHsVl^~oGGbyeHfCdDWiw;%2P!%`ZDDu-BVl1PIbt|7Fg7?fWHMziHe@g~IAJg`GB{*pV>e|qIb-h!DhN6{VsCgTDIjBSZgX@1BVjf$Vq!KiF=040GiGHlI5IdfVr4UAIbu08WnpDvIAr4oOa|`U23W;Zo6G&eb6F)%eYGBh?YGBsg0HRT6P2JZ(d8#+2~c4cyGVQ_O;C}VGKb95j>Z)|L7WMy(eK|(?%DIjBSZgX@1BVjpXVq!HjV`gPyVK8DdH8W;1V=!iAWie(sIW;jhG&JW2Od0P7DjPaFZ+2yJY+-P7Stw&~ZgX@XLvL(sX=G(`K|w-7CMh6eZ*FsR03%^zV>emcBG-Wt8>jz93?*}RyIy!H5WpZp`aC0bQZ*FsRAVY6#Y-wa=azQ~tLMAC7V{dMAbO0k^H8o>0HDqKoGh;DfIbk_wW;A1BGB7bWH8C|ZFlIGn?FUR5<^}*dIzw-4Y-wa=azQ~tLI87ga&=>LV|8M0b6+uEF=cLNX>Mg-F<&u5Z)|L7WMy(eK|(?2GB#o{Wn?yFHa2EuH#jpnIWagjVK8Ph4+tj>IyzTxa%^NMb97`nI&*1yWnXkD03%^IGdVUjWH2)|W;kOoIc7OxHDzHnIbk$pG%+e^*2T2PL2qy|UI&x)aX>)XCa#Ce;Z*_8GWhhiZa%XccE-onmBVjpYW??fhVP-U9F=RGnW@I@uH#sn4HZnFiGi75nWM%UQNeB-JCjvS;a%E>}b97~LLvL+xZ*FC7bSNnRBVjURG-YBqIWuE8FfwCgIA%97G&N&lIb$+pWiw%8I63tPNe>7o2s%1)Wnp9}DIjBSZgX@1BVjXTH8D9hG%{o`V>385GGb;hH)3RFWjQf1F<~?|H8%GLNd^xHCkQ$^cXDZTWhf~iV{dMAbO0k^HexwtHDfh5WiVklWjJACW@a{HWH&TqI5=i8I50Cf`3Fe`4+tj{Iyz%=Wnpw>C_`^;aBps9Zgf<6aAk8YE-onmBVjW&FgGzVVrFDvHDh5nG+{AfIXGowV`4aDV>B@{He&k+Nf8eSCkQ$^WMy-7a&LJkMQ(Iyba^QNBVjW)VKXo^W;9_mI5uWBIWlE9HZo#3H8?e5H#ufuHZlDNNd^xHCk{F~X>&nrX?A5OMQ(Iyba^QtV{dMAbO0k^IAmrrWil}}W@R~JGc__fH8^23F*P(YV>34~WM(oq{|8A74+tk8IyzxwWGF>$bZK;XEFeQ~ZE$aHWo~p-d2nTOASNatE-o%903%^FVm3H2F=A$8WHn)AWiw$kWH>N5I59M2WivQ2GiEmd2uU3e2qy?SI&x)gZ+2xUMQ(Iyba^QNBVl4UF=I6}V`XJ9H85c?Ib~*LI5%ZwVPP?3FlJ>lI5`6dNd^xHCk{F~Xkl|GMQ(Iyba^QtV{dMAbO0k^HeoY3F)%hTGGQ|`HfAt4VKQVeWim4{Ff(E?G-P5i1qewD4+tk7Iy!J+V{0fyZggpMc`P7gVRT_SIzw-6bY*ySDk&giZ*FsR03%^zF*Rc_HDY2kIc7LFG%{giFgP$|Ib}CAVl!l7W;rzn2uU0d2q!K&I(2SvVPk73MQ(Iyba^ZwV{dMAbRcA5bYVI=P+?0IUols2a%^NSXmo9CX#xN*X>M?JbS`LcZ~$p;aCLNFIB0NiE@*UZY)?Vm3K3Gi5blFf%n`H83_aGBsv1IWah9F*9XkH!f&&ZEPe6B04%tWqAN2VPs@EVmD)AHDNblVrF7FWj8lwHaIadVqrEkIWah5VBVlGUF*iA5I5IJ0Ff}+ZVl!hkGB{*rVPrNqIASm~HZ>#&A_6)(V{Bz%awsVPBVjmUVK*>hWiw2GhsM4F)%VQG%{p2F*7kWV>38rVPs=B76?QGBnToKIyz!$Ze%E9Z*FsRAW3d;b#y{$Ze(e0XLBYjAZc!NDF7p3VPZ8oH#Ie6IXGr8VmUK6GG=5sG&eOfF*q%xJZ*FsRAY*7@aw;q!X>N2WAY*TCb94YBVKrqkWinx5HfAtnHZw9fHa9XgWMwipWHV%8IXE+6F&qd)79Whi5BZgX@XV{dY0Iyz}@IyzTrZe(wFCM+OhZ*FsRAY*TGWjZ=(Z#p_lWqCz*Wp3htrYQg;VPa)tF*!9hVPj!pGdMS6F*z}2FkxjdGhsDhIW%HqWgZAbGb9KiH99(IVQyq>Whi5BZgX@XV{dY0Iyz}@IyzTrZe(wFCM+OhZ*FsRAY*TGWjZ=(Z#p_xX>Me1cSYiWrYQg;VPrEkW;rl6I5IRbIAk+rH)1z8GG$|BHZwRdG&p87Gav{=Gb9Ki2s%1qX>Md`ZfA2SDIjBSZgX@1BVjUOW;i)9WinN0HWn*-2aymM9Z*pv8Np5p+Wn*-2a!_n_XK8LILv>GkbZ>8LEpTjgXK8LOXmo9CBWGb_IAS?sGhtyfHDWL~V>e-DH90plH#9e6HZ?LiW@ch02ucS11qUF)yC7F@a%^NEX>N0HWn*-2asYR4a%^NRX>N0HWn*-2axHXkZ)`1aY;|X8ZZ2qaZEWNK2Rb@Ib8}^Mb2>Ufb8}^MO=WapQe|Oe0AX`;Wpr~baBOvFX>KlPbZu-SXJI#DIWuH8WiVr7Ibkt3Ff}+iIb}6BH)JUfb8}^MO=WapS8{1|WdLDwb7gdMEpTjgXK8LOXmo9CBWGbUG&nP3VKX>4H#Rq7GGbw6H#ajiWHVx6V>4qhGdN=800%lcL349ubaOg7L349ubW&wuWB_4vb7gdMEpTjgXK8LOXmo9CBWGb_Wn*D7VmM@FH)Jp|WH~W3W;bLxV`VjFW@cnGFkv<100%lcL349ubaOg7L349ubXRg|bY%cxb8}^Mb1iUeb!TaAE@*UZY$Io3Gh$_CVl+81GGsY5WH325V>vitV>U83VK`+sV`e!wKS(bz*OGCMf`6b8}^Mb1iUeb!TaAE@*UZY$Io3WHe$kW-($gWH4kiW??vEI5{;jF)}$gHZWo}W-w$iEeJdYY*Tb$bY%czY+-YAV|8M0b6+uEF=KCXWnVF0F=uRFF<&uhZE$Q~F<&u6WpH$8Q*>o+V`*$tbYXO5E@*UZY*7LLFLGsbZ*_8GWnXP!ZeeF-axQ3aZ~$^;b8mHWV`X1oZDDR1V`OA7FgY|dFl90~W->T2WM*P8Gi5X|WiU4~2vsve2s0EqI$>mFC}VGKb95k5CM+OhZ*FsRAW0@E03%^HH8x~sI5uN3Vl^;0VKQPjWn*PyIb=9EH)J+uFf}$b2vrh72s02mI%r{YQe|c+V{dMAbRbeDDIjBSZgX@1BVjRPV=*=|GcaZ|WjQlqGcYw|F*Y|aIc70tIb}6uF*h~{RSrT3GY~pDXkl|nWGG{AZgX@XNhT>EV{dMAbO0k^WMeTiGG#S6Vq!2gVqs-BH#jk3W@0xnH#lN8VPa)6I0#h^LI^VuIyz@%bW&wzC}VGKb95j{CMh6eZ*FsR03%^$F*P$dIXN?7V>UQ8VK8N4W@0xoHZ*29H#apnI509g2vrV32s02mI%j2cNn|KvZ*FsRAW|kNAY*TCb94YBVKHGiI5#peGh{S1Vq`UAIAJnjF)(FgV`5`8Fk&!dV>}2|4nhbs0y;WlY-M3`C@BCVVKX!`V>UE3WivT7Ib~!xFk>`hVlpr`Vqs-6H#ak5VLk{|LI^VmIy!S{dSxgnAY*TCb94YBVKp={Ff=hSF*#v5GC4OhV>B>iH)dloIAdZpGcz|~WV>#VQ>IrY+-YAV|8M0b6+uEF=KCXWnVF0F=SzMVP7#{F;iu7X<=+>dSP^FZ*EOta4u+cZERHtDkVBPV{&C-bY&=WbYwa@b7^{IUvw-Wb97`nI&*Y#X>MmmVKQYfVM_>122}_u6FNF@VRB_|bSQIlWI8%?X?kT}bSWTXZ*FsR03%^!V>vJ~H#uc6IWS^lFgG+ZH83(`Gc__}VKinmHe+E;2uu-G2r3ggI&*1aY-w(1D06gVIy!S{dSzd9DIjBSZgX@1BVjNzF*h(UHeoS1I5uN8HZ(LcG%+zaIAUcoFg7(aHa1TPOc7NGDib<7V`yn?WGHiVWI8%?X?kT}bSWTXZ*FsR03%^yV>mQpH9280Gh{bpFlA(7IXN+6I5J~7VPs)rWM(u`2uu-G2r4T&I&W}gZYXnfWI8%?X?kT}bSxl7X>4UWI!Iw|WNc+DAVz6yWjZ=faAj^yZ)9aD03%^yW-&5hW->WqV>d7`W?^PEWHDrAIb&ooI5RL~GBz|*2uvwq0025VL2_egX?A4*V{Bn_b7OU4Z*yNUUom5Ea%EpJUom81bYWjHUok;)V`yo1WiDuRZES7`F&a8LLUm?lWpYz=a%Ev{D0XjYWGXBmb97`nI&*1yWnXkGAYyNCY$*UEVPiQoF*q?ZW;QlBFk&+>WH(}BV=_55Gi5b2IAk_8Fjfdt7;XqL8ag^cb!KK|a#M72Wnpb7V{dMAbRc$bX=ExaAaitNIy!S{dSzd9DF7p3Ib=0AVPrBiF*h<|H(@b0IX5w4HDhHpHZm|`V>viuSO`-XZU`|AIyypiW@cq_Q*?4=VQnaLbYwa@b7^{IUvwz|BVl4TW;r=EWny7DG&nF}G&VD3G&nV5G%+}4WivD~H#AxZQwwegF%>#GLUm?lWpYz=a%Ev{C}VGKb95j=b!KK|a#M72Wnpb5DF7p3I59M4W@0rrHaIjmWn?urW;JFrH(@z6F*#;oVlpx_TnJMWZU`|DIyypiW@cq_Q*?4=VQnZvb!KK|a#M72Wnpb5CMf_TVK*}{F<~)fGGQ`eIAvyIH#TB2Wn?jAHa9e8WnwchFvQ1WH(_mF=jbsF*apj2vY`b2r(2oI&x)UWGHrTX=ExaAaitNIy!S{dSzd9DF7p3Ffur1HZU?}GBaW`F*rA2VKO#1Vr5}vV=*!}F)%SVVhB?bZU`|NIy!f9X>?^MV{dMAbRc$bX=ExaAaitNIy!S{dSzd9DF7p3F=J&gF=aG4GBh_cH8U|dF*#%~H8D71G&N%}W-w%9WC&9jZU`|5Iy!V^Y-}hgAY*TCb94YBVKy~6F=l0DHaBE8FgP+dHDfb1IAmiuHDO~jIASw4IA#b_25ty37dkp~Wo2t9aCCBHX=Y|$bSxlKWo2tma%pF2ZYcmGVPau9VmLBpFg7?cWMyVyG&E&2W;SADGBsv7WjA6rF=z-=6>bPI2s%1tZ)PYdAY*TCb94YBVKp*hHZ(RdH#RjnWHmH6W;A6sIb}IHVmW0oWnyDuWNHXg25ty32s%1&Wo2t9DIjBSZgX@1BVlG`Gh#P1WiU53WH>T2Ha0OeHextpV=-bhWoBk(WiV_AQwCoN06IECb!KK|a#M72WnpaqV{Bn_b7OU4Z*yNUUom5Ea%EpJUomZEZEtdUUol@XLUm?lWpYz=a%Ev{E@*UZY;y=VH99(VaAaY0WhirWWI8%?X?kT}bSxlqbYwa@b7^{IUvw-Wb97`nI&*1yWnXkGAaitNIy!S{dS&8(rYQg;VL3TAFg7+YVm2~0Ic8=uWHe!AVl`ngFf%weIX7l9WN!#rGjj+x0y;WpWo~71VRU6pX>e^}aC0ar03%^JVPh~jV>x0pHezKoVK6y4Gh#PkFfd^>H(@tqIb=0)2wC3;EkSZ}VR-;Sa&lpLE@*UZYzG7gAi}#KMMF~nEoEbKE@*UZYGlXmo9CVE`UFI%#ciYye*|UomNIaBMDUbZu-01PCC)yC6_(b!TaAa{w)HY;|X8ZgVbZbZu<*1OP8)X>4UKXmD@Ma|b!25mFC{#gmXLBwtE-3&bVPiOCH83_}W@R}vF=AymI5uQ7H)A$5Ff=(aH8D9bG=K0Ap-nb8};LVsCR_F<&ubZ*pZ{F<&udV{>0IUolc;b8mHWV`WWYZeeF-axQ3eZEPI@06IEJZe(S60CRM5bz^j6bz*OGUol@XV{dY0Uol@XWn*(+F<&uhZE$Q~F<&uBZe(S6E@*UZY?lEG0y;WHLsL3BXJvFlZ*6dIZe?zCPGN0jC@BCfWn*(LXmo9CBWGbbGiEttHDNI{WHwx6rVKFmeWHm84IXF0o2sf7j3lTaxMMG0MI%j2cLvL+xZ*FC7bWUMyWhirWWI8%@d2nT4X>Md?cqsraWn*(LXmo9CBWGbaV=!VjW-&A}HDWY1Ha252I5T5nH!?9|WnnWoHZoy~2saNILsddgQ(sa=M@dsuMN(fwPfbuyPDM^sD0F#nWh@|bbZ>HDXJu4*aAhnYZeeX@DFA13Z*_2AUt@1_Wi4f6b1rCfZEPcFVKFr^WH@0sHZeFkHaR(BWI1DEGGk^kHZ)^1HDY8nHH-*17ncDGAi}#KMMF~nEoEbKE@*UZY?cTzIyz)wbYTD^VPQ5oGGj0`WI1FrVK-rAGh}9DIA&opW;r=zWHvB2FqQ~1Iy!A>a7<-(Wo$!lb#8P3BVjTyF=aAgH#jyqF=S+6GiEh6W-wzjWi(=BHexYhHf5FwGCDeUX=HS003%^HH#s+DFg7!0Hez8gGGR0~F*Z16H90XgI5s(EWn(m!2r@c4Xk}?CH7F=1h3FgaypGclG3GCDeDZ*py6bO0k^F*r42Ib&jEG&VV5Wi>TnGBjmnWHmKnFfch`G%{sk1_S^)Izx40WldplL2`0oc|>J%V*qn>a&=>LV|8M0b6+uEF=KCXWnVF0F=uRFF<&u5bz)^rVQ@ima$$KyWpiULXmo9CTm=9xXL4y|E@*IY0B3S(WM4RFaBwbYbZu;^2q+mkI#6M3Wps39D06gVIy!b`V{~tFJWXMAWpZg@Y(6F?DF7p3VPj@DH90V4V>mN6I59afW@9%vIb}07H(@qnFgIm4mvTnHe_WnF=Aw5V=-YjWiezlWM!NPN(QP3CJ_9W@&C@C}VGKb95k0VRU73X<=+8DIjBSZgX@1BVjf&H)1$7GG=BoVl*){WHDthH#RdlW@9&EH(_QoH8rFNN)@UIC>T0AVPs?|V{dMAbRbP(bY*gBVQeNWAZBcDVRR_~BVjmWWH@FpVP#@rH#IY4Ib~utWH&W7Wic>iIb$+rGGnF)N*1aJC>J_9ZDn$2Whi5BZgX@XP+@FkbaZ7VEFflVZ((#P03%^DVPZ2dH8e6~Gi5PjIbk<9H8M9jGch?ZH#KBAFgG=*2uc+O1OPfZP+@FkbaZ6^V{Bn_b7OU4Z*yNUUom5Ea%EpJUomHFUol@XP+@FkbaZ7dXmo9C(FidXIyy>IPfk;1a%o{~X?kUHC~akJZ*qA$I#YCVWnpb5EFfuabSVHMVPj-7V`VonHaIgeW-&22Gh$?6F)=Y>F*sy5F*!6iFslet6wwGV6*@Y1a%psBNjNBJZgeN2gGGBBoAY*TCb95kMXkl_HDF7p3HZwOgH#RdeIb%3wF*7hUF*agiV=^~6Gh{MiH#j$Du?SNX(FidXIy!f9X>?^tHZ&+{Zge&@Uvw-WV{dMAbRc7BVR9-d03%^BGG${oIb&orW-?|lIb%38IW;q8FgG(|HaIagVr4b62vZc%2r(8qI(KqubY)dID0OLWbU0shEFfcVZgX@XV`yP=Dk%UXVKOsjHe@q1H)b|vWMXD8VrFAxGB`A1WH2^nFl93^IJF2<6wwGV7dkq3a%psBRWUXwb!l#NF*aXxEFfcVZgX@XV`yP=Dk%UXVPRroGh#MkF=l0AWj8QoW;kXxFl03|H8(amVPs@9Ft-R(710PW7dkq3a%psBRWmXub!l#NGcsRvEFfcVZgX@XV`yP=Dk%UXVK`xCW@0inW;QlsG-fzAWHn`EWH2#iG&46bIAvrpVYvuX710PW7dkq3a%psBRW>vzb!l#NHZ)&!EFfcVZgX@XV`yP=Dk%UXVPZ5hHDzLEIA%6CWidE4WjSGEWivQ9VmLN1GB_|{H@gT^710PW6goP0a%psBMl&)fW^8X^bSxlaZ*FsRAY*7@aw;hRBVjf;HZWymGB;s1G&5x~WHVwlH#spdWic}|Gh}5nFk!t2Qxee#F%>#GcXDZTWkxnMC}eMSVr*qBAY*TCb95kMXkl_HDF7p3IX5>oG-EbqG&nFgVK!njV`DZnIAvmFH)3KqVKg*3zX($k(FidUIy!f9X>?^mZ*OcUVsCG3EFfcVZgX@XV`yP=Dk%UXVPQ2kFl9G0H)J$8IWaIaWo0mBHD)<7WnnO4Vly{pH^B%~5zz=S8ag_6a%psBQ*?4^Zf7WCZ*FsRAY*7@aw;q!V{dMAbRc7BVR9-d03%^CGB!CjI5lNrV>2)?WH&Q8Gc{&qFg7LzqYGq?|C}VGKb95kMXkl_HDF7p3WHe+nH)S8H!@{7G&wObHaBH4W@9)pGGb(6#|Tr=2r(KuI$~vKX>LJsa$$KWb97`nI&*1yWnXkGAY*TCb95kMXkl_HDF7p3IWb`|W@a*GGc`3eGdVXlFkv-jV`O7yIbt$oVlrW7$p}*z(FidDIyz-;WI=LrVRfixQ)O~#VQgu7WpV&xY+-YAV|8M0b6+uEF=KCXWnVF0F=SzMVP7#{F-lWUPE%!aX<=+>dS!AhXmo9C1_S^)I#Y0ObWCYyXmkK`baHiLbYpd5Z*yNUUom5Ea%EpJUomHFUol@XQ*du|OlfCmbS`LgZERcx054-ff{FLQKZZe(F{WM6Z1a%Ev{E@*IY0CRL?Y;|X8ZZ2qWZ~$p;aCLNFGH`5lXK8L60B2=%bZKs9Epv2Xa&%>6E@*UZY}g1YIy!A(bO0k^HZU?~Ff(H`H)1(AWj8r8H#cNCV`F4AFk&}kWi~K1<^}*dI!te4VQf@yS8sA`WB_w?a&=>LV|8M0b6+uEF=cLNX>Mg-F<&uEZ)0I>RBu;ra%^NSXmo9C-3T`VIy!A(a40DNBVjjXWMgJAGBPwVFf?UmG-Wn7IWaY5H#jq6V_{=9H)GidS=|UX0y;W%Zf#+3C@BCVVPP^dVKX!_W;kRxG%;p2W@TbAI5cBrWH~Z5WMyM9W7`N>fd&9NIzw-6b97;DbV7AzW@T~!V{Bn_b7OU4Z*yNUUom5Ea%EpJUomHFUol@XX>D+9Uol@XLvL<#bYX6ELUm?lWpXZPbZuw|lHZ?M3Gcq-1V=-hgVlp{pVmUN6H)S|EIW=Y82s{Sl00$t#yC7F-Ze(wF0C#C_WN&vZaBOvFX>KlPbZuK2W@a`tF=k{jGcz_ZW@R&CG2;kF5$gyg4mvtiXmVv?WKeH!Y$#M{a%Ev;P;YN+CMGEWBVl4VF*P%0G-EP1Ff=e>H#B88VP-aDH8?RgF=S?BGBxE0M-1x-B^Nq6VPs@fVRLIJb97`nI%ailV{~b6Zaj8xX=ErVJ}CerVKg{0W-&B3Hf1wrGcq(aFf%q~Fl9M7IWl88FlAvkHs=UO73&Bk0y;W(VQF+IDF7p3VmUEmG-Wt8W@0osHDoe4Heq8hF)}zfGcaT|G+|^h=?F(50RTEWRA_Q#VPsHmZ)^Z#Y+-YAV|8M0b6+uEF=KCXWnVF0F;r-BWnpAcZ*OcaXmo9CjRF8KWo~3?VQy|^b8{|eaBu)+Ze(d;Zf<3Bb6+@UaBwbYbZu-Q1_Uo*b8}^Ma{w?nGc{!}Ff(RhGB-D7Ha25rHDhKqG&5v1H#lZCVKOdgbZu;L001vya&KW|UvOw)b7fy+Z)|L7b7^mGb1rCbZ~$U*Z((F#UvOw)b7fy&V{dG1X>)0BZgXEaXmD^YXmo9CV|8M0a{z8(ZDn(CVPj=ubz*OGE@*UZZ1M;dIyy~ZctLJyb8mEVZ*X}4XJIxlF*!72VK6WLIWRaiW@BVFIW#e3HZoyjWMngBHZn3cHe+TpVPr64GcYt}G%z`4F*Z0cWj8nS2o*XyLvL+xb#!G@b#QQRa&%>60B2z~FflnaV_`5bGGb&lHaTWyWH~T6HD+UEHaRpgWHvHkVl`u7H83_fVKZbfGh${iIAJ+6Gh;L~Wo2SxH)Am|mjMepI!AJ0aA;{`b2>Uua&K^Da&&nBEoW>lXmo9CBWGbYFflnaV_`5bGGb&lHaTWyWH~T6HD+UEHaRpgWHvIF0Sh`hM{;3sXlY|}IyzNzVP|CkEoW>lXmo9CBWGbUH)1(8H#0CXGh#L}WHd5lV>2^iHZ(G2VrDjBGB!B>2o*XyLV0v$0B2z^GdN>0VrDZlWMnZoWHMzmGh<_8VmV_sFl1$9Gh<<4VKOu|V>2={Fl1$7Wi?|tH8wOjG-YFBHfCWtGdMRl{|FU2I#XzGa&!P^VK6f|V=-c8Gc#mlF*sy0Wi&HmV`E}DV>d8lWn?pBVPP{cVq!NmH)ADziVPyXZ6*@XeZgc==VK6f|V=-c8Gc#mlF*sy0Wi&HmV`E}DV>d8lWn?pBVPP>gI5uH6V>2^0VmC2jGd5&5H#0RfV`X76Ibk?rH8TGQ6*@XqLV0v$0B2z^GdN>0VrDZlWMnZoWHMzmGh<_8VmV_sFl1$9Gh<<4G-5PjVK+84VmCD~WHmT5HezOFVlpx@Gh<^jV_{`s{|FU2I#p9>Z*p`1XJIfiIAbwlW-~KnWHC5oGG#O~V`F1tIb%04WMyPCV_{)rW@R@xHD)n0Gcz0VrDZlWMnZoWHMzmGh<_8VmV_sFl1$9Gh<<4Fk&$>IWc8qWn?xpF*Gw_V=y!~FgZ6dF)}waH#jw6{|FU2I!;1)bY%c%VK6f|V=-c8Gc#mlF*sy0Wi&HmV`E}DV>d8lWn?pBVPQFDGBGnWHD+RCWny7AW-&N5HZeD2W;tUyVlpveWibB;6*@XjQ)q8;bO2{zFf%w~F=A#jGh}2jIAk(qG&5skV`4dDH!x&nWHV!7VKHMiHZU|XFkv-iI5TEsFf%Y^IAvurWo0rlHZx-}H2(+{Iyz2OLV0v$0B2z^GdN>0VrDZlWMnZoWHMzmGh<_8VmV_sFl1$9Gh<<4I5;&pHDWk1IW#q7VPP<0I5%cCGdX56GGk(5HeoV1{|FU2I!;wnXm4_K0B2z^GdN>0VrDZlWMnZoWHMzmGh<_8VmV_sFl1$9Gh<<4G%z<}Vq`aBH)J+8Ff}n|GG#epVKiekWi>f6Gh;D0{|FU2I!0`7VRQgzVK6f|V=-c8Gc#mlF*sy0Wi&HmV`E}DV>d8lWn?pBVPP^dVP!C7GGaJ6Wi@3pWHdK7W;r-GV`DQmWHT~1GGdnj3pzSSa$#_2X=8IbI#hXZWdJQ_Y%XYYZEPcFVK6f|V=-c8Gc#mlF*sy0Wi&HmV`E}DV>d8lWn?pBVFC#iIyzNTXm4_K0B2z^Ha0UhWHw|sVK_1}H90b3V>mW5Ghs3@GB;y6GcY+}WM*YII5lQ5Gcz+ZH)c6vG&eJ5IXN&eIX5#hVliT40tpp5I#o$-bO2{zFg7+bHe@zrH(@w3GBr6eVq-WqGc#c_F)}w}IWsUhVK8DbGC472WMyPFGchzXVPh~fH!wLjF)=bXG&eXkVV405Iyy&kVQ^?^V{Np56ict&q>ZDDi(EoW>lXmo9CBWGbSHa0UhWHw|sVK_1}H90b3V>mW5Ghs3@GB;y6GcY+P2^BgzQaDpiZ*pw_XJKSyV=*^3FfcVTGcYkUFlAz6F*7kaVl`$pGc+lGdM72IW%T7FgQ13WHV(mF=A#pIb~%uVliboGA9WYIyzEEF*Z|9Z*pw_XJKSyV=*^3FfcVTGcYkUFlAz6F*7kaVl`$pGc+V_oGB`3ZGG;hAF=b?CWH2{nW@TbCGh{X}WilrT6*@XnM?yg{Hd9V-a%})-VPs@uF*i3bFf}qWFflYRWnyD7Gch@0HD)z4G%`3iF=1k6H8Wu`IW%NuHZd_cF)}qVWI1IvH#ssmWMepGHf1LX6*@XnI8{z>a%})-VPs@uF*i3bFf}qWFflYRWnyD7Gch@0HD)z4G%`3iF=073HeqCDHeqHpF)?K^H8Ey1HZwF~V>w|lH8o=~VPq!>6*@XnF*a3BZ*pw_XJKSyV=*^3FfcVTGcYkUFlAz6F*7kaVl`$pGc+N5Wim2jVq-KlIW#pfCkYigI#Ne5HdRhmF((NXIyzEELP0S$RZeemZ2)IsWMpG8H#aaaH8L|WF*Gn`Vq-BgF*#y2W;HW3GB`LfVK8B3H#ssfH8(jqVqr05W-&4~F*h?eHZx{sGcaUjHzx@dIyzD~Q%P=g0B2!jWMeTmH!v_YGBYqSG%#giV=*%^IbtB@^W;9`BGdDLfF)(B@GC4S9FfuSVHDozqGB`J7CkYigI#Mw6Ibu0DWjHf9H#0ReHDP5rWMVL8CkYigI#NeCQ%P=g0B2!jWMeTmH!v_YGBYqSG%#giV=*%^IbtWMyJ8Ibk+3Ffuq}F*!0gI421eIyzEELP0oFNp5riXJKSyV=*^3FfcVTGcYkUFlAz6F*7kaVl`$pGc+L2lG&f>4Gh#VnWimA~GdVUhI5%Q7H8f>7WG4v~IyzD@HdRS(bO2{zWMpG8H#aaaH8L|WF*Gn`Vq-BgF*#y2W;HW3GB`LfVPrBeF)(2{HZo#kGG#e1VK`wnG&nLfGd5x{H#a$BH75xbIyzEEI8{k*bO2{zWMpG8H#aaaH8L|WF*Gn`Vq-BgF*#y2W;HW3GB`LfVPR%uGBG)0GGbw2GBRN@Ibtz6H!)^4GC5;0IXGf7VD(pHaRyqF=jV3I5jY2V`O1DGcjd3W@2JwWhV(0IyzEELNPW*Y;R$70B2!jWMeTmH!v_YGBYqSG%#giV=*%^IbtvQ7Ibkz7IW#q9IW;pjGdN{4VmD$pHfA|vCkYigI#NeMGcrbOZ((!*XJKSyV=*^3FfcVTGcYkUFlAz6F*7kaVl`$pGc+U8lG&5r{Vl^};2^BgzQb$5TGcrbOZ((!*XJKSyV=*^3FfcVTGcYkUFlAz6F*7kaVl`$pGc+2$EXJKSyV=*^3FfcVTGcYkUFlAz6F*7kaVl`$pGc+Y&ZZjV>o3oIWadfVPP{dG%;f}FlI0`W@0fiHZx>1Wo0*)0Sh`hM{;3sXlY|}IyzKkcyx7gWkzpuZDDi(EoW>lXmo9CBWGb`WMeTmH!v_YGBYqSG%#giV=*%^IbtmN8IXN?CWnp7BV`e!tGBsi{W0wI7Iyy&kVQ^?^V{RAqQ{b#i4!X>4?5asVx7Y%XYYZEPcFVK_8oI5uKAFgGzVWH326GBP$XIb$<3IbminGdVJ2Ff0ibIyysF0B2z|Gcsm5VlZVlIW;slFfceWHDxw3V=-hlG&nIaGGa7gIbmiqF)%k_Fg7-3HexVjWoBYAV_{}vFf=(iW;SJHED04lIzvNO0B2z|Gcsm5VlZVlIW;slFfceWHDxw3V=-hlG&nIaGGa7gH92KtHDon6Ght$6FflY{Ght;iV=^{lVL3K3WjJGImjMepI!AJ0aA;{`b2>U#X>Md`Zf5{3XKXHLbZu-SXJIrmGG;kqFl9G6H8eLcFgP+bWi~QnF=RG0I59CYVln_mWnncqW;HcAV>e_mI5TBpH85i_GM51hIyy&kVQ^?^V{Qeks+WpYh#WMu#?XKXHLbZu-SXJKV#Vl-hmW@BV9W;i)AVl^{kHZ)~5Vl_87FlIG4IXRaB3pzSSa$#_2X=8IbIzw-5aA9&~04-;1E@*UZY$Io3W-w+qVKHW5WMw!oVPiLAWnwvGGB`P9V`5@BF=H@fmjMepI!AJ0aA;{`b2>UxbY*U1X>37bbZKvH04-;1E@*UZY$Io3HDh5oIAJw2WMyVKGB7n`HaRmkG&f{qH#A}}H90jlmjMepI!AJ0aA;{`b2>UgY-Mg_Mqy)gZ*l-FXKXHLbZu-SXJIyGG%zz|Gh;b2V_`WkHDft5VPs}FGBh_hGGaM1F))__3pzSSa$#_2X=8IbIznt^Ze&kz04-;1E@*UZY$Io3IAmjEH#jjiGGt+9WHdNrF=jb5VK!qlFg9d2G&N;7mjMepI!AJ0aA;{`b2>UxbYW*@04-;1E@*UZY$Io3GGsL|H90phF=IGlVq#=AIW#t6GchzYGBr6hW@9rsmjMepI!AJ0aA;{`b2>Uhbz)^kVPjlXmo9CBWGbWWH~uDVL31~IAt|7F)}zgVK`wqH8EsiF*af{Vq`Qu2^BgzPH%2y0B2!jH90b6Gh#6}H85miIXE>pF<~$`Fk>=dHZwM1GC4M3HeqCDIX7lFGht(9HZ(OeWHezmVKibfFgGw}GdDFfJqZ;$I#y+JbY*x#b!KK|asX#xWHmW5Wiw(iH#IP1VmUZ9H!)!_I51-}VKy^1VKO;3VKFc?HZf)~Ib&pEHDO_7Vqr37V>vlEHezKqG%zq?WIYKLIyy;iWMz0lb!KK|asX#xWHmW5Wiw(iH#IP1VmUZ9H!)!_I51-}VKy^1VKO;3VK-wlI5{;jF*Y(aG-hTnG%+`2H8^56GB`G5WimHoFg*zsIyysdZgX^DZgfI*W@cq_0B2!jH90b6Gh#6}H85miIXE>pF<~$`Fk>=dHZwM1GC4M3W-vKqFl1yiV=y>nWnp4tHDWX~GBz+dW-~ElFkv`jJqZ;$I!SF|XJtWSV`X!50B2!jH90b6Gh#6}H85miIXE>pF<~$`Fk>=dHZwM1GC4M3VKp~5VrFAEHfCXAH8C|bVKQYhGcq$aGBIX3IAJknJqZ;$I#gwNbairNL1SZOb8`S^VPrKqGG#MjF*h|ZWMVluH8(L~FgP${GGR6|HeoV3HeoqqFl9GlI5=fxH!v__Vr6DBIAvovGdValHZU_~V>LYq6*@Xba$#*{Vs&O_WpV&#VPrKqGG#MjF*h|ZWMVluH8(L~FgP${GGR6|HeoV3Heoa}Vqs)tIb}3CFfcMvWqVKQc7V>4wpIA&urFfcYbV>o0mW-u`}I53w13pzSSa$#_2X=8IbI!$G5Z*qA;VRCY5WpZ->EoW>lXmo9CBWGb`H90b6Gh#6}H85miIXE>pF<~$`Fk>=dHZwM1GC4Lu2^BgzQe|Oe0B2z}GBP(dI5#n7IXPuBGh{YoIALTqF)(FhHDxw3VPrR9H(@bhHD)tqH#ufxV>vNpWM(pEHDzIBIb=3AVPax5K?xN)I#+UObY%c%VKp)`H#RsoF=jbAWivBmHe@(qWHvD{Wn?vFHZoykH(@a`GC5-~Wi(_oGiEYmF)}eWH8Np0GcYnYF*0LjW;Q+vIahLNbY%cAVKQMjG%z?gWHc}}VKQYiW-(lXmo9CBWGbXGBP(dI5#n7IXPuBGh{YoIALTqF)(FhHDxw3VPrR#0Sh`hM{;3sXlY|}Iyy#jVQpn%b!KK|asVx7Y%XYYZEPcFVPiKjF*#ynW->T4H#BB6WHDkeV`emAV>vZ8VK*~lWtRa9Iyy&kVQ^?^V{Qeks+WpYz=VRU5xEoW>lXmo9CBWGbVGdE^6V_{}xV>e}GG-EY2G&VOfFgIgnWH)3qGi73z0Sh`hM{;3sXlY|}IyyvUaCB%>bY*U1X>3z;VRU5xEoW>lXmo9CBWGb_IXE$7F=I6|F=1w6HaKB5Ib&ouWHmQAVly}~IWskv0Sh`hM{;3sXlY|}IyypZWo~3sbYXO504-;1E@*UZY$Io3Ib||6FgY@2W;HQ2I5aq9G-F{kIb>uoWMgGzF)(8>mjMepI!AJ0aA;{`b2>UxVQp}1WpV&5XKXHLbZu-SXJIljF)}n|IXE{qF=J#kF=aV5He@w9H!wLdW@KeCWM!8D3pzSSa$#_2X=8IbI#gwNbairNF+>0@XKXHLbZu-SXJIinH8f;pG%_@0H!wG3H)1w7WHB-~V=y;nFfwIgVL6up3pzSSa$#_2X=8IbI#gwNbairNGDH9^XKXHLbZu-SXJIg5WjHx7Fl0AlV>K~lGBYtWGh}2oV>dTrW@a)pW;aL)7C~}yVR-;IGG%5mI5{z4H)Jw1Vqs!9F)%Y^G+|_BVq<18Vq-Ly0Sh`hM{;3sXlY|}IyzKkcyx7gWivzoEoW>lXmo9CBWGb`H)1hjGh;M0W;ix5Vqr06Win=BGdN>8WjAGHVK6Y40Sh`hM{;3sXlY|}IyysjVr5NXZ~!f5Y%XYYZEPcFVKQc8FlIS6I5=Z9HDYEoH8Ny1I5%ZtIWlBpHZVCbV@nAZL2`0oc>pyrHD+dHGBh(bVq!TtWo9xkI5T8sGh$*eVmCQ5IXRaB3pzSSa$#_2X=8IbIzw-6b97;DbV7AzW@T~!EoW>lXmo9CBWGb{Wj8lCF<~+|Gc+_}VKp*hGB9K{VKFu{HDotoF=jWH0Sh`hM{;3sXlY|}Iyy;iWMz0lb!KK|asVx7Y%XYYZEPcFVP!TlV`MfqWnpDAIW=K3G-EkoV>B~lV`emDW;ZuuHkSblIyy&kVQ^?^V{R%LQ@Wq3k$W@cq_04-;1E@*UZY$Io3GB9B>V>B}`HaIykHDWk3VmCN7GdDIgVKgvdHZ?b9mjMepI!AJ0aA;{`b2>U!WpZ?7ctLVUxXklb!a!_e-Wo&6~WdJQ_Y%XYYZEPcFVK`=EF*!J4G%-12Gcsd1IWuE8WH&WpHDobiG%;l}HJ1SkIyy&kVQ^?^V{Q)ppiWpYAkZe(e0XHaixZgc=GXKXHLbZu-SXJIvCIAmjHVP!BiIb=9EGc;m1VKZVjV`E}AVqr68HZqq13pF}AM{;3sXlY|}Iy!W6X<=?>b!=gDWhi5BZgX@XM{;RoCM+OxbYwa@c4cF9Z*n|VWpZ?7cs?d9AaitNIy!b`V{~tFJayuLrYQg|XKXHLbZu-SXJKPGG-Eh6F=AvkGG#J0IbvZoH92E5Ff=wdGcq(aVlY$*HZwz2LQhj)Lr+pgUq?(|O+i>+Mp8jdMM70ZMnzIzQbkTgMN(f>K~hIWR9{0+RZdg@XL4_Ka9>|zZ*pZVXKXHLbZu-SXJI)wWH~l4IXO8uW;0+R7F@+RZ>M?GDKfNQc^)#UsFk1MF3}VZ*_2AUt@1_Wi4lHE@*UZY$Io3GdVXjH#j#rG-5L|Vl+8pGBh?~W-vK9GBIK_F*Y?~LsddgQ(r?*Qbk`!OkYhwSYJa`LPbqMP+vh(QbAc?Q%PDy0B3SlXmo9CBWGb@WI1CpI5=ZuHZn9ZIA&vII5IdlVKOi|F*h+~HDfnJRYFfwUqeq)MPEluUrj++Urk9+Ura?-MND5qPgPD-0B3SlXmo9CBWGbZHD)$3Ibt(oIX5sdV`e#IWHvQqH#Rb4GB!0ZI5%ZORYFfwUqeq)MPEluUrj++Uqeq$Q&d4tR9`|>Mn*+aUqwtsO+`*rUrs?yMPE}%T15b7a&L8TUteQya%C-NY%XYYZEPcFVP$4CH#KEBV=^%}HZn3dFf=(ZVm4ziVKQVjI5{$AWkXd$Pg7q*Pf|r+M@(N$L0DfyPfk-*K~7X(LRCgaMN(fyOhrvaPE=n*PgPD-0B3SlXmo9CBWGbZWiwe@EV>2*ARYFfwUqeq)MPEluUrj++Usgp@R7F@{K~hpdSzkp=MNLIcR9{0+RZdg@XL4_Ka9>|zZ*pZVXKXHLbZu-SXJI*GW@2MzVqrHnVlXi?W-vEmF=S>oIWS=|WnwTgF*QR~LQhj)Lr+pgUq?(|O+i>+Rz*@&MOa@!Qc^)#UqV$zMnzIzLr+ysQ~+mkZ*_2AUt@1_Wi4lHE@*UZY$Io3WMg4wVlg#jW@a^IH)Am}W;bOuIb>sFVPa!9Gd4FgmjMeP!n+_xa$#_2X=8H$EoW>lXmo9CApsUTI&EcbZ*qA6Uol@XZDnn5a(OOjbZuMa|b!25G{Y;|X8ZYV=_VsCRMDFAe7ba^dlZgX&DV{~tFEp%^hY%OqXb!TaAE@*UZY$Io3G%_C4~VhKwI{RIag!n+_vZggpMc_3+Sb8uy2bZ>G1Wo~q7ba^dlZgX&DV{~tFEp%^hY%OqXb!TaAE@*UZY<~$V89F*-a$$EUQe|#rWpZV5M{;RoEFfoWZ8|z_VRSSp03%^JH#aypGh;V2Wi>ZqV>C4}G&E#pGBY)0VK8K2I5jY32}~D%2`UmgI$>>MX=QG7C}VGKb95kQY;8I^c4cETCMf_TVPZ69I51;5W->E1HDqEpGiEe0HD)$2Gc+_bHe@w1GiM1*5Pu0O7CJg}Yk5ax6wV`VosVK!rF2}~4!2`U^qI&5iYXmluJZ*FsRAY*TGWjZ=%Y&tqqaBp->X=iA3CMf_TVK-tpF)}n_I5;*oV>354Ff=qWVKXr`H)CXBHaKQuVQUFY8h;5YBRV>4X=iA3C}VGKb95kMZ*pZiI%jM;Iz(x5Wn*+{Z*F01OlfCmbS5bPBVjORH!@~7Hexh4H92H9HZ?OiW??rqWoBVHVrFJ#WnpazOd)>>DjhmHY-wj`bSPtQZgX@XV{dY0Iyz@;Iyz8qX>N2(X=iA3CMf_TVPrXBH)1qlGi5O`H!(M5Wn?!wIW=NqV=-i5Ffe0eH*X0{8-EEZ0y;WlY-M3`C@BCVVP!HoH)S$3Ffuq}V`DX8WH>o7HaIt8I5T5nHZ@^1VQ~pee+eoGIyz)>VRu7qWOFDfAY*TCb94YBVK6meVq!KlGcaT^V>UBlH)b<6Gh$(6Ha9skI5=Z6Fmnk^27d`E2s%1pZDMImcL_`he+eoGIy!T3Z*)v)XJ~YDC@COgZ*FsR03%^JGG$_BH)J(9IALL9IW#zAF)=qZHDY8kVK-(uG&VJP2}}lm2`UIWI%H{bWn*+{Z*F01OlfCmbaN;vAY*TCb94YBVKFi`H)SdB0IAUWsIALaDWH&i5He)koG&nOiHhT$727d`E2s%1&Z)t9HOlfCmbaN;vAY*TCb94YBVKg;4I5J^0W@2VEI5jq7F*IZ~GcjgmGB`3bG-Eb7IDH9B2Id9;IyzEiZe(S0WpYMxVQpmqV{Bn_b7OU4Z*yNUUomBFXK8L_Uol@XQe|#rWpZV5Msi_oWiDuRZEWTS06IETXm53FWKnf#bO3X7a&=>LV|8M0b6+uEF=cLNX>Mg-F<&uLXm53FWKnf#bS`LgZEWBN054@@b1rCbZ~$dvb6+@UaBwbYbZu;f2`f4}Z)Rq5Wpn@|VK-(lF*Y|hWi>M~W@BY$H#9aeHZeG1Fkvt@IAUXAVTB1RIy!S`VQ^&tBVjW!F*Rj1WH@0rH(_QrW-?|oH8nIbGGj7kHDqLFGC73_D>^!DVRC0_ZU7@;VK`znI50LgHDom~IXGi5WMO19H83(bF=A$AHfAz6<^}*dI#6t3Ze>GnY;0*{WpV&>baHiLbYpd5Z*yNUUomBFXK8L_Uol@XP;6mtWkYXlY-wa=axQ3eZER5j054^3bZK;XUu|J-VP|D>E@*IY0A+4;X>@sCUu|J-VP|D>UpQ!Ra4u+cZEXDk054&3V`yo1WiDuNZ~$R)V`yo1WnVaGaBwbYbZu4UKXmD@GGQ|_W-?-9IbtIX5skV>mW3IX7ixG%-0jVKFpeWo0=wGC4M6GC7V3F*-VPV`+19Z*oO$VPb4$WB?;!Vl!hnWH~uEGc-0~W->J~W;i)9GC5;nIAk_4HZw6b1_S^)I#OYCbY*f=bYXO5L}hbh0CRM5bz^j6bz*OGUol@XV{dY0Uol@XXKY_FUolc)b97~LQ*>c;Wkh9jV=icPZEXJm055QCb!TaAE@*IY0CaC}Y;#{SVRLh3bYEX(cyMfQa%FN~GH`5lXK8L2~5VP-NmVPj%5I5svkG&f^4HfAz2Wj8WnVvq?*1C|LVF*-VIZ((Fca&K)$X>4UEL349ubaN&wAY*TCb95j4UEV{dMAbRa=38oIXO2pHDxh4Wo0vFW-wtjVPZBkWieu7V=y(82}v{N1^_xbN>fixLUL(jXJr6mY+-YAV|8M0b6+uEF=cLNX>Mg-F<&uCQ%_Dpa%p5|WiDuRZEWNK2M9VkRB~Z%b7pUHZ8|!1a$#KS(bz*OGCMf`Pa$#U5lH90n7VmCN6VlX#3F=aS6WH4r9I59alW;HaI2|otp00$t#yC76@VQzC~Z*pw_baG*Cb7pUHZ7pzYb!TaAE@*UZY@!J*Iyz!+a%5$4LvL(vasVS?Wiv83G-5YqH#B2nF*!IlFl09|F=AvgV`gGvGGk<7q6sZJI&EogMrmwxWpV%`VPj)qFfcY{WM(%pGB_|ZW;J9vGC5{pF)}b^VmD?uVxkExIy!A(XGUpkbY*e?BVjc)W-vHoGdDOjIW{$8HDNPkH90vnFlA+8WMwcpIWwXOEjl`FX>e^}a7JltbY*e?BVjUQF)}wYGBPw|FgIp2WMyPBH)UfuVq-8dWj8ZoHD;m-Ejl`3WMpz>b8}SyBVjaTIW#mkG&f{qWH326Gd43ZI5jzBW@a%tGh;bsGiIU*Ejl`3WMpz>b8}VzBVlGSI5ajiGG;VkVqsx5W;ZxyGG$>mI5A{5IXE^qGcuwHEjl`3WMpz>b8}Y!BVjaSVKy`}Hf1(rHexq1V=y!}VrDopVlrbhVrDroVq~HTEjl`FVR%7qX>)IMa&K^X03%^CHZo>rH83z{HZnD2WimBlHDxg|VKii7Ib}69Vl-j~1OPfZQ(MV1c`j&hZ~$UyZeenHUpQ!Ra4u+cZEU6qNjf@cVQyq>WdI{#Ib<_3G&43hV`XGEFl1pgGBq_cFf}w{H)dmHWMMNmqXaBEI#gwNbairNGDJaga$$K?VRC0>bO2v5Uoli=cyx7gWimuTa&lpLRAF*wWpplRbZu;?2_`x^adlyI03%^$WjAFuWo0m9W;ZcnFkxk6Wo0!qGd3||Ff%u0H8M5k1^_xbQg3u&bZKvH0CRM5bz^j6bz*OGUol@XWo~C_Ze?FFUolc|bYXO9Z*DGVbZu-=0st>%c4cmKUvgz(WMy(LXmD@mI#OkBWMy(hWp-&}Whi5BZgX@XQe|#rWpYGic4=c}CMf_TVK+51HDWknG&W^4Gc#jiWim1~WMgAEFl1yhH(@X|VyX#G6Z#1)7&c;Whhc%b97~LQ*>c;Whnq7VPj@EF=JyhW@0vGH#B5qIX7Z6H#RdiHe)b1GdE^9HL?j$3;GEy9y&T>a%Ew3Wkh9gbZAp_Wo~0>Y*Tb$bY&=GZ*FsRAVg(wbZAp_Wo~0>Y*Tb$bY(c;Whg{taCB%>bY*U1X>3z;VRU6F03%^!VPRx5W;S6tV=^%{IASy~WnyGuFk?4jG&W%}HDoik2~QFF2`v{oI%9HWVRU6eY-Mg_Q*>c;Whi5BZgX@XLTqJjWK(oubY(2*jW;HW2VPs^u2~QRJ2`vmdI&)=oLTqJjWK(oubY&<)Y-Mg_Q*>c;Whnq7VP!NqF*7kSGB{*2Ff=)3Ib&gAFf}(eW-~KlF)%PWF}ev)3i=5x6goO%a%Ew3Wm92oaBO9AC}VGKb95k6VQp}1WpYGib7Lkc03%^$I5ae4WHDo7IW#zCG-ft9He+QsGdVLhVmDziIWuLv2~QIG2`v^nI%9HWVRU6wWq5RTa%C|@C}VGKb95k7Wq5RTa%C|@L}hbhCMf_TVKg^pIAS+3WH2~mF*q_~He)a~H8^24VmC8pHDWV2V!jDa6#5A*7CJg(a%Ew3WmIK&bairNGDIk2Z*FsRAXH^|bairNGDJjWb7Lkc03%^BVKy;0WivQoWic`{VKifAIAUftFgG_dGBRQ`VP-PG2~QOI2`w8sI%9HWVRU6wWq5RTa%D0^L2`0oc_?FVZgX@XRAqQ{b#i4gL_udZsHD+XCV>2?s2~QdN2`v^nI%9HWVRU6wWq5RTa%D3_C}VGKb95k7Wq5RTa%D3_L}hbhCMf_TVK6sjHZV6fV=*;lFgG@0F=I3}W-u{hIWu84G%_(`F~kW^6#5A*6goO%a%Ew3WkYphWldplC}VGKb95j>bz)^rVQ@rcb7Lkc03%^DHaIwCF=a3{W;HQoV`VU5FgIm0Gh=2kVlXr^W@Ti?2~QIG2`w2qI%9HWVRU6fbz)^rVQ@ima$$KWV{dMAbRa`@Vr5NXa6xi%VR=Mlb7Lkc03%^BV=*!{Vq{`AH85j2I5IIZGG#JmWn(vCV>LN2I5{=Q2~QXL2`wQyI%9HWVRU6fZ*FsRVQzFnb!KK|awv0jWI8%?X?kT}bSxlaZ*FsRAa-wQWGXBmRdZoyWhnq7VPZ8mG&f~3Wj8f3Vl!emGc+(bH)b+0F*#y3F*!6aG|CB2ANmO`E;>46a%Ew3Wl3&iWq3k$W@cq_D06gVIy!S{dSzd9EFfcVZgX@Xc5i89Dl8yLZe(S6MsIR$VRS4YRdZoyWhnq7VPj!qI50OhGBGhYW-wtmGBr0eIAb_tV>D%EIW;smV$2CoEcyv84LUk=WpqhyWMz0lb!KK|awth|WMz0lb!KK|awz~KVK8AbIXE$6F=jJjH8M3gG-PHmH#s*jG-Wt5GB##4G|mZ63;GEyAv!u^a%Ew3WmaW!bY*x#b!KK|awv0jWI8%?X?kT}bSxlaZ*FsRAa-wQWGXBmRdZoyWhnq7VP#}FGGR4lH#Rb5Wil{kH#IOeF=I4iIb|_4I50OhFwhB4ANmO`7&mHnIWaL|VmUZsF*af}Fl1$9Ib&qf2~QUK2`vpeI&)=oR%LQ@Wq3hya$$KWR%LQ@Wq3hya$$KX03%^yW;rl6IWuB8G-P8mIW}TAF=8_@Ha0alW-&ElGdDQY2~P|92`v;lI%9HWVRU6vXklb!a#M6+XJsf;bYW*@EFfcVZgX@XV`yP=Dk%UXVP#`8G&VIjVKp#gWHvQ1GG#VmWHDwlFkv$=IXPxCG1duB68Z@(8ag^-a%Ew3Wm9NjWMy(tX>et1X>MgGQ)ppiWpYz=VP|D5AX8{zWMy(wbYW*@DF7p3Fk&<`Gi5krVPs}AF*#v5F*#u}VlgsfF=jJkH8Nr_*a=S<`Ux#3Iyz%=Wnpw>Q)ppiWpYqyaAj<1Ze=J_Xklb!a#M6+XJsrPQ)ppiWpYz=VP|D5AX8{zWMy(wbYW*@DF7p3V=^`|HDO|8H#cN4W@9rpFk?11Fgam0Wn*SxVK*@_+6hl3`Ux!!Iyz%=Wnpw>Q)ppiWpYqyaAj<1Ze=J_Xklb!a#M6+XJsh>BVjaRV`exuWj8WpIAJtpWj1CqWjACsWHK-`HfA(8G&tM|PYe19Ef6|7b7gc>Xklb!a!_e-Wo&6~WhhfwY-w&~DF7p3H92KDHZx^rIAt<2WMO79Win-EVq{`uV`MWhWi>N4-U&|*`Ux!@Iyz%)WnpqdZ)|UJC}wPLVRS4YW^8X^bSxldY;R$7EFflVZ((#P03%^xH8?UcW@TkIIAmotHezKrV=-i7Vm3ErWi>cAH(@s52~QgO2`wo)I%8~QVRBSqa%W|9LvL(vawv0jWI8%?X?kT}bSxldY;R$7EFflVZ((#SAZBcDVRS4YW^8X^bSVHMVKg={Vq-UBGBIR1H#lWvV=y;iWn(vDH8?OZV>UH1GvWzPC;AC32Rb@qY-M3`L}hSvXeefEZ((#P03%^FFflY_FlAvmFfcJQF)%n`W;SIpG%-11Vq!2kI5#)s2~P$32`vRWI%8~QVRBP+Wo~0>Y$$1NbSVHMVP-HnFk@pmIb~!sW@b1uGB7nYV=-nqV>L52VKy{5Hs%RW1NsRq8ag^;a$$E=a%o|1XKZD2D06gVIy!S{dSzd9EFg1qWI8%?X?kT}bSVHMVKienH#jghHZe0aG&eRgIAbwlV`MinH85sjGB;v0H0TLW82Sk<8ag^;a$$E=a%o|1XKZD2Np56icx7ZLb97`nI&*1yWnXkGAaitNIy!S{dSzd9DF7p3HDzREW@R`wFgRf}Fg7zcW??dBVK^{2VPs)pWMVTh>IqL6`Ux#3Iyz)>VRuw=X<=?>Y-MvvZgX^DZewL+D06gVIy!S{dSzd9EFg1qWI8%?X?kT}bSxlqbYwa@b7^{IUvwz|BVl1RW??mAWjHf2FfnE@F)=k_H)3KnFfn8}G-YEsF*fW8PbK;ZEhjoUWO8A5RB~xyZf9&|b4hMwWq4&|Np5p=VQyn(WGHiVWI8%?X?kT}bSxlqbYwa@b7^{IUvw-Wb97`nI&*1yWnXkD03%^xH#B8tV=-YcVK!r7IAJj`Ib=37H)LfpG&D0dFgIcD2~Q>Z2`wi&I%H{caA9;~XhUypaCLNLD06gVIy!S{dSzd9EFg1qWI8%?X?kT}bSxlqbYwa@b7^{IUvwz|BVjc)W@9loVPiIAF=b>kH8(OfWHdQ9H#lW8WH~W2I5Y4GPbK;ZEf6|7ZDnn5a(O~wa&l>9awtt@ZEtdULSb@pX=QSADF7p3Wj8o5IWaIcFgY?YW;HZ8Wid4}GBr6cVP!TrGGQ_`@(E84`Ux!*Iy!S@bXI9)cW`fVbSPN2ZAZc!NDF7p3Gcq_gH#B58VliZ6GGk>hW@cn$VlrklW??ruH8x{5^a)QA`Ux!*Iy!S@bW>w#b8~NUC~0nVEFfuabSxlgZgealX>N2W03%^HVr6DCH)c3DF*7+aHZx^0IW}fDIAk+5GdDJ7H#TAR2~QIG2`vgbI%j2cP;zf@WpZ?RC{S{5aAk6Ic_{!RVPRorG&C?|H#TE7IXGlEHf1w6Hf1w7Wil~jGh=39IQR)q2nGZIIyzEiZe(S0L}hkqV`TtiY+-YAV|8M0b6+uEF=KCXWnVF0F=uRFF<&uKWo~3;aztfzX=7zBXmo9C9RUD3I#YRbbY*Q+a$#w7a{zO6a&=>LV|8M0b6+uEF=KCXWnVF0F=bD+9Uol@XQ+acAWo=Y)VQF-8E@*UZZ2bWMFJ@_MWnXi2a%Ev{E@*IY0A^`yWnW)&baG{3ZC^NOaBwbYbZu;5b8}^Mb1!0YX=G<*FKuCIZZ2bRZ~$d)XK8L_UovxHZE$R5b6+xHb8}^Mb6+xIa%p5|WnVIFVQFq(IAd^dE@*UZZ2t)+Iy!b`V*n#zIAmisFfd^=IW}ZBV_`KnVP@6CZUA$1a&=>LV|8M0b6+uEF=cLNX>Mg-F<&uIZ*ysMX>V>WXmo9C2MRw&_bZ>Hb03%^$WHB;gWMX17IAk?uVL3Q7Wi@0tF*r9fW-&8lFk)f{3Pd_OaA9&~Zgc=6VK*^lV`euwGi5ktVqq~jI5TE2WMVO8Vl_EsH)J_EH3terIy!S{Vr*${X8CBqHfA(AGGk(5GB9K_I5K83VP;}xHa0b6VFwCCIyz)wbYTD^VKiYiH8^86HDoqrGcsa0Gi5L{H)3HiWivT9V=yx?Vh0LDIy!S{dSw73VK+51H#ImiHZwIeH(@wqWH&csH8Np2VL3N5G&5p0FeL#tIyyyebaHtBUol@XMQ(I*c`j&lZEPV11TS)BZe(S0WpV&GH(@t8G&f~sH#a#qFfubWGczzXHZWv2Ib$<7V`VTdXmo9CWMOn+FJ^NuWo=?*WMpMzUtw}%XlZt3FKuCIZZ2bRZ~$X(a%EpKb75_8Y-Mv_GGt+NVP7(4b6+xLZDM6)WMyPuUtw}%XlZt3UovfBX>MOQV{mXTXmo9CAqD_1V|8M0b1rCbZ~$XdS!AbV{dMAbRctdWI8%?baH8KXC^5CBVjXPVlg)}I5lHtG&E*qIAt(mIX5(6G%++VWMyMyWH$>6RT41@GYL96a%Ev;NjNBJZgedH7VmA#6RR=K&GYUF7a%Ev;NijAkX>N2eHeYlmDF7p3V`649H8eJ1IW;shFk(0~Ff(N{G-WbnV>vTsI59P14+>QXF$yyZIy!P?VPr`&GALN2jG+%TkDF7p3HDfkrGC5;1VKX^nFg7N2eHeYlmDF7p3G-5bnWHdH2V>D(mIWRCaWn?pCH8we6V=^%|Vm4(o7YbDgF$yyaIy!P?VPsV^GAMOvZgev;UvwrZ03%^xHa1~mW-v82He)h4I50S4WM(;HH8VCcW@9!vH8V9C3RMX)3Ns5jI&x)UWK}jaD0OLWbT%|!bS5bPBVjOQW@2PCW;r%BGBYtUWMMHgWH4lAH8wXkWMegCF)|wpRS7W)GYC35a%Ev;Ml&)fW^8X^bS5bPBVjl&G&MLmF)(8=H#cHrFfcJRVlp{5W;r!DWHM%DIAk3PRR%E%GYL96a%Ev;Mm97kWN&q1Y-J`X03%^xHaKNBWHMx9I5#ynH#0eAIc8&GVq!C9IAJwoIAmoX3RMR&3Nr^fI&x)UWI}ImY$#%HZ)_$h03%^BW;8iDGBP-0HZe3}IA$<7G%#Z`H8n9YV`VfmW;kUb3RML$3NsEmI&x)UWK(oMmIb97`nI&*Y#X>MmGDF7p3G&yEAGGQ|^IASz5IWjqBHaTH5Fl9AmWjA6qVK^~kBMMavF$yyRIyz!yXK8LvVrpe$bSNnRBVjQ(IWjV0VKg~rWM(-zFfd{^H8^26V=*~1VlrZ4I58y(RWS-P0y;WnZe&klYGq?|C@BCVVKic6VmC23GiG68F*G?iVK`$mV`F1AV=^>iIWl1|GbajFF$yyRIyz!yXK8Lha&lpLC@BCVVPs}BIWuHrWHd8nWHd1_H!(G1WHMzpVP!QqV`4KjH7N>JF$yyRIyz-;WI=LrVRV>}a(O5z03%^EF=IAjGBP%0VlXx|F*Ia1G&wmmG&4A6VK6f|HDY5g3RPhM06IEKQ%_DrWpib6X<=+>dS!9|V{Bn_b7OU4Z*yNUUom5Ea%EpJUom81bYWjHUolEkPfkQ-b7gXAVQgu7WpXZPbZu--1_Uo;VRT^tIW;vjIb<_8H#0S1WHn+jG%`0iIc6|4GG%3EFk~|~E@*UZY(WYw0y;W!Z*O!cDF7p3I5ae5GdM9~F*G%0IW;n6Gczz{GB+|bFfn5_Wj8l7GYU^Z3N0);I&E)tZgePfbYwa@b98cPZf9S1X=QgTAaitNIy!Z3X>oOBUvPACJVA0}XlZt3J}CerVKy>1Vlpx`V`Vd9F=Jz9GG=6BF*!J4IbvgEG%z$_IW-DTDnSY@5;{6{Zf$RMZgePfbYwa@b98cPZf9S1X=QgQ03%^zWH~o5W@9sEWHDqnG%#Z^VKz81F=jVpGBh`1V=yx}3QrJ03M~>kI%a8ZWGHiVWI8%?baH8KXJ2+{Wp^n6BVl7QIWaXhH#IV2WH2>0F)}h^Vm3E3Ffll0V>K~lWHdPnPY^*0Ef_jFV{&C-bY&=WbYwa@b98cPZf9S1X=QgTAYyNCY$*UEVKiYiV>V(iV`4aCGc#mmI5T5mVK!rAVP-TjG&g2AH#-VX7C{Ov5;{6$Wpi|LZ+R$lbYwa@b98cPZf9S1X=QgQ03%^xF)}z~Gh#MmGdE!~V=!ViH)dsJWiT@{H)djHHDftF3QrJ03N0c!I&W}gZYXnfWI8%?baH8KXJ2+{Wp^wfMrmwiIyz5qWo}JxWMwG;BVjmUWHB@{IW=WBVP!L7F=l09H)3ICHe@g|He@tpHDo^uPav5GB2#&DbY*P-Q+acAWo<5KbZu-&3Me`{O<{9u03%^DV>M+sW-(%8Gc-0fGdE;rIbvmGFk~?@VPQBkV>vNN3Me`{X>Md?cmN||Wn^MwH8o^3VK`%AHe_RFFf}!0Wi?}BH8V40IXE?9NeU=BI%j2WWpZJ3X>V=-BVjo>I5Ib4Ha9Y3Wi??iI5RP3V>mW4VmW0tWj8itF=9yyC=@z6MQ(Iyba^OsX>N2gGGBBoAa!YObTcwvbSVHMVL3H2Fk@jdVK6vmFflVRHexq7Vm31~WjQrrHa0alWkm`~5=jau2s%1xb53<^Y$z!pV{dMAbO0k^VK8PeGBh+aVlXi_GBq?}GBGt_GGsJmGBY${HDh8iM+!;?m;nGfIz?`DX>@r2V{Bn_b7OU4Z*yNUUom5Ea%EpJUomB4b6+uEF-2~4X>@rmXmo9COA0bNI&WrXb7gb@BVjQ)WjAIvW;r)yG&V3~Ib~#IG&D0aI5%QsGd5*nG&uAG06IENZ*_BJQ)6;(Y-~k#Wo~o;b98cbV{~J6VsCR_F<&ubZ*pZ{F<&uhZ(lKAF->oEb7fOwa&K&GMRsLwbS`LgZEPV11TS=QVQzC~Z*pw_HD)(3F)%bVWi~ZrHe)h2G+{PlF=S&lHexX_H8Nu|E@*UZY=H&OUol2UjZggpMc_4FTY-M9~Z*n?1Wo~q7ba_){Y-M9~Z*ovKlPbZu-SXJI&GFl9M2Ib$(2GC5{9F)%YXI5Rh9W-w+qH)b_8Gh|K*N(TJ}2Oz?`AVqF;X>@rYb7gF0V{~tF0A+4;X>@rlb7gF0V{~tFEp%^hY%OqXb!TaAE@*UZY)%FMFKlmTE@*IY0Bmn(UpQ!Ra4u+cZERBtR606CZ*^{T0AXc0GiEtCG-fa{V>L53V>D$lW;bLwH8MD3Gi72mWjSREGCDd#Z)|L7b7^mGRC#b^03%^zGd4FfG-P8pH8Er|IXN|EVlif6Ha0XeIW#phH#jzB3Nku6Lt$=YX=Gt^WdI{#HfAwmF=H|}HaRpfWil~jIW;#lVPrL9Vq-XAH)Ao4GVq-aGHezHoGBsi|IXPrwH)LTmFkxjhWePF~IyzxwWJPXtX>@rgMQ(Iyba^QNBVjUOW;tSEIXPrFW@0gBGGR3_F*0H`Vqs=AH)1(4W@K3kR0d@VG6*_4a%F9Ac4b9wbZK;XC`E2`X>@rh03%^GVPrKkGC5*7H8V0cHZo!}H8Ev3GBss1FlIP4F)?CW3RDJV3NivZI%8~QVRA)obZK;HWpgMg03%^JF*7kTH#IOdVP!EnHD+dIH8e0YHezBoF*GV>+d2nSZAY*TCb94YBVKHPlF*GwZGdW>qIAJzqGG#DgGBG$dVK_ErHe@zrG+_!<6J-iA0y;WlY-M3`Lt$=YX=Gt^WpgMg03%^DV>D$sVq`L6Vqq|5VmV=9FfwCfV=^^lI5;ykVKFje3RLC>06IECa&KW|P-tOuWkYXlY-w|8Z*Fq{b98cbV{~J6VsCR_F<&udZf9w3WnVF0F+y^0VPsHfVRL0eZ)|L7b7^mGb1rCfZEOM_0U`n`0WbkI0XqRe14jc&1x^K00ayTB0Av7XaA9X + + + + core/ui/serialization.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ui/serialization.hpp file +

+

Functions for showing and editing serializable objects in the UI.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ui
+
User Interface module.
+
+
+
+

Functions

+
+
+ void showPackage(const data::Package& pkg, + const std::string& name) +
+
Shows a packaged object's properties in the UI. Should be called inside a ImGui::BeginTable(2) and ImGui::EndTable() block.
+
+ auto editPackage(data::Package& pkg, + const std::string& name) -> bool +
+
Shows a packaged object's properties in the UI, allowing the user to edit the object. Should be called inside a ImGui::BeginTable(3) and ImGui::EndTable() block.
+
+
template<typename T>
+ void show(const T& object, + const std::string& name) +
+
Shows a serializable object's properties in the UI. Should be called inside a ImGui::BeginTable(2) and ImGui::EndTable() block.
+
+
template<typename T>
+ auto edit(T& object, + const std::string& name) -> bool +
+
Shows a serializable object's properties in the UI. Should be called inside a ImGui::BeginTable(3) and ImGui::EndTable() block.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/settings_8hpp.html b/pr-preview/pr-494/settings_8hpp.html new file mode 100644 index 000000000..45f4e0bd6 --- /dev/null +++ b/pr-preview/pr-494/settings_8hpp.html @@ -0,0 +1,130 @@ + + + + + core/settings.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/standard__archive_8hpp.html b/pr-preview/pr-494/standard__archive_8hpp.html new file mode 100644 index 000000000..fa6ff6565 --- /dev/null +++ b/pr-preview/pr-494/standard__archive_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/data/fs/standard_archive.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/standard__stream_8hpp.html b/pr-preview/pr-494/standard__stream_8hpp.html new file mode 100644 index 000000000..e8bce49e5 --- /dev/null +++ b/pr-preview/pr-494/standard__stream_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/memory/standard_stream.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/storage_8hpp.html b/pr-preview/pr-494/storage_8hpp.html new file mode 100644 index 000000000..1b629b521 --- /dev/null +++ b/pr-preview/pr-494/storage_8hpp.html @@ -0,0 +1,137 @@ + + + + + core/ecs/storage.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/storage.hpp file +

+

Class cubos::core::ecs::Storage and related types.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
+
+
+

Classes

+
+
+ class cubos::core::ecs::IStorage +
+
Abstract parent class for all storages.
+
+
template<typename T>
+ class cubos::core::ecs::Storage +
+
Abstract container for a component type T.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/stream_8hpp.html b/pr-preview/pr-494/stream_8hpp.html new file mode 100644 index 000000000..7127bb402 --- /dev/null +++ b/pr-preview/pr-494/stream_8hpp.html @@ -0,0 +1,144 @@ + + + + + core/memory/stream.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/memory/stream.hpp file +

+

Class cubos::core::memory::Stream.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::memory
+
Memory module.
+
+
+
+

Classes

+
+
+ class cubos::core::memory::Stream +
+
Interface class for memory streams. Abstracts away sources or destinations of data.
+
+
+
+

Enums

+
+
+ enum class SeekOrigin { Begin, + Current, + End } +
+
Stream seek origin.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structMyAsset.html b/pr-preview/pr-494/structMyAsset.html new file mode 100644 index 000000000..242ee71bd --- /dev/null +++ b/pr-preview/pr-494/structMyAsset.html @@ -0,0 +1,101 @@ + + + + + MyAsset struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ MyAsset struct +
#include <assets/json/main.cpp>
+

+

A simple serializable type which we will be saving and loading.

+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1data_1_1Debug.html b/pr-preview/pr-494/structcubos_1_1core_1_1data_1_1Debug.html new file mode 100644 index 000000000..3b8fb4a95 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1data_1_1Debug.html @@ -0,0 +1,154 @@ + + + + + cubos::core::data::Debug struct | CUBOS. + + + + + + + +
+
+
+
+
+

+
template<typename T>
+ cubos::core::data::Debug struct +

+ + + + + + + + + + +
Template parameters
TThe type of the value to wrap.
+ +

Used to wrap a value to be printed using the debug serializer. Can be pretty-printed using the p option. Types can be printed using the t option.

Example usage:

CUBOS_ERROR("Cool debug serialized object: {}", Debug(mySerializableObj)); CUBOS_INFO("Pretty printed: {:p}", Debug(mySerializableObj)); CUBOS_INFO("With types too: {:pt}", Debug(mySerializableObj));

+
+

Constructors, destructors, conversion operators

+
+
+ Debug(const T& value) +
+
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ cubos::core::data::Debug<T>::Debug(const T& value) +

+ + + + + + + + + + +
Parameters
valueThe value to debug.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1data_1_1EmbeddedArchive_1_1Data.html b/pr-preview/pr-494/structcubos_1_1core_1_1data_1_1EmbeddedArchive_1_1Data.html new file mode 100644 index 000000000..07e7d871d --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1data_1_1EmbeddedArchive_1_1Data.html @@ -0,0 +1,135 @@ + + + + + cubos::core::data::EmbeddedArchive::Data struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1data_1_1EmbeddedArchive_1_1Data_1_1Entry.html b/pr-preview/pr-494/structcubos_1_1core_1_1data_1_1EmbeddedArchive_1_1Data_1_1Entry.html new file mode 100644 index 000000000..253c11438 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1data_1_1EmbeddedArchive_1_1Data_1_1Entry.html @@ -0,0 +1,145 @@ + + + + + cubos::core::data::EmbeddedArchive::Data::Entry struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::data::EmbeddedArchive::Data::Entry struct +
#include <core/data/fs/embedded_archive.hpp>
+

+

Describes a file entry in the embedded data.

+ +
+

Public variables

+
+
+ const char* name +
+
Name of the file entry.
+
+ bool isDirectory +
+
Whether the entry is a directory.
+
+ std::size_t parent +
+
Index of the parent directory.
+
+ std::size_t sibling +
+
Index of the next sibling.
+
+ std::size_t child +
+
Index of the first child.
+
+ const void* data +
+
Data of the file entry.
+
+ std::size_t size +
+
Size of the data.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1data_1_1QBMatrix.html b/pr-preview/pr-494/structcubos_1_1core_1_1data_1_1QBMatrix.html new file mode 100644 index 000000000..3b9afc4ae --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1data_1_1QBMatrix.html @@ -0,0 +1,128 @@ + + + + + cubos::core::data::QBMatrix struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1QueryInfo.html b/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1QueryInfo.html new file mode 100644 index 000000000..5a1f7def1 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1QueryInfo.html @@ -0,0 +1,125 @@ + + + + + cubos::core::ecs::QueryInfo struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1SystemInfo.html b/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1SystemInfo.html new file mode 100644 index 000000000..721d9b4fe --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1SystemInfo.html @@ -0,0 +1,197 @@ + + + + + cubos::core::ecs::SystemInfo struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::ecs::SystemInfo struct +
#include <core/ecs/system.hpp>
+

+

Describes a system.

+ +
+

Public functions

+
+
+ auto valid() const -> bool +
+
Checks if this system is valid.
+
+ auto compatible(const SystemInfo& other) const -> bool +
+
Checks if this system is compatible with another system.
+
+
+
+

Public variables

+
+
+ bool usesCommands +
+
Whether the system uses commands or not.
+
+ bool usesWorld +
+
Whether the system uses the world directly.
+
+ std::unordered_set<std::type_index> resourcesRead +
+
Set of resources the system reads.
+
+ std::unordered_set<std::type_index> resourcesWritten +
+
Set of resources the system writes.
+
+ std::unordered_set<std::type_index> componentsRead +
+
Set of components the system reads.
+
+ std::unordered_set<std::type_index> componentsWritten +
+
Set of components the system writes.
+
+
+
+

Function documentation

+
+

+ bool cubos::core::ecs::SystemInfo::valid() const +

+

Checks if this system is valid.

+ + + + + + + +
ReturnsWhether the system is valid.
+

A system may be invalid, if, for example, it both reads and writes the same resource.

+
+
+

+ bool cubos::core::ecs::SystemInfo::compatible(const SystemInfo& other) const +

+

Checks if this system is compatible with another system.

+ + + + + + + + + + + + + + + + +
Parameters
otherOther system.
ReturnsWhether the systems are compatible.
+

Two systems are compatible if they can be executed in parallel. This means that they must not, for example, write to the same resource or component.

+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1impl_1_1Index.html b/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1impl_1_1Index.html new file mode 100644 index 000000000..04619fd10 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1impl_1_1Index.html @@ -0,0 +1,118 @@ + + + + + cubos::core::ecs::impl::Index struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1impl_1_1QueryFetcher.html b/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1impl_1_1QueryFetcher.html new file mode 100644 index 000000000..c206f50ce --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1impl_1_1QueryFetcher.html @@ -0,0 +1,114 @@ + + + + + cubos::core::ecs::impl::QueryFetcher struct | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/query.hpp>
+
template<typename T>
+ cubos::core::ecs::impl::QueryFetcher struct +

+

Fetches the requested data from a world.

+ + + + + + + + + + +
Template parameters
TQuery argument type.
+

Each possible accessor type is specialized to provide the correct data.

+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1impl_1_1SystemFetcher.html b/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1impl_1_1SystemFetcher.html new file mode 100644 index 000000000..a8b02a6e5 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1impl_1_1SystemFetcher.html @@ -0,0 +1,268 @@ + + + + + cubos::core::ecs::impl::SystemFetcher struct | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/ecs/system.hpp>
+
template<typename T>
+ cubos::core::ecs::impl::SystemFetcher struct +

+

Fetches the requested data from a world.

+ + + + + + + + + + +
Template parameters
TSystem argument type.
+ +
+

Public types

+
+
+ using Type = char +
+
Type of the fetched data.
+
+
+
+

Public static functions

+
+
+ static void add(SystemInfo& info) +
+
Adds the argument T to the given info.
+
+ static auto prepare(World& world) -> State +
+
Prepares the argument for being executed on the given world.
+
+ static auto fetch(World& world, + CommandBuffer& commands, + State& state) -> Type +
+
Fetches the data from the given world.
+
+ static auto arg(Type&& fetched) -> T +
+
Converts the fetched data into the actual desired argument.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ static void cubos::core::ecs::impl::SystemFetcher<T>::add(SystemInfo& info) +

+

Adds the argument T to the given info.

+ + + + + + + + + + +
Parameters
info outSystem information.
+
+
+

+
+ template<typename T> +
+ static State cubos::core::ecs::impl::SystemFetcher<T>::prepare(World& world) +

+

Prepares the argument for being executed on the given world.

+ + + + + + + + + + + + + + + + +
Parameters
worldWorld to prepare the argument for.
ReturnsState of the argument.
+
+
+

+
+ template<typename T> +
+ static Type cubos::core::ecs::impl::SystemFetcher<T>::fetch(World& world, + CommandBuffer& commands, + State& state) +

+

Fetches the data from the given world.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
worldWorld to fetch the data from.
commandsBuffer where commands can be submitted to.
stateState of the argument.
ReturnsFetched data.
+
+
+

+
+ template<typename T> +
+ static T cubos::core::ecs::impl::SystemFetcher<T>::arg(Type&& fetched) +

+

Converts the fetched data into the actual desired argument.

+ + + + + + + + + + + + + + + + +
Parameters
fetchedFetched data.
ReturnsActual argument.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1impl_1_1SystemTraits.html b/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1impl_1_1SystemTraits.html new file mode 100644 index 000000000..4336fb18d --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1ecs_1_1impl_1_1SystemTraits.html @@ -0,0 +1,102 @@ + + + + + cubos::core::ecs::impl::SystemTraits struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1geom_1_1Box.html b/pr-preview/pr-494/structcubos_1_1core_1_1geom_1_1Box.html new file mode 100644 index 000000000..0101ec344 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1geom_1_1Box.html @@ -0,0 +1,193 @@ + + + + + cubos::core::geom::Box struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::geom::Box struct +
#include <core/geom/box.hpp>
+

+

Represents a box shape.

+ +
+

Public functions

+
+
+ void diag(glm::vec3 corners[2]) const +
+
Computes two opposite corners of the box on the major diagonal.
+
+ void corners4(glm::vec3 corners[4]) const +
+
Computes four corners of the box, one for each diagonal.
+
+ void corners(glm::vec3 corners[8]) const +
+
Computes the eight corners of the box, opposite corners are adjacent in the array.
+
+
+
+

Public variables

+
+
+ glm::vec3 halfSize +
+
Half size of the box.
+
+
+
+

Function documentation

+
+

+ void cubos::core::geom::Box::diag(glm::vec3 corners[2]) const +

+

Computes two opposite corners of the box on the major diagonal.

+ + + + + + + + + + +
Parameters
cornersArray to store the two corners in.
+
+
+

+ void cubos::core::geom::Box::corners4(glm::vec3 corners[4]) const +

+

Computes four corners of the box, one for each diagonal.

+ + + + + + + + + + +
Parameters
cornersArray to store the three corners in.
+
+
+

+ void cubos::core::geom::Box::corners(glm::vec3 corners[8]) const +

+

Computes the eight corners of the box, opposite corners are adjacent in the array.

+ + + + + + + + + + +
Parameters
cornersArray to store the eight corners in.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1geom_1_1Capsule.html b/pr-preview/pr-494/structcubos_1_1core_1_1geom_1_1Capsule.html new file mode 100644 index 000000000..e872cfe8b --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1geom_1_1Capsule.html @@ -0,0 +1,185 @@ + + + + + cubos::core::geom::Capsule struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::geom::Capsule struct +
#include <core/geom/capsule.hpp>
+

+

Represents a capsule or sphere shape.

+ +
+

Public static functions

+
+
+ static auto sphere(float radius) -> Capsule +
+
Constructs a sphere.
+
+
+
+

Public functions

+
+
+ auto height() const -> float +
+
Gets the height of the capsule.
+
+
+
+

Public variables

+
+
+ float radius +
+
Radius of the capsule.
+
+ float length +
+
Length of the capsule.
+
+
+
+

Function documentation

+
+

+ static Capsule cubos::core::geom::Capsule::sphere(float radius) +

+

Constructs a sphere.

+ + + + + + + + + + + + + + + + +
Parameters
radiusSphere radius.
ReturnsSphere shape.
+
+
+

+ float cubos::core::geom::Capsule::height() const +

+

Gets the height of the capsule.

+ + + + + + + +
ReturnsHeight of the capsule.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1geom_1_1Plane.html b/pr-preview/pr-494/structcubos_1_1core_1_1geom_1_1Plane.html new file mode 100644 index 000000000..3fcd26a12 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1geom_1_1Plane.html @@ -0,0 +1,121 @@ + + + + + cubos::core::geom::Plane struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1geom_1_1Simplex.html b/pr-preview/pr-494/structcubos_1_1core_1_1geom_1_1Simplex.html new file mode 100644 index 000000000..a80c6c545 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1geom_1_1Simplex.html @@ -0,0 +1,292 @@ + + + + + cubos::core::geom::Simplex struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::geom::Simplex struct +
#include <core/geom/simplex.hpp>
+

+

Represents a simplex shape, which may either be empty, a point, a line, a triangle or a tetrahedron.

+ +
+

Public static functions

+
+
+ static auto empty() -> Simplex +
+
Constructs an empty simplex.
+
+ static auto point(const glm::vec3& p) -> Simplex +
+
Constructs a point simplex.
+
+ static auto line(const glm::vec3& p1, + const glm::vec3& p2) -> Simplex +
+
Constructs a line simplex.
+
+ static auto triangle(const glm::vec3& p1, + const glm::vec3& p2, + const glm::vec3& p3) -> Simplex +
+
Constructs a triangle simplex.
+
+ static auto tetrahedron(const glm::vec3& p1, + const glm::vec3& p2, + const glm::vec3& p3, + const glm::vec3& p4) -> Simplex +
+
Constructs a tetrahedron simplex.
+
+
+
+

Public variables

+
+
+ std::vector<glm::vec3> points +
+
Points of the simplex.
+
+
+
+

Function documentation

+
+

+ static Simplex cubos::core::geom::Simplex::empty() +

+

Constructs an empty simplex.

+ + + + + + + +
ReturnsEmpty simplex.
+
+
+

+ static Simplex cubos::core::geom::Simplex::point(const glm::vec3& p) +

+

Constructs a point simplex.

+ + + + + + + + + + + + + + + + +
Parameters
pPoint.
ReturnsPoint simplex.
+
+
+

+ static Simplex cubos::core::geom::Simplex::line(const glm::vec3& p1, + const glm::vec3& p2) +

+

Constructs a line simplex.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
p1First point.
p2Second point.
ReturnsLine simplex.
+
+
+

+ static Simplex cubos::core::geom::Simplex::triangle(const glm::vec3& p1, + const glm::vec3& p2, + const glm::vec3& p3) +

+

Constructs a triangle simplex.

+ + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
p1First point.
p2Second point.
p3Third point.
ReturnsTriangle simplex.
+
+
+

+ static Simplex cubos::core::geom::Simplex::tetrahedron(const glm::vec3& p1, + const glm::vec3& p2, + const glm::vec3& p3, + const glm::vec3& p4) +

+

Constructs a tetrahedron simplex.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
p1First point.
p2Second point.
p3Third point.
p4Fourth point.
ReturnsTetrahedron simplex.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1BlendStateDesc.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1BlendStateDesc.html new file mode 100644 index 000000000..3f4dd28ec --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1BlendStateDesc.html @@ -0,0 +1,165 @@ + + + + + cubos::core::gl::BlendStateDesc struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::BlendStateDesc struct +
#include <core/gl/render_device.hpp>
+

+

Describes a blend state.

+ +
+

Public variables

+
+
+ bool blendEnabled +
+
Enable blending?
+
+ BlendFactor src +
+
Color blend source factor.
+
+ BlendFactor dst +
+
Color blend destination factor.
+
+ BlendOp op +
+
Color blend operation.
+
+ struct cubos::core::gl::BlendStateDesc::@1 color +
+
Color blend state.
+
+ struct cubos::core::gl::BlendStateDesc::@2 alpha +
+
Alpha blend state.
+
+
+
+

Variable documentation

+
+

+ BlendFactor cubos::core::gl::BlendStateDesc::src +

+

Color blend source factor.

+

Alpha blend source factor.

+
+
+

+ BlendFactor cubos::core::gl::BlendStateDesc::dst +

+

Color blend destination factor.

+

Alpha blend destination factor.

+
+
+

+ BlendOp cubos::core::gl::BlendStateDesc::op +

+

Color blend operation.

+

Alpha blend operation.

+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Camera.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Camera.html new file mode 100644 index 000000000..82f7e784d --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Camera.html @@ -0,0 +1,141 @@ + + + + + cubos::core::gl::Camera struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1ConstantBufferElement.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1ConstantBufferElement.html new file mode 100644 index 000000000..86d2330cc --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1ConstantBufferElement.html @@ -0,0 +1,133 @@ + + + + + cubos::core::gl::ConstantBufferElement struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::ConstantBufferElement struct +
#include <core/gl/render_device.hpp>
+

+

Describes an element in a constant buffer.

+ +
+

Public variables

+
+
+ char name +
+
Element name.
+
+ std::size_t offset +
+
Offset of the element in the buffer.
+
+ std::size_t size +
+
Number of values in the element if it is an array. If it isn't, this is set to 1.
+
+ std::size_t stride +
+
Stride between each element in the array, if the element is an array.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1ConstantBufferStructure.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1ConstantBufferStructure.html new file mode 100644 index 000000000..6eb1d3976 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1ConstantBufferStructure.html @@ -0,0 +1,129 @@ + + + + + cubos::core::gl::ConstantBufferStructure struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1CubeMapArrayDesc.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1CubeMapArrayDesc.html new file mode 100644 index 000000000..9ba77a23b --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1CubeMapArrayDesc.html @@ -0,0 +1,145 @@ + + + + + cubos::core::gl::CubeMapArrayDesc struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::CubeMapArrayDesc struct +
#include <core/gl/render_device.hpp>
+

+

Describes a cube map array.

+ +
+

Public variables

+
+
+ const void* data +
+
Optional initial cube map data, indexed using CubeFace.
+
+ std::size_t mipLevelCount +
+
Number of mip levels.
+
+ std::size_t width +
+
Cube map face width.
+
+ std::size_t height +
+
Cube map face height.
+
+ std::size_t size +
+
Number of cube maps contained in the array.
+
+ Usage usage +
+
Texture usage mode.
+
+ TextureFormat format +
+
Texture format.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1CubeMapDesc.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1CubeMapDesc.html new file mode 100644 index 000000000..554c28ba4 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1CubeMapDesc.html @@ -0,0 +1,141 @@ + + + + + cubos::core::gl::CubeMapDesc struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::CubeMapDesc struct +
#include <core/gl/render_device.hpp>
+

+

Describes a cube map.

+ +
+

Public variables

+
+
+ const void* data +
+
Optional initial cube map data, indexed using CubeFace.
+
+ std::size_t mipLevelCount +
+
Number of mip levels.
+
+ std::size_t width +
+
Cube map face width.
+
+ std::size_t height +
+
Cube map face height.
+
+ Usage usage +
+
Texture usage mode.
+
+ TextureFormat format +
+
Texture format.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc.html new file mode 100644 index 000000000..0a49830fc --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc.html @@ -0,0 +1,139 @@ + + + + + cubos::core::gl::DepthStencilStateDesc struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Depth.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Depth.html new file mode 100644 index 000000000..04041d3ad --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Depth.html @@ -0,0 +1,137 @@ + + + + + cubos::core::gl::DepthStencilStateDesc::Depth struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Stencil.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Stencil.html new file mode 100644 index 000000000..1debfed87 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Stencil.html @@ -0,0 +1,151 @@ + + + + + cubos::core::gl::DepthStencilStateDesc::Stencil struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::DepthStencilStateDesc::Stencil struct +
#include <core/gl/render_device.hpp>
+

+

Describes a stencil state.

+ +
+

Public types

+
+
+ struct Face +
+
Decribes a stencil face.
+
+
+
+

Public variables

+
+
+ bool enabled +
+
Is stencil enabled?
+
+ uint32_t ref +
+
Stencil ref value used on stencil comparison functions.
+
+ uint8_t readMask +
+
Stencil read mask.
+
+ uint8_t writeMask +
+
Stencil write mask.
+
+ Face backFace +
+
Stencil back face options.
+
+ Face frontFace +
+
Stencil front face options.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Stencil_1_1Face.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Stencil_1_1Face.html new file mode 100644 index 000000000..8b86ed52a --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Stencil_1_1Face.html @@ -0,0 +1,133 @@ + + + + + cubos::core::gl::DepthStencilStateDesc::Stencil::Face struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DirectionalLight.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DirectionalLight.html new file mode 100644 index 000000000..5d0234779 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1DirectionalLight.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::DirectionalLight struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc.html new file mode 100644 index 000000000..e525c4640 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc.html @@ -0,0 +1,162 @@ + + + + + cubos::core::gl::FramebufferDesc struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::FramebufferDesc struct +
#include <core/gl/render_device.hpp>
+

+

Describes a framebuffer.

+ +
+

Public types

+
+
+ struct CubeMapArrayTarget +
+
Describes a cube map array target.
+
+ struct CubeMapTarget +
+
Describes a cube map target.
+
+ struct FramebufferTarget +
+
Describes a framebuffer target.
+
+ struct Texture2DArrayTarget +
+
Describes a 2D texture array target.
+
+ struct Texture2DTarget +
+
Describes a 2D texture target.
+
+ enum class TargetType { CubeMap, + Texture2D, + CubeMapArray, + Texture2DArray } +
+
Possible types of targets.
+
+
+
+

Public variables

+
+
+ struct cubos::core::gl::FramebufferDesc::FramebufferTarget targets +
+
Render targets.
+
+ uint32_t targetCount +
+
Number of render targets.
+
+ FramebufferTarget depthStencil +
+
Optional depth stencil target.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1CubeMapArrayTarget.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1CubeMapArrayTarget.html new file mode 100644 index 000000000..b7972a915 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1CubeMapArrayTarget.html @@ -0,0 +1,121 @@ + + + + + cubos::core::gl::FramebufferDesc::CubeMapArrayTarget struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1CubeMapTarget.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1CubeMapTarget.html new file mode 100644 index 000000000..80a2d99ed --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1CubeMapTarget.html @@ -0,0 +1,125 @@ + + + + + cubos::core::gl::FramebufferDesc::CubeMapTarget struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1FramebufferTarget.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1FramebufferTarget.html new file mode 100644 index 000000000..d5d92dbe1 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1FramebufferTarget.html @@ -0,0 +1,121 @@ + + + + + cubos::core::gl::FramebufferDesc::FramebufferTarget struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1Texture2DArrayTarget.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1Texture2DArrayTarget.html new file mode 100644 index 000000000..8caacee98 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1Texture2DArrayTarget.html @@ -0,0 +1,121 @@ + + + + + cubos::core::gl::FramebufferDesc::Texture2DArrayTarget struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1Texture2DTarget.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1Texture2DTarget.html new file mode 100644 index 000000000..170f5125b --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1Texture2DTarget.html @@ -0,0 +1,121 @@ + + + + + cubos::core::gl::FramebufferDesc::Texture2DTarget struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Material.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Material.html new file mode 100644 index 000000000..e47b89c34 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Material.html @@ -0,0 +1,168 @@ + + + + + cubos::core::gl::Material struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::Material struct +
#include <core/gl/material.hpp>
+

+

Describes a voxel material.

+ +
+

Public static variables

+
+
+ static const Material Empty +
+
Empty material, used for voxels with index 0.
+
+
+
+

Public functions

+
+
+ auto similarity(const Material& other) const -> float +
+
Compares this material with another and returns a number which indicates how similar they are.
+
+
+
+

Public variables

+
+
+ glm::vec4 color +
+
Color of the material.
+
+
+
+

Function documentation

+
+

+ float cubos::core::gl::Material::similarity(const Material& other) const +

+

Compares this material with another and returns a number which indicates how similar they are.

+ + + + + + + + + + + + + + + + +
Parameters
otherOther material to compare with.
ReturnsSimilarity between the two materials.
+

The number is in the range [0, 1], where 0 means they are completely different and 1 means they are exactly the same.

+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1PointLight.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1PointLight.html new file mode 100644 index 000000000..8bcb40a9f --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1PointLight.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::PointLight struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1RasterStateDesc.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1RasterStateDesc.html new file mode 100644 index 000000000..9adf52c96 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1RasterStateDesc.html @@ -0,0 +1,137 @@ + + + + + cubos::core::gl::RasterStateDesc struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1SamplerDesc.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1SamplerDesc.html new file mode 100644 index 000000000..9ae31660c --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1SamplerDesc.html @@ -0,0 +1,149 @@ + + + + + cubos::core::gl::SamplerDesc struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::SamplerDesc struct +
#include <core/gl/render_device.hpp>
+

+

Describes a sampler.

+ +
+

Public variables

+
+
+ float borderColor +
+
Border color applied when the address mode is AddressMode::Border.
+
+ TextureFilter minFilter +
+
Minifying filter.
+
+ TextureFilter magFilter +
+
Magnifying filter.
+
+ TextureFilter mipmapFilter +
+
Set to None to disable mipmapping.
+
+ AddressMode addressU +
+
Texture adress mode on coordinate U.
+
+ AddressMode addressV +
+
Texture adress mode on coordinate V.
+
+ AddressMode addressW +
+
Texture adress mode on coordinate W.
+
+ std::size_t maxAnisotropy +
+
Max anisotropy for filtering. Limited to Property::MaxAnisotropy.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1SpotLight.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1SpotLight.html new file mode 100644 index 000000000..a6140d485 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1SpotLight.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::SpotLight struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Texture1DDesc.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Texture1DDesc.html new file mode 100644 index 000000000..48ea16175 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Texture1DDesc.html @@ -0,0 +1,137 @@ + + + + + cubos::core::gl::Texture1DDesc struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Texture2DArrayDesc.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Texture2DArrayDesc.html new file mode 100644 index 000000000..4f12eab9b --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Texture2DArrayDesc.html @@ -0,0 +1,145 @@ + + + + + cubos::core::gl::Texture2DArrayDesc struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::Texture2DArrayDesc struct +
#include <core/gl/render_device.hpp>
+

+

Describes a 2D texture array.

+ +
+

Public variables

+
+
+ const void* data +
+
Optional initial texture data.
+
+ std::size_t mipLevelCount +
+
Number of mip levels.
+
+ std::size_t width +
+
Texture width.
+
+ std::size_t height +
+
Texture height.
+
+ std::size_t size +
+
Number of 2D Textures contained in the array.
+
+ Usage usage +
+
Texture usage mode.
+
+ TextureFormat format +
+
Texture format.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Texture2DDesc.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Texture2DDesc.html new file mode 100644 index 000000000..d88c02c95 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Texture2DDesc.html @@ -0,0 +1,141 @@ + + + + + cubos::core::gl::Texture2DDesc struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Texture3DDesc.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Texture3DDesc.html new file mode 100644 index 000000000..7657c704c --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Texture3DDesc.html @@ -0,0 +1,145 @@ + + + + + cubos::core::gl::Texture3DDesc struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::Texture3DDesc struct +
#include <core/gl/render_device.hpp>
+

+

Describes a 3D texture.

+ +
+

Public variables

+
+
+ const void* data +
+
Optional initial texture data.
+
+ std::size_t mipLevelCount +
+
Number of mip levels.
+
+ std::size_t width +
+
Texture width.
+
+ std::size_t height +
+
Texture height.
+
+ std::size_t depth +
+
Texture depth.
+
+ Usage usage +
+
Texture usage mode.
+
+ TextureFormat format +
+
Texture format.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Vertex.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Vertex.html new file mode 100644 index 000000000..a104bd809 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1Vertex.html @@ -0,0 +1,129 @@ + + + + + cubos::core::gl::Vertex struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1VertexArrayDesc.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1VertexArrayDesc.html new file mode 100644 index 000000000..2d9e5dee8 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1VertexArrayDesc.html @@ -0,0 +1,133 @@ + + + + + cubos::core::gl::VertexArrayDesc struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1VertexElement.html b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1VertexElement.html new file mode 100644 index 000000000..c591be670 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1gl_1_1VertexElement.html @@ -0,0 +1,145 @@ + + + + + cubos::core::gl::VertexElement struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::gl::VertexElement struct +
#include <core/gl/render_device.hpp>
+

+

Describes a vertex element.

+ +
+

Public variables

+
+
+ const char* name +
+
Element name.
+
+ Type type +
+
Element type.
+
+ std::size_t size +
+
Number of components in the vertex element (1, 2, 3 or 4).
+
+ std::size_t stride +
+
Stride between each element in memory.
+
+ std::size_t offset +
+
Offset of the first element in the buffer.
+
+ std::size_t index +
+
Index of the vertex buffer where the element is stored.
+
+ struct cubos::core::gl::VertexElement::@3 buffer +
+
Vertex buffer description.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1KeyEvent.html b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1KeyEvent.html new file mode 100644 index 000000000..ad9734d4f --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1KeyEvent.html @@ -0,0 +1,125 @@ + + + + + cubos::core::io::KeyEvent struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1ModifiersEvent.html b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1ModifiersEvent.html new file mode 100644 index 000000000..9ce7bd2e8 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1ModifiersEvent.html @@ -0,0 +1,121 @@ + + + + + cubos::core::io::ModifiersEvent struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1MouseButtonEvent.html b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1MouseButtonEvent.html new file mode 100644 index 000000000..07654b474 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1MouseButtonEvent.html @@ -0,0 +1,125 @@ + + + + + cubos::core::io::MouseButtonEvent struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1MouseMoveEvent.html b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1MouseMoveEvent.html new file mode 100644 index 000000000..5fe5eb9ae --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1MouseMoveEvent.html @@ -0,0 +1,121 @@ + + + + + cubos::core::io::MouseMoveEvent struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1MouseScrollEvent.html b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1MouseScrollEvent.html new file mode 100644 index 000000000..b5ecd2c23 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1MouseScrollEvent.html @@ -0,0 +1,121 @@ + + + + + cubos::core::io::MouseScrollEvent struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1ResizeEvent.html b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1ResizeEvent.html new file mode 100644 index 000000000..bae024839 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1ResizeEvent.html @@ -0,0 +1,121 @@ + + + + + cubos::core::io::ResizeEvent struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1TextEvent.html b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1TextEvent.html new file mode 100644 index 000000000..38f452e9a --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1core_1_1io_1_1TextEvent.html @@ -0,0 +1,121 @@ + + + + + cubos::core::io::TextEvent struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1ActiveCameras.html b/pr-preview/pr-494/structcubos_1_1engine_1_1ActiveCameras.html new file mode 100644 index 000000000..be9f7b8b2 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1ActiveCameras.html @@ -0,0 +1,131 @@ + + + + + cubos::engine::ActiveCameras struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::ActiveCameras struct +
#include <engine/renderer/plugin.hpp>
+

+

Resource which identifies the camera entities to be used by the renderer.

+ +
+

Public variables

+
+
+ core::ecs::Entity entities +
+
Entities which represent the current active cameras. If more than one is set, the screen is split. At most, 4 cameras are supported at the same time.
+
+
+
+

Variable documentation

+
+

+ core::ecs::Entity cubos::engine::ActiveCameras::entities +

+

Entities which represent the current active cameras. If more than one is set, the screen is split. At most, 4 cameras are supported at the same time.

+ +
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1AmbientLight.html b/pr-preview/pr-494/structcubos_1_1engine_1_1AmbientLight.html new file mode 100644 index 000000000..3135da0cb --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1AmbientLight.html @@ -0,0 +1,101 @@ + + + + + cubos::engine::AmbientLight struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1Arguments.html b/pr-preview/pr-494/structcubos_1_1engine_1_1Arguments.html new file mode 100644 index 000000000..678fa167d --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1Arguments.html @@ -0,0 +1,102 @@ + + + + + cubos::engine::Arguments struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::Arguments struct +
#include <engine/cubos.hpp>
+

+

Resource used for storing program arguments.

+

This resource is added by the Cubos class when constructed with arguments.

+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1AssetMeta_1_1Exclude.html b/pr-preview/pr-494/structcubos_1_1engine_1_1AssetMeta_1_1Exclude.html new file mode 100644 index 000000000..edeee668c --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1AssetMeta_1_1Exclude.html @@ -0,0 +1,121 @@ + + + + + cubos::engine::AssetMeta::Exclude struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1BoxCollider.html b/pr-preview/pr-494/structcubos_1_1engine_1_1BoxCollider.html new file mode 100644 index 000000000..3c0dd735a --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1BoxCollider.html @@ -0,0 +1,140 @@ + + + + + cubos::engine::BoxCollider struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::BoxCollider struct +
#include <engine/collisions/colliders/box.hpp>
+

+

Component which adds a box collider to an entity.

+ +
  • Convex: For any 2 points inside the shape, the line segment connecting those points lies inside the shape.
  • Positive margin: Requires a positive margin to round off sharp corners. Defined in physics-space units.
+
+

Public variables

+
+
+ glm::mat4 transform +
+
Transform of the collider.
+
+ cubos::core::geom::Box shape +
+
Box shape of the collider.
+
+ float margin +
+
Margin of the collider. Needed for collision stability.
+
+
+
+

Variable documentation

+
+

+ float cubos::engine::BoxCollider::margin +

+

Margin of the collider. Needed for collision stability.

+

The collider margin avoids collision errors by rounding off sharp corners. It is absolute so the collider's transform won't affect it. Shouldn't be changed without good reason, as it's preferable to scale down the collider to account for it.

+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1BroadPhaseCollisions.html b/pr-preview/pr-494/structcubos_1_1engine_1_1BroadPhaseCollisions.html new file mode 100644 index 000000000..52fdd12c3 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1BroadPhaseCollisions.html @@ -0,0 +1,358 @@ + + + + + cubos::engine::BroadPhaseCollisions struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::BroadPhaseCollisions struct +
#include <engine/collisions/broad_phase_collisions.hpp>
+

+

Resource which stores data used in broad phase collision detection.

+ +
+

Public types

+
+
+ struct CandidateHash +
+
Hash function to allow Candidates to be used as keys in an unordered_set.
+
+ struct SweepMarker +
+
Marker used for sweep and prune.
+
+ enum class CollisionType { BoxBox = 0, + BoxCapsule, + BoxPlane, + BoxSimplex, + CapsuleCapsule, + CapsulePlane, + CapsuleSimplex, + PlanePlane, + PlaneSimplex, + SimplexSimplex, + Count } +
+
Collision type for each pair of colliders.
+
+ using Candidate = std::pair<Entity, Entity> +
+
Pair of entities that may collide.
+
+
+
+

Public functions

+
+
+ void addEntity(Entity entity) +
+
Adds an entity to the list of entities tracked by sweep and prune.
+
+ void removeEntity(Entity entity) +
+
Removes an entity from the list of entities tracked by sweep and prune.
+
+ void clearEntities() +
+
Clears the list of entities tracked by sweep and prune.
+
+ void addCandidate(CollisionType type, + Candidate candidate) +
+
Adds a collision candidate to the list of candidates for a specific collision type.
+
+ auto candidates(CollisionType type) const -> const std::unordered_set<Candidate, CandidateHash>& +
+
Gets the collision candidates for a specific collision type.
+
+ void clearCandidates() +
+
Clears the list of collision candidates.
+
+
+
+

Public variables

+
+
+ std::vector<SweepMarker> markersPerAxis +
+
List of ordered sweep markers for each axis. Stores the index of the marker in mMarkers.
+
+ std::unordered_map<Entity, std::vector<Entity>> sweepOverlapMaps +
+
Maps of overlapping entities for each axis calculated by sweep and prune.
+
+ std::unordered_set<Entity> activePerAxis +
+
Set of active entities during sweep for each axis.
+
+ std::unordered_set<Candidate, CandidateHash> candidatesPerType +
+
Sets of collision candidates for each collision type. The index of the array is the collision type.
+
+
+
+

Enum documentation

+
+

+ enum class cubos::engine::BroadPhaseCollisions::CollisionType +

+

Collision type for each pair of colliders.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Enumerators
BoxBox +
BoxCapsule +
BoxPlane +
BoxSimplex +
CapsuleCapsule +
CapsulePlane +
CapsuleSimplex +
PlanePlane +
PlaneSimplex +
SimplexSimplex +
Count +

Number of collision types.

+
+
+
+
+

Function documentation

+
+

+ void cubos::engine::BroadPhaseCollisions::addEntity(Entity entity) +

+

Adds an entity to the list of entities tracked by sweep and prune.

+ + + + + + + + + + +
Parameters
entityEntity to add.
+
+
+

+ void cubos::engine::BroadPhaseCollisions::removeEntity(Entity entity) +

+

Removes an entity from the list of entities tracked by sweep and prune.

+ + + + + + + + + + +
Parameters
entityEntity to remove.
+
+
+

+ void cubos::engine::BroadPhaseCollisions::addCandidate(CollisionType type, + Candidate candidate) +

+

Adds a collision candidate to the list of candidates for a specific collision type.

+ + + + + + + + + + + + + + +
Parameters
typeCollision type.
candidateCollision candidate.
+
+
+

+ const std::unordered_set<Candidate, CandidateHash>& cubos::engine::BroadPhaseCollisions::candidates(CollisionType type) const +

+

Gets the collision candidates for a specific collision type.

+ + + + + + + + + + + + + + + + +
Parameters
typeCollision type.
ReturnsCollision candidates.
+
+
+
+

Variable documentation

+
+

+ std::unordered_map<Entity, std::vector<Entity>> cubos::engine::BroadPhaseCollisions::sweepOverlapMaps +

+

Maps of overlapping entities for each axis calculated by sweep and prune.

+

For each each map, the key is an entity and the value is a list of entities that overlap with the key. Symmetrical pairs are not stored.

+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1CandidateHash.html b/pr-preview/pr-494/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1CandidateHash.html new file mode 100644 index 000000000..ef810df4f --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1CandidateHash.html @@ -0,0 +1,101 @@ + + + + + cubos::engine::BroadPhaseCollisions::CandidateHash struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1SweepMarker.html b/pr-preview/pr-494/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1SweepMarker.html new file mode 100644 index 000000000..b7665f32a --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1SweepMarker.html @@ -0,0 +1,125 @@ + + + + + cubos::engine::BroadPhaseCollisions::SweepMarker struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1Camera.html b/pr-preview/pr-494/structcubos_1_1engine_1_1Camera.html new file mode 100644 index 000000000..6b7a97465 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1Camera.html @@ -0,0 +1,130 @@ + + + + + cubos::engine::Camera struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1CapsuleCollider.html b/pr-preview/pr-494/structcubos_1_1engine_1_1CapsuleCollider.html new file mode 100644 index 000000000..72d528243 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1CapsuleCollider.html @@ -0,0 +1,126 @@ + + + + + cubos::engine::CapsuleCollider struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::CapsuleCollider struct +
#include <engine/collisions/colliders/capsule.hpp>
+

+

Component which adds a capsule collider to an entity.

+ +
  • Convex: For any 2 points inside the shape, the line segment connecting those points lies inside the shape.
  • Zero margin: No margin is needed, since the shape has no sharp corners.
+
+

Public variables

+
+
+ glm::mat4 transform +
+
Transform of the collider.
+
+ cubos::core::geom::Capsule shape +
+
Capsule shape of the collider.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1ColliderAABB.html b/pr-preview/pr-494/structcubos_1_1engine_1_1ColliderAABB.html new file mode 100644 index 000000000..5dcd2649e --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1ColliderAABB.html @@ -0,0 +1,278 @@ + + + + + cubos::engine::ColliderAABB struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::ColliderAABB struct +
#include <engine/collisions/aabb.hpp>
+

+

Component which stores the AABB of an entity with a collider component.

+ +
+

Public functions

+
+
+ auto box() const -> core::geom::Box +
+
Gets a core::geom::Box representation of the AABB.
+
+ auto center() const -> glm::vec3 +
+
Gets the center of the AABB.
+
+ auto overlapsX(const ColliderAABB& other) const -> bool +
+
Checks if the AABB overlaps with another AABB on the X axis.
+
+ auto overlapsY(const ColliderAABB& other) const -> bool +
+
Checks if the AABB overlaps with another AABB on the Y axis.
+
+ auto overlapsZ(const ColliderAABB& other) const -> bool +
+
Checks if the AABB overlaps with another AABB on the Z axis.
+
+ auto overlaps(const ColliderAABB& other) const -> bool +
+
Checks if the AABB overlaps with another AABB.
+
+
+
+

Public variables

+
+
+ glm::vec3 min +
+
Minimum point of the diagonal of the AABB.
+
+ glm::vec3 max +
+
Maximum point of the diagonal of the AABB.
+
+
+
+

Function documentation

+
+

+ core::geom::Box cubos::engine::ColliderAABB::box() const +

+

Gets a core::geom::Box representation of the AABB.

+ + + + + + + +
Returnscore::geom::Box representation.
+
+
+

+ glm::vec3 cubos::engine::ColliderAABB::center() const +

+

Gets the center of the AABB.

+ + + + + + + +
ReturnsCenter of the AABB.
+
+
+

+ bool cubos::engine::ColliderAABB::overlapsX(const ColliderAABB& other) const +

+

Checks if the AABB overlaps with another AABB on the X axis.

+ + + + + + + + + + + + + + + + +
Parameters
otherOther AABB.
ReturnsWhether the AABBs overlap.
+
+
+

+ bool cubos::engine::ColliderAABB::overlapsY(const ColliderAABB& other) const +

+

Checks if the AABB overlaps with another AABB on the Y axis.

+ + + + + + + + + + + + + + + + +
Parameters
otherOther AABB.
ReturnsWhether the AABBs overlap.
+
+
+

+ bool cubos::engine::ColliderAABB::overlapsZ(const ColliderAABB& other) const +

+

Checks if the AABB overlaps with another AABB on the Z axis.

+ + + + + + + + + + + + + + + + +
Parameters
otherOther AABB.
ReturnsWhether the AABBs overlap.
+
+
+

+ bool cubos::engine::ColliderAABB::overlaps(const ColliderAABB& other) const +

+

Checks if the AABB overlaps with another AABB.

+ + + + + + + + + + + + + + + + +
Parameters
otherOther AABB.
ReturnsWhether the AABBs overlap.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1DeltaTime.html b/pr-preview/pr-494/structcubos_1_1engine_1_1DeltaTime.html new file mode 100644 index 000000000..c7fbd31f3 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1DeltaTime.html @@ -0,0 +1,102 @@ + + + + + cubos::engine::DeltaTime struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::DeltaTime struct +
#include <engine/cubos.hpp>
+

+

Resource which stores the time since the last iteration of the main loop started.

+

This resource is added and updated by the Cubos class.

+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1DirectionalLight.html b/pr-preview/pr-494/structcubos_1_1engine_1_1DirectionalLight.html new file mode 100644 index 000000000..df45cadd4 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1DirectionalLight.html @@ -0,0 +1,102 @@ + + + + + cubos::engine::DirectionalLight struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1LocalToWorld.html b/pr-preview/pr-494/structcubos_1_1engine_1_1LocalToWorld.html new file mode 100644 index 000000000..5df2028a4 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1LocalToWorld.html @@ -0,0 +1,122 @@ + + + + + cubos::engine::LocalToWorld struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::LocalToWorld struct +
#include <engine/transform/local_to_world.hpp>
+

+

Component which stores the transformation matrix of an entity, from local to world space.

+ + +
+

Public variables

+
+
+ glm::mat4 mat +
+
Local to world space matrix.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1PlaneCollider.html b/pr-preview/pr-494/structcubos_1_1engine_1_1PlaneCollider.html new file mode 100644 index 000000000..d19aef7bb --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1PlaneCollider.html @@ -0,0 +1,140 @@ + + + + + cubos::engine::PlaneCollider struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::PlaneCollider struct +
#include <engine/collisions/colliders/plane.hpp>
+

+

Component which adds a plane collider to an entity.

+ +
  • Zero thickness: Not suitable for dynamic objects, but can be used for static objects.
  • Positive margin: Requires a positive margin. Defined in physics-space units.
+
+

Public variables

+
+
+ glm::vec3 offset +
+
Offset of the collider.
+
+ cubos::core::geom::Plane shape +
+
Plane shape of the collider.
+
+ float margin +
+
Margin of the collider. Needed for creating the AABB.
+
+
+
+

Variable documentation

+
+

+ float cubos::engine::PlaneCollider::margin +

+

Margin of the collider. Needed for creating the AABB.

+

The collider margin is absolute so the collider's transform won't affect it. Shouldn't be changed without good reason.

+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1PointLight.html b/pr-preview/pr-494/structcubos_1_1engine_1_1PointLight.html new file mode 100644 index 000000000..14b2c052d --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1PointLight.html @@ -0,0 +1,102 @@ + + + + + cubos::engine::PointLight struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1Position.html b/pr-preview/pr-494/structcubos_1_1engine_1_1Position.html new file mode 100644 index 000000000..941e9ad04 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1Position.html @@ -0,0 +1,122 @@ + + + + + cubos::engine::Position struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1RenderableGrid.html b/pr-preview/pr-494/structcubos_1_1engine_1_1RenderableGrid.html new file mode 100644 index 000000000..a23fdf8ba --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1RenderableGrid.html @@ -0,0 +1,130 @@ + + + + + cubos::engine::RenderableGrid struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::RenderableGrid struct +
#include <engine/renderer/plugin.hpp>
+

+

Component which makes a voxel grid be rendered by the renderer plugin.

+ + +
+

Public variables

+
+
+ Asset<core::gl::Grid> asset +
+
Handle to the grid asset to be rendered.
+
+ glm::vec3 offset +
+
Translation applied to the voxel grid before any other.
+
+ RendererGrid handle +
+
Handle to the uploaded grid - set automatically.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1RendererEnvironment.html b/pr-preview/pr-494/structcubos_1_1engine_1_1RendererEnvironment.html new file mode 100644 index 000000000..dfc76f5bf --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1RendererEnvironment.html @@ -0,0 +1,125 @@ + + + + + cubos::engine::RendererEnvironment struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1RendererFrame_1_1DrawCmd.html b/pr-preview/pr-494/structcubos_1_1engine_1_1RendererFrame_1_1DrawCmd.html new file mode 100644 index 000000000..850369e72 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1RendererFrame_1_1DrawCmd.html @@ -0,0 +1,125 @@ + + + + + cubos::engine::RendererFrame::DrawCmd struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1Rotation.html b/pr-preview/pr-494/structcubos_1_1engine_1_1Rotation.html new file mode 100644 index 000000000..e5ae28046 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1Rotation.html @@ -0,0 +1,122 @@ + + + + + cubos::engine::Rotation struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1Scale.html b/pr-preview/pr-494/structcubos_1_1engine_1_1Scale.html new file mode 100644 index 000000000..188b3b2ea --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1Scale.html @@ -0,0 +1,122 @@ + + + + + cubos::engine::Scale struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1Scene.html b/pr-preview/pr-494/structcubos_1_1engine_1_1Scene.html new file mode 100644 index 000000000..d751827b2 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1Scene.html @@ -0,0 +1,126 @@ + + + + + cubos::engine::Scene struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::Scene struct +
#include <engine/scene/scene.hpp>
+

+

Asset equivalent to ECS blueprints - a bundle of entities and their components.

+ +

Scene assets produce a blueprint when loaded which can be used to spawn them. Entity names in the resulting blueprint follow the format "foo", "import1.bar", "import1.import2.baz", etc.

+
+

Public variables

+
+
+ core::ecs::Blueprint blueprint +
+
Resulting blueprint which contains all the entities of the scene and its imported scenes. If you want to spawn the scene, use this blueprint.
+
+ std::unordered_map<std::string, Asset<Scene>> imports +
+
Handles to other scenes that are imported by this scene, mapped by their import names. Imports of imports ar not included in this map.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1ShouldQuit.html b/pr-preview/pr-494/structcubos_1_1engine_1_1ShouldQuit.html new file mode 100644 index 000000000..a1c2b34be --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1ShouldQuit.html @@ -0,0 +1,102 @@ + + + + + cubos::engine::ShouldQuit struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::ShouldQuit struct +
#include <engine/cubos.hpp>
+

+

Resource used as a flag to indicate whether the main loop should stop running.

+

This resource is added by the Cubos class, initially set to true.

+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1SimplexCollider.html b/pr-preview/pr-494/structcubos_1_1engine_1_1SimplexCollider.html new file mode 100644 index 000000000..69fca3aa0 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1SimplexCollider.html @@ -0,0 +1,140 @@ + + + + + cubos::engine::SimplexCollider struct | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::SimplexCollider struct +
#include <engine/collisions/colliders/simplex.hpp>
+

+

Component which adds a simplex collider to an entity.

+ +
  • Convex: For any 2 points inside the shape, the line segment connecting those points lies inside the shape.
  • Positive margin: Requires a positive margin to round off sharp corners. Defined in physics-space units.
  • Zero thickness (up to 3 points): Not suitable for dynamic objects, but can be used for static objects.
+
+

Public variables

+
+
+ glm::vec3 offset +
+
Offset of the collider.
+
+ cubos::core::geom::Simplex shape +
+
Simplex shape of the collider.
+
+ float margin +
+
Margin of the collider. Needed for collision stability.
+
+
+
+

Variable documentation

+
+

+ float cubos::engine::SimplexCollider::margin +

+

Margin of the collider. Needed for collision stability.

+

The collider margin avoids collision errors by rounding off sharp corners. Shouldn't be changed without good reason, it's preferable to move the simplex corners to account for it.

+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1SpotLight.html b/pr-preview/pr-494/structcubos_1_1engine_1_1SpotLight.html new file mode 100644 index 000000000..827123c0e --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1SpotLight.html @@ -0,0 +1,102 @@ + + + + + cubos::engine::SpotLight struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1tools_1_1AssetSelectedEvent.html b/pr-preview/pr-494/structcubos_1_1engine_1_1tools_1_1AssetSelectedEvent.html new file mode 100644 index 000000000..7d8cee594 --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1tools_1_1AssetSelectedEvent.html @@ -0,0 +1,121 @@ + + + + + cubos::engine::tools::AssetSelectedEvent struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/structcubos_1_1engine_1_1tools_1_1EntitySelector.html b/pr-preview/pr-494/structcubos_1_1engine_1_1tools_1_1EntitySelector.html new file mode 100644 index 000000000..5d4fee6ba --- /dev/null +++ b/pr-preview/pr-494/structcubos_1_1engine_1_1tools_1_1EntitySelector.html @@ -0,0 +1,121 @@ + + + + + cubos::engine::tools::EntitySelector struct | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/system_8hpp.html b/pr-preview/pr-494/system_8hpp.html new file mode 100644 index 000000000..f2ddbae6f --- /dev/null +++ b/pr-preview/pr-494/system_8hpp.html @@ -0,0 +1,155 @@ + + + + + core/ecs/system.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/system.hpp file +

+

Class cubos::core::ecs::SystemWrapper and related types.

+ +

This file is a bit scary, but it's not as bad as it looks. It's mostly template specializations to handle the different types of arguments a system can take.

+
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
namespace cubos::core::ecs::impl
+
Contains functions used internally by the implementation of the ECS.
+
+
+
+

Classes

+
+
+ struct cubos::core::ecs::SystemInfo +
+
Describes a system.
+
+
template<typename R>
+ class cubos::core::ecs::AnySystemWrapper +
+
Base class for system wrappers.
+
+
template<typename T>
+ struct cubos::core::ecs::impl::SystemFetcher +
+
Fetches the requested data from a world.
+
+
template<typename F>
+ struct cubos::core::ecs::impl::SystemTraits +
+
Template magic used to inspect the arguments of a system.
+
+
template<typename F>
+ class cubos::core::ecs::SystemWrapper +
+
Wrapper for a system of type F.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/thread__pool_8hpp.html b/pr-preview/pr-494/thread__pool_8hpp.html new file mode 100644 index 000000000..a5d2d0f8d --- /dev/null +++ b/pr-preview/pr-494/thread__pool_8hpp.html @@ -0,0 +1,130 @@ + + + + + core/thread_pool.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/tools_2asset__explorer_2plugin_8hpp.html b/pr-preview/pr-494/tools_2asset__explorer_2plugin_8hpp.html new file mode 100644 index 000000000..cacf7f372 --- /dev/null +++ b/pr-preview/pr-494/tools_2asset__explorer_2plugin_8hpp.html @@ -0,0 +1,142 @@ + + + + + engine/tools/asset_explorer/plugin.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/tools/asset_explorer/plugin.hpp file +

+

Plugin entry point.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
namespace cubos::engine::tools
+
Namespace for tool plugins.
+
+
+
+

Classes

+
+
+ struct cubos::engine::tools::AssetSelectedEvent +
+
Event sent when an asset is selected.
+
+
+
+

Functions

+
+
+ void assetExplorerPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/tools_2entity__inspector_2plugin_8hpp.html b/pr-preview/pr-494/tools_2entity__inspector_2plugin_8hpp.html new file mode 100644 index 000000000..0d74523cb --- /dev/null +++ b/pr-preview/pr-494/tools_2entity__inspector_2plugin_8hpp.html @@ -0,0 +1,132 @@ + + + + + engine/tools/entity_inspector/plugin.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/tools_2entity__selector_2plugin_8hpp.html b/pr-preview/pr-494/tools_2entity__selector_2plugin_8hpp.html new file mode 100644 index 000000000..fc3ad016f --- /dev/null +++ b/pr-preview/pr-494/tools_2entity__selector_2plugin_8hpp.html @@ -0,0 +1,142 @@ + + + + + engine/tools/entity_selector/plugin.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/tools/entity_selector/plugin.hpp file +

+

Plugin entry point.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::engine
+
Engine module.
+
namespace cubos::engine::tools
+
Namespace for tool plugins.
+
+
+
+

Classes

+
+
+ struct cubos::engine::tools::EntitySelector +
+
Resource which identifies the currently selected entity.
+
+
+
+

Functions

+
+
+ void entitySelectorPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/tools_2settings__inspector_2plugin_8hpp.html b/pr-preview/pr-494/tools_2settings__inspector_2plugin_8hpp.html new file mode 100644 index 000000000..4fd8e7e5d --- /dev/null +++ b/pr-preview/pr-494/tools_2settings__inspector_2plugin_8hpp.html @@ -0,0 +1,132 @@ + + + + + engine/tools/settings_inspector/plugin.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/tools_2world__inspector_2plugin_8hpp.html b/pr-preview/pr-494/tools_2world__inspector_2plugin_8hpp.html new file mode 100644 index 000000000..49deea16e --- /dev/null +++ b/pr-preview/pr-494/tools_2world__inspector_2plugin_8hpp.html @@ -0,0 +1,132 @@ + + + + + engine/tools/world_inspector/plugin.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/transform_2plugin_8hpp.html b/pr-preview/pr-494/transform_2plugin_8hpp.html new file mode 100644 index 000000000..afaf7ea18 --- /dev/null +++ b/pr-preview/pr-494/transform_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/transform/plugin.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/type__map_8hpp.html b/pr-preview/pr-494/type__map_8hpp.html new file mode 100644 index 000000000..e2cf68e4f --- /dev/null +++ b/pr-preview/pr-494/type__map_8hpp.html @@ -0,0 +1,133 @@ + + + + + core/memory/type_map.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/util_8hpp.html b/pr-preview/pr-494/util_8hpp.html new file mode 100644 index 000000000..f3c1afa79 --- /dev/null +++ b/pr-preview/pr-494/util_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/gl/util.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/gl/util.hpp file +

+

Function cubos::core::gl::generateScreenQuad.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::gl
+
Graphics module.
+
+
+
+

Functions

+
+
+ void generateScreenQuad(RenderDevice& renderDevice, + const ShaderPipeline& pipeline, + VertexArray& va) +
+
Creates the resources required to draw a quad that fills the screen and returns its VertexArray.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/vec__storage_8hpp.html b/pr-preview/pr-494/vec__storage_8hpp.html new file mode 100644 index 000000000..a35d1795a --- /dev/null +++ b/pr-preview/pr-494/vec__storage_8hpp.html @@ -0,0 +1,133 @@ + + + + + core/ecs/vec_storage.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/vertex_8hpp.html b/pr-preview/pr-494/vertex_8hpp.html new file mode 100644 index 000000000..591c75136 --- /dev/null +++ b/pr-preview/pr-494/vertex_8hpp.html @@ -0,0 +1,146 @@ + + + + + core/gl/vertex.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/gl/vertex.hpp file +

+

Class cubos::core::gl::Vertex and function cubos::core::gl::triangulate.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::gl
+
Graphics module.
+
namespace cubos::core::data
+
Data module.
+
+
+
+

Classes

+
+
+ struct cubos::core::gl::Vertex +
+
Represents a voxel vertex.
+
+
+
+

Functions

+
+
+ void triangulate(const Grid& grid, + std::vector<Vertex>& vertices, + std::vector<uint32_t>& indices) +
+
Triangulates a grid of voxels into an indexed mesh.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/voxels_2plugin_8hpp.html b/pr-preview/pr-494/voxels_2plugin_8hpp.html new file mode 100644 index 000000000..5a6728dc9 --- /dev/null +++ b/pr-preview/pr-494/voxels_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/voxels/plugin.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/window_2plugin_8hpp.html b/pr-preview/pr-494/window_2plugin_8hpp.html new file mode 100644 index 000000000..c1b14e39a --- /dev/null +++ b/pr-preview/pr-494/window_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/window/plugin.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-494/window_8hpp.html b/pr-preview/pr-494/window_8hpp.html new file mode 100644 index 000000000..4c2712171 --- /dev/null +++ b/pr-preview/pr-494/window_8hpp.html @@ -0,0 +1,214 @@ + + + + + core/io/window.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/io/window.hpp file +

+

Class cubos::core::io::Window and related types.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::gl
+
Graphics module.
+
namespace cubos::core::io
+
Input and output module.
+
+
+
+

Classes

+
+
+ struct cubos::core::io::KeyEvent +
+
Event sent when a key is pressed or released.
+
+ struct cubos::core::io::ModifiersEvent +
+
Event sent when the modifiers change.
+
+ struct cubos::core::io::MouseButtonEvent +
+
Event sent when a mouse button state changes.
+
+ struct cubos::core::io::MouseMoveEvent +
+
Event sent when the mouse cursor moves.
+
+ struct cubos::core::io::MouseScrollEvent +
+
Event sent when the mouse wheel is scrolled.
+
+ struct cubos::core::io::ResizeEvent +
+
Event sent when the window framebuffer is resized.
+
+ struct cubos::core::io::TextEvent +
+
Event sent when a unicode character is input.
+
+ class cubos::core::io::BaseWindow +
+
Interface used to wrap low-level window API implementations.
+
+
+
+

Enums

+
+
+ enum class MouseButton { Invalid = -1, + Left, + Right, + Middle, + Extra1, + Extra2 } +
+
Mouse buttons enum.
+
+ enum class MouseAxis { X, + Y, + Scroll } +
+
Mouse axes enums.
+
+ enum class MouseState { Default, + Locked, + Hidden } +
+
Possible mouse states.
+
+
+
+

Typedefs

+
+
+ using WindowEvent = std::variant<KeyEvent, ModifiersEvent, MouseButtonEvent, MouseMoveEvent, MouseScrollEvent, ResizeEvent, TextEvent> +
+
Variant that can hold any of the window events.
+
+ using Window = std::shared_ptr<BaseWindow> +
+
Handle to a window.
+
+
+
+

Functions

+
+
+ auto openWindow(const std::string& title = "CUBOS.", + const glm::ivec2& size = {800, 600}) -> Window +
+
Opens a new window.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-494/world_8hpp.html b/pr-preview/pr-494/world_8hpp.html new file mode 100644 index 000000000..b6d66e1e6 --- /dev/null +++ b/pr-preview/pr-494/world_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/ecs/world.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/ecs/world.hpp file +

+

Class cubos::core::ecs::World.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::ecs
+
ECS module.
+
namespace cubos::core::ecs::impl
+
Contains functions used internally by the implementation of the ECS.
+
+
+
+

Classes

+
+
+ class cubos::core::ecs::World +
+
Holds entities, their components and resources.
+
+
+
+
+
+
+ + + + + +