Differences

This shows you the differences between two versions of the page.

--- doc:user:geometry:user:surfaces [2015/01/07 17:05] – boman
+++ doc:user:geometry:user:surfaces [2016/11/14 10:30] (current) – [Open Surface of revolution] wautelet
@@ Line 10: / Line 10: @@
 ===== Plane =====
-{{ doc:user:doc-plan.png?300|}}
+{{ doc:user:doc-plan.png |}}
 A plane is defined by three points:
   plane = surfaceset.add( Plane(number, p1, p2, p3) )
-Its normal (and therefore the surface orientation) is calculated using the cross product of vectors
+with
+| ''number''               | user number (unique among surfaces and $\ge 1$) |
+| ''p1'', ''p2'', ''p3''   | the 3 ''[[Points]]'' lying on the plane |
+Its normal (and therefore the surface orientation) is computed using the cross product of vectors
 $\boldsymbol{p_2}-\boldsymbol{p_1}$ et $\boldsymbol{p_3}-\boldsymbol{p_1}$.
-| ''p1'', ''p2'', ''p3''   | 3  ''[[Points]]'' lying on the plane |
-\\
-\\
-\\
-\\
 ===== Coons =====
-{{ doc:user:doc-coons.png|}}
+{{ doc:user:doc-coons.png |}}
 A Coons' surface is a linear interpolation between four ''Curves''. These ''Curves'' are gathered in a closed ''Wire''. The ''Wire'' orientation defines the surface orientation.
@@ Line 37: / Line 30: @@
   coons = surfaceset.add( Coons(number, wire) )
-| ''wire''   | ''[[contours|Wire]]'' |
+with
+| ''number'' | user number (unique among surfaces and $\ge 1$) |
-\\
+| ''wire''   | the ''[[contours|Wire]]'' which is interpolated |
-\\
-\\
-\\
-\\
-\\
-\\
-\\
@@ Line 54: / Line 39: @@
 A ruled surface is defined by linearly interpolating two curves. The orientation of these curves sets the surface orientation.
-{{ doc:user:doc-ruled.png|}}
+{{ doc:user:doc-ruled.png |}}
   ruled = surfaceset.add( Ruled(number, curve1, curve2) )
-| ''curve1'', ''curve2'', ...         | the 2 ''[[courbes|Curves]]'' |
+with
+| ''number'' | user number (unique among surfaces and $\ge 1$) |
+| ''curve1'', ''curve2'', ...         | the 2 facing ''[[courbes|Curves]]'' |
 Ruled surfaces can be used to create planes, if the two ''Curves'' are coplanar ''Lines'', or cylinders if the curves are ''Arcs''.
-\\
-\\
-\\
-\\
-\\
-\\
-\\
-\\
-\\
-\\
@@ Line 78: / Line 53: @@
 ===== NURBS =====
-{{ doc:user:doc-snurbs.png|}}
+{{ doc:user:doc-snurbs.png |}}
   nur = surfaceset.add( NurbsSurface(number) )
   nur.setDegreeU(degU)
   nur.setDegreeV(degV)
-  nur.push(i1,j1,p1); nur.pushWeight(i1,j1,w1)
+  nur.push(i1, j1, p1); nur.pushWeight(i1, j1, w1)
   nur.push(i2, j2, p2); nur.pushWeight(i2, j2, w2)
   nur.pushKnotU(knotu1)
@@ Line 90: / Line 65: @@
   nur.pushKnotV(knotv1)
   ...
   nur.pushKnotV(knotv2)
+with
+| ''number'' | user number (unique among surfaces and $\ge 1$) |
 | ''degU'', ''degV''          | degree along U and V                    |
 | ''i1'', ''j1'', ''i2'', ''j2'', ... | indices of the pole matrix      |
@@ Line 99: / Line 76: @@
 | ''knotv1'', ''knotv2'', ... | knot vector along V                     |
-===== Surface of revolution =====
+===== Closed Surface of revolution =====
-{{ doc:user:doc-revol.png|}}
+{{ doc:user:doc-revol.png |}}
   revsur = surfaceset.add( RevolutionSurface(number, axe, wire) )
-where
+with
+| ''number'' | user number (unique among surfaces and $\ge 1$) |
+| ''axe''                    | ''[[courbes|Line]]'' which defines the revolution axis |
+| ''wire''                   | ''[[contours|Wire]]'' which will rotate along the revolution axis (it cannot intersect the axis on its first point and must be coplanar with it). |
+===== Open Surface of revolution =====
+  openrevsur = surfaceset.add( OpenRevolutionSurface(number, axe, wire, angle) )
+with
+| ''number'' | User number (unique among surfaces and $\ge 1$) |
 | ''axe''                    | ''[[courbes|Line]]'' which defines the revolution axis |
 | ''wire''                   | ''[[contours|Wire]]'' which will rotate along the revolution axis (it cannot intersect the axis on its first point and must be coplanar with it). |
+| ''angle'' | Opening angle $]0, 2 \pi[$ |
+===== Sphere  =====
-\\
+  c = Sphere(number, centerPoint, radius, reversed)
-\\
-\\
-\\
-\\
-\\
-==== Cylinder ====
+with
+| ''number'' | user number (unique among surfaces and $\ge 1$) |
+| ''centerPoint'' | sphere center (Point previously defined in the Pointset !)|
+| ''radius''    | sphere radius |
+| ''reversed''  | unit normal convention - By default (reversed = false), the local covariant tangents are  oriented in such a manner that the unit normal points inwards ! |
+===== Cylinder =====
   c = Cylinder(number, axis, radius, ptGen) # First way to use Cylinder
@@ Line 125: / Line 114: @@
   c.setProjType(projType)
-where
+with
+| ''number'' | user number (unique among surfaces and $\ge 1$) |
 | ''axis''       | ''[[courbes|Line]]'' which defines the cylinder axis |
 | ''radius''    | cylinder radius |
 | ''ptGen''     | optional ''[[doc:user:geometry:user:points|Point]]'' of the generating line of the cylinder. This point must be situated: \\ - in a plane perpendicular to the axis including the first point of the axis, \\ - to a distance equal to the cylinder radius of the first point of the axis. \\ Since this point is quite difficult to define when the cylinder is not parallel to an axis, a random point can be supplied and Metafor will put it in its right place with a ''WARNING_MESSAGE'' (see ''apps.qs.contactCylProj0Point''). This point is compulsory if the cylinder has a given rotation. |
 | ''projType''  | = 0 : the surface is finite and limited by the length of the axis \\ = 1 : the surface is infinite  |