Skip to content

Commit e9c164e

Browse files
Update meshery docs
1 parent 5ce0ad0 commit e9c164e

File tree

3 files changed

+20
-13
lines changed

3 files changed

+20
-13
lines changed
982 KB
Loading

tools/course-building/course-meshes.md

Lines changed: 18 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -6,39 +6,44 @@ nav_order: 3
66

77
# Course Meshes
88

9-
To create separate playable surfaces, like fairways and greens. We need to convert the basic shapes we drew in Inkscape into 3D objects that are sloped to match our terrain.
9+
To create separate playable surfaces, like fairways and greens. We need to convert the basic shapes we drew in Inkscape into 3D objects that are sloped to match our terrain. We created a specialized tool for this, called Meshery.
1010

1111

1212
1. TOC
1313
{:toc}
1414

1515
## Creating Meshes
1616

17-
1. Open the [Course Meshery](/tools/utilities/course-meshery) tool.
1817

19-
2. Click the **Select SVG File**{: .label } button and locate the SVG file you created in the [Course Map](/tools/course-building/course-map) step.
18+
1. Download and open the [Meshery](/tools/utilities/course-meshery) tool.
19+
20+
On Windows, you may get a warning from Microsoft Defender. Click **More info** and then select **Run anyways**
21+
22+
2. Click the **Import RAW Terrain**{: .label } button and locate the raw terrain data file you created in the [Course Terrain](/tools/course-building/course-map) step.
2023

21-
3. Click the **Select RAW Terrain**{: .label } button and locate the raw terrain data file you created in the [Course Terrain](/tools/course-building/course-map) step.
24+
3. Click the **Import SVG**{: .label } button and locate the SVG file you created in the [Course Map](/tools/course-building/course-map) step.
2225

23-
4. Set the **Height Scale**{: .label } value to the same thing as your **Terrain Height** in Unity.
26+
4. Set the **Terrain Height**{: .label } value to the same thing as your **Terrain Height** in Unity.
2427

25-
To find the terrain height
28+
To find your terrain height
2629

2730
1. Click the terrain object in your scene.
2831

2932
2. Click the **Terrain Settings** tab in the Inspector on the right.
3033

3134
3. Scroll down to your Terrain Size section and you should see **Terrain Height**
3235

33-
5. Set **Output Folder**{: .label } to the location you want the course folder to be generated. When the job completes, there will be a new unique folder created at this location.
36+
5. In Meshery you can optionally set a **Terrain Smoothing**{: .label } value for you terrain, to smooth out any rough / bumpy terrain. For more fine grained control, consider editing and smoothing your terrain in Unity and exporting a new RAW file for Meshery.
37+
38+
6. Click **Export Meshes**{: .label } and select a the location to save your OBJ file containing your course meshes.
3439

35-
<a href="/assets/course-building/meshery-screen.png" target="_blank">
36-
<img src="/assets/course-building/meshery-screen.png" width="500" alt="Meshery Screenshot" />
40+
<a href="/assets/course-building/meshery-window.png" target="_blank">
41+
<img src="/assets/course-building/meshery-window.png" width="500" alt="Meshery Screenshot" />
3742
</a>
3843

3944
## Import Meshes Into Unity
4045

41-
Next you'll want to import the folder of meshes into your Unity project. These meshes will sit just above your terrain layer. Make sure you're using the project template and have the OpenGolfSim Developer Toolkit package, which should include a tool for importing and batch assigning base materials to your meshes.
46+
Next you'll want to import the OBJ file into your Unity project. These meshes will sit just above your terrain layer. Make sure you're using the project template and have the OpenGolfSim Developer Toolkit package, which should include a tool for importing and batch assigning base materials to your meshes.
4247

4348
1. In your Unity project, go to **Tools > OpenGolfSim > Import Meshes**{: .label }
4449

@@ -48,11 +53,11 @@ Next you'll want to import the folder of meshes into your Unity project. These m
4853

4954
3. At this point you can batch assign materials like grass and sand to your course surfaces.
5055

51-
4. Click the **Import OBJs**{: .label } button and wait for the script to automatically import the course meshes to your scene. This step could take quite a while, depending on the size of your course.
56+
4. Click the **Import OBJs**{: .label } button and wait for the script to automatically import the course meshes to your scene.
5257

53-
5. Once the task finishes, you should see a new parent game object with the name of your folder.
58+
5. Once the task finishes, you should see a new parent game object with the name of your file.
5459

55-
6. You'll likely need to reposition the parent game object over the terrain by offsetting the X or Z value by the terrain size, as well as adjusting the Y position to be above the terrain.
60+
6. After import, you'll likely need to reposition the parent game object to sit above the terrain by offsetting the Y position to be above the terrain.
5661

5762
---
5863

tools/utilities/course-meshery.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,8 @@ nav_order: 2
2525

2626
---
2727

28+
<img src="/assets/course-building/meshery-window.png" />
29+
2830
### Generating Meshes
2931

3032
To generate your meshes:

0 commit comments

Comments
 (0)