qwt3d_coordsys.h

#ifndef QWT3D_COORDSYS_H
#define QWT3D_COORDSYS_H
 
#include "qwt3d_axis.h"
#include "qwt3d_colorlegend.h"
 
 
 
class QWT3D_EXPORT Qwt3DCoordinateSystem : public Qwt3DDrawable
{
    QWT_DECLARE_PRIVATE(Qwt3DCoordinateSystem)
 
public:
    explicit Qwt3DCoordinateSystem(Triple blb = Triple(0, 0, 0),
                              Triple ftr = Triple(0, 0, 0),
                              COORDSTYLE = BOX);
    ~Qwt3DCoordinateSystem() override;
 
    void init(Triple beg = Triple(0, 0, 0), Triple end = Triple(0, 0, 0));
    // Set style for the coordinate system (NOCOORD, FRAME or BOX)
    void setStyle(COORDSTYLE s,
                  AXIS frame_1 = X1,
                  AXIS frame_2 = Y1,
                  AXIS frame_3 = Z1);
    // Return style of the coordinate system
    COORDSTYLE style() const;
    // first == front_left_bottom, second == back_right_top
    void setPosition(Triple first, Triple second);
 
    // Set common color for all axes
    void setAxesColor(RGBA val);
    // Returns the common axes color
    RGBA axesColor() const;
    // Set common font for all axis numberings
    void setNumberFont(QString const& family, int pointSize, int weight = QFont::Normal, bool italic = false);
    // Set common font for all axis numberings
    void setNumberFont(QFont const& font);
    // Returns the common number font (delegates to first axis)
    QFont numberFont() const;
    // Set common color for all axis numberings
    void setNumberColor(RGBA val);
    // Returns the common number color
    RGBA numberColor() const;
    // Sets an linear axis with real number items
    void setStandardScale();
 
    // Fine tunes distance between axis numbering and axis body
    void adjustNumbers(int val);
    // Fine tunes distance between axis label and axis body
    void adjustLabels(int val);
 
    // Sets color for the grid lines
    void setGridLinesColor(RGBA val);
    // Returns the grid lines color
    RGBA gridLinesColor() const;
 
    // Set common font for all axis labels
    void setLabelFont(QString const& family, int pointSize, int weight = QFont::Normal, bool italic = false);
    // Set common font for all axis labels
    void setLabelFont(QFont const& font);
    // Returns the common label font (delegates to first axis)
    QFont labelFont() const;
    // Set common color for all axis labels
    void setLabelColor(RGBA val);
    // Returns the common label color
    RGBA labelColor() const;
 
    // Set line width for tic marks and axes
    void setLineWidth(double val, double majfac = 0.9, double minfac = 0.5);
    // Set length for tic marks (explicit override; persists across data changes)
    void setTicLength(double major, double minor);
    // Returns the explicit tic lengths (only meaningful after setTicLength(); use ticLengthScale() to check if auto)
    void ticLength(double& major, double& minor) const;
    // Set the automatic tic-length scale: fraction of the per-axis data range in
    // the tick's own pointing direction (default 0.015). Switches back to automatic
    // per-axis derivation, clearing any explicit length set via setTicLength().
    void setTicLengthScale(double scale);
    // Returns the automatic tic-length scale
    double ticLengthScale() const;
    // Switch to automatic per-axis tic-length derivation (clears explicit override)
    void setAutoTicLength();
 
    // Switch autoscaling of axes
    void setAutoScale(bool val = true);
    // Returns true if autoscaling is enabled (delegates to first axis)
    bool autoScale() const;
 
    Triple first() const;
    Triple second() const;
 
    void setAutoDecoration(bool val = true);
    bool autoDecoration() const;
 
    // Set tick position preference for auto-decorated axes
    // TICK_BOTTOM (default): ticks on visually lower axis; TICK_TOP: ticks on visually upper axis
    void setTickPosition(TICKPOSITION val);
    // Returns tick position preference
    TICKPOSITION tickPosition() const;
 
    // Draw smooth axes
    void setLineSmooth(bool val = true);
    // Smooth axes enabled?
    bool lineSmooth() const;
 
    void draw(const Qwt3DRenderContext& ctx) override;
 
    // Defines whether a grid between the major and/or minor tics should be drawn
    void setGridLines(bool majors, bool minors, int sides = NOSIDEGRID);
    // Returns grids switched on
    int grids() const;
 
    // Set interior grid lines through the box volume
    void setInteriorGridLines(bool majors, bool minors, int directions = NO_INTERIOR);
    // Returns interior grid directions switched on
    int interiorGrids() const;
    // Sets color for the interior grid lines
    void setInteriorGridLinesColor(RGBA val);
    // Returns the interior grid lines color
    RGBA interiorGridLinesColor() const;
    // Sets line width for interior grid lines
    void setInteriorGridLinesWidth(double major, double minor);
 
    // The vector of all 12 axes - use them to set axis properties individually
    std::vector< Qwt3DAxis > axes;
 
private:
    void destroy();
    void chooseAxes(const Qwt3DRenderContext& ctx);
    void autoDecorateExposedAxis(const Qwt3DRenderContext& ctx, Qwt3DAxis& ax, bool left);
    void drawMajorGridLines(const Qwt3DRenderContext& ctx);
    void drawMinorGridLines(const Qwt3DRenderContext& ctx);
    void drawMajorGridLines(Qwt3DAxis&, Qwt3DAxis&, QVector<float>& verts);
    void drawMinorGridLines(Qwt3DAxis&, Qwt3DAxis&, QVector<float>& verts);
    void drawInteriorMajorGridLines(const Qwt3DRenderContext& ctx);
    void drawInteriorMinorGridLines(const Qwt3DRenderContext& ctx);
    void drawInteriorGridLines(Qwt3DAxis& axisA, Qwt3DAxis& axisB,
                               int dirAxis, bool major, QVector<float>& verts);
    void recalculateAxesTics();
    // Applies the current tic-length model (auto per-axis, or explicit manual) to all axes
    void applyTicLengths();
    void drawGridLines(const Qwt3DRenderContext& ctx, const QVector<float>& vertices, double lineWidth, const RGBA& color);
};
 
 
#endif