Ein cartesisches Koordinatensystem wird gemäß den in X und Y vorhandenen Maximal- und Minimalwerten automatisch skaliert und Y in diesem System gegen X aufgetragen. Dabei können beliebige Kombinationen von linearen oder logarithmischen Achsen gewählt werden:
| VF_xyAutoPlot: | sowohl X-Achse als auch Y-Achse linear. |
| VF_xyAutoPlot_xlg_ylin: | X-Achse logarithmisch, Y-Achse linear. |
| VF_xyAutoPlot_xlg_ylg: | sowohl X-Achse als auch Y-Achse logarithmisch. |
| VF_xyAutoPlot_xlin_ylg: | X-Achse linear, Y-Achse logarithmisch. |
Bevor VF_xyAutoPlot etc. aufgerufen werden können, müssen die Plot-Routinen mittels V_initPlot initialisiert werden, siehe Kap. 4.11.
Die VecObj-Version dieser Funktion wird als Member-Funktion von Y (nicht von X) aufgerufen.
Als Schriftart der Achsenbeschriftung wird der Font des aktuellen Gerätekontextes benutzt.
Die gewünschte Darstellung der einzelnen Datenpunkte und gegebenenfalls die Art der sie verbindenden Linien werden als Parameter form mittels in <Vgraph.h> (C/C++) bzw. in der unit VGraph (Pascal/Delphi) definierter symbolischer Konstanten angegeben. Für die verschiedenen Linienarten kann wahlweise die Notation Notation der Windows-API oder auch noch diejenige der BGI-Linienarten alter Borland−Compiler verwandt werden. Die für die Übersetzung der einen in die andere Schreibweise nötigen Makros sind in <Vgraph.h> bzw. in der unit VGraph definiert.
1. Linienarten zur Verbindung benachbarter Datenpunkte:
| Windows-Stil | BGI C/C++ | BGI Pascal | Aussehen |
| PS_SOLID | SOLID_LINE | SolidLn | –––– (Standard) |
| PS_DOT | DOTTED_LINE | DottedLn | ········· |
| PS_DASH | DASHED_LINE | DashedLn | - - - - |
| PS_DASHDOT | CENTER_LINE | CenterLn | - · - · - |
| PS_DASHDOTDOT | | | - · · - · · |
| PS_NULL | NULL_LINE | NullLn | (gar keine Linie) |
2. Symbole zur Markierung der einzelnen Datenpunkte:
| SY_NULL | (gar kein Symbol) (Standard) |
| SY_CROSS | ✕ |
| SY_PLUS | + |
| SY_STAR | * |
| SY_CIRCLE | ○ |
| SY_BOX | ࡠ |
| SY_DIAMOND | ◇ |
| SY_TRIANGLEUP | △ |
| SY_TRIANGLEDOWN | ▽ |
3. Füllung der Symbole:
| SY_HOLLOW | ohne Füllung (Standard) |
| SY_FILLED | ganz ausgefüllt |
| SY_DOTTED | hohl mit Punkt an exakter Position |
Der Parameter form wird durch Addition von Linienart, Symbol und Füllung konstruiert, z.B. (SOLID_LINE + SY_TRIANGLEUP). Alternativ kann auch das Bit-weise ODER verwandt werden, z.B. (PS_SOLID | SY_CIRCLE | SY_DOTTED ).
In Pascal/Delphi lauten diese Beispiele:
(SolidLn + SY_TRIANGLEUP) und (PS_SOLID or SY_CIRCLE or SY_DOTTED).
NULL_LINE oder PS_NULL muss immer explizit angegeben werden, wenn keine Verbindung der Datenpunkte gewünscht wird. Beispielsweise würde (SY_BOX | SY_HOLLOW) als Verwendung der Standard-Linienart interpretiert werden, also SOLID_LINE zusätzlich zu dem angegebenen Symbol.
SY_NULL und SY_HOLLOW müssen nicht angegeben werden, da diese die Standards für Symbol-Art und -Füllung darstellen. Bei Wahl von SY_NULL, SY_CROSS, SY_PLUS und SY_STAR hat die Angabe einer Füllung keinen Einfluß.
Der Parameter color gibt die für die Symbole und Linien zu verwendende Farbe an. Der Datentyp COLORREF ist unsigned long / ULong. Die Standard-Farben BLACK, BLUE, GREEN, CYAN, RED, MAGENTA, BROWN, LIGHTGRAY, DARKGRAY, LIGHTBLUE, LIGHTGREEN, LIGHTCYAN, LIGHTRED, LIGHTMAGENTA, YELLOW und WHITE sind in <Vgraph.h> (oder der unit Vgraph) definiert. Häufig werden allerdings die mittels des RGB-Makros definierten Farben vorzuziehen sein.
Die Größe der Symbole kann über V_setSymbolSize modifiziert werden. Die Linienstärke kann über V_setLineThickness gesetzt werden.
Beispiele zur Anwendung dieser Funktion finden sich in den Demo-Programmen VDEMO und FITDEMO. |