fly/flightgear
1
0
Fork 0
Code Activity

From Till Busch - reload shaders command

Browse source 
Also, more documentation for effects.
This commit is contained in:
timoore 2009-08-08 10:20:32 +00:00 • committed by Tim Moore
parent aea9c750f3
commit b65f0ae0dc
2 changed files with 147 additions and 95 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

163
docs-mini/README.effects
View file

@ -1,75 +1,101 @@
<?xml version="1.0" encoding="utf-8"> Effects describe the graphical appearance of 3d objects and scenery in
<!-- FlightGear. The main motivation for effects is to support OpenGL
An effect consists of parameters and techniques. The "parameters" shaders and to provide different implementations for graphics hardware
section of an effect is a tree of values that describe, abstractly, of varying capabilities. Effects are similar to DirectX effects files
the graphical appearence of objects that use the effect. Techniques and Ogre3D material scripts.
refer to these parameters and use them to set OpenGL state or to
set parameters for shader programs. Parameters can be declared to
have a dynamic variance, which means that if their value is changed
the corresponding value in the technique will be changed too.
A technique can contain a predicate that describes the OpenGL An effect is a property list. The property list syntax is extended
functionality required to support the technique. The first with new "vec3d" and "vec4d" types to support common computer graphics
technique with a valid predicate in the list of techniques is used values. Effects are read from files with a ".eff" extension or can be
to set up the graphics state of the effect. A technique with no created on-the-fly by FlightGear at runtime. An effect consists of a
predicate is always assumed to be valid. "parameters" section followed by "technique" descriptions. The
"parameters" section is a tree of values that describe, abstractly,
the graphical appearence of objects that use the effect. Techniques
refer to these parameters and use them to set OpenGL state or to set
parameters for shader programs.
A technique can consist of several passes, which are run in Parameters can be declared to have a dynamic variance, which means
sequence. that if their value is changed the corresponding value in the
technique will be changed too. [TO BE IMPLEMENTED]
One feature not fully illustrated in the sample below is that A technique can contain a predicate that describes the OpenGL
effects can inherit from each other. The parent effect is listed in functionality required to support the technique. The first
the "inherits-from" form. The child effect's property tree is technique with a valid predicate in the list of techniques is used
overlaid over that of the parent. This means that effects that to set up the graphics state of the effect. A technique with no
inherit from the example "default effect" below could be very predicate is always assumed to be valid. The predicate is written in a
short, listing just new parameters and adding nothing to the little expression language that supports the following primitives:
techniques section; alternatively, a technique could be altered or
customized in a child, listing (for example) a different shader
program. Terrain materials work in this way: for each material type
in materials.xml an effect is created that inherits from a single
default terrain effect. The parameters section of the effect is
filled in using the ambient, diffuse, etc. fields of the material.
Material animations will be implemented by creating a new effect and, or, equal, less, less-equal
that inherits from one in a model, overriding the parameters that glversion - returns the version number of OpenGL
will be animated. extension-supported - returns true if an OpenGL extension is supported
property - returns the boolean value of a property
Ultimately all OpenGL state will be setable in a technique. These A technique can consist of several passes. A pass is basically an Open
attributes and modes are currently implemented: Scene Graph StateSet. Ultimately all OpenGL and OSG modes and state
lighting - true, false attributes will be setable in a technique. The following are
shade-model - flat, smooth are currently implemented:
cull-face - front, back, front-back lighting - true, false
rendering-hint - (OSG) opaque, transparent shade-model - flat, smooth
render-bin - children: bin-number, bin-name cull-face - front, back, front-back
material - children: ambient, ambient-front, ambient-back, diffuse, rendering-hint - (OSG) opaque, transparent
diffuse-front, diffuse-back, specular, specular-front, render-bin - children: bin-number, bin-name
specular-back, emissive, emissive-front, emissive-back, shininess, material - children: ambient, ambient-front, ambient-back, diffuse,
shininess-front, shininess-back, color-mode diffuse-front, diffuse-back, specular, specular-front,
blend - true, false specular-back, emissive, emissive-front, emissive-back, shininess,
alpha-test - true, false shininess-front, shininess-back, color-mode
texture-unit - blend - true, false
unit alpha-test - true, false
texture2d texture-unit - has several child properties:
unit - The number of an OpenGL texture unit
type - This is either an OpenGL texture type or the name of a
builtin texture. Currently supported OpenGL types are 1d, 2d,
3d which have the following common parameters:
image (file name) image (file name)
filter filter
mag-filter mag-filter
wrap-s wrap-s
wrap-t wrap-t
wrap-r wrap-r
The following builtin types are supported:
white - 1 pixel white texture
noise - a 3d noise texture
environment environment
mode mode
color color
program program
vertex-shader vertex-shader
fragment-shader fragment-shader
uniform uniform
name name
type - float, float-vec3, float-vec4, sampler-1d, sampler-2d, type - float, float-vec3, float-vec4, sampler-1d, sampler-2d,
sampler-3d sampler-3d
polygon-mode polygon-mode
front - fill, line, point front - fill, line, point
back - fill, line, point back - fill, line, point
-->
One feature not fully illustrated in the sample below is that
effects can inherit from each other. The parent effect is listed in
the "inherits-from" form. The child effect's property tree is
overlaid over that of the parent. Nodes that have the same name and
property index -- set by the "n=" attribute in the property tag --
are recursively merged. Leaf property nodes from the child have
precedence. This means that effects that inherit from the example
effect below could be very short, listing just new
parameters and adding nothing to the techniques section;
alternatively, a technique could be altered or customized in a
child, listing (for example) a different shader program. Terrain
materials work in this way: for each material type in materials.xml
an effect is created that inherits from a single default terrain
effect. The parameters section of the effect is filled in using the
ambient, diffuse, specular, emissive, shininess, and transparent
fields of the material. Seperate effects are created for each texture
variant of a material.
Material animations will be implemented by creating a new effect
that inherits from one in a model, overriding the parameters that
will be animated.
<PropertyList> <PropertyList>
<effect> <effect>
<name>city</name> <name>city</name>
@ -91,7 +117,6 @@
<shininess>1.2</shininess> <shininess>1.2</shininess>
</material> </material>
<texture n="0"> <texture n="0">
<texture2d>
<image>city.png</image> <image>city.png</image>
<filter>linear-mipmap-linear</filter> <filter>linear-mipmap-linear</filter>
<!-- also repeat --> <!-- also repeat -->
@ -102,10 +127,8 @@
--> -->
<!-- float, signed-integer, integer --> <!-- float, signed-integer, integer -->
<internal-format>normalized</internal-format> <internal-format>normalized</internal-format>
</texture2d>
</texture> </texture>
<texture n="1"> <texture n="1">
<texture2d>
<image>detail.png</image> <image>detail.png</image>
<filter>linear-mipmap-linear</filter> <filter>linear-mipmap-linear</filter>
<!-- also repeat --> <!-- also repeat -->
@ -116,7 +139,6 @@
--> -->
<!-- float, signed-integer, integer --> <!-- float, signed-integer, integer -->
<internal-format>normalized</internal-format> <internal-format>normalized</internal-format>
</texture2d>
</texture> </texture>
<bump-height type="double">.05</bump-height> <bump-height type="double">.05</bump-height>
<pattern-rotation type="vec4d">0 0 1 1.5708</pattern-rotation> <pattern-rotation type="vec4d">0 0 1 1.5708</pattern-rotation>
@ -146,10 +168,24 @@
<shininess><use>material/shininess</use></shininess> <shininess><use>material/shininess</use></shininess>
</material> </material>
<texture-unit> <texture-unit>
<texture2d><use>texture[0]/texture2d</use></texture2d> <unit>0</unit>
<image><use>texture[0]/image</use></image>
<filter><use>texture[0]/filter</use></filter>
<wrap-s><use>texture[0]/wrap-s</use></wrap-s>
<wrap-t><use>texture[0]/wrap-t</use></wrap-t>
<internal-format>
<use>texture[0]/internal-format</use>
</internal-format>
</texture-unit> </texture-unit>
<texture-unit> <texture-unit>
<texture2d><use>texture[1]/texture2d</use></texture2d> <unit>1</unit>
<image><use>texture[1]/image</use></image>
<filter><use>texture[1]/filter</use></filter>
<wrap-s><use>texture[1]/wrap-s</use></wrap-s>
<wrap-t><use>texture[1]/wrap-t</use></wrap-t>
<internal-format>
<use>texture[1]/internal-format</use>
</internal-format>
</texture-unit> </texture-unit>
<uniform> <uniform>
<name>bumpHeight</name> <name>bumpHeight</name>
@ -195,7 +231,14 @@
<specular><use>material/specular</use></specular> <specular><use>material/specular</use></specular>
</material> </material>
<texture-unit> <texture-unit>
<texture2d><use>texture[0]/texture2d</use></texture2d> <unit>0</unit>
<image><use>texture[0]/image</use></image>
<filter><use>texture[0]/filter</use></filter>
<wrap-s><use>texture[0]/wrap-s</use></wrap-s>
<wrap-t><use>texture[0]/wrap-t</use></wrap-t>
<internal-format>
<use>texture[0]/internal-format</use>
</internal-format>
</texture-unit> </texture-unit>
</pass> </pass>
</technique> </technique>

9
src/Main/fg_commands.cxx
View file

@ -15,6 +15,7 @@
#include <simgear/debug/logstream.hxx> #include <simgear/debug/logstream.hxx>
#include <simgear/math/sg_random.h> #include <simgear/math/sg_random.h>
#include <simgear/scene/material/mat.hxx> #include <simgear/scene/material/mat.hxx>
#include <simgear/scene/material/matlib.hxx>
#include <simgear/structure/exception.hxx> #include <simgear/structure/exception.hxx>
#include <simgear/structure/commands.hxx> #include <simgear/structure/commands.hxx>
#include <simgear/props/props.hxx> #include <simgear/props/props.hxx>
@ -497,6 +498,13 @@ do_screen_capture (const SGPropertyNode * arg)
return fgDumpSnapShot(); return fgDumpSnapShot();
} }
static bool
do_reload_shaders (const SGPropertyNode*)
{
simgear::reload_shaders();
return true;
}
static bool static bool
do_dump_scene_graph (const SGPropertyNode*) do_dump_scene_graph (const SGPropertyNode*)
{ {
@ -1564,6 +1572,7 @@ static struct {
{ "release-cockpit-button", do_release_cockpit_button }, { "release-cockpit-button", do_release_cockpit_button },
{ "dump-scenegraph", do_dump_scene_graph }, { "dump-scenegraph", do_dump_scene_graph },
{ "dump-terrainbranch", do_dump_terrain_branch }, { "dump-terrainbranch", do_dump_terrain_branch },
{ "reload-shaders", do_reload_shaders },
{ 0, 0 } // zero-terminated { 0, 0 } // zero-terminated
}; };