Material.cs 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353
  1. using System;
  2. using System.Collections.Generic;
  3. using System.Linq;
  4. using System.Runtime.CompilerServices;
  5. using System.Text;
  6. namespace BansheeEngine
  7. {
  8. /// <summary>
  9. /// Material that controls how objects are rendered. It is represented by a shader and parameters used to set up that
  10. /// shader. It provides a simple interface for manipulating the parameters.
  11. /// </summary>
  12. public class Material : Resource
  13. {
  14. /// <summary>
  15. /// Creates a new empty material that references no shader.
  16. /// </summary>
  17. public Material()
  18. {
  19. Internal_CreateInstance(this, IntPtr.Zero);
  20. }
  21. /// <summary>
  22. /// Constructor for internal runtime use only.
  23. /// </summary>
  24. /// <param name="dummy">Dummy parameter to differentiate it from other constructors.</param>
  25. private Material(bool dummy)
  26. { }
  27. /// <summary>
  28. /// Creates a new material with the specified shader.
  29. /// </summary>
  30. /// <param name="shader">Shader to initialize the material with.</param>
  31. public Material(Shader shader)
  32. {
  33. IntPtr nativeShader = IntPtr.Zero;
  34. if (shader != null)
  35. nativeShader = shader.GetCachedPtr();
  36. Internal_CreateInstance(this, nativeShader);
  37. }
  38. /// <summary>
  39. /// Shader used by the material. Best technique from the shader will be used for rendering, depending on currently
  40. /// active renderer and render API.
  41. /// </summary>
  42. public Shader Shader
  43. {
  44. get { return Internal_GetShader(mCachedPtr); }
  45. set
  46. {
  47. IntPtr nativeShader = IntPtr.Zero;
  48. if (value != null)
  49. nativeShader = value.GetCachedPtr();
  50. Internal_SetShader(mCachedPtr, nativeShader);
  51. }
  52. }
  53. /// <summary>
  54. /// Assigns a float value to the shader parameter with the specified name.
  55. /// </summary>
  56. /// <param name="name">Name of the shader parameter.</param>
  57. /// <param name="value">Value of the parameter.</param>
  58. public void SetFloat(string name, float value)
  59. {
  60. Internal_SetFloat(mCachedPtr, name, value);
  61. }
  62. /// <summary>
  63. /// Assigns a 2D vector to the shader parameter with the specified name.
  64. /// </summary>
  65. /// <param name="name">Name of the shader parameter.</param>
  66. /// <param name="value">Value of the parameter.</param>
  67. public void SetVector2(string name, Vector2 value)
  68. {
  69. Internal_SetVector2(mCachedPtr, name, value);
  70. }
  71. /// <summary>
  72. /// Assigns a 3D vector to the shader parameter with the specified name.
  73. /// </summary>
  74. /// <param name="name">Name of the shader parameter.</param>
  75. /// <param name="value">Value of the parameter.</param>
  76. public void SetVector3(string name, Vector3 value)
  77. {
  78. Internal_SetVector3(mCachedPtr, name, value);
  79. }
  80. /// <summary>
  81. /// Assigns a 4D vector to the shader parameter with the specified name.
  82. /// </summary>
  83. /// <param name="name">Name of the shader parameter.</param>
  84. /// <param name="value">Value of the parameter.</param>
  85. public void SetVector4(string name, Vector4 value)
  86. {
  87. Internal_SetVector4(mCachedPtr, name, value);
  88. }
  89. /// <summary>
  90. /// Assigns a 3x3 matrix to the shader parameter with the specified name.
  91. /// </summary>
  92. /// <param name="name">Name of the shader parameter.</param>
  93. /// <param name="value">Value of the parameter.</param>
  94. public void SetMatrix3(string name, Matrix3 value)
  95. {
  96. Internal_SetMatrix3(mCachedPtr, name, value);
  97. }
  98. /// <summary>
  99. /// Assigns a 4x4 matrix to the shader parameter with the specified name.
  100. /// </summary>
  101. /// <param name="name">Name of the shader parameter.</param>
  102. /// <param name="value">Value of the parameter.</param>
  103. public void SetMatrix4(string name, Matrix4 value)
  104. {
  105. Internal_SetMatrix4(mCachedPtr, name, value);
  106. }
  107. /// <summary>
  108. /// Assigns a color to the shader parameter with the specified name.
  109. /// </summary>
  110. /// <param name="name">Name of the shader parameter.</param>
  111. /// <param name="value">Value of the parameter.</param>
  112. public void SetColor(string name, Color value)
  113. {
  114. Internal_SetColor(mCachedPtr, name, value);
  115. }
  116. /// <summary>
  117. /// Assigns a 2D texture to the shader parameter with the specified name.
  118. /// </summary>
  119. /// <param name="name">Name of the shader parameter.</param>
  120. /// <param name="value">Value of the parameter.</param>
  121. public void SetTexture2D(string name, Texture2D value)
  122. {
  123. IntPtr texturePtr = IntPtr.Zero;
  124. if (value != null)
  125. texturePtr = value.GetCachedPtr();
  126. Internal_SetTexture2D(mCachedPtr, name, texturePtr);
  127. }
  128. /// <summary>
  129. /// Assigns a 3D texture to the shader parameter with the specified name.
  130. /// </summary>
  131. /// <param name="name">Name of the shader parameter.</param>
  132. /// <param name="value">Value of the parameter.</param>
  133. public void SetTexture3D(string name, Texture3D value)
  134. {
  135. IntPtr texturePtr = IntPtr.Zero;
  136. if (value != null)
  137. texturePtr = value.GetCachedPtr();
  138. Internal_SetTexture3D(mCachedPtr, name, texturePtr);
  139. }
  140. /// <summary>
  141. /// Assigns a cube texture to the shader parameter with the specified name.
  142. /// </summary>
  143. /// <param name="name">Name of the shader parameter.</param>
  144. /// <param name="value">Value of the parameter.</param>
  145. public void SetTextureCube(string name, TextureCube value)
  146. {
  147. IntPtr texturePtr = IntPtr.Zero;
  148. if (value != null)
  149. texturePtr = value.GetCachedPtr();
  150. Internal_SetTextureCube(mCachedPtr, name, texturePtr);
  151. }
  152. /// <summary>
  153. /// Returns a float value assigned with the parameter with the specified name.
  154. /// </summary>
  155. /// <param name="name">Name of the shader parameter.</param>
  156. /// <returns>Value of the parameter.</returns>
  157. public float GetFloat(string name)
  158. {
  159. return Internal_GetFloat(mCachedPtr, name);
  160. }
  161. /// <summary>
  162. /// Returns a 2D vector assigned with the parameter with the specified name.
  163. /// </summary>
  164. /// <param name="name">Name of the shader parameter.</param>
  165. /// <returns>Value of the parameter.</returns>
  166. public Vector2 GetVector2(string name)
  167. {
  168. return Internal_GetVector2(mCachedPtr, name);
  169. }
  170. /// <summary>
  171. /// Returns a 3D vector assigned with the parameter with the specified name.
  172. /// </summary>
  173. /// <param name="name">Name of the shader parameter.</param>
  174. /// <returns>Value of the parameter.</returns>
  175. public Vector3 GetVector3(string name)
  176. {
  177. return Internal_GetVector3(mCachedPtr, name);
  178. }
  179. /// <summary>
  180. /// Returns a 4D vector assigned with the parameter with the specified name.
  181. /// </summary>
  182. /// <param name="name">Name of the shader parameter.</param>
  183. /// <returns>Value of the parameter.</returns>
  184. public Vector4 GetVector4(string name)
  185. {
  186. return Internal_GetVector4(mCachedPtr, name);
  187. }
  188. /// <summary>
  189. /// Returns a 3x3 matrix assigned with the parameter with the specified name.
  190. /// </summary>
  191. /// <param name="name">Name of the shader parameter.</param>
  192. /// <returns>Value of the parameter.</returns>
  193. public Matrix3 GetMatrix3(string name)
  194. {
  195. return Internal_GetMatrix3(mCachedPtr, name);
  196. }
  197. /// <summary>
  198. /// Returns a 4x4 matrix assigned with the parameter with the specified name.
  199. /// </summary>
  200. /// <param name="name">Name of the shader parameter.</param>
  201. /// <returns>Value of the parameter.</returns>
  202. public Matrix4 GetMatrix4(string name)
  203. {
  204. return Internal_GetMatrix4(mCachedPtr, name);
  205. }
  206. /// <summary>
  207. /// Returns a color assigned with the parameter with the specified name.
  208. /// </summary>
  209. /// <param name="name">Name of the shader parameter.</param>
  210. /// <returns>Value of the parameter.</returns>
  211. public Color GetColor(string name)
  212. {
  213. return Internal_GetColor(mCachedPtr, name);
  214. }
  215. /// <summary>
  216. /// Returns a 2D texture assigned with the parameter with the specified name.
  217. /// </summary>
  218. /// <param name="name">Name of the shader parameter.</param>
  219. /// <returns>Value of the parameter.</returns>
  220. public Texture2D GetTexture2D(string name)
  221. {
  222. return Internal_GetTexture2D(mCachedPtr, name);
  223. }
  224. /// <summary>
  225. /// Returns a 3D texture assigned with the parameter with the specified name.
  226. /// </summary>
  227. /// <param name="name">Name of the shader parameter.</param>
  228. /// <returns>Value of the parameter.</returns>
  229. public Texture3D GetTexture3D(string name)
  230. {
  231. return Internal_GetTexture3D(mCachedPtr, name);
  232. }
  233. /// <summary>
  234. /// Returns a cube texture assigned with the parameter with the specified name.
  235. /// </summary>
  236. /// <param name="name">Name of the shader parameter.</param>
  237. /// <returns>Value of the parameter.</returns>
  238. public TextureCube GetTextureCube(string name)
  239. {
  240. return Internal_GetTextureCube(mCachedPtr, name);
  241. }
  242. /// <summary>
  243. /// Creates a deep copy of the material.
  244. /// </summary>
  245. /// <returns>A new object with exact data as this object.</returns>
  246. public Material Clone()
  247. {
  248. return Internal_Clone(mCachedPtr);
  249. }
  250. [MethodImpl(MethodImplOptions.InternalCall)]
  251. private static extern void Internal_CreateInstance(Material instance, IntPtr shader);
  252. [MethodImpl(MethodImplOptions.InternalCall)]
  253. private static extern Shader Internal_GetShader(IntPtr nativeInstance);
  254. [MethodImpl(MethodImplOptions.InternalCall)]
  255. private static extern void Internal_SetShader(IntPtr nativeInstance, IntPtr shader);
  256. [MethodImpl(MethodImplOptions.InternalCall)]
  257. private static extern void Internal_SetFloat(IntPtr nativeInstance, string name, float value);
  258. [MethodImpl(MethodImplOptions.InternalCall)]
  259. private static extern void Internal_SetVector2(IntPtr nativeInstance, string name, Vector2 value);
  260. [MethodImpl(MethodImplOptions.InternalCall)]
  261. private static extern void Internal_SetVector3(IntPtr nativeInstance, string name, Vector3 value);
  262. [MethodImpl(MethodImplOptions.InternalCall)]
  263. private static extern void Internal_SetVector4(IntPtr nativeInstance, string name, Vector4 value);
  264. [MethodImpl(MethodImplOptions.InternalCall)]
  265. private static extern void Internal_SetMatrix3(IntPtr nativeInstance, string name, Matrix3 value);
  266. [MethodImpl(MethodImplOptions.InternalCall)]
  267. private static extern void Internal_SetMatrix4(IntPtr nativeInstance, string name, Matrix4 value);
  268. [MethodImpl(MethodImplOptions.InternalCall)]
  269. private static extern void Internal_SetColor(IntPtr nativeInstance, string name, Color value);
  270. [MethodImpl(MethodImplOptions.InternalCall)]
  271. private static extern void Internal_SetTexture2D(IntPtr nativeInstance, string name, IntPtr value);
  272. [MethodImpl(MethodImplOptions.InternalCall)]
  273. private static extern void Internal_SetTexture3D(IntPtr nativeInstance, string name, IntPtr value);
  274. [MethodImpl(MethodImplOptions.InternalCall)]
  275. private static extern void Internal_SetTextureCube(IntPtr nativeInstance, string name, IntPtr value);
  276. [MethodImpl(MethodImplOptions.InternalCall)]
  277. private static extern float Internal_GetFloat(IntPtr nativeInstance, string name);
  278. [MethodImpl(MethodImplOptions.InternalCall)]
  279. private static extern Vector2 Internal_GetVector2(IntPtr nativeInstance, string name);
  280. [MethodImpl(MethodImplOptions.InternalCall)]
  281. private static extern Vector3 Internal_GetVector3(IntPtr nativeInstance, string name);
  282. [MethodImpl(MethodImplOptions.InternalCall)]
  283. private static extern Vector4 Internal_GetVector4(IntPtr nativeInstance, string name);
  284. [MethodImpl(MethodImplOptions.InternalCall)]
  285. private static extern Matrix3 Internal_GetMatrix3(IntPtr nativeInstance, string name);
  286. [MethodImpl(MethodImplOptions.InternalCall)]
  287. private static extern Matrix4 Internal_GetMatrix4(IntPtr nativeInstance, string name);
  288. [MethodImpl(MethodImplOptions.InternalCall)]
  289. private static extern Color Internal_GetColor(IntPtr nativeInstance, string name);
  290. [MethodImpl(MethodImplOptions.InternalCall)]
  291. private static extern Texture2D Internal_GetTexture2D(IntPtr nativeInstance, string name);
  292. [MethodImpl(MethodImplOptions.InternalCall)]
  293. private static extern Texture3D Internal_GetTexture3D(IntPtr nativeInstance, string name);
  294. [MethodImpl(MethodImplOptions.InternalCall)]
  295. private static extern TextureCube Internal_GetTextureCube(IntPtr nativeInstance, string name);
  296. [MethodImpl(MethodImplOptions.InternalCall)]
  297. private static extern Material Internal_Clone(IntPtr nativeInstance);
  298. }
  299. }