1 /* Copyright (C) 2022 Wildfire Games.
2 * This file is part of 0 A.D.
4 * 0 A.D. is free software: you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation, either version 2 of the License, or
7 * (at your option) any later version.
9 * 0 A.D. is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with 0 A.D. If not, see <http://www.gnu.org/licenses/>.
19 ///////////////////////////////////////////////
22 Basically represents a set of terrain attributes loaded from XML. These
23 objects are organized in an inheritance tree, determined at load time.
27 #ifndef INCLUDED_TERRAINPROPERTIES
28 #define INCLUDED_TERRAINPROPERTIES
33 #include "lib/file/vfs/vfs_path.h"
38 class CTerrainProperties
;
40 typedef std::shared_ptr
<CTerrainProperties
> CTerrainPropertiesPtr
;
42 class CTerrainProperties
45 typedef std::vector
<CTerrainGroup
*> GroupVector
;
48 CTerrainPropertiesPtr m_pParent
;
50 // BGRA color of topmost mipmap level, for coloring minimap, or a color
51 // manually specified in the Terrain XML (or by any parent)
52 // ..Valid is true if the base color is specified in this terrain XML
53 // No caching here, since ideally, a saved XML file of an object should
54 // produce be equivalent to the source file
58 // Orientation of texture (in radians) (default pi/4 = 45 degrees)
61 // Size of texture in metres (default 32m = 8 tiles)
64 // All terrain type groups we're a member of
68 CTerrainProperties(CTerrainPropertiesPtr parent
);
70 // Create a new object and load the XML file specified. Returns NULL upon
72 // The parent pointer may be NULL, for the "root" terrainproperties object.
73 static CTerrainPropertiesPtr
FromXML(const CTerrainPropertiesPtr
& parent
, const VfsPath
& pathname
);
75 void LoadXml(XMBElement node
, CXeromyces
*pFile
, const VfsPath
& pathname
);
77 // Save the object to an XML file. Implement when needed! ;-)
78 // bool WriteXML(const CStr& path);
80 inline CTerrainPropertiesPtr
GetParent() const
85 // Return true if this property object or any of its parents has a basecolor
86 // override (mmap attribute in the XML file)
88 // Return the minimap color specified in this property object or in any of
89 // its parents. If no minimap color is specified, return garbage.
90 // Use HasBaseColor() to see if the value is valid.
91 // The color value is in BGRA format
94 float GetTextureAngle()
96 return m_TextureAngle
;
99 float GetTextureSize()
101 return m_TextureSize
;
104 const GroupVector
&GetGroups() const