leonsal 8 лет назад
Родитель
Сommit
e13954664e
1 измененных файлов с 24 добавлено и 3 удалено
  1. 24 3
      math32/array.go

+ 24 - 3
math32/array.go

@@ -8,6 +8,7 @@ import (
 	"unsafe"
 )
 
+// ArrayF32 is a slice of float32 with additional convenience methods
 type ArrayF32 []float32
 
 // NewArrayF32 creates a returns a new array of floats
@@ -30,16 +31,19 @@ func (a *ArrayF32) Size() int {
 }
 
 // Len returns the number of float32 elements in the array
+// It is equivalent to Size()
 func (a *ArrayF32) Len() int {
 
 	return len(*a)
 }
 
+// Append appends any number of values to the array
 func (a *ArrayF32) Append(v ...float32) {
 
 	*a = append(*a, v...)
 }
 
+// AppendVector2 appends any number of Vector2 to the array
 func (a *ArrayF32) AppendVector2(v ...*Vector2) {
 
 	for i := 0; i < len(v); i++ {
@@ -47,6 +51,7 @@ func (a *ArrayF32) AppendVector2(v ...*Vector2) {
 	}
 }
 
+// AppendVector3 appends any number of Vector3 to the array
 func (a *ArrayF32) AppendVector3(v ...*Vector3) {
 
 	for i := 0; i < len(v); i++ {
@@ -54,6 +59,7 @@ func (a *ArrayF32) AppendVector3(v ...*Vector3) {
 	}
 }
 
+// AppendColor appends any number of Color to the array
 func (a *ArrayF32) AppendColor(v ...*Color) {
 
 	for i := 0; i < len(v); i++ {
@@ -61,6 +67,7 @@ func (a *ArrayF32) AppendColor(v ...*Color) {
 	}
 }
 
+// AppendColor4 appends any number of Color4 to the array
 func (a *ArrayF32) AppendColor4(v ...*Color4) {
 
 	for i := 0; i < len(v); i++ {
@@ -68,12 +75,16 @@ func (a *ArrayF32) AppendColor4(v ...*Color4) {
 	}
 }
 
+// GetVector2 stores in the specified Vector2 the
+// values from the array starting at the specified pos.
 func (a ArrayF32) GetVector2(pos int, v *Vector2) {
 
 	v.X = a[pos]
 	v.Y = a[pos+1]
 }
 
+// GetVector3 stores in the specified Vector3 the
+// values from the array starting at the specified pos.
 func (a ArrayF32) GetVector3(pos int, v *Vector3) {
 
 	v.X = a[pos]
@@ -81,6 +92,8 @@ func (a ArrayF32) GetVector3(pos int, v *Vector3) {
 	v.Z = a[pos+2]
 }
 
+// GetColor stores in the specified Color the
+// values from the array starting at the specified pos
 func (a ArrayF32) GetColor(pos int, v *Color) {
 
 	v.R = a[pos]
@@ -88,6 +101,8 @@ func (a ArrayF32) GetColor(pos int, v *Color) {
 	v.B = a[pos+2]
 }
 
+// Set sets the values of the array starting at the specified pos
+// from the specified values
 func (a ArrayF32) Set(pos int, v ...float32) {
 
 	for i := 0; i < len(v); i++ {
@@ -95,12 +110,16 @@ func (a ArrayF32) Set(pos int, v ...float32) {
 	}
 }
 
+// SetVector2 sets the values of the array at the specified pos
+// from the XY values of the specified Vector2
 func (a ArrayF32) SetVector2(pos int, v *Vector2) {
 
 	a[pos] = v.X
 	a[pos+1] = v.Y
 }
 
+// SetVector3 sets the values of the array at the specified pos
+// from the XYZ values of the specified Vector3
 func (a ArrayF32) SetVector3(pos int, v *Vector3) {
 
 	a[pos] = v.X
@@ -108,6 +127,8 @@ func (a ArrayF32) SetVector3(pos int, v *Vector3) {
 	a[pos+2] = v.Z
 }
 
+// SetColor sets the values of the array at the specified pos
+// from the RGB values of the specified Color
 func (a ArrayF32) SetColor(pos int, v *Color) {
 
 	a[pos] = v.R
@@ -115,6 +136,8 @@ func (a ArrayF32) SetColor(pos int, v *Color) {
 	a[pos+2] = v.B
 }
 
+// SetColor4 sets the values of the array at the specified pos
+// from the RGBA values of specified Color4
 func (a ArrayF32) SetColor4(pos int, v *Color4) {
 
 	a[pos] = v.R
@@ -123,9 +146,7 @@ func (a ArrayF32) SetColor4(pos int, v *Color4) {
 	a[pos+3] = v.A
 }
 
-//
-//
-//
+// ArrayU32 is a slice of uint32 with additional convenience methods
 type ArrayU32 []uint32
 
 // NewArrayU32 creates a returns a new array of uint32