http://opensimulator.org/index.php?title=OAR_Format_1.0&feed=atom&action=historyOAR Format 1.0 - Revision history2024-03-28T21:38:17ZRevision history for this page on the wikiMediaWiki 1.19.9http://opensimulator.org/index.php?title=OAR_Format_1.0&diff=32443&oldid=prevJustincc: /* Changes */2013-04-23T19:31:14Z<p><span dir="auto"><span class="autocomment">Changes</span></span></p>
<table class='diff diff-contentalign-left'>
<col class='diff-marker' />
<col class='diff-content' />
<col class='diff-marker' />
<col class='diff-content' />
<tr valign='top'>
<td colspan='2' style="background-color: white; color:black;">← Older revision</td>
<td colspan='2' style="background-color: white; color:black;">Revision as of 19:31, 23 April 2013</td>
</tr><tr><td colspan="2" class="diff-lineno">Line 3:</td>
<td colspan="2" class="diff-lineno">Line 3:</td></tr>
<tr><td class='diff-marker'> </td><td style="background: #eee; color:black; font-size: smaller;"><div>== Changes ==</div></td><td class='diff-marker'> </td><td style="background: #eee; color:black; font-size: smaller;"><div>== Changes ==</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background: #eee; color:black; font-size: smaller;"></td><td class='diff-marker'> </td><td style="background: #eee; color:black; font-size: smaller;"></td></tr>
<tr><td class='diff-marker'>−</td><td style="background: #ffa; color:black; font-size: smaller;"><div>This format <del class="diffchange diffchange-inline">is currently </del>in the <del class="diffchange diffchange-inline">development </del>version of <del class="diffchange diffchange-inline">OpenSimulator only</del>. <del class="diffchange diffchange-inline">Please do </del>not <del class="diffchange diffchange-inline">rely on </del>it <del class="diffchange diffchange-inline">as </del>the <del class="diffchange diffchange-inline">details are subject to change without notice</del>.</div></td><td class='diff-marker'>+</td><td style="background: #cfc; color:black; font-size: smaller;"><div>This format <ins class="diffchange diffchange-inline">was introduced </ins>in <ins class="diffchange diffchange-inline">OpenSimulator 0.7.5.  This is </ins>the <ins class="diffchange diffchange-inline">first </ins>version of <ins class="diffchange diffchange-inline">the OAR format which supports storing multiple regions in a single OAR</ins>. <ins class="diffchange diffchange-inline"> However, it is </ins>not <ins class="diffchange diffchange-inline">backwards compatible with versions of OpenSimulator before 0.7.5 which is why </ins>it <ins class="diffchange diffchange-inline">has a new major version number.  '''It is not currently </ins>the <ins class="diffchange diffchange-inline">default save format'''</ins>.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background: #eee; color:black; font-size: smaller;"></td><td class='diff-marker'> </td><td style="background: #eee; color:black; font-size: smaller;"></td></tr>
<tr><td class='diff-marker'>−</td><td style="background: #ffa; color:black; font-size: smaller;"><div><del class="diffchange diffchange-inline">OAR format 1.0 is </del>the <del class="diffchange diffchange-inline">first format that supports </del>storing multiple <del class="diffchange diffchange-inline">regions in a single OAR file</del>. <del class="diffchange diffchange-inline">It's not backwards compatible with </del>the <del class="diffchange diffchange-inline">previous </del>OAR <del class="diffchange diffchange-inline">formats, which is why it has a new major version number</del>.</div></td><td class='diff-marker'>+</td><td style="background: #cfc; color:black; font-size: smaller;"><div><ins class="diffchange diffchange-inline">Apart from </ins>the <ins class="diffchange diffchange-inline">additional regions/ directory structure for </ins>storing multiple <ins class="diffchange diffchange-inline">OARs and additions to archive</ins>.<ins class="diffchange diffchange-inline">xml, </ins>the <ins class="diffchange diffchange-inline">other parts of this format are idential to </ins>OAR <ins class="diffchange diffchange-inline">format 0.8</ins>.</div></td></tr>
<tr><td class='diff-marker'> </td><td style="background: #eee; color:black; font-size: smaller;"></td><td class='diff-marker'> </td><td style="background: #eee; color:black; font-size: smaller;"></td></tr>
<tr><td class='diff-marker'> </td><td style="background: #eee; color:black; font-size: smaller;"><div>== Detail ==</div></td><td class='diff-marker'> </td><td style="background: #eee; color:black; font-size: smaller;"><div>== Detail ==</div></td></tr>
</table>Justincchttp://opensimulator.org/index.php?title=OAR_Format_1.0&diff=30846&oldid=prevOrenh: Created page with "= What is the OAR 1.0 format? = == Changes == This format is currently in the development version of OpenSimulator only. Please do not rely on it as the details are subject to ..."2012-09-23T06:30:19Z<p>Created page with "= What is the OAR 1.0 format? = == Changes == This format is currently in the development version of OpenSimulator only. Please do not rely on it as the details are subject to ..."</p>
<p><b>New page</b></p><div>= What is the OAR 1.0 format? =<br />
<br />
== Changes ==<br />
<br />
This format is currently in the development version of OpenSimulator only. Please do not rely on it as the details are subject to change without notice.<br />
<br />
OAR format 1.0 is the first format that supports storing multiple regions in a single OAR file. It's not backwards compatible with the previous OAR formats, which is why it has a new major version number.<br />
<br />
== Detail ==<br />
<br />
An OAR file is a gzipped tar file (tar.gz) in the the original unix tar format (not USTAR). This can be extracted and created with standard tools ([http://www.7-zip.org/ 7-zip] on Windows). The file can contain multiple regions. The structure of the archive is as follows (this example contains 4 regions):<br />
<br />
archive.xml<br />
assets/<br />
regions/<br />
1_1_Arizona/<br />
landdata/<br />
objects/<br />
settings/<br />
terrain/<br />
2_1_New_Mexico/<br />
landdata/<br />
objects/<br />
settings/<br />
terrain/<br />
1_2_Utah/<br />
landdata/<br />
objects/<br />
settings/<br />
terrain/<br />
2_2_Colorado/<br />
landdata/<br />
objects/<br />
settings/<br />
terrain/<br />
<br />
The regions' directory names include the region's location (relative to the root region) in order to ensure uniqueness even if regions have duplicate names.<br />
<br />
=== archive.xml ===<br />
<br />
This is the archive control file. It contains a major and minor version number, to allow compatibility with future format changes.<br />
<br />
The boolean element <assets_included> specifies whether the OAR contains assets. If the value is True then the OAR was saved with assets included. If the value is False then the OAR was saved with the --noassets option.<br />
<br />
The control file contains a manifest of the included regions. The list of regions always describes a rectangle, with the root region (the region where the "save-oar" command was run) in the SW corner. The regions are listed in the following order: rows from South to North, and within each row regions are listed West-to-East. Missing regions are supported: they're represented by empty elements.<br />
<br />
For example:<br />
<br />
<?xml version="1.0" encoding="utf-16"?><br />
<archive major_version="1" minor_version="0"><br />
<creation_info><br />
<datetime>1343204139</datetime><br />
</creation_info><br />
<assets_included>True</assets_included><br />
<regions><br />
<row><br />
<region><br />
<id>12345678-1111-1111-1111-111111111111</id><br />
<dir>1_1_Arizona</dir><br />
<is_megaregion>False</is_megaregion><br />
<size_in_meters>256,256</size_in_meters><br />
</region><br />
<region><br />
<id>12345678-2222-2222-2222-222222222222</id><br />
<dir>2_1_New_Mexico</dir><br />
<is_megaregion>False</is_megaregion><br />
<size_in_meters>256,256</size_in_meters><br />
</region><br />
</row><br />
<row><br />
<region><br />
<id>12345678-3333-3333-3333-333333333333</id><br />
<dir>1_2_Utah</dir><br />
<is_megaregion>False</is_megaregion><br />
<size_in_meters>256,256</size_in_meters><br />
</region><br />
<region><br />
<id>12345678-4444-4444-4444-444444444444</id><br />
<dir>2_2_Colorado</dir><br />
<is_megaregion>False</is_megaregion><br />
<size_in_meters>256,256</size_in_meters><br />
</region><br />
</row><br />
</regions><br />
</archive><br />
<br />
=== assets/ ===<br />
<br />
This directory contains all the assets in the archive. The assets for all the regions are stored in the same directory because assets are often shared. Each filename has the following format<br />
<br />
<uuid>_<asset type>.<asset extension><br />
<br />
The ''uuid'' section must always be present and form a valid uuid - it is used directly as the uuid for that asset. The ''asset type'' and ''asset extension'' are used to identify the type of asset and the ''asset extension'' allows the asset to be associated with different editors on platforms such as Windows. For instance, a script will always have the asset type and extension script.lsl. A full list of asset types and extensions can be found in the file <br />
<br />
OpenSim/Region/Environment/Modules/World/Archiver/ArchiveConstants.cs<br />
<br />
in the OpenSimulator distribution.<br />
<br />
In the future, the format of these files will be described in [[Asset Formats]].<br />
<br />
=== landdata/ ===<br />
<br />
This directory contains all the parcels in the region. Information for each parcel is stored in a separate file in XML format. Each filename has the form:<br />
<br />
<uuid>.xml<br />
<br />
where ''uuid'' is the uuid of the parcel.<br />
<br />
=== objects/ ===<br />
<br />
Each individual file in here is an object in the region (where an object [linkset] can be composed of many prims). The file format used is OpenSim's XML2 format. Each filename has the following structure by default<br />
<br />
<Object name>_<x>-<y>-<z>__<uuid>.xml<br />
<br />
Unlike asset filenames, any component of this name can be changed without affecting any attributes of the object itself - this information is taken from the xml instead. Indeed, this file can have any name - there is no need for any of the sections to be present. An example object file name is<br />
<br />
Primitive_154-121-062__9be68fdd-f740-4a0f-9675-dfbbb536b946.xml<br />
<br />
The actual format is described (currently very sketchily) in [[Asset Formats]].<br />
<br />
=== settings/ ===<br />
<br />
This contains the region settings information for the region in XML format. The filename will be the same as the region name. For example,<br />
<br />
OpenSimulator Test.xml<br />
<br />
See an example of an XML region settings file below.<br />
<br />
=== terrains/ ===<br />
<br />
This contains the terrain file for the region, stored in RAW format. The filename must end with .r32. For example,<br />
<br />
OpenSimulator Test.r32</div>Orenh