
####################
DisplacementSettings
####################

.. js:class:: cee.ug.DisplacementSettings

   Specification of how to render parts with the given displacement result.
   
   With this object you can control the (absolute) scaling of displacements.
   
   
   Index
   =====
   
   .. rubric:: Accessors
   
   
   .. rst-class:: api-xref-list
   
   
   * :js:func:`~cee.ug.DisplacementSettings.resultId`
   * :js:func:`~cee.ug.DisplacementSettings.scaleFactor`
   * :js:func:`~cee.ug.DisplacementSettings.scaleMode`
   
   .. rubric:: Methods
   
   
   .. rst-class:: api-xref-list
   
   
   * :js:meth:`~cee.ug.DisplacementSettings.getAsProperties`
   * :js:meth:`~cee.ug.DisplacementSettings.setFromProperties`
   
   



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

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


.. js:method:: cee.ug.DisplacementSettings.resultId

      .. rst-class:: sig-pretty-signature
      
         | *get* resultId(): *number*
      
      The id (>=0) of the displacement result. This id must refer to one of the displacement results in :js:data:`ModelDirectory.displacementResultArray <cee.ug.ModelDirectory.displacementResultArray>`\ .
      
      **Returns**\ : *number*
      



.. js:method:: cee.ug.DisplacementSettings.scaleFactor

      .. rst-class:: sig-pretty-signature
      
         | *get* scaleFactor(): *number*
      
      The scale factor to use for the displacement result.
      
      The behavior depends on the chosen :js:func:`scaleMode <cee.ug.DisplacementSettings.scaleMode>`\ . For absolute displacements, they will be simply multiplied by this factor.
      
      For relative displacements, this will scale them in a way that the largest displacement will have its length equal to the length of the model bounding box's diagonal multiplied by this factor. Typical usable values for relative displacements are in the range 0 to 0.5.
      
      **Returns**\ : *number*
      
      .. rst-class:: sig-pretty-signature
      
         | *set* scaleFactor(**scaleFactor**\ : *number*\ ): *void*
      
      **Parameters**
      
      
         **scaleFactor**\ : *number*
      
      
      **Returns**\ : *void*
      



.. js:method:: cee.ug.DisplacementSettings.scaleMode

      .. rst-class:: sig-pretty-signature
      
         | *get* scaleMode(): :js:data:`DisplacementScaleMode <cee.ug.DisplacementScaleMode>`
      
      The scaling mode to use for displacement results (absolute or relative). The default is absolute.
      
      **Returns**\ : :js:data:`DisplacementScaleMode <cee.ug.DisplacementScaleMode>`
      
      .. rst-class:: sig-pretty-signature
      
         | *set* scaleMode(**scaleMode**\ : :js:data:`DisplacementScaleMode <cee.ug.DisplacementScaleMode>`\ ): *void*
      
      <nbsp>
      
      **Parameters**
      
      
         **scaleMode**\ : :js:data:`DisplacementScaleMode <cee.ug.DisplacementScaleMode>`
      
      
      **Returns**\ : *void*
      



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

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


.. js:method:: cee.ug.DisplacementSettings.getAsProperties

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



.. js:method:: cee.ug.DisplacementSettings.setFromProperties

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




