[Bf-docboard-svn] bf-manual: [7518] trunk/blender_docs/manual: add-ons blenderkit: clean up 2

Tobias Heinke noreply at blender.org
Tue Dec 29 02:22:23 CET 2020 

Revision: 7518
          https://developer.blender.org/rBM7518
Author:   TobiasH
Date:     2020-12-29 02:22:22 +0100 (Tue, 29 Dec 2020)
Log Message:
-----------
add-ons blenderkit: clean up 2

Modified Paths:
--------------
    trunk/blender_docs/manual/addons/3d_view/blenderkit.rst
    trunk/blender_docs/manual/files/data_blocks.rst
    trunk/blender_docs/manual/getting_started/help.rst
    trunk/blender_docs/manual/interface/controls/buttons/menus.rst
    trunk/blender_docs/manual/modeling/modifiers/nodes/attribute/attribute_fill.rst
    trunk/blender_docs/manual/movie_clip/tracking/clip/editing/clip.rst

Modified: trunk/blender_docs/manual/addons/3d_view/blenderkit.rst
===================================================================
--- trunk/blender_docs/manual/addons/3d_view/blenderkit.rst	2020-12-28 20:17:46 UTC (rev 7517)
+++ trunk/blender_docs/manual/addons/3d_view/blenderkit.rst	2020-12-29 01:22:22 UTC (rev 7518)
@@ -25,20 +25,19 @@
 ===========
 
 #. Type a search term into the search field.
+
+   .. figure:: /images/addons_3d-view_blenderkit_search-sidebar.jpg
+      :width: 300px
+
 #. The result are shown in the Assetbar.
-#. Drag-and-drop the material or model into your scene.
 
-.. figure:: /images/addons_3d-view_blenderkit_search-sidebar.jpg
-   :align: center
-   :width: 300px
+   .. figure:: /images/addons_3d-view_blenderkit_assetbar.jpg
+      :width: 300px
 
-.. figure:: /images/addons_3d-view_blenderkit_assetbar.jpg
-   :align: center
-   :width: 300px
+#. Drag-and-drop the material or model into your scene.
 
-.. figure:: /images/addons_3d-view_blenderkit_drag-drop.jpg
-   :align: center
-   :width: 300px
+   .. figure:: /images/addons_3d-view_blenderkit_drag-drop.jpg
+      :width: 300px
 
 
 Interface
@@ -59,23 +58,22 @@
    :align: center
    :width: 600px
 
-Assetbar shows search results and allows users to interact with them.
-The Assetbar pops up when the search results are retrieved from the server.
-It can be shown or hidden by clicking the toggle with the eye icon next to the search field.
+The Assetbar shows search results and allows you to interact with them.
+It pops up when the search results are retrieved from the server.
+The Assetbar can be shown or hidden by clicking the toggle with the eye icon next to the search field.
 
 Actions that can be performed in the Assetbar:
 
 - Drag and dropping an object or material directly into the scene.
-- Click a result to link/append it to the scene.
-- Open the context menu of a result for further interaction:
+- Click a item to link/append it to the scene.
+- Open the context menu of a item for further interaction:
 
   Open Authors Website
-     Opens a web browser and goes to the web presentation that the author specified.
+      Opens the link that the author has specified in a web browser.
   Show Assets by Author
      Shows all assets uploaded by the author of the selected 3D model.
   Replace Active Models
-     You need to select several assets to use this option from the Selected Model panel.
-     All those selected will be replaced with the last asset selected (active).
+     Replace all selected assets with the last selected asset (active).
      If you use this option from the context menu, the target asset is downloaded and replaces selected assets.
 
 - Use the :kbd:`Wheel` to scroll the results.
@@ -94,10 +92,10 @@
    :align: right
    :width: 300px
 
-This panel shows the user's login information and information about the user's public and private remaining storage.
+This panel shows your login information and information about your public and private remaining storage.
 
 See My Uploads
-   Open the BlenderKit website and show a list of the author's assets.
+   Open the BlenderKit website and show a list of your assets.
 
 
 BlenderKit Login Panel
@@ -120,7 +118,7 @@
 .. _bpy.ops.wm.blenderkit_logout:
 
 Log Out
-   Log out from BlenderKit immediately.
+   Log out from BlenderKit.
 
 
 Find and Upload Assets Panel
@@ -138,7 +136,7 @@
 The main panel enables you to Search or Upload all supported asset types.
 
 Search/Upload
-   Switch the main panel between Search and Upload functionality.
+   Switch the main panel between the Search and Upload tabs.
 
 
 Search and Download
@@ -153,26 +151,23 @@
    :align: right
    :width: 300px
 
-
 Models/Materials/Brushes
-^^^^^^^^^^^^^^^^^^^^^^^^
+   Switch between asset types available in BlenderKit.
 
-Switch between asset types available in BlenderKit.
+These controls are common for all asset types:
 
-These fields are common for all asset types:
-
 .. _bpy.ops.view3d.blenderkit_search:
 
 Search
    Search assets by name.
 Show (eye icon) :kbd:`;`
-   Show/hide Assetbar interface.
+   Show/hide the Assetbar viewport overlay.
 Style
    Search filter limiting the results (realistic, painted, polygonal, and other).
 
 
-Options Visible for Models Search
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Models Search Options
+^^^^^^^^^^^^^^^^^^^^^
 
 .. admonition:: Reference
    :class: refbox
@@ -189,38 +184,37 @@
 Free Only
    Show only free models. This option is available only for models, since all Materials and all Brushes are free.
 
-Search filters subpanel:
+Search Filters:
+   .. _bpy.data.scenes.blenderkit_models.search_condition:
 
-.. _bpy.data.scenes.blenderkit_models.search_condition:
+   Condition
+      Condition of the object.
 
-Condition
-   Condition of the object.
+      New, Used, Old, Desolate
 
-   New, Used, Old, Desolate
+   .. _bpy.data.scenes.blenderkit_models.search_design_year:
 
-.. _bpy.data.scenes.blenderkit_models.search_design_year:
+   Designed In (min - max)
+      When the object was approximately designed in terms of *year*.
+      Can be used for parallel worlds or future :abbr:`sci-fi (Science Fiction)` dates
+      (search for sci-fi assets by entering 2100 as minimum year).
 
-Designed In (min - max)
-   When the object was approximately designed in terms of *year*.
-   Can be used for parallel worlds or future :abbr:`sci-fi (Science Fiction)` dates
-   (search for sci-fi assets by entering 2100 as minimum year).
+   .. _bpy.data.scenes.blenderkit_models.search_polycount:
 
-.. _bpy.data.scenes.blenderkit_models.search_polycount:
+   Poly Count In (min - max)
+      Use the poly count of 3D object for filtering.
 
-Poly Count In (min - max)
-   Use the poly count of 3D object for filtering.
+   .. _bpy.data.scenes.blenderkit_models.search_texture_resolution:
 
-.. _bpy.data.scenes.blenderkit_models.search_texture_resolution:
+   Texture Resolution (min - max)
+      Limit search to the texture resolutions in a range.
 
-Texture Resolution (min - max)
-   Limit search to the texture resolutions in a range.
+   .. _bpy.data.scenes.blenderkit_models.search_file_size:
 
-.. _bpy.data.scenes.blenderkit_models.search_file_size:
+   File Size (min - max)
+      Limit search file size. This uses the basic file size of the original file.
 
-File Size (min - max)
-   Limit search file size. This uses the basic file size of the original file.
 
-
 Categories
 ^^^^^^^^^^
 
@@ -280,8 +274,8 @@
    Limit perpendicular snap.
 
 
-Options Visible for Materials Search:
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Materials Search Options
+^^^^^^^^^^^^^^^^^^^^^^^^
 
 .. admonition:: Reference
    :class: refbox
@@ -328,11 +322,11 @@
 .. _bpy.data.scenes.blenderkit_mat.automap:
 
 Auto-Map
-   Add cube mapping UV to the object after drag drop.
+   Add cube mapping UV to the object after drag-and-drop.
    This allows most materials to be applied instantly to any mesh.
    BlenderKit generates a new UV map called 'automap', and doesn't replace your previous UV maps.
-   The action also resets texture space of the target object to (1.0, 1.0, 1.0).
-   This enables most procedural materials to have correct scaling.
+   It also resets the texture space of the target object to (1, 1, 1)
+   which enables most procedural materials to have correct scaling.
 
 
 Upload
@@ -342,8 +336,8 @@
    Switch between asset types which are available to upload in BlenderKit.
 
 
-Common Options for All Assets Types
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Common Options
+^^^^^^^^^^^^^^
 
 .. figure:: /images/addons_3d-view_blenderkit_sidebar-upload-model-public-design.jpg
    :align: right
@@ -350,7 +344,7 @@
    :width: 300px
 
 Hide Asset Preview
-   Show/Hide asset preview, which shows how approximately will the asset look for people searching the database.
+   Show/Hide asset preview, which shows how the asset will approximately look for people searching the database.
 
 .. _bpy.ops.wm.url_open:
 
@@ -362,26 +356,25 @@
 
 Upload
    Upload or re-upload the 3D model.
-   In the operator you can choose if you want to update the files.
-   If both file and thumbnail are off, only metadata gets updated.
+   In the operator you can choose if you want to update the file.
+   If both file and thumbnail are deactivated, only the metadata get updated.
 Category
-   Main category to place the model into.
+   The main category to place the model into.
 Subcategory
-   Subcategory to place the model into.
+   The subcategory to place the model into.
 
 .. _bpy.data.materials.blenderkit.is_private:
 
 Private/Public
-   Set the assets privacy. Assets marked as Public go into
-   the `Validation <https://www.blenderkit.com/docs/validation-status>`__
-   process automatically. Private assets will be hidden to the public.
-   Private assets are limited by a quota.
+   Set the assets privacy. Assets marked as Public will be automatically submitted into
+   the `Validation <https://www.blenderkit.com/docs/validation-status>`__ process.
+   Private assets will be hidden to the public and are limited in quantity by a quota.
 
 .. _bpy.data.materials.blenderkit.license:
 
 License
    BlenderKit offers two `licenses <https://www.blenderkit.com/docs/licenses>`__ for the assets.
-   Both licenses allow for non-commercial and commercial use.
+   Both licenses allow for commercial and non-commercial use.
 
    :Royalty free: Royalty-free commercial license
    :Creative Commons Zero: Creative Commons Zero
@@ -398,7 +391,7 @@
 .. _bpy.data.materials.blenderkit.thumbnail:
 
 Thumbnail
-   Thumbnail. Path to the thumbnail a square image (at least 512×512 JPG image).
+   The path to the preview image (square, at least 512×512 px, JPG image).
 
 Generate Thumbnail
    Automatically generate a thumbnail for the 3D model assets.
@@ -414,8 +407,8 @@
    List of tags, separated by commas. Include at least three tags.
 
 
-Options Specific for Models
-^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Models Only Options
+^^^^^^^^^^^^^^^^^^^
 
 .. _bpy.objects.blenderkit.style:
 
@@ -435,16 +428,16 @@
 .. _bpy.objects.blenderkit.production_level:
 
 Production Level
-   Production state of the asset. Also template should be actually finished,
+   Production state of the asset. Also templates should be actually finished,
    just the nature of it can be a template, like a thumbnail scene,
    finished mesh topology as start for modeling or similar:
 
    :Finished:
-      For public database, the asset should always be ready for rendering.

@@ Diff output truncated at 10240 characters. @@

More information about the Bf-docboard-svn mailing list