LineBlockTracer.h

Go to the documentation of this file.

// 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;





class cLineBlockTracer :
    public cBlockTracer
{
    typedef cBlockTracer super;

public:
    enum eLineOfSight
    {
        // Bit flags used for LineOfSightTrace's Sight parameter:
        losAir = 1,    // Can see through air
        losWater = 2,  // Can see through water
        losLava = 4,   // Can see through lava

        // Common combinations:
        losAirWaterLava = losAir | losWater | losLava,
        losAirWater = losAir | losWater,
    };


    cLineBlockTracer(cWorld & a_World, cCallbacks & a_Callbacks);

    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:

    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);

    static bool Trace(cWorld & a_World, cCallbacks & a_Callbacks, const Vector3d & a_Start, const Vector3d & a_End);

    static bool LineOfSightTrace(cWorld & a_World, const Vector3d & a_Start, const Vector3d & a_End, int a_Sight);

    static bool FirstSolidHitTrace(
        cWorld & a_World,
        const Vector3d & a_Start, const Vector3d & a_End,
        Vector3d & a_HitCoords,
        Vector3i & a_HitBlockCoords,
        eBlockFace & a_HitBlockFace
    );

protected:
    double m_StartX, m_StartY, m_StartZ;

    double m_EndX, m_EndY, m_EndZ;

    double m_DiffX, m_DiffY, m_DiffZ;

    int m_DirX, m_DirY, m_DirZ;

    int m_CurrentX, m_CurrentY, m_CurrentZ;

    eBlockFace m_CurrentFace;


    void FixStartAboveWorld(void);

    void FixStartBelowWorld(void);

    void CalcXZIntersection(double a_Y, double & a_IntersectX, double & a_IntersectZ);

    bool MoveToNextBlock(void);

    bool ChunkCallback(cChunk * a_Chunk);
} ;