sigonasr2
/
jmonkeyengine
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

removed NavMesh editor button from toolbar. Added constraint checks and javadoc to NavMeshGenerator

Browse Source 
git-svn-id: https://jmonkeyengine.googlecode.com/svn/trunk@9002 75d07b2b-3a1a-0410-a2c5-0572b91ccdca
3.0
bre..ns 13 years ago
parent 1547500b5a
commit 921f4a25c2
2 changed files with 130 additions and 4 deletions
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Show Stats Download Patch File Download Diff File
  1. 126
      sdk/jme3-navmesh-gen/src/com/jme3/gde/nmgen/NavMeshGenerator.java
  2. 8
      sdk/jme3-navmesh-gen/src/com/jme3/gde/nmgen/layer.xml

126
sdk/jme3-navmesh-gen/src/com/jme3/gde/nmgen/NavMeshGenerator.java
Unescape View File

@ -20,6 +20,10 @@ import org.critterai.nmgen.TriangleMesh;
import org.openide.DialogDisplayer;
import org.openide.NotifyDescriptor;
/**
* Generates the navigation mesh using the org.critterai.nmgen.NavmeshGenerator class.
*
*/
public class NavMeshGenerator implements Savable {
private org.critterai.nmgen.NavmeshGenerator nmgen;
@ -186,6 +190,7 @@ public class NavMeshGenerator implements Savable {
return mesh2;
}
/**
* @return The height resolution used when sampling the source mesh. Value must be > 0.
*/
@ -195,9 +200,12 @@ public class NavMeshGenerator implements Savable {
/**
* @param cellHeight - The height resolution used when sampling the source mesh. Value must be > 0.
* Constraints: > 0
*/
public void setCellHeight(float cellHeight) {
this.cellHeight = cellHeight;
if (this.cellHeight <= 0)
this.cellHeight = 0.001f;
}
/**
@ -209,15 +217,23 @@ public class NavMeshGenerator implements Savable {
/**
* @param cellSize - The width and depth resolution used when sampling the the source mesh.
* Constraints: > 0
*/
public void setCellSize(float cellSize) {
this.cellSize = cellSize;
if (this.cellSize <= 0)
this.cellSize = 0.001f;
}
public boolean isClipLedges() {
return clipLedges;
}
/**
* Indicates whether ledges should be marked as unwalkable.
* A ledge is a normally walkable voxel that has one or more accessible neighbors with a an un-steppable drop from voxel top to voxel top.
* E.g. If an agent using the navmesh were to travel down from the ledge voxel to its neighbor voxel, it would result in the maximum traversable step distance being violated. The agent cannot legally "step down" from a ledge to its neighbor.
*/
public void setClipLedges(boolean clipLedges) {
this.clipLedges = clipLedges;
}
@ -226,80 +242,167 @@ public class NavMeshGenerator implements Savable {
return contourMaxDeviation;
}
/**
* The maximum distance the surface of the navmesh may deviate from the surface of the original geometry.
* The accuracy of the algorithm which uses this value is impacted by the value of the contour sample distance argument.
* The value of this argument has no meaning if the contour sample distance argument is set to zero.
* Setting the value to zero is not recommended since it can result in a large increase in the number of triangles in the
* final navmesh at a high processing cost.
* Constraints: >= 0
*/
public void setContourMaxDeviation(float contourMaxDeviation) {
this.contourMaxDeviation = contourMaxDeviation;
if (this.contourMaxDeviation < 0)
this.contourMaxDeviation = 0.0f;
}
public float getContourSampleDistance() {
return contourSampleDistance;
}
/**
* Sets the sampling distance to use when matching the navmesh to the surface of the original geometry.
* Impacts how well the final mesh conforms to the original geometry's surface contour. Higher values result in
* a navmesh which conforms more closely to the original geometry's surface at the cost of a higher final triangle
* count and higher processing cost.
* Setting this argument to zero will disable this functionality.
* Constraints: >= 0
*/
public void setContourSampleDistance(float contourSampleDistance) {
this.contourSampleDistance = contourSampleDistance;
if (this.contourSampleDistance < 0)
this.contourSampleDistance = 0;
}
public float getEdgeMaxDeviation() {
return edgeMaxDeviation;
}
/**
* The maximum distance the edge of the navmesh may deviate from the source geometry.
* Setting this lower will result in the navmesh edges following the geometry contour more
* accurately at the expense of an increased triangle count.
* Setting the value to zero is not recommended since it can result in a large increase in
* the number of triangles in the final navmesh at a high processing cost.
* Constraints: >= 0
*/
public void setEdgeMaxDeviation(float edgeMaxDeviation) {
this.edgeMaxDeviation = edgeMaxDeviation;
if (this.edgeMaxDeviation < 0)
this.edgeMaxDeviation= 0;
}
public float getMaxEdgeLength() {
return maxEdgeLength;
}
/**
* The maximum length of polygon edges that represent the border of the navmesh.
* More vertices will be added to navmesh border edges if this value is exceeded for a
* particular edge. In certain cases this will reduce the number of thin, long triangles in the navmesh.
* A value of zero will disable this feature.
* Constraints: >= 0
*/
public void setMaxEdgeLength(float maxEdgeLength) {
this.maxEdgeLength = maxEdgeLength;
if (this.maxEdgeLength < 0)
this.maxEdgeLength= 0;
}
public float getMaxTraversableSlope() {
return maxTraversableSlope;
}
/**
* The maximum slope that is considered walkable. (Degrees)
* Constraints: 0 <= value <= 85
*/
public void setMaxTraversableSlope(float maxTraversableSlope) {
this.maxTraversableSlope = maxTraversableSlope;
if (this.maxTraversableSlope < 0)
this.maxTraversableSlope = 0;
if (this.maxTraversableSlope > 85)
this.maxTraversableSlope = 85;
}
public float getMaxTraversableStep() {
return maxTraversableStep;
}
/**
* Represents the maximum ledge height that is considered to still be walkable.
* Prevents minor deviations in height from improperly showing as obstructions. Permits detection of stair-like structures, curbs, etc.
* Constraints: >= 0
*/
public void setMaxTraversableStep(float maxTraversableStep) {
this.maxTraversableStep = maxTraversableStep;
if (this.maxTraversableStep < 0)
this.maxTraversableStep = 0;
}
public int getMaxVertsPerPoly() {
return maxVertsPerPoly;
}
/**
* The maximum number of vertices per polygon for polygons generated during the voxel to polygon conversion stage.
* Higher values reduce performance, but can also result in better formed triangles in the navmesh. A value of
* around 6 is generally adequate with diminishing returns for values higher than 6.
* Contraints: >= 3
*/
public void setMaxVertsPerPoly(int maxVertsPerPoly) {
this.maxVertsPerPoly = maxVertsPerPoly;
if (this.maxVertsPerPoly < 3)
this.maxVertsPerPoly = 3;
}
public int getMergeRegionSize() {
return mergeRegionSize;
}
/**
* Any regions smaller than this size will, if possible, be merged with larger regions. (Voxels)
* Helps reduce the number of unnecessarily small regions that can be formed. This is especially an issue in
* diagonal path regions where inherent faults in the region generation algorithm can result in unnecessarily
* small regions.
* If a region cannot be legally merged with a neighbor region, then it will be left alone.
* Constraints: >= 0
*/
public void setMergeRegionSize(int mergeRegionSize) {
this.mergeRegionSize = mergeRegionSize;
if (this.mergeRegionSize < 0)
this.mergeRegionSize = 0;
}
public float getMinTraversableHeight() {
return minTraversableHeight;
}
/**
* Represents the minimum floor to ceiling height that will still allow the floor area to be considered walkable.
* Permits detection of overhangs in the geometry which make the geometry below become unwalkable.
* Constraints: > 0
*/
public void setMinTraversableHeight(float minTraversableHeight) {
this.minTraversableHeight = minTraversableHeight;
if (this.minTraversableHeight <= 0)
this.minTraversableHeight = 0.001f;
}
public int getMinUnconnectedRegionSize() {
return minUnconnectedRegionSize;
}
/**
* The minimum region size for unconnected (island) regions. (Voxels)
* Any generated regions that are not connected to any other region and are smaller than this size will be
* culled before final navmesh generation. I.e. No longer considered walkable.
* Constraints: > 0
*/
public void setMinUnconnectedRegionSize(int minUnconnectedRegionSize) {
this.minUnconnectedRegionSize = minUnconnectedRegionSize;
if (this.minUnconnectedRegionSize <= 0)
this.minUnconnectedRegionSize = 1;
}
public NavmeshGenerator getNmgen() {
@ -314,22 +417,45 @@ public class NavMeshGenerator implements Savable {
return smoothingThreshold;
}
/**
* The amount of smoothing to be performed when generating the distance field.
* This value impacts region formation and border detection. A higher value results in generally
* larger regions and larger border sizes. A value of zero will disable smoothing.
* Constraints: 0 <= value <= 4
*/
public void setSmoothingThreshold(int smoothingThreshold) {
this.smoothingThreshold = smoothingThreshold;
if (this.smoothingThreshold < 0)
this.smoothingThreshold = 0;
if (this.smoothingThreshold > 4)
this.smoothingThreshold = 4;
}
public float getTraversableAreaBorderSize() {
return traversableAreaBorderSize;
}
/**
* Represents the closest any part of the navmesh can get to an obstruction in the source mesh.
* Usually set to the maximum bounding radius of entities utilizing the navmesh for navigation decisions.
* Constraints: >= 0
*/
public void setTraversableAreaBorderSize(float traversableAreaBorderSize) {
this.traversableAreaBorderSize = traversableAreaBorderSize;
if (this.traversableAreaBorderSize < 0)
this.traversableAreaBorderSize = 0;
}
public boolean isUseConservativeExpansion() {
return useConservativeExpansion;
}
/**
* Applies extra algorithms to regions to help prevent poorly formed regions from forming.
* If the navigation mesh is missing sections that should be present, then enabling this feature will likely
* fix the problem.
* Enabling this feature significantly increased processing cost.
*/
public void setUseConservativeExpansion(boolean useConservativeExpansion) {
this.useConservativeExpansion = useConservativeExpansion;
}

8
sdk/jme3-navmesh-gen/src/com/jme3/gde/nmgen/layer.xml
Unescape View File

@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE filesystem PUBLIC "-//NetBeans//DTD Filesystem 1.2//EN" "http://www.netbeans.org/dtds/filesystem-1_2.dtd">
<filesystem>
<folder name="Actions">
<!--folder name="Actions">
<folder name="NavMesh">
<file name="com-jme3-gde-nmgen-NavMeshAction.instance">
<attr name="delegate" methodvalue="org.openide.awt.Actions.inject"/>
@ -22,8 +22,8 @@
<attr name="instanceCreate" methodvalue="org.openide.windows.TopComponent.openAction"/>
</file>
</folder>
</folder>
<folder name="Toolbars">
</folder-->
<!--folder name="Toolbars">
<folder name="jMonkeyPlatform-Tools">
<file name="com-jme3-gde-nmgen-NavMeshAction.shadow">
<attr name="originalFile" stringvalue="Actions/NavMesh/com-jme3-gde-nmgen-NavMeshAction.instance"/>
@ -40,6 +40,6 @@
<file name="NavMeshTopComponent.wstcref" url="NavMeshTopComponentWstcref.xml"/>
</folder>
</folder>
</folder>
</folder-->
</filesystem>
Write Preview
Loading…
Cancel
Save