home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / OpenGL / glxcopycontext.z / glxcopycontext
Encoding:
Text File  |  2001-04-17  |  7.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))          OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX          ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt - copy state from one rendering context to another
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt( Display *_d_p_y,
  14.                           GLXContext _s_r_c,
  15.                           GLXContext _d_s_t,
  16.                           unsigned long _m_a_s_k )
  17.  
  18.  
  19. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  20.      _d_p_y   Specifies the connection to the X server.
  21.  
  22.      _s_r_c   Specifies the source context.
  23.  
  24.      _d_s_t   Specifies the destination context.
  25.  
  26.      _m_a_s_k  Specifies which portions of _s_r_c state are to be copied to _d_s_t.
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt copies selected groups of state variables from _s_r_c to _d_s_t.
  30.      _m_a_s_k indicates which groups of state variables are to be copied.  _m_a_s_k
  31.      contains the bitwise OR of the same symbolic names that are passed to the
  32.      GL command ggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb.  The single symbolic constant GGGGLLLL____AAAALLLLLLLL____AAAATTTTTTTTRRRRIIIIBBBB____BBBBIIIITTTTSSSS
  33.      can be used to copy the maximum possible portion of rendering state.
  34.  
  35.      The copy can be done only if the renderers named by _s_r_c and _d_s_t share an
  36.      address space.  Two rendering contexts share an address space if both are
  37.      nondirect using the same server, or if both are direct and owned by a
  38.      single process.  Note that in the nondirect case it is not necessary for
  39.      the calling threads to share an address space, only for their related
  40.      rendering contexts to share an address space.
  41.  
  42.      Not all values for GL state can be copied.  For example, pixel pack and
  43.      unpack state, render mode state, and select and feedback state are not
  44.      copied.  The state that can be copied is exactly the state that is
  45.      manipulated by the GL command ggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb.
  46.  
  47.      An implicit ggggllllXXXXFFFFlllluuuusssshhhh is done by ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt if _s_r_c is the current
  48.      context for the calling thread.
  49.  
  50. NNNNOOOOTTTTEEEESSSS
  51.      Two rendering contexts share an address space if both are nondirect using
  52.      the same server, or if both are direct and owned by a single process.
  53.  
  54.      A _p_r_o_c_e_s_s is a single execution environment, implemented in a single
  55.      address space, consisting of one or more threads.
  56.  
  57.      A _t_h_r_e_a_d is one of a set of subprocesses that share a single address
  58.      space, but maintain separate program counters, stack spaces, and other
  59.      related global data.  A _t_h_r_e_a_d that is the only member of its subprocess
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))          OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee ---- GGGGLLLLXXXX          ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      group is equivalent to a _p_r_o_c_e_s_s.
  75.  
  76. EEEERRRRRRRROOOORRRRSSSS
  77.      BBBBaaaaddddMMMMaaaattttcccchhhh is generated if rendering contexts _s_r_c and _d_s_t do not share an
  78.      address space or were not created with respect to the same screen.
  79.  
  80.      BBBBaaaaddddAAAAcccccccceeeessssssss is generated if _d_s_t is current to any thread (including the
  81.      calling thread) at the time ggggllllXXXXCCCCooooppppyyyyCCCCoooonnnntttteeeexxxxtttt is called.
  82.  
  83.      GGGGLLLLXXXXBBBBaaaaddddCCCCuuuurrrrrrrreeeennnnttttWWWWiiiinnnnddddoooowwww is generated if _s_r_c is the current context and the
  84.      current drawable is a window that is no longer valid.
  85.  
  86.      GGGGLLLLXXXXBBBBaaaaddddCCCCoooonnnntttteeeexxxxtttt is generated if either _s_r_c or _d_s_t is not a valid GLX
  87.      context.
  88.  
  89.      BBBBaaaaddddVVVVaaaalllluuuueeee is generated if undefined _m_a_s_k bits are specified.
  90.  
  91.  
  92.  
  93. MMMMAAAACCCCHHHHIIIINNNNEEEE DDDDEEEEPPPPEEEENNNNDDDDEEEENNNNCCCCIIIIEEEESSSS
  94.      On all SGI systems, _s_r_c must be the current context and, except in the
  95.      case of direct rendering contexts on IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee,
  96.      RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX systems, _d_s_t must have been made current to some
  97.      thread prior to the copy.
  98.  
  99.      On RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee, RRRReeeeaaaalllliiiittttyyyyEEEEnnnnggggiiiinnnneeee2222, and VVVVTTTTXXXX, on IIIInnnnffffiiiinnnniiiitttteeeeRRRReeeeaaaalllliiiittttyyyy, on HHHHiiiigggghhhh
  100.      IIIImmmmppppaaaacccctttt and MMMMaaaaxxxxiiiimmmmuuuummmm IIIImmmmppppaaaacccctttt, on SSSSoooolllliiiidddd IIIImmmmppppaaaacccctttt systems, on OOOO2222 systems, and on
  101.      OOOOccccttttaaaannnneeee2222 VVVVPPPPrrrroooo systems, it is not possible to use a context for rendering
  102.      to both windows and pixmaps.
  103.  
  104.  
  105. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  106.      ggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb, ggggllllXXXXCCCCrrrreeeeaaaatttteeeeCCCCoooonnnntttteeeexxxxtttt, ggggllllXXXXIIIIssssDDDDiiiirrrreeeecccctttt
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.