Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Image.draw_* fail on images from Image.Read: pixel data is not C-contiguous (cv2 line/circle/putText layout error)

Aberta
  • Algo errado?
#158 2 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

@petercorke já está trabalhando nisso.

Desde 21/10/2026.

  • #162 de @petercorke — aberto

Avaliação

Dificuldade
3/5
Tempo estimado
1-2 dias
Facilidade para iniciantes
35/100
Tipo de issue
Bug
Clareza
Claramente especificada
Status de atividade
Estagnada
Stack de tecnologia
opencv, python
Domínio
backend, computer-vision

Direção de pesquisa

Start in base/graphics.py, where draw_point calls cv2.putText, and inspect the other draw_* functions that pass the image to OpenCV drawing calls. Reproduce with the issue's Image.Read("monalisa.png") example and check the array's contiguity; add the requested regression test for drawing text on an image read this way. Done when the drawing call succeeds on OpenCV 5 and the regression test passes; pull request #162 is already open.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

bug

On OpenCV 5.0, Image.draw_point(..., text) raises when the image comes straight from Image.Read. This breaks the example in its own docstring, so the published docs show a traceback.

Reproduce

OpenCV 5.0.0 (also 5.0.0.93 from PyPI), origin/main at 77a3da9c:

from machinevisiontoolbox import Image
img = Image.Read("monalisa.png")
img.draw_point((270, 194), "+", "eye", fontsize=1, color="yellow")

File ".../machinevisiontoolbox/base/graphics.py", line 782, in draw_point
    cv2.putText(
cv2.error: OpenCV(5.0.0) :-1: error: (-5:Bad argument) in function 'putText'
> Overload resolution failed:
>  - Layout of the output array img is incompatible with cv::Mat
>  - Expected Ptr<cv::UMat> for argument 'img'

Likely cause

The array that Image.Read returns is not C-contiguous. For monalisa.png it has shape (700, 677, 3), strides (677, 1, 473900) and flags["C_CONTIGUOUS"] == False: the memory is planar (channel-first) and the Image holds a transposed view. cv2.putText on 5.0 rejects an output array in that layout.

Not yet checked:

  • whether OpenCV 4 accepts it (the test machines used here all had OpenCV 5.0.0);
  • why Image.Read produces a planar layout;
  • whether the other draw_* functions in base/graphics.py that pass the image to cv2 drawing calls fail the same way.

Fix ideas

  • Make the draw_* functions work on a contiguous copy and write the result back (or return it), or
  • have Image.Read / Image construction keep arrays C-contiguous, which is the more general fix but touches more code.

Whichever is chosen, add a regression test that draws text onto an Image.Read image on OpenCV 5 (the existing suite passes on 4 and 5, so it does not exercise this path).

Found while investigating broken examples in the docs build; see the tech-debt issue #159.

Linguagem predominante
Python
Estrelas
224
Forks
35
Merge médio
1d 22h
PRs com merge (30d)
29

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de petercorke/machinevision-toolbox-python

Todas as issues de petercorke/machinevision-toolbox-python

Issues semelhantes

Mais issues de Python

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.