assimp/contrib/openddlparser
Russ Taylor f618387b06 Added const to string definitions so that the compiler won't warn about them being unused. 2015-07-04 18:31:25 -04:00
..
code Added const to string definitions so that the compiler won't warn about them being unused. 2015-07-04 18:31:25 -04:00
include/openddlparser - OpenDDL-Parser: latest greatest. 2015-05-31 20:36:55 +02:00
CMakeLists.txt support of openddlparser lib without x++11. 2015-01-31 11:46:13 +01:00
README.md add openddl-parser to contrib. 2015-01-31 11:07:48 +01:00

README.md

The OpenDDL-Parser

A simple and fast OpenDDL Parser Current build status: Build Status

Get the source code

You can get the code from our git repository, which is located at GitHub. You can clone the repository like:

git clone https://github.com/kimkulling/openddl-parser.git

Build from repo

To build the library you need to install cmake first ( see http://www.cmake.org/ for more information ). Make also sure that a compiler toolchain is installed on your machine. After installing it you can open a console and type:

cmake CMakeLists.txt

This command will generate a build environment for your installed build enrironment ( for Visual Studio the project files will be generated, for gcc the makefiles will be generated ). When using an IDE open the IDE and run the build. When using GNU-make type in your console:

make

and that's all.

Use the library

To use the OpenDDL-parser you need to build the lib first. Now add the

/include

to your include-path and the

/lib

to your lib-folder. Link the openddl.lib to your application.

Here is a small example how to use the lib:


#include <iostream>
#include <cassert>
#include <openddlparser/OpenDDLParser.h>

USE_ODDLPARSER_NS;

int main( int argc, char *argv[] ) {
    if( argc < 3 ) {
        return 1;
    }

    char *filename( nullptr );
    if( 0 == strncmp( FileOption, argv[ 1 ], strlen( FileOption ) ) ) {
        filename = argv[ 2 ];
    }
    std::cout << "file to import: " << filename << std::endl;   
    if( nullptr == filename ) {
        std::cerr << "Invalid filename." << std::endl;
        return Error;
    }

    FILE *fileStream = fopen( filename, "r+" );
    if( NULL == filename ) {
        std::cerr << "Cannot open file " << filename << std::endl;
        return 1;
    }

    // obtain file size:
    fseek( fileStream, 0, SEEK_END );
    const size_t size( ftell( fileStream ) );   
    rewind( fileStream );   
    if( size > 0 ) {
        char *buffer = new char[ size ];
        const size_t readSize( fread( buffer, sizeof( char ), size, fileStream ) );
        assert( readSize == size );
        OpenDDLParser theParser;
        theParser.setBuffer( buffer, size );
        const bool result( theParser.parse() );
        if( !result ) {
            std::cerr << "Error while parsing file " << filename << "." << std::endl;
        }
    }
    return 0;
}

How to access the imported data

The data is organized as a tree. You can get the root tree with the following code:

OpenDDLParser theParser;
theParser.setBuffer( buffer, size );
const bool result( theParser.parse() );
if ( result ) {
    DDLNode *root = theParser.getRoot();

    DDLNode::DllNodeList childs = root->getChildNodeList();
    for ( size_t i=0; i<childs.size(); i++ ) {
        DDLNode *child = childs[ i ];
        Property *prop = child->getProperty(); // to get properties
        std:.string type = child->getType();   // to get the node type
        Value *values = child->getValue();     // to get the data;
    }
}

The instance called root contains the data.