Land (database table)

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(fleshing out documentation on bitmap)
(wikification)
Line 1: Line 1:
−
__NOTOC__
 
 
{{Template:Quicklinks}}
 
{{Template:Quicklinks}}
−
<br />
+
''&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(back to [[Database Documentation]])
−
 
+
−
[[Category:Database]]
+
−
 
+
−
'''Estate Managers''' ''Records managers of estates ''&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(back to [[Database Documentation]])
+
 
<br><br>
 
<br><br>
 
The current structure of the Land table is as follows:<br>
 
The current structure of the Land table is as follows:<br>
Line 46: Line 41:
 
<tr><td>Dwell</td><td>int(11)</td><td>NO</td><td></td><td></td><td></td></tr>
 
<tr><td>Dwell</td><td>int(11)</td><td>NO</td><td></td><td></td><td></td></tr>
 
</table>
 
</table>
−
<br>
+
 
−
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(back to [[Database Documentation]])<br>
+
== UUID ==
−
<hr>
+
−
'''UUID'''
+
−
<br>
+
 
The unique ID of the Land Parcel.
 
The unique ID of the Land Parcel.
−
<br>
+
 
−
<br>
+
== RegionUUID ==
−
'''RegionUUID'''
+
−
<br>
+
 
The UUID of the region containing this land parcel.
 
The UUID of the region containing this land parcel.
−
<br>
+
 
−
<br>
+
== LocalLandID ==
−
'''LocalLandID'''
+
The number of the parcel.
−
<br>
+
 
−
The number of the parcel
+
== Bitmap ==
−
<br>
+
−
<br>
+
−
'''Bitmap'''
+
−
<br>
+
 
A block of 512 bytes (4,096 bits) of data with each bit of each byte indicating whether a 4m x 4m piece of a region (the smallest selectable) is in the parcel of land. The block of bytes starts in the bottom left corner of the region, proceeding west-east, south-north. As there are 8 bits in a byte, each byte corresponds to 8 pieces of land in a 256x256 region.
 
A block of 512 bytes (4,096 bits) of data with each bit of each byte indicating whether a 4m x 4m piece of a region (the smallest selectable) is in the parcel of land. The block of bytes starts in the bottom left corner of the region, proceeding west-east, south-north. As there are 8 bits in a byte, each byte corresponds to 8 pieces of land in a 256x256 region.
  
Line 102: Line 88:
 
# byte & 128
 
# byte & 128
  
−
<br>
+
== Name ==
−
'''Name'''
+
−
<br>
+
 
The name of this land parcel.
 
The name of this land parcel.
−
<br>
+
 
−
<br>
+
== Description ==
−
'''Description'''
+
−
<br>
+
 
A description of this land parcel.
 
A description of this land parcel.
−
<br>
+
 
−
<br>
+
== OwnerUUID ==
−
'''OwnerUUID'''
+
−
<br>
+
 
The UUID of the user who owns this land parcel.
 
The UUID of the user who owns this land parcel.
−
<br>
+
 
−
<br>
+
== IsGroupOwned ==
−
'''IsGroupOwned'''
+
−
<br>
+
 
This is set to 1 if the parcel is owned by a group. If it is not group owned it will be 0.
 
This is set to 1 if the parcel is owned by a group. If it is not group owned it will be 0.
−
<br>
+
 
−
<br>
+
== Area ==
−
'''Area'''
+
−
<br>
+
 
The size of the parcel (in square meters).
 
The size of the parcel (in square meters).
−
<br>
+
 
−
<br>
+
== AuctionID ==
−
'''AuctionID'''
+
−
<br>
+
 
To be identified.
 
To be identified.
−
<br>
+
 
−
<br>
+
== Category ==
−
'''Category'''
+
−
<br>
+
 
This specifies the category the parcel of land is in when doing a search. A value of 0 indicates no category was set, -1 is any category, and positive numbers indicate a specific category.
 
This specifies the category the parcel of land is in when doing a search. A value of 0 indicates no category was set, -1 is any category, and positive numbers indicate a specific category.
−
<br>
+
 
−
<br>
+
== ClaimDate ==
−
'''ClaimDate'''
+
−
<br>
+
 
The date the parcel of land was claimed by an avatar (ie. the date of sale).
 
The date the parcel of land was claimed by an avatar (ie. the date of sale).
−
<br>
+
 
−
<br>
+
== ClaimPrice ==
−
'''ClaimPrice'''
+
−
<br>
+
 
To be identified.
 
To be identified.
−
<br>
+
 
−
<br>
+
== GroupUUID ==
−
'''GroupUUID'''
+
−
<br>
+
 
To be identified when Groups are implemented.
 
To be identified when Groups are implemented.
−
<br>
+
 
−
<br>
+
== SalePrice ==
−
'''SalePrice'''
+
−
<br>
+
 
If the land is for sale this is the price asked.
 
If the land is for sale this is the price asked.
−
<br>
+
 
−
<br>
+
== LandStatus ==
−
'''LandStatus'''
+
−
<br />
+
 
''From OpenMetaverse.ParcelStatus''
 
''From OpenMetaverse.ParcelStatus''
 
* -1 : None
 
* -1 : None
Line 166: Line 128:
 
* 2  : Abandoned
 
* 2  : Abandoned
  
−
'''LandFlags'''
+
== LandFlags ==
 
<table>
 
<table>
 
<caption>OpenMetaverse.ParcelFlags</caption>
 
<caption>OpenMetaverse.ParcelFlags</caption>
Line 331: Line 293:
 
</table>
 
</table>
  
−
'''LandingType'''
+
== LandingType ==
−
<br>
+
 
The landing point setting for the parcel: 0 is Blocked, 1 is 1anding point set, 2 is for landing allowed anywhere.
 
The landing point setting for the parcel: 0 is Blocked, 1 is 1anding point set, 2 is for landing allowed anywhere.
−
<br>
+
 
−
<br>
+
== MediaAutoScale ==
−
'''MediaAutoScale'''
+
−
<br>
+
 
A boolean (1 or 0) indicating whether media should be stretched to fit the face of the prim it's displayed on.
 
A boolean (1 or 0) indicating whether media should be stretched to fit the face of the prim it's displayed on.
−
<br>
+
 
−
<br>
+
== MediaTextureUUID ==
−
'''MediaTextureUUID'''
+
−
<br>
+
 
The UUID of a texture. Objects using this texture will show a video stream or web page after they click the video play arrow in their viewer.
 
The UUID of a texture. Objects using this texture will show a video stream or web page after they click the video play arrow in their viewer.
−
<br>
+
 
−
<br>
+
== MediaURL ==
−
'''MediaURL'''
+
−
<br>
+
 
The URL of the video stream, or media, to be played in this land.
 
The URL of the video stream, or media, to be played in this land.
−
<br>
+
 
−
<br>
+
== MusicURL ==
−
'''MusicURL'''
+
−
<br>
+
 
The URL of the Music station to be played in this land.
 
The URL of the Music station to be played in this land.
−
<br>
+
 
−
<br>
+
== Passhours ==
−
'''Passhours'''
+
−
<br>
+
 
The length of time that a pass to his parcel is valid.
 
The length of time that a pass to his parcel is valid.
−
<br>
+
 
−
<br>
+
== PassPrice ==
−
'''PassPrice'''
+
−
<br>
+
 
The cost of a pass to this parcel.
 
The cost of a pass to this parcel.
−
<br>
+
 
−
<br>
+
== SnapshotUUID ==
−
'''SnapshotUUID'''
+
−
<br>
+
 
The UUID (key) on the asset table of a picture of this parcel.
 
The UUID (key) on the asset table of a picture of this parcel.
−
<br>
+
 
−
<br>
+
== UserLocationX ==
−
'''UserLocationX'''
+
−
<br>
+
 
The X co-ordinate of the parcel's landing zone (if set).
 
The X co-ordinate of the parcel's landing zone (if set).
−
<br>
+
 
−
<br>
+
== UserLocationY ==
−
'''UserLocationY'''
+
−
<br>
+
 
The Y co-ordinate of the parcel's landing zone (if set).
 
The Y co-ordinate of the parcel's landing zone (if set).
−
<br>
+
 
−
<br>
+
== UserLocationZ ==
−
'''UserLocationZ'''
+
−
<br>
+
 
The Z co-ordinate of the parcel's landing zone (if set).
 
The Z co-ordinate of the parcel's landing zone (if set).
−
<br>
+
 
−
<br>
+
== UserLookAtX ==
−
'''UserLookAtX'''
+
−
<br>
+
 
To be identified.
 
To be identified.
−
<br>
+
 
−
<br>
+
== UserLookAtY ==
−
'''UserLookAtY'''
+
−
<br>
+
 
To be identified.
 
To be identified.
−
<br>
+
 
−
<br>
+
== UserLookAtZ ==
−
'''UserLookAtZ'''
+
−
<br>
+
 
To be identified.
 
To be identified.
−
<br>
+
 
−
<br>
+
== AuthBuyID ==
−
'''AuthBuyID'''
+
−
<br>
+
 
The UUID of the User authorised to buy this land.
 
The UUID of the User authorised to buy this land.
−
<br>
+
 
−
<br>
+
== OtherCleanTime ==
−
'''OtherCleanTime'''
+
−
<br>
+
 
Other residents objects in the parcel will be automatically returned after this many minutes has elapsed. Set to 0 to disable auto-return of objects.
 
Other residents objects in the parcel will be automatically returned after this many minutes has elapsed. Set to 0 to disable auto-return of objects.
−
<br>
+
 
−
<br>
+
== Dwell ==
−
'''Dwell'''
+
−
<br>
+
 
To be identified.
 
To be identified.
−
<br>
+
 
−
<br>
+
−
<hr>
+
−
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(back to [[Database Documentation]])<br>
+
 
[[Category:Database]]
 
[[Category:Database]]

Revision as of 03:06, 9 June 2011

Languages Languages: 

En.png English

      (back to Database Documentation)

The current structure of the Land table is as follows:

Field
TypeNullKeyDefaultExtra
 
UUIDvarchar(255)NOPRI
RegionUUIDvarchar(255)YES
LocalLandIDint(11)YES
BitmaplongblobYES
Namevarchar(255)YES
Descriptionvarchar(255)YES
OwnerUUIDvarchar(255)YES
IsGroupOwnedint(11)YES
Areaint(11)YES
AuctionIDint(11)YES
Categoryint(11)YES
ClaimDateint(11)YES
ClaimPriceint(11)YES
GroupUUIDvarchar(255)YES
SalePriceint(11)YES
LandStatusint(11)YES
LandFlagsint(11)YES
MediaAutoScaleint(11)YES
MediaTextureUUIDvarchar(255)YES
MediaURLvarchar(255)YES
MUSICURLvarchar(255)YES
PasshoursfloatYES
PassPriceint(11)YES
SnapshotUUIDvarchar(255)YES
UserLocationXint(11)YES
UserLocationYint(11)YES
UserLocationZint(11)YES
UserLookAtXint(11)YES
UserLookAtYint(11)YES
UserLookAtZint(11)YES
AuthBuyerIDvarchar(255)NO00000000-0000-0000-0000-000000000000
OtherCleanTimeint(11)NO
Dwellint(11)NO

Contents

UUID

The unique ID of the Land Parcel.

RegionUUID

The UUID of the region containing this land parcel.

LocalLandID

The number of the parcel.

Bitmap

A block of 512 bytes (4,096 bits) of data with each bit of each byte indicating whether a 4m x 4m piece of a region (the smallest selectable) is in the parcel of land. The block of bytes starts in the bottom left corner of the region, proceeding west-east, south-north. As there are 8 bits in a byte, each byte corresponds to 8 pieces of land in a 256x256 region.

The first bit in the first byte refers to the square piece of land with corners (in region co-ordinates) at:

  • (0, 0)
  • (4, 0)
  • (4, 4)
  • (0, 4)

The first byte corresponds to a rectangle with corners at:

  • (0 ,0)
  • (32,0)
  • (32,4)
  • (0, 4)

The second byte corresponds to a rectangle with corners at:

  • (32, 0)
  • (64, 0)
  • (64, 4)
  • (32, 4)

The ninth byte thus corresponds to a rectangle with corners at:

  • (0, 4)
  • (32,4)
  • (32,8)
  • (0, 8)

To determine if a piece of land in the region belongs to the parcel, one should perform a bitwise operation on the byte, e.g.

  1. byte & 1
  2. byte & 2
  3. byte & 4
  4. byte & 8
  5. byte & 16
  6. byte & 32
  7. byte & 64
  8. byte & 128

Name

The name of this land parcel.

Description

A description of this land parcel.

OwnerUUID

The UUID of the user who owns this land parcel.

IsGroupOwned

This is set to 1 if the parcel is owned by a group. If it is not group owned it will be 0.

Area

The size of the parcel (in square meters).

AuctionID

To be identified.

Category

This specifies the category the parcel of land is in when doing a search. A value of 0 indicates no category was set, -1 is any category, and positive numbers indicate a specific category.

ClaimDate

The date the parcel of land was claimed by an avatar (ie. the date of sale).

ClaimPrice

To be identified.

GroupUUID

To be identified when Groups are implemented.

SalePrice

If the land is for sale this is the price asked.

LandStatus

From OpenMetaverse.ParcelStatus

  • -1 : None
  • 0  : Leased
  • 1  : LeasePending
  • 2  : Abandoned

LandFlags

OpenMetaverse.ParcelFlags
None 0 No flags set
AllowFly 1 Allow avatars to fly (a client-side only restriction)
AllowOtherScripts 2 Allow foreign scripts to run
ForSale 4 This parcel is for sale
AllowLandmark 8 Allow avatars to create a landmark on this parcel
AllowTerraform 16 Allows all avatars to edit the terrain on this parcel
AllowDamage 32 Avatars have health and can take damage on this parcel. If set, avatars can be killed and sent home here
CreateObjects 64 Foreign avatars can create objects here
ForSaleObjects 128 All objects on this parcel can be purchased
UseAccessGroup 256 Access is restricted to a group
UseAccessList 512 Access is restricted to a whitelist
UseBanList 1024 Ban blacklist is enabled
UsePassList 2048 Unknown
ShowDirectory 4096 List this parcel in the search directory
AllowDeedToGroup 8192 Allow personally owned parcels to be deeded to group
ContributeWithDeed 16384 If Deeded, owner contributes required tier to group parcel is deeded to
SoundLocal 32768 Restrict sounds originating on this parcel to the parcel boundaries
SellParcelObjects 65536 Objects on this parcel are sold when the land is purchsaed
AllowPublish 131072 Allow this parcel to be published on the web
MaturePublish 262144 The information for this parcel is mature content
UrlWebPage 524288 The media URL is an HTML page
UrlRawHtml 1048576 The media URL is a raw HTML string
RestrictPushObject 2097152 Restrict foreign object pushes
DenyAnonymous 4194304 Ban all non identified/transacted avatars
LindenHome 8388608 No comment in documentation or this one!
AllowGroupScripts 33554432 Allow group-owned scripts to run
CreateGroupObjects 67108864 Allow object creation by group members or group objects
AllowAPrimitiveEntry 134217728 Allow all objects to enter this parcel
AllowGroupObjectEntry 268435456 Only allow group and owner objects to enter this parcel
AllowVoiceChat 536870912 Voice Enabled on this parcel
UseEstateVoiceChan 1073741824 Use Estate Voice channel for Voice on this parcel
DenyAgeUnverified 2147483648 Deny Age Unverified Users

LandingType

The landing point setting for the parcel: 0 is Blocked, 1 is 1anding point set, 2 is for landing allowed anywhere.

MediaAutoScale

A boolean (1 or 0) indicating whether media should be stretched to fit the face of the prim it's displayed on.

MediaTextureUUID

The UUID of a texture. Objects using this texture will show a video stream or web page after they click the video play arrow in their viewer.

MediaURL

The URL of the video stream, or media, to be played in this land.

MusicURL

The URL of the Music station to be played in this land.

Passhours

The length of time that a pass to his parcel is valid.

PassPrice

The cost of a pass to this parcel.

SnapshotUUID

The UUID (key) on the asset table of a picture of this parcel.

UserLocationX

The X co-ordinate of the parcel's landing zone (if set).

UserLocationY

The Y co-ordinate of the parcel's landing zone (if set).

UserLocationZ

The Z co-ordinate of the parcel's landing zone (if set).

UserLookAtX

To be identified.

UserLookAtY

To be identified.

UserLookAtZ

To be identified.

AuthBuyID

The UUID of the User authorised to buy this land.

OtherCleanTime

Other residents objects in the parcel will be automatically returned after this many minutes has elapsed. Set to 0 to disable auto-return of objects.

Dwell

To be identified.

Retrieved from "http://opensimulator.org/index.php?title=Land_(database_table)&oldid=23131"
Personal tools
General
About This Wiki