Jump to content

Resources/Light Pointcloud

From HEModdingWiki
Revision as of 14:02, 26 January 2025 by Ashrindy (talk | contribs)
Light Pointcloud
Resource TypeLighting
File Extension.pcrt
Used In Games
Container FormatBINA
Editing Tools
Reverse Engineering StatusDone

Light Pointcloud is a fileformat used since Sonic Frontiers, that's used to place lights (.light) in a stage using a collection of instances with resource names.

File Format

This is one of the many BINA file formats, meaning it's very easily memory-mappable.

The structure of this format is very simple, it contains a signature "CPIC", the version "2" (no instances have been found with the version 1) and the list of instances itself.

The structure of an instance is

  • Instance name, to easily differentiate between different instance.
  • Resource Name, to set the MIRAGE Light file name of the instance.
  • Position, straight forward.
  • Rotation, straight forward.
  • Scale, straight forward.
  • Unknown value.

Technical Info

Since this is a BINA file format, it's very easy to show this type in a struct/memory map it.

struct Instance{
    const char* instanceName;
    const char* resourceName;
    csl::math::Position position;
    csl::math::Position rotation;
    int unk0;
    csl::math::Position Scale;
    long unk1;
};

struct PointcloudLight{
    char signature[4];
    uint version;
    int instanceCount;
    Instance* instances;
};