Roku SDK Documentation : Tutorial Overview

Every ZIP file example in this tutorial is a complete application, in that it consists of at least a scene component (a component extended from a scene node class, such as Scene, or OverhangPanelSetScene), and possibly any other components needed for the example. It also includes all of the graphic images, and content meta-data (or links to content meta-data) required for the application, and the main.brs and manifest files needed to launch the application.

But each example is designed to isolate and demonstrate a specific Roku SceneGraph node class, or design/development principle. The examples only show the very specific aspects of each example to demonstrate their use in general Roku SceneGraph development. For this reason, the scene component used in the examples typically only contains the minimum amount of code required for a typical application, to highlight the example usage.

In most cases, the scene component includes code in the <script> element init() function to set the background image for the application, center the example in the screen, and set focus on the scene:

sub init()
  m.top.backgroundURI = "pkg:/images/rsgde_bg_hd.jpg"
  example = m.top.findNode("exampleRectangle")
  examplerect = example.boundingRect()
  centerx = (1280 - examplerect.width) / 2
  centery = (720 - examplerect.height) / 2
  example.translation = [ centerx, centery ]
  m.top.setFocus(true)
end sub

As this code (or equivalent) is found in almost all the example scene XML component files, it is not described in the tutorial. Likewise, since virtually the same code is used in the every example main.brs and manifest file, these files will not be described in the tutorial, as well as the files in the package images directory. The only time any of these files will be covered in this tutorial is if they serve a specific purpose in the specific example.