Sloargs

This extension provides a Scheme interface to the C library distributed by Pixar called "libsloargs.a." The interface commands are shown below and should be straightforward to anyone familiar with the C language counterpart. There's only one change however -- the Scheme interface equivalent to Slo_GetPath() actually works!

(slo-get-path)

Returns the current shader search path in as a string containing colon separated directories.

(so-get-default-path)

Returns the shader path specified by the user's configuration files.

(slo-set-path path)

Sets the current shader search path. path should be a string containing colon separated directories.

(slo-set-shader name)

Sets the current shader to name. Returns #f if no such shader with that name exists in the current search path. Returns #t otherwise.

(slo-end-shader)

Closes the current shader.

(slo-get-name)

Returns the name of the current shader as a string.

(slo-get-type)

Returns the type of the current shader as a string.

(slo-get-n-args)

Returns the number of parameters (as an integer) for the current shader.

(slo-get-arg id)
(slo-get-arg name)

Both functions return information about a specific parameter for the current shader. The desired parameter can be specified by an integer id (indexed starting at 1) or by the name of the parameter (as a string). If a valid id or name is specified, a list is returned (#f is returned if invalid), containing in order:

name
storage
type
space
default value

If there is no default value, the 5th element of the list will be #f. If the storage or space is unspecified, their values will be empty strings.

Last updated: 4/4/96 / Steve May ( smay@cgrg.ohio-state.edu )

Any comments or suggestions appreciated.