RESOURCES

1. Overview

    The resources for objects used in the sample program numirror are explained in this chapter, divided into those for characters and for the map (maze).
    All of the character data and map data in this numirror have been converted once from the general purpose 3DGC tools to the N64 intermediate file format NIFF.
   The NIFF files generated are then converted into the data format for the application.

2. About NIFF

   NIFF will be simply explained here. Please refer to the NIFF Manual for details about NIFF.

   As also stated in the "Overview," NIFF is an intermediate file format for N64.
   The general purpose 3DGC tools have different formats whose data formats differ from tool to tool, so that when a different 3DCG tool is used for each application, it is necessary to develop a data converter compatible with each tool.
    Therefore, NIFF files provide for a unified intermediate file format for the N64 in order to absorb the differences in the data formats for each CG tool.
   The CG tools which currently can generate NIFF files are listed below.
   Since these are available as plug-ins for each CG tool, separate plug-ins must be purchased for each tool.

   (1) SOFTIMAGE (not released)
   (2) 3D Studio Max (not released)
   (3) N-WORLD (already released)
   (4) LightWave (already released)
   (5) MultiGenCreator (to be released)
   (6) PowerAnimator (to be released)

3. Character Resource

   The character resource is discussed here.
   The character resource generates a NIFF file for each character from the general purpose CG tool (N-WORLD was used this time), creates a tool to convert the NIFF file into the data format of the simple display driver used by numirror, and converts the data.
  The structure of the character resource files are as follows.

   (1) Resource File Structure

        Used by Game Main

          frake_walk.c ...... Main character walking animation
          frake_down.c .... Main character falling down animation
          CornGroup.c ..... Corn flakes
          goal.c ................. Goal plate

        Used by Select Character

          frake_select.c ..... Main character deformation animation
          frake_kime.c ....... Main character decision animation
          pump.c ................ Select character cursor

4. Map Resource

   The map resource is discussed here.
   The map resource generates a NIFF file of the map from the general purpose CG tool (N-WORLD was used), creates a tool for converting the NIFF file to a data format which can be searched by numirror, and converts the data.
   However, a simple display driver is not used for the map resource.
   The file structure of map resource files is shown below.

    (1) Resource File Structure

          aa_group.c ...... Data for area A in map
          bb_group.c ...... Data for area B in map
          cc_group.c ...... Data for area C in map
          dd_group.c ...... Data for area D in map
          ee_group.c ...... Data for area E in map

         We will stop here with introducing the resource file structure for the map.
         The actual structure of the map in the program is explained in "Map (Maze) Structure".

5. NIFF Data Files

 The NIFF data files utilized in this version of numirror are explained in this section.

 (1) NIFF Data File Directory Structure

      The NIFF data file directory structure is shown below.

       Mirror_Niff
               |
               ---------bin
               |
               ---------map
               |
               ---------obejct

       bin

        The conversion tools for converting from the current NIFF file to the data format which actually can be searched by the game are stored in the bin directory.
        There are two types of converters each for PC and SGI versions, as shown below.

         PC Version

         niff2wincv.exe   (For character resource conversion)
         niff2winomb.exe (For map resource conversion)

         SGI Version

         niff2sgicv   (For character resource conversion) 
         niff2sgiomg (For map resource conversion)

       map

        The NIFF data files which are the source of the map resources explained in 4., above, are stored in the map directory.

       object

        The NIFF data files which are the source of the character resources explained in 3., above, are stored in the object directory.

  (2) NIFF Data File Conversion Method

      Make files which perform batch conversion for the PC version or for the SGI version are available under each of the map and object directories.
      The make methods for the PC version and the SGI version are explained below.
      The make method is the same for both map and object.

       Make Method

          PC Version  Move from the MS-DOS prompt to either the map or the object directory, then run make -f makefile.win

          SGI Version   Move from the UNIX shell to either the map or the object directory, then run make -f makefile.sgi

       Results After Make

          There is a cvout directory under each of the map and the object directories.
          When conversion is properly completed, a converted C source file will have been generated under this cvout directory.

 (3) NIFF Editor

      NIFF Editor is a tool for editing NIFF files.

       NIFF Editor Description (PC Version)

      When an edited NIFF file is opened, a window like that shown below is displayed.
      A node tree of objects is displayed on your left, while the child nodes, etc. of the node selected on the left are displayed on the right.
      Right-clicking while a node is selected will display a pop-up menu, and if Properties is selected, the properties information for that node can be changed.
      The numirror NIFF files can be edited with this NIFF Editor, enabling you to control the object display data to some extent when the data are recoverted and reflected in the application.

        For details concerning the NIFF Editor, please refer to the NIFF Editor on-line manual.