Debian Codegraph @

doc/geomview.html/SKEL.html

raw
1 <html lang="en">
2 <head>
3 <title>SKEL - Geomview Manual</title>
4 <meta http-equiv="Content-Type" content="text/html">
5 <meta name="description" content="Geomview Manual">
6 <meta name="generator" content="makeinfo 4.13">
7 <link title="Top" rel="start" href="index.html#Top">
8 <link rel="up" href="Object-File-Formats.html#Object-File-Formats" title="Object File Formats">
9 <link rel="prev" href="VECT.html#VECT" title="VECT">
10 <link rel="next" href="SPHERE.html#SPHERE" title="SPHERE">
11 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
12 <meta http-equiv="Content-Style-Type" content="text/css">
13 <style type="text/css"><!--
14 pre.display { font-family:inherit }
15 pre.format { font-family:inherit }
16 pre.smalldisplay { font-family:inherit; font-size:smaller }
17 pre.smallformat { font-family:inherit; font-size:smaller }
18 pre.smallexample { font-size:smaller }
19 pre.smalllisp { font-size:smaller }
20 span.sc { font-variant:small-caps }
21 span.roman { font-family:serif; font-weight:normal; }
22 span.sansserif { font-family:sans-serif; font-weight:normal; }
23 --></style>
24 </head>
25 <body>
26 <div class="node">
27 <a name="SKEL"></a>
28 <p>
29 Next:&nbsp;<a rel="next" accesskey="n" href="SPHERE.html#SPHERE">SPHERE</a>,
30 Previous:&nbsp;<a rel="previous" accesskey="p" href="VECT.html#VECT">VECT</a>,
31 Up:&nbsp;<a rel="up" accesskey="u" href="Object-File-Formats.html#Object-File-Formats">Object File Formats</a>
32 <hr>
33 </div>
34
35 <h4 class="subsection">4.2.7 SKEL Files</h4>
36
37 <p><code>SKEL</code> files represent collections of points and polylines, with
38 shared vertices.
39 The conventional suffix for <code>SKEL</code> files is <samp><span class="file">.skel</span></samp>.
40
41 <p>Syntax:
42
43 <pre class="example"> [C][4][n]SKEL
44 [<var>NDim</var>] # Vertex dimension, present only if nSKEL
45 <var>NVertices</var> <var>NPolylines</var>
46
47 <var>x</var>[0] <var>y</var>[0] <var>z</var>[0] # Vertices
48 # if 4SKEL, each vertex has 4 components
49 # if nSKEL, each vertex has NDim components
50 # if C[4][n]SKEL vertex coordinates are
51 # followed by an RGBA color specification
52 ...
53 <var>x</var>[<var>NVertices</var>-1] <var>y</var>[<var>NVertices</var>-1] <var>z</var>[<var>NVertices</var>-1]
54
55 # Polylines
56 # <var>Nv</var> = vertices on this polyline (1 = point)
57 # <var>v</var>[0] ... <var>v</var>[<var>Nv</var>-1]: vertex indices
58 # in range 0..<var>NVertices</var>-1
59 <var>Nv</var> <var>v</var>[0] <var>v</var>[1] ... <var>v</var>[<var>Nv</var>-1] [<var>colorspec</var>]
60 ...
61 # <var>colorspec</var> continues past <var>v</var>[<var>Nv</var>-1]
62 # to end-of-line; may be nothing, or 3 or 4 numbers.
63 # nothing: default color
64 # 3 or 4 floats: RGB[A] values 0..1
65 </pre>
66 <p>The syntax resembles that of <code>OFF</code> files, with a table of vertices
67 followed by a sequence of polyline descriptions, each referring to vertices
68 by index in the table. Each polyline has an optional color.
69
70 <p>For <code>nSKEL</code> objects, each vertex has <var>NDim</var> components.
71 For <code>4nSKEL</code> objects, each vertex has <var>NDim+1</var> components;
72 the final component is the homogeneous divisor.
73
74 <p>A <var>[4][n]SKEL BINARY</var> format is accepted; See <a href="Binary-format.html#Binary-format">Binary format</a>.
75 It resembles the ASCII format in almost the way you'd expect,
76 with 32-bit integers for all counters and vertex indices and 32-bit
77 floats for vertex positions.
78
79 <p>Exception: each polyline's vertex indices are followed by an integer
80 indicating how many color components accompany it. Polyline color
81 components must be floats, not integer values. Thus a colorless
82 polyline with 3 vertices might be represented as
83
84 <pre class="example"> int int int int int
85 3 17 5 9 0
86 </pre>
87 <p>while the same polyline colored red might be
88
89 <pre class="example"> int int int int int float float float float
90 3 17 5 9 4 1.0 0.0 0.0 1.0
91 </pre>
92 <!-- -->
93 </body></html>
94