From 2b61645425aa5f5b0f3539e33532475588c64500 Mon Sep 17 00:00:00 2001 From: luishfonseca Date: Mon, 25 Sep 2023 18:31:09 +0000 Subject: [PATCH] =?UTF-8?q?Deploy=20preview=20for=20PR=20589=20?= =?UTF-8?q?=F0=9F=9B=AB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- pr-preview/pr-589/CubosLogo.png | Bin 0 -> 18999 bytes pr-preview/pr-589/aabb_8hpp.html | 134 + pr-preview/pr-589/accessors_8hpp.html | 148 + pr-preview/pr-589/action_8hpp.html | 130 + pr-preview/pr-589/annotated.html | 520 +++ pr-preview/pr-589/archive_8hpp.html | 132 + pr-preview/pr-589/asset_8hpp.html | 139 + pr-preview/pr-589/assets_2bridge_8hpp.html | 130 + pr-preview/pr-589/assets_2plugin_8hpp.html | 130 + pr-preview/pr-589/assets_8hpp.html | 154 + pr-preview/pr-589/audio__device_8hpp.html | 169 + pr-preview/pr-589/axis_8hpp.html | 130 + pr-preview/pr-589/binary_8hpp.html | 131 + pr-preview/pr-589/bindings_8hpp.html | 130 + pr-preview/pr-589/bloom_8hpp.html | 130 + pr-preview/pr-589/blueprint_8hpp.html | 132 + .../pr-589/broad__phase__collisions_8hpp.html | 138 + pr-preview/pr-589/buffer__stream_8hpp.html | 132 + pr-preview/pr-589/camera_8hpp.html | 132 + pr-preview/pr-589/classTextBridge.html | 159 + .../classcubos_1_1core_1_1ThreadPool.html | 181 + ...asscubos_1_1core_1_1al_1_1AudioDevice.html | 290 ++ ...cubos_1_1core_1_1al_1_1impl_1_1Buffer.html | 159 + ...cubos_1_1core_1_1al_1_1impl_1_1Source.html | 377 +++ ...classcubos_1_1core_1_1data_1_1Archive.html | 396 +++ ...1_1core_1_1data_1_1BinaryDeserializer.html | 489 +++ ...s_1_1core_1_1data_1_1BinarySerializer.html | 572 ++++ ...classcubos_1_1core_1_1data_1_1Context.html | 246 ++ ...os_1_1core_1_1data_1_1DebugSerializer.html | 578 ++++ ...cubos_1_1core_1_1data_1_1Deserializer.html | 555 ++++ ...os_1_1core_1_1data_1_1EmbeddedArchive.html | 464 +++ .../classcubos_1_1core_1_1data_1_1File.html | 494 +++ ...sscubos_1_1core_1_1data_1_1FileStream.html | 350 ++ ...sscubos_1_1core_1_1data_1_1FileSystem.html | 325 ++ ...s_1_1core_1_1data_1_1JSONDeserializer.html | 483 +++ ...bos_1_1core_1_1data_1_1JSONSerializer.html | 572 ++++ ...classcubos_1_1core_1_1data_1_1Package.html | 847 +++++ ...s_1_1core_1_1data_1_1SerializationMap.html | 367 +++ ...sscubos_1_1core_1_1data_1_1Serializer.html | 654 ++++ ...os_1_1core_1_1data_1_1StandardArchive.html | 432 +++ ...sscubos_1_1core_1_1data_1_1Unpackager.html | 483 +++ ...s_1_1core_1_1data_1_1impl_1_1Packager.html | 540 +++ ...os_1_1core_1_1ecs_1_1AnySystemWrapper.html | 245 ++ ...lasscubos_1_1core_1_1ecs_1_1Blueprint.html | 330 ++ ...os_1_1core_1_1ecs_1_1BlueprintBuilder.html | 236 ++ ...cubos_1_1core_1_1ecs_1_1CommandBuffer.html | 317 ++ ...classcubos_1_1core_1_1ecs_1_1Commands.html | 314 ++ ...os_1_1core_1_1ecs_1_1ComponentManager.html | 522 +++ ...asscubos_1_1core_1_1ecs_1_1Dispatcher.html | 407 +++ .../classcubos_1_1core_1_1ecs_1_1Entity.html | 196 ++ ...cubos_1_1core_1_1ecs_1_1EntityBuilder.html | 209 ++ ...cubos_1_1core_1_1ecs_1_1EntityManager.html | 378 +++ ...e_1_1ecs_1_1EntityManager_1_1Iterator.html | 101 + ...lasscubos_1_1core_1_1ecs_1_1EventPipe.html | 297 ++ ...sscubos_1_1core_1_1ecs_1_1EventReader.html | 247 ++ ...ore_1_1ecs_1_1EventReader_1_1Iterator.html | 101 + ...sscubos_1_1core_1_1ecs_1_1EventWriter.html | 193 ++ ...classcubos_1_1core_1_1ecs_1_1IStorage.html | 243 ++ ...asscubos_1_1core_1_1ecs_1_1MapStorage.html | 257 ++ ...sscubos_1_1core_1_1ecs_1_1NullStorage.html | 257 ++ .../classcubos_1_1core_1_1ecs_1_1OptRead.html | 225 ++ ...classcubos_1_1core_1_1ecs_1_1OptWrite.html | 226 ++ .../classcubos_1_1core_1_1ecs_1_1Query.html | 272 ++ ...s_1_1core_1_1ecs_1_1Query_1_1Iterator.html | 138 + .../classcubos_1_1core_1_1ecs_1_1Read.html | 205 ++ ...scubos_1_1core_1_1ecs_1_1ReadResource.html | 183 ++ ...sscubos_1_1core_1_1ecs_1_1ReadStorage.html | 183 ++ ...classcubos_1_1core_1_1ecs_1_1Registry.html | 295 ++ ...bos_1_1core_1_1ecs_1_1ResourceManager.html | 222 ++ .../classcubos_1_1core_1_1ecs_1_1Storage.html | 362 ++ ...cubos_1_1core_1_1ecs_1_1SystemWrapper.html | 235 ++ ...asscubos_1_1core_1_1ecs_1_1VecStorage.html | 257 ++ .../classcubos_1_1core_1_1ecs_1_1World.html | 592 ++++ .../classcubos_1_1core_1_1ecs_1_1Write.html | 205 ++ ...cubos_1_1core_1_1ecs_1_1WriteResource.html | 183 ++ ...scubos_1_1core_1_1ecs_1_1WriteStorage.html | 183 ++ .../classcubos_1_1core_1_1gl_1_1Debug.html | 373 +++ .../classcubos_1_1core_1_1gl_1_1Grid.html | 365 ++ .../classcubos_1_1core_1_1gl_1_1Palette.html | 332 ++ ...sscubos_1_1core_1_1gl_1_1RenderDevice.html | 1259 +++++++ ...s_1_1core_1_1gl_1_1impl_1_1BlendState.html | 101 + ...1core_1_1gl_1_1impl_1_1ConstantBuffer.html | 142 + ...ubos_1_1core_1_1gl_1_1impl_1_1CubeMap.html | 181 + ...1_1core_1_1gl_1_1impl_1_1CubeMapArray.html | 187 ++ ...re_1_1gl_1_1impl_1_1DepthStencilState.html | 101 + ..._1_1core_1_1gl_1_1impl_1_1Framebuffer.html | 101 + ..._1_1core_1_1gl_1_1impl_1_1IndexBuffer.html | 142 + ..._1_1core_1_1gl_1_1impl_1_1RasterState.html | 101 + ...ubos_1_1core_1_1gl_1_1impl_1_1Sampler.html | 101 + ...e_1_1gl_1_1impl_1_1ShaderBindingPoint.html | 622 ++++ ...1core_1_1gl_1_1impl_1_1ShaderPipeline.html | 138 + ..._1_1core_1_1gl_1_1impl_1_1ShaderStage.html | 138 + ...os_1_1core_1_1gl_1_1impl_1_1Texture1D.html | 163 + ...os_1_1core_1_1gl_1_1impl_1_1Texture2D.html | 175 + ...1core_1_1gl_1_1impl_1_1Texture2DArray.html | 181 + ...os_1_1core_1_1gl_1_1impl_1_1Texture3D.html | 187 ++ ..._1_1core_1_1gl_1_1impl_1_1VertexArray.html | 101 + ...1_1core_1_1gl_1_1impl_1_1VertexBuffer.html | 142 + ...lasscubos_1_1core_1_1io_1_1BaseWindow.html | 475 +++ .../classcubos_1_1core_1_1io_1_1Cursor.html | 204 ++ ...bos_1_1core_1_1memory_1_1BufferStream.html | 424 +++ ...scubos_1_1core_1_1memory_1_1ReadGuard.html | 261 ++ ...s_1_1core_1_1memory_1_1StandardStream.html | 331 ++ ...lasscubos_1_1core_1_1memory_1_1Stream.html | 1010 ++++++ ...asscubos_1_1core_1_1memory_1_1TypeMap.html | 452 +++ ...cubos_1_1core_1_1memory_1_1WriteGuard.html | 324 ++ ...e_1_1reflection_1_1ConstructibleTrait.html | 458 +++ ...tion_1_1ConstructibleTrait_1_1Builder.html | 215 ++ ...sscubos_1_1core_1_1reflection_1_1Type.html | 328 ++ .../classcubos_1_1engine_1_1AnyAsset.html | 380 +++ .../pr-589/classcubos_1_1engine_1_1Asset.html | 330 ++ .../classcubos_1_1engine_1_1AssetBridge.html | 248 ++ .../classcubos_1_1engine_1_1AssetMeta.html | 242 ++ .../classcubos_1_1engine_1_1Assets.html | 674 ++++ .../classcubos_1_1engine_1_1BaseRenderer.html | 385 +++ .../classcubos_1_1engine_1_1BinaryBridge.html | 257 ++ .../pr-589/classcubos_1_1engine_1_1Cubos.html | 435 +++ ...sscubos_1_1engine_1_1DeferredRenderer.html | 280 ++ .../classcubos_1_1engine_1_1FileBridge.html | 330 ++ .../pr-589/classcubos_1_1engine_1_1Input.html | 436 +++ .../classcubos_1_1engine_1_1InputAction.html | 269 ++ .../classcubos_1_1engine_1_1InputAxis.html | 311 ++ ...classcubos_1_1engine_1_1InputBindings.html | 193 ++ .../classcubos_1_1engine_1_1JSONBridge.html | 258 ++ ...ubos_1_1engine_1_1PostProcessingBloom.html | 391 +++ ...cubos_1_1engine_1_1PostProcessingCopy.html | 219 ++ ...os_1_1engine_1_1PostProcessingManager.html | 294 ++ ...cubos_1_1engine_1_1PostProcessingPass.html | 231 ++ ...classcubos_1_1engine_1_1RendererFrame.html | 408 +++ .../classcubos_1_1engine_1_1SceneBridge.html | 225 ++ .../classcubos_1_1engine_1_1Settings.html | 434 +++ ...classcubos_1_1engine_1_1SystemBuilder.html | 274 ++ .../classcubos_1_1engine_1_1TagBuilder.html | 244 ++ ...bos_1_1engine_1_1impl_1_1RendererGrid.html | 101 + .../pr-589/collisions_2plugin_8hpp.html | 130 + pr-preview/pr-589/commands_8hpp.html | 144 + .../pr-589/component__manager_8hpp.html | 157 + pr-preview/pr-589/constructible_8hpp.html | 137 + .../pr-589/constructible__utils_8hpp.html | 134 + pr-preview/pr-589/contribution.html | 112 + pr-preview/pr-589/copy__pass_8hpp.html | 130 + ...ude_2cubos_2core_2data_2fs_2file_8hpp.html | 132 + ...2include_2cubos_2core_2geom_2box_8hpp.html | 134 + ...lude_2cubos_2core_2geom_2capsule_8hpp.html | 134 + ...nclude_2cubos_2core_2geom_2plane_8hpp.html | 134 + ...lude_2cubos_2core_2geom_2simplex_8hpp.html | 134 + ...ata_2fs_2embedded__archive_2main_8cpp.html | 101 + pr-preview/pr-589/cubos_8hpp.html | 150 + pr-preview/pr-589/cursor_8hpp.html | 132 + pr-preview/pr-589/debug_8hpp.html | 132 + .../pr-589/deferred__renderer_8hpp.html | 130 + .../dir_0835e003fa277f66ce5cf543d578f6a2.html | 134 + .../dir_2a3f20446d92cb0b384d0cf4f4d26d60.html | 118 + .../dir_3733897ca737f1fa8773f329655abd67.html | 118 + .../dir_38e9fb064544086d3594e70a41f6b257.html | 122 + .../dir_3a267dbab794906b09058daa283b3fee.html | 124 + .../dir_459dda10180a6131eb62bc74e02d0b6e.html | 118 + .../dir_5f701044e65d6c264a6c1dc66b1052c2.html | 126 + .../dir_672562f1eb3ea0be7f3aa3e89e72ecd2.html | 124 + .../dir_6c897dd97bedf3914ee8a4d9f7f6549c.html | 144 + .../dir_7376bacbd9e6243f425bd4c56d48edd9.html | 124 + .../dir_73cd920be1d9b25db5feb4d2a202c641.html | 118 + .../dir_764b6913e5a035b506325f3918f13ed7.html | 118 + .../dir_79f402fdd7bbb1d73f9fd1aa85f618da.html | 128 + .../dir_85f1b5bc6fb8e602e74068211760bfae.html | 120 + .../dir_8711f680e2d25dedddc79c2be2b1fda2.html | 120 + .../dir_87a7847ee77970235330560d79c37ce0.html | 140 + .../dir_8b12085945cef5a7cea7b856ed1ac7f6.html | 118 + .../dir_8e5f84d20b1aa89c94160461e78e26c4.html | 126 + .../dir_95549d37735ad5b142799f042eef0d37.html | 118 + .../dir_9b04cf786b414c0d644db09287f665e6.html | 118 + .../dir_9bdaf8f561be1ffd03f616379797b70b.html | 130 + .../dir_b6daa990b896c2c0c53126427e4d978d.html | 152 + .../dir_bafb7af0e03e95b24a45ff63060ab57b.html | 146 + .../dir_bd9be39c2ccf4132268583193b02b48c.html | 122 + .../dir_c185369e92e3603c6d00fa8343148da7.html | 128 + .../dir_c1deef5baf41393ad8a994c3fd53e62f.html | 124 + .../dir_c396301357880712663814927d68a432.html | 118 + .../dir_c4311188e9cc606330f5e3e0b9dd5059.html | 132 + .../dir_d0ac2003a3c19c21d7ab7ff2f06fbec3.html | 118 + .../dir_db86702e1371d7558db3699dd3786a14.html | 130 + .../dir_e42c9d7813efab99826f1cb60398c3fa.html | 118 + .../dir_f4414684a5bb1e1b8e9ba236e8bdb594.html | 130 + .../dir_f556bbe30cd07922836d0e9d7f5fa0a5.html | 122 + .../dir_f6f65ff657bd34b22e5078310628f4e7.html | 118 + .../pr-589/directional__light_8hpp.html | 130 + pr-preview/pr-589/dispatcher_8hpp.html | 132 + pr-preview/pr-589/ecs_8hpp.html | 139 + pr-preview/pr-589/embedded__archive_8hpp.html | 140 + pr-preview/pr-589/endianness_8hpp.html | 157 + ...s_2engine_2assets_2bridges_2file_8hpp.html | 130 + ...gine_2collisions_2colliders_2box_8hpp.html | 130 + ..._2collisions_2colliders_2capsule_8hpp.html | 130 + ...ne_2collisions_2colliders_2plane_8hpp.html | 130 + ..._2collisions_2colliders_2simplex_8hpp.html | 130 + pr-preview/pr-589/entity__manager_8hpp.html | 140 + pr-preview/pr-589/environment_8hpp.html | 130 + pr-preview/pr-589/event__pipe_8hpp.html | 133 + pr-preview/pr-589/event__reader_8hpp.html | 137 + pr-preview/pr-589/event__writer_8hpp.html | 133 + pr-preview/pr-589/examples-core-logging.html | 116 + .../examples-core-reflection-basic.html | 136 + ...-core-reflection-traits-constructible.html | 131 + .../pr-589/examples-core-reflection.html | 103 + pr-preview/pr-589/examples-core.html | 102 + .../pr-589/examples-engine-assets-bridge.html | 146 + .../pr-589/examples-engine-assets-json.html | 135 + .../pr-589/examples-engine-assets-saving.html | 115 + pr-preview/pr-589/examples-engine-assets.html | 103 + .../pr-589/examples-engine-renderer.html | 150 + pr-preview/pr-589/examples-engine-scene.html | 134 + .../pr-589/examples-engine-settings.html | 112 + pr-preview/pr-589/examples-engine.html | 102 + pr-preview/pr-589/examples.html | 101 + pr-preview/pr-589/favicon-dark.png | Bin 0 -> 380 bytes pr-preview/pr-589/features-ecs.html | 172 + pr-preview/pr-589/features-plugins.html | 142 + pr-preview/pr-589/features-quadrados.html | 121 + pr-preview/pr-589/features.html | 100 + pr-preview/pr-589/file__stream_8hpp.html | 133 + pr-preview/pr-589/file__system_8hpp.html | 132 + pr-preview/pr-589/files.html | 395 +++ pr-preview/pr-589/frame_8hpp.html | 134 + pr-preview/pr-589/gamepad_8hpp.html | 191 ++ pr-preview/pr-589/getting-started.html | 101 + pr-preview/pr-589/grid_8hpp.html | 134 + .../group__asset-explorer-tool-plugin.html | 153 + pr-preview/pr-589/group__assets-plugin.html | 294 ++ .../pr-589/group__collisions-plugin.html | 197 ++ pr-preview/pr-589/group__core-al.html | 151 + pr-preview/pr-589/group__core-data-fs.html | 160 + pr-preview/pr-589/group__core-data.html | 118 + pr-preview/pr-589/group__core-ecs.html | 404 +++ pr-preview/pr-589/group__core-geom.html | 146 + pr-preview/pr-589/group__core-gl.html | 1320 ++++++++ pr-preview/pr-589/group__core-io.html | 753 +++++ pr-preview/pr-589/group__core-memory.html | 460 +++ pr-preview/pr-589/group__core-reflection.html | 419 +++ pr-preview/pr-589/group__core-ui.html | 444 +++ pr-preview/pr-589/group__core.html | 528 +++ pr-preview/pr-589/group__engine.html | 182 + .../group__entity-inspector-tool-plugin.html | 152 + .../group__entity-selector-tool-plugin.html | 152 + pr-preview/pr-589/group__imgui-plugin.html | 153 + pr-preview/pr-589/group__input-plugin.html | 185 ++ pr-preview/pr-589/group__renderer-plugin.html | 316 ++ .../group__scene-editor-tool-plugin.html | 152 + pr-preview/pr-589/group__scene-plugin.html | 170 + ...group__settings-inspector-tool-plugin.html | 152 + pr-preview/pr-589/group__settings-plugin.html | 153 + pr-preview/pr-589/group__tool-plugins.html | 128 + .../pr-589/group__transform-plugin.html | 182 + pr-preview/pr-589/group__voxels-plugin.html | 152 + pr-preview/pr-589/group__window-plugin.html | 156 + .../group__world-inspector-tool-plugin.html | 152 + pr-preview/pr-589/guards_8hpp.html | 138 + pr-preview/pr-589/imgui_2plugin_8hpp.html | 130 + pr-preview/pr-589/imgui_8hpp.html | 148 + pr-preview/pr-589/index.html | 100 + pr-preview/pr-589/input_2plugin_8hpp.html | 130 + pr-preview/pr-589/input_8hpp.html | 130 + pr-preview/pr-589/json_8hpp.html | 131 + pr-preview/pr-589/keyboard_8hpp.html | 261 ++ pr-preview/pr-589/local__to__world_8hpp.html | 130 + pr-preview/pr-589/log_8hpp.html | 214 ++ .../pr-589/m-dark+documentation.compiled.css | 2925 +++++++++++++++++ pr-preview/pr-589/manager_8hpp.html | 142 + pr-preview/pr-589/map__storage_8hpp.html | 133 + pr-preview/pr-589/material_8hpp.html | 134 + pr-preview/pr-589/meta_8hpp.html | 134 + pr-preview/pr-589/modules.html | 160 + pr-preview/pr-589/move_8hpp.html | 144 + pr-preview/pr-589/namespacecubos.html | 120 + pr-preview/pr-589/namespacecubos_1_1core.html | 158 + .../pr-589/namespacecubos_1_1core_1_1al.html | 165 + .../namespacecubos_1_1core_1_1al_1_1impl.html | 124 + .../namespacecubos_1_1core_1_1data.html | 792 +++++ ...amespacecubos_1_1core_1_1data_1_1impl.html | 120 + .../pr-589/namespacecubos_1_1core_1_1ecs.html | 289 ++ ...namespacecubos_1_1core_1_1ecs_1_1impl.html | 137 + .../namespacecubos_1_1core_1_1geom.html | 132 + .../pr-589/namespacecubos_1_1core_1_1gl.html | 520 +++ .../namespacecubos_1_1core_1_1gl_1_1impl.html | 188 ++ .../pr-589/namespacecubos_1_1core_1_1io.html | 386 +++ .../namespacecubos_1_1core_1_1memory.html | 200 ++ .../namespacecubos_1_1core_1_1reflection.html | 145 + .../pr-589/namespacecubos_1_1core_1_1ui.html | 169 + .../pr-589/namespacecubos_1_1engine.html | 399 +++ .../namespacecubos_1_1engine_1_1impl.html | 120 + .../namespacecubos_1_1engine_1_1tools.html | 154 + pr-preview/pr-589/namespaces.html | 161 + pr-preview/pr-589/null__storage_8hpp.html | 133 + pr-preview/pr-589/output.png | Bin 0 -> 118782 bytes pr-preview/pr-589/pages.html | 159 + pr-preview/pr-589/palette_8hpp.html | 134 + pr-preview/pr-589/pass_8hpp.html | 130 + pr-preview/pr-589/point__light_8hpp.html | 130 + pr-preview/pr-589/position_8hpp.html | 130 + pr-preview/pr-589/primitives_8hpp.html | 100 + pr-preview/pr-589/query_8hpp.html | 149 + pr-preview/pr-589/reflect_8hpp.html | 180 + pr-preview/pr-589/registry_8hpp.html | 144 + pr-preview/pr-589/render__device_8hpp.html | 594 ++++ pr-preview/pr-589/renderer_2plugin_8hpp.html | 148 + pr-preview/pr-589/renderer_8hpp.html | 150 + pr-preview/pr-589/resource__manager_8hpp.html | 142 + pr-preview/pr-589/rotation_8hpp.html | 130 + pr-preview/pr-589/scale_8hpp.html | 130 + pr-preview/pr-589/scene_2bridge_8hpp.html | 130 + pr-preview/pr-589/scene_2plugin_8hpp.html | 130 + pr-preview/pr-589/scene_8hpp.html | 130 + pr-preview/pr-589/search-v2.js | 897 +++++ pr-preview/pr-589/searchdata-v2.js | 2 + pr-preview/pr-589/serialization_8hpp.html | 150 + pr-preview/pr-589/settings_2plugin_8hpp.html | 130 + pr-preview/pr-589/settings_8hpp.html | 130 + pr-preview/pr-589/spot__light_8hpp.html | 130 + pr-preview/pr-589/standard__archive_8hpp.html | 132 + pr-preview/pr-589/standard__stream_8hpp.html | 132 + pr-preview/pr-589/storage_8hpp.html | 137 + pr-preview/pr-589/stream_8hpp.html | 144 + pr-preview/pr-589/structColorTrait.html | 101 + pr-preview/pr-589/structIntegerAsset.html | 100 + pr-preview/pr-589/structPerson.html | 100 + pr-preview/pr-589/structPosition.html | 101 + pr-preview/pr-589/structScale.html | 100 + pr-preview/pr-589/structStrings.html | 100 + .../structcubos_1_1core_1_1data_1_1Debug.html | 154 + ...re_1_1data_1_1EmbeddedArchive_1_1Data.html | 135 + ...a_1_1EmbeddedArchive_1_1Data_1_1Entry.html | 145 + ...ructcubos_1_1core_1_1data_1_1QBMatrix.html | 128 + ...ructcubos_1_1core_1_1ecs_1_1QueryInfo.html | 125 + ...uctcubos_1_1core_1_1ecs_1_1SystemInfo.html | 197 ++ ...cubos_1_1core_1_1ecs_1_1impl_1_1Index.html | 118 + ..._1core_1_1ecs_1_1impl_1_1QueryFetcher.html | 114 + ...1core_1_1ecs_1_1impl_1_1SystemFetcher.html | 268 ++ ..._1core_1_1ecs_1_1impl_1_1SystemTraits.html | 102 + .../structcubos_1_1core_1_1geom_1_1Box.html | 193 ++ ...tructcubos_1_1core_1_1geom_1_1Capsule.html | 185 ++ .../structcubos_1_1core_1_1geom_1_1Plane.html | 121 + ...tructcubos_1_1core_1_1geom_1_1Simplex.html | 292 ++ ...cubos_1_1core_1_1gl_1_1BlendStateDesc.html | 165 + .../structcubos_1_1core_1_1gl_1_1Camera.html | 141 + ..._1core_1_1gl_1_1ConstantBufferElement.html | 133 + ...core_1_1gl_1_1ConstantBufferStructure.html | 129 + ...bos_1_1core_1_1gl_1_1CubeMapArrayDesc.html | 145 + ...uctcubos_1_1core_1_1gl_1_1CubeMapDesc.html | 141 + ..._1core_1_1gl_1_1DepthStencilStateDesc.html | 139 + ...1gl_1_1DepthStencilStateDesc_1_1Depth.html | 137 + ...l_1_1DepthStencilStateDesc_1_1Stencil.html | 151 + ...thStencilStateDesc_1_1Stencil_1_1Face.html | 133 + ...ubos_1_1core_1_1gl_1_1FramebufferDesc.html | 162 + ...FramebufferDesc_1_1CubeMapArrayTarget.html | 121 + ...l_1_1FramebufferDesc_1_1CubeMapTarget.html | 125 + ...1FramebufferDesc_1_1FramebufferTarget.html | 121 + ...amebufferDesc_1_1Texture2DArrayTarget.html | 121 + ...1_1FramebufferDesc_1_1Texture2DTarget.html | 121 + ...structcubos_1_1core_1_1gl_1_1Material.html | 168 + ...ubos_1_1core_1_1gl_1_1RasterStateDesc.html | 137 + ...uctcubos_1_1core_1_1gl_1_1SamplerDesc.html | 149 + ...tcubos_1_1core_1_1gl_1_1Texture1DDesc.html | 137 + ...s_1_1core_1_1gl_1_1Texture2DArrayDesc.html | 145 + ...tcubos_1_1core_1_1gl_1_1Texture2DDesc.html | 141 + ...tcubos_1_1core_1_1gl_1_1Texture3DDesc.html | 145 + .../structcubos_1_1core_1_1gl_1_1Vertex.html | 129 + ...ubos_1_1core_1_1gl_1_1VertexArrayDesc.html | 133 + ...tcubos_1_1core_1_1gl_1_1VertexElement.html | 145 + ...1core_1_1io_1_1GamepadConnectionEvent.html | 125 + ...ctcubos_1_1core_1_1io_1_1GamepadState.html | 188 ++ ...structcubos_1_1core_1_1io_1_1KeyEvent.html | 125 + ...cubos_1_1core_1_1io_1_1ModifiersEvent.html | 121 + ...bos_1_1core_1_1io_1_1MouseButtonEvent.html | 125 + ...cubos_1_1core_1_1io_1_1MouseMoveEvent.html | 121 + ...bos_1_1core_1_1io_1_1MouseScrollEvent.html | 121 + ...uctcubos_1_1core_1_1io_1_1ResizeEvent.html | 121 + ...tructcubos_1_1core_1_1io_1_1TextEvent.html | 121 + ..._1_1core_1_1memory_1_1RemoveReference.html | 134 + ...ubos_1_1core_1_1reflection_1_1Reflect.html | 114 + ...tructcubos_1_1engine_1_1ActiveCameras.html | 131 + .../structcubos_1_1engine_1_1Arguments.html | 102 + ...bos_1_1engine_1_1AssetMeta_1_1Exclude.html | 121 + .../structcubos_1_1engine_1_1BoxCollider.html | 140 + ...bos_1_1engine_1_1BroadPhaseCollisions.html | 358 ++ ...BroadPhaseCollisions_1_1CandidateHash.html | 101 + ..._1BroadPhaseCollisions_1_1SweepMarker.html | 125 + .../structcubos_1_1engine_1_1Camera.html | 130 + ...uctcubos_1_1engine_1_1CapsuleCollider.html | 126 + ...structcubos_1_1engine_1_1ColliderAABB.html | 278 ++ .../structcubos_1_1engine_1_1DeltaTime.html | 102 + ...ctcubos_1_1engine_1_1DirectionalLight.html | 102 + ...structcubos_1_1engine_1_1LocalToWorld.html | 122 + ...tructcubos_1_1engine_1_1PlaneCollider.html | 140 + .../structcubos_1_1engine_1_1PointLight.html | 102 + .../structcubos_1_1engine_1_1Position.html | 122 + ...ructcubos_1_1engine_1_1RenderableGrid.html | 130 + ...ubos_1_1engine_1_1RendererEnvironment.html | 125 + ...1_1engine_1_1RendererFrame_1_1DrawCmd.html | 125 + .../structcubos_1_1engine_1_1Rotation.html | 122 + .../structcubos_1_1engine_1_1Scale.html | 122 + .../structcubos_1_1engine_1_1Scene.html | 126 + .../structcubos_1_1engine_1_1ShouldQuit.html | 102 + ...uctcubos_1_1engine_1_1SimplexCollider.html | 140 + .../structcubos_1_1engine_1_1SpotLight.html | 102 + ...engine_1_1tools_1_1AssetSelectedEvent.html | 121 + ..._1_1engine_1_1tools_1_1EntitySelector.html | 121 + pr-preview/pr-589/system_8hpp.html | 155 + pr-preview/pr-589/thread__pool_8hpp.html | 130 + .../tools_2asset__explorer_2plugin_8hpp.html | 142 + ...tools_2entity__inspector_2plugin_8hpp.html | 132 + .../tools_2entity__selector_2plugin_8hpp.html | 142 + .../tools_2scene__editor_2plugin_8hpp.html | 132 + ...ols_2settings__inspector_2plugin_8hpp.html | 132 + .../tools_2world__inspector_2plugin_8hpp.html | 132 + pr-preview/pr-589/transform_2plugin_8hpp.html | 130 + pr-preview/pr-589/type_8hpp.html | 132 + pr-preview/pr-589/type__map_8hpp.html | 133 + pr-preview/pr-589/util_8hpp.html | 134 + pr-preview/pr-589/vec__storage_8hpp.html | 133 + pr-preview/pr-589/vertex_8hpp.html | 146 + pr-preview/pr-589/voxels_2plugin_8hpp.html | 130 + pr-preview/pr-589/window_2plugin_8hpp.html | 130 + pr-preview/pr-589/window_8hpp.html | 218 ++ pr-preview/pr-589/world_8hpp.html | 134 + 423 files changed, 88285 insertions(+) create mode 100644 pr-preview/pr-589/CubosLogo.png create mode 100644 pr-preview/pr-589/aabb_8hpp.html create mode 100644 pr-preview/pr-589/accessors_8hpp.html create mode 100644 pr-preview/pr-589/action_8hpp.html create mode 100644 pr-preview/pr-589/annotated.html create mode 100644 pr-preview/pr-589/archive_8hpp.html create mode 100644 pr-preview/pr-589/asset_8hpp.html create mode 100644 pr-preview/pr-589/assets_2bridge_8hpp.html create mode 100644 pr-preview/pr-589/assets_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/assets_8hpp.html create mode 100644 pr-preview/pr-589/audio__device_8hpp.html create mode 100644 pr-preview/pr-589/axis_8hpp.html create mode 100644 pr-preview/pr-589/binary_8hpp.html create mode 100644 pr-preview/pr-589/bindings_8hpp.html create mode 100644 pr-preview/pr-589/bloom_8hpp.html create mode 100644 pr-preview/pr-589/blueprint_8hpp.html create mode 100644 pr-preview/pr-589/broad__phase__collisions_8hpp.html create mode 100644 pr-preview/pr-589/buffer__stream_8hpp.html create mode 100644 pr-preview/pr-589/camera_8hpp.html create mode 100644 pr-preview/pr-589/classTextBridge.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ThreadPool.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1al_1_1AudioDevice.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1al_1_1impl_1_1Buffer.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1al_1_1impl_1_1Source.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1Archive.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1BinaryDeserializer.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1BinarySerializer.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1Context.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1DebugSerializer.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1Deserializer.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1EmbeddedArchive.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1File.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1FileStream.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1FileSystem.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1JSONDeserializer.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1JSONSerializer.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1Package.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1SerializationMap.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1Serializer.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1StandardArchive.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1Unpackager.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1data_1_1impl_1_1Packager.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1AnySystemWrapper.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Blueprint.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1BlueprintBuilder.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1CommandBuffer.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Commands.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1ComponentManager.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Dispatcher.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Entity.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EntityBuilder.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EntityManager.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EntityManager_1_1Iterator.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EventPipe.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EventReader.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EventReader_1_1Iterator.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EventWriter.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1IStorage.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1MapStorage.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1NullStorage.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1OptRead.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1OptWrite.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Query.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Query_1_1Iterator.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Read.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1ReadResource.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1ReadStorage.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Registry.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1ResourceManager.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Storage.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1SystemWrapper.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1VecStorage.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1World.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Write.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1WriteResource.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1WriteStorage.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1Debug.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1Grid.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1Palette.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1RenderDevice.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1BlendState.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1ConstantBuffer.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1CubeMap.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1CubeMapArray.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1DepthStencilState.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Framebuffer.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1IndexBuffer.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1RasterState.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Sampler.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderBindingPoint.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderPipeline.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderStage.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Texture1D.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Texture2D.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Texture2DArray.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Texture3D.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1VertexArray.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1VertexBuffer.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1io_1_1BaseWindow.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1io_1_1Cursor.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1memory_1_1BufferStream.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1memory_1_1ReadGuard.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1memory_1_1StandardStream.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1memory_1_1Stream.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1memory_1_1TypeMap.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1memory_1_1WriteGuard.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1reflection_1_1ConstructibleTrait.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1reflection_1_1ConstructibleTrait_1_1Builder.html create mode 100644 pr-preview/pr-589/classcubos_1_1core_1_1reflection_1_1Type.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1AnyAsset.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1Asset.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1AssetBridge.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1AssetMeta.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1Assets.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1BaseRenderer.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1BinaryBridge.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1Cubos.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1DeferredRenderer.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1FileBridge.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1Input.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1InputAction.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1InputAxis.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1InputBindings.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1JSONBridge.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1PostProcessingBloom.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1PostProcessingCopy.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1PostProcessingManager.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1PostProcessingPass.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1RendererFrame.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1SceneBridge.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1Settings.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1SystemBuilder.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1TagBuilder.html create mode 100644 pr-preview/pr-589/classcubos_1_1engine_1_1impl_1_1RendererGrid.html create mode 100644 pr-preview/pr-589/collisions_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/commands_8hpp.html create mode 100644 pr-preview/pr-589/component__manager_8hpp.html create mode 100644 pr-preview/pr-589/constructible_8hpp.html create mode 100644 pr-preview/pr-589/constructible__utils_8hpp.html create mode 100644 pr-preview/pr-589/contribution.html create mode 100644 pr-preview/pr-589/copy__pass_8hpp.html create mode 100644 pr-preview/pr-589/core_2include_2cubos_2core_2data_2fs_2file_8hpp.html create mode 100644 pr-preview/pr-589/core_2include_2cubos_2core_2geom_2box_8hpp.html create mode 100644 pr-preview/pr-589/core_2include_2cubos_2core_2geom_2capsule_8hpp.html create mode 100644 pr-preview/pr-589/core_2include_2cubos_2core_2geom_2plane_8hpp.html create mode 100644 pr-preview/pr-589/core_2include_2cubos_2core_2geom_2simplex_8hpp.html create mode 100644 pr-preview/pr-589/core_2samples_2data_2fs_2embedded__archive_2main_8cpp.html create mode 100644 pr-preview/pr-589/cubos_8hpp.html create mode 100644 pr-preview/pr-589/cursor_8hpp.html create mode 100644 pr-preview/pr-589/debug_8hpp.html create mode 100644 pr-preview/pr-589/deferred__renderer_8hpp.html create mode 100644 pr-preview/pr-589/dir_0835e003fa277f66ce5cf543d578f6a2.html create mode 100644 pr-preview/pr-589/dir_2a3f20446d92cb0b384d0cf4f4d26d60.html create mode 100644 pr-preview/pr-589/dir_3733897ca737f1fa8773f329655abd67.html create mode 100644 pr-preview/pr-589/dir_38e9fb064544086d3594e70a41f6b257.html create mode 100644 pr-preview/pr-589/dir_3a267dbab794906b09058daa283b3fee.html create mode 100644 pr-preview/pr-589/dir_459dda10180a6131eb62bc74e02d0b6e.html create mode 100644 pr-preview/pr-589/dir_5f701044e65d6c264a6c1dc66b1052c2.html create mode 100644 pr-preview/pr-589/dir_672562f1eb3ea0be7f3aa3e89e72ecd2.html create mode 100644 pr-preview/pr-589/dir_6c897dd97bedf3914ee8a4d9f7f6549c.html create mode 100644 pr-preview/pr-589/dir_7376bacbd9e6243f425bd4c56d48edd9.html create mode 100644 pr-preview/pr-589/dir_73cd920be1d9b25db5feb4d2a202c641.html create mode 100644 pr-preview/pr-589/dir_764b6913e5a035b506325f3918f13ed7.html create mode 100644 pr-preview/pr-589/dir_79f402fdd7bbb1d73f9fd1aa85f618da.html create mode 100644 pr-preview/pr-589/dir_85f1b5bc6fb8e602e74068211760bfae.html create mode 100644 pr-preview/pr-589/dir_8711f680e2d25dedddc79c2be2b1fda2.html create mode 100644 pr-preview/pr-589/dir_87a7847ee77970235330560d79c37ce0.html create mode 100644 pr-preview/pr-589/dir_8b12085945cef5a7cea7b856ed1ac7f6.html create mode 100644 pr-preview/pr-589/dir_8e5f84d20b1aa89c94160461e78e26c4.html create mode 100644 pr-preview/pr-589/dir_95549d37735ad5b142799f042eef0d37.html create mode 100644 pr-preview/pr-589/dir_9b04cf786b414c0d644db09287f665e6.html create mode 100644 pr-preview/pr-589/dir_9bdaf8f561be1ffd03f616379797b70b.html create mode 100644 pr-preview/pr-589/dir_b6daa990b896c2c0c53126427e4d978d.html create mode 100644 pr-preview/pr-589/dir_bafb7af0e03e95b24a45ff63060ab57b.html create mode 100644 pr-preview/pr-589/dir_bd9be39c2ccf4132268583193b02b48c.html create mode 100644 pr-preview/pr-589/dir_c185369e92e3603c6d00fa8343148da7.html create mode 100644 pr-preview/pr-589/dir_c1deef5baf41393ad8a994c3fd53e62f.html create mode 100644 pr-preview/pr-589/dir_c396301357880712663814927d68a432.html create mode 100644 pr-preview/pr-589/dir_c4311188e9cc606330f5e3e0b9dd5059.html create mode 100644 pr-preview/pr-589/dir_d0ac2003a3c19c21d7ab7ff2f06fbec3.html create mode 100644 pr-preview/pr-589/dir_db86702e1371d7558db3699dd3786a14.html create mode 100644 pr-preview/pr-589/dir_e42c9d7813efab99826f1cb60398c3fa.html create mode 100644 pr-preview/pr-589/dir_f4414684a5bb1e1b8e9ba236e8bdb594.html create mode 100644 pr-preview/pr-589/dir_f556bbe30cd07922836d0e9d7f5fa0a5.html create mode 100644 pr-preview/pr-589/dir_f6f65ff657bd34b22e5078310628f4e7.html create mode 100644 pr-preview/pr-589/directional__light_8hpp.html create mode 100644 pr-preview/pr-589/dispatcher_8hpp.html create mode 100644 pr-preview/pr-589/ecs_8hpp.html create mode 100644 pr-preview/pr-589/embedded__archive_8hpp.html create mode 100644 pr-preview/pr-589/endianness_8hpp.html create mode 100644 pr-preview/pr-589/engine_2include_2cubos_2engine_2assets_2bridges_2file_8hpp.html create mode 100644 pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2box_8hpp.html create mode 100644 pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2capsule_8hpp.html create mode 100644 pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2plane_8hpp.html create mode 100644 pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2simplex_8hpp.html create mode 100644 pr-preview/pr-589/entity__manager_8hpp.html create mode 100644 pr-preview/pr-589/environment_8hpp.html create mode 100644 pr-preview/pr-589/event__pipe_8hpp.html create mode 100644 pr-preview/pr-589/event__reader_8hpp.html create mode 100644 pr-preview/pr-589/event__writer_8hpp.html create mode 100644 pr-preview/pr-589/examples-core-logging.html create mode 100644 pr-preview/pr-589/examples-core-reflection-basic.html create mode 100644 pr-preview/pr-589/examples-core-reflection-traits-constructible.html create mode 100644 pr-preview/pr-589/examples-core-reflection.html create mode 100644 pr-preview/pr-589/examples-core.html create mode 100644 pr-preview/pr-589/examples-engine-assets-bridge.html create mode 100644 pr-preview/pr-589/examples-engine-assets-json.html create mode 100644 pr-preview/pr-589/examples-engine-assets-saving.html create mode 100644 pr-preview/pr-589/examples-engine-assets.html create mode 100644 pr-preview/pr-589/examples-engine-renderer.html create mode 100644 pr-preview/pr-589/examples-engine-scene.html create mode 100644 pr-preview/pr-589/examples-engine-settings.html create mode 100644 pr-preview/pr-589/examples-engine.html create mode 100644 pr-preview/pr-589/examples.html create mode 100644 pr-preview/pr-589/favicon-dark.png create mode 100644 pr-preview/pr-589/features-ecs.html create mode 100644 pr-preview/pr-589/features-plugins.html create mode 100644 pr-preview/pr-589/features-quadrados.html create mode 100644 pr-preview/pr-589/features.html create mode 100644 pr-preview/pr-589/file__stream_8hpp.html create mode 100644 pr-preview/pr-589/file__system_8hpp.html create mode 100644 pr-preview/pr-589/files.html create mode 100644 pr-preview/pr-589/frame_8hpp.html create mode 100644 pr-preview/pr-589/gamepad_8hpp.html create mode 100644 pr-preview/pr-589/getting-started.html create mode 100644 pr-preview/pr-589/grid_8hpp.html create mode 100644 pr-preview/pr-589/group__asset-explorer-tool-plugin.html create mode 100644 pr-preview/pr-589/group__assets-plugin.html create mode 100644 pr-preview/pr-589/group__collisions-plugin.html create mode 100644 pr-preview/pr-589/group__core-al.html create mode 100644 pr-preview/pr-589/group__core-data-fs.html create mode 100644 pr-preview/pr-589/group__core-data.html create mode 100644 pr-preview/pr-589/group__core-ecs.html create mode 100644 pr-preview/pr-589/group__core-geom.html create mode 100644 pr-preview/pr-589/group__core-gl.html create mode 100644 pr-preview/pr-589/group__core-io.html create mode 100644 pr-preview/pr-589/group__core-memory.html create mode 100644 pr-preview/pr-589/group__core-reflection.html create mode 100644 pr-preview/pr-589/group__core-ui.html create mode 100644 pr-preview/pr-589/group__core.html create mode 100644 pr-preview/pr-589/group__engine.html create mode 100644 pr-preview/pr-589/group__entity-inspector-tool-plugin.html create mode 100644 pr-preview/pr-589/group__entity-selector-tool-plugin.html create mode 100644 pr-preview/pr-589/group__imgui-plugin.html create mode 100644 pr-preview/pr-589/group__input-plugin.html create mode 100644 pr-preview/pr-589/group__renderer-plugin.html create mode 100644 pr-preview/pr-589/group__scene-editor-tool-plugin.html create mode 100644 pr-preview/pr-589/group__scene-plugin.html create mode 100644 pr-preview/pr-589/group__settings-inspector-tool-plugin.html create mode 100644 pr-preview/pr-589/group__settings-plugin.html create mode 100644 pr-preview/pr-589/group__tool-plugins.html create mode 100644 pr-preview/pr-589/group__transform-plugin.html create mode 100644 pr-preview/pr-589/group__voxels-plugin.html create mode 100644 pr-preview/pr-589/group__window-plugin.html create mode 100644 pr-preview/pr-589/group__world-inspector-tool-plugin.html create mode 100644 pr-preview/pr-589/guards_8hpp.html create mode 100644 pr-preview/pr-589/imgui_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/imgui_8hpp.html create mode 100644 pr-preview/pr-589/index.html create mode 100644 pr-preview/pr-589/input_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/input_8hpp.html create mode 100644 pr-preview/pr-589/json_8hpp.html create mode 100644 pr-preview/pr-589/keyboard_8hpp.html create mode 100644 pr-preview/pr-589/local__to__world_8hpp.html create mode 100644 pr-preview/pr-589/log_8hpp.html create mode 100644 pr-preview/pr-589/m-dark+documentation.compiled.css create mode 100644 pr-preview/pr-589/manager_8hpp.html create mode 100644 pr-preview/pr-589/map__storage_8hpp.html create mode 100644 pr-preview/pr-589/material_8hpp.html create mode 100644 pr-preview/pr-589/meta_8hpp.html create mode 100644 pr-preview/pr-589/modules.html create mode 100644 pr-preview/pr-589/move_8hpp.html create mode 100644 pr-preview/pr-589/namespacecubos.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core_1_1al.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core_1_1al_1_1impl.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core_1_1data.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core_1_1data_1_1impl.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core_1_1ecs.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core_1_1ecs_1_1impl.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core_1_1geom.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core_1_1gl.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core_1_1gl_1_1impl.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core_1_1io.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core_1_1memory.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core_1_1reflection.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1core_1_1ui.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1engine.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1engine_1_1impl.html create mode 100644 pr-preview/pr-589/namespacecubos_1_1engine_1_1tools.html create mode 100644 pr-preview/pr-589/namespaces.html create mode 100644 pr-preview/pr-589/null__storage_8hpp.html create mode 100644 pr-preview/pr-589/output.png create mode 100644 pr-preview/pr-589/pages.html create mode 100644 pr-preview/pr-589/palette_8hpp.html create mode 100644 pr-preview/pr-589/pass_8hpp.html create mode 100644 pr-preview/pr-589/point__light_8hpp.html create mode 100644 pr-preview/pr-589/position_8hpp.html create mode 100644 pr-preview/pr-589/primitives_8hpp.html create mode 100644 pr-preview/pr-589/query_8hpp.html create mode 100644 pr-preview/pr-589/reflect_8hpp.html create mode 100644 pr-preview/pr-589/registry_8hpp.html create mode 100644 pr-preview/pr-589/render__device_8hpp.html create mode 100644 pr-preview/pr-589/renderer_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/renderer_8hpp.html create mode 100644 pr-preview/pr-589/resource__manager_8hpp.html create mode 100644 pr-preview/pr-589/rotation_8hpp.html create mode 100644 pr-preview/pr-589/scale_8hpp.html create mode 100644 pr-preview/pr-589/scene_2bridge_8hpp.html create mode 100644 pr-preview/pr-589/scene_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/scene_8hpp.html create mode 100644 pr-preview/pr-589/search-v2.js create mode 100644 pr-preview/pr-589/searchdata-v2.js create mode 100644 pr-preview/pr-589/serialization_8hpp.html create mode 100644 pr-preview/pr-589/settings_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/settings_8hpp.html create mode 100644 pr-preview/pr-589/spot__light_8hpp.html create mode 100644 pr-preview/pr-589/standard__archive_8hpp.html create mode 100644 pr-preview/pr-589/standard__stream_8hpp.html create mode 100644 pr-preview/pr-589/storage_8hpp.html create mode 100644 pr-preview/pr-589/stream_8hpp.html create mode 100644 pr-preview/pr-589/structColorTrait.html create mode 100644 pr-preview/pr-589/structIntegerAsset.html create mode 100644 pr-preview/pr-589/structPerson.html create mode 100644 pr-preview/pr-589/structPosition.html create mode 100644 pr-preview/pr-589/structScale.html create mode 100644 pr-preview/pr-589/structStrings.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1data_1_1Debug.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1data_1_1EmbeddedArchive_1_1Data.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1data_1_1EmbeddedArchive_1_1Data_1_1Entry.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1data_1_1QBMatrix.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1QueryInfo.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1SystemInfo.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1impl_1_1Index.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1impl_1_1QueryFetcher.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1impl_1_1SystemFetcher.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1impl_1_1SystemTraits.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1geom_1_1Box.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1geom_1_1Capsule.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1geom_1_1Plane.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1geom_1_1Simplex.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1BlendStateDesc.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Camera.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1ConstantBufferElement.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1ConstantBufferStructure.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1CubeMapArrayDesc.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1CubeMapDesc.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Depth.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Stencil.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Stencil_1_1Face.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1CubeMapArrayTarget.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1CubeMapTarget.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1FramebufferTarget.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1Texture2DArrayTarget.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1Texture2DTarget.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Material.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1RasterStateDesc.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1SamplerDesc.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Texture1DDesc.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Texture2DArrayDesc.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Texture2DDesc.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Texture3DDesc.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Vertex.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1VertexArrayDesc.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1VertexElement.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1io_1_1GamepadConnectionEvent.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1io_1_1GamepadState.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1io_1_1KeyEvent.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1io_1_1ModifiersEvent.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1io_1_1MouseButtonEvent.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1io_1_1MouseMoveEvent.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1io_1_1MouseScrollEvent.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1io_1_1ResizeEvent.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1io_1_1TextEvent.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1memory_1_1RemoveReference.html create mode 100644 pr-preview/pr-589/structcubos_1_1core_1_1reflection_1_1Reflect.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1ActiveCameras.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1Arguments.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1AssetMeta_1_1Exclude.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1BoxCollider.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1BroadPhaseCollisions.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1CandidateHash.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1SweepMarker.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1Camera.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1CapsuleCollider.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1ColliderAABB.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1DeltaTime.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1DirectionalLight.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1LocalToWorld.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1PlaneCollider.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1PointLight.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1Position.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1RenderableGrid.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1RendererEnvironment.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1RendererFrame_1_1DrawCmd.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1Rotation.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1Scale.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1Scene.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1ShouldQuit.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1SimplexCollider.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1SpotLight.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1tools_1_1AssetSelectedEvent.html create mode 100644 pr-preview/pr-589/structcubos_1_1engine_1_1tools_1_1EntitySelector.html create mode 100644 pr-preview/pr-589/system_8hpp.html create mode 100644 pr-preview/pr-589/thread__pool_8hpp.html create mode 100644 pr-preview/pr-589/tools_2asset__explorer_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/tools_2entity__inspector_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/tools_2entity__selector_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/tools_2scene__editor_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/tools_2settings__inspector_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/tools_2world__inspector_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/transform_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/type_8hpp.html create mode 100644 pr-preview/pr-589/type__map_8hpp.html create mode 100644 pr-preview/pr-589/util_8hpp.html create mode 100644 pr-preview/pr-589/vec__storage_8hpp.html create mode 100644 pr-preview/pr-589/vertex_8hpp.html create mode 100644 pr-preview/pr-589/voxels_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/window_2plugin_8hpp.html create mode 100644 pr-preview/pr-589/window_8hpp.html create mode 100644 pr-preview/pr-589/world_8hpp.html diff --git a/pr-preview/pr-589/CubosLogo.png b/pr-preview/pr-589/CubosLogo.png new file mode 100644 index 0000000000000000000000000000000000000000..fd0cc2a08280d6020b487d4f5824b72345a4f882 GIT binary patch literal 18999 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 Q4E{}@Hf!opf9aP02c=FaoB#j- literal 0 HcmV?d00001 diff --git a/pr-preview/pr-589/aabb_8hpp.html b/pr-preview/pr-589/aabb_8hpp.html new file mode 100644 index 000000000..f167f0271 --- /dev/null +++ b/pr-preview/pr-589/aabb_8hpp.html @@ -0,0 +1,134 @@ + + + + + engine/collisions/aabb.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/accessors_8hpp.html b/pr-preview/pr-589/accessors_8hpp.html new file mode 100644 index 000000000..33d292623 --- /dev/null +++ b/pr-preview/pr-589/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-589/action_8hpp.html b/pr-preview/pr-589/action_8hpp.html new file mode 100644 index 000000000..5b630a583 --- /dev/null +++ b/pr-preview/pr-589/action_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/input/action.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/annotated.html b/pr-preview/pr-589/annotated.html new file mode 100644 index 000000000..1840da7a1 --- /dev/null +++ b/pr-preview/pr-589/annotated.html @@ -0,0 +1,520 @@ + + + + + CUBOS. + + + + + + + +
+
+
+
+
+

Classes

+
    +
  • + namespace cubos CUBOS. libraries namespace. +
      + + +
    +
    • +
  • struct ColorTrait [Position definition]
    • +
  • struct IntegerAsset [Asset type]
    • +
  • struct Person [Person definition]
    • +
  • struct Position [Person reflection]
    • +
  • struct Scale [Scale declaration]
    • +
  • struct Strings
    • +
  • class TextBridge
    • +
+ +
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/archive_8hpp.html b/pr-preview/pr-589/archive_8hpp.html new file mode 100644 index 000000000..ed49773aa --- /dev/null +++ b/pr-preview/pr-589/archive_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/data/fs/archive.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/asset_8hpp.html b/pr-preview/pr-589/asset_8hpp.html new file mode 100644 index 000000000..361fa7582 --- /dev/null +++ b/pr-preview/pr-589/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-589/assets_2bridge_8hpp.html b/pr-preview/pr-589/assets_2bridge_8hpp.html new file mode 100644 index 000000000..32733210e --- /dev/null +++ b/pr-preview/pr-589/assets_2bridge_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/assets/bridge.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/assets_2plugin_8hpp.html b/pr-preview/pr-589/assets_2plugin_8hpp.html new file mode 100644 index 000000000..c7016afa3 --- /dev/null +++ b/pr-preview/pr-589/assets_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/assets/plugin.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/assets_8hpp.html b/pr-preview/pr-589/assets_8hpp.html new file mode 100644 index 000000000..64b26c639 --- /dev/null +++ b/pr-preview/pr-589/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-589/audio__device_8hpp.html b/pr-preview/pr-589/audio__device_8hpp.html new file mode 100644 index 000000000..35ef6a93a --- /dev/null +++ b/pr-preview/pr-589/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-589/axis_8hpp.html b/pr-preview/pr-589/axis_8hpp.html new file mode 100644 index 000000000..9bc9907b6 --- /dev/null +++ b/pr-preview/pr-589/axis_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/input/axis.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/binary_8hpp.html b/pr-preview/pr-589/binary_8hpp.html new file mode 100644 index 000000000..6779e5292 --- /dev/null +++ b/pr-preview/pr-589/binary_8hpp.html @@ -0,0 +1,131 @@ + + + + + engine/assets/bridges/binary.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/bindings_8hpp.html b/pr-preview/pr-589/bindings_8hpp.html new file mode 100644 index 000000000..378747964 --- /dev/null +++ b/pr-preview/pr-589/bindings_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/input/bindings.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/bloom_8hpp.html b/pr-preview/pr-589/bloom_8hpp.html new file mode 100644 index 000000000..bc4dc23f4 --- /dev/null +++ b/pr-preview/pr-589/bloom_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/renderer/pps/bloom.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/blueprint_8hpp.html b/pr-preview/pr-589/blueprint_8hpp.html new file mode 100644 index 000000000..a2cf79882 --- /dev/null +++ b/pr-preview/pr-589/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-589/broad__phase__collisions_8hpp.html b/pr-preview/pr-589/broad__phase__collisions_8hpp.html new file mode 100644 index 000000000..d4e1974be --- /dev/null +++ b/pr-preview/pr-589/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-589/buffer__stream_8hpp.html b/pr-preview/pr-589/buffer__stream_8hpp.html new file mode 100644 index 000000000..5a88913d4 --- /dev/null +++ b/pr-preview/pr-589/buffer__stream_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/memory/buffer_stream.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/camera_8hpp.html b/pr-preview/pr-589/camera_8hpp.html new file mode 100644 index 000000000..360ce5242 --- /dev/null +++ b/pr-preview/pr-589/camera_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/gl/camera.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classTextBridge.html b/pr-preview/pr-589/classTextBridge.html new file mode 100644 index 000000000..b56a7923a --- /dev/null +++ b/pr-preview/pr-589/classTextBridge.html @@ -0,0 +1,159 @@ + + + + + TextBridge class | CUBOS. + + + + + + + +
+
+
+
+
+

+ TextBridge class +

+ +

[TextBridge] 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 +
+
[TextBridge]
+
+ auto saveToFile(const Assets& assets, + const AnyAsset& handle, + Stream& stream) -> bool override +
+
[TextBridge::loadFromFile]
+
+
+
+

Function documentation

+
+

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

+

[TextBridge]

+

[TextBridge::loadFromFile]

+
+
+

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

+

[TextBridge::loadFromFile]

+

[TextBridge::saveToFile]

+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1ThreadPool.html b/pr-preview/pr-589/classcubos_1_1core_1_1ThreadPool.html new file mode 100644 index 000000000..8c9dc5c64 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1al_1_1AudioDevice.html b/pr-preview/pr-589/classcubos_1_1core_1_1al_1_1AudioDevice.html new file mode 100644 index 000000000..f2f287c75 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1al_1_1impl_1_1Buffer.html b/pr-preview/pr-589/classcubos_1_1core_1_1al_1_1impl_1_1Buffer.html new file mode 100644 index 000000000..631f83fda --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1al_1_1impl_1_1Source.html b/pr-preview/pr-589/classcubos_1_1core_1_1al_1_1impl_1_1Source.html new file mode 100644 index 000000000..cc30314f4 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1Archive.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1Archive.html new file mode 100644 index 000000000..0dd525580 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1BinaryDeserializer.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1BinaryDeserializer.html new file mode 100644 index 000000000..52a1d8698 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1BinarySerializer.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1BinarySerializer.html new file mode 100644 index 000000000..27afffb0d --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1Context.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1Context.html new file mode 100644 index 000000000..9dc13036a --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1DebugSerializer.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1DebugSerializer.html new file mode 100644 index 000000000..a35066af8 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1Deserializer.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1Deserializer.html new file mode 100644 index 000000000..71d2b03ca --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1EmbeddedArchive.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1EmbeddedArchive.html new file mode 100644 index 000000000..35f61967e --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1File.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1File.html new file mode 100644 index 000000000..3ed45f214 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1FileStream.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1FileStream.html new file mode 100644 index 000000000..c95f83f28 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1FileSystem.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1FileSystem.html new file mode 100644 index 000000000..5e51c9501 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1JSONDeserializer.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1JSONDeserializer.html new file mode 100644 index 000000000..08c981c33 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1JSONSerializer.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1JSONSerializer.html new file mode 100644 index 000000000..5e0be7f6f --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1Package.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1Package.html new file mode 100644 index 000000000..41133312f --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1SerializationMap.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1SerializationMap.html new file mode 100644 index 000000000..c6a2df600 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1SerializationMap.html @@ -0,0 +1,367 @@ + + + + + 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 +
+
+
+ auto getMap() const -> std::unordered_map<R, I> +
+
Returns the internal map that maps references to IDs.
+
+
+
+

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.

+
+
+

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

+

Returns the internal map that maps references to IDs.

+ + + + + + + +
ReturnsMap of references and Ids.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1Serializer.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1Serializer.html new file mode 100644 index 000000000..9f0347d60 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1StandardArchive.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1StandardArchive.html new file mode 100644 index 000000000..1f9813823 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1Unpackager.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1Unpackager.html new file mode 100644 index 000000000..63b660656 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1data_1_1impl_1_1Packager.html b/pr-preview/pr-589/classcubos_1_1core_1_1data_1_1impl_1_1Packager.html new file mode 100644 index 000000000..2889d38a6 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1AnySystemWrapper.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1AnySystemWrapper.html new file mode 100644 index 000000000..b46dd8c63 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1Blueprint.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Blueprint.html new file mode 100644 index 000000000..bcc529cff --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Blueprint.html @@ -0,0 +1,330 @@ + + + + + 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.
+
+ auto getMap() const -> std::unordered_map<Entity, std::string> +
+
Returns the internal map that maps entities to their names.
+
+
+
+

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.
+ +
+
+

+ std::unordered_map<Entity, std::string> cubos::core::ecs::Blueprint::getMap() const +

+

Returns the internal map that maps entities to their names.

+ + + + + + + +
ReturnsMap of entities and names.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1BlueprintBuilder.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1BlueprintBuilder.html new file mode 100644 index 000000000..0f68737c8 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1CommandBuffer.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1CommandBuffer.html new file mode 100644 index 000000000..11fd170b2 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1Commands.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Commands.html new file mode 100644 index 000000000..318e4087a --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1ComponentManager.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1ComponentManager.html new file mode 100644 index 000000000..ff9ccb5dc --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1Dispatcher.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Dispatcher.html new file mode 100644 index 000000000..b74666050 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Dispatcher.html @@ -0,0 +1,407 @@ + + + + + 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.
+
+ void systemSetBeforeTag(const std::string& tag) +
+
Sets the current system to run before the tag.
+
+
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.
+
+
+

+ 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::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-589/classcubos_1_1core_1_1ecs_1_1Entity.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Entity.html new file mode 100644 index 000000000..441279403 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1EntityBuilder.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EntityBuilder.html new file mode 100644 index 000000000..08c0aa2d1 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1EntityManager.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EntityManager.html new file mode 100644 index 000000000..7813cffcf --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1EntityManager_1_1Iterator.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EntityManager_1_1Iterator.html new file mode 100644 index 000000000..851430d66 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EntityManager_1_1Iterator.html @@ -0,0 +1,101 @@ + + + + + cubos::core::ecs::EntityManager::Iterator class | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EventPipe.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EventPipe.html new file mode 100644 index 000000000..06c77a1c6 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1EventReader.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EventReader.html new file mode 100644 index 000000000..4a235ec98 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1EventReader_1_1Iterator.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EventReader_1_1Iterator.html new file mode 100644 index 000000000..d718dda87 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EventReader_1_1Iterator.html @@ -0,0 +1,101 @@ + + + + + cubos::core::ecs::EventReader::Iterator class | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EventWriter.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1EventWriter.html new file mode 100644 index 000000000..49e621855 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1IStorage.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1IStorage.html new file mode 100644 index 000000000..fcc66bdcd --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1MapStorage.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1MapStorage.html new file mode 100644 index 000000000..58d3068b6 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1NullStorage.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1NullStorage.html new file mode 100644 index 000000000..24847b043 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1OptRead.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1OptRead.html new file mode 100644 index 000000000..d46ab5a22 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1OptWrite.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1OptWrite.html new file mode 100644 index 000000000..506214950 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1Query.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Query.html new file mode 100644 index 000000000..45557e019 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1Query_1_1Iterator.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Query_1_1Iterator.html new file mode 100644 index 000000000..2980571d7 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1Read.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Read.html new file mode 100644 index 000000000..217ca00b7 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1ReadResource.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1ReadResource.html new file mode 100644 index 000000000..4f4e86d32 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1ReadStorage.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1ReadStorage.html new file mode 100644 index 000000000..6090dc6fa --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1Registry.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Registry.html new file mode 100644 index 000000000..c6f96d5d0 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1ResourceManager.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1ResourceManager.html new file mode 100644 index 000000000..efe14abf0 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1Storage.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Storage.html new file mode 100644 index 000000000..70c2a4583 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1SystemWrapper.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1SystemWrapper.html new file mode 100644 index 000000000..9ad613f0b --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1VecStorage.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1VecStorage.html new file mode 100644 index 000000000..58562386b --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1World.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1World.html new file mode 100644 index 000000000..1cbabd1cd --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1Write.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1Write.html new file mode 100644 index 000000000..38a5d43f5 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1WriteResource.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1WriteResource.html new file mode 100644 index 000000000..91cac38fa --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1ecs_1_1WriteStorage.html b/pr-preview/pr-589/classcubos_1_1core_1_1ecs_1_1WriteStorage.html new file mode 100644 index 000000000..d58d97cb3 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1Debug.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1Debug.html new file mode 100644 index 000000000..88830ff85 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1Debug.html @@ -0,0 +1,373 @@ + + + + + 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 drawLine(glm::vec3 start, + glm::vec3 end, + bool relative = false, + glm::vec3 color = glm::vec3(1), + float time = 0.0F) +
+
Draws a line that will stay visible for a specified amount of time.
+
+ 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::drawLine(glm::vec3 start, + glm::vec3 end, + bool relative = false, + glm::vec3 color = glm::vec3(1), + float time = 0.0F) +

+

Draws a line that will stay visible for a specified amount of time.

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
Parameters
startStarting point of the line.
endEnding point of the line.
relativeWhether the ending point is relative to the starting point.
colorColor of the drawn line.
timeHow long will it be visible for? If 0, for a single frame.
+
+
+

+ 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-589/classcubos_1_1core_1_1gl_1_1Grid.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1Grid.html new file mode 100644 index 000000000..fd7148d6b --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1Palette.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1Palette.html new file mode 100644 index 000000000..5a4aec9ae --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1RenderDevice.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1RenderDevice.html new file mode 100644 index 000000000..1507da199 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1impl_1_1BlendState.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1BlendState.html new file mode 100644 index 000000000..59a04ad5c --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1BlendState.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::impl::BlendState class | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1ConstantBuffer.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1ConstantBuffer.html new file mode 100644 index 000000000..3929921d3 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1impl_1_1CubeMap.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1CubeMap.html new file mode 100644 index 000000000..6cf631e2d --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1impl_1_1CubeMapArray.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1CubeMapArray.html new file mode 100644 index 000000000..93f9833bb --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1impl_1_1DepthStencilState.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1DepthStencilState.html new file mode 100644 index 000000000..5d3e3eb42 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1DepthStencilState.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::impl::DepthStencilState class | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Framebuffer.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Framebuffer.html new file mode 100644 index 000000000..34392800b --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Framebuffer.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::impl::Framebuffer class | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1IndexBuffer.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1IndexBuffer.html new file mode 100644 index 000000000..d0295348a --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1impl_1_1RasterState.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1RasterState.html new file mode 100644 index 000000000..7e424012d --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1RasterState.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::impl::RasterState class | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Sampler.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Sampler.html new file mode 100644 index 000000000..e9cbecc9f --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Sampler.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::impl::Sampler class | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderBindingPoint.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderBindingPoint.html new file mode 100644 index 000000000..c66675312 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderPipeline.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderPipeline.html new file mode 100644 index 000000000..72467c2c7 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderStage.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderStage.html new file mode 100644 index 000000000..9dc01f959 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1ShaderStage.html @@ -0,0 +1,138 @@ + + + + + cubos::core::gl::impl::ShaderStage class | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Texture1D.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Texture1D.html new file mode 100644 index 000000000..49761a784 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1impl_1_1Texture2D.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Texture2D.html new file mode 100644 index 000000000..f97e24a4d --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1impl_1_1Texture2DArray.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Texture2DArray.html new file mode 100644 index 000000000..b23610106 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1impl_1_1Texture3D.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1Texture3D.html new file mode 100644 index 000000000..8729c8c7c --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1gl_1_1impl_1_1VertexArray.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1VertexArray.html new file mode 100644 index 000000000..d50bb9849 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1VertexArray.html @@ -0,0 +1,101 @@ + + + + + cubos::core::gl::impl::VertexArray class | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1VertexBuffer.html b/pr-preview/pr-589/classcubos_1_1core_1_1gl_1_1impl_1_1VertexBuffer.html new file mode 100644 index 000000000..6ec8883ba --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1io_1_1BaseWindow.html b/pr-preview/pr-589/classcubos_1_1core_1_1io_1_1BaseWindow.html new file mode 100644 index 000000000..3bc538d24 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1io_1_1BaseWindow.html @@ -0,0 +1,475 @@ + + + + + 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.
+
+ auto gamepadState(int gamepad, + GamepadState& state) const -> bool pure virtual +
+
Gets the state of the specified gamepad.
+
+
+
+

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.
+
+
+

+ bool cubos::core::io::BaseWindow::gamepadState(int gamepad, + GamepadState& state) const pure virtual +

+

Gets the state of the specified gamepad.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
gamepadGamepad to get the state of.
stateState to fill with the gamepad state.
ReturnsWhether the gamepad was found.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1io_1_1Cursor.html b/pr-preview/pr-589/classcubos_1_1core_1_1io_1_1Cursor.html new file mode 100644 index 000000000..196c59bde --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1memory_1_1BufferStream.html b/pr-preview/pr-589/classcubos_1_1core_1_1memory_1_1BufferStream.html new file mode 100644 index 000000000..56620746b --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1memory_1_1ReadGuard.html b/pr-preview/pr-589/classcubos_1_1core_1_1memory_1_1ReadGuard.html new file mode 100644 index 000000000..ac1b29946 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1memory_1_1StandardStream.html b/pr-preview/pr-589/classcubos_1_1core_1_1memory_1_1StandardStream.html new file mode 100644 index 000000000..76d41e54b --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1memory_1_1Stream.html b/pr-preview/pr-589/classcubos_1_1core_1_1memory_1_1Stream.html new file mode 100644 index 000000000..0bcdb0646 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1memory_1_1TypeMap.html b/pr-preview/pr-589/classcubos_1_1core_1_1memory_1_1TypeMap.html new file mode 100644 index 000000000..0fe134605 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1memory_1_1WriteGuard.html b/pr-preview/pr-589/classcubos_1_1core_1_1memory_1_1WriteGuard.html new file mode 100644 index 000000000..fe285f8e2 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1core_1_1reflection_1_1ConstructibleTrait.html b/pr-preview/pr-589/classcubos_1_1core_1_1reflection_1_1ConstructibleTrait.html new file mode 100644 index 000000000..342878028 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1reflection_1_1ConstructibleTrait.html @@ -0,0 +1,458 @@ + + + + + cubos::core::reflection::ConstructibleTrait class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::reflection::ConstructibleTrait class +
#include <core/reflection/traits/constructible.hpp>
+

+

Describes how a reflected type may be constructed and destructed.

+ + +
+

Public types

+
+
+
template<typename T>
+ class Builder +
+
Builder for ConstructibleTrait.
+
+ using Destructor = void(*)(void*instance) +
+
Function pointer to the destructor of a type.
+
+ using DefaultConstructor = void(*)(void*instance) +
+
Function pointer to the default constructor of a type.
+
+ using CopyConstructor = void(*)(void*instance, const void*other) +
+
Function pointer to the copy constructor of a type.
+
+ using MoveConstructor = void(*)(void*instance, void*other) +
+
Function pointer to the move constructor of a type.
+
+
+
+

Public static functions

+
+
+
template<typename T>
+ static auto typed() -> Builder<T> +
+
Returns a trait builder for the given type.
+
+
+
+

Constructors, destructors, conversion operators

+
+
+ ConstructibleTrait(std::size_t size, + std::size_t alignment, + void(*)(void*) destructor) +
+
Constructs.
+
+
+
+

Public functions

+
+
+ auto withDefaultConstructor(DefaultConstructor defaultConstructor) && -> ConstructibleTrait&& +
+
Sets the default constructor of the type.
+
+ auto withCopyConstructor(CopyConstructor copyConstructor) && -> ConstructibleTrait&& +
+
Sets the copy constructor of the type.
+
+ auto withMoveConstructor(MoveConstructor moveConstructor) && -> ConstructibleTrait&& +
+
Sets the move constructor of the type.
+
+ auto size() const -> std::size_t +
+
Returns the size of the type in bytes.
+
+ auto alignment() const -> std::size_t +
+
Returns the alignment of the type in bytes.
+
+ void destruct(void* instance) const +
+
Destructs an instance of the type.
+
+ auto defaultConstruct(void* instance) const -> bool +
+
Default constructs an instance of the type.
+
+ auto copyConstruct(void* instance, + const void* other) const -> bool +
+
Copy constructs an instance of the type.
+
+ auto moveConstruct(void* instance, + void* other) const -> bool +
+
Move constructs an instance of the type.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ static Builder<T> cubos::core::reflection::ConstructibleTrait::typed() +

+

Returns a trait builder for the given type.

+ + + + + + + + + + + + + + + + +
Template parameters
TType to build a trait for.
ReturnsTrait builder.
+
+
+

+ cubos::core::reflection::ConstructibleTrait::ConstructibleTrait(std::size_t size, + std::size_t alignment, + void(*)(void*) destructor) +

+

Constructs.

+ + + + + + + + + + + + + + + + + + +
Parameters
sizeSize of the type in bytes.
alignmentAlignment of the type in bytes (must be a power of two).
destructorFunction pointer to the destructor of the type.
+
+
+

+ ConstructibleTrait&& cubos::core::reflection::ConstructibleTrait::withDefaultConstructor(DefaultConstructor defaultConstructor) && +

+

Sets the default constructor of the type.

+ + + + + + + + + + + + + + + + +
Parameters
defaultConstructorFunction pointer to the default constructor of the type.
ReturnsTrait.
+

Aborts if the default constructor has already been set.

+
+
+

+ ConstructibleTrait&& cubos::core::reflection::ConstructibleTrait::withCopyConstructor(CopyConstructor copyConstructor) && +

+

Sets the copy constructor of the type.

+ + + + + + + + + + + + + + + + +
Parameters
copyConstructorFunction pointer to the copy constructor of the type.
ReturnsTrait.
+

Aborts if the copy constructor has already been set.

+
+
+

+ ConstructibleTrait&& cubos::core::reflection::ConstructibleTrait::withMoveConstructor(MoveConstructor moveConstructor) && +

+

Sets the move constructor of the type.

+ + + + + + + + + + + + + + + + +
Parameters
moveConstructorFunction pointer to the move constructor of the type.
ReturnsTrait.
+

Aborts if the copy constructor has already been set.

+
+
+

+ std::size_t cubos::core::reflection::ConstructibleTrait::size() const +

+

Returns the size of the type in bytes.

+ + + + + + + +
ReturnsSize of the type in bytes.
+
+
+

+ std::size_t cubos::core::reflection::ConstructibleTrait::alignment() const +

+

Returns the alignment of the type in bytes.

+ + + + + + + +
ReturnsAlignment of the type in bytes.
+
+
+

+ void cubos::core::reflection::ConstructibleTrait::destruct(void* instance) const +

+

Destructs an instance of the type.

+ + + + + + + + + + +
Parameters
instancePointer to the instance to destruct.
+
+
+

+ bool cubos::core::reflection::ConstructibleTrait::defaultConstruct(void* instance) const +

+

Default constructs an instance of the type.

+ + + + + + + + + + + + + + + + +
Parameters
instancePointer to the location to construct the instance at.
ReturnsWhether default construction is supported.
+
+
+

+ bool cubos::core::reflection::ConstructibleTrait::copyConstruct(void* instance, + const void* other) const +

+

Copy constructs an instance of the type.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
instancePointer to the location to construct the instance at.
otherPointer to the instance to copy construct from.
ReturnsWhether copy construction is supported.
+
+
+

+ bool cubos::core::reflection::ConstructibleTrait::moveConstruct(void* instance, + void* other) const +

+

Move constructs an instance of the type.

+ + + + + + + + + + + + + + + + + + + + +
Parameters
instancePointer to the location to construct the instance at.
otherPointer to the instance to move construct from.
ReturnsWhether move construction is supported.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1reflection_1_1ConstructibleTrait_1_1Builder.html b/pr-preview/pr-589/classcubos_1_1core_1_1reflection_1_1ConstructibleTrait_1_1Builder.html new file mode 100644 index 000000000..2141ab645 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1reflection_1_1ConstructibleTrait_1_1Builder.html @@ -0,0 +1,215 @@ + + + + + cubos::core::reflection::ConstructibleTrait::Builder class | CUBOS. + + + + + + + +
+
+
+
+
+

+
#include <core/reflection/traits/constructible.hpp>
+
template<typename T>
+ cubos::core::reflection::ConstructibleTrait::Builder class +

+

Builder for ConstructibleTrait.

+ +
+

Constructors, destructors, conversion operators

+
+
+ Builder() +
+
Constructs.
+
+
+
+

Public functions

+
+
+ auto build() && -> ConstructibleTrait +
+
Returns the constructed trait.
+
+ auto withDefaultConstructor() && -> Builder&& +
+
Sets the copy constructor of the type.
+
+ auto withCopyConstructor() && -> Builder&& +
+
Sets the copy constructor of the type.
+
+ auto withMoveConstructor() && -> Builder&& +
+
Sets the move constructor of the type.
+
+
+
+

Function documentation

+
+

+
+ template<typename T> +
+ ConstructibleTrait cubos::core::reflection::ConstructibleTrait::Builder<T>::build() && +

+

Returns the constructed trait.

+ + + + + + + +
ReturnsConstructed trait.
+
+
+

+
+ template<typename T> +
+ Builder&& cubos::core::reflection::ConstructibleTrait::Builder<T>::withDefaultConstructor() && +

+

Sets the copy constructor of the type.

+ + + + + + + +
ReturnsBuilder.
+
+
+

+
+ template<typename T> +
+ Builder&& cubos::core::reflection::ConstructibleTrait::Builder<T>::withCopyConstructor() && +

+

Sets the copy constructor of the type.

+ + + + + + + +
ReturnsBuilder.
+
+
+

+
+ template<typename T> +
+ Builder&& cubos::core::reflection::ConstructibleTrait::Builder<T>::withMoveConstructor() && +

+

Sets the move constructor of the type.

+ + + + + + + +
ReturnsBuilder.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1core_1_1reflection_1_1Type.html b/pr-preview/pr-589/classcubos_1_1core_1_1reflection_1_1Type.html new file mode 100644 index 000000000..4db47ebb9 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1core_1_1reflection_1_1Type.html @@ -0,0 +1,328 @@ + + + + + cubos::core::reflection::Type class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::reflection::Type class final +
#include <core/reflection/type.hpp>
+

+

Describes a reflected type.

+ +

Holds the name of a type and the traits associated with it. Traits can be of any type, which means you can define your own custom traits.

+
+

Public static functions

+
+
+ static auto create(std::string name) -> Type& +
+
Constructs with a type the given name.
+
+ static void destroy(Type& type) +
+
Destroys the given type.
+
+
+
+

Public functions

+
+
+ auto name() const -> const std::string& +
+
Returns the name of the type.
+
+
template<typename T>
+ auto is() const -> bool +
+
Checks if this type represents the type T.
+
+
template<typename T>
+ auto with(T trait) -> Type& +
+
Adds the given trait to the type.
+
+
template<typename T>
+ auto has() const -> bool +
+
Returns whether the type has the given trait.
+
+
template<typename T>
+ auto get() const -> const T& +
+
Returns the given trait of the type.
+
+
+
+

Function documentation

+
+

+ static Type& cubos::core::reflection::Type::create(std::string name) +

+

Constructs with a type the given name.

+ + + + + + + + + + + + + + + + +
Parameters
nameName of the type.
ReturnsReference to the type.
+
+
+

+ static void cubos::core::reflection::Type::destroy(Type& type) +

+

Destroys the given type.

+ + + + + + + + + + +
Parameters
typeType to destroy.
+
+
+

+ const std::string& cubos::core::reflection::Type::name() const +

+

Returns the name of the type.

+ + + + + + + +
ReturnsName of the type.
+
+
+

+
+ template<typename T> +
+ bool cubos::core::reflection::Type::is() const +

+

Checks if this type represents the type T.

+ + + + + + + + + + + + + + + + +
Template parameters
TType to check.
ReturnsWhether this type represents the type T.
+
+
+

+
+ template<typename T> +
+ Type& cubos::core::reflection::Type::with(T trait) +

+

Adds the given trait to the type.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TTrait type.
Parameters
traitTrait value.
ReturnsReference to this type, for chaining.
+

Aborts if the trait is already present in the type.

+
+
+

+
+ template<typename T> +
+ bool cubos::core::reflection::Type::has() const +

+

Returns whether the type has the given trait.

+ + + + + + + + + + + + + + + + +
Template parameters
TTrait type.
ReturnsWhether the type has the given trait.
+
+
+

+
+ template<typename T> +
+ const T& cubos::core::reflection::Type::get() const +

+

Returns the given trait of the type.

+ + + + + + + + + + + + + + + + +
Template parameters
TTrait type.
ReturnsReference to the trait.
+

Aborts if the type does not have the given trait.

+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1engine_1_1AnyAsset.html b/pr-preview/pr-589/classcubos_1_1engine_1_1AnyAsset.html new file mode 100644 index 000000000..286da24e4 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1Asset.html b/pr-preview/pr-589/classcubos_1_1engine_1_1Asset.html new file mode 100644 index 000000000..0b5afdae9 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1AssetBridge.html b/pr-preview/pr-589/classcubos_1_1engine_1_1AssetBridge.html new file mode 100644 index 000000000..9d02177a1 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1AssetMeta.html b/pr-preview/pr-589/classcubos_1_1engine_1_1AssetMeta.html new file mode 100644 index 000000000..7846057ca --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1Assets.html b/pr-preview/pr-589/classcubos_1_1engine_1_1Assets.html new file mode 100644 index 000000000..8b2c5af58 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1BaseRenderer.html b/pr-preview/pr-589/classcubos_1_1engine_1_1BaseRenderer.html new file mode 100644 index 000000000..4047cd3a6 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1BinaryBridge.html b/pr-preview/pr-589/classcubos_1_1engine_1_1BinaryBridge.html new file mode 100644 index 000000000..198daa0b5 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1Cubos.html b/pr-preview/pr-589/classcubos_1_1engine_1_1Cubos.html new file mode 100644 index 000000000..a88a8dd74 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1DeferredRenderer.html b/pr-preview/pr-589/classcubos_1_1engine_1_1DeferredRenderer.html new file mode 100644 index 000000000..ec7d11cc2 --- /dev/null +++ b/pr-preview/pr-589/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, + 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, + 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-589/classcubos_1_1engine_1_1FileBridge.html b/pr-preview/pr-589/classcubos_1_1engine_1_1FileBridge.html new file mode 100644 index 000000000..cec05d8cd --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1Input.html b/pr-preview/pr-589/classcubos_1_1engine_1_1Input.html new file mode 100644 index 000000000..bd5a00b2e --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1engine_1_1Input.html @@ -0,0 +1,436 @@ + + + + + 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.
+
+ using GamepadButton = core::io::GamepadButton +
+
Alias for core::io::GamepadButton.
+
+ using GamepadAxis = core::io::GamepadAxis +
+
Alias for core::io::GamepadAxis.
+
+
+
+

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.
+
+ void gamepad(int player, + int gamepad) +
+
Sets the gamepad for a specific player.
+
+ auto gamepad(int player) const -> int +
+
Gets the gamepad 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::GamepadConnectionEvent& event) +
+
Handle a gamepad connection event.
+
+ void handle(const core::io::Window& window, + const core::io::WindowEvent& event) +
+
Handle all other events - discards them.
+
+ void pollGamepads(const core::io::Window& window) +
+
Polls the input state of the gamepads.
+
+ 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.
+
+
+

+ void cubos::engine::Input::gamepad(int player, + int gamepad) +

+

Sets the gamepad for a specific player.

+ + + + + + + + + + + + + + +
Parameters
playerPlayer whose gamepad will be set.
gamepadGamepad to set.
+
+
+

+ int cubos::engine::Input::gamepad(int player) const +

+

Gets the gamepad for a specific player.

+ + + + + + + + + + + + + + + + +
Parameters
playerPlayer whose gamepad will be retrieved.
ReturnsGamepad if it exists, -1 otherwise.
+
+
+

+ 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::GamepadConnectionEvent& event) +

+

Handle a gamepad connection event.

+ + + + + + + + + + + + + + +
Parameters
windowWindow that received the event.
eventGamepad connection 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().

+
+
+

+ void cubos::engine::Input::pollGamepads(const core::io::Window& window) +

+

Polls the input state of the gamepads.

+ + + + + + + + + + +
Parameters
windowWindow to poll the gamepad state from.
+
+
+

+ 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-589/classcubos_1_1engine_1_1InputAction.html b/pr-preview/pr-589/classcubos_1_1engine_1_1InputAction.html new file mode 100644 index 000000000..10ea8a42e --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1engine_1_1InputAction.html @@ -0,0 +1,269 @@ + + + + + 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, + std::vector<core::io::GamepadButton> gamepadButtons) +
+
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 gamepadButtons() const -> const std::vector<core::io::GamepadButton>& +
+
Gets the gamepad button bindings.
+
+ auto gamepadButtons() -> std::vector<core::io::GamepadButton>& +
+
Gets the gamepad button 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, + std::vector<core::io::GamepadButton> gamepadButtons) +

+

Constructs with existing bindings.

+ + + + + + + + + + + + + + +
Parameters
keysKey bindings.
gamepadButtonsGamepad button 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.
+
+
+

+ const std::vector<core::io::GamepadButton>& cubos::engine::InputAction::gamepadButtons() const +

+

Gets the gamepad button bindings.

+ + + + + + + +
ReturnsVector of buttons.
+
+
+

+ std::vector<core::io::GamepadButton>& cubos::engine::InputAction::gamepadButtons() +

+

Gets the gamepad button bindings.

+ + + + + + + +
ReturnsVector of buttons.
+
+
+

+ 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-589/classcubos_1_1engine_1_1InputAxis.html b/pr-preview/pr-589/classcubos_1_1engine_1_1InputAxis.html new file mode 100644 index 000000000..d8dd9ef4e --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1engine_1_1InputAxis.html @@ -0,0 +1,311 @@ + + + + + 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, + std::vector<core::io::GamepadAxis> gamepadAxes) +
+
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 gamepadAxes() const -> const std::vector<core::io::GamepadAxis>& +
+
Gets the gamepad axis 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 gamepadAxes() -> std::vector<core::io::GamepadAxis>& +
+
Gets the gamepad axis 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, + std::vector<core::io::GamepadAxis> gamepadAxes) +

+

Constructs with existing bindings.

+ + + + + + + + + + + + + + + + + + +
Parameters
positivePositive key bindings.
negativeNegative key bindings.
gamepadAxesGamepad axis 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.
+
+
+

+ const std::vector<core::io::GamepadAxis>& cubos::engine::InputAxis::gamepadAxes() const +

+

Gets the gamepad axis bindings.

+ + + + + + + +
ReturnsVector of gamepad axes.
+
+
+

+ 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.
+
+
+

+ std::vector<core::io::GamepadAxis>& cubos::engine::InputAxis::gamepadAxes() +

+

Gets the gamepad axis bindings.

+ + + + + + + +
ReturnsVector of gamepad axes.
+
+
+

+ 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-589/classcubos_1_1engine_1_1InputBindings.html b/pr-preview/pr-589/classcubos_1_1engine_1_1InputBindings.html new file mode 100644 index 000000000..5a861a815 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1JSONBridge.html b/pr-preview/pr-589/classcubos_1_1engine_1_1JSONBridge.html new file mode 100644 index 000000000..9b98e3c94 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1PostProcessingBloom.html b/pr-preview/pr-589/classcubos_1_1engine_1_1PostProcessingBloom.html new file mode 100644 index 000000000..6e675a76f --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1PostProcessingCopy.html b/pr-preview/pr-589/classcubos_1_1engine_1_1PostProcessingCopy.html new file mode 100644 index 000000000..45d19ccfb --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1PostProcessingManager.html b/pr-preview/pr-589/classcubos_1_1engine_1_1PostProcessingManager.html new file mode 100644 index 000000000..8ae0929ef --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1PostProcessingPass.html b/pr-preview/pr-589/classcubos_1_1engine_1_1PostProcessingPass.html new file mode 100644 index 000000000..5b2a9b435 --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1RendererFrame.html b/pr-preview/pr-589/classcubos_1_1engine_1_1RendererFrame.html new file mode 100644 index 000000000..f80ebbc90 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1engine_1_1RendererFrame.html @@ -0,0 +1,408 @@ + + + + + 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(glm::mat4 transform, + const SpotLight& light) +
+
Adds a spot light to the frame.
+
+ void light(glm::mat4 transform, + const DirectionalLight& light) +
+
Adds a directional light to the frame.
+
+ void light(glm::mat4 transform, + const 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<std::pair<glm::mat4, SpotLight>>& +
+
Gets the spot lights of the frame.
+
+ auto directionalLights() const -> const std::vector<std::pair<glm::mat4, DirectionalLight>>& +
+
Gets the directional lights of the frame.
+
+ auto pointLights() const -> const std::vector<std::pair<glm::mat4, 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(glm::mat4 transform, + const SpotLight& light) +

+

Adds a spot light to the frame.

+ + + + + + + + + + + + + + +
Parameters
transformLight transform matrix.
lightSpot light to add.
+
+
+

+ void cubos::engine::RendererFrame::light(glm::mat4 transform, + const DirectionalLight& light) +

+

Adds a directional light to the frame.

+ + + + + + + + + + + + + + +
Parameters
transformLight transform matrix.
lightDirectional light to add.
+
+
+

+ void cubos::engine::RendererFrame::light(glm::mat4 transform, + const PointLight& light) +

+

Adds a point light to the frame.

+ + + + + + + + + + + + + + +
Parameters
transformLight transform matrix.
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<std::pair<glm::mat4, SpotLight>>& cubos::engine::RendererFrame::spotLights() const +

+

Gets the spot lights of the frame.

+ + + + + + + +
ReturnsSpot lights.
+
+
+

+ const std::vector<std::pair<glm::mat4, DirectionalLight>>& cubos::engine::RendererFrame::directionalLights() const +

+

Gets the directional lights of the frame.

+ + + + + + + +
ReturnsDirectional lights.
+
+
+

+ const std::vector<std::pair<glm::mat4, PointLight>>& cubos::engine::RendererFrame::pointLights() const +

+

Gets the point lights of the frame.

+ + + + + + + +
ReturnsPoint lights.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1engine_1_1SceneBridge.html b/pr-preview/pr-589/classcubos_1_1engine_1_1SceneBridge.html new file mode 100644 index 000000000..46fc0ba1c --- /dev/null +++ b/pr-preview/pr-589/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-589/classcubos_1_1engine_1_1Settings.html b/pr-preview/pr-589/classcubos_1_1engine_1_1Settings.html new file mode 100644 index 000000000..29a14e9f5 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1engine_1_1Settings.html @@ -0,0 +1,434 @@ + + + + + cubos::engine::Settings class | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::engine::Settings class final +
#include <engine/settings/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, + bool value) +
+
Defines a new boolean setting.
+
+ auto getBool(const std::string& key, + bool defaultValue) -> 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) -> 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) -> 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) -> 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::engine::Settings::setBool(const std::string& key, + bool value) +

+

Defines a new boolean setting.

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

If the setting already exists, overwrites its value.

+
+
+

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

+

Retrieves the bool setting with the given key.

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

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

+
+
+

+ void cubos::engine::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::engine::Settings::getString(const std::string& key, + const std::string& defaultValue) +

+

Retrieves the string setting with the given key.

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

If no setting exists with such key, sets it to defaultValue and returns it.

+
+
+

+ void cubos::engine::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::engine::Settings::getInteger(const std::string& key, + int defaultValue) +

+

Retrieves the integer setting with the given key.

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

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

+
+
+

+ void cubos::engine::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::engine::Settings::getDouble(const std::string& key, + double defaultValue) +

+

Retrieves the double setting with the given key.

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

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

+
+
+

+ void cubos::engine::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::engine::Settings::getValues() const +

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

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

+ + + + + + + +
ReturnsUnderlying std::unordered_map with the settings.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/classcubos_1_1engine_1_1SystemBuilder.html b/pr-preview/pr-589/classcubos_1_1engine_1_1SystemBuilder.html new file mode 100644 index 000000000..613e56494 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1engine_1_1SystemBuilder.html @@ -0,0 +1,274 @@ + + + + + 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 before(const std::string& tag) -> SystemBuilder& +
+
Sets the current system to be executed before another tag.
+
+ auto after(const std::string& tag) -> SystemBuilder& +
+
Sets the current system to be executed after another tag.
+
+
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::before(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::after(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::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-589/classcubos_1_1engine_1_1TagBuilder.html b/pr-preview/pr-589/classcubos_1_1engine_1_1TagBuilder.html new file mode 100644 index 000000000..478bbc00a --- /dev/null +++ b/pr-preview/pr-589/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 before(const std::string& tag) -> TagBuilder& +
+
Sets the current tag to be executed before another tag.
+
+ auto after(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::before(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::after(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-589/classcubos_1_1engine_1_1impl_1_1RendererGrid.html b/pr-preview/pr-589/classcubos_1_1engine_1_1impl_1_1RendererGrid.html new file mode 100644 index 000000000..6a01e12f2 --- /dev/null +++ b/pr-preview/pr-589/classcubos_1_1engine_1_1impl_1_1RendererGrid.html @@ -0,0 +1,101 @@ + + + + + cubos::engine::impl::RendererGrid class | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/collisions_2plugin_8hpp.html b/pr-preview/pr-589/collisions_2plugin_8hpp.html new file mode 100644 index 000000000..e81375808 --- /dev/null +++ b/pr-preview/pr-589/collisions_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/collisions/plugin.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/commands_8hpp.html b/pr-preview/pr-589/commands_8hpp.html new file mode 100644 index 000000000..9de221f9a --- /dev/null +++ b/pr-preview/pr-589/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-589/component__manager_8hpp.html b/pr-preview/pr-589/component__manager_8hpp.html new file mode 100644 index 000000000..7435159e7 --- /dev/null +++ b/pr-preview/pr-589/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-589/constructible_8hpp.html b/pr-preview/pr-589/constructible_8hpp.html new file mode 100644 index 000000000..28d870082 --- /dev/null +++ b/pr-preview/pr-589/constructible_8hpp.html @@ -0,0 +1,137 @@ + + + + + core/reflection/traits/constructible.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/reflection/traits/constructible.hpp file +

+

Class cubos::core::reflection::ConstructibleTrait.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::reflection
+
Reflection module.
+
+
+
+

Classes

+
+
+ class cubos::core::reflection::ConstructibleTrait +
+
Describes how a reflected type may be constructed and destructed.
+
+
template<typename T>
+ class cubos::core::reflection::ConstructibleTrait::Builder +
+
Builder for ConstructibleTrait.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/constructible__utils_8hpp.html b/pr-preview/pr-589/constructible__utils_8hpp.html new file mode 100644 index 000000000..e5aaa7388 --- /dev/null +++ b/pr-preview/pr-589/constructible__utils_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/reflection/traits/constructible_utils.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/reflection/traits/constructible_utils.hpp file +

+

Utilities for cubos::core::reflection::ConstructibleTrait.

+ + +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::reflection
+
Reflection module.
+
+
+
+

Functions

+
+
+
template<typename T>
+ auto autoConstructibleTrait() -> ConstructibleTrait +
+
Returns a ConstructibleTrait with the default, copy and move constructors, set only if the type has them.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/contribution.html b/pr-preview/pr-589/contribution.html new file mode 100644 index 000000000..f606bd09d --- /dev/null +++ b/pr-preview/pr-589/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-589/copy__pass_8hpp.html b/pr-preview/pr-589/copy__pass_8hpp.html new file mode 100644 index 000000000..bbbf69fe3 --- /dev/null +++ b/pr-preview/pr-589/copy__pass_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/renderer/pps/copy_pass.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/core_2include_2cubos_2core_2data_2fs_2file_8hpp.html b/pr-preview/pr-589/core_2include_2cubos_2core_2data_2fs_2file_8hpp.html new file mode 100644 index 000000000..ed1596ec5 --- /dev/null +++ b/pr-preview/pr-589/core_2include_2cubos_2core_2data_2fs_2file_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/data/fs/file.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/core_2include_2cubos_2core_2geom_2box_8hpp.html b/pr-preview/pr-589/core_2include_2cubos_2core_2geom_2box_8hpp.html new file mode 100644 index 000000000..c85ad9eaf --- /dev/null +++ b/pr-preview/pr-589/core_2include_2cubos_2core_2geom_2box_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/geom/box.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/core_2include_2cubos_2core_2geom_2capsule_8hpp.html b/pr-preview/pr-589/core_2include_2cubos_2core_2geom_2capsule_8hpp.html new file mode 100644 index 000000000..f160db3c6 --- /dev/null +++ b/pr-preview/pr-589/core_2include_2cubos_2core_2geom_2capsule_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/geom/capsule.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/core_2include_2cubos_2core_2geom_2plane_8hpp.html b/pr-preview/pr-589/core_2include_2cubos_2core_2geom_2plane_8hpp.html new file mode 100644 index 000000000..2fecf5af5 --- /dev/null +++ b/pr-preview/pr-589/core_2include_2cubos_2core_2geom_2plane_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/geom/plane.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/core_2include_2cubos_2core_2geom_2simplex_8hpp.html b/pr-preview/pr-589/core_2include_2cubos_2core_2geom_2simplex_8hpp.html new file mode 100644 index 000000000..886ce74d4 --- /dev/null +++ b/pr-preview/pr-589/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-589/core_2samples_2data_2fs_2embedded__archive_2main_8cpp.html b/pr-preview/pr-589/core_2samples_2data_2fs_2embedded__archive_2main_8cpp.html new file mode 100644 index 000000000..d5d815a1c --- /dev/null +++ b/pr-preview/pr-589/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-589/cubos_8hpp.html b/pr-preview/pr-589/cubos_8hpp.html new file mode 100644 index 000000000..81e977ac4 --- /dev/null +++ b/pr-preview/pr-589/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 which stores the command-line 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-589/cursor_8hpp.html b/pr-preview/pr-589/cursor_8hpp.html new file mode 100644 index 000000000..673da2595 --- /dev/null +++ b/pr-preview/pr-589/cursor_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/io/cursor.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/debug_8hpp.html b/pr-preview/pr-589/debug_8hpp.html new file mode 100644 index 000000000..c01ee55d4 --- /dev/null +++ b/pr-preview/pr-589/debug_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/gl/debug.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/deferred__renderer_8hpp.html b/pr-preview/pr-589/deferred__renderer_8hpp.html new file mode 100644 index 000000000..491c8d973 --- /dev/null +++ b/pr-preview/pr-589/deferred__renderer_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/renderer/deferred_renderer.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_0835e003fa277f66ce5cf543d578f6a2.html b/pr-preview/pr-589/dir_0835e003fa277f66ce5cf543d578f6a2.html new file mode 100644 index 000000000..48aea1cff --- /dev/null +++ b/pr-preview/pr-589/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-589/dir_2a3f20446d92cb0b384d0cf4f4d26d60.html b/pr-preview/pr-589/dir_2a3f20446d92cb0b384d0cf4f4d26d60.html new file mode 100644 index 000000000..9774e0b55 --- /dev/null +++ b/pr-preview/pr-589/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-589/dir_3733897ca737f1fa8773f329655abd67.html b/pr-preview/pr-589/dir_3733897ca737f1fa8773f329655abd67.html new file mode 100644 index 000000000..5595f7f84 --- /dev/null +++ b/pr-preview/pr-589/dir_3733897ca737f1fa8773f329655abd67.html @@ -0,0 +1,118 @@ + + + + + engine/tools/entity_selector/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_38e9fb064544086d3594e70a41f6b257.html b/pr-preview/pr-589/dir_38e9fb064544086d3594e70a41f6b257.html new file mode 100644 index 000000000..0213d5d7d --- /dev/null +++ b/pr-preview/pr-589/dir_38e9fb064544086d3594e70a41f6b257.html @@ -0,0 +1,122 @@ + + + + + engine/scene/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_3a267dbab794906b09058daa283b3fee.html b/pr-preview/pr-589/dir_3a267dbab794906b09058daa283b3fee.html new file mode 100644 index 000000000..3015902e4 --- /dev/null +++ b/pr-preview/pr-589/dir_3a267dbab794906b09058daa283b3fee.html @@ -0,0 +1,124 @@ + + + + + engine/collisions/colliders/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_459dda10180a6131eb62bc74e02d0b6e.html b/pr-preview/pr-589/dir_459dda10180a6131eb62bc74e02d0b6e.html new file mode 100644 index 000000000..b1c81a2b1 --- /dev/null +++ b/pr-preview/pr-589/dir_459dda10180a6131eb62bc74e02d0b6e.html @@ -0,0 +1,118 @@ + + + + + engine/imgui/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_5f701044e65d6c264a6c1dc66b1052c2.html b/pr-preview/pr-589/dir_5f701044e65d6c264a6c1dc66b1052c2.html new file mode 100644 index 000000000..2b8e53ec8 --- /dev/null +++ b/pr-preview/pr-589/dir_5f701044e65d6c264a6c1dc66b1052c2.html @@ -0,0 +1,126 @@ + + + + + engine/transform/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_672562f1eb3ea0be7f3aa3e89e72ecd2.html b/pr-preview/pr-589/dir_672562f1eb3ea0be7f3aa3e89e72ecd2.html new file mode 100644 index 000000000..8527c5381 --- /dev/null +++ b/pr-preview/pr-589/dir_672562f1eb3ea0be7f3aa3e89e72ecd2.html @@ -0,0 +1,124 @@ + + + + + engine/renderer/pps/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_6c897dd97bedf3914ee8a4d9f7f6549c.html b/pr-preview/pr-589/dir_6c897dd97bedf3914ee8a4d9f7f6549c.html new file mode 100644 index 000000000..cd70e3bda --- /dev/null +++ b/pr-preview/pr-589/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 reflection/
+
Reflection module.
+
directory ui/
+
User Interface module.
+
+
+
+

Files

+
+
file log.hpp
+
Logging and assertion macros.
+
file thread_pool.hpp
+
Class cubos::core::ThreadPool.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_7376bacbd9e6243f425bd4c56d48edd9.html b/pr-preview/pr-589/dir_7376bacbd9e6243f425bd4c56d48edd9.html new file mode 100644 index 000000000..d2ad75490 --- /dev/null +++ b/pr-preview/pr-589/dir_7376bacbd9e6243f425bd4c56d48edd9.html @@ -0,0 +1,124 @@ + + + + + core/io/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_73cd920be1d9b25db5feb4d2a202c641.html b/pr-preview/pr-589/dir_73cd920be1d9b25db5feb4d2a202c641.html new file mode 100644 index 000000000..b2b48488e --- /dev/null +++ b/pr-preview/pr-589/dir_73cd920be1d9b25db5feb4d2a202c641.html @@ -0,0 +1,118 @@ + + + + + core/reflection/external/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/reflection/external/ directory +

+

Reflection declarations for external types.

+ +
+

Files

+
+
file primitives.hpp
+
Reflection declarations for primitive types.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_764b6913e5a035b506325f3918f13ed7.html b/pr-preview/pr-589/dir_764b6913e5a035b506325f3918f13ed7.html new file mode 100644 index 000000000..77ef6d94a --- /dev/null +++ b/pr-preview/pr-589/dir_764b6913e5a035b506325f3918f13ed7.html @@ -0,0 +1,118 @@ + + + + + engine/tools/world_inspector/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_79f402fdd7bbb1d73f9fd1aa85f618da.html b/pr-preview/pr-589/dir_79f402fdd7bbb1d73f9fd1aa85f618da.html new file mode 100644 index 000000000..653213c4c --- /dev/null +++ b/pr-preview/pr-589/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-589/dir_85f1b5bc6fb8e602e74068211760bfae.html b/pr-preview/pr-589/dir_85f1b5bc6fb8e602e74068211760bfae.html new file mode 100644 index 000000000..d27f361b8 --- /dev/null +++ b/pr-preview/pr-589/dir_85f1b5bc6fb8e602e74068211760bfae.html @@ -0,0 +1,120 @@ + + + + + core/reflection/traits/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_8711f680e2d25dedddc79c2be2b1fda2.html b/pr-preview/pr-589/dir_8711f680e2d25dedddc79c2be2b1fda2.html new file mode 100644 index 000000000..32eea7d1a --- /dev/null +++ b/pr-preview/pr-589/dir_8711f680e2d25dedddc79c2be2b1fda2.html @@ -0,0 +1,120 @@ + + + + + engine/settings/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_87a7847ee77970235330560d79c37ce0.html b/pr-preview/pr-589/dir_87a7847ee77970235330560d79c37ce0.html new file mode 100644 index 000000000..d844788e3 --- /dev/null +++ b/pr-preview/pr-589/dir_87a7847ee77970235330560d79c37ce0.html @@ -0,0 +1,140 @@ + + + + + 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 directional_light.hpp
+
Component cubos::engine::DirectionalLight.
+
file environment.hpp
+
Resource cubos::engine::RendererEnvironment.
+
file frame.hpp
+
Resource cubos::engine::RendererFrame.
+
file plugin.hpp
+
Plugin entry point, resource cubos::engine::ActiveCameras and components cubos::engine::RenderableGrid and cubos::engine::Camera.
+
file point_light.hpp
+
Component cubos::engine::PointLight.
+
file renderer.hpp
+
Class cubos::engine::BaseRenderer and resource cubos::engine::Renderer.
+
file spot_light.hpp
+
Component cubos::engine::SpotLight.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_8b12085945cef5a7cea7b856ed1ac7f6.html b/pr-preview/pr-589/dir_8b12085945cef5a7cea7b856ed1ac7f6.html new file mode 100644 index 000000000..4195173ff --- /dev/null +++ b/pr-preview/pr-589/dir_8b12085945cef5a7cea7b856ed1ac7f6.html @@ -0,0 +1,118 @@ + + + + + engine/tools/scene_editor/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_8e5f84d20b1aa89c94160461e78e26c4.html b/pr-preview/pr-589/dir_8e5f84d20b1aa89c94160461e78e26c4.html new file mode 100644 index 000000000..1e6b28fb7 --- /dev/null +++ b/pr-preview/pr-589/dir_8e5f84d20b1aa89c94160461e78e26c4.html @@ -0,0 +1,126 @@ + + + + + engine/input/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_95549d37735ad5b142799f042eef0d37.html b/pr-preview/pr-589/dir_95549d37735ad5b142799f042eef0d37.html new file mode 100644 index 000000000..92f6310fa --- /dev/null +++ b/pr-preview/pr-589/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-589/dir_9b04cf786b414c0d644db09287f665e6.html b/pr-preview/pr-589/dir_9b04cf786b414c0d644db09287f665e6.html new file mode 100644 index 000000000..27879f035 --- /dev/null +++ b/pr-preview/pr-589/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-589/dir_9bdaf8f561be1ffd03f616379797b70b.html b/pr-preview/pr-589/dir_9bdaf8f561be1ffd03f616379797b70b.html new file mode 100644 index 000000000..255655a31 --- /dev/null +++ b/pr-preview/pr-589/dir_9bdaf8f561be1ffd03f616379797b70b.html @@ -0,0 +1,130 @@ + + + + + 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 move.hpp
+
Function cubos::core::memory::move.
+
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-589/dir_b6daa990b896c2c0c53126427e4d978d.html b/pr-preview/pr-589/dir_b6daa990b896c2c0c53126427e4d978d.html new file mode 100644 index 000000000..d934b8412 --- /dev/null +++ b/pr-preview/pr-589/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-589/dir_bafb7af0e03e95b24a45ff63060ab57b.html b/pr-preview/pr-589/dir_bafb7af0e03e95b24a45ff63060ab57b.html new file mode 100644 index 000000000..c84d8c68d --- /dev/null +++ b/pr-preview/pr-589/dir_bafb7af0e03e95b24a45ff63060ab57b.html @@ -0,0 +1,146 @@ + + + + + engine/ directory | CUBOS. + + + + + + + +
+
+
+
+
+

+ engine/ directory +

+

Engine module.

+ +
+

Directories

+
+
directory assets/
+
Assets plugin directory.
+
directory collisions/
+
Collisions 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 settings/
+
Settings 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-589/dir_bd9be39c2ccf4132268583193b02b48c.html b/pr-preview/pr-589/dir_bd9be39c2ccf4132268583193b02b48c.html new file mode 100644 index 000000000..9e37c155c --- /dev/null +++ b/pr-preview/pr-589/dir_bd9be39c2ccf4132268583193b02b48c.html @@ -0,0 +1,122 @@ + + + + + engine/assets/bridges/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_c185369e92e3603c6d00fa8343148da7.html b/pr-preview/pr-589/dir_c185369e92e3603c6d00fa8343148da7.html new file mode 100644 index 000000000..2b1a29bcb --- /dev/null +++ b/pr-preview/pr-589/dir_c185369e92e3603c6d00fa8343148da7.html @@ -0,0 +1,128 @@ + + + + + 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 scene_editor/
+
Scene editor plugin directory.
+
directory settings_inspector/
+
Settings inspector plugin directory.
+
directory world_inspector/
+
World inspector plugin directory.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_c1deef5baf41393ad8a994c3fd53e62f.html b/pr-preview/pr-589/dir_c1deef5baf41393ad8a994c3fd53e62f.html new file mode 100644 index 000000000..5b393d166 --- /dev/null +++ b/pr-preview/pr-589/dir_c1deef5baf41393ad8a994c3fd53e62f.html @@ -0,0 +1,124 @@ + + + + + core/geom/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_c396301357880712663814927d68a432.html b/pr-preview/pr-589/dir_c396301357880712663814927d68a432.html new file mode 100644 index 000000000..bf1dab929 --- /dev/null +++ b/pr-preview/pr-589/dir_c396301357880712663814927d68a432.html @@ -0,0 +1,118 @@ + + + + + engine/tools/asset_explorer/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_c4311188e9cc606330f5e3e0b9dd5059.html b/pr-preview/pr-589/dir_c4311188e9cc606330f5e3e0b9dd5059.html new file mode 100644 index 000000000..8a96ee4a6 --- /dev/null +++ b/pr-preview/pr-589/dir_c4311188e9cc606330f5e3e0b9dd5059.html @@ -0,0 +1,132 @@ + + + + + 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 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-589/dir_d0ac2003a3c19c21d7ab7ff2f06fbec3.html b/pr-preview/pr-589/dir_d0ac2003a3c19c21d7ab7ff2f06fbec3.html new file mode 100644 index 000000000..abf658077 --- /dev/null +++ b/pr-preview/pr-589/dir_d0ac2003a3c19c21d7ab7ff2f06fbec3.html @@ -0,0 +1,118 @@ + + + + + engine/tools/entity_inspector/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_db86702e1371d7558db3699dd3786a14.html b/pr-preview/pr-589/dir_db86702e1371d7558db3699dd3786a14.html new file mode 100644 index 000000000..5f39d61d2 --- /dev/null +++ b/pr-preview/pr-589/dir_db86702e1371d7558db3699dd3786a14.html @@ -0,0 +1,130 @@ + + + + + engine/collisions/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_e42c9d7813efab99826f1cb60398c3fa.html b/pr-preview/pr-589/dir_e42c9d7813efab99826f1cb60398c3fa.html new file mode 100644 index 000000000..d31748b3a --- /dev/null +++ b/pr-preview/pr-589/dir_e42c9d7813efab99826f1cb60398c3fa.html @@ -0,0 +1,118 @@ + + + + + engine/tools/settings_inspector/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_f4414684a5bb1e1b8e9ba236e8bdb594.html b/pr-preview/pr-589/dir_f4414684a5bb1e1b8e9ba236e8bdb594.html new file mode 100644 index 000000000..04fd3c77a --- /dev/null +++ b/pr-preview/pr-589/dir_f4414684a5bb1e1b8e9ba236e8bdb594.html @@ -0,0 +1,130 @@ + + + + + core/reflection/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_f556bbe30cd07922836d0e9d7f5fa0a5.html b/pr-preview/pr-589/dir_f556bbe30cd07922836d0e9d7f5fa0a5.html new file mode 100644 index 000000000..0a880aa67 --- /dev/null +++ b/pr-preview/pr-589/dir_f556bbe30cd07922836d0e9d7f5fa0a5.html @@ -0,0 +1,122 @@ + + + + + core/ui/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dir_f6f65ff657bd34b22e5078310628f4e7.html b/pr-preview/pr-589/dir_f6f65ff657bd34b22e5078310628f4e7.html new file mode 100644 index 000000000..a792ae5d3 --- /dev/null +++ b/pr-preview/pr-589/dir_f6f65ff657bd34b22e5078310628f4e7.html @@ -0,0 +1,118 @@ + + + + + core/al/ directory | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/directional__light_8hpp.html b/pr-preview/pr-589/directional__light_8hpp.html new file mode 100644 index 000000000..9335f66e1 --- /dev/null +++ b/pr-preview/pr-589/directional__light_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/renderer/directional_light.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/dispatcher_8hpp.html b/pr-preview/pr-589/dispatcher_8hpp.html new file mode 100644 index 000000000..ea18e0c50 --- /dev/null +++ b/pr-preview/pr-589/dispatcher_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/ecs/dispatcher.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/ecs_8hpp.html b/pr-preview/pr-589/ecs_8hpp.html new file mode 100644 index 000000000..ec97c4850 --- /dev/null +++ b/pr-preview/pr-589/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-589/embedded__archive_8hpp.html b/pr-preview/pr-589/embedded__archive_8hpp.html new file mode 100644 index 000000000..015d48060 --- /dev/null +++ b/pr-preview/pr-589/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-589/endianness_8hpp.html b/pr-preview/pr-589/endianness_8hpp.html new file mode 100644 index 000000000..3bff84ecc --- /dev/null +++ b/pr-preview/pr-589/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-589/engine_2include_2cubos_2engine_2assets_2bridges_2file_8hpp.html b/pr-preview/pr-589/engine_2include_2cubos_2engine_2assets_2bridges_2file_8hpp.html new file mode 100644 index 000000000..c17480299 --- /dev/null +++ b/pr-preview/pr-589/engine_2include_2cubos_2engine_2assets_2bridges_2file_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/assets/bridges/file.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2box_8hpp.html b/pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2box_8hpp.html new file mode 100644 index 000000000..8f68bab3e --- /dev/null +++ b/pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2box_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/collisions/colliders/box.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2capsule_8hpp.html b/pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2capsule_8hpp.html new file mode 100644 index 000000000..e917e5e49 --- /dev/null +++ b/pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2capsule_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/collisions/colliders/capsule.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2plane_8hpp.html b/pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2plane_8hpp.html new file mode 100644 index 000000000..856093954 --- /dev/null +++ b/pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2plane_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/collisions/colliders/plane.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2simplex_8hpp.html b/pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2simplex_8hpp.html new file mode 100644 index 000000000..274937d9a --- /dev/null +++ b/pr-preview/pr-589/engine_2include_2cubos_2engine_2collisions_2colliders_2simplex_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/collisions/colliders/simplex.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/entity__manager_8hpp.html b/pr-preview/pr-589/entity__manager_8hpp.html new file mode 100644 index 000000000..aa5594f79 --- /dev/null +++ b/pr-preview/pr-589/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-589/environment_8hpp.html b/pr-preview/pr-589/environment_8hpp.html new file mode 100644 index 000000000..a682ce836 --- /dev/null +++ b/pr-preview/pr-589/environment_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/renderer/environment.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/event__pipe_8hpp.html b/pr-preview/pr-589/event__pipe_8hpp.html new file mode 100644 index 000000000..7f66c0e4f --- /dev/null +++ b/pr-preview/pr-589/event__pipe_8hpp.html @@ -0,0 +1,133 @@ + + + + + core/ecs/event_pipe.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/event__reader_8hpp.html b/pr-preview/pr-589/event__reader_8hpp.html new file mode 100644 index 000000000..125d85698 --- /dev/null +++ b/pr-preview/pr-589/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-589/event__writer_8hpp.html b/pr-preview/pr-589/event__writer_8hpp.html new file mode 100644 index 000000000..704725b78 --- /dev/null +++ b/pr-preview/pr-589/event__writer_8hpp.html @@ -0,0 +1,133 @@ + + + + + core/ecs/event_writer.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/examples-core-logging.html b/pr-preview/pr-589/examples-core-logging.html new file mode 100644 index 000000000..a1582a1bc --- /dev/null +++ b/pr-preview/pr-589/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-589/examples-core-reflection-basic.html b/pr-preview/pr-589/examples-core-reflection-basic.html new file mode 100644 index 000000000..636d720ce --- /dev/null +++ b/pr-preview/pr-589/examples-core-reflection-basic.html @@ -0,0 +1,136 @@ + + + + + Examples » Core » Reflection » Basic Usage | CUBOS. + + + + + + + +
+
+
+
+
+

+ Examples » + Core » + Reflection » + Basic Usage +

+

Defining and using reflectable types.

+

Lets say you have a type Person, which you want to be able to reflect. You can declare it as reflectable using the macro CUBOS_REFLECT, for example, in your header, like this:

#include <cubos/core/reflection/reflect.hpp>
+
+struct Person
+{
+    CUBOS_REFLECT;
+    int age;
+    float weight;
+};

The file core/reflection/reflect.hpp is a very lightweight header which you should include when declaring types as reflectable. It only defines the reflection macros and the reflection function. Avoid including other unnecessary reflection headers, which might be heavier, in order to reduce compile times.

In your source file, you must define the reflection data for your type. This is done through the CUBOS_REFLECT_IMPL macro:

#include <cubos/core/reflection/type.hpp>
+
+using cubos::core::reflection::Type;
+
+CUBOS_REFLECT_IMPL(Person)
+{
+    return Type::create("Person");
+}

To access this reflection data, you should use the cubos::core::reflection::reflect function, which is also defined in the core/reflection/reflect.hpp header.

int main()
+{
+    using cubos::core::reflection::reflect;
+
+    const auto& personType = reflect<Person>();
+    CUBOS_ASSERT(personType.name() == "Person");

Lets say you want to associate your own data to your types, to describe them further. For example, imagine you're making a GUI editor for your game and you which to display the fields of your types in a tree view, with different colors for different types. You could associate colors to your types by defining a trait:

struct ColorTrait
+{
+    float r, g, b;
+};

Now, when you define your type reflection, you add your trait with the Type::with method.

CUBOS_REFLECT_IMPL(Position)
+{
+    return Type::create("Position").with(ColorTrait{.r = 0.0F, .g = 1.0F, .b = 0.0F});
+}

To check if a type has a trait, you use the Type::has method.

    const auto& positionType = reflect<Position>();
+    CUBOS_ASSERT(positionType.has<ColorTrait>());
+    CUBOS_ASSERT(!personType.has<ColorTrait>());

To actually access the trait data, you use the Type::get method.

    const auto& colorTrait = positionType.get<ColorTrait>();
+    CUBOS_ASSERT(colorTrait.r == 0.0F);
+    CUBOS_ASSERT(colorTrait.g == 1.0F);
+    CUBOS_ASSERT(colorTrait.b == 0.0F);
+    return 0;
+}
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/examples-core-reflection-traits-constructible.html b/pr-preview/pr-589/examples-core-reflection-traits-constructible.html new file mode 100644 index 000000000..211fe2c2e --- /dev/null +++ b/pr-preview/pr-589/examples-core-reflection-traits-constructible.html @@ -0,0 +1,131 @@ + + + + + Examples » Core » Reflection » Constructible Trait | CUBOS. + + + + + + + +
+
+
+
+
+

+ Examples » + Core » + Reflection » + Constructible Trait +

+

Exposing the destructor and constructors of a type.

+

You may find it useful while working with type-erased data to be able to create copies of the data, destroy it, or move it around. The ConstructibleTrait trait exposes the size, alignment, destructor and constructors of a type.

Lets say you have a type Scale, which you want to be able to reflect, with a default value of 1.0:

#include <cubos/core/reflection/reflect.hpp>
+
+struct Scale
+{
+    CUBOS_REFLECT;
+    float value = 1.0F;
+};

We're going to add the ConstructibleTrait trait to it, so that we can create instances of it at runtime:

#include <cubos/core/reflection/traits/constructible.hpp>
+#include <cubos/core/reflection/type.hpp>
+
+using cubos::core::reflection::ConstructibleTrait;
+using cubos::core::reflection::Type;
+
+CUBOS_REFLECT_IMPL(Scale)
+{
+    return Type::create("Scale").with(ConstructibleTrait::typed<Scale>().withDefaultConstructor().build());
+}

Now, we can access the trait from the reflected type:

int main()
+{
+    using cubos::core::reflection::reflect;
+
+    const auto& scaleType = reflect<Scale>();
+    CUBOS_ASSERT(scaleType.has<ConstructibleTrait>());
+    const auto& constructible = scaleType.get<ConstructibleTrait>();

Imagine for a moment that you don't know the type of the data you're working, and you only have access to its reflection data through scaleType. If you want to create a default instance of the type, you can call the default constructor stored in the trait:

    // Allocate memory for the instance and default-construct it.
+    void* instance = operator new(constructible.size());
+    CUBOS_ASSERT(constructible.defaultConstruct(instance));
+    CUBOS_ASSERT(static_cast<Scale*>(instance)->value == 1.0F);

The defaultConstruct method returns a boolean which indicates if the type has a default constructor or not. In this case, since we added the default constructor to the trait, it will return true.

This could be useful, for example, to fallback from using moveConstruct to copyConstruct, if the first isn't available.

Don't forget to destroy the instance manually when you're done with it:

    // Destroy the instance and deallocate its memory.
+    constructible.destruct(instance);
+    operator delete(instance);
+}
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/examples-core-reflection.html b/pr-preview/pr-589/examples-core-reflection.html new file mode 100644 index 000000000..dd8459b8f --- /dev/null +++ b/pr-preview/pr-589/examples-core-reflection.html @@ -0,0 +1,103 @@ + + + + + Examples » Core » Reflection | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/examples-core.html b/pr-preview/pr-589/examples-core.html new file mode 100644 index 000000000..885df1aa3 --- /dev/null +++ b/pr-preview/pr-589/examples-core.html @@ -0,0 +1,102 @@ + + + + + Examples » Core | CUBOS. + + + + + + + +
+
+
+
+
+

+ Examples » + Core +

+

Showcases features of the Core library.

+

The following examples have fully documented tutorials:

+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/examples-engine-assets-bridge.html b/pr-preview/pr-589/examples-engine-assets-bridge.html new file mode 100644 index 000000000..79bb36bf0 --- /dev/null +++ b/pr-preview/pr-589/examples-engine-assets-bridge.html @@ -0,0 +1,146 @@ + + + + + Examples » Engine » Assets » Introducion and Custom Bridges | CUBOS. + + + + + + + +
+
+
+
+
+

+ Examples » + Engine » + Assets » + Introducion and Custom Bridges +

+

Basic Assets plugin features and creating your own bridges.

+

This example demonstrates how we can create a custom asset bridge to load assets of a given type. More specifically, we'll go through how we can create a bridge which loads std::strings from text files.

We define our bridge class by inheriting from cubos::engine::FileBridge, which offers a simple interface for loading and saving assets from files.

class TextBridge : public FileBridge
+{
+public:
+    TextBridge()
+        : FileBridge(typeid(std::string))
+    {
+    }

We pass typeid(std::string) to the base class, so that the engine knows which type of assets this bridge can load. Then, we'll need to implement both the loadFromFile and saveToFile methods.

In the first method, we receive the assets manager where we should store the loaded data, the handle to the asset we're loading, and a stream to read the file data from.

    bool loadFromFile(Assets& assets, const AnyAsset& handle, Stream& stream) override
+    {
+        // Dump the file's contents into a string.
+        std::string contents;
+        stream.readUntil(contents, nullptr);
+
+        // Store the asset's data.
+        assets.store(handle, std::move(contents));
+        return true;
+    }

In the second method, we receive the assets manager, the handle to the asset we're saving, and a stream to write the file data to.

    bool saveToFile(const Assets& assets, const AnyAsset& handle, Stream& stream) override
+    {
+        // Get the asset's data.
+        auto contents = assets.read<std::string>(handle);
+
+        // Write the data to the file.
+        stream.print(*contents);
+        return true;
+    }
+};

Now that we have our bridge type, we must register it with the assets manager before using it.

static void bridgeSystem(Write<Assets> assets)
+{
+    // Add a custom bridge to load .txt files.
+    assets->registerBridge(".txt", std::make_unique<TextBridge>());
+}

After this system runs, any time we load an asset whose path ends with .txt, the assets manager will use our bridge to load it.

In this sample we have a file sample.txt on the assets/ directory containing the following text:

How are you holding up?
+Because I'm a potato
+<clap clap clap>

We also have a file sample.txt.meta, which describes the asset for the engine. In this case, we only need to specify its UUID, which was generated on a UUID generator website:

{
+    "id": "6f42ae5a-59d1-5df3-8720-83b8df6dd536"
+}

Then, we can load it from our code:

// Assets are identified through UUIDs which are defined in their .meta files.
+static const Asset<std::string> SampleAsset = AnyAsset("6f42ae5a-59d1-5df3-8720-83b8df6dd536");
+
+static void loadSystem(Read<Assets> assets)
+{
+    // Access the text asset - will be loaded automatically.
+    auto text = assets->read(SampleAsset);
+    Stream::stdOut.print(*text);
+}

Some care must be taken when registering bridges or loading assets during the startup phase. Systems which add bridges should be tagged with cubos.assets.bridge so that they run before any assets are loaded. Similarly, startup systems which load assets should be tagged with cubos.assets so that they run after all bridges have been registered.

    cubos.addPlugin(assetsPlugin);
+    cubos.startupSystem(bridgeSystem).tagged("cubos.assets.bridge");
+    cubos.startupSystem(loadSystem).tagged("cubos.assets");
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/examples-engine-assets-json.html b/pr-preview/pr-589/examples-engine-assets-json.html new file mode 100644 index 000000000..3a5401d36 --- /dev/null +++ b/pr-preview/pr-589/examples-engine-assets-json.html @@ -0,0 +1,135 @@ + + + + + Examples » Engine » Assets » Loading Serializable Assets | CUBOS. + + + + + + + +
+
+
+
+
+

+ Examples » + Engine » + Assets » + Loading Serializable Assets +

+

Loading serializable assets from JSON.

+

We'll use the following type as an example:

struct Strings
+{
+    std::vector<std::string> strings;
+};

We can make it serializable by implementing the following specializations:

template <>
+void cubos::core::data::serialize<Strings>(Serializer& ser, const Strings& obj, const char* name)
+{
+    ser.beginObject(name);
+    ser.write(obj.strings, "strings");
+    ser.endObject();
+}
+
+template <>
+void cubos::core::data::deserialize<Strings>(Deserializer& des, Strings& obj)
+{
+    des.beginObject();
+    des.read(obj.strings);
+    des.endObject();
+}

Then, we must register a bridge for this type. We provide JSONBridge for easily loading and saving serializable assets as JSON.

static void bridgeSystem(Write<Assets> assets)
+{
+    assets->registerBridge(".strings", std::make_unique<JSONBridge<Strings>>());
+}

With the bridge registered, we can just load it from its handle:

static const Asset<Strings> SampleAsset = AnyAsset("6f42ae5a-59d1-5df3-8720-83b8df6dd536");
+
+static void loadSystem(Write<Assets> assets)
+{
+    auto read = assets->read(SampleAsset);
+    for (const auto& str : read->strings)
+    {
+        Stream::stdOut.printf("String: {}\n", str);
+    }
+}

These sytems are configured the usual way, as explained in Introducion and Custom Bridges.

    cubos.addPlugin(assetsPlugin);
+    cubos.startupSystem(bridgeSystem).tagged("cubos.assets.bridge");
+    cubos.startupSystem(loadSystem).tagged("cubos.assets");
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/examples-engine-assets-saving.html b/pr-preview/pr-589/examples-engine-assets-saving.html new file mode 100644 index 000000000..9b063697f --- /dev/null +++ b/pr-preview/pr-589/examples-engine-assets-saving.html @@ -0,0 +1,115 @@ + + + + + Examples » Engine » Assets » Creating and Saving | CUBOS. + + + + + + + +
+
+
+
+
+

+ Examples » + Engine » + Assets » + Creating and Saving +

+

Creating and saving assets.

+

This example demonstrates how a new asset be created programatically and how it can be saved to the assets directory, which is useful while working on tools such as TESSERATOS.

Before we go any further, if we want to save assets to the filesystem, we must allow assets to be modified. This is done through the following setting:

static void configSystem(Write<Settings> settings)
+{
+    // If we want to save assets, we must set this to false.
+    settings->setBool("assets.io.readOnly", false);

We'll use the following asset type as an example, with a JSONBridge registered for it with the extension .int.

struct IntegerAsset
+{
+    int value;
+};

First, we'll create an asset of this type:

static void saveSystem(Write<Assets> assets)
+{
+    // Create a new asset (with a random UUID).
+    auto handle = assets->create(IntegerAsset{1337});

Then, we'll assign it a path and save it. Its important that the path ends with the correct extension, so that Assets knows which bridge to use when loading it.

    assets->writeMeta(handle)->set("path", "/assets/sample/sample.int");
+    assets->save(handle);

With this, the files sample/sample.int and sample/sample.int.meta should have appeared on the assets/ directory. The .meta file contains the UUID of the asset, which is used by the engine to identify it.

Finally, the engine is configured the following way:

    cubos.addPlugin(assetsPlugin);
+    cubos.startupSystem(saveSystem).tagged("cubos.assets");

Try running the sample yourself to see the files being created!

+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/examples-engine-assets.html b/pr-preview/pr-589/examples-engine-assets.html new file mode 100644 index 000000000..b7d76fc7c --- /dev/null +++ b/pr-preview/pr-589/examples-engine-assets.html @@ -0,0 +1,103 @@ + + + + + Examples » Engine » Assets | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/examples-engine-renderer.html b/pr-preview/pr-589/examples-engine-renderer.html new file mode 100644 index 000000000..62b8818e9 --- /dev/null +++ b/pr-preview/pr-589/examples-engine-renderer.html @@ -0,0 +1,150 @@ + + + + + Examples » Engine » Renderer | CUBOS. + + + + + + + +
+
+
+
+
+

+ Examples » + Engine » + Renderer +

+

Using the Renderer plugin.

+

This example shows how the Renderer plugin can be used and configured with a simple scene, lighting and split-screen rendering.

Image

The plugin function is included from the engine/renderer/plugin.hpp header. You may need to include other headers, depending on what you want to access.

    cubos.addPlugin(rendererPlugin);

The first thing we're going to worry about is setting the Palette the renderer will use. This palette would usually be loaded from a file, but for this example we'll just create it manually.

static void setPaletteSystem(Write<Renderer> renderer)
+{
+    using cubos::core::gl::Palette;
+
+    // Create a simple palette with 3 materials (red, green and blue).
+    (*renderer)->setPalette(Palette{{
+        {{1, 0, 0, 1}},
+        {{0, 1, 0, 1}},
+        {{0, 0, 1, 1}},
+    }});
+}

We should also spawn a voxel grid, so we have something to render.

static void spawnVoxelGridSystem(Commands commands, Write<Assets> assets)
+{
+    using cubos::core::gl::Grid;
+
+    // Create a 2x2x2 grid whose voxels alternate between the materials defined in the palette.
+    auto gridAsset = assets->create(Grid{{2, 2, 2}, {1, 2, 3, 1, 2, 3, 1, 2}});
+
+    // Spawn an entity with a renderable grid component and a identity transform.
+    commands.create(RenderableGrid{gridAsset, {-1.0F, 0.0F, -1.0F}}, LocalToWorld{});
+}

If we don't add any lights, the scene will be completely dark. Lets add a simple PointLight.

static void spawnLightSystem(Commands commands)
+{
+    // Spawn a point light.
+    commands.create()
+        .add(PointLight{.color = {1.0F, 1.0F, 1.0F}, .intensity = 1.0F, .range = 10.0F})
+        .add(Position{{1.0F, 3.0F, -2.0F}});
+}

We can also add some ambient lighting, and even add a sky gradient, through the RendererEnvironment resource.

static void setEnvironmentSystem(Write<RendererEnvironment> env)
+{
+    env->ambient = {0.2F, 0.2F, 0.2F};
+    env->skyGradient[0] = {0.1F, 0.2F, 0.4F};
+    env->skyGradient[1] = {0.6F, 0.6F, 0.8F};
+}

Lastly, without a camera, we won't be able to see anything. Cameras can be set using the ActiveCameras resource.

static void spawnCamerasSystem(Commands commands, Write<ActiveCameras> camera)
+{
+    // Spawn the a camera entity for the first viewport.
+    camera->entities[0] =
+        commands.create()
+            .add(Camera{.fovY = 60.0F, .zNear = 0.1F, .zFar = 100.0F})
+            .add(Position{{-3.0, 1.0F, -3.0F}})
+            .add(Rotation{glm::quatLookAt(glm::normalize(glm::vec3{1.0F, 0.0F, 1.0F}), glm::vec3{0.0F, 1.0F, 0.0F})})
+            .entity();
+
+    // Add two other viewports using the same camera, which splits the screen in three.
+    camera->entities[1] = camera->entities[0];
+    camera->entities[2] = camera->entities[0];
+}

Then, its just a matter of adding these systems to the engine. The only one which requires special attention is the setPaletteSystem. This system accesses the Renderer resource, which is only initialized on the tag cubos.renderer.init.

    cubos.startupSystem(setPaletteSystem).after("cubos.renderer.init");
+    cubos.startupSystem(spawnVoxelGridSystem);
+    cubos.startupSystem(spawnLightSystem);
+    cubos.startupSystem(setEnvironmentSystem);
+    cubos.startupSystem(spawnCamerasSystem);
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/examples-engine-scene.html b/pr-preview/pr-589/examples-engine-scene.html new file mode 100644 index 000000000..f932f941f --- /dev/null +++ b/pr-preview/pr-589/examples-engine-scene.html @@ -0,0 +1,134 @@ + + + + + Examples » Engine » Scene | CUBOS. + + + + + + + +
+
+
+
+
+

+ Examples » + Engine » + Scene +

+

Using the Scene plugin.

+

This example shows how the Scene plugin can be used to create scene assets and spawn them on the world.

The plugin function is included from the engine/scene/plugin.hpp header.

    cubos.addPlugin(scenePlugin);

Let's start by taking a look at a scene file.

{
+  "imports": {},
+  "entities": {
+    "root": {
+      "num": 1
+    },
+    "child": {
+      "num": 2,
+      "parent": "root"
+    }
+  }
+}

Scene files are JSON files with the extension .cubos. They must have two fields: imports and entities. The entities field is an object where each field identifies and describes the components of an entity. In this scene we have two entities, root and child. root has a single component, num, with a value of 1. child has two components, a parent and a num. In this sample, num is used so we can later identify the entities.

Let's look at a different scene file now, this time with imports. Imports allows us to instantiate scenes within other scenes.

{
+  "imports": {
+    "sub1": "cd007ba2-ee0d-44fd-bf36-85c829dbe66f",
+    "sub2": "cd007ba2-ee0d-44fd-bf36-85c829dbe66f"
+  },
+  "entities": {
+    "main": {
+      "num": 0
+    },
+    "sub1.root": {
+      "parent": "main"
+    },
+    "sub2.root": {
+      "parent": "main"
+    }
+  }
+}

This file imports the asset with id cd007ba2-ee0d-44fd-bf36-85c829dbe66f, which is the scene we looked at in the previous file, under the name sub1. It then imports the very same scene again, but this time with the name sub2 instead. This effectively instantiates the entities of the previous scene twice in this new scene, each with their names prefixed with either sub1. or sub2.

Under entities, we can override the entities in the sub-scenes to edit components or add new ones. For example, by referencing sub1.root we are making local changes to the root entity of that instance of the subscene. The result of the changes we make to both sub1.root and sub2.root is that the parent of these entities will be set to be the main entity.

Now that we have our scene file, let's get our application to load it. The first thing we're going to need is a reference to the scene asset. For the purposes of this sample we can simply use an hardcoded reference to the asset.

static const Asset<Scene> SceneAsset = AnyAsset("f0d86ba8-5f34-440f-a180-d9d12c8e8b91");

Then we'll need a system that spawns that scene. To do this we simply get the Scene object from the asset, and then spawn its entities. Commands::spawn will create in the world a copy of every entity defined in the scene's blueprint. It won't remove the entities already there, so if you want to close a scene, you'll have to do it yourself.

static void spawnScene(Commands commands, Read<Assets> assets)
+{
+    auto sceneRead = assets->read(SceneAsset);
+    commands.spawn(sceneRead->blueprint);
+}

In this case, we'll run this system at startup, since we want to spawn it a single time. Since it's a startup system, we'll have to tag it with cubos.assets to make sure it runs only after the scene bridge has been registered. On a real game, you could have, for example, a scene for an enemy which you spawn multiple times, instead of just once at startup.

    cubos.startupSystem(spawnScene).tagged("spawn").tagged("cubos.assets");

This sample will output the list of every entity in the scene, so you can check that everything is working as expected. If you run it, it should give you a list that has:

  • an entity with num set to 0, with no parent. This is the main entity.
  • two entities with num set to 1, with same parent, who has num set to 0. These are the root entities of each instance of the subscene.
  • two entities with num set to 2, with different parents, but both of them having num set to 1. These are the child entities of each instance of the subscene.
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/examples-engine-settings.html b/pr-preview/pr-589/examples-engine-settings.html new file mode 100644 index 000000000..3f037c3ae --- /dev/null +++ b/pr-preview/pr-589/examples-engine-settings.html @@ -0,0 +1,112 @@ + + + + + Examples » Engine » Settings | CUBOS. + + + + + + + +
+
+
+
+
+

+ Examples » + Engine » + Settings +

+

Using the Settings plugin.

+

This example shows how the Settings plugin can be used to load settings from a file and command-line arguments.

Accesing the settings is straightforward:

static void checkSettings(Write<Settings> settings)
+{
+    CUBOS_INFO("{}", settings->getString("greeting", "Hello!"));
+}

If the setting greetings has been set on the settings.json file next to the sample's executable, or if it has been passed as a command-line argument (e.g. ./engine-sample.settings --greetings "Hello, world!"), the sample will output that value. Otherwise, it will output Hello!, which we set as a default.

We want this system to run after the settings have been loaded, so we run it after the tag cubos.settings. Notice that if we want the command-line arguments to be loaded as settings, we need to pass argc and argv to the Cubos::Cubos(int, char**) constructor.

int main(int argc, char** argv)
+{
+    Cubos cubos{argc, argv};
+    cubos.addPlugin(settingsPlugin);
+    cubos.startupSystem(checkSettings).after("cubos.settings");
+    cubos.run();
+}
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/examples-engine.html b/pr-preview/pr-589/examples-engine.html new file mode 100644 index 000000000..30ca29c43 --- /dev/null +++ b/pr-preview/pr-589/examples-engine.html @@ -0,0 +1,102 @@ + + + + + Examples » Engine | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/examples.html b/pr-preview/pr-589/examples.html new file mode 100644 index 000000000..f4c814145 --- /dev/null +++ b/pr-preview/pr-589/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-589/favicon-dark.png b/pr-preview/pr-589/favicon-dark.png new file mode 100644 index 0000000000000000000000000000000000000000..c2498580c1aeb9dc13d311f1785319025ec8e299 GIT binary patch literal 380 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`EX7WqAsj$Z!;#Vf4nJ z@ErkR#;MwT(m+AU64!{5;QX|b^2DN4hVt@qz0ADq;^f4FRK5J7^x5xhq=1Tkdb&7< zSoGeV?5NFBC~>S_`|=i}-=YT7Padn`>b# z#-|U~KTAvL@1NW}Hzhmx)17mMt7=aCeXE+Tu9&=7S?5gnj;`}NclWK#&8=bGIZyxk=h6Uv70<|T%c?G1a5bK$ zvUi4y=d7&sa{sr>(>;Sq3ti{$JNRyL*!63ieM)Uzu6a?uGU+o`&g43#a^|ex=GfaQ zMT>lHbTFJ?l#{#7u&3NA<)*ff#AJqqNg@qFCx8CzWC;2`r~i!nImh){e;(_7S;cQs XpYeAO6X!QzATW5k`njxgN@xNAhZ>zq literal 0 HcmV?d00001 diff --git a/pr-preview/pr-589/features-ecs.html b/pr-preview/pr-589/features-ecs.html new file mode 100644 index 000000000..87e9440f5 --- /dev/null +++ b/pr-preview/pr-589/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-589/features-plugins.html b/pr-preview/pr-589/features-plugins.html new file mode 100644 index 000000000..ef6c8393e --- /dev/null +++ b/pr-preview/pr-589/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-589/features-quadrados.html b/pr-preview/pr-589/features-quadrados.html new file mode 100644 index 000000000..a42a181ca --- /dev/null +++ b/pr-preview/pr-589/features-quadrados.html @@ -0,0 +1,121 @@ + + + + + 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.

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.

+
« Plugins | Feature Guide
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/features.html b/pr-preview/pr-589/features.html new file mode 100644 index 000000000..4eb7a1b43 --- /dev/null +++ b/pr-preview/pr-589/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-589/file__stream_8hpp.html b/pr-preview/pr-589/file__stream_8hpp.html new file mode 100644 index 000000000..f4391be04 --- /dev/null +++ b/pr-preview/pr-589/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-589/file__system_8hpp.html b/pr-preview/pr-589/file__system_8hpp.html new file mode 100644 index 000000000..a2dfcbba7 --- /dev/null +++ b/pr-preview/pr-589/file__system_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/data/fs/file_system.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/files.html b/pr-preview/pr-589/files.html new file mode 100644 index 000000000..cd42d9d72 --- /dev/null +++ b/pr-preview/pr-589/files.html @@ -0,0 +1,395 @@ + + + + + CUBOS. + + + + + + + +
+
+
+
+
+

Files

+ + +
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/frame_8hpp.html b/pr-preview/pr-589/frame_8hpp.html new file mode 100644 index 000000000..2c8c6952d --- /dev/null +++ b/pr-preview/pr-589/frame_8hpp.html @@ -0,0 +1,134 @@ + + + + + engine/renderer/frame.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/gamepad_8hpp.html b/pr-preview/pr-589/gamepad_8hpp.html new file mode 100644 index 000000000..9955f3e38 --- /dev/null +++ b/pr-preview/pr-589/gamepad_8hpp.html @@ -0,0 +1,191 @@ + + + + + core/io/gamepad.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/io/gamepad.hpp file +

+

Struct Gref cubos::core::io::GamepadState and related enums.

+ +
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::io
+
Input and output module.
+
+
+
+

Classes

+
+
+ struct cubos::core::io::GamepadState +
+
Holds the state of a gamepad.
+
+
+
+

Enums

+
+
+ enum class GamepadButton { Invalid = -1, + A, + B, + X, + Y, + LBumper, + RBumper, + Back, + Start, + Guide, + LThumb, + RThumb, + Up, + Right, + Down, + Left, + Count } +
+
Gamepad buttons.
+
+ enum class GamepadAxis { Invalid = -1, + LX, + LY, + RX, + RY, + LTrigger, + RTrigger, + Count } +
+
Gamepad axes.
+
+
+
+

Functions

+
+
+ auto gamepadButtonToString(GamepadButton button) -> std::string +
+
Converts a GamepadButton enum to a string.
+
+ auto stringToGamepadButton(const std::string& str) -> GamepadButton +
+
Converts a string to a GamepadButton.
+
+ auto gamepadAxisToString(GamepadAxis axis) -> std::string +
+
Convert a GamepadAxis to a string.
+
+ auto stringToGamepadAxis(const std::string& str) -> GamepadAxis +
+
Convert a string to a GamepadAxis.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/getting-started.html b/pr-preview/pr-589/getting-started.html new file mode 100644 index 000000000..15f3dd0ab --- /dev/null +++ b/pr-preview/pr-589/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-589/grid_8hpp.html b/pr-preview/pr-589/grid_8hpp.html new file mode 100644 index 000000000..efe38bfd7 --- /dev/null +++ b/pr-preview/pr-589/grid_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/gl/grid.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/group__asset-explorer-tool-plugin.html b/pr-preview/pr-589/group__asset-explorer-tool-plugin.html new file mode 100644 index 000000000..ed76f1327 --- /dev/null +++ b/pr-preview/pr-589/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-589/group__assets-plugin.html b/pr-preview/pr-589/group__assets-plugin.html new file mode 100644 index 000000000..093f34222 --- /dev/null +++ b/pr-preview/pr-589/group__assets-plugin.html @@ -0,0 +1,294 @@ + + + + + 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 - startup systems which load assets should be tagged with this.

Tags

  • cubos.assets.cleanup - frees any assets no longer in use.

Dependencies

+
+

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-589/group__collisions-plugin.html b/pr-preview/pr-589/group__collisions-plugin.html new file mode 100644 index 000000000..e1b49d9d6 --- /dev/null +++ b/pr-preview/pr-589/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-589/group__core-al.html b/pr-preview/pr-589/group__core-al.html new file mode 100644 index 000000000..ba4ed02ba --- /dev/null +++ b/pr-preview/pr-589/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-589/group__core-data-fs.html b/pr-preview/pr-589/group__core-data-fs.html new file mode 100644 index 000000000..125dfdb60 --- /dev/null +++ b/pr-preview/pr-589/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-589/group__core-data.html b/pr-preview/pr-589/group__core-data.html new file mode 100644 index 000000000..82798189f --- /dev/null +++ b/pr-preview/pr-589/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-589/group__core-ecs.html b/pr-preview/pr-589/group__core-ecs.html new file mode 100644 index 000000000..08c58be31 --- /dev/null +++ b/pr-preview/pr-589/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-589/group__core-geom.html b/pr-preview/pr-589/group__core-geom.html new file mode 100644 index 000000000..b046d975c --- /dev/null +++ b/pr-preview/pr-589/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-589/group__core-gl.html b/pr-preview/pr-589/group__core-gl.html new file mode 100644 index 000000000..bb721785b --- /dev/null +++ b/pr-preview/pr-589/group__core-gl.html @@ -0,0 +1,1320 @@ + + + + + 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 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::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-589/group__core-io.html b/pr-preview/pr-589/group__core-io.html new file mode 100644 index 000000000..9682e00c2 --- /dev/null +++ b/pr-preview/pr-589/group__core-io.html @@ -0,0 +1,753 @@ + + + + + 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 gamepad.hpp
+
Struct Gref cubos::core::io::GamepadState and related enums.
+
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::GamepadState +
+
Holds the state of a gamepad.
+
+ 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.
+
+ struct cubos::core::io::GamepadConnectionEvent +
+
Event sent when a gamepad is connected or disconnected.
+
+ class cubos::core::io::BaseWindow +
+
Interface used to wrap low-level window API implementations.
+
+
+
+

Enums

+
+
+ enum class GamepadButton { Invalid = -1, + A, + B, + X, + Y, + LBumper, + RBumper, + Back, + Start, + Guide, + LThumb, + RThumb, + Up, + Right, + Down, + Left, + Count } +
+
Gamepad buttons.
+
+ enum class GamepadAxis { Invalid = -1, + LX, + LY, + RX, + RY, + LTrigger, + RTrigger, + Count } +
+
Gamepad axes.
+
+ 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, GamepadConnectionEvent> +
+
Variant that can hold any of the window events.
+
+ using Window = std::shared_ptr<BaseWindow> +
+
Handle to a window.
+
+
+
+

Functions

+
+
+ auto gamepadButtonToString(GamepadButton button) -> std::string +
+
Converts a GamepadButton enum to a string.
+
+ auto stringToGamepadButton(const std::string& str) -> GamepadButton +
+
Converts a string to a GamepadButton.
+
+ auto gamepadAxisToString(GamepadAxis axis) -> std::string +
+
Convert a GamepadAxis to a string.
+
+ auto stringToGamepadAxis(const std::string& str) -> GamepadAxis +
+
Convert a string to a GamepadAxis.
+
+ 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 GamepadButton +
#include <core/io/gamepad.hpp>
+

+

Gamepad buttons.

+
+
+

+ enum class GamepadAxis +
#include <core/io/gamepad.hpp>
+

+

Gamepad axes.

+
+
+

+ 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, GamepadConnectionEvent> +
#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 gamepadButtonToString(GamepadButton button) +
#include <core/io/gamepad.hpp>
+

+

Converts a GamepadButton enum to a string.

+ + + + + + + + + + + + + + + + +
Parameters
buttonButton to convert.
ReturnsString representation.
+
+
+

+ GamepadButton stringToGamepadButton(const std::string& str) +
#include <core/io/gamepad.hpp>
+

+

Converts a string to a GamepadButton.

+ + + + + + + + + + + + + + + + +
Parameters
strString to convert.
ReturnsButton.
+
+
+

+ std::string gamepadAxisToString(GamepadAxis axis) +
#include <core/io/gamepad.hpp>
+

+

Convert a GamepadAxis to a string.

+ + + + + + + + + + + + + + + + +
Parameters
axisAxis to convert.
ReturnsString representation.
+
+
+

+ GamepadAxis stringToGamepadAxis(const std::string& str) +
#include <core/io/gamepad.hpp>
+

+

Convert a string to a GamepadAxis.

+ + + + + + + + + + + + + + + + +
Parameters
strString to convert.
ReturnsAxis.
+
+
+

+ 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-589/group__core-memory.html b/pr-preview/pr-589/group__core-memory.html new file mode 100644 index 000000000..de06b15b5 --- /dev/null +++ b/pr-preview/pr-589/group__core-memory.html @@ -0,0 +1,460 @@ + + + + + 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 move.hpp
+
Function cubos::core::memory::move.
+
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.
+
+
template<typename T>
+ auto move(T&& value) -> RemoveReference<T>::Type&& +
+
Returns an R-value reference to the given value.
+
+
+
+

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.
+
+
+

+
#include <core/memory/move.hpp>
+
+ template<typename T> +
+ RemoveReference<T>::Type&& move(T&& value) +

+

Returns an R-value reference to the given value.

+ + + + + + + + + + + + + + + + + + + + + + + + + +
Template parameters
TValue type.
Parameters
valueValue to move.
ReturnsMoved value.
+ +
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/group__core-reflection.html b/pr-preview/pr-589/group__core-reflection.html new file mode 100644 index 000000000..b58c09335 --- /dev/null +++ b/pr-preview/pr-589/group__core-reflection.html @@ -0,0 +1,419 @@ + + + + + Core » Reflection module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Core » + Reflection module

+

Provides utilities useful for handling type-erased data.

+ + +
+

Files

+
+
file primitives.hpp
+
Reflection declarations for primitive types.
+
file reflect.hpp
+
Function cubos::core::reflection::reflect and related macros.
+
file constructible.hpp
+
Class cubos::core::reflection::ConstructibleTrait.
+
file constructible_utils.hpp
+
Utilities for cubos::core::reflection::ConstructibleTrait.
+
file type.hpp
+
Class cubos::core::reflection::Type.
+
+
+
+

Classes

+
+
+
template<typename T>
+ struct cubos::core::reflection::Reflect +
+
Defines the reflection function for the given type T.
+
+ class cubos::core::reflection::ConstructibleTrait +
+
Describes how a reflected type may be constructed and destructed.
+
+ class cubos::core::reflection::Type +
+
Describes a reflected type.
+
+
+
+

Functions

+
+
+
template<typename T>
+ auto reflect() -> const Type& +
+
Reflects the given type T.
+
+
template<typename T>
+ auto autoConstructibleTrait() -> ConstructibleTrait +
+
Returns a ConstructibleTrait with the default, copy and move constructors, set only if the type has them.
+
+
+
+

Defines

+
+
+ #define CUBOS_PACK(...) +
+
Helper macro used to pass arguments with commas to other macros, wrapped in parentheses.
+
+ #define CUBOS_REFLECT +
+
Declares a reflection method.
+
+ #define CUBOS_REFLECT_IMPL(T) +
+
Defines a reflection method.
+
+ #define CUBOS_REFLECT_EXTERNAL_DECL_TEMPLATE(T) +
+
Declares a specialization of cubos::core::reflection::Reflect for a templated type.
+
+ #define CUBOS_REFLECT_EXTERNAL_DECL(T) +
+
Declares a specialization of cubos::core::reflection::Reflect for a type.
+
+ #define CUBOS_REFLECT_EXTERNAL_IMPL(T) +
+
Implements a specialization of cubos::core::reflection::Reflect for a type.
+
+ #define CUBOS_REFLECT_EXTERNAL_TEMPLATE(args, + T) +
+
Both declares and implements a specialization of cubos::core::reflection::Reflect for a type.
+
+
+
+

Function documentation

+
+

+
#include <core/reflection/reflect.hpp>
+
+ template<typename T> +
+ const Type& reflect() +

+

Reflects the given type T.

+ + + + + + + + + + + + + + + + +
Template parameters
TType to reflect.
ReturnsType information.
+

Fails to compile if the type does not implement reflection, or, in the case of external types, if its reflection specialization has not been included.

Internally, this function stores a static instance of the reflection data for the given type. Thus the reflection data is only initialized once, the first time this function is called, which means that the returned reference can be safely used as an identifier for the type.

The reflection data is obtained by calling the Reflect<T>::type() function.

+
+
+

+
#include <core/reflection/traits/constructible_utils.hpp>
+
+ template<typename T> +
+ ConstructibleTrait autoConstructibleTrait() +

+

Returns a ConstructibleTrait with the default, copy and move constructors, set only if the type has them.

+ + + + + + + + + + + + + + + + +
Template parameters
TType.
ReturnsConstructibleTrait.
+ +
+
+
+

Define documentation

+
+

+ #define CUBOS_PACK(...) +
#include <core/reflection/reflect.hpp>
+

+

Helper macro used to pass arguments with commas to other macros, wrapped in parentheses.

+
#define FOO(T) T foo;
+FOO(int); // expands to int foo;
+FOO(std::map<int, int>); // error: too many arguments to macro 'FOO'
+
+// Instead, use CUBOS_PACK:
+#define FOO(T) CUBOS_PACK T foo;
+FOO((int)); // expands to CUBOS_PACK(int) foo, which expands to int foo;
+FOO((std::map<int, int>)); // expands to CUBOS_PACK(std::map<int, int>) foo, which expands to
+                           // std::map<int, int> foo;
+
+
+

+ #define CUBOS_REFLECT +
#include <core/reflection/reflect.hpp>
+

+

Declares a reflection method.

+
// my_type.hpp
+#include <cubos/core/reflection/reflect.hpp>
+
+struct MyType
+{
+    CUBOS_REFLECT; // declares `static const Type& reflect()`
+};
+
+
+

+ #define CUBOS_REFLECT_IMPL(T) +
#include <core/reflection/reflect.hpp>
+

+

Defines a reflection method.

+ + + + + + + + + + +
Parameters
TType to reflect.
+
// my_type.cpp
+#include "my_type.hpp"
+
+CUBOS_REFLECT_IMPL(MyType) // defines `const Type& MyType::reflect()`
+{
+    return /* create your type here */;
+}
+
+
+

+ #define CUBOS_REFLECT_EXTERNAL_DECL_TEMPLATE(T) +
#include <core/reflection/reflect.hpp>
+

+

Declares a specialization of cubos::core::reflection::Reflect for a templated type.

+ + + + + + + + + + +
Parameters
TType to reflect.
+
// templated_type_reflection.hpp
+#include <cubos/core/reflection/reflect.hpp>
+
+template <typename T>
+CUBOS_REFLECT_EXTERNAL_DECL_TEMPLATE(TemplatedType<T>);
+
+
+

+ #define CUBOS_REFLECT_EXTERNAL_DECL(T) +
#include <core/reflection/reflect.hpp>
+

+

Declares a specialization of cubos::core::reflection::Reflect for a type.

+ + + + + + + + + + +
Parameters
TType to reflect.
+
// not_my_type_reflection.hpp
+#include <cubos/core/reflection/reflect.hpp>
+
+CUBOS_REFLECT_EXTERNAL_DECL(NotMyType);
+
+
+

+ #define CUBOS_REFLECT_EXTERNAL_IMPL(T) +
#include <core/reflection/reflect.hpp>
+

+

Implements a specialization of cubos::core::reflection::Reflect for a type.

+ + + + + + + + + + +
Parameters
TType to reflect.
+
// not_my_type_reflection.cpp
+#include "not_my_type_reflection.hpp"
+
+CUBOS_REFLECT_EXTERNAL_IMPL(NotMyType)
+{
+    return /* create your type here */;
+}
// templated_type_reflection.hpp
+template <typename T>
+CUBOS_REFLECT_EXTERNAL_IMPL(TemplatedType<T>)
+{
+    return /* create your type here */;
+}
+
+
+

+ #define CUBOS_REFLECT_EXTERNAL_TEMPLATE(args, + T) +
#include <core/reflection/reflect.hpp>
+

+

Both declares and implements a specialization of cubos::core::reflection::Reflect for a type.

+ + + + + + + + + + + + + + +
Parameters
argsTemplate parameters, wrapped in parentheses.
TType to reflect, wrapped in parentheses.
+
// templated_type_reflection.hpp
+#include <cubos/core/reflection/reflect.hpp>
+
+CUBOS_REFLECT_EXTERNAL_TEMPLATE((typename T), (TemplatedType<T>))
+{
+    return /* create your type here */;
+}
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/group__core-ui.html b/pr-preview/pr-589/group__core-ui.html new file mode 100644 index 000000000..a8b3de2fa --- /dev/null +++ b/pr-preview/pr-589/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-589/group__core.html b/pr-preview/pr-589/group__core.html new file mode 100644 index 000000000..ead8e3a95 --- /dev/null +++ b/pr-preview/pr-589/group__core.html @@ -0,0 +1,528 @@ + + + + + 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 Reflection
+
Provides utilities useful for handling type-erased data.
+
module User Interface
+
Provides ImGui integration and general UI utilities.
+
+
+
+

Files

+
+
file log.hpp
+
Logging and assertion macros.
+
file thread_pool.hpp
+
Class cubos::core::ThreadPool.
+
+
+
+

Classes

+
+
+ 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-589/group__engine.html b/pr-preview/pr-589/group__engine.html new file mode 100644 index 000000000..7441edbc6 --- /dev/null +++ b/pr-preview/pr-589/group__engine.html @@ -0,0 +1,182 @@ + + + + + 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 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 Settings
+
Adds and manages settings.
+
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.
+
file settings.hpp
+
Class cubos::engine::Settings.
+
+
+
+

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 which stores the command-line 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.
+
+ class cubos::engine::Settings +
+
Stores settings as key-value pairs and provides methods to retrieve them.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/group__entity-inspector-tool-plugin.html b/pr-preview/pr-589/group__entity-inspector-tool-plugin.html new file mode 100644 index 000000000..8d0cd35fe --- /dev/null +++ b/pr-preview/pr-589/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-589/group__entity-selector-tool-plugin.html b/pr-preview/pr-589/group__entity-selector-tool-plugin.html new file mode 100644 index 000000000..604848038 --- /dev/null +++ b/pr-preview/pr-589/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-589/group__imgui-plugin.html b/pr-preview/pr-589/group__imgui-plugin.html new file mode 100644 index 000000000..cc4eb0d93 --- /dev/null +++ b/pr-preview/pr-589/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-589/group__input-plugin.html b/pr-preview/pr-589/group__input-plugin.html new file mode 100644 index 000000000..f36429ddb --- /dev/null +++ b/pr-preview/pr-589/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-589/group__renderer-plugin.html b/pr-preview/pr-589/group__renderer-plugin.html new file mode 100644 index 000000000..bf40956d5 --- /dev/null +++ b/pr-preview/pr-589/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.
  • cubos.renderer.bloom.enabled - whether bloom 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 directional_light.hpp
+
Component cubos::engine::DirectionalLight.
+
file environment.hpp
+
Resource cubos::engine::RendererEnvironment.
+
file frame.hpp
+
Resource cubos::engine::RendererFrame.
+
file plugin.hpp
+
Plugin entry point, resource cubos::engine::ActiveCameras and components cubos::engine::RenderableGrid and cubos::engine::Camera.
+
file point_light.hpp
+
Component cubos::engine::PointLight.
+
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.
+
file spot_light.hpp
+
Component cubos::engine::SpotLight.
+
+
+
+

Classes

+
+
+ class cubos::engine::DeferredRenderer +
+
Renderer implementation which uses deferred rendering.
+
+ struct cubos::engine::DirectionalLight +
+
Component which makes an entity behave like a directional light.
+
+ 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::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.
+
+ struct cubos::engine::PointLight +
+
Component which makes an entity behave like a point light.
+
+ 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.
+
+ struct cubos::engine::SpotLight +
+
Component which makes an entity emit a spot light.
+
+
+
+

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-589/group__scene-editor-tool-plugin.html b/pr-preview/pr-589/group__scene-editor-tool-plugin.html new file mode 100644 index 000000000..7bf722f18 --- /dev/null +++ b/pr-preview/pr-589/group__scene-editor-tool-plugin.html @@ -0,0 +1,152 @@ + + + + + Engine » Tools » Scene editor module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Tools » + Scene editor module

+

Adds a window to edit scenes and select entities in them.

+ +

Dependencies

+
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Functions

+
+
+ void sceneEditorPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void sceneEditorPlugin(Cubos& cubos) +
#include <engine/tools/scene_editor/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/group__scene-plugin.html b/pr-preview/pr-589/group__scene-plugin.html new file mode 100644 index 000000000..d7df6e018 --- /dev/null +++ b/pr-preview/pr-589/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-589/group__settings-inspector-tool-plugin.html b/pr-preview/pr-589/group__settings-inspector-tool-plugin.html new file mode 100644 index 000000000..95f6041da --- /dev/null +++ b/pr-preview/pr-589/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-589/group__settings-plugin.html b/pr-preview/pr-589/group__settings-plugin.html new file mode 100644 index 000000000..b80f18377 --- /dev/null +++ b/pr-preview/pr-589/group__settings-plugin.html @@ -0,0 +1,153 @@ + + + + + Engine » Settings module | CUBOS. + + + + + + + +
+
+
+
+
+

+ Engine » + Settings module

+

Adds and manages settings.

+ +

Initially, parses settings from the Arguments resource. Then, the file at settings.path is loaded, as a JSON file. If the file does not exist, it is created. If it can't be parsed, the plugin aborts. Previously set settings will be overriden, and file settings will be overriden by command line arguments.

Settings

  • settings.path - path of the settings file (default: ./settings.json).

Resources

Startup tags

  • cubos.settings - the settings are loaded, overriding values set previously.
+
+

Files

+
+
file plugin.hpp
+
Plugin entry point.
+
+
+
+

Functions

+
+
+ void settingsPlugin(Cubos& cubos) +
+
Plugin entry function.
+
+
+
+

Function documentation

+
+

+ void settingsPlugin(Cubos& cubos) +
#include <engine/settings/plugin.hpp>
+

+

Plugin entry function.

+ + + + + + + + + + +
Parameters
cubosCUBOS. main class
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/group__tool-plugins.html b/pr-preview/pr-589/group__tool-plugins.html new file mode 100644 index 000000000..351d9a6de --- /dev/null +++ b/pr-preview/pr-589/group__tool-plugins.html @@ -0,0 +1,128 @@ + + + + + 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 Scene editor
+
Adds a window to edit scenes and select entities in them.
+
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-589/group__transform-plugin.html b/pr-preview/pr-589/group__transform-plugin.html new file mode 100644 index 000000000..3b3aa793a --- /dev/null +++ b/pr-preview/pr-589/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-589/group__voxels-plugin.html b/pr-preview/pr-589/group__voxels-plugin.html new file mode 100644 index 000000000..a5aa5c3ee --- /dev/null +++ b/pr-preview/pr-589/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-589/group__window-plugin.html b/pr-preview/pr-589/group__window-plugin.html new file mode 100644 index 000000000..1bec15907 --- /dev/null +++ b/pr-preview/pr-589/group__window-plugin.html @@ -0,0 +1,156 @@ + + + + + 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.

Dependencies

+
+

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-589/group__world-inspector-tool-plugin.html b/pr-preview/pr-589/group__world-inspector-tool-plugin.html new file mode 100644 index 000000000..a91ebf249 --- /dev/null +++ b/pr-preview/pr-589/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-589/guards_8hpp.html b/pr-preview/pr-589/guards_8hpp.html new file mode 100644 index 000000000..fce581a46 --- /dev/null +++ b/pr-preview/pr-589/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-589/imgui_2plugin_8hpp.html b/pr-preview/pr-589/imgui_2plugin_8hpp.html new file mode 100644 index 000000000..ba19a9ef5 --- /dev/null +++ b/pr-preview/pr-589/imgui_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/imgui/plugin.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/imgui_8hpp.html b/pr-preview/pr-589/imgui_8hpp.html new file mode 100644 index 000000000..53befbc33 --- /dev/null +++ b/pr-preview/pr-589/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-589/index.html b/pr-preview/pr-589/index.html new file mode 100644 index 000000000..5a6f2e718 --- /dev/null +++ b/pr-preview/pr-589/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-589/input_2plugin_8hpp.html b/pr-preview/pr-589/input_2plugin_8hpp.html new file mode 100644 index 000000000..c84eb8bbb --- /dev/null +++ b/pr-preview/pr-589/input_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/input/plugin.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/input_8hpp.html b/pr-preview/pr-589/input_8hpp.html new file mode 100644 index 000000000..8f06d62e1 --- /dev/null +++ b/pr-preview/pr-589/input_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/input/input.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/json_8hpp.html b/pr-preview/pr-589/json_8hpp.html new file mode 100644 index 000000000..ff6cbcc62 --- /dev/null +++ b/pr-preview/pr-589/json_8hpp.html @@ -0,0 +1,131 @@ + + + + + engine/assets/bridges/json.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/keyboard_8hpp.html b/pr-preview/pr-589/keyboard_8hpp.html new file mode 100644 index 000000000..1ede28d4c --- /dev/null +++ b/pr-preview/pr-589/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-589/local__to__world_8hpp.html b/pr-preview/pr-589/local__to__world_8hpp.html new file mode 100644 index 000000000..f31030a09 --- /dev/null +++ b/pr-preview/pr-589/local__to__world_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/transform/local_to_world.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/log_8hpp.html b/pr-preview/pr-589/log_8hpp.html new file mode 100644 index 000000000..dcbcf027c --- /dev/null +++ b/pr-preview/pr-589/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-589/m-dark+documentation.compiled.css b/pr-preview/pr-589/m-dark+documentation.compiled.css new file mode 100644 index 000000000..7d091c2fa --- /dev/null +++ b/pr-preview/pr-589/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-589/manager_8hpp.html b/pr-preview/pr-589/manager_8hpp.html new file mode 100644 index 000000000..bdb0a357c --- /dev/null +++ b/pr-preview/pr-589/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-589/map__storage_8hpp.html b/pr-preview/pr-589/map__storage_8hpp.html new file mode 100644 index 000000000..f81b52bc1 --- /dev/null +++ b/pr-preview/pr-589/map__storage_8hpp.html @@ -0,0 +1,133 @@ + + + + + core/ecs/map_storage.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/material_8hpp.html b/pr-preview/pr-589/material_8hpp.html new file mode 100644 index 000000000..b9e926da3 --- /dev/null +++ b/pr-preview/pr-589/material_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/gl/material.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/meta_8hpp.html b/pr-preview/pr-589/meta_8hpp.html new file mode 100644 index 000000000..3b03a0481 --- /dev/null +++ b/pr-preview/pr-589/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-589/modules.html b/pr-preview/pr-589/modules.html new file mode 100644 index 000000000..7c9f6c7ee --- /dev/null +++ b/pr-preview/pr-589/modules.html @@ -0,0 +1,160 @@ + + + + + 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 Reflection Provides utilities useful for handling type-erased data.
      • +
    • 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 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 Settings Adds and manages settings.
      • +
    • + 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 Scene editor Adds a window to edit scenes and select entities in them.
        • +
      • 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-589/move_8hpp.html b/pr-preview/pr-589/move_8hpp.html new file mode 100644 index 000000000..378a29ef2 --- /dev/null +++ b/pr-preview/pr-589/move_8hpp.html @@ -0,0 +1,144 @@ + + + + + core/memory/move.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/memory/move.hpp file +

+

Function cubos::core::memory::move.

+ +
+

Namespaces

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

Classes

+
+
+
template<typename T>
+ struct cubos::core::memory::RemoveReference +
+
Provides a type which is the same as the given type, but without any references.
+
+
+
+

Functions

+
+
+
template<typename T>
+ auto move(T&& value) -> RemoveReference<T>::Type&& +
+
Returns an R-value reference to the given value.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/namespacecubos.html b/pr-preview/pr-589/namespacecubos.html new file mode 100644 index 000000000..d087267c1 --- /dev/null +++ b/pr-preview/pr-589/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-589/namespacecubos_1_1core.html b/pr-preview/pr-589/namespacecubos_1_1core.html new file mode 100644 index 000000000..5d24b14b1 --- /dev/null +++ b/pr-preview/pr-589/namespacecubos_1_1core.html @@ -0,0 +1,158 @@ + + + + + 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 reflection
+
Reflection module.
+
namespace ui
+
User Interface module.
+
+
+
+

Classes

+
+
+ 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-589/namespacecubos_1_1core_1_1al.html b/pr-preview/pr-589/namespacecubos_1_1core_1_1al.html new file mode 100644 index 000000000..34890a678 --- /dev/null +++ b/pr-preview/pr-589/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-589/namespacecubos_1_1core_1_1al_1_1impl.html b/pr-preview/pr-589/namespacecubos_1_1core_1_1al_1_1impl.html new file mode 100644 index 000000000..748d3016f --- /dev/null +++ b/pr-preview/pr-589/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-589/namespacecubos_1_1core_1_1data.html b/pr-preview/pr-589/namespacecubos_1_1core_1_1data.html new file mode 100644 index 000000000..54326484f --- /dev/null +++ b/pr-preview/pr-589/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-589/namespacecubos_1_1core_1_1data_1_1impl.html b/pr-preview/pr-589/namespacecubos_1_1core_1_1data_1_1impl.html new file mode 100644 index 000000000..0de6962d6 --- /dev/null +++ b/pr-preview/pr-589/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-589/namespacecubos_1_1core_1_1ecs.html b/pr-preview/pr-589/namespacecubos_1_1core_1_1ecs.html new file mode 100644 index 000000000..2a2de030f --- /dev/null +++ b/pr-preview/pr-589/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-589/namespacecubos_1_1core_1_1ecs_1_1impl.html b/pr-preview/pr-589/namespacecubos_1_1core_1_1ecs_1_1impl.html new file mode 100644 index 000000000..436fe39a3 --- /dev/null +++ b/pr-preview/pr-589/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-589/namespacecubos_1_1core_1_1geom.html b/pr-preview/pr-589/namespacecubos_1_1core_1_1geom.html new file mode 100644 index 000000000..f0b1803bf --- /dev/null +++ b/pr-preview/pr-589/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-589/namespacecubos_1_1core_1_1gl.html b/pr-preview/pr-589/namespacecubos_1_1core_1_1gl.html new file mode 100644 index 000000000..8c14fd889 --- /dev/null +++ b/pr-preview/pr-589/namespacecubos_1_1core_1_1gl.html @@ -0,0 +1,520 @@ + + + + + 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 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-589/namespacecubos_1_1core_1_1gl_1_1impl.html b/pr-preview/pr-589/namespacecubos_1_1core_1_1gl_1_1impl.html new file mode 100644 index 000000000..3debc0e80 --- /dev/null +++ b/pr-preview/pr-589/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-589/namespacecubos_1_1core_1_1io.html b/pr-preview/pr-589/namespacecubos_1_1core_1_1io.html new file mode 100644 index 000000000..37f7fca5b --- /dev/null +++ b/pr-preview/pr-589/namespacecubos_1_1core_1_1io.html @@ -0,0 +1,386 @@ + + + + + cubos::core::io namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::io namespace +

+

Input and output module.

+ +
+

Classes

+
+
+ class Cursor +
+
Handle for a custom mouse cursor.
+
+ struct GamepadState +
+
Holds the state of a gamepad.
+
+ 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.
+
+ struct GamepadConnectionEvent +
+
Event sent when a gamepad is connected or disconnected.
+
+ class BaseWindow +
+
Interface used to wrap low-level window API implementations.
+
+
+
+

Enums

+
+
+ enum class GamepadButton { Invalid = -1, + A, + B, + X, + Y, + LBumper, + RBumper, + Back, + Start, + Guide, + LThumb, + RThumb, + Up, + Right, + Down, + Left, + Count } +
+
Gamepad buttons.
+
+ enum class GamepadAxis { Invalid = -1, + LX, + LY, + RX, + RY, + LTrigger, + RTrigger, + Count } +
+
Gamepad axes.
+
+ 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, GamepadConnectionEvent> +
+
Variant that can hold any of the window events.
+
+ using Window = std::shared_ptr<BaseWindow> +
+
Handle to a window.
+
+
+
+

Functions

+
+
+ auto gamepadButtonToString(GamepadButton button) -> std::string +
+
Converts a GamepadButton enum to a string.
+
+ auto stringToGamepadButton(const std::string& str) -> GamepadButton +
+
Converts a string to a GamepadButton.
+
+ auto gamepadAxisToString(GamepadAxis axis) -> std::string +
+
Convert a GamepadAxis to a string.
+
+ auto stringToGamepadAxis(const std::string& str) -> GamepadAxis +
+
Convert a string to a GamepadAxis.
+
+ 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-589/namespacecubos_1_1core_1_1memory.html b/pr-preview/pr-589/namespacecubos_1_1core_1_1memory.html new file mode 100644 index 000000000..2fb1d3965 --- /dev/null +++ b/pr-preview/pr-589/namespacecubos_1_1core_1_1memory.html @@ -0,0 +1,200 @@ + + + + + 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.
+
+
template<typename T>
+ struct RemoveReference +
+
Provides a type which is the same as the given type, but without any references.
+
+ 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.
+
+
template<typename T>
+ auto move(T&& value) -> RemoveReference<T>::Type&& +
+
Returns an R-value reference to the given value.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/namespacecubos_1_1core_1_1reflection.html b/pr-preview/pr-589/namespacecubos_1_1core_1_1reflection.html new file mode 100644 index 000000000..ff9815b51 --- /dev/null +++ b/pr-preview/pr-589/namespacecubos_1_1core_1_1reflection.html @@ -0,0 +1,145 @@ + + + + + cubos::core::reflection namespace | CUBOS. + + + + + + + +
+
+
+
+
+

+ cubos::core::reflection namespace +

+

Reflection module.

+ +
+

Classes

+
+
+
template<typename T>
+ struct Reflect +
+
Defines the reflection function for the given type T.
+
+ class ConstructibleTrait +
+
Describes how a reflected type may be constructed and destructed.
+
+ class Type +
+
Describes a reflected type.
+
+
+
+

Functions

+
+
+
template<typename T>
+ auto reflect() -> const Type& +
+
Reflects the given type T.
+
+
template<typename T>
+ auto autoConstructibleTrait() -> ConstructibleTrait +
+
Returns a ConstructibleTrait with the default, copy and move constructors, set only if the type has them.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/namespacecubos_1_1core_1_1ui.html b/pr-preview/pr-589/namespacecubos_1_1core_1_1ui.html new file mode 100644 index 000000000..9c424fa0c --- /dev/null +++ b/pr-preview/pr-589/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-589/namespacecubos_1_1engine.html b/pr-preview/pr-589/namespacecubos_1_1engine.html new file mode 100644 index 000000000..e81314e90 --- /dev/null +++ b/pr-preview/pr-589/namespacecubos_1_1engine.html @@ -0,0 +1,399 @@ + + + + + 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 which stores the command-line 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 DirectionalLight +
+
Component which makes an entity behave like a directional light.
+
+ 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 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.
+
+ struct PointLight +
+
Component which makes an entity behave like a point light.
+
+ 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.
+
+ struct SpotLight +
+
Component which makes an entity emit a spot light.
+
+ class SceneBridge +
+
Bridge which loads and saves Scene assets.
+
+ struct Scene +
+
Asset equivalent to ECS blueprints - a bundle of entities and their components.
+
+ class Settings +
+
Stores settings as key-value pairs and provides methods to retrieve them.
+
+ 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 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 settingsPlugin(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-589/namespacecubos_1_1engine_1_1impl.html b/pr-preview/pr-589/namespacecubos_1_1engine_1_1impl.html new file mode 100644 index 000000000..166608720 --- /dev/null +++ b/pr-preview/pr-589/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-589/namespacecubos_1_1engine_1_1tools.html b/pr-preview/pr-589/namespacecubos_1_1engine_1_1tools.html new file mode 100644 index 000000000..06a16fbb5 --- /dev/null +++ b/pr-preview/pr-589/namespacecubos_1_1engine_1_1tools.html @@ -0,0 +1,154 @@ + + + + + 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 sceneEditorPlugin(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-589/namespaces.html b/pr-preview/pr-589/namespaces.html new file mode 100644 index 000000000..4cbc57049 --- /dev/null +++ b/pr-preview/pr-589/namespaces.html @@ -0,0 +1,161 @@ + + + + + CUBOS. + + + + + + + +
+
+
+
+
+

Namespaces

+ + +
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/null__storage_8hpp.html b/pr-preview/pr-589/null__storage_8hpp.html new file mode 100644 index 000000000..919eb3f31 --- /dev/null +++ b/pr-preview/pr-589/null__storage_8hpp.html @@ -0,0 +1,133 @@ + + + + + core/ecs/null_storage.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/output.png b/pr-preview/pr-589/output.png new file mode 100644 index 0000000000000000000000000000000000000000..1867409f1acdefc1e9144c8491d1babf9227dcc0 GIT binary patch literal 118782 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 + + + + CUBOS. + + + + + + + + +
+
+
+
+

Pages

+ + +
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/palette_8hpp.html b/pr-preview/pr-589/palette_8hpp.html new file mode 100644 index 000000000..243e5394e --- /dev/null +++ b/pr-preview/pr-589/palette_8hpp.html @@ -0,0 +1,134 @@ + + + + + core/gl/palette.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/pass_8hpp.html b/pr-preview/pr-589/pass_8hpp.html new file mode 100644 index 000000000..9a54137b4 --- /dev/null +++ b/pr-preview/pr-589/pass_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/renderer/pps/pass.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/point__light_8hpp.html b/pr-preview/pr-589/point__light_8hpp.html new file mode 100644 index 000000000..2b6ec7dd9 --- /dev/null +++ b/pr-preview/pr-589/point__light_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/renderer/point_light.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/position_8hpp.html b/pr-preview/pr-589/position_8hpp.html new file mode 100644 index 000000000..2d5f46b62 --- /dev/null +++ b/pr-preview/pr-589/position_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/transform/position.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/primitives_8hpp.html b/pr-preview/pr-589/primitives_8hpp.html new file mode 100644 index 000000000..93f0a8d85 --- /dev/null +++ b/pr-preview/pr-589/primitives_8hpp.html @@ -0,0 +1,100 @@ + + + + + core/reflection/external/primitives.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/reflection/external/primitives.hpp file +

+

Reflection declarations for primitive types.

+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/query_8hpp.html b/pr-preview/pr-589/query_8hpp.html new file mode 100644 index 000000000..b8cc42569 --- /dev/null +++ b/pr-preview/pr-589/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-589/reflect_8hpp.html b/pr-preview/pr-589/reflect_8hpp.html new file mode 100644 index 000000000..656703360 --- /dev/null +++ b/pr-preview/pr-589/reflect_8hpp.html @@ -0,0 +1,180 @@ + + + + + core/reflection/reflect.hpp file | CUBOS. + + + + + + + +
+
+
+
+
+

+ core/reflection/reflect.hpp file +

+

Function cubos::core::reflection::reflect and related macros.

+ +

Meant to be as minimal as possible in order to keep compile times low.

+
+

Namespaces

+
+
namespace cubos
+
CUBOS. libraries namespace.
+
namespace cubos::core
+
Core namespace.
+
namespace cubos::core::reflection
+
Reflection module.
+
+
+
+

Classes

+
+
+
template<typename T>
+ struct cubos::core::reflection::Reflect +
+
Defines the reflection function for the given type T.
+
+
+
+

Functions

+
+
+
template<typename T>
+ auto reflect() -> const Type& +
+
Reflects the given type T.
+
+
+
+

Defines

+
+
+ #define CUBOS_PACK(...) +
+
Helper macro used to pass arguments with commas to other macros, wrapped in parentheses.
+
+ #define CUBOS_REFLECT +
+
Declares a reflection method.
+
+ #define CUBOS_REFLECT_IMPL(T) +
+
Defines a reflection method.
+
+ #define CUBOS_REFLECT_EXTERNAL_DECL_TEMPLATE(T) +
+
Declares a specialization of cubos::core::reflection::Reflect for a templated type.
+
+ #define CUBOS_REFLECT_EXTERNAL_DECL(T) +
+
Declares a specialization of cubos::core::reflection::Reflect for a type.
+
+ #define CUBOS_REFLECT_EXTERNAL_IMPL(T) +
+
Implements a specialization of cubos::core::reflection::Reflect for a type.
+
+ #define CUBOS_REFLECT_EXTERNAL_TEMPLATE(args, + T) +
+
Both declares and implements a specialization of cubos::core::reflection::Reflect for a type.
+
+
+
+
+
+
+ + + +
+ + diff --git a/pr-preview/pr-589/registry_8hpp.html b/pr-preview/pr-589/registry_8hpp.html new file mode 100644 index 000000000..c1dcb16e3 --- /dev/null +++ b/pr-preview/pr-589/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-589/render__device_8hpp.html b/pr-preview/pr-589/render__device_8hpp.html new file mode 100644 index 000000000..a050dbd26 --- /dev/null +++ b/pr-preview/pr-589/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-589/renderer_2plugin_8hpp.html b/pr-preview/pr-589/renderer_2plugin_8hpp.html new file mode 100644 index 000000000..8c46dd6db --- /dev/null +++ b/pr-preview/pr-589/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-589/renderer_8hpp.html b/pr-preview/pr-589/renderer_8hpp.html new file mode 100644 index 000000000..a16a12824 --- /dev/null +++ b/pr-preview/pr-589/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-589/resource__manager_8hpp.html b/pr-preview/pr-589/resource__manager_8hpp.html new file mode 100644 index 000000000..8bb32e97d --- /dev/null +++ b/pr-preview/pr-589/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-589/rotation_8hpp.html b/pr-preview/pr-589/rotation_8hpp.html new file mode 100644 index 000000000..ed6bb4ec4 --- /dev/null +++ b/pr-preview/pr-589/rotation_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/transform/rotation.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/scale_8hpp.html b/pr-preview/pr-589/scale_8hpp.html new file mode 100644 index 000000000..bcaa68b57 --- /dev/null +++ b/pr-preview/pr-589/scale_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/transform/scale.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/scene_2bridge_8hpp.html b/pr-preview/pr-589/scene_2bridge_8hpp.html new file mode 100644 index 000000000..ffe2aacb3 --- /dev/null +++ b/pr-preview/pr-589/scene_2bridge_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/scene/bridge.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/scene_2plugin_8hpp.html b/pr-preview/pr-589/scene_2plugin_8hpp.html new file mode 100644 index 000000000..b86fe2ef1 --- /dev/null +++ b/pr-preview/pr-589/scene_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/scene/plugin.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/scene_8hpp.html b/pr-preview/pr-589/scene_8hpp.html new file mode 100644 index 000000000..57218fbc5 --- /dev/null +++ b/pr-preview/pr-589/scene_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/scene/scene.hpp file | CUBOS. + + + + + + + +
+
+ + + +
+ + diff --git a/pr-preview/pr-589/search-v2.js b/pr-preview/pr-589/search-v2.js new file mode 100644 index 000000000..1fb71e1f8 --- /dev/null +++ b/pr-preview/pr-589/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-589/searchdata-v2.js b/pr-preview/pr-589/searchdata-v2.js new file mode 100644 index 000000000..4528025a9 --- /dev/null +++ b/pr-preview/pr-589/searchdata-v2.js @@ -0,0 +1,2 @@ +/* Generated by https://mcss.mosra.cz/documentation/doxygen/. Do not edit. */ +Search.load('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Al35&!`KeF!Mr5`X{!ZsHOE00C+05&!@JXYdjL00DLO5&!@JZ2S@c00D3U6951KatIRu00D0f6951KbQBW+00Cnf6951KWgrs(00D3&6951Kb1V}800C|?6951KX*d%A00DD86951KXG9YK00C}F6951KX;2dY00DGX6951KbX*ev00CuU6951Kb7&I)00BB~6951KI&>3&00DA(6951KZ-5g300DG{6951KV~i6300Cu^6951KaF`PS00DEJ6951KZln_c00C*L6951KAg~hv00DEh6951KXS@>t00C~o6951KX~+`*00DH)6951Kbkq|700LuW(h>mL6954KhX4QpDe4md0Re^pDDD%000D0F6951KY5Wra00CzL6aWALbqEvy00C?c6aWALa1;~(00D9u6aWALZy*!^00DF+6aWALV=NQ^00Ct(6aWALa5xkI00DD86aWALZbTFS00C)A6aWALWKa|U00C@P6aWALa$FPu00D1e6aWALcW4v<00BB~6aWALI&>6(00DA(6aWALZ-5j400DG{6aWALV~i9400Cu^6aWALaF`ST00DEJ6aWALZln|d00C*L6aWALAg~kw00CsS6aWALY`hcz00DBs6aWALZ^#q?0RYkg00Ak~6aWDM(E%vf6o3E$Zr&6C00C*{6aWALXY3RJ00DLK6aWALZ1@xa00D6R6aWALas(9s00D0b6#xJMbPyE)00Cnb6#xJMWgHa%00C?w6#xJMWhfN@00DC@6#xJMc{CLO00DG56#xJMX+RYK00DGH6#xJMZcG&b00CuE6#xJMI#?9|00BB)6@UN%a%2?%00D1m6#xJMbZ`{_00Com6#xJMWqcI?00C@*6#xJMWr!630RV{z00AkK6#xMNhzKZ{6@UN%Zk`nY00C*H6#xJMXRH+f00DKf6#xJMY`7Hw00D5m6#xJMa>Nw?00D2x6#xJMbkG$500Cpx6#xJMW!x1200D5~6#xJMbLbTS00D096#xJMY4jBU00DXW6#xJMbO06r00C(R761SNbPN^%00C|i761SNWf&F!00BB4761SNIwTf=00D9;761SNZ!i`B00DG1761SNV>}iB00Ct}761SNa7Y#a00DDO761SNZd4Wk00MJqjuik}761VNS_J?BZfX_)00D1q761SNX>=9<00DG*761SNV}KR_00Cu&761SNY>XBF00Cu^76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�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r80dLI#uFV0m%>nbx0r$-TK+XX~&H;nY0f){3#?ArC&H)L}0S(UqP0s;Q&jFFo0hP}I)z1Oh&jA_G0Ugi*UC;qx&;g;)0j1CZ0jkjf3DN-#(g9%70g}=ImeK*s(gDuW0Rqzj1=9gH(*bhR0oKz2+S36P)BzXN0V>o1S=0fH)B)Di0U6Z+9n}F<)d5-60h84Mm(>B$)dAJj0T0#z6V?Gt)&Wq~0gKiFkJbUo)&b7e0SVUu4c7rh*8xe_0fN^7hSveU*8#%U0Rz|p2iO5U*a1M;0d&{_ch~`}*a5HD0pi#J<=6oq*#RQi0b1DsUD*Me*#Xws0omCBB-#Ne+5vXj0ead2u-XB%+5z|40sGnkFxvq%+W~6Z0dCs?r`rLm+X3X;0qENSF5Ce!+yQRf0dm{{%-jLc+yOM*0XW?OfZYMC-2vL&0S4XyG~NM*-T}|v0n^?A6W;+B-vMsl0dn5~iQfUv-vQF!0U6){9pC|K-~n#n0jS^stl$B`-~sjE0r=nnH{k(0;Q^T80i59h>fr(I;Q?FX0bk+)sNw;v;sF5T0R-a#G~)p`;{k5t0dnI3tm6UM;{lkM=;-L^=;&DJ=;&COsi~={K&h#zsi~={sYt1*IH{?rsi~={sHv!_si~={si~={si~V=vbJTP^qa%si`}rr=&7iwsjaQ4si~={si~={si~={sHv%`si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~<*Sm@~J=;-LFsi~=0n3(8T$mr)`si~={si~=`si>)_si~={NSLXqsi>)_si~={si~={si~={si~={si~={si~={si~={si;V)sW_Mzn3$=lsi~={si~={si~={si~={si~={si~={si>)`si>)`si;Wk=;-L^=;&Cfsi~+)=;-KJSgEP0si~={si~={si~={si~={si~={sHv$)si~=`NU5nf=vauYt*NM~sHv%`si~={si~<*h?rQZsHv%`si~={si~={sYt1*si{a9m?){Ksi~={si~={NSK)DSgENv=;&DJsi~={si~={si~={si~={si~={si~={si~=`si>)_si>)_si>)`si>)_NSIidn5n6$si~={si~={si~-`si~={si~={si~<*si~={si~={si~={si~={si>)`si{aPFzD#1si~=0si>)`si~=`si~=`si~={NLZLin3$M|=;-L^=;-KJh^eWms7RQY5a?JKm>B5jSSXn2=&7k#si>)`si{b*si~-`sHv$)=;&Cfsi~={sYt1*si~={si~={si~={si~={si~={si{b*si~={si~={si~={si~={si~={si~={si~={sHv%`sHv%`s7RP7h^eWmsi~-`sHv$)NGPePsi~={NSLXqsi~={si{b*sHvz(m^etOsi~<*IGEVj*x1)`si~={si{clSgEP0si~={si~={si~={s7R@)si~={si{avn5n6$si~={si~={si~={si~={sYt1*si~={NSK)D=ve4j=&7iwsi~={si~=0i0J6(=ve4jsi`=rsi~={si~={si~={sHv%`sYvMP=vaX0=;-KJsi>)`si~={si~={si~={si~={si~=`NJy!vsi{biD5V=;-L^SeTgT=;-L^=ve6J=;-L^Scs{qsi~={si~={si~={NSLXqsi>)`NSG+-SU8AKc&VwWsi~={si~={sYr;J=;&C8h?wZ;=;-L^SeU7)NSKJ2n24CEsi~-`sHvz(NSLXqsi~={NU5o*si~={si~<*=;-KJsi`=rsi~={si~<*n5n6$si~={si~<*si;U$si`<9n0R=2c&VwWsi~={si~={si~={si~={si~+)h^eWmsi~={sHv%`si~<*SlHOu$ar|EsW_Oasi~<*n60g;si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={si~={sYvMP=vYt~=&7l#t*NQ0si~={si~={sHv%`sYrmSsi~={si~={s7P3tm?)U3sHv%`si~={si~={si~-`si~={sYsaUSgEP0si~={si~={si~={si~={si~={si~={si~-`si~-`si~+)si~={si>)_si>)`si~={Na*P3ScvH8SQzN&=;-L^=vb+#si~={NEqno=;-L^=vbI2n5n5Kn3#x|7?=>4=vWx3si~<*si`>F*x1N;si~={si~={si>)`si~={si~={si~={si~={NSF|q=vb+#si~={si~={si~={NGRCIc)_si>)_si;VJ=;*1bsi{b*sW=cAn8+xpsi~={si~={si~={si~={si~={sHv$)c&VwWsi~={saO!0=&7l#t*NQ0sYvMPSm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'); diff --git a/pr-preview/pr-589/serialization_8hpp.html b/pr-preview/pr-589/serialization_8hpp.html new file mode 100644 index 000000000..c60e9ce8a --- /dev/null +++ b/pr-preview/pr-589/serialization_8hpp.html @@ -0,0 +1,150 @@ + + + + + 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-589/settings_2plugin_8hpp.html b/pr-preview/pr-589/settings_2plugin_8hpp.html new file mode 100644 index 000000000..bf1f9a2bf --- /dev/null +++ b/pr-preview/pr-589/settings_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/settings/plugin.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/settings_8hpp.html b/pr-preview/pr-589/settings_8hpp.html new file mode 100644 index 000000000..914b9e33f --- /dev/null +++ b/pr-preview/pr-589/settings_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/settings/settings.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/spot__light_8hpp.html b/pr-preview/pr-589/spot__light_8hpp.html new file mode 100644 index 000000000..2047a9dee --- /dev/null +++ b/pr-preview/pr-589/spot__light_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/renderer/spot_light.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/standard__archive_8hpp.html b/pr-preview/pr-589/standard__archive_8hpp.html new file mode 100644 index 000000000..fa6ff6565 --- /dev/null +++ b/pr-preview/pr-589/standard__archive_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/data/fs/standard_archive.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/standard__stream_8hpp.html b/pr-preview/pr-589/standard__stream_8hpp.html new file mode 100644 index 000000000..e8bce49e5 --- /dev/null +++ b/pr-preview/pr-589/standard__stream_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/memory/standard_stream.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/storage_8hpp.html b/pr-preview/pr-589/storage_8hpp.html new file mode 100644 index 000000000..1b629b521 --- /dev/null +++ b/pr-preview/pr-589/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-589/stream_8hpp.html b/pr-preview/pr-589/stream_8hpp.html new file mode 100644 index 000000000..7127bb402 --- /dev/null +++ b/pr-preview/pr-589/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-589/structColorTrait.html b/pr-preview/pr-589/structColorTrait.html new file mode 100644 index 000000000..321d22849 --- /dev/null +++ b/pr-preview/pr-589/structColorTrait.html @@ -0,0 +1,101 @@ + + + + + ColorTrait struct | CUBOS. + + + + + + + +
    +
    +
    +
    +
    +

    + ColorTrait struct +

    +

    [Position definition]

    +

    [Your own trait]

    +
    +
    +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structIntegerAsset.html b/pr-preview/pr-589/structIntegerAsset.html new file mode 100644 index 000000000..5737190fa --- /dev/null +++ b/pr-preview/pr-589/structIntegerAsset.html @@ -0,0 +1,100 @@ + + + + + IntegerAsset struct | CUBOS. + + + + + + + +
    +
    +
    +
    +
    +

    + IntegerAsset struct +

    +

    [Asset type]

    +
    +
    +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structPerson.html b/pr-preview/pr-589/structPerson.html new file mode 100644 index 000000000..c17e20b23 --- /dev/null +++ b/pr-preview/pr-589/structPerson.html @@ -0,0 +1,100 @@ + + + + + Person struct | CUBOS. + + + + + + + +
    +
    +
    +
    +
    +

    + Person struct +

    +

    [Person definition]

    +
    +
    +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structPosition.html b/pr-preview/pr-589/structPosition.html new file mode 100644 index 000000000..5bf47c456 --- /dev/null +++ b/pr-preview/pr-589/structPosition.html @@ -0,0 +1,101 @@ + + + + + Position struct | CUBOS. + + + + + + + +
    +
    +
    +
    +
    +

    + Position struct +

    +

    [Person reflection]

    +

    [Position definition]

    +
    +
    +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structScale.html b/pr-preview/pr-589/structScale.html new file mode 100644 index 000000000..9dacf694a --- /dev/null +++ b/pr-preview/pr-589/structScale.html @@ -0,0 +1,100 @@ + + + + + Scale struct | CUBOS. + + + + + + + +
    +
    +
    +
    +
    +

    + Scale struct +

    +

    [Scale declaration]

    +
    +
    +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structStrings.html b/pr-preview/pr-589/structStrings.html new file mode 100644 index 000000000..51bc5745c --- /dev/null +++ b/pr-preview/pr-589/structStrings.html @@ -0,0 +1,100 @@ + + + + + Strings struct | CUBOS. + + + + + + + +
    +
    +
    +
    +
    +

    + Strings struct +

    +

    [Asset type] A simple serializable type which we will be saving and loading.

    +
    +
    +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1data_1_1Debug.html b/pr-preview/pr-589/structcubos_1_1core_1_1data_1_1Debug.html new file mode 100644 index 000000000..3b8fb4a95 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1data_1_1EmbeddedArchive_1_1Data.html b/pr-preview/pr-589/structcubos_1_1core_1_1data_1_1EmbeddedArchive_1_1Data.html new file mode 100644 index 000000000..07e7d871d --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1data_1_1EmbeddedArchive_1_1Data_1_1Entry.html b/pr-preview/pr-589/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-589/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-589/structcubos_1_1core_1_1data_1_1QBMatrix.html b/pr-preview/pr-589/structcubos_1_1core_1_1data_1_1QBMatrix.html new file mode 100644 index 000000000..3b9afc4ae --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1data_1_1QBMatrix.html @@ -0,0 +1,128 @@ + + + + + cubos::core::data::QBMatrix struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1QueryInfo.html b/pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1QueryInfo.html new file mode 100644 index 000000000..5a1f7def1 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1QueryInfo.html @@ -0,0 +1,125 @@ + + + + + cubos::core::ecs::QueryInfo struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1SystemInfo.html b/pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1SystemInfo.html new file mode 100644 index 000000000..721d9b4fe --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1ecs_1_1impl_1_1Index.html b/pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1impl_1_1Index.html new file mode 100644 index 000000000..04619fd10 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1ecs_1_1impl_1_1QueryFetcher.html b/pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1impl_1_1QueryFetcher.html new file mode 100644 index 000000000..c206f50ce --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1ecs_1_1impl_1_1SystemFetcher.html b/pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1impl_1_1SystemFetcher.html new file mode 100644 index 000000000..a8b02a6e5 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1ecs_1_1impl_1_1SystemTraits.html b/pr-preview/pr-589/structcubos_1_1core_1_1ecs_1_1impl_1_1SystemTraits.html new file mode 100644 index 000000000..4336fb18d --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1geom_1_1Box.html b/pr-preview/pr-589/structcubos_1_1core_1_1geom_1_1Box.html new file mode 100644 index 000000000..0101ec344 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1geom_1_1Capsule.html b/pr-preview/pr-589/structcubos_1_1core_1_1geom_1_1Capsule.html new file mode 100644 index 000000000..e872cfe8b --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1geom_1_1Plane.html b/pr-preview/pr-589/structcubos_1_1core_1_1geom_1_1Plane.html new file mode 100644 index 000000000..3fcd26a12 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1geom_1_1Plane.html @@ -0,0 +1,121 @@ + + + + + cubos::core::geom::Plane struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1geom_1_1Simplex.html b/pr-preview/pr-589/structcubos_1_1core_1_1geom_1_1Simplex.html new file mode 100644 index 000000000..a80c6c545 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1BlendStateDesc.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1BlendStateDesc.html new file mode 100644 index 000000000..3f4dd28ec --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1Camera.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Camera.html new file mode 100644 index 000000000..82f7e784d --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Camera.html @@ -0,0 +1,141 @@ + + + + + cubos::core::gl::Camera struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1ConstantBufferElement.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1ConstantBufferElement.html new file mode 100644 index 000000000..86d2330cc --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1ConstantBufferStructure.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1ConstantBufferStructure.html new file mode 100644 index 000000000..6eb1d3976 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1ConstantBufferStructure.html @@ -0,0 +1,129 @@ + + + + + cubos::core::gl::ConstantBufferStructure struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1CubeMapArrayDesc.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1CubeMapArrayDesc.html new file mode 100644 index 000000000..9ba77a23b --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1CubeMapDesc.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1CubeMapDesc.html new file mode 100644 index 000000000..554c28ba4 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc.html new file mode 100644 index 000000000..0a49830fc --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc.html @@ -0,0 +1,139 @@ + + + + + cubos::core::gl::DepthStencilStateDesc struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Depth.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Depth.html new file mode 100644 index 000000000..04041d3ad --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Stencil.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Stencil.html new file mode 100644 index 000000000..1debfed87 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1DepthStencilStateDesc_1_1Stencil_1_1Face.html b/pr-preview/pr-589/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-589/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-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc.html new file mode 100644 index 000000000..e525c4640 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1CubeMapArrayTarget.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1CubeMapArrayTarget.html new file mode 100644 index 000000000..b7972a915 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1CubeMapTarget.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1CubeMapTarget.html new file mode 100644 index 000000000..80a2d99ed --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1FramebufferTarget.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1FramebufferTarget.html new file mode 100644 index 000000000..d5d92dbe1 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1Texture2DArrayTarget.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1Texture2DArrayTarget.html new file mode 100644 index 000000000..8caacee98 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1Texture2DTarget.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1FramebufferDesc_1_1Texture2DTarget.html new file mode 100644 index 000000000..170f5125b --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1Material.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Material.html new file mode 100644 index 000000000..e47b89c34 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1RasterStateDesc.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1RasterStateDesc.html new file mode 100644 index 000000000..9adf52c96 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1RasterStateDesc.html @@ -0,0 +1,137 @@ + + + + + cubos::core::gl::RasterStateDesc struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1SamplerDesc.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1SamplerDesc.html new file mode 100644 index 000000000..9ae31660c --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1Texture1DDesc.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Texture1DDesc.html new file mode 100644 index 000000000..48ea16175 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Texture1DDesc.html @@ -0,0 +1,137 @@ + + + + + cubos::core::gl::Texture1DDesc struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Texture2DArrayDesc.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Texture2DArrayDesc.html new file mode 100644 index 000000000..4f12eab9b --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1Texture2DDesc.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Texture2DDesc.html new file mode 100644 index 000000000..d88c02c95 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Texture2DDesc.html @@ -0,0 +1,141 @@ + + + + + cubos::core::gl::Texture2DDesc struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Texture3DDesc.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Texture3DDesc.html new file mode 100644 index 000000000..7657c704c --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1gl_1_1Vertex.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Vertex.html new file mode 100644 index 000000000..a104bd809 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1Vertex.html @@ -0,0 +1,129 @@ + + + + + cubos::core::gl::Vertex struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1VertexArrayDesc.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1VertexArrayDesc.html new file mode 100644 index 000000000..2d9e5dee8 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1VertexArrayDesc.html @@ -0,0 +1,133 @@ + + + + + cubos::core::gl::VertexArrayDesc struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1VertexElement.html b/pr-preview/pr-589/structcubos_1_1core_1_1gl_1_1VertexElement.html new file mode 100644 index 000000000..c591be670 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1core_1_1io_1_1GamepadConnectionEvent.html b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1GamepadConnectionEvent.html new file mode 100644 index 000000000..e1444f34b --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1GamepadConnectionEvent.html @@ -0,0 +1,125 @@ + + + + + cubos::core::io::GamepadConnectionEvent struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1GamepadState.html b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1GamepadState.html new file mode 100644 index 000000000..17179b5d0 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1GamepadState.html @@ -0,0 +1,188 @@ + + + + + cubos::core::io::GamepadState struct | CUBOS. + + + + + + + +
    +
    +
    +
    +
    +

    + cubos::core::io::GamepadState struct +
    #include <core/io/gamepad.hpp>
    +

    +

    Holds the state of a gamepad.

    + +
    +

    Public functions

    +
    +
    + auto pressed(GamepadButton button) const -> bool +
    +
    Checks if a button is pressed.
    +
    + auto axis(GamepadAxis axis) const -> float +
    +
    Gets the value of an axis.
    +
    +
    +
    +

    Public variables

    +
    +
    + bool buttons +
    +
    Which buttons are pressed, indexed by GamepadButton.
    +
    + float axes +
    +
    Values of the axes, indexed by GamepadAxis.
    +
    +
    +
    +

    Function documentation

    +
    +

    + bool cubos::core::io::GamepadState::pressed(GamepadButton button) const +

    +

    Checks if a button is pressed.

    + + + + + + + + + + + + + + + + +
    Parameters
    buttonButton to check.
    ReturnsWhether it is pressed or not.
    +
    +
    +

    + float cubos::core::io::GamepadState::axis(GamepadAxis axis) const +

    +

    Gets the value of an axis.

    + + + + + + + + + + + + + + + + +
    Parameters
    axisAxis to get the value of.
    ReturnsValue of the axis.
    +
    +
    +
    +
    +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1KeyEvent.html b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1KeyEvent.html new file mode 100644 index 000000000..ad9734d4f --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1KeyEvent.html @@ -0,0 +1,125 @@ + + + + + cubos::core::io::KeyEvent struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1ModifiersEvent.html b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1ModifiersEvent.html new file mode 100644 index 000000000..9ce7bd2e8 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1ModifiersEvent.html @@ -0,0 +1,121 @@ + + + + + cubos::core::io::ModifiersEvent struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1MouseButtonEvent.html b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1MouseButtonEvent.html new file mode 100644 index 000000000..07654b474 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1MouseButtonEvent.html @@ -0,0 +1,125 @@ + + + + + cubos::core::io::MouseButtonEvent struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1MouseMoveEvent.html b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1MouseMoveEvent.html new file mode 100644 index 000000000..5fe5eb9ae --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1MouseMoveEvent.html @@ -0,0 +1,121 @@ + + + + + cubos::core::io::MouseMoveEvent struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1MouseScrollEvent.html b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1MouseScrollEvent.html new file mode 100644 index 000000000..b5ecd2c23 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1MouseScrollEvent.html @@ -0,0 +1,121 @@ + + + + + cubos::core::io::MouseScrollEvent struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1ResizeEvent.html b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1ResizeEvent.html new file mode 100644 index 000000000..bae024839 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1ResizeEvent.html @@ -0,0 +1,121 @@ + + + + + cubos::core::io::ResizeEvent struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1TextEvent.html b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1TextEvent.html new file mode 100644 index 000000000..38f452e9a --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1io_1_1TextEvent.html @@ -0,0 +1,121 @@ + + + + + cubos::core::io::TextEvent struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1memory_1_1RemoveReference.html b/pr-preview/pr-589/structcubos_1_1core_1_1memory_1_1RemoveReference.html new file mode 100644 index 000000000..45d63ed0c --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1memory_1_1RemoveReference.html @@ -0,0 +1,134 @@ + + + + + cubos::core::memory::RemoveReference struct | CUBOS. + + + + + + + +
    +
    +
    +
    +
    +

    +
    #include <core/memory/move.hpp>
    +
    template<typename T>
    + cubos::core::memory::RemoveReference struct +

    +

    Provides a type which is the same as the given type, but without any references.

    + + + + + + + + + + +
    Template parameters
    T
    + + +
    +

    Public types

    +
    +
    + using Type = T +
    +
    Type without references.
    +
    +
    +
    +
    +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1core_1_1reflection_1_1Reflect.html b/pr-preview/pr-589/structcubos_1_1core_1_1reflection_1_1Reflect.html new file mode 100644 index 000000000..9c68d9265 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1core_1_1reflection_1_1Reflect.html @@ -0,0 +1,114 @@ + + + + + cubos::core::reflection::Reflect struct | CUBOS. + + + + + + + +
    +
    +
    +
    +
    +

    +
    #include <core/reflection/reflect.hpp>
    +
    template<typename T>
    + cubos::core::reflection::Reflect struct +

    +

    Defines the reflection function for the given type T.

    + + + + + + + + + + +
    Template parameters
    TType to reflect.
    +

    By default, this function calls the static member function reflect of the type, which should return a pointer to an instance of Type.

    To implement reflection for your type, you should either:

    • Define a static member function reflect with return type const Type& on your type.
    • Specialize this struct for your type.

    The first option is preferred, as it is less verbose. However, when handling external types, to which member functions cannot be added, the second option is necessary.

    Both options can and should be shortened by using the macros:

    +
    +
    +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1ActiveCameras.html b/pr-preview/pr-589/structcubos_1_1engine_1_1ActiveCameras.html new file mode 100644 index 000000000..be9f7b8b2 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1engine_1_1Arguments.html b/pr-preview/pr-589/structcubos_1_1engine_1_1Arguments.html new file mode 100644 index 000000000..f50a815ba --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1Arguments.html @@ -0,0 +1,102 @@ + + + + + cubos::engine::Arguments struct | CUBOS. + + + + + + + +
    +
    +
    +
    +
    +

    + cubos::engine::Arguments struct +
    #include <engine/cubos.hpp>
    +

    +

    Resource which stores the command-line arguments.

    +

    This resource is added by the Cubos class.

    +
    +
    +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1AssetMeta_1_1Exclude.html b/pr-preview/pr-589/structcubos_1_1engine_1_1AssetMeta_1_1Exclude.html new file mode 100644 index 000000000..edeee668c --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1AssetMeta_1_1Exclude.html @@ -0,0 +1,121 @@ + + + + + cubos::engine::AssetMeta::Exclude struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1BoxCollider.html b/pr-preview/pr-589/structcubos_1_1engine_1_1BoxCollider.html new file mode 100644 index 000000000..3c0dd735a --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1engine_1_1BroadPhaseCollisions.html b/pr-preview/pr-589/structcubos_1_1engine_1_1BroadPhaseCollisions.html new file mode 100644 index 000000000..52fdd12c3 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1CandidateHash.html b/pr-preview/pr-589/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1CandidateHash.html new file mode 100644 index 000000000..ef810df4f --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1CandidateHash.html @@ -0,0 +1,101 @@ + + + + + cubos::engine::BroadPhaseCollisions::CandidateHash struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1SweepMarker.html b/pr-preview/pr-589/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1SweepMarker.html new file mode 100644 index 000000000..b7665f32a --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1BroadPhaseCollisions_1_1SweepMarker.html @@ -0,0 +1,125 @@ + + + + + cubos::engine::BroadPhaseCollisions::SweepMarker struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1Camera.html b/pr-preview/pr-589/structcubos_1_1engine_1_1Camera.html new file mode 100644 index 000000000..6b7a97465 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1Camera.html @@ -0,0 +1,130 @@ + + + + + cubos::engine::Camera struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1CapsuleCollider.html b/pr-preview/pr-589/structcubos_1_1engine_1_1CapsuleCollider.html new file mode 100644 index 000000000..72d528243 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1engine_1_1ColliderAABB.html b/pr-preview/pr-589/structcubos_1_1engine_1_1ColliderAABB.html new file mode 100644 index 000000000..5dcd2649e --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1engine_1_1DeltaTime.html b/pr-preview/pr-589/structcubos_1_1engine_1_1DeltaTime.html new file mode 100644 index 000000000..c7fbd31f3 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1engine_1_1DirectionalLight.html b/pr-preview/pr-589/structcubos_1_1engine_1_1DirectionalLight.html new file mode 100644 index 000000000..1cc444390 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1DirectionalLight.html @@ -0,0 +1,102 @@ + + + + + cubos::engine::DirectionalLight struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1LocalToWorld.html b/pr-preview/pr-589/structcubos_1_1engine_1_1LocalToWorld.html new file mode 100644 index 000000000..5df2028a4 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1engine_1_1PlaneCollider.html b/pr-preview/pr-589/structcubos_1_1engine_1_1PlaneCollider.html new file mode 100644 index 000000000..d19aef7bb --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1engine_1_1PointLight.html b/pr-preview/pr-589/structcubos_1_1engine_1_1PointLight.html new file mode 100644 index 000000000..d7803df4e --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1PointLight.html @@ -0,0 +1,102 @@ + + + + + cubos::engine::PointLight struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1Position.html b/pr-preview/pr-589/structcubos_1_1engine_1_1Position.html new file mode 100644 index 000000000..941e9ad04 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1Position.html @@ -0,0 +1,122 @@ + + + + + cubos::engine::Position struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1RenderableGrid.html b/pr-preview/pr-589/structcubos_1_1engine_1_1RenderableGrid.html new file mode 100644 index 000000000..a23fdf8ba --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1engine_1_1RendererEnvironment.html b/pr-preview/pr-589/structcubos_1_1engine_1_1RendererEnvironment.html new file mode 100644 index 000000000..dfc76f5bf --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1RendererEnvironment.html @@ -0,0 +1,125 @@ + + + + + cubos::engine::RendererEnvironment struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1RendererFrame_1_1DrawCmd.html b/pr-preview/pr-589/structcubos_1_1engine_1_1RendererFrame_1_1DrawCmd.html new file mode 100644 index 000000000..850369e72 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1RendererFrame_1_1DrawCmd.html @@ -0,0 +1,125 @@ + + + + + cubos::engine::RendererFrame::DrawCmd struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1Rotation.html b/pr-preview/pr-589/structcubos_1_1engine_1_1Rotation.html new file mode 100644 index 000000000..e5ae28046 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1Rotation.html @@ -0,0 +1,122 @@ + + + + + cubos::engine::Rotation struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1Scale.html b/pr-preview/pr-589/structcubos_1_1engine_1_1Scale.html new file mode 100644 index 000000000..188b3b2ea --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1Scale.html @@ -0,0 +1,122 @@ + + + + + cubos::engine::Scale struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1Scene.html b/pr-preview/pr-589/structcubos_1_1engine_1_1Scene.html new file mode 100644 index 000000000..d751827b2 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1engine_1_1ShouldQuit.html b/pr-preview/pr-589/structcubos_1_1engine_1_1ShouldQuit.html new file mode 100644 index 000000000..a1c2b34be --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1engine_1_1SimplexCollider.html b/pr-preview/pr-589/structcubos_1_1engine_1_1SimplexCollider.html new file mode 100644 index 000000000..69fca3aa0 --- /dev/null +++ b/pr-preview/pr-589/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-589/structcubos_1_1engine_1_1SpotLight.html b/pr-preview/pr-589/structcubos_1_1engine_1_1SpotLight.html new file mode 100644 index 000000000..b47478f71 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1SpotLight.html @@ -0,0 +1,102 @@ + + + + + cubos::engine::SpotLight struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1tools_1_1AssetSelectedEvent.html b/pr-preview/pr-589/structcubos_1_1engine_1_1tools_1_1AssetSelectedEvent.html new file mode 100644 index 000000000..7d8cee594 --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1tools_1_1AssetSelectedEvent.html @@ -0,0 +1,121 @@ + + + + + cubos::engine::tools::AssetSelectedEvent struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/structcubos_1_1engine_1_1tools_1_1EntitySelector.html b/pr-preview/pr-589/structcubos_1_1engine_1_1tools_1_1EntitySelector.html new file mode 100644 index 000000000..5d4fee6ba --- /dev/null +++ b/pr-preview/pr-589/structcubos_1_1engine_1_1tools_1_1EntitySelector.html @@ -0,0 +1,121 @@ + + + + + cubos::engine::tools::EntitySelector struct | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/system_8hpp.html b/pr-preview/pr-589/system_8hpp.html new file mode 100644 index 000000000..f2ddbae6f --- /dev/null +++ b/pr-preview/pr-589/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-589/thread__pool_8hpp.html b/pr-preview/pr-589/thread__pool_8hpp.html new file mode 100644 index 000000000..a5d2d0f8d --- /dev/null +++ b/pr-preview/pr-589/thread__pool_8hpp.html @@ -0,0 +1,130 @@ + + + + + core/thread_pool.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/tools_2asset__explorer_2plugin_8hpp.html b/pr-preview/pr-589/tools_2asset__explorer_2plugin_8hpp.html new file mode 100644 index 000000000..cacf7f372 --- /dev/null +++ b/pr-preview/pr-589/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-589/tools_2entity__inspector_2plugin_8hpp.html b/pr-preview/pr-589/tools_2entity__inspector_2plugin_8hpp.html new file mode 100644 index 000000000..0d74523cb --- /dev/null +++ b/pr-preview/pr-589/tools_2entity__inspector_2plugin_8hpp.html @@ -0,0 +1,132 @@ + + + + + engine/tools/entity_inspector/plugin.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/tools_2entity__selector_2plugin_8hpp.html b/pr-preview/pr-589/tools_2entity__selector_2plugin_8hpp.html new file mode 100644 index 000000000..fc3ad016f --- /dev/null +++ b/pr-preview/pr-589/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-589/tools_2scene__editor_2plugin_8hpp.html b/pr-preview/pr-589/tools_2scene__editor_2plugin_8hpp.html new file mode 100644 index 000000000..b20f19d56 --- /dev/null +++ b/pr-preview/pr-589/tools_2scene__editor_2plugin_8hpp.html @@ -0,0 +1,132 @@ + + + + + engine/tools/scene_editor/plugin.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/tools_2settings__inspector_2plugin_8hpp.html b/pr-preview/pr-589/tools_2settings__inspector_2plugin_8hpp.html new file mode 100644 index 000000000..4fd8e7e5d --- /dev/null +++ b/pr-preview/pr-589/tools_2settings__inspector_2plugin_8hpp.html @@ -0,0 +1,132 @@ + + + + + engine/tools/settings_inspector/plugin.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/tools_2world__inspector_2plugin_8hpp.html b/pr-preview/pr-589/tools_2world__inspector_2plugin_8hpp.html new file mode 100644 index 000000000..49deea16e --- /dev/null +++ b/pr-preview/pr-589/tools_2world__inspector_2plugin_8hpp.html @@ -0,0 +1,132 @@ + + + + + engine/tools/world_inspector/plugin.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/transform_2plugin_8hpp.html b/pr-preview/pr-589/transform_2plugin_8hpp.html new file mode 100644 index 000000000..afaf7ea18 --- /dev/null +++ b/pr-preview/pr-589/transform_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/transform/plugin.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/type_8hpp.html b/pr-preview/pr-589/type_8hpp.html new file mode 100644 index 000000000..0df04595e --- /dev/null +++ b/pr-preview/pr-589/type_8hpp.html @@ -0,0 +1,132 @@ + + + + + core/reflection/type.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/type__map_8hpp.html b/pr-preview/pr-589/type__map_8hpp.html new file mode 100644 index 000000000..e2cf68e4f --- /dev/null +++ b/pr-preview/pr-589/type__map_8hpp.html @@ -0,0 +1,133 @@ + + + + + core/memory/type_map.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/util_8hpp.html b/pr-preview/pr-589/util_8hpp.html new file mode 100644 index 000000000..f3c1afa79 --- /dev/null +++ b/pr-preview/pr-589/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-589/vec__storage_8hpp.html b/pr-preview/pr-589/vec__storage_8hpp.html new file mode 100644 index 000000000..a35d1795a --- /dev/null +++ b/pr-preview/pr-589/vec__storage_8hpp.html @@ -0,0 +1,133 @@ + + + + + core/ecs/vec_storage.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/vertex_8hpp.html b/pr-preview/pr-589/vertex_8hpp.html new file mode 100644 index 000000000..591c75136 --- /dev/null +++ b/pr-preview/pr-589/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-589/voxels_2plugin_8hpp.html b/pr-preview/pr-589/voxels_2plugin_8hpp.html new file mode 100644 index 000000000..5a6728dc9 --- /dev/null +++ b/pr-preview/pr-589/voxels_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/voxels/plugin.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/window_2plugin_8hpp.html b/pr-preview/pr-589/window_2plugin_8hpp.html new file mode 100644 index 000000000..c1b14e39a --- /dev/null +++ b/pr-preview/pr-589/window_2plugin_8hpp.html @@ -0,0 +1,130 @@ + + + + + engine/window/plugin.hpp file | CUBOS. + + + + + + + +
    +
    + + + +
    + + diff --git a/pr-preview/pr-589/window_8hpp.html b/pr-preview/pr-589/window_8hpp.html new file mode 100644 index 000000000..cc4dd4a73 --- /dev/null +++ b/pr-preview/pr-589/window_8hpp.html @@ -0,0 +1,218 @@ + + + + + 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.
    +
    + struct cubos::core::io::GamepadConnectionEvent +
    +
    Event sent when a gamepad is connected or disconnected.
    +
    + 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, GamepadConnectionEvent> +
    +
    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-589/world_8hpp.html b/pr-preview/pr-589/world_8hpp.html new file mode 100644 index 000000000..b6d66e1e6 --- /dev/null +++ b/pr-preview/pr-589/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.
    +
    +
    +
    +
    +
    +
    + + + +
    + +