1 /*
2 * Class modelling a 3D perspective
3 *
4 * Authors:
5 * Maximilian Albert <Anhalter42@gmx.de>
6 *
7 * Copyright (C) 2007 authors
8 *
9 * Released under GNU GPL, read the file 'COPYING' for more information
10 */
12 #ifndef SEEN_PERSPECTIVE3D_H
13 #define SEEN_PERSPECTIVE3D_H
15 #include "vanishing-point.h"
16 #include "svg/stringstream.h"
17 #include <glib.h>
19 class SP3DBox;
21 namespace Box3D {
23 class PerspectiveLine;
25 class Perspective3D {
26 public:
27 Perspective3D(VanishingPoint const &pt_x, VanishingPoint const &pt_y, VanishingPoint const &pt_z);
28 Perspective3D(Perspective3D &other);
29 ~Perspective3D();
31 bool operator== (Perspective3D const &other) const;
33 bool has_vanishing_point (VanishingPoint *vp);
34 VanishingPoint *get_vanishing_point (Box3D::Axis const dir);
35 Axis get_axis_of_VP (VanishingPoint *vp);
36 void set_vanishing_point (Box3D::Axis const dir, VanishingPoint const &pt);
37 void set_vanishing_point (Box3D::Axis const dir, gdouble pt_x, gdouble pt_y, gdouble dir_x, gdouble dir_y, VPState st);
38 void add_box (SP3DBox *box);
39 void remove_box (const SP3DBox *box);
40 bool has_box (const SP3DBox *box) const;
41 inline guint number_of_boxes () { return g_slist_length (boxes); }
42 void reshape_boxes (Box3D::Axis axes);
43 void update_box_reprs ();
45 /* convenience functions for interaction with dragging machinery: */
46 bool all_boxes_occur_in_list (GSList *boxes_to_do);
47 GSList * boxes_occurring_in_list (GSList * list_of_boxes);
49 void absorb (Perspective3D *other); // swallow the other perspective if both coincide
51 static gint counter; // for testing only
52 gint my_counter; // for testing only
54 static GSList * perspectives; // All existing 3D perspectives
55 // FIXME: Perspectives should be linked to the list of existing ones automatically in the constructor
56 // and removed in the destructor!
57 static void add_perspective (Box3D::Perspective3D * const persp);
58 static void remove_perspective (Box3D::Perspective3D * const persp);
60 /* find an existing perspective whose VPs are equal to those of persp */
61 static Box3D::Perspective3D * find_perspective (Box3D::Perspective3D * const persp);
63 static void print_debugging_info();
64 static Perspective3D * current_perspective;
66 private:
67 VanishingPoint *vp_x;
68 VanishingPoint *vp_y;
69 VanishingPoint *vp_z;
70 GSList * boxes; // holds a list of boxes sharing this specific perspective
71 };
73 Perspective3D * get_persp_of_box (const SP3DBox *box);
74 Perspective3D * get_persp_of_VP (const VanishingPoint *vp);
76 NR::Point perspective_intersection (NR::Point pt1, Box3D::Axis dir1, NR::Point pt2, Box3D::Axis dir2, Perspective3D *persp);
77 NR::Point perspective_line_snap (NR::Point pt, Box3D::Axis dir, NR::Point ext_pt, Perspective3D *persp);
79 } // namespace Box3D
82 /** A function to print out the VanishingPoint (prints the coordinates) **/
83 /***
84 inline std::ostream &operator<< (std::ostream &out_file, const VanishingPoint &vp) {
85 out_file << vp;
86 return out_file;
87 }
88 ***/
91 #endif /* !SEEN_PERSPECTIVE3D_H */
93 /*
94 Local Variables:
95 mode:c++
96 c-file-style:"stroustrup"
97 c-file-offsets:((innamespace . 0)(inline-open . 0))
98 indent-tabs-mode:nil
99 fill-column:99
100 End:
101 */
102 // vim: filetype=cpp:expandtab:shiftwidth=4:tabstop=8:softtabstop=4 :