mirror of https://github.com/ZDoom/raze-gles.git
67 lines
3.1 KiB
Plaintext
67 lines
3.1 KiB
Plaintext
|
|
Sector-like clipping for sprites
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Sprite picnums can be assigned to a bunch of connected sectors so that
|
|
clipping against these sprites will work as if it is carried out on the
|
|
associated sectors. For this, files named _clipshapeX.map (where X is
|
|
in 0..9) should be present at program start time. Every such map must be
|
|
built to certain rules, and loading many of them has the same effect as
|
|
loading a single map with all sectors/walls/sprites thrown together.
|
|
|
|
* Every sector that contains at least one white wall is considered an "outer" sector.
|
|
Conversely, sectors with only red walls are "inner" (clipping) sectors.
|
|
|
|
* Sprites in outer sectors are ignored.
|
|
|
|
* To associate a picnum with a bunch of sectors, place a sprite with that picnum in
|
|
some inner sector of the lot. At the end stage of editing, align the sprite so that
|
|
the model matches the sectors well. See samples/_clipshape0.map for examples.
|
|
|
|
* A picnum may be associated with many "layers" (called "indices" in the code) of
|
|
sectorwork. This serves two purposes: one is to enable more complex shapes than
|
|
would be possible using only one sector. The other reason is that a sprite may differ
|
|
in orientation in such a way that it is not possible to calculate one from another.
|
|
In particular, floor-aligned sprites and face/wall sprites should have their own
|
|
sector versions (of course only if they are intended to be used in a particular
|
|
orientation).
|
|
|
|
* The sprites in inner sectors should point northward and should not have any orientation-
|
|
changing bits like x-flip or y-flip set. Setting centering and a custom size is permitted,
|
|
though.
|
|
|
|
* A set of picnums can be aliased to a layer. This is useful if "secondary" picnums
|
|
are going to be used as decoration, for example. For this, set lotags and/or hitags
|
|
of any wall of an inner sector to the picnums to be aliased to layer containing the wall.
|
|
If only one of them is set, it is taken as a picnum, otherwise as a both-sided inclusive
|
|
range, the order doesn't matter. The pigcop tank is present as an example in
|
|
samples/_clipshape0.map. If a picnum has multiple layers, it is advisable to set the same
|
|
lotags/hitags for each layer. Note that you do not need to set tags unless you intend to
|
|
have more than one picnum to share a clipping shape.
|
|
|
|
* The inner sectors of a given layer must be all interconnected (not necessarily directly)
|
|
and for a layer there must be a unique outer sector.
|
|
|
|
* Making the floor or ceiling of a sector parallaxed will disable clipping on it in certain
|
|
ways. Normally, there are four horizontal clipping planes per inner sector (see the round
|
|
table for an example). Making the ceiling parallaxed disables the upper two, and analogously
|
|
for the floor.
|
|
|
|
* Making a sprite transparent will disable rotation around its origin to match a given sprite's
|
|
angle. Use it on models with rotational symmetry.
|
|
|
|
|
|
Notes:
|
|
------
|
|
|
|
* The clipping will not change with rendering modes or options.
|
|
|
|
|
|
Predicted bugs:
|
|
---------------
|
|
|
|
* Clipping may not work across playing map sector boundaries, especially with large sprites.
|
|
|
|
|
|
--Helixhorned
|