Difference between revisions of "LavishNav:lnavregion (Object Type)"

From Lavish Software Wiki
Jump to navigation Jump to search
Line 2: Line 2:
  
 
== Members ==
 
== Members ==
*... '''Parent''':
+
*... '''Parent''': The region immediately containing this one
*... '''Children''':
+
*... '''Children''': The first child region in this region's tree
*... '''Next''':
+
*... '''Next''': The next sibling region
*... '''Previous''':
+
*... '''Previous''': The previous sibling region
*[[DataType:uint|uint]] '''ID''':
+
*[[DataType:uint|uint]] '''ID''': This region's unique identifier number
*[[DataType:string|string]] '''Name''':
+
*[[DataType:string|string]] '''Name''': This region's name
*[[DataType:string|string]] '''FQN''':
+
*[[DataType:string|string]] '''FQN''': The Fully-Qualified Name for this region
*[[DataType:bool|bool]] '''Unique''':
+
*[[DataType:bool|bool]] '''Unique''': Is this region unique?
*[[DataType:bool|bool]] '''Avoid''':
+
*[[DataType:bool|bool]] '''Avoid''': Is this region marked avoid?
*[[DataType:bool|bool]] '''InheritedAvoid''':
+
*[[DataType:bool|bool]] '''InheritedAvoid''': Is one of this region's ancestors marked avoid, thus allowing this region to inherit avoidance?
*[[DataType:bool|bool]] '''AnyAvoid''':
+
*[[DataType:bool|bool]] '''AnyAvoid''': Is this region marked avoid OR does it inherit avoidance (as above)?
*[[DataType:bool|bool]] '''AllPointsValid''':
+
*[[DataType:bool|bool]] '''AllPointsValid''': Is this region marked "All points valid", thus allowing safe random point generation within the bounds of this region?
*[[DataType:bool|bool]] '''Contains['''x''','''y''','''z''']''':
+
*[[DataType:bool|bool]] '''Contains['''x''','''y''','''z''']''': Does this region contain the given point (coordinates may be ommitted to check for x,0,0 or x,y,0)?
*[[DataType:string|string]] '''Type''':
+
*[[DataType:string|string]] '''Type''': The region type (point, rect, radius, box, etc)
*[[DataType:string|string]] '''Custom['''name''']''':
+
*[[DataType:string|string]] '''Custom['''name''']''': Value of the custom data point with this name
 
*... '''AddChild['''type''','''name''','''...''']''': Adds a child region given a type (such as point) and a name.  Extra parameters are used to construct the new region.  To construct a unique region, use -unique.  To construct a region that defines a coordinate system, use -coordinatesystem.  These must be the first extra parameters, before any region type-specific parameters.
 
*... '''AddChild['''type''','''name''','''...''']''': Adds a child region given a type (such as point) and a name.  Extra parameters are used to construct the new region.  To construct a unique region, use -unique.  To construct a region that defines a coordinate system, use -coordinatesystem.  These must be the first extra parameters, before any region type-specific parameters.
 
*... '''FindRegion['''search''']''': Finds a region with a relative [[LavishNav:Region Name Search|Region Name Search]]
 
*... '''FindRegion['''search''']''': Finds a region with a relative [[LavishNav:Region Name Search|Region Name Search]]
*point3f '''NearestPoint''':
+
*point3f '''NearestPoint['''x''','''y''','''z''']''': Retrieves the nearest point to the given location (coordinates may be ommitted to use x,0,0 or x,y,0)
*point3f '''CenterPoint''':
+
*point3f '''CenterPoint''': The center point
*... '''CoordinateSystem''': The region that defines the coordinate system for this particular region
+
*... '''CoordinateSystem''': The ancestor region that defines the coordinate system for this particular region
 +
*[[DataType:bool|bool]] '''IsCoordinateSystem''': TRUE if this region defines a coordinate system for its descendant regions
  
 
== Methods ==
 
== Methods ==
Line 29: Line 30:
 
*'''ExportChildren['''filename''']''': Exports this region's children to a LavishNav XML file
 
*'''ExportChildren['''filename''']''': Exports this region's children to a LavishNav XML file
 
*'''Remove''': Removes the region
 
*'''Remove''': Removes the region
*'''Connect''': not yet implemented
+
*'''Disconnect['''search''']''': not yet implemented
*'''Disconnect''': not yet implemented
+
*'''SetCustom['''name''','''text''']''': Creates a custom data point with this name and value
*'''SetCustom['''name''','''text''']''': Creates a custom data point
 
 
*'''UnsetCustom['''name''']''': Removes a custom data point
 
*'''UnsetCustom['''name''']''': Removes a custom data point
 
*'''SetAllPointsValid['''value''']''': Sets the "All points valid" flag
 
*'''SetAllPointsValid['''value''']''': Sets the "All points valid" flag
 
*'''SetUnique['''value''']''': Sets the unique flag
 
*'''SetUnique['''value''']''': Sets the unique flag
 
*'''SetAvoid['''value''']''': Sets the avoid flag
 
*'''SetAvoid['''value''']''': Sets the avoid flag
*'''AddChild['''type''','''name''','''...''']''':
+
*... '''AddChild['''type''','''name''','''...''']''': Adds a child region given a type (such as point) and a name.  Extra parameters are used to construct the new region.  To construct a unique region, use -unique.  To construct a region that defines a coordinate system, use -coordinatesystem.  These must be the first extra parameters, before any region type-specific parameters.
*'''Connect['''search''']''':
+
*'''Connect['''search''']''': Connects this region to the given region, using a relative [[LavishNav:Region Name Search|Region Name Search]]
  
 
== Inherits ==
 
== Inherits ==

Revision as of 18:49, 12 March 2006

Description

Members

  • ... Parent: The region immediately containing this one
  • ... Children: The first child region in this region's tree
  • ... Next: The next sibling region
  • ... Previous: The previous sibling region
  • uint ID: This region's unique identifier number
  • string Name: This region's name
  • string FQN: The Fully-Qualified Name for this region
  • bool Unique: Is this region unique?
  • bool Avoid: Is this region marked avoid?
  • bool InheritedAvoid: Is one of this region's ancestors marked avoid, thus allowing this region to inherit avoidance?
  • bool AnyAvoid: Is this region marked avoid OR does it inherit avoidance (as above)?
  • bool AllPointsValid: Is this region marked "All points valid", thus allowing safe random point generation within the bounds of this region?
  • bool Contains[x,y,z]: Does this region contain the given point (coordinates may be ommitted to check for x,0,0 or x,y,0)?
  • string Type: The region type (point, rect, radius, box, etc)
  • string Custom[name]: Value of the custom data point with this name
  • ... AddChild[type,name,...]: Adds a child region given a type (such as point) and a name. Extra parameters are used to construct the new region. To construct a unique region, use -unique. To construct a region that defines a coordinate system, use -coordinatesystem. These must be the first extra parameters, before any region type-specific parameters.
  • ... FindRegion[search]: Finds a region with a relative Region Name Search
  • point3f NearestPoint[x,y,z]: Retrieves the nearest point to the given location (coordinates may be ommitted to use x,0,0 or x,y,0)
  • point3f CenterPoint: The center point
  • ... CoordinateSystem: The ancestor region that defines the coordinate system for this particular region
  • bool IsCoordinateSystem: TRUE if this region defines a coordinate system for its descendant regions

Methods

  • Clear: Resets the region such that it will contain no child regions
  • Import[filename]: Imports a LavishNav XML file as children of this region
  • Export[filename]: Exports this region and its children to a LavishNav XML file
  • ExportChildren[filename]: Exports this region's children to a LavishNav XML file
  • Remove: Removes the region
  • Disconnect[search]: not yet implemented
  • SetCustom[name,text]: Creates a custom data point with this name and value
  • UnsetCustom[name]: Removes a custom data point
  • SetAllPointsValid[value]: Sets the "All points valid" flag
  • SetUnique[value]: Sets the unique flag
  • SetAvoid[value]: Sets the avoid flag
  • ... AddChild[type,name,...]: Adds a child region given a type (such as point) and a name. Extra parameters are used to construct the new region. To construct a unique region, use -unique. To construct a region that defines a coordinate system, use -coordinatesystem. These must be the first extra parameters, before any region type-specific parameters.
  • Connect[search]: Connects this region to the given region, using a relative Region Name Search

Inherits

none

Returns

NULL

Examples

See Also