Elaztek Developer Hub
Blamite Game Engine - blam!  00388.06.24.23.2301.blamite
The core library for the Blamite Game Engine.
tag_io.h
Go to the documentation of this file.
1 #pragma once
2 
3 #include <string>
4 
5 #include <Strings/components/diagnostics/errors/errors.h>
6 
7 #ifdef BLAM_EXPORTS
8 #define BLAM_EXT_API __declspec(dllexport)
9 #else
10 #define BLAM_EXT_API __declspec(dllimport)
11 #endif
12 
13 #ifndef BLAM
14 #define BLAM
15 #endif
16 
17 class BlamTagData;
18 
19 namespace Blam::Content::Tags
20 {
29  BLAM_EXT_API void AddExtraTagFolder(std::string tag_folder);
30 
36  BLAM void LoadReferencedTags(std::string tag_path);
37 
42 
56  BLAM BlamResult LoadTagFromFile(std::string tag_path, bool reload_if_already_loaded = true);
57 
58  BLAM BlamResult LoadTagFromMemoryBlock(char* address, int size, std::string tag_path, bool reload_if_already_loaded = true);
59 
67  BLAM BlamResult SaveTag(std::string tag_path);
68 
76  BLAM bool TagNeedsPostprocess(BlamTagData tag_data);
77 
90  BLAM void TagPostprocess(BlamTagData tag_data);
91 }
tag_block::entry_size
int entry_size
The size of each block entry.
Definition: tags.h:129
Blam::World::GetWorldState
BLAM_EXT_API BlamWorldState * GetWorldState()
Retrieves the current world state.
Definition: world.cpp:44
Blam::Content::Tags::GetFieldName
BLAM std::string GetFieldName(BlamPluginFieldType type)
Generates a string representation of a plugin field type.
Definition: fields.cpp:3
Blam::Settings::Config::GetEngineConfiguration
BLAM BlamConfigurationFile * GetEngineConfiguration()
Definition: config.cpp:58
tag_io.h
BlamWorldState::AddObject
void AddObject(BlamWorldObject *object)
Definition: BlamWorldState.cpp:70
Blam::Content::Tags::TagPostprocess
BLAM void TagPostprocess(BlamTagData tag_data)
Performs any required post-processing for a given tag.
Definition: tag_postprocess.cpp:27
Blam::Content::Tags::SaveTag
BLAM BlamResult SaveTag(std::string tag_path)
Saves a tag data to a file.
Definition: tag_io.cpp:627
BLAM_EXT_API
#define BLAM_EXT_API
Definition: tag_io.h:10
Blam::Content::Tags
Namespace containing functions related to tag data.
Definition: bitmap.h:151
primitive
Definition: primitive.h:11
tag_block::entry_data_address
void * entry_data_address
The address of the blocks' entry data.
Definition: tags.h:131
Blam::Logger::LogEvent
BLAM void LogEvent(std::string message)
Logs a message to the log and/or console.
Definition: aliases.cpp:142
BlamPluginFieldType::Real
@ Real
tag_block< void >
LoadTagDataSection
void * LoadTagDataSection(int offset, int size, std::ifstream *tag_file)
Loads a tag data section from a file.
Definition: tag_io.cpp:82
logger.h
tag_reference::GetTagPath
std::string GetTagPath()
Retrieves the path of the tag that this tagref refers to.
Definition: tag_reference.cpp:63
BlamEngineDataFolder::Tags
@ Tags
Directory used for reading engine tags. Defaults to ./tags/
active_scenario_tag_data
BlamTagData * active_scenario_tag_data
Definition: scenario.cpp:10
BlamTagData::path
char path[256]
The tag's path.
Definition: tags.h:46
world.h
BlamPluginFieldType::Bitfield16
@ Bitfield16
Blam::Content::Tags::LoadTagFromFile
BLAM BlamResult LoadTagFromFile(std::string tag_path, bool reload_if_already_loaded=true)
Loads a tag from the engine's tag directory (default is '.
Definition: tag_io.cpp:194
tag_reference::data_size
int data_size
The size of tagref_address.
Definition: tags.h:190
BuildTagDataSection
std::vector< char > BuildTagDataSection(void *section_data, int size, int start_offset)
Prepares a tag data section for saving.
Definition: tag_io.cpp:569
Blam::Content::Tags::GetTagClass
BLAM_EXT_API BlamTagClass * GetTagClass(std::string id)
Retrieves a tag class that matches the given string.
Definition: tagclass.cpp:66
BlamPluginFieldType::Bitfield32
@ Bitfield32
USER_DATA_PATH
#define USER_DATA_PATH(path)
Macro to quickly access a user data folder.
Definition: config.h:43
BLAM
#define BLAM
Definition: tag_io.h:14
scenario.h
Blam::Content::Tags::GetActiveScenarioTag
BLAM_EXT_API scenario * GetActiveScenarioTag()
Retrieves the currently loaded scenario tag.
Definition: scenario.cpp:72
scenario
Definition: scenario.h:11
BlamPluginFieldType::Enum32
@ Enum32
BlamPluginFieldType::Enum16
@ Enum16
active_scenario_tag
scenario * active_scenario_tag
Definition: scenario.cpp:9
BlamTagData::SetTagPath
bool SetTagPath(std::string new_path)
Updates the tag path.
Definition: BlamTagData.cpp:12
Blam3DPrimitiveType::Cuboid
@ Cuboid
BlamTagClass::class_name_short
std::string class_name_short
The short, 4-character name of the tag class.
Definition: tags.h:90
ENGINE_DATA_PATH
#define ENGINE_DATA_PATH(path)
Macro to quickly access a game engine data folder.
Definition: config.h:36
Blam::EngineDefs::GetVersion
const BLAM char * GetVersion()
Retrieves the version of the engine in the following format:
Definition: engine_definitions.cpp:150
tag_block::entry_count
int entry_count
The number of entries within the tag block.
Definition: tags.h:132
BlamTagClass::version
int version
The tag class version. Should be incremented any time a tag class is modified whatsoever.
Definition: tags.h:91
BlamPluginFieldType::Ascii
@ Ascii
BlamPluginFieldType::Unspecified
@ Unspecified
tag_reference
Structure representing a tag reference.
Definition: tags.h:182
BlamPluginFieldType::Enum8
@ Enum8
BlamTagClass::class_name_long
std::string class_name_long
The longer class name. Typically shown alongside short name for user-friendliness.
Definition: tags.h:89
Blam::Content::Tags::LoadTagFromMemoryBlock
BLAM BlamResult LoadTagFromMemoryBlock(char *address, int size, std::string tag_path, bool reload_if_already_loaded=true)
Definition: tag_io.cpp:395
BlamPluginFieldType::Boolean
@ Boolean
BlamPluginFieldType::Vector3
@ Vector3
Blam::Content::Tags::GetTagData
BLAM BlamTagData * GetTagData(std::string tag_path)
Retrieves information for a given tag.
Definition: tags.cpp:80
extra_tag_search_folders
std::vector< std::string > extra_tag_search_folders
Definition: tag_io.cpp:16
Blam::Content::Tags::ResolveAllTagReferences
BLAM void ResolveAllTagReferences()
Attempts to resolve all tag references within all loaded tags.
Definition: tags.cpp:72
Blam::Content::Tags::GetLoadedTags
BLAM std::vector< BlamTagData > * GetLoadedTags()
Retrieves the list of loaded tag data.
Definition: tags.cpp:142
BlamPluginFieldType::Int32
@ Int32
LoadSectionTagReferences
void LoadSectionTagReferences(char *address, int size, std::string tag_path)
Attempts to resolve any tag references within the given tag data section.
Definition: tag_io.cpp:25
TagOrigin::Memory
@ Memory
Indicates the tag originated from the engine's memory.
BlamWorldObject_Primitive
Class representing a primitive-based world object.
Definition: world_objects.h:99
engine_definitions.h
tag_reference::data_is_tag
bool data_is_tag
Whether or not tagref_address points to tag data, or the tag's path.
Definition: tags.h:188
Blam::Content::Tags::LoadScenarioTag
BLAM_EXT_API void LoadScenarioTag(std::string tag_path)
Loads a new scenario tag.
Definition: scenario.cpp:77
data_reference::data_address
void * data_address
The address of the referenced data.
Definition: tags.h:235
BlamPluginFieldType::Int16
@ Int16
Blam::Content::Tags::LoadReferencedTags
BLAM void LoadReferencedTags(std::string tag_path)
Attempts to resolve any tag references within a given tag.
Definition: tag_io.cpp:57
Blam3DPrimitiveType::Cylinder
@ Cylinder
BlamPluginFieldType::DataReference
@ DataReference
BlamPluginFieldType::TagReference
@ TagReference
data_reference
Structure representing a data reference.
Definition: tags.h:232
tag_reference::HasReference
bool HasReference()
Checks if a tag reference has a tag specified or not.
Definition: tag_reference.cpp:87
BlamPluginFieldType::Vector2
@ Vector2
Blam::Content::Tags::TagNeedsPostprocess
BLAM bool TagNeedsPostprocess(BlamTagData tag_data)
Checks if a given tag requires additional post-processing.
Definition: tag_postprocess.cpp:8
BlamPluginFieldType
BlamPluginFieldType
Enumerator listing all possible plugin field types.
Definition: BlamTagClassField.h:14
BlamTagClass::tag_size
int tag_size
The size of the tag's data. Used on loading/writing tag files.
Definition: tags.h:96
Blam::World::InitializeEmptyWorldState
BLAM void InitializeEmptyWorldState()
Initializes a new world state with no default objects.
Definition: world.cpp:23
data_reference::data_size
int data_size
The size of the referenced data.
Definition: tags.h:236
BlamPluginFieldType::Block
@ Block
Blam::Content::Tags::CleanupTagData
BLAM void CleanupTagData()
Releases all memory used by tags.
Definition: tags.cpp:130
BlamTagData::address
void * address
The address pointing to the start of the tag's data.
Definition: tags.h:33
tagclass.h
config.h
BlamPluginFieldType::Color
@ Color
BlamPluginFieldType::Comment
@ Comment
tags.h
BlamTagData::origin
TagOrigin origin
The origin of the tag.
Definition: tags.h:48
TagOrigin::BinaryFile
@ BinaryFile
Indicates the tag originated from a binary file.
BlamTagData
Class used to contain and access tag data.
Definition: tags.h:30
tag_reference::tagref_address
void * tagref_address
The address of the tagref data.
Definition: tags.h:187
PrepareNewWorldState
void PrepareNewWorldState()
Prepares a new world state.
Definition: scenario.cpp:17
Blam::Content::Tags::AddExtraTagFolder
BLAM_EXT_API void AddExtraTagFolder(std::string tag_folder)
Adds an additional folder to search when attempting to load a tag.
Definition: tag_io.cpp:52
BlamUserDataFolder::Tags
@ Tags
Directory storing user-created tags. Defaults to {DataRoot}/tags/.
BlamTagData::size
int size
The size of the tag's data in memory.
Definition: tags.h:34
tag_reference::ResolveReference
bool ResolveReference()
Attempts to resolve a tag reference.
Definition: tag_reference.cpp:25
BlamPluginFieldType::Int8
@ Int8
BlamWorldState
Class representing a world state.
Definition: world_objects.h:125
BlamPluginFieldType::Vector4
@ Vector4
BlamTagClass
Class representing a tag class.
Definition: tags.h:86
BlamPluginFieldType::Bitfield8
@ Bitfield8
BlamTagData::tag_class
std::string tag_class
The tag's short class name.
Definition: tags.h:47