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
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
|
/*
* This is a modified version of the original header as provided by
* NVidia; original copyright appears below.
*
* Modified by Christopher Kline, May 2003: Stripped down and hacked to get
* around macro interpretation problems.
*/
/*
*
* Copyright (c) 2002, NVIDIA Corporation.
*
*
*
* NVIDIA Corporation("NVIDIA") supplies this software to you in consideration
* of your agreement to the following terms, and your use, installation,
* modification or redistribution of this NVIDIA software constitutes
* acceptance of these terms. If you do not agree with these terms, please do
* not use, install, modify or redistribute this NVIDIA software.
*
*
*
* In consideration of your agreement to abide by the following terms, and
* subject to these terms, NVIDIA grants you a personal, non-exclusive license,
* under NVIDIA�s copyrights in this original NVIDIA software (the "NVIDIA
* Software"), to use, reproduce, modify and redistribute the NVIDIA
* Software, with or without modifications, in source and/or binary forms;
* provided that if you redistribute the NVIDIA Software, you must retain the
* copyright notice of NVIDIA, this notice and the following text and
* disclaimers in all such redistributions of the NVIDIA Software. Neither the
* name, trademarks, service marks nor logos of NVIDIA Corporation may be used
* to endorse or promote products derived from the NVIDIA Software without
* specific prior written permission from NVIDIA. Except as expressly stated
* in this notice, no other rights or licenses express or implied, are granted
* by NVIDIA herein, including but not limited to any patent rights that may be
* infringed by your derivative works or by other works in which the NVIDIA
* Software may be incorporated. No hardware is licensed hereunder.
*
*
*
* THE NVIDIA SOFTWARE IS BEING PROVIDED ON AN "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING
* WITHOUT LIMITATION, WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT,
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR ITS USE AND OPERATION
* EITHER ALONE OR IN COMBINATION WITH OTHER PRODUCTS.
*
*
*
* IN NO EVENT SHALL NVIDIA BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL,
* EXEMPLARY, CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, LOST
* PROFITS; PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
* PROFITS; OR BUSINESS INTERRUPTION) OR ARISING IN ANY WAY OUT OF THE USE,
* REPRODUCTION, MODIFICATION AND/OR DISTRIBUTION OF THE NVIDIA SOFTWARE,
* HOWEVER CAUSED AND WHETHER UNDER THEORY OF CONTRACT, TORT (INCLUDING
* NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF NVIDIA HAS BEEN ADVISED
* OF THE POSSIBILITY OF SUCH DAMAGE.
*
*/
#ifndef _cg_h
#define _cg_h
#define CG_VERSION_1_2 1
#define CG_VERSION_NUM 1200
//
// This #define foreces the old API for now. This will be removed soon, but
// the user will still have the ability to enable it.
//
// #define CG_DEPRECATED_1_1_API 1
// Set up for either Win32 import/export/lib.
#ifndef CGDLL_API
#ifdef WIN32
#ifdef CGDLL_EXPORTS
#define CGDLL_API /*__declspec(dllexport) */
#elif defined (CG_LIB)
#define CGDLL_API
#else
#define CGDLL_API __declspec(dllimport)
#endif
#else
#define CGDLL_API
#endif
#endif
/*************************************************************************/
/*** CG Run-Time Library API ***/
/*************************************************************************/
/*************************************************************************/
/*** Data types and enumerants ***/
/*************************************************************************/
typedef int CGbool;
#define CG_FALSE ((CGbool)0)
#define CG_TRUE ((CGbool)1)
// typedef struct _CGcontext *CGcontext;
// typedef struct _CGprogram *CGprogram;
// typedef struct _CGparameter *CGparameter;
// hack: until typedef resolution is fixed, change the typedef from *CGContext
// to CGContext, and change all references to CGContext in functions to CGContext*
typedef struct _CGcontext CGcontext;
typedef struct _CGprogram CGprogram;
typedef struct _CGparameter CGparameter;
typedef enum
{
CG_UNKNOWN_TYPE,
CG_STRUCT,
CG_ARRAY,
CG_TYPE_START_ENUM = 1024,
//# define CG_DATATYPE_MACRO(name, compiler_name, enum_name, ncols, nrows) enum_name ,
#include <CG/cg_datatypes.h>
} CGtype;
typedef enum
{
//# define CG_BINDLOCATION_MACRO(name,enum_name,compiler_name,enum_int,addressable,param_type) enum_name = enum_int,
#include <CG/cg_bindlocations.h>
CG_UNDEFINED,
} CGresource;
typedef enum
{
CG_PROFILE_START = 6144,
CG_PROFILE_UNKNOWN,
//# define CG_PROFILE_MACRO(name, compiler_id, compiler_id_caps, compiler_opt,int_id,vertex_profile) CG_PROFILE_##compiler_id_caps = int_id,
#include <CG/cg_profiles.h>
CG_PROFILE_MAX,
} CGprofile;
typedef enum
{
//# define CG_ERROR_MACRO(code, enum_name, new_enum_name, message) new_enum_name = code,
# include <CG/cg_errors.h>
} CGerror;
typedef enum
{
//# define CG_ENUM_MACRO(enum_name, enum_val) enum_name = enum_val,
# include <Cg/cg_enums.h>
} CGenum;
#include <stdarg.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef void (*CGerrorCallbackFunc)(void);
/*************************************************************************/
/*** Functions ***/
/*************************************************************************/
#ifndef CG_EXPLICIT
/*** Context functions ***/
CGDLL_API /*CGcontext*/CGcontext* cgCreateContext(void);
CGDLL_API void cgDestroyContext(/*CGcontext*/CGcontext* ctx);
CGDLL_API CGbool cgIsContext(/*CGcontext*/CGcontext* ctx);
CGDLL_API const char *cgGetLastListing(/*CGcontext*/CGcontext* ctx);
CGDLL_API void cgSetAutoCompile(/*CGcontext*/CGcontext* ctx, CGenum flag);
/*** Program functions ***/
CGDLL_API /*CGprogram*/CGprogram* cgCreateProgram(/*CGcontext*/CGcontext* ctx,
CGenum program_type,
const char *program,
CGprofile profile,
const char *entry,
const char **args);
CGDLL_API /*CGprogram*/CGprogram* cgCreateProgramFromFile(/*CGcontext*/CGcontext* ctx,
CGenum program_type,
const char *program_file,
CGprofile profile,
const char *entry,
const char **args);
CGDLL_API /*CGprogram*/CGprogram* cgCopyProgram(/*CGprogram*/CGprogram* program);
CGDLL_API void cgDestroyProgram(/*CGprogram*/CGprogram* program);
CGDLL_API /*CGprogram*/CGprogram* cgGetFirstProgram(/*CGcontext*/CGcontext* ctx);
CGDLL_API /*CGprogram*/CGprogram* cgGetNextProgram(/*CGprogram*/CGprogram* current);
CGDLL_API /*CGcontext*/CGcontext* cgGetProgramContext(/*CGprogram*/CGprogram* prog);
CGDLL_API CGbool cgIsProgram(/*CGprogram*/CGprogram* program);
CGDLL_API void cgCompileProgram(/*CGprogram*/CGprogram* program);
CGDLL_API CGbool cgIsProgramCompiled(/*CGprogram*/CGprogram* program);
CGDLL_API const char *cgGetProgramString(/*CGprogram*/CGprogram* prog, CGenum pname);
CGDLL_API CGprofile cgGetProgramProfile(/*CGprogram*/CGprogram* prog);
/*** Parameter functions ***/
CGDLL_API /*CGparameter*/CGparameter* cgCreateParameter(/*CGcontext*/CGcontext* ctx, CGtype type);
CGDLL_API /*CGparameter*/CGparameter* cgCreateParameterArray(/*CGcontext*/CGcontext* ctx,
CGtype type,
int length);
CGDLL_API /*CGparameter*/CGparameter* cgCreateParameterMultiDimArray(/*CGcontext*/CGcontext* ctx,
CGtype type,
int dim,
const int *lengths);
CGDLL_API void cgDestroyParameter(/*CGparameter*/CGparameter* param);
CGDLL_API void cgConnectParameter(/*CGparameter*/CGparameter* from, /*CGparameter*/CGparameter* to);
CGDLL_API void cgDisconnectParameter(/*CGparameter*/CGparameter* param);
CGDLL_API /*CGparameter*/CGparameter* cgGetConnectedParameter(/*CGparameter*/CGparameter* param);
CGDLL_API int cgGetNumConnectedToParameters(/*CGparameter*/CGparameter* param);
CGDLL_API /*CGparameter*/CGparameter* cgGetConnectedToParameter(/*CGparameter*/CGparameter* param, int index);
CGDLL_API /*CGparameter*/CGparameter* cgGetNamedParameter(/*CGprogram*/CGprogram* prog, const char *name);
CGDLL_API /*CGparameter*/CGparameter* cgGetNamedProgramParameter(/*CGprogram*/CGprogram* prog,
CGenum name_space,
const char *name);
CGDLL_API /*CGparameter*/CGparameter* cgGetFirstParameter(/*CGprogram*/CGprogram* prog, CGenum name_space);
CGDLL_API /*CGparameter*/CGparameter* cgGetNextParameter(/*CGparameter*/CGparameter* current);
CGDLL_API /*CGparameter*/CGparameter* cgGetFirstLeafParameter(/*CGprogram*/CGprogram* prog, CGenum name_space);
CGDLL_API /*CGparameter*/CGparameter* cgGetNextLeafParameter(/*CGparameter*/CGparameter* current);
CGDLL_API /*CGparameter*/CGparameter* cgGetFirstStructParameter(/*CGparameter*/CGparameter* param);
CGDLL_API /*CGparameter*/CGparameter* cgGetNamedStructParameter(/*CGparameter*/CGparameter* param,
const char *name);
CGDLL_API /*CGparameter*/CGparameter* cgGetFirstDependentParameter(/*CGparameter*/CGparameter* param);
CGDLL_API /*CGparameter*/CGparameter* cgGetArrayParameter(/*CGparameter*/CGparameter* aparam, int index);
CGDLL_API int cgGetArrayDimension(/*CGparameter*/CGparameter* param);
CGDLL_API CGtype cgGetArrayType(/*CGparameter*/CGparameter* param);
CGDLL_API int cgGetArraySize(/*CGparameter*/CGparameter* param, int dimension);
CGDLL_API void cgSetArraySize(/*CGparameter*/CGparameter* param, int size);
CGDLL_API void cgSetMultiDimArraySize(/*CGparameter*/CGparameter* param, const int *sizes);
CGDLL_API /*CGprogram*/CGprogram* cgGetParameterProgram(/*CGparameter*/CGparameter* prog);
CGDLL_API /*CGcontext*/CGcontext* cgGetParameterContext(/*CGparameter*/CGparameter* param);
CGDLL_API CGbool cgIsParameter(/*CGparameter*/CGparameter* param);
CGDLL_API const char *cgGetParameterName(/*CGparameter*/CGparameter* param);
CGDLL_API CGtype cgGetParameterType(/*CGparameter*/CGparameter* param);
CGDLL_API CGtype cgGetParameterNamedType(/*CGparameter*/CGparameter* param);
CGDLL_API const char *cgGetParameterSemantic(/*CGparameter*/CGparameter* param);
CGDLL_API CGresource cgGetParameterResource(/*CGparameter*/CGparameter* param);
CGDLL_API CGresource cgGetParameterBaseResource(/*CGparameter*/CGparameter* param);
CGDLL_API unsigned long cgGetParameterResourceIndex(/*CGparameter*/CGparameter* param);
CGDLL_API CGenum cgGetParameterVariability(/*CGparameter*/CGparameter* param);
CGDLL_API CGenum cgGetParameterDirection(/*CGparameter*/CGparameter* param);
CGDLL_API CGbool cgIsParameterReferenced(/*CGparameter*/CGparameter* param);
CGDLL_API const double *cgGetParameterValues(/*CGparameter*/CGparameter* param,
CGenum value_type,
int *nvalues);
CGDLL_API int cgGetParameterOrdinalNumber(/*CGparameter*/CGparameter* param);
CGDLL_API CGbool cgIsParameterGlobal(/*CGparameter*/CGparameter* param);
CGDLL_API int cgGetParameterIndex(/*CGparameter*/CGparameter* param);
CGDLL_API void cgSetParameterVariability(/*CGparameter*/CGparameter* param, CGenum vary);
CGDLL_API void cgSetParameterSemantic(/*CGparameter*/CGparameter* param, const char *semantic);
CGDLL_API void cgSetParameter1f(/*CGparameter*/CGparameter* param, float x);
CGDLL_API void cgSetParameter2f(/*CGparameter*/CGparameter* param, float x, float y);
CGDLL_API void cgSetParameter3f(/*CGparameter*/CGparameter* param, float x, float y, float z);
CGDLL_API void cgSetParameter4f(/*CGparameter*/CGparameter* param,
float x,
float y,
float z,
float w);
CGDLL_API void cgSetParameter1d(/*CGparameter*/CGparameter* param, double x);
CGDLL_API void cgSetParameter2d(/*CGparameter*/CGparameter* param, double x, double y);
CGDLL_API void cgSetParameter3d(/*CGparameter*/CGparameter* param,
double x,
double y,
double z);
CGDLL_API void cgSetParameter4d(/*CGparameter*/CGparameter* param,
double x,
double y,
double z,
double w);
CGDLL_API void cgSetParameter1fv(/*CGparameter*/CGparameter* param, const float *v);
CGDLL_API void cgSetParameter2fv(/*CGparameter*/CGparameter* param, const float *v);
CGDLL_API void cgSetParameter3fv(/*CGparameter*/CGparameter* param, const float *v);
CGDLL_API void cgSetParameter4fv(/*CGparameter*/CGparameter* param, const float *v);
CGDLL_API void cgSetParameter1dv(/*CGparameter*/CGparameter* param, const double *v);
CGDLL_API void cgSetParameter2dv(/*CGparameter*/CGparameter* param, const double *v);
CGDLL_API void cgSetParameter3dv(/*CGparameter*/CGparameter* param, const double *v);
CGDLL_API void cgSetParameter4dv(/*CGparameter*/CGparameter* param, const double *v);
CGDLL_API void cgSetMatrixParameterdr(/*CGparameter*/CGparameter* param, const double *matrix);
CGDLL_API void cgSetMatrixParameterfr(/*CGparameter*/CGparameter* param, const float *matrix);
CGDLL_API void cgSetMatrixParameterdc(/*CGparameter*/CGparameter* param, const double *matrix);
CGDLL_API void cgSetMatrixParameterfc(/*CGparameter*/CGparameter* param, const float *matrix);
/*** Type Functions ***/
CGDLL_API const char *cgGetTypeString(CGtype type);
CGDLL_API CGtype cgGetType(const char *type_string);
CGDLL_API CGtype cgGetNamedUserType(/*CGprogram*/CGprogram* program, const char *name);
CGDLL_API int cgGetNumUserTypes(/*CGprogram*/CGprogram* program);
CGDLL_API CGtype cgGetUserType(/*CGprogram*/CGprogram* program, int index);
CGDLL_API int cgGetNumParentTypes(CGtype type);
CGDLL_API CGtype cgGetParentType(CGtype type, int index);
CGDLL_API CGbool cgIsParentType(CGtype parent, CGtype child);
CGDLL_API CGbool cgIsInterfaceType(CGtype type);
/*** Resource Functions ***/
CGDLL_API const char *cgGetResourceString(CGresource resource);
CGDLL_API CGresource cgGetResource(const char *resource_string);
/*** Enum Functions ***/
CGDLL_API const char *cgGetEnumString(CGenum en);
CGDLL_API CGenum cgGetEnum(const char *enum_string);
/*** Profile Functions ***/
CGDLL_API const char *cgGetProfileString(CGprofile profile);
CGDLL_API CGprofile cgGetProfile(const char *profile_string);
/*** Error Functions ***/
CGDLL_API CGerror cgGetError(void);
CGDLL_API const char *cgGetErrorString(CGerror error);
CGDLL_API const char *cgGetLastErrorString(CGerror *error);
CGDLL_API void cgSetErrorCallback(CGerrorCallbackFunc func);
CGDLL_API CGerrorCallbackFunc cgGetErrorCallback(void);
/*** Misc Functions ***/
CGDLL_API const char *cgGetString(CGenum sname);
/*** Support for deprecated Cg 1.1 API ***/
CGDLL_API /*CGparameter*/CGparameter* cgGetNextParameter_depr1_1(/*CGparameter*/CGparameter* current);
CGDLL_API /*CGparameter*/CGparameter* cgGetNextLeafParameter_depr1_1(/*CGparameter*/CGparameter* current);
#ifdef CG_DEPRECATED_1_1_API
#define cgGetNextParameter cgGetNextParameter_depr1_1
#define cgGetNextLeafParameter cgGetNextLeafParameter_depr1_1
#endif
#endif
#ifdef __cplusplus
}
#endif
#endif
|
