Mesa (master): gallium/docs: Start turning notes into docs.
Corbin Simpson
csimpson at kemper.freedesktop.org
Wed Feb 3 01:04:40 UTC 2010
Module: Mesa
Branch: master
Commit: 62ca7b85ae1f7d914156a9b376d0520db85ba495
URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=62ca7b85ae1f7d914156a9b376d0520db85ba495
Author: Corbin Simpson <MostAwesomeDude at gmail.com>
Date: Tue Feb 2 16:36:34 2010 -0800
gallium/docs: Start turning notes into docs.
Yeah, what's that? You can read it? It's got, hmm, *readability*? Nice,
ain't it. :3
---
src/gallium/docs/source/tgsi.rst | 27 +++++++++++++++------------
1 files changed, 15 insertions(+), 12 deletions(-)
diff --git a/src/gallium/docs/source/tgsi.rst b/src/gallium/docs/source/tgsi.rst
index 34d80da..7e6dce9 100644
--- a/src/gallium/docs/source/tgsi.rst
+++ b/src/gallium/docs/source/tgsi.rst
@@ -6,6 +6,19 @@ for describing shaders. Since Gallium is inherently shaderful, shaders are
an important part of the API. TGSI is the only intermediate representation
used by all drivers.
+Basics
+------
+
+All TGSI instructions, known as *opcodes*, operate on arbitrary-precision
+floating-point four-component vectors. An opcode may have up to one
+destination register, known as *dst*, and between zero and three source
+registers, called *src0* through *src2*, or simply *src* if there is only
+one.
+
+Some instructions, like :opcode:`I2F`, permit re-interpretation of vector
+components as integers. Other instructions permit using registers as
+two-component vectors with double precision; see :ref:`Double Opcodes`.
+
Instruction Set
---------------
@@ -1111,6 +1124,8 @@ ps_2_x
TBD
+.. _doubleopcodes:
+
Double Opcodes
^^^^^^^^^^^^^^^
@@ -1269,20 +1284,8 @@ Keywords
discard Discard fragment.
- dst First destination register.
-
- dst0 First destination register.
-
pc Program counter.
- src First source register.
-
- src0 First source register.
-
- src1 Second source register.
-
- src2 Third source register.
-
target Label of target instruction.
More information about the mesa-commit
mailing list