2015-04-10 20:44:38 -04:00
|
|
|
#!/usr/bin/env python3
|
|
|
|
#
|
|
|
|
# SuperTuxKart - a fun racing game with go-kart
|
|
|
|
# Copyright (C) 2006-2015 SuperTuxKart-Team
|
|
|
|
#
|
|
|
|
# This program is free software; you can redistribute it and/or
|
|
|
|
# modify it under the terms of the GNU General Public License
|
|
|
|
# as published by the Free Software Foundation; either version 3
|
|
|
|
# of the License, or (at your option) any later version.
|
|
|
|
#
|
|
|
|
# This program is distributed in the hope that it will be useful,
|
|
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
# GNU General Public License for more details.
|
|
|
|
#
|
|
|
|
# You should have received a copy of the GNU General Public License
|
|
|
|
# along with this program; if not, write to the Free Software
|
|
|
|
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
|
|
|
2015-08-16 09:48:27 -04:00
|
|
|
# This script creates code for the characteristics.
|
2015-04-16 11:50:17 -04:00
|
|
|
# It takes an argument that specifies what the output of the script should be.
|
2015-04-18 18:11:39 -04:00
|
|
|
# The output options can be seen by running this script without arguments.
|
2015-11-21 16:53:21 -05:00
|
|
|
# A more convenient version to update the code is to run update_characteristics.py
|
2015-04-16 11:50:17 -04:00
|
|
|
|
|
|
|
import sys
|
|
|
|
|
|
|
|
# Input data
|
2015-10-03 11:45:25 -04:00
|
|
|
# Each line contains a topic and the attributes of that topic.
|
|
|
|
# This model is used for the xml file and to access the kart properties in the code.
|
2015-08-16 09:48:27 -04:00
|
|
|
characteristics = """Suspension: stiffness, rest, travel, expSpringResponse(bool), maxForce
|
2015-04-16 11:50:17 -04:00
|
|
|
Stability: rollInfluence, chassisLinearDamping, chassisAngularDamping, downwardImpulseFactor, trackConnectionAccel, smoothFlyingImpulse
|
|
|
|
Turn: radius(InterpolationArray), timeResetSteer, timeFullSteer(InterpolationArray)
|
|
|
|
Engine: power, maxSpeed, brakeFactor, brakeTimeIncrease, maxSpeedReverseRatio
|
|
|
|
Gear: switchRatio(std::vector<float>/floatVector), powerIncrease(std::vector<float>/floatVector)
|
|
|
|
Mass
|
2015-08-16 10:23:06 -04:00
|
|
|
Wheels: dampingRelaxation, dampingCompression
|
2015-04-16 11:50:17 -04:00
|
|
|
Camera: distance, forwardUpAngle, backwardUpAngle
|
|
|
|
Jump: animationTime
|
|
|
|
Lean: max, speed
|
|
|
|
Anvil: duration, weight, speedFactor
|
2015-07-11 19:29:17 -04:00
|
|
|
Parachute: friction, duration, durationOther, lboundFraction, uboundFraction, maxSpeed
|
2015-04-16 11:50:17 -04:00
|
|
|
Bubblegum: duration, speedFraction, torque, fadeInTime, shieldDuration
|
2015-07-11 13:17:24 -04:00
|
|
|
Zipper: duration, force, speedGain, maxSpeedIncrease, fadeOutTime
|
2015-04-16 11:50:17 -04:00
|
|
|
Swatter: duration, distance, squashDuration, squashSlowdown
|
2015-07-11 13:17:24 -04:00
|
|
|
Plunger: bandMaxLength, bandForce, bandDuration, bandSpeedIncrease, bandFadeOutTime, inFaceTime
|
2015-04-16 11:50:17 -04:00
|
|
|
Startup: time(std::vector<float>/floatVector), boost(std::vector<float>/floatVector)
|
|
|
|
Rescue: duration, vertOffset, height
|
|
|
|
Explosion: duration, radius, invulnerabilityTime
|
|
|
|
Nitro: duration, engineForce, consumption, smallContainer, bigContainer, maxSpeedIncrease, fadeOutTime, max
|
2015-11-21 16:53:21 -05:00
|
|
|
Slipstream: duration, length, width, collectTime, useTime, addPower, minSpeed, maxSpeedIncrease, fadeOutTime
|
2015-11-21 17:27:00 -05:00
|
|
|
Skid: increase, decrease, max, timeTillMax, visual, visualTime, revertVisualTime, minSpeed, timeTillBonus(std::vector<float>/floatVector), bonusSpeed(std::vector<float>/floatVector), bonusTime(std::vector<float>/floatVector), bonusForce(std::vector<float>/floatVector), physicalJumpTime, graphicalJumpTime, postSkidRotateFactor, reduceTurnMin, reduceTurnMax, enabled(bool)"""
|
2015-04-16 11:50:17 -04:00
|
|
|
|
2015-10-03 11:45:25 -04:00
|
|
|
""" A GroupMember is an attribute of a group.
|
|
|
|
In the xml files, a value will be assigned to it.
|
|
|
|
If the name of the attribute is 'value', the getter method will only
|
|
|
|
contain the group name and 'value' will be omitted (e.g. used for mass). """
|
2015-04-15 03:01:23 -04:00
|
|
|
class GroupMember:
|
|
|
|
def __init__(self, name, typeC, typeStr):
|
|
|
|
self.name = name
|
2015-07-11 13:17:24 -04:00
|
|
|
if name == "value":
|
|
|
|
self.getName = ""
|
|
|
|
else:
|
|
|
|
self.getName = name
|
2015-04-15 03:01:23 -04:00
|
|
|
self.typeC = typeC
|
|
|
|
self.typeStr = typeStr
|
|
|
|
|
2015-08-16 09:48:27 -04:00
|
|
|
""" E.g. power(std::vector<float>/floatVector)
|
|
|
|
or speed(InterpolationArray)
|
|
|
|
The default type is float
|
|
|
|
The name 'value' is special: Only the group name will be used to access
|
|
|
|
the member but in the xml file it will be still value (because we
|
|
|
|
need a name). """
|
2015-04-15 03:01:23 -04:00
|
|
|
def parse(content):
|
|
|
|
typeC = "float"
|
|
|
|
typeStr = typeC
|
|
|
|
name = content.strip()
|
|
|
|
pos = content.find("(")
|
|
|
|
end = content.find(")", pos)
|
|
|
|
if pos != -1 and end != -1:
|
|
|
|
name = content[:pos].strip()
|
|
|
|
pos2 = content.find("/", pos, end)
|
|
|
|
if pos2 != -1:
|
|
|
|
typeC = content[pos + 1:pos2].strip()
|
|
|
|
typeStr = content[pos2 + 1:end].strip()
|
|
|
|
else:
|
|
|
|
typeC = content[pos + 1:end].strip()
|
|
|
|
typeStr = typeC
|
|
|
|
|
|
|
|
return GroupMember(name, typeC, typeStr)
|
|
|
|
|
2015-10-03 11:45:25 -04:00
|
|
|
""" A Group has a base name and can contain GroupMembers.
|
|
|
|
In the xml files, a group is a tag. """
|
2015-04-10 20:44:38 -04:00
|
|
|
class Group:
|
|
|
|
def __init__(self, baseName):
|
|
|
|
self.baseName = baseName
|
2015-04-15 03:01:23 -04:00
|
|
|
self.members = []
|
|
|
|
|
2015-10-03 11:45:25 -04:00
|
|
|
""" Parses and adds a member to this group """
|
2015-04-15 03:01:23 -04:00
|
|
|
def addMember(self, content):
|
|
|
|
self.members.append(GroupMember.parse(content))
|
|
|
|
|
2015-04-16 11:50:17 -04:00
|
|
|
def getBaseName(self):
|
|
|
|
return self.baseName
|
|
|
|
|
2015-08-16 09:48:27 -04:00
|
|
|
""" E.g. engine: power, gears(std::vector<Gear>/Gears)
|
|
|
|
or mass(float) or only mass """
|
2015-04-15 03:01:23 -04:00
|
|
|
def parse(content):
|
|
|
|
pos = content.find(":")
|
|
|
|
if pos == -1:
|
2015-07-11 13:17:24 -04:00
|
|
|
group = Group(content)
|
|
|
|
group.addMember("value")
|
2015-04-15 03:01:23 -04:00
|
|
|
return group
|
|
|
|
else:
|
|
|
|
group = Group(content[:pos].strip())
|
|
|
|
for m in content[pos + 1:].split(","):
|
|
|
|
group.addMember(m)
|
|
|
|
return group
|
2015-04-10 20:44:38 -04:00
|
|
|
|
2015-08-16 09:48:27 -04:00
|
|
|
""" Creates a list of words from a titlecase string """
|
2015-04-10 20:44:38 -04:00
|
|
|
def toList(name):
|
|
|
|
result = []
|
|
|
|
cur = ""
|
|
|
|
for c in name:
|
|
|
|
if c.isupper() and len(cur) != 0:
|
|
|
|
result.append(cur)
|
|
|
|
cur = ""
|
|
|
|
cur += c.lower()
|
|
|
|
if len(cur) != 0:
|
|
|
|
result.append(cur)
|
|
|
|
return result
|
|
|
|
|
2015-08-16 09:48:27 -04:00
|
|
|
""" titleCase: true = result is titlecase
|
|
|
|
false = result has underscores """
|
2015-04-15 03:01:23 -04:00
|
|
|
def joinSubName(group, member, titleCase):
|
2015-07-11 13:17:24 -04:00
|
|
|
words = toList(group.baseName) + toList(member.getName)
|
2015-04-10 20:44:38 -04:00
|
|
|
first = True
|
|
|
|
if titleCase:
|
2015-04-16 11:50:17 -04:00
|
|
|
words = [w.title() for w in words]
|
2015-04-10 20:44:38 -04:00
|
|
|
return "".join(words)
|
|
|
|
else:
|
|
|
|
return "_".join(words)
|
|
|
|
|
2015-11-28 20:16:07 -05:00
|
|
|
# Functions to generate code
|
2015-04-16 11:50:17 -04:00
|
|
|
|
2015-11-28 20:16:07 -05:00
|
|
|
def createEnum(groups):
|
|
|
|
for g in groups:
|
|
|
|
print()
|
|
|
|
print(" // {0}".format(g.getBaseName().title()))
|
|
|
|
for m in g.members:
|
|
|
|
print(" {0},".format(joinSubName(g, m, False).upper()))
|
|
|
|
|
|
|
|
def createAcDefs(groups):
|
|
|
|
for g in groups:
|
|
|
|
print()
|
|
|
|
for m in g.members:
|
|
|
|
nameTitle = joinSubName(g, m, True)
|
|
|
|
nameUnderscore = joinSubName(g, m, False)
|
|
|
|
typeC = m.typeC
|
|
|
|
|
|
|
|
print(" {0} get{1}() const;".
|
|
|
|
format(typeC, nameTitle, nameUnderscore))
|
2015-04-10 20:44:38 -04:00
|
|
|
|
2015-11-28 20:16:07 -05:00
|
|
|
def createAcGetter(groups):
|
2015-04-18 18:11:39 -04:00
|
|
|
for g in groups:
|
|
|
|
for m in g.members:
|
2015-11-28 20:16:07 -05:00
|
|
|
nameTitle = joinSubName(g, m, True)
|
|
|
|
nameUnderscore = joinSubName(g, m, False)
|
|
|
|
typeC = m.typeC
|
|
|
|
result = "result"
|
|
|
|
|
|
|
|
print("""// ----------------------------------------------------------------------------
|
2015-10-03 11:15:49 -04:00
|
|
|
{3} AbstractCharacteristic::get{1}() const
|
2015-04-16 11:50:17 -04:00
|
|
|
{{
|
|
|
|
{0} result;
|
2015-04-18 20:56:15 -04:00
|
|
|
bool is_set = false;
|
|
|
|
process({2}, &result, &is_set);
|
|
|
|
if (!is_set)
|
2015-10-03 11:15:49 -04:00
|
|
|
Log::fatal("AbstractCharacteristic", "Can't get characteristic %s",
|
|
|
|
getName({2}).c_str());
|
2015-04-16 11:50:17 -04:00
|
|
|
return {4};
|
2015-10-03 11:15:49 -04:00
|
|
|
}} // get{1}
|
2015-04-16 11:50:17 -04:00
|
|
|
""".format(m.typeC, nameTitle, nameUnderscore.upper(), typeC, result))
|
2015-11-28 20:16:07 -05:00
|
|
|
|
|
|
|
def createKpDefs(groups):
|
|
|
|
for g in groups:
|
|
|
|
print()
|
|
|
|
for m in g.members:
|
|
|
|
nameTitle = joinSubName(g, m, True)
|
|
|
|
nameUnderscore = joinSubName(g, m, False)
|
|
|
|
typeC = m.typeC
|
|
|
|
|
|
|
|
print(" {0} get{1}() const;".
|
|
|
|
format(typeC, nameTitle, nameUnderscore))
|
|
|
|
|
|
|
|
def createKpGetter(groups):
|
|
|
|
for g in groups:
|
|
|
|
for m in g.members:
|
|
|
|
nameTitle = joinSubName(g, m, True)
|
|
|
|
nameUnderscore = joinSubName(g, m, False)
|
|
|
|
typeC = m.typeC
|
|
|
|
result = "result"
|
|
|
|
|
|
|
|
print("""// ----------------------------------------------------------------------------
|
|
|
|
{1} KartProperties::get{0}() const
|
|
|
|
{{
|
|
|
|
return m_cached_characteristic->get{0}();
|
|
|
|
}} // get{0}
|
|
|
|
""".format(nameTitle, typeC))
|
|
|
|
|
|
|
|
def createGetType(groups):
|
|
|
|
for g in groups:
|
|
|
|
for m in g.members:
|
|
|
|
nameTitle = joinSubName(g, m, True)
|
|
|
|
nameUnderscore = joinSubName(g, m, False)
|
|
|
|
print(" case {0}:\n return TYPE_{1};".
|
|
|
|
format(nameUnderscore.upper(), "_".join(toList(m.typeStr)).upper()))
|
|
|
|
|
|
|
|
def createGetName(groups):
|
|
|
|
for g in groups:
|
|
|
|
for m in g.members:
|
|
|
|
nameTitle = joinSubName(g, m, True)
|
|
|
|
nameUnderscore = joinSubName(g, m, False).upper()
|
|
|
|
print(" case {0}:\n return \"{0}\";".
|
|
|
|
format(nameUnderscore))
|
|
|
|
|
|
|
|
def createLoadXml(groups):
|
|
|
|
for g in groups:
|
|
|
|
print(" if (const XMLNode *sub_node = node->getNode(\"{0}\"))\n {{".
|
|
|
|
format(g.baseName.lower()))
|
|
|
|
for m in g.members:
|
|
|
|
nameUnderscore = joinSubName(g, m, False)
|
|
|
|
nameMinus = "-".join(toList(m.name))
|
|
|
|
print(""" sub_node->get(\"{0}\",
|
2015-10-03 11:15:49 -04:00
|
|
|
&m_values[{1}]);""".
|
2015-11-28 20:16:07 -05:00
|
|
|
format(nameMinus, nameUnderscore.upper()))
|
|
|
|
print(" }\n")
|
|
|
|
|
|
|
|
# Dicionary that maps an argument string to a tupel of
|
|
|
|
# a generator function, a help string and a filename
|
|
|
|
functions = {
|
|
|
|
"enum": (createEnum, "List the enum values for all characteristics", "karts/abstract_characteristic.hpp"),
|
|
|
|
"acdefs": (createAcDefs, "Create the header function definitions", "karts/abstract_characteristic.hpp"),
|
|
|
|
"acgetter": (createAcGetter, "Implement the getters", "karts/abstract_characteristic.cpp"),
|
|
|
|
"getType": (createGetType, "Implement the getType function", "karts/abstract_characteristic.cpp"),
|
|
|
|
"getName": (createGetName, "Implement the getName function", "karts/abstract_characteristic.cpp"),
|
|
|
|
"kpdefs": (createKpDefs, "Create the header function definitions for the getters", "karts/kart_properties.hpp"),
|
|
|
|
"kpgetter": (createKpGetter, "Implement the getters", "karts/kart_properties.cpp"),
|
|
|
|
"loadXml": (createLoadXml, "Code to load the characteristics from an xml file", "karts/xml_characteristic.hpp"),
|
|
|
|
}
|
|
|
|
|
|
|
|
def main():
|
|
|
|
# Find out what to do
|
|
|
|
if len(sys.argv) != 2:
|
|
|
|
print("""Usage: ./create_kart_properties.py <operation>
|
|
|
|
Operations:""")
|
|
|
|
maxOperationLength = 0
|
|
|
|
maxDescriptionLength = 0
|
|
|
|
for o, f in functions.items():
|
|
|
|
l = len(o)
|
|
|
|
if l > maxOperationLength:
|
|
|
|
maxOperationLength = l
|
|
|
|
l = len(f[1])
|
|
|
|
if l > maxDescriptionLength:
|
|
|
|
maxDescriptionLength = l
|
|
|
|
|
|
|
|
formatString = " {{0:{0}}} {{1:{1}}} in {{2}}".format(maxOperationLength, maxDescriptionLength)
|
|
|
|
for o, f in functions.items():
|
|
|
|
print(formatString.format(o, f[1], f[2]))
|
|
|
|
return
|
|
|
|
|
|
|
|
task = sys.argv[1]
|
|
|
|
|
|
|
|
if task not in functions:
|
|
|
|
print("The wanted operation was not found. Please call this script without arguments to list available arguments.")
|
|
|
|
return
|
|
|
|
|
|
|
|
# Parse properties
|
|
|
|
groups = [Group.parse(line) for line in characteristics.split("\n")]
|
|
|
|
|
|
|
|
# Create the wanted code
|
|
|
|
functions[task][0](groups)
|
2015-04-13 05:10:18 -04:00
|
|
|
|
2015-04-10 20:44:38 -04:00
|
|
|
if __name__ == '__main__':
|
|
|
|
main()
|
2015-04-16 11:50:17 -04:00
|
|
|
|