home *** CD-ROM | disk | FTP | other *** search
/ Tricks of the Windows Gam…ming Gurus (2nd Edition) / Disc2.iso / msdn_vcb / samples / vc98 / sdk / graphics / directx / misc / d3dutils.inl < prev    next >
Encoding:
Text File  |  1997-07-15  |  14.4 KB  |  628 lines
  1. /*
  2. **-----------------------------------------------------------------------------
  3. ** Name:    D3DUtils.inl
  4. ** Purpose: Various D3D utility functions
  5. ** Notes:   This defines inline functions only
  6. **
  7. ** Copyright (c) 1995 - 1997 by Microsoft, all rights reserved
  8. **-----------------------------------------------------------------------------
  9. */
  10.  
  11. /*
  12. **-----------------------------------------------------------------------------
  13. **    Light Inline Methods
  14. **-----------------------------------------------------------------------------
  15. */
  16.  
  17. /*
  18. **-----------------------------------------------------------------------------
  19. **  Name:    Light::AddToViewport
  20. **-----------------------------------------------------------------------------
  21. */
  22.  
  23. inline HRESULT
  24. Light::AddToViewport (LPDIRECT3DVIEWPORT2 lpView)
  25. {
  26.     Set();
  27.     return lpView->AddLight(lpD3DLight);
  28. } // end Light::AddToViewport
  29.  
  30.  
  31. /*
  32. **-----------------------------------------------------------------------------
  33. **  Name:    Light::RemoveFromViewport
  34. **-----------------------------------------------------------------------------
  35. */
  36.  
  37. inline HRESULT
  38. Light::RemoveFromViewport (LPDIRECT3DVIEWPORT2 lpView)
  39. {
  40.     return lpView->DeleteLight(lpD3DLight);
  41. } // end Light::RemoveFromViewport
  42.  
  43.  
  44.   
  45. /*
  46. **-----------------------------------------------------------------------------
  47. **  Name:    Light::Set
  48. **-----------------------------------------------------------------------------
  49. */
  50.  
  51. inline HRESULT    
  52. Light::Set (void)
  53. {    
  54.     if (changed) {
  55.         changed = 0;
  56.         return lpD3DLight->SetLight((D3DLIGHT *)&light);
  57.     } 
  58.  
  59.     return D3D_OK;
  60. } // end Light::Set
  61.  
  62.  
  63. /*
  64. **-----------------------------------------------------------------------------
  65. **  Name:    Light::SetColor
  66. **-----------------------------------------------------------------------------
  67. */
  68.  
  69. inline void        
  70. Light::SetColor (const D3DVECTOR & color)
  71. {
  72.     light.dcvColor.r = color[0];
  73.     light.dcvColor.g = color[1];
  74.     light.dcvColor.b = color[2];
  75.     changed = 1;
  76. } // end Light::SetColor
  77.  
  78.  
  79.   
  80. /*
  81. **-----------------------------------------------------------------------------
  82. **  Name:    Light::GetColor
  83. **-----------------------------------------------------------------------------
  84. */
  85.  
  86. inline D3DVECTOR    
  87. Light::GetColor (void) const
  88. {
  89.     D3DVECTOR    ret;
  90.     ret[0] = light.dcvColor.r;
  91.     ret[1] = light.dcvColor.g;
  92.     ret[2] = light.dcvColor.b;
  93.     return ret;
  94. } // end Light::GetColor
  95.  
  96.  
  97.  
  98. /*
  99. **-----------------------------------------------------------------------------
  100. **  Name:    Light::SetPosition
  101. **-----------------------------------------------------------------------------
  102. */
  103.  
  104. inline void        
  105. Light::SetPosition (const D3DVECTOR & position)
  106. { 
  107.     light.dvPosition = position;
  108.     changed = 1;
  109. } // end Light::SetPosition
  110.  
  111.  
  112. /*
  113. **-----------------------------------------------------------------------------
  114. **  Name:    Light::GetPosition
  115. **-----------------------------------------------------------------------------
  116. */
  117.  
  118. inline D3DVECTOR    
  119. Light::GetPosition(void) const
  120. { 
  121.     return light.dvPosition;
  122. } // end Light::GetPosition
  123.  
  124.  
  125.   
  126. /*
  127. **-----------------------------------------------------------------------------
  128. **  Name:    Light::SetDirection
  129. **-----------------------------------------------------------------------------
  130. */
  131.  
  132. inline void        
  133. Light::SetDirection (const D3DVECTOR & direction)
  134. { 
  135.     light.dvDirection = direction;
  136.     changed = 1;
  137. }
  138.  
  139.  
  140.  
  141. /*
  142. **-----------------------------------------------------------------------------
  143. **  Name:    Light::GetDirection
  144. **-----------------------------------------------------------------------------
  145. */
  146.  
  147. inline D3DVECTOR    
  148. Light::GetDirection(void) const
  149. { 
  150.     return light.dvDirection;
  151. }
  152.  
  153.  
  154. /*
  155. **-----------------------------------------------------------------------------
  156. **  Name:    Light::SetAttenuation
  157. **-----------------------------------------------------------------------------
  158. */
  159.  
  160. inline void        
  161. Light::SetAttenuation (const D3DVECTOR & attenuation)
  162. { 
  163.     light.dvAttenuation0 = attenuation[0];
  164.     light.dvAttenuation1 = attenuation[1];
  165.     light.dvAttenuation2 = attenuation[2];
  166.     changed = 1;
  167. } // end Light::SetAttenuation
  168.  
  169.  
  170.  
  171. /*
  172. **-----------------------------------------------------------------------------
  173. **  Name:    Light::GetAttenuation
  174. **-----------------------------------------------------------------------------
  175. */
  176.  
  177. inline D3DVECTOR    
  178. Light::GetAttenuation(void) const
  179. { 
  180.     D3DVECTOR    ret;
  181.     ret[0] = light.dvAttenuation0;
  182.     ret[1] = light.dvAttenuation1;
  183.     ret[2] = light.dvAttenuation2;
  184.     return ret;
  185. } // end Light::GetAttenuation
  186.  
  187.  
  188.   
  189. /*
  190. **-----------------------------------------------------------------------------
  191. **  Name:    Light::SetRange
  192. **-----------------------------------------------------------------------------
  193. */
  194.  
  195. inline void        
  196. Light::SetRange(const float range)
  197. {
  198.     light.dvRange = range;
  199.     changed = 1;
  200. } // end Light::SetRange
  201.  
  202.  
  203. /*
  204. **-----------------------------------------------------------------------------
  205. **  Name:    Light::GetRange
  206. **-----------------------------------------------------------------------------
  207. */
  208.  
  209. inline float        
  210. Light::GetRange(void) const
  211. {
  212.     return light.dvRange;
  213. } // end Light::GetRange
  214.  
  215.  
  216.   
  217. /*
  218. **-----------------------------------------------------------------------------
  219. **  Name:    Light::SetFalloff
  220. **-----------------------------------------------------------------------------
  221. */
  222.  
  223. inline void        
  224. Light::SetFalloff(const float falloff)
  225. {
  226.     light.dvFalloff = falloff;
  227.     changed = 1;
  228. } // end Light::SetFalloff
  229.  
  230.  
  231.   
  232. /*
  233. **-----------------------------------------------------------------------------
  234. **  Name:    Light::GetFalloff
  235. **-----------------------------------------------------------------------------
  236. */
  237.  
  238. inline float        
  239. Light::GetFalloff(void) const
  240. {
  241.     return light.dvFalloff;
  242. } // end Light::GetFalloff
  243.  
  244.  
  245.  
  246. /*
  247. **-----------------------------------------------------------------------------
  248. **  Name:    Light::SetUmbra
  249. **-----------------------------------------------------------------------------
  250. */
  251.  
  252. inline void        
  253. Light::SetUmbra(const float umbra)
  254. {
  255.     light.dvTheta = umbra;
  256.     changed = 1;
  257. } // end Light::SetUmbra
  258.  
  259.  
  260.  
  261. /*
  262. **-----------------------------------------------------------------------------
  263. **  Name:    Light::GetUmbra
  264. **-----------------------------------------------------------------------------
  265. */
  266.  
  267. inline float        
  268. Light::GetUmbra(void) const
  269. {
  270.     return light.dvTheta;
  271. } // end Light::GetUmbra
  272.  
  273.  
  274.  
  275. /*
  276. **-----------------------------------------------------------------------------
  277. **  Name:    Light::SetPenumbra
  278. **-----------------------------------------------------------------------------
  279. */
  280.  
  281. inline void        
  282. Light::SetPenumbra(const float penumbra)
  283. {
  284.     light.dvPhi = penumbra;
  285.     changed = 1;
  286. } // end Light::SetPenumbra
  287.  
  288.  
  289.  
  290. /*
  291. **-----------------------------------------------------------------------------
  292. **  Name:    Light::GetPenumbra
  293. **-----------------------------------------------------------------------------
  294. */
  295.  
  296. inline float        
  297. Light::GetPenumbra(void) const
  298. {
  299.     return light.dvPhi;
  300. } // end Light::GetPenumbra
  301.  
  302.  
  303. inline void        
  304. Light::SetFlags(const DWORD flags)
  305. {
  306.     light.dwFlags = flags;
  307.     changed = 1;
  308. }    // end of Light::SetFlags()
  309.  
  310. inline DWORD        
  311. Light::GetFlags(void) const
  312. {
  313.     return light.dwFlags;
  314. }    // end of Light::GtFlags()
  315.  
  316. /*
  317. **-----------------------------------------------------------------------------
  318. **    Material inline methods
  319. **-----------------------------------------------------------------------------
  320. */
  321.  
  322. /*
  323. **-----------------------------------------------------------------------------
  324. **  Name:    Material::SetAsCurrent
  325. **-----------------------------------------------------------------------------
  326. */
  327.  
  328. inline HRESULT
  329. Material::SetAsCurrent(LPDIRECT3DDEVICE2 lpDev)
  330. {
  331.     HRESULT hResult;
  332.  
  333.     Set();
  334.  
  335.     hResult = lpDev->SetLightState(D3DLIGHTSTATE_MATERIAL, hMat);
  336.     if (hResult != D3D_OK)
  337.         return hResult;
  338.  
  339.     hResult = lpDev->SetRenderState(D3DRENDERSTATE_TEXTUREHANDLE, Mat.hTexture);
  340.     if (hResult != D3D_OK)
  341.         return hResult;
  342.  
  343.     // Success
  344.     return D3D_OK;
  345. } // end Material::SetAsCurrent
  346.  
  347.  
  348.   
  349. /*
  350. **-----------------------------------------------------------------------------
  351. **  Name:    Material::Set
  352. **-----------------------------------------------------------------------------
  353. */
  354.  
  355. inline HRESULT
  356. Material::Set(void)
  357. {
  358.     if (changed) {
  359.         changed = 0;
  360.         return lpMat->SetMaterial (&Mat);
  361.     } 
  362.  
  363.     return D3D_OK;
  364. } // end Material::Set
  365.  
  366.  
  367.  
  368. /*
  369. **-----------------------------------------------------------------------------
  370. **  Name:    Material::SetAsBackground
  371. **-----------------------------------------------------------------------------
  372. */
  373.  
  374. inline HRESULT
  375. Material::SetAsBackground (LPDIRECT3DVIEWPORT2 lpView)
  376. {
  377.     Mat.dwRampSize = 1;
  378.     changed = 1;
  379.     Set();
  380.     return lpView->SetBackground(hMat);
  381. } // end Material::SetAsBackground
  382.  
  383.  
  384.  
  385. /*
  386. **-----------------------------------------------------------------------------
  387. **  Name:    Material::SetDiffuse
  388. **-----------------------------------------------------------------------------
  389. */
  390.  
  391. inline void        
  392. Material::SetDiffuse(const D3DVECTOR& color)
  393. {
  394.     Mat.diffuse.r = color[0];
  395.     Mat.diffuse.g = color[1];
  396.     Mat.diffuse.b = color[2];
  397.     changed = 1;
  398. } // end Material::SetDiffuse
  399.  
  400.  
  401. /*
  402. **-----------------------------------------------------------------------------
  403. **  Name:    Material::GetDiffuse
  404. **-----------------------------------------------------------------------------
  405. */
  406.  
  407. inline D3DVECTOR    
  408. Material::GetDiffuse(void) const
  409. {
  410.     D3DVECTOR    ret;
  411.     ret[0] = Mat.diffuse.r;
  412.     ret[1] = Mat.diffuse.g;
  413.     ret[2] = Mat.diffuse.b;
  414.     return ret;
  415. } // end Material::GetDiffuse
  416.  
  417. inline void        
  418. Material::SetAlpha(const float& alpha)
  419. {
  420.     Mat.diffuse.a = alpha;
  421.     changed = 1;
  422. }    // end of Material::SetAlpha()
  423.  
  424. inline float    
  425. Material::GetAlpha(void) const
  426. {
  427.     return Mat.diffuse.a;
  428. }    // end of Material::GetAlpha()
  429.  
  430.  
  431.  
  432. /*
  433. **-----------------------------------------------------------------------------
  434. **  Name:    Material::SetAmbient
  435. **-----------------------------------------------------------------------------
  436. */
  437.  
  438. inline void        
  439. Material::SetAmbient(const D3DVECTOR& color)
  440. {
  441.     Mat.ambient.r = color[0];
  442.     Mat.ambient.g = color[1];
  443.     Mat.ambient.b = color[2];
  444.     changed = 1;
  445. } // end Material::SetAmbient
  446.  
  447.  
  448.   
  449. /*
  450. **-----------------------------------------------------------------------------
  451. **  Name:    Material::GetAmbient
  452. **-----------------------------------------------------------------------------
  453. */
  454.  
  455. inline D3DVECTOR    
  456. Material::GetAmbient(void) const
  457. {
  458.     D3DVECTOR    ret;
  459.     ret[0] = Mat.ambient.r;
  460.     ret[1] = Mat.ambient.g;
  461.     ret[2] = Mat.ambient.b;
  462.     return ret;
  463. } // end Material::GetAmbient
  464.  
  465.  
  466.  
  467. /*
  468. **-----------------------------------------------------------------------------
  469. **  Name:    Material::SetEmissive
  470. **-----------------------------------------------------------------------------
  471. */
  472.  
  473. inline void        
  474. Material::SetEmissive(const D3DVECTOR& color)
  475. {
  476.     Mat.emissive.r = color[0];
  477.     Mat.emissive.g = color[1];
  478.     Mat.emissive.b = color[2];
  479.     changed = 1;
  480. } // end Material::SetEmissive
  481.  
  482.  
  483.  
  484. /*
  485. **-----------------------------------------------------------------------------
  486. **  Name:    Material::GetEmissive
  487. **-----------------------------------------------------------------------------
  488. */
  489.  
  490. inline D3DVECTOR    
  491. Material::GetEmissive(void) const
  492. {
  493.     D3DVECTOR    ret;
  494.     ret[0] = Mat.emissive.r;
  495.     ret[1] = Mat.emissive.g;
  496.     ret[2] = Mat.emissive.b;
  497.     return ret;
  498. } // end Material::GetEmissive
  499.  
  500.  
  501.   
  502. /*
  503. **-----------------------------------------------------------------------------
  504. **  Name:    Material::SetSpecular
  505. **-----------------------------------------------------------------------------
  506. */
  507.  
  508. inline void        
  509. Material::SetSpecular(const D3DVECTOR& color)
  510. {
  511.     Mat.specular.r = color[0];
  512.     Mat.specular.g = color[1];
  513.     Mat.specular.b = color[2];
  514.     changed = 1;
  515. } // end Material::SetSpecular
  516.  
  517.  
  518.   
  519. /*
  520. **-----------------------------------------------------------------------------
  521. **  Name:    Material::GetSpecular
  522. **-----------------------------------------------------------------------------
  523. */
  524.  
  525. inline D3DVECTOR    
  526. Material::GetSpecular(void) const
  527. {
  528.     D3DVECTOR    ret;
  529.     ret[0] = Mat.specular.r;
  530.     ret[1] = Mat.specular.g;
  531.     ret[2] = Mat.specular.b;
  532.     return ret;
  533. } // end Material::GetSpecular
  534.  
  535.  
  536.  
  537. /*
  538. **-----------------------------------------------------------------------------
  539. **  Name:    Material::SetPower
  540. **-----------------------------------------------------------------------------
  541. */
  542.  
  543. inline void        
  544. Material::SetPower(const D3DVALUE& power)
  545. {
  546.     Mat.power = power;
  547.     changed = 1;
  548. } // end Material::SetPower
  549.  
  550.  
  551.   
  552. /*
  553. **-----------------------------------------------------------------------------
  554. **  Name:    Material::GetPower
  555. **-----------------------------------------------------------------------------
  556. */
  557.  
  558. inline D3DVALUE    
  559. Material::GetPower(void) const
  560. {
  561.     return Mat.power;
  562. } // end Material::GetPower
  563.  
  564.  
  565.   
  566. /*
  567. **-----------------------------------------------------------------------------
  568. **  Name:    Material::SetRampSize
  569. **-----------------------------------------------------------------------------
  570. */
  571.  
  572. inline void        
  573. Material::SetRampSize(const DWORD& ramp)
  574. {
  575.     Mat.dwRampSize = ramp;
  576.     changed = 1;
  577. } // end Material::SetRampSize
  578.  
  579.  
  580.   
  581. /*
  582. **-----------------------------------------------------------------------------
  583. **  Name:    Material::GetRampSize
  584. **-----------------------------------------------------------------------------
  585. */
  586.  
  587. inline DWORD        
  588. Material::GetRampSize(void) const
  589. {
  590.     return Mat.dwRampSize;
  591. } // end Material::GetRampSize
  592.  
  593.  
  594.  
  595. /*
  596. **-----------------------------------------------------------------------------
  597. **  Name:    Material::SetTextureHandle
  598. **-----------------------------------------------------------------------------
  599. */
  600.  
  601. inline void        
  602. Material::SetTextureHandle(const D3DTEXTUREHANDLE& hTexture)
  603. {
  604.     Mat.hTexture = hTexture;
  605.     changed = 1;
  606. } // end Material::SetTextureHandle
  607.  
  608.  
  609. /*
  610. **-----------------------------------------------------------------------------
  611. **  Name:    Material::GetTextureHandle
  612. **-----------------------------------------------------------------------------
  613. */
  614.  
  615. inline D3DTEXTUREHANDLE    
  616. Material::GetTextureHandle(void)
  617. {
  618.     Set();
  619.     return Mat.hTexture;
  620. } // end Material::GetTextureHandle
  621.  
  622.   
  623. /*
  624. **-----------------------------------------------------------------------------
  625. **  end of File
  626. **-----------------------------------------------------------------------------
  627. */
  628.