lowlines

Nitro Cell Resource (NCER)

Category: Nintendo DS

Description: Common cell format used in Nintendo DS games.

Author: lowlines & Garyong/Barubary/Aygox

Filename: ncer.xml

Size: 6.64 KB

Date Modified: 07 November 2019

• Nitro Header

  • Type	Name	Offset	Size	Value	Description
    	Magic Stamp	0x0000	4	0x5245434E	Stamp (RECN) "Nitro CEll Resource".
    u32	Constant	0x0004	4	0x0100FEFF
    u32	File Size	0x0008	4
    u16	Header Size	0x000C	2	0x10
    u16	# Sections	0x000E	2	1 or 3

• CEll BanK Section (CEBK)

  • Type	Name	Offset	Size	Value	Description
    	Magic Stamp	0x0000	4	0x4B424543	Stamp (KBEC) "CEll BanK".
    u32	Section Size	0x0004	4
    u16	# Banks	0x0008	2
    u16	Extended Flag	0x000A	2		If 1, data is extended.
    u32	Data Offset	0x000C	4	0x18	Relative to start of Section + 8.
    u32	Flags	0x0010	4		Bit 0-1 << 1 Tile Index Offset Bit 2 If 1, use sub-images
    u32	Partition Data Offset	0x0014	4		Only present if not zero.
    u64	Padding	0x0018	8	0x00

  • Cell Banks (times # Banks)

    • Type	Name	Offset	Size	Value	Description
      u16	# OAMs	0x0000	2
      u16	Unknown	0x0002	2
      u32	First OAM Offset	0x0004	4		Relative to start of OAM Data.
      Coordinates (Only present in Extended Mode)
      s16	X Max	0x0008	2
      s16	Y Max	0x000A	2
      s16	X Min	0x000C	2
      s16	Y Min	0x000E	2

  • OAM Data
    • see GBATEK http://nocash.emubase.de/gbatek.htm#lcdobjoamattributes

    • Type	Name	Offset	Size	Value	Description
      u16	OBJ Attribute 0	0x0000	2
      u16	OBJ Attribute 1	0x0002	2
      u16	OBJ Attribute 2	0x0004	2

    • OBJ Attribute 0
      • Details

        Bit 0-7: Y Position (Signed)

        Range (-128, 127)

        Bit 8: Rotation/Scaling Flag

        If R/S = 0

        Bit 9: OBJ Disable Flag

        Else

        Bit 9: Double-Size Flag

        Bit 10-11: OBJ Mode

        00 = Normal

        01 = Semi-Transparent

        10 = OBJ Window

        11 = Invalid

        Should not be set in NCER

        Bit 12: Mosaic Flag

        Should not be set in NCER

        Bit 13: Color Depth

        0 = 4-Bit

        1 = 8-Bit

        Bit 14-15: OBJ Shape

        00 = Square

        01 = Horizontal

        10 = Vertical

        11 = Invalid

    • OBJ Attribute 1
      • Details

        Bit 0-8: X Position (Unsigned)

        Range (-256, 255), subtract 0x200 if >= 0x100

        If R/S = 0

        Bit 9-11: Unused

        Bit 12: Horizontal Flip

        Bit 13: Vertical Flip

        Else

        Bit 9-13: R/S Parameter Selection, should not be set in NCER.

        Bit 14-15: OBJ Size

    • OBJ Attribute 2
      • Details

        Bit 0-9: Tile Index

        Bit 10-11: Priority relative to BG, normally not set in NCER

        Bit 12-15: Palette Index

    • OAM Size Table

      • 		OBJ Shape
        		Square (00)	Horizontal (01)	Vertical (10)
        OBJ Size	00	8x8	16x8	8x16
        	01	16x16	32x8	8x32
        	10	32x32	32x16	16x32
        	11	64x64	64x32	32x64

  • Partition Data

    • Type	Name	Offset	Size	Value	Description
      u32	Start	0x0000	4		In pixels
      u32	Length	0x0004	4		In pixels

• Label Section (LABL)

  • Type	Name	Offset	Size	Value	Description
    	Magic Stamp	0x0000	4		Stamp (LBAL) "LABLe".
    u32	Section Size	0x0004	4
    Name Offsets (!= always equal # objects.)
    u32	Name Offset	0x0000	4		Relative to the start of this section.
    String Table (Each name is terminated by a 0x00)

• UEXT Section (UEXT)

  • Type	Name	Offset	Size	Value	Description
    	Magic Stamp	0x0000	4		Stamp (TXEU) "Utility EXTension??".
    u32	Section Size	0x0004	4
    u32	Unknown Value	0x0008	4