Outils de Ryzom Core

Kervala a compilé divers outils utilisés dans la galaxie Ryzom Core. Ils sont disponibles ici : http://ryzom.kervala.net/clients/.

animation_set_builder [animation_set.animset] [animation.anim]

This command line add or replace the animation.anim animation into the animation_set.animset animation set

Voilà tout ce qu'on peut en savoir.

Cet outil est utilisé pour la 3D.

anim_builder [directoryIn] [pathOut] [parameter_file] 

Bonne chance !

Sert à construire des animations ? Dans les outils “3D”.

bnp_make permet de dé/packager les .bnp

Les paramètres sont : /p pour créer, /u pour dépackager /l pour lister

$ bnp_make /u nom_ficher.bnp
$ bnp_make /l fichier.bnp | grep dds

Pour dépackager tous les bnp d'un coup :

$ for i in /repertoiredetravail/*.bnp ; do ./bnp_make /u $i ; done

Articles en rapport :

• Outils texture
• Texture du terrain

Cet outil sert à créer des textures éloignées pour les quatre saisons.

On utilise le fichier *.bank (simple, sans déclinaison de saison : desert.bank) comme source.

Pour créer un fichier desert_au.farbank dans database/landscape/_texture_tiles/desert_au/ :

• il faut avoir exactement la même hiérarchie de sous-répertoires avec les fichiers de textures ayant les même noms que dans database/landscape/_texture_tiles/desert/ mais avec un suffixe _au (par exemple desert_sable_01.tga → desert_sable_01_au.tga) ;
• il faut avoir déjà créé le fichier .bank, qui sera dans notre exemple desert.bank, situé à database/landscape/_texture_tiles/desert/.

On se place ensuite dans le repértoire database/landscape/_texture_tiles/desert_au/ et on génère alors le fichier farbank :

$ build_far_bank ../desert/desert.bank desert_au.farbank -d. -p_au -f

L'option -d. indique le répertoire actuel comme répertoire racine de ce smallbank.
L'option -p_auindique que l'on génère la version _au du smallbank.
L'option -f demande le recalcul des images.

C'est un outil en ligne de commande qui permet de générer les .tga utilisés en jeu pour l'interface, à partir de tous les petits fichiers image qui les composent.

On peut utiliser des caractères génériques dans les noms des répertoires. On peut ainsi inclure plusieurs répertoires rapidement :

$ build_interface Mon_interface interface*

Cette commande permettra de générer un nouveau fichier Mon_interface.tga à partir du contenu de tous les sous-répertoires qui commencent par interface. Il générera en même temps Mon_interface.txt qui sera le fichier lié, décrivant le contenu de l'image et les correspondances entre les emplacements et les noms des images à appeler.

C'est un utilitaire en ligne de commande qui permet de calculer les ombres projetées par un .shape d'un objet animé. Il faut impérativement que les .shape de créatures pouvant être animées se voient appliqué cet outil sans quoi elles ne projeteront pas d'ombre.

Utilisation :

$ build_shadow_skin shape_in shape_out [facePercentage] [maxFaces]

Avec les paramètres suivants :

• shape_in :le nom du fichier entrant
• shape_out: le nom du fichier de sortie (qui peut être le même que celui d'entrée, pour l'écraser)

L'outil accepte en argument optionnel les deux paramètres suivants (il prendra le plus petit des deux en valeur si les deux sont donnés) :

• facePercentage : Pourcentage des faces du mesh à prendre en compte, en %
• maxFaces : Nombre de faces à prendre en compte

Exemple :

$ for i in *.shape ; do build_shadow_skin $i $i ; done

Permet de créer les informations d'ombrage pour tous les fichiers .shape du répertoire courant, en les écrasant.

Il sert à créer un fichier allégé pour les textures, celui qui sera utilisé par le système en jeu de préférence au .bank

On utilise le fichier *.bank simple, pas ceux des déclinaisons saisonnières.

Exemple:

$ build_smallbank jungle.bank jungle.smallbank

Outil servant à afficher les informations sur un fichier .ig

$ ig_info fichier.ig

Il retourne un certain nombre d'informations :

• Origine (X, Y, Z)
• Instances contenues (avec leur position absolue et leur Scale, en X Y Z)
  • les .shape , nommés sans extension
  • les.ps système de particules, nommés avec leur extension
• Lights

Création du fichier “sheet_id.bin” qui sert au server à …….

$ make_sheet_id -o/home/compil/khaganat-data/leveldesign/game_elem/sheet_id.bin /home/compil/khaganat-data/leveldesign/game_elem /home/compil/khaganat-data/leveldesign/game_element /home/compil/khaganat-data/leveldesign/world /home/compil/khaganat-data/leveldesign/ecosystems /home/compil/khaganat-data/sound

Creation du fichier “visual_slot.tab” qui sert au shard à …………..

$ cd /home/compil/khaganat/code/ryzom/tools/sheets_packer
 
$ ./sheets_packer

Pensez à vos chemin dans sheets_packer.cfg:

/////////////////////////////////
/////////////////////////////////
/// SHEETS PACKER CONFIG FILE ///
/////////////////////////////////
/////////////////////////////////
DataPath = { "../../common/data_leveldesign", "../../common/data_common", "../../client/data", "../../../../../khaganat-data/common", "../../../../../khaganat-data/leveldesign", "../../../../../khaganat-data/primitives" };
WorldSheet = "ryzom.world";
PrimitivesPath = "../../../../../khaganat-data/primitives";
OutputDataPath = "../../client/data";
LigoPrimitiveClass = "world_editor_classes.xml";

Cet outil permet de convertir une image PNG ou TGA au format DDS et générer automatiquement le mipmap associé. Ne pas créer directement le DDS avec Gimp, certains paramètres ne seront pas bon.

tga2dds fichier_source [-o fichier_destination.dss] [-a <algo>] [-m]

Exportez depuis Gimp la texture modifiée au format tga ou png, ensuite en ligne de commande

$ tga2dds xxx.tga -m

Traitement par lot de toutes les images .tga d'un dossier :

$ for i in ./*.tga ; do ./tga2dds $i -m ; done

Articles en rapport :

• Outils texture

Extrait de la doc de base.

ZVIEWER permet de visioner une ou plusieurs zones exportées depuis 3DSMax au format de NeL, en utilisant le moteur.

Le répertoire d'où est exécuté le programme doit contenir le fichier ZVIEWER.CFG qui contient les paramètres de configuration. Sans ce fichier aucune zone ne sera affichée. Lorsqu'il n'y a pas de fichier de configuration à l’exécution un fichier type est généré.

Exemple de config :

• FullScreen = 0; 0 : windowed / 1 : fullscreen
• Width = 800; largeur de la fenêtre.
• Height = 600; hauteur de la fenêtre.
• Depth = 32; nombre de couleurs (32bits,24bits,…).
• Position = { 1088.9, -925.7, -1234.0 }; position initiale (x,y,z). Correspond aux coordonnées dans Max (Generic Units). La position est automatiquement snapée au sol quelque soit la coordonnée en z.
• EyesHeight = 1.80; hauteur des yeux pour le mode Walk.
• Background = { 100, 100, 255 }; couleur rgb du fond.
• ZFar = 1000.0; distance de clipping. Plus la distance est grande, plus on voit loin.
• LandscapeTileNear = 50.0; valeur du near. Plus cette valeur est grande, plus la zone du near est grande.
• LandscapeThreshold = 0.001; Seuil utilisé pour la subdivision adaptative. Quand la valeur augmente, la qualité de la subdivision diminue (reduit le temps de calcul). Mis au minimum par défaut (0.001).
• BanksPath = “C:\WINDOWS\Bureau\zviewer\” ; chemin des banks (<bank>.bank et <bank>.farbank).
• Bank = “fyros_landf.bank” ; nom de la bank (meme racine que la farbank).
• TilesPath = “C:\WINDOWS\Bureau\zviewer\tiles” ;
• ZonesPath = “C:\WINDOWS\Bureau\zviewer\zones” ; chemin des zones.
• IgPath = “C:\WINDOWS\Bureau\zviewer\ig” ;
• ShapePath = “C:\WINDOWS\Bureau\zviewer\shapes” ;
• MapsPath = “C:\WINDOWS\Bureau\zviewer\maps” ;
• Zones = { “3_AC.zonel”,“3_AD.zonel” }; liste des noms des zones
• Zonessave = { “3_AC.zonel”,“3_AD.zonel” };
• Zones = { “3_AC.zonel”,“3_AD.zonel” };
• Ig = { “3_AC.ig”,“3_AD.ig” };

Les déplacements se font à l'aide de la combinaison clavier/souris. Il existe 2 modes de déplacement : FreeLook et Walk (défaut).

• Le mode FreeLook permet de se déplacer dans la direction du regard(idem cstrike).
• Dans le mode Walk le déplacement se fait au niveau du sol, à hauteur des yeux. L'utilisateur reste collé au sol.

La souris permet d'orienter le regard dans toutes les directions. Le clavier permet de se déplacer.