ClipOutput()

Syntaxe

ClipOutput(X, Y, Largeur, Hauteur)
Description
Définit un cadre d'affichage qui limite tous les dessins à ce cadre.
Tous les pixels établis en dehors de cette zone ne seront pas affichés.

Arguments

X, Y, Largeur, Hauteur La position et les dimensions de la zone de découpage.

Les coordonnées (X, Y) sont toujours absolues et ne sont pas affectées par les appels à SetOrigin().

Valeur de retour

Aucune.

Remarques

Cette commande n'a d'effet que sur les sorties de dessin créées par ImageOutput() ou CanvasOutput().

L'origine du dessin n'est pas modifiée par un appel à cette fonction. Pour dessiner dans le coin supérieur gauche de la boîte de découpage, un appel séparé à SetOrigin() doit être fait si cela est souhaité.

Les fonctions Plot() et Point() n'effectuent pas de vérification des limites pour des raisons de performance et ne sont donc pas concernées par cette commande.

Exemple

  If OpenWindow(0, 0, 0, 200, 200, "ClipOutput", #PB_Window_SystemMenu | #PB_Window_ScreenCentered)
    If CreateImage(0, 200, 200, 24, $FFFFFF) And StartDrawing(ImageOutput(0))

      ClipOutput(50, 50, 100, 100) ; restriction de l'affichage du dessin à cette région
      Circle( 50,  50, 50, $0000FF)  
      Circle( 50, 150, 50, $00FF00)  
      Circle(150,  50, 50, $FF0000)  
      Circle(150, 150, 50, $00FFFF)  
      
      DrawingMode(#PB_2DDrawing_Outlined)
      Box(50, 50, 100, 100, $000000)
         
      StopDrawing() 
      ImageGadget(0, 0, 0, 200, 200, ImageID(0))      
    EndIf
    
    Repeat
      Event = WaitWindowEvent()
    Until Event = #PB_Event_CloseWindow
  EndIf

Voir aussi

UnclipOutput(), SetOrigin(), OutputWidth(), OutputHeight()

OS Supportés

Tous

<- CircularGradient() - 2DDrawing Index - ConicalGradient() ->