pdp 0.8.3

svn path=/trunk/externals/pdp/; revision=382

1 files changed, 33 insertions, 33 deletions

diff --git a/README b/README
index eb53d0c..efc6ae6 100644
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-PDP - Pure Data Packet v0.7
+PDP - Pure Data Packet v0.8.3
 a packet processing library for pure data
 
 Copyright (c) by Tom Schouten <pdp@zzz.kotnet.org>
@@ -32,13 +32,6 @@ compilablility yet. So if some of the requirements are missing on your
 system, you'll have to tinker a bit to get it working until i move to 
 automatic configuration and building...
 
-The goal (for now) is not to write a general purpose video processing 
-tool for pd, the goal is to experiment with cache optimization, mmx 
-integer processing, time and space feedback in video, nonlinear 
-difference equations, cellular automata, computer vision, and other 
-buzzwords...
-
-
 Features:
 
 * packet formats: greyscale and YV12 encoded images,
@@ -46,6 +39,7 @@ Features:
 * sources: noise, video4linux and quicktime (with audio), CA
 * sink: xvideo display
 * filters: convolution, biquad time, biquad space, CA
+* warping: rotate, zoom, stretch
 * transforms: colour translation/scaling, grey->palette
 * add, mul, mix, random pixel mix
 * utility objs: packet register, snapshot, trigger
@@ -67,15 +61,20 @@ Requirements:
 philips webcam included.
 * libquicktime (not quicktime4linux!) for quicktime playback.
 * an X display with XVideo extension for video display
+* libsdl
 
 
 Documentation:
 
-Have a look in doc/ for documentation. It is not finished yet. More info 
-in modules/README, scaf/README, the files in abstractions/ and test/ and 
-the code. If you wan't to make your own pdp modules, you can take the 
-simplest one (modules/pdp_add.c) as an example.
-The file doc/reference.txt contains a list of all objects.
+Have a look in doc/ for documentation. The file doc/reference.txt 
+contains a list of all objects. doc/introduction has some basic
+facts on using pdp. doc/objects is a reference doc for all the
+objects and doc/examples contains some more example patches.
+
+The directory abstractions/ has some abstractions using the pdp 
+objects (some specific filters) that can serve as example.
+
+For developer docs see modules/README, scaf/README. 
 
 
 Building:
@@ -102,8 +101,8 @@ Additional Remarks:
 * If some of the modules don't compile due to some missing libraries, 
 you can try to comment out the offending code in modules/Makefile and 
 system/pdp.c If compilation or linking fails due to other reasons, 
-please let me know. if you have both libquicktime and quicktime4linux
-installed. make sure pdp.pd_linux loads the right library.
+please let me know. If you have both libquicktime and quicktime4linux
+installed, make sure pdp.pd_linux loads the right library.
 
 * The reason i use YV12 and not RGB is simple: it's faster, and for 
 linear operations it doesn't make much difference. Most camera's and
@@ -123,13 +122,12 @@ processing.
 * Packets can be processed in a low priority thread with a dropping 
 mechanism to prevent overload or audio drops, or they can be processed 
 in the main pd thread. This can be set/unset by sending a "thread x"
-message to pdp_control. Processing in thread is on by default. If you
-don't need audio, (i.e. if you are using 2 pd's, one for audio and one 
-for video) having threads disabled can have advantages, since no pdp
-frames are dropped and no extra delays are introduced. Even when you use 
-audio and pdp in the same pd session, it is possible to run with threads 
-disabled and without audio dropouts by tuning pd's fragsize and keeping
-the frame rate low. 
+message to pdp_control. Processing in pdp thread is off by default.
+Use the pd thread for rock solid video timing. Increase the audio 
+latency to avoid dropouts. If you want low audio latency, and don't
+care about a dropped video frame here and there, switch on the pdp
+thread. Note that when using the pdp thread, the control flow is no
+longer depth first. Additinal delays will be introduced.
 
 * There have been some requests for an osx port, but i wil probably not
 do this myself (at least not right now). However, i've ported all
@@ -137,7 +135,8 @@ the mmx code to c, so it should work on other architectures as well.
 This should ease porting a bit for anyone who wants to give it a try. 
 Also i've moved all the image conversion routines to pdp_llconv.c  
 This means porting is reduced to writing new objects for the os specific 
-stuff like video/movie input/output.
+stuff like movie playback&record and live video input. Thanks to Martin
+Pi we now have sdl support for video output.
 
 * Have a look at Yves Degoyon's PiDiP library. It contains some extra 
 effects (from EffecTV and FreeJ), a quicktime recording object, some 
@@ -161,15 +160,16 @@ Experimental relases are in the subdirectory test/
 
 Directory structure:
 
-abstractions/	some abstractions that use the pdp objects
-doc/		start of a decent set of document patches
-debug/		debug scripts
-include/	header files
-modules/	pdp module code
-scaf/		CA extension lib (needs to be compiled separately)
-system/		core pdp system
-system/mmx/	mmx assembler files
-test/		some test patches (pretty complete doc but cryptic)
+abstractions/		some abstractions that use the pdp objects
+doc/introduction/	getting started with pdp
+doc/examples/		some example patches
+doc/objects/		pd style reference documentation
+debug/			debug scripts
+include/		header files
+modules/		pdp module code
+scaf/			CA extension lib (needs to be compiled separately)
+system/			core pdp system
+system/mmx/		mmx assembler files
 
 
 
@@ -182,4 +182,4 @@ Have Fun,
 Tom
 
 
-last modified: 2003/01/19
+last modified: 2003/02/03