railUtils.h

Go to the documentation of this file.

/*******************************************************************************
** Copyright (c) 2010 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/


#pragma once

#include "vrfutil/railSegment.h"
#include "matrix/vlVector.h"
#include "vrfutil/vrfutilDefines.h"
#include "terrainCS/coordSystem.h"
#include "vrfutil/iteratorBase.h"
#include "vrfutil/rwRailSegment.h"
#include "vrfutil/localVectorIterator.h"
#include "geometry/point.h"


DT_DLL_vrfutil double distance2DSqAlongRailSegment(const DtVector & pos, const DtRailSegment * seg,
                                                 const Coordinate_System& coordinateSystem,double & distanceToSeg);

DT_DLL_vrfutil double distance2DAlongRailFromStart(const DtVector & pos, const DtRailSegmentList * rails,const Coordinate_System& coordinateSystem);

DT_DLL_vrfutil DtVector locationAlongRail(double distanceFromStart, const DtRailSegmentList * rails,const Coordinate_System& coordinateSystem);

DT_DLL_vrfutil DtVector locationAlongRailSegment(double distanceFromSegmentStart, const DtRailSegment* railSegment);

DT_DLL_vrfutil double railHeading(const DtRailSegment* railSegment,const Coordinate_System& coordinateSystem);

DT_DLL_vrfutil int findTurnDirection(double currentHeading, double desiredHeading,double & headingDiff);

DT_DLL_vrfutil bool intersection(const DtRailSegment * currentSegment,const DtRailSegment * nextSegment);

DT_DLL_vrfutil int findDrivingLane(const int turnDirection,const DtRailSegment* segment);

DT_DLL_vrfutil const DtRailSegment * findClosestSegment( const DtVector & pos, const DtRailSegmentList * rails, const Coordinate_System & coordinateSystem,
                                   double & distanceSqAlongClosest);
DT_DLL_vrfutil double distance2DAlongRailBetween2Points(const DtVector & pos1, const DtVector & pos2, const DtRailSegmentList * rails,
                                                        const Coordinate_System& coordinateSystem);

DT_DLL_vrfutil double closestPointInXY(const DtRailSegment * seg, const DtVector & pointFronm, DtVector & closest,
                                                     const Coordinate_System & coordinateSystem);

DT_DLL_vrfutil double laneLengthTurnAdjustment(const DtRailSegment *seg,
                                        const int lane, const double headingChange);

DT_DLL_vrfutil DtRailSegment * generateEntryPoint(const DtPoint & entry,  DtRailSegmentList * rails,const DtVector & entityPos,
                                                  bool drivingOnLeft,bool pivots,const double turnRadius,const double entityHeading,DtVector & entryPoint, const Coordinate_System& coordinateSystem);

DT_DLL_vrfutil void setUpLocalToBodyCoordinateTransform(const DtVector & offset, const double heading,
                                   const Coordinate_System& coordinateSystem,DtCoordTransform& transform);

DT_DLL_vrfutil DtRwRailSegmentList* createRwRailPath(const DtRailSegmentList * rails);

DT_DLL_vrfutil DtRwRailSegmentList* createRwRailPathFromRoute(DtLocalVectorIterator & routeIter,const DtVector startPos,
                                                     DtIteratorDirection dir,bool startAtClosestPt,
                                                      const Coordinate_System& coordinateSystem);

DT_DLL_vrfutil void fillInRailPathFromRoute(DtLocalVectorIterator& routeIter,const DtVector startPos,
                                                      DtIteratorDirection dir,bool startAtClosestPt,
                                                      const Coordinate_System& coordinateSystem,DtRailSegmentList & rails);

DT_DLL_vrfutil bool calcOrthoOffset(const DtPoint& startPoint, const DtPoint& endPoint, double distance,
   DtPoint& leftOffset, DtPoint& rightOffset);

DT_DLL_vrfutil bool findPointOnLine(const DtPoint& startPoint, 
   const DtPoint& endPoint, DtPoint& result, double distance); 

DT_DLL_vrfutil bool isRailWithinDistance(const Coordinate_System* coordSys, const DtVector& sourceLocation,
   DtRailSegment* railSegment, double allowDistance, double& actualDistSq);

DT_DLL_vrfutil bool isLocationWithinRoad(const Coordinate_System* coordSys, const DtVector& sourceLocation,
   DtRailSegment* railSegment);

DT_DLL_vrfutil DtVector convertGeocVecToTopo(const DtVector& geocPoint, const DtCoordTransform& matrix);

DT_DLL_vrfutil DtVector convertTopoVecToGeoc(const DtVector& topoPoint, const DtCoordTransform& matrix);

DT_DLL_vrfutil DtCoordTransform generateTransformMatrix(const DtVector& geocViewpoint);

DT_DLL_vrfutil bool removeShortSegmentsFromRailPath(DtRailSegmentList& railPath,
   const double allowedError, const Coordinate_System* localCoordinateSystem,
   bool debug = false);