<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<!DOCTYPE MAN SYSTEM "../../manrev.dtd">
<MAN>
  <LANGUAGE>fr</LANGUAGE>

  <TITLE>xset</TITLE>

  <TYPE>Scilab Function</TYPE>

  <DATE>April 1993</DATE>

  <SHORT_DESCRIPTION name="xset">change des valeurs du contexte
  graphique</SHORT_DESCRIPTION>

  <CALLING_SEQUENCE>
    <CALLING_SEQUENCE_ITEM>xset(choice-name,x1,x2,x3,x4,x5)</CALLING_SEQUENCE_ITEM>

    <CALLING_SEQUENCE_ITEM>xset()</CALLING_SEQUENCE_ITEM>
  </CALLING_SEQUENCE>

  <PARAM>
    <PARAM_INDENT>
      <PARAM_ITEM>
        <PARAM_NAME>choice-name</PARAM_NAME>

        <PARAM_DESCRIPTION>
          <SP>: chaîne de caractères</SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>

      <PARAM_ITEM>
        <PARAM_NAME>x1,...,x5</PARAM_NAME>

        <PARAM_DESCRIPTION>
          <SP>: dépend de <VERB>choice-name</VERB></SP>
        </PARAM_DESCRIPTION>
      </PARAM_ITEM>
    </PARAM_INDENT>
  </PARAM>

  <DESCRIPTION>
    <P><VERB>Remarque Importante : </VERB>Les versions Scilab 4.x seront les
    dernières à  fonctionner avec l'ancien mode graphique.</P>

    <P><VERB>xset</VERB> est utilisée pour changer des valeurs du contexte
    graphique de la fenêtre graphique courante.</P>

    <P>Quand elle est appelée sans argument, une boîte de dialogue est
    affichée avec les valeurs courantes et des changements peuvent être
    effectués à &#160; l'aide de boutons.</P>

    <P>Utiliser <VERB>xset()</VERB> pour afficher ou changer la couleur
    courante, le marqueur ou la police.</P>

    <DESCRIPTION_INDENT>
      <DESCRIPTION_ITEM label="xset(&quot;alufunction&quot;,number)">
        <SP>: utilisé pour changer l'opérateur logique de dessin L'opérateur
        est choisi avec <VERB>x1</VERB>. Les valeurs habituelles sont : 3 pour
        la copie (par défaut), 6 pour le ou exclusif (pour faire des
        animations) et 0 pour effacer. Voir <VERB>alufunctions</VERB> pour
        plus de détails.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;auto clear&quot;,&quot;on&quot;|&quot;off&quot;)">
        <SP>: Met "on" ou "off" le mode d'effacement automatique des
        graphiques. Quand le mode est "on", les dessins successifs ne sont pas
        superposés, i.e. la commande <VERB>xbasc()</VERB> (effacement de la
        fenêtre graphique et effacement des graphiques enregistrés) est
        exécutée avant chaque commande graphique de haut niveau (plot2d par
        exemple). La valeur par défaut est "off".</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;background&quot;,color)">
        <SP>: Change la couleur d'arrière plan de la fenêtre graphique
        courante. La fenêtre graphique courante désigne la zone des axes où
        les dessins sont dessinés, pas la figure entière.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;clipping&quot;,x,y,w,h)">
        <SP>: Définit la zone de clipping (la zone de la fenêtre graphique où
        les dessins peuvent être dessinés) comme le rectangle (x,y,w,h) (point
        en haut à &#160; gauche, largeur, hauteur). Cette fonction utilise
        l'échelle courante de la fenêtre graphique.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;color&quot;,value)">
        <SP>: Définit la couleur par défaut de tracé de ligne, de remplissage,
        de texte, pour toutes les fonctions de dessin. <VERB>value</VERB> est
        un entier projeté sur l'intervalle [0,whiteid]. 0 est utilisé pour le
        noir et whiteid pour le blanc. La valeur de whiteid peut être obtenue
        avec <VERB>xget("white")</VERB>.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;colormap&quot;,cmap)">
        <SP>: Définit la table des couleurs à &#160; partir d'une matrice m x
        3. m est le nombre de couleurs. La couleur numéro i est donnée comme
        le triplet cmap(i,1), cmap(i,2), cmap(i,3) correspondant
        respectivement aux intensités de rouge, vert et bleu, comprises entre
        0 et 1.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;dashes&quot;,i)">
        <SP>: en mode noir et blanc (<VERB>xset("use color",0)</VERB>),
        choisit le style de pointillé numéro i (0 pour une ligne continue). En
        mode couleur (<VERB>xset("use color",1)</VERB>) cette commande est
        utilisée pour choisir la couleur du marqueur, des lignes et du texte.
        Ce mot-clé est obsolète, utiliser <VERB>xset('color',i)</VERB> et
        <VERB>xset('line style',i)</VERB> à &#160; la place.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;default&quot;)">
        <SP>: Réinitialise le contexte graphiques aux valeurs par défaut.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;font&quot;,fontid,fontsize) : choisit la police courante et sa taille.">
        <SP>Noter que <VERB>fontsize</VERB> s'applique aussi à &#160; toutes
        les polices autres que <VERB>fontid</VERB> .</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;font size&quot;,fontsize)">
        <SP>: Choisit la taille des polices.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;foreground&quot;,color)">
        <SP>: Choisit la couleur de premier plan pour la fenêtre graphique
        courante.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;fpf&quot;,string)">
        <SP>: Change le format des nombres affichés sur les courbes de niveau,
        où <VERB>string</VERB> précise le format comme en langage C (par
        exemple <VERB>string="%.3f"</VERB>). Utiliser <VERB>string=""</VERB>
        pour revenir au format par défaut.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;hidden3d&quot;,colorid) : Choisit la couleur des parties arrières dans la fonction plot3d.">
        <SP><VERB>colorid=0</VERB> supprime l'affichage des parties arrières
        des objets 3D. Il s'agit d'une technique dénommée 'culling' et permet
        d'accélérer le rendu des surfaces fermées.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;line mode&quot;,type)">
        <SP>: Cette fonction est utilisée pour changer le mode de dessin des
        lignes. Mode absolu pour type=1 et relatif avec type=0. (attention :
        le mode type=0 est buggé)</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;line style&quot;,value)">
        <SP>: Choisit le style de ligne (1: continu, &gt;1 pour les
        pointillés).</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;mark&quot;,markid,marksize)">
        <SP>: Choisit le marqueur ainsi que sa taille. Utiliser
        <VERB>xset()</VERB> pour voir les marqueurs. Noter que
        <VERB>marksize</VERB> s'applique aussi à &#160; tous les marqueurs
        autres que <VERB>markid</VERB>.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;mark size&quot;,marksize)">
        <SP>: Choisit la taille de marqueur</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;pattern&quot;,value)">
        <SP>: Choisit le motif pour les fonctions de remplissage.
        <VERB>value</VERB> est un entier projeté sur l'intervalle [0,whiteid].
        0 est utilisé pour le noir et whiteid pour le blanc. La valeur de
        whiteid peut être obtenue avec <VERB>xget("white")</VERB>. "pattern"
        est équivalent à &#160; "color".</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;pixmap&quot;,flag)">
        <SP>Si flag=0 les graphiques sont dessinés directement sur l'écran. Si
        flag=1 les graphiques sont dessinés sur un pixmap et sont affichés
        à &#160; l'écran avec la commande <VERB>xset("wshow")</VERB>. Le pixmap
        est effacé avec la commande <VERB>xset("wwpc")</VERB>. Noter que la
        commande <VERB>xbasc()</VERB> efface aussi le pixmap.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;thickness&quot;,value)">
        <SP>: Choisit l'épaisseur des lignes en pixels (0 et 1 = épaisseur de
        1 pixel).</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;use color&quot;,flag)">
        <SP>Si flag=1 alors <VERB>xset("pattern",.)</VERB> ou
        <VERB>xset("dashes",.)</VERB> changent la couleur de dessin ou de
        remplissage. Si flag=0 on passe en mode pointillés et noir et
        blanc.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;viewport&quot;,x,y)">
        <SP>: Choisit la position de la fenêtre glissante.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;wdim&quot;,width,height)">
        <SP>: Choisit la largeur et la hauteur de la fenêtre graphique
        courante. Cette option n'est pas prise en compte par le pilote
        PostScript.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;wpdim&quot;,width,height)">
        <SP>: Choisit (en pixels) la largeur et la hauteur de la fenêtre
        graphique courante physique (qui peut être différente de la taille
        réelle en mode wresize=1). Cette option n'est pas prise en compte par
        le pilote PostScript.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;window&quot;,window-number)">
        <SP>: Choisit la fenêtre <VERB>window-number</VERB> comme fenêtre
        graphique par défaut et crée cette fenêtre si elle n'existe pas.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;wpos&quot;,x,y)">
        <SP>: Choisit la position (en pixels) du point en haut à &#160; gauche
        de la fenêtre graphique.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;wresize&quot;,flag)">
        <SP>Si flag=1 alors les graphiques sont automatiquement redimensionnés
        de manière à &#160; remplir la fenêtre graphique.</SP>

        <VERBATIM>xdel();xset("wresize",1);plot2d();xset("wdim",1000,500)</VERBATIM>

        <P>Si flag=0 l'échelle des graphiques est inchangée quand la fenêtre
        est redimensionnée. Le "panner" en haut à &#160; gauche de la fenêtre
        ou les flèches du clavier peuvent être utilisées pour faire glisser le
        contenu de la fenêtre.</P>

        <VERBATIM>xdel();plot2d();xset("wresize",0);xset("wdim",1000,500)</VERBATIM>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;wshow&quot;)">
        <SP>: Voir <VERB>xset("pixmap",1)</VERB> ci-dessus.</SP>
      </DESCRIPTION_ITEM>

      <DESCRIPTION_ITEM label="xset(&quot;wwpc&quot;)">
        <SP>: Voir <VERB>xset("pixmap",1)</VERB> ci-dessus.</SP>
      </DESCRIPTION_ITEM>
    </DESCRIPTION_INDENT>
  </DESCRIPTION>

  <SEE_ALSO>
    <SEE_ALSO_ITEM>
      <LINK>colormap</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>xget</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>getcolor</LINK>
    </SEE_ALSO_ITEM>

    <SEE_ALSO_ITEM>
      <LINK>getsymbol</LINK>
    </SEE_ALSO_ITEM>
  </SEE_ALSO>

  <AUTHOR>J.Ph.C.</AUTHOR>
</MAN>