OBD:ENVP: Difference between revisions

Revision as of 23:21, 13 May 2025

ENVP : Env Particle Array

switch to XML:ENVP page

Overview @ Oni Stuff

Offset Type Raw Hex Value Description

0x00 res_id 01 9B 02 00 667 00667-.ENVP

0x04 lev_id 01 00 00 06 3 level 3

0x08 char[22] AD DE dead padding

0x1E uint16 42 00 66 array size

First element (black outline)

0x00 char[64] locklight particle class name (reference to 06079-3RAPlocklight.BINA in level 0)

0x40 char[48] lock1_locklight01 particle tag name; lookup name for use in scripts via the particle command

0x70

matrix

00 00 80 BF	52 D2 43 B3	2E B4 61 B7
2F B4 61 37	FD B7 AA B7	00 00 80 BF
4A A5 42 33	00 00 80 BF	FD B7 AA 37
BA E1 20 44	C9 C4 50 41	05 EB 89 C3

1.000000	-0.000000	-0.000013
0.000013	-0.000020	-1.000000
0.000000	-1.000000	0.000020
643.526978	13.048043	-275.836090

transform matrix for the particle (in world space)

0xA0 float 00 00 80 3F 1.000000 decal x scale

0xA4 float 00 00 80 3F 1.000000 decal y scale

0xA8 uint16 00 00 0 runtime: flags

0xAA uint16 00 00 0 runtime: owner type

0xAC uint32 00 00 00 00 0 runtime: pointer to owner particle

0xB0 uint32 00 00 00 00 0 runtime: pointer to dynamic matrix

0xB4 uint32 00 00 00 00 0 runtime: pointer to particle class

0xB8 uint32 00 00 00 00 0 runtime: pointer to spawned particle

0xBC uint32 00 00 00 00 0 runtime: pointer to spawned particle header

0xC0 uint32 00 00 00 00 0 runtime: pointer to previous particle in global spawned particle list

0xC4 uint32 00 00 00 00 0 runtime: pointer to next particle in global spawned particle list

0xC8 uint32 00 00 00 00 0 runtime: pointer to position in hash list (hash table of all spawned particles with tag names)

0xCC uint32 00 00 00 00 0 runtime: pointer to position in tag list (linked list of all spawned particles with the same tag name)

Environment particles: Door lock lights, lights, fire, smoke, steam, "electricity", etc. Loose particles are normally added to the level particle collection. ENVP is used by the level importer tool to store particles attached to objects or furniture.

Transformation matrix: Used to orient and stretch the particles (decals, lock lights, etc).; See e.g. CRSA for a detailed explanation.


ONI BINARY DATA

DPge << Other file types >> FILM
ENVP : Env Particle Array
Level file

@@ Line 2: / Line 2: @@
-[[image:envp_a.gif]]
+[[Image:envp_a.gif]]
@@ Line 12: / Line 12: @@
 {{OBDtr| 0x1E | uint16    |00FFFF| 42 00       | 66         | array size }}
 {{OBDtrBK}}
-{{OBDtr2|0x00 | char[64] |FFC8C8| locklight                | particle type name (reference to 06079-3RAPlocklight.[[OBD:BINA/PAR3|BINA]] of level 0); global lookup name }}
+{{OBDtr2|0x00 | char[64] |FFC8C8| locklight                | particle class name (reference to 06079-3RAPlocklight.[[OBD:BINA/PAR3|BINA]] in level 0) }}
-{{OBDtr2|0x40 | char[48] |FFFFC8| lock1_locklight01        | particle name; local lookup name (visible from scripts etc) }}
+{{OBDtr2|0x40 | char[48] |FFFFC8| lock1_locklight01        | particle tag name; lookup name for use in scripts via the <code>particle</code> command }}
 |- ALIGN=CENTER VALIGN=TOP
@@ Line 41: / Line 41: @@
 {{OBDtr| 0xA0 | float    |C800C8| 00 00 80 3F | 1.000000   | decal x scale }}
 {{OBDtr| 0xA4 | float    |C87C64| 00 00 80 3F | 1.000000   | decal y scale }}
-{{OBDtr| 0xA8 | uint16   |FFFFFF| -- -- -- -- | -          | flags }}
+{{OBDtr| 0xA8 | uint16   |B0C4D5| 00 00       | 0          | runtime: flags }}
-{{OBDtr| ---- | offset   |FFFFFF| -- -- -- -- | -          | owner type; reset at level load; runtime only }}
+{{OBDtr| 0xAA | uint16   |B0C4D5| 00 00       | 0          | runtime: owner type }}
-{{OBDtr| ---- | offset   |FFFFFF| -- -- -- -- | -          | raw offset for owner particle; reset at level load; runtime only }}
+{{OBDtr| 0xAC | uint32   |B0C4D5| 00 00 00 00 | 0          | runtime: pointer to owner particle }}
-{{OBDtr| ---- | offset   |FFFFFF| -- -- -- -- | -          | raw offset for dynamic matrix; reset at level load; runtime only }}
+{{OBDtr| 0xB0 | uint32   |B0C4D5| 00 00 00 00 | 0          | runtime: pointer to dynamic matrix }}
-{{OBDtr| ---- | offset   |FFFFFF| -- -- -- -- | -          | raw offset for particle class; zeroed at level load; runtime only }}
+{{OBDtr| 0xB4 | uint32   |B0C4D5| 00 00 00 00 | 0          | runtime: pointer to particle class }}
-{{OBDtr| ---- | offset   |FFFFFF| -- -- -- -- | -          | raw offset for particle; zeroed at level load; runtime only }}
+{{OBDtr| 0xB8 | uint32   |B0C4D5| 00 00 00 00 | 0          | runtime: pointer to spawned particle }}
-{{OBDtr| ---- | offset   |FFFFFF| -- -- -- -- | -          | raw offset for particle self ref(?); zeroed at level load; runtime only }}
+{{OBDtr| 0xBC | uint32   |B0C4D5| 00 00 00 00 | 0          | runtime: pointer to spawned particle header }}
-{{OBDtr| ---- | offset   |FFFFFF| -- -- -- -- | -          | raw offset for previous particle(?); zeroed at level load; runtime only }}
+{{OBDtr| 0xC0 | uint32   |B0C4D5| 00 00 00 00 | 0          | runtime: pointer to previous particle in global spawned particle list }}
-{{OBDtr| ---- | offset   |FFFFFF| -- -- -- -- | -          | raw offset for next particle(?); zeroed at level load; runtime only }}
+{{OBDtr| 0xC4 | uint32   |B0C4D5| 00 00 00 00 | 0          | runtime: pointer to next particle in global spawned particle list }}
-{{OBDtr| ---- | offset   |FFFFFF| -- -- -- -- | -          | raw offset for hash list(?); zeroed at level load; runtime only }}
+{{OBDtr| 0xC8 | uint32   |B0C4D5| 00 00 00 00 | 0          | runtime: pointer to position in hash list (hash table of all spawned particles with tag names) }}
-{{OBDtr| ---- | offset   |FFFFFF| -- -- -- -- | -          | raw offset for tag list(?); zeroed at level load; runtime only }}
+{{OBDtr| 0xCC | uint32   |B0C4D5| 00 00 00 00 | 0          | runtime: pointer to position in tag list (linked list of all spawned particles with the same tag name) }}
 |}
-;Enviroment particles
+;Environment particles
-:Locklights, lights, fire, smoke, steam, "electricity" etc. Loose particles are normally added to the [[OBD:BINA/OBJC/PART|level particle collection]]. ENVP is used by the level importer tool to store particles attached to [[OBD:OBOA|objects]] or [[OBD:BINA/OBJC/FURN|furniture]].
+:Door lock lights, lights, fire, smoke, steam, "electricity", etc. Loose particles are normally added to the [[OBD:BINA/OBJC/PART|level particle collection]]. ENVP is used by the level importer tool to store particles attached to [[OBD:OBOA|objects]] or [[OBD:BINA/OBJC/FURN|furniture]].
 ;Transformation matrix
-:Used to orient and stretch the particles (decals, locklights, etc).
+:Used to orient and stretch the particles (decals, lock lights, etc).
-:See, e.g., [[OBD:CRSA|CRSA]] for a detailed explanation.
+:See e.g. [[OBD:CRSA|CRSA]] for a detailed explanation.