1XXX - Not complete yet!!! 2 3Name 4 5 SGIX_list_priority 6 7Name Strings 8 9 GL_SGIX_list_priority 10 11Version 12 13 $Date: 1996/05/30 08:00:32 $ $Revision: 1.3 $ 14 15Number 16 17 80 18 19Dependencies 20 21 None 22 23Overview 24 25 This extension provides a mechanism for specifying the relative 26 importance of display lists. This information can be used by 27 an OpenGL implementation to guide the placement of display 28 list data in a storage hierarchy. 29 30Issues 31 32 * Should we also add some hints to guide compilation strategies 33 For example a hint could give us the equivalent of the iris gl 34 compactify command. Generally hints could control compilation 35 speed versus memory consumption, degree of optimization, etc. 36 37 yes, in another spec 38 39 * Should we go ahead and add a ListParameter command rather than a 40 PrioritorizeList command just in case some other list attribute 41 needs to be added. Do we go ahead and finish the job with 42 f,i,iv functions? 43 44 yes 45 46 * Is 1.0 a reasonable default? 47 48 * Should it be an SGI rather than SGIX extension? 49 50New Procedures and Functions 51 52 ListParameterfSGIX(uint list, 53 enum pname, 54 float params; 55 56 ListParameterfvSGIX(uint list, 57 enum pname, 58 float *params); 59 60 ListParameteriSGIX(uint list, 61 enum pname, 62 int param); 63 64 ListParameterivSGIX(uint list, 65 enum pname, 66 int *params); 67 68 GetListParameterfvSGIX(uint list, 69 enum pname, 70 float *params); 71 72 GetListParameterivSGIX(uint list, 73 enum pname, 74 int *params); 75 76New Tokens 77 78 Accepted by the <pname> parameters of ListParameterfSGIX, 79 ListParameterfvSGIX, ListParameteriSGIX, ListParameterivSGIX, 80 GetListParameterfvSGIX, and GetListParameterivSGIX: 81 82 LIST_PRIORITY_SGIX 83 84Additions to Chapter 2 of the 1.0 Specification (OpenGL Operation) 85 86 None 87 88Additions to Chapter 3 of the 1.0 Specification (Rasterization) 89 90 None 91 92Additions to Chapter 4 of the 1.0 Specification (Per-Fragment Operations 93and the Frame Buffer) 94 95 None 96 97Additions to Chapter 5 of the 1.0 Specification (Special Functions) 98 99 Applications guide the OpenGL implementation in determining which 100 display lists should be favoured for fast execution by specifying 101 a priority for each display list. Calling ListParameterfSGIX, 102 ListParameterfvSGIX, ListParameteriSGIX, or ListParameterivSGIX 103 with <list> set to the display list, <pname> set to LIST_PRIORITY_SGIX, 104 sets the priority to the value in <params>. 105 The priority value is clamped to the range [0.0, 1.0] before it is 106 assigned. Zero indicates the lowest priority, and hence the least 107 likelihood of optimal execution. One indicates the highest priority, 108 and hence the greatest likelihood of optimal execution. 109 (Attempts attempts to prioritize nonlists are silently ignored. Attempts 110 to prioritize list 0 generates an INVALID_VALUE error.) 111 112 The priority of a list can be queried by calling GetListParameterfvSGIX or 113 GetListParameterivSGIX with <list> set to the list and <pname> set to 114 LIST_PRIORITY_SGIX. If <list> is not defined than the value returned 115 is undefined. 116 117 ListParameterfSGIX, ListParameterfvSGIX, ListParameteriSGIX, and 118 ListParameterivSGIX are not included in display lists. 119 120Additions to Chapter 6 of the 1.0 Specification (State and State Requests) 121 122 None 123 124Additions to the GLX Specification 125 126 TBD 127 128Errors 129 130 INVALID_VALUE is generated if ListParameterfSGIX, ListParameterfvSGIX, 131 ListParameteriSGIX, ListParameterivSGIX, GetListParameterfvSGIX, or 132 GetListParameterivSGIX parameter <list> is 0. 133 134 INVALID_ENUM is generated if ListParameterfSGIX, ListParameterfvSGIX, 135 ListParameteriSGIX, ListParameterivSGIX, GetListParameterfvSGIX, or 136 GetListParameterivSGIX parameter <pname> is not LIST_PRIORITY_SGIX. 137 138 INVALID_OPERATION is generated if ListParameterfSGIX, ListParameterfvSGIX, 139 ListParameteriSGIX, ListParameterivSGIX, GetListParameterfvSGIX, or 140 GetListParameterivSGIX is called between execution of Begin and the 141 corresponding execution of End. 142 143New State 144 145 Initial 146 Get Value Get Command Type Value Attrib 147 --------- ----------- ---- ------- ------ 148 LIST_PRIORITY_SGIX GetListParameterfvSGIX n x Z+ 1 - 149 150 151New Implementation Dependent State 152 153 None 154