vers l'index général de l'aide / vers l'index des directives
La console, c'est l'endroit où POV-Ray écrit les messages d'erreurs, les avertissements, les statistiques, etc... Selon les systèmes, la console peut comporter des zones distinctes (version MS-DOS, par exemple) ou les messages sont tous envoyés au même endroit (versions Windows ou Macintosh, par exemple). Une série de directives permettent à l'utilisateur d'envoyer lui-même des messages vers la console.
POV-Ray 3.0 +sup.
POV-Ray 3.5 (simplifications)
Les directives de messages se placent à n'importe quel endroit du script (sauf à l'intérieur d'une autre instruction, bien entendu !).
#debug Chaine1
Envoie le message contenu dans la chaîne vers la console, sans autre incidence sur le déroulement du script. Cette directive est souvent employée pour la mise au point des scripts, en affichant les valeurs prises par certaines variables, ou en signalant qu'une action a été effectuée.
#render Chaine1
#statistics Chaine1
Ont le même effet que #debug, depuis POV-Ray 3.5 (auparavant, ils avaient leur section propre dans la console).
#warning Chaine1
Fonctionne comme #debug, en écrivant "Warning : " avant la chaîne. Cette directive s'utilise surtout dans les #macros, pour avertir l'utilisateur qu'il en fait un usage pas très orthodoxe (valeurs anormales,...).
#error Chaine1
Envoie le message vers la console correspondante, et stoppe l'interprétation du script. On peut s'en servir par exemple dans une #macro, au cas où certaines valeurs d'un paramètre risquent d'apporter de graves aberrations dans le résultat final.
Dans "debug.inc" :
Debug_Inc_Stack() : active un 'suivi' des fichiers standard inclus, qui enverront chacun un message
signalant leur 'activation'.
Set_Debug(Bool) : activation/désactivation globale des macros de 'debug.inc'.
Debug_Message(Str) : envoyer un message vers la console 'debug'.
Debug(Condition, Message) : envoyer un message vers 'debug', si une condition est vraie.
Warning(Condition, Message) : envoyer un message vers 'warning', si une condition est vraie.
Error(Condition, Message) : envoyer un message vers 'error', si une condition est vraie.
Rédacteur: Fabien Mosen