.. highlightlang:: us .. index:: XYZSetProps .. _xyzsetprops: XYZSetProps =========== .. us.tag XYZSetProps NOTREADYGERMAN XYZSet New403 Changed412 Changed5300 :ref:`XYZSetProps` setzt Eigenschaften eines x/y/z-Datensatzes. .. function:: bool = XYZSetProps(hData, ssProps) .. us.return **Returnwert** *bool* ist TRUE (1) wenn alle Eigenschaften erfolgreich gesetzt werden konnte, und sonst FALSE (0). .. us.params **Parameter** .. uparam:: hData *hData* ist die Zugriffsnummer (Handle) des Datensatzes, der mit :ref:`XYZCreate` erzeugt wurde. .. uparam:: ssProps *ssProps* ist ein String mit ``NAME='WERT'``-Paaren mit den Eigenschaften. .. us.example **Beispiel** Der folgende Beispielaufruf schaltet den Bubble-Plot ein und die Isolinien-Anzeige aus. Die anderen Eigenschaften des Datensatzes werden nicht geändert. :: XYZSetProps(hData, "bubble='1' isolines='0'") Isolinien berechnen und beschriften:: XYZSetProps(hData, "iso-values='auto' iso-label-type='auto'") Weiteres Beispiel:: XYZSetProps(hData, "hull-label-distance='0.2' " + ... "marker='1' marker-label='0' " + ... "iso-pen-color='silver' iso-values = 'auto:15' " + ... "iso-label-type ='random'"); Isolinienfarben setzen:: rmColor = [255,0,0; 255,127,0; 0,255,0; 0,0,255]; // the last color (blue) will be used for all remaining iso lines // (5., 6., etc.). ssColor = sty_RGB_to_prop_color(rmColor); ssProp = sprintf("iso-pen-color = '%s'", ssColor); XYZSetProps(hData, ssProp); .. us.comment **Kommentar** In der folgenden Tabelle sind alle Eigenschaften (Properties), die gesetzt werden können, aufgeführt. In der Spalte Typ wird der Wertebereich der Eigenschaften festgelegt. Folgende Typen existieren: bool, int, double, color, curve_style, marker_style. bool kann die Werte '0' oder '1' annehmen. '0' bedeutet ausgeschaltet (off, false) und '1' eingeschaltet (on, true). int ist eine ganze Zahl ('1', '-1', '144'). double ist eine Gleitkommazahl wie '1.23', '5000', '1e3'. color ist ein Name wie 'mediumblue' (siehe Farbtabelle unten), ein Zahlenwert wie '#0000CD' oder ein Ausdruck der Form 'rgb(0,0,205)'. Eigenschaften alphabetisch: .. list-table:: :header-rows: 1 * - Eigenschaft - Typ - Default-Wert - Kommentar * - base-value-3d - double - ``'0.0'`` - * - bubble - bool - ``'0'`` - * - bubble-color-type - int - ``'1'`` - * - bubble-size-max - double - ``'1.0'`` - Maximale Bubble-Größe in Zentimeter * - bubble-size-min - double - ``'0.2'`` - Minimale Bubble-Größe in Zentimeter * - bubble-scale-max - double - ``'2.0'`` - Falls ``bubble-use-scaleval`` auf 1 gesetzt ist, wird dieser Wert benutzt um den Maximal-Wert statt des Daten-Maximums zu setzen. * - bubble-scale-min - double - ``'1.0'`` - Falls ``bubble-use-scaleval`` auf 1 gesetzt ist, wird dieser Wert benutzt um den Minimal-Wert statt des Daten-Minimums zu setzen. * - bubble-size-type - int - ``'1'`` - 1: Durchmesser, 2: Fläche * - bubble-no-edge - int - ``'0'`` - Falls dieser Wert auf 1 gesetzt ist, wird eine Kante angezeigt. * - bubble-use-scaleval - int - ``'0'`` - Falls dieser Wert auf 1 gesetzt ist, wird der Min/Max-Wert zum Berechnen der Bubble-Größe benutzt. * - color-matrix - bool - ``'0'`` - * - color-matrix-line-color - color - black - * - color-matrix-line-width - int - ``'2'`` - * - color-matrix-showzval - bool - ``'1'`` - * - color-matrix-cliptext - bool - ``'1'`` - * - color-matrix-shrinktext - bool - ``'1'`` - * - color-matrix-showedge - bool - ``'1'`` - * - color-matrix-clipzmin - bool - ``'0'`` - * - filled - bool - ``'0'`` - * - hull-label - bool - ``'1'`` - * - hull-label-distance - double - ``'0.3'`` - in Zentimeter * - hull-label-horizontal - bool - ``'1'`` - * - hull-pen-color - color - ``'black'`` - * - hull-pen-style - curve_style - ``'solid'`` - possible values: '0' or 'solid' , '1' or 'dash', '2' or'dot', '3' or 'dashdot', '4' or 'dashdotdot'. * - hull-pen-width - int - ``'4'`` - * - hull-spline - bool - ``'0'`` - * - hull-type - int - ``'1'`` - * - inside-3d-pen-color - color - ``'black'`` - * - inside-3d-pen-style - curve_style - ``'solid'`` - possible values: '0' or 'solid' , '1' or 'dash', '2' or'dot', '3' or 'dashdot', '4' or 'dashdotdot'. * - inside-3d-pen-width - int - ``'2'`` - * - inside-color-3d - color - ``'white'`` - * - interpolation-density - string - ``'40,40'`` - * - interpolation-on-grid - bool - ``'0'`` - * - interpolation-range - string - ``'auto'`` - * - interpolation-smooth-factor - int - ``'0'`` - * - interpolation-type - int - ``'3'`` - '1' (linear Interpolation), '2' (Non linear Interpolation), '3' (Thin-Plate-Spline Interpolation) * - iso-colors - string - ``'auto'`` - * - iso-colors-alpha - string - ``'255'`` - * - iso-colormap - string - ``'viridis'`` - * - iso-colormap-enable - bool - ``'0'`` - * - iso-label-type - string - ``'auto'`` - * - iso-min-color - string - ``'auto'`` - * - iso-min-color-alpha - int - ``'255'`` - * - iso-pen-color - string - ``'black'`` - * - iso-pen-styles - string - ``'solid'`` - possible values: '0' or 'solid' , '1' or 'dash', '2' or'dot', '3' or 'dashdot', '4' or 'dashdotdot'. * - iso-pen-width - string - ``'1'`` - * - iso-values - string - ``'auto'`` - * - isolines - bool - ``'1'`` - * - isolines-3d - bool - ``'0'`` - * - label-font-angle - double - ``'0.0'`` - * - label-font-color - color - ``'black'`` - * - label-font-face-name - string - ``''`` - * - label-font-height - int - ``'-9'`` - * - label-font-italic - bool - ``'0'`` - * - label-font-pitch-and-family - int - ``'0'`` - * - label-font-strikeout - bool - ``'0'`` - * - label-font-underline - bool - ``'0'`` - * - label-font-weight - int - ``'400'`` - * - label-format - string - ``'auto'`` - * - label-in-a-box - bool - ``'0'`` - * - label-in-line-color - int - ``'0'`` - * - label-transparent - bool - ``'0'`` - * - label-orientation - int - ``'0'`` - * - marker - bool - ``'0'`` - * - marker-edge-color - color - ``'black'`` - * - marker-edge-width - int - ``'1'`` - * - marker-fill-color - color - ``'red'`` - * - marker-fill-alpha - int - ``'255'`` - ``'0'``: transparent, ``'255'``: opaque, Exception: The value ``'1'`` sets alpha to opaque to be compatible with older versions. * - marker-label - bool - ``'0'`` - * - marker-label-font-angle - double - ``'0.0'`` - * - marker-label-font-color - color - ``'black'`` - * - marker-label-font-face-name - string - ``''`` - * - marker-label-font-height - int - ``'12'`` - * - marker-label-font-italic - int - ``'0'`` - * - marker-label-font-pitch-and-family - int - ``'0'`` - * - marker-label-font-strikeout - int - ``'0'`` - * - marker-label-font-underline - int - ``'0'`` - * - marker-label-font-weight - int - ``'400'`` - * - marker-line-index - bool - ``'0'`` - * - marker-size - double - ``'0.25'`` - * - marker-style - marker_style - ``'3'`` - * - max-marker - bool - ``'0'`` - * - max-marker-edge-color - color - ``'black'`` - * - max-marker-edge-width - int - ``'1'`` - * - max-marker-fill-color - color - ``'red'`` - * - max-marker-fill-alpha - int - ``'255'`` - ``'0'``: transparent, ``'255'``: opaque, Exception: The value ``'1'`` sets alpha to opaque to be compatible with older versions. * - max-marker-size - double - ``'0.25'`` - * - max-marker-style - marker_style - ``'1'`` - Siehe :ref:`XYSetProps` * - min-marker - bool - ``'0'`` - * - min-marker-edge-color - color - ``'black'`` - * - min-marker-edge-width - int - ``'1'`` - * - min-marker-fill-color - color - ``'red'`` - * - min-marker-fill-alpha - int - ``'255'`` - ``'0'``: transparent, ``'255'``: opaque, Exception: The value ``'1'`` sets alpha to opaque to be compatible with older versions. * - min-marker-size - double - ``'0.25'`` - * - min-marker-style - marker_style - ``'0'`` - Siehe :ref:`XYSetProps` * - name - string - ``''`` - * - outside-3d-pen-color - color - ``'black'`` - * - outside-3d-pen-style - curve_style - ``'solid'`` - possible values: '0' or 'solid' , '1' or 'dash', '2' or'dot', '3' or 'dashdot', '4' or 'dashdotdot'. * - outside-3d-pen-width - int - ``'2'`` - * - outside-color - color - ``'#7F7F7F'`` - * - outside-hull-3d-type - int - ``'2'`` - * - scatter-bar-width - double - ``'3.0'`` - * - scatter-label-offset-x - double - ``'0.0'`` - * - scatter-label-offset-y - double - ``'0.0'`` - * - spline - bool - ``'0'`` - * - surface-attributes - int - ``'0'`` - * - surface-type - int - ``'1'`` - * - triangulation - bool - ``'0'`` - **Eigenschaften in Kategorien:** **Isolinien** .. list-table:: :header-rows: 1 * - Eigenschaft - Typ - Default-Wert * - isolines - bool - ``'1'`` * - spline - bool - ``'0'`` * - iso-values - string - ``'auto'`` or ``'auto:10'`` or ``'auto:linear,10'`` * - filled - bool - ``'0'`` * - iso-min-color - string - ``'auto'`` * - iso-colors - string - ``'auto'`` * - iso-colors-alpha - string - ``'255'`` * - iso-pen-color - string - ``'black'`` * - iso-pen-styles - string - ``'solid'`` * - iso-pen-width - string - ``'1'`` Anmerkungen: **iso-values** legt fest, welche Isolinien gezeichnet werden. iso-values ist entweder der String "auto", oder ein String mit komma-separierten Zahlen ("22.3,25,100,200,500.12"). Dem String "auto" kann noch ein Doppelpunkt mit einer Zahl im Bereich von 1 bis 100 folgen, um die Anzahl an automatisch ermittelten Isolinien festzulegen, z. B. "auto:6". Der Text "auto:linear,XX" führt eine lineare Skalierung druch. ``XX`` steht für die Anzahl der gewünschten Isolinienwerte, z. B. "auto:linear,10" **iso-min-color** wird verwendet, wenn "filled='1'" ist. **iso-colors** ist eine einzelne Farbe oder eine komma-separierte Liste von Farben. Falls iso-values='auto' ist, wird iso-min-color und die letzte Farbe von iso-colors verwendet um einen Farbverlauf zu bestimmen. Falls iso-values eine Liste von Werten ist, muss iso-colors die gleiche Anzahl an Farben wie iso-values Werte haben, ansonsten wird wie bei iso-values='auto' ein Farbverlauf aus der letzten Farbe von iso-colors und iso-min-color berechnet. **iso-pen-color**, **iso-pen-styles**, **iso-pen-width** sind komma-separierte Listen. Falls die Anzahl nicht mit der Anzahl an Werten in iso-values übereinstimmt, wird die Liste mit dem letzten Wert der Liste aufgefüllt. **Isolinien-Beschriftungen** .. list-table:: :header-rows: 1 * - Eigenschaft - Typ - Default-Wert * - iso-label-type - string - ``'auto'`` * - label-format - string - ``'auto'`` * - label-in-a-box - bool - ``'0'`` * - label-in-line-color - int - ``'0'`` * - label-transparent - bool - ``'0'`` * - label-orientation - int - ``'0'`` * - label-font-angle - double - ``'0.0'`` * - label-font-color - color - ``'black'`` * - label-font-face-name - string - ``''`` * - label-font-height - int - ``'-9'`` * - label-font-italic - bool - ``'0'`` * - label-font-pitch-and-family - int - ``'0'`` * - label-font-strikeout - bool - ``'0'`` * - label-font-underline - bool - ``'0'`` * - label-font-weight - int - ``'400'`` Anmerkungen: **iso-label-type** ist einer der folgenden Werte .. list-table:: :header-rows: 0 * - 'none' oder '0' - bewirkt, das keine Label an die Isolinie gezeichnet werden. * - 'user' oder '1' - bewirkt, das die Label nicht geändert werden. * - 'stripes' oder '2' - zieht zwei gedachte, vertikale Geraden und beschriftet die Isolinien an den gedachten Schnittpunkten der Geraden mit den Isolinien, * - 'middle' oder '3' - bewirkt, dass eine Beschriftung für jede Isoline in der Mitte ausgegeben wird. * - 'random' oder '4' - erzeugt ein Label an einer zufälligen Stelle. * - 'auto' - ist dasselbe wie 'random'. **label-format** 'auto' oder eine Zahl (siehe :ref:`XYZSetLabelFormat`). **label-transparent** Die Isolinienbeschriftungen werden transparent ausgegeben, wenn der Wert auf '1' gesetzt wird. Ansonsten wird die Beschriftung mit einem weißen Rechteck unterlegt. **Bubble-Plots** .. list-table:: :header-rows: 1 * - Eigenschaft - Typ - Default-Wert * - bubble - bool - ``'0'`` * - bubble-color-type - int - ``'1'`` * - bubble-size-max - double - ``'1.0'`` * - bubble-size-min - double - ``'0.2'`` * - bubble-size-type - int - ``'1'`` Anmerkungen: **bubble-color-type** '1' einfarbig, '2' farbgradient. **bubble-size-type** '1' z-Wert proportional zur Fläche des Markers, '2' z-Wert proportional zum Durchmesser des Markers. **Hülle** .. list-table:: :header-rows: 1 * - Eigenschaft - Typ - Default-Wert * - hull-label - bool - ``'1'`` * - hull-label-distance - double - ``'0.3'`` * - hull-label-horizontal - bool - ``'1'`` * - hull-pen-color - color - ``'black'`` * - hull-pen-style - curve_style - ``'solid'`` * - hull-pen-width - int - ``'4'`` * - hull-spline - bool - ``'0'`` * - hull-type - int - ``'1'`` Anmerkungen: **hull-type** legt den Hüllentyp fest. .. list-table:: :header-rows: 0 * - '0' - keine Hülle (HULL_NONE) * - '1' - nördlicher Teil (HULL_NORTH) * - '2' - nördlicher Teil (Splineverbindung) (HULL_NORTH_SPLINE) * - '3' - Gesamthülle (HULL_ENTIRE) * - '4' - Gesamthülle - nördlicher Teil mit Splineverbindung (HULL_ENTIRE_SPLINE) * - '5' - benutzer-definierte Hülle (HULL_USERDEF) **3D-Oberflächen-Plots** .. list-table:: :header-rows: 1 * - Eigenschaft - Typ - Default-Wert * - base-value-3d - double - ``'0.0'`` * - inside-3d-pen-color - color - ``'black'`` * - inside-3d-pen-style - curve_style - ``'solid'`` * - inside-3d-pen-width - int - ``'2'`` * - inside-color-3d - color - ``'white'`` * - outside-3d-pen-color - color - ``'black'`` * - outside-3d-pen-style - curve_style - ``'solid'`` * - outside-3d-pen-width - int - ``'2'`` * - outside-color - color - ``'#7F7F7F'`` * - outside-hull-3d-type - int - ``'2'`` * - surface-attributes - int - ``'0'`` * - surface-type - int - ``'1'`` * - isolines-3d - bool - ``'0'`` Anmerkungen: **surface-type** legt die Darstellung der Oberfläche fest (siehe :ref:`XYZSet3DSurfaceType`). Wertebereich ist '0' bis '7'. **Interpolation** .. list-table:: :header-rows: 1 * - Eigenschaft - Typ - Default-Wert * - interpolation-density - string - ``'40,40'`` * - interpolation-on-grid - bool - ``'0'`` * - interpolation-range - string - ``'auto'`` * - interpolation-smooth-factor - int - ``'0'`` * - interpolation-type - int - ``'3'`` Anmerkungen: Bedeutung der Werte **interpolation-type**: .. list-table:: :header-rows: 1 * - Wert - Bedeutung * - 1 - linear Interpolation * - 2 - Nicht lineare Interpolation * - 3 - Thin-Plate-Spline Interpolation **Streuplots** .. list-table:: :header-rows: 1 * - Eigenschaft - Typ - Default-Wert * - marker - bool - ``'0'`` * - marker-edge-color - color - ``'black'`` * - marker-edge-width - int - ``'1'`` * - marker-fill-color - color - ``'red'`` * - marker-fill-alpha - int - ``'255'`` * - marker-label - bool - ``'0'`` * - marker-label-font-angle - double - ``'0.0'`` * - marker-label-font-color - color - ``'black'`` * - marker-label-font-face-name - string - ``''`` * - marker-label-font-height - int - ``'12'`` * - marker-label-font-italic - int - ``'0'`` * - marker-label-font-pitch-and-family - int - ``'0'`` * - marker-label-font-strikeout - int - ``'0'`` * - marker-label-font-underline - int - ``'0'`` * - marker-label-font-weight - int - ``'400'`` * - marker-line-index - bool - ``'0'`` * - marker-size - double - ``'0.25'`` * - marker-style - marker_style - ``'3'`` * - max-marker - bool - ``'0'`` * - max-marker-edge-color - color - ``'black'`` * - max-marker-edge-width - int - ``'1'`` * - max-marker-fill-color - color - ``'red'`` * - max-marker-fill-alpha - int - ``'255'`` * - max-marker-size - double - ``'0.25'`` * - max-marker-style - marker_style - ``'1'`` * - min-marker - bool - ``'0'`` * - min-marker-edge-color - color - ``'black'`` * - min-marker-edge-width - int - ``'1'`` * - min-marker-fill-color - color - ``'red'`` * - min-marker-fill-alpha - int - ``'255'`` * - min-marker-size - double - ``'0.25'`` * - min-marker-style - marker_style - ``'0'`` **Farbmatrizen** .. list-table:: :header-rows: 1 * - Eigenschaft - Typ - Default-Wert * - color-matrix - bool - 0 * - color-matrix-line-color - color - black * - color-matrix-line-width - int - 2 * - color-matrix-showzval - bool - 1 * - color-matrix-cliptext - bool - 1 * - color-matrix-shrinktext - bool - 1 * - color-matrix-showedge - bool - 1 * - color-matrix-clipzmin - bool - 0 **Sonstiges** .. list-table:: :header-rows: 1 * - Eigenschaft - Typ - Default-Wert * - name - string - ``''`` * - scatter-bar-width - double - ``'3.0'`` * - scatter-label-offset-x - double - ``'0.0'`` * - scatter-label-offset-y - double - ``'0.0'`` * - triangulation - bool - ``'0'`` Anmerkungen zur Spalte **Typ** finden Sie unter :ref:`XYSetProps`. Weitere Informationen finden Sie in der Datei :file:`script\\do_sty4.ic`. **Farbtabelle** .. image:: S:/uniplot-obj/images/color-table.* .. us.history **History** .. list-table:: :header-rows: 1 * - Version - Beschreibung * - 5.30 - Farbmatrix-Attribute zugefügt. **label-transparent** zugefügt. * - 4.0.3 - Neu. .. seealso:: :ref:`uberblick-xyz-datensatze`, :ref:`XYZGetProps`, :ref:`XYZSetDefault`, :ref:`XYSetProps` :sub:`id-1762688`