vphong

package
v1.0.5 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 12, 2022 License: BSD-3-Clause Imports: 14 Imported by: 3

README

vPhong is a Blinn-Phong rendering system in vGPU

Blinn-Phong is a standard lighting model that used to be built into OpenGL, and is widely used in 3D graphics: wikipedia Blinn-Phong, learnopengl.com.

Supports 4 different types of lights, with a max of 8 instances of each light type:

  • Ambient: light emitted from everywhere -- provides a background of diffuse light bouncing around in all directions.

  • Directional: light directed along a given vector (specified as a position of a light shining toward the origin), with no attenuation. This is like the sun.

  • Point: an omnidirectional light with a position and associated decay factors, which divide the light intensity as a function of linear and quadratic distance. The quadratic factor dominates at longer distances.light radiating out in all directdions from a specific point,

  • Spot: a light with a position and direction and associated decay factors and angles, which divide the light intensity as a function of linear and quadratic distance. The quadratic factor dominates at longer distances.

Meshes are indexed triangles.

There are 3 rendering pipelines:

  • Texture: color comes from texture image
  • OneColor: a single color for the entire mesh.
  • PerVertex: color is provided per vertex by the mesh.

The color model has the following factors:

  • Color = main color of surface arising from one of the 3 sources listed above, used for both ambient and diffuse color in standard Phong model -- alpha component determines transparency -- note that transparent objects require more complex rendering, to sort objects as a function of depth.
  • Emissive = color that surface emits independent of any lighting -- i.e., glow -- can be used for marking lights with an object.
  • Shiny = specular shininess factor -- how focally the surface shines back directional light -- this is an exponential factor, with 0 = very broad diffuse reflection, and higher values (typically max of 128) having a smaller more focal specular reflection. Default is 30.
  • Reflect = reflectiveness of the surface in the region where specular reflected light is emitted -- 1 for full shiny white reflection (specular) color, 0 = no shine reflection. The specular color is always set to white, which will reflect the light color accurately.
  • Bright = overall multiplier on final computed color value -- can be used to tune the overall brightness of various surfaces relative to each other for a given set of lighting parameters.

Known Issues

There must be at least one texture image, otherwise the Mac VKMolten system triggers this error. The system automatically adds a dummy image to deal with this.

[mvk-error] VK_ERROR_INVALID_SHADER_NV: Unable to convert SPIR-V to MSL:
MSL conversion error: Unsized array of images is not supported in MSL.

Layout of Vars

Set: -2
    Role: Vertex
        Var: 0:	Pos	Float32Vec3	(size: 12)	Vals: 6
        Var: 1:	Norm	Float32Vec3	(size: 12)	Vals: 6
        Var: 2:	Tex	Float32Vec2	(size: 8)	Vals: 6
        Var: 3:	Color	Float32Vec4	(size: 16)	Vals: 6
    Role: Index
        Var: 4:	Index	Uint32	(size: 4)	Vals: 6
Set: -1
    Role: Push
        Var: 0:	PushU	Struct	(size: 128)	Vals: 1
Set: 0
    Role: Uniform
        Var: 0:	Mtxs	Struct	(size: 128)	Vals: 1
Set: 1
    Role: Uniform
        Var: 0:	NLights	Struct	(size: 16)	Vals: 1
Set: 2
    Role: Uniform
        Var: 0:	AmbLights	Struct[8]	(size: 16)	Vals: 1
        Var: 1:	DirLights	Struct[8]	(size: 32)	Vals: 1
        Var: 2:	PointLights	Struct[8]	(size: 48)	Vals: 1
        Var: 3:	SpotLights	Struct[8]	(size: 64)	Vals: 1
Set: 3
    Role: TextureRole
        Var: 0:	Tex	ImageRGBA32	(size: 4)	Vals: 3

Documentation

Index

Constants

View Source 
const MaxLights = 8

MaxLights is upper limit on number of any given type of light

Variables

View Source 
var KiT_Sets = kit.Enums.AddEnum(SetsN, kit.NotBitFlag, nil)

Functions

func CameraViewMat 

func CameraViewMat(pos, target, up mat32.Vec3) *mat32.Mat4

CameraViewMat returns the camera view matrix, based position of camera facing at target position, with given up vector.

Types

type AmbientLight 

type AmbientLight struct {
	Color mat32.Vec3 `desc:"color of light -- multiplies ambient color of materials"`
	// contains filtered or unexported fields
}

AmbientLight provides diffuse uniform lighting -- typically only one of these

type Colors 

type Colors struct {
	Color       mat32.Vec4 `` /* 200-byte string literal not displayed */
	ShinyBright mat32.Vec4 `` /* 649-byte string literal not displayed */
	Emissive    mat32.Vec4 `desc:"color that surface emits independent of any lighting -- i.e., glow -- can be used for marking lights with an object"`
}

Colors are the material colors with padding for direct uploading to shader

func NewColors 

func NewColors(clr, emis color.Color, shiny, reflect, bright float32) *Colors

NewGoColor sets the colors from standard Go colors

func (*Colors) SetColors 

func (cl *Colors) SetColors(clr, emis color.Color, shiny, reflect, bright float32)

SetColors sets the colors from standard Go colors

type CurRender 

type CurRender struct {
	DescIdx     int        `desc:"index of descriptor collection to use -- for threaded / parallel rendering -- see vgup.Vars NDescs for more info"`
	UseTexture  bool       `desc:"a texture was selected -- if true, overrides other options"`
	UseVtxColor bool       `desc:"a per-vertex color was selected"`
	ModelMtx    mat32.Mat4 `desc:"current model pose matrix"`
	VPMtx       Mtxs       `desc:"camera view and projection matrixes"`
	Color       Colors     `desc:"current color surface properties"`
	TexPars     TexPars    `desc:"texture parameters -- repeat, offset"`
	TexIdx      int        `desc:"index of currently-selected texture"`
}

CurRender holds info about the current render as updated by Use* methods -- determines which pipeline is used. Default is single color.

func (*CurRender) NewPush 

func (cr *CurRender) NewPush() *PushU

NewPush generates a new Push object based on current render settings unsafe.Pointer does not work having this be inside the CurRender obj itself so we create one afresh.

type DirLight 

type DirLight struct {
	Color mat32.Vec3 `desc:"color of light at full intensity"`

	Pos mat32.Vec3 `` /* 148-byte string literal not displayed */
	// contains filtered or unexported fields
}

DirLight is directional light, which is assumed to project light toward the origin based on its position, with no attenuation, like the Sun. For rendering, the position is negated and normalized to get the direction vector (i.e., absolute distance doesn't matter)

type Mesh 

type Mesh struct {
	NVtx     int  `desc:"number of vertex points, as mat32.Vec3 -- always includes mat32.Vec3 normals and mat32.Vec2 texture coordinates"`
	NIdx     int  `desc:"number of indexes, as mat32.ArrayU32"`
	HasColor bool `desc:"has per-vertex colors, as mat32.Vec4 per vertex"`
}

Mesh records the number of elements in an indexed triangle mesh, which always includes normals and texture coordinates, and optionally per-vertex colors.

type Mtxs 

type Mtxs struct {
	View mat32.Mat4 `desc:"View Matrix: transforms world into camera-centered, 3D coordinates"`
	Prjn mat32.Mat4 `desc:"Projection Matrix: transforms camera coords into 2D render coordinates"`
}

Mtxs contains the camera view and projection matricies, for uniform uploading

type NLights 

type NLights struct {
	Ambient int32
	Dir     int32
	Point   int32
	Spot    int32
}

Number of different lights active

func (*NLights) Reset added in v1.0.0 

func (nl *NLights) Reset()

type Phong 

type Phong struct {
	NLights NLights                 `desc:"number of each type of light"`
	Ambient [MaxLights]AmbientLight `desc:"ambient lights"`
	Dir     [MaxLights]DirLight     `desc:"directional lights"`
	Point   [MaxLights]PointLight   `desc:"point lights"`
	Spot    [MaxLights]SpotLight    `desc:"spot lights"`

	Cur      CurRender                    `desc:"state for current rendering"`
	Meshes   ordmap.Map[string, *Mesh]    `desc:"meshes -- holds all the mesh data -- must be configured prior to rendering"`
	Textures ordmap.Map[string, *Texture] `` /* 133-byte string literal not displayed */
	Colors   ordmap.Map[string, *Colors]  `desc:"colors, optionally available for looking up by name -- not used directly in rendering"`

	Sys    vgpu.System `desc:"rendering system"`
	UpdtMu sync.Mutex  `view:"-" copy:"-" json:"-" xml:"-" desc:"mutex on updating"`
}

Phong implements standard Blinn-Phong rendering pipelines in a vgpu System. Must Add all Lights, Meshes, Colors, Textures first, and call Config() to configure everything prior to first RenderStart.

Meshes are configured initially with numbers of points, then after Config(), points are set by calling MeshFloatsBy* and assigning values.

If any changes are made to numbers or sizes of anything, you must call Config() again.

Changes to data only can be synced by calling Sync()

Rendering starts with RenderStart, followed by Use* calls to specify the parameters for each item, and then a Draw call to add the rendering command, followed by RenderEnd.

func (*Phong) AddAmbientLight 

func (ph *Phong) AddAmbientLight(color mat32.Vec3)

AddAmbientLight adds Ambient light at given position

func (*Phong) AddColor 

func (ph *Phong) AddColor(name string, clr *Colors)

AddColor adds to list of colors, which can be use for a materials library

func (*Phong) AddDirLight 

func (ph *Phong) AddDirLight(color, pos mat32.Vec3)

AddDirLight adds directional light

func (*Phong) AddMesh 

func (ph *Phong) AddMesh(name string, nVtx, nIdx int, hasColor bool)

AddMesh adds a Mesh with name and given number of verticies, indexes, and optional per-vertex color

func (*Phong) AddPointLight 

func (ph *Phong) AddPointLight(color, pos mat32.Vec3, linDecay, quadDecay float32)

AddPointLight adds point light. Defaults: linDecay=.1, quadDecay=.01

func (*Phong) AddSpotLight 

func (ph *Phong) AddSpotLight(color, pos, dir mat32.Vec3, angDecay, cutAngle, linDecay, quadDecay float32)

AddSpotLight adds spot light Defaults: angDecay=15, cutAngle=45 (max 90), linDecay=.01, quadDecay=0.001

func (*Phong) AddTexture 

func (ph *Phong) AddTexture(name string, tex *Texture)

AddTexture adds to list of textures

func (*Phong) AllocTextures 

func (ph *Phong) AllocTextures()

AllocTextures allocates textures that have been previously configured, via ConfigTextures(), after Phong.Sys.Config() has been called.

func (*Phong) Config 

func (ph *Phong) Config()

Config configures everything after everything has been Added

func (*Phong) ConfigLights 

func (ph *Phong) ConfigLights()

ConfigLights configures the rendering for the lights that have been added.

func (*Phong) ConfigMeshes 

func (ph *Phong) ConfigMeshes()

ConfigMeshes configures vals for meshes -- this is the first of two passes in configuring and setting mesh values -- Phong.Sys.Config is called after this method (and everythign else is configured).

func (*Phong) ConfigMeshesTextures added in v1.0.0 

func (ph *Phong) ConfigMeshesTextures()

ConfigMeshesTextures configures the Meshes and Textures based on everything added in the Phong config, prior to Sys.Config() which does host allocation.

func (*Phong) ConfigPipeline 

func (ph *Phong) ConfigPipeline(pl *vgpu.Pipeline)

ConfigPipeline configures graphics settings on the pipeline

func (*Phong) ConfigSys 

func (ph *Phong) ConfigSys()

ConfigSys configures the vDraw System and pipelines.

func (*Phong) ConfigTextures 

func (ph *Phong) ConfigTextures()

ConfigTextures configures vals for textures -- this is the first of two passes -- call Phong.Sys.Config after everything is config'd. This automatically allocates images by size so everything fits within the MaxTexturesPerStage limit, as texture arrays.

func (*Phong) DeleteMesh added in v1.0.0 

func (ph *Phong) DeleteMesh(name string)

DeleteMesh deletes Mesh with name

func (*Phong) DeleteTexture added in v1.0.0 

func (ph *Phong) DeleteTexture(name string)

DeleteTexture deletes texture with name

func (*Phong) Destroy 

func (ph *Phong) Destroy()

func (*Phong) MeshFloatsByIdx 

func (ph *Phong) MeshFloatsByIdx(i int) (pos, norm, tex, clr mat32.ArrayF32, idx mat32.ArrayU32)

MeshFloatsByIdx returns the mat32.ArrayF32's and mat32.ArrayU32 for given mesh for assigning values to the mesh. Must call ModMeshByIdx after setting these values to mark as modified.

func (*Phong) MeshFloatsByName 

func (ph *Phong) MeshFloatsByName(name string) (pos, norm, tex, clr mat32.ArrayF32, idx mat32.ArrayU32)

MeshFloatsByName returns the mat32.ArrayF32's and mat32.ArrayU32 for given mesh for assigning values to the mesh. Must call ModMeshByName after setting these values to mark as modified.

func (*Phong) ModMeshByIdx 

func (ph *Phong) ModMeshByIdx(i int)

ModMeshByIdx marks given mesh by index as modified. Must call after modifying mesh values, to mark for syncing

func (*Phong) ModMeshByName 

func (ph *Phong) ModMeshByName(name string)

ModMeshByName marks given mesh by name as modified. Must call after modifying mesh values, to mark for syncing

func (*Phong) Push 

func (ph *Phong) Push(pl *vgpu.Pipeline, push *PushU)

Push pushes given push constant data

func (*Phong) Render 

func (ph *Phong) Render()

Render does one step of rendering given current Use* settings

func (*Phong) RenderOnecolor 

func (ph *Phong) RenderOnecolor()

RenderOnecolor renders current settings to onecolor pipeline

func (*Phong) RenderTexture 

func (ph *Phong) RenderTexture()

RenderTexture renders current settings to texture pipeline

func (*Phong) RenderVtxColor added in v1.0.0 

func (ph *Phong) RenderVtxColor()

RenderVtxColor renders current settings to vertexcolor pipeline

func (*Phong) ResetMeshes added in v1.0.0 

func (ph *Phong) ResetMeshes()

ResetMeshes resets the meshes for reconfiguring

func (*Phong) ResetNLights added in v1.0.0 

func (ph *Phong) ResetNLights()

ResetNLights resets number of lights to 0 -- for reconfig

func (*Phong) ResetTextures added in v1.0.0 

func (ph *Phong) ResetTextures()

ResetTextures resets all textures

func (*Phong) SetAmbientLight added in v1.0.0 

func (ph *Phong) SetAmbientLight(idx int, color mat32.Vec3)

SetAmbientLight sets Ambient light at index to given position

func (*Phong) SetDirLight added in v1.0.0 

func (ph *Phong) SetDirLight(idx int, color, pos mat32.Vec3)

SetDirLight sets directional light at given index

func (*Phong) SetModelMtx 

func (ph *Phong) SetModelMtx(model *mat32.Mat4)

SetModelMtx sets the model pose matrix -- must be set per render step (otherwise last one will be used)

func (*Phong) SetPointLight added in v1.0.0 

func (ph *Phong) SetPointLight(idx int, color, pos mat32.Vec3, linDecay, quadDecay float32)

SetPointLight sets point light at given index. Defaults: linDecay=.1, quadDecay=.01

func (*Phong) SetSpotLight added in v1.0.0 

func (ph *Phong) SetSpotLight(idx int, color, pos, dir mat32.Vec3, angDecay, cutAngle, linDecay, quadDecay float32)

SetSpotLight sets spot light at given index Defaults: angDecay=15, cutAngle=45 (max 90), linDecay=.01, quadDecay=0.001

func (*Phong) SetViewPrjn 

func (ph *Phong) SetViewPrjn(view, prjn *mat32.Mat4)

SetViewPrjn sets the camera view and projection matrixes, and updates uniform data, so they are ready to use.

func (*Phong) Sync 

func (ph *Phong) Sync()

Sync synchronizes any changes in val data up to GPU device memory. any changes in numbers or sizes of any element requires a Config call.

func (*Phong) UpdateTextureIdx added in v1.0.0 

func (ph *Phong) UpdateTextureIdx(idx int) error

UpdateTextureIdx updates texture by index -- call this when the underlying image changes. Assumes the size remains the same. Must Sync for the changes to take effect.

func (*Phong) UpdateTextureName added in v1.0.0 

func (ph *Phong) UpdateTextureName(name string) error

UpdateTextureName updates texture by name

func (*Phong) UseColor added in v1.0.0 

func (ph *Phong) UseColor(clr, emis color.Color, shiny, reflect, bright float32)

UseColors sets the color values for current render step

func (*Phong) UseColorIdx 

func (ph *Phong) UseColorIdx(idx int) error

UseColorIdx selects color by index for current render step

func (*Phong) UseColorName 

func (ph *Phong) UseColorName(name string) error

UseColorName selects color by name for current render step

func (*Phong) UseFullTexture added in v1.0.0 

func (ph *Phong) UseFullTexture()

UseFullTexture sets the texture parameters for the next render command: to render the full texture: repeat = 1,1; off = 0,0

func (*Phong) UseMeshIdx 

func (ph *Phong) UseMeshIdx(idx int) error

UseMeshIdx selects mesh by index for current render step. If mesh has per-vertex colors, these are selected for rendering, and texture is turned off. UseTexture* after this to override.

func (*Phong) UseMeshName 

func (ph *Phong) UseMeshName(name string) error

UseMeshName selects mesh by name for current render step If mesh has per-vertex colors, these are selected for rendering, and texture is turned off. UseTexture* after this to override.

func (*Phong) UseNoTexture 

func (ph *Phong) UseNoTexture()

UseNoTexture turns off texture rendering

func (*Phong) UseTextureIdx 

func (ph *Phong) UseTextureIdx(idx int) error

UseTextureIdx selects texture by index for current render step

func (*Phong) UseTextureName 

func (ph *Phong) UseTextureName(name string) error

UseTextureName selects texture by name for current render step

func (*Phong) UseTexturePars added in v1.0.0 

func (ph *Phong) UseTexturePars(repeat mat32.Vec2, off mat32.Vec2)

UseTexturePars sets the texture parameters for the next render command: how often the texture repeats along each dimension, and the offset

type PointLight 

type PointLight struct {
	Color mat32.Vec3 `desc:"color of light a full intensity"`

	Pos mat32.Vec3 `desc:"position of light in world coordinates"`

	Decay mat32.Vec3 `` /* 160-byte string literal not displayed */
	// contains filtered or unexported fields
}

PointLight is an omnidirectional light with a position and associated decay factors, which divide the light intensity as a function of linear and quadratic distance. The quadratic factor dominates at longer distances.

type PushU 

type PushU struct {
	ModelMtx mat32.Mat4 `desc:"Model Matrix: poses object in world coordinates"`
	Color    Colors     `desc:"surface colors"`
	Tex      TexPars    `desc:"texture parameters"`
}

PushU is the push constants structure, holding everything that updates per object -- avoids any limitations on capacity.

type Sets 

type Sets int

Sets are variable set numbers - must coordinate with System sets! 

const (
	MtxsSet Sets = iota
	NLightSet
	LightSet
	TexSet
	SetsN
)

func (*Sets) FromString 

func (i *Sets) FromString(s string) error

func (Sets) String 

func (i Sets) String() string

type SpotLight 

type SpotLight struct {
	Color mat32.Vec3 `desc:"color of light a full intensity"`

	Pos mat32.Vec3 `desc:"position of light in world coordinates"`

	Dir mat32.Vec3 `desc:"direction of light vector"`

	Decay mat32.Vec4 `` /* 296-byte string literal not displayed */
	// contains filtered or unexported fields
}

Spotlight is a light with a position and direction and associated decay factors and angles, which divide the light intensity as a function of linear and quadratic distance. The quadratic factor dominates at longer distances.

type TexPars 

type TexPars struct {
	Repeat mat32.Vec2 `desc:"how often to repeat the texture in each direction"`
	Off    mat32.Vec2 `desc:"offset for when to start the texure in each direction"`
}

TexPars holds texture parameters: how often to repeat the texture image and offset

func (*TexPars) Set 

func (tp *TexPars) Set(rpt, off mat32.Vec2)

type Texture 

type Texture struct {
	Image *image.RGBA
}

Texture has texture image -- stored as image.RGBA for GPU compatibility

func NewTexture 

func NewTexture(img image.Image) *Texture

func (*Texture) Set 

func (tx *Texture) Set(img image.Image)

Set sets values

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.