OAR Format 0.7 - Revision history

MakoBot: Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

2012-03-04T06:46:20Z

Robot: Replacing 'OpenSim' to 'OpenSimulator', which is the precise name

MakoBot: Robot: Cosmetic changes

2012-03-04T03:39:21Z

Robot: Cosmetic changes

Justincc: /* assets/ */

2012-01-07T01:29:32Z

‎assets/

Justincc: /* objects/ */

2012-01-07T01:28:47Z

‎objects/

MakoBot: Removed 'Template:' prefix from template includings and/or changed external-link into internal-link

2011-06-10T23:13:31Z

Removed 'Template:' prefix from template includings and/or changed external-link into internal-link

Makopoppo at 08:50, 4 June 2011

2011-06-04T08:50:41Z

Justincc: /* archive.xml */

2011-05-26T01:33:24Z

‎archive.xml

Justincc: New page: {{Template:Quicklinks}}
Technical Reference -> Terms -> OAR Format 0.6 =What is the OAR 0.7 format?= == Changes == ...

2011-05-26T01:32:24Z

New page: {{Template:Quicklinks}} <br /> Technical Reference -> Terms -> OAR Format 0.6 =What is the OAR 0.7 format?= == Changes == ...

New page

{{Template:Quicklinks}}
<br />

[[Technical Reference | Technical Reference]] -> [[Technical Reference/terms | Terms]] -> [[OAR Format 0.6]]

=What is the OAR 0.7 format?=

== Changes ==

This format is currently in the development version of OpenSim only. Please do not rely on it as the details are subject to change without notice.

OAR format 0.7 is identical to 0.6 except that the control file (archive.xml) now includes an <assets_included> element (see below).

== Detail ==

At the present time, a region archive 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 structure of the archive is as follows

archive.xml
assets/
landdata/
objects/
settings/
terrains/

=== archive.xml ===

This is the archive control file. At the moment it contains only a major and minor version number, to allow compatibility with future format changes.

=== assets/ ===

This directory contains all the assets in the archive. Each filename has the following format

<uuid>_<asset type>.<asset extension>

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

OpenSim/Region/Environment/Modules/World/Archiver/ArchiveConstants.cs

in the OpenSim distribution.

=== landdata/ ===

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:

<uuid>.xml

where ''uuid'' is the uuid of the parcel.

=== objects/ ===

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

<Object name>_<x>-<y>-<z>__<uuid>.xml

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

Primitive_154-121-062__9be68fdd-f740-4a0f-9675-dfbbb536b946.xml

=== settings/ ===

This contains the region settings information for the region in XML format. The filename will be the same as the region name. For example,

OpenSim Test.xml

Here is an [[OAR format 0.2 region settings example|example of an XML region file]] (schema to follow, sometime).

=== terrains/ ===

This contains the terrain file for the region, stored in RAW format. The filename must end with .r32. For example,

OpenSim Test.r32

= See Also =

* [[Status|Main Status Page]]
* [[Technical_Reference|Technical Reference Page]]
* [[OpenSim_Archives|How to use OpenSim Archives (OAR)]]
* [[OAR Format 0.1 | OAR Format 0.1]]
* [[OAR Format 0.2 | OAR Format 0.2]]

[[Category:Users]]
[[Category:Support]]
[[Category:Tech Reference]]
[[Category:Help]]
[[Category:Configuration]]
[[Category:Getting_Started]]
[[Category:Development]]

@@ Line 6: / Line 6: @@
 == Changes ==
-This format is currently in the development version of OpenSim only. Please do not rely on it as the details are subject to change without notice.
+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.
 OAR format 0.7 is identical to 0.6 except that the control file (archive.xml) now includes an <assets_included> element (see below).
@@ Line 36: / Line 36: @@
   OpenSim/Region/Environment/Modules/World/Archiver/ArchiveConstants.cs
-in the OpenSim distribution.
+in the OpenSimulator distribution.
 In the future, the format of these files will be described in [[Asset Formats]].
@@ Line 64: / Line 64: @@
 This contains the region settings information for the region in XML format. The filename will be the same as the region name. For example,
-  OpenSim Test.xml
+  OpenSimulator Test.xml
 Here is an [[OAR format 0.2 region settings example|example of an XML region file]] (schema to follow, sometime).
@@ Line 72: / Line 72: @@
 This contains the terrain file for the region, stored in RAW format. The filename must end with .r32. For example,
-  OpenSim Test.r32
+  OpenSimulator Test.r32
 = See Also =
-* [[OpenSim Archives|How to use OpenSim Archives (OAR)]]
+* [[OpenSim Archives|How to use OpenSimulator Archives (OAR)]]
 * [[OAR Format 0.1]]
 * [[OAR Format 0.2]]

← Older revision		Revision as of 01:29, 7 January 2012
Line 37:		Line 37:

	in the OpenSim distribution.		in the OpenSim distribution.
		+
		+	In the future, the format of these files will be described in [[Asset Formats]].

	=== landdata/ ===		=== landdata/ ===

← Older revision		Revision as of 01:28, 7 January 2012
Line 55:		Line 55:

	Primitive_154-121-062__9be68fdd-f740-4a0f-9675-dfbbb536b946.xml		Primitive_154-121-062__9be68fdd-f740-4a0f-9675-dfbbb536b946.xml
		+
		+	The actual format is described (currently very sketchily) in [[Asset Formats]].

	=== settings/ ===		=== settings/ ===

← Older revision		Revision as of 23:13, 10 June 2011
Line 1:		Line 1:
−	{{~~Template:~~Quicklinks}}	+	{{Quicklinks}}
	<br />		<br />

@@ Line 2: / Line 2: @@
 <br />
-=What is the OAR 0.7 format?=
+= What is the OAR 0.7 format? =
 == Changes ==
-This format is currently in the development version of OpenSim only.  Please do not rely on it as the details are subject to change without notice.
+This format is currently in the development version of OpenSim only. Please do not rely on it as the details are subject to change without notice.
 OAR format 0.7 is identical to 0.6 except that the control file (archive.xml) now includes an <assets_included> element (see below).
@@ Line 12: / Line 12: @@
 == Detail ==
-At the present time, a region archive 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 structure of the archive is as follows
+At the present time, a region archive 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 structure of the archive is as follows
   archive.xml
@@ Line 23: / Line 23: @@
 === archive.xml ===
-This is the archive control file.  It contains a major and minor version number, to allow compatibility with future format changes.
+This is the archive control file. It contains a major and minor version number, to allow compatibility with future format changes.
-It also contains an <assets_included> element which can have the contents True or False.  If the string is True, then the OAR was saved with assets included.  If the switch is False, then the OAR was saved with the --noassets option.
+It also contains an <assets_included> element which can have the contents True or False. If the string is True, then the OAR was saved with assets included. If the switch is False, then the OAR was saved with the --noassets option.
 === assets/ ===
-This directory contains all the assets in the archive.  Each filename has the following format
+This directory contains all the assets in the archive. Each filename has the following format
   <uuid>_<asset type>.<asset extension>
-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
+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
   OpenSim/Region/Environment/Modules/World/Archiver/ArchiveConstants.cs
@@ Line 50: / Line 50: @@
 === objects/ ===
-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
+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
   <Object name>_<x>-<y>-<z>__<uuid>.xml
-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
+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
   Primitive_154-121-062__9be68fdd-f740-4a0f-9675-dfbbb536b946.xml
@@ Line 62: / Line 62: @@
 === settings/ ===
-This contains the region settings information for the region in XML format.  The filename will be the same as the region name.  For example,
+This contains the region settings information for the region in XML format. The filename will be the same as the region name. For example,
   OpenSim Test.xml
@@ Line 70: / Line 70: @@
 === terrains/ ===
-This contains the terrain file for the region, stored in RAW format.  The filename must end with .r32.  For example,
+This contains the terrain file for the region, stored in RAW format. The filename must end with .r32. For example,
   OpenSim Test.r32
@@ Line 76: / Line 76: @@
 = See Also =
-* [[OpenSim_Archives|How to use OpenSim Archives (OAR)]]
+* [[OpenSim Archives|How to use OpenSim Archives (OAR)]]
-* [[OAR Format 0.1 | OAR Format 0.1]]
+* [[OAR Format 0.1]]
-* [[OAR Format 0.2 | OAR Format 0.2]]
+* [[OAR Format 0.2]]
 [[Category:Users]]
 [[Category:Support]]
 [[Category:Tech Reference]]
 [[Category:Help]]
 [[Category:Configuration]]
-[[Category:Getting_Started]]
+[[Category:Getting Started]]
 [[Category:Development]]