{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Earthwork Zones, dynamically simulated in Vortex Studio, ","type":"text"},{"text":"can be rendered in Unity during simu","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"lation","type":"text"},{"text":". When a Earthwork Zone is loaded, a height field prefab is loaded from an asset bundle file ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"located in the same directory as the Vortex file that contains the Earthwork Zone.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Manually creating prefabs and Asset Bundles","type":"text"}]},{"type":"paragraph","content":[{"text":"To manually create assets for the Earthwork Zone, a Unity project with the Vortex Integration Package is needed (such as VortexUnityTools or your own project), some height field and terrain prefabs must be added and the assets must be packaged in asset bundles.","type":"text"}]},{"type":"paragraph","content":[{"text":"For an overview of the assets workflow, refer to ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Workflow for ","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/VSD238/pages/3342546359"}}]},{"text":"Preparing and Using Assets for a Vortex Simulation with Unity Graphics","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/VSD238/pages/3342546359"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Height Field Prefabs","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"At simulation time, when a Earthwork Zone instance is added, the Vortex Integration will look for a height field prefab with a specific name. The prefab name must contain the Graphics Soil hierarchy with the Graphics Soil name from the Vortex Editor explorer without the parent element that is contained in a Vortex file. The hierarchy levels are separated with period characters. Folders are omitted from the hierarchy. The name and hierarchy are case sensitive.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"For example, for the following hierarchy, the prefab name would be ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Construction_Site.Earthwork Zone.Graphics","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":22.0},"content":[{"type":"media","attrs":{"width":360,"id":"20f7a143-ae41-4452-b8ef-84ab48769d38","collection":"contentId-3342546546","type":"file","height":318}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating a Height Field Prefab","type":"text"}]},{"type":"paragraph","content":[{"text":"The height field prefab must have a","type":"text"},{"text":" ","type":"text"},{"text":"Vortex Height Field","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"component and a","type":"text"},{"text":" ","type":"text"},{"text":"Vortex Height Field Renderer","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"component.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create an empty GameObject","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"e9fb6469-e053-4922-9139-093bb104b814","collection":"contentId-3342546546","height":"400"}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rename it with the proper name (see the ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Height Field Prefabs","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"section introduction)","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"8a7d3bf1-b674-430c-8e5d-bfaaa94091c2","collection":"contentId-3342546546","height":"132"}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the created GameObject and add the VortexHeightField and VortexHeightFieldRenderer components in the inspector","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"347d500b-ef4d-4fdb-b309-94a53f1e205e","collection":"contentId-3342546546","height":"250"}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a new material based on the DefaultHeightFieldShader shader and assign it to the VortexHeightFieldRenderer material field","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"3f546693-e12b-45b4-b239-fe48adbf6632","collection":"contentId-3342546546","height":"250"}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Drag and drop the GameObject somewhere in the Assets folder in the project pane to create the prefab","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"text":"You can create folders in in the assets folder to store the prefabs (ex: Assets/Resources/Scene)","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"400","id":"517aa43b-06e0-40e3-9bb3-0428d264b6a5","collection":"contentId-3342546546","height":""}}},{"type":"hardBreak"}]}]}]},{"type":"paragraph","content":[{"text":"In the following section, we present in great detail the required components and materials that compose a height field prefab.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The VortexHeightField Component","type":"text"}]},{"type":"paragraph","content":[{"text":"The VortexHeightField component is in charge of managing the height field data and to updating the renderer.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":31.0},"content":[{"type":"media","attrs":{"width":398,"id":"a3178aa2-8d33-480e-882a-9c854e62ad98","collection":"contentId-3342546546","type":"file","height":47}}]},{"type":"paragraph","content":[{"text":"These public fields can be configured through the inspector:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Field","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Height Field Offset","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"An height offset that can be applied to the height field.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Hole Offset Factor","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"An offset factor to shrink down the hole created in the terrain where the Earthwork Zone is located.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Blur Enabled","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Enables height field geometry smoothing","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Blur Radius","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Sets the smoothing factor on the height field geometry","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The VortexHeightFieldRenderer Component","type":"text"}]},{"type":"paragraph","content":[{"text":"This component is used to render the height field as a dynamic mesh. The mesh is generated once and updated based on the incoming height field data.","type":"text"}]},{"type":"paragraph","content":[{"text":"These public fields can be configured through the inspector:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[63.58]},"content":[{"type":"paragraph","content":[{"text":"Field","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[394.19]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[63.58]},"content":[{"type":"paragraph","content":[{"text":"Material","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[394.19]},"content":[{"type":"paragraph","content":[{"text":"The Unity material assigned to the generated height field mesh. The material must be based on the ","type":"text"},{"text":"DefaultHeightFieldShader.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[63.58]},"content":[{"type":"paragraph","content":[{"text":"Terrain Upscaling","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[394.19]},"content":[{"type":"paragraph","content":[{"text":"Used to create a higher level of visual detail without having to increase the number of Dynamics cells, which can otherwise be computationally costly.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"The Height Field Material","type":"text"}]},{"type":"paragraph","content":[{"text":"The material must be based on the ","type":"text"},{"text":"DefaultHeightFieldShader. To get a seamless transition between the overlapped terrain and the Earthwork Zone un-disturbed soil, the material must use the same parameters as the terrain node it intersects. The disturbed soil look can be controlled independently. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"These public fields can be configured through the inspector:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"table","attrs":{"layout":"default"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.43]},"content":[{"type":"paragraph","content":[{"text":"Field","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.54]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.43]},"content":[{"type":"paragraph","content":[{"text":"BaseMap","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.54]},"content":[{"type":"paragraph","content":[{"text":"The color texture used on the un-disturbed soil. It must use the same texture from the intersected terrain material.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.43]},"content":[{"type":"paragraph","content":[{"text":"NormalMap","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.54]},"content":[{"type":"paragraph","content":[{"text":"The normal texture for the un-disturbed soil. It must use the same texture from the intersected terrain material.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.43]},"content":[{"type":"paragraph","content":[{"text":"Metallic","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.54]},"content":[{"type":"paragraph","content":[{"text":"Determines how “metal-like” the surface is (between 0 and 1). It must match the value from the intersected terrain material.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.43]},"content":[{"type":"paragraph","content":[{"text":"Smoothness","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.54]},"content":[{"type":"paragraph","content":[{"text":"Determines how smooth the surface is (between 0 and 1). It must match the value from the intersected terrain material.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.43]},"content":[{"type":"paragraph","content":[{"text":"Disturbed Soil Albedo","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.54]},"content":[{"type":"paragraph","content":[{"text":"The color texture for the disturbed soil","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.43]},"content":[{"type":"paragraph","content":[{"text":"Disturbed Soil Normal Map","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.54]},"content":[{"type":"paragraph","content":[{"text":"The normal texture for the disturbed soil","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.43]},"content":[{"type":"paragraph","content":[{"text":"Disturbed Soil Normal Strength","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.54]},"content":[{"type":"paragraph","content":[{"text":"The strength of the normal from the normal texture","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.43]},"content":[{"type":"paragraph","content":[{"text":"Disturbed Soil Texture Tiling","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.54]},"content":[{"type":"paragraph","content":[{"text":"The disturb soil texture texture tiling","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[120.43]},"content":[{"type":"paragraph","content":[{"text":"Disturbed Blend Range And Offset","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[543.54]},"content":[{"type":"paragraph","content":[{"text":"Controls the blending between the disturbed and un-disturbed soil textures.","type":"text"},{"type":"hardBreak"},{"text":"X Value: The range in meters to mix disturbed and un-disturbed soil","type":"text"},{"type":"hardBreak"},{"text":"Y Value: The offset in meters from the disturbed and un-disturbed junctions","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Enable GPU Instancing, Emission and Motion Vector For Vertex Animation","type":"text","marks":[{"type":"em"}]},{"text":" parameters are inherited by Unity's shader graph and should not be enabled.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Creating a custom heightfield shader","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"A custom shader must be assigned to the Earthwork Zone prefab if a custom terrain shader is assigned to the intersected terrain prefab. The steps to create a custom heightfield shader are:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Duplicate the custom terrain shader graph","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In addition to the described fields in the Height Field Material section, add these parameters to the shader","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"__confluenceADFMigrationUnsupportedContentInternalExtension__","text":"","parameters":{"cxhtml":"

Reference Name	Type
HeightFieldTexture	Texture2D
HeightFieldDimensions	Vector2
DisturbedSoilDistanceField	Texture2D

","block-inline":true,"nestedContent":{"type":"doc","content":[{"type":"table","content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Reference Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Type","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"HeightFieldTexture","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Texture2D","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"HeightFieldDimensions","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Vector2","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"DisturbedSoilDistanceField","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Texture2D","type":"text"}]}]}]}]}],"version":1},"reason":"A table in list item can't be created or edited in the new editor."}}}]},{"type":"paragraph","content":[{"text":"RemapTexUV0, RemapTexUV1, RemapTexUV2, RemapTexUV3 and RemapTexVertexColor are textures parameters that must also be added if the shader uses vertices UVs or colors.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Insert a HeightFieldVertexSubGraph and a HeightFieldFragmentSubGraph in the shader and link the nodes with the properties nodes and the Lit Master node as shown in this image.","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":1239,"id":"35e21194-01d0-47b5-9d16-cfca8bbdf48e","collection":"contentId-3342546546","type":"file","height":636}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Modify all samplers that use the mesh UVs to use the UVs stored in the RemapTexUV0, RemapTexUV1, RemapTexUV2 and RemapTexUV3 textures","type":"text"},{"type":"hardBreak"},{"text":"Before:","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":34.0},"content":[{"type":"media","attrs":{"width":442,"id":"7a592c11-20e5-489f-96a9-db9104c37088","collection":"contentId-3342546546","type":"file","height":245}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"After","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":34.0},"content":[{"type":"media","attrs":{"width":547,"id":"6efd842d-943d-4f75-a965-de562fff5c7f","collection":"contentId-3342546546","type":"file","height":309}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Replace all Vertex Color nodes to use colors stored in the RemapTexVertexColor texture ","type":"text"},{"type":"hardBreak"},{"text":"Before:","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":15.0},"content":[{"type":"media","attrs":{"width":193,"id":"37a9a149-1228-45e6-b324-83fd418f8806","collection":"contentId-3342546546","type":"file","height":129}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"After:","type":"text"},{"type":"hardBreak"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":37.0},"content":[{"type":"media","attrs":{"width":512,"id":"cfde457e-b774-4ded-9f8d-cd17b0089f0b","collection":"contentId-3342546546","type":"file","height":265}}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"When creating the material based on the shader, make sure that the parameters common with the terrain material are all set to the same values.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Terrain Prefabs","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"In order to properly display the height field over the terrain, a terrain prefab must be prepared. The process is similar to the one used for the graphic galleries but the material assigned to the underlying mesh must be based on the TerrainShaderGraph shader or must be a custom shader following specific conventions.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the scene in the Vortex Editor and export the Graphic Gallery used for the File Terrain throughout the Gallery Tools","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"17edfcca-3c2c-4c36-8ca3-21cfcf97e8ed","collection":"contentId-3342546546","height":""}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In the Unity project, create a folder named after the graphic gallery file and drag and drop the exported FBX file and the images folder.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"f8608595-98f6-4d30-89ac-28cd9ef97d29","collection":"contentId-3342546546","height":""}}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Select the imported model and make sure that ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Preserve Hierarchy","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":" is checked in the property pane in the Model section","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"df2364fa-6032-4054-af94-a114940f02b4","collection":"contentId-3342546546","height":""}}},{"type":"hardBreak"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In Materials property section, click on ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Extract Materials ","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"and select a folder that will contain the extracted materials","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"ee5af8a2-2765-42fc-bdea-ab5d077eadb5","collection":"contentId-3342546546","height":""}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For each sub-mesh that intersects with the Earthworking Zone, select the corresponding material by double clicking it","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"879d8ba8-93a6-4a3e-b5ca-46a47727bf61","collection":"contentId-3342546546","height":""}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Note witch textures are assigned to the base map and the normal map by clicking on the textures icons","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"2645c587-0d3c-4ce6-8647-a398aa9083c9","collection":"contentId-3342546546","height":""}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Change the material shader for TerrainShaderGraph","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"db857712-b7e3-4b10-a8e7-4b12c8fcb416","collection":"contentId-3342546546","height":"72"}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Assign back the Base Map and Normal Map textures","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"2e028179-3201-423c-ae52-84199456df95","collection":"contentId-3342546546","height":""}}},{"type":"hardBreak"},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enable Alpha Clipping on the material","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Repeat steps 5 to 8 for each material that will be in contact with the Earthwork Zone.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Creating a custom terrain shader","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"paragraph","content":[{"text":"A custom shader can also be assigned to the sub-meshes where the Earthwork Zone intersects. Some rules must be followed:","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The shader must have a Vector1 property name ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"NumHoles","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":" set to zero by default. The reference name should also be ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"NumHoles. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}},{"type":"em"}]},{"text":"The property declaration must be overridden to ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Per Material","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"type":"hardBreak"},{"type":"inlineExtension","attrs":{"extensionType":"com.atlassian.confluence.migration","extensionKey":"inline-media-image","parameters":{"width":"","id":"e966ac22-1a24-461e-9897-3e59e82c9518","collection":"contentId-3342546546","height":"250"}}},{"type":"hardBreak"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The shader must have Matrix4 properties ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"HoleTransform00, ","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"HoleTransform01, HoleTransform02, HoleTransform03","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":". The reference names should be the same as the properties names. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"The properties declarations must be overridden to ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":"Per Material","type":"text","marks":[{"type":"em"},{"type":"textColor","attrs":{"color":"#172b4d"}}]},{"text":".","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The shader must include de TerrainHoleSubGraph. The subgraph node should be linked with the properties listed above and with the Master Node Alpha input. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":57.0},"content":[{"type":"media","attrs":{"width":1021,"id":"2cb07ff7-873e-47ea-a544-a16e4e35aafb","collection":"contentId-3342546546","type":"file","height":345}}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The AlphaClipThreshold on the master node must be set to 0.5.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The shader name must contain \"TerrainShaderGraph\"","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The material that will use the custom shader must enable Alpha Clipping.","type":"text","marks":[{"type":"textColor","attrs":{"color":"#172b4d"}}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Creating an Asset Bundle","type":"text"}]},{"type":"paragraph","content":[{"text":"Once the height field prefabs and the terrain prefabs are created, they can be packaged in asset bundles so that they can be loaded by VortexUnityApp, or your own similar Unity application with Vortex Integration.","type":"text"}]},{"type":"paragraph","content":[{"text":"The process for generating an asset bundle is described in","type":"text"},{"text":" ","type":"text"},{"text":"this section","type":"text","marks":[{"type":"link","attrs":{"href":"https://cm-labs.atlassian.net/wiki/display/VSD21A/Workflow+for+Preparing+and+Using+Assets+for+a+Vortex+Simulation+with+Unity+Graphics#WorkflowforPreparingandUsingAssetsforaVortexSimulationwithUnityGraphics-ExportingAssetsintoanAssetBundle"}}]},{"text":". In short, you can use the","type":"text"},{"text":" ","type":"text"},{"text":"Export Asset Bundle...","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"command from the context menu when selecting the folder containing the prefab's assets.","type":"text"}]},{"type":"paragraph","content":[{"text":"Then, select the file's destination and name to create the file.","type":"text"}]},{"type":"paragraph","content":[{"text":"In order to get VortexUnityApp to load the asset bundles properly, the asset bundles files must be placed in the same folders where are stored the Vortex file that contains the Earthwork Zone and the Vortex graphic gallery.","type":"text"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"}]}],"version":1}