aboutsummaryrefslogtreecommitdiff
path: root/docs/api_docs/files/pageintroduction.html
diff options
context:
space:
mode:
authorAnton Novoselov <[email protected]>2017-08-01 12:53:38 +0300
committerAnton Novoselov <[email protected]>2017-08-01 12:53:38 +0300
commit236f03c0b9a4982328ed1201978f7f69d192d9b2 (patch)
treee486f2fa39dba203563895541e92c60ed3e25759 /docs/api_docs/files/pageintroduction.html
parentAdded screens to welcome page (diff)
downloadblast-236f03c0b9a4982328ed1201978f7f69d192d9b2.tar.xz
blast-236f03c0b9a4982328ed1201978f7f69d192d9b2.zip
Blast 1.1 release (windows / linux)
see docs/release_notes.txt for details
Diffstat (limited to 'docs/api_docs/files/pageintroduction.html')
-rw-r--r--docs/api_docs/files/pageintroduction.html11
1 files changed, 6 insertions, 5 deletions
diff --git a/docs/api_docs/files/pageintroduction.html b/docs/api_docs/files/pageintroduction.html
index 5c3bedc..9016338 100644
--- a/docs/api_docs/files/pageintroduction.html
+++ b/docs/api_docs/files/pageintroduction.html
@@ -1,6 +1,6 @@
<html>
<head>
- <title>NVIDIA(R) Blast(R) SDK 1.0 API Reference: Introduction</title>
+ <title>NVIDIA(R) Blast(R) SDK 1.1 API Reference: Introduction</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<LINK HREF="NVIDIA.css" REL="stylesheet" TYPE="text/css">
</head>
@@ -28,12 +28,13 @@ The static data associated with a destructible is stored in an <em>asset</em>. A
Chunks are defined hierarchically, so that when a chunk is fractured its child chunks are created. The user may tag any chunk in this hierarchy as a <em>support</em> chunk. This is covered in more detail in the <a class="el" href="pageintroduction.html#support_model">Support Model</a> section. The user also supplies a description of the connections between support chunks. A <em>bond</em> represents the surface joining neighboring chunks. A bond is represented by a surface centroid, an average surface normal, and the surface area. These quantities don't need to be exact for Blast&trade; to operate effectively.<p>
Multiple chunk hierarchies may exist in a single asset. The <em>root chunks</em> (see <a class="el" href="pagedefinitions.html">Definitions</a>) will be visible when the asset is initially instanced. Subsequent fracturing has the effect of breaking the root chunks into their hierarchical descendants.<h2><a class="anchor" name="support_model">
Support Model</a></h2>
-Blast&trade; requires that support chunks form an <em>exact cover</em> (see the definition of exact coverage in <a class="el" href="pagedefinitions.html">Definitions</a>). However, it is quite forgiving with respect to user input when creating an asset. The geometric interpretation of exact coverage is that the support chunks fill the space of the root (unfractured) chunk, without any volume being covered by more than one chunk. Upon asset creation, missing coverage will be filled in by Blast&trade;, by assigning support to chunks at the highest place possible (closest to root) in the hierarchy. If support is redundant, that is a chunk and one of its descendant chunks are both marked as support by the user, then Blast&trade; will remove support from the descendant chunk.<p>
-Support chunks that are joined by bonds will be grouped together in the same actor when fracturing occurs. In order to take advantage of the chunk hieararchy to reduce the number of chunks which represent an actor physically and graphically, Blast&trade; calculates a list of <em>visible chunks</em> from the support chunks in an actor. These may be the support chunks, or they may be ancestors of support chunks if all descendant support chunks are in the actor.<p>
-Support chunks do not have to be leaves in the chunk hierarchy, nor do they have to be at the same depth in the hierarchy. Children of support chunks will always be the sole chunk in their actor, since there is no bond defined between them. If an actor consists of of a <em>subsupport chunk</em> (see <a class="el" href="pagedefinitions.html">Definitions</a>), the visible chunk is the same chunk.<h2><a class="anchor" name="damage_model">
+Blast&trade; requires that support chunks form an <em>exact cover</em> (see the definition of exact coverage in <a class="el" href="pagedefinitions.html">Definitions</a>). The geometric interpretation of exact coverage is that the support chunks fill the space of the root (unfractured) chunk, without any volume being covered by more than one chunk. A helper function are provided to modify a set of chunk descriptors so that they have exact coverage. This function fills in missing coverage by assigning support to chunks at the highest place possible (closest to root) in the hierarchy, and redundant support is removed: if a chunk and one of its descendant chunks are both marked as support, the function will remove support from the descendant chunk.<p>
+Support chunks that are joined by bonds will be grouped together in the same actor when fracturing occurs. Bonds may be defined between any two support chunks, or between a support chunk and "the world." There is no corresponding "world chunk," but the bond represents a connection between the chunk and its external environment. All chunks with a support graph connected to the world will be put into the same actor. An expected use case is to make this actor static (or kinematic). Actors may be queried to determine if they are "world-bound."<p>
+In order to take advantage of the chunk hieararchy to reduce the number of chunks which represent an actor physically and graphically, Blast&trade; calculates a list of <em>visible chunks</em> from the support chunks in an actor. These may be the support chunks, or they may be ancestors of support chunks if all descendant support chunks are in the actor.<p>
+Support chunks do not have to be leaves in the chunk hierarchy, nor do they have to be at the same depth in the hierarchy. Children of support chunks will always be the sole chunk in their actor, since there are no bonds defined between them. If an actor consists of a <em>subsupport chunk</em> (see <a class="el" href="pagedefinitions.html">Definitions</a>), the visible chunk is the same chunk. The same is true if an actor consists of a <em>single</em> support chunk.<h2><a class="anchor" name="damage_model">
Damage Model</a></h2>
Damage is defined as loss of an actor's material integrity. This is modeled by a simple health value associated with the bonds and chunks in the support graph. The user applies damage to an actor at a given location, with a maximum effect radius. The resulting loss of bond and chunk health is determined by a user-defined <em>material function</em>. In this way the user can customize the effect of damage based upon the bonds' properties such as normal and area, as well as distance from impact location.<p>
-Damage is applied from a damage event buffer. After all damage events are processed, bonds with non-positive healths are considered to be broken. Blast&trade; performs island detection on the support graph to find all groups of support chunks that are connected by unbroken bonds, and any new islands found result in new actors.<p>
+Damage is applied during the processing of a damage event buffer. After all damage events are processed, bonds with non-positive healths are considered to be broken. Blast&trade; performs island detection on the support graph to find all groups of support chunks that are connected by unbroken bonds, and any new islands found result in new actors.<p>
If an actor is composed of a single support or subsupport chunk with subsupport descendants, then there is no bond structure to model damage. Instead, such a chunk is considered to have its own health value, which may be decreased by damage. When such a lower-support (see <a class="el" href="pagedefinitions.html">Definitions</a>) chunk's health is non-positive, its associated actor is deleted and replaced by actors that represent its child chunks, if any.<p>
The effect of damage on leaf chunks depends upon which API is used. The low-level API does not delete leaf chunks. It is up to the user to delete them, and manage their physical and graphical representation outside of Blast&trade; if so desired.<h2><a class="anchor" name="backwards_compatibility">
Backwards Compatibility</a></h2>