home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3dm / fx / dmFXUpdateImageBuffer.z / dmFXUpdateImageBuffer
Encoding:
Text File  |  2002-10-03  |  6.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrr((((3333ddddmmmm))))                          ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrr((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrr, ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrrssss, ddddmmmmFFFFXXXXGGGGeeeettttBBBBuuuuffffffffeeeerrrrFFFFoooorrrrmmmmaaaatttt -
  10.      change the active size of a special effects buffer
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////ffffxxxx____bbbbuuuuffffffffeeeerrrr....hhhh>>>>
  14.  
  15.      DDDDMMMMssssttttaaaattttuuuussss ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrr
  16.          (((( ccccoooonnnnsssstttt DDDDMMMMppppaaaarrrraaaammmmssss**** iiiimmmmaaaaggggeeeeFFFFoooorrrrmmmmaaaatttt,,,,
  17.            DDDDMMMMffffxxxxbbbbuuuuffffffffeeeerrrr****     bbbbuuuuffffffffeeeerrrr ))));;;;
  18.  
  19.      DDDDMMMMssssttttaaaattttuuuussss ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrrssss
  20.          (((( ccccoooonnnnsssstttt DDDDMMMMppppaaaarrrraaaammmmssss**** iiiimmmmaaaaggggeeeeFFFFoooorrrrmmmmaaaatttt,,,,
  21.            iiiinnnntttt             nnnnuuuummmmbbbbeeeerrrrOOOOffffBBBBuuuuffffffffeeeerrrrssss,,,,
  22.            DDDDMMMMffffxxxxbbbbuuuuffffffffeeeerrrr****     bbbbuuuuffffffffeeeerrrrssss[[[[]]]] ))));;;;
  23.  
  24.      DDDDMMMMppppaaaarrrraaaammmmssss**** ddddmmmmFFFFXXXXGGGGeeeettttBBBBuuuuffffffffeeeerrrrFFFFoooorrrrmmmmaaaatttt
  25.          (((( DDDDMMMMffffxxxxbbbbuuuuffffffffeeeerrrr bbbbuuuuffffffffeeeerrrr ))));;;;
  26.  
  27.  
  28. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  29.      _i_m_a_g_e_F_o_r_m_a_t       A parameter list that describes the new image size to
  30.                        be stored in the buffer.
  31.  
  32.      _b_u_f_f_e_r            An image buffer.
  33.  
  34.      _n_u_m_b_e_r_O_f_B_u_f_f_e_r_s   The number of elements in the array _b_u_f_f_e_r_s.
  35.  
  36.      _b_u_f_f_e_r_s           An array of image buffers.
  37.  
  38.  
  39. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.      A special-effects image buffer has a fixed size, which is the amount of
  41.      storage allocated to store an image.  By default, the buffers deals with
  42.      images of that size.  They can also be used to deal with images that are
  43.      smaller.  To do this, the "active size" of the buffer must be changed
  44.      with ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrr or ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrrssss.
  45.  
  46.      ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrr is used to update the size of a single buffer, and
  47.      ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrrssss is used to update the size of several buffers at
  48.      once.  The new size is taken from the DDDDMMMM____IIIIMMMMAAAAGGGGEEEE____WWWWIIIIDDDDTTTTHHHH and DDDDMMMM____IIIIMMMMAAAAGGGGEEEE____HHHHEEEEIIIIGGGGHHHHTTTT
  49.      parameters in _i_m_a_g_e_F_o_r_m_a_t.
  50.  
  51.      The current size of a buffer, as well as its other image format
  52.      parameters, can be obtained by calling ddddmmmmFFFFXXXXGGGGeeeettttBBBBuuuuffffffffeeeerrrrFFFFoooorrrrmmmmaaaatttt.
  53.  
  54.  
  55.  
  56. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  57.      ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrr and ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrrssss will return DDDDMMMM____SSSSUUUUCCCCCCCCEEEESSSSSSSS
  58.      if the size of all of the buffers was changed, or DDDDMMMM____FFFFAAAAIIIILLLLUUUURRRREEEE if not.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrr((((3333ddddmmmm))))                          ddddmmmmFFFFXXXXUUUUppppddddaaaatttteeeeIIIImmmmaaaaggggeeeeBBBBuuuuffffffffeeeerrrr((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74.      The parameter list returned by ddddmmmmFFFFXXXXGGGGeeeettttBBBBuuuuffffffffeeeerrrrFFFFoooorrrrmmmmaaaatttt is owned by the
  75.      buffer.  It may be queried, but should not be modified or freed.
  76.  
  77.  
  78. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  79.      dmFXAllocateImageBuffers(3dm)
  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.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.