/* Graphics_linesAndAreas.cpp
 *
 * Copyright (C) 1992-2005,2007-2021 Paul Boersma, 2013 Tom Naughton
 *
 * This code is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or (at
 * your option) any later version.
 *
 * This code is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this work. If not, see <http://www.gnu.org/licenses/>.
 */

#include "GraphicsP.h"

/* Normally on, because e.g. the intensity contour in the Sound window should not run through the play buttons: */
#define FUNCTIONS_ARE_CLIPPED  1

#define LINE_WIDTH_IN_PIXELS(me)  ( my resolution > 192 ? my lineWidth * (my resolution / 192.0) : my lineWidth )
#define ORDER_DC  { double temp; if (x1DC > x2DC) temp = x1DC, x1DC = x2DC, x2DC = temp; \
	if (yIsZeroAtTheTop == (y2DC > y1DC)) temp = y1DC, y1DC = y2DC, y2DC = temp; }

static void psPrepareLine (GraphicsPostscript me) {
	double lineWidth_pixels = LINE_WIDTH_IN_PIXELS (me);
	if (my lineType == Graphics_DOTTED)
		my d_printf (my d_file, "[%td %td] 0 setdash\n", (integer) (my resolution / 100), (integer) (my resolution / 75 + lineWidth_pixels));
	else if (my lineType == Graphics_DASHED)
		my d_printf (my d_file, "[%td %td] 0 setdash\n", (integer) (my resolution / 25), (integer) (my resolution / 50 + lineWidth_pixels));
	else if (my lineType == Graphics_DASHED_DOTTED)
		my d_printf (my d_file, "[%td %td %td %td] 0 setdash\n",
			(integer) (my resolution / 100), (integer) (my resolution / 60 + lineWidth_pixels),
			(integer) (my resolution / 25), (integer) (my resolution / 60 + lineWidth_pixels));
	if (my lineWidth != 1.0)
		my d_printf (my d_file, "%g setlinewidth\n", lineWidth_pixels);
}
static void psRevertLine (GraphicsPostscript me) {
	if (my lineType != Graphics_DRAWN)
		my d_printf (my d_file, "[] 0 setdash\n");
	if (my lineWidth != 1.0)
		my d_printf (my d_file, "%g setlinewidth\n", my resolution > 192 ? my resolution / 192.0 : 1.0);   // 0.375 point
}

#if cairo
	static void cairoPrepareLine (GraphicsScreen me) {
		if (! my d_cairoGraphicsContext) return;
		double dotted_line [] { 2.0, 2.0 };
		double dashed_line [] { 6.0, 2.0 };
		double dashed_dotted_line [] { 6.0, 2.0, 2.0, 2.0 };
		cairo_save (my d_cairoGraphicsContext);
		switch (my lineType) {
			case Graphics_DOTTED:
				cairo_set_dash (my d_cairoGraphicsContext, dotted_line, 2, 1.0);
				break;
			case Graphics_DASHED:
				cairo_set_dash (my d_cairoGraphicsContext, dashed_line, 2, 1.0);
				break;
			case Graphics_DASHED_DOTTED:
				cairo_set_dash (my d_cairoGraphicsContext, dashed_dotted_line, 4, 1.0);
				break;
		}
		cairo_set_line_width (my d_cairoGraphicsContext, my lineWidth);
	}
	static void cairoRevertLine (GraphicsScreen me) {
		if (! my d_cairoGraphicsContext)
			return;
		if (my lineType >= Graphics_DOTTED)
			cairo_set_dash (my d_cairoGraphicsContext, nullptr, 0, 0);
		cairo_restore (my d_cairoGraphicsContext);
	}
#elif gdi
	#define MY_BRUSH  SelectPen (d_gdiGraphicsContext, GetStockPen (NULL_PEN)), SelectBrush (d_gdiGraphicsContext, d_winBrush);
	#define DEFAULT  SelectPen (d_gdiGraphicsContext, GetStockPen (BLACK_PEN)), SelectBrush (d_gdiGraphicsContext, GetStockBrush (NULL_BRUSH));
	static void winPrepareLine (GraphicsScreen me) {
		HPEN newPen;
		const int lineWidth_pixels = Melder_clippedLeft (1, int (LINE_WIDTH_IN_PIXELS (me) + 0.5));
		my d_fatNonSolid = my lineType != Graphics_DRAWN && lineWidth_pixels > 1;
		if (Melder_debug == 10) {
			LOGBRUSH brush;
			brush. lbStyle = BS_SOLID;
			brush. lbColor = my d_winForegroundColour;
			brush. lbHatch = my lineType == Graphics_DRAWN ? 0 : my lineType == Graphics_DOTTED ? PS_DOT : my lineType == Graphics_DASHED ? PS_DASH : PS_DASHDOT;
			if (my lineType == Graphics_DRAWN) {
				newPen = ExtCreatePen (PS_GEOMETRIC, lineWidth_pixels, & brush, 0, nullptr);
			} else {
				DWORD style [] = { 36, 33 };
				newPen = ExtCreatePen (PS_GEOMETRIC | PS_USERSTYLE, lineWidth_pixels, & brush, 2, style);
			}
		} else {
			/*newPen = CreatePen (my lineType == Graphics_DRAWN ? PS_SOLID :
				my lineType == Graphics_DOTTED ? PS_DOT : my lineType == Graphics_DASHED ? PS_DASH : PS_DASHDOT,
				my fatNonSolid ? 1 : lineWidth_pixels, my foregroundColour);*/
			LOGPEN pen;
			pen. lopnStyle = my lineType == Graphics_DRAWN ? PS_SOLID : my lineType == Graphics_DOTTED ? PS_DOT : my lineType == Graphics_DASHED ? PS_DASH : PS_DASHDOT;
			pen. lopnWidth. x = my d_fatNonSolid ? 1 : lineWidth_pixels;
			pen. lopnWidth. y = 0;
			pen. lopnColor = my d_winForegroundColour | 0x02000000;
			newPen = CreatePenIndirect (& pen);
		}
		SelectPen (my d_gdiGraphicsContext, newPen);
		DeletePen (my d_winPen);
		my d_winPen = newPen;
	}
#elif quartz
	static void quartzPrepareLine (GraphicsScreen me) {
		CGContextSetLineJoin (my d_macGraphicsContext, kCGLineJoinBevel);   // much faster than kCGLineJoinRound
		CGContextSetRGBStrokeColor (my d_macGraphicsContext, my colour.red, my colour.green, my colour.blue, 1.0);
		double lineWidth_pixels = LINE_WIDTH_IN_PIXELS (me);
		CGContextSetLineWidth (my d_macGraphicsContext, lineWidth_pixels);

		CGFloat lengths [4];
		if (my lineType == Graphics_DOTTED) {
			lengths [0] = my resolution > 192 ? my resolution / 100.0 : 2;
			lengths [1] = my resolution > 192 ? my resolution / 75.0 + lineWidth_pixels : 2;
		} else if (my lineType == Graphics_DASHED) {
			lengths [0] = my resolution > 192 ? my resolution / 25 : 6;
			lengths [1] = my resolution > 192 ? my resolution / 50.0 + lineWidth_pixels : 2;
		} else if (my lineType == Graphics_DASHED_DOTTED) {
			lengths [0] = my resolution > 192 ? my resolution / 25 : 6;
			lengths [1] = my resolution > 192 ? my resolution / 50.0 + lineWidth_pixels : 2;
			lengths [2] = my resolution > 192 ? my resolution / 100.0 : 2;
			lengths [3] = my resolution > 192 ? my resolution / 50.0 + lineWidth_pixels : 2;
		}
		CGContextSetLineDash (my d_macGraphicsContext, 0.0, my lineType == Graphics_DRAWN ? nullptr : lengths,
				my lineType == 0 ? 0 : my lineType == Graphics_DASHED_DOTTED ? 4 : 2);
	}
	static void quartzRevertLine (GraphicsScreen me) {
	}
	static void quartzPrepareFill (GraphicsScreen me) {
		CGContextSetAlpha (my d_macGraphicsContext, 1.0);
		CGContextSetRGBFillColor (my d_macGraphicsContext, my colour.red, my colour.green, my colour.blue, 1.0);
	}
#endif

/* First level. */

void structGraphicsScreen :: v_polyline (integer numberOfPoints, double *xyDC, bool close) {
	#if cairo
		if (our d_cairoGraphicsContext == nullptr)
			return;
		cairoPrepareLine (this);
		// cairo_new_path (d_cairoGraphicsContext); // move_to() automatically creates a new path
		cairo_move_to (our d_cairoGraphicsContext, xyDC [0], xyDC [1]);
		for (integer i = 1; i < numberOfPoints; i ++)
			cairo_line_to (our d_cairoGraphicsContext, xyDC [i + i], xyDC [i + i + 1]);
		if (close)
			cairo_close_path (our d_cairoGraphicsContext);
		cairo_stroke (our d_cairoGraphicsContext);
		cairoRevertLine (this);
	#elif gdi
		if (our d_useGdiplus && 0) {
			Gdiplus::Graphics dcplus (our d_gdiGraphicsContext);
			Gdiplus::Point *points = Melder_malloc (Gdiplus::Point, numberOfPoints + close);
			if (points) {
				for (integer i = 0; i < numberOfPoints; i ++) {
					points [i]. X = *xyDC, xyDC ++;
					points [i]. Y = *xyDC, xyDC ++;
				}
				if (close)
					points [numberOfPoints] = points [0];
#define LINE_WIDTH_IN_PIXELS2(hjhkj)  ( our resolution > 192 ? our lineWidth * (our resolution / 192.0) : our lineWidth )
				Gdiplus::Pen pen (Gdiplus::Color (255,0,0,0), LINE_WIDTH_IN_PIXELS2 (this) + 0.5);
				float dotted_line [] = { 2, 2 };
				float dashed_line [] = { 6, 2 };
				float dashed_dotted_line [] = { 6, 2, 2, 2 };
				switch (our lineType) {
					case Graphics_DOTTED:
						pen. SetDashPattern (dotted_line, 2);
						break;
					case Graphics_DASHED:
						pen. SetDashPattern (dashed_line, 2);
						break;
					case Graphics_DASHED_DOTTED:
						pen. SetDashPattern (dashed_dotted_line, 4);
						break;
				}
				dcplus. DrawLines (& pen, points, numberOfPoints + close);
				Melder_free (points);
			}
		} else {
			winPrepareLine (this);
			POINT *points = Melder_malloc (POINT, numberOfPoints + close);
			if (points) {
				for (integer i = 0; i < numberOfPoints; i ++) {
					points [i]. x = *xyDC, xyDC ++;
					points [i]. y = *xyDC, xyDC ++;
				}
				if (close)
					points [numberOfPoints] = points [0];
				Polyline (our d_gdiGraphicsContext, points, numberOfPoints + close);
				if (our d_fatNonSolid) {
					for (integer i = 0; i < numberOfPoints; i ++)
						points [i]. x -= 1;
					if (close)
						points [numberOfPoints] = points [0];
					Polyline (our d_gdiGraphicsContext, points, numberOfPoints + close);
					for (integer i = 0; i < numberOfPoints; i ++) {
						points [i]. x += 1;
						points [i]. y -= 1;
					}
					if (close)
						points [numberOfPoints] = points [0];
					Polyline (our d_gdiGraphicsContext, points, numberOfPoints + close);
				}
				Melder_free (points);
			}
			DEFAULT
		}
	#elif quartz
		quartzPrepareLine (this);
		CGContextBeginPath (our d_macGraphicsContext);
		trace (U"starting point ", xyDC [0], U" ", xyDC [1]);
		CGContextMoveToPoint (our d_macGraphicsContext, xyDC [0], xyDC [1]);   // starts a new subpath
		for (integer i = 1; i < numberOfPoints; i ++)
			CGContextAddLineToPoint (our d_macGraphicsContext, xyDC [i + i], xyDC [i + i + 1]);
		if (close)
			CGContextClosePath (our d_macGraphicsContext);   // closes only the subpath
		CGContextStrokePath (our d_macGraphicsContext);
		quartzRevertLine (this);
	#endif
}

void structGraphicsPostscript :: v_polyline (integer numberOfPoints, double *xyDC, bool close) {
	const integer nn = 2 * numberOfPoints;
	psPrepareLine (this);
	our d_printf (our d_file, "N %.7g %.7g moveto\n", xyDC [0], xyDC [1]);
	for (integer i = 2; i < nn; i += 2) {
		const double dx = xyDC [i] - xyDC [i - 2], dy = xyDC [i + 1] - xyDC [i - 1];
		our d_printf (our d_file, "%.7g %.7g L\n", dx, dy);
	}
	if (close)
		our d_printf (our d_file, "closepath ");
	our d_printf (our d_file, "stroke\n");
	psRevertLine (this);
}

void structGraphicsScreen :: v_fillArea (integer numberOfPoints, double *xyDC) {
	#if cairo
		if (our d_cairoGraphicsContext == nullptr)
			return;
		// cairo_new_path (our d_cairoGraphicsContext); // move_to() automatically creates a new path
		cairo_move_to (our d_cairoGraphicsContext, xyDC [0], xyDC [1]);
		for (integer i = 1; i < numberOfPoints; i ++)
			cairo_line_to (our d_cairoGraphicsContext, xyDC [i + i], xyDC [i + i + 1]);
		cairo_close_path (our d_cairoGraphicsContext);
		cairo_fill (our d_cairoGraphicsContext);
	#elif gdi
		MY_BRUSH
		BeginPath (our d_gdiGraphicsContext);
		MoveToEx (our d_gdiGraphicsContext, xyDC [0], xyDC [1], nullptr);
		for (integer i = 1; i < numberOfPoints; i ++)
			LineTo (our d_gdiGraphicsContext, xyDC [i + i], xyDC [i + i + 1]);
		EndPath (our d_gdiGraphicsContext);
		FillPath (our d_gdiGraphicsContext);
		DEFAULT
	#elif quartz
		quartzPrepareFill (this);
		CGContextBeginPath (our d_macGraphicsContext);
		CGContextMoveToPoint (our d_macGraphicsContext, xyDC [0], xyDC [1]);
		for (integer i = 1; i < numberOfPoints; i ++)
			CGContextAddLineToPoint (our d_macGraphicsContext, xyDC [i + i], xyDC [i + i + 1]);
		CGContextFillPath (our d_macGraphicsContext);
	#endif
}

void structGraphicsPostscript :: v_fillArea (integer numberOfPoints, double *xyDC) {
	integer nn = numberOfPoints + numberOfPoints;
	our d_printf (our d_file, "N %.7g %.7g M\n", xyDC [0], xyDC [1]);
	for (integer i = 2; i < nn; i += 2)
		our d_printf (our d_file, "%.7g %.7g L\n", xyDC [i] - xyDC [i - 2], xyDC [i + 1] - xyDC [i - 1]);
	our d_printf (our d_file, "closepath fill\n");
}

/* Second level. */

void structGraphicsScreen :: v_rectangle (double x1DC, double x2DC, double y1DC, double y2DC) {
	ORDER_DC
	#if cairo
		if (! our d_cairoGraphicsContext)
			return;
		const double width = x2DC - x1DC, height = y1DC - y2DC;
		if (width <= 0.0 || height <= 0.0)
			return;
		cairoPrepareLine (this);
		cairo_rectangle (our d_cairoGraphicsContext, x1DC, y2DC, width, height);
		cairo_stroke (our d_cairoGraphicsContext);
		cairoRevertLine (this);
	#elif gdi
		winPrepareLine (this);
		Rectangle (our d_gdiGraphicsContext, x1DC, y2DC, x2DC + 1.0, y1DC + 1.0);
		DEFAULT
	#elif quartz
		quartzPrepareLine (this);
		CGContextStrokeRect (our d_macGraphicsContext, CGRectMake (x1DC, y2DC, x2DC - x1DC, y1DC - y2DC));
		quartzRevertLine (this);
	#else
		double xyDC [8];
		xyDC [0] = x1DC;	xyDC [1] = y1DC;
		xyDC [2] = x2DC;	xyDC [3] = y1DC;
		xyDC [4] = x2DC;	xyDC [5] = y2DC;
		xyDC [6] = x1DC;	xyDC [7] = y2DC;
		our v_polyline (5, & xyDC [0], true);
	#endif
}

void structGraphicsPostscript :: v_rectangle (double x1DC, double x2DC, double y1DC, double y2DC) {
	psPrepareLine (this);
	our d_printf (our d_file, "N %.7g %.7g M %.7g %.7g lineto %.7g %.7g lineto %.7g %.7g lineto closepath stroke\n",
			x1DC, y1DC, x2DC, y1DC, x2DC, y2DC, x1DC, y2DC);
	psRevertLine (this);
}

void structGraphicsScreen :: v_fillRectangle (double x1DC, double x2DC, double y1DC, double y2DC) {
	ORDER_DC
	#if cairo
		if (! our d_cairoGraphicsContext)
			return;
		const double width = x2DC - x1DC + 1.0, height = y1DC - y2DC + 1.0;
		if (width <= 0.0 || height <= 0.0)
			return;
		trace (U"x1DC ", x1DC, U", x2DC ", x2DC, U", y1DC ", y1DC, U", y2DC ", y2DC);
		cairo_rectangle (our d_cairoGraphicsContext, round (x1DC), round (y2DC), round (width), round (height));
		cairo_fill (our d_cairoGraphicsContext);
	#elif gdi
		RECT rect;
		rect. left = x1DC, rect. right = x2DC, rect. top = y2DC, rect. bottom = y1DC;   /* Superfluous? */
		MY_BRUSH
		Rectangle (our d_gdiGraphicsContext, x1DC, y2DC, x2DC + 1.0, y1DC + 1.0);
		DEFAULT
	#elif quartz
		quartzPrepareFill (this);
		CGContextFillRect (our d_macGraphicsContext, CGRectMake (x1DC, y2DC, x2DC - x1DC, y1DC - y2DC));
	#else
		double xyDC [10];
		xyDC [0] = x1DC;	xyDC [1] = y1DC;
		xyDC [2] = x2DC;	xyDC [3] = y1DC;
		xyDC [4] = x2DC;	xyDC [5] = y2DC;
		xyDC [6] = x1DC;	xyDC [7] = y2DC;
		xyDC [8] = x1DC;	xyDC [9] = y1DC;
		our v_fillArea (5, & xyDC [0]);
	#endif
}

void structGraphicsPostscript :: v_fillRectangle (double x1DC, double x2DC, double y1DC, double y2DC) {
	our d_printf (our d_file,
		"N %.7g %.7g M %.7g %.7g lineto %.7g %.7g lineto %.7g %.7g lineto closepath fill\n",
		x1DC, y1DC, x2DC, y1DC, x2DC, y2DC, x1DC, y2DC);
}

void structGraphicsScreen :: v_circle (double xDC, double yDC, double rDC) {
	#if cairo
		if (! our d_cairoGraphicsContext)
			return;
		cairoPrepareLine (this);
		cairo_new_path (our d_cairoGraphicsContext);
		cairo_arc (our d_cairoGraphicsContext, xDC, yDC, rDC, 0.0, 2.0 * M_PI);
		cairo_stroke (our d_cairoGraphicsContext);
		cairoRevertLine (this);
	#elif gdi
		winPrepareLine (this);
		Ellipse (our d_gdiGraphicsContext, xDC - rDC, yDC - rDC, xDC + rDC, yDC + rDC);
		DEFAULT
	#elif quartz
		quartzPrepareLine (this);
		CGContextBeginPath (our d_macGraphicsContext);
		CGContextAddArc (our d_macGraphicsContext, xDC, yDC, rDC, 0.0, NUM2pi, 0);
		CGContextStrokePath (our d_macGraphicsContext);
		quartzRevertLine (this);
	#endif
}

void structGraphicsPostscript :: v_circle (double xDC, double yDC, double rDC) {
	psPrepareLine (this);
	our d_printf (our d_file, "N %td %td %td C\n", (integer) xDC, (integer) yDC, (integer) rDC);
	psRevertLine (this);
}

void structGraphicsScreen :: v_ellipse (double x1DC, double x2DC, double y1DC, double y2DC) {
	ORDER_DC
	#if cairo
		if (! our d_cairoGraphicsContext)
			return;
		cairoPrepareLine (this);
		cairo_new_path (our d_cairoGraphicsContext);
		cairo_save (our d_cairoGraphicsContext);
		cairo_translate (our d_cairoGraphicsContext, 0.5 * (x2DC + x1DC), 0.5 * (y2DC + y1DC));
		cairo_scale (our d_cairoGraphicsContext, 0.5 * (x2DC - x1DC), 0.5 * (y2DC - y1DC));
		cairo_arc (our d_cairoGraphicsContext, 0.0, 0.0, 1.0, 0.0, 2 * M_PI);
		cairo_restore (our d_cairoGraphicsContext);
		cairo_stroke (our d_cairoGraphicsContext);
		cairoRevertLine (this);
	#elif gdi
		winPrepareLine (this);
		Ellipse (our d_gdiGraphicsContext, x1DC, y2DC, x2DC + 1, y1DC + 1);
		DEFAULT
	#elif quartz
		quartzPrepareLine (this);
        //NSCAssert (our d_macGraphicsContext, @"nil context");
		CGContextBeginPath (our d_macGraphicsContext);
		CGContextSaveGState (our d_macGraphicsContext);
		CGContextTranslateCTM (our d_macGraphicsContext, 0.5 * (x2DC + x1DC), 0.5 * (y2DC + y1DC));
		CGContextScaleCTM (our d_macGraphicsContext, 0.5 * (x2DC - x1DC), 0.5 * (y2DC - y1DC));
		CGContextAddArc (our d_macGraphicsContext, 0.0, 0.0, 1.0, 0.0, NUM2pi, 0);
		CGContextScaleCTM (our d_macGraphicsContext, 2.0 / (x2DC - x1DC), 2.0 / (y2DC - y1DC));
		CGContextStrokePath (our d_macGraphicsContext);
		CGContextRestoreGState (our d_macGraphicsContext);
		quartzRevertLine (this);
	#endif
}

void structGraphicsPostscript :: v_ellipse (double x1DC, double x2DC, double y1DC, double y2DC) {
	if (x1DC != x2DC && y1DC != y2DC) {   // prevent division by zero
		psPrepareLine (this);
		/* To draw an ellipse, we will have to 'translate' and 'scale' and draw a circle. */
		/* However, we have to scale back before the actual 'stroke', */
		/* because we want the normal line thickness; */
		/* So we cannot use 'gsave' and 'grestore', which clear the path (Cookbook 3). */
		our d_printf (our d_file, "gsave %.7g %.7g translate %.7g %.7g scale N 0 0 1 0 360 arc\n"
			" %.7g %.7g scale stroke grestore\n",
			0.5 * (x2DC + x1DC), 0.5 * (y2DC + y1DC), 0.5 * (x2DC - x1DC), 0.5 * (y2DC - y1DC),
			2.0 / (x2DC - x1DC), 2.0 / (y2DC - y1DC)
		);
		psRevertLine (this);
	}
}

void structGraphicsScreen :: v_arc (double xDC, double yDC, double rDC, double fromAngle, double toAngle) {
	#if cairo
		if (! our d_cairoGraphicsContext)
			return;
		cairoPrepareLine (this);
		cairo_new_path (our d_cairoGraphicsContext);
		cairo_arc (our d_cairoGraphicsContext, xDC, yDC, rDC, -toAngle * (M_PI / 180.0), -fromAngle * (M_PI / 180.0));
		cairo_stroke (our d_cairoGraphicsContext);
		cairoRevertLine (this);
	#elif gdi
		int arcAngle = (int) toAngle - (int) fromAngle;
		POINT pt;
		if (arcAngle < 0.0)
			arcAngle += 360;
		winPrepareLine (this);
		MoveToEx (our d_gdiGraphicsContext, xDC + rDC * cos (NUMpi / 180 * fromAngle), yDC - rDC * sin (NUMpi / 180 * fromAngle), & pt);
		AngleArc (our d_gdiGraphicsContext, xDC, yDC, rDC, fromAngle, arcAngle);
		DEFAULT
	#elif quartz
		quartzPrepareLine (this);
		CGContextBeginPath (our d_macGraphicsContext);
		CGContextAddArc (our d_macGraphicsContext, xDC, yDC, rDC, NUM2pi - NUMpi / 180 * toAngle, NUM2pi - NUMpi / 180 * fromAngle, 0);
		CGContextStrokePath (our d_macGraphicsContext);
		quartzRevertLine (this);
	#endif
}

void structGraphicsPostscript :: v_arc (double xDC, double yDC, double rDC, double fromAngle, double toAngle) {
	psPrepareLine (this);
	our d_printf (d_file, "N %.7g %.7g %.7g %.7g %.7g arc stroke\n", xDC, yDC, rDC, fromAngle, toAngle);
	psRevertLine (this);
}

/* Third level. */

void structGraphicsScreen :: v_fillCircle (double xDC, double yDC, double rDC) {
	#if cairo
		if (! our d_cairoGraphicsContext)
			return;
		cairo_new_path (our d_cairoGraphicsContext);
		cairo_arc (our d_cairoGraphicsContext, xDC, yDC, rDC, 0, 2 * M_PI);
		cairo_fill (our d_cairoGraphicsContext);
	#elif gdi
		MY_BRUSH
		/*
		 * NT cannot fill circles that span less than five pixels...
		 */
		Ellipse (our d_gdiGraphicsContext, xDC - rDC, yDC - rDC, xDC + rDC, yDC + rDC);
		DEFAULT
	#elif quartz
		quartzPrepareFill (this);
		CGContextBeginPath (our d_macGraphicsContext);
		CGContextAddArc (our d_macGraphicsContext, xDC, yDC, rDC, 0.0, NUM2pi, 0);
		CGContextFillPath (our d_macGraphicsContext);
	#else
		our v_circle (xDC, yDC, rDC);
	#endif
}

void structGraphicsPostscript :: v_fillCircle (double xDC, double yDC, double rDC) {
	d_printf (d_file, "N %.7g %.7g %.7g FC\n", xDC, yDC, rDC);
}

void structGraphicsScreen :: v_fillEllipse (double x1DC, double x2DC, double y1DC, double y2DC) {
	ORDER_DC
	#if cairo
		if (! our d_cairoGraphicsContext)
			return;
		cairo_new_path (our d_cairoGraphicsContext);
		cairo_save (our d_cairoGraphicsContext);
		cairo_translate (our d_cairoGraphicsContext, 0.5 * (x2DC + x1DC), 0.5 * (y2DC + y1DC));
		cairo_scale (our d_cairoGraphicsContext, 0.5 * (x2DC - x1DC), 0.5 * (y2DC - y1DC));
		cairo_arc (our d_cairoGraphicsContext, 0.0, 0.0, 1.0, 0.0, 2.0 * M_PI);
		cairo_restore (our d_cairoGraphicsContext);
		cairo_fill (our d_cairoGraphicsContext);
	#elif gdi
		MY_BRUSH
		Ellipse (our d_gdiGraphicsContext, x1DC, y2DC, x2DC + 1.0, y1DC + 1.0);
		DEFAULT
	#elif quartz
		quartzPrepareFill (this);
        //NSCAssert (our d_macGraphicsContext, @"nil context");
		CGContextBeginPath (our d_macGraphicsContext);
		CGContextSaveGState (our d_macGraphicsContext);
		CGContextTranslateCTM (our d_macGraphicsContext, 0.5 * (x2DC + x1DC), 0.5 * (y2DC + y1DC));
		CGContextScaleCTM (our d_macGraphicsContext, 0.5 * (x2DC - x1DC), 0.5 * (y2DC - y1DC));
		CGContextAddArc (our d_macGraphicsContext, 0.0, 0.0, 1.0, 0.0, NUM2pi, 0);
		CGContextScaleCTM (our d_macGraphicsContext, 2.0 / (x2DC - x1DC), 2.0 / (y2DC - y1DC));
		CGContextFillPath (our d_macGraphicsContext);
		CGContextRestoreGState (our d_macGraphicsContext);
	#else
		our v_ellipse (x1DC, x2DC, y1DC, y2DC);
	#endif
}

void structGraphicsPostscript :: v_fillEllipse (double x1DC, double x2DC, double y1DC, double y2DC) {
	our d_printf (our d_file, "gsave %.7g %.7g translate %.7g %.7g scale N 0 0 1 FC grestore\n",
			(x2DC + x1DC) / 2.0, (y2DC + y1DC) / 2.0, (x2DC - x1DC) / 2.0, (y2DC - y1DC) / 2.0);
}

void structGraphicsScreen :: v_button (double x1DC, double x2DC, double y1DC, double y2DC) {
	ORDER_DC
	#if cairo
		if (x2DC <= x1DC || y1DC <= y2DC)
			return;
		cairo_save (our d_cairoGraphicsContext);
		#if 0
			if (our d_drawingArea) {
				// clip to drawing area
				const int w = gdk_window_get_width (our d_window);
				const int h = gdk_window_get_height (our d_window);
				cairo_rectangle (our d_cairoGraphicsContext, 0, 0, w, h);
				cairo_clip (our d_cairoGraphicsContext);
			}
		#endif
		cairo_set_line_width (our d_cairoGraphicsContext, 1.0);
		double left = x1DC - 0.5, right = x2DC - 0.5, top = y2DC + 0.5, bottom = y1DC + 0.5;
		double width = right - left, height = bottom - top;
		cairo_set_source_rgb (our d_cairoGraphicsContext, 0.1, 0.1, 0.1);   // dark grey
		cairo_rectangle (our d_cairoGraphicsContext, left, top, width, height);
		cairo_stroke (our d_cairoGraphicsContext);
		
		left += 1.0;
		right -= 1.0;
		top += 1.0;
		bottom -= 1.0;
		width -= 2.0;
		height -= 2.0;
		if (width > 0.0 && height > 0.0) {
			cairo_set_source_rgb (our d_cairoGraphicsContext, 0.3, 0.3, 0.3);
			cairo_move_to (our d_cairoGraphicsContext, left + 1, bottom);
			cairo_line_to (our d_cairoGraphicsContext, right, bottom);
			cairo_line_to (our d_cairoGraphicsContext, right, top + 1);
			cairo_stroke (our d_cairoGraphicsContext);
			
			cairo_set_source_rgb (our d_cairoGraphicsContext, 1.0, 1.0, 1.0);
			cairo_move_to (our d_cairoGraphicsContext, left, bottom);
			cairo_line_to (our d_cairoGraphicsContext, left, top);
			cairo_line_to (our d_cairoGraphicsContext, right, top);
			cairo_stroke (our d_cairoGraphicsContext);
			left += 0.5;
			right -= 0.5;
			top += 0.5;
			bottom -= 0.5;
			width -= 1.0;
			height -= 1.0;
			if (width > 0.0 && height > 0.0) {
				cairo_set_source_rgb (our d_cairoGraphicsContext, 0.65, 0.65, 0.65);
				cairo_rectangle (our d_cairoGraphicsContext, left, top, width, height);
				cairo_fill (our d_cairoGraphicsContext);
			}
		}
		cairo_restore (our d_cairoGraphicsContext);
	#elif quartz
        double width = x2DC - x1DC, height = y1DC - y2DC;
		if (width <= 0.0 || height <= 0.0)
			return;
		/*
			This is pixel-precise drawing, and may therefore be different on retina displays than on 100 dpi displays.
		*/
		//const bool isRetinaDisplay = [[our d_macView window] backingScaleFactor] == 2.0;

		CGContextSetLineWidth (our d_macGraphicsContext, 1.0);
		CGContextSetAllowsAntialiasing (our d_macGraphicsContext, false);   // because we want to draw by pixel
        CGFloat red = 0.3, green = 0.3, blue = 0.2;
        CGContextSetRGBStrokeColor (our d_macGraphicsContext, red, green, blue, 1.0);
		x1DC += 0.5;
		x2DC -= 0.5;
		y1DC -= 0.5;
		y2DC += 0.5;
		width = x2DC - x1DC;
		height = y1DC - y2DC;
        CGRect rect = CGRectMake (x1DC, y2DC, width, height);
        CGContextAddRect (our d_macGraphicsContext, rect);
        CGContextStrokePath (our d_macGraphicsContext);
		x1DC += 1.0;
		x2DC -= 1.0;
		y1DC -= 1.0;
		y2DC += 1.0;
		width = x2DC - x1DC;
		height = y1DC - y2DC;
		if (width > 0.0 && height > 0.0) {
			red = 0.5, green = 0.5, blue = 0.4;
			CGContextSetRGBStrokeColor (our d_macGraphicsContext, red, green, blue, 1.0);
			CGContextMoveToPoint (our d_macGraphicsContext, x1DC, y1DC);
			CGContextAddLineToPoint (our d_macGraphicsContext, x2DC, y1DC);
			CGContextMoveToPoint (our d_macGraphicsContext, x2DC, y1DC);
			CGContextAddLineToPoint (our d_macGraphicsContext, x2DC, y2DC);
			CGContextStrokePath (our d_macGraphicsContext);
			red = 1.0, green = 1.0, blue = 0.9;
			CGContextSetRGBStrokeColor (our d_macGraphicsContext, red, green, blue, 1.0);
			CGContextMoveToPoint (our d_macGraphicsContext, x1DC, y1DC);
			CGContextAddLineToPoint (our d_macGraphicsContext, x1DC, y2DC);
			CGContextMoveToPoint (our d_macGraphicsContext, x1DC, y2DC);
            CGContextAddLineToPoint (our d_macGraphicsContext, x2DC, y2DC);
            CGContextStrokePath (our d_macGraphicsContext);
			if (width > 2.0 && height > 2.0) {
				red = 0.75, green = 0.75, blue = 0.65;
				CGContextSetRGBFillColor (our d_macGraphicsContext, red, green, blue, 1.0);
				rect = CGRectMake (x1DC, y2DC, width, height);
				CGContextFillRect (our d_macGraphicsContext, rect);
            }
        }
		CGContextSetAllowsAntialiasing (our d_macGraphicsContext, true);
		CGContextSetLineDash (our d_macGraphicsContext, 0, nullptr, 0);
    #elif gdi
        RECT rect;
        rect. left = x1DC, rect. right = x2DC, rect. top = y2DC, rect. bottom = y1DC;
        DrawEdge (our d_gdiGraphicsContext, & rect, EDGE_RAISED, BF_RECT);
        SelectPen (our d_gdiGraphicsContext, GetStockPen (NULL_PEN));
        SelectBrush (our d_gdiGraphicsContext, GetStockBrush (LTGRAY_BRUSH));
        Rectangle (our d_gdiGraphicsContext, x1DC + 1, y2DC + 1, x2DC - 1, y1DC - 1);
        SelectPen (our d_gdiGraphicsContext, GetStockPen (BLACK_PEN));
        SelectBrush (our d_gdiGraphicsContext, GetStockBrush (NULL_BRUSH));
	#endif
}

void structGraphics :: v_roundedRectangle (double x1DC, double x2DC, double y1DC, double y2DC, double r) {
	const double dy = ( yIsZeroAtTheTop ? - r : r );
	double xyDC [4];
	ORDER_DC
	xyDC [0] = x1DC + r;
	xyDC [1] = y1DC;
	xyDC [2] = x2DC - r;
	xyDC [3] = y1DC;
	our v_polyline (2, xyDC, false);
	our v_arc (x2DC - r, y1DC + dy, r, -90.0, 0.0);
	xyDC [0] = x2DC;
	xyDC [1] = y1DC + dy;
	xyDC [2] = x2DC;
	xyDC [3] = y2DC - dy;
	our v_polyline (2, xyDC, false);
	our v_arc (x2DC - r, y2DC - dy, r, 0.0, 90.0);
	xyDC [0] = x2DC - r;
	xyDC [1] = y2DC;
	xyDC [2] = x1DC + r;
	xyDC [3] = y2DC;
	our v_polyline (2, xyDC, false);
	our v_arc (x1DC + r, y2DC - dy, r, 90.0, 180.0);
	xyDC [0] = x1DC;
	xyDC [1] = y2DC - dy;
	xyDC [2] = x1DC;
	xyDC [3] = y1DC + dy;
	our v_polyline (2, xyDC, false);
	our v_arc (x1DC + r, y1DC + dy, r, 180.0, 270.0);
}

void structGraphicsScreen :: v_roundedRectangle (double x1DC, double x2DC, double y1DC, double y2DC, double r) {
	#if gdi
		const double dy = ( yIsZeroAtTheTop ? - r : r );
		double xyDC [4];
		ORDER_DC
		winPrepareLine (this);
		RoundRect (d_gdiGraphicsContext, x1DC, y2DC, x2DC + 1.0, y1DC + 1.0, r + r, r + r);
		DEFAULT
		return;
	#else
		GraphicsScreen_Parent :: v_roundedRectangle (x1DC, x2DC, y1DC, y2DC, r);
	#endif
}

/* Fourth level. */

void structGraphics :: v_fillRoundedRectangle (double x1DC, double x2DC, double y1DC, double y2DC, double r) {
	const double dy = ( yIsZeroAtTheTop ? - r : r );
	ORDER_DC
	our v_fillCircle (x2DC - r, y1DC + dy, r);
	our v_fillCircle (x2DC - r, y2DC - dy, r);
	our v_fillCircle (x1DC + r, y2DC - dy, r);
	our v_fillCircle (x1DC + r, y1DC + dy, r);
	our v_fillRectangle (x1DC, x2DC, y1DC + dy, y2DC - dy);
	our v_fillRectangle (x1DC + r, x2DC - r, y1DC, y2DC);
}

/* Fifth level. */

#define wdx(x)  ((x) * my scaleX + my deltaX)
#define wdy(y)  ((y) * my scaleY + my deltaY)

void Graphics_polyline (Graphics me, integer numberOfPoints, const double *xWC, const double *yWC) {   // base 0
	if (my recording) {
		op (POLYLINE, 1 + 2 * numberOfPoints);
		put (numberOfPoints);
		mput (numberOfPoints, & xWC [0])
		mput (numberOfPoints, & yWC [0])
	} else {
		if (numberOfPoints < 2)
			return;
		double *xyDC;
		try {
			xyDC = Melder_malloc (double, 2 * numberOfPoints);
		} catch (MelderError) {
			/*
				Out of memory: silently refuse to draw.
			 */
			Melder_clearError ();
			return;
		}
		for (integer i = 0; i < numberOfPoints; i ++) {
			xyDC [i + i] = wdx (xWC [i]);
			xyDC [i + i + 1] = wdy (yWC [i]);
		}
		my v_polyline (numberOfPoints, xyDC, false);
		Melder_free (xyDC);
	}
}

void Graphics_polyline_closed (Graphics me, integer numberOfPoints, const double *xWC, const double *yWC) {   // base 0
	if (my recording) {
		op (POLYLINE_CLOSED, 1 + 2 * numberOfPoints);
		put (numberOfPoints);
		mput (numberOfPoints, & xWC [0])
		mput (numberOfPoints, & yWC [0])
	} else {
		if (numberOfPoints < 1)
			return;
		double *xyDC;
		try {
			xyDC = Melder_malloc (double, 2 * numberOfPoints);
		} catch (MelderError) {
			/*
				Out of memory: silently refuse to draw.
			*/
			Melder_clearError ();
			return;
		}
		for (integer i = 0; i < numberOfPoints; i ++) {
			xyDC [i + i] = wdx (xWC [i]);
			xyDC [i + i + 1] = wdy (yWC [i]);
		}
		my v_polyline (numberOfPoints, xyDC, true);
		Melder_free (xyDC);
	}
}

void Graphics_line (Graphics me, double x1WC, double y1WC, double x2WC, double y2WC) {
	if (my recording) {
		op (LINE, 4); put (x1WC); put (y1WC); put (x2WC); put (y2WC);
	} else {
		double xyDC [4];
		trace (x1WC, U" ", y1WC, U" ", x2WC, U" ", y2WC);
		xyDC [0] = wdx (x1WC);
		xyDC [1] = wdy (y1WC);
		xyDC [2] = wdx (x2WC);
		xyDC [3] = wdy (y2WC);
		my v_polyline (2, xyDC, false);
	}
}

void Graphics_fillArea (Graphics me, integer numberOfPoints, double const *xWC, double const *yWC) {
	if (my recording) {
		op (FILL_AREA, 1 + 2 * numberOfPoints);
		put (numberOfPoints);
		mput (numberOfPoints, & xWC [0])
		mput (numberOfPoints, & yWC [0])
	} else {
		if (numberOfPoints < 3)
			return;
		double *xyDC;
		try {
			xyDC = Melder_malloc (double, 2 * numberOfPoints);
		} catch (MelderError) {
			/*
				Out of memory: silently refuse to draw.
			*/
			Melder_clearError ();
			return;
		}
		for (integer i = 0; i < numberOfPoints; i ++) {
			xyDC [i + i] = wdx (xWC [i]);
			xyDC [i + i + 1] = wdy (yWC [i]);
		}
		my v_fillArea (numberOfPoints, xyDC);
		Melder_free (xyDC);
	}
}

template <typename TYPE>
void Graphics_function_ (Graphics me, const TYPE yWC [], integer stride, integer ix1, integer ix2, double x1WC, double x2WC) {
	const integer clipy1 = wdy (my d_y1WC), clipy2 = wdy (my d_y2WC);
	const integer n = ix2 - ix1 + 1;
	if (n <= 1 || my scaleX == 0.0)
		return;
	const double dx = (x2WC - x1WC) / (n - 1);
	const double offsetX = x1WC - ix1 * dx;
	/* xDC = wdx (offsetX + i * dx) */
	const double translation = wdx (offsetX);
	const double scale = dx * my scaleX;
	const integer x1DC = translation + ix1 * scale;
	const integer x2DC = translation + ix2 * scale;
	if (n > (x2DC - x1DC + 1) * 2) {   // optimize: draw one vertical line for each device x coordinate
		const integer numberOfPixels = x2DC - x1DC + 1;
		integer k = 0;
		const integer numberOfPointsActuallyDrawn = numberOfPixels * 2;
		TYPE lastMini;
		if (numberOfPointsActuallyDrawn < 1)
			return;
		double *xyDC = Melder_malloc_f (double, 2 * numberOfPointsActuallyDrawn);
		for (integer i = 0; i < numberOfPixels; i ++) {
			integer jmin = ix1 + i / scale, jmax = ix1 + (i + 1) / scale;
			if (jmin > ix2) jmin = ix2;
			if (jmax > ix2) jmax = ix2;
			TYPE mini = yWC [stride * jmin], maxi = mini;
			for (integer j = jmin + 1; j <= jmax; j ++) {   // one point overlap
				TYPE value = yWC [stride * j];
				if (value > maxi) maxi = value;
				else if (value < mini) mini = value;
			}
			integer minDC = wdy (mini);
			integer maxDC = wdy (maxi);
			if (my yIsZeroAtTheTop) {
				if (minDC > clipy1) minDC = clipy1;
				if (maxDC > clipy1) maxDC = clipy1;
				if (maxDC < clipy2) maxDC = clipy2;
				if (minDC < clipy2) minDC = clipy2;
			} else {
				if (minDC < clipy1) minDC = clipy1;
				if (maxDC < clipy1) maxDC = clipy1;
				if (maxDC > clipy2) maxDC = clipy2;
				if (minDC > clipy2) minDC = clipy2;
			}
			if (i == 0) {
				if (yWC [stride * jmin] < yWC [stride * jmax]) {
					xyDC [k ++] = x1DC;
					xyDC [k ++] = minDC;
					xyDC [k ++] = x1DC;
					xyDC [k ++] = maxDC;
				} else {
					xyDC [k ++] = x1DC;
					xyDC [k ++] = maxDC;
					xyDC [k ++] = x1DC;
					xyDC [k ++] = minDC;
				}
			} else if (minDC == xyDC [k - 1]) {
				xyDC [k ++] = x1DC + i;
				xyDC [k ++] = maxDC;
			} else if (maxDC == xyDC [k - 1]) {
				xyDC [k ++] = x1DC + i;
				xyDC [k ++] = minDC;
			} else if (mini > lastMini) {
				xyDC [k ++] = x1DC + i;
				xyDC [k ++] = minDC;
				xyDC [k ++] = x1DC + i;
				xyDC [k ++] = maxDC;
			} else {
				xyDC [k ++] = x1DC + i;
				xyDC [k ++] = maxDC;
				xyDC [k ++] = x1DC + i;
				xyDC [k ++] = minDC;
			}
			lastMini = mini;
		}
		if (k > 1)
			my v_polyline (k / 2, xyDC, false);
		Melder_free (xyDC);
	} else {   // normal
		double *xyDC = Melder_malloc_f (double, 2 * n);
		for (integer i = 0; i < n; i ++) {
			integer ix = ix1 + i;
			integer value = wdy (yWC [stride * ix]);
			xyDC [i + i] = translation + ix * scale;
			if (my yIsZeroAtTheTop) {
				if (FUNCTIONS_ARE_CLIPPED && value > clipy1) value = clipy1;
				if (FUNCTIONS_ARE_CLIPPED && value < clipy2) value = clipy2;
			} else {
				if (FUNCTIONS_ARE_CLIPPED && value < clipy1) value = clipy1;
				if (FUNCTIONS_ARE_CLIPPED && value > clipy2) value = clipy2;
			}
			xyDC [i + i + 1] = value;
		}
		my v_polyline (n, xyDC, false);
		Melder_free (xyDC);
	}
}

void Graphics_function (Graphics me, const double yWC [], integer ix1, integer ix2, double x1WC, double x2WC) {
	if (my recording) {
		const integer n = ix2 - ix1 + 1;
		if (n >= 2) {
			op (FUNCTION, 3 + n);
			put (n);
			put (x1WC);
			put (x2WC);
			mput (n, & yWC [ix1])
		}
	} else
		Graphics_function_ <double> (me, yWC, 1, ix1, ix2, x1WC, x2WC);
}

void Graphics_function16 (Graphics me, const int16 yWC [], integer stride, integer ix1, integer ix2, double x1WC, double x2WC) {
	if (my recording) {
		Melder_fatal (U"Graphics_function16: cannot be used during graphics recording.");
	} else
		Graphics_function_ <int16> (me, yWC, stride, ix1, ix2, x1WC, x2WC);
}

void Graphics_rectangle (Graphics me, double x1WC, double x2WC, double y1WC, double y2WC) {
	if (my recording) {
		op (RECTANGLE, 4); put (x1WC); put (x2WC); put (y1WC); put (y2WC);
	} else
		my v_rectangle (wdx (x1WC), wdx (x2WC), wdy (y1WC), wdy (y2WC));
}

void Graphics_fillRectangle (Graphics me, double x1WC, double x2WC, double y1WC, double y2WC) {
	if (my recording) {
		op (FILL_RECTANGLE, 4); put (x1WC); put (x2WC); put (y1WC); put (y2WC);
	} else
		my v_fillRectangle (wdx (x1WC), wdx (x2WC), wdy (y1WC), wdy (y2WC));
}

void Graphics_roundedRectangle (Graphics me, double x1WC, double x2WC, double y1WC, double y2WC, double r_mm) {
	if (my recording) {
		op (ROUNDED_RECTANGLE, 5); put (x1WC); put (x2WC); put (y1WC); put (y2WC); put (r_mm);
	} else
		my v_roundedRectangle (wdx (x1WC), wdx (x2WC), wdy (y1WC), wdy (y2WC), r_mm * my resolution / 25.4);
}

void Graphics_fillRoundedRectangle (Graphics me, double x1WC, double x2WC, double y1WC, double y2WC, double r_mm) {
	if (my recording) {
		op (FILL_ROUNDED_RECTANGLE, 5); put (x1WC); put (x2WC); put (y1WC); put (y2WC); put (r_mm);
	} else
		my v_fillRoundedRectangle (wdx (x1WC), wdx (x2WC), wdy (y1WC), wdy (y2WC), r_mm * my resolution / 25.4);
}

void Graphics_button (Graphics me, double x1WC, double x2WC, double y1WC, double y2WC) {
	if (my recording) {
		op (BUTTON, 4); put (x1WC); put (x2WC); put (y1WC); put (y2WC);
	} else
		my v_button (wdx (x1WC), wdx (x2WC), wdy (y1WC), wdy (y2WC));
}

void Graphics_innerRectangle (Graphics me, double x1WC, double x2WC, double y1WC, double y2WC) {
	if (my recording) {
		op (INNER_RECTANGLE, 4); put (x1WC); put (x2WC); put (y1WC); put (y2WC);
	} else {
		const double dy = ( my yIsZeroAtTheTop ? -1.0 : 1.0 );
		my v_rectangle (wdx (x1WC) + 1.0, wdx (x2WC) - 1.0, wdy (y1WC) + dy, wdy (y2WC) - dy);
	}
}

void Graphics_circle (Graphics me, double xWC, double yWC, double rWC) {
	if (my recording) {
		op (CIRCLE, 3); put (xWC); put (yWC); put (rWC);
	} else
		my v_circle (wdx (xWC), wdy (yWC), my scaleX * rWC);
}

void Graphics_circle_mm (Graphics me, double xWC, double yWC, double diameter) {
	if (my recording) {
		op (CIRCLE_MM, 3); put (xWC); put (yWC); put (diameter);
	} else
		my v_circle (wdx (xWC), wdy (yWC), 0.5 * diameter * my resolution / 25.4);
}

void Graphics_fillCircle (Graphics me, double xWC, double yWC, double rWC) {
	if (my recording) {
		op (FILL_CIRCLE, 3); put (xWC); put (yWC); put (rWC);
	} else
		my v_fillCircle (wdx (xWC), wdy (yWC), my scaleX * rWC);
}

void Graphics_fillCircle_mm (Graphics me, double xWC, double yWC, double diameter) {
	if (my recording) {
		op (FILL_CIRCLE_MM, 3); put (xWC); put (yWC); put (diameter);
	} else
		my v_fillCircle (wdx (xWC), wdy (yWC), 0.5 * diameter * my resolution / 25.4);
}

void Graphics_speckle (Graphics me, double xWC, double yWC) {
	if (my recording) {
		op (SPECKLE, 2); put (xWC); put (yWC);
	} else
		my v_fillCircle (wdx (xWC), wdy (yWC), 0.5 * my speckleSize * my resolution / 25.4);
}

void Graphics_rectangle_mm (Graphics me, double xWC, double yWC, double horSide, double vertSide) {
	if (my recording) {
		op (RECTANGLE_MM, 4); put (xWC); put (yWC); put (horSide); put (vertSide);
	} else {
		const double xDC = wdx (xWC), yDC = wdy (yWC);
		const double halfHorSide = 0.5 * horSide * my resolution / 25.4;
		const double halfVertSide = 0.5 * vertSide * my resolution / 25.4;
		if (my yIsZeroAtTheTop) {
			my v_rectangle (xDC - halfHorSide, xDC + halfHorSide, yDC + halfVertSide, yDC - halfVertSide);
		} else {
			my v_rectangle (xDC - halfHorSide, xDC + halfHorSide, yDC - halfVertSide, yDC + halfVertSide);
		}
	}
}

void Graphics_fillRectangle_mm (Graphics me, double xWC, double yWC, double horSide, double vertSide) {
	if (my recording) {
		op (FILL_RECTANGLE_MM, 4); put (xWC); put (yWC); put (horSide); put (vertSide);
	} else {
		const double xDC = wdx (xWC), yDC = wdy (yWC);
		const double halfHorSide = 0.5 * horSide * my resolution / 25.4;
		const double halfVertSide = 0.5 * vertSide * my resolution / 25.4;
		if (my yIsZeroAtTheTop) {
			my v_fillRectangle (xDC - halfHorSide, xDC + halfHorSide, yDC + halfVertSide, yDC - halfVertSide);
		} else {
			my v_fillRectangle (xDC - halfHorSide, xDC + halfHorSide, yDC - halfVertSide, yDC + halfVertSide);
		}
	}
}

void Graphics_ellipse (Graphics me, double x1, double x2, double y1, double y2) {
	if (my recording) {
		op (ELLIPSE, 4); put (x1); put (x2); put (y1); put (y2);
	} else
		my v_ellipse (wdx (x1), wdx (x2), wdy (y1), wdy (y2));
}

void Graphics_fillEllipse (Graphics me, double x1, double x2, double y1, double y2) {
	if (my recording) {
		op (FILL_ELLIPSE, 4); put (x1); put (x2); put (y1); put (y2);
	} else
		my v_fillEllipse (wdx (x1), wdx (x2), wdy (y1), wdy (y2));
}

void Graphics_arc (Graphics me, double xWC, double yWC, double rWC, double fromAngle, double toAngle) {
	if (my recording) {
		op (ARC, 5); put (xWC); put (yWC); put (rWC); put (fromAngle); put (toAngle);
	} else
		my v_arc (wdx (xWC), wdy (yWC), my scaleX * rWC, fromAngle, toAngle);
}

void Graphics_fillArc (Graphics me, double xWC, double yWC, double rWC, double fromAngle, double toAngle) {
	if (my recording) {
		op (FILL_ARC, 5); put (xWC); put (yWC); put (rWC); put (fromAngle); put (toAngle);
	} else
		my v_arc (wdx (xWC), wdy (yWC), my scaleX * rWC, fromAngle, toAngle);   // NYI v_fillArc
}

/* Arrows. */

void structGraphics :: v_arrowHead (double xDC, double yDC, double angle) {
	(void) xDC;
	(void) yDC;
	(void) angle;
}

void structGraphicsScreen :: v_arrowHead (double xDC, double yDC, double angle) {
	#if cairo
		if (! our d_cairoGraphicsContext) return;
		double size = 10.0 * our resolution * our arrowSize / 75.0;   // TODO: die 75 zou dat niet de scherm resolutie moeten worden?
		cairo_new_path (our d_cairoGraphicsContext);
		cairo_move_to (our d_cairoGraphicsContext, xDC + cos ((angle + 160.0) * NUMpi / 180.0) * size, yDC - sin ((angle + 160.0) * NUMpi / 180.0) * size);
		cairo_line_to (our d_cairoGraphicsContext, xDC, yDC);
		cairo_line_to (our d_cairoGraphicsContext, xDC + cos ((angle - 160.0) * NUMpi / 180.0) * size, yDC - sin ((angle - 160.0) * NUMpi / 180.0) * size);
		cairo_close_path (our d_cairoGraphicsContext);
		cairo_fill (our d_cairoGraphicsContext);
	#elif gdi
		double size = 10.0 * our resolution * our arrowSize / 72.0;
		MY_BRUSH
		BeginPath (our d_gdiGraphicsContext);
		MoveToEx (our d_gdiGraphicsContext, xDC + cos ((angle + 160.0) * NUMpi / 180.0) * size, yDC - sin ((angle + 160.0) * NUMpi / 180.0) * size, nullptr);
		LineTo (our d_gdiGraphicsContext, xDC, yDC);
		LineTo (our d_gdiGraphicsContext, xDC + cos ((angle - 160.0) * NUMpi / 180.0) * size, yDC - sin ((angle - 160.0) * NUMpi / 180.0) * size);
		EndPath (our d_gdiGraphicsContext);
		FillPath (our d_gdiGraphicsContext);
		DEFAULT
	#elif quartz
		quartzPrepareFill (this);
		//NSCAssert (our d_macGraphicsContext, @"nil context");
		CGContextSaveGState (our d_macGraphicsContext);
		CGContextBeginPath (our d_macGraphicsContext);
		CGContextTranslateCTM (our d_macGraphicsContext, xDC, yDC);
		CGContextRotateCTM (our d_macGraphicsContext, - angle * NUMpi / 180.0);
		CGContextMoveToPoint (our d_macGraphicsContext, 0.0, 0.0);
		double size = 10.0 * our resolution * our arrowSize / 72.0;
		double radius = our resolution * our arrowSize / 30.0;
		CGContextAddArc (our d_macGraphicsContext, - size, 0.0, radius, - NUMpi / 3.0, NUMpi / 3.0, 0);
		CGContextAddLineToPoint (our d_macGraphicsContext, 0.0, 0.0);
		CGContextFillPath (our d_macGraphicsContext);
		CGContextRestoreGState (our d_macGraphicsContext);
	#endif
}

void structGraphicsPostscript :: v_arrowHead (double xDC, double yDC, double angle) {
	double length = resolution * arrowSize / 10.0, radius = resolution * arrowSize / 30.0;
	d_printf (d_file, "gsave %.7g %.7g translate %.7g rotate\n"
		"N 0 0 M %.7g 0 %.7g -60 60 arc closepath fill grestore\n", xDC, yDC, angle, - length, radius);
}

void Graphics_arrow (Graphics me, double x1WC, double y1WC, double x2WC, double y2WC) {
	if (my recording) {
		op (ARROW, 4); put (x1WC); put (y1WC); put (x2WC); put (y2WC);
	} else {
		const double angle = (180.0 / NUMpi) * atan2 ((wdy (y2WC) - wdy (y1WC)) * (my yIsZeroAtTheTop ? -1.0 : 1.0), wdx (x2WC) - wdx (x1WC));
		const double size = my screen ? 10.0 * my resolution * my arrowSize / 72.0 : my resolution * my arrowSize / 10;
		double xyDC [4];
		xyDC [0] = wdx (x1WC);
		xyDC [1] = wdy (y1WC);
		xyDC [2] = wdx (x2WC) + (my screen ? 0.7 : 0.6) * cos ((angle - 180.0) * NUMpi / 180.0) * size;
		xyDC [3] = wdy (y2WC) + (my yIsZeroAtTheTop ? -1.0 : 1.0) * (my screen ? 0.7 : 0.6) * sin ((angle - 180.0) * NUMpi / 180.0) * size;
		my v_polyline (2, xyDC, false);
		my v_arrowHead (wdx (x2WC), wdy (y2WC), angle);
	}
}

void Graphics_doubleArrow (Graphics me, double x1WC, double y1WC, double x2WC, double y2WC) {
	if (my recording) {
		op (DOUBLE_ARROW, 4); put (x1WC); put (y1WC); put (x2WC); put (y2WC);
	} else {
		const double angle = (180.0 / NUMpi) * atan2 ((wdy (y2WC) - wdy (y1WC)) * (my yIsZeroAtTheTop ? -1.0 : 1.0), wdx (x2WC) - wdx (x1WC));
		const double size = my screen ? 10.0 * my resolution * my arrowSize / 72.0 : my resolution * my arrowSize / 10.0;
		double xyDC [4];
		xyDC [0] = wdx (x1WC) + (my screen ? 0.7 : 0.6) * cos (angle * NUMpi / 180.0) * size;
		xyDC [1] = wdy (y1WC) + (my yIsZeroAtTheTop ? -1.0 : 1.0) * (my screen ? 0.7 : 0.6) * sin (angle * NUMpi / 180.0) * size;
		xyDC [2] = wdx (x2WC) + (my screen ? 0.7 : 0.6) * cos ((angle - 180) * NUMpi / 180.0) * size;
		xyDC [3] = wdy (y2WC) + (my yIsZeroAtTheTop ? -1.0 : 1.0) * (my screen ? 0.7 : 0.6) * sin ((angle - 180.0) * NUMpi / 180.0) * size;
		my v_polyline (2, xyDC, false);
		my v_arrowHead (wdx (x1WC), wdy (y1WC), angle + 180.0);
		//my v_polyline (2, xyDC);
		my v_arrowHead (wdx (x2WC), wdy (y2WC), angle);
	}
}

void Graphics_arcArrow (Graphics me, double xWC, double yWC, double rWC,
	double fromAngle, double toAngle, int arrowAtStart, int arrowAtEnd)
{
	if (my recording) {
		op (ARC_ARROW, 7); put (xWC); put (yWC); put (rWC);
		put (fromAngle); put (toAngle); put (arrowAtStart); put (arrowAtEnd);
	} else {
		my v_arc (wdx (xWC), wdy (yWC), my scaleX * rWC, fromAngle, toAngle);
		if (arrowAtStart)
			my v_arrowHead (
				wdx (xWC + rWC * cos (fromAngle * (NUMpi / 180.0))),
				wdy (yWC + rWC * sin (fromAngle * (NUMpi / 180.0))), fromAngle - 90.0
			);
		if (arrowAtEnd)
			my v_arrowHead (
				wdx (xWC + rWC * cos (toAngle * (NUMpi / 180.0))),
				wdy (yWC + rWC * sin (toAngle * (NUMpi / 180.0))), toAngle + 90.0
			);
	}
}

/* Output attributes. */

void Graphics_setLineType (Graphics me, int lineType) {
	my lineType = lineType;
	if (my recording) { op (SET_LINE_TYPE, 1); put (lineType); }
}

void Graphics_setLineWidth (Graphics me, double lineWidth) {
	my lineWidth = lineWidth;
	if (my recording) { op (SET_LINE_WIDTH, 1); put (lineWidth); }
}

void Graphics_setArrowSize (Graphics me, double arrowSize) {
	my arrowSize = arrowSize;
	if (my recording) { op (SET_ARROW_SIZE, 1); put (arrowSize); }
}

void Graphics_setSpeckleSize (Graphics me, double speckleSize) {
	my speckleSize = speckleSize;
	if (my recording) { op (SET_SPECKLE_SIZE, 1); put (speckleSize); }
}

/* Inquiries. */

int Graphics_inqLineType (Graphics me) { return my lineType; }
double Graphics_inqLineWidth (Graphics me) { return my lineWidth; }
double Graphics_inqArrowSize (Graphics me) { return my arrowSize; }
double Graphics_inqSpeckleSize (Graphics me) { return my speckleSize; }

/* End of file Graphics_linesAndAreas.cpp */
