vtkRenderer主要是提供了一个抽象的renderers的规范。一个renderer是一个控制对象渲染进程的对象。渲染是变换几何结构的进程,是光照,一幅图形的相机view的规范。 vtkRenderer同样也在世界坐标和view坐标(计算机图形渲染坐标系统)和display coordinates(设备上事实的screen坐标)之间执行坐标变换。更进阶的一些渲染特征,例如two-sided lighting也由这个控制。
// .SECTION See Also
// vtkRenderWindow vtkActor vtkCamera vtkLight vtkVolume
#ifndef __vtkRenderer_h
#define __vtkRenderer_h
#include "vtkRenderingCoreModule.h" // For export macro#include "vtkViewport.h"
#include "vtkVolumeCollection.h" // Needed for access in inline members
#include "vtkActorCollection.h" // Needed for access in inline members内嵌成员?
class vtkRenderWindow;
class vtkVolume;
class vtkCuller;
class vtkActor;
class vtkActor2D;
class vtkCamera;
class vtkLightCollection;
class vtkCullerCollection;
class vtkLight;
class vtkPainter;
class vtkHardwareSelector;
class vtkRendererDelegate;
class vtkTexture;
class VTKRENDERINGCORE_EXPORT vtkRenderer : public vtkViewport
{
public:
1.vtkTypeMacro(vtkRenderer,vtkViewport);父类是,vtkViewport
2.void PrintSelf(ostream& os, vtkIndent indent);输出自身
3.static vtkRenderer *New();初始化,它的New包括一个工厂类,还有自身的初始化,在工厂类中判断它是否有重载,还有注册等功能,没有重载则返回NULL,接下里则初始为:a black background, a white ambient light, two-sided lighting turned on, a viewport of (0,0,1,1), and backface culling turned off
4. void AddActor(vtkProp *p);void AddVolume(vtkProp *p); void RemoveActor(vtkProp *p);void RemoveVolume(vtkProp *p);增加或者移出不同的props给这个renderer。这些方法与 AddViewProp and RemoveViewProp同义,且向后兼容(与actor联系)
5.增加light到light lists中void AddLight(vtkLight *);删除一个light void RemoveLight(vtkLight *);删除所有的光照void RemoveAllLights();,返回lights集合vtkLightCollection *GetLights();
6.设置lights集,我们不能命名他为SetLights,因为需要TestSetGet lights_exist: lights!=0 post lights_set: lights==this->GetLights():void SetLightCollection(vtkLightCollection *lights);
7.renderer中添加一个light:void CreateLight(void);
8.创建一个对于此类Renderer合适的Light 。For example, a vtkMesaRenderer should create a vtkMesaLight in this function. 默认call vtkLight::New.
virtual vtkLight *MakeLight();
9.打开或者关闭面的双侧光。如果关闭,则只有向着lights这面会亮,另一面则是黑的。如果打开,则两面都会亮。
vtkGetMacro(TwoSidedLighting,int);
vtkSetMacro(TwoSidedLighting,int);
vtkBooleanMacro(TwoSidedLighting,int);
10.打开或者关闭lights是否自动跟着相机移动重新定位。LightFollowCamera为on,则lights将会被设计为Headlights or CameraLights,将会自适应相机移动。反之则不会
vtkSetMacro(LightFollow