This wiki was in read-only mode for many years, but can now be edited again. A lot of information will need to be updated.

Group: Difference between revisions

From BZFlagWiki
Jump to navigation Jump to search
And Groups
 
Red rider (talk | contribs)
76 edits
 
(13 intermediate revisions by 7 users not shown)
Line 1: Line 1:
A group will recall map objects within a define obect. I must be used after the define object in question.
The group object allows a map-maker to bring together a number of elements and refer to them as a single object. The group of elements is created in the [[define]] object and then called by name with the group object.  The group of elements can then be placed, copied, and/or modified as a whole instead of having to re-create separate objects.  Group creates an "instance" of something defined.


Group goes hand-in-hand with the [[define]] object.
Unlike most other objects, the group object can come before the definition in the bzw file.  This may help make the bzw file more readable.  


== Code ==
== Code ==
{|
|
  group my_group
  group my_group
   shift 0 0 0  
   shift 0 0 0  
   scale 1 1 1
   scale 1 1 1
  rotation 0
   shear 0 0 0
   shear 0 0 0
   spin 0 0 0 0
   spin 0 0 0 0
Line 15: Line 18:
   phydrv my_phydrv
   phydrv my_phydrv
   matref my_material
   matref my_material
  ricochet
  end
  end
 
|}
The valid parameters for groups are:
The valid parameters for groups are:
{|{{Prettytable}}
|-
| {{Hl3}} |'''Parameter'''
| {{Hl3}} |'''Description'''
|-
| '''shift''' || Shift the group (repeatable).
|-
| '''scale''' || Scale the group (repeatable).
|-
| '''rotation''' || Rotate the group (in degrees).
|-
| '''shear''' || Shear the group (repeatable).
|-
| '''spin''' || Spin the group (repeatable).
|-
| '''team''' || Redefine all [[base]] colors within group.
|-
| '''tint''' || Hierarchically tints objects within group.
|-
| '''drivethrough''' || Make all objects in group drivethrough.
|-
| '''shootthrough''' || Make all objects in the group shootthrough.
|-
| '''phydrv''' || Apply [[physics]] to all objects/faces within group.
|-
| '''matref''' || Apply [[material]] to all objects/faces within group.
|-
| '''ricochet''' || Makes shots bounce off objects within group.
|}


'''Shift''': Shift the group (repeatable)
An in-depth explanation of the 3d-transformations of shift, scale, and shear can be found [http://kapsi.fi/jpa/stuff/bzw/transformations.php here]
'''Scale''': Scale the group (repeatable)
'''Shear''': Shear the group (repeatable)
'''Spin''': Spin the group (repeatable)
'''team''': Redefine all [[base]] colors within group.
'''tint''': Hierarchically tints objects within group.
'''drivethrough''': Make all objects in group drivethrough.
'''shootthrough''': Make all objects in the group shootthrough.
'''phydrv''': Apply [[physics]] to all objects/faces within group.
'''matref''': Apply [[material]] to all objects/faces within group.


== Editor Support ==
== Editor Support ==
There are currently no supported editors: groups are normally most useful when editing by hand.
There are currently no supported editors: groups are normally most useful when editing by hand.  


==History==
==History==
The group definition object was added with the [[BZFlag 2.0.0|v2.0.0]] release of BZFlag.
The group definition object was added with the [[BZFlag 2.0.0|v2.0.0]] release of BZFlag.
[[Category:Map Making]]
[[Category:Map_Objects]]

Latest revision as of 06:13, 2 November 2025

The group object allows a map-maker to bring together a number of elements and refer to them as a single object. The group of elements is created in the define object and then called by name with the group object. The group of elements can then be placed, copied, and/or modified as a whole instead of having to re-create separate objects. Group creates an "instance" of something defined.

Unlike most other objects, the group object can come before the definition in the bzw file. This may help make the bzw file more readable.

Code

group my_group
  shift 0 0 0 
  scale 1 1 1
  rotation 0
  shear 0 0 0
  spin 0 0 0 0
  team 0
  tint 1 1 1 1
  drivethrough
  shootthrough
  phydrv my_phydrv
  matref my_material
  ricochet
end

The valid parameters for groups are:

Parameter Description
shift Shift the group (repeatable).
scale Scale the group (repeatable).
rotation Rotate the group (in degrees).
shear Shear the group (repeatable).
spin Spin the group (repeatable).
team Redefine all base colors within group.
tint Hierarchically tints objects within group.
drivethrough Make all objects in group drivethrough.
shootthrough Make all objects in the group shootthrough.
phydrv Apply physics to all objects/faces within group.
matref Apply material to all objects/faces within group.
ricochet Makes shots bounce off objects within group.

An in-depth explanation of the 3d-transformations of shift, scale, and shear can be found here

Editor Support

There are currently no supported editors: groups are normally most useful when editing by hand.

History

The group definition object was added with the v2.0.0 release of BZFlag.

Retrieved from "https://wiki.bzflag.org/index.php?title=Group&oldid=9599"