Upload 3 files

active_spline.rst.txt

@@ -0,0 +1,80 @@
+
+*************
+Active Spline
+*************
+
+.. admonition:: Reference
+   :class: refbox
+
+   :Mode:      Edit Mode
+   :Menu:      :menuselection:`Properties --> Curve --> Active Spline`
+
+.. seealso:
+
+   :doc:`Active Spline </modeling/curves/properties/active_spline>` for curves.
+
+The *Active Spline* panel is used in Edit Mode to control properties of the currently selected spline.
+
+.. figure:: /images/modeling_surfaces_properties_active-spline-panel.png
+   :align: center
+
+   Active Spline panel.
+
+Cyclic U/V
+   Like curves, surfaces can be closed (cyclical) or open, independently in both directions,
+   allowing you to easily create a tube, donut or sphere shape,
+   and they can be viewed as "solids" in *Edit Mode*.
+   This can be set per interpolation axis.
+Bézier U
+   Makes the surface act like a Bézier curve.
+   The control points act like *Free* handles of a Bézier curve.
+   Depending on the *Order*, 3 or 4 control points form one spline segment.
+   This can be set per interpolation axis.
+   *Cyclic* and *Endpoint* must be disabled for this option to work.
+Endpoint U/V
+   Makes the surface contact the end control points.
+   This can be set per interpolation axis.
+   *Cyclic* must be disabled for this option to work.
+
+   .. figure:: /images/modeling_surfaces_properties_endpoint.png
+      :align: center
+      :width: 50%
+
+      Endpoint U.
+
+   In the image below, the U interpolation axis is labeled as "U"
+   and the V interpolation axis is labeled as "V".
+   The U's interpolation axis has been set to *Endpoint*
+   and as such the surface now extends to the outer edges from
+   E1 to E2 along the U interpolation axis.
+
+   To cause the surface to extend to all edges,
+   *Endpoint* would be set for the V's axis as well.
+Order U/V
+   This property is the same as with :ref:`NURBS Curves <modeling-curve-order>`;
+   it specifies how much the control points are taken into account for calculating the curve of the surface shape.
+   For high Orders 1 the surface pulls away from the control points,
+   creating a smoother surface by assuming that the *Resolution U/V* is high enough.
+   For lowest Orders 2 the surface follows the control points,
+   creating a surface that tends to follow the grid cage.
+
+   .. _fig-surface-intro-order:
+
+   .. figure:: /images/modeling_surfaces_properties_order.png
+      :align: center
+      :width: 50%
+
+      Order 2 and Order 4 surface.
+
+   For illustration purposes, in both Fig. :ref:`fig-surface-intro-order`,
+   the knot vectors were set to *Endpoint*, causing the surface to extend to all edges.
+
+   You can set independently the order for each interpolation axis,
+   and like curves, it **cannot** be lower than 2,
+   and higher than 6 or the number of control points on the relevant axis.
+Resolution U/V
+   Alters the :ref:`resolution <bpy.types.Curve.resolution_v>`
+   of each segment by changing the number of subdivisions.
+   This can be set per interpolation axis.
+Smooth
+   Use :ref:`Smooth Shading <modeling-meshes-editing-normals-shading>` for any 3D geometry.

index.rst.txt

@@ -1,17 +1,10 @@
-.. _modeling-surfaces-index:
-.. _bpy.ops.surface:
 
-############
-  Surfaces
-############
+##############
+  Properties
+##############
 
 .. toctree::
    :maxdepth: 2
 
-   introduction.rst
-   toolbar/index.rst
-   structure.rst
-   primitives.rst
-   selecting.rst
-   editing/index.rst
-   properties/index.rst
+   shape.rst
+   active_spline.rst

shape.rst.txt

@@ -0,0 +1,45 @@
+
+*****
+Shape
+*****
+
+.. figure:: /images/modeling_surfaces_properties_resolution-panel.png
+   :align: center
+
+   Shape panel.
+
+.. _bpy.types.Curve.resolution_v:
+
+Resolution Preview U/V
+   Resolution to use in the 3D Viewport.
+Render U/V
+   Just like :ref:`NURBS curves <curve-nurbs>`, *Resolution* controls the detail of the surface.
+   The higher the *Resolution* the more detailed and smoother the surface is.
+   The lower the *Resolution* the rougher the surface. However, here you have two resolution settings,
+   one for each interpolation axis (U and V).
+
+   You can adjust the resolution separately for both preview and render,
+   to not slow things down in the viewport, but still get good render results.
+
+   .. list-table::
+
+      * - .. figure:: /images/modeling_surfaces_properties_resolution-1x1-wire.png
+
+             Resolution 1×1.
+
+        - .. figure:: /images/modeling_surfaces_properties_resolution-3x3-wire.png
+
+             Resolution 3×3.
+
+      * - .. figure:: /images/modeling_surfaces_properties_resolution-1x1.png
+
+             Resolution of 1 for both U and V.
+
+        - .. figure:: /images/modeling_surfaces_properties_resolution-3x3.png
+
+             Resolution of 3 for both U and V.
+
+.. seealso::
+
+   The panels of the *Curve and Surface* tab are the same as for
+   :doc:`curves </modeling/curves/introduction>`, just with fewer options...