home *** CD-ROM | disk | FTP | other *** search
/ Learn 3D Graphics Programming on the PC / Learn_3D_Graphics_Programming_on_the_PC_Ferraro.iso / rwwin / pick.h2_ / pick.bin
Text File  |  1995-11-14  |  4KB  |  88 lines
  1. #if !defined(_PICK_H)
  2. #define _PICK_H
  3.  
  4. //*********************************************************************
  5. //
  6. // File :     pick.h
  7. //
  8. // Abstract : The interface to some enhanced picking functionality
  9. //            which use ray casting to determine the exact position
  10. //            of the projection of a viewport position onto an
  11. //            arbitrary plane. These functions can be used to drag
  12. //            objects directly under the mouse cursor.
  13. //
  14. //            This application had been written to be compatible with
  15. //            both the fixed and floating-point versions of the
  16. //            RenderWare library, i.e., it uses the macros CREAL,
  17. //            INT2REAL, RAdd, RDiv, RSub etc. If your application is
  18. //            intended for the floating-point version of the library
  19. //            only these macros are not necessary.
  20. //
  21. //            Please note that this application is intended for
  22. //            demonstration purposes only. No support will be
  23. //            provided for this code and it comes with no warranty.
  24. //
  25. //*********************************************************************
  26. //
  27. // This file is a product of Criterion Software Ltd.
  28. //
  29. // This file is provided as is with no warranties of any kind and is
  30. // provided without any obligation on Criterion Software Ltd. or
  31. // Canon Inc. to assist in its use or modification.
  32. //
  33. // Criterion Software Ltd. will not, under any
  34. // circumstances, be liable for any lost revenue or other damages
  35. // arising from the use of this file.
  36. //
  37. // Copyright (c) 1994, 1995 Criterion Software Ltd.
  38. // All Rights Reserved.
  39. //
  40. // RenderWare is a trademark of Canon Inc.
  41. //
  42. //*********************************************************************
  43.  
  44. //*********************************************************************
  45. //
  46. // Type definitions.
  47. //
  48. //*********************************************************************
  49.  
  50. // This type represents a ray which we intersect with a plane to
  51. // compute a position.
  52. typedef struct
  53. {
  54.     RwV3d p;                    // Origin of the ray.
  55.  
  56.     RwV3d v;                    // Direction of the ray.
  57.  
  58. }
  59. RwRay;
  60.  
  61. //*********************************************************************
  62. //
  63. // Functions.
  64. //
  65. //*********************************************************************
  66.  
  67. // Return t at the point of interestion of the given ray and plane.
  68. // The plane is defined by a point on the plane (p) and a nornal to the
  69. // plane (n). Returns TRUE if the ray and plane intersect and FALSE if
  70. // the ray and plane are parallel.
  71. extern RwBool IntersectRayAndPlane(RwRay * ray, RwV3d * n, RwV3d * p, RwReal * t);
  72.  
  73. // Given a camera and a viewport position spawn a ray into world space.
  74. // NOTE: This function does not take into account camera offsets.
  75. extern RwRay *SpawnRay(RwCamera * camera, RwInt32 x, RwInt32 y, RwRay * ray);
  76.  
  77. // Compute the position (in world coordinates) of the given clump under
  78. // the given (x, y) position in the viewport of the given camera. The
  79. // clump will keep a constant orientation and distance with respect to
  80. // the camera, i.e., this function can be used to drag the clump around
  81. // on the plane parallel to the camera on which the clump lies.
  82. extern RwV3d *GetClumpPositionUnderPointer(RwClump * clump, RwCamera * camera,
  83.                                          RwInt32 x, RwInt32 y, RwV3d * pos);
  84.  
  85. //*********************************************************************
  86.  
  87. #endif /* !defined(_PICK_H) */
  88.