This wiki is archived and useful information is being migrated to the main bzflag.org website

Difference between revisions of "Arc"

From BZFlagWiki
Jump to: navigation, search
(Code)
m (Code: properties formatting)
Line 35: Line 35:
 
|}
 
|}
 
Valid parameters for an [[arc]] are
 
Valid parameters for an [[arc]] are
<properties>
+
 
name=defines the name of arc, often unused  
+
;name: defines the name of arc, often unused  
divisions=defines the number of subdivisions in the arc
+
;divisions: defines the number of subdivisions in the arc
flatshading=defines the use of flat shading, smooth is the default
+
;flatshading: defines the use of flat shading, smooth is the default
angle=defines the sweep of the arc, 360 indicates a full circle
+
;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.
+
;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.
+
;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.
+
;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.
+
;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)
+
;shift: shift the arc (repeatable)
shear=(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)
+
;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)
+
;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.0.0|2.0.x]] standard [[Box|boxes]] have "texsize -2.0 -2.0 -8.0 -8.0", in [[BZFlag_3.0|3.0]] [[Box|boxes]] will have "texsize -8.0 -8.0 -8.0 -8.0" so choose the appropriate texsize if you want the arc(s) match the [[Box|box(es)]] exact look.
+
;texsize: texture sizes, changes how the textures scale on the object. In [[BZFlag_2.0.0|2.0.x]] standard [[Box|boxes]] have "texsize -2.0 -2.0 -8.0 -8.0", in [[BZFlag_3.0|3.0]] [[Box|boxes]] will have "texsize -8.0 -8.0 -8.0 -8.0" so choose the appropriate texsize if you want the arc(s) match the [[Box|box(es)]] exact look.
phydrv=reference to a predefined [[physics|physics driver]].
+
;phydrv: reference to a predefined [[physics|physics driver]].
smoothbounce=defines that shot bounces use normals
+
;smoothbounce: defines that shot bounces use normals
matref=reference to a predefined [[material]].
+
;matref: reference to a predefined [[material]].
</properties>
+
  
 
==Appearance==
 
==Appearance==

Revision as of 03:15, 28 July 2012

The arc object is a BZW object that defines an arc or cylinder in the game arena.

Code

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:

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

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.0.x standard boxes have "texsize -2.0 -2.0 -8.0 -8.0", in 3.0 boxes will have "texsize -8.0 -8.0 -8.0 -8.0" so choose the appropriate texsize if you want the arc(s) match the box(es) exact look.
phydrv
reference to a predefined physics driver.
smoothbounce
defines that shot bounces use normals
matref
reference to a predefined material.

Appearance

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

The arc object has been supported since BZFlag 2.0.0. In previous versions of BZFlag, this object will not work.

Editor Support

Editors that support the arc object include Blender using the BZWTools, Wings3D using the BZW Exporter for Wings3D, and pyBZEdit. BZEdit and BZFed do NOT support the arcs.