View source for love.graphics.newMesh (Français)

{{newin (Français)|[[0.9.0]]|090|type=function}}
Crée un nouveau [[Mesh (Français)|maillage]].

Utiliser [[Mesh:setTexture (Français)|Mesh:setTexture]] si le maillage doit être texturé à l'aide d'une [[Image (Français)|Image]] ou [[Canvas (Français)|Canvas]] lorsqu'elle est tracée.

Dans les versions antérieures à LÖVE [[11.0]], les valeurs de composantes couleurs et octets étaient dans l'étendue 0 à 255 au lieu de 0 à 1.

{{newobjectnotice (Français)}}

== Fonction ==
{{newin (Français)|[[0.10.0]]|100|type=variant}}
Crée un maillage standard utilisant les vecteurs spécifiés.
=== Synopsis ===
<source lang="lua">
mesh = love.graphics.newMesh( vertices, mode, usage )
</source>
=== Arguments ===
{{param|table (Français)|vertices|Table remplie avec les tables d'information de vecteurpour chaque vecteur comme suit :}}
{{subparam|number (Français)|[1]|Position du vecteur sur l'axe des x.}}
{{subparam|number (Français)|[2]|Position du vecteur sur l'axe des y.}}
{{subparam|number (Français)|[3] (0)|Coordonnée u (horizontale) de texture du vecteur. Les coordonnées de texture sont normalement dans une étendue [0, 1], mais peuvent être plus grandes ou moins grandes (voir [[WrapMode (Français)|WrapMode]].)}}
{{subparam|number (Français)|[4] (0)|Coordonnée v (verticale) de texture du vecteur. Les coordonnées de texture sont normalement dans une étendue [0, 1], mais peuvent être plus grandes ou moins grandes (voir [[WrapMode (Français)|WrapMode]].)}}
{{subparam|number (Français)|[5] (1)|Composante rouge de la couleur du vecteur.}}
{{subparam|number (Français)|[6] (1)|Composante vert de la couleur du vecteur.}}
{{subparam|number (Français)|[7] (1)|Composante bleu de la couleur du vecteur.}}
{{subparam|number (Français)|[8] (1)|Composante alpha de la couleur du vecteur.}}
{{param|MeshDrawMode (Français)|mode ("fan")|Façon dont les vecteurs sont utilisés lors de leur tracé. Le mode par défaut, "fan" (éventail) est suffisant pour les polygones convexes simples.}}
{{param|SpriteBatchUsage (Français)|usage ("dynamic")|Utilisation attendue du maillage. Le mode d'utilisations pécifiée affecte l'utilisation mémoire et les performances du maillage.}}

=== Retourne ===
{{param|Mesh (Français)|mesh|Le nouveau maillage.}}

== Fonction ==
{{newin (Français)|[[0.10.0]]|100|type=variant}}
Crée un maillage standard en utilisant le nombre spécifié de vecteurs.
=== Synopsis ===
<source lang="lua">
mesh = love.graphics.newMesh( vertexcount, mode, usage )
</source>
=== Arguments ===
{{param|number (Français)|vertexcount|Nombre total de vecteur que le maillage utilisera. Chaque vecteur est initialisé à <code>{0,0, 0,0, 1,1,1,1}</code>.}}
{{param|MeshDrawMode (Français)|mode ("fan")|Façon dont les vecteurs sont utilisés lors de leur tracé. Le mode par défaut, "fan" (éventail) est suffisant pour les polygones convexes simples.}}
{{param|SpriteBatchUsage (Français)|usage ("dynamic")|Utilisation attendue du maillage. Le mode d'utilisations pécifiée affecte l'utilisation mémoire et les performances du maillage.}}
=== Retourne ===
{{param|Mesh|mesh|Le nouveau maillage.}}
=== Notes ===
[[Mesh:setVertices (Français)|Mesh:setVertices]] or [[Mesh:setVertex (Français)|Mesh:setVertex]] et [[Mesh:setDrawRange (Français)|Mesh:setDrawRange]] peuvent être utilisés pour spécifier les informations des vecteurs après que le maillage ai été créé.

== Fonction ==
{{newin (Français)|[[0.10.0]]|100|type=variant}}
Crée un maillage en utilisant des attributs de vecteurs personnalisés et les données de vecteurs spécifiées.

=== Synopsis ===
<source lang="lua">
mesh = love.graphics.newMesh( vertexformat, vertices, mode, usage )
</source>
=== Arguments ===
{{param|table (Français)|vertexformat|Table de la forme <code>{attribut, …}</code>. Chaque attribut est une table qui spécifie un attribut de vecteur personnalisé utilisé pour chaque vecteur.}}
{{subparam|table (Français)|attribute|Table contenant le nom de l'attribute, son [[AttributeDataType (Français)|type de donnée]], et le nombre de composantes ddans l'attribut, sous la forme <code>{nom, type de donnée, composantes}</code>.}}
{{subparam|table (Français)|...|Tables de format d'attribut des vecteurs additionnelle.}}
{{param|table (Français)|vertices|Table remplie par des tables d'information de vecteur pour chaque vecteur, sous la forme <code>{vecteur, …}</code> où chaque vecteur est une table sous la forme <code>{composant d'attribut, …}</code>.}}
{{subparam|number (Français)|attributecomponent|Première composante du premier attribut de vecteur dans le vecteur.}}
{{subparam|number (Français)|...|Composantes supplémentairess de tous les attributs de vecteur dans le vecteur.}}
{{param|MeshDrawMode (Français)|mode ("fan")|Façon dont les vecteurs sont utilisés lors de leur tracé. Le mode par défaut, "fan" (éventail) est suffisant pour les polygones convexes simples.}}
{{param|SpriteBatchUsage (Français)|usage ("dynamic")|Utilisation attendue du maillage. Le mode d'utilisations pécifiée affecte l'utilisation mémoire et les performances du maillage.}}
=== Retourne ===
{{param|Mesh (Français)|mesh|Le nouveau maillage.}}
=== Notes ===
Les valeurs de chaque table de vecteurs sont dans le même ordre que les attributs de vecteur dans le format de vecteurs spécifié. Si aucune valeur n'est fournie pour une composante d'attribut de vecteur spécifique, elle sera définie à la valeur 0 par défaut si son [[AttributeDataType (Français)|type de donnée]] est « float » (nombre flottant), ou 1 si son type de données est « byte » (octet).

Si le type de donnée d'un attribut est « float » (nombre à virgule flottante), les composants peuvent être dans l'étendue 1 à 4, si le type de donnée est « byte » (octet) il doit être 4.

Si un attribut de vecteur personnalisé utilise le nom "VertexPosition", "VertexTexCoord", ou "VertexColor", alors tha donnée du vecteur pour cet attribut de vecteur sera utilisé pour les positions de vecteur, coordonnées de tectures ou couleurs de vecteur standard respectivement, lorsque le maillage est tracé. Dans le cas contraire, un [[Shader (Français)|ombrage de vecteur]] est requit afin d'utiliser les attributs de vecteur lorsque le maillage est tracé.

Un maillage '''doit''' comporter un attribut "VertexPosition" pour pouvoir être tracé, mais il peut être attaché depuis un maillage différent via [[Mesh:attachAttribute (Français)|Mesh:attachAttribute]].

Pour utiliser un attribut de vecteur nommé personnalisé dans un ombrage de vecteurs, il doit être déclaré comme une variable d'attribut (<code>attribute</code>) du même nom. Les variables peuvent être envoyées depuis le code des ombrages de vecteur vers le code des ombrages de pixel en créant des variables <code>varying</code>. Par exemple :

''Code d'ombrage de vecteur''
<source lang="glsl">
attribute vec2 CoolVertexAttribute;

varying vec2 CoolVariable;

vec4 position(mat4 transform_projection, vec4 vertex_position)
{
    CoolVariable = CoolVertexAttribute;
    return transform_projection * vertex_position;
}
</source>
''Code d'ombrage de pixels''
<source lang="glsl">
varying vec2 CoolVariable;

vec4 effect(vec4 color, Image tex, vec2 texcoord, vec2 pixcoord)
{
    vec4 texcolor = Texel(tex, texcoord + CoolVariable);
    return texcolor * color;
}
</source>

== Fonction ==
{{newin (Français)|[[0.10.0]]|100|type=variant}}
Crér un maillage comportant des attributs de vecteurs personnalisés et le nombre de vecteurs spécifié.
=== Synopsis ===
<source lang="lua">
mesh = love.graphics.newMesh( vertexformat, vertexcount, mode, usage )
</source>
=== Arguments ===
{{param|table (Français)|vertexformat|Table sous la forme de <code>{attribut, ...}</code>. Chaque attribut est une table qui spécifie un attribut de vecteur personnalisé utilisé pour chaque vecteur.}}
{{subparam|table (Français)|attribute|Table contenant le nom de l'attribut, son [[AttributeDataType (Français)|type de donnée]], et le nombre de composantes dans l'attribut, sous la forme de <code>{nom, type de donnée, composante}</code>.}}
{{subparam|table (Français)|...|Tables de format d'attribut de vecteur additionnel.}}
{{param|number (Français)|vertexcount|Nombre totale de vecteurs que le maillage utilisera.}}
{{param|MeshDrawMode (Français)|mode ("fan")|Façon dont les vecteurs sont utilisés lors de leur tracé. Le mode par défaut, "fan" (éventail) est suffisant pour les polygones convexes simples.}}
{{param|SpriteBatchUsage (Français)|usage ("dynamic")|Utilisation attendue du maillage. Le mode d'utilisations pécifiée affecte l'utilisation mémoire et les performances du maillage.}}
=== Retourne ===
{{param|Mesh (Français)|mesh|Le nouveau maillage.}}
=== Notes ===
Les valeurs de chaque table de vecteurs sont dans le même ordre que les attributs de vecteur dans le format de vecteurs spécifié. Si aucune valeur n'est fournie pour une composante d'attribut de vecteur spécifique, elle sera définie à la valeur 0 par défaut si son [[AttributeDataType (Français)|type de donnée]] est « float » (nombre flottant), ou 1 si son type de données est « byte » (octet).

Si le type de donnée d'un attribut est « float » (nombre à virgule flottante), les composants peuvent être dans l'étendue 1 à 4, si le type de donnée est « byte » (octet) il doit être 4.

Si un attribut de vecteur personnalisé utilise le nom "VertexPosition", "VertexTexCoord", ou "VertexColor", alors tha donnée du vecteur pour cet attribut de vecteur sera utilisé pour les positions de vecteur, coordonnées de tectures ou couleurs de vecteur standard respectivement, lorsque le maillage est tracé. Dans le cas contraire, un [[Shader (Français)|ombrage de vecteur]] est requit afin d'utiliser les attributs de vecteur lorsque le maillage est tracé.

Un maillage '''doit''' comporter un attribut "VertexPosition" pour pouvoir être tracé, mais il peut être attaché depuis un maillage différent via [[Mesh:attachAttribute (Français)|Mesh:attachAttribute]].

== Fonction ==
{{oldin (Français)|[[0.10.0]]|100|type=variant}}
=== Synopsis ===
<source lang="lua">
mesh = love.graphics.newMesh( vertices, texture, mode )
</source>
=== Arguments ===
{{param|table|vertices|The table filled with vertex information tables for each vertex as follows:}}
{{subparam|number|[1]|The position of the vertex on the x-axis.}}
{{subparam|number|[2]|The position of the vertex on the y-axis.}}
{{subparam|number|[3]|The u texture coordinate. Texture coordinates are normally in the range of [0, 1], but can be greater or less (see [[WrapMode]].)}}
{{subparam|number|[4]|The v texture coordinate. Texture coordinates are normally in the range of [0, 1], but can be greater or less (see [[WrapMode]].)}}
{{subparam|number|[5] (255)|The red color component.}}
{{subparam|number|[6] (255)|The green color component.}}
{{subparam|number|[7] (255)|The blue color component.}}
{{subparam|number|[8] (255)|The alpha color component.}}
{{param|Texture|texture (nil)|The [[Image]] or [[Canvas]] to use when drawing the Mesh. May be nil to use no texture.}}
{{param|MeshDrawMode|mode ("fan")|How the vertices are used when drawing. The default mode "fan" is sufficient for simple convex polygons.}}
=== Retourne ===
{{param|Mesh (Français)|mesh|The new mesh.}}

== Fonction ==
{{newinoldin (Français)|[[0.9.1]]|091|[[0.10.0]]|100|type=variant}}
=== Synopsis ===
<source lang="lua">
mesh = love.graphics.newMesh( vertexcount, texture, mode )
</source>
=== Arguments ===
{{param|number|vertexcount|The total number of vertices the Mesh will use. Each vertex is initialized to <code>{0,0, 0,0, 255,255,255,255}</code>.}}
{{param|Texture|texture (nil)|The [[Image]] or [[Canvas]] to use when drawing the Mesh. May be nil to use no texture.}}
{{param|MeshDrawMode|mode ("fan")|How the vertices are used when drawing. The default mode "fan" is sufficient for simple convex polygons.}}
=== Returns ===
{{param|Mesh (Français)|mesh|The new mesh.}}
=== Notes ===
[[Mesh:setVertices]] or [[Mesh:setVertex]] and [[Mesh:setDrawRange]] can be used to specify vertex information once the Mesh is created.

== Exemples ==
=== Crée et trace un maillage identique à une image tracé normalement mais avec différentes couleurs à chaque angle ===
<source lang="lua">
function love.load()
	image = love.graphics.newImage("pig.png")
	
	local vertices = {
		{
			-- Coin haut-gauche (tinté en rouge)
			0, 0, -- position du vecteur
			0, 0, -- Coordonnées de texture à la position du vecteur
			1, 0, 0, -- couleurs du vecteur
		},
		{
			-- Coin haut-droit (tinté en vert)
			image:getWidth(), 0,
			1, 0, -- Coordonnés de texture dans l'étendue [0, 1]
			0, 1, 0
		},
		{
			-- Coin bas-droit (tinté en bleu)
			image:getWidth(), image:getHeight(),
			1, 1,
			0, 0, 1
		},
		{
			-- Coin bas-gauche (tinté en jaune)
			0, image:getHeight(),
			0, 1,
			1, 1, 0
		},
	}

	-- KLe DrawMode (mode de tracé) de maillage "fan" (éventail) fonctionne bien pour les maillages de 4 vecteurs.
	mesh = love.graphics.newMesh(vertices, "fan")
        mesh:setTexture(image)
end

function love.draw()
	love.graphics.draw(mesh, 0, 0)
end
</source>

=== Crée et trace un cercle texturé comportant une teinte rouge en son centre. ===
<source lang="lua">
function CreateTexturedCircle(image, segments)
	segments = segments or 40
	local vertices = {}
	
	-- Le premier vecteur est au centre et est teinté en rouge. Nous centrons le cercle autour de l'origine (0, 0).
	table.insert(vertices, {0, 0, 0.5, 0.5, 255, 0, 0})
	
	-- Crée les vecteurs du bord du cercle.
	for i=0, segments do
		local angle = (i / segments) * math.pi * 2

		-- Cercle unité (d'un rayon de 1).
		local x = math.cos(angle)
		local y = math.sin(angle)
		
		-- Notre position est dans l'étendue [-1, 1] mais nous désirons que les coordonnées de texture soit dans l'étendue [0, 1].
		local u = (x + 1) * 0.5
		local v = (y + 1) * 0.5
		
		-- Les couleurs par vecteur sont à blanc par défaut.
		table.insert(vertices, {x, y, u, v})
	end
	
	-- Le mode de tracé "fan" (éventail) est pafait pour notre cercle.
	local mesh = love.graphics.newMesh(vertices, "fan")
        mesh:setTexture(image)

        return mesh
end

function love.load()
	image = love.graphics.newImage("pig.png")
	mesh = CreateTexturedCircle(image)
end

function love.draw()
	local radius = 100
	local mx, my = love.mouse.getPosition()
	
	-- Nous avons créé un cercle-unité, nous pouvons donc utiliser directement les paramètres d'échelle pour le rayon.
	love.graphics.draw(mesh, mx, my, 0, radius, radius)
end
</source>

=== Crée un cercle et le trace plus efficacement que love.graphics.circle. ===
<source lang="lua">
function CreateCircle(segments)
	segments = segments or 40
	local vertices = {}
	
	-- Le premier vecteur à pour origine (0, 0) et sera le centre du cercle.
	table.insert(vertices, {0, 0})
	
	-- Crée les vecteurs au bord du cercle.
	for i=0, segments do
		local angle = (i / segments) * math.pi * 2

		-- Cercle-unité.
		local x = math.cos(angle)
		local y = math.sin(angle)

		table.insert(vertices, {x, y})
	end
	
	-- Le mode de tracé "fan" (éventail) est parfait pour notre cercle.
	return love.graphics.newMesh(vertices, "fan")
end

function love.load()
	mesh = CreateCircle()
end

function love.draw()
	local radius = 100
	local mx, my = love.mouse.getPosition()
	
	-- Nous avons crée un cercle-unité, nous pouvons donc utiliser directement les paramètres d'échelle pour le rayon.
	love.graphics.draw(mesh, mx, my, 0, radius, radius)
end
</source>

== Voir également ==
* [[parent::love.graphics (Français)]]
* [[Constructs::Mesh (Français)]]
[[Category:Functions (Français)]]
[[Sub-Category::Object Creation (Français)| ]]
{{#set:Description=Creates a new [[Mesh]].}}
{{#set:Since=090}}
== Autres langues ==
{{i18n|love.graphics.newMesh}}