aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorHans-Christoph Steiner <eighthave@users.sourceforge.net>2008-05-24 23:14:15 +0000
committerHans-Christoph Steiner <eighthave@users.sourceforge.net>2008-05-24 23:14:15 +0000
commita587a74821c155e281d2a6ce9a9a1d7b6a336fce (patch)
treec5ddd7ed4a1cb1a03a8e9d06d16bbe25c5b153df /doc
parent921b949e82d9b140d69c4487b132fb4ac3185c2a (diff)
Checked in latest from Tom Schouten's darcs repository, which was checked in
19-Feb-2008. Changes are mostly the email address and URLs, but two new objects are also added: pdp_array2grey and pdp_grey2array for converting between Pd arrays and greyscale images. svn path=/trunk/externals/pdp/; revision=9899
Diffstat (limited to 'doc')
-rw-r--r--doc/introduction/input_output.pd2
-rw-r--r--doc/misc/devdoc.html2
-rw-r--r--doc/misc/old-overview.html107
-rw-r--r--doc/misc/rawout.txt14
-rw-r--r--doc/reference.txt2
5 files changed, 119 insertions, 8 deletions
diff --git a/doc/introduction/input_output.pd b/doc/introduction/input_output.pd
index 494eb69..6f7cb9a 100644
--- a/doc/introduction/input_output.pd
+++ b/doc/introduction/input_output.pd
@@ -25,7 +25,7 @@ have to be the same to be combined (i.e. mixed);
#X text 349 559 dim sets the window dimensions;
#X msg 210 510 create;
#X msg 210 531 destroy;
-#X text 208 447 pdp_glx ouputs video in a window using the xVideo extension.
+#X text 208 447 pdp_glx ouputs video in a window using the GLX extension.
if your graphics card/driver supports it you can have multiple output
windows. if a pdp message is received and a window is not open \, one
is created automaticly.;
diff --git a/doc/misc/devdoc.html b/doc/misc/devdoc.html
index c587c48..0f79eb7 100644
--- a/doc/misc/devdoc.html
+++ b/doc/misc/devdoc.html
@@ -161,7 +161,7 @@
<hr>
- <address><a href="mailto:pdp@zzz.kotnet.org">Tom Schouten</a></address>
+ <address><a href="mailto:tom@zwizwa.be">Tom Schouten</a></address>
<!-- Created: Mon Apr 28 15:35:12 CEST 2003 -->
<!-- hhmts start -->
Last modified: Fri Sep 19 04:52:12 CEST 2003
diff --git a/doc/misc/old-overview.html b/doc/misc/old-overview.html
new file mode 100644
index 0000000..856465c
--- /dev/null
+++ b/doc/misc/old-overview.html
@@ -0,0 +1,107 @@
+<h1>Pure Data Packet</h1>
+
+<h2>Introduction</h2>
+
+<p>PDP is an extension library for
+<a href="http://www.crca.ucsd.edu/~msp/software.html">Pure</a>
+<a href="http://www.pure-data.org/about/">Data</a>,
+aimed at providing video and other media processing fuctionality.
+That's still it's main purpose, but as of version 0.13, there is more.
+PDP turned into a tool for writing PDP. See the section on
+<a href="#packetforth">Packet Forth</a>.
+
+<p>PDP runs on Linux and OSX. The OSX version depends on <a
+href="http://fink.sourceforge.net/">Fink</a>.
+
+<p> PDP's focus is on images and video, but there is no reason it
+should stay like that. There is support for matrix processing,
+1D and 2D binary cellular automata, opengl rendering (like Gem),
+scheme scripting (guile), ascii packets, bit grids, ...
+
+<p> For more image processing objects, streaming objects and a collection
+of very useful additions to the bare bones PDP functionality, have a look
+at Yves Degoyon's <a href="http://ydegoyon.free.fr/pidip.html">PiDiP</a> library.
+
+<p> Since version 0.13.x, which is a merger between stable (0.12.x) and
+packet forth, PDP has been split up into 3 parts:
+
+<li> libtile - A lowlevel library for platform specific (integer, mmx, altivec)
+image processing operations and cache optimizations.
+<li> libpdp - The packet managing library + pf scripting language.
+<li> pdp - This is the stable pdp 0.12.x with support for packet forth.
+
+
+<a name="puredata">
+<h2>PDP for Pure Data</h2></a>
+
+This is considered to be the stable part of pdp. It has been stable since 0.12.x
+It has it's bugs & drawbacks & oversimplifications but will mostly stay
+like it is.
+
+It is optimized for intel/mmx and uses a 16bit signed yuv format ideal for real
+time video processing, mixing, blending and feedback. The pf layer is accessible
+from pd/pdp. The result of this is that you can write pdp objects in pf, or directly
+map pf operations to pdp objects.
+
+A 'getting started' documentation for pd/pdp/pidip is being worked on.
+Until then you can have a look at the 'pdp' subdirectory in pd's 'Pure Documentation'.
+Most objects are documented with pd style help patches accessible by right clicking
+on an object. The place to send questions is the pd mailing list. Bugreports can
+be sent to the pd list or me: <code> pdp TA zzz TOD kotnet TOD org </code>.
+
+
+<a name="packetforth">
+<h2>Packet Forth</h2></a>
+
+The libpdp library is a C support library for media processing. It implements
+a mime-like media type system (packets), type conversion and packet operations,
+interface logic to connect pf to other applications, and other things you might
+need to write small 'scratch' media applications.
+
+All operations are implemented as extensions to a forth-like glue language
+called Packet Forth. For more information on this see the documentation
+in the libpdp distribution, or the mailing list <a href="/pipermail/pf-list">archives</a>.
+
+
+
+<a name="cvs">
+<h2>CVS</h2></a>
+
+The latest stable pdp release is <a href="http://zwizwa.fartit.com/pd/pdp/pdp-0.12.4.tar.gz">0.12.4</a>.
+Because 0.13.x is still in a flux, the preferred way of accessing the code is CVS.
+You can access the modules in this way:
+
+<p><code>
+export CVSROOT=:pserver:anonymous@zwizwa.fartit.com:/usr/local/cvsroot <br>
+cvs login <br>
+cvs co libtile <br>
+cvs co libpdp <br>
+cvs co pdp <br>
+</code>
+
+<p>To update, simply <code>cd</code> to each of the 3 directories, and type <code>cvs update -d</code>.
+
+
+<p>When extracting from cvs, you need to run the <code>./bootstrap</code> script to
+create the configure scripts and build and install the packages in the order above.
+In order to compile pdp with libpdp (pf) support, you need to add a
+<code>--enable-pf</code> option when invoking pdp's configure script.
+
+
+<a name="links">
+<h2>Links</h2></a>
+
+<li><a href="http://pure-data.iem.at/about/">Pure Data at IEM</a>
+<li><a href="http://ydegoyon.free.fr/pidip.html">PiDiP Is Definitely In Pieces</a>
+<li><a href="http://www.hackitectura.net/aljwarizmi/">al-Jwarizmi</a>
+<li><a href="http://www.artefacte.org/modules.php?op=modload&name=PD&file=index">PidipVJ</a>
+<li><a href="http://rama.xicnet.com/appz.php">Videoflow / Cruzados BGN</a>
+<li><a href="http://attacksyour.net/pi/pd/index.html">Eth0</a>
+<li><a href="http://footils.org/cms">RRADical</a>
+
+<li><a href="http://veejay.sourceforge.net/">Veejay</a> / <a href="http://zwizwa.fartit.com/pd/sendVIMS/">SendVIMS</a>
+<li><a href="http://freej.dyne.org/">FreeJ</a>
+<li><a href="http://effectv.sourceforge.net/">EffecTV</a>
+
+
+
diff --git a/doc/misc/rawout.txt b/doc/misc/rawout.txt
index 240ede3..d5e65be 100644
--- a/doc/misc/rawout.txt
+++ b/doc/misc/rawout.txt
@@ -104,18 +104,20 @@ lavtrans -o clip.mov -f q clip.avi
Mplayer/Mencoder
----------------
-The MPlayer project uses libavcodec, and even distributes a copy with the MPlayer source.
-You'll need mencoder mainly if you want to use an encoder that's not in the
-ffmpeg package (lavcodec), or what to do some format conversion that's not
-supported by ffmpeg directly. Of course mplayer is handy for inspecting raw files.
-To play a raw video stream try:
+The MPlayer project uses libavcodec, and even distributes a copy with
+the MPlayer source. You'll need mencoder mainly if you want to use an
+encoder that's not in the ffmpeg package (lavcodec), or what to do
+some format conversion that's not supported by ffmpeg directly. Of
+course mplayer is handy for inspecting raw files. To play a raw video
+stream try:
mplayer -rawvideo on:w=320:h=240:fps=25 video.i420
To encode video only using the ffmpeg (lavc) mjpeg codec
(it is possible to use yv12 here, using the format=yv12 option)
-mencoder -rawvideo on:w=320:h=240:fps=25 video.i420 -ovc lavc -lavcopts vcodec=mjpeg -o clip.avi
+mencoder -rawvideo on:w=320:h=240:fps=25 video.i420 -ovc lavc \
+ -lavcopts vcodec=mjpeg -o clip.avi
diff --git a/doc/reference.txt b/doc/reference.txt
index a57953e..d80df8f 100644
--- a/doc/reference.txt
+++ b/doc/reference.txt
@@ -29,6 +29,8 @@ image processors:
pdp_abs absolute value
pdp_add adds two images
pdp_and bitwize and
+pdp_array2grey convert pd array to greyscale image
+pdp_grey2array convert greyscale image to pd array
pdp_bitdepth set bit depth
pdp_bitmask apply a bit mask
pdp_bq spatial biquad filter