
##############
ScalarSettings
##############

.. js:class:: cee.ug.ScalarSettings

   Specification of how to render scalar results on the model, on cutting planes, on isosurfaces and on particle traces.
   
   Use this object to control the visual appearance of scalar results in the 3D viewer. You can specify which :js:func:`colorScheme <cee.ug.ScalarSettings.colorScheme>` to use for the color legend and how many levels (unique colors) it should have with :js:func:`levelCount <cee.ug.ScalarSettings.levelCount>`\ . You can also control the legend's scaling, either by using :js:func:`autoRangeMode <cee.ug.ScalarSettings.autoRangeMode>` or by specifying :js:func:`rangeMinimum <cee.ug.ScalarSettings.rangeMinimum>` and :js:func:`rangeMaximum <cee.ug.ScalarSettings.rangeMaximum>`\ .
   
   **Example:** Setup a custom color legend
   
   .. code-block:: javascript
   
      var modelSpec = myModel.modelSpec;
      
      var resultId = modelSpec.fringesResultId;
      if (resultId >= 0) {
          var scalarSettings = myModel.getScalarSettingsById(resultId);
      
          var min = myModel.getScalarResultMinimumValue(resultId);
          var max = myModel.getScalarResultMaximumValue(resultId);
          var range = max - min;
      
          // Setup custom scale 50% -> 100% of the range using a green to brown legend.
          scalarSettings.setRange(min + range*0.5, max);
          scalarSettings.colorScheme = cee.ug.ColorScheme.WHITE_TO_BROWN;
          scalarSettings.levelCount = 3;
      }    
   
   This code sample produces the following image in the 3D Viewer:
   
   .. image:: /images/ScalarSettings_custom.png
      :alt: None
   
   
   
   
   Index
   =====
   
   .. rubric:: Accessors
   
   
   .. rst-class:: api-xref-list
   
   
   * :js:func:`~cee.ug.ScalarSettings.aboveRangeColor`
   * :js:func:`~cee.ug.ScalarSettings.autoRangeMode`
   * :js:func:`~cee.ug.ScalarSettings.belowRangeColor`
   * :js:func:`~cee.ug.ScalarSettings.colorMarkerArray`
   * :js:func:`~cee.ug.ScalarSettings.colorScheme`
   * :js:func:`~cee.ug.ScalarSettings.customContinuousColorArr`
   * :js:func:`~cee.ug.ScalarSettings.customContinuousTickMarkArr`
   * :js:func:`~cee.ug.ScalarSettings.customContinuousValueArr`
   * :js:func:`~cee.ug.ScalarSettings.customFilledContoursColorArr`
   * :js:func:`~cee.ug.ScalarSettings.filledContoursColorArr`
   * :js:func:`~cee.ug.ScalarSettings.filteringRangeMaximum`
   * :js:func:`~cee.ug.ScalarSettings.filteringRangeMinimum`
   * :js:func:`~cee.ug.ScalarSettings.isAutoRangeEnabled`
   * :js:func:`~cee.ug.ScalarSettings.isFilteringEnabled`
   * :js:func:`~cee.ug.ScalarSettings.legendVisibilityMode`
   * :js:func:`~cee.ug.ScalarSettings.levelCount`
   * :js:func:`~cee.ug.ScalarSettings.logarithmicMapping`
   * :js:func:`~cee.ug.ScalarSettings.nodeAveragedValues`
   * :js:func:`~cee.ug.ScalarSettings.numericFormat`
   * :js:func:`~cee.ug.ScalarSettings.numericPrecision`
   * :js:func:`~cee.ug.ScalarSettings.rangeMaximum`
   * :js:func:`~cee.ug.ScalarSettings.rangeMinimum`
   * :js:func:`~cee.ug.ScalarSettings.resultId`
   * :js:func:`~cee.ug.ScalarSettings.scalingConstantTerm`
   * :js:func:`~cee.ug.ScalarSettings.scalingFirstDegreeTerm`
   * :js:func:`~cee.ug.ScalarSettings.undefinedColor`
   
   .. rubric:: Methods
   
   
   .. rst-class:: api-xref-list
   
   
   * :js:meth:`~cee.ug.ScalarSettings.disableFiltering`
   * :js:meth:`~cee.ug.ScalarSettings.getAsProperties`
   * :js:meth:`~cee.ug.ScalarSettings.mapToColor`
   * :js:meth:`~cee.ug.ScalarSettings.setAutoRange`
   * :js:meth:`~cee.ug.ScalarSettings.setCustomContinuousColorArr`
   * :js:meth:`~cee.ug.ScalarSettings.setCustomContinuousTickMarks`
   * :js:meth:`~cee.ug.ScalarSettings.setFilteringRange`
   * :js:meth:`~cee.ug.ScalarSettings.setFromProperties`
   * :js:meth:`~cee.ug.ScalarSettings.setRange`
   
   



.. rst-class:: kind-group kind-accessors

.. rubric:: Accessors
   :class: kind-group-title


.. js:method:: cee.ug.ScalarSettings.aboveRangeColor

      .. rst-class:: sig-pretty-signature
      
         | *get* aboveRangeColor(): :js:class:`Color3Like <cee.Color3Like>`
      
      The color for the parts of the model that are above the current range.
      
      Default is null, which means that the top color of the :js:func:`colorScheme <cee.ug.ScalarSettings.colorScheme>` will be used.
      
      Note: Changing the colorScheme will set :js:func:`aboveRangeColor <cee.ug.ScalarSettings.aboveRangeColor>` and :js:func:`belowRangeColor <cee.ug.ScalarSettings.belowRangeColor>` to null.
      
      **Returns**\ : :js:class:`Color3Like <cee.Color3Like>`
      
      .. rst-class:: sig-pretty-signature
      
         | *set* aboveRangeColor(**color**\ : :js:class:`Color3Like <cee.Color3Like>`\ ): *void*
      
      **Parameters**
      
      
         **color**\ : :js:class:`Color3Like <cee.Color3Like>`
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.autoRangeMode

      .. rst-class:: sig-pretty-signature
      
         | *get* autoRangeMode(): :js:data:`AutoRangeMode <cee.ug.AutoRangeMode>`
      
      Auto range mode. Set this value with :js:meth:`setAutoRange <cee.ug.ScalarSettings.setAutoRange>`\ .
      
      To disable auto range, set a manual range with :js:meth:`setRange <cee.ug.ScalarSettings.setRange>`\ .
      
      **Returns**\ : :js:data:`AutoRangeMode <cee.ug.AutoRangeMode>`
      



.. js:method:: cee.ug.ScalarSettings.belowRangeColor

      .. rst-class:: sig-pretty-signature
      
         | *get* belowRangeColor(): :js:class:`Color3Like <cee.Color3Like>`
      
      The color for the parts of the model that are below the current range.
      
      Default is null, which means that the bottom color of the :js:func:`colorScheme <cee.ug.ScalarSettings.colorScheme>` will be used.
      
      Note: Changing the colorScheme will set :js:func:`aboveRangeColor <cee.ug.ScalarSettings.aboveRangeColor>` and :js:func:`belowRangeColor <cee.ug.ScalarSettings.belowRangeColor>` to null.
      
      **Returns**\ : :js:class:`Color3Like <cee.Color3Like>`
      
      .. rst-class:: sig-pretty-signature
      
         | *set* belowRangeColor(**color**\ : :js:class:`Color3Like <cee.Color3Like>`\ ): *void*
      
      **Parameters**
      
      
         **color**\ : :js:class:`Color3Like <cee.Color3Like>`
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.colorMarkerArray

      .. rst-class:: sig-pretty-signature
      
         | *get* colorMarkerArray(): readonly  :js:class:`LegendColorMarker <cee.ug.LegendColorMarker>`\ []
      
      Additional color legend markers that can be shown above or below the main markers in the legend.
      
      Useful for describing above, below and undefined colors.
      
      Example: Add a "No result" marker below the color legend:
      
      .. code-block:: javascript
      
         scalarSettings.colorMarkerArray = [
             { 
                 position: cee.ug.LegendColorMarkerPosition.BELOW, 
                 color: new cee.Color3(0.5, 0.5, 0.5), 
                 description: "No result" 
             }
         ];
      
      **Returns**\ : readonly  :js:class:`LegendColorMarker <cee.ug.LegendColorMarker>`\ []
      
      .. rst-class:: sig-pretty-signature
      
         | *set* colorMarkerArray(**colorMarkers**\ : readonly  :js:class:`LegendColorMarker <cee.ug.LegendColorMarker>`\ []): *void*
      
      **Parameters**
      
      
         **colorMarkers**\ : readonly  :js:class:`LegendColorMarker <cee.ug.LegendColorMarker>`\ []
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.colorScheme

      .. rst-class:: sig-pretty-signature
      
         | *get* colorScheme(): :js:data:`ColorScheme <cee.ug.ColorScheme>`
      
      The color scheme to use for the color legend and mapped colors on the model.
      
      Use this property to set the color scheme to any of the pre-defined color schemes.
      
      The colorScheme cannot be set to CUSTOM with this property. This is done with the setCustomContinuousColorArr() method or customFilledContoursColorArr property. colorScheme will return CUSTOM if one if these setters are used.
      
      Note: Changing the colorScheme will set :js:func:`aboveRangeColor <cee.ug.ScalarSettings.aboveRangeColor>` and :js:func:`belowRangeColor <cee.ug.ScalarSettings.belowRangeColor>` to null.
      
      **Returns**\ : :js:data:`ColorScheme <cee.ug.ColorScheme>`
      
      .. rst-class:: sig-pretty-signature
      
         | *set* colorScheme(**colorScheme**\ : :js:data:`ColorScheme <cee.ug.ColorScheme>`\ ): *void*
      
      **Parameters**
      
      
         **colorScheme**\ : :js:data:`ColorScheme <cee.ug.ColorScheme>`
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.customContinuousColorArr

      .. rst-class:: sig-pretty-signature
      
         | *get* customContinuousColorArr(): :js:class:`Color3Like <cee.Color3Like>`\ []
      
      Get the custom continuous color array if defined.
      
      This is setup with the setCustomContinuousColorArr() method.
      
      **Returns**\ : :js:class:`Color3Like <cee.Color3Like>`\ []
      



.. js:method:: cee.ug.ScalarSettings.customContinuousTickMarkArr

      .. rst-class:: sig-pretty-signature
      
         | *get* customContinuousTickMarkArr(): *number*\ []
      
      Get the custom continuous tick mark array if defined.
      
      This is setup with the setCustomContinuousTickMarks() method.
      
      **Returns**\ : *number*\ []
      



.. js:method:: cee.ug.ScalarSettings.customContinuousValueArr

      .. rst-class:: sig-pretty-signature
      
         | *get* customContinuousValueArr(): *number*\ []
      
      Get the custom continuous value array if defined.
      
      This is setup with the setCustomContinuousColorArr() method.
      
      **Returns**\ : *number*\ []
      



.. js:method:: cee.ug.ScalarSettings.customFilledContoursColorArr

      .. rst-class:: sig-pretty-signature
      
         | *get* customFilledContoursColorArr(): :js:class:`Color3Like <cee.Color3Like>`\ []
      
      Setup the color legend with the given level colors.
      
      The color scheme will be set to CUSTOM, and the number of levels will be set to the length of the provided array.
      
      **Returns**\ : :js:class:`Color3Like <cee.Color3Like>`\ []
      
      .. rst-class:: sig-pretty-signature
      
         | *set* customFilledContoursColorArr(**colorArr**\ : :js:class:`Color3Like <cee.Color3Like>`\ []): *void*
      
      **Parameters**
      
      
         **colorArr**\ : :js:class:`Color3Like <cee.Color3Like>`\ []
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.filledContoursColorArr

      .. rst-class:: sig-pretty-signature
      
         | *get* filledContoursColorArr(): :js:class:`Color3Like <cee.Color3Like>`\ []
      
      Get the colors of the current color legend (if in levels mode)
      
      If levelCount > 0, this will return the colors for each level on the color legend, starting from the bottom of the legend.
      
      Note: If not using customFilledContoursColorArr, the color legend info needs to be received from the server before this method will return valid info, so make sure the current update of display model is fully completed.
      
      **Returns**\ : :js:class:`Color3Like <cee.Color3Like>`\ []
      



.. js:method:: cee.ug.ScalarSettings.filteringRangeMaximum

      .. rst-class:: sig-pretty-signature
      
         | *get* filteringRangeMaximum(): *number*
      
      The maximum value the result needs to have to be visible when filtering is enabled. This will be undefined if filtering is disabled.
      
      **Returns**\ : *number*
      



.. js:method:: cee.ug.ScalarSettings.filteringRangeMinimum

      .. rst-class:: sig-pretty-signature
      
         | *get* filteringRangeMinimum(): *number*
      
      The minimum value the result needs to have to be visible when filtering is enabled. This will be undefined if filtering is disabled.
      
      **Returns**\ : *number*
      



.. js:method:: cee.ug.ScalarSettings.isAutoRangeEnabled

      .. rst-class:: sig-pretty-signature
      
         | *get* isAutoRangeEnabled(): *boolean*
      
      Whether auto range is enabled.
      
      **Returns**\ : *boolean*
      



.. js:method:: cee.ug.ScalarSettings.isFilteringEnabled

      .. rst-class:: sig-pretty-signature
      
         | *get* isFilteringEnabled(): *boolean*
      
      Whether filtering of this scalar result is enabled.
      
      **Returns**\ : *boolean*
      



.. js:method:: cee.ug.ScalarSettings.legendVisibilityMode

      .. rst-class:: sig-pretty-signature
      
         | *get* legendVisibilityMode(): :js:data:`LegendVisibilityMode <cee.ug.LegendVisibilityMode>`
      
      Specifies the visibility of the color legend.
      
      The legend can be set to appear if used by any part in the model (AUTO, default), to always be shown (ALWAYS) or to never be shown (NEVER)
      
      **Returns**\ : :js:data:`LegendVisibilityMode <cee.ug.LegendVisibilityMode>`
      
      .. rst-class:: sig-pretty-signature
      
         | *set* legendVisibilityMode(**mode**\ : :js:data:`LegendVisibilityMode <cee.ug.LegendVisibilityMode>`\ ): *void*
      
      **Parameters**
      
      
         **mode**\ : :js:data:`LegendVisibilityMode <cee.ug.LegendVisibilityMode>`
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.levelCount

      .. rst-class:: sig-pretty-signature
      
         | *get* levelCount(): *number*
      
      The number of levels (unique colors) in the color legend.
      
      If you want a continuous (smooth) legend, set the number of levels to 0. This will create a continuous legend with tick marks at round numbers.
      
      **Returns**\ : *number*
      
      .. rst-class:: sig-pretty-signature
      
         | *set* levelCount(**numLevels**\ : *number*\ ): *void*
      
      **Parameters**
      
      
         **numLevels**\ : *number*
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.logarithmicMapping

      .. rst-class:: sig-pretty-signature
      
         | *get* logarithmicMapping(): *boolean*
      
      If true, a logarithmic range will be used for the color legend and results mapping. If false, a linear mapping will be used.
      
      **Returns**\ : *boolean*
      
      .. rst-class:: sig-pretty-signature
      
         | *set* logarithmicMapping(**logarithmicMapping**\ : *boolean*\ ): *void*
      
      **Parameters**
      
      
         **logarithmicMapping**\ : *boolean*
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.nodeAveragedValues

      .. rst-class:: sig-pretty-signature
      
         | *get* nodeAveragedValues(): *boolean*
      
      Specify if the scalar result should be shown as a node averaged result or not.
      
      If false (default) the result is shown as is computed. If true, a node averaged result will be shown that is derived from the original result.
      
      Also, setting this value for a result used to compute a feature extraction (like isovolume) affects the way the feature extraction is generated. For example, for per-element result mapping, the isosurface will be generated as a smooth node-averaged surface when this is set to true, instead of the usual "blocky" appearance.
      
      **Returns**\ : *boolean*
      
      .. rst-class:: sig-pretty-signature
      
         | *set* nodeAveragedValues(**useNodeAveraging**\ : *boolean*\ ): *void*
      
      **Parameters**
      
      
         **useNodeAveraging**\ : *boolean*
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.numericFormat

      .. rst-class:: sig-pretty-signature
      
         | *get* numericFormat(): *string*
      
      The numerical format to use for the numbers on the color legend tick marks
      
      Legal options: 'g': (default) (using the .toPrecision JS function). 'f': fixed notation (1234.0) (using the .toFixed() JS function) 'e': scientific notation (1.234e4)  (using the .toExponential JS function)
      
      The precision is controlled by the numericPrecision property.
      
      **Returns**\ : *string*
      
      .. rst-class:: sig-pretty-signature
      
         | *set* numericFormat(**numericFormat**\ : *string*\ ): *void*
      
      **Parameters**
      
      
         **numericFormat**\ : *string*
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.numericPrecision

      .. rst-class:: sig-pretty-signature
      
         | *get* numericPrecision(): *number*
      
      Set the precision to use for the numbers on the color legend tick marks
      
      See numericFormat for the different options.
      
      **Returns**\ : *number*
      
      .. rst-class:: sig-pretty-signature
      
         | *set* numericPrecision(**precision**\ : *number*\ ): *void*
      
      **Parameters**
      
      
         **precision**\ : *number*
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.rangeMaximum

      .. rst-class:: sig-pretty-signature
      
         | *get* rangeMaximum(): *number*
      
      The maximum range of the scalar result if auto range is disabled. This is undefined if auto range is enabled.
      
      To set a manual range, use the :js:meth:`setRange <cee.ug.ScalarSettings.setRange>` function.
      
      **Returns**\ : *number*
      



.. js:method:: cee.ug.ScalarSettings.rangeMinimum

      .. rst-class:: sig-pretty-signature
      
         | *get* rangeMinimum(): *number*
      
      The minimum range of the scalar result if auto range is disabled. This is undefined if auto range is enabled.
      
      To set a manual range, use the :js:meth:`setRange <cee.ug.ScalarSettings.setRange>` function.
      
      **Returns**\ : *number*
      



.. js:method:: cee.ug.ScalarSettings.resultId

      .. rst-class:: sig-pretty-signature
      
         | *get* resultId(): *number*
      
      The id (>=0) of the scalar result. This id corresponds to the id in :js:data:`ModelDirectory.scalarResultArray <cee.ug.ModelDirectory.scalarResultArray>`\ .
      
      **Returns**\ : *number*
      



.. js:method:: cee.ug.ScalarSettings.scalingConstantTerm

      .. rst-class:: sig-pretty-signature
      
         | *get* scalingConstantTerm(): *number*
      
      Constant scaling term used for custom scaling of the legend.
      
      The value shown on the legend tick marks is:
      
      
      ::
      
         legendValue = scalingConstantTerm + scalarValue*scalingFirstDegreeTerm
      
      **Returns**\ : *number*
      
      .. rst-class:: sig-pretty-signature
      
         | *set* scalingConstantTerm(**scalingConstantTerm**\ : *number*\ ): *void*
      
      **Parameters**
      
      
         **scalingConstantTerm**\ : *number*
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.scalingFirstDegreeTerm

      .. rst-class:: sig-pretty-signature
      
         | *get* scalingFirstDegreeTerm(): *number*
      
      First degree term used for custom scaling of the legend.
      
      The value shown on the legend tick marks is:
      
      
      ::
      
         legendValue = scalingConstantTerm + scalarValue*scalingFirstDegreeTerm
      
      **Returns**\ : *number*
      
      .. rst-class:: sig-pretty-signature
      
         | *set* scalingFirstDegreeTerm(**scalingFirstDegreeTerm**\ : *number*\ ): *void*
      
      **Parameters**
      
      
         **scalingFirstDegreeTerm**\ : *number*
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.undefinedColor

      .. rst-class:: sig-pretty-signature
      
         | *get* undefinedColor(): :js:class:`Color3Like <cee.Color3Like>`
      
      The color of the parts of the model with an undefined result.
      
      **Returns**\ : :js:class:`Color3Like <cee.Color3Like>`
      
      .. rst-class:: sig-pretty-signature
      
         | *set* undefinedColor(**color**\ : :js:class:`Color3Like <cee.Color3Like>`\ ): *void*
      
      **Parameters**
      
      
         **color**\ : :js:class:`Color3Like <cee.Color3Like>`
      
      
      **Returns**\ : *void*
      



.. rst-class:: kind-group kind-methods

.. rubric:: Methods
   :class: kind-group-title


.. js:method:: cee.ug.ScalarSettings.disableFiltering

      .. rst-class:: sig-pretty-signature
      
         | disableFiltering(): *void*
      
      Disables any filtering of the results.
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.getAsProperties

      .. rst-class:: sig-pretty-signature
      
         | getAsProperties(): :js:class:`ScalarSettingsProperties <cee.ug.ScalarSettingsProperties>`
      
      Gets the settings for this object as a Plain Old JavaScript Object (POJO).
      
      **Returns**\ : :js:class:`ScalarSettingsProperties <cee.ug.ScalarSettingsProperties>`
      



.. js:method:: cee.ug.ScalarSettings.mapToColor

      .. rst-class:: sig-pretty-signature
      
         | mapToColor(**scalarValue**\ : *number*\ ): :js:class:`Color3Like <cee.Color3Like>`
      
      Maps the given domain value to a color using the current scalar settings
      
      **Parameters**
      
      
         **scalarValue**\ : *number*
      
      
      **Returns**\ : :js:class:`Color3Like <cee.Color3Like>`
      



.. js:method:: cee.ug.ScalarSettings.setAutoRange

      .. rst-class:: sig-pretty-signature
      
         | setAutoRange(**mode**\ : :js:data:`AutoRangeMode <cee.ug.AutoRangeMode>`\ ): *void*
      
      Sets the automatic full range of the scalar result.
      
      Set this to AutoRangeMode.ALL_ITEMS to use the full range for the result (this is the default) or to AutoRangeMode.VISIBLE_ITEMS to limit the range to the currently visible parts
      
      **Parameters**
      
      
         **mode**\ : :js:data:`AutoRangeMode <cee.ug.AutoRangeMode>`
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.setCustomContinuousColorArr

      .. rst-class:: sig-pretty-signature
      
         | setCustomContinuousColorArr(**colorArr**\ : :js:class:`Color3Like <cee.Color3Like>`\ [], **valueArr**\ : *number*\ []): *void*
      
      Sets custom color scheme for a continuous color legend.
      
      Specify an array of colors to use to create the interpolated continuous legend.
      
      If values are specified (valueArr) the color will be set at that value and interpolated between the values. If no values are provided the specified colors will be distributed evenly between min and max.
      
      The range will be adjusted if needed to include the specified values (if any).
      
      Please note that there is no correlation between the values specified and the tick marks on the legend. The values specify the position of the color on the legend. The tick marks will be distributed on round numbers.
      
      Note! colorScheme will be set to ColorScheme.CUSTOM and the levelCount to 0.
      
      **Parameters**
      
      
         **colorArr**\ : :js:class:`Color3Like <cee.Color3Like>`\ []
      
         **valueArr**\ : *number*\ []
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.setCustomContinuousTickMarks

      .. rst-class:: sig-pretty-signature
      
         | setCustomContinuousTickMarks(**tickMarkValues**\ : *number*\ []): *void*
      
      Set custom tick marks for a continuous color legend. Any values outside the legend min/max range will be ignored.  If an empty array or falsy value is provided, the tick marks will be distributed on round numbers by default.
      
      Note this will not set the legend to be continuous. To do that, set levelCount to 0.
      
      **Parameters**
      
      
         **tickMarkValues**\ : *number*\ []
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.setFilteringRange

      .. rst-class:: sig-pretty-signature
      
         | setFilteringRange(**minValue**\ : *number*\ , **maxValue**\ : *number*\ ): *void*
      
      Specifies to show only the results whose value lies within the given range.
      
      When enabled, only results whose value is within the given filter range <``minValue``\ , ``maxValue``\ > will be drawn. All other results will be discarded and not drawn.
      
      The filtering will be done on a per-element basis, so an element (and thus all its surface) is either fully visible or not visible. If you have a per-node or per-element-node result, the element is visible if at least one of the nodes is within range.
      
      **Parameters**
      
      
         **minValue**\ : *number*
      
         **maxValue**\ : *number*
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.setFromProperties

      .. rst-class:: sig-pretty-signature
      
         | setFromProperties(**props**\ : *Partial*\ ): *void*
      
      Applies the settings in the given properties object to this scalar settings
      
      **Parameters**
      
      
         **props**\ : *Partial*
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.ScalarSettings.setRange

      .. rst-class:: sig-pretty-signature
      
         | setRange(**min**\ : *number*\ , **max**\ : *number*\ ): *void*
      
      Sets a user defined range of the scalar result.
      
      This function will disable auto range.
      
      **Parameters**
      
      
         **min**\ : *number*
      
         **max**\ : *number*
      
      
      **Returns**\ : *void*
      




