Módulo para dibujar gráficos simples.
pygame.draw.rect() dibuja un rectángulo en la superficie dada.
Atributos:
rect(superficie, color, rect) -> Rect
rect(superficie, color, rect, ancho=0, border_radius=0, border_radius=-1, border_top_left_radius=-1, border_top_right_radius=-1, border_bottom_left_radius=-1) -> Rect
El método pygame.Surface.fill() también funciona para dibujar rectángulos rellenos y puede acelerarse por hardware en algunas plataformas mediante modos de visualización de software y hardware.
parámetro:
superficie (Surface) – el color de la superficie que se dibujará (Color o int o tuple(int, int, int, [int])) – el color que se dibujará, el valor alfa es opcional cuando se utiliza la representación de tupla (RGB[A] )
rect (Rect) – el rectángulo a dibujar [posición y tamaño]
ancho (int) – (opcional) usado para indicar el grosor de la línea o del rectángulo a rellenar (no debe confundirse con el valor de ancho del parámetro rect) )
si ancho == 0, (predeterminado) rectángulo relleno
Si el ancho > 0, se utiliza para indicar el grosor de la línea.
Si ancho < 0, no se dibujará nada
Aviso:
Cuando se usa ancho > 1, las líneas de borde crecerán más allá de los límites originales del rectángulo. Consulte las notas del parámetro de ancho de la función pygame.draw.line() para obtener más detalles.
border_radius (int) – (opcional) usado para dibujar rectángulos redondeados. El rango admitido es [0, min(alto, ancho) / 2], 0 representa un rectángulo sin esquinas redondeadas.
border_top_left_radius (int): (opcional) valor utilizado para establecer el borde superior izquierdo. Si este valor no se establece, utilizará el valor border_radius.
border_top_right_radius (int) --(opcional) se usa para establecer el valor del borde superior derecho. Si este valor no se establece, utilizará el valor border_radius.
border_bottom_left_radius (int) --(opcional) se usa para establecer el valor del borde inferior izquierdo. Si este valor no se establece, utilizará el valor border_radius.
border_bottom_right_radius (int) --(opcional) se usa para establecer el valor del borde inferior derecho. Si este valor no se establece, utilizará el valor border_radius.
Si border_radius < 1, se dibujará un rectángulo sin esquinas redondeadas.
Si algún valor del radio del borde es menor que 0, se utiliza el valor de border_radius (border_radius)
Si la suma de los radios en el mismo lado del rectángulo es mayor que el tamaño del rectángulo, los radios se escalarán
Valor de retorno: (Rect) Un rectángulo que encierra los píxeles modificados. Si no se dibuja nada, la posición del rectángulo circundante será la del parámetro rect dado, y su ancho y alto serán 0
Modificado en pygame 2.0.0: se agregó soporte para argumentos de palabras clave.
Modificado en pygame 2.0.0.dev8: se agregó soporte para radios de borde.
pygame.draw.polygon() dibuja un polígono en la superficie dada.
polígono(superficie, color, puntos) -> Rect
polígono(superficie, color, puntos, ancho=0) -> Rect
参数：
superficie (Surface) – el color de la superficie que se dibujará (Color o int o tuple(int, int, int, [int])) – el color que se dibujará, el valor alfa es opcional cuando se utiliza la representación de tupla (RGB[A] )
puntos (tupla (coordenada) o lista (coordenada)): una secuencia de 3 o más coordenadas (x, y) que forman los vértices del polígono. Cada coordenada en la secuencia debe ser 2 en el formato de tupla/lista/ pygame.math.Vector2 enteros/flotantes, por ejemplo: [(x1, y1), (x2, y2), (x3, y3)] ancho (int) – (opcional) usado
para indicar el grosor de la línea o para rellenar el rectángulo ( no debe usarse con el parámetro rect Confusión del valor de ancho)
Si ancho == 0, (predeterminado) polígono relleno
Si el ancho > 0, se utiliza para indicar el grosor de la línea.
Si ancho < 0, no se dibujará nada
Aviso:
Cuando se usa ancho > 1, las líneas de borde crecerán más allá de los límites originales del polígono. Consulte las notas del parámetro de ancho de la función pygame.draw.line() para obtener más detalles.
Valor de retorno: (Rect) Un rectángulo que rodea el píxel modificado. Si no se dibuja nada, la posición del rectángulo circundante será la posición del primer punto en el parámetro de puntos (los valores flotantes se truncarán) y su ancho y la altura será 0
pista:
ValueError: si len(puntos) < 3 (debe tener al menos 3 puntos)
TypeError: si los puntos no son una secuencia o los puntos no contienen un par de números Nota
: Para polígonos aa, utilice aalines() [cerrado=Verdadero].
Modificado en pygame 2.0.0: se agregó soporte para argumentos de palabras clave.
pygame.draw.circle() dibuja un círculo en la superficie dada.
círculo(superficie, color, centro, radio) -> Rect
círculo(superficie, color, centro, radio, ancho=0, draw_top_right=Ninguno, draw_top_left=Ninguno, draw_bottom_left=Ninguno, draw_bottom_right=Ninguno) -> Rect
参数：
superficie (Surface) – el color de la superficie que se dibujará (Color o int o tuple(int, int, int, [int])) – el color que se dibujará, el valor alfa es opcional cuando se utiliza la representación de tupla (RGB[A] )
centro (tuple(int o float, int o float) o lista(int o float, int o float) o Vector2(int o float, int o float)): el punto central del círculo representado por una secuencia de 2 int/ float , por ejemplo (x, y)
radio (int o float): el radio del círculo medido desde el parámetro central, si el radio es menor que 1, no se dibuja nada
ancho (int) – (opcional) usado para indicar el grosor de la línea o relleno a llenar Rectángulo (no debe confundirse con el valor de ancho del parámetro rect)
. Si ancho == 0, (predeterminado) un círculo relleno.
Si ancho > 0, se usa para indicar el grosor de la línea
. Si ancho < 0, nada será sorteado.
Aviso:
Cuando se usa ancho > 1, las líneas de borde solo crecerán hacia adentro.
draw_top_right (bool) – (Opcional) Si se establece en True, se dibujará la esquina superior derecha del círculo
draw_top_left (bool) – (Opcional) Si se establece en True, se dibujará la esquina superior izquierda del círculo draw_bottom_left
(bool) – (Opcional) Opcional) Si se establece en Verdadero, se dibujará la esquina inferior izquierda del círculo. draw_bottom_right
(bool) -- (Opcional) Si se establece en Verdadero, se dibujará la esquina inferior derecha del círculo.
Si alguno de draw_circle_part es Es cierto, dibujará un círculo con valor Verdadero para todas las partes del círculo; de lo contrario, se dibujará el círculo completo.
返回值：(Rect)un rectángulo que delimita los píxeles modificados, si no se dibuja nada, la posición del rectángulo delimitador será el valor del parámetro central (los valores flotantes se truncarán) y su ancho y alto serán 0
pista:
TypeError: si el centro no es una secuencia o dos números
TypeError: si el radio no es un número
Modificado en pygame 2.0.0.dev8: se agregó soporte para dibujar cuadrantes de círculos. Modificado en pygame 2.0.0: se agregó soporte para argumentos de palabras clave. Cuando el radio es 0, no se dibuja nada (cuando el radio es igual a 0, se dibuja un píxel en la coordenada central). El parámetro central acepta punto flotante y Vector2. El algoritmo de dibujo se ha mejorado para que parezca más un círculo.
pygame.draw.ellipse() dibuja una elipse en la superficie dada.
elipse(superficie, color, rect) -> Rect
elipse(superficie, color, rect, ancho=0) -> Rect
参数：
superficie (Surface) – el color de la superficie que se dibujará (Color o int o tuple(int, int, int, [int])) – el color que se dibujará, el valor alfa es opcional cuando se utiliza la representación de tupla (RGB[A] )
rect (Rect): un rectángulo que representa la posición y las dimensiones de una elipse que se centrará dentro y estará delimitada por el
ancho del rectángulo (int). (opcional) se usa para indicar el grosor de la línea o para rellenar el rectángulo (no comparar con el ancho). valor del parámetro rect Confundido)
Si ancho == 0, (predeterminado) llena la elipse
Si ancho > 0, se usa para indicar el grosor de la línea
Si ancho < 0, no se dibujará nada Nota
:
Cuando se usa ancho > 1, la línea del borde solo crecerá hacia adentro desde los límites originales del parámetro rect.
Valor de retorno: (Rect) Un rectángulo que encierra los píxeles modificados. Si no se dibuja nada, la posición del rectángulo circundante será la del parámetro rect dado, y su ancho y alto serán 0
Modificado en pygame 2.0.0: se agregó soporte para argumentos de palabras clave.
pygame.draw.arc() dibuja un arco elíptico en la superficie dada.
arc(surface, color, rect, start_angle, stop_angle) -> Rect
arc(surface, color, rect, start_angle, stop_angle, width=1) -> Rect Los
dos parámetros de ángulo se expresan en radianes e indican las posiciones inicial y final de el arco. Desde start_angle hasta stop_angle, los arcos se dibujan en sentido antihorario.
parámetro:
superficie (Surface) – el color de la superficie que se dibujará (Color o int o tuple(int, int, int, [int])) – el color que se dibujará, el valor alfa es opcional cuando se utiliza la representación de tupla (RGB[A] )
rect (Rect) – El rectángulo representa la posición y el tamaño de la elipse, que estará centrada en el rectángulo
start_angle (flotante) – El ángulo inicial del arco (expresado en radianes)
stop_angle (flotante) – El ángulo final del arco (expresado en radianes)
si start_angle < stop_angle, dibuja un arco en sentido antihorario desde start_angle hasta stop_angle
Si start_angle > stop_angle, agregue tau (tau == 2 * pi) a stop_angle:
Si el valor del ángulo final generado es mayor que start_angle, se aplica la situación anterior start_angle < stop_angle; de lo contrario, no se dibujará nada.
Si start_angle == stop_angle, no se dibujará nada
ancho (int) – (opcional) usado para indicar el grosor de la línea o del rectángulo a llenar (no debe confundirse con el valor de ancho del parámetro rect).
Si ancho == 0, no se dibujará nada.
Si ancho > 0, usado para indicar el grosor de la línea
. ancho < 0, no se dibujará nada
Aviso:
Cuando se usa ancho > 1, la línea del borde solo crecerá hacia adentro desde los límites originales del parámetro rect.
Valor de retorno: (Rect) Un rectángulo que encierra los píxeles modificados. Si no se dibuja nada, la posición del rectángulo circundante será la del parámetro rect dado, y su ancho y alto serán 0
Modificado en pygame 2.0.0: se agregó soporte para argumentos de palabras clave.
pygame.draw.line() dibuja una línea recta
line(surface, color, start_pos, end_pos, width) -> Rect
line(surface, color, start_pos, end_pos, width=1) -> Rect
dibuja una línea recta en la superficie dada. Sin tapa final. Las líneas gruesas tienen extremos cuadrados.
parámetro:
superficie (Surface) – el color de la superficie que se dibujará (Color o int o tuple(int, int, int, [int])) – el color que se dibujará, el valor alfa es opcional cuando se utiliza la representación de tupla (RGB[A] )
start_pos (tupla(int o float, int o float) o lista(int o float, int o float) o Vector2(int o float, int o float)) – posición inicial de la línea, (x, y) end_pos (
tupla (int o float, int o float) o lista(int o float, int o float) o Vector2(int o float, int o float)) – posición final de la línea, (x, y) ancho (int) – (
opcional (opcional) se usa para indicar el grosor de la línea.
Si el ancho> = 1, se usa para el grosor de la línea (el valor predeterminado es 1)
. Si el ancho <1, no se dibuja nada.
NOTA: Cuando se utiliza ancho > 1, la línea crecerá de la siguiente manera:
Para valores de ancho impares, el ancho de cada línea aumenta con la línea original en el centro.
Para valores de ancho pares, el ancho de cada línea aumenta a medida que la línea original se desplaza del centro (porque no se dibuja una línea central exacta). Entonces, una línea con pendiente <1 (horizontal) será 1 píxel más gruesa que la línea original (dirección y). Las líneas con pendiente >= 1 (verticalmente) tendrán 1 píxel de grosor más a la derecha (dirección x) de la línea original.
Valor de retorno: (Rect) un rectángulo que encierra el píxel modificado. Si no se dibuja nada, la posición del rectángulo que lo encierra será el valor del parámetro start_pos (los valores de punto flotante se truncarán) y su ancho y alto serán 0
Consejo: TypeError: si start_pos o end_pos no es una secuencia de dos números
Modificado en pygame 2.0.0: se agregó soporte para argumentos de palabras clave.
pygame.draw.lines() dibuja múltiples segmentos de línea recta continuos
líneas (superficie, color, cerrado, puntos) -> Rect
líneas (superficie, color, cerrado, puntos, ancho = 1) -> Rect
dibuja una secuencia continua de líneas rectas en la superficie dada. No hay tapas de extremo ni conexiones biseladas. Las líneas gruesas tienen extremos cuadrados. Dibujar ángulos agudos con trazos atrevidos puede tener efectos indeseables.
parámetro:
superficie (Surface) – el color de la superficie que se dibujará (Color o int o tuple(int, int, int, [int])) – el color que se dibujará, el valor alfa es opcional cuando se utiliza la representación de tupla (RGB[A] )
cerrado (bool) – Si es Verdadero, se dibuja un segmento de línea adicional entre el primer y el último punto de los puntos de la secuencia de puntos
(tupla (coordenada) o lista (coordenada)) – Una línea que contiene 2 o más (x, y) Una secuencia de coordenadas Cada coordenada en la secuencia debe ser una tupla/lista/pygame.math.Vector2 en 2 formatos de entero/coma flotante, y las coordenadas adyacentes estarán conectadas por segmentos de línea. [Por ejemplo, para los puntos [(x1, y1), (x2, y2), (x3, y3)] el segmento de recta se dibujará de (x1, y1) a (x2, y2) y de (x2, y2 ) a (x3, y3), además, si el parámetro de cierre es verdadero, se dibujará otro segmento de línea de (x3, y3) a (x1, y1)] ancho (int) – (opcional) utilizado para indicar la
línea espesor
si ancho >= 1, se utiliza para el espesor de línea (el valor predeterminado es 1)
Si ancho < 1, no se dibuja ningún contenido
. Nota:
Consulte el comentario sobre el ancho de line() para obtener detalles sobre cómo crecen las líneas gruesas cuando se usa un ancho > 1.
Valor de retorno: (Rect) Un rectángulo que encierra el píxel modificado. Si no se dibuja nada, la posición del rectángulo que lo encierra será la posición del primer punto en el parámetro de puntos (el valor de punto flotante se truncará), y su ancho y la altura será 0
pista:
ValueError: si len(puntos) < 2 (debe tener al menos 2 puntos)
TypeError: si los puntos no son una secuencia o los puntos no contienen un par numérico
Modificado en pygame 2.0.0: se agregó soporte para argumentos de palabras clave.
pygame.draw.aaline() dibuja una línea recta suavizada en la superficie dada.
aaline(superficie, color, start_pos, end_pos) -> Rect
aaline(superficie, color, start_pos, end_pos, blend=1) -> Rect
参数：
superficie (Surface) – la superficie que se va a dibujar
color (Color o int o tuple(int, int, int, [int])) – el color que se va a dibujar, el valor alfa es opcional cuando se utiliza la representación de tupla (RGB[A] )
rect (Rect): el rectángulo que representa la posición y las dimensiones de la elipse que se centrará en el rectángulo
start_pos (tuple(int o float, int o float) o list(int o float, int o float) o Vector2(int o float, int o float)) – posición inicial de la línea, (x, y)
end_pos (tupla(int o float, int o float) o lista(int o float, int o float) o Vector2(int o float, int o float )) – donde termina la línea, (x, y)
blend (int) – (opcional) si es distinto de cero (predeterminado), la línea se fusionará con las sombras de píxeles existentes de la superficie; de lo contrario, se sobrescribirán.
Valor de retorno : (Rect) un rectángulo que rodea los píxeles modificados, si no se dibuja nada, la posición del rectángulo circundante será el valor del parámetro start_pos (los valores flotantes se truncarán) y su ancho y alto serán 0
Consejo: TypeError: si start_pos o end_pos no es una secuencia de dos números
Modificado en pygame 2.0.0: se agregó soporte para argumentos de palabras clave.
pygame.draw.aalines() dibuja una secuencia continua de líneas rectas suavizadas en la superficie dada.
aalines(superficie, color, cerrado, puntos) -> Rect
aalines(superficie, color, cerrado, puntos, mezcla=1) -> Rect
参数：
superficie (Surface) – la superficie que se va a dibujar
color (Color o int o tuple(int, int, int, [int])) – el color que se va a dibujar, el valor alfa es opcional cuando se utiliza la representación de tupla (RGB[A] )
cerrado (bool): si es Verdadero, se dibuja un segmento de línea adicional entre el primer y el último punto de la secuencia de puntos puntos
(tupla (coordenada) o lista (coordenada)): un conjunto de 2 o más (x, y) A secuencia de coordenadas, cada coordenada en la secuencia debe ser una tupla/lista/pygame.math.Vector2 de formato 2 enteros/flotante, y las coordenadas adyacentes se conectarán mediante segmentos de línea. [Por ejemplo, para los puntos [(x1, y1), (x2, y2), (x3, y3)] el segmento de recta se dibujará de (x1, y1) a (x2, y2) y de (x2, y2 ) a (x3, y3), además, si el parámetro de cierre es verdadero, se dibujará otro segmento de línea de (x3, y3) a (x1, y1)] blend (int) – (opcional) si es distinto de cero
( predeterminado), la línea será Sombreada con los píxeles existentes de la Superficie; de lo contrario, los sobrescribirá.
Devuelve: (Rect) Un rectángulo que encierra el píxel modificado, o la posición del rectángulo que lo encierra si no se dibuja nada. La posición del primer punto en los puntos. parámetro (el valor flotante se truncará), su ancho y alto serán 0
pista:
ValueError: si len(puntos) < 2 (debe tener al menos 2 puntos)
TypeError: si los puntos no son una secuencia o los puntos no contienen un par numérico
Modificado en pygame 2.0.0: se agregó soporte para argumentos de palabras clave.