zeGraph Objects

These tags are for object creation. Tags for calling object functions are explained in the linked XML files.

ze_axis | ze_blend | ze_color | ze_colorbar | ze_font | ze_light | ze_line | ze_material | ze_node | ze_plot | ze_point | ze_polygon | ze_render | ze_scene | ze_texcoord | ze_text | ze_texture | ze_vertex | ze_normal |

<include>script_file_name</include> is a special function that can used anywhere in a script. It loads a script in another file.

<use name="object_name">...</use> may be used to make a named object as the current object and then call its functions as usual.

Plug-in Functions

A function in the dynamic-link library (DLL) zs.dll may be called by an vertex, color, or texture coordinate object as:

    <dll append="true" params="p1, p2, ...">libray_file_name, function_name</dll>

What to use as the values of append and params attibutes depends on what input-output the DLL function expects. Refer to the plug-in interface page for more details.

make_sphere_vertex: To be called by a vertex object to generate vertices for a sphere surface (GL_QUADS) of radius 1. The function uses p1 as the slices number of along the latitude. The same function may be used for vertex normal.

make_sphere_texcoord: To be called by a texture coordinate object to generate texture coordinates for a sphere surface. The function uses p1 as the number of slices along the latitude.

make_sphere_grid: To be called by a vertex object to generate latiude and logitude lines (GL_LINES) on a sphere surface of radius 1. The function uses p1 as the number of slices along the latitude.

make_cylinder_vertex: To be called by a vertex object to generate vertices for a cylinder surface (GL_QUAD_STRIP) of radius 1 with the bottom at (0, 0, 0) and the top at (0, 0, 1). The function uses p1 as the number of slices along the circle. The same function may be used for vertex normal.

make_cylinder_texcoord: To be called by a texture coordinate object to generate texture coordinates for a cylinder surface. The function uses p1 as the number of slices along the circle. The bottom coordinates range from (0, 0) to (1, 0) and the top from (0, 1) to (1, 1)

make_cone_vertex: To be called by a vertex object to generate vertices for a cone surface (GL_QUAD_STRIP) of radius 1 with the bottom at (0, 0, 0) and the top at (0, 0, 1). The function uses p1 as the number of slices along the circle.

make_cone_normal: To be called by a vertex object to generate vertex normal for a cone surface (GL_QUAD_STRIP) of radius 1 with the bottom at (0, 0, 0) and the top at (0, 0, 1). The function uses p1 as the number of slices along the circle.

make_cone_texcoord: To be called by a texture coordinate object to generate texture coordinates for a cone surface. The function uses p1 as the number of slices along the circle. The bottom coordinates range from (0, 0) to (1, 0) and the top from (0, 1) to (1, 1)

make_disk_vertex: To be called by a vertex object to generate vertices for a disk shape (GL_TRIANGLE_FAN) of radius 1 on the x-y plane with the center at (0, 0, 0). The function uses p1 as the number slices along the circle. A disk shape needs only one normal of either (0, 0, 1) or (0, 0, -1).

make_disk_texcoord: To be called by a texture coordinate object to generate texture coordinates for a disk shape. The function uses p1 as the number of slices along the circle. The center coordinate is (0.5, 1) and coordinates on the edge range from (0, 0) to (1, 0)

read_gshhs: To be called by a vertex object to reads GSHHS map data and returns them as vertices of GL_LINES. The function uses p1 as the GSHHS file name; uses p2, if set, as the flag indecating land, lake, island, or pond (e.g., p2="land"); and uses p3 to p6, if set, as the longitude (p3=0 to p4=360) and latitude (p5=-90 to p6=90) boundaries.

sphere_projection: To be called by a vertex object with appent="false" to convert longitude and latitude to x, y, and z on a sphere surface of radius 1.

aitoff_projection: To be called by a vertex object with appent="false" to convert longitude and latitude to x and y. The longitude and latitude in the object before conversion must be in the ranges of -180 to 180 and -90 to 90, respectively; and the returned x and y will be in the ranges of -3.06 to 3.10 and -1.48 to 1.54, respectively.

echert_projection: To be called by a vertex object with appent="false" to convert longitude and latitude to x and y. The longitude and latitude in the object before conversion must be in the ranges of -180 to 180 and -90 to 90, respectively; and the returned x and y will be in the ranges of -2.71 to 2.74 and -1.21 to 1.28, respectively.