OpenEuphoria

1. I think I got Callbacks now?

• Posted by Icy_Viking Mar 19, 2023
• 1062 views

Hello all,

While I am still trying to work with callbacks. I think I am slowly starting to figure them out or how to wrap them. I just want to make sure that I am doing it right.

[https://github.com/SFML/CSFML/blob/master/include/SFML/Audio/SoundRecorder.h] - for reference

typedef sfBool (*sfSoundRecorderStartCallback)(void*);                           ///< Type of the callback used when starting a capture 
typedef sfBool (*sfSoundRecorderProcessCallback)(const sfInt16*, size_t, void*); ///< Type of the callback used to process audio data 
typedef void   (*sfSoundRecorderStopCallback)(void*);                            ///< Type of the callback used when stopping a capture 

public function sfSoundRecorderStartCallback(atom cap) 
	atom id = cap 
	return id 
end function 
 
public constant sfSoundRecorderStartCallback_cb = call_back(routine_id("sfSoundRecorderStartCallback"),{C_POINTER},C_BOOL) 
 
public function sfSoundRecorderProcessCallback(atom in16,atom size,atom user) 
	atom id = in16 
	atom s = size 
	atom u = user 
	return id 
end function 
 
public constant sfSoundRecorderProcessCallback_cb = call_back(routine_id("sfSoundRecorderProcessCallback"),{C_POINTER,C_SIZE_T,C_POINTER},C_BOOL) 
 
public function sfSoundRecorderStopCallback(atom user) 
	atom id = user 
	return id 
end function 
 
public constant sfSoundRecorderStopCallback_cb = call_back(routine_id("sfSoundRecorderStopCallback"),{}) 
 
constant C_CALLBACK = C_POINTER 
 
export constant xsfSoundRecorder_create = define_c_func(aud,"+sfSoundRecorder_create",{C_CALLBACK,C_CALLBACK,C_CALLBACK,C_POINTER},C_POINTER) 
 
public function sfSoundRecorder_create(atom onStart,atom onProcess,atom onStop,atom ud) 
	return c_func(xsfSoundRecorder_create,{onStart,onProcess,onStop,ud}) 
end function 

3. Re: I think I got Callbacks now?

• Posted by Icy_Viking Mar 19, 2023
• 944 views

So I am getting the hang of it. Thanks Greg. Yeah I kinda figured its the user who is one who is going to have to use the callbacks. Though a function that can do setup or cleanup is also a good idea.

5. Re: I think I got Callbacks now?

• Posted by ghaberek (admin) Mar 20, 2023
• 837 views

Agreed. The original RDS docs were beautiful but at times felt too sparse, while the current auto-generated docs are hard to look at, hard to navigate, and too verbose. And I intend to address this as I'm very unhappy with the state of eudoc and creole but it's a few iterations out. First I need to get my template parser into the standard library and then I need a Markdown library because I am not writing any new docs on Betamax Creole. Then I need to revisit the placement and organization of source material. And most importantly, if we're going to continue publishing docs on the internet then I need a new home for that, because I do not want it to be an integrated part of this website. Too many eggs in one basket and all that.

-Greg

7. Re: I think I got Callbacks now?

• Posted by ghaberek (admin) Mar 20, 2023
• 779 views

Nothing anymore. At this point I've stopped asking for that and figured I'd just get to it when I get to it.

But... this is a programming forum for a programming community for a particular programming language, so I would expect to find here mostly... programmers? I'm not pulling in people off the street. And most of us been here for a long time. I don't think it's unreasonable to ask programmers, regardless of their skill or experience or knowledge, to learn code versioning commands (git) or to sign up on a website (GitHub) or to run a few commands to execute some code (creole, eudoc, etc.).

This is patently false. Who's refusing things? The path for contributing changes currently remains as it's been, which is described here: https://openeuphoria.org/forum/134522.wc. Anyone is welcome to work on an alternative in the mean time. Some folks tried to use the wiki for documentation (which seems unwise to me) and that seems to have fallen off at some point. I'm not refusing to work on an alternative method but I am not spending any time on it right now either.

-Greg

9. Re: I think I got Callbacks now?

• Posted by jimcbrown (admin) Mar 20, 2023
• 752 views

Thanks for the shout-out!

Understandable, considering how few volunteers we seem able to attract that way.

Agreed. Often the coder is also the best documenter.

Thinking back, when _tom was around, he was really great at this! So yes, while for the time being it makes sense to attract coders to help with docs, we should remain open to letting non-programming folks help out too if they're interested.

Do they ever unidle? Perhaps they remain blissfully unaware. It's a bit like talking to your wall, I imagine.

I think that's fair. It's also a fundamental issue - if we had the funds to afford to pay folks to deal with this, it would have been dealt with already.

I think it would not even cost that much. Just a few hundred dollars for a task on upwork.com or the like and we could easily find someone to handle it. But no one considers these tasks important enough to even donate this much to support the effort.

I'd actually not agree with this. There's not much more involved in making a ticket on this forum, than doing this.

Reporting is easy.

Hmm, I suppose we should consider having the docs on the website get generated automatically from the latest bleeding-edge master (rather than using a manual process and the latest released version). That would at least allow developers to put up a PR to fix doc changes faster, and allow for the website to get updated once the PR was merged and approved.

Perhaps it's not as good as providing a speedy path for noncoders to fix documentation on the website, but it's a step in the right direction.

I think for now, this is the best that we can do, especially for noncoders who can't handle the github workflow - have them report it to ghaberek and let him fix it when he has time to get to it.