Orx Learning

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Scroll, Cameras and Viewports ======

This is a super short tutorial, more a reminder of how Cameras and Viewports are a tad different from a plain orx project.

===== The MainCamera and MainViewport =====

In a Scroll project, the MainCamera and MainViewport are created automatically. They are not created manually in the ''init()'' function like in a plain orx project.

<WRAP center round important 60%>
Please be aware that this is currently changing. Creating the viewport will be the responsibility of the developer. There will be upgrade walkthrough when this change comes about.
</WRAP>


As long as they are defined in the config file (and they come with a generated project), then they will be created when the game starts.

===== Getting Access =====

Of course you can still get access to the default ones via code using:

<code c>
    orxFLOAT viewportWidth = 0;
    orxFLOAT viewportHeight = 0;

    orxViewport_GetSize(this->GetMainViewport(), &viewportWidth, &viewportHeight);
</code>

and...

<code c>
    camera = this->GetMainCamera();
    currentZoom = orxCamera_GetZoom(camera);
</code>

===== Other Viewports =====

You can continue to create other viewports the standard way, for example:

    orxViewport_CreateFromConfig("SomeOtherViewport");
    
And matching config could be:

<code ini>
[HudViewport]
Camera          = HudCamera
Size = (200, 200, 0)
RelativePosition = bottom right

[HudCamera]
FrustumWidth  = 200
FrustumHeight = 200
FrustumFar    = 2.0
FrustumNear   = 0.0
Position      = (0.0, 0.0, -2.0)
Zoom = 0.02
</code>

That's it, nice and short.
Orx Learning

User Tools

Site Tools

Page Tools
