summaryrefslogtreecommitdiff
path: root/libgraphics/doc/libgraphics.ms
diff options
context:
space:
mode:
authorrgl <devnull@localhost>2020-02-03 22:42:28 +0100
committerrgl <devnull@localhost>2020-02-03 22:42:28 +0100
commit0373255087377122eeb10e006ffb8aa1b57e611c (patch)
tree33a4fafa4996fc2efa205b2973622c3fbd27f368 /libgraphics/doc/libgraphics.ms
download3dee-0373255087377122eeb10e006ffb8aa1b57e611c.tar.gz
3dee-0373255087377122eeb10e006ffb8aa1b57e611c.tar.bz2
3dee-0373255087377122eeb10e006ffb8aa1b57e611c.zip
after a year or so of work, i dare create a proper repo.
Diffstat (limited to 'libgraphics/doc/libgraphics.ms')
-rw-r--r--libgraphics/doc/libgraphics.ms34
1 files changed, 34 insertions, 0 deletions
diff --git a/libgraphics/doc/libgraphics.ms b/libgraphics/doc/libgraphics.ms
new file mode 100644
index 0000000..87a23a7
--- /dev/null
+++ b/libgraphics/doc/libgraphics.ms
@@ -0,0 +1,34 @@
+.TL
+libgraphics
+.AU
+Rodrigo G. López
+.sp
+rgl@antares-labs.eu
+.AI
+Antares Telecom Laboratories
+Albatera, Alicante
+.FS
+ACHTUNG! this is a
+.B "WORK IN PROGRESS"
+.FE
+.NH 1
+Data Structures
+.NH 2
+Camera
+.P1
+struct Camera {
+ RFrame3; /* VCS */
+ Image *viewport;
+ double fov; /* vertical FOV */
+ struct {
+ double n, f; /* near and far clipping planes */
+ } clip;
+ Projection ptype;
+ Matrix3 proj; /* VCS to viewport xform */
+};
+.P2
+.PP
+A camera is an image capturing entity, analog to the real world device
+we all know, that allows us to see the virtual 3-D world by projecting
+it into a viewport we can attach to a screen or window for real-time
+visualization or write out into a file.