Sylex Examples :)

  ||||Introduction||||
Hello,
in the following paragraph I will try to briefly explain what Sylex 3.0 is used for. Sylex 3.0 is small 3D engine that works with Acknex 3D Game Studio 6. 
This engine was written to be used in my project "Sunset Down" and it only works with Commercial or Professional edition of 3D Game Studio. 
In this documentation you will find everything you need to know on how to work with our Plugin.

You may ask youselves about the licensing of this plugin. It is Freeware. Simply e-mail me at: SebastianLeopold@aol.com.
In the end, here's a picture from our project Sunset Down:
[TODO: I'll put the picture]

||||Tutorials||||

Tutorial 01: integrate sylex 3.0
Tutorial 01: provideing Render Targets
Tutorial 01: Useing the clip planes
Tutorial 01: Using Post-Processing
Tutorial 01: Write you own Post-Processing
Tutorial 01: Using of Sky boxing
Tutorial 01: Using of Water Objects

 [b]||||Tutorial01||||      
Introduction:  [/b] In this Tutorial I will show you how to insert Sylex 3.0 in your projects. In addition we provide an easy project to start and again to finish. 
All resources from the Plugin must be realeased again after you use them.

[b]Installation of Sylex 3.0[/b]
Sylex 3.0 comes with several files. You must copy the files in order to be able to use Sylex 3.0. We begin with the file: sylex3_csr.wdl. 
This should go to you Template folder or copy it in the folder which you Script Data is located in your project. The "Sylex3.dll" goes to your acknex_plugins in 3D Gamestudio folder. 
You must also copy the SLX3Content into your project folder. Once you copied the necessary files you should now be able to work with the Sylex 3.0 Plugin.


[b]Including Sylex 3.0 into your project: [/b]

At first you must include the C-Script "sylex3_csr.wdl" into your project. You do this by using the include function in C-Script. 
In this Script there are a few constants that define the internal data types of Sylex 3.0 representation . 
Furthermore there are prototypes of the exported DLL - to access the Sylex 3.0 Plugin functions. 
You will find an explanation of the functions with example in this documentation in 'Reference' area.
You must not change this Script. But in some cases  this can happen that two or several Plugins use the same Acknex 6 pointer functions. 
In this case you must 
remove the allocations of these pointers in this file and substitute with your own  functions.

Here is how to include this file:

||Code01||
// Includes: 
include <sylex3_csr.wdl>;
// TODO: Other includes go here.
// ... 
/||Code01||

The next the function that must be called is SLX3Initialize(var_mode, str_title). 
This function initializes Sylex 3.0 and makes the components of the Plugins ready for C-Script. 
By the way, the first parameter gives the mode in which Sylex 3.0 begins and the second parameter is the title of the 3DGamestudio window. 
To receive precise information about this function please check the reference in the area 'general functions'. 
You should call the function at the beginning of the Main() function. 
Here's an example of Main function that only Sylex 3.0 is initialized and a level loads.

||Code02||
// Main function with initialization of Sylex 3.0: 
function main()
{
   // Initialization of Sylex 3.0
   SLX3Initialize(SLX3_RUNMODE_DEBUG,"Testanwendung mit Sylex 3.02"); 

  // Load level
   level_load("Test.wmb"); 

   // Other functions from the Main call
} 
/||Code02||


The important step about Sylex 3.0 to be able to use the Plugin correctly is to finish it properly. 
This step is most important in this Tutorial because if you use Sylex 3.0 and finish it wrong it will lead to  [url=http://en.wikipedia.org/wiki/Memory_leak]Memory Leak[/url]. 
The wrong finishing mostly also leads to an error in Acknex 6 engine. 
Therefore, we write the function as an example to see how to finish the plugin usage.
 The two pointer functions : on_d3d_lost and on_d3d_reset must be set to NULL and then call the function SLX3DeInitialize() before the "exit" function of C-Script/Acknex 6. 
In addition, you must provide some key definitions for application window to be closed properly. 
For ex, clicking on X at the top-right of the window closes it or if the key F10 is pressed it will exit the software. 
The key ESC usually closes the engine , therefore, we will likewise define this key. That being said, we can now begin with the code for this function:

||Code03||
// user-defined Exit function with ending of Sylex 3.0 
function userdef_exit()
{
   // Sylex 3.0 Deinitialization
   SLX3DeInitialize();; 

   // Pointer functions to be reset.
   on_d3d_lost = NULL; 
   on_d3d_reset = NULL; 

   // Acknex 6 Engine finishing 
   exit; 
} 

Testing definitions:
ON_ESC = userdef_exit; // Define the ESC key
ON_CLOSE = userdef_exit; // Defining the 'X' button at the top right of the window
ON_F10 = userdef_exit; // Behandlung der F10 Taste 

/||Code03||

In the next Tutorials you will learn about calling of Sylex 3.0 functions and 
how to use for ex, Post-Processing effects and how to show water or sky of Sylex 3.0. 
If you have any problem with they tutorial or if something is not functioning properly write an email to me at: SebastianLeopold@aol.com.

var Blur = 1; 

function activate_MotionBlur()
{
	if (Blur == 1)
	{
	// Blureffekte setzen
   SLX3ViewSetPostProcessingEffect(10,0,SLX3_PPE_HBLUR);
   SLX3ViewSetPostProcessingEffect(10,1,SLX3_PPE_VBLUR);
   SLX3ViewSetPostProcessingEffect(10,2,SLX3_PPE_HBLUR);
   SLX3ViewSetPostProcessingEffect(10,3,SLX3_PPE_VBLUR); 
   SLX3ViewSetPostProcessingEffect(10,5,0);

   // Post-Processing aktivieren
   SLX3ViewSetPostProcessing(10,1);
while(Blur != 0)
   {

      SLX3EffectSetValue(SLX3_PPE_HBLUR,0,1.5  );
      SLX3EffectSetValue(SLX3_PPE_VBLUR,0,1.5 * key_force.y );
      wait(1);
    }
    
    }

} 

// Deaktiviert das Post-Processing
function deactivate_MotionBlur()
{
   Blur = 0;
}

Quote:

---

Okay I don't wanna be putting up a competition here at translating the manual but I had some free time today and translated the Tutorial parts as well as the reference part regarding the views and put it into a chm file.

Get it here:

http://www.team-blacksun.de/slx3doc_en.chm

Will do the rest tommorow morning

Greets Sven

---

Thanks a lot man!
As much as translating this manual is easy for you that much is difficult for me. In fact. if i knew that someone will do this favour for us I would have never started translating at the first place. So keep up the good work!
and btw, could you tell me which software you use to make chm files ?


Cheers,

Quote:

---

Is anybody else except for Sorcerer having problems with the file?

@Sorcerer: do you have problems downloading? Or is the file not readable afterwards?

Greets
Sven

---

I can open the tutorial, but when I click over the index, the page doesn't open, not even one.

Quote:

---

are you sure you registered the right camera? I don't know as I don't work with the templates but what is the main view called in the templates and what layer is its layer?

Does the motion blur of Matt's examples work for you?

Greets
Sven

P.S.: I have noticed a strange effect.... HBLUR doesn't work for me only VBLUR
Same goes for HBLOOM only VBLOOM seems to work...anybody have an idea?

---

yup you can only do one at a time ..as far as i can tell .. you can either do Hblur OR Vblur ..

i cant get tonemapping to work at all which is a bummer ..

i have been able to make a sky box and render to texture one side of it ! yay! /sarcasm

these release of sylex 3 seems just to be a template for some one to finish programming it ..a lot of things do not work .. mainly .. adding y our A6 models .. which is the biggest part to it ..