Japanese

2. Specifications

1. Files
   1. Editable types of files
   2. Importable types of files
   3. Exportable types of files
2. Directories
   1. TPF directory
   2. TMF directory
   3. TLF directory
3. Objects
   1. Project
   2. Picture
   3. Image
   4. Palette
4. Functions
   1. Editing functions
      1. Picture
      2. Palette
      3. Image
   2. Drawing functions
      1. Pixel
      2. Pen
      3. Line
      4. Box
      5. Box fill
      6. Circle
      7. Circle fill
      8. Paint
      9. Pick with right-click
   3. Viewing functions
      1. Zoom function
      2. Grid display ON/OFF
      3. Preview function
   4. Plug-In functions
      1. Import BMP plug-in
      2. Import RGB plug-in
      3. Export C plug-in
      4. Preview IS-VIEWER64 plug-in
5. Plug-In Interface
6. File Formats
   1. TPF format
   2. TMF format
   3. TLF format

1. Files

   TextureEditor can handle the following files:

   1. Editable types of files

      Texture project file (TPF)	The file that manages a number of "pictures," where texture image files (TMF) and texture lookup table files (TLF)are registered together. N64 CITextureEditor can only open 1 such file. Expressed as a Makefile-like texture file.
      Texture image file (TMF)	The file that handles the texture image. For a CI, if there is no color lookup table (if one is not attached) then the CI cannot be displayed. Currently, 4bit(16 color)/8bit(256 color) image files can be handled. With N64 CITextureEditor various editing can be done. This file is an uncompressed binary image file.
      Texture lookup table file (TLF)	The file that handles CI texture colors. It is also called the palette Currently, 4bit (16 color)/8bit (256 color) palettes can be handled. With N64 CITextureEditor various editing can be done. This file is an uncompressed binary image file.
      BMP file� (BMP)	BMP files can be handled as TMF/TLF. When the BMP file is read, the TLF is automatically extracted and created from the BMP. (The number of colors must be reduced to 16 or 256 colors.) Saving this with a TMF name makes it a TMF. The reverse is also possible. This file cannot be handled unless it is an uncompressed 4bit/8bit BMP file.

   2. Importable types of files

      The Import functions enable different-format files to be inserted into an image during editing.
      These are functions added from the plug-ins.

      The Import plug-ins automatically perform color reduction (reduction to 16/256 colors) and paste the file into the currently edited TMF/TLF. The current version does not perform this color reduction correctly. The cause is currently being investigated. If the conversion does not proceed well, we recommend using another image editing application to perform the color reduction, and then importing the file.

      BMP files	Windows (uncompressed) bitmap files
      RGB files	SGI (uncompressed) image files

   3. Exportable types of files

      The Export functions enable an image file to be converted into another format.
      These are functions added from the plug-ins.

      BMP files	Windows (uncompressed) bitmap files
      RGB files	SGI (uncompressed) image files
      C language source files	The texture image file is turned into a compilable C language source file by CC/GCC. This file is just a binary image converted into a source file, so it alone cannot actually be displayed on the screen. It requires the use of a suitable display list.

2. Directories

   The following directories are used with N64 CITextureEditor:

   1. TPF directory

      The directory with .TPF files.

   2. TMF directory

      The directory with .TMF files.

   3. TLF directory

      The directory with .TLF files.

3. Objects

   The following objects are handled by N64 CITextureEditor:

   1. Project

      A project manages pictures using the TPF file.
      N64 CITextureEditor can only edit one project at a time.
      

   2. Picture

      A picture is an object comprising an image (TMF) and palette (TLF).
      The image and palette can be referenced from another picture.
      This object is stored in the project (TPF)
      

   3. Image

      An image is the TMF, the file with image data detached from the palette.
      This object can be referenced by a picture.
      Currently, only 4bit/8bit CI textures can be handled.

   4. Palette

      The palette is the TLF, the file with image data detached from the image.
      This object can be referenced by a picture.
      Currently, only lookup tables for 4bit/8bit CI textures can be handled.

4. Functions
   1. Editing functions
      1. Pictures

         [Restricted] The picture editing functions do not support Undo/Redo and Cut & Paste.

         1. Add
            Selects TMF and TLF files with different names and adds them as a picture to the project.
            
         2. Edit
            This function can be used to change the TMF and TLF composition of the specified picture.
            
         3. Remove
            Deletes the specified picture.
            
      2. Palettes
         1. Select rectangle
            Selects a number of palettes for use together.
            Normally you select a single palette by moving the cursor above the palette and left-clicking the mouse. But you can select a number of palettes by pressing the left mouse button above a palette and dragging the cursor to draw a rectangle around the group you want to select. All palettes within the rectangle are selected for editing.
         2. Undo
            Lets you undo a change and return the palette to its original form. The Undo buffer can hold up to 100 changes.
         3. Redo
            Lets you redo what was just undone.
         4. Copy
            Copies the selected range to the clipboard.
         5. Paste
            Takes the palette data that was copied to the clipboard and inserts it starting from the selected position (or the upper-left position if a rectangle was selected, pasting all that was in the clipboard irregardless of the size of the selected region).
      3. Images
         1. Select rectangle
            Drag a rectangle to specify a region for editing.
         2. Undo
            Lets you undo a change and return the image to its original form. The Undo buffer can hold up to 100 changes.
         3. Redo
            Lets you redo what was just undone.
         4. Cut
            Copies the selected region to the clipboard and then deletes it.
         5. Copy
            Copies the selected region to the clipboard.
         6. Paste
            Inserts the image that was copied to the clipboard.
            A select frame is prepared corresponding to the copy size, so please decide on the position and size.
            Changing the size will enlarge or reduce the image to fit that size. Pressing the Return key or clicking outside the range or switching operations will implement the paste.
            To cancel the paste, press the Escape key.
         7. Flip vertically
            Flips the selected image range vertically (left-right).
         8. Flip horizontally
            Flips the selected image range horizontally (up-down).
   2. Drawing functions
      1. Pixel
         Draws one point. The point is drawn with the color currently assigned to the pen.
      2. Pen
         This is the "free draw" mode. The line is drawn with the color currently assigned to the pen.
      3. Line
         Draws a straight line. The line is drawn with with the color currently assigned to the pen.
      4. Box
         Draws a rectangle. The rectangle is drawn with with the color currently assigned to the pen.
      5. Box fill
         Draws a rectangle filled with the color currently assigned to the pen.
      6. Circle
         Draws a circular shape. The circle is drawn with the color currently assigned to the pen.
      7. Circle fill
         Draws a circle filled with the color currently assigned to the pen.
      8. Paint
         Fills the selected location with the color currently assigned to the pen.
      9. Pick with right-click
         When this is ON, and when status is 1~8, picks up a color from the image and assigns it as the current color of the pen.
   3. View functions
      1. Zoom function
         Magnification can be 1x to 16x (100% ~ 1600%)
      2. Grid display ON/OFF
         Turns display of the 8x8 alignment grid ON/OFF.
      3. Preview functions
         When the IS-VIEWER64 is connected and the Preview function is ON, textures can be checked in real time on the console.
         This is a function added by the plug-in. (See also: IS-VIEWER64 Preview plug-in)
   4. Plug-in functions

      Plug-in functions expand the functionality of the application. A plug-in module is the module which carries out that plug-in function.
      There is a PlugIns subdirectory in the application folder where these plug-in modules are stored. When the application starts up, it automatically identifies these modules.
      (Details about the plug-ins can be viewed in the About dialog.
      

      Here we explain about the four plug-ins that were introduced from the start.
      

      1. BMP Import/Export plug-ins (MSBMP.DLL)
         BMP Import
         This function can be used to paste a Microsoft BMP file into the image currently being edited.
         If a color palette is already assigned to the image currently being edited, the BMP file is blended and pasted.
         (At this time, the contents of the palette are forcibly replaced, so if the Escape key is pressed to interrupt the paste, the palette is nevertheless changed.)
         If no palette has been assigned yet, then a new palette is created and assigned to the image.
         BMP Export
         This function can be used to save TMF/TLF as an uncompressed BMP.
         
      2. RGB Import/Export plug-ins(SGIRGB.DLL)
         RGB Import
         This function can be used to paste an SGI RGB file into the image currently being edited.
         
         Functionally, this plug-in works the same as the BMP Import plug-in.
         RGB Export
         This function can be used to save TMF/TLF as an uncompressed RGB.
         
      3. C Export plug-in (TMFtoC.DLL)
         Saves the currently edited image as a C language file that can be used by NINTENDO64.
         A dialog opens to set the file specifications and the scope and label.
         
         1. Scope is determined by extern/static.
            When "extern" is selected, a source file (.c) and header file (.h) are output, and they can used as a compiled & linked module.
            When "static" is selected, only a source file (.c) is output, so you need add #include "texture1.c" etc. to a referenced source and combine this with the source file.
            
         2. const is the read-only specifier. Since the data is always in ROM, please check this item.
            
         3. The 64bit alignment check box specification only works for the GNU C compiler.
         4. label is the picture label name.
            For related labels, the label is automatically created by appending a character string to the base name specified by the user.
      4. IS-VIEWER64 Preview plug-in (Preview.DLL)
         This plug-in enables the currently edited texture to be previewed via the IS-VIEWER64.
         A number of basic operations and menus are provided on the IS-VIEWER64 side.
         

         Basic operations

         • L-R -- Switch menu pages
         • Z trigger -- Menu display ON/OFF
         • Control pad -- Move menu items
         • A/B Buttons -- Change values one at a time
         • Analog stick UP/DOWN -- Make big change to values
         • C Control Pad UP/DOWN -- Set value to maximum, minimum
         • C Control Pad LEFT/RIGHT -- Switch picture whose parameters are being manipulated
         Menus
         • Texture menu
           • Offset X,Y . . . Texture's offset position (X=-640~640/Y=-480~480: X,Y independent)
           • Scale X,Y . . . Texture's scale (00.10~10.00: X,Y independent)
           • Scale X&Y . . . Texture's scale (00.10~10.00: X,Y simultaneous) (Common to all pictures)
           • Back Ground . . . Background color (Common to all pictures)
         • Filter menu
           • Filter
             1. G_TF_POINT . . . Point sampling
             2. G_TF_AVERAGE . . . Average filtering
             3. G_TF_BILERP . . . Bilinear interpolation filtering
         • Combiner menu
           • Mode
             1. G_CC_DECALRGBA . . . Transfer the design as-is
             2. G_CC_PRIMITIVE . . . Transfer the primitive color
             3. G_CC_BLENDPE . . . Blend primitive color and environment color
           • Primitive . . . Primitive color
           • Environment . . . Environment color
         • Blender menu
           • Render Mode
             1. G_RM_AA_ZB_OPA_SURF . . . Opaque surface (Anti-aliased Z buffer algorithm)
             2. G_RM_AA_ZB_XLU_SURF . . . Translucent surface (Anti-aliased Z buffer algorithm)
             3. G_RM_AA_ZB_TEX_EDGE . . . Texture edge mode (Anti-aliased Z buffer algorithm)
5. Plug-in Interface

   Click below to reference the documentation for the development of plug-ins.

   TextureEditor Plug-In SDK

6. File format

   Click below to reference the documentation regarding the file formats handled by the N64 CITextureEditor.

   1. TPF format
   2. TMF format
   3. TLF format

Japanese