Starting Up

Setup

Starting Up

Notes

Initial Settings File

Screen Settings
General System
3D Display Settings
3D Default Scene Settings

Setup

Hardware Setup:

Connect the device used for previewing to the PC with a USB cable.
Depending on the combinations of machines and their connections, USB communication between the Viewer and the PC may not work; check the Requirement Specifications.

Software Setup:

PARTNER-CTR Debugger software setup must be complete. For more information, see the PARTNER-CTR Debugger setup manual.
Install CTR-SDK. First, the folder in which CTR-SDK is installed must be set using the environment variable CTRSDK_ROOT and update to CTR-SDK-compatible firmware for devices used for preview.
Install NintendoWare. The Viewer will be installed in the Viewer folder below NintendoWare/CTR (indicated below as NW4C_ROOT).

Starting Up

The procedure to start the Viewer is shown below:

Configure the Viewer's initial settings.
If screen size settings are required, edit (NW4C_ROOT)/Viewer/dvdroot/viewer.ini.

This step will not be required at the next or subsequent times if those settings are not changed.
Run the batch file used to start the Viewer.
- Execute $(NW4R_ROOT)/tools/Viewer/LaunchViewer.bat.
  (Note: CTRSDK_ROOT must be set to the folder where CTRSDK is setup.)
PARTNER-CTR HIO-Daemon will be disconnected if the development hardware is turned off or if the USB adapter is removed. Just reconnect if this happens.
Note: If multiple development devices are connected to the PC, check the title bar of PARTNER-CTR HIO-Daemon because it displays the device currently communicating.
You will not be able to connect to the Viewer if it is running on a different device than the one that HIO-Daemon is communicating with.

Notes

Note: If Viewer does not start correctly with PARTNER-CTR Debugger:

Is the CTRSDK_ROOT environment variable set?
The CTRSDK_ROOT environment variable must be set to folder where the CTR-SDK is installed.
Is PARTNER-CTR HIO-Daemon running?
HIO-Daemon must be installed and running.
Does the installed CTR-SDK support the PARNTER-CTR Debugger version being used?
The version of the SDK set with CTRSDK_ROOT must be compatible with the PARTNER-CTR Debugger version being used.
Has the PARTNER-CTR Debugger firmware been updated to a supported version?
In order to use PARTNER-CTR Debugger, it is necessary to update to the latest PARTNER-CTR Debugger firmware version supported by the SDK being set up.

Initial Settings File

Edit the file $(NW4C_ROOT)/tools/Viewer/Viewer.ini with a text editor to change the screen settings displayed on Viewer.

The Viewer.ini file is read each time Viewer is launched. If the settings are changed, Viewer must be restarted.

The following items can be set:

Screen Settings

Performs screen settings.

Configure the values after the key names following /system/video/ as shown below.

Example: /system/video/clr_color = 0x404040FF

Key Name	Description
clr_color	Sets the clear color value.
clr_z	Sets the clear Z value.

System Basics

Viewer mode settings are configured.

Configure the values after the key names following /system/config/ as shown below.

Specify path settings using in the form of full path plus filename.

Example: /system/config/capture_image = C:\NintendoWare\CTR\tools\Viewer\Capture.bmp

Key Name	Description
default_mode	Sets the default mode when launching the Viewer. You can choose one of the following modes: 3D: 3D Mode EFF: Effect Mode
default_model	Sets the file path for the model to load by default.
reload_target	Sets the file reload path.
capture_image	Sets the path for saving screen captures.
controller_mode	Sets the operation mode. (Currently cannot be set.)
frame_rate	Configures all of the animation frame rate.
frame_skip	Sets whether to skip animation frames when processing slows down. 0: Do not skip 1: Skip

3D Display Settings

Configures the 3D display settings.

Be sure to set the values after the key names following /system/information/ as shown below.

Example: /system/information/grid_visible = 1

Key Name	Description
sub_mode	Sets the Graphics sub-mode at Viewer startup. CAM: Camera mode MNU: Menu mode
grid_visible	Sets whether grid display is enabled. 0: Do not display 1: Display
grid_scale	Sets the size of the grid scale when displaying the coordinate axes or grid. Specify a real number between 0.001 and 1000.0.
grid_num	Sets the number of divisions in the grid scale when displaying the coordinate axes or grid. Specify an integer between 1 and 20.
grid_color	Sets the grid color when displaying the grid.

3D Default Scene Settings

Configures the 3D default scene settings.

Camera Settings

Configure the values after the key names following /g3d/ as shown below.

Example: /g3d/camera/distance rotation_init = 4.032

Key Name	Description
rotation_init	Sets the initial value for rotation velocity.
rotation_step	Sets the acceleration per frame for rotation velocity.
rotation_max	Sets the maximum rotation velocity.
translation_init	Sets the initial value for translation velocity.
translation_step	Sets the acceleration per frame for translation velocity.
translation_max	Sets the maximum value for translation velocity.
tilt_init	Sets the initial value for tilt velocity.
dolly_init	Sets the initial value for dolly translation velocity.
tilt_accel	Sets the acceleration versus pixels during tilt rotation.
tilt_decel	Sets the deceleration per frame for tilt rotation.
tilt_limit	Sets the velocity limit per frame for tilt rotation.
slide_accel	Sets the acceleration versus pixels during slide translation.
slide_decel	Sets the deceleration per frame during slide translation.
slide_limit	Sets the velocity limit per frame during slide translation.
tumble_x_inverse	Sets the tumble x inverse flag for camera-controlled rotation. 0: Do not inverse 1: Inverse
tumble_y_inverse	Sets the tumble y inverse flag for camera-controlled rotation. 0: Do not inverse 1: Inverse
track_x_inverse	Sets the tumble x inverse flag for camera-controlled translation. 0: Do not inverse 1: Inverse
track_y_inverse	Sets the tumble y inverse flag for camera-controlled rotation. 0: Do not inverse 1: Inverse
dolly_inverse	Sets the dolly inverse flag for camera-controlled translation. 0: Do not inverse 1: Inverse
dolly_target_inverse	Sets the dolly target inverse flag for camera-controlled translation. 0: Do not inverse 1: Inverse
tilt_x_inverse	Sets the x inverse flag for camera-controlled tilt. 0: Do not inverse 1: Inverse
tilt_y_inverse	Sets the y inverse flag for camera-controlled tilt. 0: Do not inverse 1: Inverse
fovy	Sets the view angle for the default camera.
position/x	Sets the x value for the default camera.
position/y	Sets the y value for the default camera.
position/z	Sets the z value for the default camera.
target_pos/x	Sets the x value of the default camera target.
target_pos/y	Sets the y value of the default camera target.
target_pos/z	Sets the z value of the default camera target.
up_vector/x	Sets the x value of the default camera up vector.
up_vector/y	Sets the y value of the default camera up vector.
up_vector/z	Sets the z value of the default camera up vector.
touch_panel_mode	Sets the touch panel operation mode. NORMAL: Normal mode DRAG: Drag mode INERTIA: Inertia mode
near	Sets the camera near clip.
far	Sets the camera far clip.

Light Settings

Configure by entering /g3d/light/ followed by the key names and their values, as shown in the example below:.

Example: /g3d/light/global_ambient_color = 0x333333FF

Key Name	Description
global_ambient_color	Sets the light color of the global ambient light using RGBA values.
light0_kind	Sets the light type. DIRECTIONAL: Parallel light source POINT: Point light source
light0_ambient_color	Sets Ambient Color 1 of Light 0 using RGBA values.
light0_diffuse_color	Sets Diffuse 1 of Light 0 using RGBA values.
light0_specular0_color_specular0_color	Sets Specular 0 of Light 0 using RGBA values.
light0_specular1_color	Sets Specular 0 of Light 1 using RGBA values.
light0_direction/x	Sets the x value of the Light 0 direction vector.
light0_direction/y	Sets the y value of the Light 0 direction vector.
light0_direction/z	Sets the z value of the Light 0 direction vector.

Effect Settings

Configure by entering /effect/config/ followed by the key name and a value, as shown in the example below:

Example: /effect/config/max_frame_count = 200

Key Name	Description
sub_mode	Sets the Effect sub-mode at Viewer startup. CAM: Camera mode MNU: Menu mode
max_frame_count	Sets the maximum frame count.
loop_flag	Sets whether looping is enabled. 0: Do not loop 1: Loop

CONFIDENTIAL