Changes between Version 19 and Version 20 of PIL

Timestamp:

10/16/24 14:00:31 (19 months ago)

Author:

siegel

Comment:

--

PIL

@@ -316 +316 @@
 == Objects
 
-The following operations are supported on the `$obj` type:
-
+The function
+- `$obj $empty_obj($int size);`
+returns the empty object spanning `size` bytes.  Only values of a sized type can be written to an object.
+
+An object is modified through a pointer into the object, for example:
+{{{
+typedef $size(4) $int int;
+typedef $size(8) $real double;
+$obj o1 = $empty_obj(1000);
+double* dp = (double*)&o1;  // points to byte 0
+*dp = 3.14;
+*(dp+7) = 2.718;
+int* ip = (int*)&o1;
+*(ip+2) = 17;
+}}}
+The operations above place the double value 3.14 in o1 at positions 0..7, the double value 2.718 at positions 28..35, and the integer value 17 at positions 8..11.
+
+If a write to an object overlaps the interval of an existing value, the old value is removed.
+
+The values in an object are also read using pointers.