TK_Camera

Functions

TK_Camera

~TK_Camera

TK_Status

Read

TK_Status

Write

TK_Status

Clone

TK_Status

ReadAscii

TK_Status

WriteAscii

void

SetPosition

void

SetPosition

float const *

GetPosition

void

GetPosition

void

SetDPosition

void

SetDPosition

double const *

GetDPosition

void

GetDPosition

void

SetTarget

void

SetTarget

float const *

GetTarget

void

GetTarget

void

SetDTarget

void

SetDTarget

double const *

GetDTarget

void

GetDTarget

void

SetUpVector

void

SetUpVector

float const *

GetUpVector

void

GetUpVector

void

SetDUpVector

void

SetDUpVector

double const *

GetDUpVector

void

GetDUpVector

void

SetField

void

SetField

float const *

GetField

void

GetField

void

SetDField

void

SetDField

double const *

GetDField

void

GetDField

void

SetOblique

void

SetOblique

float const *

GetOblique

void

GetOblique

void

SetNearLimit

float

GetNearLimit

void

SetProjection

int

GetProjection

void

SetView

void

SetView

char const *

GetView

char *

GetView

Detailed Description

class TK_Camera : public BBaseOpcodeHandler

Handles the TKE_Camera opcode.

TK_Camera provides support for writing/reading the TKE_Camera opcode object to/from an HSF file.

The HOOPS/3dGS scene-graph supports a camera, which is a segment attribute defining a specific view of world space.

Public Functions

inline TK_Camera(unsigned char opcode = TKE_Camera)

constructor

~TK_Camera()
virtual TK_Status Read(BStreamFileToolkit &tk)

Reads data from the toolkit buffer, decodes/decompresses it, and maps it to the opcode handlers data members. User-defined classes which need to write out custom data should utilize one of the available GetData() methods.

Parameters

tk – A reference to the BStreamFileToolkit object.

Returns

The result of the function call.

virtual TK_Status Write(BStreamFileToolkit &tk)

Encodes/compresses data and writes data to the toolkit buffer. User-defined classes which need to write out custom data should utilize one of the available PutData() methods, and first write out the opcode associated with the group of binary data followed by the data itself.

Parameters

tk – A reference to the BStreamFileToolkit object.

Returns

The result of the function call.

virtual TK_Status Clone(BStreamFileToolkit &tk, BBaseOpcodeHandler **handler) const

Copies the opcode handler

Parameters
  • tk – A reference to the BStreamFileToolkit object.

  • handler – A pointer to the opcode handler object. Passed by reference.

Returns

The result of the function call.

TK_Status ReadAscii(BStreamFileToolkit &tk)

Deprecated.

TK_Status WriteAscii(BStreamFileToolkit &tk)

Deprecated.

inline void SetPosition(float x, float y, float z)

Sets the position of the camera using discrete float values

inline void SetPosition(float const p[])

Sets the position of the camera using a float triplet

inline float const *GetPosition() const

Returns the position of the camera as the address of a float triplet

inline void GetPosition(float p[]) const

Returns the position of the camera to a pre-allocated array

inline void SetDPosition(double x, double y, double z)

Sets the position of the camera using discrete double values

inline void SetDPosition(double const p[])

Sets the position of the camera using a double triplet

inline double const *GetDPosition() const

Returns the position of the camera as the address of a double triplet

inline void GetDPosition(double p[]) const

Returns the position of the camera to a pre-allocated array

inline void SetTarget(float x, float y, float z)

Sets the target of the camera using discrete float values

inline void SetTarget(float const t[])

Sets the target of the camera using a float triplet

inline float const *GetTarget() const

Returns the target of the camera as the address of a float triplet

inline void GetTarget(float t[]) const

Returns the target of the camera to a pre-allocated array

inline void SetDTarget(double x, double y, double z)

Sets the target of the camera using discrete double values

inline void SetDTarget(double const t[])

Sets the target of the camera using a double triplet

inline double const *GetDTarget() const

Returns the target of the camera as the address of a float triplet

inline void GetDTarget(double t[]) const

Returns the target of the camera to a pre-allocated array

inline void SetUpVector(float x, float y, float z)

Sets the up-vector of the camera using discrete float values

inline void SetUpVector(float const u[])

Sets the up-vector of the camera using a float triplet

inline float const *GetUpVector() const

Returns the up-vector of the camera as the address of a float triplet

inline void GetUpVector(float u[]) const

Returns the up-vector of the camera to a pre-allocated array

inline void SetDUpVector(double x, double y, double z)

Sets the up-vector of the camera using discrete double values

inline void SetDUpVector(double const u[])

Sets the up-vector of the camera using a float triplet

inline double const *GetDUpVector() const

Returns the up-vector of the camera as the address of a float triplet

inline void GetDUpVector(double u[]) const

Returns the up-vector of the camera to a pre-allocated array

inline void SetField(float w, float h)

Sets the camera field size using discrete float values

inline void SetField(float const f[])

Sets the camera field size using a float pair

inline float const *GetField() const

Returns the camera field size as the address of a float pair

inline void GetField(float f[]) const

Returns the camera field size to a pre-allocated array

inline void SetDField(double w, double h)

Sets the camera field size using discrete double values

inline void SetDField(double const f[])

Sets the camera field size using a float pair

inline double const *GetDField() const

Returns the camera field size as the address of a float pair

inline void GetDField(double f[]) const

Returns the camera field size to a pre-allocated array

inline void SetOblique(float h, float v)

Sets the camera oblique angles (degrees) using discrete float values

inline void SetOblique(float const o[])

Sets the camera oblique angles (degrees) using a float pair

inline float const *GetOblique() const

Returns the camera oblique angles as the address of a float pair

inline void GetOblique(float o[]) const

Returns the camera oblique angles to a pre-allocated array

inline void SetNearLimit(float l)

Sets the camera field size using discrete float values

inline float GetNearLimit() const

Returns the camera field size as the address of a float pair

inline void SetProjection(int p)

Sets the projection type. Projection types are specified by TKO_Camera_Projection.

inline int GetProjection() const

Returns the projection type. Projection types are specified by TKO_Camera_Projection.

inline void SetView(char const *name)

Sets the view name. Allocates the buffer and copies the string

inline void SetView(int length)

Sets the view name buffer. Allocates a buffer which can hold a srting of ‘length’ characters

inline char const *GetView() const

Returns the view name.

inline char *GetView()

Returns the view name buffer, which may be modified directly