Volume
- mert.goktas (Unlicensed)
Volume objects define 3D entities by extending surface objects. To create a volume object, you need to connect two or more surface objects that have the same number of points.
Example Syntax:
...
<O T="Volume"
...
...
</O>There are three methods to create a volume object:
By specifying a thickness value for a surface object
By connecting a line object and a surface object
By connecting two different surface objects.
Example:
<O N="VolumeObject1" T="Project" Category="3D Geometric Objects" TransAlignRule="Right">
<!-- created by ParamML Examples on 01.02.2023 -->
<O N="Prsm1" T="Surface" Thickness="20" Y="80">
<O T="Point" X="0" Y="0" Z="0" />
<O T="Point" X="20" Y="0" Z="0" />
<O T="Point" X="20" Y="20" Z="0" />
<O T="Point" X="0" Y="20" Z="0" />
</O>
<O N="Prsm2" T="Line" Y="50">
<O T="Point" X="0" Y="0" Z="0" />
<O T="Point" X="0" Y="0" Z="50" />
<O N="Section" T="Section">
<O T="Shape">
<O T="Point" X="-2" Y="-2" />
<O T="Point" X="2" Y="-2" />
<O T="Point" X="2" Y="2" />
<O T="Point" X="-2" Y="2" />
</O>
</O>
</O>
<O N="Prsm3" T="Volume">
<P N="w" V="20" />
<O T="Surface" Z="0">
<O T="Point" X="-w" Y="-w" />
<O T="Point" X="w" Y="-w" />
<O T="Point" X="w" Y="w" />
<O T="Point" X="-w" Y="w" />
</O>
<O T="Surface" Z="25">
<O T="Point" X="-w/2" Y="-w/2" />
<O T="Point" X="w/2" Y="-w/2" />
<O T="Point" X="w/2" Y="w/2" />
<O T="Point" X="-w/2" Y="w/2" />
</O>
</O>
</O> |
 CAD view |
To view this example in the library, see (OpenBrIM Platform) |
The order and number of points in the two surfaces are critical when creating a volume object. If the points are defined in a different order for the lower and upper surfaces, the connecting lines will form a diagonal line between the points, leading to an incorrect appearance.
It's also important to ensure that both surfaces have the same number of points. If the number of points is different, the matching points will combine, while the remaining unmatched points will be left exposed.
Example:
<O N="VolumeObject2" T="Project" Category="3D Geometric Objects" TransAlignRule="Right">
<!-- created by ParamML Examples on 01.02.2023 -->
<O N="WrongPrism1" T="Volume" Y="50">
<O T="Surface" Z="0">
<O T="Point" X="10" Y="-10" />
<O T="Point" X="10" Y="10" />
<O T="Point" X="-10" Y="10" />
<O T="Point" X="-10" Y="-10" />
</O>
<O T="Surface" Z="25">
<O T="Point" X="-5" Y="-5" />
<O T="Point" X="5" Y="-5" />
<O T="Point" X="5" Y="5" />
<O T="Point" X="-5" Y="5" />
</O>
</O>
<O N="WrongPrism2" T="Volume">
<O T="Surface">
<O T="Point" X="10" Y="-10" />
<O T="Point" X="10" Y="10" />
<O T="Point" X="-10" Y="10" />
<O T="Point" X="-10" Y="0" />
<O T="Point" X="-10" Y="-10" />
</O>
<O T="Surface" Z="30">
<O T="Point" X="5" Y="-5" />
<O T="Point" X="5" Y="5" />
<O T="Point" X="-5" Y="5" />
<O T="Point" X="-5" Y="-5" />
</O>
</O>
</O> |
 CAD View |
To view this example in the library, see (OpenBrIM Platform) |
Example:
If all the points on a surface have the same coordinate value, it can be represented as a common value in the brackets. This is equivalent to writing the same coordinate value for each point. For example, since all the Z values in the first "Surface" object are 0, they can be written in a single line in the surface object definition, instead of writing them individually for each point. The hierarchy of these lines can be seen using the "toglobal" function.
The example shows that the "Group" volume contains the volumes from the outermost to the innermost, including both surface1 and surface2. In other words, the Z value of surface1 is calculated as 3 + 1 + 10 ( height) + 5 = Z → 19, starting from the innermost point. The Z value of surface2 is calculated as 8 + 12 + 10 (height) + 5 = Z → 35. |
To view this example in the library, see (OpenBrIM Platform) |
Example:
To view this example in the library, see (OpenBrIM Platform) |
Example:
To view this example in the library, see (OpenBrIM Platform) |
Parameters of Volume Object:
Label | Mandatory | Name and Type Attributes | Default Description and Value Attributes | Other Attributes | |
|---|---|---|---|---|---|
| 1 | Draw Face A | No | N="DrawFaceA" | D="Draw Face A?: Should graphics display face A of this volume? [Yes=1/No=0]" V="1" | Role="Input" |
| 2 | Draw Face B | No | N="DrawFaceB" | D="Draw Face B?: Should graphics display face B of this volume? [Yes=1/No=0]" V="1" | Role="Input" |
| 3 | Draw Border | No | N="DrawBorder" | D="Draw Border?: Should graphics display a border along the lines connecting the faces? [Yes=1/No=0]" V="1" | Role="Input" |
| 4 | Draw Border Around Face A | No | N="DrawFaceABorder" | D="Draw Border Around Face A?: Should graphics display a border around face A? [Yes=1/No=0]" V="1" | Role="Input" |
| 5 | Draw Border Around Face B | No | N="DrawFaceBBorder" | D="Draw Border Around Face B?: Should graphics display a border around face B? [Yes=1/No=0]" V="1" | Role="Input" |