Tutorial
DSP
KUIML
How-to
Scripts
KUIMLElement ReferenceCOLOR_SURFACE_3D
March 25, 2024

COLOR_SURFACE_3D

This object represents the shape of a surface in a 3D scene with a color scale.

Attributes brief detailed show all inherited

Name DescriptionDefault
low_colorColor for the min value#000000...
high_colorColor for the max value#ffffff...

See Attributes Common to 3D Objects. Also, as a surface viewing element, this object shares Attributes Common to Surface Viewers, except the attributes specific to widgets.

Specific Attributes

Examples

Formula Surface

The example below displays a surface defined by a Math Formula and lets the user change several options for the 3D view. 3D renderer characteristics are also displayed:

doc_ref_3d_objects_color_surface_3d_element_example1.png
  1. <?xml version="1.0" encoding="utf-8" ?>
  2. <SKIN text_color="#ffffff">

  4. <!-- Custom Viewer definition -->
  5. <DEFINE>
  6. <CUS_3D_VIEWER base_type="VIEW_3D" width="600" height="400" grid.opacity=".8" cursor="system::open_hand"
  7. y_ratio=".8" z_ratio=".5" transform.tz="-1.3" persistent_viewpoint="true" transform.rx="60" transform.rz="20"/>
  8. </DEFINE>

  10. <!-- The formula that defines the surface -->
  11. <FORMULA_SURFACE formula="cos(2*pi*x)*sin(2*pi*y)*sqrt(1-x^2-y^2)" id="my_formula" x_min="-1" x_max="1" x_default="0" y_min="-1" y_max="1" y_default="0" z_min="-1" z_max="1" z_default="0"/>

  13. <!-- Main layout-->
  14. <ROW spacing= "5">
  15. <COLUMN>
  16. <!-- The 3D Viewer -->
  17. <CUS_3D_VIEWER id="3d_view">
  18. <!-- Grid object -->
  19. <GRID_3D id="3d_view.grid" x_param_info_id="my_formula.x_info" y_param_info_id="my_formula.y_info" z_param_info_id="my_formula.z_info"
  20. y_positions_count="11" x_positions_count="11" z_positions_count="11" x_position="-.5" y_position="-.5" z_position="-.5" x_offset=".5" y_offset=".5" z_offset=".5"/>
  21. <!-- The Color surface-->
  22. <COLOR_SURFACE_3D id="3d_view.surface" surface_id="my_formula" visible="true" high_color="#ff0000" low_color="#000001" opacity=".8"
  23. x_positions_count="100" y_positions_count="100" x_offset=".5" y_offset=".5" z_offset=".5" x_position="-.5" y_position="-.5" z_position="-.5"/>
  24. </CUS_3D_VIEWER>
  25. </COLUMN>
  26. <!-- User Controls-->
  27. <COLUMN spacing="20">
  28. <COLUMN spacing="2">
  29. <!-- Select Objects Opacity -->
  30. <TEXT value="Opacity:"/>
  31. <PARAM_TEXT_EDIT_BOX param_id="3d_view.surface.opacity" width="100" background_color="#00000"/>
  32. <PARAM_TEXT_EDIT_BOX param_id="3d_view.grid.opacity" width="100" background_color="#00000"/>
  33. </COLUMN>
  34. <PARAM_TEXT content="3D Style: {text_value}" param_id="3d_view.surface.draw_style" width="100">
  35. <INVISIBLE_PARAM_MENU_BUTTON param_id="3d_view.surface.draw_style" width="100%" height="100%" cursor="system::hand"/>
  36. </PARAM_TEXT>
  37. <!-- Display information about the OpenGL Renderer -->
  38. <COLUMN spacing="2">
  39. <TEXT value="OpenGL Renderer:" />
  40. <TEXT string_id="3d_view.vendor" width="200" height="10" />
  41. <TEXT string_id="3d_view.renderer" width="200" height="10"/>
  42. <TEXT string_id="3d_view.version" width="200" height="10"/>
  43. </COLUMN>
  44. </COLUMN>
  45. </ROW>
  46. </SKIN>