vshape

type Box struct {
	ShapeBase

	// size along each dimension
	Size mat32.Vec3 `desc:"size along each dimension"`

	// number of segments to divide each plane into (enforced to be at least 1) -- may potentially increase rendering quality to have > 1
	Segs mat32.Vec3i `` /* 137-byte string literal not displayed */
}

type Capsule struct {
	ShapeBase

	// height of the cylinder portion
	Height float32 `desc:"height of the cylinder portion"`

	// radius of the top -- set to 0 to omit top cap
	TopRad float32 `desc:"radius of the top -- set to 0 to omit top cap"`

	// radius of the bottom -- set to 0 to omit bottom cap
	BotRad float32 `desc:"radius of the bottom -- set to 0 to omit bottom cap"`

	// [min: 1] number of radial segments (32 is a reasonable default for full circle)
	RadialSegs int `min:"1" desc:"number of radial segments (32 is a reasonable default for full circle)"`

	// number of height segments
	HeightSegs int `desc:"number of height segments"`

	// number of segments in the hemisphere cap ends (16 is a reasonable default)
	CapSegs int `desc:"number of segments in the hemisphere cap ends (16 is a reasonable default)"`

	// [min: 0] [max: 360] [step: 5] starting angle in degrees, relative to -1,0,0 left side starting point
	AngStart float32 `min:"0" max:"360" step:"5" desc:"starting angle in degrees, relative to -1,0,0 left side starting point"`

	// [min: 0] [max: 360] [step: 5] total angle to generate in degrees (max 360)
	AngLen float32 `min:"0" max:"360" step:"5" desc:"total angle to generate in degrees (max 360)"`
}

type Cylinder struct {
	ShapeBase

	// height of the cylinder
	Height float32 `desc:"height of the cylinder"`

	// radius of the top -- set to 0 for a cone
	TopRad float32 `desc:"radius of the top -- set to 0 for a cone"`

	// radius of the bottom
	BotRad float32 `desc:"radius of the bottom"`

	// [min: 1] number of radial segments (32 is a reasonable default for full circle)
	RadialSegs int `min:"1" desc:"number of radial segments (32 is a reasonable default for full circle)"`

	// number of height segments
	HeightSegs int `desc:"number of height segments"`

	// render the top disc
	Top bool `desc:"render the top disc"`

	// render the bottom disc
	Bottom bool `desc:"render the bottom disc"`

	// [min: 0] [max: 360] [step: 5] starting angle in degrees, relative to -1,0,0 left side starting point
	AngStart float32 `min:"0" max:"360" step:"5" desc:"starting angle in degrees, relative to -1,0,0 left side starting point"`

	// [min: 0] [max: 360] [step: 5] total angle to generate in degrees (max 360)
	AngLen float32 `min:"0" max:"360" step:"5" desc:"total angle to generate in degrees (max 360)"`
}

type Lines struct {
	ShapeBase

	// line points (must be 2 or more)
	Points []mat32.Vec3 `desc:"line points (must be 2 or more)"`

	// line width, Y = height perpendicular to line direction, and X = depth
	Width mat32.Vec2 `desc:"line width, Y = height perpendicular to line direction, and X = depth"`

	// optional colors for each point -- actual color interpolates between
	Colors []color.Color `desc:"optional colors for each point -- actual color interpolates between"`

	// if true, connect the first and last points to form a closed shape
	Closed bool `desc:"if true, connect the first and last points to form a closed shape"`
}

type Plane struct {
	ShapeBase

	// axis along which the normal perpendicular to the plane points.  E.g., if the Y axis is specified, then it is a standard X-Z ground plane -- see also NormNeg for whether it is facing in the positive or negative of the given axis.
	NormAxis mat32.Dims `` /* 235-byte string literal not displayed */

	// if false, the plane normal facing in the positive direction along specified NormAxis, otherwise it faces in the negative if true
	NormNeg bool `` /* 135-byte string literal not displayed */

	// 2D size of plane
	Size mat32.Vec2 `desc:"2D size of plane"`

	// number of segments to divide plane into (enforced to be at least 1) -- may potentially increase rendering quality to have > 1
	Segs mat32.Vec2i `` /* 132-byte string literal not displayed */

	// offset from origin along direction of normal to the plane
	Offset float32 `desc:"offset from origin along direction of normal to the plane"`
}

type Shape interface {
	// N returns number of vertex, index points in this shape element
	N() (nVtx, nIdx int)

	// Offs returns starting offset for verticies, indexes in full shape array,
	// in terms of points, not floats
	Offs() (vtxOff, idxOff int)

	// SetOffs sets starting offset for verticies, indexes in full shape array,
	// in terms of points, not floats
	SetOffs(vtxOff, idxOff int)

	// Set sets points in given allocated arrays
	Set(vtxAry, normAry, texAry mat32.ArrayF32, idxAry mat32.ArrayU32)

	// BBox returns the bounding box for the shape, typically centered around 0
	// This is only valid after Set has been called.
	BBox() mat32.Box3
}

type ShapeBase struct {

	// vertex offset, in points
	VtxOff int `desc:"vertex offset, in points"`

	// index offset, in points
	IdxOff int `desc:"index offset, in points"`

	// cubic bounding box in local coords
	CBBox mat32.Box3 `desc:"cubic bounding box in local coords"`

	// all shapes take a 3D position offset to enable composition
	Pos mat32.Vec3 `desc:"all shapes take a 3D position offset to enable composition"`
}

type ShapeGroup struct {
	ShapeBase

	// list of shapes in group
	Shapes []Shape `desc:"list of shapes in group"`
}

type Sphere struct {
	ShapeBase

	// radius of the sphere
	Radius float32 `desc:"radius of the sphere"`

	// [min: 3] number of segments around the width of the sphere (32 is reasonable default for full circle)
	WidthSegs int `min:"3" desc:"number of segments around the width of the sphere (32 is reasonable default for full circle)"`

	// [min: 3] number of height segments (32 is reasonable default for full height)
	HeightSegs int `min:"3" desc:"number of height segments (32 is reasonable default for full height)"`

	// [min: 0] [max: 360] [step: 5] starting radial angle in degrees, relative to -1,0,0 left side starting point
	AngStart float32 `min:"0" max:"360" step:"5" desc:"starting radial angle in degrees, relative to -1,0,0 left side starting point"`

	// [min: 0] [max: 360] [step: 5] total radial angle to generate in degrees (max = 360)
	AngLen float32 `min:"0" max:"360" step:"5" desc:"total radial angle to generate in degrees (max = 360)"`

	// [min: 0] [max: 180] [step: 5] starting elevation (height) angle in degrees - 0 = top of sphere, and Pi is bottom
	ElevStart float32 `min:"0" max:"180" step:"5" desc:"starting elevation (height) angle in degrees - 0 = top of sphere, and Pi is bottom"`

	// [min: 0] [max: 180] [step: 5] total angle to generate in degrees (max = 180)
	ElevLen float32 `min:"0" max:"180" step:"5" desc:"total angle to generate in degrees (max = 180)"`
}

type Torus struct {
	ShapeBase

	// larger radius of the torus ring
	Radius float32 `desc:"larger radius of the torus ring"`

	// radius of the solid tube
	TubeRadius float32 `desc:"radius of the solid tube"`

	// [min: 1] number of segments around the radius of the torus (32 is reasonable default for full circle)
	RadialSegs int `min:"1" desc:"number of segments around the radius of the torus (32 is reasonable default for full circle)"`

	// [min: 1] number of segments for the tube itself (32 is reasonable default for full height)
	TubeSegs int `min:"1" desc:"number of segments for the tube itself (32 is reasonable default for full height)"`

	// [min: 0] [max: 360] [step: 5] starting radial angle in degrees relative to 1,0,0 starting point
	AngStart float32 `min:"0" max:"360" step:"5" desc:"starting radial angle in degrees relative to 1,0,0 starting point"`

	// [min: 0] [max: 360] [step: 5] total radial angle to generate in degrees (max = 360)
	AngLen float32 `min:"0" max:"360" step:"5" desc:"total radial angle to generate in degrees (max = 360)"`
}