#ifndef _Graphics_h_ #define _Graphics_h_ /* Graphics.h * * Copyright (C) 1992-2011 Paul Boersma * * This program 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 program 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 program; if not, write to the Free Software * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ #include "Thing.h" #include "Graphics_enums.h" typedef struct { double red, green, blue; } Graphics_Colour; typedef struct { double x1NDC, x2NDC, y1NDC, y2NDC; } Graphics_Viewport; #if defined (UNIX) typedef void *GuiObject; #else Thing_declare (GuiObject); #endif typedef struct { unsigned char link, rightToLeft; short style, size, baseline; unsigned long code; wchar_t kar; double width; union { long integer; const char *string; } font; int cell, line, run; } _Graphics_widechar; Thing_define (Graphics, Thing) { // new data: public: /* Device constants. */ bool screen; /* A boolean for whether we are a graphic screen (which may include a non-PostScript printer. */ bool postScript; /* A boolean for whether we are a PostScript device. */ bool printer; /* A boolean for whether we are a printer. */ bool metafile; /* A boolean for whether we are a high-resolution metafile or clipboard. */ bool yIsZeroAtTheTop; /* A boolean for whether vertical cooordinates increase from top to bottom (as on most screens, but not PostScript). */ GuiObject d_drawingArea; /* Also used as a boolean. */ int resolution; /* Dots per inch. */ long x1DCmin, x2DCmax, y1DCmin, y2DCmax; /* Maximum dimensions of the output device. */ /* x1DCmin < x2DCmax; y1DCmin < y2DCmax; */ /* The point (x1DCmin, y1DCmin) can be either in the top left */ /* or in the bottom left, depending on the yIsZeroAtTheTop flag. */ /* Device variables. */ long x1DC, x2DC, y1DC, y2DC; /* Current dimensions of the output device, or: */ /* device coordinates of the viewport rectangle. */ /* x1DCmin <= x1DC < x2DC <= x2DCmax; */ /* y1DCmin <= y1DC < y2DC <= y2DCmax; */ /* Graphics_create_xxxxxx sets these coordinates to */ /* x1DCmin, x2DCmax, y1DCmin, and y2DCmax. */ /* They can be changed by Graphics_setWsViewport. */ double x1wNDC, x2wNDC, y1wNDC, y2wNDC; /* Normalized device coordinates of */ /* the device viewport rectangle. */ /* The point (x1wNDC, y1wNDC) is always in the bottom left. */ /* Graphics_create_xxxxxx sets these coordinates to */ /* 0.0, 1.0, 0.0, and 1.0. */ /* They can be changed by Graphics_setWsWindow. */ double x1NDC, x2NDC, y1NDC, y2NDC; /* Normalized device coordinates of the user output viewport, */ /* which is a part of the device viewport rectangle. */ /* x1wNDC <= x1NDC < x2NDC <= x2wNDC; */ /* y1wNDC <= y1NDC < y2NDC <= y2wNDC; */ /* Graphics_create_xxxxxx sets these coordinates to */ /* 0.0, 1.0, 0.0, and 1.0. */ /* They can be changed by Graphics_setViewport. */ double x1WC, x2WC, y1WC, y2WC; /* World coordinates of the user output viewport rectangle. */ /* They bear a relation to the "real" world, */ /* and are used in the drawing routines. */ /* Graphics_create_xxxxxx sets these coordinates to */ /* 0.0, 1.0, 0.0, and 1.0. */ /* They can be changed by Graphics_setWindow. */ double deltaX, deltaY, scaleX, scaleY; /* Current coordinate transformation. */ /* Graphics state. */ int lineType; Graphics_Colour colour; double lineWidth, arrowSize; int horizontalTextAlignment, verticalTextAlignment; double textRotation, wrapWidth, secondIndent, textX, textY; enum kGraphics_font font; int fontSize, fontStyle; int percentSignIsItalic, numberSignIsBold, circumflexIsSuperscript, underscoreIsSubscript; int dollarSignIsCode, atSignIsLink; bool recording, duringXor; long irecord, nrecord; double *record; Graphics_Viewport outerViewport; /* For Graphics_(un)setInner (). */ double horTick, vertTick; /* For Graphics_mark(s)XXX (). */ double paperWidth, paperHeight; // overridden methods: virtual void v_destroy (); // new methods: virtual void v_polyline (long numberOfPoints, long *xyDC, bool close) { (void) numberOfPoints; (void) xyDC; (void) close; } virtual void v_fillArea (long numberOfPoints, long *xyDC) { (void) numberOfPoints; (void) xyDC; } virtual void v_rectangle (long a_x1DC, long a_x2DC, long a_y1DC, long a_y2DC) { (void) a_x1DC; (void) a_x2DC; (void) a_y1DC; (void) a_y2DC; } virtual void v_fillRectangle (long a_x1DC, long a_x2DC, long a_y1DC, long a_y2DC) { (void) a_x1DC; (void) a_x2DC; (void) a_y1DC; (void) a_y2DC; } virtual void v_circle (double xDC, double yDC, double rDC) { (void) xDC; (void) yDC; (void) rDC; } virtual void v_ellipse (long a_x1DC, long a_x2DC, long a_y1DC, long a_y2DC) { (void) a_x1DC; (void) a_x2DC; (void) a_y1DC; (void) a_y2DC; } virtual void v_arc (long xDC, long yDC, long rDC, double fromAngle, double toAngle) { (void) xDC; (void) yDC; (void) rDC; (void) fromAngle; (void) toAngle; } virtual void v_fillCircle (long xDC, long yDC, long rDC) { (void) xDC; (void) yDC; (void) rDC; } virtual void v_fillEllipse (long a_x1DC, long a_x2DC, long a_y1DC, long a_y2DC) { (void) a_x1DC; (void) a_x2DC; (void) a_y1DC; (void) a_y2DC; } virtual void v_button (long a_x1DC, long a_x2DC, long a_y1DC, long a_y2DC) { v_rectangle (a_x1DC, a_x2DC, a_y1DC, a_y2DC); // the simplest implementation } virtual void v_roundedRectangle (long x1DC, long x2DC, long y1DC, long y2DC, long r); virtual void v_fillRoundedRectangle (long x1DC, long x2DC, long y1DC, long y2DC, long r); virtual void v_arrowHead (long xDC, long yDC, double angle); virtual bool v_mouseStillDown () { return false; } virtual void v_getMouseLocation (double *xWC, double *yWC) { *xWC = *yWC = NUMundefined; } virtual void v_flushWs () { } virtual void v_clearWs () { } virtual void v_updateWs () { } }; Graphics Graphics_create (int resolution); Graphics Graphics_create_postscriptjob (MelderFile file, int resolution, enum kGraphicsPostscript_spots spots, enum kGraphicsPostscript_paperSize paperSize, enum kGraphicsPostscript_orientation rotation, double magnification); Graphics Graphics_create_epsfile (MelderFile file, int resolution, enum kGraphicsPostscript_spots spots, double xmin, double xmax, double ymin, double ymax, bool includeFonts, bool useSilipaPS); Graphics Graphics_create_pdffile (MelderFile file, int resolution, double x1inches, double x2inches, double y1inches, double y2inches); Graphics Graphics_create_pdf (void *context, int resolution, double x1inches, double x2inches, double y1inches, double y2inches); Graphics Graphics_create_postscriptprinter (void); Graphics Graphics_create_screenPrinter (void *display, void *window); Graphics Graphics_create_screen (void *display, void *window, int resolution); #ifdef macintosh Graphics Graphics_create_port (void *display, void *port, int resolution); #endif Graphics Graphics_create_xmdrawingarea (/* GuiObject */ void *drawingArea); int Graphics_getResolution (Graphics me); void Graphics_setWsViewport (Graphics me, long x1DC, long x2DC, long y1DC, long y2DC); void Graphics_resetWsViewport (Graphics me, long x1DC, long x2DC, long y1DC, long y2DC); void Graphics_setWsWindow (Graphics me, double x1NDC, double x2NDC, double y1NDC, double y2NDC); void Graphics_inqWsViewport (Graphics me, long *x1DC, long *x2DC, long *y1DC, long *y2DC); void Graphics_inqWsWindow (Graphics me, double *x1NDC, double *x2NDC, double *y1NDC, double *y2NDC); void Graphics_clearWs (Graphics me); void Graphics_flushWs (Graphics me); void Graphics_updateWs (Graphics me); void Graphics_DCtoWC (Graphics me, long xDC, long yDC, double *xWC, double *yWC); void Graphics_WCtoDC (Graphics me, double xWC, double yWC, long *xDC, long *yDC); void Graphics_setViewport (Graphics me, double x1NDC, double x2NDC, double y1NDC, double y2NDC); Graphics_Viewport Graphics_insetViewport (Graphics me, double x1rel, double x2rel, double y1rel, double y2rel); void Graphics_resetViewport (Graphics me, Graphics_Viewport viewport); void Graphics_setWindow (Graphics me, double x1, double x2, double y1, double y2); void Graphics_polyline (Graphics me, long numberOfPoints, double *x, double *y); void Graphics_polyline_closed (Graphics me, long numberOfPoints, double *x, double *y); void Graphics_text (Graphics me, double x, double y, const wchar_t *text); void Graphics_text1 (Graphics me, double x, double y, const wchar_t *s1); void Graphics_text2 (Graphics me, double x, double y, const wchar_t *s1, const wchar_t *s2); void Graphics_text3 (Graphics me, double x, double y, const wchar_t *s1, const wchar_t *s2, const wchar_t *s3); void Graphics_text4 (Graphics me, double x, double y, const wchar_t *s1, const wchar_t *s2, const wchar_t *s3, const wchar_t *s4); void Graphics_text5 (Graphics me, double x, double y, const wchar_t *s1, const wchar_t *s2, const wchar_t *s3, const wchar_t *s4, const wchar_t *s5); void Graphics_text6 (Graphics me, double x, double y, const wchar_t *s1, const wchar_t *s2, const wchar_t *s3, const wchar_t *s4, const wchar_t *s5, const wchar_t *s6); void Graphics_text7 (Graphics me, double x, double y, const wchar_t *s1, const wchar_t *s2, const wchar_t *s3, const wchar_t *s4, const wchar_t *s5, const wchar_t *s6, const wchar_t *s7); void Graphics_text8 (Graphics me, double x, double y, const wchar_t *s1, const wchar_t *s2, const wchar_t *s3, const wchar_t *s4, const wchar_t *s5, const wchar_t *s6, const wchar_t *s7, const wchar_t *s8); void Graphics_text9 (Graphics me, double x, double y, const wchar_t *s1, const wchar_t *s2, const wchar_t *s3, const wchar_t *s4, const wchar_t *s5, const wchar_t *s6, const wchar_t *s7, const wchar_t *s8, const wchar_t *s9); void Graphics_textRect (Graphics me, double x1, double x2, double y1, double y2, const wchar_t *text); double Graphics_textWidth (Graphics me, const wchar_t *text); double Graphics_textWidth_ps (Graphics me, const wchar_t *text, bool useSilipaPS); double Graphics_textWidth_ps_mm (Graphics me, const wchar_t *text, bool useSilipaPS); void Graphics_fillArea (Graphics me, long numberOfPoints, double *x, double *y); void Graphics_cellArray (Graphics me, double **z, long ix1, long ix2, double x1, double x2, long iy1, long iy2, double y1, double y2, double minimum, double maximum); void Graphics_cellArray8 (Graphics me, unsigned char **z, long ix1, long ix2, double x1, double x2, long iy1, long iy2, double y1, double y2, unsigned char minimum, unsigned char maximum); void Graphics_image (Graphics me, double **z, long ix1, long ix2, double x1, double x2, long iy1, long iy2, double y1, double y2, double minimum, double maximum); void Graphics_image8 (Graphics me, unsigned char **z, long ix1, long ix2, double x1, double x2, long iy1, long iy2, double y1, double y2, unsigned char minimum, unsigned char maximum); void Graphics_imageFromFile (Graphics me, const wchar_t *relativeFileName, double x1, double x2, double y1, double y2); void Graphics_line (Graphics me, double x1, double y1, double x2, double y2); void Graphics_rectangle (Graphics me, double x1, double x2, double y1, double y2); void Graphics_fillRectangle (Graphics me, double x1, double x2, double y1, double y2); void Graphics_roundedRectangle (Graphics me, double x1, double x2, double y1, double y2, double r_mm); void Graphics_fillRoundedRectangle (Graphics me, double x1, double x2, double y1, double y2, double r_mm); void Graphics_function (Graphics me, double y [], long ix1, long ix2, double x1, double x2); /* y [ix1..ix2] */ void Graphics_function16 (Graphics me, int16_t y [], int stagger, long ix1, long ix2, double x1, double x2); /* y [ix1..ix2] or y [ix1*2..ix2*2] */ void Graphics_circle (Graphics me, double x, double y, double r); void Graphics_fillCircle (Graphics me, double x, double y, double r); void Graphics_circle_mm (Graphics me, double x, double y, double d); void Graphics_fillCircle_mm (Graphics me, double x, double y, double d); void Graphics_rectangle_mm (Graphics me, double x, double y, double horizontalSide_mm, double verticalSide_mm); void Graphics_fillRectangle_mm (Graphics me, double x, double y, double horizontalSide_mm, double verticalSide_mm); void Graphics_arc (Graphics me, double x, double y, double r, double fromAngle, double toAngle); void Graphics_fillArc (Graphics me, double x, double y, double r, double fromAngle, double toAngle); void Graphics_ellipse (Graphics me, double x1, double x2, double y1, double y2); void Graphics_fillEllipse (Graphics me, double x1, double x2, double y1, double y2); void Graphics_arrow (Graphics me, double x1, double y1, double x2, double y2); void Graphics_doubleArrow (Graphics me, double x1, double y1, double x2, double y2); void Graphics_arcArrow (Graphics me, double x, double y, double r, double fromAngle, double toAngle, int arrowAtStart, int arrowAtEnd); void Graphics_mark (Graphics me, double x, double y, double size_mm, const wchar_t *markString); void Graphics_button (Graphics me, double x1, double x2, double y1, double y2); void Graphics_innerRectangle (Graphics me, double x1, double x2, double y1, double y2); extern Graphics_Colour Graphics_BLACK, Graphics_WHITE, Graphics_RED, Graphics_GREEN, Graphics_BLUE, Graphics_CYAN, Graphics_MAGENTA, Graphics_YELLOW, Graphics_MAROON, Graphics_LIME, Graphics_NAVY, Graphics_TEAL, Graphics_PURPLE, Graphics_OLIVE, Graphics_PINK, Graphics_SILVER, Graphics_GREY; const wchar_t * Graphics_Colour_name (Graphics_Colour colour); static inline bool Graphics_Colour_equal (Graphics_Colour colour1, Graphics_Colour colour2) { return colour1. red == colour2. red && colour1. green == colour2. green && colour1. blue == colour2. blue; } void Graphics_setColour (Graphics me, Graphics_Colour colour); void Graphics_setGrey (Graphics me, double grey); void Graphics_xorOn (Graphics me, Graphics_Colour colour); void Graphics_xorOff (Graphics me); void Graphics_highlight (Graphics me, double x1, double x2, double y1, double y2); void Graphics_unhighlight (Graphics me, double x1, double x2, double y1, double y2); void Graphics_highlight2 (Graphics me, double x1, double x2, double y1, double y2, double innerX1, double innerX2, double innerY1, double innerY2); void Graphics_unhighlight2 (Graphics me, double x1, double x2, double y1, double y2, double innerX1, double innerX2, double innerY1, double innerY2); #define Graphics_NOCHANGE -1 #define Graphics_LEFT kGraphics_horizontalAlignment_LEFT #define Graphics_CENTRE kGraphics_horizontalAlignment_CENTRE #define Graphics_RIGHT kGraphics_horizontalAlignment_RIGHT #define Graphics_BOTTOM 0 #define Graphics_HALF 1 #define Graphics_TOP 2 #define Graphics_BASELINE 3 void Graphics_setTextAlignment (Graphics me, int horizontal, int vertical); void Graphics_setFont (Graphics me, enum kGraphics_font font); void Graphics_setFontSize (Graphics me, int height); void Graphics_setFontStyle (Graphics me, int style); void Graphics_setItalic (Graphics me, bool onoff); void Graphics_setBold (Graphics me, bool onoff); void Graphics_setCode (Graphics me, bool onoff); #define Graphics_NORMAL 0 #define Graphics_BOLD 1 #define Graphics_ITALIC 2 #define Graphics_BOLD_ITALIC 3 #define Graphics_CODE 4 void Graphics_setTextRotation (Graphics me, double angle); void Graphics_setTextRotation_vector (Graphics me, double dx, double dy); void Graphics_setWrapWidth (Graphics me, double wrapWidth); void Graphics_setSecondIndent (Graphics me, double indent); double Graphics_inqTextX (Graphics me); double Graphics_inqTextY (Graphics me); typedef struct { double x1, x2, y1, y2; wchar_t *name; } Graphics_Link; int Graphics_getLinks (Graphics_Link **plinks); void Graphics_setNumberSignIsBold (Graphics me, bool isBold); void Graphics_setPercentSignIsItalic (Graphics me, bool isItalic); void Graphics_setCircumflexIsSuperscript (Graphics me, bool isSuperscript); void Graphics_setUnderscoreIsSubscript (Graphics me, bool isSubscript); void Graphics_setDollarSignIsCode (Graphics me, bool isCode); void Graphics_setAtSignIsLink (Graphics me, bool isLink); void Graphics_setLineType (Graphics me, int lineType); #define Graphics_DRAWN 0 #define Graphics_DOTTED 1 #define Graphics_DASHED 2 #define Graphics_DASHED_DOTTED 3 void Graphics_setLineWidth (Graphics me, double lineWidth); void Graphics_setArrowSize (Graphics me, double arrorSize); void Graphics_inqViewport (Graphics me, double *x1NDC, double *x2NDC, double *y1NDC, double *y2NDC); void Graphics_inqWindow (Graphics me, double *x1WC, double *x2WC, double *y1WC, double *y2WC); enum kGraphics_font Graphics_inqFont (Graphics me); int Graphics_inqFontSize (Graphics me); int Graphics_inqFontStyle (Graphics me); int Graphics_inqLineType (Graphics me); double Graphics_inqLineWidth (Graphics me); double Graphics_inqArrowSize (Graphics me); Graphics_Colour Graphics_inqColour (Graphics me); void Graphics_contour (Graphics me, double **z, long ix1, long ix2, double x1WC, double x2WC, long iy1, long iy2, double y1WC, double y2WC, double height); void Graphics_altitude (Graphics me, double **z, long ix1, long ix2, double x1, double x2, long iy1, long iy2, double y1, double y2, int numberOfBorders, double borders []); void Graphics_grey (Graphics me, double **z, long ix1, long ix2, double x1, double x2, long iy1, long iy2, double y1, double y2, int numberOfBorders, double borders []); #define Graphics_gray Graphics_grey void Graphics_surface (Graphics me, double **z, long ix1, long ix2, double x1, double x2, long iy1, long iy2, double y1, double y2, double minimum, double maximum, double elevation, double azimuth); void Graphics_setInner (Graphics me); void Graphics_unsetInner (Graphics me); void Graphics_drawInnerBox (Graphics me); void Graphics_textLeft (Graphics me, bool far, const wchar_t *text); void Graphics_textRight (Graphics me, bool far, const wchar_t *text); void Graphics_textBottom (Graphics me, bool far, const wchar_t *text); void Graphics_textTop (Graphics me, bool far, const wchar_t *text); void Graphics_marksLeft (Graphics me, int numberOfMarks, bool haveNumbers, bool haveTicks, bool haveDottedLines); void Graphics_marksRight (Graphics me, int numberOfMarks, bool haveNumbers, bool haveTicks, bool haveDottedLines); void Graphics_marksBottom (Graphics me, int numberOfMarks, bool haveNumbers, bool haveTicks, bool haveDottedLines); void Graphics_marksTop (Graphics me, int numberOfMarks, bool haveNumbers, bool haveTicks, bool haveDottedLines); void Graphics_marksLeftLogarithmic (Graphics me, int numberOfMarksPerDecade, bool haveNumbers, bool haveTicks, bool haveDottedLines); void Graphics_marksRightLogarithmic (Graphics me, int numberOfMarksPerDecade, bool haveNumbers, bool haveTicks, bool haveDottedLines); void Graphics_marksBottomLogarithmic (Graphics me, int numberOfMarksPerDecade, bool haveNumbers, bool haveTicks, bool haveDottedLines); void Graphics_marksTopLogarithmic (Graphics me, int numberOfMarksPerDecade, bool haveNumbers, bool haveTicks, bool haveDottedLines); void Graphics_markLeft (Graphics me, double yWC, bool hasNumber, bool hasTick, bool hasDottedLine, const wchar_t *text); void Graphics_markRight (Graphics me, double yWC, bool hasNumber, bool hasTick, bool hasDottedLine, const wchar_t *text); void Graphics_markBottom (Graphics me, double xWC, bool hasNumber, bool hasTick, bool hasDottedLine, const wchar_t *text); void Graphics_markTop (Graphics me, double xWC, bool hasNumber, bool hasTick, bool hasDottedLine, const wchar_t *text); void Graphics_markLeftLogarithmic (Graphics me, double y /* > 0 */, bool hasNumber, bool hasTick, bool hasDottedLine, const wchar_t *text); void Graphics_markRightLogarithmic (Graphics me, double y, bool hasNumber, bool hasTick, bool hasDottedLine, const wchar_t *text); void Graphics_markBottomLogarithmic (Graphics me, double x, bool hasNumber, bool hasTick, bool hasDottedLine, const wchar_t *text); void Graphics_markTopLogarithmic (Graphics me, double x, bool hasNumber, bool hasTick, bool hasDottedLine, const wchar_t *text); void Graphics_marksLeftEvery (Graphics me, double units, double distance, bool haveNumbers, bool haveTicks, bool haveDottedLines); void Graphics_marksRightEvery (Graphics me, double units, double distance, bool haveNumbers, bool haveTicks, bool haveDottedLines); void Graphics_marksBottomEvery (Graphics me, double units, double distance, bool haveNumbers, bool haveTicks, bool haveDottedLines); void Graphics_marksTopEvery (Graphics me, double units, double distance, bool haveNumbers, bool haveTicks, bool haveDottedLines); void *Graphics_x_getCR (Graphics me); void Graphics_x_setCR (Graphics me, void *cr); void *Graphics_x_getGC (Graphics me); bool Graphics_startRecording (Graphics me); bool Graphics_stopRecording (Graphics me); void Graphics_clearRecording (Graphics me); void Graphics_play (Graphics from, Graphics to); void Graphics_writeRecordings (Graphics me, FILE *f); void Graphics_readRecordings (Graphics me, FILE *f); #ifdef _WIN32 void Graphics_readRecordings_oldWindows (Graphics me, FILE *f); #endif void Graphics_markGroup (Graphics me); void Graphics_undoGroup (Graphics me); double Graphics_dxMMtoWC (Graphics me, double dx_mm); double Graphics_dyMMtoWC (Graphics me, double dy_mm); double Graphics_distanceWCtoMM (Graphics me, double x1WC, double y1WC, double x2WC, double y2WC); double Graphics_dxWCtoMM (Graphics me, double dxWC); double Graphics_dyWCtoMM (Graphics me, double dyWC); bool Graphics_mouseStillDown (Graphics me); void Graphics_waitMouseUp (Graphics me); void Graphics_getMouseLocation (Graphics me, double *xWC, double *yWC); void Graphics_nextSheetOfPaper (Graphics me); /* End of file Graphics.h */ #endif