Csound Csound-dev Csound-tekno Search About

Re: [Cs-dev] Some API documentation points

Date2005-05-06 21:30
FromMichael Gogins
SubjectRe: [Cs-dev] Some API documentation points
Are you saying that you use the csoundKeyPress, Invalue, Outvalue, and ScoreEvent functions aas they stand in the Csound API, or that you have your own versions in your own code, of which the "canonical" versions are relics or stubs?

In any event, please, let us have a consistent API. 

I do not agree that there should be one API for hosts and another API for plugins. "Host" and "plugin" are purely relative terms whose meaning depends on context. In CsoundVST or as a Python extension module, Csound acts as both host and plugin.

In other words, acting as a host, Csound provides the API to plugin opcodes. Also acting as a host, CsoundVST calls the API and treats Csound itself as a plugin. And of course in both cases, all the opcodes call many API functions for managing arguments, tables, and messages, treating Csound as the host.

In addition to the actual polyvalence of these terms, providing two APIs would involve duplicating many functions between the two APIs and that would be an unnecessary complication that might introduce errors.

Regards,
Mike Gogins

-----Original Message-----
From: matt 
Sent: May 6, 2005 2:20 PM
To: csound-devel@lists.sourceforge.net
Subject: Re: [Cs-dev] Some API documentation points

csoundKeyPress, Invalue, Outvalue, and ScoreEvent are all things i added
and use frequently.  they are for HOST applications communicating with
a csound library and are VERY useful to me.  they are pretty worthless 
for
opcode plugins though.

it has been suggested a few times to make separate api's for hosts and 
plugins, which
i would not object to..

>> - the csoundKeyPress() entry in csound.h mentions the 'keypress' 
>> opcode, which does not have an entry in the manual

i think thats a typo, it should say the 'sensekey' opcode [ not 
'keypress' ]



-------------------------------------------------------
This SF.Net email is sponsored by: NEC IT Guy Games.
Get your fingers limbered up and give it your best shot. 4 great events, 4
opportunities to win big! Highest score wins.NEC IT Guy Games. Play to
win an NEC 61 plasma display. Visit http://www.necitguy.com/?r=20
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel





-------------------------------------------------------
This SF.Net email is sponsored by: NEC IT Guy Games.
Get your fingers limbered up and give it your best shot. 4 great events, 4
opportunities to win big! Highest score wins.NEC IT Guy Games. Play to
win an NEC 61 plasma display. Visit http://www.necitguy.com/?r=20
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net

Date2005-05-06 21:50
Frommatt
SubjectRe: [Cs-dev] Some API documentation points
> Are you saying that you use the csoundKeyPress, Invalue, Outvalue, and 
> ScoreEvent functions aas they stand in the Csound API,

[without looking at the code]
  yes.  the only difference is probably the sensekey ocpode itself
right now in my code is hardwired to only use the api.  so this would 
need to be changed as well
as getting the inChar, etc variables out of global space.




-------------------------------------------------------
This SF.Net email is sponsored by: NEC IT Guy Games.
Get your fingers limbered up and give it your best shot. 4 great events, 4
opportunities to win big! Highest score wins.NEC IT Guy Games. Play to
win an NEC 61 plasma display. Visit http://www.necitguy.com/?r=20
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net