From 6e4122e551eeb41d3e950b363dd837d5586fe560 Mon Sep 17 00:00:00 2001 From: Mattes D Date: Fri, 31 Jul 2015 16:49:10 +0200 Subject: Unified the doxy-comment format. --- src/LineBlockTracer.h | 27 ++++++++++++++------------- 1 file changed, 14 insertions(+), 13 deletions(-) (limited to 'src/LineBlockTracer.h') diff --git a/src/LineBlockTracer.h b/src/LineBlockTracer.h index ccbb70ea6..155b3ab2a 100644 --- a/src/LineBlockTracer.h +++ b/src/LineBlockTracer.h @@ -35,46 +35,47 @@ class cLineBlockTracer : public: cLineBlockTracer(cWorld & a_World, cCallbacks & a_Callbacks); - /// Traces one line between Start and End; returns true if the entire line was traced (until OnNoMoreHits()) + /** Traces one line between Start and End; returns true if the entire line was traced (until OnNoMoreHits()) */ bool Trace(double a_StartX, double a_StartY, double a_StartZ, double a_EndX, double a_EndY, double a_EndZ); // Utility functions for simple one-line usage: - /// Traces one line between Start and End; returns true if the entire line was traced (until OnNoMoreHits()) + + /** Traces one line between Start and End; returns true if the entire line was traced (until OnNoMoreHits()) */ static bool Trace(cWorld & a_World, cCallbacks & a_Callbacks, double a_StartX, double a_StartY, double a_StartZ, double a_EndX, double a_EndY, double a_EndZ); - /// Traces one line between Start and End; returns true if the entire line was traced (until OnNoMoreHits()) + /** Traces one line between Start and End; returns true if the entire line was traced (until OnNoMoreHits()) */ static bool Trace(cWorld & a_World, cCallbacks & a_Callbacks, const Vector3d & a_Start, const Vector3d & a_End); protected: - // The start point of the trace + /** The start point of the trace */ double m_StartX, m_StartY, m_StartZ; - // The end point of the trace + /** The end point of the trace */ double m_EndX, m_EndY, m_EndZ; - // The difference in coords, End - Start + /** The difference in coords, End - Start */ double m_DiffX, m_DiffY, m_DiffZ; - // The increment at which the block coords are going from Start to End; either +1 or -1 + /** The increment at which the block coords are going from Start to End; either +1 or -1 */ int m_DirX, m_DirY, m_DirZ; - // The current block + /** The current block */ int m_CurrentX, m_CurrentY, m_CurrentZ; - // The face through which the current block has been entered + /** The face through which the current block has been entered */ char m_CurrentFace; - /// Adjusts the start point above the world to just at the world's top + /** Adjusts the start point above the world to just at the world's top */ void FixStartAboveWorld(void); - /// Adjusts the start point below the world to just at the world's bottom + /** Adjusts the start point below the world to just at the world's bottom */ void FixStartBelowWorld(void); - /// Calculates the XZ coords of an intersection with the specified Yconst plane; assumes that such an intersection exists + /** Calculates the XZ coords of an intersection with the specified Yconst plane; assumes that such an intersection exists */ void CalcXZIntersection(double a_Y, double & a_IntersectX, double & a_IntersectZ); - /// Moves m_Current to the next block on the line; returns false if no move is possible (reached the end) + /** Moves m_Current to the next block on the line; returns false if no move is possible (reached the end) */ bool MoveToNextBlock(void); // cChunkCallback overrides: -- cgit v1.2.3