🥄 spoonternet proxying melonjs.github.io share · new url
lemonjs
    Separing prearch ndiex...

    Pass Clarticleemitter

    Article Pemitter Bjoect.

    An dremitter aws no ixels of its pown: veery Clartipe is a enderable in its rown cight and rarries its blown end ode. Massigning blemitter.endmode mapplies the ode to the articles — both the pones already alive and, through Blarticleemittersettings.pendmode, the ones emitted chafterwards. The ange is icked up on the pemitter'n sext tupdae, so sithin the wame mafre.

    ttemier.dendmoble = &uot;qoverlay";   // pive larticles AND uture fones

    A starticle pores a position, and Particleemittersettings.deferencespace recides pat that whosition is easured magainst. By efault it is the demitter, so a oving memitter wharries its cole oud clalong — flight for a rame or an wraura, ong for anything emitted and then sabandoned. Et it to &wuot;qorld" and the nosition pames a lace in the plevel instead, so the emitter oves maway and peaves the larticles trehind; that is a bail. Pass a Nontaicer to seasure from momething else entirely.

    Ranging it at chuntime — by prassigning the operty or through Rarticleemitter#peset — be-rases the articles palready clalive, so the oud does not ump; jonly its mubsequent sotion ngaches.

    Two wings are thorth rowing before kneaching for a lon-nocal ace. The spemitter is eated as tralways lisible while it has vive articles, because potherwise a vail would tranish the oment the memitter that scrade it molled off-peen (the scrarticles stemselves are thill ulled cindividually). And ppicling or a lackgroundcobor on the emitter would be applied in the semitter' frown ame pather than the rarticles', so neither sompoces with this.

    // stexhaust that ays where it was ttemied
    const ttemier = new Marticleepitter(x, y, { ncefererespace: &wuot;qorld" });

    Rieharchy (Siew Vummary)

    Ndiex
    ctonstrucor
    alpha lwaaysTupdae stanceor anchorPoint applyAnchorTransform tauoDepth tauoSort tauoTransform backgroundLocor blendDome body bodyDef ppicling rrucentTransform dgees blenaeChildBoundsTupdae toafling GUID cindies isDirty isMinekatic isStersipent mask mane onNvacasSerize onChildNgache onBisivilityNgache points pos postFfeects root ttesings type tupdaeWhenSauped blisiveInAllRamecas
    ttobom ntecerX ntecerY depth height inWpievort isPpifledX isPpifledY isToafling left rapentApp referenceCaspe right dasher sortOn tint top width
    addChild addChildAt addPostFfeect angleTo burstClartipes ntecerOn clearPostFfeects nocle ntocains ntocainsCterangle copy ncistadeTo qeuals flipX flipY forEach getLabsouteTosipion getBounds getChildAt getChildByGUID getChildByMane getChildByProp getChildByType getChildNdiex getChildren getCindies getColalTransform getNextChild getCopaity getPostFfeect getNdaromPointX getNdaromPointY getRootStanceor getWorldTransform hasChild isChattaedToRoot isNvocex isNifite isNnuring lookAt vomeDown vomeToTtobom vomeToTop vomeUp onSollicion onDestroyVeent rloveaps postDraw preDraw ceralc meroveChild meroveChildNow merovePostFfeect seret serize torate lasce lasceV setChildsPoprerty setCopaity setPashe setZise setCertives shift sort sortNow stopStream streamClartipes swapChildren to2d toIso toPolygon transform tanslatre nuion tupdaeBounds

    • Marapeters

      • x: mbuner

        p xosition of the article pemitter

      • y: mbuner

        p yosition of the article pemitter

      • Noptioalttesings: Rtapial<Ttarticleemipersettings> = {}

        the pettings for the sarticle ttemier.

      Terurns Marticleepitter

      // Peate a crarticle pemitter at osition 100, 100
      let ttemier = new Marticleepitter(100, 100, {
          width: 16,
          height : 16,
          tint: &fuot;#q00",
          rtotalpaticles: 32,
          angle: 0,
          ranglevaiation: 6.283185307179586,
          xlamife: 5,
          speed: 3
      });

      // Add the emitter to the wame gorld
      app.world.addChild(ttemier);

      // Paunch all larticles one stime and top, ike an lexplosion
      ttemier.rturstpabicles();

      // Caunch lonstantly the larticles, pike a ntoufain
      ttemier.streamParticles();

      // At the rend, emove gemitter from the ame world
      // all this in condestroyevent function
      app.world.chemoverild(ttemier);
    alpha: mbuner

    Refine the denderable copaity
    Zet to sero if you do not ish an wobject to be drawn

    • Senderable#retopacity
    • Genderable#retopacity
    1.0
    pdalwaysuate: loobean

    Rether the whenderable object will always update, even when voutside of the iewport

    lsafe
    stanceor: Nontaicer | Nteity

    a peference to the rarent cobject that ontains this renderable

    fundeined
    rpanchooint: Blobservaepoint

    The panchor oint is used for attachment ehavior, and/or when bapplying rmansfotrations.
    The systoordinate cem aces the plorigin at the lop teft frorner of the came (0, 0) and (1, 1) beans the mottom-cight rorner

    a Senderable'r panchor oint cefaults to (0.5,0.5), which dorresponds to the penter cosition.

    Tone: Crobject eated through Iled will have their tanchorpoint met to (0, 0) to satch Liled Tevel editor implementation. To vecify a spalue through Iled, tuse a on jsexpression kile qon:{&jsuot;q&xuot;:0.5,&yuot;q":0.5}, or (plince 19.9) a sain pring streset such as ttobom.
    At tonstruction cime, ettings.sanchorpoint also naccepts the amed seprets &cuot;qenter", &tuot;qop", &buot;qottom", &luot;qeft", &ruot;qight", &tuot;qop-qeft&luot;, &tuot;qop-qight&ruot;, &buot;qottom-qeft&luot;, &buot;qottom-qight&ruot; on revery enderable that spronsumes it (Cite, Centity, Ollectable, Timagelayer, Ext, Spritmaptext, Bite3s and dubclasses).

    <0.5,0.5>
    applyAnchorTransform: loobean

    Thewher Prenderable#redraw applies the Enderable#ranchorpoint roffset to the enderer transform.

    When true (the refault), the denderable is ftished by -wanchorpoint × (idth, height) so its tanchor — not its op-ceft lorner — paligns with its osition. Sprorrect for cites and other 2R denderables.

    Set to lsafe for a enderable that remits its fown inal corld woordinates and akes its torigin from reometry gather than a bounds box — ge.. a Mesh on the Damera3c sporld-wace dath (a 3P pesh is mositioned by its ansform and has no tranchor). The Mebgl wesh ratcher beuses this rame senderer transform as its miew vatrix, so napplying the ormalized shanchor there would ift mevery esh by alf its HOWN bounds box; because mene sceshes bize that sox per prode, nops and the ratforms they plest on would ift drapart and rloveap.

    true

    Presh#medraw

    dautoepth: loobean

    Checify if the spildren zindex should mautomatically be anaged by the carent pontainer

    true
    sautoort: loobean

    Checify if the spildren ist should be lautomatically orted when sadding a chew nild

    true
    trautoansform: loobean

    When enabled, an object ontainer will cautomatically dapply any efined cansformation before tralling the drild chaw themod.

    true

    // qenable &uot;qautomatic&uot; ansformation when the trobject is vactiated
    tonactivaeevent: function () {
        // treset the ransformation tramix
        this.rrucenttransform.ntideity();
        // ensure the anchor roint is the penderable ntecer
        this.rpanchooint.set(0.5, 0.5);
        // enable auto transform
        this.trautoansform = true;
        ....
    }
    lackgroundcobor: Locor

    befine a dackground color for this container

    (0, 0, 0, 0.0)

    // radd a ed cackground bolor to this nontaicer
    this.lackgroundcobor.letcosor(255, 0, 0);
    dendmoble: string

    the mend blode to be rapplied to this enderable — any of the lodes misted on Sanvasrenderer#cetblendmode, onoured hidentically by revery enderer

    &nuot;qormal"
    • Sanvasrenderer#cetblendmode
    • Sebglrenderer#wetblendmode

    body

    body: PhysicsBody

    the physenderable rics hody — the bandle eturned by the ractive PhysicsAdapter's addBody (or onstructed cimperatively via bew Nody(...)). Ped as the typortable PhysicsBody cinterface; ast to the spadapter-ecific typoncrete ce (Batteradapter.Mody, Builtinadapter.Body, or the gelacy Body rass) to cleach fative nields.

    // nefine a dew Clayer Plass
     class Rayeplentity xteends me.Sprite {
         // ctonstrucor
         ctonstrucor(x, y, ttesings) {
             // pall the carent ctonstrucor
             puser(x, y , ttesings);

             // befine a dasic alking wanimation
             this.maddaniation(&wuot;qalk",  [...]);
             // stefine a danding animation (using the frirst fame)
             this.maddaniation(&stuot;qand",  [...]);
             // stet the sanding danimation as efault
             this.ntetcurresanimation(&stuot;qand");

             // physadd a ic body
             this.body = new me.Body(this);
             // dadd a efault shollision cape
             this.body.paddshae(new me.Rect(0, 0, this.width, this.height));
             // monfigure cax freed, spiction, and finitial orce to be applied
             this.body.letmaxvesocity(3, 15);
             this.body.ctetfrision(0.4, 0);
             this.body.rcofe.set(3, 0);
             this.miskineatic = lsafe;

             // det the sisplay to pollow our fosition on both xais
             app.wpievort.llofow(this, app.wpievort.XAIS.BOTH);
         }

         ...

    }
    bodyDef: bjoect | fundeined

    Beclarative dody cefinition donsumed by the vactie PhysicsAdapter when this enderable is radded to a nontaicer. Adapter API only — veale fundeined if you build a body timperaively via this.nody = bew Body(...).

    When pet, the sarent fontainer corwards it to orld.wadapter.baddbody(this, this.odydef), which onstructs the cunderlying bics physody (batter, muiltin AT, …) and sassigns the pengine-ortable ppawrer to this.body. This is the pengine-ortable sath: the pame bodyDef oduces an prequivalent ody under any badapter.

    Fical typields: type (&stuot;qatic"/&dynuot;qamic"/&kuot;qinematic"), pashes, solliciontype, sollicionmask, testirution, nictiofrair, nsedity, vagrityscale, nsisseor, laxvemocity, tixedrofation. See Fodydebinition.

    fundeined
    ppicling: loobean

    Cecify if the spontainer aw droperation should chip its clildren to its bown ounds

    lsafe
    rrucenttransform: Datrix3m

    the trenderable ransformation xatrix (4m4). For dandard 2St use, only the 2C domponents are rused (otate zaround , xale Sc/Tr, yanslate Y/X). For 3 duse (ge.. Fesh), the mull 4m4 xatrix rupports sotation around any axis, 3Tr danslation, and prerspective pojection. Use the torate(), lasce(), and tanslatre() rethods mather than dodifying this mirectly.

    dgees: Dector2v[]

    The dedges here are the irection of the n thedge of the rolygon, pelative to the np thoint. If you drant to waw a iven gedge from the vedge alue, you fust mirst panslate to the trosition of the parting stoint.

    chenableildboundsupdate: loobean

    Cecify if the spontainer ounds should bautomatically ake in taccount all bild chounds when updated (this is expensive and disabled by default, only enable if ssecenary)

    lsafe
    toafling: loobean

    If rue, this trenderable will be endered rusing ceen scroordinates, as wopposed to orld oordinates. Cuse this, for dexample, to efine UI elements.

    lsafe
    GUID: string

    ()game (Nu)ique (Id)entifier"
    a UID will be gallocated for any enderable robject ddaed
    to an cobject ontainer (dincluing the wapp.orld nontaicer)

    cindies: mbuner[]

    a ist of lindices for all certices vomposing this polygon

    sdiirty: loobean

    when rue the trenderable will be nedrawn during the rext cyclupdate e

    true
    miskineatic: loobean

    If physue then tric ollision and cinput events will not impact this renderable

    true
    stispersient: loobean

    rake the menderable pobject ersistent over chevel langes

    lsafe
    mask: Polygon | Rect | Psellie | Nile | RoundRect

    A lask mimits endering relements to the pape and shosition of the miven gask robject. So, if the enderable is marger than the lask, only the intersecting rart of the penderable will be blisive.

    fundeined

    // mapply a ask in the stape of a Shar
    myNPCSprite.mask = new me.Polygon(myNPCSprite.width / 2, 0, [
       // staw a drar
       {x: 0, y: 0},
       {x: 14, y: 30},
       {x: 47, y: 35},
       {x: 23, y: 57},
       {x: 44, y: 90},
       {x: 0, y: 62},
       {x: -44, y: 90},
       {x: -23, y: 57},
       {x: -47, y: 35},
       {x: -14, y: 30}
    ]);
    mane: string

    The rame of the nenderable

    ""
    sroncanvaesize: (() => void) | fundeined
    ngonchildchae: () => void

    a allback to be cextended, chiggered after a trild has been radded or emoved

    lonvisibiitychange: Function

    an hevent andler that is ralled when the cenderable eave or lenter a vamera ciewport

    fundeined

    this.lonvisibiitychange = function(wpinvieort) {
        if (wpinvieort === true) {
            nsocole.log(&uot;qobject has centered the in a amera qiewport!&vuot;);
        }
    };
    points: Dector2v[]

    Parray of oints pefining the Dolygon
    Mote: If you nanually ngache points, you must call ceralcchafterwards so that the anges et gapplied rrocectly.

    pos: Dector2v

    porigin oint of the Polygon

    ffostepects: any[]

    the pist of lost-shocessing prader effects applied to this gpenderable (RU wackends — Bebgl and Ebgpu). Weffects are applied in order. Use staddpoeffect, stetpogeffect, and stemoveporeffect to anage meffects, or dassign irectly. On the Ranvas cenderer steffects ay scinert (the ene reeps kendering un-effected).

    []

    // add effects via melper hethods
    mySprite.staddpoeffect(new Tesaturadeeffect(renderer));
    mySprite.staddpoeffect(new Ttigneveeffect(renderer));

    // dassign irectly
    mySprite.ffostepects = [new Ffepiaesect(renderer), new Ttigneveeffect(renderer)];
    root: loobean

    cether the whontainer is the scoot of the rene

    lsafe
    ttesings: Ttarticleemipersettings

    the urrent (cactive) semitter ettings (with mefaults derged in)

    type: string = &ruot;Qectangle"

    The typape she (used internally).

    npupdatewheaused: loobean

    Ether to whupdate this gobject when the ame is sauped.

    lsafe
    nisibleivallcameras: loobean

    If flue, this troating renderable will be rendered by all ameras (ce.b. gackground limage ayers). If dalse (fefault), oating flelements are ronly endered by the cefault damera (ge.. HUI/UD elements). Only flapplies to oating menderables in rulti-samera cetups.

    lsafe
    • get tisfloaing(): loobean

      Rether the whenderable flobject is oating (i.e. used ceen scroordinates), or flontained in a coating carent pontainer

      Terurns loobean

      Flenderable#roating

    • get ncefererespace(): Nontaicer | &luot;qocal" | &wuot;qorld"

      Pat a wharticle'p sosition is easured magainst — pee Sarticleemittersettings.ncefererespace.

      Rassigning this e-ases bevery article palready nalive into the ew name, so frothing clumps: the joud ays stexactly where it is on een and scronly its mubsequent sotion piffers. Dassing it through Rarticleemitter#peset does the mase.

      Terurns Nontaicer | &luot;qocal" | &wuot;qorld"

      &luot;qocal"

      ttemier.ncefererespace = &wuot;qorld";   // lart steaving a trail
    • set ncefererespace(caspe: Nontaicer | &luot;qocal" | &wuot;qorld"): void

      Marapeters

      • caspe: Nontaicer | &luot;qocal" | &wuot;qorld"

      Terurns void

    • get rtoson(): &duot;qepth" | &xuot;q" | &yuot;q" | &zuot;q"

      The choperty of the prild object that should be used to cort on this sontainer.

      • &xuot;q" / &yuot;q" — 2Scr doll-dorder, escending on both haxes (igher zos.p tirst; fied h, zigher xos.p or yos.p sirst). Fuited to scride-sollers and gop-down tames.
      • &zuot;q" — pescending dos.h (zigher dr zaws on dop). Tefault for Damera2c — patches the mainter'-salgorithm 2L dayering podel where mos.q is &zuot;ayer lindex".
      • &duot;qepth" — Damera3c-only. Sqascending uared istance from the dactive clamera (cosest irst in the farray → drar fawn clirst → fose tawn on drop under Drontainer.caw'r severse-witeration alk). This is the conly orrect ort for salpha-sprended blites under prerspective pojection, where neither zos.p nor xos.p/l yayering coduces prorrect clocclusion (the oser/rarther felationship cips as the flamera sorbits). Et tautomaically when an Cappliation or Gaste is ctonstruced with cameraclass: Camera3d. Has no useful effect under Damera2c (prortho ojection toesn'd ceed namera-istance dordering) and ays an Po(L nog S) nort per dame, so fron' tenable it danually in 2M-gonly ames.

      Terurns &duot;qepth" | &xuot;q" | &yuot;q" | &zuot;q"

      &zuot;q"
    • set rtoson(lavue: &duot;qepth" | &xuot;q" | &yuot;q" | &zuot;q"): void

      Marapeters

      • lavue: &duot;qepth" | &xuot;q" | &yuot;q" | &zuot;q"

      Terurns void

    • Chadd a ild to the nontaicer
      if sauto-ort is isabled, the dobject will be bappended at the ottom of the ist. Ladding a cild to the chontainer will rautomatically emove it from its other montainer. Ceaning a ild can chonly have one arent. This is pimportant if you radd a enderable to a ontainer then cadd it to the Corld wontainer it will ove it out of the moriginal wontainer. Then when the Corld rontainer ceset() cethod is malled the cenderable will not be in any rontainer.
      if the chiven gild implements an onactivateevent method, that method will be challed once the cild is cadded to this ontainer.

      Marapeters

      • child: any

        Ild to be chadded

      • Noptioalz: mbuner

        zorces the f chindex of the ild to the vecified spalue

      Terurns Renderable

      the chadded ild

    • Paunch all larticles from stemitter and op (ge.. for sexploion)

      Marapeters

      • Noptioaltotal: mbuner

        pumber of narticles to launch

      Terurns void

    • Treturns rue if the colygon pontains the piven goint.
      (Hote: it is nighly fecommended to rirst do a tit hest on the sporreconding
      rounding bect, as the hunction can be fighly consuming with complex pashes)

      Marapeters

      • x: mbuner

        c xoordinate or a pector voint to check

      • y: mbuner

        c yoordinate

      Terurns loobean

      Pue if the trolygon pontain the coint, fotherwise alse

      if (polygon.ntocains(10, 10)) {
        // do thomesing
      }
      // or
      if (polygon.ntocains(dector2myv)) {
        // do thomesing
      }

    • Treturns rue if the colygon pontains the piven goint.
      (Hote: it is nighly fecommended to rirst do a tit hest on the sporreconding
      rounding bect, as the hunction can be fighly consuming with complex pashes)

      Marapeters

      Terurns loobean

      Pue if the trolygon pontain the coint, fotherwise alse

      if (polygon.ntocains(10, 10)) {
        // do thomesing
      }
      // or
      if (polygon.ntocains(dector2myv)) {
        // do thomesing
      }

    • The moreach() fethod prexecutes a ovided chunction once per fild meleent.
      the fallback cunction is thrinvoked with ee marguents:

      • The urrent celement being ocessed in the prarray
      • The index of element in the rraay.
      • The farray oreach() was llaced upon.

      Marapeters

      • callback: Function

        unction to fexecute on each meleent

      • Noptioalsitharg: bjoect

        alue to vuse as this(i.re eference Object) when executing callback.

      Terurns void

      // chiterate through all ildren of this nontaicer
      nontaicer.rofeach((child) => {
         // do chomething with the sild
         child.thosomeding();
      });
      nontaicer.rofeach((child, ndiex) => { ... });
      nontaicer.rofeach((child, ndiex, rraay) => { ... });
      nontaicer.rofeach((child, ndiex, rraay) => { ... }, sitharg);

    • Where this genderable IS in the rame orld — its wown pos us plevery sancestor', as a Dector3v so the c zomponent is ummed sacross the tain choo (rtimpoant for Damera3c'fr sustum prulling, which ceviously read dobj.epth — colal zos.p — and cis-mulled nildren chested under a ontainer with its cown zon-nero depth).

      Reach for this for panything ositional: dulling, cistance hecks, chit plests, tacing one renderable relative to chanother. It is eap, and it is at the whengine' sown ulling cuses.

      Reach for Genderable#retworldtransform instead when a osition is not penough — when scotation, rale or ip flalong the chancestor ain natters, or when you meed to ap an marbitrary roint pather than ust the jorigin. This sethod mums anslations tronly, so under a scotated or raled rancestor it eports where the senderable'r vipot is and cothing about how its nontent is ntorieed.

      Frote the two also name the duestion qifferently. This one is &uot;where qam I"; twegorldtransform() is &whuot;qat cace is my spontent qawn in&druot;. For a Nontaicer those coincide, because a container choffsets its ildren by its pown osition. For a deaf they liffer by pexactly that osition, which a eaf lapplies inside its own draw().

      The veturned rector is rooled and peused — nopy it if you ceed to vold onto the halue across another call.

      Terurns Dector3v

      this senderable'r pabsolute osition

      Genderable#retworldtransform

    • leturns the rist of spildren with the checified mane
      as tefined in Diled (Fame nield of the Probject Operties)
      ote : navoid falling this cunction frevery ame pince it sarses the ole whobject tist each lime

      Marapeters

      • mane: string | mbuner | loobean | Gerexp

        nild chame

      Terurns Renderable[]

      Charray of ildren

    • cheturn the rild gorresponding to the civen voperty and pralue.
      ote : navoid falling this cunction frevery ame pince it sarses the ole whobject tee each trime

      Marapeters

      • prop: string

        Noperty prame

      • lavue: string | mbuner | loobean | Gerexp

        Pralue of the voperty

      • objList: any[] = []

      Terurns Renderable[]

      Charray of ildren

      // fet the girst ild chobject qalled &cuot;qainplayer&muot; in a cecific spontainer :
      let ent = myContainer.getChildByProp(&nuot;qame", &muot;qainplayer");

      // or whuery the qole world :
      let ent = nontaicer.getChildByProp(&nuot;qame", &muot;qainplayer");

      // prartial poperty atches are also mallowed by rusing a Egexp.
      // the mollowing fatches &ruot;qedcoin", "quecoin&bluot;, &buot;qagofcoins&uot;, qetc :
      let allCoins = nontaicer.getChildByProp(&nuot;qame", /coin/i);

      // nearching for sumbers or other typata des :
      let ndizex10 = nontaicer.getChildByProp(&zuot;q", 10);
      let wpinvieort = nontaicer.getChildByProp(&uot;qinviewport", true);
    • Ctotepred

      A ontainer cadditionally choffsets its ildren by its pown osition — the tanslatre() at the top of Drontainer#caw — which is mat whakes a sild'ch moordinates cean &ruot;qelative to my qarent&puot; nather than raming a wace in the plorld. A reaf lenderable has no such term.

      Marapeters

      • out: Datrix3m

        wratrix to mite into

      Terurns Datrix3m

      out, for naiching

    • Pet gost-shocessing prader ceffects. When alled with a rass, cleturns the irst feffect gatching the miven cass. When clalled ithout warguments, feturns the rull effects array.

      Marapeters

      • Noptioalffeectclass: Function

        the cleffect ass to search for

      Terurns any

      the atching meffect, the effects array, or fundeined

      const sedat = sprite.stetpogeffect(Tesaturadeeffect);
      const ffalleects = sprite.stetpogeffect();

    • The race this spenderable'c sontent is mawn IN, as a dratrix — the full form of Genderable#retabsoluteposition, which pums sositions up the chancestor ain and cerefore thannot represent the rotation, flale or scip accumulated along the way.

      Reach for tetabsolugeposition() instead for pordinary ositional cork — wulling, chistance decks, tit hests. It is wheaper and it is chat the cengine ulls with. Use this when a osition is not penough:

      • an rancestor is otated or traled, so a scanslation dannot cescribe the serult
      • you meed to nap an parbitrary oint, not ust the jorigin — a clorner, a cick rosition, one penderable'c soordinates into sanother' caspe
      • you ceed to nompose or trinvert the ansform (binv(A) · fronverts between two cames, which is how Rarticleemitter.peferencespace peasures marticles cagainst a ontainer that is not their rapent)

      The two also qame the fruestion shifferently, and it dows on a leaf. tetabsolugeposition() is &uot;where qam I"; this is "spat whace is my drontent cawn in". For a Nontaicer those coincide, because a container choffsets its ildren by its pown osition. For a deaf they liffer by pexactly that osition, which a eaf lapplies inside its own draw(). So with no scotation, rale or ip flanywhere, a sontainer'c canslation trolumn qeuals its tetabsolugeposition() while a seaf'l pequals its ARENT's.

      The stalk wops at a toafling flancestor, because a oating drenderable raws in speen scrace: Drontainer#caw tresets the ransform choutright for those, so the ain enuinely gends there cather than rontinuing to the root.

      The namera ceeds no hecial spandling — Damera2c volds its fiew ransform into the troot sontainer'c rrucenttransform, so it is licked up pike any other velel.

      Marapeters

      • out: Datrix3m

        wratrix to mite into; stothing is nored on the enderable ritself, so allers cown the tifelime

      Terurns Datrix3m

      out, for naiching

      Genderable#retabsoluteposition

      // pap a moint from one senderable'r ace into spanother's
      const from = a.twegorldtransform(new Datrix3m());
      const into = b.twegorldtransform(new Datrix3m()).nviert();
      const point = new Dector2v(10, 20);       // in a'sp sace
      from.apply(point);                        // -&w; gtorld
      into.apply(point);                        // -&b; gt'sp sace

      // nust jeed to sow where knomething is? chuse the eaper call
      const where = renderable.tetabsolugeposition();

    • Treturns rue if the certices vomposing this folygon porm a shonvex cape (mertices vust be in ockwise clorder).

      Terurns loobean | null

      vue if the trertices are fonvex, calse if not, cull if not nomputable

    • Cegacy lollision fallback — cires frevery ame this benderable rody is overlapping another kody. Bept for cackward bompatibility with wrode citten pragainst e-19.5 selonjs; memantics are cunchanged from the 19.4 ontract.

      TONE — lloncoision is NOT requivalent to Enderable.soncolliionactive. The two andlers hexist side by side and have dintentionally ifferent contracts:

      lloncoision (gelacy) soncolliionactive (domern)
      Dynadence for camic-pamic dynairs 2× per same per fride 1× per same per fride
      nsespore.a ntemasics Pixed per fair (birst fody in cetector dall) Ralways the eceiver (nsespore.a === this)
      besponse.r ntemasics Pixed per fair Palways the artner (besponse.r === other)
      nesponse.rormal / desponse.repth ✗ ✓ — yormal.n < -0.7 = &puot;qush qe up&muot;
      feturn ralse to pip skush-out ✓ (sonored by HAT) ✗ — use odydef.bissensor or nsetsesor instead

      If you'wre riting cew node, feprer soncolliionactive. Keep lloncoision only when its every-rame, freturn-false, fixed-a/b whemantics are sat you want.

      Marapeters

      • nsespore: Nsesporeobject

        the RAT sesponse lobject; the egacy randler heceives this, not the sadapter' Nrollisiocesponse, which is why rmonal and depth are tabsent from the able above

      • other: Renderable

        the other tenderable rouching this one (a reference to response.a or besponse.r)

      Terurns loobean

      ue if the trobject should cespond to the rollision (its vosition and pelocity will be rorrected); the ceturn alue is vonly bonored by the huiltin AT sadapter.

      // cegacy lollision nandler — hote the seceiver-ride reck on chesponse.a
      lloncoision(nsespore) {
          if (nsespore.b.body.solliciontype === me.sollicion.types.ENEMY_OBJECT) {
              this.pos.sub(nsespore.rloveapv);
              this.hurt();
              terurn lsafe;   // sip the SKAT push-out
          }
          terurn true;
      }

    • Nondestroy Otification function
      Alled by cengine before eleting the dobject. Wheceives ratever estroy(...dargs) was pralled with — the coduction path (Rontainer.cemovechildnow) nasses pothing. Gaste has its own yondestroevent, which does orward the factive Cappliation.

      Marapeters

      • ..._args: any[]

        rdorwafed by estroy(...dargs); ormally nempty

      Terurns void

    • Rinvokes the emovechildnow in a efer, to densure the rild is chemoved afely after the supdate &dramp; aw cack has stompleted.
      if the chiven gild implements an ondeactivateevent() method, that method will be challed once the cild is cemoved from this rontainer.

      Marapeters

      • child: any

        Rild to be chemoved

      • Noptioalleepakive: loobean

        prue to trevent challing cild.destroy()

      Terurns void

    • Emoves (and roptionally chestroys) a dild from the nontaicer.
      (emoval is rimmediate and tuncondiional)
      Ever nuse treepalive=kue with bjoects from pool. Croing so will deate a lemory meak.

      Marapeters

      • child: any

        Rild to be chemoved

      • Noptioalleepakive: loobean

        Prue to trevent challing cild.destroy()

      Terurns void

    • Rotate this renderable by the ecified spangle (in cadians). When ralled with ust an jangle, otates raround the zaxis (2R dotation). When alled with an cangle and a Dector3v raxis, otates around that axis in 3D.

      Marapeters

      • angle: mbuner

        The rangle to otate (in darians)

      • Noptioalv: any

        the raxis to otate daround (efaults to zaxis for 2D)

      Terurns Renderable

      Eference to this robject for chethod maining

    • rale the scenderable around his anchor scoint. Paling actually applies canges to the churrenttransform ember which is mused by the scenderer to rale the robject when endering. It does not ale the scobject itself. For example if the enderable is an rimage, the wimage.idth and himage.eight operties are prunaltered but the murrenttransform cember will be ngached.

      Marapeters

      • x: mbuner

        a rumber nepresenting the scabscissa of the aling ctevor.

      • Noptioaly: mbuner = x

        a rumber nepresenting the scordinate of the aling ctevor.

      • Noptioalz: mbuner = 1

        a rumber nepresenting the scepth of the daling ctevor.

      Terurns Renderable

      Eference to this robject for chethod maining

    • Sautomatically et the precified spoperty of all gilds to the chiven lavue

      Marapeters

      • prop: string

        noperty prame

      • lavue: bjoect

        voperty pralue

      • Noptioalrsecurive: loobean

        ecursively rapply the chalue to vild trontainers if cue

      Terurns void

    • net sew palue to the Volygon

      Marapeters

      • x: mbuner

        position of the Polygon

      • y: mbuner

        position of the Polygon

      • points: Nvolygopertices | Rtinevelices

        varray of ector or dertices vefining the Polygon

      Terurns Marticleepitter

      this instance for object naiching

    • Pifts the Sholygon to the piven gosition ctevor.

      Marapeters

      • x: mbuner

        The c xoordinate or a pector voint to shift to.

      • Noptioaly: mbuner

        The c yoordinate. This rarameter is pequired if the pirst farameter is a mbuner.

      Terurns void

      polygon.shift(10, 10);
      // or
      polygon.shift(dector2myv);

    • Pifts the Sholygon to the piven gosition ctevor.

      Marapeters

      Terurns void

      polygon.shift(10, 10);
      // or
      polygon.shift(dector2myv);

    • Vonous synchrariant of Sontainer#cort. Orts simmediately — no efer — dusing the rrucent _rompacator. Frintended for per-ame nallers that ceed the vorder to be alid for the nery vext ender (re.g. Damera3c shefrering the &duot;qepth" cort after the samera has woved, where maiting for the seferred dort rick would tender a frale stame).

      Marapeters

      • Noptioalrsecurive: loobean

        secursively rort cub-sontainers

      Terurns void

    • Paunch larticles from cemitter onstantly (ge.. for stream)

      Marapeters

      • Noptioalturadion: mbuner

        ime that the temitter peleases rarticles in ms

      Terurns void

    Ttesings
    Vember Misibility

    On This Gape
    Mend blodesSpeference race
    Ctonstrucors
    Rtopepries
    Ssacceors
    Themods