visionforge/docs/inheritance.md
2021-08-22 14:56:31 +03:00

2.9 KiB
Raw Blame History

Inheritance

Inheritance is an ability of an element to transfer a pack of properties to its children elements 'wrapped inside'.

VisionBase Properties have to be set in a specific order:

Main properties' inheritance:

  • styles - StyleSheet
  • parents
  • parent's styles
  • defaults

SolidReference As for prototypes, this property has to be set after styles, but before parents. So the order will be this:

Reference properties' inheritance:

  • styles
  • prototypes - PrototypeHolder in SolidGroup
  • parents
  • parent's styles
  • defaults

Let's take a closer look using a Muon Monitor Visualization. Running the demo, we will see this:

You can see a tree of elements on the left; 'World' is a root, 'bottom', 'middle', and 'top' are 'World's children and so on.

On the right, there is a list with changeable properties.

Properties, which can or cannot be inherited, are these:

  • visible toggles the visibility of an element. To be exact, the invisibility of an element is inheritable. If a parent element is invisible, other elements are invisible as well, and they cannot be changed to visible mode.

  • material a group of properties, which can be inherited and which can be changed in children elements.

    • color color of an element.
    • opacity a number from 0 to 1 which represents percents of opacity (0 for 0%, 1 for 100%).
    • wireframe toggles the wireframe mode.

    Let's see how elements of the material group inherit changing color property; other properties of this group inherit in the same way.

    Let's change color of 'World' element: It is a parent, so 'bottom', 'middle', and 'top' elements inherit this color.

    Now, let's change 'top's color: It changes only, 'bottom' and 'middle' stays the same.

    'top' is a parent element as well: it has children 'SC72', 'SC73', ... ,'SC80'. Let's change the color of 'SC76': Again, only 'SC76' has changed among other 'siblings'.

    However, 'SC76' is a parent too. Let's change one of its children color (here we change 'SC76_5's color'):

    As we can see, color is inheritable property, which can be changed in a custom way.

    If after all those changes we set at the 'World' element grey color, changes won't disappear:

  • rotation rotation of an element. Here, it is set by x value. It is inheritable and unable to be changed in children elements.

  • position position of an element, cannot be inherited.