Michael Jones (mtj++at++babar)
Wed, 15 Feb 1995 22:54:04 -0800
Well, yes and no. It is there on page "xiii" in the printed version of the
IRIS Performer Reference Pages, and it is in the online man page that
you get via "man performer". On the other hand, it is not described
in detail anywhere, which is your point.
:It was discovered accidentally by a colleage
:in the Performer header files (while I was telling him that I couldn't
:believe that there was no such function!).
That's the spirit: If it's not in Perfomer, it just means that we
forgot to document it. ;-)
:What's the story with pfGetNumLPoints()? Is it just a documentation
:ommision or is it not supported?
It's a documentation omission. I will fix it now ... there, done. Here
is the newly updated man page:
pfLightPoint(3pf) IRIS Performer 2.0 libpf Reference Pages pfLightPoint(3pf)
NAME
pfNewLPoint, pfGetNumLPoints, pfLPointSize, pfGetLPointSize,
pfLPointFogScale, pfGetLPointFogScale, pfLPointColor, pfGetLPointColor,
pfLPointShape, pfGetLPointShape, pfLPointRot, pfGetLPointRot,
pfLPointPos, pfGetLPointPos - Set and get pfLightPoint size, color,
shape, rotation and position.
C SPECIFICATION
#include <Performer/pf.h>
pfLightPoint * pfNewLPoint(int num);
int pfGetNumLPoints(pfLightPoint *lpoint);
:
DESCRIPTION
A pfLightPoint is a pfNode that contains one or more light points. The
light point node is quite different from a pfLightSource; it is visible
as one or more self-illuminated small points but these points do not
illuminate surrounding objects. In contrast to this, a pfLightSource does
illuminate scene contents but is itself not a visible object. All the
light points in a pfLightPoint node share all their attributes except
point location and color.
pfNewLPoint creates and returns a handle to a pfLightPoint node. num
specifies the maximum number of individual light points the node may
contain. The function pfGetNumLPoints returns this maximum number of
light points that the pfLightPoint node lpoint can hold. This is the
value set when the light point node was created using pfNewLPoint and is
the size of the internal position and color arrays used to represent the
light points.
Thanks for the bug report.
--Be seeing you, Phone:415.390.1455 Fax:415.965.2658 M/S:8U-590 Michael T. Jones Silicon Graphics, Advanced Graphics Division mtj++at++sgi.com 2011 N. Shoreline Blvd., Mtn. View, CA 94039-7311
This archive was generated by hypermail 2.0b2 on Mon Aug 10 1998 - 17:50:57 PDT