True Axis Physics SDK 1.2.0.1 Beta Documentation
www.trueaxis.com

---

DescriptorLanguage.h

//---------------------------------------------------------------------------------
// File Name: DescriptorLanguage.h
// Description:
//
// Copyright (C) 2004 True Axis Pty Ltd, Australia. 
// All Rights Reserved.
//
// History:
//      Created File.
//---------------------------------------------------------------------------------

#ifndef TA_DESCRIPTORLANGUAGE_H
#define TA_DESCRIPTORLANGUAGE_H

#ifndef TA_TYPES_H
#include "Types.h"
#endif // TA_TYPES_H

#ifndef TA_STRING_H
#include "String.h"
#endif // TA_STRING_H

#ifndef TA_DEBUG_H
#include "Debug.h"
#endif // TA_DEBUG_H

#ifndef TA_MEMORYMGR_H
#include "MemoryMgr.h"
#endif // TA_MEMORYMGR_H

#ifndef TA_DESCRIPTORITEMNUMERIC_H
#include "DescriptorItemNumeric.h"
#endif // TA_DESCRIPTORITEMNUMERIC_H

#ifndef TA_DESCRIPTORITEMLIST_H
#include "DescriptorItemList.h"
#endif // TA_DESCRIPTORITEMLIST_H

namespace TA
{

class Descriptor;
class DescriptorItem;
class DescriptorItemLabel;

class TACOMMON_CLASS DescriptorLanguage
{
public:
    DescriptorLanguage();
    virtual ~DescriptorLanguage();

    void Initialise(const String& strName, const String& strFileName);
    void Finalise();

    bool IsInitialised() const { return m_bIsInitialised; }

    void InitialiseDescriptor(Descriptor& descriptor);

    DescriptorItem* GetRootItem() { TA_ASSERT(m_pParent); TA_ASSERT((u32)m_pParent == (u32)m_pRoot); return m_pParent; }
        
    void BeginDescGroup(const Char* szGroupName);
    void EndDescGroup();

    void AddDescItem(
        const Char* szName,                         // Name
        Descriptor* pDescriptor,
        String& strVar,                             // Editable variable
        const Char* szDefault,                      // Default value
        const Char* szDescription);                 // Description

    void AddDescItem(
        const Char* szName,                         // Name
        void (*SetVar)(const String&, void* pData), // Set function
        const String& (*GetVar)(void* pData),       // Get function
        const Char* szDefault,                      // Default value
        const Char* szDescription);                 // Description

    template <class Type>
    void AddDescItem(
        const Char* szName,                         // Name
        Descriptor* pDescriptor,
        Type& var,                                  // Reference to the editable variable
        Type defaultValue,                          // Default value
        Type min,                                   // Min value
        Type max,                                   // Max value
        const Char* szDescription)                  // Description
    {           
    //  DescriptorItemNumericOfType<Type>* pItem = new DescriptorItemNumericOfType<Type>();
        DescriptorItemNumericOfType<Type>* pItem;
        TA_MEMORY_MGR_NEW(pItem, DescriptorItemNumericOfType<Type>);
        pItem->Initialise(
            szName,
            pDescriptor,
            var,
            defaultValue,
            min,
            max,
            szDescription);
        TA_ASSERT(m_pParent);
        m_pParent->AddChild(pItem);
    }

/*  template <class Type>
    void AddDescItem2(
        const Char* szName,                         // Name
        void (*SetVar)(Type, void* pData),          // Set function
        Type (*GetVar)(void* pData),                // Get function
        Type defaultValue,                          // Default value
        Type min,                                   // Min value
        Type max,                                   // Max value
        const Char* szDescription)                  // Description
    {
    //  DescriptorItemNumeric<Type>* pItem = new DescriptorItemNumeric<Type>();
        DescriptorItemNumeric<Type>* pItem;
        TA_MEMORY_MGR_NEW(pItem, DescriptorItemNumeric<Type>());
        pItem->Initialise(
            szName, 
            SetVar,     
            GetVar,     
            defaultValue,
            min,
            max,
            szDescription);
        TA_ASSERT(m_pParent);
        m_pParent->AddChild(pItem);
    }*/
    void AddDescItem(
        const Char* szName,                         // Name
        void (*SetVar)(float, void* pData),         // Set function
        float (*GetVar)(void* pData),               // Get function
        float defaultValue,                         // Default value
        float min,                                  // Min value
        float max,                                  // Max value
        const Char* szDescription);                 // Description

    void AddDescItem(
        const Char* szName,                         // Name
        void (*SetVar)(int, void* pData),           // Set function
        int (*GetVar)(void* pData),                 // Get function
        int defaultValue,                           // Default value
        int min,                                    // Min value
        int max,                                    // Max value
        const Char* szDescription);                 // Description  template <class Type>

    template <class Type>
    void AddDescItem(
        const Char* szName,                         // Name
        Descriptor* pDescriptor,
        DescriptorList<Type>& var,                  // Reference to the editable variable
        const Char* szDescription)                  // Description
    {       
    //  DescriptorItemListOfType<Type>* pItem = new DescriptorItemListOfType<Type>();
        DescriptorItemListOfType<Type>* pItem; 
        TA_MEMORY_MGR_NEW(pItem, DescriptorItemListOfType<Type>);
        pItem->Initialise(
            szName,
            pDescriptor,
            var,
            szDescription);
        TA_ASSERT(m_pParent);
        m_pParent->AddChild(pItem);
    }



private:
    bool m_bIsInitialised;
    String m_strFileName;
    DescriptorItemLabel* m_pRoot;
    DescriptorItem* m_pParent; // used in initialising the language

    void InitialiseDescriptorInternal(DescriptorItem* pRoot, Descriptor& descriptor);   
};

};

//#include "DescriptorLanguage.inl"


#endif // TA_DESCRIPTORLANGUAGE_H

---

© Copyright 2004-2006 TRUE AXIS PTY LTD Australia. All rights reserved.