{"type":"doc","content":[{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"bodiedExtension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"excerpt","parameters":{"macroParams":{"_parentId":{"value":"3985973576"},"atlassian-macro-output-type":{"value":"BLOCK"}},"macroMetadata":{"macroId":{"value":"8ab7b168-4138-4643-bde6-9d7dc6389461"},"schemaVersion":{"value":"1"},"title":"Excerpt"}},"localId":"5ecf50af-94a1-4ea8-a5bb-18b21100a9e7"},"content":[{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"7a2e4d2b-dd92-442e-b614-dd7b6a8fd59e","collection":"contentId-3985973576","height":"59"}}},{"text":"This information is intended for users of Vortex Studio and Unreal Engine who want to integrate Vortex Studio simulation capabilities with Unreal, within a single process. This integration SDK is useful for single process simulation, VR, and using advanced blueprints logic in Unreal.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#000000"}}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"_parentId":{"value":"3985973576"}},"macroMetadata":{"macroId":{"value":"ca8d6766-34c7-4640-8a07-fca452a5c376"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"31e98024-87cf-4c43-8d81-27d6afb701c1"}},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"To use the following guide, you must be familiar with ","type":"text"},{"text":"Vortex mechanisms","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Mechanisms","versionAtSave":"10"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985982512"}}]},{"text":", ","type":"text"},{"text":"Vortex Graphics Galleries","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Graphics Galleries","versionAtSave":"3"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985978238"}}]},{"text":", and the ","type":"text"},{"text":"Unreal Editor","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/index.html"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"In the following documentation, you will be able to simulate Vortex mechanisms just like any other assets in an Unreal level.","type":"text"}]},{"type":"paragraph","content":[{"text":"With the Vortex Studio Plugin for Unreal Engine, the Unreal Editor lets you connect to parameters that you expose in Vortex Studio.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":1081679,"__fileMimeType":"image/png","width":1280,"id":"40eef406-b684-49a9-aed0-e3d7d1f36c0f","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-13_11-16-13.png","height":694}}]},{"type":"paragraph","content":[{"text":"Any Vortex Studio simulation parameter can be sent to a function in an Unreal blueprint (get/set) and included in your Unreal level.","type":"text"}]},{"type":"paragraph","content":[{"text":"Vortex Studio automatically detects landscape components that you create in Unreal around a Vortex vehicle. A corresponding height field is created and streamed in Vortex Studio at run time. To monitor contacts and collisions during simulation, you can show the height field at the same time using the Vortex Studio Remote Debugger application.","type":"text"}]},{"type":"paragraph","content":[{"text":"During the simulation, Vortex Studio sends information about the position and orientation of each body to the Unreal Engine. Parameters and outputs can be accessed via the mechanism's interface. To ensure smooth gameplay with accurate synchronization and realistic movements, Vortex Studio sends information about the position and orientation of each body to the Unreal Engine. Parameters and outputs that you expose using a ","type":"text"},{"text":"VHL interface","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Mechanisms","versionAtSave":"10"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985982512"}}]},{"text":" let you control the Mechanism in Unreal.","type":"text"}]},{"type":"paragraph","content":[{"text":"Vortex Studio manages external devices, such as motion platforms and CANopen-compliant devices for controlling vehicles and enriching simulation.","type":"text"}]},{"type":"table","attrs":{"layout":"wide","width":900.0,"localId":"a0207fbd-6cbe-4763-8f93-e20f625342d5"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[450.0]},"content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Getting started...","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Installing the Vortex Studio Plugin","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#Installing-the-Vortex-Studio-Plugin"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Running a Sample Project","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#Running-a-Sample-Project"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Organizing Vortex Studio Assets","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#Organizing-Vortex-Studio-Assets"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Creating Your First Project","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#Creating-Your-First-Project"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Importing Mechanisms into Unreal","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#Importing-Mechanisms-into-Unreal"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enabling Vortex Simulation","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#%5BhardBreak%5DEnabling-Vortex-Simulation"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Packaging Your Project","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#Packaging-Your-Project"}}]},{"text":" ","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[450.0]},"content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"Tell me about...","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Managing the Frame Rate Between Vortex Studio and the Unreal Editor","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#Managing-the-Frame-Rate-Between-Vortex-Studio-and-the-Unreal-Editor"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Vortex Studio Mechanisms Inputs and Outputs","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#Get%2FSet-Vortex-Studio-Mechanism-Inputs-and-Outputs-(IO)"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Using the Vortex Studio Remote Debugger with Unreal","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#Visualizing-the-Vortex-Simulation-for-Debugging-Purposes-Using-the-Vortex-Remote-Debugger"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Supported Colliding Objects in Unreal","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#Supported-Colliding-Objects-in-Unreal"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Mapping Contact Materials","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#Mapping-Contact-Materials"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Viewing Vortex Studio Log Files","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#Viewing-Vortex-Studio-Log-Files-in-the-Unreal-Editor"}}]},{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Limitations","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/spaces/VSD2502/pages/1206515688/Integrating+Vortex+Studio+with+Unreal+Engine#Limitations"}}]},{"text":" ","type":"text"}]}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Installing the Vortex Studio Plugin","type":"text"}]},{"type":"paragraph","content":[{"text":"Installing the Vortex Studio Plugin involves downloading the plugin from the Unreal marketplace and configuring basic parameters.","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"The Vortex Studio plugin for Unreal is compatible with Unreal Engine versions 4.27. Support Unreal Engine 5 will be available soon","type":"text"}]},{"type":"paragraph","content":[{"text":"The Vortex Studio Plugin on the Unreal marketplace is tagged to be compatible with Unreal 4.26. This is expected. The plugin will need to be rebuilt with Unreal 4.27.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"paragraph","content":[{"text":"To use the Vortex Studio for Unreal Engine 4 plugin, you must have Vortex Studio and ","type":"text"},{"text":"Unreal Engine 4.27","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/4.26/en-US/Basics/InstallingUnrealEngine/"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Download the plugin from the ","type":"text"},{"text":"Unreal Marketplace","type":"text","marks":[{"type":"link","attrs":{"href":"https://www.unrealengine.com/marketplace/en-US/slug/vortex-studio"}}]},{"text":" and install it following these steps:","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"IMPORTANT","type":"text"}]},{"type":"paragraph","content":[{"text":"You must have a valid Epic games user account to download the plugin from the Unreal Marketplace.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"To install the Plugin with the Epic Games Launcher","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the ","type":"text"},{"text":"Epic Games Launcher","type":"text","marks":[{"type":"strong"}]},{"text":" and login using your account information.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":748462,"__fileMimeType":"image/png","width":1280,"id":"d309516d-609b-4f1b-a4da-04f8360c9970","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-56-57.png","height":693}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click the ","type":"text"},{"text":"Marketplace","type":"text","marks":[{"type":"strong"}]},{"text":" tab.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"__fileSize":7361,"__fileMimeType":"image/png","width":889,"id":"f203280c-b5fa-4b50-b830-345980e7bcda","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-57-1.png","height":92}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the search bar, type ","type":"text"},{"text":"Vortex","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"The Vortex Studio plugin appears in the list.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":40.0},"content":[{"type":"media","attrs":{"__fileSize":224068,"__fileMimeType":"image/png","width":761,"id":"d973ee51-da5e-4df3-b4e9-64d6df240185","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-57-15.png","height":628}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Vortex Studio","type":"text","marks":[{"type":"strong"}]},{"text":" plugin and click on ","type":"text"},{"text":"Install to Engine","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":297558,"__fileMimeType":"image/png","width":1280,"id":"e81672ce-5f97-4fd3-a682-7f4c140463a5","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-57-20.png","height":693}}]},{"type":"paragraph","content":[{"text":"The Vortex Studio plugin now appears in your Unreal projects","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"To install the Plugin from the 7z File","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the folder ","type":"text"},{"text":"Plugins","type":"text","marks":[{"type":"strong"}]},{"text":" at the following address ","type":"text"},{"text":"\\Engine\\Plugins\\","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If you see a subfolder named ","type":"text"},{"text":"VortexPlugin","type":"text","marks":[{"type":"strong"}]},{"text":" remove it.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy the 7z named ","type":"text"},{"text":"Vortex_Studio_Unreal_Plugin_[ReleaseNumber].7z","type":"text","marks":[{"type":"code"}]},{"text":" into the ","type":"text"},{"text":"Plugins","type":"text","marks":[{"type":"strong"}]},{"text":" folder.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the 7-zip context menu, select Extract Here.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":60.0},"content":[{"type":"media","attrs":{"__fileSize":29180,"__fileMimeType":"image/png","width":774,"id":"9e11274f-fd69-4772-8822-538629da7428","collection":"contentId-3985973576","type":"file","__fileName":"image2021-12-7_13-43-2.png","height":279}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete the 7z file.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"How to rebuild the Vortex Studio Plugin to a later version of Vortex Studio","type":"text"}]},{"type":"paragraph","content":[{"text":"The Vortex Studio Plugin available on the Epic Games Launcher might not match the version of your Vortex Studio installation. It is however possible to update the plugin's version following these steps.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unreal Engine version 4.27: We cannot guarantee that the plugin will work with a version other than these.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Microsoft Visual Studio: In order to compile the code, we recommend having Microsoft Visual Studio 2019 or later.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Vortex Studio: A Vortex Studio installation is mandatory for the update and for the plugin to work with Unreal Engine.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"How to update the plugin step-by-step","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure that you currently have the Vortex Studio plugin from the Marketplace. If you don't, install it from the Marketplace page or from the Vault section of your library if it is there:","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":85.0},"content":[{"type":"media","attrs":{"__fileSize":928950,"__fileMimeType":"image/png","width":1280,"id":"aeeb5578-46f7-46a1-86cf-16e9e8f84baf","collection":"contentId-3985973576","type":"file","__fileName":"image2022-6-8_15-30-32.png","height":875}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open your Windows Explorer and move to the folder where the Vortex Studio plugin was installed. For example, if Epic Games is installed at the default location, the path should be: ","type":"text"},{"text":"C:\\Program Files\\Epic Games\\UE_4.27\\Engine\\Plugins\\Marketplace","type":"text","marks":[{"type":"em"}]},{"text":" ;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Inside the Marketplace folder, copy the folder VortexPlugin and copy it somewhere else such as in your Documents or on the Desktop. The important part is that it isn't inside the Epic Games repository.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In your new location, open the VortexPlugin folder. There, delete both the Binaries and the Intermediate folders. The end result should look like this:","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"__fileSize":22783,"__fileMimeType":"image/png","width":872,"id":"1ba2a6c5-fabc-4186-882a-29efd1b5d247","collection":"contentId-3985973576","type":"file","__fileName":"image2022-6-8_15-40-2.png","height":257}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From there, go in the folder named ","type":"text"},{"text":"\\VortexPlugin\\Source\\ThirdParty\\VortexStudio\\Win64","type":"text","marks":[{"type":"em"}]},{"text":" . This is where we will have to change some files.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open a new Windows Explorer and open your Vortex Studio installation. The path should be ","type":"text"},{"text":"C:\\CM Labs\\Vortex Studio ","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The first step will be to copy and replace the library. In <","type":"text"},{"text":"Vortex Studio Installation>\\lib","type":"text","marks":[{"type":"em"}]},{"text":", copy VortexIntegration.lib and copy it inside ","type":"text"},{"text":"\\VortexPlugin\\Source\\ThirdParty\\VortexStudio\\Win64\\lib","type":"text","marks":[{"type":"em"}]},{"text":". You will have to replace the existing library.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The second step will be to copy the header files. In ","type":"text"},{"text":"\\include\\VortexIntegration","type":"text","marks":[{"type":"em"}]},{"text":", copy all files and move them to ","type":"text"},{"text":"\\VortexPlugin\\Source\\ThirdParty\\VortexStudio\\Win64\\include\\VortexIntegration","type":"text","marks":[{"type":"em"}]},{"text":" . This will replace all files except the one named ","type":"text"},{"text":"Version.h","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Finally, open the file ","type":"text"},{"text":"Version.h","type":"text","marks":[{"type":"em"}]},{"text":" in ","type":"text"},{"text":"\\VortexPlugin\\Source\\ThirdParty\\VortexStudio\\Win64\\include\\VortexIntegration ","type":"text","marks":[{"type":"em"}]},{"text":"and open the file VxVersion.h from ","type":"text"},{"text":"\\include\\Vx","type":"text","marks":[{"type":"em"}]},{"text":". Each field of ","type":"text"},{"text":"Version.h","type":"text","marks":[{"type":"em"}]},{"text":" needs to be replaced to mirror the defined fields of ","type":"text"},{"text":"VxVersion.h","type":"text","marks":[{"type":"em"}]},{"text":":","type":"text"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

","nestedContent":{"type":"doc","content":[{"type":"table","attrs":{"__autoSize":true},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":98.0},"content":[{"type":"media","attrs":{"__fileSize":29532,"__fileMimeType":"image/png","width":700,"id":"af23b01b-8291-42c1-af19-7e0c98bd946f","collection":"contentId-3985973576","type":"file","__fileName":"image2022-6-8_15-58-42.png","height":418}}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":84.0},"content":[{"type":"media","attrs":{"__fileSize":41819,"__fileMimeType":"image/png","width":724,"id":"68427325-f567-4717-b77f-fac1feee1df4","collection":"contentId-3985973576","type":"file","__fileName":"image2022-6-8_15-59-23.png","height":506}}]}]}]}]}],"version":1},"reason":"A table in list item can't be created or edited in the new editor."}}},{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now that the files are updated, we need to compile the plugin. Open a CMD prompt and move to your Unreal Engine install in the batch file folder ","type":"text"},{"text":"C:\\Program Files\\Epic Games\\UE_4.27\\Engine\\Build\\BatchFiles","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From here, run this command and replace the path location with your own:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"shell"},"content":[{"text":"c:\\Users\\username\\Desktop\\vortex>\"C:\\Program Files\\Epic Games\\UE_4.27\\Engine\\Build\\BatchFiles\\RunUAT.bat\" BuildPlugin -Plugin=\"c:\\Users\\username\\Desktop\\vortex\\VortexPlugin\\VortexPlugin.uplugin\"\n-Package=\"C:\\Users\\username\\Desktop\\vortex\\output\" -CreateSubFolder -VS2019","type":"text"}]},{"type":"paragraph","content":[{"text":"Where:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"RunUAT.bat","type":"text","marks":[{"type":"strong"}]},{"text":" is the batch file to run;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"BuildPlugin","type":"text","marks":[{"type":"strong"}]},{"text":" is the action;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"-Plugin","type":"text","marks":[{"type":"strong"}]},{"text":" is the path of the uplugin file from your new plugin folder;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"-Package","type":"text","marks":[{"type":"strong"}]},{"text":" is the output folder where your new plugin will be created. This must be outside the Unreal Engine directory;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"-CreateSubFolder","type":"text","marks":[{"type":"strong"}]},{"text":" is to specify how to create the plugin hierarchy;","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"-VS2019","type":"text","marks":[{"type":"strong"}]},{"text":" is to specify the compiler. This may change depending on your Microsoft Visual Studio installation.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now go back into your Epic Games application and uninstall the Vortex Studio plugin.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy the folder VortexPlugin from your work folder into the plugin repository of Unreal Engine at this location: ","type":"text"},{"text":"C:\\Program Files\\Epic Games\\UE_4.27\\Engine\\Plugins","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"81bf99e4-bb61-4f00-885d-4259a2be2edb","collection":"contentId-3985973576","height":"400"}}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Close and restart Epic Games. You should now be able to use the Vortex Plugin with your current version.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Running a Sample Project","type":"text"}]},{"type":"paragraph","content":[{"text":"For convenience, CM Labs offers a sample project that you can use to understand the different features of the Vortex Studio integration with Unreal. You can also use it as a starting point for your own projects.","type":"text"}]},{"type":"paragraph","content":[{"text":"To download the sample project files do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In a web browser go to ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://u.pcloud.link/publink/show?code=7h3italK#folder=11215238438&tpl=publicfoldergrid"}},{"text":" and navigate to the Vortex version you have installed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To begin the download, click the filename of the sample project: ","type":"text"},{"text":"Vortex_Studio_for_Unreal_Forklift_Sample_[ReleaseNumber].7z","type":"text","marks":[{"type":"code"}]},{"text":" and extract the content on your computer.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the Unreal Engine 4.27 and click the ","type":"text"},{"text":"Launch","type":"text","marks":[{"type":"strong"}]},{"text":" button.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":748462,"__fileMimeType":"image/png","width":1280,"id":"2a98c06c-97de-4b26-b7c7-824a176bb0d3","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-57-25.png","height":693}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Unreal Project Browser, click ","type":"text"},{"text":"Browse","type":"text","marks":[{"type":"strong"}]},{"text":" and navigate to the extracted sample files.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":80.0},"content":[{"type":"media","attrs":{"__fileSize":141546,"__fileMimeType":"image/png","width":1107,"id":"eea86e5b-ca87-42f7-8f3f-faa0506e05c6","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-57-31.png","height":505}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the ","type":"text"},{"text":"ForkliftSim_uproject","type":"text","marks":[{"type":"code"}]},{"text":" file.","type":"text"}]},{"type":"paragraph","content":[{"text":"The project opens in the Unreal Editor.","type":"text"}]},{"type":"paragraph","content":[{"text":"NOTE:","type":"text","marks":[{"type":"strong"}]},{"text":" It can take several minutes for the project and to load for the first time.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":1567353,"__fileMimeType":"image/png","width":1280,"id":"2a598def-5b6e-4bbf-8bfb-1e9ef460eec5","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-57-34.png","height":704}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To start the simulation, press the ","type":"text"},{"text":"Play","type":"text","marks":[{"type":"strong"}]},{"text":" button.","type":"text"}]},{"type":"paragraph","content":[{"text":"You can use a Direct Input game controller to control the forklift.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":1343512,"__fileMimeType":"image/png","width":1280,"id":"60a3287f-ae9b-4529-b969-34bf8133e70a","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-57-39.png","height":693}}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Organizing Vortex Studio Assets","type":"text"}]},{"type":"paragraph","content":[{"text":"This section assumes that you already have a good understanding of ","type":"text","marks":[{"type":"em"}]},{"text":"Vortex Studio Editor Documents","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Vortex Studio Editor Documents","versionAtSave":"1"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985983418"}}]},{"text":".","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"The Vortex Studio plugin lets you import Vortex mechanisms to an Unreal project.","type":"text"}]},{"type":"paragraph","content":[{"text":"To create a valid Unreal project using Vortex Studio, you must copy the Vortex assets you want to use in your new Unreal project under the ","type":"text"},{"text":"Content ","type":"text","marks":[{"type":"code"}]},{"text":"directory for the project. Vortex assets include files with the following formats:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"*.vxmechanism (Mechanism Document)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"*.vxassembly (Assembly Document)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"*.vxgraphicgallery (Graphics Gallery Document)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"*.vxc (Setup Document)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"*.vxmaterials (Material Table)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Example","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example, you have the following folder hierarchy for a Vortex forklift mechanism:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Forklift","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Dynamics","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Forklift.vxmechanism","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Forklift_Assembly.vxassembly","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Graphics","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Forklift2016.vxgraphicgallery","type":"text"}]}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"To build a valid Unreal project, you must move the same folder structure to a sub-folder of the ","type":"text"},{"text":"Content ","type":"text","marks":[{"type":"code"}]},{"text":"folder for your Unreal project. The structure of your Unreal project would appear as follows:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MyProject","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MyProject.uproject","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Config","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"...","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"...","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Content","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Vortex_Mechanisms","type":"text"},{"type":"hardBreak"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Forklift","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Dynamics","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Forklift.vxmechanism","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Forklift_Assembly.vxassembly","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Graphics","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Forklift2016.vxgraphicgallery","type":"text"}]}]}]}]}]}]}]}]}]}]}]}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"It is easier to configure packaging settings for the project when all your Vortex assets exist under single directories in the project Content folder, with other assets that the Unreal Editor does not recognize.","type":"text"}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Creating Your First Project","type":"text"}]},{"type":"paragraph","content":[{"text":"Bringing your first Vortex Studio project into Unreal involves verifying that the plugin is enabled, restarting the application, and verifying settings for the project with the plugin. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"About Vortex Studio Project Settings","type":"text"}]},{"type":"paragraph","content":[{"text":"You can customize several settings for your project in the Unreal Editor from the Project Settings window.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"__fileSize":99343,"__fileMimeType":"image/png","width":1260,"id":"ec35a69a-89a0-43f1-8019-d8bdc04d5d91","collection":"contentId-3985973576","type":"file","__fileName":"UnrealPluginDefaultSettings.png","height":792}}]},{"type":"paragraph","content":[{"text":"Specifically, you can customize the following settings for your project:","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Anytime you change a setting, you must restart the application before they can take effect.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"wide","width":738.0,"localId":"34507523-98ca-444f-81f8-f1a75d812643"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"Category","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Setting Name","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Data Provider's Path","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"This setting is for advanced usage.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Specifies a path (must be under the ","type":"text"},{"text":"Content ","type":"text","marks":[{"type":"code"}]},{"text":"directory for the project) where some simulation data will be stored (for instance, ","type":"text"},{"text":"Control Presets","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"The Control Presets Tab","versionAtSave":"13"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985965850"}}]},{"text":").","type":"text"}]},{"type":"paragraph","content":[{"text":"Default","type":"text","marks":[{"type":"strong"}]},{"text":": None.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":2,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"Application Setup","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Use Default","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"When set to true, the Vortex Studio simulation in the Unreal application uses this default ","type":"text"},{"text":"Application Setup Document","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Simulator Setup User Guide","versionAtSave":"6"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985976538"}}]},{"text":" packaged with Vortex Studio:","type":"text"}]},{"type":"paragraph","content":[{"text":"C:\\CM Labs\\Vortex Studio [ReleaseNumber]\\resources\\config\\VortexIntegration.vxc","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Default","type":"text","marks":[{"type":"strong"}]},{"text":": True.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Custom Application Setup","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"This setting is only used when ","type":"text"},{"text":"Application Setup->Use Default","type":"text","marks":[{"type":"em"}]},{"text":" is false. It allows using a custom ","type":"text"},{"text":"Application Setup Document","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Simulator Setup User Guide","versionAtSave":"6"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985976538"}}]},{"text":" for your Unreal project.","type":"text"}]},{"type":"paragraph","content":[{"text":"It is strongly recommended to use the default Application Setup Document for Vortex integrations as a starting point. ","type":"text","marks":[{"type":"strong"}]},{"text":"The default file is under:","type":"text"}]},{"type":"paragraph","content":[{"text":"C:\\CM Labs\\Vortex Studio [ReleaseNumber]\\resources\\config\\VortexIntegration.vxc","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Your custom ","type":"text","marks":[{"type":"strong"}]},{"text":"Application Setup Document","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Simulator Setup User Guide","versionAtSave":"6"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985976538"}}]},{"text":" must reside under the ","type":"text","marks":[{"type":"strong"}]},{"text":"Content ","type":"text","marks":[{"type":"code"}]},{"text":"folder for the project.","type":"text","marks":[{"type":"strong"}]},{"text":" It should be under a specific sub-folder since it will be needed to package this ","type":"text"},{"text":"Non-Asset","type":"text","marks":[{"type":"em"}]},{"text":" folder when packaging your Unreal project.","type":"text"}]},{"type":"paragraph","content":[{"text":"Default","type":"text","marks":[{"type":"strong"}]},{"text":": None (not used)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":2,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"Material Table","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Use Default","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"When set to true, the Vortex Studio simulation within Unreal will use this default ","type":"text"},{"text":"Material Table","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Contact Materials","versionAtSave":"1"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985971813"}}]},{"text":" packaged with Vortex Studio:","type":"text"}]},{"type":"paragraph","content":[{"text":"C:\\CM Labs\\Vortex Studio [ReleaseNumber]\\resources\\DynamicsMaterials\\default.vxmaterials","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Default","type":"text","marks":[{"type":"strong"}]},{"text":": True","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Custom Material Table","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"This setting is only used when ","type":"text"},{"text":"Material Table->Use Default","type":"text","marks":[{"type":"em"}]},{"text":" is false. It lets you specify a custom ","type":"text"},{"text":"Material Table","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Contact Materials","versionAtSave":"1"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985971813"}}]},{"text":" for your Unreal project.","type":"text"}]},{"type":"paragraph","content":[{"text":"It is strongly recommended that you use the default Material Table for Vortex Studio integrations as a starting point. ","type":"text","marks":[{"type":"strong"}]},{"text":"The default file is under:","type":"text"}]},{"type":"paragraph","content":[{"text":"C:\\CM Labs\\Vortex Studio [ReleaseNumber]\\resources\\DynamicsMaterials\\default.vxmaterials","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Your custom ","type":"text","marks":[{"type":"strong"}]},{"text":"Material Table","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Contact Materials","versionAtSave":"1"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985971813"}}]},{"text":" must exist under the ","type":"text","marks":[{"type":"strong"}]},{"text":"Content ","type":"text","marks":[{"type":"code"}]},{"text":"folder for your project.","type":"text","marks":[{"type":"strong"}]},{"text":" It must exist under a specific sub-folder since the application uses it to package this ","type":"text"},{"text":"Non-Asset ","type":"text","marks":[{"type":"code"}]},{"text":"folder when packaging your Unreal project.","type":"text"}]},{"type":"paragraph","content":[{"text":"Default","type":"text","marks":[{"type":"strong"}]},{"text":": None (not used)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":4,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"Static Collision","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"type":"hardBreak"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Enable Landscape Collision Detection","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"If true, ","type":"text"},{"text":"Unreal Landscapes","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/Engine/Landscape/index.html"}}]},{"text":" will be transferred to Vortex Studio at runtime, using the underlying Vortex terrain paging system, so your mechanisms can collide with them.","type":"text"}]},{"type":"paragraph","content":[{"text":"For additional parameters that allow tuning the performance of the terrain paging system, please see the Static Collision → Terrain Paging category below.","type":"text"}]},{"type":"paragraph","content":[{"text":"Default","type":"text","marks":[{"type":"strong"}]},{"text":": True","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Enable Mesh Simple Collision Detection","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"If true, ","type":"text"},{"text":"Collision On a Simple Shaped Mesh","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/Engine/Content/Types/StaticMeshes/HowTo/SettingCollision/index.html"}}]},{"text":" for all ","type":"text"},{"text":"Unreal Static Meshes","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/Engine/Content/Types/StaticMeshes/index.html"}}]},{"text":" will be transferred to Vortex Studio at runtime, using the underlying Vortex terrain paging system, so your mechanisms can interact with them.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that Vortex Studio always uses the colliding geometry (simple or complex) that PhysX would use in Unreal.","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"For additional parameters that allow tuning the performance of the terrain paging system, please see the Static Collision → Terrain Paging category below.","type":"text"}]},{"type":"paragraph","content":[{"text":"Default","type":"text","marks":[{"type":"strong"}]},{"text":": True","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Enable Mesh Complex Collision Detection","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"If true, ","type":"text"},{"text":"Collision On a More Complex Mesh","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/Engine/Content/Types/StaticMeshes/HowTo/SettingCollision/index.html"}}]},{"text":" for all ","type":"text"},{"text":"Unreal Static Meshes","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/Engine/Content/Types/StaticMeshes/index.html"}}]},{"text":" will be transferred to Vortex Studio at runtime, using the underlying Vortex terrain paging system, so your mechanisms can interact with them.","type":"text"}]},{"type":"paragraph","content":[{"text":"Note that Vortex Studio always uses the colliding geometry (simple or complex) that PhysX would use in Unreal.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"For additional parameters that allow tuning the performance of the terrain paging system, please see the Static Collision → Terrain Paging category below.","type":"text"}]},{"type":"paragraph","content":[{"text":"Default","type":"text","marks":[{"type":"strong"}]},{"text":": True","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Material Mappings","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"Allows associating an ","type":"text"},{"text":"Unreal Physical Material","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/Engine/Physics/PhysicalMaterials/index.html"}}]},{"text":" to a ","type":"text"},{"text":"Vortex Contact Material","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Contact Materials","versionAtSave":"1"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985971813"}}]},{"text":" by name. This lets you specify which contact material a Vortex collision uses for computation purposes. The application only uses these associations when at least one of the following settings is enabled:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enable Landscape Collision Detection","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enable Mesh Simple Collision Detection","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enable Mesh Complex Collision Detection","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Default","type":"text","marks":[{"type":"strong"}]},{"text":": None.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":3,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"Static Collision → Terrain Paging Landscape","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Tile Size XY","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"Size in meters, in world X and Y direction, of the square tiles used by the landscape terrain pager for landscape collision queries and caching.","type":"text"},{"type":"hardBreak"},{"text":"Landscape component will be queried by the terrain pager in tiles of the given size around the dynamically moving Vortex mechanisms.","type":"text"},{"type":"hardBreak"},{"text":"Tiles will be cached and only queried again if not already present in the cache in order to reduce query time, and in order to produce consistent, non-duplicate collision geometries in the Vortex simulation when multiple moving objects are operating in close proximity.","type":"text"}]},{"type":"paragraph","content":[{"text":"Use Tile Size XY value around the Landscape Component size for better results.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"For more information on this parameter and the terrain paging system underlying the Unreal integration, refer to ","type":"text"},{"text":"Integrating Vortex Studio using the VortexIntegration API","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Integrating Vortex Studio using the VortexIntegration API","versionAtSave":"2"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985975946"}}]},{"text":".","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Default:","type":"text","marks":[{"type":"strong"}]},{"text":" 50 meters","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Look Ahead Time","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies the time, in simulation seconds, the terrain pager should forecast ahead. All the terrain to be reached within the specified time, at the current velocity, will be requested.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the terrain paging system experiences slow downs when navigating, consider reducing this parameter.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"For more information on this parameter and the terrain paging system underlying the Unreal integration, refer to ","type":"text"},{"text":"Integrating Vortex Studio using the VortexIntegration API","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Integrating Vortex Studio using the VortexIntegration API","versionAtSave":"2"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985975946"}}]},{"text":".","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Default:","type":"text","marks":[{"type":"strong"}]},{"text":" 1 second","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Safety Band Size","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies the distance (in meters) to grow the paged region by, as a safety band, in order to account for objects changing direction.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the terrain paging system experiences slow downs when navigating, consider reducing this parameter.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"For more information on this parameter and the terrain paging system underlying the Unreal integration, refer to ","type":"text"},{"text":"Integrating Vortex Studio using the VortexIntegration API","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Integrating Vortex Studio using the VortexIntegration API","versionAtSave":"2"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985975946"}}]},{"text":".","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Default:","type":"text","marks":[{"type":"strong"}]},{"text":" 1 meter","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":3,"colwidth":[91.0]},"content":[{"type":"paragraph","content":[{"text":"Static Collision → Terrain Paging Mesh","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Tile Size XY","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"Size in meters, in world X and Y direction, of the square tiles used by the terrain pager for Mesh collision queries and caching.","type":"text"},{"type":"hardBreak"},{"text":"Terrain will be queried by the terrain pager in tiles of the given size around the dynamically moving Vortex mechanisms.","type":"text"},{"type":"hardBreak"},{"text":"Tiles will be cached and only queried again if not already present in the cache in order to reduce query time, and in order to produce consistent, non-duplicate collision geometries in the Vortex simulation when multiple moving objects are operating in close proximity.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the terrain paging system experiences slow downs when navigating on a complex terrain with many obstacles (e.g., trees) consider reducing this parameter.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"Note that a too drastic reduction (e.g., a value of 1 meter) can in itself lead to slowdowns. A balance can be found through experimentation.","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"paragraph","content":[{"text":"For more information on this parameter and the terrain paging system underlying the Unreal integration, refer to ","type":"text"},{"text":"Integrating Vortex Studio using the VortexIntegration API","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Integrating Vortex Studio using the VortexIntegration API","versionAtSave":"2"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985975946"}}]},{"text":".","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Default:","type":"text","marks":[{"type":"strong"}]},{"text":" 50 meters","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Look Ahead Time","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies the time, in simulation seconds, the terrain pager should forecast ahead. All the terrain to be reached within the specified time, at the current velocity, will be requested.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the terrain paging system experiences slow downs when navigating on a complex terrain with many obstacles (e.g., trees) consider reducing this parameter.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"For more information on this parameter and the terrain paging system underlying the Unreal integration, refer to ","type":"text"},{"text":"Integrating Vortex Studio using the VortexIntegration API","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Integrating Vortex Studio using the VortexIntegration API","versionAtSave":"2"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985975946"}}]},{"text":".","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Default:","type":"text","marks":[{"type":"strong"}]},{"text":" 1 second","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[97.0]},"content":[{"type":"paragraph","content":[{"text":"Safety Band Size","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[550.0]},"content":[{"type":"paragraph","content":[{"text":"Specifies the distance (in meters) to grow the paged region by, as a safety band, in order to account for objects changing direction.","type":"text"}]},{"type":"paragraph","content":[{"text":"If the terrain paging system experiences slow downs when navigating on a complex terrain with many obstacles (e.g., trees) consider reducing this parameter.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"For more information on this parameter and the terrain paging system underlying the Unreal integration, refer to ","type":"text"},{"text":"Integrating Vortex Studio using the VortexIntegration API","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Integrating Vortex Studio using the VortexIntegration API","versionAtSave":"2"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985975946"}}]},{"text":".","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Default:","type":"text","marks":[{"type":"strong"}]},{"text":" 1 meter","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"To Create a New Unreal Project Using the Vortex Studio Plugin","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the Unreal Engine 4.27 and click the ","type":"text"},{"text":"Launch","type":"text","marks":[{"type":"strong"}]},{"text":" button.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":748462,"__fileMimeType":"image/png","width":1280,"id":"922efd78-13e8-4c80-90ab-4661aa373f1c","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-57-53.png","height":693}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Unreal Editor, ","type":"text"},{"text":"follow steps in Unreal documentation","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/Engine/Basics/Projects/Browser/index.html"}}]},{"text":" to create a new project.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"__fileSize":541295,"__fileMimeType":"image/gif","width":1101,"id":"f14887d9-35bd-4529-a261-c45eed91866c","collection":"contentId-3985973576","type":"file","__fileName":"newproject.gif","height":759}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the upper left, click ","type":"text"},{"text":"Edit","type":"text","marks":[{"type":"strong"}]},{"text":" and then click ","type":"text"},{"text":"Plugins","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":25.0},"content":[{"type":"media","attrs":{"__fileSize":27269,"__fileMimeType":"image/png","width":226,"id":"f11b95bd-4418-47d0-bb54-9563ac5bd130","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-58-7.png","height":300}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Confirm that the Vortex Studio plugin is installed.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"__fileSize":109539,"__fileMimeType":"image/png","width":1280,"id":"0ef451e1-3120-4fcb-a789-e176b9bd306f","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-58-12.png","height":806}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To enable the plugin, click to select ","type":"text"},{"text":"Enabled.","type":"text","marks":[{"type":"strong"}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":3558210,"__fileMimeType":"image/gif","width":1907,"id":"d867135f-2638-46e0-bd9a-b1520fbe91c9","collection":"contentId-3985973576","type":"file","__fileName":"VortexStudioPluginEnable.gif","height":1006}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the lower right, click","type":"text"},{"text":" Restart Now.","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The project re-opens with the Vortex Studio plugin enabled.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save the project to permanently enable the plugin.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Managing the Frame Rate Between Vortex Studio and the Unreal Editor","type":"text"}]},{"type":"paragraph","content":[{"text":"By default, new Unreal projects use a variable frame rate. The Vortex Studio integration in Unreal Engine uses a fixed frame rate of 60 Hz. If you do not change the default settings, the simulation will run at unrealistic speeds.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"IMPORTANT","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"To maintain fidelity and realism in the simulation, you must configure project settings so that Unreal Engine and Vortex Studio both use a fixed frame rate.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Example: Setting the Frame Rate in Vortex Studio and the Unreal Engine","type":"text"}]},{"type":"paragraph","content":[{"text":"In this example, you want a simulation to run at 90 Hz.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"To set the Frame Rate in the Unreal Editor, do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Unreal Editor, open your project.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Edit","type":"text","marks":[{"type":"strong"}]},{"text":" and then click ","type":"text"},{"text":"Project Settings","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"__fileSize":117140,"__fileMimeType":"image/png","width":585,"id":"527e82be-20d1-427d-8b02-511765701b75","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-58-26.png","height":420}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Project Settings window, under the ","type":"text"},{"text":"Engine","type":"text","marks":[{"type":"em"}]},{"text":" section, click ","type":"text"},{"text":"General Settings","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"__fileSize":130584,"__fileMimeType":"image/png","width":1280,"id":"42813af7-7e74-420c-8519-60e61076e27c","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-58-38.png","height":805}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Scroll down to the ","type":"text"},{"text":"Framerate","type":"text","marks":[{"type":"em"}]},{"text":" section and do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click to select the ","type":"text"},{"text":"Use Fixed Frame Rate","type":"text","marks":[{"type":"strong"}]},{"text":" checkbox.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Fixed Frame Rate","type":"text","marks":[{"type":"strong"}]},{"text":" field, specify ","type":"text"},{"text":"90.00","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"__fileSize":119699,"__fileMimeType":"image/png","width":1280,"id":"6d009357-ff4f-4c99-9b74-0c233208c1c7","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-58-43.png","height":804}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save the settings and restart the project.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"To set the Frame Rate in the Vortex Studio Editor, do the following:","type":"text"}]},{"type":"paragraph","content":[{"text":"Prerequisite: You must have a custom ","type":"text"},{"text":"Simulator Setup User Guide","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Simulator Setup User Guide","versionAtSave":"6"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985976538"}}]},{"text":" (not the default one provided with Vortex Studio). For more information, see ","type":"text"},{"text":"Integrating Vortex Studio with Unreal Engine#About Vortex Studio Project Settings","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=19071453#IntegratingVortexStudiowithUnrealEngine-AboutVortexStudioProjectSettings"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Make sure the custom application setup document is saved in the ","type":"text"},{"text":"Content ","type":"text","marks":[{"type":"code"}]},{"text":"directory of your Unreal project.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Vortex Studio Editor, open the custom Application Setup Document for this project.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Explorer","type":"text","marks":[{"type":"em"}]},{"text":" panel, click ","type":"text"},{"text":"Setup","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":91042,"__fileMimeType":"image/png","width":1280,"id":"6564a568-e357-4289-96eb-1d449f698b55","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-58-47.png","height":692}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the right of screen, in the ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"em"}]},{"text":" panel, set the ","type":"text"},{"text":"Simulation Frame Rate","type":"text","marks":[{"type":"strong"}]},{"text":" value to ","type":"text"},{"text":"90.00","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":92162,"__fileMimeType":"image/png","width":1280,"id":"cde73d43-d477-45f1-bca5-8581f548d882","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-58-55.png","height":688}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To save your changes, click the Save button.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":75.0},"content":[{"type":"media","attrs":{"__fileSize":8484,"__fileMimeType":"image/png","width":543,"id":"e59ac221-8ed0-4dbb-9c03-821f8a81b65c","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-58-59.png","height":106}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When you restart the Unreal Editor, validate that the settings have been correctly configured.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Importing Mechanisms into Unreal","type":"text"}]},{"type":"paragraph","content":[{"text":"When you import a mechanism from Vortex Studio to the Unreal editor, the application identifies all Graphics Galleries (.vxgraphicgallery) in the mechanism file (.vxmechanism). The application imports all textures, materials, and meshes from the galleries as standard Unreal assets in the directory you specify.","type":"text"}]},{"type":"paragraph","content":[{"text":"Unreal creates a new Actor blueprint subclass to represent the Vortex Studio mechanism. You can use the new blueprint class to instantiate your Vortex Studio mechanism in an Unreal map. The class accomplishes the following things:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It replicates the Vortex Studio graphics node hierarchy using the imported graphics galleries and uses it to create a hierarchy of corresponding Unreal Scene and Static Mesh components.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":582198,"__fileMimeType":"image/png","width":1280,"id":"c3e6fd1e-38aa-4f9d-a74e-664325e9f285","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-59-2.png","height":691}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It automatically updates the position and orientation of relevant Unreal Scene and Static Mesh components when Vortex Studio parts are moving.","type":"text"}]},{"type":"paragraph","content":[{"text":"When a Vortex Studio part moves, the blueprint analyzes connections between parts and graphics nodes in Vortex Studio (typically under the Skin connection container) to detect which components move.","type":"text"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

The Unreal Editor does not expose the automatic mapping which occurs.

","nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The Unreal Editor does not expose the automatic mapping which occurs.","type":"text"}]}]}],"version":1},"reason":"An info macro in a list item can't be created or edited in the new editor."}}},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

The Skin connection container and all relevant graphic nodes in Vortex Studio are required for the integration and must not be deleted.

","nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"The Skin connection container and all relevant graphic nodes in Vortex Studio are required for the integration and must not be deleted.","type":"text"}]}]}],"version":1},"reason":"An info macro in a list item can't be created or edited in the new editor."}}},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":348162,"__fileMimeType":"image/png","width":1280,"id":"e52b340a-1e3d-4841-813e-616a13e3e0cd","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-59-7.png","height":696}}]}]}]},{"type":"paragraph","content":[{"text":"Importing a Vortex Studio mechanism into Unreal involves preparing your Vortex Studio project, specifying project settings in the Unreal Editor, and creating a new project blueprint.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Preparing your Vortex Studio Project for Import","type":"text"}]},{"type":"paragraph","content":[{"text":"When you import a mechanism from Vortex Studio, Unreal creates a version of each material in the Graphics Gallery. Each material that Unreal creates becomes a material instance of \"BaseGraphicsMaterial\". This material uses a single texture, the first albedo texture defined in the original material, and configures it to use UV set 0. The material instance uses no other textures or material inputs (such as Emission, Occlusion, Specular, or Gloss). Unreal imports every texture currently in the Graphics Gallery.","type":"text"}]},{"type":"paragraph","content":[{"text":"After you import a mechanism for Vortex Studio to the Unreal Editor, you can modify the graphics gallery contents and the Unreal Editor will automatically update behavior in your project there. Renaming any meshes in Unreal Editor breaks the related Unreal mesh <=> graphics node mapping. If a name changes, you must rename the mesh in Unreal Editor to the name it had when you imported the project.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"To Import a Mechanism from Vortex Studio to the Unreal Editor","type":"text"}]},{"type":"paragraph","content":[{"text":"To add Vortex Studio mechanism to your Unreal project, do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure your Vortex Studio assets are ","type":"text"},{"text":"correctly organized","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=19071453#IntegratingVortexStudiowithUnrealEngine-OrganizingVortexStudioAssets"}}]},{"text":" in the Content folder for your Unreal project.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Unreal Editor, select the directory in the ","type":"text"},{"text":"Content Browser","type":"text","marks":[{"type":"em"}]},{"text":" where you will import your Vortex mechanism, including textures, material instances static meshes, and a VortexMechanism Unreal asset.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Option 1:","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Drag and drop the .vxmechanism file you want to import from ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Windows Explorer","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":" into the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Content Browser","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A pop-up window for selecting a folder appears","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After selecting a folder to save the generated blueprint, the application imports the mechanism.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Option 2","type":"text","marks":[{"type":"strong"}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Right-click on the directory in the ","type":"text"},{"text":"Content Browser","type":"text","marks":[{"type":"em"}]},{"text":" and then click ","type":"text"},{"text":"Import to /Game/...","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":746492,"__fileMimeType":"image/png","width":1280,"id":"cbc735b0-4285-457d-a208-a6366bdbe7f8","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-59-11.png","height":674}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A pop-up window for selecting a folder appears.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the .vxmechanism file you want to import and click ","type":"text"},{"text":"Open","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The application imports the mechanism and generates a blueprint.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select a folder for the new blueprint class and then click ","type":"text"},{"text":"OK","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":602833,"__fileMimeType":"image/png","width":1280,"id":"c5ebff76-c338-4e49-b8d9-14e2bf1e2255","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-59-17.png","height":674}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Drag-and-drop the generated mechanism blueprint from the ","type":"text"},{"text":"Content Browser","type":"text","marks":[{"type":"em"}]},{"text":" into the viewport.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"__fileSize":26755,"__fileMimeType":"image/png","width":372,"id":"0f3f0c04-8ac4-47a3-bf3d-5752b3b1a0b5","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-59-20.png","height":259}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":1081679,"__fileMimeType":"image/png","width":1280,"id":"fef71ce4-fd72-4829-be3a-5d8f52b52392","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-59-24.png","height":694}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can open the blueprint to get or set additional values from Vortex Studio. The blueprint appears empty while the application maps the meshes and transforms from Vortex.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":776958,"__fileMimeType":"image/png","width":1280,"id":"db1bb180-dd3f-4a06-86c6-5b034b95e05d","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-59-28.png","height":693}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":269777,"__fileMimeType":"image/png","width":1280,"id":"44048a92-2828-4b01-9599-3736004e16c5","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-59-31.png","height":688}}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"(Optional) To Take Control of the New Actor","type":"text"}]},{"type":"paragraph","content":[{"text":"To take control of the new Actor in Unreal, do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Blueprint Editor for your new Actor, on the toolbar click ","type":"text"},{"text":"File","type":"text","marks":[{"type":"strong"}]},{"text":" and then click ","type":"text"},{"text":"Reparent Blueprint","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":264054,"__fileMimeType":"image/png","width":1280,"id":"b8da0424-98ca-4441-8593-00ae996d54ff","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_20-59-36.png","height":693}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Reparent Blueprint","type":"text","marks":[{"type":"em"}]},{"text":" list, search for ","type":"text"},{"text":"Pawn ","type":"text","marks":[{"type":"code"}]},{"text":"and then click to select it.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":294759,"__fileMimeType":"image/png","width":1280,"id":"943df2d7-dd16-4768-b2a2-1c08fe09fece","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-0-3.png","height":691}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":276368,"__fileMimeType":"image/png","width":1280,"id":"2b12a1c8-cf49-4db2-bf95-a307daa6381e","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-0-6.png","height":692}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To verify the new parent class for your blueprint, use the mouse to hover over the root element of the ","type":"text"},{"text":"Components","type":"text","marks":[{"type":"em"}]},{"text":" panel.","type":"text"}]},{"type":"paragraph","content":[{"text":"The parent class of the blueprint is now ","type":"text"},{"text":"Pawn","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":278359,"__fileMimeType":"image/png","width":1280,"id":"5fe8e9da-23e4-489f-a3e9-331cbfe3709f","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-0-11.png","height":691}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To add a camera to the blueprint, click the ","type":"text"},{"text":"+Add Component","type":"text","marks":[{"type":"strong"}]},{"text":" button and select the camera you want to add from the menu.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":281164,"__fileMimeType":"image/png","width":1280,"id":"a071b8e9-a4a0-4eed-af59-64672764327e","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-0-14.png","height":694}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Compile","type":"text","marks":[{"type":"strong"}]},{"text":" and then click ","type":"text"},{"text":"Save","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":274235,"__fileMimeType":"image/png","width":1280,"id":"888a16e5-2e88-4ad2-b3ca-2864f14e9848","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-0-19.png","height":690}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Components","type":"text","marks":[{"type":"em"}]},{"text":" panel, click to select the new camera. Then, switch the center view to ","type":"text"},{"text":"Viewport","type":"text","marks":[{"type":"strong"}]},{"text":" and use manipulators to move your camera to the correct location.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":703188,"__fileMimeType":"image/png","width":1280,"id":"1bd4bdf5-fb39-4836-b01a-221ef63aebb8","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-0-23.png","height":690}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When the camera is added and in the correct position, in the ","type":"text"},{"text":"Components","type":"text","marks":[{"type":"em"}]},{"text":" panel, click select the root element (the ","type":"text"},{"text":"self","type":"text","marks":[{"type":"strong"}]},{"text":" element).","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":281768,"__fileMimeType":"image/png","width":1280,"id":"0065513b-90ab-4c02-8bc1-5be13ad251a1","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-0-29.png","height":694}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On the right of the screen, in the ","type":"text"},{"text":"Details","type":"text","marks":[{"type":"em"}]},{"text":" panel, scroll down to the ","type":"text"},{"text":"Pawn","type":"text","marks":[{"type":"strong"}]},{"text":" category and assign ","type":"text"},{"text":"Auto Possess Player","type":"text","marks":[{"type":"strong"}]},{"text":" to a valid player ID. For example, ","type":"text"},{"text":"Player 0","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":274235,"__fileMimeType":"image/png","width":1280,"id":"32caccba-ab39-4c62-8a67-59887adb02a6","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-0-31.png","height":690}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Compile and save the blueprint.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the main window of the project, click the ","type":"text"},{"text":"Save Current","type":"text","marks":[{"type":"strong"}]},{"text":" button.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":761725,"__fileMimeType":"image/png","width":1280,"id":"c41266a9-c01b-45c6-a212-8e184dce7b7d","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-0-50.png","height":693}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now, because the Pawn blueprint is automatically possessed when the simulation begins, the 3D view should automatically display what the Blueprint camera sees when you press the ","type":"text"},{"text":"Play","type":"text","marks":[{"type":"strong"}]},{"text":" button.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":809084,"__fileMimeType":"image/png","width":1280,"id":"6c0bc222-f26d-4b6a-94f0-1612fa8e5c6e","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-0-55.png","height":695}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":834355,"__fileMimeType":"image/png","width":1280,"id":"27063b0f-0930-4df4-ace1-7d1757e5e7bf","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-0-58.png","height":692}}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"type":"hardBreak"},{"text":"Enabling Vortex Simulation","type":"text"}]},{"type":"paragraph","content":[{"text":"For simulation with Vortex content to function correctly, your Unreal ","type":"text"},{"text":"Level Blueprint","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/4.26/en-US/ProgrammingAndScripting/Blueprints/UserGuide/Types/LevelBlueprint/"}}]},{"text":" must include functions to start and stop Vortex simulation in the context of your Unreal gameplay.","type":"text"}]},{"type":"paragraph","content":[{"text":"To add these functions, do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open your Level Blueprint:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":725908,"__fileMimeType":"image/png","width":1280,"id":"02ed761b-5789-4555-8a93-37e1576b0f02","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-1-3.png","height":692}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Event Graph","type":"text","marks":[{"type":"strong"}]},{"text":", find the EventBeginGameplay item.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the EventGameplay item, use the left mouse button to click the ","type":"text"},{"text":"Exec","type":"text","marks":[{"type":"em"}]},{"text":" icon and drag it to the right and then release the mouse button.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":185536,"__fileMimeType":"image/png","width":1280,"id":"23e8892b-81e2-4d5d-a46b-1b0aa73a89ef","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-1-6.png","height":694}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":194071,"__fileMimeType":"image/png","width":1280,"id":"9f7aa6f4-8ff6-4dee-8ad8-cd56afdb3526","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-1-9.png","height":693}}]},{"type":"paragraph","content":[{"text":"A pop-up window for adding a function appears","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the pop-up window, scroll to the ","type":"text"},{"text":"Vortex","type":"text","marks":[{"type":"strong"}]},{"text":" →","type":"text"},{"text":"Application","type":"text","marks":[{"type":"strong"}]},{"text":" category and click ","type":"text"},{"text":"Start Simulation","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":197606,"__fileMimeType":"image/png","width":1280,"id":"ff9114ea-12aa-49c6-b712-7242a2b99e42","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-1-16.png","height":692}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":162039,"__fileMimeType":"image/png","width":1280,"id":"b7ce8fb6-3cbf-436f-98ba-6ec2d86bb140","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-1-18.png","height":693}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the ","type":"text"},{"text":"Event Graph","type":"text","marks":[{"type":"em"}]},{"text":" area, right-click anywhere on the empty space (not on a node).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the search bar of the blueprint actions pop-up window that appears, type ","type":"text"},{"text":"end play","type":"text","marks":[{"type":"code"}]},{"text":" and then select the search result ","type":"text"},{"text":"Event End Play","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":204020,"__fileMimeType":"image/png","width":1280,"id":"14c812c0-5793-4f81-94ac-9870ed640855","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-1-21.png","height":692}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Use the same process to add a ","type":"text"},{"text":"Stop Simulation","type":"text","marks":[{"type":"strong"}]},{"text":" function. Click the Exec icon on the new ","type":"text"},{"text":"Event End Play","type":"text","marks":[{"type":"em"}]},{"text":" and drag it right before you release the mouse button. Then, add the ","type":"text"},{"text":"Stop Simulation ","type":"text","marks":[{"type":"strong"}]},{"text":"function.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":185864,"__fileMimeType":"image/png","width":1280,"id":"58f9a267-b43b-41d1-b703-8ce0bfcfdc22","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-1-26.png","height":693}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Compile and save the Level Blueprint.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To save your map, press the ","type":"text"},{"text":"Save Current","type":"text","marks":[{"type":"strong"}]},{"text":" button in the main Unreal Editor interface.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":182766,"__fileMimeType":"image/png","width":1280,"id":"ae39407a-c90e-4564-9887-e41385018186","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-1-29.png","height":692}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":761725,"__fileMimeType":"image/png","width":1280,"id":"31cdd225-ef60-474b-b6e6-bd647c14ee47","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-1-32.png","height":693}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

To make sure that the Vortex simulation can start correctly, always press the Save Current button before you press Play. This of course will also save to disk any changes to your map.

","nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"To make sure that the Vortex simulation can start correctly, always press the","type":"text"},{"text":" ","type":"text"},{"text":"Save Current","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"button before you press","type":"text"},{"text":" ","type":"text"},{"text":"Play","type":"text","marks":[{"type":"strong"}]},{"text":". This of course will also save to disk any changes to your map.","type":"text"}]}]}],"version":1},"reason":"An info macro in a list item can't be created or edited in the new editor."}}},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"extension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

You can call the Start Simulation and Stop Simulation functions at any time, but you must make sure the Vortex simulation has completely stopped when you stop the Unreal simulation. All Vortex mechanisms must be loaded when the Vortex simulation is not running.

","nestedContent":{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"},{"text":"You can call the","type":"text"},{"text":" ","type":"text"},{"text":"Start Simulation","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"and","type":"text"},{"text":" ","type":"text"},{"text":"Stop Simulation","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"functions at any time, but you must make sure the Vortex simulation has completely stopped when you stop the Unreal simulation. All Vortex mechanisms must be loaded when the Vortex simulation is not running.","type":"text"}]}]}],"version":1},"reason":"An info macro in a list item can't be created or edited in the new editor."}}},{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Get/Set Vortex Studio Mechanism Inputs and Outputs (IO)","type":"text"}]},{"type":"paragraph","content":[{"text":"After you import Vortex mechanisms to an Unreal project, you must get/set Vortex mechanism inputs and outputs (IO) from the Unreal simulation.","type":"text"}]},{"type":"paragraph","content":[{"text":"Available IO for mechanisms are defined by the following mechanism interfaces:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VHL Interfaces","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Mechanisms","versionAtSave":"10"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985982512"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Control Interfaces","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Control Interface","versionAtSave":"1"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985973495"}}]}]}]}]},{"type":"paragraph","content":[{"text":"Outputs from these interfaces can be read from Unreal, while inputs can be set with new values from the Unreal simulation.","type":"text"}]},{"type":"paragraph","content":[{"text":"For this purpose, a set of useful ","type":"text"},{"text":"blueprint","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/Engine/Blueprints/Overview/index.html"}}]},{"text":" functions are exposed by the Vortex Studio plugin. To quickly find them, type ","type":"text"},{"text":"VHL ","type":"text","marks":[{"type":"code"}]},{"text":"in the action search bar:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":244445,"__fileMimeType":"image/png","width":1280,"id":"56bc82bd-0ecd-4ddd-860f-b9f427000d80","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-1-37.png","height":692}}]},{"type":"paragraph","content":[{"text":"Each function must have a ","type":"text"},{"text":"Mechanism Component","type":"text","marks":[{"type":"strong"}]},{"text":" as a target. This component is automatically created under the blueprint class created when you import a Vortex mechanism (see ","type":"text"},{"text":"Integrating Vortex Studio with Unreal Engine#Importing Mechanisms into Unreal","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/pages/resumedraft.action?draftId=19071453#IntegratingVortexStudiowithUnrealEngine-ImportingMechanismsintoUnreal"}}]},{"text":").","type":"text"}]},{"type":"paragraph","content":[{"text":"The following functions are available to you:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"6e444313-7f26-4eb9-bf80-b57f07c7e7b8"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Blueprint Function","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":2,"rowspan":1},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"From Vortex to Unreal","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Get VHLField as Bool","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL/Control interface's output field on the target mechanism. This function assumes the desired field is a boolean field and will return its value as a bool.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Get VHLField as Float","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL/Control interface's output field on the target mechanism. This function assumes the desired field is a double field and will return its value as a float.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Get VHLField as Integer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL/Control interface's output field on the target mechanism. This function assumes the desired field is an integer field and will return its value as an int32.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Get VHLField as String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL's output field on the target mechanism. This function assumes the desired field is a string field and will return its value as an ","type":"text"},{"text":"FString","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/API/Runtime/Core/Containers/FString/index.html"}}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Get VHLField as Transform","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL's output field on the target mechanism. This function assumes the desired field is a Matrix44 field and will return its value as an ","type":"text"},{"text":"FTransform","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/API/Runtime/Core/Math/FTransform/index.html"}}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Get VHLField as Vector 2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL's output field on the target mechanism. This function assumes the desired field is a Vector2 field and will return its value as an ","type":"text"},{"text":"FVector2D","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/API/Runtime/Core/Math/FVector2D/index.html"}}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Get VHLField as Vector 3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL's output field on the target mechanism. This function assumes the desired field is a Vector3 field and will return its value as an ","type":"text"},{"text":"FVector","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/API/Runtime/Core/Math/FVector/index.html"}}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Get VHLField as Vector 4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL's output field on the target mechanism. This function assumes the desired field is a Vector4 field and will return its value as an ","type":"text"},{"text":"FVector4","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/API/Runtime/Core/Math/FVector4/index.html"}}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":2,"rowspan":1},"content":[{"type":"paragraph","marks":[{"type":"alignment","attrs":{"align":"center"}}],"content":[{"text":"From Unreal to Vortex","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Set VHLField as Bool","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL/Control interface's input field on the target mechanism. This function assumes the desired field is a boolean field and will set its value from a bool.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Set VHLField as Float","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL/Control interface's input field on the target mechanism. This function assumes the desired field is a double field and will set its value from a float.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Set VHLField as Integer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL/Control interface's input field on the target mechanism. This function assumes the desired field is an integer field and will set its value from an int32.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Set VHLField as String","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL/Control interface's input field on the target mechanism. This function assumes the desired field is a string field and will set its value from an ","type":"text"},{"text":"FString","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/API/Runtime/Core/Containers/FString/index.html"}}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Set VHLField as Transform","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL/Control interface's input field on the target mechanism. This function assumes the desired field is a Matrix44 field and will set its value from an ","type":"text"},{"text":"FTransform","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/API/Runtime/Core/Math/FTransform/index.html"}}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Set VHLField as Vector 2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL/Control interface's input field on the target mechanism. This function assumes the desired field is a Vector2 field and will set its value from an ","type":"text"},{"text":"FVector2D","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/API/Runtime/Core/Math/FVector2D/index.html"}}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Set VHLField as Vector 3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL/Control interface's input field on the target mechanism. This function assumes the desired field is a Vector3 field and will set its value from an ","type":"text"},{"text":"FVector","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/API/Runtime/Core/Math/FVector/index.html"}}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Set VHLField as Vector 4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Allows to search for a specific VHL/Control interface's input field on the target mechanism. This function assumes the desired field is a Vector4 field and will set its value from an ","type":"text"},{"text":"FVector4","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/API/Runtime/Core/Math/FVector4/index.html"}}]},{"text":".","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Additional variations of the ","type":"text"},{"text":"Get VHLField as ...","type":"text","marks":[{"type":"strong"}]},{"text":" function are available, but they are reserved for exceptional circumstances.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"All functions have similar structures:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":288912,"__fileMimeType":"image/png","width":1280,"id":"2f856821-757a-4b17-b104-6c4935d9ff07","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-1-43.png","height":694}}]},{"type":"paragraph","content":[{"text":"You must connect the Exec input to the correct Event tick. For example, if the data is get/set every tick, then the Exec of Event Tick must connect to the Exec input for the new function.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"wide","width":100.0},"content":[{"type":"media","attrs":{"__fileSize":51073,"__fileMimeType":"image/png","width":714,"id":"e969a9b3-2265-47c7-a3ac-7070fbd94167","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-1-49.png","height":228}}]},{"type":"paragraph","content":[{"text":"Get VHLField as ...","type":"text","marks":[{"type":"underline"},{"type":"strong"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"57b551c4-3ae2-48d4-b75b-5d7e08980820"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Target","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Specifies on which Mechanism Component to call this function. The Mechanism Component refers to the specific ","type":"text"},{"text":".vxmechanism","type":"text","marks":[{"type":"code"}]},{"text":" file from Vortex.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"VHLName","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The name of the VHL/Control interface to search for.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Field Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The name of the output field to search for.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Output","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The returned value (the type differs for each variation of the ","type":"text"},{"text":"Get VHLField as ...","type":"text","marks":[{"type":"strong"}]},{"text":" function).","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Set VHLField as ...","type":"text","marks":[{"type":"underline"},{"type":"strong"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"b5a3a397-ea2c-4e69-830b-bda330957025"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Target","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Specifies on which Mechanism Component to call this function. The Mechanism Component refers to the actual .","type":"text"},{"text":"vxmechanism","type":"text","marks":[{"type":"code"}]},{"text":" file from Vortex.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"VHLName","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The name of the VHL/Control interface to search for.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Field Name","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The name of the input field to search for.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Input","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Value","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"The value to assign to the specified field (the type differs for each variation of the ","type":"text"},{"text":"Set VHLField as ...","type":"text","marks":[{"type":"strong"}]},{"text":" function).","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Earthworks Systems","type":"text"}]},{"type":"paragraph","content":[{"text":"As a Vortex Studio and Unreal Engine user, you can combine the best of both worlds and use Vortex Studio Earthworks as your soil simulation in Unreal Engine. While an Unreal Engine Landscape can be sculpted and edited in Unreal Editor, it is usually a static and non-deformable object during the simulation. The Vortex Studio Earthwork Systems allows you to make otherwise rigid terrain surfaces deformable within a limited area. Earthmoving operations such as digging, trenching, filling, etc generate particles and respect mass conservation.","type":"text"}]},{"type":"paragraph","content":[{"text":"To do this, you will want to create one (or many) Deformable Terrains in Vortex Studio, as well as cutting tools or buckets, and import them in Unreal Engine. This guide will help you put it together for the following Earthworks constructs: Soil Bin, Deformable Terrain, Soil Particles. Refer to official Vortex Studio documentation (","type":"text"},{"text":"Earthwork Systems Tutorials","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Earthwork Systems Tutorials","versionAtSave":"6"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985976953"}}]},{"text":") for the remaining Earthworks features: Soil Layer, Soil Emitter, Soil Culling Geometry, Soil Mass Sensor, Soil Materials, Bucket, Blade, Generic Bucket. They work without any specific adaptation needed for Unreal Engine.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"A single Soil Particle extension is responsible for all particles generated in a simulation from any deformer on any Soilbin or Deformable Terrain. A single Soil Materials extension is responsible for all soil materials present in a simulation. With this in mind, a single Vortex Mechanism should contain a Soil Particles and Soil Materials extension and this Mechanism should be added once to a given Unreal level. Refer to Unreal Engine documentation about Levels if you are not familiar with them (","type":"text"},{"text":"https://docs.unrealengine.com/en-US/Engine/Levels/index.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/Engine/Levels/index.html"}}]},{"text":").","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Soilbin","type":"text"}]},{"type":"paragraph","content":[{"text":"As a Vortex Studio and Unreal Engine user, you can see your Vortex Studio Soilbin and interact with it in Unreal Engine. Here are the steps:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"1e6bf12f-1519-4366-9e74-d4cd9972e07f"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Information","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Media","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"How to view an Earthworks Soilbin in Unreal Engine","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Before you start, make sure that your Soilbin is correctly designed in Vortex Studio. You cannot make changes to the Soilbin extension from the Unreal Editor, and changes to inputs, outputs, and parameters that you make in Vortex Studio can cause problems in Unreal if they affect the mapping to the Procedural Mesh Component in the Unreal blueprint.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#263238"}}]}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":75.0},"content":[{"type":"media","attrs":{"__fileSize":529177,"__fileMimeType":"image/png","width":860,"id":"1a0eaf83-bebd-45d1-b6a8-1282d32b7266","collection":"contentId-3985973576","type":"file","__fileName":"image2019-8-13_15-2-45.png","height":403}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expose your Soilbin and its World Transform to VHL using the Vortex Editor.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For the proper position of the origin of the Soilbin in Unreal, expose the Outputs. World Transform of the Dynamics Soil Bin. This will be used from the blueprint as a position for the Procedural Mesh Component. To expose it, drag the field onto the VHL Interface's \"Outputs\" row.","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"wide","width":100.0},"content":[{"type":"media","attrs":{"__fileSize":78840,"__fileMimeType":"image/png","width":1256,"id":"1da5c9b2-7030-47b0-9078-1ad364a65f07","collection":"contentId-3985973576","type":"file","__fileName":"image2020-2-25_12-48-41.png","height":428}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To expose a Soilbin's shape so the Unreal object (created later in this guide) can conform to the Soilbin visuals, using Vortex Editor navigate to the VHL editing screen. Add an extension pointer output field by pressing '+' next to the \"Outputs\" column title. Keeping the VHL editing screen open navigate to your Soilbin in the Explorer tree. Select it and drag it to the \"Data\" column of the just created extension pointer output on the VHL editing screen.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You will need to remember the names of these two outputs when working in Unreal, so it might be helpful for you to rename them.","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":30.0},"content":[{"type":"media","attrs":{"__fileSize":19657,"__fileMimeType":"image/png","width":249,"id":"ce266afa-f409-4a21-b12f-4550f3e07363","collection":"contentId-3985973576","type":"file","__fileName":"image2019-8-13_15-7-0.png","height":271}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":95.0},"content":[{"type":"media","attrs":{"__fileSize":33746,"__fileMimeType":"image/png","width":1095,"id":"7f065151-0fb4-4836-986d-b55a8604040c","collection":"contentId-3985973576","type":"file","__fileName":"image2019-8-13_15-6-15.png","height":245}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In your Unreal project, open Plugins. Then, enable the 'Procedural Mesh' plugin","type":"text"},{"text":". It can be found in the Built-In\" pulldown.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"wide","width":100.0},"content":[{"type":"media","attrs":{"__fileSize":51170,"__fileMimeType":"image/png","width":1249,"id":"47ab60e6-0fd6-47b9-9d37-c285546a57f7","collection":"contentId-3985973576","type":"file","__fileName":"image2019-8-13_15-11-49.png","height":210}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To prepare Unreal Editor to receive Soilbin data from Vortex, create a 'Procedural Mesh' component in a blueprint relevant to the Soilbin (truck, ground, pile, etc).","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":45.0},"content":[{"type":"media","attrs":{"__fileSize":26444,"__fileMimeType":"image/png","width":321,"id":"b1611413-32f7-4386-a153-d26697aa9311","collection":"contentId-3985973576","type":"file","__fileName":"image2020-2-26_15-35-25.png","height":215}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"6","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The 'Procedural Mesh' must be created and updated at runtime from the Vortex data. Here is a breakdown of the Blueprint image shown next to this step:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the Material on the mesh","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the Transform of the Procedural Mesh based on data from Vortex","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create the mesh with the Height Field data from Vortex","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Recreate the mesh when the Heightfield size changes","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"or","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Update it if the size didn't change","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Optional: An empty Soil Bin will likely create graphical artifacts as the bottom face of the container exactly overlaps with the flat height field. To avoid this, you can raise or lower the Transform received from Vortex by a small amount.","type":"text"}]}]}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"wide","width":100.0},"content":[{"type":"media","attrs":{"__fileSize":361487,"__fileMimeType":"image/png","width":1280,"id":"d49b3e43-c71f-4577-8c6c-81681c96362a","collection":"contentId-3985973576","type":"file","__fileName":"image_labeled_.png","height":600}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Soil particles","type":"text"}]},{"type":"paragraph","content":[{"text":"When simulating any Earthworks System in Unreal Engine, you will want to see a visual representation of the dug soil (inside or falling from a bucket for example). In Vortex Studio, this dug soil is represented by the Vortex Studio Particle extension. Ensure that your particle system is set up with particle culling and has a reasonable maximum particle count. Refer to official Vortex Studio documentation (","type":"text"},{"text":"Earthwork Systems Tutorials","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Earthwork Systems Tutorials","versionAtSave":"6"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985976953"}}]},{"text":"). Once that is set up, here are the steps to use it in Unreal Engine:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"82b0daae-61ec-48fa-bd21-40ce9b43785a"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Information","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Media","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"How to view Earthworks particles in Unreal Engine","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":45.0},"content":[{"type":"media","attrs":{"__fileSize":510689,"__fileMimeType":"image/png","width":651,"id":"39836d74-505a-4e45-b0a8-e366a7b40222","collection":"contentId-3985973576","type":"file","__fileName":"image2019-8-14_11-8-17.png","height":493}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To expose your soil particles to Unreal, create a VHL interface in the Vortex Studio Editor","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":" (your soil ","type":"text"},{"text":"particles ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"must be already functional).","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":95.0},"content":[{"type":"media","attrs":{"__fileSize":18529,"__fileMimeType":"image/png","width":675,"id":"f20cb974-66b2-4af5-ac49-9977e8be51d3","collection":"contentId-3985973576","type":"file","__fileName":"image2019-8-14_11-10-20.png","height":164}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In Vortex Studio Editor, on your VHL interface, add an extension pointer output field by pressing '+' in the VHL editing screen using Vortex Editor.","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":45.0},"content":[{"type":"media","attrs":{"__fileSize":22130,"__fileMimeType":"image/png","width":356,"id":"bd66869a-08b4-49d9-994b-a4f676467c83","collection":"contentId-3985973576","type":"file","__fileName":"image2019-8-14_11-10-4.png","height":288}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In Unreal Editor, import some rock models into your Unreal assets. Import some material to use for the rock models.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If your rock model doesn't come from a pre-existing Unreal asset (ie you imported it from fbx) verify that the scale matches Unreal's centimeter units by opening it in Unreal and confirming its size.","type":"text"}]}]}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":20.0},"content":[{"type":"media","attrs":{"__fileSize":14637,"__fileMimeType":"image/png","width":158,"id":"fe6e5276-d38d-4090-a034-7ddb2ec961bf","collection":"contentId-3985973576","type":"file","__fileName":"image2019-8-14_11-11-50.png","height":124}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":20.0},"content":[{"type":"media","attrs":{"__fileSize":18427,"__fileMimeType":"image/png","width":142,"id":"375670ce-d426-48df-b638-043a0102ac94","collection":"contentId-3985973576","type":"file","__fileName":"image2019-8-14_11-12-11.png","height":122}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In Unreal Editor, create an 'Instanced Static Mesh' component in an Actor relevant to the soil particles (environment, ground, etc). Configure it to use one of the previously imported rock models.","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":85.0},"content":[{"type":"media","attrs":{"__fileSize":41322,"__fileMimeType":"image/png","width":610,"id":"0b9ab21f-47d7-49dd-bc1f-efa64e07a688","collection":"contentId-3985973576","type":"file","__fileName":"image2019-8-14_11-14-29.png","height":144}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":85.0},"content":[{"type":"media","attrs":{"__fileSize":23509,"__fileMimeType":"image/png","width":578,"id":"148429a4-edc6-4647-8daf-9e612cccc455","collection":"contentId-3985973576","type":"file","__fileName":"image2019-8-14_11-13-57.png","height":151}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"6","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Soil Particles must be created as instanced meshes in Unreal Engine. Here is a breakdown of the Blueprint image shown next to this step:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the relevant actor's 'Construction Script', pre-create a pool of particles. Match the maximum particle count the Vortex Studio particle culling, in this example, it is a pool of 10000 particles matching the maximum particle count setup in Vortex Studio. (refer to ","type":"text"},{"text":"Earthwork Systems Tutorials","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Earthwork Systems Tutorials","versionAtSave":"6"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985976953"}}]},{"text":")","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the initial transform for the instances to be out of the Player's view. (like underground)","type":"text"}]}]}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":80.0},"content":[{"type":"media","attrs":{"__fileSize":124591,"__fileMimeType":"image/png","width":908,"id":"23854bed-2f88-496a-bca1-faae0da87987","collection":"contentId-3985973576","type":"file","__fileName":"image2020-3-2_16-50-12.png","height":413}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":85.0},"content":[{"type":"media","attrs":{"__fileSize":25667,"__fileMimeType":"image/png","width":610,"id":"cf9e8179-9fc1-49e5-9e17-9eef3bab2837","collection":"contentId-3985973576","type":"file","__fileName":"image2020-3-2_16-50-43.png","height":151}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"7","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In Unreal, Soil Particles must be updated at runtime from the Vortex data. Here is a breakdown of the Blueprint image shown next to this step:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For each particle, a transform must be created from a position and a scale given by Vortex data.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(advanced) You can use the particle ID and a modulus operator to randomize mesh instance and angle of rotation (using frame number for example)","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":" \"Mark Render State Dirty\" on \"Update Instance Transform\" must be true for particle position change to be taken into account by Unreal Engine visible.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(performance) Setting it to true for each particle is very slow. It should be true for the last particle only.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(optional) Since we are working with a pool of particles (from the Construction Script) you may need to position the remaining unused particles out of view.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The 'Hide Particles' variable is a transform to apply to unused particles to 'park' them out of sight.","type":"text"}]}]}]}]}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":95.0},"content":[{"type":"media","attrs":{"__fileSize":391905,"__fileMimeType":"image/png","width":1280,"id":"472465b4-33df-4da8-93c7-ec5643fc2fce","collection":"contentId-3985973576","type":"file","__fileName":"image2020-3-2_16-48-10.png","height":758}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Deformable Terrain","type":"text"}]},{"type":"paragraph","content":[{"text":"As a Vortex Studio and Unreal Engine user, you can see your Vortex Studio Deformable Terrain and interact with it in Unreal Engine. Here are the steps:","type":"text"}]},{"type":"paragraph","content":[{"text":"For general information about creating a Deformable Terrain in Vortex Studio, refer to ","type":"text"},{"text":"Deformable Terrain","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Deformable Terrain","versionAtSave":"2"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985977042"}}]}]},{"type":"table","attrs":{"layout":"default","width":1800.0,"localId":"8146eefe-0011-418e-8d43-3b62b8ca60de"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Information","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Media","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The expected result when driving on soft ground with soft ground tire models in Unreal, notice the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ground texture is different where the wheel has compressed the grass.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The ground is visually and permanently deformed (compressed) when wheels move over it.","type":"text"}]}]}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":1472275,"__fileMimeType":"image/png","width":1280,"id":"a2b63f4c-190b-4fae-8e17-12e2336f80c1","collection":"contentId-3985973576","type":"file","__fileName":"image1962087383.png","height":717}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The first step is to create a new Mechanism in Vortex Studio containing a Deformable Terrain. Refer to the ","type":"text"},{"text":"Deformable Terrain","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Deformable Terrain","versionAtSave":"2"},"href":"https://vortexstudio.atlassian.net/wiki/spaces/VSD2502/pages/3985977042"}}]},{"text":" Engineering Guide.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It is possible to create a Deformable Terrain at the Scene or Mechanism level. For Unreal use, it must be created at the Mechanism level since it is the importable building block.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"As with the Soilbin in the Earthworks - Soilbin section above, expose the Deformable Terrain object as a VHL output.","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"type":"hardBreak"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In Unreal Editor, follow \"Loading a Vortex Mechanism in Unreal\" to add your Vortex Studio Mechanism to the Unreal world","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Depending on how the Mechanism containing the Deformable Terrain was created you may need to delete or hide some imported assets from the resulting Unreal import to properly view the terrain. If the Deformable Terrain conforms to a gallery they will be superimposed once in Unreal Engine. This can be used to hide the imported gallery (static mesh):","type":"text"}]}]},{"type":"listItem","content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":70.0},"content":[{"type":"media","attrs":{"__fileSize":40880,"__fileMimeType":"image/png","width":485,"id":"b19be6a9-51db-4904-a0b8-df2c33f42757","collection":"contentId-3985973576","type":"file","__fileName":"image2020-3-3_15-8-10.png","height":178}}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Convert it to Blueprint and add a Procedural Mesh. Open the Event Graph for editing.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To associate the Procedural Mesh to your Deformable Terrain, create a \"Get VHL Field as Tiled Heightfield\" event.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The VHLName and Field Name should match the field used to expose the Deformable Terrain in the previous step.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Store the OK output in a variable for use in the next step. Each step, get this (previous) value and pass it to the Update input. This allows the event to differentiate updating the mesh from creating the mesh","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The rest of the event graph deals with setting proper materials on each section and disabling the costly 'Cast Shadow' flag","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":95.0},"content":[{"type":"media","attrs":{"__fileSize":233097,"__fileMimeType":"image/png","width":1200,"id":"e206a29c-7495-4418-a3c4-172aed1ce0b7","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-2-2.png","height":727}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Blueprint for the Actor containing the Vortex Mechanism of the Deformable Terrain, add the typical Blueprint construct to position the origin of the Procedural Mesh (shown in the image on the right)","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":95.0},"content":[{"type":"media","attrs":{"__fileSize":70771,"__fileMimeType":"image/png","width":673,"id":"13f69b8d-95df-4c99-ba0e-faf9867983da","collection":"contentId-3985973576","type":"file","__fileName":"image2020-3-3_15-36-7.png","height":226}}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"You can design a material that will use a different texture for deformed and undeformed regions (as in Vortex Studio).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When designing your material, mix the two textures according to the value of one of the color channels of \"Vertex Color\". Black is deformed and White is undeformed.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Refer to ","type":"text"},{"text":"https://docs.unrealengine.com/en-US/Engine/Rendering/Materials/index.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/Engine/Rendering/Materials/index.html"}}]}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":75867,"__fileMimeType":"image/png","width":455,"id":"ed414993-f8e9-46df-8ddd-3fc2b82d919e","collection":"contentId-3985973576","type":"file","__fileName":"image6e7d9e273e.png","height":377}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":50.0},"content":[{"type":"media","attrs":{"__fileSize":240858,"__fileMimeType":"image/png","width":1029,"id":"44ce152b-5184-4cac-8791-d4386bae12d0","collection":"contentId-3985973576","type":"file","__fileName":"image2020-1-29_9-30-26.png","height":701}}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Visualizing the Vortex Simulation for Debugging Purposes Using the Vortex Remote Debugger","type":"text"}]},{"type":"paragraph","content":[{"text":"It can be useful to use the Vortex Studio Remote Debugger tool visualize your simulation. The tool lets you inspect collision geometries, contacts, part origins, and more to identify the source of problems.","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","width":1479.8466,"localId":"6652a201-7203-4040-b3d1-817739c1d08f"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[994.63]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The Remote Debugger can be very useful to view the Vortex Studio environment within Unreal.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"It allows the user to see collision geometries, contacts, part origins, etc.","type":"text"}]}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[485.22]},"content":[{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"type":"external","url":"https://www.cm-labs.com/vortexstudiodocumentation/Vortex_User_Documentation/Content/Unreal/ConfluenceResources/image2019-9-24_9-32-12_396x221.png"}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"__fileSize":39295,"__fileMimeType":"image/png","width":400,"id":"d7278a78-565c-4568-a595-a0f23d5ac5ef","collection":"contentId-3985973576","type":"file","__fileName":"image2019-9-24_9-24-11_thumb_400_0.png","height":255}}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Supported Colliding Objects in Unreal","type":"text"}]},{"type":"paragraph","content":[{"text":"The Unreal Engine supports multiple colliding objects in your simulations, including landscape and static meshes.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Landscape","type":"text"}]},{"type":"paragraph","content":[{"text":"The landscape is the primary tool to create a terrain in the Unreal Engine. This object uses a height map to define the elevations of the terrain. It includes several Landscape Components (each with the same number of quads).","type":"text"}]},{"type":"paragraph","content":[{"text":"The plugin automatically discovers Landscape Components within a 50m x 50m range around any given Vortex Mechanism and creates the corresponding height field in the Vortex world (all this occurs at runtime).","type":"text"}]},{"type":"paragraph","content":[{"text":"The following image shows an example of a landscape component made of 127 X 127 quads (16129 quads):","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"__fileSize":51601,"__fileMimeType":"image/png","width":438,"id":"2d5d29a3-0f95-4670-ab67-5347ee04a477","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-2-12.png","height":795}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":2934874,"__fileMimeType":"image/png","width":1280,"id":"20019151-7fa7-4fcd-9807-c1a06aee79b1","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-2-21.png","height":704}}]},{"type":"paragraph","content":[{"text":"You can inspect any generated height fields in the Vortex world using the Vortex Remote Debugger. The following image shows an example of generated height fields in the Vortex Remote Debugger:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"__fileSize":134805,"__fileMimeType":"image/png","width":1280,"id":"ecf97e3f-9d02-4bb8-a7fc-bee702ccc1e7","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-2-26.png","height":827}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Meshes That Do Not Simulate Physics","type":"text"}]},{"type":"paragraph","content":[{"text":"With the plugin, the application can generate collisions between a Vortex Mechanism and any Unreal mesh that does not simulate physics (static). For example, the system can generate collisions with the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Static meshes","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Instanced static meshes, such as foliage","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Landscape splines","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The Unreal Engine supports 2 different types of collisions:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Simple Collision","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Complex Collision","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"By default, the application uses simple collisions, since they support better performance. You can override the collision type at different levels in Unreal Engine, in Project Settings or for the individual mesh. For more information about simple and complex collisions in Unreal, see: ","type":"text"},{"text":"https://docs.unrealengine.com/en-US/Engine/Physics/SimpleVsComplex/index.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/Engine/Physics/SimpleVsComplex/index.html"}}]}]},{"type":"paragraph","content":[{"text":"The plugin always uses the same collision type as the one currently being used by PhysX on the Unreal Engine side. The integration supports the following shapes:","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"table","attrs":{"layout":"default","width":409.0,"localId":"70db5289-54ff-4236-b57f-d560d1d9ee2e"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[409.0]},"content":[{"type":"paragraph","content":[{"text":"Supported Simple Collision Shapes","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Box","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sphere","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Sphyl","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Convex","type":"text"}]}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[409.0]},"content":[{"type":"paragraph","content":[{"text":"Supported Complex Collision Shapes","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[140.0]},"content":[{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Triangle Mesh","type":"text"}]}]}]}]}]}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"IMPORTANT:","type":"text","marks":[{"type":"strong"}]},{"text":" To function correctly, the static meshes cannot be in a blueprint containing a Deformable Terrain or a Soil Bin. The statics mesh must exist in a separate actor.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Example of Meshes that Do Not Simulate Physics","type":"text"}]},{"type":"paragraph","content":[{"text":"The following image shows a default simple collision used by a tree mesh (for foliage).","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":1563098,"__fileMimeType":"image/png","width":1280,"id":"20c7e615-ea38-41c1-844d-23105eddf41a","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-2-31.png","height":693}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":2946386,"__fileMimeType":"image/png","width":1280,"id":"f40c215f-0771-46fe-90c3-070b10f75d58","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-2-35.png","height":704}}]},{"type":"paragraph","content":[{"text":"You can visualize the resulting geometry in the Vortex Remote Debugger:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"__fileSize":139956,"__fileMimeType":"image/png","width":1280,"id":"a5dc3983-498f-461a-bd83-7a7f99fd341c","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-2-40.png","height":827}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Mapping Contact Materials","type":"text"}]},{"type":"paragraph","content":[{"text":"The Vortex Plugin for the Unreal Engine lets you specify which dynamic materials the application uses for a given collision. To configure this, you can map physical materials in Unreal to dynamics materials in Vortex Studio.","type":"text"}]},{"type":"paragraph","content":[{"text":"The physics properties you define for material in the Unreal Editor do not affect materials in Vortex Studio. The changes you make only apply to PhysX simulation in the Unreal Engine.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Create a Mapping for Contact Materials","type":"text"}]},{"type":"paragraph","content":[{"text":"To create a mapping for contact materials, do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If a Physical Material does not already exist in your Unreal project for the type of material you want to use, create a new one:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":1899561,"__fileMimeType":"image/png","width":1280,"id":"2b4cd5ac-d618-4315-b1fb-9cee15784bef","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-2-45.png","height":693}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":272557,"__fileMimeType":"image/png","width":1280,"id":"c17899e7-c303-4862-a91f-47b16ead03df","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-2-49.png","height":694}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Navigate to ","type":"text"},{"text":"Project Settings","type":"text","marks":[{"type":"strong"}]},{"text":" → ","type":"text"},{"text":"Vortex Studio","type":"text","marks":[{"type":"strong"}]},{"text":" and do one of the following:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click to select the Vortex material table you want to use.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Accept the default material setting.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a Material Mapping. In this new mapping, select the Unreal physical material you want to use and write the Vortex dynamics material that you want to associate it with. You can create a landscape mapping, static Mesh mapping, or static mesh mapping with complex collisions.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":270310,"__fileMimeType":"image/png","width":1280,"id":"5681a017-8357-46d1-9d56-37e190bc2b6a","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-2-57.png","height":693}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":253782,"__fileMimeType":"image/png","width":1280,"id":"e075fcbf-1e03-4f1a-88fc-0d86ff7eea44","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-3-0.png","height":694}}]},{"type":"paragraph","content":[{"text":"Map Landscape Materials","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"The Unreal Editor lets you assign physical materials by Landscape Layer. You can inspect each later here:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":2165155,"__fileMimeType":"image/png","width":1280,"id":"71b36144-db99-4692-81ff-cc5f0a3571b5","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-3-3.png","height":694}}]},{"type":"paragraph","content":[{"text":"To map landscape materials, do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click to select the layer that you will associate with a physical material.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To automatically select the Landscape Layer Info Object, click on the lens icon next to it.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":1958489,"__fileMimeType":"image/png","width":1280,"id":"070c5064-eb57-4a2e-ad5a-6e87bba301e1","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-3-10.png","height":693}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From the Content Browser, double click on the Layer Info Object. The following window appears:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":60.0},"content":[{"type":"media","attrs":{"__fileSize":74058,"__fileMimeType":"image/png","width":1280,"id":"4b7c926e-d0b4-4362-bfa8-34f4b59c4296","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-3-26.png","height":730}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Specify the Physical Material that you will associate with the layer and then press the ","type":"text"},{"text":"Save","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":60.0},"content":[{"type":"media","attrs":{"__fileSize":79237,"__fileMimeType":"image/png","width":1280,"id":"53807d56-b931-4dfc-acfd-cc503e3ce3ae","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-3-30.png","height":730}}]}]}]},{"type":"paragraph","content":[{"text":"Map Static Meshes","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"To map a static mesh, do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Unreal Editor, open a window for the static mesh that you want to associate with a physical material.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the ","type":"text"},{"text":"Simple Collision Physical Material","type":"text","marks":[{"type":"strong"}]},{"text":" that you will use for this mesh and save the changes.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":2053143,"__fileMimeType":"image/png","width":1280,"id":"67910282-e83e-4c06-b374-c371ab67032d","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-3-34.png","height":696}}]},{"type":"paragraph","content":[{"text":"The system only applies the physical material if the mesh uses simple collisions","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Map a Static Mesh Using Complex Collisions","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"To map a static mesh that uses complex collisions, do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Unreal Editor, open a window for the static mesh that you want to associate with a physical material.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Search for graphics materials in the mesh.","type":"text"}]},{"type":"paragraph","content":[{"text":"When you use a complex collision, the application uses a graphics material to apply each physical material (a one-to-one relationship). You must pay special attention to the graphics material you select for the static mesh.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":2075077,"__fileMimeType":"image/png","width":1280,"id":"dde0e264-965a-4189-ab12-f2bb4f0eb3aa","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-3-38.png","height":696}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Double click on the graphics material you want to open an editor for it.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":1622221,"__fileMimeType":"image/png","width":1280,"id":"f0044eae-cc5c-44de-9b8e-996f41f1e8d7","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-3-44.png","height":696}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"From the editor window for the graphics material, select the physical material you will associate with the graphics material.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":1623666,"__fileMimeType":"image/png","width":1280,"id":"6cf12dac-3bc8-4822-82d8-dce19d400c3d","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-3-48.png","height":696}}]},{"type":"paragraph","content":[{"text":"The application only applies the physical materials if the mesh uses complex collisions.","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(optional) Use the Vortex Studio Remote Debugger to debug Vortex Studio dynamics material.","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the Vortex Studio Remote Debugger tool, you can inspect the dynamics material the Vortex Studio uses for a given contact from the following page:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":53945,"__fileMimeType":"image/png","width":1280,"id":"307b7429-b94a-43c8-a5c8-4a550e0fd014","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-3-52.png","height":699}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":126748,"__fileMimeType":"image/png","width":1280,"id":"ad9f1cb4-bb88-4d33-b626-d8d7db91b4df","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-3-55.png","height":693}}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Packaging Your Project","type":"text"}]},{"type":"paragraph","content":[{"text":"Before you can distribute your simulation to users as an Unreal project, you must package it. Packaging ensures that all code and content is up to date and in the correct format to run on your target platform. For more information about packaging projects in Unreal, see the Packaging Projects topic in Unreal online documentation: ","type":"text"},{"text":"https://docs.unrealengine.com/en-US/Engine/Basics/Projects/Packaging/index.html","type":"text","marks":[{"type":"link","attrs":{"href":"https://docs.unrealengine.com/en-US/Engine/Basics/Projects/Packaging/index.html"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"When you package an Unreal project that uses the Vortex Studio plugin, you must include all Vortex Studio assets with all the Unreal assets in the packaging process.","type":"text"}]},{"type":"paragraph","content":[{"text":"To prevent disorganization, CM Labs strongly recommends that you isolate the Vortex Studio assets, including mechanisms, assemblies, graphics galleries, the application setup document, and any material tables, in sub-folders under the ","type":"text"},{"text":"Content ","type":"text","marks":[{"type":"code"}]},{"text":"folder of the Unreal project directory.","type":"text"}]},{"type":"paragraph","content":[{"text":"IMPORTANT:","type":"text","marks":[{"type":"strong"}]},{"text":" You can only use the Vortex Studio Plugin for Unreal Engine to package a project for Windows (64-bit)","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"To Package Your Project","type":"text"}]},{"type":"paragraph","content":[{"text":"To package a","type":"text"},{"text":" Vortex Mechanisms ","type":"text","marks":[{"type":"code"}]},{"text":"directory, including all dependent files, do the following:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Unreal Editor, open the Project Settings for you project.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":749580,"__fileMimeType":"image/png","width":1280,"id":"1f615b7e-74ff-4c3b-86cb-d8f127129f9b","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-4-0.png","height":692}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Under ","type":"text"},{"text":"Project","type":"text","marks":[{"type":"em"}]},{"text":", click to select ","type":"text"},{"text":"Packaging","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"__fileSize":119531,"__fileMimeType":"image/png","width":1280,"id":"77676a54-e2d2-43f7-b965-347b02300714","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-4-3.png","height":809}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"At the bottom of the ","type":"text"},{"text":"Packaging","type":"text","marks":[{"type":"em"}]},{"text":" items, click ","type":"text"},{"text":"Show Advanced","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":55.0},"content":[{"type":"media","attrs":{"__fileSize":122610,"__fileMimeType":"image/png","width":1280,"id":"ac7db08b-856e-4989-b92b-39aa16653a89","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-4-10.png","height":803}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Scroll down to ","type":"text"},{"text":"Additional Non-Asset Directories to Copy","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To add a new entry, press the ","type":"text"},{"text":"+","type":"text","marks":[{"type":"strong"}]},{"text":" button and click to select the ","type":"text"},{"text":"Vortex_Mechanisms","type":"text","marks":[{"type":"code"}]},{"text":" directory under the ","type":"text"},{"text":"Content ","type":"text","marks":[{"type":"code"}]},{"text":"directory","type":"text"}]},{"type":"paragraph","content":[{"text":"A packaged version of your Unreal project will now run correctly.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Viewing Vortex Studio Log Files in the Unreal Editor","type":"text"}]},{"type":"paragraph","content":[{"text":"When you develop a project in the Unreal Editor using Vortex Studio content, you may need to refer to application information about the Vortex Studio simulation for debugging purposes. To facilitate troubleshooting, the Vortex Studio plugin and the Vortex Studio application log messages. To access application logs, follow these steps:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"To View Vortex Studio Plugin for Unreal Engine Logs","type":"text"}]},{"type":"paragraph","content":[{"text":"When you use the plugin, Vortex Studio generates logs in the Output Log window of the Unreal Editor. The application groups log files under the ","type":"text"},{"text":"LogVortex","type":"text","marks":[{"type":"strong"}]},{"text":" category:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":799817,"__fileMimeType":"image/png","width":1280,"id":"16c70abd-4043-45b3-a808-1f3adbaae571","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-4-14.png","height":693}}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":789530,"__fileMimeType":"image/png","width":1280,"id":"361480a6-5ff6-4911-8159-0ac7632aa65e","collection":"contentId-3985973576","type":"file","__fileName":"image2020-10-12_21-4-18.png","height":692}}]},{"type":"paragraph","content":[{"text":"You can also find these logs in the ","type":"text"},{"text":"Saved/Logs","type":"text","marks":[{"type":"strong"}]},{"text":" subfolder of your Unreal project.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Logs from the Vortex Application","type":"text"}]},{"type":"paragraph","content":[{"text":"Logs generated by the Vortex Studio application are output as ","type":"text"},{"text":".log ","type":"text","marks":[{"type":"code"}]},{"text":"files in the ","type":"text"},{"text":"Saved/Logs","type":"text","marks":[{"type":"strong"}]},{"text":" subfolder of your Unreal project.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Limitations","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Physical Interaction Between Unreal and Vortex Studio","type":"text"}]},{"type":"paragraph","content":[{"text":"The Vortex Studio Plugin for Unreal Engine allows Vortex mechanisms to interact with Unreal ","type":"text"},{"text":"static objects only","type":"text","marks":[{"type":"underline"},{"type":"strong"}]},{"text":". When enabling this feature, a 50m x 50m detection box is used in the Unreal world around each Vortex Mechanism to automatically detect all static obstacles. Those obstacles are streamed at runtime to Vortex to create corresponding collision geometries.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Supported Platform","type":"text"}]},{"type":"paragraph","content":[{"text":"The Vortex Studio Plugin for the Unreal Engine only supports the \"Windows (64-bit)\" platform.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":65.0},"content":[{"type":"media","attrs":{"__fileSize":3558210,"__fileMimeType":"image/gif","width":1907,"id":"d867135f-2638-46e0-bd9a-b1520fbe91c9","collection":"contentId-3985973576","type":"file","__fileName":"VortexStudioPluginEnable.gif","height":1006}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}

Browser not supported