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

/////////////////////////////////////////////////////////////////////////////
// Name:        misc.h
// Purpose:     Miscellaneous utilities for OGL
// Author:      Julian Smart
// Modified by:
// Created:     12/07/98
// RCS-ID:      $Id$
// Copyright:   (c) Julian Smart
// Licence:     wxWindows licence
/////////////////////////////////////////////////////////////////////////////

#ifndef _OGL_MISC_H_
#define _OGL_MISC_H_

#if defined(__GNUG__) && !defined(__APPLE__)
#pragma interface "misc.h"
#endif


// List to use when copying objects; may need to associate elements of new objects
// with elements of old objects, e.g. when copying constraint.s
extern wxList oglObjectCopyMapping;

/*
 * TEXT FORMATTING FUNCTIONS
 *
 */

// Centres the given list of wxShapeTextLine strings in the given box
// (changing the positions in situ). Doesn't actually draw into the DC.
WXDLLIMPEXP_OGL void oglCentreText(wxDC& dc, wxList *text, double m_xpos, double m_ypos,
                double width, double height,
                int formatMode = FORMAT_CENTRE_HORIZ | FORMAT_CENTRE_VERT);

// Given a string, returns a list of strings that fit within the given
// width of box. Height is ignored.
WXDLLIMPEXP_OGL wxStringList* oglFormatText(wxDC& dc, const wxString& text, double width, double height, int formatMode = 0);

// Centres the list of wxShapeTextLine strings, doesn't clip.
// Doesn't actually draw into the DC.
WXDLLIMPEXP_OGL void oglCentreTextNoClipping(wxDC& dc, wxList *text_list,
                              double m_xpos, double m_ypos, double width, double height);

// Gets the maximum width and height of the given list of wxShapeTextLines.
WXDLLIMPEXP_OGL void oglGetCentredTextExtent(wxDC& dc, wxList *text_list,
                              double m_xpos, double m_ypos, double width, double height,
                              double *actual_width, double *actual_height);

// Actually draw the preformatted list of wxShapeTextLines.
WXDLLIMPEXP_OGL void oglDrawFormattedText(wxDC& context, wxList *text_list,
                       double m_xpos, double m_ypos, double width, double height,
                       int formatMode = FORMAT_CENTRE_HORIZ | FORMAT_CENTRE_VERT);

// Give it a list of points, finds the centre.
WXDLLIMPEXP_OGL void oglFindPolylineCentroid(wxList *points, double *x, double *y);

WXDLLIMPEXP_OGL void oglCheckLineIntersection(double x1, double y1, double x2, double y2,
                             double x3, double y3, double x4, double y4,
                             double *ratio1, double *ratio2);

WXDLLIMPEXP_OGL void oglFindEndForPolyline(double n, double xvec[], double yvec[],
                           double x1, double y1, double x2, double y2, double *x3, double *y3);


WXDLLIMPEXP_OGL void oglFindEndForBox(double width, double height,
                      double x1, double y1,         // Centre of box (possibly)
                      double x2, double y2,         // other end of line
                      double *x3, double *y3);      // End on box edge

WXDLLIMPEXP_OGL void oglFindEndForCircle(double radius,
                         double x1, double y1,  // Centre of circle
                         double x2, double y2,  // Other end of line
                         double *x3, double *y3);

WXDLLIMPEXP_OGL void oglGetArrowPoints(double x1, double y1, double x2, double y2,
                      double length, double width,
                      double *tip_x, double *tip_y,
                      double *side1_x, double *side1_y,
                      double *side2_x, double *side2_y);

/*
 * Given an ellipse and endpoints of a line, returns the point at which
 * the line touches the ellipse in values x4, y4.
 * This function assumes that the centre of the ellipse is at x1, y1, and the
 * ellipse has a width of a1 and a height of b1. It also assumes you are
 * wanting to draw an arc FROM point x2, y2 TOWARDS point x3, y3.
 * This function calculates the x,y coordinates of the intersection point of
 * the arc with the ellipse.
 * Author: Ian Harrison
 */

WXDLLIMPEXP_OGL void oglDrawArcToEllipse(double x1, double y1, double a1, double b1, double x2, double y2, double x3, double y3,
  double *x4, double *y4);

WXDLLIMPEXP_OGL bool oglRoughlyEqual(double val1, double val2, double tol = 0.00001);

extern wxFont*          g_oglNormalFont;
extern wxPen*           g_oglBlackPen;
extern wxPen*           g_oglWhiteBackgroundPen;
extern wxPen*           g_oglTransparentPen;
extern wxBrush*         g_oglWhiteBackgroundBrush;
extern wxPen*           g_oglBlackForegroundPen;

WXDLLIMPEXP_OGL wxFont*          oglMatchFont(int point_size);

WXDLLIMPEXP_OGL wxString         oglColourToHex(const wxColour& colour);
WXDLLIMPEXP_OGL wxColour         oglHexToColour(const wxString& hex);
WXDLLIMPEXP_OGL void             oglDecToHex(unsigned int dec, char *buf);
WXDLLIMPEXP_OGL unsigned int     oglHexToDec(char* buf);


#endif
 // _OGL_MISC_H_
Commit	Line	Data
1fc25a89 JS	1	/////////////////////////////////////////////////////////////////////////////
	2	// Name: misc.h
	3	// Purpose: Miscellaneous utilities for OGL
	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_MISC_H_
	13	#define _OGL_MISC_H_
	14
ab7ce33c	15	#if defined(__GNUG__) && !defined(__APPLE__)
1fc25a89 JS	16	#pragma interface "misc.h"
	17	#endif
	18
5f331691	19
1fc25a89 JS	20	// List to use when copying objects; may need to associate elements of new objects
	21	// with elements of old objects, e.g. when copying constraint.s
	22	extern wxList oglObjectCopyMapping;
	23
	24	/*
	25	* TEXT FORMATTING FUNCTIONS
	26	*
	27	*/
	28
	29	// Centres the given list of wxShapeTextLine strings in the given box
	30	// (changing the positions in situ). Doesn't actually draw into the DC.
5f331691	31	WXDLLIMPEXP_OGL void oglCentreText(wxDC& dc, wxList *text, double m_xpos, double m_ypos,
1fc25a89 JS	32	double width, double height,
	33	int formatMode = FORMAT_CENTRE_HORIZ \| FORMAT_CENTRE_VERT);
	34
	35	// Given a string, returns a list of strings that fit within the given
	36	// width of box. Height is ignored.
5f331691	37	WXDLLIMPEXP_OGL wxStringList* oglFormatText(wxDC& dc, const wxString& text, double width, double height, int formatMode = 0);
1fc25a89 JS	38
	39	// Centres the list of wxShapeTextLine strings, doesn't clip.
	40	// Doesn't actually draw into the DC.
5f331691	41	WXDLLIMPEXP_OGL void oglCentreTextNoClipping(wxDC& dc, wxList *text_list,
1fc25a89 JS	42	double m_xpos, double m_ypos, double width, double height);
	43
	44	// Gets the maximum width and height of the given list of wxShapeTextLines.
5f331691	45	WXDLLIMPEXP_OGL void oglGetCentredTextExtent(wxDC& dc, wxList *text_list,
1fc25a89 JS	46	double m_xpos, double m_ypos, double width, double height,
	47	double actual_width, double actual_height);
	48
	49	// Actually draw the preformatted list of wxShapeTextLines.
5f331691	50	WXDLLIMPEXP_OGL void oglDrawFormattedText(wxDC& context, wxList *text_list,
1fc25a89 JS	51	double m_xpos, double m_ypos, double width, double height,
	52	int formatMode = FORMAT_CENTRE_HORIZ \| FORMAT_CENTRE_VERT);
	53
	54	// Give it a list of points, finds the centre.
5f331691	55	WXDLLIMPEXP_OGL void oglFindPolylineCentroid(wxList points, double x, double *y);
1fc25a89	56
5f331691	57	WXDLLIMPEXP_OGL void oglCheckLineIntersection(double x1, double y1, double x2, double y2,
1fc25a89 JS	58	double x3, double y3, double x4, double y4,
	59	double ratio1, double ratio2);
	60
5f331691	61	WXDLLIMPEXP_OGL void oglFindEndForPolyline(double n, double xvec[], double yvec[],
1fc25a89 JS	62	double x1, double y1, double x2, double y2, double x3, double y3);
	63
	64
5f331691	65	WXDLLIMPEXP_OGL void oglFindEndForBox(double width, double height,
1fc25a89 JS	66	double x1, double y1, // Centre of box (possibly)
	67	double x2, double y2, // other end of line
	68	double x3, double y3); // End on box edge
	69
5f331691	70	WXDLLIMPEXP_OGL void oglFindEndForCircle(double radius,
1fc25a89 JS	71	double x1, double y1, // Centre of circle
	72	double x2, double y2, // Other end of line
	73	double x3, double y3);
	74
5f331691	75	WXDLLIMPEXP_OGL void oglGetArrowPoints(double x1, double y1, double x2, double y2,
1fc25a89 JS	76	double length, double width,
	77	double tip_x, double tip_y,
	78	double side1_x, double side1_y,
	79	double side2_x, double side2_y);
	80
	81	/*
	82	* Given an ellipse and endpoints of a line, returns the point at which
	83	* the line touches the ellipse in values x4, y4.
	84	* This function assumes that the centre of the ellipse is at x1, y1, and the
	85	* ellipse has a width of a1 and a height of b1. It also assumes you are
	86	* wanting to draw an arc FROM point x2, y2 TOWARDS point x3, y3.
67d54b58	87	* This function calculates the x,y coordinates of the intersection point of
1fc25a89 JS	88	* the arc with the ellipse.
	89	* Author: Ian Harrison
	90	*/
	91
5f331691	92	WXDLLIMPEXP_OGL void oglDrawArcToEllipse(double x1, double y1, double a1, double b1, double x2, double y2, double x3, double y3,
1fc25a89 JS	93	double x4, double y4);
1fc25a89 JS	94
5f331691	95	WXDLLIMPEXP_OGL bool oglRoughlyEqual(double val1, double val2, double tol = 0.00001);
1fc25a89 JS	96
	97	extern wxFont* g_oglNormalFont;
	98	extern wxPen* g_oglBlackPen;
	99	extern wxPen* g_oglWhiteBackgroundPen;
	100	extern wxPen* g_oglTransparentPen;
	101	extern wxBrush* g_oglWhiteBackgroundBrush;
	102	extern wxPen* g_oglBlackForegroundPen;
1fc25a89	103
5f7ea955	104	WXDLLIMPEXP_OGL wxFont* oglMatchFont(int point_size);
1fc25a89	105
5f7ea955 JS	106	WXDLLIMPEXP_OGL wxString oglColourToHex(const wxColour& colour);
	107	WXDLLIMPEXP_OGL wxColour oglHexToColour(const wxString& hex);
	108	WXDLLIMPEXP_OGL void oglDecToHex(unsigned int dec, char *buf);
	109	WXDLLIMPEXP_OGL unsigned int oglHexToDec(char* buf);
1fc25a89 JS	110
	111
	112	#endif
	113	// _OGL_MISC_H_