DgsImageSetUVPosition - Revision history

Thisdp at 05:03, 19 April 2021

2021-04-19T05:03:04Z

← Older revision		Revision as of 05:03, 19 April 2021
Line 15:		Line 15:

	===Returns===		===Returns===
	Returns ''true'' if ~~succeed~~, ''false'' otherwise		Returns ''true'' if successful, ''false'' otherwise

	==Example==		==Example==

Thisdp at 04:58, 19 April 2021

2021-04-19T04:58:09Z

← Older revision		Revision as of 04:58, 19 April 2021
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool dgsImageSetUVPosition ( element ~~dgsElement~~, float UPos, float VPos, bool relative )		bool dgsImageSetUVPosition ( element dgsImage, float UPos, float VPos, bool relative )
	</syntaxhighlight>		</syntaxhighlight>

	===Required Arguments===		===Required Arguments===
	*'''~~guiElement:~~''' The dgs image of which you wish to set the UV position.		*'''dgsImage''': The dgs image of which you wish to set the UV position.
	*'''UPos:''' A float of the U position of image.		*'''UPos''': A float of the U position of image.
	*'''VPos:''' A float of the V position of image.		*'''VPos''': A float of the V position of image.
	*'''relative:''' This determines whether UV position is relative. If this is true, then UV position floats must be between 0 and 1, representing UV positions relative to the pixels of the texture loaded.		*'''relative''': This determines whether UV position is relative. If this is true, then UV position floats must be between 0 and 1, representing UV positions relative to the pixels of the texture loaded.

	===Returns===		===Returns===

Thisdp: /* Syntax */

2018-11-06T03:34:10Z

Syntax

← Older revision		Revision as of 03:34, 6 November 2018
Line 5:		Line 5:
	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	dgsImageSetUVPosition ( element dgsElement, float UPos, float VPos, bool relative )		bool dgsImageSetUVPosition ( element dgsElement, float UPos, float VPos, bool relative )
	</syntaxhighlight>		</syntaxhighlight>

Thisdp: /* Required Arguments */

2018-11-06T03:32:33Z

Required Arguments

← Older revision		Revision as of 03:32, 6 November 2018
Line 10:		Line 10:
	===Required Arguments===		===Required Arguments===
	*'''guiElement:''' The dgs image of which you wish to set the UV position.		*'''guiElement:''' The dgs image of which you wish to set the UV position.
	*'''~~USize~~:''' ~~The width~~ of the U ~~size~~ of image.		*'''UPos:''' A float of the U position of image.
	*'''~~VSize~~:''' ~~The height~~ of the V ~~size~~ of image.		*'''VPos:''' A float of the V position of image.
	*'''relative:''' This determines whether UV position is relative. If this is true, then UV position floats must be between 0 and 1, representing UV positions relative to the pixels of the texture loaded.		*'''relative:''' This determines whether UV position is relative. If this is true, then UV position floats must be between 0 and 1, representing UV positions relative to the pixels of the texture loaded.

Thisdp: /* Required Arguments */

2018-11-06T03:27:58Z

Required Arguments

← Older revision		Revision as of 03:27, 6 November 2018
Line 9:		Line 9:

	===Required Arguments===		===Required Arguments===
	*'''guiElement:''' The dgs image of which you wish to ~~retrieve~~ the UV position.		*'''guiElement:''' The dgs image of which you wish to set the UV position.
	*'''USize:''' The width of the U size of image.		*'''USize:''' The width of the U size of image.
	*'''VSize:''' The height of the V size of image.		*'''VSize:''' The height of the V size of image.

Thisdp at 03:27, 6 November 2018

2018-11-06T03:27:30Z

← Older revision		Revision as of 03:27, 6 November 2018
Line 1:		Line 1:
	__NOTOC__		__NOTOC__
	{{Client function}}		{{Client function}}
	This function ~~gets~~ the UV positon of a DGS image (Only available when there is a texture loaded in DGS image).		This function sets the UV positon of a DGS image (Only available when there is a texture loaded in DGS image).

	==Syntax==		==Syntax==
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	float, float ~~dgsImageGetUVPosition ( element dgsElement~~, bool relative )		dgsImageSetUVPosition ( element dgsElement, float UPos, float VPos, bool relative )
	</syntaxhighlight>		</syntaxhighlight>

	===Required Arguments===		===Required Arguments===
	*'''guiElement:''' The dgs ~~element~~ of which you wish to retrieve the position.		*'''guiElement:''' The dgs image of which you wish to retrieve the UV position.
			*'''USize:''' The width of the U size of image.
			*'''VSize:''' The height of the V size of image.
	*'''relative:''' This determines whether UV position is relative. If this is true, then UV position floats must be between 0 and 1, representing UV positions relative to the pixels of the texture loaded.		*'''relative:''' This determines whether UV position is relative. If this is true, then UV position floats must be between 0 and 1, representing UV positions relative to the pixels of the texture loaded.

	===Returns===		===Returns===
	Returns ~~floats representing the~~ ''U'' ~~and~~ ''V'' ~~position of the image, or false if the position could not be retrieved.~~		Returns ''true'' if succeed, ''false'' otherwise

	==Example==		==Example==

Thisdp: Created page with "NOTOC {{Client function}} This function gets the UV positon of a DGS image (Only available when there is a texture loaded in DGS image). ==Syntax==
2018-11-06T03:25:51Z

Created page with "NOTOC {{Client function}} This function gets the UV positon of a DGS image (Only available when there is a texture loaded in DGS image). ==Syntax== <syntaxhighlight lan..."

New page
NOTOC
{{Client function}}
This function gets the UV positon of a DGS image (Only available when there is a texture loaded in DGS image).

==Syntax==
<syntaxhighlight lang="lua">
float, float dgsImageGetUVPosition ( element dgsElement, bool relative )
</syntaxhighlight>

===Required Arguments===
'''guiElement:''' The dgs element of which you wish to retrieve the position.
'''relative:''' This determines whether UV position is relative. If this is true, then UV position floats must be between 0 and 1, representing UV positions relative to the pixels of the texture loaded.

===Returns===
Returns floats representing the ''U'' and ''V'' position of the image, or false if the position could not be retrieved.

==Example==
<syntaxhighlight lang="lua">
DGS = exports.dgs

local texture = dxCreateTexture("test.png") -- Example File
local image = DGS:dgsCreateImage(400,400,400,400,texture,false)
local UPos,VPos = DGS:dgsImageGetUVPosition(image,false)
DGS:dgsImageSetUVPosition(image,UPos+10,VPos+10,false)
</syntaxhighlight>

==See Also==
{{DGSFUNCTIONS}}