DxCreateTexture - Revision history

Pirulax: Add tip to pre-convert textures using dxtex texconv

2022-02-04T00:00:21Z

Add tip to pre-convert textures using dxtex texconv

← Older revision		Revision as of 00:00, 4 February 2022
Line 4:		Line 4:
	{{Important Note\|This function uses significant process RAM, make sure you don't load a lot of textures, because you'll run out of memory and crash MTA on your gaming PC beyond the technical limit of 3.5 GB (weak PC users much earlier). Besides that, don't make the common mistake of causing a memory leak by not destroying textures (causing dxTextures to pile up) when they should no longer display per your script, which causes FPS lag and crashes all over MTA due to so many scripters missing it}}		{{Important Note\|This function uses significant process RAM, make sure you don't load a lot of textures, because you'll run out of memory and crash MTA on your gaming PC beyond the technical limit of 3.5 GB (weak PC users much earlier). Besides that, don't make the common mistake of causing a memory leak by not destroying textures (causing dxTextures to pile up) when they should no longer display per your script, which causes FPS lag and crashes all over MTA due to so many scripters missing it}}
	{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}		{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}
			{{Tip\|It is recommended to pre-convert textures to whatever format you want to load them as. ARGB should be PNG, all other formats are self explanatory. By doing this you can load textures on the fly without any hickups (Note: There might still be some if the user has a slow HHD). See [https://github.com/microsoft/DirectXTex/releases DirectXTex texconv tool]. }}
	[[Image:Screenshot_27.png\|frame\|A speedtest showing the performance of a texture created with various settings of textureFormat.[Mipmaps = true][textureEdge = "wrap"]]]		[[Image:Screenshot_27.png\|frame\|A speedtest showing the performance of a texture created with various settings of textureFormat.[Mipmaps = true][textureEdge = "wrap"]]]
	[[Image:DxCreateTexture_mipmaps_false.png \|frame\|A speedtest showing the performance of a texture created with various settings of textureFormat.[Mipmaps = false][textureEdge = "wrap"]]]		[[Image:DxCreateTexture_mipmaps_false.png \|frame\|A speedtest showing the performance of a texture created with various settings of textureFormat.[Mipmaps = false][textureEdge = "wrap"]]]

Dutchman101 at 08:00, 15 February 2021

2021-02-15T08:00:10Z

← Older revision		Revision as of 08:00, 15 February 2021
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	This function creates a [[texture]] element that can be used in the dxDraw functions.		This function creates a [[texture]] element that can be used in the dxDraw functions.
	{{Important Note\|This function uses process RAM, make sure you don't load a lot of textures, because you'll run out of memory and crash MTA on your gaming PC beyond the technical limit of 3.5 GB (weak PC users much earlier). Besides that, don't make the common mistake of causing a memory leak by not destroying textures (causing dxTextures to pile up) when they should no longer display per your script}}		{{Important Note\|This function uses significant process RAM, make sure you don't load a lot of textures, because you'll run out of memory and crash MTA on your gaming PC beyond the technical limit of 3.5 GB (weak PC users much earlier). Besides that, don't make the common mistake of causing a memory leak by not destroying textures (causing dxTextures to pile up) when they should no longer display per your script, which causes FPS lag and crashes all over MTA due to so many scripters missing it}}
	{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}		{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}

Dutchman101: clarify pre-existing note

2021-02-15T07:51:30Z

clarify pre-existing note

← Older revision		Revision as of 07:51, 15 February 2021
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	This function creates a [[texture]] element that can be used in the dxDraw functions.		This function creates a [[texture]] element that can be used in the dxDraw functions.
	{{Important Note\|This function uses process RAM, make sure you don't load a lot of textures, because you'll run out of memory~~. Max is around~~ 3.5 ~~gb after which GTA crashes~~. Besides that, don't make the common mistake of causing a memory leak by not destroying textures (causing dxTextures to pile up) when they should no longer display per your script}}		{{Important Note\|This function uses process RAM, make sure you don't load a lot of textures, because you'll run out of memory and crash MTA on your gaming PC beyond the technical limit of 3.5 GB (weak PC users much earlier). Besides that, don't make the common mistake of causing a memory leak by not destroying textures (causing dxTextures to pile up) when they should no longer display per your script}}
	{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}		{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}

Dutchman101: Add memory leak warning to existing box

2021-02-15T07:49:35Z

Add memory leak warning to existing box

← Older revision		Revision as of 07:49, 15 February 2021
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	This function creates a [[texture]] element that can be used in the dxDraw functions.		This function creates a [[texture]] element that can be used in the dxDraw functions.
	{{Important Note\|This function uses process RAM, make sure you don't load a lot of textures, because you'll run out of memory. Max is around 3.5 gb after which GTA crashes}}		{{Important Note\|This function uses process RAM, make sure you don't load a lot of textures, because you'll run out of memory. Max is around 3.5 gb after which GTA crashes. Besides that, don't make the common mistake of causing a memory leak by not destroying textures (causing dxTextures to pile up) when they should no longer display per your script}}
	{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}		{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}

Pirulax: DXT1 has an alpha channel, but its only 1 bit. So, add a note that is actually supports alpha, because it was stated it doesn't

2020-07-14T08:44:24Z

DXT1 has an alpha channel, but its only 1 bit. So, add a note that is actually supports alpha, because it was stated it doesn't

← Older revision		Revision as of 08:44, 14 July 2020
Line 29:		Line 29:
	*'''textureFormat :''' A string representing the desired texture format, which can be one of:		*'''textureFormat :''' A string representing the desired texture format, which can be one of:
	**'''"argb"''' : ARGB uncompressed 32 bit color (default).		**'''"argb"''' : ARGB uncompressed 32 bit color (default).
	**'''"dxt1"''' : DXT1 compressed - Can take a fraction of a second longer to load (unless the file is already a DXT1 .dds). Uses 8 times less video memory than ARGB and '''can speed up drawing'''. Quality not as good as ARGB ~~and does not support~~ alpha blending.		**'''"dxt1"''' : DXT1 compressed - Can take a fraction of a second longer to load (unless the file is already a DXT1 .dds). Uses 8 times less video memory than ARGB and '''can speed up drawing'''. Quality not as good as ARGB. '''It supports alpha blending, but it can only be on or off, that is: either 0 or 255.'''
	**'''"dxt3"''' : DXT3 compressed - Can take a fraction of a second longer to load (unless the file is already a DXT3 .dds). Uses 4 times less video memory than ARGB and '''can speed up drawing'''. Quality slightly better than DXT1 and supports crisp alpha blending.		**'''"dxt3"''' : DXT3 compressed - Can take a fraction of a second longer to load (unless the file is already a DXT3 .dds). Uses 4 times less video memory than ARGB and '''can speed up drawing'''. Quality slightly better than DXT1 and supports crisp alpha blending.
	**'''"dxt5"''' : DXT5 compressed - Can take a fraction of a second longer to load (unless the file is already a DXT5 .dds). Uses 4 times less video memory than ARGB and '''can speed up drawing'''. Quality slightly better than DXT1 and supports smooth alpha blending.		**'''"dxt5"''' : DXT5 compressed - Can take a fraction of a second longer to load (unless the file is already a DXT5 .dds). Uses 4 times less video memory than ARGB and '''can speed up drawing'''. Quality slightly better than DXT1 and supports smooth alpha blending.

Pirulax at 11:14, 28 June 2020

2020-06-28T11:14:50Z

← Older revision		Revision as of 11:14, 28 June 2020
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	This function creates a [[texture]] element that can be used in the dxDraw functions.		This function creates a [[texture]] element that can be used in the dxDraw functions.
	{{Important Note\|~~It seems like dxCreateTexture~~ uses ~~both VRAM and~~ RAM ~~(more of RAM), so~~, ~~if you want to have big render targets (on which~~ you don't ~~draw every frame)~~, ~~this~~ is ~~a good solution using [[dxSetTexturePixels]]~~.}}		{{Important Note\|This function uses process RAM, make sure you don't load a lot of textures, because you'll run out of memory. Max is around 3.5 gb after which GTA crashes}}
	{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}		{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}

StrixG: Add mirror texture edge

2019-09-17T13:44:32Z

Add mirror texture edge

← Older revision		Revision as of 13:44, 17 September 2019
Line 36:		Line 36:
	**'''"wrap"''' : Wrap the texture at the edges (default)		**'''"wrap"''' : Wrap the texture at the edges (default)
	**'''"clamp"''' : Clamp the texture at the edges. This may help avoid edge artifacts.		**'''"clamp"''' : Clamp the texture at the edges. This may help avoid edge artifacts.
			**'''"mirror"''' : Mirror the texture at the edges.
	*'''textureType :''' A string representing the desired texture type, which can be one of:		*'''textureType :''' A string representing the desired texture type, which can be one of:
	**'''"2d"''' : Standard texture (default)		**'''"2d"''' : Standard texture (default)

Surge at 12:22, 18 October 2018

2018-10-18T12:22:41Z

← Older revision		Revision as of 12:22, 18 October 2018
Line 75:		Line 75:
	==See Also==		==See Also==
	{{Drawing_functions}}		{{Drawing_functions}}

			[[hu:dxCreateTexture]]

Myonlake at 10:51, 18 August 2018

2018-08-18T10:51:37Z

← Older revision		Revision as of 10:51, 18 August 2018
Line 2:		Line 2:
	__NOTOC__		__NOTOC__
	This function creates a [[texture]] element that can be used in the dxDraw functions.		This function creates a [[texture]] element that can be used in the dxDraw functions.
			{{Important Note\|It seems like dxCreateTexture uses both VRAM and RAM (more of RAM), so, if you want to have big render targets (on which you don't draw every frame), this is a good solution using [[dxSetTexturePixels]].}}
	{{Important Note\|It seems like dxCreateTexture uses both VRAM and RAM(more of ~~this~~), so, if you want to have big ~~rendertargets~~(on which you don't draw every frame), this is a good solution using ~~setPixels()~~}}
	{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}		{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}

Line 23:		Line 22:
	*'''pixels:''' [[Texture_pixels\|Pixels]] containing image data. ('plain', 'jpeg' or 'png' pixels can be used here)		*'''pixels:''' [[Texture_pixels\|Pixels]] containing image data. ('plain', 'jpeg' or 'png' pixels can be used here)
	or		or
	*'''width:''' Desired width (~~Can't be more than~~ 16384)		*'''width:''' Desired width, preferably power of two (16, 32, 64 etc.), maximum is 16384
	*'''height :''' Desired height (~~Can't be more than~~ 16384)		*'''height :''' Desired height, preferably power of two (16, 32, 64 etc.), maximum is 16384

	===Optional Arguments===		===Optional Arguments===

Pirulax: Changed 'must be power of two' to 'can't be more than 16384'(tested it.)

2018-08-16T15:46:04Z

Changed 'must be power of two' to 'can't be more than 16384'(tested it.)

← Older revision		Revision as of 15:46, 16 August 2018
Line 23:		Line 23:
	*'''pixels:''' [[Texture_pixels\|Pixels]] containing image data. ('plain', 'jpeg' or 'png' pixels can be used here)		*'''pixels:''' [[Texture_pixels\|Pixels]] containing image data. ('plain', 'jpeg' or 'png' pixels can be used here)
	or		or
	*'''width:''' Desired width (~~Must~~ be ~~a power of two. e.g. 128, 256~~)		*'''width:''' Desired width (Can't be more than 16384)
	*'''height :''' Desired height (~~Must~~ be ~~a power of two. e.g. 128, 256~~)		*'''height :''' Desired height (Can't be more than 16384)

	===Optional Arguments===		===Optional Arguments===

← Older revision		Revision as of 00:00, 4 February 2022
Line 4:		Line 4:
	{{Important Note\|This function uses significant process RAM, make sure you don't load a lot of textures, because you'll run out of memory and crash MTA on your gaming PC beyond the technical limit of 3.5 GB (weak PC users much earlier). Besides that, don't make the common mistake of causing a memory leak by not destroying textures (causing dxTextures to pile up) when they should no longer display per your script, which causes FPS lag and crashes all over MTA due to so many scripters missing it}}		{{Important Note\|This function uses significant process RAM, make sure you don't load a lot of textures, because you'll run out of memory and crash MTA on your gaming PC beyond the technical limit of 3.5 GB (weak PC users much earlier). Besides that, don't make the common mistake of causing a memory leak by not destroying textures (causing dxTextures to pile up) when they should no longer display per your script, which causes FPS lag and crashes all over MTA due to so many scripters missing it}}
	{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}		{{Note\|The times shown at the right of the page are only the time needed to add the thing to the draw queue, its not the actual time it takes to draw them.}}
			{{Tip\|It is recommended to pre-convert textures to whatever format you want to load them as. ARGB should be PNG, all other formats are self explanatory. By doing this you can load textures on the fly without any hickups (Note: There might still be some if the user has a slow HHD). See [https://github.com/microsoft/DirectXTex/releases DirectXTex texconv tool]. }}
	[[Image:Screenshot_27.png\|frame\|A speedtest showing the performance of a texture created with various settings of textureFormat.[Mipmaps = true][textureEdge = "wrap"]]]		[[Image:Screenshot_27.png\|frame\|A speedtest showing the performance of a texture created with various settings of textureFormat.[Mipmaps = true][textureEdge = "wrap"]]]
	[[Image:DxCreateTexture_mipmaps_false.png \|frame\|A speedtest showing the performance of a texture created with various settings of textureFormat.[Mipmaps = false][textureEdge = "wrap"]]]		[[Image:DxCreateTexture_mipmaps_false.png \|frame\|A speedtest showing the performance of a texture created with various settings of textureFormat.[Mipmaps = false][textureEdge = "wrap"]]]