{"id":3117,"date":"2025-02-17T14:10:05","date_gmt":"2025-02-17T19:10:05","guid":{"rendered":"https:\/\/stepinto.vision\/?p=3117"},"modified":"2025-02-17T14:10:05","modified_gmt":"2025-02-17T19:10:05","slug":"realitykit-basics-update-closure","status":"publish","type":"post","link":"https:\/\/stepinto.vision\/example-code\/realitykit-basics-update-closure\/","title":{"rendered":"RealityKit Basics: update closure"},"content":{"rendered":"\n

The update closure will run when any referenced state changes. We can reach into our RealityView content to modify entities or components.<\/p>\n\n\n\n

Overview<\/h2>\n\n\n\n

We touched on the update closure in the post on RealityView<\/a>, but let’s take a closer look. The update closure is our bridge from the 3D world of RealityKit to SwiftUI. There are three concepts we need use to make this work for us.<\/p>\n\n\n\n

    \n
  1. Some state for our view. This could be simple @State<\/code> variables like in this example, or more complex data defined where in our app.<\/li>\n\n\n\n
  2. Something to modify the state. In this example, we have two toggle buttons in the toolbar.<\/li>\n\n\n\n
  3. The update<\/code> closure. Any code we define here will execute whenever the update closure is triggered.<\/li>\n<\/ol>\n\n\n\n

    When is update triggered? Generally speaking<\/em> \u2020<\/a>, whenever one of or more bit of referenced state is modified. For example, this will only run when showEarth<\/code> or showMoon<\/code> has changed. If we had a third state variable called showSun<\/code>, changes to it would not trigger this since we are not using it in the closure.<\/p>\n\n\n\n

    <\/path><\/path><\/svg><\/span>
    } update: { content <\/span>in<\/span><\/span>\n    <\/span>if<\/span> <\/span>let<\/span> earth = content.<\/span>entities<\/span>.<\/span>first<\/span>?.<\/span>findEntity<\/span>(<\/span>named<\/span>: <\/span>"Earth"<\/span>), <\/span>let<\/span> moon = content.<\/span>entities<\/span>.<\/span>first<\/span>?.<\/span>findEntity<\/span>(<\/span>named<\/span>: <\/span>"Moon"<\/span>) {<\/span><\/span>\n        earth.<\/span>isEnabled<\/span> = showEarth<\/span><\/span>\n        moon.<\/span>isEnabled<\/span> = showMoon<\/span><\/span>\n    }<\/span><\/span>\n}<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
    We can access the content<\/code> from RealityView, then query the entity graph to find something that needs to change.<\/p>\n\n\n\n
    It’s important to note that this update closure is not like an update or tick function in a game engine.  Those run every frame, whereas this only runs when the state it references changes.<\/p>\n\n\n\n
    Something else to keep in mind is that this whole closure<\/strong> will fire when any state<\/strong> it uses has changed. If either showEarth<\/code> or<\/strong> showMoon<\/code> is changed, this update will be triggered. If you have very complex views with a lot of state, you may run into situations where entities updated unnecessarily.<\/p>\n\n\n\n
    Lastly, update will fire every time a bit if state is modified. If the action you are performing is complex, that may not be idea. For example, I’d avoid using sliders or other controls that rapidly change state variables, as each change would trigger an update.<\/p>\n\n\n\n
    In a future post, we’ll look at some other methods to update our entities based on changes to state. <\/p>\n\n\n\n
    Video Demo<\/h2>\n\n\n\n\t\t
    \n\t\t\t