DxDrawMaterialPrimitive3D - Revision history

Fernando187: Remove obsolete Requirements section

2024-11-07T17:21:45Z

Remove obsolete Requirements section

← Older revision		Revision as of 17:21, 7 November 2024
Line 87:		Line 87:

	This function can be used to draw billboards in the game world. You have to [https://forum.mtasa.com/topic/133065-naruto-jutsus-help-me/?do=findComment&comment=1003073 understand the mathematical models about the human vision] to calculate the proper vertices.		This function can be used to draw billboards in the game world. You have to [https://forum.mtasa.com/topic/133065-naruto-jutsus-help-me/?do=findComment&comment=1003073 understand the mathematical models about the human vision] to calculate the proper vertices.

	~~==Requirements==~~
	~~{{Requirements\|n/a\|1.5.7-9.19626\|}}~~

	==See Also==		==See Also==
	{{Drawing_functions}}		{{Drawing_functions}}

FileEX at 14:04, 27 May 2024

2024-05-27T14:04:05Z

@@ Line 5: / Line 5: @@
 Power of two: 2px, 4px, 8px, 16px, 32px, 64px, 128px, 256px, 512px, 1024px...
-{{Deprecated items|3.0159|1.5.9|
+{{Legacy|legacy/dxDrawMaterialPrimitive3D}}
 {{Updated feature/item|1.5.9|1.5.9|22465|

TEDERIs at 04:41, 27 May 2024

2024-05-27T04:41:15Z

← Older revision		Revision as of 04:41, 27 May 2024
Line 42:		Line 42:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxDrawMaterialPrimitive3D ( primitiveType pType, mixed material, string stage~~="postfx"~~, table vertex1 [, table vertex2, ...] )		bool dxDrawMaterialPrimitive3D ( primitiveType pType, mixed material, string stage, table vertex1 [, table vertex2, ...] )
	</syntaxhighlight>		</syntaxhighlight>

TEDERIs at 04:29, 27 May 2024

2024-05-27T04:29:14Z

@@ Line 5: / Line 5: @@
 Power of two: 2px, 4px, 8px, 16px, 32px, 64px, 128px, 256px, 512px, 1024px...
 ==Syntax==
 <syntaxhighlight lang="lua">
@@ Line 18: / Line 19: @@
 ==Allowed types==
 [[Image:MTAsa_primitives.png|thumb|240px|Available primitive types.]]
-More info on primitives may be found on [https://msdn.microsoft.com/en-us/library/windows/desktop/bb147291(v=vs.85).aspx this MSDN site]
+More info on primitives may be found on [https://msdn.microsoft.com/en-us/library/windows/desktop/bb147291.aspx this MSDN site]
 * '''pointlist:''' Renders the vertices as a collection of isolated points.
 * '''linelist:''' Renders the vertices as a list of isolated straight line segments.
@@ Line 30: / Line 31: @@
 * '''posY:''' An float representing the Y position of the vertex in the GTA world.
 * '''posZ:''' An float representing the Z position of the vertex in the GTA world.
-* '''color (optional):''' An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue). If it's not specified, white color is used.
+* '''color (optional):''' An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB. If it's not specified, white color is used.
 * '''u:''' An float representing  the relative X coordinate of the top left corner of the material which should be drawn from image
 * '''v:''' An float representing  the relative Y coordinate of the top left corner of the material which should be drawn from image
@@ Line 36: / Line 37: @@
 ===Returns===
 Returns a ''true'' if the operation was successful, ''false'' otherwise.
 ==Remarks==

Dmi7ry at 06:31, 17 June 2023

2023-06-17T06:31:10Z

← Older revision		Revision as of 06:31, 17 June 2023
Line 7:		Line 7:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dxDrawMaterialPrimitive3D ( primitiveType pType, mixed material, bool postGUI, table ~~vertice1~~ [, table ~~vertice2~~, ...] )		bool dxDrawMaterialPrimitive3D ( primitiveType pType, mixed material, bool postGUI, table vertex1 [, table vertex2, ...] )
	</syntaxhighlight>		</syntaxhighlight>

Line 14:		Line 14:
	* '''image:''' Either a [[material]] element or a [[filepath]] of the image which is going to be drawn. (.dds images are also supported). Image files should ideally have dimensions that are a power of two, to prevent possible blurring. Use a texture created with [[dxCreateTexture]] to '''speed up drawing'''.		* '''image:''' Either a [[material]] element or a [[filepath]] of the image which is going to be drawn. (.dds images are also supported). Image files should ideally have dimensions that are a power of two, to prevent possible blurring. Use a texture created with [[dxCreateTexture]] to '''speed up drawing'''.
	* '''postGUI:''' A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).		* '''postGUI:''' A bool representing whether the line should be drawn on top of or behind any ingame GUI (rendered by CEGUI).
	* '''vertices:''' Tables representing each primitive ~~vertice~~, required amount of them is determined by primitive type.		* '''vertices:''' Tables representing each primitive vertex, required amount of them is determined by primitive type.

	==Allowed types==		==Allowed types==
Line 27:		Line 27:

	==Vertices format==		==Vertices format==
	* '''posX:''' An float representing the X position of the ~~vertice~~ in the GTA world.		* '''posX:''' An float representing the X position of the vertex in the GTA world.
	* '''posY:''' An float representing the Y position of the ~~vertice~~ in the GTA world.		* '''posY:''' An float representing the Y position of the vertex in the GTA world.
	* '''posZ:''' An float representing the Z position of the ~~vertice~~ in the GTA world.		* '''posZ:''' An float representing the Z position of the vertex in the GTA world.
	* '''color (optional):''' An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue). If it's not specified, white color is used.		* '''color (optional):''' An integer of the hex color, produced using [[tocolor]] or 0xAARRGGBB (AA = alpha, RR = red, GG = green, BB = blue). If it's not specified, white color is used.
	* '''u:''' An float representing the relative X coordinate of the top left corner of the material which should be drawn from image		* '''u:''' An float representing the relative X coordinate of the top left corner of the material which should be drawn from image

Myonlake at 14:56, 11 June 2023

2023-06-11T14:56:28Z

← Older revision		Revision as of 14:56, 11 June 2023
Line 86:		Line 86:
	==See Also==		==See Also==
	{{Drawing_functions}}		{{Drawing_functions}}

	~~[[hu:dxDrawMaterialPrimitive3D]]~~

Dragon: /* Example */ Added an example

2023-04-02T19:25:13Z

Example: Added an example

@@ Line 45: / Line 45: @@
 ==Example==
-{{Example}}
+This example draws the picture with the file name 'test.png' on the ground of Grove Street and adds a /flip command to flip it. The 'test.png' file needs to be included in the [[meta.xml]] in order for this example to work.
 This function can be used to draw billboards in the game world. You have to [https://forum.mtasa.com/topic/133065-naruto-jutsus-help-me/?do=findComment&comment=1003073 understand the mathematical models about the human vision] to calculate the proper vertices.

Quiret: /* Remarks */

2022-01-11T23:25:44Z

Remarks

← Older revision		Revision as of 23:25, 11 January 2022
Line 42:		Line 42:
	[[File:D3d9_screen_space_transformation.png\|frameless\|center\|Direct3D 9 screen-space transformation]]		[[File:D3d9_screen_space_transformation.png\|frameless\|center\|Direct3D 9 screen-space transformation]]

	To transform the coordinates you first have to flip the Y coordinate using negation and then apply the Direct3D 9 screen-space rasterization cross-hair by using the screen dimensions (sw, sh). Since linear shapes are being preserved across linear translations, you can simplify each vertex-based figure into it's set of vertices for the purpose shown above.		To transform the coordinates you first have to flip the Y coordinate using negation and then apply the Direct3D 9 screen-space rasterization cross-hair by using the screen dimensions (sw, sh). Since linear shapes are being preserved across linear translations, you can simplify each vertex-based figure into it's set of vertices for the purpose shown above. By using this function in such a way it can perform all the operations in the same quality such as the simpler [[dxDrawMaterialPrimitive]] function.

	==Example==		==Example==

Quiret: /* Remarks */

2022-01-11T12:45:48Z

Remarks

← Older revision		Revision as of 12:45, 11 January 2022
Line 42:		Line 42:
	[[File:D3d9_screen_space_transformation.png\|frameless\|center\|Direct3D 9 screen-space transformation]]		[[File:D3d9_screen_space_transformation.png\|frameless\|center\|Direct3D 9 screen-space transformation]]

	To transform the coordinates you first have to flip the Y coordinate using negation and then apply the Direct3D 9 screen-space rasterization cross-hair by using the screen dimensions (sw, sh).		To transform the coordinates you first have to flip the Y coordinate using negation and then apply the Direct3D 9 screen-space rasterization cross-hair by using the screen dimensions (sw, sh). Since linear shapes are being preserved across linear translations, you can simplify each vertex-based figure into it's set of vertices for the purpose shown above.

	==Example==		==Example==

Quiret: /* Remarks */

2022-01-11T12:41:43Z

Remarks

← Older revision		Revision as of 12:41, 11 January 2022
Line 38:		Line 38:

	==Remarks==		==Remarks==
	When a 3D draw call is issued by any such material MTA function then the principle to push it directly to the 3D adapter does apply. To achieve this there is '''no software-side 3D clipping mathematics''' being performed. This way the vertex data is always being pushed to the vertex shader, leaving the entire freedom to the developer on how to interpret this vertex data in the shader. For example, even though this function does imply an use in 3D world space, the vertex coordinates could be translated directly into Direct3D 9 screen space instead, effectively discarding any multiplication with the camera projection matrix. The mathematical model for translation into valid Direct3D 9 screen-space coordinates is described [https://docs.microsoft.com/en-us/windows/win32/direct3d9/viewports-and-clipping here]. Let's assume that you are drawing the rectangle on a classic sheet of paper with a mathematical 2D X,Y coordinate system.		When a 3D draw call is issued by any such material MTA function then the principle to [https://github.com/multitheftauto/mtasa-blue/blob/16769b8d1c94e2b9fe6323dcba46d1305f87a190/Client/core/Graphics/CMaterialPrimitive3DBatcher.cpp#L42 push it directly to the 3D adapter] does apply. To achieve this there is '''no software-side 3D clipping mathematics''' being performed. This way the vertex data is always being pushed to the vertex shader, leaving the entire freedom to the developer on how to interpret this vertex data in the shader. For example, even though this function does imply an use in 3D world space, the vertex coordinates could be translated directly into Direct3D 9 screen space instead, effectively discarding any multiplication with the camera projection matrix. The mathematical model for translation into valid Direct3D 9 screen-space coordinates is described [https://docs.microsoft.com/en-us/windows/win32/direct3d9/viewports-and-clipping here]. Let's assume that you are drawing the rectangle on a classic sheet of paper with a mathematical 2D X,Y coordinate system.

	[[File:D3d9_screen_space_transformation.png\|frameless\|center\|Direct3D 9 screen-space transformation]]		[[File:D3d9_screen_space_transformation.png\|frameless\|center\|Direct3D 9 screen-space transformation]]