Classes | Collections | Files

Archive : LibraryBase : MultiLevelIdentityDictionary : Collection : Object

storing objects to file
Source: Library.sc

Description

Archives can write any object to disk and read from file again. Complex structures of objects can thus be restored. Writing an object to file as a compile string is usually more readable, but does not account for the internal structure of the object.

There is only one global instance: Archive.global, which is initialized automatically.

Class Methods

Archive.global

Archive.global = obj

set or get the global archive instance

Archive.archiveDir

Archive.archiveDir = value

set or get the directory that the archive is written to. Default: Platform.userAppSupportDir.

Archive.write(filename)

write the global archive now. This is called automatically when SuperCollider quits. The default filename is "/archive.sctxar"

Archive.read(filename)

read the global archive now. This is called automatically when SuperCollider recompiles or starts. The default filename is "/archive.sctxar"

Inherited class methods

Instance Methods

Inherited instance methods

Examples

// make a storage place for various objects:
q = (); // Event

q[\a_long_array] = Array.rand(128, 0.0, 1.0);
q[\pi_squared] = pi * pi;
q[\favourite_sound] = { { SinOsc.ar([300, 330]).sum * LFPulse.kr(2 + [0, 0.01]) * 0.1 }.play };
q[\same_long_array] = q[\a_long_array]; // same objects may appear several times

Archive.global.put(\myData, q);


Archive.global.at(\myData).postcs;

// after a recompile:
s.boot;

q = Archive.global.at(\myData);
q.postcs;
q[\favourite_sound].value;