1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
|
#!/usr/bin/env python3
#########################################################################
# Copyright (C) 2011-2012 Tavian Barnes <tavianator@tavianator.com> #
# #
# This file is part of Dimension. #
# #
# Dimension is free software; you can redistribute it and/or modify it #
# under the terms of the GNU General Public License as published by the #
# Free Software Foundation; either version 3 of the License, or (at #
# your option) any later version. #
# #
# Dimension is distributed in the hope that it will be useful, but #
# WITHOUT ANY WARRANTY; without even the implied warranty of #
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU #
# General Public License for more details. #
# #
# You should have received a copy of the GNU General Public License #
# along with this program. If not, see <http://www.gnu.org/licenses/>. #
#########################################################################
import argparse
import re
import os
import sys
import threading
from contextlib import contextmanager
from dimension import *
def main():
"""Invoke the client from the command line."""
# Parse the command line
parser = DimensionArgumentParser(
epilog = "@PACKAGE_STRING@\n"
"@PACKAGE_URL@\n"
"Copyright (C) 2009-2011 Tavian Barnes <@PACKAGE_BUGREPORT@>\n"
"Licensed under the GNU General Public License",
formatter_class = argparse.RawDescriptionHelpFormatter,
conflict_handler = "resolve", # For -h as height instead of help
)
parser.add_argument("-V", "--version", action = "version",
version = "@PACKAGE_STRING@")
parser.add_argument("-w", "--width", action = "store", type = int,
default = 768,
help = "image width (default: %(default)s)")
parser.add_argument("-h", "--height", action = "store", type = int,
default = 480,
help = "image height (default: %(default)s)")
parser.add_argument("--region", action = "store", type = str,
help = "subregion to render, as \"(x1, y1)->(x2, y2)\"")
parser.add_argument("-v", "--verbose", action = "store_true",
help = "print more information")
parser.add_argument("-q", "--quiet", action = "store_true",
help = "print less information")
parser.add_argument("--threads", action = "store", type = int,
help = "the number of threads to render with")
parser.add_argument("--quality", action = "store", type = str,
help = "the scene quality")
parser.add_argument("--adc-bailout", action = "store", type = str,
help = "the ADC bailout (default: 1/255)")
parser.add_argument("-o", "--output", action = "store", type = str,
help = "the output image file")
parser.add_argument("input", action = "store", type = str,
help = "the input scene description file")
parser.add_argument("-p", "--preview", action = "store_true",
help = "display a preview while the image renders")
# Debugging/testing options
parser.add_argument("--strict", action = "store_true",
help = argparse.SUPPRESS)
args = parser.parse_args()
# Calculate subregion
calculate_subregion(args)
# Default output is basename(input).png
if args.output is None:
noext = os.path.splitext(os.path.basename(args.input))[0]
args.output = noext + ".png"
# Handle the --strict option
die_on_warnings(args.strict)
# Sandbox dictionary for the scene
sandbox = { }
sandbox.update(__import__("dimension").__dict__)
sandbox.update(__import__("math").__dict__)
# Defaults/available variables
sandbox.update({
"image_width" : args.width,
"image_height" : args.height,
"objects" : [],
"lights" : [],
"camera" : PerspectiveCamera(),
"default_texture" : Texture(finish = Ambient(sRGB(0.1))
+ Diffuse(sRGB(0.7))),
"default_interior" : Interior(),
"background" : Black,
"recursion_limit" : None,
})
# Execute the input script
if not args.quiet:
print("Parsing scene ...")
# Run with the script's dirname as the working directory
workdir = os.path.dirname(os.path.abspath(args.input))
parse_timer = Timer()
with open(args.input) as fh, working_directory(workdir):
exec(compile(fh.read(), args.input, "exec"), sandbox)
parse_timer.stop()
# Make the canvas
canvas = Canvas(width = args.region_width, height = args.region_height)
canvas.optimize_PNG()
if args.preview:
canvas.optimize_GL()
# Make the scene object
scene = Scene(canvas = canvas,
objects = sandbox["objects"],
lights = sandbox["lights"],
camera = sandbox["camera"])
scene.region_x = args.region_x
scene.region_y = args.region_y
scene.outer_width = args.width
scene.outer_height = args.height
scene.default_texture = sandbox["default_texture"]
scene.default_interior = sandbox["default_interior"]
scene.background = sandbox["background"]
if sandbox["recursion_limit"] is not None:
scene.recursion_limit = sandbox["recursion_limit"]
if args.threads is not None:
scene.nthreads = args.threads
if args.quality is not None:
scene.quality = args.quality
if args.adc_bailout is not None:
pattern = r"^(.*)/(.*)$"
match = re.match(pattern, args.adc_bailout)
if match is not None:
args.adc_bailout = float(match.group(1))/float(match.group(2))
scene.adc_bailout = float(args.adc_bailout)
# Ray-trace the scene
with scene.render_async() as future:
bar = None
if not args.quiet:
if scene.nthreads == 1:
render_message = "Rendering scene"
else:
render_message = "Rendering scene (using %d threads)" % scene.nthreads
bar = progress_bar_async(render_message, future)
if args.preview:
from dimension import preview
preview.show_preview(canvas, future)
if bar is not None:
join_progress_bar(bar)
# Write the output file
export_timer = Timer()
with canvas.write_PNG_async(args.output) as future:
if not args.quiet:
progress_bar("Writing %s" % args.output, future)
export_timer.stop()
# Print execution times
if args.verbose:
print()
print("Parsing time: ", parse_timer)
print("Bounding time: ", scene.bounding_timer)
print("Rendering time: ", scene.render_timer)
print("Exporting time: ", export_timer)
class DimensionArgumentParser(argparse.ArgumentParser):
"""
Specialized parser to print --version output to stdout rather than stderr.
"""
def exit(self, status = 0, message = None):
if message:
file = sys.stdout if status == 0 else sys.stderr
file.write(message)
sys.exit(status)
def calculate_subregion(args):
if args.region is None:
args.region_x = 0
args.region_y = 0
args.region_width = args.width
args.region_height = args.height
else:
pattern = r"^\s*\(\s*(\d*)\s*,\s*(\d*)\s*\)\s*->\s*\(\s*(\d*)\s*,\s*(\d*)\s*\)\s*$"
match = re.match(pattern, args.region)
if match is None:
raise RuntimeError("range specified in invalid format.")
args.region_x = int(match.group(1))
args.region_y = int(match.group(2))
region_xmax = int(match.group(3))
region_ymax = int(match.group(4))
args.region_width = region_xmax - args.region_x
args.region_height = region_ymax - args.region_y
if args.region_width <= 0 or args.region_height <= 0:
raise RuntimeError("region is degenerate.")
if region_xmax >= args.width or region_ymax > args.height:
raise RuntimeError("region exceeds bounds of image.")
@contextmanager
def working_directory(newwd):
"""Change the working directory within a with statement."""
oldwd = os.getcwd()
try:
os.chdir(newwd)
yield
finally:
os.chdir(oldwd)
def progress_bar(str, future):
"""Display a progress bar while a Future completes."""
print(str, end = " ")
sys.stdout.flush()
term_width = terminal_width()
width = term_width - (len(str) + 1)%term_width
for i in range(width):
future.wait((i + 1)/width)
print(".", end = "")
sys.stdout.flush()
print()
sys.stdout.flush()
def progress_bar_async(str, future):
thread = threading.Thread(target = progress_bar, args = (str, future))
thread.start()
return (thread, future)
def join_progress_bar(bar):
"""Handle joining a progress bar thread in a way responsive to ^C."""
thread = bar[0]
future = bar[1]
try:
thread.join()
except:
future.cancel()
thread.join()
raise
|
