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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
pool - a hierarchical storage object for PD and Max/MSP
Copyright (c) 2002-2004 Thomas Grill (gr@grrrr.org)
For information on usage and redistribution, and for a DISCLAIMER OF ALL
WARRANTIES, see the file, "license.txt," in this distribution.
Donations for further development of the package are highly appreciated.
Visit https://www.paypal.com/xclick/business=t.grill%40gmx.net&item_name=pool&no_note=1&tax=0¤cy_code=EUR
----------------------------------------------------------------------------
Goals/features of the package:
- pool can store and retrieve key/value pairs, where a key can be any atom and
the value can be any list of atoms
- pool can manage folders. A folder name can be any atom.
- pool objects can be named and then share their data space
- clipboard operations are possible in a pool or among several pools
- file operations can load/save data from disk
----------------------------------------------------------------------------
IMPORTANT INFORMATION for all PD users:
Put the pd-msvc/pool.dll, pd-linux/pool.pd_linux or pd-darwin/pool.pd_darwin file
into the extra folder of the PD installation, or use a -path or -lib option
at PD startup to find the pool external.
Put the help-pool.pd file into the doc\5.reference subfolder of your PD installation.
----------------------------------------------------------------------------
IMPORTANT INFORMATION for all Max/MSP users:
For Mac OSX put the max-osx/pool.mxd file into the folder
/Library/Application Support/Cycling '74/externals
For Mac OS9 put the max-os9/pool.mxe file into the externals subfolder of your Max/MSP installation
For Windows put the max-msvc\pool.mxe file into the folder
C:\program files\common files\Cycling '74\externals (english version)
Put the pool.help file into the max-help folder.
============================================================================
You will need the flext C++ layer for PD and Max/MSP externals to compile the source distribution.
see http://grrrr.org/ext
Package files:
- readme.txt: this one
- gpl.txt,license.txt: GPL license stuff
- main.cpp, pool.h, pool.cpp, data.cpp
----------------------------------------------------------------------------
The package should at least compile (and is tested) with the following compilers:
pd - Windows:
-------------
o Borland C++ 5.5 (free): edit "config-pd-bcc.txt" & run "build-pd-bcc.bat"
o Microsoft Visual C++ 6/7: edit "config-pd-msvc.txt" & run "build-pd-msvc.bat"
o GCC (MinGW): edit "config-pd-mingw.txt" & run "build-pd-mingw.bat"
pd - linux:
-----------
o GCC: edit "config-pd-linux.txt" & run "sh build-pd-linux.sh"
pd - darwin (MacOSX):
---------------------
o GCC: edit "config-pd-darwin.txt" & run "sh build-pd-darwin.sh"
Max/MSP - MacOS9/X:
-------------------
o CodeWarrior: edit "pool.cw" and build
Max/MSP - Windows:
-------------------
o Microsoft Visual C++ 6/7: edit "config-max-msvc.txt" & run "build-max-msvc.bat"
============================================================================
Version history:
0.2.1:
- fixed "cntsub"... directories in current directory have been forgotten
- store/create also empty dirs with file I/O
- more inlined functions and better symbol handling
- added "seti" message to set elements at index
- added "clri" message to erase elements at index
- fixed bad bug: pool::priv was not initialized
- enhanced and optimized atom parsing
0.2.0:
- attributes (pool,private,echodir,absdir)
- added "geti" message for retrieval of a value at an index
- fixed bug in "get" message if key not present
- adapted source to flext 0.4.1 - register methods at class creation
- extensive use of hashing for keys and directories
- database can be saved/loaded as XML data
- fixed bug with stored numbers starting with - or +
- relative file names will be based on the folder of the current patcher
- added printall, printrec, printroot messages for console printout
- added mkchdir, mkchsub to create and change to directories at once
- change storage object only when name has changed
0.1.0:
- first public release
---------------------------------------------------------------------------
BUGS:
- pool does not handle symbols with spaces, colons or all digits
TODO list:
- check for invalid symbols (spaces, colons)
general:
- what is output as value if it is key only? (Max->nothing!)
- XML format ok?
|