teldufalsari/visionforge
1
0
Fork 0
forked from kscience/visionforge
Code Pull Requests Activity

Merge pull request #9 from kiruma524/dev

Browse Source 
Dev
This commit is contained in:
kiruma524 2021-08-06 17:10:43 +03:00 committed by GitHub
commit 2a9e5c4078
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 28 additions and 26 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
docs/tutorial.md
View File

@ -1,6 +1,6 @@
# Tutorial # Tutorial
#### The main goal of this tutorial is to show main capabilities of the visualization instrument. #### The main goal of this tutorial is to show the main capabilities of the visualization instrument.
The simple visualization can be made with function `main`. (this part will be supplemented) The simple visualization can be made with function `main`. (this part will be supplemented)
```kotlin ```kotlin
@ -42,7 +42,9 @@ fun main(){
*Basic properties:* *Basic properties:*
1. `opacity` — It is set in `float`. It takes on values from 0 to 1, which represent percents of solid opacity. It's initial value is 1. 1. `opacity` — It is set in `float`. It takes on values from 0 to 1, which represent percents of solid opacity. It's initial value is 1.
2. `color` — It can be specified as `Int`, `String`, or as three `Ubytes`, which represent color in `rgb`. Elementally, the solid will have `green` color. 2. `color` — It can be specified as `Int`, `String`, or as three `Ubytes`, which represent color in `rgb`. Elementally, the solid will have `green` color.
3. `rotation` — it's the point, which set rotations along axes. Initially, the value is `Point3D(0, 0, 0)`. Changing `x` coordinate of the point, you make pivot around `x axis`. The same for other coordinates: changing `y` — pivot around `y axis`, changing `z` — pivot around `z axis`.
3. `rotation` — it's the point, which sets rotations along axes. Initially, the value is `Point3D(0, 0, 0)`. Changing `x` coordinate of the point, you make pivot around `x axis`. The same for other coordinates: changing `y` — pivot around `y axis`, changing `z` — pivot around `z axis`.
4. position, which is given by values `x`, `y`, `z`. Initial values are `x = 0`, `y = 0`, `z = 0`. The coordinate system is Cartesian. It's elemental position is this — vertical `y` axis and horizontal `Oxz` plane. 4. position, which is given by values `x`, `y`, `z`. Initial values are `x = 0`, `y = 0`, `z = 0`. The coordinate system is Cartesian. It's elemental position is this — vertical `y` axis and horizontal `Oxz` plane.
Let's see how properties are set in solids. Let's see how properties are set in solids.
@ -114,18 +116,18 @@ fun main(){
![](../docs/images/two-boxes-1.png) ![](../docs/images/two-boxes-1.png)
![](../docs/images/two-boxes-2.png) ![](../docs/images/two-boxes-2.png)
***There is plenty of other properties, especially of those, which you can create by yourself. Here we mention just small part.*** ***There is plenty of other properties, especially those, which you can create by yourself. Here we mention just a small part.***
## Basic Solids ## Basic Solids
Now, let's see which solids can be visualized: Now, let's see which solids can be visualized:
### 1) PolyLine ### 1) PolyLine
It's scarcely a solid, but it can be visualized, so we mention it. It's scarcely a solid, but it can be visualized, so we mention it.
`polyline` build lines, obviously. Let's take a look at it's work. `polyline` build lines, obviously. Let's take a look at it's work.
`polyline` requires two values — `points`, and `name`: `polyline` requires two values — `points`, and `name`:
* `points` is a `vararg` with `Point3D` type. It takes pairs of points, which you want to connect. * `points` is a `vararg` with `Point3D` type. It takes pairs of points, which you want to connect.
* `name` is an identifier of *any solid*, but in this case it is an identifier of `polyline`. * `name` is an identifier of *any solid*; but in this case, it is an identifier of `polyline`.
It's type is `String`. **This value can be required by any solid; It's type is `String`. **This value can be required by any solid;
you can set it, you can not to set it, but without you won't be able to control solid, since it won't be inherited.** you can set it, you can not to set it, but without you won't be able to control solid, since it won't be inherited.**
@ -173,11 +175,11 @@ Now, let's make `box` with bigger `y` value.
color("black") color("black")
} }
``` ```
As you can see, only rib of `y-axis` differs from other ribs. As you can see, only the rib of `y-axis` differs from other ribs.
![](../docs/images/high-box.png) ![](../docs/images/high-box.png)
For final trial, let's create `box` with bigger `x` value. For a final trial, let's create a `box` with a bigger `x` value.
```kotlin ```kotlin
box(65, 40, 40, name = "wide box") { box(65, 40, 40, name = "wide box") {
@ -187,7 +189,7 @@ For final trial, let's create `box` with bigger `x` value.
color("black") color("black")
} }
``` ```
Predictably, only `x-axis` rib bigger than other ribs. Predictably, only the `x-axis` rib is bigger than other ribs.
![](../docs/images/wide-box.png) ![](../docs/images/wide-box.png)
@ -196,7 +198,7 @@ Predictably, only `x-axis` rib bigger than other ribs.
It takes in two values: `radius`, and `name`. It takes in two values: `radius`, and `name`.
We bring you to mind that `name` is a general value for all solids, so do not wonder, since all solids need their own identifier. We bring you to mind that `name` is a general value for all solids, so do not wonder, since all solids need their own identifier.
As for `radius`, it has `Float` type, and, as you can guess, it sets radius of the sphere, which will be created. As for `radius`, it has `Float` type, and, as you can guess, it sets the radius of the sphere which will be created.
```kotlin ```kotlin
sphere(50, name = "sphere") { sphere(50, name = "sphere") {
x = 0 x = 0
@ -222,7 +224,7 @@ It is solid which has six edges. It is set by eight values: `node1`,..., `node8`
![](../docs/images/scheme.png) ![](../docs/images/scheme.png)
As hexagon takes in specific points, we understand that this solid cannot be moved, it fixed in space, and it can't make pivots. As the hexagon takes in specific points, we understand that this solid cannot be moved, it is fixed in space, and it can't make pivots.
Let's make classic parallelepiped. Let's make classic parallelepiped.
```kotlin ```kotlin
@ -244,24 +246,25 @@ Let's make classic parallelepiped.
Now, let's make a custom hexagon. Now, let's make a custom hexagon.
```kotlin ```kotlin
hexagon( hexagon(
Point3D(5, 30, 5), Point3D(5, 30, 5),
Point3D(24, 30, 8), Point3D(24, 30, 8),
Point3D(20, 30, -10), Point3D(20, 30, -10),
Point3D(5, 30, -7), Point3D(5, 30, -7),
Point3D(8, 16, 0), Point3D(8, 16, 0),
Point3D(12, 16, 0), Point3D(12, 16, 0),
Point3D(10, 16, -5), Point3D(10, 16, -5),
Point3D(6.5, 12, -3), Point3D(6.5, 12, -3),
name = "custom_hexagon"){ name = "custom_hexagon"
color("brown") ) {
} color("brown")
}
``` ```
![](../docs/images/custom-hexagon.png) ![](../docs/images/custom-hexagon.png)
### 3) Cone ### 3) Cone
It takes in six values: `bottomRadius`, `height`, `upperRadius`, `startAngle`, `angle`, and `name`. It takes in six values: `bottomRadius`, `height`, `upperRadius`, `startAngle`, `angle`, and `name`.
Obviously, `bottomRadius` is responsible for radius of a bottom base, and `height` sets height of a cone along the `z-axis`. Obviously, `bottomRadius` is responsible for the radius of a bottom base, and `height` sets the height of a cone along the `z-axis`.
As it takes such values as `upperRadius`, `startAngle`, `angle`, `cone` can build not only usual cones, but also cone segments. Initially, `upperRadius` will have `0.0` value, `startAngle` — `0f`, `angle` — `PI2`, so if you don't set them, you'll get just a simple cone. As it takes such values as `upperRadius`, `startAngle`, `angle`, `cone` can build not only usual cones, but also cone segments. Initially, `upperRadius` will have `0.0` value, `startAngle` — `0f`, `angle` — `PI2`, so if you don't set them, you'll get just a simple cone.
@ -368,6 +371,5 @@ tube(50, 40, 20, 0f, PI, name = "fragmented tube"){
### 7) Extruded ### 7) Extruded
`extruded` is set by two values: `shape`, and `layer`. `extruded` is set by two values: `shape`, and `layer`.
* `shape` is a value of `List<Point2D>` type. It' s just a list of all points of the solid. *`shape` has to consist of not less than two points!* * `shape` is a value of `List<Point2D>` type. It's just a list of all points of the solid. *`shape` has to consist of not less than two points!*
* `layer` is `MutableList` types variable. (here is a sentence with description of the work of this function). *The amount of `layer`-s has to be more than one* * `layer` is `MutableList` types variable. (here is a sentence with a description of the work of this function). *The amount of `layer`-s has to be more than one*