HU/dxCreateTexture
Ez function létrehoz egy textúra elemet, mely a dxDraw function-ban használható.
Fontos megjegyzés: Úgy tűnik, hogy a dxCreateTexture VRAM-ot is és RAM-ot is egyaránt használ (több RAM-ot), ezért, ha nagy renderelési célokat szeretne (melyen nem rajzol ki minden frame-t), ez egy jó megoldás lehet a dxSetTexturePixels használata. |
Megjegyzés: Az oldal jobb oldalán jelzett idők azok az idők, melyek szükségesek a rajzolási sorrend hozzáadásához, ez nem az a valós idő, amibe ezek lerajzolása telik. |
A kockák és a nagy mennyiségű textúrák betöltésésre használhatjuk a dxCreateTexture-át, de ezeket csak az árnyéknál használhatóak. A Microsoft segédprogramokban DxTex megtekintheti és módosíthatja a kockákat és a nagy mennyiségű textúrákat. Valamint a DxTex a szabványos textúrákat DXT1/3/5-be tömörítheti .dds - melyek csökkentik a fájlméreteket.
Szintaxis
element dxCreateTexture ( string pixels / string filepath [, string textureFormat = "argb", bool mipmaps = true, string textureEdge = "wrap" ] )
element dxCreateTexture ( int width, int height [, string textureFormat = "argb", string textureEdge = "wrap", string textureType = "2d", int depth = 1 ] )
OOP Syntax Help! I don't understand this!
- Method: DxTexture(...)
Kötelező paraméterek
- filepath: A kép elérési útja. (támogatott formátumok .bmp, .dds, .jpg, .png, and .tga). A képfájloknak ideális esetben olyan méretekkel kell rendelkezniük, amelyek a kettő négyzetei, hogy megakadályozzák az elmosódást.
vagy
- pixels: Pixelek tartalmazzák a képadatokat. ('plain', 'jpeg' vagy 'png' formátumok használhatóak)
vagy
- width: A kívánt szélesség, lehetőleg a kettő négyzetei legyenek (16, 32, 64 stb.), maximum 16384
- height : A kívánt magasság, lehetőleg a kettő négyzetei legyenek (16, 32, 64 stb.), maximum 16384
Tetszőleges paraméterek
Megjegyzés: Amikor tetszőleges paramétereket használ, előfordulhat, hogy az összes paramétert meg kell adnia, mielőtt egyet is használna. További információkért látogassa meg a tetszőleges paraméterek oldalt.
- textureFormat : Egy string, mely a kívánt textúra formátumot ábrázolja, melyek a következők lehetnek:
- "argb" : ARGB tömörítetlen 32 bites szín (alapértelmezett).
- "dxt1" : DXT1 tömörített - A betöltés tovább tarthat, mint a másodperc törtrésze (hacsak a fájl már nem DXT1 .dds). 8-szor kevesebb videó memóriát használ, mint az ARGB felgyorsíthatja a rajzolást. A minősége nem olyan jó, mint az ARGB-nél, és nem támogatja az alpha társítást.
- "dxt3" : DXT3 tömörített - A betöltés tovább tarthat, mint a másodperc törtrésze (hacsak a fájl már nem DXT3 .dds). 4-szer kevesebb videó memóriát használ, mint az ARGB felgyorsíthatja a rajzolást. A minősége valamivel jobb, mint a DXT1 és támogatja az erős alpha társítást.
- "dxt5" : DXT5 tömörített - A betöltés tovább tarthat, mint a másodperc törtrésze (hacsak a fájl már nem DXT5 .dds). 4-szer kevesebb videó memóriát használ, mint az ARGB felgyorsíthatja a rajzolást. A minősége valamivel jobb, mint a DXT1 és támogatja az egyenletes alpha társítást.
- mipmaps : Igaz, hogy létrehoz egy mip-map láncot, így a textúra jól néz ki, ha különböző méretekben rajzolódik ki.
- textureEdge : A string representing the desired texture edge handling, which can be one of:
- "wrap" : A textúra éleit befedi (alapértelmezett)
- "clamp" : Clamp the texture at the edges. This may help avoid edge artifacts.
- textureType : A string representing the desired texture type, which can be one of:
- "2d" : Standard texture (alapértelmezett)
- "3d" : Volume texture
- "cube" : Cube map
- depth: Desired number of slices when creating a volume texture
Visszatérési érték
Visszatérési értéke egy textúra, ha sikeres, false, ha érvénytelen paraméterek lettek megadva.
Példa
addEventHandler( "onClientRender", root, function() if myImage then dxDrawImage( 100, 350, 300, 350, myImage ) end end ) -- Use 'toggle' command to switch image on and off addCommandHandler( "toggle", function() if not myImage then myImage = dxCreateTexture( "moonpig.png" ) -- Create texture else destroyElement( myImage ) -- Destroy texture myImage = nil end end )
Changelog
Version | Description |
---|
1.3.0-9.04021 | Added textureType and depth argument |
1.3.0-9.04035 | Added textureEdge argument |
Lásd még
- HU/dxConvertPixels
- HU/dxCreateFont
- HU/dxCreateRenderTarget
- HU/dxCreateScreenSource
- HU/dxCreateShader
- HU/dxCreateTexture
- HU/dxDrawCircle
- HU/dxDrawImage
- HU/dxDrawImageSection
- HU/dxDrawLine
- HU/dxDrawLine3D
- HU/dxDrawMaterialLine3D
- HU/dxDrawMaterialPrimitive
- HU/dxDrawPrimitive
- HU/dxDrawMaterialSectionLine3D
- HU/dxDrawRectangle
- HU/dxDrawText
- HU/dxGetBlendMode
- HU/dxGetFontHeight
- HU/dxGetMaterialSize
- HU/dxGetPixelColor
- HU/dxGetPixelsSize
- HU/dxGetPixelsFormat
- HU/dxGetStatus
- HU/dxGetTextWidth
- HU/dxGetTexturePixels
- HU/dxSetAspectRatioAdjustmentEnabled
- HU/dxSetBlendMode
- HU/dxSetPixelColor
- HU/dxSetRenderTarget
- HU/dxSetShaderValue
- HU/dxSetShaderTessellation
- HU/dxSetShaderTransform
- HU/dxSetTestMode
- HU/dxSetTextureEdge
- HU/dxSetTexturePixels
- HU/dxUpdateScreenSource