[wxWidgets.git] / contrib / include / wx / ogl / composit.h

/////////////////////////////////////////////////////////////////////////////
// Name:        composit.h
// Purpose:     wxCompositeShape
// Author:      Julian Smart
// Modified by:
// Created:     12/07/98
// RCS-ID:      $Id$
// Copyright:   (c) Julian Smart
// Licence:     wxWindows licence
/////////////////////////////////////////////////////////////////////////////

#ifndef _OGL_COMPOSIT_H_
#define _OGL_COMPOSIT_H_


class WXDLLIMPEXP_OGL wxDivisionShape;
class WXDLLIMPEXP_OGL wxOGLConstraint;

/*
 * A composite object is an invisible rectangle surrounding all children
 *
 */

class WXDLLIMPEXP_OGL wxCompositeShape: public wxRectangleShape
{
 DECLARE_DYNAMIC_CLASS(wxCompositeShape)
public:

  wxCompositeShape();
  ~wxCompositeShape();

  void OnDraw(wxDC& dc);
  void OnDrawContents(wxDC& dc);
  void OnErase(wxDC& dc);
  bool OnMovePre(wxDC& dc, double x, double y, double oldX, double oldY, bool display = true);
  void OnDragLeft(bool draw, double x, double y, int keys, int attachment = 0);
  void OnBeginDragLeft(double x, double y, int keys, int attachment = 0);
  void OnEndDragLeft(double x, double y, int keys, int attachment = 0);

  void OnRightClick(double x, double y, int keys, int attachment = 0);

  void SetSize(double w, double h, bool recursive = true);

  // Returns true if it settled down
  bool Recompute();

  // New members
  void AddChild(wxShape *child, wxShape *addAfter = NULL);
  void RemoveChild(wxShape *child);

  wxOGLConstraint *AddConstraint(wxOGLConstraint *constraint);
  wxOGLConstraint *AddConstraint(int type, wxShape *constraining, wxList& constrained);
  wxOGLConstraint *AddConstraint(int type, wxShape *constraining, wxShape *constrained);

  void DeleteConstraint(wxOGLConstraint *constraint);

  // Delete constraints that involve this child.
  void DeleteConstraintsInvolvingChild(wxShape *child);

  // Remove the image from any constraints involving it, but DON'T
  // remove any constraints.
  void RemoveChildFromConstraints(wxShape *child);

  // Find constraint, also returning actual composite the constraint was in,
  // in case it had to find it recursively.
  wxOGLConstraint *FindConstraint(long id, wxCompositeShape **actualComposite = NULL);

  // Returns true if something changed
  bool Constrain();

  // Make this composite into a container by creating one wxDivisionShape
  void MakeContainer();

  // Calculates size and position of composite object based on children
  void CalculateSize();

#if wxUSE_PROLOGIO
  void WriteAttributes(wxExpr *clause);
  void ReadAttributes(wxExpr *clause);
  // In case the object has constraints it needs to read in in a different pass
  void ReadConstraints(wxExpr *clause, wxExprDatabase *database);
#endif
  // Does the copying for this object
  void Copy(wxShape& copy);

  virtual wxDivisionShape *OnCreateDivision();

  // Finds the image used to visualize a container. This is any child
  // of the composite that is not in the divisions list.
  wxShape *FindContainerImage();

  // Returns true if division is a descendant of this container
  bool ContainsDivision(wxDivisionShape *division);

  inline wxList& GetDivisions() const { return (wxList&) m_divisions; }
  inline wxList& GetConstraints() const { return (wxList&) m_constraints; }

protected:
  double             m_oldX;
  double             m_oldY;
  wxList            m_constraints;
  wxList            m_divisions; // In case it's a container
};

/*
 * A division object is a composite with special properties,
 * to be used for containment. It's a subdivision of a container.
 * A containing node image consists of a composite with a main child shape
 * such as rounded rectangle, plus a list of division objects.
 * It needs to be a composite because a division contains pieces
 * of diagram.
 * NOTE a container has at least one wxDivisionShape for consistency.
 * This can be subdivided, so it turns into two objects, then each of
 * these can be subdivided, etc.
 */
#define DIVISION_SIDE_NONE      0
#define DIVISION_SIDE_LEFT      1
#define DIVISION_SIDE_TOP       2
#define DIVISION_SIDE_RIGHT     3
#define DIVISION_SIDE_BOTTOM    4

class WXDLLIMPEXP_OGL wxDivisionShape: public wxCompositeShape
{
 DECLARE_DYNAMIC_CLASS(wxDivisionShape)
 public:

  wxDivisionShape();
  ~wxDivisionShape();

  void OnDraw(wxDC& dc);
  void OnDrawContents(wxDC& dc);
  bool OnMovePre(wxDC& dc, double x, double y, double oldX, double oldY, bool display = true);
  void OnDragLeft(bool draw, double x, double y, int keys, int attachment = 0);
  void OnBeginDragLeft(double x, double y, int keys, int attachment = 0);
  void OnEndDragLeft(double x, double y, int keys, int attachment = 0);

  void OnRightClick(double x, double y, int keys = 0, int attachment = 0);

  // Don't want this kind of composite to resize its subdiagrams, so
  // override composite's SetSize.
  void SetSize(double w, double h, bool recursive = true);

  // Similarly for calculating size: it's fixed at whatever SetSize
  // set it to, not in terms of children.
  void CalculateSize();

  void MakeControlPoints();
  void ResetControlPoints();
  void MakeMandatoryControlPoints();
  void ResetMandatoryControlPoints();

#if wxUSE_PROLOGIO
  void WriteAttributes(wxExpr *clause);
  void ReadAttributes(wxExpr *clause);
#endif
  // Does the copying for this object
  void Copy(wxShape& copy);

  // Divide horizontally (wxHORIZONTAL) or vertically (wxVERTICAL)
  bool Divide(int direction);

  // Resize adjoining divisions at the given side. If test is true,
  // just see whether it's possible for each adjoining region,
  // returning false if it's not.
  bool ResizeAdjoining(int side, double newPos, bool test);

  // Adjust a side, returning false if it's not physically possible.
  bool AdjustLeft(double left, bool test);
  bool AdjustTop(double top, bool test);
  bool AdjustRight(double right, bool test);
  bool AdjustBottom(double bottom, bool test);

  // Edit style of left or top side
  void EditEdge(int side);

  // Popup menu
  void PopupMenu(double x, double y);

  inline void SetLeftSide(wxDivisionShape *shape) { m_leftSide = shape; }
  inline void SetTopSide(wxDivisionShape *shape) { m_topSide = shape; }
  inline void SetRightSide(wxDivisionShape *shape) { m_rightSide = shape; }
  inline void SetBottomSide(wxDivisionShape *shape) { m_bottomSide = shape; }
  inline wxDivisionShape *GetLeftSide() const { return m_leftSide; }
  inline wxDivisionShape *GetTopSide() const { return m_topSide; }
  inline wxDivisionShape *GetRightSide() const { return m_rightSide; }
  inline wxDivisionShape *GetBottomSide() const { return m_bottomSide; }

  inline void SetHandleSide(int side) { m_handleSide = side; }
  inline int GetHandleSide() const { return m_handleSide; }

  inline void SetLeftSidePen(wxPen *pen) { m_leftSidePen = pen; }
  inline const wxPen *GetLeftSidePen() const { return m_leftSidePen; }
  inline void SetTopSidePen(wxPen *pen) { m_topSidePen = pen; }
  inline const wxPen *GetTopSidePen() const { return m_topSidePen; }

  void SetLeftSideColour(const wxString& colour);
  void SetTopSideColour(const wxString& colour);
  void SetLeftSideStyle(const wxString& style);
  void SetTopSideStyle(const wxString& style);

  inline wxString GetLeftSideColour() const { return m_leftSideColour; }
  inline wxString GetTopSideColour() const { return m_topSideColour; }
  inline wxString GetLeftSideStyle() const { return m_leftSideStyle; }
  inline wxString GetTopSideStyle() const { return m_topSideStyle; }

 protected:
  // Adjoining divisions. NULL indicates edge
  // of container, and that side shouldn't be
  // drawn.
  wxDivisionShape*      m_leftSide;
  wxDivisionShape*      m_rightSide;
  wxDivisionShape*      m_topSide;
  wxDivisionShape*      m_bottomSide;

  int                   m_handleSide;       // Side at which handle is legal

  const wxPen*          m_leftSidePen;
  const wxPen*          m_topSidePen;
  wxString              m_leftSideColour;
  wxString              m_topSideColour;
  wxString              m_leftSideStyle;
  wxString              m_topSideStyle;
};


#define DIVISION_MENU_SPLIT_HORIZONTALLY    1
#define DIVISION_MENU_SPLIT_VERTICALLY      2
#define DIVISION_MENU_EDIT_LEFT_EDGE        3
#define DIVISION_MENU_EDIT_TOP_EDGE         4
#define DIVISION_MENU_EDIT_RIGHT_EDGE       5
#define DIVISION_MENU_EDIT_BOTTOM_EDGE      6
#define DIVISION_MENU_DELETE_ALL            7

#endif
 // _OGL_COMPOSIT_H_
Commit	Line	Data
1fc25a89 JS	1	/////////////////////////////////////////////////////////////////////////////
	2	// Name: composit.h
	3	// Purpose: wxCompositeShape
	4	// Author: Julian Smart
	5	// Modified by:
	6	// Created: 12/07/98
	7	// RCS-ID: $Id$
	8	// Copyright: (c) Julian Smart
2ba06d5a	9	// Licence: wxWindows licence
1fc25a89 JS	10	/////////////////////////////////////////////////////////////////////////////
	11
	12	#ifndef _OGL_COMPOSIT_H_
	13	#define _OGL_COMPOSIT_H_
	14
5f331691 RD	15
	16	class WXDLLIMPEXP_OGL wxDivisionShape;
	17	class WXDLLIMPEXP_OGL wxOGLConstraint;
1fc25a89 JS	18
	19	/*
	20	* A composite object is an invisible rectangle surrounding all children
	21	*
	22	*/
	23
5f331691	24	class WXDLLIMPEXP_OGL wxCompositeShape: public wxRectangleShape
1fc25a89 JS	25	{
	26	DECLARE_DYNAMIC_CLASS(wxCompositeShape)
	27	public:
	28
	29	wxCompositeShape();
	30	~wxCompositeShape();
	31
	32	void OnDraw(wxDC& dc);
	33	void OnDrawContents(wxDC& dc);
	34	void OnErase(wxDC& dc);
2ba06d5a	35	bool OnMovePre(wxDC& dc, double x, double y, double oldX, double oldY, bool display = true);
1fc25a89 JS	36	void OnDragLeft(bool draw, double x, double y, int keys, int attachment = 0);
	37	void OnBeginDragLeft(double x, double y, int keys, int attachment = 0);
	38	void OnEndDragLeft(double x, double y, int keys, int attachment = 0);
	39
	40	void OnRightClick(double x, double y, int keys, int attachment = 0);
	41
2ba06d5a	42	void SetSize(double w, double h, bool recursive = true);
1fc25a89	43
2ba06d5a	44	// Returns true if it settled down
1fc25a89 JS	45	bool Recompute();
	46
	47	// New members
	48	void AddChild(wxShape child, wxShape addAfter = NULL);
	49	void RemoveChild(wxShape *child);
	50
	51	wxOGLConstraint AddConstraint(wxOGLConstraint constraint);
	52	wxOGLConstraint AddConstraint(int type, wxShape constraining, wxList& constrained);
	53	wxOGLConstraint AddConstraint(int type, wxShape constraining, wxShape *constrained);
	54
	55	void DeleteConstraint(wxOGLConstraint *constraint);
	56
	57	// Delete constraints that involve this child.
	58	void DeleteConstraintsInvolvingChild(wxShape *child);
	59
	60	// Remove the image from any constraints involving it, but DON'T
	61	// remove any constraints.
	62	void RemoveChildFromConstraints(wxShape *child);
	63
	64	// Find constraint, also returning actual composite the constraint was in,
	65	// in case it had to find it recursively.
	66	wxOGLConstraint FindConstraint(long id, wxCompositeShape *actualComposite = NULL);
	67
2ba06d5a	68	// Returns true if something changed
1fc25a89 JS	69	bool Constrain();
	70
	71	// Make this composite into a container by creating one wxDivisionShape
	72	void MakeContainer();
	73
	74	// Calculates size and position of composite object based on children
	75	void CalculateSize();
	76
2b5f62a0	77	#if wxUSE_PROLOGIO
1fc25a89 JS	78	void WriteAttributes(wxExpr *clause);
	79	void ReadAttributes(wxExpr *clause);
	80	// In case the object has constraints it needs to read in in a different pass
	81	void ReadConstraints(wxExpr clause, wxExprDatabase database);
	82	#endif
	83	// Does the copying for this object
	84	void Copy(wxShape& copy);
	85
	86	virtual wxDivisionShape *OnCreateDivision();
	87
	88	// Finds the image used to visualize a container. This is any child
	89	// of the composite that is not in the divisions list.
	90	wxShape *FindContainerImage();
	91
2ba06d5a	92	// Returns true if division is a descendant of this container
1fc25a89 JS	93	bool ContainsDivision(wxDivisionShape *division);
	94
	95	inline wxList& GetDivisions() const { return (wxList&) m_divisions; }
	96	inline wxList& GetConstraints() const { return (wxList&) m_constraints; }
	97
	98	protected:
	99	double m_oldX;
	100	double m_oldY;
	101	wxList m_constraints;
	102	wxList m_divisions; // In case it's a container
	103	};
	104
	105	/*
	106	* A division object is a composite with special properties,
	107	* to be used for containment. It's a subdivision of a container.
	108	* A containing node image consists of a composite with a main child shape
	109	* such as rounded rectangle, plus a list of division objects.
	110	* It needs to be a composite because a division contains pieces
	111	* of diagram.
	112	* NOTE a container has at least one wxDivisionShape for consistency.
	113	* This can be subdivided, so it turns into two objects, then each of
	114	* these can be subdivided, etc.
	115	*/
	116	#define DIVISION_SIDE_NONE 0
	117	#define DIVISION_SIDE_LEFT 1
	118	#define DIVISION_SIDE_TOP 2
	119	#define DIVISION_SIDE_RIGHT 3
	120	#define DIVISION_SIDE_BOTTOM 4
	121
5f331691	122	class WXDLLIMPEXP_OGL wxDivisionShape: public wxCompositeShape
1fc25a89 JS	123	{
	124	DECLARE_DYNAMIC_CLASS(wxDivisionShape)
	125	public:
	126
	127	wxDivisionShape();
	128	~wxDivisionShape();
	129
	130	void OnDraw(wxDC& dc);
	131	void OnDrawContents(wxDC& dc);
2ba06d5a	132	bool OnMovePre(wxDC& dc, double x, double y, double oldX, double oldY, bool display = true);
1fc25a89 JS	133	void OnDragLeft(bool draw, double x, double y, int keys, int attachment = 0);
	134	void OnBeginDragLeft(double x, double y, int keys, int attachment = 0);
	135	void OnEndDragLeft(double x, double y, int keys, int attachment = 0);
	136
	137	void OnRightClick(double x, double y, int keys = 0, int attachment = 0);
	138
	139	// Don't want this kind of composite to resize its subdiagrams, so
	140	// override composite's SetSize.
2ba06d5a	141	void SetSize(double w, double h, bool recursive = true);
1fc25a89 JS	142
	143	// Similarly for calculating size: it's fixed at whatever SetSize
	144	// set it to, not in terms of children.
	145	void CalculateSize();
	146
	147	void MakeControlPoints();
	148	void ResetControlPoints();
	149	void MakeMandatoryControlPoints();
	150	void ResetMandatoryControlPoints();
	151
2b5f62a0	152	#if wxUSE_PROLOGIO
1fc25a89 JS	153	void WriteAttributes(wxExpr *clause);
	154	void ReadAttributes(wxExpr *clause);
	155	#endif
	156	// Does the copying for this object
	157	void Copy(wxShape& copy);
	158
	159	// Divide horizontally (wxHORIZONTAL) or vertically (wxVERTICAL)
	160	bool Divide(int direction);
	161
2ba06d5a	162	// Resize adjoining divisions at the given side. If test is true,
1fc25a89	163	// just see whether it's possible for each adjoining region,
2ba06d5a	164	// returning false if it's not.
1fc25a89 JS	165	bool ResizeAdjoining(int side, double newPos, bool test);
1fc25a89 JS	166
2ba06d5a	167	// Adjust a side, returning false if it's not physically possible.
1fc25a89 JS	168	bool AdjustLeft(double left, bool test);
	169	bool AdjustTop(double top, bool test);
	170	bool AdjustRight(double right, bool test);
	171	bool AdjustBottom(double bottom, bool test);
	172
	173	// Edit style of left or top side
	174	void EditEdge(int side);
	175
	176	// Popup menu
	177	void PopupMenu(double x, double y);
	178
	179	inline void SetLeftSide(wxDivisionShape *shape) { m_leftSide = shape; }
	180	inline void SetTopSide(wxDivisionShape *shape) { m_topSide = shape; }
	181	inline void SetRightSide(wxDivisionShape *shape) { m_rightSide = shape; }
	182	inline void SetBottomSide(wxDivisionShape *shape) { m_bottomSide = shape; }
	183	inline wxDivisionShape *GetLeftSide() const { return m_leftSide; }
	184	inline wxDivisionShape *GetTopSide() const { return m_topSide; }
	185	inline wxDivisionShape *GetRightSide() const { return m_rightSide; }
	186	inline wxDivisionShape *GetBottomSide() const { return m_bottomSide; }
	187
	188	inline void SetHandleSide(int side) { m_handleSide = side; }
	189	inline int GetHandleSide() const { return m_handleSide; }
	190
	191	inline void SetLeftSidePen(wxPen *pen) { m_leftSidePen = pen; }
ce3e37f1	192	inline const wxPen *GetLeftSidePen() const { return m_leftSidePen; }
1fc25a89	193	inline void SetTopSidePen(wxPen *pen) { m_topSidePen = pen; }
ce3e37f1	194	inline const wxPen *GetTopSidePen() const { return m_topSidePen; }
1fc25a89 JS	195
	196	void SetLeftSideColour(const wxString& colour);
	197	void SetTopSideColour(const wxString& colour);
	198	void SetLeftSideStyle(const wxString& style);
	199	void SetTopSideStyle(const wxString& style);
	200
	201	inline wxString GetLeftSideColour() const { return m_leftSideColour; }
	202	inline wxString GetTopSideColour() const { return m_topSideColour; }
	203	inline wxString GetLeftSideStyle() const { return m_leftSideStyle; }
	204	inline wxString GetTopSideStyle() const { return m_topSideStyle; }
	205
	206	protected:
	207	// Adjoining divisions. NULL indicates edge
	208	// of container, and that side shouldn't be
	209	// drawn.
	210	wxDivisionShape* m_leftSide;
	211	wxDivisionShape* m_rightSide;
	212	wxDivisionShape* m_topSide;
	213	wxDivisionShape* m_bottomSide;
	214
	215	int m_handleSide; // Side at which handle is legal
	216
ce3e37f1 WS	217	const wxPen* m_leftSidePen;
ce3e37f1 WS	218	const wxPen* m_topSidePen;
1fc25a89 JS	219	wxString m_leftSideColour;
	220	wxString m_topSideColour;
	221	wxString m_leftSideStyle;
	222	wxString m_topSideStyle;
	223	};
	224
	225
	226	#define DIVISION_MENU_SPLIT_HORIZONTALLY 1
	227	#define DIVISION_MENU_SPLIT_VERTICALLY 2
	228	#define DIVISION_MENU_EDIT_LEFT_EDGE 3
	229	#define DIVISION_MENU_EDIT_TOP_EDGE 4
	230	#define DIVISION_MENU_EDIT_RIGHT_EDGE 5
	231	#define DIVISION_MENU_EDIT_BOTTOM_EDGE 6
	232	#define DIVISION_MENU_DELETE_ALL 7
	233
	234	#endif
	235	// _OGL_COMPOSIT_H_