Class: GMath3D::Box

Inherits:
Geom
  • Object
show all
Defined in:
lib/box.rb

Overview

Box represents an axitially aligned box on 3D space.

Instance Attribute Summary collapse

Attributes inherited from Geom

#tolerance

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Geom

default_tolerance

Constructor Details

#initialize(point1 = Vector3.new(0,0,0), point2 = Vector3.new(1,1,1)) ⇒ Box

Input

point1 and point2 should be Vector3. Each points are opposing corners.

Output

return new instance of Box.



16
17
18
19
20
21
22
23
24
25
26
27
28
 
# File 'lib/box.rb', line 16

def initialize(point1 = Vector3.new(0,0,0), point2 = Vector3.new(1,1,1))
  Util3D.check_arg_type(Vector3, point1)
  Util3D.check_arg_type(Vector3, point2)
  super()
  @min_point = Vector3.new();
  @max_point = Vector3.new();
  @min_point.x = [ point1.x, point2.x ].min
  @min_point.y = [ point1.y, point2.y ].min
  @min_point.z = [ point1.z, point2.z ].min
  @max_point.x = [ point1.x, point2.x ].max
  @max_point.y = [ point1.y, point2.y ].max
  @max_point.z = [ point1.z, point2.z ].max
end

Instance Attribute Details

#max_point ⇒ Object (readonly)

Returns the value of attribute max_point.



9
10
11
 
# File 'lib/box.rb', line 9

def max_point
  @max_point
end

#min_point ⇒ Object (readonly)

Returns the value of attribute min_point.



8
9
10
 
# File 'lib/box.rb', line 8

def min_point
  @min_point
end

Class Method Details

.from_points(points) ⇒ Object

Input

points should be Array of Vector3. Each points are opposing corners.

Output

return new instance of Box.



35
36
37
38
39
40
 
# File 'lib/box.rb', line 35

def self.from_points( points )
  return nil if (points == nil || points.size <=0)
  box = Box.new(points[0], points[0])
  box += points
  return box
end

Instance Method Details

#+(rhs) ⇒ Object

Input

rhs shold be Vector3 or Box or Array of them.

Output

return added result as Box.



54
55
56
 
# File 'lib/box.rb', line 54

def +(rhs)
  add(rhs)
end

#==(rhs) ⇒ Object 



46
47
48
 
# File 'lib/box.rb', line 46

def ==(rhs)
  equals_inner(rhs)
end

#center ⇒ Object

Output

return cente point of Box as Vector3.



60
61
62
 
# File 'lib/box.rb', line 60

def center
  return (@min_point + @max_point) * 0.5
end

#length ⇒ Object

Output

return width, height, depth as [Numeric, Numeric, Numeric]



66
67
68
 
# File 'lib/box.rb', line 66

def length
  return max_point.x - min_point.x, max_point.y - min_point.y, max_point.z - min_point.z
end

#rotate(quat) ⇒ Object

input

quat should be Quat.

Output

return rotated box as Box. since Box is AABB, returned box might be bigger than original one.



106
107
108
109
110
111
112
 
# File 'lib/box.rb', line 106

def rotate(quat)
  rot_matrix = Matrix.from_quat(quat)
  verts = self.vertices
  inv_mat = rot_matrix.inv
  verts = verts.collect {|item| inv_mat*item}
  return Box.from_points(verts)
end

#to_s ⇒ Object 



42
43
44
 
# File 'lib/box.rb', line 42

def to_s
  "Box[min#{min_point.to_element_s}, max#{max_point.to_element_s}]"
end

#translate(vec) ⇒ Object

input

vec should be Vector3.

Output

return translated box as Box.



97
98
99
 
# File 'lib/box.rb', line 97

def translate(vec)
  return Box.new(min_point + vec, max_point + vec)
end

#vertices ⇒ Object

Output

return all vertices of Box.



79
80
81
82
83
84
85
86
87
88
89
90
91
 
# File 'lib/box.rb', line 79

def vertices
  verts = Array.new(8)
  length_ary = self.length
  verts[0] = @min_point.clone
  verts[1] = @min_point + Vector3.new(length_ary[0],             0,            0 )
  verts[2] = @min_point + Vector3.new(length_ary[0], length_ary[1],            0 )
  verts[3] = @min_point + Vector3.new(            0, length_ary[1],            0 )
  verts[4] = @min_point + Vector3.new(            0,             0, length_ary[2])
  verts[5] = @min_point + Vector3.new(length_ary[0],             0, length_ary[2])
  verts[6] = @min_point + Vector3.new(length_ary[0], length_ary[1], length_ary[2])
  verts[7] = @min_point + Vector3.new(            0, length_ary[1], length_ary[2])
  return verts
end

#volume ⇒ Object

Output

return volume of Box as Numeric.



72
73
74
75
 
# File 'lib/box.rb', line 72

def volume
  width, height, depth = self.length
  return width*height*depth
end