This wiki is archived and useful information is being migrated to the main bzflag.org website
Difference between revisions of "Arc"
From BZFlagWiki
(Moved comments to parameters section and worded similarly to other Object pages) |
(→Editor Support: update) |
||
(12 intermediate revisions by 8 users not shown) | |||
Line 2: | Line 2: | ||
==Code== | ==Code== | ||
+ | [[Image:Arcmats.jpg|right|thumb|400px|Appearance of an arc with solid color materials. The words show the names used to map materials to various sides. Obviously, the bottom matref is not shown.]] | ||
To place an arc into your map file, the following template is suggested: | To place an arc into your map file, the following template is suggested: | ||
{| | {| | ||
Line 18: | Line 19: | ||
scale 1 1 1 | scale 1 1 1 | ||
spin angle nx ny nz | spin angle nx ny nz | ||
+ | texsize -2.0 -2.0 -8.0 -8.0 | ||
phydrv physics_driver_name | phydrv physics_driver_name | ||
smoothbounce | smoothbounce | ||
− | + | ||
+ | ## You can give the entire arc a single material with the lone 'matref' property, | ||
+ | ## or you can give different parts different materials, as shown below | ||
+ | matref material0 | ||
+ | top matref material1 | ||
+ | bottom matref material2 | ||
+ | inside matref material3 | ||
+ | outside matref material4 | ||
+ | startside matref material5 | ||
+ | endside matref material6 | ||
end | end | ||
|} | |} | ||
− | Valid parameters for | + | Valid parameters for an [[arc]] are: |
− | + | {|{{Prettytable}} | |
− | + | |- | |
− | + | | {{Hl3}} |'''Parameter''' | |
− | + | | {{Hl3}} |'''Description''' | |
− | + | |- | |
− | + | | '''name''' || defines the name of arc, often unused. | |
− | + | |- | |
− | + | | '''divisions''' || defines the number of subdivisions in the arc. | |
− | + | |- | |
− | + | | '''flatshading''' || defines the use of flat shading, smooth is the default. | |
− | + | |- | |
− | + | | '''angle''' || defines the sweep of the arc, 360 indicates a full circle. | |
− | + | |- | |
− | + | | '''ratio''' || defines the ratio to make a hollow arc, the parameter is (outrad - inrad) / outrad. | |
− | + | |- | |
+ | | '''position''' || defines the position of the arc in X-pos, Y-pos and the height of the arc in Z. | ||
+ | |- | ||
+ | | '''rotation''' || defines a rotation around the Z axis for the arc, in degrees. | ||
+ | |- | ||
+ | | '''size''' || defines the distance from the center to the side of the arc in X and Y, and the total height of the arc in Z. | ||
+ | |- | ||
+ | | '''shift''' || shift the arc (repeatable). | ||
+ | |- | ||
+ | | '''shear''' || (repeatable). | ||
+ | |- | ||
+ | | '''scale''' || defines the scale of the arc in x,y, and z, 1 is the default, lower values make it smaller (repeatable). | ||
+ | |- | ||
+ | | '''spin angle''' || rotate the arc around a vector by angle. ONE of nx, ny, and nz should be 1, the others should be 0. (repeatable). | ||
+ | |- | ||
+ | | '''texsize''' || texture sizes, changes how the textures scale on the object. In [[BZFlag_2.4.0|2.4.x]] standard [[Box|boxes]] have "texsize -2.0 -2.0 -8.0 -8.0". | ||
+ | |- | ||
+ | | '''phydrv''' || reference to a predefined [[physics|physics driver]]. | ||
+ | |- | ||
+ | | '''smoothbounce''' || defines that shot bounces use normals. | ||
+ | |- | ||
+ | | '''matref''' || reference to a predefined [[material]]. | ||
+ | |} | ||
+ | |||
==Appearance== | ==Appearance== | ||
− | The arc, by default, has the red brick wall texture on the sides, and the grey | + | The arc, by default, has the red brick wall texture on the sides, and the grey roof appearance of a normal box on the top. However, using [[material|matref]] one can change the appearance of the arc. |
==History== | ==History== | ||
Line 46: | Line 80: | ||
==Editor Support== | ==Editor Support== | ||
− | Editors that support the arc object include [[Blender]] using the [[BZWTools]], [[ | + | Editors that support the arc object include [[Blender]] using the [[BZWTools]], [[Wings3D]], and [[pyBZEdit]]. [[BZEdit]] and [[BZFed]] do NOT support the arcs. |
[[Category:Map Making]] | [[Category:Map Making]] | ||
[[Category:Map_Objects]] | [[Category:Map_Objects]] |
Latest revision as of 20:56, 2 February 2017
The arc object is a BZW object that defines an arc or cylinder in the game arena.
Contents
Code[edit]
To place an arc into your map file, the following template is suggested:
arc name example_arc divisions 16 flatshading angle 360 ratio 1 position 0 0 0 rotation 0 size 10 10 10 shift 0 0 0 shear 0 0 0 scale 1 1 1 spin angle nx ny nz texsize -2.0 -2.0 -8.0 -8.0 phydrv physics_driver_name smoothbounce ## You can give the entire arc a single material with the lone 'matref' property, ## or you can give different parts different materials, as shown below matref material0 top matref material1 bottom matref material2 inside matref material3 outside matref material4 startside matref material5 endside matref material6 end |
Valid parameters for an arc are:
Parameter | Description |
name | defines the name of arc, often unused. |
divisions | defines the number of subdivisions in the arc. |
flatshading | defines the use of flat shading, smooth is the default. |
angle | defines the sweep of the arc, 360 indicates a full circle. |
ratio | defines the ratio to make a hollow arc, the parameter is (outrad - inrad) / outrad. |
position | defines the position of the arc in X-pos, Y-pos and the height of the arc in Z. |
rotation | defines a rotation around the Z axis for the arc, in degrees. |
size | defines the distance from the center to the side of the arc in X and Y, and the total height of the arc in Z. |
shift | shift the arc (repeatable). |
shear | (repeatable). |
scale | defines the scale of the arc in x,y, and z, 1 is the default, lower values make it smaller (repeatable). |
spin angle | rotate the arc around a vector by angle. ONE of nx, ny, and nz should be 1, the others should be 0. (repeatable). |
texsize | texture sizes, changes how the textures scale on the object. In 2.4.x standard boxes have "texsize -2.0 -2.0 -8.0 -8.0". |
phydrv | reference to a predefined physics driver. |
smoothbounce | defines that shot bounces use normals. |
matref | reference to a predefined material. |
Appearance[edit]
The arc, by default, has the red brick wall texture on the sides, and the grey roof appearance of a normal box on the top. However, using matref one can change the appearance of the arc.
History[edit]
The arc object has been supported since BZFlag 2.0.0. In previous versions of BZFlag, this object will not work.
Editor Support[edit]
Editors that support the arc object include Blender using the BZWTools, Wings3D, and pyBZEdit. BZEdit and BZFed do NOT support the arcs.