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
|
# Copyright 2009 Nanorex, Inc. See LICENSE file for details.
"""
GraphicsTestCase.py - abstract class for a test case for Test Graphics Performance
@author: Bruce
@version: $Id$
@copyright: 2009 Nanorex, Inc. See LICENSE file for details.
todo: refile some or all of this out of this specific command?
"""
class GraphicsTestCase(object):
"""
abstract class for a test case for Test Graphics Performance command
"""
# == setup-like methods
def __init__(self, *params):
"""
@param params: optional, arbitrary parameters to be used by the test case.
"""
self._params = params
# REVIEW: if we insist on passing these to __init__,
# do we still need activate/deactivate methods? Guess: yes,
# but we simplify their semantics by not worrying about
# whether to call them when params changed
# (since we always use a new instance then).
return
def current_params(self):
"""
Return the test case parameters,
as a tuple of the args passed to self.__init__.
"""
# review: use copy_val?
return self._params
def __str__(self):
shortname = self.__class__.__name__.split('.')[-1]
return "%s%r" % (shortname, self._params)
def activate(self):
"""
Make sure this instance is ready to be used immediately.
You can assume that this is either called just before self.draw(),
or that no other test case's .draw method has been called between
when this was called and when self.draw() is called.
TBD: whether it is necessarily called when test case parameters change.
(Guess: should be, but isn't in initial prototype.)
(Note that that means that the subclass API semantics for this method
depends on how it's used by the totality of test cases.
At present, one thing it can be used for is setting up the global environment
for drawing, e.g. the list of DrawingSets to draw,
in a way depended on by self.draw.)
"""
return
# == deallocation-like methods
def destroy(self):
"""
"""
self.deactivate()
return
def deactivate(self):
"""
Optimize for not planning to reuse this instance for awhile.
"""
self.clear_caches()
return
def clear_caches(self):
"""
Deallocate whatever caches this instance owns
(which consume nontrivial amounts of CPU or GPU RAM),
without preventing further uses of this instance.
"""
return
# == drawing methods
def draw_complete(self):
"""
Do all drawing for self for one frame.
@note; it is not usually sensible for this method on a container
to call the same method on contained objects.
For that, see self.draw().
"""
self.draw()
self._draw_drawingsets()
return
def draw(self): # review: rename? this name is
"""
Run whatever immediate-mode OpenGL code is required,
and maintain the global or env-supplied list of DrawingSets
and their CSDL membership, in anticipation of their being drawn
in the usual way (by _draw_drawingsets, on self or some container self is in)
later in the drawing of this frame.
"""
# note: this name 'draw' is for maximum old-code compatibility.
# it may be clear when seen from the point of view of graphics leaf nodes
# rather than for rendering loop test cases as this class API is meant for.
return
def _draw_drawingsets(self):
"""
subclass API method, for a complete test container
(not for individual objects inside it)
"""
assert 0, "implement in subclass"
return
pass
# end
|
