Scarfski/recastnavigation
1
0
Fork 0
mirror of https://github.com/recastnavigation/recastnavigation.git synced 2026-08-30 15:08:55 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
4829bffd3257cd64a69d7f784ea4554d18d1f1fd
recastnavigation/structrcConfig.html

550 lines
42 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.9.1"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Recast Navigation: rcConfig Struct Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="navtree.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="resize.js"></script>
<script type="text/javascript" src="navtreedata.js"></script>
<script type="text/javascript" src="navtree.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
<link href="doxygen-awesome.css" rel="stylesheet" type="text/css"/>
<link href="doxygen-awesome-sidebar-only.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">Recast Navigation
</div>
<div id="projectbrief">Navigation-mesh Toolset for Games</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.1 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
var searchBox = new SearchBox("searchBox", "search",false,'Search','.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
/* @license-end */</script>
<div id="main-nav"></div>
</div><!-- top -->
<div id="side-nav" class="ui-resizable side-nav-resizable">
<div id="nav-tree">
<div id="nav-tree-contents">
<div id="nav-sync" class="sync"></div>
</div>
</div>
<div id="splitbar" style="-moz-user-select:none;"
class="ui-resizable-handle">
</div>
</div>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&amp;dn=gpl-2.0.txt GPL-v2 */
$(document).ready(function(){initNavTree('structrcConfig.html',''); initResizable(); });
/* @license-end */
</script>
<div id="doc-content">
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
<div class="header">
<div class="summary">
<a href="#pub-attribs">Public Attributes</a> &#124;
<a href="structrcConfig-members.html">List of all members</a> </div>
<div class="headertitle">
<div class="title">rcConfig Struct Reference<div class="ingroups"><a class="el" href="group__recast.html">Recast</a></div></div> </div>
</div><!--header-->
<div class="contents">
<p>Specifies a configuration to use when performing Recast builds.
<a href="structrcConfig.html#details">More...</a></p>
<p><code>#include &lt;<a class="el" href="Recast_8h_source.html">Recast.h</a>&gt;</code></p>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-attribs"></a>
Public Attributes</h2></td></tr>
<tr class="memitem:aa870882b1addeb37535185740838eb32"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#aa870882b1addeb37535185740838eb32">width</a></td></tr>
<tr class="memdesc:aa870882b1addeb37535185740838eb32"><td class="mdescLeft">&#160;</td><td class="mdescRight">The width of the field along the x-axis. [Limit: &gt;= 0] [Units: vx]. <a href="structrcConfig.html#aa870882b1addeb37535185740838eb32">More...</a><br /></td></tr>
<tr class="separator:aa870882b1addeb37535185740838eb32"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a25cdb5fcddc1d2813eca2462f60c13d1"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#a25cdb5fcddc1d2813eca2462f60c13d1">height</a></td></tr>
<tr class="memdesc:a25cdb5fcddc1d2813eca2462f60c13d1"><td class="mdescLeft">&#160;</td><td class="mdescRight">The height of the field along the z-axis. [Limit: &gt;= 0] [Units: vx]. <a href="structrcConfig.html#a25cdb5fcddc1d2813eca2462f60c13d1">More...</a><br /></td></tr>
<tr class="separator:a25cdb5fcddc1d2813eca2462f60c13d1"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ac011c6166e1c722dd07427a7c301a601"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#ac011c6166e1c722dd07427a7c301a601">tileSize</a></td></tr>
<tr class="memdesc:ac011c6166e1c722dd07427a7c301a601"><td class="mdescLeft">&#160;</td><td class="mdescRight">The width/height size of tile's on the xz-plane. [Limit: &gt;= 0] [Units: vx]. <a href="structrcConfig.html#ac011c6166e1c722dd07427a7c301a601">More...</a><br /></td></tr>
<tr class="separator:ac011c6166e1c722dd07427a7c301a601"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a473ec0f080862d2593099d8ee207da57"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#a473ec0f080862d2593099d8ee207da57">borderSize</a></td></tr>
<tr class="memdesc:a473ec0f080862d2593099d8ee207da57"><td class="mdescLeft">&#160;</td><td class="mdescRight">The size of the non-navigable border around the heightfield. [Limit: &gt;=0] [Units: vx]. <a href="structrcConfig.html#a473ec0f080862d2593099d8ee207da57">More...</a><br /></td></tr>
<tr class="separator:a473ec0f080862d2593099d8ee207da57"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ae74c4bd2b0477f29a65a53ca9c59196d"><td class="memItemLeft" align="right" valign="top">float&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#ae74c4bd2b0477f29a65a53ca9c59196d">cs</a></td></tr>
<tr class="memdesc:ae74c4bd2b0477f29a65a53ca9c59196d"><td class="mdescLeft">&#160;</td><td class="mdescRight">The xz-plane cell size to use for fields. [Limit: &gt; 0] [Units: wu]. <a href="structrcConfig.html#ae74c4bd2b0477f29a65a53ca9c59196d">More...</a><br /></td></tr>
<tr class="separator:ae74c4bd2b0477f29a65a53ca9c59196d"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:acdde0dfdbb39611966ece78ef473d861"><td class="memItemLeft" align="right" valign="top">float&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#acdde0dfdbb39611966ece78ef473d861">ch</a></td></tr>
<tr class="memdesc:acdde0dfdbb39611966ece78ef473d861"><td class="mdescLeft">&#160;</td><td class="mdescRight">The y-axis cell size to use for fields. [Limit: &gt; 0] [Units: wu]. <a href="structrcConfig.html#acdde0dfdbb39611966ece78ef473d861">More...</a><br /></td></tr>
<tr class="separator:acdde0dfdbb39611966ece78ef473d861"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:afb77489af4eb0cd75ceb8b46db2c4341"><td class="memItemLeft" align="right" valign="top">float&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#afb77489af4eb0cd75ceb8b46db2c4341">bmin</a> [3]</td></tr>
<tr class="memdesc:afb77489af4eb0cd75ceb8b46db2c4341"><td class="mdescLeft">&#160;</td><td class="mdescRight">The minimum bounds of the field's AABB. [(x, y, z)] [Units: wu]. <a href="structrcConfig.html#afb77489af4eb0cd75ceb8b46db2c4341">More...</a><br /></td></tr>
<tr class="separator:afb77489af4eb0cd75ceb8b46db2c4341"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ab33657eac12a119d583422c4c00c6892"><td class="memItemLeft" align="right" valign="top">float&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#ab33657eac12a119d583422c4c00c6892">bmax</a> [3]</td></tr>
<tr class="memdesc:ab33657eac12a119d583422c4c00c6892"><td class="mdescLeft">&#160;</td><td class="mdescRight">The maximum bounds of the field's AABB. [(x, y, z)] [Units: wu]. <a href="structrcConfig.html#ab33657eac12a119d583422c4c00c6892">More...</a><br /></td></tr>
<tr class="separator:ab33657eac12a119d583422c4c00c6892"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a689373b55bb5fab1d3284b716e972fe0"><td class="memItemLeft" align="right" valign="top">float&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#a689373b55bb5fab1d3284b716e972fe0">walkableSlopeAngle</a></td></tr>
<tr class="memdesc:a689373b55bb5fab1d3284b716e972fe0"><td class="mdescLeft">&#160;</td><td class="mdescRight">The maximum slope that is considered walkable. [Limits: 0 &lt;= value &lt; 90] [Units: Degrees]. <a href="structrcConfig.html#a689373b55bb5fab1d3284b716e972fe0">More...</a><br /></td></tr>
<tr class="separator:a689373b55bb5fab1d3284b716e972fe0"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a2483649686584b9d696ac00b968dedaa"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#a2483649686584b9d696ac00b968dedaa">walkableHeight</a></td></tr>
<tr class="memdesc:a2483649686584b9d696ac00b968dedaa"><td class="mdescLeft">&#160;</td><td class="mdescRight">Minimum floor to 'ceiling' height that will still allow the floor area to be considered walkable. <a href="structrcConfig.html#a2483649686584b9d696ac00b968dedaa">More...</a><br /></td></tr>
<tr class="separator:a2483649686584b9d696ac00b968dedaa"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a9b6bbabb4857e3f4bf4428af86ee7673"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#a9b6bbabb4857e3f4bf4428af86ee7673">walkableClimb</a></td></tr>
<tr class="memdesc:a9b6bbabb4857e3f4bf4428af86ee7673"><td class="mdescLeft">&#160;</td><td class="mdescRight">Maximum ledge height that is considered to still be traversable. [Limit: &gt;=0] [Units: vx]. <a href="structrcConfig.html#a9b6bbabb4857e3f4bf4428af86ee7673">More...</a><br /></td></tr>
<tr class="separator:a9b6bbabb4857e3f4bf4428af86ee7673"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a57a961a919d76559d6124d60ddf73864"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#a57a961a919d76559d6124d60ddf73864">walkableRadius</a></td></tr>
<tr class="memdesc:a57a961a919d76559d6124d60ddf73864"><td class="mdescLeft">&#160;</td><td class="mdescRight">The distance to erode/shrink the walkable area of the heightfield away from obstructions. <a href="structrcConfig.html#a57a961a919d76559d6124d60ddf73864">More...</a><br /></td></tr>
<tr class="separator:a57a961a919d76559d6124d60ddf73864"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a2149036442bf38b9ec9615549aa48fd4"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#a2149036442bf38b9ec9615549aa48fd4">maxEdgeLen</a></td></tr>
<tr class="memdesc:a2149036442bf38b9ec9615549aa48fd4"><td class="mdescLeft">&#160;</td><td class="mdescRight">The maximum allowed length for contour edges along the border of the mesh. [Limit: &gt;=0] [Units: vx]. <a href="structrcConfig.html#a2149036442bf38b9ec9615549aa48fd4">More...</a><br /></td></tr>
<tr class="separator:a2149036442bf38b9ec9615549aa48fd4"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a3421826332c0acfbbdfa34ee6c7183d1"><td class="memItemLeft" align="right" valign="top">float&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#a3421826332c0acfbbdfa34ee6c7183d1">maxSimplificationError</a></td></tr>
<tr class="memdesc:a3421826332c0acfbbdfa34ee6c7183d1"><td class="mdescLeft">&#160;</td><td class="mdescRight">The maximum distance a simplified contour's border edges should deviate the original raw contour. <a href="structrcConfig.html#a3421826332c0acfbbdfa34ee6c7183d1">More...</a><br /></td></tr>
<tr class="separator:a3421826332c0acfbbdfa34ee6c7183d1"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:af91c92dd5bb5ebf51a85b194917062ec"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#af91c92dd5bb5ebf51a85b194917062ec">minRegionArea</a></td></tr>
<tr class="memdesc:af91c92dd5bb5ebf51a85b194917062ec"><td class="mdescLeft">&#160;</td><td class="mdescRight">The minimum number of cells allowed to form isolated island areas. [Limit: &gt;=0] [Units: vx]. <a href="structrcConfig.html#af91c92dd5bb5ebf51a85b194917062ec">More...</a><br /></td></tr>
<tr class="separator:af91c92dd5bb5ebf51a85b194917062ec"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ac2385e0a316304cd7b1c563cf9f7dd59"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#ac2385e0a316304cd7b1c563cf9f7dd59">mergeRegionArea</a></td></tr>
<tr class="memdesc:ac2385e0a316304cd7b1c563cf9f7dd59"><td class="mdescLeft">&#160;</td><td class="mdescRight">Any regions with a span count smaller than this value will, if possible, be merged with larger regions. <a href="structrcConfig.html#ac2385e0a316304cd7b1c563cf9f7dd59">More...</a><br /></td></tr>
<tr class="separator:ac2385e0a316304cd7b1c563cf9f7dd59"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a055d0ed71c79c9af29424de5d0cf3d2d"><td class="memItemLeft" align="right" valign="top">int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#a055d0ed71c79c9af29424de5d0cf3d2d">maxVertsPerPoly</a></td></tr>
<tr class="memdesc:a055d0ed71c79c9af29424de5d0cf3d2d"><td class="mdescLeft">&#160;</td><td class="mdescRight">The maximum number of vertices allowed for polygons generated during the contour to polygon conversion process. <a href="structrcConfig.html#a055d0ed71c79c9af29424de5d0cf3d2d">More...</a><br /></td></tr>
<tr class="separator:a055d0ed71c79c9af29424de5d0cf3d2d"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:abdc131d1c8f5e4c1f09a68702efba604"><td class="memItemLeft" align="right" valign="top">float&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#abdc131d1c8f5e4c1f09a68702efba604">detailSampleDist</a></td></tr>
<tr class="memdesc:abdc131d1c8f5e4c1f09a68702efba604"><td class="mdescLeft">&#160;</td><td class="mdescRight">Sets the sampling distance to use when generating the detail mesh. <a href="structrcConfig.html#abdc131d1c8f5e4c1f09a68702efba604">More...</a><br /></td></tr>
<tr class="separator:abdc131d1c8f5e4c1f09a68702efba604"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ae53de5fcf0777c0be9e3cd91c9da3d1f"><td class="memItemLeft" align="right" valign="top">float&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="structrcConfig.html#ae53de5fcf0777c0be9e3cd91c9da3d1f">detailSampleMaxError</a></td></tr>
<tr class="memdesc:ae53de5fcf0777c0be9e3cd91c9da3d1f"><td class="mdescLeft">&#160;</td><td class="mdescRight">The maximum distance the detail mesh surface should deviate from heightfield data. <a href="structrcConfig.html#ae53de5fcf0777c0be9e3cd91c9da3d1f">More...</a><br /></td></tr>
<tr class="separator:ae53de5fcf0777c0be9e3cd91c9da3d1f"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Description</h2>
<div class="textblock"><p>Specifies a configuration to use when performing Recast builds. </p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>The is a convenience structure that represents an aggregation of parameters used at different stages in the Recast build process. Some values are derived during the build process. Not all parameters are used for all build processes.</p>
<p>Units are usually in voxels (vx) or world units (wu). The units for voxels, grid size, and cell size are all based on the values of <a class="el" href="structrcConfig.html#ae74c4bd2b0477f29a65a53ca9c59196d" title="The xz-plane cell size to use for fields. [Limit: &gt; 0] [Units: wu].">cs</a> and <a class="el" href="structrcConfig.html#acdde0dfdbb39611966ece78ef473d861" title="The y-axis cell size to use for fields. [Limit: &gt; 0] [Units: wu].">ch</a>.</p>
<p>In this documentation, the term 'field' refers to heightfield and contour data structures that define spacial information using an integer grid.</p>
<p>The upper and lower limits for the various parameters often depend on the platform's floating point accuraccy as well as interdependencies between the values of multiple parameters. See the individual parameter documentation for details.</p>
<dl class="section note"><dt>Note</dt><dd>First you should decide the size of your agent's logical cylinder. If your game world uses meters as units, a reasonable starting point for a human-sized agent might be a radius of <code>0.4</code> and a height of <code>2.0</code>. </dd></dl>
</div><h2 class="groupheader">Member Data Documentation</h2>
<a id="ab33657eac12a119d583422c4c00c6892"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ab33657eac12a119d583422c4c00c6892">&#9670;&nbsp;</a></span>bmax</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">float rcConfig::bmax[3]</td>
</tr>
</table>
</div><div class="memdoc">
<p>The maximum bounds of the field's AABB. [(x, y, z)] [Units: wu]. </p>
</div>
</div>
<a id="afb77489af4eb0cd75ceb8b46db2c4341"></a>
<h2 class="memtitle"><span class="permalink"><a href="#afb77489af4eb0cd75ceb8b46db2c4341">&#9670;&nbsp;</a></span>bmin</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">float rcConfig::bmin[3]</td>
</tr>
</table>
</div><div class="memdoc">
<p>The minimum bounds of the field's AABB. [(x, y, z)] [Units: wu]. </p>
</div>
</div>
<a id="a473ec0f080862d2593099d8ee207da57"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a473ec0f080862d2593099d8ee207da57">&#9670;&nbsp;</a></span>borderSize</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">rcConfig::borderSize</td>
</tr>
</table>
</div><div class="memdoc">
<p>The size of the non-navigable border around the heightfield. [Limit: &gt;=0] [Units: vx]. </p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>This value represents the the closest the walkable area of the heightfield should come to the xz-plane AABB of the field. It does not have any impact on the borders around internal obstructions. </p>
</div>
</div>
<a id="acdde0dfdbb39611966ece78ef473d861"></a>
<h2 class="memtitle"><span class="permalink"><a href="#acdde0dfdbb39611966ece78ef473d861">&#9670;&nbsp;</a></span>ch</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">rcConfig::ch</td>
</tr>
</table>
</div><div class="memdoc">
<p>The y-axis cell size to use for fields. [Limit: &gt; 0] [Units: wu]. </p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>The voxelization cell height <a class="el" href="structrcConfig.html#acdde0dfdbb39611966ece78ef473d861" title="The y-axis cell size to use for fields. [Limit: &gt; 0] [Units: wu].">ch</a> is defined separately in order to allow for greater precision in height tests. A good starting point for <a class="el" href="structrcConfig.html#acdde0dfdbb39611966ece78ef473d861" title="The y-axis cell size to use for fields. [Limit: &gt; 0] [Units: wu].">ch</a> is half the <a class="el" href="structrcConfig.html#ae74c4bd2b0477f29a65a53ca9c59196d" title="The xz-plane cell size to use for fields. [Limit: &gt; 0] [Units: wu].">cs</a> value. Smaller <a class="el" href="structrcConfig.html#acdde0dfdbb39611966ece78ef473d861" title="The y-axis cell size to use for fields. [Limit: &gt; 0] [Units: wu].">ch</a> values ensure that the navmesh properly connects areas that are only separated by a small curb or ditch. If small holes are generated in your navmesh around where there are discontinuities in height (for example, stairs or curbs), you may want to decrease the cell height value to increase the vertical rasterization precision of Recast.</p>
<p><a class="el" href="structrcConfig.html#ae74c4bd2b0477f29a65a53ca9c59196d" title="The xz-plane cell size to use for fields. [Limit: &gt; 0] [Units: wu].">cs</a> and <a class="el" href="structrcConfig.html#acdde0dfdbb39611966ece78ef473d861" title="The y-axis cell size to use for fields. [Limit: &gt; 0] [Units: wu].">ch</a> define voxel/grid/cell size. So their values have significant side effects on all parameters defined in voxel units.</p>
<p>The minimum value for this parameter depends on the platform's floating point accuracy, with the practical minimum usually around 0.05. </p>
</div>
</div>
<a id="ae74c4bd2b0477f29a65a53ca9c59196d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ae74c4bd2b0477f29a65a53ca9c59196d">&#9670;&nbsp;</a></span>cs</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">rcConfig::cs</td>
</tr>
</table>
</div><div class="memdoc">
<p>The xz-plane cell size to use for fields. [Limit: &gt; 0] [Units: wu]. </p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>The voxelization cell size <a class="el" href="structrcConfig.html#ae74c4bd2b0477f29a65a53ca9c59196d" title="The xz-plane cell size to use for fields. [Limit: &gt; 0] [Units: wu].">cs</a> defines the voxel size along both axes of the ground plane: x and z in Recast. This value is usually derived from the character radius <code>r</code>. A recommended starting value for <a class="el" href="structrcConfig.html#ae74c4bd2b0477f29a65a53ca9c59196d" title="The xz-plane cell size to use for fields. [Limit: &gt; 0] [Units: wu].">cs</a> is either <code>r/2</code> or <code>r/3</code>. Smaller values of <a class="el" href="structrcConfig.html#ae74c4bd2b0477f29a65a53ca9c59196d" title="The xz-plane cell size to use for fields. [Limit: &gt; 0] [Units: wu].">cs</a> will increase rasterization resolution and navmesh detail, but total generation time will increase exponentially. In outdoor environments, <code>r/2</code> is often good enough. For indoor scenes with tight spaces you might want the extra precision, so a value of <code>r/3</code> or smaller may give better results.</p>
<p>The initial instinct is to reduce this value to something very close to zero to maximize the detail of the generated navmesh. This quickly becomes a case of diminishing returns, however. Beyond a certain point there's usually not much perceptable difference in the generated navmesh, but huge increases in generation time. This hinders your ability to quickly iterate on level designs and provides little benefit. The general recommendation here is to use as large a value for <a class="el" href="structrcConfig.html#ae74c4bd2b0477f29a65a53ca9c59196d" title="The xz-plane cell size to use for fields. [Limit: &gt; 0] [Units: wu].">cs</a> as you can get away with.</p>
<p><a class="el" href="structrcConfig.html#ae74c4bd2b0477f29a65a53ca9c59196d" title="The xz-plane cell size to use for fields. [Limit: &gt; 0] [Units: wu].">cs</a> and <a class="el" href="structrcConfig.html#acdde0dfdbb39611966ece78ef473d861" title="The y-axis cell size to use for fields. [Limit: &gt; 0] [Units: wu].">ch</a> define voxel/grid/cell size. So their values have significant side effects on all parameters defined in voxel units.</p>
<p>The minimum value for this parameter depends on the platform's floating point accuracy, with the practical minimum usually around 0.05. </p>
</div>
</div>
<a id="abdc131d1c8f5e4c1f09a68702efba604"></a>
<h2 class="memtitle"><span class="permalink"><a href="#abdc131d1c8f5e4c1f09a68702efba604">&#9670;&nbsp;</a></span>detailSampleDist</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">float rcConfig::detailSampleDist</td>
</tr>
</table>
</div><div class="memdoc">
<p>Sets the sampling distance to use when generating the detail mesh. </p>
<p>(For height detail only.) [Limits: 0 or &gt;= 0.9] [Units: wu] <br />
</p>
</div>
</div>
<a id="ae53de5fcf0777c0be9e3cd91c9da3d1f"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ae53de5fcf0777c0be9e3cd91c9da3d1f">&#9670;&nbsp;</a></span>detailSampleMaxError</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">float rcConfig::detailSampleMaxError</td>
</tr>
</table>
</div><div class="memdoc">
<p>The maximum distance the detail mesh surface should deviate from heightfield data. </p>
<p>(For height detail only.) [Limit: &gt;=0] [Units: wu] <br />
</p>
</div>
</div>
<a id="a25cdb5fcddc1d2813eca2462f60c13d1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a25cdb5fcddc1d2813eca2462f60c13d1">&#9670;&nbsp;</a></span>height</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int rcConfig::height</td>
</tr>
</table>
</div><div class="memdoc">
<p>The height of the field along the z-axis. [Limit: &gt;= 0] [Units: vx]. </p>
</div>
</div>
<a id="a2149036442bf38b9ec9615549aa48fd4"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2149036442bf38b9ec9615549aa48fd4">&#9670;&nbsp;</a></span>maxEdgeLen</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">rcConfig::maxEdgeLen</td>
</tr>
</table>
</div><div class="memdoc">
<p>The maximum allowed length for contour edges along the border of the mesh. [Limit: &gt;=0] [Units: vx]. </p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>In certain cases, long outer edges may decrease the quality of the resulting triangulation, creating very long thin triangles. This can sometimes be remedied by limiting the maximum edge length, causing the problematic long edges to be broken up into smaller segments.</p>
<p>The parameter <a class="el" href="structrcConfig.html#a2149036442bf38b9ec9615549aa48fd4" title="The maximum allowed length for contour edges along the border of the mesh. [Limit: &gt;=0] [Units: vx].">maxEdgeLen</a> defines the maximum edge length and is defined in terms of voxels. A good value for <a class="el" href="structrcConfig.html#a2149036442bf38b9ec9615549aa48fd4" title="The maximum allowed length for contour edges along the border of the mesh. [Limit: &gt;=0] [Units: vx].">maxEdgeLen</a> is something like <code>walkableRadius * 8</code>. A good way to adjust this value is to first set it really high and see if your data creates long edges. If it does, decrease <a class="el" href="structrcConfig.html#a2149036442bf38b9ec9615549aa48fd4" title="The maximum allowed length for contour edges along the border of the mesh. [Limit: &gt;=0] [Units: vx].">maxEdgeLen</a> until you find the largest value which improves the resulting tesselation.</p>
<p>Extra vertices will be inserted as needed to keep contour edges below this length. A value of zero effectively disables this feature. </p>
</div>
</div>
<a id="a3421826332c0acfbbdfa34ee6c7183d1"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a3421826332c0acfbbdfa34ee6c7183d1">&#9670;&nbsp;</a></span>maxSimplificationError</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">rcConfig::maxSimplificationError</td>
</tr>
</table>
</div><div class="memdoc">
<p>The maximum distance a simplified contour's border edges should deviate the original raw contour. </p>
<p>[Limit: &gt;=0] [Units: vx]</p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>When the rasterized areas are converted back to a vectorized representation, the <a class="el" href="structrcConfig.html#a3421826332c0acfbbdfa34ee6c7183d1" title="The maximum distance a simplified contour&#39;s border edges should deviate the original raw contour.">maxSimplificationError</a> describes how loosely the simplification is done. The simplification process uses the <a href="https://en.wikipedia.org/wiki/Ramer–Douglas–Peucker_algorithm">Ramer–Douglas-Peucker algorithm</a>, and this value describes the max deviation in voxels.</p>
<p>Good values for <a class="el" href="structrcConfig.html#a3421826332c0acfbbdfa34ee6c7183d1" title="The maximum distance a simplified contour&#39;s border edges should deviate the original raw contour.">maxSimplificationError</a> are in the range <code>[1.1, 1.5]</code>. <br />
A value of <code>1.3</code> is a good starting point and usually yields good results. If the value is less than <code>1.1</code>, some sawtoothing starts to appear at the generated edges. If the value is more than <code>1.5</code>, the mesh simplification starts to cut some corners it shouldn't.</p>
<p>The effect of this parameter only applies to the xz-plane. </p>
</div>
</div>
<a id="a055d0ed71c79c9af29424de5d0cf3d2d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a055d0ed71c79c9af29424de5d0cf3d2d">&#9670;&nbsp;</a></span>maxVertsPerPoly</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">rcConfig::maxVertsPerPoly</td>
</tr>
</table>
</div><div class="memdoc">
<p>The maximum number of vertices allowed for polygons generated during the contour to polygon conversion process. </p>
<p>[Limit: &gt;= 3] <br />
</p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>If the mesh data is to be used to construct a Detour navigation mesh, then the upper limit is limited to &lt;= <a class="el" href="group__detour.html#ga8591fdac662dbfabb580de626c64c9f3" title="The maximum number of vertices per navigation polygon.">DT_VERTS_PER_POLYGON</a>. </p>
</div>
</div>
<a id="ac2385e0a316304cd7b1c563cf9f7dd59"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ac2385e0a316304cd7b1c563cf9f7dd59">&#9670;&nbsp;</a></span>mergeRegionArea</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">rcConfig::mergeRegionArea</td>
</tr>
</table>
</div><div class="memdoc">
<p>Any regions with a span count smaller than this value will, if possible, be merged with larger regions. </p>
<p>[Limit: &gt;=0] [Units: vx] <br />
</p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>The triangulation process works best with small, localized voxel regions. The parameter <a class="el" href="structrcConfig.html#ac2385e0a316304cd7b1c563cf9f7dd59" title="Any regions with a span count smaller than this value will, if possible, be merged with larger region...">mergeRegionArea</a> controls the maximum voxel area of a region that is allowed to be merged with another region. If you see small patches missing here and there, you could lower the <a class="el" href="structrcConfig.html#af91c92dd5bb5ebf51a85b194917062ec" title="The minimum number of cells allowed to form isolated island areas. [Limit: &gt;=0] [Units: vx].">minRegionArea</a> value. </p>
</div>
</div>
<a id="af91c92dd5bb5ebf51a85b194917062ec"></a>
<h2 class="memtitle"><span class="permalink"><a href="#af91c92dd5bb5ebf51a85b194917062ec">&#9670;&nbsp;</a></span>minRegionArea</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">rcConfig::minRegionArea</td>
</tr>
</table>
</div><div class="memdoc">
<p>The minimum number of cells allowed to form isolated island areas. [Limit: &gt;=0] [Units: vx]. </p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>Watershed partitioning is really prone to noise in the input distance field. In order to get nicer areas, the areas are merged and small disconnected areas are removed after the water shed partitioning. The parameter <a class="el" href="structrcConfig.html#af91c92dd5bb5ebf51a85b194917062ec" title="The minimum number of cells allowed to form isolated island areas. [Limit: &gt;=0] [Units: vx].">minRegionArea</a> describes the minimum isolated region size that is still kept. A region is removed if the number of voxels in the region is less than the square of <a class="el" href="structrcConfig.html#af91c92dd5bb5ebf51a85b194917062ec" title="The minimum number of cells allowed to form isolated island areas. [Limit: &gt;=0] [Units: vx].">minRegionArea</a>.</p>
<p>Any regions that are smaller than this area will be marked as unwalkable. This is useful in removing useless regions that can sometimes form on geometry such as table tops, box tops, etc. </p>
</div>
</div>
<a id="ac011c6166e1c722dd07427a7c301a601"></a>
<h2 class="memtitle"><span class="permalink"><a href="#ac011c6166e1c722dd07427a7c301a601">&#9670;&nbsp;</a></span>tileSize</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">rcConfig::tileSize</td>
</tr>
</table>
</div><div class="memdoc">
<p>The width/height size of tile's on the xz-plane. [Limit: &gt;= 0] [Units: vx]. </p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>This field is only used when building multi-tile meshes. </p>
</div>
</div>
<a id="a9b6bbabb4857e3f4bf4428af86ee7673"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a9b6bbabb4857e3f4bf4428af86ee7673">&#9670;&nbsp;</a></span>walkableClimb</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">rcConfig::walkableClimb</td>
</tr>
</table>
</div><div class="memdoc">
<p>Maximum ledge height that is considered to still be traversable. [Limit: &gt;=0] [Units: vx]. </p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>The <a class="el" href="structrcConfig.html#a9b6bbabb4857e3f4bf4428af86ee7673" title="Maximum ledge height that is considered to still be traversable. [Limit: &gt;=0] [Units: vx].">walkableClimb</a> value defines the maximum height of ledges and steps that the agent can walk up. Given a designer-defined <code>maxClimb</code> distance in world units, the value of <a class="el" href="structrcConfig.html#a9b6bbabb4857e3f4bf4428af86ee7673" title="Maximum ledge height that is considered to still be traversable. [Limit: &gt;=0] [Units: vx].">walkableClimb</a> should be calculated as <code>ceil(maxClimb / ch)</code>. <br />
Note that this is using <a class="el" href="structrcConfig.html#acdde0dfdbb39611966ece78ef473d861" title="The y-axis cell size to use for fields. [Limit: &gt; 0] [Units: wu].">ch</a> not <a class="el" href="structrcConfig.html#ae74c4bd2b0477f29a65a53ca9c59196d" title="The xz-plane cell size to use for fields. [Limit: &gt; 0] [Units: wu].">cs</a> because it's a height-based value.</p>
<p>Allows the mesh to flow over low lying obstructions such as curbs and up/down stairways. The value is usually set to how far up/down an agent can step. </p>
</div>
</div>
<a id="a2483649686584b9d696ac00b968dedaa"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2483649686584b9d696ac00b968dedaa">&#9670;&nbsp;</a></span>walkableHeight</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">rcConfig::walkableHeight</td>
</tr>
</table>
</div><div class="memdoc">
<p>Minimum floor to 'ceiling' height that will still allow the floor area to be considered walkable. </p>
<p>[Limit: &gt;= 3] [Units: vx] <br />
</p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>This value defines the worldspace height <code>h</code> of the agent in voxels. Th value of <a class="el" href="structrcConfig.html#a2483649686584b9d696ac00b968dedaa" title="Minimum floor to &#39;ceiling&#39; height that will still allow the floor area to be considered walkable.">walkableHeight</a> should be calculated as <code>ceil(h / ch)</code>. Note this is based on <a class="el" href="structrcConfig.html#acdde0dfdbb39611966ece78ef473d861" title="The y-axis cell size to use for fields. [Limit: &gt; 0] [Units: wu].">ch</a> not <a class="el" href="structrcConfig.html#ae74c4bd2b0477f29a65a53ca9c59196d" title="The xz-plane cell size to use for fields. [Limit: &gt; 0] [Units: wu].">cs</a> since it's a height value.</p>
<p>Permits detection of overhangs in the source geometry that make the geometry below un-walkable. The value is usually set to the maximum agent height. </p>
</div>
</div>
<a id="a57a961a919d76559d6124d60ddf73864"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a57a961a919d76559d6124d60ddf73864">&#9670;&nbsp;</a></span>walkableRadius</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">rcConfig::walkableRadius</td>
</tr>
</table>
</div><div class="memdoc">
<p>The distance to erode/shrink the walkable area of the heightfield away from obstructions. </p>
<p>[Limit: &gt;=0] [Units: vx] <br />
</p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>The parameter <a class="el" href="structrcConfig.html#a57a961a919d76559d6124d60ddf73864" title="The distance to erode/shrink the walkable area of the heightfield away from obstructions.">walkableRadius</a> defines the worldspace agent radius <code>r</code> in voxels. <br />
Most often, this value of <a class="el" href="structrcConfig.html#a57a961a919d76559d6124d60ddf73864" title="The distance to erode/shrink the walkable area of the heightfield away from obstructions.">walkableRadius</a> should be calculated as <code>ceil(r / cs)</code>. Note this is based on <a class="el" href="structrcConfig.html#ae74c4bd2b0477f29a65a53ca9c59196d" title="The xz-plane cell size to use for fields. [Limit: &gt; 0] [Units: wu].">cs</a> since the agent radius is always parallel to the ground plane.</p>
<p>If the <a class="el" href="structrcConfig.html#a57a961a919d76559d6124d60ddf73864" title="The distance to erode/shrink the walkable area of the heightfield away from obstructions.">walkableRadius</a> value is greater than zero, the edges of the navmesh will be pushed away from all obstacles by this amount.</p>
<p>A non-zero <a class="el" href="structrcConfig.html#a57a961a919d76559d6124d60ddf73864" title="The distance to erode/shrink the walkable area of the heightfield away from obstructions.">walkableRadius</a> allows for much simpler runtime navmesh collision checks. The game only needs to check that the center point of the agent is contained within a navmesh polygon. Without this erosion, runtime navigation checks need to collide the geometric projection of the agent's logical cylinder onto the navmesh with the boundary edges of the navmesh polygons.</p>
<p>In general, this is the closest any part of the final mesh should get to an obstruction in the source geometry. It is usually set to the maximum agent radius.</p>
<p>If you want to have tight-fitting navmesh, or want to reuse the same navmesh for multiple agents with differing radii, you can use a <code>walkableRadius</code> value of zero. Be advised though that you will need to perform your own collisions with the navmesh edges, and odd edge cases issues in the mesh generation can potentially occur. For these reasons, specifying a radius of zero is allowed but is not recommended. </p>
</div>
</div>
<a id="a689373b55bb5fab1d3284b716e972fe0"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a689373b55bb5fab1d3284b716e972fe0">&#9670;&nbsp;</a></span>walkableSlopeAngle</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">rcConfig::walkableSlopeAngle</td>
</tr>
</table>
</div><div class="memdoc">
<p>The maximum slope that is considered walkable. [Limits: 0 &lt;= value &lt; 90] [Units: Degrees]. </p>
<dl class="section user"><dt></dt><dd></dd></dl>
<p>The parameter <a class="el" href="structrcConfig.html#a689373b55bb5fab1d3284b716e972fe0" title="The maximum slope that is considered walkable. [Limits: 0 &lt;= value &lt; 90] [Units: Degrees].">walkableSlopeAngle</a> is to filter out areas of the world where the ground slope would be too steep for an agent to traverse. This value is defined as a maximum angle in degrees that the surface normal of a polgyon can differ from the world's up vector. This value must be within the range <code>[0, 90]</code>.</p>
<p>The practical upper limit for this parameter is usually around 85 degrees. </p>
</div>
</div>
<a id="aa870882b1addeb37535185740838eb32"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aa870882b1addeb37535185740838eb32">&#9670;&nbsp;</a></span>width</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int rcConfig::width</td>
</tr>
</table>
</div><div class="memdoc">
<p>The width of the field along the x-axis. [Limit: &gt;= 0] [Units: vx]. </p>
</div>
</div>
<hr/>The documentation for this struct was generated from the following files:<ul>
<li><a class="el" href="Recast_8h_source.html">Recast.h</a></li>
<li><a class="el" href="Recast__api_8txt.html">Recast_api.txt</a></li>
</ul>
</div><!-- contents -->
</div><!-- doc-content -->
<!-- HTML footer for doxygen 1.8.6-->
<!-- start footer part -->
<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
<ul>
<li class="navelem"><a class="el" href="structrcConfig.html">rcConfig</a></li>
&nbsp;&nbsp;<a href="https://github.com/recastnavigation/recastnavigation">Project Home</a>
| <a href="./License.txt">Licence (ZLib)</a>
| Copyright 2009 Mikko Mononen
</ul>
</div>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink