Matter.Render-moduuli on kevyt, valinnainen apuohjelma, joka tarjoaa yksinkertaisen kankaalle perustuvan renderöijän Matter.Engine-esiintymien visualisointiin. Se on tarkoitettu kehitys- ja virheenkorjaustarkoituksiin, mutta se voi sopia myös yksinkertaisiin peleihin. Se sisältää useita piirustusvaihtoehtoja, mukaan lukien rautalanka, vektori tuella spriteille ja kuvaportit.
menetelmät
Matter.Render.create([options]) → Render
Luo uuden renderöijän. Asetukset-parametri on objekti, joka määrittää ominaisuudet, jotka haluat ohittaa oletusasetukset. Kaikilla ominaisuuksilla on oletusarvot, ja monet niistä lasketaan etukäteen automaattisesti muiden ominaisuuksien perusteella. Katso alla olevasta ominaisuudet-osiosta yksityiskohtaisia tietoja siitä, mitä voit siirtää asetukset-objektin kautta.
Parametrit
[options]Object optional
Palauttaa
Render: A new renderer
Matter.Render.endViewTransform(render)
Nollaa kaikki muunnokset renderöintikontekstissa.
Parametrit
renderRender
Matter.Render.lookAt(render, objects, [padding], [center=true])
Sijoittaa ja kokoaa näkymän annettujen objektien rajojen ympärille. Objekteilla on oltava vähintään yksi seuraavista ominaisuuksista:
- objekti.rajat
- objekti.sijainti
- objekti.min ja objekti.max
- objekti.x ja objekti.y
Parametrit
renderRender objectsObject[] [padding]Vector optional[center=true]Bool optional
Matter.Render.run(render)
Päivittää jatkuvasti renderöintialuetta requestAnimationFrame-tapahtumassa.
Parametrit
renderRender
Matter.Render.setPixelRatio(render, pixelRatio)
Asettaa renderöijän pikselisuhteen ja päivittää kankaan. Tunnistaaksesi oikean suhteen automaattisesti, anna pixelRatio-merkkijono "auto".
Parametrit
renderRender pixelRatioNumber
Matter.Render.setSize(render, width, height)
Asettaa renderöinnin leveyden ja korkeuden.
Päivittää render.options.pixelRatio-pohjaisen kirjanpidon.
Päivittää oikean alakulman renderöintiraidan render.bounds.max suhteessa annettuun leveyteen ja korkeuteen. Vasemman yläkulman renderöintirajattu render.bounds.min ei muutu.
Seuraa tätä kutsua Render.lookAtilla, jos sinun on muutettava renderöintirajoja.
Katso myös Render.setPixelRatio.
Parametrit
renderRender widthNumber Leveys (CSS-pikseleinä) heightNumber Korkeus (CSS-pikseleinä)
Matter.Render.startViewTransform(render)
Käyttää render.bounds-arvoon perustuvia näkymän muunnoksia renderöintikontekstiin.
Parametrit
renderRender
Matter.Render.stop(render)
Lopettaa tiedoston Render.run suorittamisen annetulla renderöinnillä peruuttamalla animaatiokehyspyyntötapahtumasilmukan.
Parametrit
renderRender
Matter.Render.world(render)
Muodostaa annetun moottorin Matter.World-objektin. Tämä on kaikkien renderöintien aloituspiste, ja sitä tulisi kutsua aina, kun kohtaus muuttuu.
Parametrit
renderRender
Ominaisuudet / Vaihtoehdot
Seuraavat ominaisuudet, jos ne on määritetty alla, koskevat Matter.Render.create-ohjelman luomia objekteja, ja ne voidaan välittää sille vaihtoehtoina.
render.bounds Bounds
Rajoitusobjekti, joka määrittää piirustusnäkymän alueen. Renderöinti muunnetaan ja skaalataan automaattisesti sopimaan kanvaskoon (render.options.width ja render.options.height). Tämä mahdollistaa näkymien luomisen, jotka voivat panoroida tai zoomata näkymää. Sinun on myös asetettava render.options.hasBounds arvoon true, jotta voit ottaa rajatun renderöinnin käyttöön.
render.canvas HTMLCanvasElement
Kanvas-elementti, johon renderöidä. Jos sitä ei ole määritetty, sellainen luodaan, jos render.element on määritetty.
Oletus:null
render.context CanvasRenderingContext2D
2d-renderöintikonteksti render.canvas-elementistä.
render.controller Render deprecated
Takaisinviittaus Matter.Render-moduuliin.
render.element HTMLElement
Viittaus elementtiin, johon kangas lisätään (jos render.canvas ei ole määritetty)
Oletus:null
render.engine Engine
Viittaus käytettävään Matter.Engine-esiintymään.
render.mouse Mouse
Renderöitävä hiiri, jos render.options.showMousePosition on käytössä.
Oletus:null
render.options
Renderöijän asetusvaihtoehdot.
render.options.background String
CSS-taustavärimerkkijono, jota käytetään, kun render.options.wireframes ei ole käytössä. Tämä voi olla myös "läpinäkyvä" tai vastaava.
Oletus:'#14151f'
render.options.enabled Boolean
Lippu, jolla hahmonnus otetaan käyttöön tai poistetaan kokonaan käytöstä.
Oletus:false
render.options.hasBounds Boolean
Lippu, joka määrittää, tuleeko render.bounds-arvoa käyttää renderöinnissa.
Oletus:false
render.options.height Number
Luotavan render.canvas-tiedoston tavoitekorkeus pikseleinä. Katso myös option.pixelRatio-ominaisuus muuttaaksesi renderöinnin laatua.
Oletus:600
render.options.pixelRatio Number
Renderöinnissa käytettävä pikselisuhde.
Oletus:1
render.options.showAngleIndicator Boolean
Lippu, joka ottaa kehon kulman virheenkorjauspeittokuvan käyttöön tai poistaa sen käytöstä.
Oletus:false
render.options.showAxes Boolean
Lippu, joka ottaa käyttöön tai poistaa käytöstä runkoakselien virheenkorjauspeittokuvan.
Oletus:false
render.options.showBounds Boolean
Lippu, jolla otetaan käyttöön tai poistetaan käytöstä runkorajojen virheenkorjauspeitto.
Oletus:false
render.options.showBroadphase Boolean deprecated
Vanhentunut: ei enää käytössä
Lippu, joka ottaa käyttöön tai poistaa käytöstä törmäyksen laajavaiheisen virheenkorjauspeittokuvan.
Oletus:false
render.options.showCollisions Boolean
Lippu, joka ottaa kehon törmäysten virheenkorjauspeittokuvan käyttöön tai poistaa sen käytöstä.
Oletus:false
render.options.showConvexHulls Boolean
Lippu, joka ottaa käyttöön tai poistaa käytöstä rungon kuperan rungon virheenkorjauspeittokuvan.
Oletus:false
render.options.showDebug Boolean
Lippu, joka ottaa käyttöön tai poistaa käytöstä kaikki virheenkorjaustietopeittokuvat yhdessä.
Tämä sisältää ja on etusijalla seuraaviin arvoihin nähden:
- render.options.showStats
- render.options.showPerformance
Oletus:false
render.options.showDebug Boolean
Lippu virheenkorjaustietojen peittokuvan ottamiseksi käyttöön tai poistamiseksi käytöstä.
Oletus:false
render.options.showIds Boolean
Lippu, jolla otetaan käyttöön tai poistetaan käytöstä runko- ja osatunnusten virheenkorjauspeitto.
Oletus:false
render.options.showInternalEdges Boolean
Lippu, joka ottaa käyttöön tai poistaa käytöstä rungon sisäreunojen virheenkorjauspeittokuvan.
Oletus:false
render.options.showMousePosition Boolean
Lippu, joka ottaa käyttöön tai poistaa käytöstä hiiren sijainnin virheenkorjauspeittokuvan.
Oletus:false
render.options.showPerformance Boolean
Lippu tehokkuuskaavioiden käyttöön tai poistamiseksi käytöstä.
Vasemmalta oikealle näkyvät arvot ovat:
- keskimääräinen renderöintitaajuus (esim. 60 fps)
- viimeisessä päivityksessä käytetty tarkka moottorin delta-aika (esim. 16,66 ms)
- päivitysten keskimäärä kehystä kohden (esim. 1)
- moottorin keskimääräinen suoritusaika (esim. 5,00 ms)
- keskimääräinen renderöinnin kesto (esim. 0,40 ms)
- keskimääräinen tehollinen toistonopeus (esim. "1.00x" on "reaaliaikainen")
Jokainen arvo tallennetaan kiinteään otteeseen menneistä kehyksistä (60 kehystä).
Kunkin arvon alla oleva kaavio osoittaa poikkeaman otoksen keskiarvosta. Mitä vakaampi tai kiinteämpi arvo on, sitä tasaisempi kaavio näyttää.
Oletus:false
render.options.showPositions Boolean
Lippu, jolla otetaan käyttöön tai poistetaan käytöstä kehon asemien virheenkorjauspeitto.
Oletus:false
render.options.showSeparations Boolean
Lippu, joka ottaa käyttöön tai poistaa käytöstä törmäyksenratkaisun erottelun virheenkorjauspeittokuvan.
Oletus:false
render.options.showSleeping Boolean
Lippu, joka ottaa käyttöön tai poistaa käytöstä nukkuvien kehojen ilmaisimet.
Oletus:true
render.options.showStats Boolean
Lippu moottorin tilastotietojen peittokuvan ottamiseksi käyttöön tai poistamiseksi käytöstä.
Vasemmalta oikealle näkyvät arvot ovat:
- ruumiinosat yhteensä
- kehon kokonaismäärä
- rajoitukset yhteensä
- komposiitit yhteensä
- törmäysparit yhteensä
Oletus:false
render.options.showVelocity Boolean
Lippu, joka ottaa kehon nopeuden virheenkorjauspeittokuvan käyttöön tai poistaa sen käytöstä.
Oletus:false
render.options.showVertexNumbers Boolean
Lippu, joka ottaa käyttöön tai poistaa käytöstä runkopistenumeroiden virheenkorjauspeittokuvan.
Oletus:false
render.options.width Number
Luotavan render.canvas-tiedoston tavoiteleveys pikseleinä. Katso myös option.pixelRatio-ominaisuus muuttaaksesi renderöinnin laatua.
Oletus:800
render.options.wireframeBackground String
CSS-värimerkkijono, jota käytetään taustana, kun render.options.wireframes on käytössä. Tämä voi olla myös "läpinäkyvä" tai vastaava.
Oletus:'#14151f'
render.options.wireframes Boolean
Lippua käytetään kehyksen renderöinnin vaihtamiseen, muuten kiinteätä täyttöä käytetään.
Oletus:true
render.options.wireframeStrokeStyle String
CSS-värimerkkijono, jota käytetään viivalla, kun render.options.wireframes on käytössä. Tämä voi olla myös "läpinäkyvä" tai vastaava.
Oletus:'#bbb'
render.textures
Sprite-tekstuurivälimuisti.
Tapahtumat
Seuraavat tapahtumat lähettävät Matter.Render.create-ohjelman luomat objektit ja vastaanottavat Matter.Events.on-palvelun kautta tilatut objektit.
Events.on(render, "afterRender", callback)
Ammutettu renderoinnin jälkeen
Takaisinsoittoparametrit
eventObject Tapahtumaobjekti timestampNumber Tapahtuman engine.timing.timestamp sourceTapahtuman lähdekohde nameTapahtuman nimi
Events.on(render, "beforeRender", callback)
Käynnistetty ennen renderöintiä
Takaisinsoittoparametrit
eventObject Tapahtumaobjekti timestampNumber Tapahtuman engine.timing.timestamp sourceTapahtuman lähdekohde nameTapahtuman nimi