StartDrawing()

Syntaxe

Resultat = StartDrawing(OutputID)

Change la surface de dessin par celle mentionnée par 'OutputID'. Après avoir utilisé cette fonction, toutes les commandes de dessin seront exécutées sur la nouvelle surface. Lorsque tous les dessins sont terminés, la fonction StopDrawing() doit être appelée. Le 'Resultat' doit être toujours testé avant de continuer avec les operations de dessins, pour être sûr que la surface est disponible. La couleur d'arrière plan est le noir (ie: RGB(0,0,0)) et la couleur d'avant plan est le blanc (ie: RGB(255,255,255)).

'OutputID' peut être une des fonctions suivantes:

  WindowOutput()  : Les dessins seront rendus directement sur la fenêtre.
  ScreenOutput()  : Les dessins seront rendus directement sur l'ecran (utile pour les jeux).
  SpriteOutput()  : Les dessins seront rendus directement sur le sprite (utile pour les jeux).
  ImageOutput()   : Les dessins seront rendus directement sur l'image (voir aussi CreateImage())
  PrinterOutput() : Les dessins seront rendus directement sur l'imprimante.
  TextureOutput() : Les dessins seront rendus directement sur la texture.

Pour dessiner, les fonctions suivantes sont disponibles:

  Box()       : Carré ou rectangle
  Circle()    : Cercle
  Ellipse()   : Ellipse
  FillArea()  : Remplissage de forme
  Line()      : Ligne (largeur et hauteur)
  LineXY()    : Ligne (de x1,y1 à x2,y2)
  Plot()      : Point
  DrawImage() : Affiche une image
  DrawText()  : Affiche du texte

Note: Sous Windows, il est nécessaire de redessiner les graphiques si on utilise WindowOutput() après chaque recouvrement, réduction de la fenêtre etc.. Il est donc recommandé de créer le dessin sur une image en utilisant ImageOutput() et de l'afficher à l'aide d'un ImageGadget(). Si une mise à jour de l'image est nécessaire, il suffit d'utiliser SetGadgetState() et Windows rafraîchira correctement le dessin.

La valeur de retour 'Resultat' est le DC (Device Context) qui correspond à la surface en cours d'utilisation. Cette valeur peut être utilisée dans les commandes API nécessitant un DC.

OS Supportés

Tous