/****************************************************************************
 *
 * CRI Middleware SDK
 *
 * Copyright (c) 2001-2006 CRI-MW
 *
 * Title   : CRI Middleware SDK for PLAYSTATION3
 * Module  : Release Notes
 * File    : release_ps3_e.txt
 * Date    : 2006-04-05
 * Version : 0.80 UpdatePack1
 *
 ****************************************************************************/

/*--------------------------------------------------------------------------*/
 *
 * [Table of Contents]
 * 1.  About CRI Middleware SDK
 * 2.  Version Information
 *   2.1  Version Information of This Release
 *   2.2  Revision Histories
 * 3.  Usage of SDK
 *   3.1  Directory Structure
 *   3.2  How to Install
 * 4.  System Requirements
 *   4.1  Hardware
 *   4.2  Software
 * 5.  Particular Information about PS3
 *   5.1  Limitation and Restriction
 *   5.2  Known Problem
 *
 * Caution about Using the CRI SDK
 *
/*--------------------------------------------------------------------------*/

1.  About CRI Middleware SDK
  CRI Middleware SDK is a software development kit that contains CRI middleware
  libraries and tools. (referred to as the CRI SDK in this document.)
  The CRI SDK comes with the following middleware.

    ADX     : Multi Stream Sound System
    Sofdec  : High Quality Movie System

2.  Version Information
2.1  Version Information of This Release
(1) SDK
    CRI SDK for PLAYSTATION3 English Version : Ver.0.80 UpdatePack1

(2) Libraries
    ADX Library                 : Ver.9.77
    Sofdec Library (MWSFD)      : Ver.3.90

2.2  Revision Histories
(1) Libraries
  Revision Histories for libraries are stored in the following directory.
    /cri/ps3/docs/eng/history

(2) Tools
  Version information and revision history for each tool is stored in the
  tool's subdirectory docs.
 (They can also be accessed from the "Tools Overview".)

3.  Usage of SDK
3.1  Directory Structure

   cri
   |
   +- common   ;Common
   |  +- smpdata          ;Data for sample program (*1)
   |  |
   |  +- tools            ;Tool
   |     +- windows
   |         +- sofdec_tools     ;Sofdec Data Creation Tool
   |         +-    :
   |
   +- ps3   ;CRI SDK for PLAYSTATION3
      |
      +- docs      ;Documents
      |
      |- include   ;Header files
      |
      |- libs      ;Library files
      |
      +- samples   ;Sample programs
         +- adx         ;ADX playback sample
         +- sofdec      ;Sofdec playback sample

[Note]
  (*1) Data for sample program is prepared at our web site to download.

3.1  How to Install
  Please follow the instruction as below.

    (1) Download ZIPed SDK file and extract it.
    (2) Copy all files below /cri to somewhere on your host machine at all.
         (eg. c:/cri or c:/usr/local/cri )
    (3) Set "Environment Variables" of your host machine as below.
         Variable : "CRISDK_PS3_ROOT"
         Value    : directory path where you copied /cri.
    (4) Download ZIPed Data file for sample program, and copy as well as SDK.

4.  System Requirements
  This release is built and tested on the following environment.

4.1  Hardware
  DEH-R1000 or later target machine
  720p HDTV, or WXGA monitor

4.2  Software
(1) Runtime Library
    PLAYSTATION(R)3 Programmer Tool Runtime Library 082.006

(2) Compiler
   - PPU -
     ppu-lv2-gcc    : gcc version 4.0.2 (CELL 4.0.11, $Rev: 556 $)
     ppu-lv2-ar     : GNU ar 2.16.1 (CELL 4.0.9, $)
     ppu-lv2-ld     : GNU ld version 2.16.1 (CELL 4.0.9, $)
     ppu-lv2-as     : GNU assembler 2.16.1 (CELL 4.0.9, $)
     ppu-lv2-ranlib : GNU ranlib 2.16.1 (CELL 4.0.9, $)
   - Cg -
     sce-cgc: version 1.5.0b17 (SDK 0.8.2), build date Mar 20 2006 10:30:52.

5.  Particular Information about PS3
5.1  General notes
(1) Versions of the Runtime Library
  If the version of CRI SDK built is not correspond to PLAYSTATION(R)3
Programmer Tool Runtime Library, application program might be hang up.

(2) Make sure to set the CRISDK_PS3_ROOT in your path
  Environment variable "CRISDK_PS3_ROOT" is required to use middleware.
  We recommend to set as OS environment variable. In the case of Windows,
do this by right-clicking on "My Computer", select Properties, click the 
Advanced tab, and click Environment Variables button.  Click "New" under 
System variables. Add a System variable called CRISDK_PS3_ROOT and set it
to c:/cri .
  The build process wants forward slashes, so make sure you don't use 
C:\cri .

(3) Cell system file to copy
  "shaders.bin" file is required for Sofdec sample program.
  Please copy it to your root directory of Cell filesystem previously.
  It is provided in \cell\sample_data\graphics\shaders.bin .

(4) File Server of SN Systems ProDG
  SN tools can be set file server root in various menu. Also if there's no set,
automatically it's assigned as the executable directory.

  The way to set file server root is as follows.
  (a) Target Manager  : "File Server" shown by clicking [Tagret] - [Property]
  (b) ProDG Debuggher : Option area of "Load executable" shown by clicking 
                        [File]-[Load]-[Executable]

(5) Change HDTV to VGA
  Sample program is fixed to output to HDTV.
  If you'd like to output VGA, please rewrite as follows.

    // Create a PSGL device
    PSGLbufferParameters params = {
        width:WINDOW_WIDTH,
        height:WINDOW_HEIGHT,
        colorBits:24,
        alphaBits:8,
        depthBits:24,
        stencilBits:8,
        deviceType:PSGL_DEVICE_TYPE_AUTO,
//      deviceType:PSGL_DEVICE_TYPE_TV,
        TVStandard:PSGL_TV_STANDARD_HD720P,
        TVFormat:PSGL_TV_FORMAT_YCRCB,

5.2  Limitation and Restriction
(1) ADX
  (a) Following functions are not implemented.
      - Balance setting (ADXT_SetOutBalance())
      - Realtime 3D panning (ADXT_SetOutPos())
      - All pausing (ADXT_PauseAll())
      - Transpose setting (ADXT_SetTranspose())
(2) Sofdec
  (a) This version supports ONLY simple playback.
      The other extended file playback is NOT supported.
  (b) Current performance is 1280x720 16Mbps 30fps.
      This version can not play 1280x720 60fps and 1920x1080.
  (c) PSEUDOFS streaming playback is not impractical.
      Now recommended to play out of system memory.
  (d) ONLY YUVA8 frame conversion for shader is available.
      The other frame conversion related to RGB do not have enough performance.

5.3  Known Problems
(1) ADX
  (a) Sound playback streaming via PSEUDOFS, multiple sound playback or AIX
      playback sometimes make some stuttering.
	  That can be hardly occured via CFS and DISCFS.

(2) Sofdec
  (a) Frame interval is not stable even though 1280x720 16Mbps 30fps.
  (b) The color of HDTV does not come out well. It's brighter than real one.
  (c) Playback with audio has same problem as ADX.

/*--------------------------------------------------------------------------*/
 *
 *  Caution about Using the CRI SDK
 *    All information contained in this SDK is confidential information of
 *    CRI Middleware Co.,Ltd.
 *    You are required to enter into a nondisclosure agreement before using 
 *    CRI middleware.
 *    Please treat carefully in accordance with the nondisclosure agreement
 *    between your company and us.
 *
/*--------------------------------------------------------------------------*/

/*--< end of file >---------------------------------------------------------*/
