renderer

Documentation

Overview

Package renderer implements the scene renderer.

Index

• Constants
• type Renderer
  • func NewRenderer(gs *gls.GLS) *Renderer
  • func (r *Renderer) ObjectSorting() bool
  • func (r *Renderer) Render(scene core.INode, cam camera.ICamera) error
  • func (r *Renderer) SetObjectSorting(sort bool)
  • func (r *Renderer) Stats() Stats
• type ShaderSpecs
• type Shaman
  • func (sm *Shaman) AddShaders()
  • func (sm *Shaman) Init(gs *gls.GLS)
  • func (sm *Shaman) NewFrame()
  • func (sm *Shaman) SetProgram(specs ShaderSpecs) (bool, error)
• type Stats

Constants

const GLSL_VERSION = "330 core"

Types

type Renderer

type Renderer struct {
	Shaman // Embedded shader manager
	// contains filtered or unexported fields
}

Renderer renders a scene containing 3D objects and/or 2D GUI elements.

func NewRenderer

func NewRenderer(gs *gls.GLS) *Renderer

NewRenderer creates and returns a pointer to a new Renderer.

func (*Renderer) ObjectSorting

func (r *Renderer) ObjectSorting() bool

ObjectSorting returns whether objects will be sorted before rendering.

func (*Renderer) Render

func (r *Renderer) Render(scene core.INode, cam camera.ICamera) error

Render renders the specified scene using the specified camera. Returns an error.

func (*Renderer) SetObjectSorting

func (r *Renderer) SetObjectSorting(sort bool)

SetObjectSorting sets whether objects will be sorted before rendering.

func (*Renderer) Stats

func (r *Renderer) Stats() Stats

Stats returns a copy of the statistics for the last frame. Should be called after the frame was rendered.

type ShaderSpecs

type ShaderSpecs struct {
	Name             string              // Shader name
	UseLights        material.UseLights  // Bitmask indicating which lights to consider
	AmbientLightsMax int                 // Number of ambient lights
	DirLightsMax     int                 // Number of directional lights
	PointLightsMax   int                 // Number of point lights
	SpotLightsMax    int                 // Number of spot lights
	MatTexturesMax   int                 // Number of material textures
	MaterialDefines  gls.MaterialDefines // Additional shader defines
	GeometryDefines  gls.GeometryDefines // Additional shader defines
	GraphicDefines   gls.GraphicDefines  // Additional shader defines
}

ShaderSpecs describes the specification of a compiled shader program.

type Shaman

type Shaman struct {
	// contains filtered or unexported fields
}

Shaman is the shader manager.

func (*Shaman) AddShaders

func (sm *Shaman) AddShaders()

AddShaders adds registered shaders and programs to the Shaman.

func (*Shaman) Init

func (sm *Shaman) Init(gs *gls.GLS)

Init initializes the shader manager

func (*Shaman) NewFrame

func (sm *Shaman) NewFrame()

func (*Shaman) SetProgram

func (sm *Shaman) SetProgram(specs ShaderSpecs) (bool, error)

SetProgram sets the shader program to satisfy the specs.

Returns whether this is the first time this program was activated this frame and an error if one occurred.

type Stats

type Stats struct {
	GraphicMats int // Number of graphic materials rendered
	Lights      int // Number of lights rendered
	Panels      int // Number of GUI panels rendered
	Others      int // Number of other objects rendered
}

Stats describes how many objects of each type are being rendered. It is cleared at the start of each render.