Deprecating gfxdraw module

[mzivic7]

These functions must be implemented to pygame.draw module in order to deprecate pygame.gfxdraw module:

• draw.aacircle() #2800
  • thickness
  • filled
• draw.aaline
  • thickness
• draw.aalines
  • Fix aalines overlap #2912
  • thickness *
• Add draw.aaellipse #3016
  • thickness
  • filled
• draw.aapolygon
  • thickness *
  • filled *
• draw.textured_polygon
• Add bezier from gfxdraw module to draw module #3009
• Fix segfault with antialiased draw functions with a depth different than 32bits #3008
• Deprecate gfxdraw but keep the functionality #3010 (deprecation warning + notice in the docs)

Each aa- function should be interchangeable with regular function, in terms of arguments and capabilities.

* - this feature is hard to implement or not possible

gfxdraw can be deprecated after implementing all above listed main functions, and it gets removed in pygame-ce 3 or later.
Thickness and filled features are still very important.

Deprecating gfxdraw closes:

• Add line thickness in gfxdraw #2463
• gfxdraw.aacircle weird lines when large radius #2450
• wasm: gfxdraw not working correctly #2082
• Antialiasing inside surface issue (3500) #1728
• gfxdraw.circle, .aacircle, .filled_circle, .arc and .pie all add a central pixel, making circles 1 px too big. (2924) #1487
• The gfxdraw functions do not support mapped colors (1126) #679
• gfxdraw will be replaced by pygame.draw (157) #172

[bilhox]

Hello,

First of all, thank you for the list. IMO, gfxdraw.pie shouldn't be ported to draw as it can be reproduced easily with existing draw functions.

[mzivic7]

Ok, removing draw.pie from the list, because it can be drawn with draw.arc and 2 draw.lines.

[mzivic7]

Idea for draw.aapolygon:

If width == 1:
    1. Draw closed aalines with width=1 
Else:
    1. Draw closed aalines with width=1
    2. Now for each point:
        3. calculate bisecting vector of angle at that point such that it points toward inside of polygon
        4. Get point moved by 1px along that vector in its direction
        This will result in 1px smaller polygon
    5. With new points draw another aalines
    If filled:
        6. Draw regular filled polygon with same points from 5.
    Else:
        6. Repeat 2.-5. with draw.lines until layer == width-2, in ecah iteration with each layer polygon will get smaller
        7. Draw another aalines with 1px smaller polygon than previous
        8. Repeat 7.

Why this:
Closed shapes must expand width towards inside, and it is expected for polygon to have sharp edges.
Step 1. alone is enough to deprecate gfxdraw.aapolygon. Other steps are for width and filled, which is IMO more important than just aapolygon.

[damusss]

Ok, removing draw.pie from the list, because it can be drawn with draw.arc and 2 draw.lines.

that's how I replaced it in my shim

[bilhox]

#586 - draw.aacircle is also segfaulting
It doesn't segfault for me both on Windows and Ubuntu (In the case of pygame.draw.aacircle), it tells me this on Windows : 💀

pygame-ce 2.5.0 (SDL 2.30.3, Python 3.12.0)
Traceback (most recent call last):
  File "c:\Users\...\pygame-ce\a.py", line 8, in <module>
    aacircle(
OverflowError: Python int too large to convert to C long

and this on Ubuntu :

pygame-ce 2.5.1.dev1 (SDL 2.30.0, Python 3.12.3)
Traceback (most recent call last):
  File "/home/rakoon/pygame-ce/a.py", line 8, in <module>
    aacircle(
OverflowError: signed integer is greater than maximum

Update :
Nevermind, it appeared that pygame.draw.aacircle had a different signature than pygame.gfxdraw.aacircle, it segfaults now.

what I found while debugging :

Thread 1 "python3" received signal SIGSEGV, Segmentation fault.
get_antialiased_color (surf=0xf0c6b0, x=317, y=255, original_color=224, brightness=1) at ../src_c/draw.c:1135
1135        SDL_GetRGBA(pixels[(y * surf->w) + x], surf->format, &background_color[0],

[mzivic7]

#586 turned out to be unrelated to gfxdraw.
The problem was with get_antialiased_color.
Will be fixed in #3008