| | '''OpenGL extension ARB.fragment_program |
| | |
| | This module customises the behaviour of the |
| | OpenGL.raw.GL.ARB.fragment_program to provide a more |
| | Python-friendly API |
| | |
| | Overview (from the spec) |
| | |
| | Unextended OpenGL mandates a certain set of configurable per- |
| | fragment computations defining texture application, texture |
| | environment, color sum, and fog operations. Several extensions have |
| | added further per-fragment computations to OpenGL. For example, |
| | extensions have defined new texture environment capabilities |
| | (ARB_texture_env_add, ARB_texture_env_combine, ARB_texture_env_dot3, |
| | ARB_texture_env_crossbar), per-fragment depth comparisons |
| | (ARB_depth_texture, ARB_shadow, ARB_shadow_ambient, |
| | EXT_shadow_funcs), per-fragment lighting (EXT_fragment_lighting, |
| | EXT_light_texture), and environment mapped bump mapping |
| | (ATI_envmap_bumpmap). |
| | |
| | Each such extension adds a small set of relatively inflexible per- |
| | fragment computations. |
| | |
| | This inflexibility is in contrast to the typical flexibility |
| | provided by the underlying programmable floating point engines |
| | (whether micro-coded fragment engines, DSPs, or CPUs) that are |
| | traditionally used to implement OpenGL's texturing computations. |
| | The purpose of this extension is to expose to the OpenGL application |
| | writer a significant degree of per-fragment programmability for |
| | computing fragment parameters. |
| | |
| | For the purposes of discussing this extension, a fragment program is |
| | a sequence of floating-point 4-component vector operations that |
| | determines how a set of program parameters (not specific to an |
| | individual fragment) and an input set of per-fragment parameters are |
| | transformed to a set of per-fragment result parameters. |
| | |
| | The per-fragment computations for standard OpenGL given a particular |
| | set of texture and fog application modes (along with any state for |
| | extensions defining per-fragment computations) is, in essence, a |
| | fragment program. However, the sequence of operations is defined |
| | implicitly by the current OpenGL state settings rather than defined |
| | explicitly as a sequence of instructions. |
| | |
| | This extension provides an explicit mechanism for defining fragment |
| | program instruction sequences for application-defined fragment |
| | programs. In order to define such fragment programs, this extension |
| | defines a fragment programming model including a floating-point |
| | 4-component vector instruction set and a relatively large set of |
| | floating-point 4-component registers. |
| | |
| | The extension's fragment programming model is designed for efficient |
| | hardware implementation and to support a wide variety of fragment |
| | programs. By design, the entire set of existing fragment programs |
| | defined by existing OpenGL per-fragment computation extensions can |
| | be implemented using the extension's fragment programming model. |
| | |
| | The official definition of this extension is available here: |
| | http://www.opengl.org/registry/specs/ARB/fragment_program.txt |
| | ''' |
| | from OpenGL import platform, constant, arrays |
| | from OpenGL import extensions, wrapper |
| | import ctypes |
| | from OpenGL.raw.GL import _types, _glgets |
| | from OpenGL.raw.GL.ARB.fragment_program import * |
| | from OpenGL.raw.GL.ARB.fragment_program import _EXTENSION_NAME |
| |
|
| | def glInitFragmentProgramARB(): |
| | '''Return boolean indicating whether this extension is available''' |
| | from OpenGL import extensions |
| | return extensions.hasGLExtension( _EXTENSION_NAME ) |
| |
|
| | |
| | glProgramStringARB=wrapper.wrapper(glProgramStringARB).setInputArraySize( |
| | 'string', None |
| | ) |
| | |
| | glDeleteProgramsARB=wrapper.wrapper(glDeleteProgramsARB).setInputArraySize( |
| | 'programs', None |
| | ) |
| | glGenProgramsARB=wrapper.wrapper(glGenProgramsARB).setOutput( |
| | 'programs',size=lambda x:(x,),pnameArg='n',orPassIn=True |
| | ) |
| | glProgramEnvParameter4dvARB=wrapper.wrapper(glProgramEnvParameter4dvARB).setInputArraySize( |
| | 'params', 4 |
| | ) |
| | glProgramEnvParameter4fvARB=wrapper.wrapper(glProgramEnvParameter4fvARB).setInputArraySize( |
| | 'params', 4 |
| | ) |
| | glProgramLocalParameter4dvARB=wrapper.wrapper(glProgramLocalParameter4dvARB).setInputArraySize( |
| | 'params', 4 |
| | ) |
| | glProgramLocalParameter4fvARB=wrapper.wrapper(glProgramLocalParameter4fvARB).setInputArraySize( |
| | 'params', 4 |
| | ) |
| | glGetProgramEnvParameterdvARB=wrapper.wrapper(glGetProgramEnvParameterdvARB).setOutput( |
| | 'params',size=(4,),orPassIn=True |
| | ) |
| | glGetProgramEnvParameterfvARB=wrapper.wrapper(glGetProgramEnvParameterfvARB).setOutput( |
| | 'params',size=(4,),orPassIn=True |
| | ) |
| | glGetProgramLocalParameterdvARB=wrapper.wrapper(glGetProgramLocalParameterdvARB).setOutput( |
| | 'params',size=(4,),orPassIn=True |
| | ) |
| | glGetProgramLocalParameterfvARB=wrapper.wrapper(glGetProgramLocalParameterfvARB).setOutput( |
| | 'params',size=(4,),orPassIn=True |
| | ) |
| | glGetProgramivARB=wrapper.wrapper(glGetProgramivARB).setOutput( |
| | 'params',size=(1,),orPassIn=True |
| | ) |
| | |
| | |
| |
|
