Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

pygame.Sound.copy implementation #3238

Open
wants to merge 9 commits into
base: main
Choose a base branch
from

Conversation

Borishkof
Copy link

Create a function for deep copying sound.
Create some tests (failing tests on .xm and .opus for un unknown reason).

issue : #1328 (comment)

@Borishkof Borishkof requested a review from a team as a code owner November 24, 2024 17:39
@bilhox bilhox changed the title Sound copy - co-authored @bilhox @thomasgrgi pygame.Sound.copy implementation Nov 24, 2024
@yunline yunline added mixer pygame.mixer New API This pull request may need extra debate as it adds a new class or function to pygame labels Nov 25, 2024
Copy link
Member

@ankith26 ankith26 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for contributing to pygame-ce!

This change would need documentation and type stubs for complete approval

src_c/mixer.c Outdated Show resolved Hide resolved
Parameter type changing from pgSoundObject to PyObject.

Co-authored-by: Thomasgrgi <[email protected]>
Co-authored-by: Bilhox
Co-authored-by: AntoineM <[email protected]>"
Copy link
Contributor

@damusss damusss left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Things I noticed beside what ankith said. Also some error messages could be improved grammar wise.

docs/reST/ref/mixer.rst Outdated Show resolved Hide resolved
src_c/mixer.c Outdated Show resolved Hide resolved
src_c/mixer.c Outdated Show resolved Hide resolved
src_c/mixer.c Show resolved Hide resolved
@Borishkof
Copy link
Author

Thanks for your help, I will update my PR.

@yunline yunline linked an issue Nov 28, 2024 that may be closed by this pull request
Copy link
Contributor

@bilhox bilhox left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overall LGTM, I left some requested changes.

test/mixer_test.py Outdated Show resolved Hide resolved
@Borishkof
Copy link
Author

It seems like xm or opus is "Unrecognized audio format" (using mixer.Sound() ) for the distribution that does the automatic test I failed.
But it works on my distrib and some examples in mixer_music_test use those formats (without specific version checking).
What should I do ?

@yunline
Copy link
Contributor

yunline commented Nov 30, 2024

It seems like xm or opus is "Unrecognized audio format" (using mixer.Sound() ) for the distribution that does the automatic test I failed.
But it works on my distrib and some examples in mixer_music_test use those formats (without specific version checking).
What should I do ?

You are writing unittest for Sound.copy, not for other functionalities.
The test case should be decoupled with other functionalities like "reading files" since those should be taken care of by other test cases.

// Handle chunk allocation type
if (chunk->allocated) {
// Create a deep copy of the audio buffer for allocated chunks
Uint8 *buffer_copy = (Uint8 *)malloc(chunk->alen);
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe this is a memory leak. This is allocated but never freed, and it can't be freed here because it needs to live as long as the chunk does.

Comment on lines +880 to +887
new_chunk = (Mix_Chunk *)malloc(sizeof(Mix_Chunk));
if (!new_chunk) {
Py_DECREF(new_sound);
PyErr_SetString(PyExc_MemoryError,
"Failed to allocate memory for sound chunk");
return NULL;
}
*new_chunk = *chunk; // Copy the entire structure
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copying an entire struct like this may work in this scenario but in my opinion is not something that is safe in general. From SDL's perspective these are all internal fields and they can do whatever they want with it. They're barely documented.

@Starbuck5
Copy link
Member

Thank you for working on this @Borishkof! I can tell this is a high effort contribution.

However, I feel that there is no safe way to do this within the SDL_mixer API, and I don't really see why this is a useful feature. I feel bad I didn't see the earlier discussion and say so then.

Copying a surface? Important, because they are editable. Edit one copy, leave the other copy the same.
Sounds on the other hand? The only thing you can edit currently is the volume. Not exactly as fundamental.

Talking myself through it I guess you could attach sounds to objects in a game. So like different sprites have different volume explosion noises. So you would want to give them each a copy of the sound with a different preset volume. But that would be very wasteful on the memory front. The ideal solution I think would be a bunch of Mix_Chunks all pointed at the same audio buffer, with different volumes set. So we already have Quickload_RAW from SDL_mixer, and we already can get the raw bytes using the routine get_raw uses right?

So maybe this can be done without this allocated branching? Whether or not the mix_chunk controls the allocation, the allocation can be copied out. We'd need some way of managing the life cycle of this new buffer that only some Sound objects have. If we wanted to share it between Sound copies for efficiency's sake it could be another Python object so we can ref-count it for garbage collection purposes.

OK new idea on this train of thought, can't this be implemented safely and simply in Python? I haven't tested this at all but couldn't you take the output of Sound.get_raw() and pipe it back into the Sound constructor with the array= keyword. If it's written in Python you could do my crazy memory proxy Python object idea with very low complexity.

@Borishkof
Copy link
Author

Thank you for the review :)

As I am a beginner in Pygame, I can't argue much about the solutions you propose and will leave it to the community to decide which is the most efficient way to tackle the issue.
That being said, I believe you are right about the poor memory management (I forgot to check it).

If the community reaches a consensus on a reasonably simple solution, I would be glad to try and implement it. Otherwise, I am happy to let anyone with good ideas take a shot at addressing this issue. 👍

@bilhox
Copy link
Contributor

bilhox commented Dec 7, 2024

I find the arguments gave by starbucks understandable, so I'm for an implementation in python side now.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
mixer pygame.mixer New API This pull request may need extra debate as it adds a new class or function to pygame
Projects
None yet
Development

Successfully merging this pull request may close these issues.

pygame.mixer.Sound.copy (2577)
6 participants