RenderContext.hx 26 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824
  1. package h2d;
  2. private typedef ViewportStackEntry = {
  3. va : Float, vb : Float, vc : Float, vd : Float, vx : Float, vy : Float
  4. };
  5. private typedef CameraStackEntry = ViewportStackEntry & {
  6. camera: h2d.Camera
  7. };
  8. private typedef TargetStackEntry = ViewportStackEntry & {
  9. t : h3d.mat.Texture, hasRZ : Bool, rzX:Float, rzY:Float, rzW:Float, rzH:Float
  10. };
  11. private typedef RenderZoneStack = { hasRZ:Bool, x:Float, y:Float, w:Float, h:Float };
  12. private typedef FilterStack = { spr: h2d.Object, scaleX:Float, scaleY:Float };
  13. /**
  14. A 2D scene renderer.
  15. Passed during `Object.sync` and `Object.drawRec` and can be accessed directly via `Scene.renderer`.
  16. **/
  17. @:access(h2d.Scene)
  18. class RenderContext extends h3d.impl.RenderContext {
  19. static inline var BUFFERING = #if heaps_emit_tile_buffering true #else false #end;
  20. /**
  21. Current transparency value used for rendering objects.
  22. Automatically managed by `Object`.
  23. **/
  24. public var globalAlpha = 1.;
  25. /**
  26. Temporary vertex buffer used to emit Tiles when `RenderContext.BUFFERING` is on.
  27. Otherwise it's `null`. Internal usage only.
  28. **/
  29. @:dox(hide)
  30. public var buffer : hxd.FloatBuffer;
  31. /**
  32. Current temporary buffer position. Internal usage only.
  33. **/
  34. @:dox(hide)
  35. public var bufPos : Int;
  36. /**
  37. The 2D scene attached to this RenderContext instance.
  38. **/
  39. public var scene : h2d.Scene;
  40. /**
  41. <span class="label">Internal usage</span>
  42. Determines texture filtering method (Linear or Nearest).
  43. Not recommended to use - assign `Scene.defaultSmooth` instead.
  44. **/
  45. public var defaultSmooth : Bool = false;
  46. /**
  47. When enabled, pixels with alpha value below 0.001 will be discarded.
  48. **/
  49. public var killAlpha : Bool;
  50. /**
  51. When enabled, causes `Object` to render its children in reverse order.
  52. **/
  53. public var front2back : Bool;
  54. /**
  55. Sent before Drawable is rendered.
  56. Drawable won't be rendered if callback returns `false`.
  57. **/
  58. public var onBeginDraw : h2d.Drawable->Bool;
  59. /**
  60. Sent before filter begins rendering.
  61. Filter (and it's object tree) won't be rendered if callback returns `false`.
  62. **/
  63. public var onEnterFilter : h2d.Object->Bool;
  64. /**
  65. Send after filter has been rendered.
  66. **/
  67. public var onLeaveFilter : h2d.Object->Void;
  68. /**
  69. <span class="label">Internal usage</span>
  70. Used to calculate filter rendering bounds.
  71. **/
  72. @:dox(hide)
  73. public var tmpBounds = new h2d.col.Bounds();
  74. /**
  75. The camera instance that is currently being rendered, if present, `null` otherwise.
  76. **/
  77. public var currentCamera(default, null): Null<h2d.Camera> = null;
  78. var texture : h3d.mat.Texture;
  79. var baseShader : h3d.shader.Base2d;
  80. var output : h3d.pass.OutputShader;
  81. var compiledShader : hxsl.RuntimeShader;
  82. var fixedBuffer : h3d.Buffer;
  83. var pass : h3d.mat.Pass;
  84. var currentShaders : hxsl.ShaderList;
  85. var baseShaderList : hxsl.ShaderList;
  86. var needInitShaders : Bool;
  87. var currentObj : Drawable;
  88. var stride : Int;
  89. var targetsStack : Array<TargetStackEntry>;
  90. var targetsStackIndex : Int;
  91. var cameraStack : Array<CameraStackEntry>;
  92. var cameraStackIndex : Int;
  93. var curTarget : h3d.mat.Texture;
  94. var renderZoneStack:Array<RenderZoneStack> = [];
  95. var renderZoneIndex:Int = 0;
  96. var hasUVPos : Bool;
  97. var filterStack : Array<FilterStack>;
  98. var filterStackIndex : Int;
  99. var inFilter : FilterStack;
  100. var inFilterBlend : BlendMode;
  101. var viewA : Float;
  102. var viewB : Float;
  103. var viewC : Float;
  104. var viewD : Float;
  105. var viewX : Float;
  106. var viewY : Float;
  107. var hasRenderZone : Bool;
  108. var renderX : Float;
  109. var renderY : Float;
  110. var renderW : Float;
  111. var renderH : Float;
  112. var currentBlend : BlendMode;
  113. var baseFlipY : Float;
  114. var targetFlipY : Float;
  115. /**
  116. Create a new RenderContext and attach it to specified Scene.
  117. @param scene The scene which RenderContext will render.
  118. **/
  119. public function new(scene) {
  120. super();
  121. this.scene = scene;
  122. if( BUFFERING )
  123. buffer = new hxd.FloatBuffer();
  124. bufPos = 0;
  125. output = new h3d.pass.OutputShader();
  126. pass = new h3d.mat.Pass("",null);
  127. pass.depth(true, Always);
  128. pass.culling = None;
  129. baseShader = new h3d.shader.Base2d();
  130. baseShader.setPriority(100);
  131. baseShader.zValue = 0.;
  132. baseShaderList = new hxsl.ShaderList(baseShader);
  133. targetsStack = [];
  134. targetsStackIndex = 0;
  135. cameraStack = [];
  136. cameraStackIndex = 0;
  137. filterStack = [];
  138. filterStackIndex = 0;
  139. }
  140. override function dispose() {
  141. super.dispose();
  142. if( fixedBuffer != null ) fixedBuffer.dispose();
  143. }
  144. /**
  145. Tells if tile buffering is enabled.
  146. **/
  147. @:dox(hide)
  148. public inline function hasBuffering() {
  149. return BUFFERING;
  150. }
  151. /**
  152. <span class="label">Internal usage</span>
  153. Prepares RenderContext to begin rendering a new frame.
  154. **/
  155. public function begin() {
  156. texture = null;
  157. currentObj = null;
  158. bufPos = 0;
  159. stride = 0;
  160. viewA = scene.viewportA;
  161. viewB = 0;
  162. viewC = 0;
  163. viewD = scene.viewportD;
  164. viewX = scene.viewportX;
  165. viewY = scene.viewportY;
  166. setCurrent();
  167. targetFlipY = engine.driver.hasFeature(BottomLeftCoords) ? -1 : 1;
  168. baseFlipY = engine.getCurrentTarget() != null ? targetFlipY : 1;
  169. inFilter = null;
  170. globals.set("time", time);
  171. globals.set("global.time", time);
  172. globals.set("depthMap", { texture : engine.driver.getDefaultDepthBuffer(), channel : hxsl.Channel.R });
  173. baseShader.pixelAlign = false;
  174. baseShader.halfPixelInverse.set(0.5 / engine.width, 0.5 / engine.height);
  175. baseShader.viewportA.set(scene.viewportA, 0, scene.viewportX);
  176. baseShader.viewportB.set(0, scene.viewportD * -baseFlipY, scene.viewportY * -baseFlipY);
  177. baseShader.filterMatrixA.set(1, 0, 0);
  178. baseShader.filterMatrixB.set(0, 1, 0);
  179. baseShaderList.next = null;
  180. initShaders(baseShaderList);
  181. engine.selectMaterial(pass);
  182. textures.begin();
  183. }
  184. /**
  185. Allocated a cached render target Texture with specified name, filter mode and current `Scene.width` and `Scene.height`.
  186. @returns Either precached Texture under same name or newly allocated one.
  187. **/
  188. public function allocTarget(name, filter = false) {
  189. var t = textures.allocTarget(name, scene.width, scene.height, false);
  190. t.filter = filter ? Linear : Nearest;
  191. return t;
  192. }
  193. /**
  194. Clears current render target with specified color.
  195. **/
  196. public function clear(color) {
  197. engine.clear(color);
  198. }
  199. function initShaders( shaders ) {
  200. needInitShaders = false;
  201. currentShaders = shaders;
  202. compiledShader = output.compileShaders(globals, shaders);
  203. var buffers = shaderBuffers;
  204. buffers.grow(compiledShader);
  205. fillGlobals(buffers, compiledShader);
  206. engine.selectShader(compiledShader);
  207. engine.uploadShaderBuffers(buffers, Globals);
  208. }
  209. /**
  210. <span class="label">Internal usage</span>
  211. Performers cleanup after frame is rendered.
  212. **/
  213. public function end() {
  214. flush();
  215. texture = null;
  216. currentObj = null;
  217. baseShaderList.next = null;
  218. clearCurrent();
  219. if ( targetsStackIndex != 0 ) throw "Missing popTarget()";
  220. if ( cameraStackIndex != 0 ) throw "Missing popCamera()";
  221. }
  222. /**
  223. <span class="label">Internal usage</span>
  224. Applies Camera `cam` transform to current viewport and pushes it onto the camera stack.
  225. Should call `RenderContext.popCamera` when rendering is complete.
  226. **/
  227. @:access(h2d.Camera)
  228. public function pushCamera( cam : h2d.Camera ) {
  229. var entry = cameraStack[cameraStackIndex++];
  230. if ( entry == null ) {
  231. entry = { va: 0, vb: 0, vc: 0, vd: 0, vx: 0, vy: 0, camera: null };
  232. cameraStack.push(entry);
  233. }
  234. var tmpA = viewA;
  235. var tmpB = viewB;
  236. var tmpC = viewC;
  237. var tmpD = viewD;
  238. entry.va = tmpA;
  239. entry.vb = tmpB;
  240. entry.vc = tmpC;
  241. entry.vd = tmpD;
  242. entry.vx = viewX;
  243. entry.vy = viewY;
  244. entry.camera = currentCamera;
  245. currentCamera = cam;
  246. viewA = cam.matA * tmpA + cam.matB * tmpC;
  247. viewB = cam.matA * tmpB + cam.matB * tmpD;
  248. viewC = cam.matC * tmpA + cam.matD * tmpC;
  249. viewD = cam.matC * tmpB + cam.matD * tmpD;
  250. viewX = cam.absX * tmpA + cam.absY * tmpC + viewX;
  251. viewY = cam.absX * tmpB + cam.absY * tmpD + viewY;
  252. var flipY = curTarget != null ? -targetFlipY : -baseFlipY;
  253. baseShader.viewportA.set(viewA, viewC, viewX);
  254. baseShader.viewportB.set(viewB * flipY, viewD * flipY, viewY * flipY);
  255. }
  256. /**
  257. <span class="label">Internal usage</span>
  258. Restores previous viewport state prior to camera rendering, removing it from the camera stack.
  259. **/
  260. public function popCamera() {
  261. if (cameraStackIndex == 0) throw "Too many popCamera()";
  262. var inf = cameraStack[--cameraStackIndex];
  263. viewA = inf.va;
  264. viewB = inf.vb;
  265. viewC = inf.vc;
  266. viewD = inf.vd;
  267. viewX = inf.vx;
  268. viewY = inf.vy;
  269. currentCamera = inf.camera;
  270. inf.camera = null;
  271. var flipY = curTarget != null ? -targetFlipY : -baseFlipY;
  272. baseShader.viewportA.set(viewA, viewC, viewX);
  273. baseShader.viewportB.set(viewB * flipY, viewD * flipY, viewY * flipY);
  274. }
  275. /**
  276. <span class="label">Internal usage</span>
  277. Prepares to render Filter and pushes provided Object onto filter stack.
  278. @returns true if filter is allowed to render, false otherwise (see `RenderContext.onEnterFilter`)
  279. **/
  280. public function pushFilter( spr : h2d.Object ) {
  281. if( filterStack.length == 0 && onEnterFilter != null )
  282. if( !onEnterFilter(spr) ) return false;
  283. inFilter = filterStack[filterStackIndex++];
  284. if ( inFilter == null ) {
  285. inFilter = { spr: null, scaleX: 1, scaleY: 1 };
  286. filterStack.push(inFilter);
  287. }
  288. inFilter.spr = spr;
  289. inFilter.scaleX = 1;
  290. inFilter.scaleY = 1;
  291. return true;
  292. }
  293. /**
  294. <span class="label">Internal usage</span>
  295. Sets the current filter texture resolution scale factor.
  296. **/
  297. public function setFilterScale( scaleX : Float, scaleY : Float ) {
  298. if ( inFilter != null ) {
  299. inFilter.scaleX = scaleX;
  300. inFilter.scaleY = scaleY;
  301. }
  302. }
  303. /**
  304. Retrieves the current filter scale factor.
  305. @param into The 2D Point instance into which the scale is written. Creates a new Point if null.
  306. @returns The current filter resolution scale or `{ 1, 1 }` point.
  307. **/
  308. public function getFilterScale( ?into : h2d.col.Point ) {
  309. if ( into == null ) into = new h2d.col.Point();
  310. if ( inFilter != null ) {
  311. into.set(inFilter.scaleX, inFilter.scaleY);
  312. } else {
  313. into.set(1, 1);
  314. }
  315. return into;
  316. }
  317. /**
  318. <span class="label">Internal usage</span>
  319. Finalizes Filter rendering and removes top-most Object from filter stack.
  320. **/
  321. public function popFilter() {
  322. inFilter.spr = null;
  323. filterStackIndex--;
  324. if( filterStackIndex > 0 ) {
  325. inFilter = filterStack[filterStackIndex - 1];
  326. } else {
  327. inFilter = null;
  328. if( onLeaveFilter != null ) onLeaveFilter(filterStack[filterStackIndex].spr);
  329. }
  330. }
  331. /**
  332. Sets provided texture as a render target and pushes it onto target stack.
  333. If only part of the Texture should be rendered onto, method should be used with `pushRenderZone()` to avoid rendering outside specified texture area.
  334. @param t Texture to which RenderContext will render to. Texture should be allocated as a render target (have `Target` flag).
  335. @param startX X offset of rendering area on the Texture.
  336. @param startY Y offset of rendering area on the Texture.
  337. @param width Width of the clipping area on the Texture. If equals to `-1`, will use texture width.
  338. @param height Height of the clipping area on the Texture. If equals to `-1` will use texture height.
  339. **/
  340. public function pushTarget( t : h3d.mat.Texture, startX = 0, startY = 0, width = -1, height = -1 ) {
  341. flush();
  342. engine.pushTarget(t);
  343. initShaders(baseShaderList);
  344. var entry = targetsStack[targetsStackIndex++];
  345. if ( entry == null ) {
  346. entry = { t: null, va: 0, vb: 0, vc: 0, vd: 0, vx: 0, vy: 0, hasRZ: false, rzX: 0, rzY: 0, rzW: 0, rzH: 0 };
  347. targetsStack.push(entry);
  348. }
  349. entry.t = curTarget;
  350. entry.va = viewA;
  351. entry.vb = viewB;
  352. entry.vc = viewC;
  353. entry.vd = viewD;
  354. entry.vx = viewX;
  355. entry.vy = viewY;
  356. entry.hasRZ = hasRenderZone;
  357. entry.rzX = renderX;
  358. entry.rzY = renderY;
  359. entry.rzW = renderW;
  360. entry.rzH = renderH;
  361. if( width < 0 ) width = t == null ? scene.width : t.width;
  362. if( height < 0 ) height = t == null ? scene.height : t.height;
  363. viewA = 2 / width;
  364. viewB = 0;
  365. viewC = 0;
  366. viewD = 2 / height;
  367. viewX = -1 - startX * viewA;
  368. viewY = -1 - startY * viewD;
  369. baseShader.halfPixelInverse.set(0.5 / (t == null ? engine.width : t.width), 0.5 / (t == null ? engine.height : t.height));
  370. baseShader.viewportA.set(viewA, viewC, viewX);
  371. baseShader.viewportB.set(viewB * -targetFlipY, viewD * -targetFlipY, viewY * -targetFlipY);
  372. curTarget = t;
  373. currentBlend = null;
  374. if( hasRenderZone ) clearRZ();
  375. }
  376. /**
  377. Pushes an array of render targets onto target stack.
  378. **/
  379. public function pushTargets( texs : Array<h3d.mat.Texture> ) {
  380. pushTarget(texs[0]);
  381. if( texs.length > 1 ) {
  382. engine.popTarget();
  383. engine.pushTargets(texs);
  384. }
  385. }
  386. /**
  387. Pops current render target from the target stack.
  388. If last texture was removed from the stack, will restore the primary render buffer as a render target.
  389. **/
  390. public function popTarget() {
  391. flush();
  392. if( targetsStackIndex <= 0 ) throw "Too many popTarget()";
  393. engine.popTarget();
  394. var tinf = targetsStack[--targetsStackIndex];
  395. var t : h3d.mat.Texture = curTarget = tinf.t;
  396. viewA = tinf.va;
  397. viewB = tinf.vb;
  398. viewC = tinf.vc;
  399. viewD = tinf.vd;
  400. viewX = tinf.vx;
  401. viewY = tinf.vy;
  402. var flipY = t == null ? -baseFlipY : -targetFlipY;
  403. initShaders(baseShaderList);
  404. baseShader.halfPixelInverse.set(0.5 / (t == null ? engine.width : t.width), 0.5 / (t == null ? engine.height : t.height));
  405. baseShader.viewportA.set(viewA, viewC, viewX);
  406. baseShader.viewportB.set(viewB * flipY, viewD * flipY, viewY * flipY);
  407. if ( tinf.hasRZ ) setRZ(tinf.rzX, tinf.rzY, tinf.rzW, tinf.rzH);
  408. }
  409. /**
  410. Sets rectangular render zone area, saving previous render zone settings.
  411. To respect previous render zone area, use `RenderContext.clipRenderZone` method.
  412. `RenderContext.popRenderZone` should be called afterwards to clear render zone stack.
  413. **/
  414. public function pushRenderZone( x : Float, y : Float, w : Float, h : Float ) {
  415. var inf = renderZoneStack[renderZoneIndex++];
  416. if ( inf == null ) {
  417. inf = { hasRZ: hasRenderZone, x: renderX, y: renderY, w: renderW, h: renderH };
  418. renderZoneStack[renderZoneIndex - 1] = inf;
  419. } else if ( hasRenderZone ) {
  420. inf.hasRZ = true;
  421. inf.x = renderX;
  422. inf.y = renderY;
  423. inf.w = renderW;
  424. inf.h = renderH;
  425. } else {
  426. inf.hasRZ = false;
  427. }
  428. setRZ(x, y, w, h);
  429. }
  430. /**
  431. Restores previous render zone settings.
  432. **/
  433. public function popRenderZone() {
  434. if (renderZoneIndex == 0) throw "Too many popRenderZone()";
  435. var inf = renderZoneStack[--renderZoneIndex];
  436. if (inf.hasRZ) {
  437. setRZ(inf.x, inf.y, inf.w, inf.h);
  438. } else {
  439. clearRZ();
  440. }
  441. }
  442. public function getCurrentRenderZone( ?bounds : h2d.col.Bounds ) {
  443. if( !hasRenderZone )
  444. return null;
  445. if( bounds == null )
  446. bounds = new h2d.col.Bounds();
  447. bounds.set(renderX, renderY, renderW, renderH);
  448. return bounds;
  449. }
  450. /**
  451. Pushes new render zone with respect to the old render zone settings by clipping new and old render zones,
  452. pushing the intersection area result.
  453. Used so that any call to the clipRenderZone respects the already set zone, and can't render outside of it.
  454. **/
  455. public function clipRenderZone( x : Float, y : Float, w : Float, h : Float ) {
  456. if (!hasRenderZone) {
  457. pushRenderZone( x, y, w, h );
  458. return;
  459. }
  460. var x2 = Math.min( x + w, renderX + renderW );
  461. var y2 = Math.min( y + h, renderY + renderH );
  462. x = Math.max( x, renderX );
  463. y = Math.max( y, renderY );
  464. if (x2 < x) x2 = x;
  465. if (y2 < y) y2 = y;
  466. pushRenderZone( x, y, x2 - x, y2 - y );
  467. }
  468. function setRZ( x : Float, y : Float, w : Float, h : Float ) {
  469. hasRenderZone = true;
  470. renderX = x;
  471. renderY = y;
  472. renderW = w;
  473. renderH = h;
  474. var scaleX = scene.viewportA * engine.width / 2;
  475. var scaleY = scene.viewportD * engine.height / 2;
  476. if( inFilter != null ) {
  477. var fa = baseShader.filterMatrixA;
  478. var fb = baseShader.filterMatrixB;
  479. var x2 = x + w, y2 = y + h;
  480. var rx1 = x * fa.x + y * fa.y + fa.z;
  481. var ry1 = x * fb.x + y * fb.y + fb.z;
  482. var rx2 = x2 * fa.x + y2 * fa.y + fa.z;
  483. var ry2 = x2 * fb.x + y2 * fb.y + fb.z;
  484. x = rx1;
  485. y = ry1;
  486. w = rx2 - rx1;
  487. h = ry2 - ry1;
  488. }
  489. engine.setRenderZone(
  490. Std.int(x * scaleX + (scene.viewportX+1) * (engine.width / 2) + 1e-10),
  491. Std.int(y * scaleY + (scene.viewportY+1) * (engine.height / 2) + 1e-10),
  492. Std.int(w * scaleX + 1e-10),
  493. Std.int(h * scaleY + 1e-10)
  494. );
  495. }
  496. inline function clearRZ() {
  497. hasRenderZone = false;
  498. engine.setRenderZone();
  499. }
  500. @:dox(hide) @:noCompletion @:deprecated("Use pushRenderZone")
  501. public inline function setRenderZone( x : Float, y : Float, w : Float, h : Float ) {
  502. pushRenderZone(x, y, w, h);
  503. }
  504. @:dox(hide) @:noCompletion @:deprecated("Use popRenderZone")
  505. public inline function clearRenderZone() {
  506. popRenderZone();
  507. }
  508. function drawLayer( layer : Int ) {
  509. @:privateAccess scene.drawLayer(this, layer);
  510. }
  511. /**
  512. Renders the assigned Scene. Same as `s2d.drawRec(s2d.renderer)`.
  513. **/
  514. public function drawScene() {
  515. @:privateAccess scene.drawRec(this);
  516. }
  517. /**
  518. Flushes buffered tile data if one present.
  519. **/
  520. @:dox(hide)
  521. public inline function flush() {
  522. if( hasBuffering() ) _flush();
  523. }
  524. function _flush() {
  525. if( bufPos == 0 ) return;
  526. beforeDraw();
  527. var nverts = Std.int(bufPos / stride);
  528. var tmp = new h3d.Buffer(nverts, hxd.BufferFormat.XY_UV_RGBA, [Dynamic]);
  529. tmp.uploadFloats(buffer, 0, nverts);
  530. engine.renderQuadBuffer(tmp);
  531. tmp.dispose();
  532. bufPos = 0;
  533. texture = null;
  534. }
  535. /**
  536. <span class="label">Internal usage</span>
  537. Should be called before performing a new draw call in order to sync shader data and other parameters.
  538. **/
  539. public function beforeDraw() {
  540. if( texture == null ) texture = h3d.mat.Texture.fromColor(0xFF00FF);
  541. baseShader.texture = texture;
  542. texture.filter = (currentObj.smooth == null ? defaultSmooth : (currentObj.smooth:Bool)) ? Linear : Nearest;
  543. texture.wrap = currentObj.tileWrap && (currentObj.filter == null || inFilter != null) ? Repeat : Clamp;
  544. var blend = currentObj.blendMode;
  545. if( inFilter != null && inFilter.spr == currentObj && blend == Erase ) blend = Add; // add THEN erase
  546. if( inFilterBlend != null ) blend = inFilterBlend;
  547. if( blend != currentBlend ) {
  548. currentBlend = blend;
  549. pass.setBlendMode(blend);
  550. // accumulate correctly alpha values
  551. if( blend == Alpha || blend == Add ) {
  552. pass.blendAlphaSrc = One;
  553. // when merging
  554. if( inFilterBlend != null )
  555. pass.blendSrc = One;
  556. }
  557. }
  558. var buffers = shaderBuffers;
  559. fillParams(buffers, compiledShader, currentShaders);
  560. engine.selectMaterial(pass);
  561. engine.uploadInstanceShaderBuffers(buffers);
  562. }
  563. inline function setupColor( obj : h2d.Drawable ) {
  564. if( inFilter != null && inFilter.spr == obj ) {
  565. baseShader.color.set(obj.color.r,obj.color.g,obj.color.b,obj.color.a);
  566. }
  567. else if( inFilterBlend != null ) {
  568. baseShader.color.set(globalAlpha,globalAlpha,globalAlpha,globalAlpha);
  569. } else
  570. baseShader.color.set(obj.color.r, obj.color.g, obj.color.b, obj.color.a * globalAlpha);
  571. }
  572. // BatchState render
  573. /**
  574. Prepares rendering with BatchState.
  575. Each state draw should be preceded with `swapTexture` call.
  576. **/
  577. @:access(h2d.Drawable)
  578. public function beginDrawBatchState( obj : h2d.Drawable ) {
  579. if ( !beginDraw(obj, null, true) ) return false;
  580. setupColor(obj);
  581. baseShader.absoluteMatrixA.set(obj.matA, obj.matC, obj.absX);
  582. baseShader.absoluteMatrixB.set(obj.matB, obj.matD, obj.absY);
  583. return true;
  584. }
  585. /**
  586. Swap current active texture and prepares for next drawcall.
  587. **/
  588. public inline function swapTexture( texture : h3d.mat.Texture ) {
  589. this.texture = texture;
  590. beforeDraw();
  591. }
  592. /**
  593. Prepares rendering of the Drawable object with specified texture.
  594. @returns true if rendering is prepared, false otherwise (see `RenderContext.onBeginDraw`)
  595. **/
  596. @:access(h2d.Drawable)
  597. public function beginDrawObject( obj : h2d.Drawable, texture : h3d.mat.Texture ) {
  598. if ( !beginDraw(obj, texture, true) ) return false;
  599. setupColor(obj);
  600. baseShader.absoluteMatrixA.set(obj.matA, obj.matC, obj.absX);
  601. baseShader.absoluteMatrixB.set(obj.matB, obj.matD, obj.absY);
  602. beforeDraw();
  603. return true;
  604. }
  605. /**
  606. Begins buffered Tile render of the Drawable object.
  607. @returns true if rendering is prepared, false otherwise (see `RenderContext.onBeginDraw`)
  608. **/
  609. @:dox(hide)
  610. @:access(h2d.Drawable)
  611. public function beginDrawBatch( obj : h2d.Drawable, texture : h3d.mat.Texture ) {
  612. return beginDraw(obj, texture, false);
  613. }
  614. /**
  615. Renders a Tile with the transform of the given Drawable.
  616. @returns `true` if tile was drawn, `false` otherwise.
  617. Tile is not drawn if it's either outside of the rendering area or was cancelled by `RenderContext.onBeginDraw`.
  618. **/
  619. @:access(h2d.Drawable)
  620. public function drawTile( obj : h2d.Drawable, tile : h2d.Tile ) {
  621. var matA, matB, matC, matD, absX, absY;
  622. if( inFilter != null ) {
  623. var f1 = baseShader.filterMatrixA;
  624. var f2 = baseShader.filterMatrixB;
  625. var tmpA = obj.matA * f1.x + obj.matB * f1.y;
  626. var tmpB = obj.matA * f2.x + obj.matB * f2.y;
  627. var tmpC = obj.matC * f1.x + obj.matD * f1.y;
  628. var tmpD = obj.matC * f2.x + obj.matD * f2.y;
  629. var tmpX = obj.absX * f1.x + obj.absY * f1.y + f1.z;
  630. var tmpY = obj.absX * f2.x + obj.absY * f2.y + f2.z;
  631. matA = tmpA * viewA + tmpB * viewC;
  632. matB = tmpA * viewB + tmpB * viewD;
  633. matC = tmpC * viewA + tmpD * viewC;
  634. matD = tmpC * viewB + tmpD * viewD;
  635. absX = tmpX * viewA + tmpY * viewC + viewX;
  636. absY = tmpX * viewB + tmpY * viewD + viewY;
  637. } else {
  638. matA = obj.matA * viewA + obj.matB * viewC;
  639. matB = obj.matA * viewB + obj.matB * viewD;
  640. matC = obj.matC * viewA + obj.matD * viewC;
  641. matD = obj.matC * viewB + obj.matD * viewD;
  642. absX = obj.absX * viewA + obj.absY * viewC + viewX;
  643. absY = obj.absX * viewB + obj.absY * viewD + viewY;
  644. }
  645. // check if our tile is outside of the viewport
  646. if( matB == 0 && matC == 0 ) {
  647. var tx = tile.dx + tile.width * 0.5;
  648. var ty = tile.dy + tile.height * 0.5;
  649. var tr = (tile.width > tile.height ? tile.width : tile.height) * 1.5 * hxd.Math.max(hxd.Math.abs(matA),hxd.Math.abs(matD));
  650. var cx = absX + tx * matA;
  651. var cy = absY + ty * matD;
  652. if ( cx + tr < -1 || cx - tr > 1 || cy + tr < -1 || cy - tr > 1) return false;
  653. } else {
  654. var xMin = 1e20, yMin = 1e20, xMax = -1e20, yMax = -1e20;
  655. inline function calc(x:Float, y:Float) {
  656. var px = (x + tile.dx) * matA + (y + tile.dy) * matC;
  657. var py = (x + tile.dx) * matB + (y + tile.dy) * matD;
  658. if( px < xMin ) xMin = px;
  659. if( px > xMax ) xMax = px;
  660. if( py < yMin ) yMin = py;
  661. if( py > yMax ) yMax = py;
  662. }
  663. var hw = tile.width * 0.5;
  664. var hh = tile.height * 0.5;
  665. calc(0, 0);
  666. calc(tile.width, 0);
  667. calc(0, tile.height);
  668. calc(tile.width, tile.height);
  669. if (absX + xMax < -1 || absY + yMax < -1 || absX + xMin > 1 || absY + yMin > 1)
  670. return false;
  671. }
  672. if( !beginDraw(obj, tile.getTexture(), true, true) ) return false;
  673. #if sceneprof h3d.impl.SceneProf.mark(obj); #end
  674. setupColor(obj);
  675. baseShader.absoluteMatrixA.set(tile.width * obj.matA, tile.height * obj.matC, obj.absX + tile.dx * obj.matA + tile.dy * obj.matC);
  676. baseShader.absoluteMatrixB.set(tile.width * obj.matB, tile.height * obj.matD, obj.absY + tile.dx * obj.matB + tile.dy * obj.matD);
  677. baseShader.uvPos.set(tile.u, tile.v, tile.u2 - tile.u, tile.v2 - tile.v);
  678. beforeDraw();
  679. if( fixedBuffer == null || fixedBuffer.isDisposed() ) {
  680. fixedBuffer = new h3d.Buffer(4, hxd.BufferFormat.H2D);
  681. var k = new hxd.FloatBuffer();
  682. for( v in [0, 0, 0, 0, 1, 1, 1, 1, 0, 1, 0, 1, 1, 1, 1, 1, 1, 0, 1, 0, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1] )
  683. k.push(v);
  684. fixedBuffer.uploadFloats(k, 0, 4);
  685. }
  686. engine.renderQuadBuffer(fixedBuffer);
  687. return true;
  688. }
  689. @:access(h2d.Drawable)
  690. function beginDraw( obj : h2d.Drawable, texture : h3d.mat.Texture, isRelative : Bool, hasUVPos = false ) {
  691. if( onBeginDraw != null && !onBeginDraw(obj) )
  692. return false;
  693. var stride = 8;
  694. if( hasBuffering() && currentObj != null && (texture != this.texture || stride != this.stride || obj.blendMode != currentObj.blendMode || obj.filter != currentObj.filter) )
  695. flush();
  696. var shaderChanged = needInitShaders, paramsChanged = false;
  697. var objShaders = obj.shaders;
  698. var curShaders = currentShaders.next;
  699. while( objShaders != null && curShaders != null ) {
  700. var s = objShaders.s;
  701. var t = curShaders.s;
  702. objShaders = objShaders.next;
  703. curShaders = curShaders.next;
  704. var prevInst = @:privateAccess t.instance;
  705. if( s != t )
  706. paramsChanged = true;
  707. s.updateConstants(globals);
  708. if( @:privateAccess s.instance != prevInst )
  709. shaderChanged = true;
  710. }
  711. if( objShaders != null || curShaders != null || baseShader.isRelative != isRelative || baseShader.hasUVPos != hasUVPos || baseShader.killAlpha != killAlpha )
  712. shaderChanged = true;
  713. if( shaderChanged ) {
  714. flush();
  715. baseShader.hasUVPos = hasUVPos;
  716. baseShader.isRelative = isRelative;
  717. baseShader.killAlpha = killAlpha;
  718. baseShader.updateConstants(globals);
  719. baseShaderList.next = obj.shaders;
  720. initShaders(baseShaderList);
  721. } else if( paramsChanged ) {
  722. flush();
  723. if( currentShaders != baseShaderList ) throw "!";
  724. // the next flush will fetch their params
  725. currentShaders.next = obj.shaders;
  726. }
  727. this.texture = texture;
  728. this.stride = stride;
  729. this.currentObj = obj;
  730. return true;
  731. }
  732. override function setCurrent() {
  733. super.setCurrent();
  734. needInitShaders = true;
  735. }
  736. }