VST2.4 specs 
HOME   |   Software       VST2.4 specs :: FIRST   -   PREV   -   NEXT

effSetProgramName / setProgramName()


C++: VstIntPtr function dispatcher(AEffect* e, VstInt32 opcode, VstInt32 index, VstIntPtr value, void* ptr, float opt);
Delphi: function dispatcher(e: PAEffect; opcode, index: VstInt32; value: VstIntPtr; ptr: pointer; opt: Single): VstIntPtr; cdecl;
always returns 0, unless otherwise defined.
all string-pointers points to zero terminated strings.
e[ ]: = plugin receives as entry parameter
x[ ]: = plugin returns to host

dispatcher() function using opcode 4:
4. effSetProgramName   >= VST1.0   @see AudioEffect::setProgramName()
host has changed the current program name
e[ptr]: string-pointer to new program name (max 24 bytes)

C++ method:
 void AudioEffect::setProgramName(char* name)

Delphi method:
 procedure AudioEffectX.setProgramName(name: pchar);

warning:
Please be aware that the string lengths supported by the default VST interface are normally limited to 24 characters (max 23 chars plus null terminating character). If you copy too much data into the buffers provided, you may break certain Host applications.

FIRST   -   PREV   -   NEXT   -   TOP