EN Teddybear - Revision history

Zorroargh at 15:47, 20 July 2018

2018-07-20T15:47:07Z

Zorroargh at 11:10, 25 February 2015

2015-02-25T11:10:28Z

Krill: Typo

2014-08-13T22:18:45Z

Typo

Krill: Update of some links

2014-08-11T21:31:32Z

Update of some links

Krill: Link toward Ryzom Forge page

2014-08-11T16:42:13Z

Link toward Ryzom Forge page

Krill: Step 13 - finish

2014-08-06T22:38:29Z

Step 13 - finish

Krill: Step 13

2014-08-06T22:23:57Z

Step 13

Krill: Step 12

2014-08-06T22:04:22Z

Step 12

Krill: Step 10

2014-08-06T21:49:17Z

Step 10

Krill: Step 9

2014-08-06T21:20:19Z

Step 9

← Older revision		Revision as of 15:47, 20 July 2018
Line 1:		Line 1:
		+	{{Migrated to\|:en:Teddybear}}
	{{TabLang\|EN\|Teddybaer\|EN Teddybear\|ES Peluche\|FR Peluche\|плюш}}		{{TabLang\|EN\|Teddybaer\|EN Teddybear\|ES Peluche\|FR Peluche\|плюш}}
	{{toTrad\|ES}}		{{toTrad\|ES}}

@@ Line 1: / Line 1: @@
-{{TabLang|EN|Teddybaer|EN Teddybear|ES|FR Peluche|RU}}
+{{TabLang|EN|Teddybaer|EN Teddybear|ES Peluche|FR Peluche|плюш}}
+{{toTrad|ES}}
-{{ToTrad}}
+{{toTrad|RU}}
 <!-- ⇩↓⇊⇓⬇ votre texte ⬇⇓⇊↓⇩ -->
@@ Line 464: / Line 463: @@
 <references />
+{{In_Category|3D}}
 {{TPInWikiRyzom}}
 [[Category:EN]]

@@ Line 30: / Line 30: @@
 * Insalling the NEL plugin of 3DSMax: https://ryzomcore.atlassian.net/wiki/display/RC/Installing+the+Max+Plugins
-==  Step 1: choosing the model we'll use for our cuddly toy ==
+==  Step 1: Choosing the model we'll use for our cuddly toy ==
 All 3d models for Ryzom fauna are gathered in the "W:\database\stuff\tryker\agents\monsters" folder, by creature family. In this tutorial, we'll use the "Gubani" model, which is located in the "horse" ("cheval" in French) folder, to create our cuddly toy:
@@ Line 72: / Line 72: @@
 [[File:03-tuto-peluche-dossier-soft-toy.png|600px]]
-==  Step 3: Cleaing the 3D model using 3DSMax ==
+==  Step 3: Cleaning the 3D model using 3DSMax ==
 The monster 3D model contains a skeleton and animation track. This is not necessary for a toy accessory and unnecessarily overburden the final ryzom model. We will delete it.

@@ Line 261: / Line 261: @@
    icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125
-Even if it can be added by hand, the proper way to do it is to use the dedicated NEL tool ''build_interface'', as explained in the https://khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet tutorial (still in French also), which recreate the global texture and the txt file from a folder with all the icons.
+Even if it can be added by hand, the proper way to do it is to use the dedicated NEL tool ''build_interface'', as explained in the http://khaganat.net/wikhan/fr:creer_icone_objet (still in French also), which recreate the global texture and the txt file from a folder with all the icons.
@@ Line 458: / Line 458: @@
 =Sources=
-https://khaganat.net/wikhan/fr:todo:dessiner:peluche
+http://khaganat.net/wikhan/fr:peluche

← Older revision		Revision as of 16:42, 11 August 2014
Line 221:		Line 221:
	[[File:22-gubani-peluche-axe.png\|400px]]		[[File:22-gubani-peluche-axe.png\|400px]]

−	If you want to know more about objects held, you can read this tutorial (still in French for now): http://~~khaganat~~.~~net~~/~~wikhan~~/~~fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu~~	+	If you want to know more about objects held, you can read this tutorial (still in French for now - link to be modified when translation is available): http://forge.ryzom.com/wiki/Objet_prehensible

@@ Line 403: / Line 403: @@
 * RYZOM_HOME on the install of the server sources
-===  Ajout du datasheet "teddygubani.sitem" au serveur   ===
+===  Adding the "teddygubani.sitem" datasheet to the server ===
-Coté serveur nous allons créer un dossier dédié pour les datasheets des peluches et y placer celui du gubani :
+On server side, we'll create a folder dedicated to the soft-toys and place the gubani's one there:
    $ mkdir $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy
    $ cp teddygubani.sitem $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy
-===  Nettoyages préalables  ===
+===  Cleaning beforehand ===
-===  Re-générer le fichier "sheet_id.bin"   ===
+===  Re-generating the "sheet_id.bin" file ===
-La première étape consiste à regénérer le fichier d'index des datasheet via la commande "make_sheet_id". Il reprend le fichier d'index existant et va le compléter avec les datasheets du dossier $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy c'est-à-dire les datasheets de nos peluches
+The first step consists in regenerating the index file for the datasheets throught the "make_sheet_id" command. It takes over the existing index file and complete it with the datasheets from the $RYZOM_LEVELPATH/leveldesign/game_element/sitem/soft-toy folder, namely the datasheets for our soft-toys.
    $ make_sheet_id -o$LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin $LEVELDESIGNPATH/leveldesign/game_element/sitem/soft-toy
-===  Re-générer les "*.packed_sheets" et "visual_slot.tab"  ===
+===  Re-generating the "*.packed_sheets" and "visual_slot.tab"  ===
-Il faut regénérer les "*.packed_sheets".Ce sont les versions pré-compilées des datasheets :
+The "*.packed_sheets" have to be regenerated. These are the pre-compiled versions of the datasheets:
    $ sheets_packer
-Cette commande va également re-générer le fichier visual_slot.tab
+This command also regenerate the visual_slot.tab file.
-===  Copier les fichiers nécessaires coté client  ===
+===  Copying the needed files on the client side ===
-* Nous copions le fichier "visual_slot.tab" généré dans le dossier courant dans le dossier "user" du client de jeu
+* Copy the "visual_slot.tab" file generated in the current folder into the "user" folder of the game client
-* Nous copions le fichier $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin dans le dossier "user" du client de jeu
+* Copy the $LEVELDESIGNPATH/leveldesign/Game_elem/sheet_id.bin file into the "user" folder of the game client
-* Nous remplaçons les fichiers packet_sheets du dossier "data" du client par ceux générés ici $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets par la commande ''sheets_packer''
+* Replace the packet_sheets files in the "data" folder of the client, with the ones generated in $RYZOM_HOME/code/ryzom/client/data/*.packed_sheets using the ''sheets_packer'' command
-===  Créer un bnp pour le modèle de la peluche  ===
+===  Creating a bnp for the soft-toy model ===
-Pour finir il faut copier le shape et la texture de la peluche dans le dossier "data" du client.
+To end this, you'll have to copy the shape and the texture of the soft-toy into the "data" folder of the client.
-Cependant pour bien faire les choses, autant créer un fichier ".bnp" dédié.
+However, in order to work cleanly, let's create a dedicaed ".bnp" file.
-Un fichier ".bnp" est une sorte de zip regroupant les différents fichiers shape, dds, txt, ou autres par thème.
+A ".bnp" file is some sort of zip that gathers the various shape, dds, txt, or other files on a same theme.
-Créer on dossier "soft-toy", copions y  tous les shapes et textures de nos peluche, à savoir pour le moment "ge_acc_teddy-gubani_01.shape" et "ge_acc_teddy-gubani_01.dds" et créons un fichier BNP pour les contenur
+Let's create a "soft-toy" folder, and copy in it all the shapes and textures for our soft-toys, meaning for now "ge_acc_teddy-gubani_01.shape" and "ge_acc_teddy-gubani_01.dds" and let's create a BNP file to contain them
    bnp_make /p soft-toy
-La commande va créer un fichier "soft-toy,bnp" qui contiendra nos deux fichiers. A présent il faut le copier dans le dossier "data" du client.
+The command will create a "soft-toy,bnp" file, which will contain our two files. Now, let's copy it in the "data" folder of the client.
-===  Tester IG  ===
+===  Testing IG  ===
-Relancer le serveur avec la commande ''shard start'' puis connectez vous avec votre client.
+Restart the server with the ''shard start'' command and connect with your client.
-Si tout c'est bien déroulé, en lançant votre client de jeu, vous pouvez créer une peluche dans votre inventaire avec la commande :
+If everything went well, when starting your game client, you can create a soft-toy in your inventory with this command:
    /a createItemInBag teddygubani 1 5

@@ Line 378: / Line 378: @@
 </pre>
-==  Étape 13 : Déployer la peluche sur le serveur et le client de jeu   ==
+==  Step 13: Deploying the soft-toy on the game server and client ==
-Afin de déployer la peluche en jeu la méthode officielle consiste à utiliser la pipeline "build_gamedata" (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). Je vais vous proposer une méthode différente, où les opérations seront effectués à la mains, mais uniquement celles nécessaires à notre peluche :
+In order to deploy the soft toy in game, the official method consists in using the "build_gamedata" pipeline (cf. https:''ryzomcore.atlassian.net/wiki/display/RC/Gamedata+Build+Pipeline). I'll propose you a different method, where the actions will be done by hand but only the ones required for the soft-toy:
-Nous avons besoin des fichiers suivants :
+We'll need the following files:
-* teddygubani.sitem ( le datasheet de la peluche gunabi )
+* teddygubani.sitem (the datasheet for the teddy-gubani)
-* ge_acc_teddy-gubani_01.shape ( le modèle 3d NEL de la peluche )
+* ge_acc_teddy-gubani_01.shape (the 3d NEL model for the soft-toy)
-* ge_acc_teddy-gubani_01.dds ( la texture du modèle 3d )
+* ge_acc_teddy-gubani_01.dds (the texture for the 3d model)
-De plus le déploiement de cette peluche va impacter les fichiers suivants :
+Moreover, deploying this soft-toy will impact the following files:
-* les fichiers "*.packed_sheets" utilisée par le serveur et le client qui sont une version compilé des datasheets
+* the "*.packed_sheets" files used by the server and the client, which are a compiled version of the datasheets
-* le fichier "sheet_id.bin" qui est un index de tous les datasheets utilisés par le jeu
+* the "sheet_id.bin" file, which is an index of all the datasheets used by the game
-* le fichier "visual_slot.tab" qui liste les éléments affichables coté client
+* the "visual_slot.tab" file, which lists the items that can be showed on client side
-Pour bien faire les choses, nous allons également créer un fichier "soft-toy.bnp" qui contiendra les shapes et les textures de toutes les futures peluches.
+To work properly, we'll also create a "soft-toy.bnp" file, which will include the shapes and the textures for all the future soft-toys.
-Pour la suite des opérations nous partons du principe que notre serveur de jeu fonctionne sous linux, et que les variables d'envrionnement suivantes sont définies :
+For the next operations, we'll consider that our game server uses linux, and that the following environement variable are defined as follow:
-* LEVELDESIGNPATH pointe sur le dossier des datas du level design
+* LEVELDESIGNPATH points out the folder for the datas of the level design
-* RYZOM_HOME sur l'installation des sources du serveur
+* RYZOM_HOME on the install of the server sources
 ===  Ajout du datasheet "teddygubani.sitem" au serveur   ===

@@ Line 272: / Line 272: @@
-==  Etape 11 : créer le fichiers des noms  ==
+==  Step 11: Creating the names file ==
-A compléter.
+To be completed.
 [[File:30-tuto-peluche-txtfile.png]]
@@ Line 281: / Line 281: @@
-==  Étape 12 : créer le datasheet   ==
+==  Step 12: Creating the datasheet ==
-A la base, une peluche reste est un objet porté comme une arme. De fait le datasheet de la peluche est trs semblable à celui d'une arme une main, comme l'exemple de la dague ci-dessous.
+Basically, a soft-toy remains an object held like a weapon. Actually, the datasheet for the soft-toy is very similar to the one of a one-handed weapon, such as the dagger's example below.
-__icrm1pd.sitem  ( datasheet de la dague du réfugié ) :__
+__icrm1pd.sitem  ( datasheet for the refugee dagger):__
 <pre>
@@ Line 317: / Line 317: @@
 </pre>
-Ce qui change c'est :
+What will be changed is:
-* la référénce au shape dans la section "3d"
+* the reference for the shape in the "3d" section
        <ATOM Name="shape" Value="ge_acc_teddy-gubani_01.shape"/>
        <ATOM Name="shape_female" Value="ge_acc_teddy-gubani_01.shape"/>
-* la référence à l'icone utilisé dans la barre d'état et l'inventaire dans la section "3d"
+* the reference for the icon used in the action bar and in the inventory in the "3d" section
        <ATOM Name="icon" Value="icon_teddygubani.tga"/>
        <ATOM Name="icon overlay" Value="icon_teddygubani.tga"/>
-* les caractéristiques de base qui diffèrent d'une arme : pas de niveau requis, pas de brique de plan, etc..
+* the base features which differ from the ones of a weapon: no level required, no craft stanza, etc...
      <STRUCT Name="basics">
@@ Line 342: / Line 342: @@
-Voila donc le datasheet de la peluche gubani  que nous nommerons "teddygubani.sitem" :
+Here is then the datasheet for the teddy-gubani which will be called  "teddygubani.sitem":
 <pre>

@@ Line 204: / Line 204: @@
-==  Step 9: orientation and positionning of an object hold in hand ==
+==  Step 9: Orientating and positionning an object hold in hand ==
 The fastening point for an object hold in hand is at the point with (0,0,0) coordinates of the object. Its orientation obeys the following rule:
@@ Line 224: / Line 224: @@
-==  Étape 9 : Créer l’icône pour l'inventaire et la barre d'actions  ==
+==  Step 10: Creating the icone for inventory and actions bar ==
-Il faut créer un icône pour l'affichage de l'item peluche gubani dans l'inventaire et dans la barre  d'actions.
+You have to create an icon to show the teddy-gubani item in the inventory and in the action bar.
-Cet au icône au format tga doit faire 40x40 pixels avec un fond transparent. Nous le nommerons "icon_teddygubani.tga"
+This icon in tga format has do be of size 40x40 pixels, with a transparent background. We'll name it "icon_teddygubani.tga"
-L'icône de 40x40 pixels :
+The 40x40 pixels icon:
 [[File:23-icone-gubani.png|80px]]
-Pour des questions de performance, ces icônes ne sont pas stockés individuellement mais regroupés dans une seule image dénommée : "texture_interfaces_v3.tga". Le fichier texte associé dénommé "texture_interfaces_v3.txt" liste les icones présents et leur position dans l'image :
+For performance reasons, these icones aren't stored individually but gathered under one single image names: "texture_interfaces_v3.tga". The text file associated to it is called "texture_interfaces_v3.txt" and provides the list of all present icons and their position in the image:
 [[File:23-icone-gubani-contexte-txt.png]]
-le fichier texte utilise le format suivant pour chaque ligne :
+The text file uses the following format for each line:
    NomFichierIcone u1 v1 u2 v2
-Avec :
+Where:
-* u1,v1 la position du point supérieur gauche de l'icône
+* u1,v1 is the position of the upper left corner of the icon
-* u2,v2 la position du coin inférieur droit de l'icône
+* u2,v2 is the position of the lower righ corner of the icon
-A la différence des coordonnées en pixels, ces coordonnées qui utilisent la technique du UV Mapping en 3d ont leurs valeurs dans l’intervalle [0 .. 1]. la coordonnée (0,0) correspond au point supérieur gauche de l'image et (1,1) au point inférieur droit de l'image.
+Unlike coordinates in pixels, these coordinates are using the 3D UV Mapping technique, and have their valeus in [0 .. 1] interval. The (0,0) coordinate is the upper left corner of the image and (1,1) is the bottom right corner of the image.
-Le passage d'un système à l'autre est simple. Soit (x1,y1) la position en pixels du coin haut gauche de notre icône dans l'image globale et (x2,y2) la position du point inférieur droit de l'icône dans l'image, alors :
+Passing from one system to the other one is simple. Let (x1,y1) be the place of the upper left corner of our icon in the global image and (x2,y2) the place for its bottom right corner, then:
-* u1 = x1 / largeur-image
+* u1 = x1 / image width
-* v1 = y1 / hauteur-image
+* v1 = y1 / image height
-* u2 = x2 / largeur-image
+* u2 = x2 / image width
-* v2 = y2 / hauteur-image
+* v2 = y2 / image height
-Sachant que la texture "texture_interfaces_v3.tga" fait 1024x1024 pixel, et que dans l'exemple l'icône "icon_teddygubani.tga" se situe à la position (x1=118,y1=798), que le point inférieur gauche étant à la position (x2=157,y2=837), le fichier txt contient donc la ligne :
+Knowhing that the "texture_interfaces_v3.tga" texture has a size of 1024x1024 pixels, and that in the example the "icon_teddygubani.tga" icon is located in position (x1=118,y1=798), that the bottom left corner is in (x2=157,y2=837), the text file contains the line:
    icon_teddygubani.tga 0.115234375 0.779296875 0.1533203125 0.8173828125
-Même si cela peut être ajouté à la main, la bonne méthode et d'utiliser l'outil dédié de NEL ''build_interface'' comme indiqué dans le tutorial https://khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet qui recrée la texture globale et le fichier txt à partir d'un dossier contenant tous les icones.
+Even if it can be added by hand, the proper way to do it is to use the dedicated NEL tool ''build_interface'', as explained in the https://khaganat.net/wikhan/fr:todo:dessiner:creer_icone_objet tutorial (still in French also), which recreate the global texture and the txt file from a folder with all the icons.
-Note: L'ajout de l'icône ne suffit pas, il faut également créer le datasheet de l'objet peluche et spécifier dedans le nom de notre icône à utiliser comme nous le verrons plus loin dans ce tutorial. Au final nous obtenons le résultat suivant IG :
+Nota: Adding the icon isn't enough, you'll also have to create the datasheet for the soft-toy object and specify in it the name of the icon to be used, as will be seen later in this tutorial. By the end, we're getting the following result IG:
 [[File:23-icone-gubani-contexte.png]]

@@ Line 204: / Line 204: @@
-==  Étape 9 : orientation et positionnement d'un objet porté  ==
+==  Step 9: orientation and positionning of an object hold in hand ==
-Le point de fixation d'un objet tenu en main correspond au point de coordonnée (0,0,0) de l'objet.Son orientation suit la règle suivante  :
+The fastening point for an object hold in hand is at the point with (0,0,0) coordinates of the object. Its orientation obeys the following rule:
-   l'axe X remonte le long de l'avant-bras ;
+   X axe goes up along the forearm;
-   l'axe Y part depuis le dos de la main vers l'extérieur ;
+   Y axe starts from the back of the hand towards outside;
-   l'axe Z pointe vers le haut de l'objet tenu fermement en main.
+   Z axe points towards the top of the object firmly hold in hand.
-Nous réorientons la peluche gubani dans 3dsmax comme le montre l'image suivante : l'axe X sort du dos du gubani pour remonter le long du bras qui le portera. L'axe Z sort de la main et est donc dans le prolongement de la tête de la peluche :
+We realign the teddy-gubani in 3DSMax as shown in the following image: X axe exits the gubani's deck to go up the arm that will hold it. Z axe exist the hand and is hence probably in the extension of the soft-toy's head:
 [[File:22-gubani-peluche-axe-3dsmax.png]]
-Après réorientation du modèle gubani et réexportation du shape nous obtenons enfin une peluche qui est tenue par le tronc :
+After realigning the gubani model and re-exporting the shape, we get a plushy which is hold by its trunk:
 [[File:22-gubani-peluche-axe.png|400px]]
-Pour aller plus loin sur les objets portés, je vous conseille de lire ce tutorial :  http://khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu
+If you want to know more about objects held, you can read this tutorial (still in French for now): http://khaganat.net/wikhan/fr:todo:dessiner:creation_d_un_objet_prehensible_en_jeu