Skip to content

Commit

Permalink
updated images in placing assets page
Browse files Browse the repository at this point in the history
  • Loading branch information
CookieBadger committed Nov 6, 2023
1 parent 883a64b commit 5c6c711
Show file tree
Hide file tree
Showing 5 changed files with 5 additions and 5 deletions.
Binary file added images/ChangingSpawnParent_v2.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/PlacingAsset_v2.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/RotatingAndFlipping_v2.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/TransformingAsset_v2.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
10 changes: 5 additions & 5 deletions placing_assets.rst
Original file line number Diff line number Diff line change
Expand Up @@ -4,22 +4,22 @@ Placing Assets
The heart of this plugin is the feature to place assets in the 3D environment. Once you have :doc:`added assets to a library <adding_assets/>`, you can place instances of them in a 3D scne.
To do so, click on an asset in the asset palette. It becomes highlighted and once you now hover the mouse over the 3D world, you should see a preview of your asset under the mouse cursor (to explore the capabilities of the plugin with the default settings, make sure you position the viewport camera above the origin, looking slightly downwards).

.. image:: images/PlacingAsset.gif
.. image:: images/PlacingAsset_v2.gif

You can now click to place instances of your assets. They are being added to the scene tree under the selected spawn parent.
You can change the spawn parent in the AssetPlacer UI, by dragging a node from the scene tree onto the "Spawn Under" field, or by selecting a node and then clicking the button next to "Spawn Under".

.. image:: images/ChangingSpawnParent.gif
.. image:: images/ChangingSpawnParent_v2.gif

You can keep placing more instances of your selected asset or select a different asset from the palette. If you want to stop placing assets, press :kbd:`Esc` to deselect the asset.
In case you then want to select the same asset again, you can press the :kbd:`Space`, to select the last asset again.
In case you then want to select the same asset again, you can press :kbd:`Space`, to select the last asset again.
If you want to place an asset and select it, to apply some transformations or modifications to the instance, you can use :kbd:`Alt+Click`.

If you want to transform not just the current instance of the asset you are placing, but all instances you are placing, you can select the asset and press :kbd:`E` to rotate or :kbd:`R` to scale, while hovering over the viewport.
You can apply the desired changes and then press :kbd:`Space` to confirm. In case you want to cancel your changes, press :kbd:`Esc`. Notice that transformations persist when you deselect and select your asset again.
If you want to reset the transformation of your asset entirely, press :kbd:`Shift+E`, or click the little reset button that will have appeared on the asset in the asset panel.

.. image:: images/TransformingAsset.gif
.. image:: images/TransformingAsset_v2.gif

You can also apply some quick transformations by using shortcuts. With :kbd:`A`, :kbd:`S`, and :kbd:`D` you can rotate your asset by 90 degrees on the X, Y, and Z axes.
Using the :kbd:`Shift` modifier, the rotation step is halved to 45 degrees. You can change the amount of rotation when holding :kbd:`Shift` in the :doc:`Project Settings <settings/>` under ``AssetPlacer -> Settings``.
Expand All @@ -28,7 +28,7 @@ You can also flip your asset by inverting scale components along the X, Y and Z
..
only if gif can also show keys
..
.. image:: images/RotatingAndFlipping.gif
.. image:: images/RotatingAndFlipping_v2.gif

Of course, the plugin would be very limited, if you could only place on the XZ plane. You can change the plane you are placing on, or place on physics surfaces instead. Refer to :doc:`placement_modes` for more information.

Expand Down

0 comments on commit 5c6c711

Please sign in to comment.