Material.cs 13 KB

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