diff options
author | Stéphane Marchesin <[email protected]> | 2011-08-26 17:37:25 -0700 |
---|---|---|
committer | Stéphane Marchesin <[email protected]> | 2011-08-26 17:37:25 -0700 |
commit | f8e6d19f3f40931be741b44d3edf210c38e13f0f (patch) | |
tree | e99e4c619901412ac6448534b0f57ce1c4295c6b /docs | |
parent | 974c49ed176de55aadb335a2956ef5dfec774a23 (diff) | |
parent | e3b0e3776646d0367206e4544229622eb22fe9f8 (diff) |
Merge branch 'master' of git://anongit.freedesktop.org/mesa/mesa
Diffstat (limited to 'docs')
-rw-r--r-- | docs/GL3.txt | 13 | ||||
-rw-r--r-- | docs/autoconf.html | 7 | ||||
-rw-r--r-- | docs/contents.html | 1 | ||||
-rw-r--r-- | docs/devinfo.html | 33 | ||||
-rw-r--r-- | docs/download.html | 1 | ||||
-rw-r--r-- | docs/faq.html | 7 | ||||
-rw-r--r-- | docs/install.html | 5 | ||||
-rw-r--r-- | docs/postprocess.html | 56 | ||||
-rw-r--r-- | docs/sourcetree.html | 2 |
9 files changed, 109 insertions, 16 deletions
diff --git a/docs/GL3.txt b/docs/GL3.txt index 135bc4bab67..ff1f5020a5b 100644 --- a/docs/GL3.txt +++ b/docs/GL3.txt @@ -114,6 +114,19 @@ GL_ARB_vertex_attrib_64bit not started GL_ARB_viewport_array not started +GL 4.2: +GLSL 4.2 not started +GL_ARB_texture_compression_bptc not started +GL_ARB_compressed_texture_pixel_storage not started +GL_ARB_shader_atomic_counters not started +GL_ARB_texture_storage not started +GL_ARB_transform_feedback_instanced not started +GL_ARB_base_instance not started +GL_ARB_shader_image_load_store not started +GL_ARB_conservative_depth DONE (compiler) +GL_ARB_shading_language_420pack not started +GL_ARB_internalformat_query not started +GL_ARB_map_buffer_alignment not started More info about these features and the work involved can be found at diff --git a/docs/autoconf.html b/docs/autoconf.html index 64bcbd48a67..895cf665c5b 100644 --- a/docs/autoconf.html +++ b/docs/autoconf.html @@ -20,7 +20,6 @@ <li><a href="#library">Library Options</a></li> <ul> <li><a href="#glu">GLU</a></li> - <li><a href="#glw">GLw</a></li> </ul> <li><a href="#demos">Demo Program Options</a></li> </ol> @@ -245,12 +244,6 @@ instructions</a>. on all drivers. This can be disable with the option <code>--disable-glu</code>. </li> - -<a name="glw"> -<li><b><em>GLw</em></b> - The libGLw library will be built by default -if libGLU has been enabled. This can be disable with the option -<code>--disable-glw</code>. -</li> </ul> </p> diff --git a/docs/contents.html b/docs/contents.html index 8fc2ac0da9f..46e458ee174 100644 --- a/docs/contents.html +++ b/docs/contents.html @@ -63,6 +63,7 @@ a:visited { <LI><A HREF="extensions.html" target="MainFrame">Mesa Extensions</A> <LI><A HREF="mangling.html" target="MainFrame">Function Name Mangling</A> <LI><A href="llvmpipe.html" target="MainFrame">Gallium llvmpipe driver</A> +<LI><A href="postprocess.html" target="MainFrame">Gallium post-processing</A> </ul> <b>Developer Topics</b> diff --git a/docs/devinfo.html b/docs/devinfo.html index 8887dd02624..d9e82e29d0b 100644 --- a/docs/devinfo.html +++ b/docs/devinfo.html @@ -72,6 +72,13 @@ If you use tabs, set them to 8 columns </p> <p> +Line width: the preferred width to fill comments and code in Mesa is 78 +columns. Exceptions are sometimes made for clarity (e.g. tabular data is +sometimes filled to a much larger width so that extraneous carriage returns +don't obscure the table). +</p> + +<p> Brace example: </p> <pre> @@ -81,10 +88,26 @@ Brace example: else { bar; } + + switch (condition) { + case 0: + foo(); + break; + + case 1: { + ... + break; + } + + default: + ... + break; + } </pre> <p> Here's the GNU indent command which will best approximate my preferred style: +(Note that it won't format switch statements in the preferred way) </p> <pre> indent -br -i3 -npcs --no-tabs infile.c -o outfile.c @@ -114,6 +137,16 @@ Function name examples: _mesa_foo_bar() - an internal non-static Mesa function </pre> +<p> +Places that are not directly visible to the GL API should prefer the use +of <tt>bool</tt>, <tt>true</tt>, and +<tt>false</tt> over <tt>GLboolean</tt>, <tt>GL_TRUE</tt>, and +<tt>GL_FALSE</tt>. In C code, this may mean that +<tt>#include <stdbool.h></tt> need to be added. The +<tt>try_emit_</tt>* methods in src/mesa/program/ir_to_mesa.cpp and +src/mesa/state_tracker/st_glsl_to_tgsi.cpp can serve as an example. +</p> + <H2>Making a New Mesa Release</H2> diff --git a/docs/download.html b/docs/download.html index 3c4d5976c2c..4e8fc2f02f0 100644 --- a/docs/download.html +++ b/docs/download.html @@ -84,7 +84,6 @@ src/mesa - sources for the main Mesa library and device drivers src/gallium - sources for Gallium and Gallium drivers src/glu - libGLU source code src/glx - sources for building libGL with full GLX and DRI support -src/glw - Xt/Motif/OpenGL widget code </pre> If you downloaded and unpacked the MesaGLUT.x.y.z package: diff --git a/docs/faq.html b/docs/faq.html index 071381c5a1c..bf6545fd5f7 100644 --- a/docs/faq.html +++ b/docs/faq.html @@ -204,8 +204,13 @@ If you don't already have GLUT installed, you should grab </a></p> +<h2><a name="part2">2.4 Where is the GLw library?</a></h2> +<p> +<a name="part2">GLw (OpenGL widget library) is now available from a separate <a href="http://cgit.freedesktop.org/mesa/glw/">git repository</a>. Unless you're using very old Xt/Motif applications with OpenGL, you shouldn't need it. +</a></p> + -<h2><a name="part2">2.4 What's the proper place for the libraries and headers?</a></h2> +<h2><a name="part2">2.5 What's the proper place for the libraries and headers?</a></h2> <p> <a name="part2">On Linux-based systems you'll want to follow the </a><a href="http://oss.sgi.com/projects/ogl-sample/ABI/index.html" diff --git a/docs/install.html b/docs/install.html index e1018119a76..c86a755e4b6 100644 --- a/docs/install.html +++ b/docs/install.html @@ -157,9 +157,6 @@ lrwxrwxrwx 1 brian users 20 Mar 26 07:53 libGLU.so.1 -> libGLU.so lrwxrwxrwx 1 brian users 12 Mar 26 07:53 libglut.so -> libglut.so.3* lrwxrwxrwx 1 brian users 16 Mar 26 07:53 libglut.so.3 -> libglut.so.3.7.1* -rwxr-xr-x 1 brian users 597754 Mar 26 07:53 libglut.so.3.7.1* -lrwxrwxrwx 1 brian users 11 Mar 26 08:04 libGLw.so -> libGLw.so.1* -lrwxrwxrwx 1 brian users 15 Mar 26 08:04 libGLw.so.1 -> libGLw.so.1.0.0* --rwxr-xr-x 1 brian users 20750 Mar 26 08:04 libGLw.so.1.0.0* lrwxrwxrwx 1 brian users 14 Mar 26 07:53 libOSMesa.so -> libOSMesa.so.6* lrwxrwxrwx 1 brian users 23 Mar 26 07:53 libOSMesa.so.6 -> libOSMesa.so.6.1.060100* -rwxr-xr-x 1 brian users 23871 Mar 26 07:53 libOSMesa.so.6.1.060100* @@ -172,8 +169,6 @@ lrwxrwxrwx 1 brian users 23 Mar 26 07:53 libOSMesa.so.6 -> libOSM <br> <b>libglut</b> is the GLUT library. <br> -<b>libGLw</b> is the Xt/Motif OpenGL drawing area widget library. -<br> <b>libOSMesa</b> is the OSMesa (Off-Screen) interface library. </p> diff --git a/docs/postprocess.html b/docs/postprocess.html new file mode 100644 index 00000000000..2a379694298 --- /dev/null +++ b/docs/postprocess.html @@ -0,0 +1,56 @@ +<HTML> + +<TITLE>Gallium Post-processing</TITLE> + +<link rel="stylesheet" type="text/css" href="mesa.css"></head> + +<BODY> + +<H1>Gallium Post-processing</H1> + +<p> +The Gallium drivers support user-defined image post-processing. +At the end of drawing a frame a post-processing filter can be applied to +the rendered image. +Example filters include morphological antialiasing and cell shading. +</p> + +<p> +The filters can be toggled per-app via driconf, or per-session via the +corresponding environment variables. +</p> + +<p> +Multiple filters can be used together. +</p> + + +<H2>PP environment variables</H2> + +<ul> +<li>PP_DEBUG - If defined debug information will be printed to stderr. +</ul> + +<h2>Current filters</h2> + +<ul> +<li>pp_nored, pp_nogreen, pp_noblue - set to 1 to remove the corresponding color channel. +These are basic filters for easy testing of the PP queue. +<li>pp_jimenezmlaa, pp_jimenezmlaa_color - +<a href="http://www.iryokufx.com/mlaa/" target=_blank>Jimenez's MLAA</a> +is a morphological antialiasing filter. +The two versions use depth and color data, respectively. +Which works better depends on the app - depth will not blur text, but it will +miss transparent textures for example. +Set to a number from 2 to 32, roughly corresponding to quality. +Numbers higher than 8 see minimizing gains. +<li>pp_celshade - set to 1 to enable cell shading (a more complex color filter). +</ul> + + +<br> +<br> + + +</BODY> +</HTML> diff --git a/docs/sourcetree.html b/docs/sourcetree.html index 2e2d1d3f275..713e25b019c 100644 --- a/docs/sourcetree.html +++ b/docs/sourcetree.html @@ -153,8 +153,6 @@ each directory. <li><b>glx</b> - The GLX library code for building libGL. This is used for direct rendering drivers. It will dynamically load one of the xxx_dri.so drivers. - <li><b>glw</b> - Widgets for Xt/Motif. - <li><b>glew</b> - OpenGL Extension Wrangler library (used by demo programs) </ul> <li><b>progs</b> - OpenGL test and demonstration programs <li><b>lib</b> - where the GL libraries are placed |