-
Notifications
You must be signed in to change notification settings - Fork 3
/
listing4.html
executable file
·338 lines (286 loc) · 14.6 KB
/
listing4.html
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
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
<html>
<head>
<!-- BEGIN META TAG INFO -->
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<link rel="home" href="http://developer.apple.com/">
<link rel="find" href="http://developer.apple.com/search/">
<link rel="stylesheet" type="text/css" href="../../documentation/css/adcstyle.css" title="fonts">
<script language="JavaScript" src="../../documentation/js/adc.js" type="text/javascript"></script>
<!-- END META TAG INFO -->
<!-- BEGIN TITLE -->
<title>OpenGL Image - /OpenGL_Image.h</title>
<!-- END TITLE -->
<script language="JavaScript">
function JumpToNewPage() {
window.location=document.scpopupmenu.gotop.value;
return true;
}
</script>
</head>
<!-- BEGIN BODY OPEN -->
<body>
<!--END BODY OPEN -->
<!-- START CENTER OPEN -->
<center>
<!-- END CENTER OPEN -->
<!-- BEGIN LOGO AND SEARCH -->
<!--#include virtual="/includes/adcnavbar"-->
<!-- END LOGO AND SEARCH -->
<!-- START BREADCRUMB -->
<div id="breadcrumb">
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td scope="row"><img width="340" height="10" src="images/1dot.gif" alt=""></td>
<td><img width="340" height="10" src="images/1dot.gif" alt=""></td>
</tr>
<tr valign="middle">
<td align="left" colspan="2">
<a href="http://developer.apple.com/">ADC Home</a> > <a href="../../referencelibrary/index.html">Reference Library</a> > <a href="../../samplecode/index.html">Sample Code</a> > <a href="../../samplecode/LegacyTechnologies/index.html">Legacy Documents</a> > <a href="../../samplecode/LegacyTechnologies/idxGraphicsImaging-date.html">Graphics & Imaging</a> > <A HREF="javascript:location.replace('index.html');">OpenGL Image</A> >
</td>
</tr>
<tr>
<td colspan="2" scope="row"><img width="680" height="35" src="images/1dot.gif" alt=""></td>
</tr>
</table>
</div>
<!-- END BREADCRUMB -->
<div style="width:100%; position:fixed;"><div align="center" id="watermark" style="position: relative; margin-left:auto; margin-right:auto; z-index:20; width:500px;"><div class="legacybox"><h1>Legacy Document<span class=closebutton><a href="javascript:closeWatermark()"><img src="../../images/closebutton.png" width="14" height="14" border="0" alt="close button"></a></span></h1>
<p><strong>Important: </strong>This document is part of the Legacy section of the ADC Reference Library. This information should not be used for new development.</p>
<div class="reflibtopic">
<p>Current information on this Reference Library topic can be found here:</p>
<ul>
<li><a href="http://developer.apple.com/referencelibrary/GraphicsImaging/idxOpenGL-date.html" target="_blank">Graphics & Imaging > OpenGL</a></li>
</ul>
</div>
</div></div></div>
<!-- START MAIN CONTENT -->
<!-- START TITLE GRAPHIC AND INTRO-->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td><h1><div id="pagehead">OpenGL Image</div></h1></td>
</tr>
</table>
<!-- END TITLE GRAPHIC AND INTRO -->
<!-- START WIDE COLUMN -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr align="left" valign="top">
<td id="scdetails">
<h2>/OpenGL_Image.h</h2>
<form name="scpopupmenu" onSubmit="return false;" method=post>
<p><strong>View Source Code:</strong>
<select name="gotop" onChange="JumpToNewPage();" style="width:340px"><option selected value="ingnore">Select File</option>
<option value="listing1.html">/Carbon Include.h</option>
<option value="listing2.html">/Carbon.r</option>
<option value="listing3.html">/main.c</option>
<option value="listing4.html">/OpenGL_Image.h</option>
<option value="listing5.html">/OpenGL_Image_Loading.c</option>
<option value="listing6.html">/OpenGL_Image_Options-Dialog.c</option>
<option value="listing7.html">/OpenGL_Image_Utilities.c</option></select>
</p>
</form>
<p><strong><a href="OpenGL_Image.zip">Download Sample</a></strong> (“OpenGL_Image.zip”, 340.7K)<BR>
<strong><a href="OpenGL_Image.dmg">Download Sample</a></strong> (“OpenGL_Image.dmg”, 444.3K)</p>
<!--
<p><strong><a href="#">Download Sample</a></strong> (“filename.sit”, 500K)</p>
-->
</td>
</tr>
<tr>
<td scope="row"><img width="680" height="10" src="images/1dot.gif" alt=""><br>
<img height="1" width="680" src="images/1dot_919699.gif" alt=""><br>
<img width="680" height="20" src="images/1dot.gif" alt=""></td>
</tr>
<tr>
<td scope="row">
<!--googleon: index -->
<pre class="sourcecodebox">/*
* OpenGL_Image.h
* OpenGL Image
*
* Created by ggs on Fri May 11 2001.
Copyright: Copyright © 2001 Apple Computer, Inc., All Rights Reserved
Disclaimer: IMPORTANT: This Apple software is supplied to you by Apple Computer, Inc.
("Apple") in consideration of your agreement to the following terms, and your
use, installation, modification or redistribution of this Apple software
constitutes acceptance of these terms. If you do not agree with these terms,
please do not use, install, modify or redistribute this Apple software.
In consideration of your agreement to abide by the following terms, and subject
to these terms, Apple grants you a personal, non-exclusive license, under Apple's
copyrights in this original Apple software (the "Apple Software"), to use,
reproduce, modify and redistribute the Apple Software, with or without
modifications, in source and/or binary forms; provided that if you redistribute
the Apple Software in its entirety and without modifications, you must retain
this notice and the following text and disclaimers in all such redistributions of
the Apple Software. Neither the name, trademarks, service marks or logos of
Apple Computer, Inc. may be used to endorse or promote products derived from the
Apple Software without specific prior written permission from Apple. Except as
expressly stated in this notice, no other rights or licenses, express or implied,
are granted by Apple herein, including but not limited to any patent rights that
may be infringed by your derivative works or by other works in which the Apple
Software may be incorporated.
The Apple Software is provided by Apple on an "AS IS" basis. APPLE MAKES NO
WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED
WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND OPERATION ALONE OR IN
COMBINATION WITH YOUR PRODUCTS.
IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, MODIFICATION AND/OR DISTRIBUTION
OF THE APPLE SOFTWARE, HOWEVER CAUSED AND WHETHER UNDER THEORY OF CONTRACT, TORT
(INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*
*/
#ifndef _OpenGL_Image_h_
#define _OpenGL_Image_h_
#ifdef __APPLE_CC__ // project builder
#include <Carbon/Carbon.h>
#else
#endif
#include "Carbon_SetupGL.h" // setup API for gl context
// ==================================
enum // how to scale image to power of two on read if scaling
{
kNone = 1,
kNearest, // find nearest power of 2
kNearestLess, // nearest power of 2 which is less than or equal image dimension
KNearestGreater, // nearest power of 2 which is greater than or equal image dimension
k32, // use this size specifically
k64,
k128,
k256,
k512,
k1024,
k2048,
k4096,
k8192
};
enum
{
kDrag = 1, // dragging image
kRotation = 2, // roatating image
kZoom = 3 // zooming image
};
struct recGLCap // structure to store minimum OpenGL capabilites across all displays and GPUs
{
Boolean f_ext_texture_rectangle; // is texture rectangle extension supported
Boolean f_ext_client_storage; // is client storage extension supported
Boolean f_ext_packed_pixel; // is packed pixel extension supported
Boolean f_ext_texture_edge_clamp; // is SGI texture edge clamp extension supported
Boolean f_gl_texture_edge_clamp; // is OpenGL texture edge clamp support (1.2+)
unsigned long edgeClampParam; // the param that is passed to the texturing parmeteres
long maxTextureSize; // the minimum max texture size across all GPUs
long maxNOPTDTextureSize; // the minimum max texture size across all GPUs that support non-power of two texture dimensions
};
typedef struct recGLCap recGLCap;
typedef recGLCap * pRecGLCap;
struct recImage // OpenGL and image information associated with each window
{
// genric OpenGL stuff
structGLWindowInfo glInfo; // gl info used with SetupGL to build context
AGLContext aglContext; // the OpenGL context (read: state)
GLuint fontList; // the display list storing the bitmap font created for the context to display info
Boolean info; // show information layer?
Boolean lines; // show polygon edge layer?
Boolean grid; // show texel grid layer?
Boolean spinning; // spin image?
Boolean fAGPTexturing; // 10.1+ only: texture from AGP memory without loading to GPU
EventLoopTimerRef timer; // timer for spinning
// texture display stuff
Boolean fNPOTTextures; // are we using Non-Power Of Two (NPOT) textures?
Boolean fTileTextures; // are multiple tiled textures used to display image?
Boolean fOverlapTextures; // do tiled textures overlapped to create correct filtering between tiles? (only applies if using tiled textures)
Boolean fClientTextures; // 10.1+ only: texture from client memory
unsigned char * pImageBuffer; // image buffer that contains data for image (disposed after loading into texture if not using client textures)
long imageWidth; // height of orginal image
long imageHeight; // width of orginal image
float imageAspect; // width / height or aspect ratio of orginal image
long imageDepth; // depth of image (after loading into gworld, will be either 32 or 16 bits)
long textureX; // number of horizontal textures
long textureY; // number of vertical textures
long maxTextureSize; // max texture size for image
GLuint * pTextureName; // array for texture names (# = textureX * textureY)
long textureWidth; // total width of texels with cover image (including any border on image, but not internal texture overlaps)
long textureHeight; // total height of texels with cover image (including any border on image, but not internal texture overlaps)
float zoom; // zoom from on texel = one pixel is 1.0
float rotation; // image roatation from vert (clockwise positive)
float centerX; // image center in window (in window coordiantes)
float centerY;
float timerInterval;
// maintained by aglString frame counter
long frames; // frames drawn
AbsoluteTime time; // time
char cstrTime [256];
StrFileName name; // name of image file
};
typedef struct recImage recImage; // typedef for easy declaration
typedef recImage * pRecImage; // pointer type
// ==================================
// only used internally to handle image options dialog
void GetImageOptions (pRecGLCap pOpenGLCaps, Boolean *pfTileTextures, short * pTextureScale, Boolean * pfOverlapTextures,
short * pMaxTextureSize, Boolean * pfClientTextures, Boolean *pfAGPTextures, Boolean *pfNPOTTextures);
// opens image into GWorld created without padding (via QTNewGWorldFromPtr (...)) which can be used for packed pixel texturing
Boolean LoadImageForRecImage (pRecImage pWindowInfo);
// disposes OpenGL context, and associated texture list
OSStatus DisposeGLForWindow (WindowRef window);
// builds the GL context and associated state for the window
// loads image into a texture or textures
// disposes of GWorld and image buffer when finished loading textures
OSStatus BuildGLForWindow (WindowRef window);
// Handle updating context for window moves and resizing
OSStatus ResizeMoveGLWindow (WindowRef window);
// resets tracking of mouse drag when wmouse is released
void MouseUpGLWindow (void);
// starts tracking of mouse down for drag calculatons
// need to record drag window local position of the mouse and whether we are dragging or rotating
void MouseDownGLWindow (WindowRef window, Point mousePoint, UInt32 modifiers);
// main working functioning hamdling live drag and rotation
// moves center based on mouse delta from last check or rotates image based on nagular chnage of mouse (from image center)
void DragGLWindow (Point dragPoint);
// starts and stops rotation timer
void StartRotation (WindowRef window);
void StopRotation (WindowRef window);
// main GL drawing routine, should be valid window passed in (will setupGL if require). Draw image, then grid, then edges, then information
void DrawGL (WindowRef window);
extern short gTextureScale; // current global texture scaling value
extern short gMaxTextureSize; // current maximum texture sze to use when opening a new window
extern pRecGLCap gpOpenGLCaps;
#endif // _OpenGL_Image_Utilities_h_</pre>
<!--googleoff: index -->
</td>
</tr>
</table>
<!-- END WIDE COLUMN -->
<!-- END MAIN CONTENT -->
<table width="680" border="0" cellpadding="0" cellspacing="0">
<tr>
<td><div style="width: 100%; height: 1px; background-color: #919699; margin-top: 5px; margin-bottom: 15px"></div></td>
</tr>
<tr>
<td align="center"><br/>
<table border="0" cellpadding="0" cellspacing="0" class="graybox">
<tr>
<th>Did this document help you?</th>
</tr>
<tr>
<td>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=1&url=/samplecode/OpenGL_Image/listing4.html%3Fid%3DDTS10000538-1.0&media=dvd" target=_new>Yes</a>: Tell us what works for you.</div>
<div style="margin-bottom: 8px"><a href="http://developer.apple.com/feedback/?v=2&url=/samplecode/OpenGL_Image/listing4.html%3Fid%3DDTS10000538-1.0&media=dvd" target=_new>It’s good, but:</a> Report typos, inaccuracies, and so forth.</div>
<div><a href="http://developer.apple.com/feedback/?v=3&url=/samplecode/OpenGL_Image/listing4.html%3Fid%3DDTS10000538-1.0&media=dvd" target=_new>It wasn’t helpful</a>: Tell us what would have helped.</div>
</td>
</tr>
</table>
</td>
</tr>
</table>
<!-- START BOTTOM APPLE NAVIGATION -->
<!--#include virtual="/includes/footer"-->
<!-- END BOTTOM APPLE NAVIGATION -->
<!-- START CENTER CLOSE -->
</center>
<!-- END CENTER CLOSE -->
</body>
</html>