GLGETPROGRAMIV(3gl)GLGETPROGRAMIV(3gl)NAMEglGetProgramivARB - Returns the program state values for a program
object.
C SPECIFICATION
void glGetProgramivARB( GLenum target,
GLenum pname,
Glint *params)
PARAMETERS
target Symbolic name which specifies the program type. Valid val‐
ues
are
GL_VER‐
TEX_PRO‐
GRAM_ARB
and
GL_FRAG‐
MENT_PRO‐
GRAM_ARB.
pname Specifies the symbolic name of the program attribute
to
be
queried.
Accepted
val‐
ues
are:
GL_PRO‐
GRAM_LENGTH_ARB,
GL_PRO‐
GRAM_FOR‐
MAT_ARB,
GL_PRO‐
GRAM_BIND‐
ING_ARB,
GL_MAX_PRO‐
GRAM_LOCAL_PARAM‐
E‐
TERS_ARB,
GL_MAX_PRO‐
GRAM_ENV_PARAM‐
E‐
TERS_ARB,
GL_MAX_PRO‐
GRAM_INSTRUC‐
TIONS_ARB,
GL_MAX_PRO‐
GRAM_TEM‐
PO‐
RARIES_ARB,
GL_MAX_PRO‐
GRAM_PARAM‐
E‐
TERS_ARB,
GL_MAX_PRO‐
GRAM_ATTRIBS_ARB,
GL_MAX_PRO‐
GRAM_ADDRESS_REG‐
IS‐
TERS_ARB,
GL_MAX_PRO‐
GRAM_NATIVE_INSTRUC‐
TIONS_ARB,
GL_MAX_PRO‐
GRAM_NATIVE_TEM‐
PO‐
RARIES_ARB,
GL_MAX_PRO‐
GRAM_NATIVE_PARAM‐
E‐
TERS_ARB,
GL_MAX_PRO‐
GRAM_NATIVE_ATTRIBS_ARB,
GL_MAX_PRO‐
GRAM_NATIVE_ADDRESS_REG‐
IS‐
TERS_ARB,
GL_PRO‐
GRAM_INSTRUC‐
TIONS_ARB,
GL_PRO‐
GRAM_TEM‐
PO‐
RARIES_ARB,
GL_PRO‐
GRAM_PARAM‐
E‐
TERS_ARB,
GL_PRO‐
GRAM_NATIVE_ATTRIBS_ARB,
GL_PRO‐
GRAM_ALU_INSTRUC‐
TIONS_ARB,
GL_PRO‐
GRAM_TEX_INSTRUC‐
TIONS_ARB,
GL_PRO‐
GRAM_TEX_INDI‐
REC‐
TIONS_ARB,
GL_PRO‐
GRAM_NATIVE_ALU_INSTRUC‐
TIONS_ARB,
GL_PRO‐
GRAM_NATIVE_TEX_INSTRUC‐
TIONS_ARB,
GL_PRO‐
GRAM_NATIVE_TEX_INDI‐
REC‐
TIONS_ARB,
GL_MAX_PRO‐
GRAM_ALU_INSTRUC‐
TIONS_ARB,
GL_MAX_PRO‐
GRAM_TEX_INSTRUC‐
TIONS_ARB,
GL_MAX_PRO‐
GRAM_TEX_INDI‐
REC‐
TIONS_ARB,
GL_MAX_PRO‐
GRAM_NATIVE_ALU_INSTRUC‐
TIONS_ARB,
GL_MAX_PRO‐
GRAM_NATIVE_TEX_INSTRUC‐
TIONS_ARB,
GL_MAX_PRO‐
GRAM_NATIVE_TEX_INDI‐
REC‐
TIONS_ARB,
GL_PRO‐
GRAM_ATTRIBS_ARB,
GL_PRO‐
GRAM_ADDRESS_REG‐
IS‐
TERS_ARB,
GL_PRO‐
GRAM_UNDER_NATIVE_LIM‐
ITS_ARB.
params Pointer to array containing the returned values.
DESCRIPTIONglGetProgramivARB obtains program state for the program target target,
writing the state into the array given by params. GetProgramivARB can
be used to determine the properties of the currently bound program
object or implementation limits for target. The accepted parameter
names are as follows:
GL_PROGRAM_LENGTH_ARB Returns the length in bytes of the
current program string.
GL_PROGRAM_FORMAT_ARB Returns the format of the current
program string.
GL_PROGRAM_BINDING_ARB Returns the name of the program cur‐
rently bound to target.
GL_MAX_PROGRAM_LOCAL_PARAMETERS_ARB
Returns maximum number of program
local parameters supported for cur‐
rently bound target.
GL_MAX_PROGRAM_ENV_PARAMETERS_ARB Returns maximum number of program
environment parameters supported for
currently bound target.
GL_MAX_PROGRAM_INSTRUCTIONS_ARB Returns maximum number of program
instructions which can be used by a
program bound to target.
GL_MAX_PROGRAM_TEMPORARIES_ARB Returns maximum number of program
temporaries which can be used by a
program bound to target.
GL_MAX_PROGRAM_PARAMETERS_ARB Returns maximum number of program
parameters which can be used by a
program bound to target.
GL_MAX_PROGRAM_ATTRIBS_ARB Returns maximum number of program
attributes which can be used by a
program bound to target.
GL_MAX_PROGRAM_ADDRESS_REGISTERS_ARB
Returns maximum number of program
address registers which can be used
by a program bound to target.
GL_MAX_PROGRAM_NATIVE_INSTRUCTIONS_ARB
Returns maximum number of native
instructions available to a program
bound to target.
GL_MAX_PROGRAM_NATIVE_TEMPORARIES_ARB
Returns maximum number of native
temporaries available to a program
bound to target.
GL_MAX_PROGRAM_NATIVE_PARAMETERS_ARB
Returns maximum number of native
parameters available to a program
bound to target.
GL_MAX_PROGRAM_NATIVE_ATTRIBS_ARB Returns maximum number of native
attributes available to a program
bound to target.
GL_MAX_PROGRAM_NATIVE_ADDRESS_REGISTERS_ARB
Returns maximum number of native
address registers available to a
program bound to target.
GL_PROGRAM_INSTRUCTIONS_ARB Returns number of instructions used
by current program for target.
GL_PROGRAM_TEMPORARIES_ARB Returns number of program tempo‐
raries used by current program for
target.
GL_PROGRAM_PARAMETERS_ARB Returns number of program parameters
used by current program for target.
GL_PROGRAM_ATTRIBS_ARB Returns number of program attributes
used by current program for target.
GL_PROGRAM_ADDRESS_REGISTERS_ARB Returns number of program address
registers used by current program
for target.
GL_PROGRAM_UNDER_NATIVE_LIMITS_ARB Returns 0 if the native resource
consumption of the program currently
bound to target exceeds the number
of available resources for any
resource type, and 1 otherwise.
GL_PROGRAM_NATIVE_ATTRIBS_ARB, Returns number of native program
attributes used by current program
for target.
GL_PROGRAM_ALU_INSTRUCTIONS_ARB, Returns number of program ALU
instructions used by current program
for target.
GL_PROGRAM_TEX_INSTRUCTIONS_ARB, Returns number of program texture
instructions used by current program
for target.
GL_PROGRAM_TEX_INDIRECTIONS_ARB, Returns number of program texture
indirections used by current program
for target.
GL_PROGRAM_NATIVE_ALU_INSTRUCTIONS_ARB,
Returns number of native program ALU
instructions used by current program
for target.
GL_PROGRAM_NATIVE_TEX_INSTRUCTIONS_ARB,
Returns number of native program
texture instructions used by current
program for target.
GL_PROGRAM_NATIVE_TEX_INDIRECTIONS_ARB,
Returns number of native program
texture indirections used by current
program for target.
GL_MAX_PROGRAM_ALU_INSTRUCTIONS_ARB,
Returns maximum number of native ALU
instructions available to a program
bound to target.
GL_MAX_PROGRAM_TEX_INSTRUCTIONS_ARB,
Returns maximum number of native
texture instructions available to a
program bound to target.
GL_MAX_PROGRAM_TEX_INDIRECTIONS_ARB,
Returns maximum number of native
texture indirections available to a
program bound to target.
GL_MAX_PROGRAM_NATIVE_ALU_INSTRUCTIONS_ARB,
Returns maximum number of native ALU
instructions available to a program
bound to target.
GL_MAX_PROGRAM_NATIVE_TEX_INSTRUCTIONS_ARB,
Returns maximum number of native
texture instructions available to a
program bound to target.
GL_MAX_PROGRAM_NATIVE_TEX_INDIRECTIONS_ARB,
Returns maximum number of native
texture indirections available to a
program bound to target.
ERRORS
GL_INVALID_ENUM is generated if target or pname is not one of the
accepted values.
GL_INVALID_OPERATION is generated glGetProgramivARB is executed between
the execution of glBegin and the corresponding execution of glEnd.
SEE ALSO
glProgramStringARB, glBindProgramARB
12 Mar 04 GLGETPROGRAMIV(3gl)