summaryrefslogtreecommitdiffstats
path: root/source/LineBlockTracer.h
blob: ccbb70ea68e9e4879bdbbfdffc176f3cd9e3df95 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

// LineBlockTracer.h

// Declares the cLineBlockTracer class representing a cBlockTracer that traces along a straight line between two points





#pragma once

#include "BlockTracer.h"





// fwd: Chunk.h
class cChunk;

// fwd: cChunkMap.h
typedef cItemCallback<cChunk> cChunkCallback;






class cLineBlockTracer :
	public cBlockTracer,
	public cChunkCallback
{
	typedef cBlockTracer super;
	
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())
	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())
	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())
	static bool Trace(cWorld & a_World, cCallbacks & a_Callbacks, const Vector3d & a_Start, const Vector3d & a_End);
	
protected:
	// The start point of the trace
	double m_StartX, m_StartY, m_StartZ;
	
	// The end point of the trace
	double m_EndX, m_EndY, m_EndZ;
	
	// 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
	int m_DirX, m_DirY, m_DirZ;
	
	// The current block
	int m_CurrentX, m_CurrentY, m_CurrentZ;
	
	// 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
	void FixStartAboveWorld(void);
	
	/// 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
	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)
	bool MoveToNextBlock(void);
	
	// cChunkCallback overrides:
	virtual bool Item(cChunk * a_Chunk) override;
} ;