blob: 5fe5d25daa988666afb798f41660da0a95f1d77c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
<HTML>
<HEAD>
<TITLE>Pd Documentation</TITLE>
</HEAD>
<BODY bgcolor="#ffffff">
<SMALL>
<div style="width:6.5in; margin-left:.5in">
<CENTER> <B>
Pd Documentation chapter 4: writing Pd objects in C
</B> </CENTER>
<BR>
<H5> <A href=index.htm#s4> back to table of contents </A></H5>
<BR><BR>
<P>
You can write your own objects that you and others can use in their Pd
applications. You can write them in C or (if you're smart and brave) in C++ or
FORTRAN.
<P> HOW EXTERNS ARE LOADED
<P> Whenever you type the name of an object
(into an "object" text box) that Pd doesn't yet know about, Pd looks for a
relocatable object file, named, for instance, "profile.pd_irix5". Pd looks
first in the directory containing the patch, then in directories in its
"path." Pd will then add whatever object is defined there to its "class list,"
which is the set of all Pd classes you can use. If all this works, Pd then
attempts again to create the object you asked for, this time perhaps
sucessfully. There is no difference between an object defined this way and an
object built into Pd.
<P> Once you load a new object into Pd, it's there for the duration of your Pd
session. If you load another Pd document which supplies a different version of
some Pd object, the object won't be updated. IF you're working on a new object
and decide to change it, you have to exit and re-enter Pd to get the change to
take.
<P> In the "externs" subdirectory of the documentation you
can find simple examples of "externs" with their source code and test patches;
there are many other on the web (see <a href="x1.htm#s2">section 1.2 </A>).
<P> Iohannes Zmoelnig has written an excellent guide to writing externs at
<A href="http://iem.kug.ac.at/pd/externals-HOWTO/">
http://iem.kug.ac.at/pd/externals-HOWTO/</A> .
<P> A paper by Theo Stojanov on the subject is at:
<A href="http://www.music.mcgill.ca/~theo/html/audio/pd_externs.pdf">
http://www.music.mcgill.ca/~theo/html/audio/pd_externs.pdf </A> .
<P> NT HINT: In NT, Pd is compiled using Visual C 6.0. If you have VC 5.x
your externs won't compile against Pd; you'll get an error about "disk full
or bad DLL." Simply recompile Pd under 5.x and the problem goes away. Externs
compiled under 5.x and 6.x are binary compatible; it's just the compilation
that's sensitive.
</BODY>
</HTML>
|
