home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL-ftn / fglbindtexture.z / fglbindtexture
Encoding:
Text File  |  2002-10-03  |  9.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee((((3333GGGG))))             OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee             ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee - bind a named texture to a texturing target
  10.  
  11.  
  12. FFFFOOOORRRRTTTTRRRRAAAANNNN SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      SUBROUTINE ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee( INTEGER*4 _t_a_r_g_e_t,
  14.                                 INTEGER*4 _t_e_x_t_u_r_e )
  15.  
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _t_a_r_g_e_t   Specifies the target to which the texture is bound.  Must be
  19.               either GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD, or GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD.
  20.  
  21.      _t_e_x_t_u_r_e  Specifies the name of a texture.
  22.  
  23. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.      ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee lets you create or use a named texture. Calling
  25.      ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee with _t_a_r_g_e_t set to GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD, GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD,
  26.      GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD and _t_e_x_t_u_r_e set to the name of the newtexture binds the
  27.      texture name to the target. When a texture is bound to a target, the
  28.      previous binding for that target is automatically broken.
  29.  
  30.      Texture names are unsigned integers. The value zero is reserved to
  31.      represent the default texture for each texture target.  Texture names and
  32.      the corresponding texture contents are local to the shared display-list
  33.      space (see ffffggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt) of the current GL rendering context; two
  34.      rendering contexts share texture names only if they also share display
  35.      lists.
  36.  
  37.      You may use ffffggggllllGGGGeeeennnnTTTTeeeexxxxttttuuuurrrreeeessss to generate a set of new texture names.
  38.  
  39.      When a texture is first bound, it assumes the dimensionality of its
  40.      target:  A texture first bound to GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD becomes one-dimensional,
  41.      and a texture first bound to GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____2222DDDD becomes two-dimensional, and a
  42.      texture first bound to GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____3333DDDD becomes a three-dimensional texture.
  43.      The state of a one-dimensional texture immediately after it is first
  44.      bound is equivalent to the state of the default GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____1111DDDD at GL
  45.      initialization, and similarly for two-, and three-dimensional textures.
  46.  
  47.      While a texture is bound, GL operations on the target to which it is
  48.      bound affect the bound texture, and queries of the target to which it is
  49.      bound return state from the bound texture. If texture mapping of the
  50.      dimensionality of the target to which a texture is bound is active, the
  51.      bound texture is used.  In effect, the texture targets become aliases for
  52.      the textures currently bound to them, and the texture name zero refers to
  53.      the default textures that were bound to them at initialization.
  54.  
  55.      A texture binding created with ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee remains active until a
  56.      different texture is bound to the same target, or until the bound texture
  57.      is deleted with ffffggggllllDDDDeeeelllleeeetttteeeeTTTTeeeexxxxttttuuuurrrreeeessss.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee((((3333GGGG))))             OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee             ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      Once created, a named texture may be re-bound to the target of the
  75.      matching dimensionality as often as needed.  It is usually much faster to
  76.      use ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee to bind an existing named texture to one of the
  77.      texture targets than it is to reload the texture image using
  78.      ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD, ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, or ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee3333DDDD.  For additional control
  79.      over performance, use ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss.
  80.  
  81.      ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee is included in display lists.
  82.  
  83. NNNNOOOOTTTTEEEESSSS
  84.      ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee is available only if the GL version is 1.1 or greater.
  85.  
  86. EEEERRRRRRRROOOORRRRSSSS
  87.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_a_r_g_e_t is not one of the allowable
  88.      values.
  89.  
  90.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if _t_e_x_t_u_r_e has a dimensionality that
  91.      doesn't match that of _t_a_r_g_e_t.
  92.  
  93.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN is generated if ffffggggllllBBBBiiiinnnnddddTTTTeeeexxxxttttuuuurrrreeee is executed between
  94.      the execution of ffffggggllllBBBBeeeeggggiiiinnnn and the corresponding execution of ffffggggllllEEEEnnnndddd.
  95.  
  96. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  97.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____BBBBIIIINNNNDDDDIIIINNNNGGGG____1111DDDD
  98.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____BBBBIIIINNNNDDDDIIIINNNNGGGG____2222DDDD
  99.      ffffggggllllGGGGeeeetttt with argument GGGGLLLL____TTTTEEEEXXXXTTTTUUUURRRREEEE____BBBBIIIINNNNDDDDIIIINNNNGGGG____3333DDDD
  100.  
  101.  
  102. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  103.      RealityEngine, RealityEngine2, and VTX systems do not support texture
  104.      name sharing.  Texture names are always local to the rendering context
  105.      which was active at the time the names were created.
  106.  
  107.      The implementation on O2 systems uses a minimum of 64K bytes for every
  108.      texture object defined.
  109.  
  110.  
  111. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  112.      ffffggggllllAAAArrrreeeeTTTTeeeexxxxttttuuuurrrreeeessssRRRReeeessssiiiiddddeeeennnntttt, ffffggggllllDDDDeeeelllleeeetttteeeeTTTTeeeexxxxttttuuuurrrreeeessss, ffffggggllllGGGGeeeennnnTTTTeeeexxxxttttuuuurrrreeeessss, ffffggggllllGGGGeeeetttt,
  113.      ffffggggllllGGGGeeeettttTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr, ffffggggllllIIIIssssTTTTeeeexxxxttttuuuurrrreeee, ffffggggllllPPPPrrrriiiioooorrrriiiittttiiiizzzzeeeeTTTTeeeexxxxttttuuuurrrreeeessss, ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee1111DDDD,
  114.      ffffggggllllTTTTeeeexxxxIIIImmmmaaaaggggeeee2222DDDD, ffffggggllllTTTTeeeexxxxPPPPaaaarrrraaaammmmeeeetttteeeerrrr
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.