XML Loader's done

This commit is contained in:
Caspian Rychlik-Prince 2004-04-20 19:40:54 +00:00
parent 0fb0abe573
commit ca0a661a62
2 changed files with 358 additions and 1 deletions

View File

@ -31,13 +31,27 @@
*/
package org.lwjgl.util.model.loader;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import org.lwjgl.util.model.Frame;
import org.lwjgl.util.model.Model;
import org.lwjgl.util.model.Skin;
import org.lwjgl.util.model.Triangle;
import org.lwjgl.util.model.Vertex;
import org.lwjgl.util.vector.Matrix4f;
import org.lwjgl.util.vector.Vector2f;
import org.lwjgl.util.vector.Vector3f;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
/**
* $Id$
*
* Loads a Model from an XML document.
* Loads a Model from an XML document. Construct with an XML Document as the argument,
* and then retrieve the Model by calling load().
*
* @author $Author$
* @version $Revision$
@ -60,6 +74,191 @@ public class Loader {
* @throws Exception
*/
public Model load() throws Exception {
return new Model(
XMLUtil.getString(src.getDocumentElement(), "material"),
loadVertices(),
loadTriangles(),
loadAnimations(XMLUtil.getInt(src.getDocumentElement(), "bones"))
);
}
/**
* Load all the Vertices
* @return Vertex[]
* @throws Exception
*/
private Vertex[] loadVertices() throws Exception {
List vertexElements = XMLUtil.getChildren(src.getDocumentElement(), "vertex");
Vertex[] vertices = new Vertex[vertexElements.size()];
int vertexCount = 0;
for (Iterator i = vertexElements.iterator(); i.hasNext(); ) {
Element vertexElement = (Element) i.next();
vertices[vertexCount++] = loadVertex(vertexElement);
}
return vertices;
}
/**
* Load all the Triangles
* @return Triangle[]
* @throws Exception
*/
private Triangle[] loadTriangles() throws Exception {
List triangleElements = XMLUtil.getChildren(src.getDocumentElement(), "triangle");
Triangle[] triangles = new Triangle[triangleElements.size()];
int triangleCount = 0;
for (Iterator i = triangleElements.iterator(); i.hasNext(); ) {
Element triangleElement = (Element) i.next();
triangles[triangleCount++] = loadTriangle(triangleElement);
}
return triangles;
}
/**
* Load all the animations
* @param numBones The number of bones in the animations
* @return Map of animation names to Frame[] animations
* @throws Exception
*/
private Map loadAnimations(int numBones) throws Exception {
List animationElements = XMLUtil.getChildren(src.getDocumentElement(), "animation");
Map animations = new HashMap(animationElements.size());
for (Iterator i = animationElements.iterator(); i.hasNext(); ) {
Element animationElement = (Element) i.next();
animations.put(XMLUtil.getString(animationElement, "name"), loadAnimation(animationElement, numBones));
}
return animations;
}
/**
* Load a Vertex from XML
* @param vertexElement
* @return a Vertex
* @throws Exception
*/
private Vertex loadVertex(Element vertexElement) throws Exception {
List skinElements = XMLUtil.getChildren(vertexElement, "skin");
Skin[] skins = new Skin[skinElements.size()];
int skinCount = 0;
for (Iterator i = skinElements.iterator(); i.hasNext(); ) {
Element skinElement = (Element) i.next();
skins[skinCount++] = loadSkin(skinElement);
}
return new Vertex(
new Vector3f(
XMLUtil.getFloat(vertexElement, "x"),
XMLUtil.getFloat(vertexElement, "y"),
XMLUtil.getFloat(vertexElement, "z")
),
new Vector3f(
XMLUtil.getFloat(vertexElement, "nx"),
XMLUtil.getFloat(vertexElement, "ny"),
XMLUtil.getFloat(vertexElement, "nz")
),
new Vector2f(
XMLUtil.getFloat(vertexElement, "u"),
XMLUtil.getFloat(vertexElement, "v")
),
skins
);
}
/**
* Load a Skin from XML
* @param element
* @return a Skin
* @throws Exception
*/
private Skin loadSkin(Element element) throws Exception {
return new Skin(
XMLUtil.getInt(element, "bone"),
XMLUtil.getFloat(element, "weight")
);
}
/**
* Load a Triangle from XML
* @param element
* @return a Triangle
* @throws Exception
*/
private Triangle loadTriangle(Element element) throws Exception {
return new Triangle(
XMLUtil.getInt(element, "a"),
XMLUtil.getInt(element, "b"),
XMLUtil.getInt(element, "c"),
XMLUtil.getInt(element, "adjacency", 0)
);
}
/**
* Load an Animation from XML
* @param element
* @param numBones
* @return Frame[]
* @throws Exception
*/
private Frame[] loadAnimation(Element element, int numBones) throws Exception {
List frameElements = XMLUtil.getChildren(element, "frame");
Frame[] frames = new Frame[frameElements.size()];
int frameCount = 0;
for (Iterator i = frameElements.iterator(); i.hasNext(); ) {
Element frameElement = (Element) i.next();
frames[frameCount++] = loadFrame(frameElement, numBones);
}
return frames;
}
/**
* Load a Frame from XML
* @param element
* @param numBones
* @return Frame
* @throws Exception
*/
private Frame loadFrame(Element element, int numBones) throws Exception {
List boneElements = XMLUtil.getChildren(element, "bone");
if (boneElements.size() != numBones) {
throw new Exception("Expected "+numBones+" bones in frame, only got "+boneElements.size());
}
Matrix4f[] bones = new Matrix4f[boneElements.size()];
int boneCount = 0;
for (Iterator i = boneElements.iterator(); i.hasNext(); ) {
Element boneElement = (Element) i.next();
bones[boneCount++] = loadBone(boneElement);
}
return new Frame(
XMLUtil.getFloat(element, "time", 0.0f),
bones
);
}
/**
* Load a Bone from XML
* @param element
* @return a Matrix4f
* @throws Exception
*/
private Matrix4f loadBone(Element element) throws Exception {
Matrix4f ret = new Matrix4f();
ret.m00 = XMLUtil.getFloat(element, "m00");
ret.m01 = XMLUtil.getFloat(element, "m01");
ret.m02 = XMLUtil.getFloat(element, "m02");
ret.m03 = XMLUtil.getFloat(element, "m03");
ret.m10 = XMLUtil.getFloat(element, "m10");
ret.m11 = XMLUtil.getFloat(element, "m11");
ret.m12 = XMLUtil.getFloat(element, "m12");
ret.m13 = XMLUtil.getFloat(element, "m13");
ret.m20 = XMLUtil.getFloat(element, "m20");
ret.m21 = XMLUtil.getFloat(element, "m21");
ret.m22 = XMLUtil.getFloat(element, "m22");
ret.m23 = XMLUtil.getFloat(element, "m23");
ret.m30 = XMLUtil.getFloat(element, "m30", 0.0f);
ret.m31 = XMLUtil.getFloat(element, "m31", 0.0f);
ret.m32 = XMLUtil.getFloat(element, "m32", 0.0f);
ret.m33 = XMLUtil.getFloat(element, "m33", 1.0f);
return ret;
}
}

View File

@ -0,0 +1,158 @@
/*
* Copyright (c) 2003 Shaven Puppy Ltd
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are
* met:
*
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
*
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* * Neither the name of 'Shaven Puppy' nor the names of its contributors
* may be used to endorse or promote products derived from this software
* without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
* TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
* LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
* NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
* SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
package org.lwjgl.util.model.loader;
import java.util.ArrayList;
import java.util.List;
import org.w3c.dom.Element;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList;
/**
* Some simple XML utilities
* @author cas
*/
final class XMLUtil {
/**
* @param name The name of the child elements you want
* @return a List of child Elements
*/
static List getChildren(Element element, String name) throws Exception {
NodeList nodes = element.getChildNodes();
ArrayList ret = new ArrayList(nodes.getLength());
for (int i = 0; i < nodes.getLength(); i ++) {
Node childNode = (Node) nodes.item(i);
if (childNode.getNodeName().equals(name) && childNode.getNodeType() == Node.ELEMENT_NODE) {
ret.add(childNode);
}
}
return ret;
}
/**
* A convenience method for getting float values out of XML elements
* @param attribute The name of the attribute
* @throws NumberFormatException If the supplied attribute is not a number
* @throws Exception if the value is missing
* @return the parsed float value
*/
static float getFloat(Element element, String attribute) throws Exception {
String s = element.getAttribute(attribute);
if (s == null || "".equals(s))
throw new Exception("Attribute '"+attribute+"' has not been specified for "+element.getNodeName());
else
return Float.parseFloat(s);
}
/**
* A convenience method for getting float values out of XML elements
* @param attribute The name of the attribute
* @param defaultValue The default value to return if no default is specified
* @throws NumberFormatException If the supplied attribute is not a number
* @return the parsed float value
*/
static float getFloat(Element element, String attribute, float defaultValue) throws Exception {
String s = element.getAttribute(attribute);
if (s == null || "".equals(s))
return defaultValue;
else
return Float.parseFloat(s);
}
/**
* A convenience method for getting integer values out of XML elements
* @param attribute The name of the attribute
* @throws NumberFormatException If the supplied attribute is not a number
* @throws Exception if the value is missing
* @return the parsed integer value
*/
static int getInt(Element element, String attribute) throws Exception {
String s = element.getAttribute(attribute);
if (s == null || "".equals(s))
throw new Exception("Attribute '"+attribute+"' has not been specified for "+element.getNodeName());
else
return Integer.parseInt(s);
}
/**
* A convenience method for getting integer values out of XML elements
* @param attribute The name of the attribute
* @param defaultValue The default value to return if no default is specified
* @throws NumberFormatException If the supplied attribute is not a number
* @return the parsed integer value
*/
static int getInt(Element element, String attribute, int defaultValue) throws Exception {
String s = element.getAttribute(attribute);
if (s == null || "".equals(s))
return defaultValue;
else
return Integer.parseInt(s);
}
/**
* A convenience method for getting string values out of XML elements
* @param attribute The name of the attribute
* @return the string value, which will not be null
* @throws Exception the value is not specified
*/
static String getString(Element element, String attribute) throws Exception {
String s = element.getAttribute(attribute);
if (s == null || "".equals(s))
throw new Exception("Attribute '"+attribute+"' has not been specified for "+element.getNodeName());
else
return s;
}
/**
* A convenience method for getting string values out of XML elements
* @param attribute The name of the attribute
* @param defaultValue The default value to return if no default is specified
* @return the string value, which will not be null
*/
static String getString(Element element, String attribute, String defaultValue) throws Exception {
String s = element.getAttribute(attribute);
if (s == null || "".equals(s))
return defaultValue;
else
return s;
}
}