OgreNavLib - Revision history

Kannkor: /* Methods */

2017-11-14T20:56:09Z

‎Methods

Kannkor: /* How to use it? - With creating a script - Basic example */

2017-11-14T20:06:34Z

‎How to use it? - With creating a script - Basic example

Kannkor: /* How to use it? - With creating a script - Basic example */

2017-11-14T20:05:57Z

‎How to use it? - With creating a script - Basic example

Kannkor: /* OgreNavLib - Methods and Members */

2017-11-14T20:03:14Z

‎OgreNavLib - Methods and Members

Kannkor at 19:59, 14 November 2017

2017-11-14T19:59:39Z

Kannkor: Created page with "OgreNavLib == What is OgreNavLib? == OgreNavLib is a library of commands I have written, so scripts can navigate the world. This is a complete rewrite of 'OgreNavLib.inc', wh..."

2017-11-14T19:29:58Z

Created page with "OgreNavLib == What is OgreNavLib? == OgreNavLib is a library of commands I have written, so scripts can navigate the world. This is a complete rewrite of 'OgreNavLib.inc', wh..."

New page

OgreNavLib

== What is OgreNavLib? ==
OgreNavLib is a library of commands I have written, so scripts can navigate the world. This is a complete rewrite of 'OgreNavLib.inc', which will be phased out and not updated.

This will primarily be used by advanced scripters, such as myself, BJCasey, Pork, etc, to automate navigating. While technically anyone is welcome to use it, it will require a solid understanding of LavishScript to use.

== What's new over the old one? ==
It was completely re-written from the ground up. The movement is better, the error reporting is better, the code is better, and debugging it is 100 times better.

Oh, did I mention, it supports '''flying'''?

== How to use it? - Without creating a script - Basic example ==
For basic use, it will be nearly identical to the old way. You create a map: (this command may change): ogre navmap

While you're creating your map, you can fly as you see fit, land when you want, and fly again.

Note: Technically creating a map is not required, as with before, if there is direct line of sight with no obstacles, it will go directly there, including flying to/from a location.

When you want to move some where, you do the same as what you have done previously:

You navigate to it. (This command will likely change): ogre navtest <parameters>
* Note: ogre navtest is identical to ogre nav, except it uses the new lib instead of the old one. But all flags will. Such as -loc, -ntr, -tr, etc etc.
For example:
* ogre navtest Point1
** You would navigate to a custom named point of 'Point1'
* ogre navtest -loc 10 30 -382
** You would navigate to a location of: 10,30,-382

== How to use it? - With creating a script ==
This will give you more control over how the lib works, but for obvious reasons, is way more technical.

Create a script, and include the library, then create the library, change any values in the library you wish to change, then have start the navigation.

There are two files (or, will be), in your /Scripts/OgreNav/ folder. OgreNavExample.iss and OgreNavExampleAdvanced.iss
* OgreNavExample.iss is a very basic example of how to use it, with nearly no options changed from the default.
<pre>function main(string _Location="WhereDoYouWantToGo")
{
ogre navlib
wait 5
Obj_OgreCreateNavLibs:CreateNavLib[${Script.Filename}]
Obj_OgreCreateNavLibs:CreateNavEntry[${Script.Filename}]

OgreNavEntry:Set_Location["${_Location}"]
call OgreNavLib.OgreNav OgreNavEntry
}</pre>
There are 3 parts to note, that will be required before using the Nav lib.
* Step 1: Make sure the navlib is loaded, and wait some indetermined amount of time for it to load.
<pre> ogre navlib
wait 5</pre>
* Step 2: Create the Nav lib
** This creates 'OgreNavLib' for you.
** See <this link> for members and methods of OgreNavLib.
<pre> Obj_OgreCreateNavLibs:CreateNavLib[${Script.Filename}]</pre>
* Step 3: Create a navigation entry.
** This is how you tell the nav lib where you want to go.
** See <this link> for members and methods of OgreNavEntry.
<pre> Obj_OgreCreateNavLibs:CreateNavEntry[${Script.Filename}]</pre>

The rest is pretty basic. You modify anything in NavLib/NavEntry, then you call OgreNav and pass it the Entry. Simple huh?

@@ Line 98: / Line 98: @@
 ** method Set_StuckDistance(float _Value)
 ** method Set_TargetRequired(bool _Value)
 * Currently not able to be updated by the user. But will be in the future.
 ** method Set_OgreNavChecks(persistentref _ref)
 ** method Set_OgreNavInformation(persistentref _ref)
 == OgreNavEntry - Methods and Members ==

@@ Line 70: / Line 70: @@
 * member:bool Paused()
 ** Check if OgreNavLib is paused.
 * member:string Status()
 ** Various status that are being reported by OgreNavLib. This will likely need testing to be very useful.
@@ Line 86: / Line 87: @@
 ** Used to stop movement.
 * The rest below should be straight forward. They are for changing various values. If an explanation is required PM me.
 ** method Set_AllowFlyingOffMap(bool _Value)
 ** method Set_AllowOffMapFudging(bool _Value=TRUE)
@@ Line 99: / Line 101: @@
 ** method Set_OgreNavChecks(persistentref _ref)
 ** method Set_OgreNavInformation(persistentref _ref)

@@ Line 57: / Line 57: @@
 * Step 3: Create a navigation entry.
 ** This is how you tell the nav lib where you want to go.
-** See <this link> for members and methods of OgreNavEntry.
+** See [[OgreNavLib#OgreNavEntry_-_Methods_and_Members|This link]] for members and methods of OgreNavEntry.
 <pre>	Obj_OgreCreateNavLibs:CreateNavEntry[${Script.Filename}]</pre>

@@ Line 53: / Line 53: @@
 * Step 2: Create the Nav lib
 ** This creates 'OgreNavLib' for you.
-** See <this link> for members and methods of OgreNavLib.
+** See [[OgreNavLib#OgreNavLib_-_Methods_and_Members|This link]] for members and methods of OgreNavLib.
 <pre>	Obj_OgreCreateNavLibs:CreateNavLib[${Script.Filename}]</pre>
 * Step 3: Create a navigation entry.

@@ Line 12: / Line 12: @@
 Oh, did I mention, it supports '''flying'''?
-== How to use it? - Without creating a script - Basic example ==
+== How to use it? - Without creating a script ==
 For basic use, it will be nearly identical to the old way. You create a map: (this command may change): ogre navmap
@@ Line 30: / Line 30: @@
 ** You would navigate to a location of: 10,30,-382
-== How to use it? - With creating a script ==
+== How to use it? - With creating a script - Basic example ==
 This will give you more control over how the lib works, but for obvious reasons, is way more technical.
@@ Line 61: / Line 61: @@
 The rest is pretty basic. You modify anything in NavLib/NavEntry, then you call OgreNav and pass it the Entry. Simple huh?