http://wiki.lostsouls.org/w/index.php?action=history&feed=atom&title=Man_shape 2026-05-03T11:34:55Z Revision history for this page on the wiki MediaWiki 1.8.2 http://wiki.lostsouls.org/w/index.php?title=Man_shape&diff=3976&oldid=prev 2007-06-11T20:58:25Z

<p></p> <p><b>New page</b></p><div>==Files==<br /> <br /> /def/descriptor/shape.c<br /> /lib/descriptors/shape.h<br /> /lib/geometry.h<br /> /def/geometry<br /> /daemon/geometry.c<br /> /lib/common_shapes.h<br /> <br /> ==Description==<br /> <br /> Shape descriptors are used to specify the shape of an object. This can, in<br /> turn, be used to determine its volume, which in conjunction with material<br /> composition elements (see 'man element') can determine its mass and other<br /> properties.<br /> <br /> Shape descriptors are not intended to be fully precise definitions of the<br /> object's shape, and are more of an effort to define its general dimensions<br /> to a near enough tolerance for practical purposes.<br /> <br /> When working with shape descriptors, you will generally want to #include<br /> &lt;geometry.h&gt;, which defines various useful macros and includes shape.h.<br /> <br /> Shape descriptors rely heavily on the geometry definitions managed through<br /> /daemon/geometry.c, /lib/geometry.h, and /def/geometry. Some of these<br /> geometries describe precise ideal shapes (Geometry_Sphere, Geometry_Cube)<br /> and others describe useful approximations (Geometry_Anthropoid).<br /> <br /> &quot;Live&quot; shape descriptors in use by objects should not be directly modified<br /> because the changes will not be properly taken into account. Changes to an<br /> object's shape should be done by calling set_shape() in it, possibly with<br /> an argument consisting of a copy of its previous shape descriptor that has<br /> been altered in some fashion.<br /> <br /> /lib/common_shapes.h defines a number of helpful shape specifications that<br /> make it unnecessary to write your own shape dimensions in many situations,<br /> and otherwise provide useful examples.<br /> <br /> Though the shapes most relevant to our usage are the three-dimensional<br /> shapes, the geometry mechanics also understand various two-dimensional<br /> shapes. These should never be set as the shapes of game objects, however.<br /> <br /> There is an entire class of hollow geometries, both two-dimensional and<br /> three-dimensional, which are essentially versions of a shape with an added<br /> parameter, thickness. For instance, Geometry_Ball is a hollow version of<br /> Geometry_Sphere; Geometry_Sphere's only dimension is a Shape_Radius, where<br /> Geometry_Ball has a Shape_Radius and a Shape_Thickness. Additional values<br /> can be calculated for hollow shapes, as described under Support Functions.<br /> <br /> ===Public Fields===<br /> <br /> Shape_Type: The geometric figure described; must be a valid geometry type,<br /> and will be converted to the type's integer geometry code.<br /> <br /> ===Virtual Fields===<br /> <br /> The virtual fields of a shape descriptor are the various dimensions of its<br /> particular shape, as determined by the geometry definition it uses for its<br /> type. You can review /lib/descriptors/shape.h for the full list, or look<br /> at geometry definitions in /def/geometry to see which fields they use. All<br /> dimensions are always in the standard Ain Soph unit of distance, the dimin<br /> (decimeter).<br /> <br /> ===Internal Fields===<br /> <br /> Shape_Params: This is where the shape dimension information derived from<br /> the virtual fields, in relation to the shape geometry, are stored.<br /> <br /> Shape_Tag: The tag for the descriptor system.<br /> <br /> ===Support Functions===<br /> <br /> '''float Shape_Volume(mixed spec)'''<br /> <br /> Returns the volume of the specified three-dimensional shape, in balaths<br /> (liters).<br /> <br /> '''float Shape_Surface_Area(mixed spec)'''<br /> <br /> Returns the surface area of the specified three-dimensional shape, in<br /> square dimins (square decimeters). In the case of a hollow shape, this<br /> will include all surfaces.<br /> <br /> '''float Shape_Volume_Enclosed(mixed spec)'''<br /> <br /> Returns the volume enclosed by the specified hollow three-dimensional<br /> shape, in balaths (liters).<br /> <br /> '''float Shape_Inner_Surface_Area(mixed spec)'''<br /> <br /> Returns the inner surface area of the specified hollow three-dimensional<br /> shape, in square dimins (square decimeters).<br /> <br /> '''float Shape_Outer_Surface_Area(mixed spec)'''<br /> <br /> Returns the outer surface area of the specified hollow three-dimensional<br /> shape, in square dimins (square decimeters).<br /> <br /> '''float array Shape_Volume_Param(mixed spec, float value)'''<br /> <br /> Returns an array of the parameters necessary for a three-dimensional shape<br /> of the type and with the proportions of that specified to have a volume<br /> equal (within a small tolerance) to the value given.<br /> <br /> '''float array Shape_Surface_Area_Param(mixed spec, float value)'''<br /> <br /> Returns an array of the parameters necessary for a three-dimensional shape<br /> of the type and with the proportions of that specified to have a surface<br /> area equal (within a small tolerance) to the value given.<br /> <br /> '''float array Shape_Volume_Enclosed_Param(mixed spec, float value)'''<br /> <br /> Returns an array of the parameters necessary for a hollow three-dimensional<br /> shape of the type and with the proportions of that specified to have an<br /> enclosed volume equal (within a small tolerance) to the value given.<br /> <br /> '''float array Shape_Inner_Surface_Area_Param(mixed spec, float value)'''<br /> <br /> Returns an array of the parameters necessary for a hollow three-dimensional<br /> shape of the type and with the proportions of that specified to have an<br /> inner surface area equal (within a small tolerance) to the value given.<br /> <br /> '''float array Shape_Outer_Surface_Area_Param(mixed spec, float value)'''<br /> <br /> Returns an array of the parameters necessary for a hollow three-dimensional<br /> shape of the type and with the proportions of that specified to have an<br /> outer surface area equal (within a small tolerance) to the value given.<br /> <br /> '''float Shape_Area(mixed spec)'''<br /> <br /> Returns the area of the specified two-dimensional shape, in square dimins<br /> (square decimeters).<br /> <br /> '''float Shape_Perimeter(mixed spec)'''<br /> <br /> Returns the perimeter distance of the specified two-dimensional shape, in<br /> dimins (decimeters). In the case of a hollow two-dimensional shape, this<br /> will be the total perimeter along all edges.<br /> <br /> '''float Shape_Area_Enclosed(mixed spec)'''<br /> <br /> Returns the area enclosed by the specified hollow two-dimensional shape,<br /> in square dimins (square decimeters).<br /> <br /> '''float Shape_Inner_Perimeter(mixed spec)'''<br /> <br /> Returns the inner perimeter of the specified hollow two-dimensional shape,<br /> in dimins (decimeters).<br /> <br /> '''float Shape_Outer_Perimeter(mixed spec)'''<br /> <br /> Returns the outer perimeter of the specified hollow two-dimensional shape,<br /> in dimins (decimeters).<br /> <br /> '''float array Shape_Area_Param(mixed spec, float value)'''<br /> <br /> Returns an array of the parameters necessary for a two-dimensional shape<br /> of the type and with the proportions of that specified to have an area<br /> equal (within a small tolerance) to the value given.<br /> <br /> '''float array Shape_Perimeter_Param(mixed spec, float value)'''<br /> <br /> Returns an array of the parameters necessary for a two-dimensional shape<br /> of the type and with the proportions of that specified to have a perimeter<br /> equal (within a small tolerance) to the value given.<br /> <br /> '''float array Shape_Area_Enclosed_Param(mixed spec, float value)'''<br /> <br /> Returns an array of the parameters necessary for a hollow two-dimensional<br /> shape of the type and with the proportions of that specified to have an<br /> enclosed area equal (within a small tolerance) to the value given.<br /> <br /> '''float array Shape_Area_Inner_Perimeter_Param(mixed spec, float value)'''<br /> <br /> Returns an array of the parameters necessary for a hollow two-dimensional<br /> shape of the type and with the proportions of that specified to have an<br /> inner perimeter equal (within a small tolerance) to the value given.<br /> <br /> '''float array Shape_Area_Outer_Perimeter_Param(mixed spec, float value)'''<br /> <br /> Returns an array of the parameters necessary for a hollow two-dimensional<br /> shape of the type and with the proportions of that specified to have an<br /> outer perimeter equal (within a small tolerance) to the value given.<br /> <br /> '''descriptor Shape_Resize(mixed spec, float value)'''<br /> <br /> Returns a descriptor with the same relative proportions as that specified<br /> but with its volume (three-dimensional shapes) or area (two-dimensional<br /> shapes) equal (within a small tolerance) to the value given.<br /> <br /> '''descriptor Shape_Universal(descriptor dxr)'''<br /> <br /> Used to ensure that a given descriptor is shared via the global shape<br /> descriptor cache. The descriptor returned, which may be the same as the<br /> one sent, is guaranteed to be shared.<br /> <br /> ==See Also==<br /> <br /> [[man descriiptors|descriptors(mechanisms)], [[man set shape|set_shape(lfun)]], [[man query shape|query_shape(lfun)]]</div>

Laine