home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 20 / AACD20.BIN / AACD / Programming / Pony3D / DOCS / Pony3DPL_020+.doc < prev    next >
Encoding:
Text File  |  2000-04-21  |  5.6 KB  |  242 lines
  1. TABLE OF CONTENTS
  2.  
  3. pony3d.library/p3dRotate
  4. pony3d.library/p3dMove
  5. pony3d.library/p3dPerspective
  6. pony3d.library/p3dPointRepresent
  7. pony3d.library/p3dRotate                                     pony3d.library/p3dRotate
  8.  
  9.    NAZWA
  10.     p3dRotate -- Obraca punkty o dany kât
  11.  
  12.    OPIS
  13.     p3dRotate( anglex, angley, anglez, cubestructpoints, rotatedpoints )
  14.            D4       D5       D6      A0             A1
  15.  
  16.     VOID p3dRotate(ULONG, ULONG, ULONG, struct cubestructpoints *, struct rotatedpoints *)
  17.  
  18.    FUNKCJA
  19.     Fukcja ta obraca wszystkie punkty w tablicy cubestructpoints
  20.     o podane kâty.
  21.  
  22.    WEJÔCIE
  23.     anglex - kât obrotu w osi OX
  24.     angley - kât obrotu w osi OY
  25.     anglez - kât obrotu w osi OZ
  26.     cubestructpoints - wskaúnik na strukturë cubestructpoints
  27.                w której znajdujâ sië wspóîrzëdne wierzchoîków.
  28.     rotatedpoints - wskaúnik na obszar pamiëci w którym zostanâ
  29.             zapisane wspóîrzëdne wynikowe punktów (rotatedpoints).
  30.  
  31.    UWAGI
  32.     Struktura cubestructpoints ma postaê nastëpujâcâ:
  33.  
  34.     CubeStructPoints:
  35.  
  36.         dc.l    n-1
  37.         dc.l    x,y,z        ;P1
  38.         dc.l    x,y,z        ;P2
  39.         dc.l    x,y,z        ;P3
  40.         ...
  41.         dc.l    x,y,z        ;Pn
  42.  
  43.     gdzie:
  44.     
  45.     n - iloôê wierzchoîków
  46.     x - wspóîrzëdna x
  47.     y - wspóîrzëdna y
  48.     z - wspóîrzëdna z
  49.  
  50.     Rozmiar obszaru pamiëci na strukturë rotatedpoints moûna
  51.     obliczyê ze wzoru: n*12+4, gdzie n to iloôê wierzchoîków.
  52.     Struktura ta ma postaê nastëpujâcâ:
  53.  
  54.     RotatedPoints:
  55.  
  56.         dc.l    n-1
  57.         dc.l    xr,yr,zr     ;P1
  58.         dc.l    xr,yr,zr     ;P2
  59.         dc.l    xr,yr,zr     ;P3
  60.         ...
  61.         dc.l    xr,yr,zr     ;Pn
  62.  
  63.     gdzie:
  64.     
  65.     n - iloôê wierzchoîków
  66.     xr - obrócona wspóîrzëdna x
  67.     yr - obrócona wspóîrzëdna y
  68.     zr - obrócona wspóîrzëdna z
  69.  
  70. pony3d.library/p3dMove                                     pony3d.library/p3dMove
  71.  
  72.    NAZWA
  73.     p3dMove -- Przesuwa obrócony punkt równolegle o wektor.
  74.  
  75.    OPIS
  76.     p3dMove( movex, movey, movez, rotatedpoints, movedpoints )
  77.          D0    D1     D2     A0         A1
  78.  
  79.     VOID p3dMove(ULONG, ULONG, ULONG, struct rotatedpoints *, struct movedpoints *)
  80.  
  81.    FUNKCJA
  82.     Funkcja ta przesywa wszystkie punkty w tablicy równlegle o
  83.     okreôlone wektory.Punkty powinny byê wczeôniej obrócone.
  84.  
  85.    WEJÔCIE
  86.     movex - przesuniëcie w osi OX
  87.     movey - przesuniëcie w osi OY
  88.     movez - przesuniëcie w osi OZ
  89.     rotatedpoints - wskaúnik na strukturë rotatedpoints (otrzymanâ w
  90.             wyniku p3dRotate) w której znajdujâ sië wspóîrzëdne
  91.             wierzchoîków.
  92.     movedpoints - wskaúnik na obszar pamiëci w którym zostanâ
  93.               zapisane wspóîrzëdne wynikowe punktów (movedpoints).
  94.  
  95.    UWAGI
  96.  
  97.     Struktura rotatedpoints ma postaê nastëpujâcâ:
  98.  
  99.     RotatedPoints:
  100.  
  101.         dc.l    n-1
  102.         dc.l    xr,yr,zr     ;P1
  103.         dc.l    xr,yr,zr     ;P2
  104.         dc.l    xr,yr,zr     ;P3
  105.         ...
  106.         dc.l    xr,yr,zr     ;Pn
  107.  
  108.     gdzie:
  109.     
  110.     n - iloôê wierzchoîków
  111.     xr - obrócona wspóîrzëdna x
  112.     yr - obrócona wspóîrzëdna y
  113.     zr - obrócona wspóîrzëdna z
  114.  
  115.     Rozmiar obszaru pamiëci na strukturë movedpoints moûna
  116.     obliczyê ze wzoru: n*12+4, gdzie n to iloôê wierzchoîków.
  117.     Struktura ta ma postaê nastëpujâcâ:
  118.  
  119.     MovedPoints:
  120.  
  121.         dc.l    n-1
  122.         dc.l    xrm,yrm,zrm     ;P1
  123.         dc.l    xrm,yrm,zrm     ;P2
  124.         dc.l    xrm,yrm,zrm     ;P3
  125.         ...
  126.         dc.l    xrm,yrm,zrm     ;Pn
  127.  
  128.     gdzie:
  129.     
  130.     n - iloôê wierzchoîków
  131.     xrm - obrócona i przesuniëta wspóîrzëdna x
  132.     yrm - obrócona i przesuniëta wspóîrzëdna y
  133.     zrm - obrócona i przesuniëta wspóîrzëdna z
  134.  
  135. pony3d.library/p3dPerspective                                     pony3d.library/p3dPerspective
  136.  
  137.    NAZWA
  138.     p3dPerspective -- Dokonyje rzutowania pespektywistycznego
  139.               wczeôniej obróconych i przesuniëtych punktów.
  140.  
  141.    OPIS
  142.     p3dPerspective( distance, width, height, movedpoints, 2dcords )
  143.              D0      D1     D2      A0          A1
  144.  
  145.     VOID p3dPerspective(ULONG, ULONG, ULONG, struct movedpoints *, struct 2dcords *)
  146.  
  147.    FUNKCJA
  148.     Fukcja dokonuje operacji rzutowania w zwiâzku z czym otrzymujemy
  149.     wspóîrzëdne na pîaszczyúnie.Punkty muszâ byê wczeôniej obrócone
  150.     i przesuniëte.
  151.  
  152.    WEJÔCIE
  153.     distance - odlegîoôê pîaszczyzny rzutowania od obserwatora w osi OZ
  154.     width - szerokoôê ekranu
  155.     height - wysokoôê ekranu
  156.     movedpoints - wskaúnik na strukturë movedpoints (otrzymanâ w
  157.             wyniku p3dMove) w której znajdujâ sië wspóîrzëdne
  158.             wierzchoîków.
  159.     2dcords - wskaúnik na obszar pamiëci w którym zostanâ
  160.           zapisane wspóîrzëdne wynikowe punktów (2dcords).
  161.  
  162.    UWAGI
  163.  
  164.     Struktura movedpoints ma postaê nastëpujâcâ:
  165.  
  166.     MovedPoints:
  167.  
  168.         dc.l    n-1
  169.         dc.l    xrm,yrm,zrm     ;P1
  170.         dc.l    xrm,yrm,zrm     ;P2
  171.         dc.l    xrm,yrm,zrm     ;P3
  172.         ...
  173.         dc.l    xrm,yrm,zrm     ;Pn
  174.  
  175.     gdzie:
  176.     
  177.     n - iloôê wierzchoîków
  178.     xrm - obrócona i przesuniëta wspóîrzëdna x
  179.     yrm - obrócona i przesuniëta wspóîrzëdna y
  180.     zrm - obrócona i przesuniëta wspóîrzëdna z
  181.  
  182.     Rozmiar obszaru pamiëci na strukturë 2dcords moûna
  183.     obliczyê ze wzoru: n*8+4, gdzie n to iloôê wierzchoîków.
  184.     Struktura ta ma postaê nastëpujâcâ:
  185.  
  186.     2DCords:
  187.  
  188.         dc.l    n-1
  189.         dc.l    x`,y`         ;P1
  190.         dc.l    x`,y`         ;P2
  191.         dc.l    x`,y`         ;P3
  192.         ...
  193.         dc.l    x`,y`         ;Pn
  194.  
  195.     gdzie:
  196.     
  197.     n - iloôê wierzchoîków
  198.     x` - wspóîrzëdna x na pîaszczyúnie
  199.     y` - wspóîrzëdna y na pîaszczyúnie
  200.  
  201. pony3d.library/p3dPointRepresent                                     pony3d.library/p3dPointRepresent
  202.  
  203.    NAZWA
  204.     p3dPointRepresent -- Wyôwietla wszystkie wierzchoîki i tylko
  205.                  wierzchoîki obiektu na ekranie.
  206.  
  207.    OPIS
  208.     p3dPointRepresent( 2dcords , plane )
  209.                 A0         A1
  210.  
  211.     VOID p3dPerspective(struct 2dcords *, APTR)
  212.  
  213.    FUNKCJA
  214.     Fukcja wyôwietla na ekranie punkty o podanych wspóîrzëdnych.
  215.     Nie sâ one îâczone.
  216.  
  217.    WEJÔCIE
  218.     2dcords - wskaúnik na strukturë 2dcordspoints (otrzymanâ w
  219.           wyniku p3dPerspective) w której znajdujâ sië wspóîrzëdne
  220.           wierzchoîków.
  221.     plane - adres ekranu na którym majâ byê wyôwietlone punkty.
  222.  
  223.    UWAGI
  224.  
  225.     Struktura 2dcords ma postaê nastëpujâcâ:
  226.  
  227.     2DCords:
  228.  
  229.         dc.l    n-1
  230.         dc.l    x`,y`         ;P1
  231.         dc.l    x`,y`         ;P2
  232.         dc.l    x`,y`         ;P3
  233.         ...
  234.         dc.l    x`,y`         ;Pn
  235.  
  236.     gdzie:
  237.     
  238.     n - iloôê wierzchoîków
  239.     x` - wspóîrzëdna x na pîaszczyúnie
  240.     y` - wspóîrzëdna y na pîaszczyúnie
  241.  
  242.