atlas.h

Go to the documentation of this file.

// The following ifdef block is the standard way of creating macros which make exporting 
// from a DLL simpler. All files within this DLL are compiled with the ATLAS_EXPORTS
// symbol defined on the command line. this symbol should not be defined on any project
// that uses this DLL. This way any other project whose source files include this file see 
// ATLAS_API functions as being imported from a DLL, whereas this DLL sees symbols
// defined with this macro as being exported.
#ifdef ATLAS_EXPORTS
#define ATLAS_API __declspec(dllexport)
#else
#define ATLAS_API __declspec(dllimport)
#endif

typedef float AT_scalar;
//typedef double AT_scalar;

typedef AT_scalar (* AT_CalculateDistanceCallbackType) (int vID0, int vID1, void *userDef);
typedef AT_scalar (* AT_AstarHeuristicCallbackType) (int vID0, int vID1, void *userDef);



#define AT_SUCCESS                  0

#define AT_ILLEGAL_VALUE           -1

#define AT_EDGE_ALREADY_EXISTS     -2

#define AT_NO_PATH_FOUND           -3

#define AT_NO_SUCH_VERTEX          -4

#define AT_NO_SUCH_EDGE            -5

#define AT_GRAPH_DIRECTED          -6

#define AT_NEED_RECALCULATION      -7

class ATLAS_API CAtlas {
        //added by Arno
private:
        void* main;
        //end added by Arno
public:
  CAtlas (int dimension, bool directed);

  virtual ~CAtlas ();

  int GetDimension (int *dimension);

  // vertex functions
  int AddVertex (AT_scalar *conf, int *vID, void *userDef=NULL);

  int RemoveVertex (int vID);

  int GetVertexConfiguration (int vID, AT_scalar* conf, void **userDef=NULL);

  int GetNrVertices (int *nr);

  int GetVertices (int *vIDs);

  int SetUserDef (int vID, void *userDef);

  // edge functions
  int AddEdge (int vID0, int vID1, AT_scalar value, void *userDef=NULL);

  int RemoveEdge (int vID0, int vID1);

  int GetNrPredecessors (int vID, int *nr);

  int GetNrSuccessors (int vID, int *nr);

  int GetSuccessor (int vID, int nr, int *nID);

  int GetPredecessor (int vID, int nr, int *nID);

  int GetPredecessors (int vID, int *ids);

  int GetSuccessors (int vID, int *ids);

  int SetEdgeConfiguration (int vID0, int vID1, AT_scalar value, void *userDef=NULL);

  int GetEdgeConfiguration (int vID0, int vID1, AT_scalar *value, void **userDef=NULL);

  int SetEdgeInvalidation (int vID0, int vID1, bool invalidate);

  // query functions
  int FindShortestPaths (int startID);

  int FindAllPairsShortestPaths ();

  int AStar (int startID, int goalID, AT_AstarHeuristicCallbackType ASHCB, int *size, void *userDef=NULL);

  int GetAStarQueryVertex (int nr, int *vID);

  int Query (int goalID, int *size, AT_scalar *length=NULL);

  int Query (int startID, int goalID, int *size, AT_scalar *length=NULL);

  int GetQueryVertex (int nr, int* vID);

  int VerticesConnected (int vID0, int vID1, bool *connected);

  //misc
  int ResetGraph ();

  int LoadGraph (char *fileName);

  int SaveGraph (char *fileName);

  int CheckUsefulCycle (int startID, int goalID, AT_scalar K, AT_CalculateDistanceCallbackType calcDistCB, bool *result, void *userDef=NULL);
};

---