mjpeg — gravação mjpeg#

O módulo mjpeg é utilizado para gravação de vídeo no formato mjpeg. Use-o para gravar clipes de vídeo longos como dados de imagem comprimidos. Use gif para clipes curtos.

Exemplo de utilização:

import csi
import mjpeg
import time

# Setup camera.
csi0 = csi.CSI()
csi0.reset()
csi0.pixformat(csi.RGB565)
csi0.framesize(csi.QVGA)
csi0.snapshot(time=2000)

# Create the mjpeg object.
m = mjpeg.Mjpeg("example.mjpeg")

# Record for 20 seconds.
start = time.ticks_ms()
while time.ticks_diff(time.ticks_ms(), start) < 20000:
    m.add_frame(csi0.snapshot())

# Finalize.
m.close()

classe Mjpeg – gravador Mjpeg#

class mjpeg.Mjpeg(path: str, width: int | None = None, height: int | None = None)#

Cria um objeto Mjpeg ao qual pode adicionar fotogramas.

path é o caminho no sistema de ficheiros onde a gravação mjpeg será guardada.

width é a resolução horizontal do ficheiro mjpeg. Por omissão, utiliza a largura do framebuffer principal quando não especificado.

height é a resolução vertical do ficheiro mjpeg. Por omissão, utiliza a altura do framebuffer principal quando não especificado.

is_closed() → bool#

Devolve True se o ficheiro foi fechado. Não é possível escrever mais dados num ficheiro fechado.

width() → int#

Devolve a resolução horizontal do ficheiro mjpeg.

height() → int#

Devolve a resolução vertical do ficheiro mjpeg.

count() → int#

Devolve o número de fotogramas escritos no ficheiro mjpeg.

size() → int#

Devolve o tamanho do ficheiro mjpeg em bytes.

add_frame(image: image.Image, roi: Tuple[int, int, int, int] | None = None, rgb_channel: int = -1, alpha: int = 255, color_palette: image.Image | None = None, alpha_palette: image.Image | None = None, hint: int = 0, quality: int = 90) → None#

Acrescenta image à gravação mjpeg. A imagem é automaticamente redimensionada preservando a proporção para a resolução especificada na criação do ficheiro. É aceite qualquer formato de imagem; este método descomprime, redimensiona/converte e recomprime conforme necessário.

roi é o tuplo retângulo de região de interesse (x, y, w, h) de image a copiar. Por omissão, corresponde à imagem inteira.

rgb_channel é o canal RGB (0=R, 1=G, 2=B) a extrair de uma imagem fonte RGB565 e renderizar em escala de cinzentos. -1 (predefinição) desativa a extração de canal.

alpha (0-255) controla a quantidade da imagem fonte a misturar no destino. 255 é opaco; valores inferiores misturam com um fundo preto; 0 resulta num fotograma preto.

color_palette é uma enumeração de paleta de cores (p. ex. image.PALETTE_RAINBOW) ou uma imagem RGB565 de 256 pixels usada como tabela de consulta de cores aplicada ao valor em escala de cinzentos da imagem fonte. Aplicada após a extração de rgb_channel.

alpha_palette é uma imagem em escala de cinzentos de 256 pixels usada como tabela de consulta de alfa que modula alpha por pixel fonte com base no seu valor em escala de cinzentos. 255 é opaco; 0 é transparente. Aplicada após a extração de rgb_channel.

hint é um OR lógico de:

quality (0-100) é a qualidade de compressão JPEG utilizada para imagens fonte não JPEG.

write(image: image.Image, roi: Tuple[int, int, int, int] | None = None, rgb_channel: int = -1, alpha: int = 255, color_palette: image.Image | None = None, alpha_palette: image.Image | None = None, hint: int = 0, quality: int = 90) → None#

Alias para Mjpeg.add_frame().

sync() → None#

Descarrega o ficheiro mjpeg para disco mantendo-o aberto para mais escritas. Chame periodicamente para garantir que os dados são guardados.

close() → None#

Finaliza a gravação mjpeg. Deve ser chamado uma vez quando a gravação estiver concluída para tornar o ficheiro visualizável.