• Home
  • History
  • Annotate
Name Date Size #Lines LOC

..03-May-2022-

doc/H07-May-2022-

examples/H03-May-2022-1,404893

man/src/H03-May-2022-7,6435,824

Makefile.inH A D03-May-20228.2 KiB249122

READMEH A D31-Dec-19946.2 KiB169123

changesH A D30-Dec-19944.2 KiB11176

config.guessH A D11-Nov-199412.8 KiB471391

config.h.inH A D25-Sep-1994452 1711

config.subH A D11-Nov-199415.9 KiB794695

configureH A D31-Dec-199434.3 KiB1,183929

configure.inH A D15-Dec-19941.3 KiB6154

install-shH A D25-Sep-19944.6 KiB237152

makeopts.cH A D30-Dec-19941.7 KiB6830

no_edit_headerH A D13-Jul-1994882 2523

patchlevel.hH A D17-Dec-199448 31

volpack.hH A D30-Dec-199424.8 KiB578428

vp_check.cH A D30-Dec-19948.1 KiB334225

vp_compA.m4H A D30-Dec-199457.7 KiB2,0171,884

vp_context.cH A D01-Jan-199551.6 KiB2,1111,736

vp_extract.cH A D30-Dec-199420.9 KiB709555

vp_file.cH A D30-Dec-199438.1 KiB1,223882

vp_global.hH A D03-May-202230.9 KiB772459

vp_linalg.cH A D30-Dec-19947.4 KiB352213

vp_octree.cH A D30-Dec-199450.1 KiB1,5661,259

vp_renderA.cH A D30-Dec-199431.5 KiB891741

vp_renderB.cH A D30-Dec-199424.2 KiB855668

vp_renderC.cH A D30-Dec-19945.5 KiB239167

vp_renderR.cH A D30-Dec-19944.8 KiB207137

vp_resample.cH A D30-Dec-199432.8 KiB1,118848

vp_rle.cH A D30-Dec-199445.2 KiB1,5881,205

vp_shade.cH A D30-Dec-199425 KiB771568

vp_transpose.cH A D30-Dec-19944.3 KiB15093

vp_util.cH A D30-Dec-19943.2 KiB15396

vp_view.cH A D30-Dec-199433.1 KiB1,096818

vp_warp.cH A D30-Dec-199414.7 KiB420311

vp_warpA.m4H A D30-Dec-199418.8 KiB557521

README

1                       VolPack version 1.0beta3
2                       ------------------------
3
4Phil Lacroute
5volpack@graphics.stanford.edu
616 December 1994
7
81. Introduction
9---------------
10
11VolPack is a portable library of fast volume rendering algorithms
12that produce high-quality images.
13
142. Installation
15---------------
16
17To build the library, do the following:
18
19  A. Type "./configure" in this directory.  This will run a shell
20     script that determines the features of your operating system
21     and then automatically chooses compiler flags and configuration
22     constants for VolPack.
23
24     Configure takes a number of options, but only the commonly-used
25     ones are described here.  You can specify the top-level
26     installation directory with the "--prefix=<directory>"
27     option, and the top-level installation directory for
28     architecture-dependent binaries with "--exec_prefix=<directory>".
29     Both options default to /usr/local.
30
31     If you want, you can look at the Makefile configure builds and
32     override some of the options.
33
34  B. Type "make".  This creates a library archive call "libvolpack.a".
35
36  C. To compile the example programs type "make examples", or move
37     to the examples directory and type "make".
38
39  D. Type "make install" to install the library, include files, and
40     manual entries.
41
42  E. Look at the User's Guide in the "doc" directory for a tutorial
43     introduction, and look at the examples programs in the "examples"
44     directory (see examples/README).
45
46If you have a version of "m4" that does not understand the -D option
47then the compilation will fail (usually "make" will appear to hang
48after the first call to m4).  Some systems have two versions of m4;
49you can choose the correct one by editting the "M4" macro in
50Makefile.in or by setting the M4 environment variable to the correct
51path before running configure.  You can also install GNU m4.
52
53If your optimizer has trouble or takes a long time on some of the
54files you may want to use a lower optimization level for them.  All of the
55files with names like vp_comp*.c are special-case versions of the
56rendering routine and you may choose to optimize only the ones you
57plan to use frequently.
58
59An important note for HP-UX users:
60The math library rint() function is broken in HP-UX 9.01 (and maybe
61other releases), causing the VolPack test programs to generate blank
62images.  This is fixed by HP patch "PHSS_3597", which HP-UX users can
63get from HP support.
64
653. Documentation
66----------------
67
68The doc directory contains a user's guide to VolPack in HTML format
69(volpack.html) which you can read using Mosaic or any other Web
70browser.  A PostScript version is also available.
71
72The man directory contains manual pages for each routine in the
73library.
74
754. Support
76----------
77
78If you have problems, bug reports or bug fixes, please send mail to:
79
80    volpack@graphics.stanford.edu
81
82The author makes no commitment to fix bugs or provide support.
83However, future releases with fixes and enhancements are planned.
84If you like the library then drop us a note describing what you use it
85for!
86
87If you decide to use the software then please add yourself to our
88mailing list so we can tell you about bug fixes and new versions of
89the software.  Just send a message to
90
91    majordomo@lists.stanford.edu
92
93with the message body:
94
95    subscribe volpack-announce
96
975. Data Sets and Other Goodies
98------------------------------
99
100One sample data set is provided in the examples directory.  Some
101larger data sets and a more complete demonstration application,
102vprender, are available from the Stanford Computer Graphics
103Laboratory's ftp site:
104    graphics.stanford.edu:pub/volpack
105or
106    http://www-graphics.stanford.edu/
107
1086. Changes
109----------
110
111Release 1.0beta3 includes the following additions to release 1.0beta2:
112
113    - a new shader for rendering shadows (see vpSetShadowLookupShader)
114    - filtering routines for resampling volumes to different resolutions
115    - the capability to produce images with different pixel formats,
116      including formats with alpha channels
117    - several important bug fixes, including a problem with depth
118      cueing that caused "flashing" artifacts in rotation sequences
119    - upgraded configuration script to autoconf 2.0 for even easier
120      installation
121
122See the "changes" file for a complete list.  There are minor
123incompatible changes to the functions vpSetImage and vpGetImage.
124
1257. Copyright
126------------
127
128VolPack is covered by the following copyright notice:
129
130    Copyright (c) 1994 The Board of Trustees of The Leland Stanford
131    Junior University.  All rights reserved.
132
133    Permission to use, copy, modify and distribute this software and its
134    documentation for any purpose is hereby granted without fee, provided
135    that the above copyright notice and this permission notice appear in
136    all copies of this software and that you do not sell the software.
137    Commercial licensing is available by contacting the author.
138
139    THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTY OF ANY KIND,
140    EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY
141    WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
142
143
1448. Credits
145----------
146
147VolPack was written by Phil Lacroute at the Computer Graphics
148Laboratory, Stanford University.  The algorithms are based on Phil's
149Ph.D. thesis research and are described in the following paper:
150Philippe Lacroute and Marc Levoy, Fast Volume Rendering Using a
151Shear-Warp Factorization of the Viewing Transformation, Proc. SIGGRAPH
152'94 (Orlando, Florida, July 24-29, 1994).  In Computer Graphics
153Proceedings, Annual Conference Series, 1994, ACM SIGGRAPH, pp. 451-458.
154
155If you publish a rendering made using VolPack and you would like to
156make an attribution, the following form is suggested:
157
158    Image generated using the Stanford VolPack volume renderer.
159
160An appropriate longer attribution could omit the word Stanford but would
161include a citation of the SIGGRAPH '94 paper:
162
163    Image generated using the VolPack volume renderer [#].
164
165    [#]  Philippe Lacroute and Marc Levoy, Fast Volume Rendering Using a
166    Shear-Warp Factorization of the Viewing Transformation, Proc. SIGGRAPH
167    '94 (Orlando, Florida, July 24-29, 1994).  In Computer Graphics
168    Proceedings, Annual Conference Series, 1994, ACM SIGGRAPH, pp. 451-458.
169