Hi All,

I have made the release version of gifticlib (1.0.0) available at: http://www.nitrc.org/frs/download.php/23... .

The most notable change is small, but significant. The coordsys element in giiMetaData is now a pointer to a pointer (used as an array of pointers), rather than the single pointer from before. This version includes the format change where a MetaData element can include an arbitrary number of CoordSystem structures.

It is easy to test this. Just duplicate (and possibly modify) the CoordinateSystemTransformMatrix a few times within a DataArray element, and see if your software can read it. An example of testing it with gifti_tool is:

gifti_tool -no_updates -infiles many.cs.gii -write_gifti new.gii
diff many.cs.gii new.gii

-----

The other change is the ability to deal with external files as data, which I had previously been too lazy to do. A 'set_extern_filelist' option has been added to gifti_tool to accommodate this.

As a sample of what one can and might want to do, consider the following commands. From an existing dataset, set external file references and copy the dataset (therefore creating the external files). Then put the external data back into a new dataset. Finally, compare the original and newest dataset, to see that they are identical. This example assumes ts3.gii exists, with 3 DataArray elements.

# create ts3.ext.gii, along with external data files ext_data.ts3.?.bin
gifti_tool -infiles ts3.gii -no_updates -set_extern_filelist ext_data.ts3.{1,2,3}.bin -write_gifti ts3.ext.gii

# from ts3.ext.gii, create ts3.int.gii as internal data
gifti_tool -infiles ts3.ext.gii -no_updates -encoding BASE64GZIP -write_gifti ts3.int.gii

# test all differences
gifti_tool -compare_gifti -compare_data -compare_verb 3 -infiles b64gz.ts.3.gii ts3.int.gii

-----

Note that if one wants to create a new dataset that points to existing external data files _without_ creating (or overwriting) them, add the '-no_data' option to the gifti_tool command (so that it doesn't attempt to write the data out when writing a new dataset).

Please let me know if there are any comments or questions about this.

- rick