diff options
| author | Anton Novoselov <[email protected]> | 2017-08-08 20:14:22 +0300 |
|---|---|---|
| committer | Anton Novoselov <[email protected]> | 2017-08-08 20:14:22 +0300 |
| commit | d41654b469fa51870b5952c836c04d9da17f32d3 (patch) | |
| tree | 64f8f437eef394630355f281d35ca1d53e5c4d6c /docs/api_docs/files/pagesampleassetviewer.html | |
| parent | add +x for packman script (diff) | |
| download | blast-d41654b469fa51870b5952c836c04d9da17f32d3.tar.xz blast-d41654b469fa51870b5952c836c04d9da17f32d3.zip | |
Updated to CL 22627414:
* docs updates
* authoring fixes
* stress solver crash fixes
Diffstat (limited to 'docs/api_docs/files/pagesampleassetviewer.html')
| -rw-r--r-- | docs/api_docs/files/pagesampleassetviewer.html | 16 |
1 files changed, 9 insertions, 7 deletions
diff --git a/docs/api_docs/files/pagesampleassetviewer.html b/docs/api_docs/files/pagesampleassetviewer.html index a1ffa3d..d70eb79 100644 --- a/docs/api_docs/files/pagesampleassetviewer.html +++ b/docs/api_docs/files/pagesampleassetviewer.html @@ -35,9 +35,9 @@ To load multiple destructible models, use a config file. The viewer reads .xml c </pre></div><p> Running the application with no commandline arguments, the viewer will load <b>samples/resources/configs/assets.xml</b> by default. This file references the models in the subdirectories of <b>samples/resources/models</b>.<h2><a class="anchor" name="using_assetviewer"> Using SampleAssetViewer</a></h2> -Upon startup, the viewer will instance its first asset in its assets list. Using the default assets.xml, this is a brick will.<p> +Upon startup, the viewer will instance its first asset in its assets list. Using the default assets.xml, this is a brick wall.<p> The menu is displayed using an overlay on the left side of the screen. It is divided into many submenus, which are described below.<p> -In any scene, you may press <b>'F'</b> to fire a box into the scene in the direction the camer is pointing.<p> +In any scene, you may press <b>'F'</b> to fire a box into the scene in the direction the camera is pointing.<p> You may also press <b>SPACE</b> to toggle between damage and drag mode. (The mode is shown at the top of the screen.) In drag mode, dynamic objects can be manipulated by placing the mouse cursor over them, and using <b>Left Mouse / Drag</b> to pull on the object. In damage mode, <b>left-clicking</b> a destructible actor will apply damage to it.<p> You may select between three different damage tools using the <b>1, 2, and 3</b> keys. Each will color the damage sphere (shown at the mouse hit location) a different color:<p> <ul> @@ -52,17 +52,19 @@ Scene</a></h3> Here you can select which assets to add to the scene, set the material damage properties, and enable a stress solver.<p> In Replace mode (the default, set by radio button), selecting assets in the Assets list will remove all destructible actors from the scene and insert the selected one. In Append mode (the other radio button), selecting a new asset will insert its actor into the scene while keeping the others as well.<p> You may also select actors in the Scene Actors list, and remove (or reload) the actor using the buttons below the list. Reloading an actor will restore it to its unfractured state.<p> -Note, in addition to destructible actors, the Scene Actors list shows the boxes that were fired into the scene using the 'F' key. Holding down the 'F' key "charges" the throw, increasing the cube's speed the longer you hold down the kye. You may remove the cubes using the scene controls. All cubes will be removed when the scene is reset.<p> +Note, in addition to destructible actors, the Scene Actors list shows the boxes that were fired into the scene using the 'F' key. Holding down the 'F' key "charges" the throw, increasing the cube's speed the longer you hold down the key. You may remove the cubes using the scene controls. All cubes will be removed when the scene is reset.<p> The Blast Material properties are used by the various damage tools available.<p> <ul> <li>Health = the value which damage must exceed to break a bond or chunk</li><li>Min Damage Threshold = a fraction of Health, below which damage has no effect</li><li>Max Damage Threshold = a fraction of Health, equal to the maximum damage that can be applied per damage event</li></ul> <p> -A stress solver may be enabled by selcting the Stress Solver Enabled checkbox. When enabled you will be presented with several options. NOTE: you must then select the Stress Damage Enabled checkbox in order to allow stress to do damage to the actors in the scene. Bond Iterations Per Frame - is max amount of bonds allowed to be processed in one frame. The more this value the better quality of stress solver, but the time taken by it is increased linearly. You can check this timing in <em>Stats</em> submenu. Using this value stress solver takes fixed amount of CPU time on asset of any size. So the more asset complex (the more bonds it has) the less total iterations (on all bonds) are made. Use graph reduction level param to simplify stress graph for large assets. You can look at stress graph using by using <em>Debug</em> Render submenu. Stress linear and angular factors are corresponded for amount of damage to be applied on bonds from linear and angular momentum of stress on every bond.<p> -Replay control section allows to control recording and replaying Blast events. It demonstrates the usage of ExtSync extension. You may start/stop recording of blast events (damage, split). If you toggle to sync initial actors once recording starts full blast state is saved.<h3><a class="anchor" name="viewer_blast"> +A stress solver may be enabled by selcting the Stress Solver Enabled checkbox. When enabled, you will be presented with several options. NOTE: you must then select the Stress Damage Enabled checkbox in order to allow stress to do damage to the actors in the scene.<br> + Bond Iterations Per Frame - is max amount of bonds allowed to be processed in one frame. The higher this value, the better quality of stress solver, but the time taken by it is increased linearly. 9You can check this timing in <em>Stats</em> submenu.) Using this value stress solver takes a fixed amount of CPU time on assets of any size. So the more complex an asset is (the more bonds it has) the less total iterations (on all bonds) are made.<br> + Use graph reduction level param to simplify stress graph for large assets. You can look at stress graph by using the <em>Debug</em> Render submenu. Stress linear and angular factors are corresponded to the amount of damage to be applied on bonds from linear and angular momentum of stress on every bond.<p> +Replay control section allows to control recording and replaying Blast™ events. It demonstrates the usage of <a class="el" href="pageextphysx.html#ExtSync">ExtSync</a> extension. You may start/stop recording of Blast™ events (damage, split). If you toggle to sync initial actors, once recording starts, the full Blast™ state is saved.<h3><a class="anchor" name="viewer_blast"> Blast</a></h3> Here you may disable or enable impact damage, using the Impact Damage checkbox (on by default).<p> The Fragility setting is a multiplier that turns impact forces into damage amounts.<p> -You can toggle to pass impact damage to stress solver instead of just applying it with simple damage shader. Impact impulse will be passed to stress graph and damage will be applied accordingly to stress solver settings mentioned above.<p> +You can toggle to pass impact damage to stress solver instead of just applying it with simple damage shader. Impact impulse will be passed to stress graph and damage will be applied according to stress solver settings mentioned above.<p> When dragging static actors (with mouse dragging tool) stress impulse is also applied on stress graph. Use Dragging To Stress Factor to tune the amount.<p> You can limit rigid body count with next setting, all the actors created above this count will be ignored.<h3><a class="anchor" name="viewer_damage_tool"> Damage Tool</a></h3> @@ -82,7 +84,7 @@ You may select the debug render options from the Blast Debug Render Mode dropdow <li>Disabled = no debug rendering</li><li>Health Graph = draws bonds with color based upon bond health. Green = full health, red = low health.</li><li>Centroids = draws a line segment starting at each bond centroid, pointing in the direction of the bond normal. Also draws a square centered at the bond centroid, with the area of the bond.</li><li>Health Graph + Centroids = the two options above, combined.</li><li>Stress Graph = draws bonds with color based upon stress values. Green = low stress, red = high stress.</li><li>Stress Graph + Nodes Impulse = same as Stress Graph plus a line segment indicating the impulse applied to each graph node. The length of the segment is scaled by the Blast Debug Render Scale control. The green segments show the linear impulse, the red segments the rotational impulse.</li><li>Stress Graph + Bonds Impulse = same as Stress Graph plus a line segment indicating the impulse applied to each bond. The length of the segment is scaled by the Blast Debug Render Scale control. The green segments show the linear impulse, the red segments the rotational impulse.</li></ul> <h3><a class="anchor" name="viewer_physx"> PhysX</a></h3> -This menu controls PhysX simulation parameters. Here you may choose to use fixed time steps (off by default), and set the time step (if Use Fixed Timestep is checked) with the Fixed Timestep control.<p> +This menu controls PhysX™ simulation parameters. Here you may choose to use fixed time steps (off by default), and set the time step (if Use Fixed Timestep is checked) with the Fixed Timestep control.<p> If a suitable GPU is available, GPU Physics may be enabled using the Use GPU Physics control.<h3><a class="anchor" name="viewer_renderer"> Renderer</a></h3> Here you may change the lighting, shadow, and ambient occlusion (HBAO) options.<h3><a class="anchor" name="viewer_hints_help"> |