home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3dm / video / vlcreatepath.z / vlcreatepath
Encoding:
Text File  |  1998-10-20  |  4.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. VVVVLLLLCCCCRRRREEEEAAAATTTTEEEEPPPPAAAATTTTHHHH((((3333ddddmmmm))))                                            VVVVLLLLCCCCRRRREEEEAAAATTTTEEEEPPPPAAAATTTTHHHH((((3333ddddmmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      vlCreatePath, vlDestroyPath - manage VL paths
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddmmmmeeeeddddiiiiaaaa////vvvvllll....hhhh>>>>
  13.  
  14.      VVVVLLLLPPPPaaaatttthhhh vvvvllllCCCCrrrreeeeaaaatttteeeePPPPaaaatttthhhh((((VVVVLLLLSSSSeeeerrrrvvvveeeerrrr ssssvvvvrrrr,,,, VVVVLLLLDDDDeeeevvvv ddddeeeevvvv,,,, VVVVLLLLNNNNooooddddeeee ssssoooouuuurrrrcccceeee,,,, VVVVLLLLNNNNooooddddeeee ddddrrrraaaaiiiinnnn))));;;;
  15.      iiiinnnntttt vvvvllllDDDDeeeessssttttrrrrooooyyyyPPPPaaaatttthhhh((((VVVVLLLLSSSSeeeerrrrvvvveeeerrrr ssssvvvvrrrr,,,, VVVVLLLLPPPPaaaatttthhhh ppppaaaatttthhhh))));;;;
  16.  
  17. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  18.      _s_v_r        Specifies the server handle.
  19.  
  20.      _v_l_D_e_v      Specifies the device handle.
  21.  
  22.      _p_a_t_h       Specifies the path handle.
  23.  
  24.      _s_o_u_r_c_e     Specifies the source node.
  25.  
  26.      _d_r_a_i_n      Specifies the drain node.
  27.  
  28. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  29.      vvvvllllCCCCrrrreeeeaaaatttteeeePPPPaaaatttthhhh creates a path for data transfer, or using controls. The
  30.      path will be created on the specified device. If the device is specified
  31.      as _V_L__A_N_Y, a device which supports the specified source and drain will be
  32.      used, in the case where the two nodes are _V_L__A_N_Y, it will choose a device
  33.      in a deterministic manner.  vvvvllllGGGGeeeettttDDDDeeeevvvviiiicccceeee(3dm) can be used to determine the
  34.      device selected. If the source and drain are specified as _V_L__A_N_Y, the
  35.      path returned will not contain any nodes. Nodes can be added or removed
  36.      later using vvvvllllAAAAddddddddNNNNooooddddeeee(3dm), and vvvvllllRRRReeeemmmmoooovvvveeeeNNNNooooddddeeee(3dm).
  37.  
  38.      Once a node is added to a path (via vvvvllllCCCCrrrreeeeaaaatttteeeePPPPaaaatttthhhh,,,, or vvvvllllAAAAddddddddNNNNooooddddeeee(3dm), that
  39.      node is on the device that the path is on. It cannot later be used on a
  40.      path on a different device.
  41.  
  42.      Using multiple sources and/or multiple drains implies data interaction
  43.      along the path.  For example, a blender in the path might require two
  44.      sources and one drain.
  45.  
  46.      The path handle returned is unique only to this server, and not to all
  47.      servers.
  48.  
  49.      vvvvllllDDDDeeeessssttttrrrrooooyyyyPPPPaaaatttthhhh destroys the specified path, freeing the resources used by
  50.      the path.
  51.  
  52. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  53.      If successful, vvvvllllCCCCrrrreeeeaaaatttteeeePPPPaaaatttthhhh returns a path handle.  vvvvllllDDDDeeeessssttttrrrrooooyyyyPPPPaaaatttthhhh returns
  54.      0 on success. Otherwise, both routines return a value of -1 on error and
  55.      vvvvllllGGGGeeeettttEEEErrrrrrrrnnnnoooo((((3333ddddmmmm)))) can be called to retrieve the error.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. VVVVLLLLCCCCRRRREEEEAAAATTTTEEEEPPPPAAAATTTTHHHH((((3333ddddmmmm))))                                            VVVVLLLLCCCCRRRREEEEAAAATTTTEEEEPPPPAAAATTTTHHHH((((3333ddddmmmm))))
  71.  
  72.  
  73.  
  74. SEE ALSO
  75.      vlSetupPaths(3dm), vlAddNode(3dm), vlRemoveNode(3dm), vlGetErrno(3dm),
  76.      vlGetDevice(3dm)
  77.  
  78.  
  79.  
  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.