#include <c4d_baseobject.h>

Inheritance diagram for CameraObject:

[legend]

Detailed Description

Represents a Camera object.

Note: Has to be created with Alloc() and destroyed with Free(). Use AutoAlloc to automate the allocation and destruction based on scope.

Private Member Functions
	CameraObject ()

	~CameraObject ()

Alloc/Free
static CameraObject *	Alloc ()

static void	Free (CameraObject *&bl)

Projection
Int32	GetProjection () const

Bool	SetProjection (Int32 projection)

Zoom
Float	GetZoom () const

Bool	SetZoom (Float zoom)

Offset
Vector	GetOffset () const

Bool	SetOffset (const Vector &offset)

Aperture
Float	GetAperture () const

Bool	SetAperture (Float v)

Focus
Float	GetFocus () const

Bool	SetFocus (Float v)

Float	GetTargetDistance (BaseDocument *doc)

Stereo
Int32	StereoGetCameraCount (BaseDocument doc, BaseDraw bd, RenderData *rd, Int32 flags) const

Bool	StereoGetCameraInfo (BaseDocument doc, BaseDraw bd, RenderData *rd, Int32 n, StereoCameraInfo &info, Int32 flags) const

Additional Inherited Members
Public Member Functions inherited from BaseObject
BaseObject *	GetNext (void)

BaseObject *	GetPred (void)

BaseObject *	GetUp (void)

BaseObject *	GetDown (void)

BaseObject *	GetDownLast (void)

Vector	GetAbsPos () const

void	SetAbsPos (const Vector &v)

Vector	GetAbsScale () const

void	SetAbsScale (const Vector &v)

Vector	GetAbsRot () const

void	SetAbsRot (const Vector &v)

Vector	GetFrozenPos () const

void	SetFrozenPos (const Vector &v)

Vector	GetFrozenScale () const

void	SetFrozenScale (const Vector &v)

Vector	GetFrozenRot () const

void	SetFrozenRot (const Vector &v)

Vector	GetRelPos () const

void	SetRelPos (const Vector &v)

Vector	GetRelScale () const

void	SetRelScale (const Vector &v)

Vector	GetRelRot () const

void	SetRelRot (const Vector &v)

const Matrix &	GetMl (void) const

void	SetMl (const Matrix &m)

Matrix	GetFrozenMln () const

Matrix	GetRelMln () const

Matrix	GetRelMl () const

void	SetRelMl (const Matrix &m)

Matrix	GetMg () const

void	SetMg (const Matrix &m)

Matrix	GetMln () const

Matrix	GetMgn () const

Matrix	GetUpMg () const

void	CopyMatrixTo (BaseObject *dst)

Vector	GetMp (void)

Vector	GetRad (void)

void	GetDimension (Vector &mp, Vector &rad)

Int32	GetEditorMode (void) const

Int32	GetEditorModeH (void) const

void	SetEditorMode (Int32 mode)

Int32	GetRenderMode (void) const

Int32	GetRenderModeH (void) const

void	SetRenderMode (Int32 mode)

Bool	GetDeformMode (void) const

void	SetDeformMode (Bool mode)

Int32	GetRealDeformMode (void) const

void	SetRealDeformMode (Int32 mode)

Int32	GetUniqueIP (void)

void	SetUniqueIP (Int32 ip)

BaseTag *	GetFirstTag (void)

BaseTag *	GetLastTag (void)

BaseTag *	GetTag (Int32 type, Int32 nr=0)

const maxon::BaseArray< BaseTag * > *	GetTagsOfType (Int32 type) const

const maxon::BaseArray< BaseTag * > *	GetTagsWithFlags (Int32 flags) const

const void *	GetTagDataR (Int32 type, Int32 nr=0) const

void *	GetTagDataW (Int32 type, Int32 nr=0)

Int32	GetTagDataCount (Int32 type) const

BaseTag *	MakeTag (Int32 type, BaseTag *pred=nullptr)

VariableTag *	MakeVariableTag (Int32 type, Int32 count, BaseTag *pred=nullptr)

void	InsertTag (BaseTag tp, BaseTag pred=nullptr)

void	KillTag (Int32 type, Int32 nr=0)

Bool	CopyTagsTo (BaseObject dest, Int32 visible, Int32 variable, Int32 hierarchical, AliasTrans trans)

BaseObject *	GetCache (HierarchyHelp *hh=nullptr)

BaseObject *	GetDeformCache (void)

LineObject *	GetIsoparm (void)

void	SetIsoparm (LineObject *l)

BaseObject *	GetCacheParent (void) const

BaseObject *	GetCacheTopParent (void) const

Bool	SetPhong (Bool on, Bool anglelimit, Float angle)

Bool	IsDirty (DIRTYFLAGS flags)

void	SetDirty (DIRTYFLAGS flags)

Bool	CheckCache (HierarchyHelp *hh)

void	Touch (void)

void	GetColorProperties (ObjectColorProperties *prop)

void	SetColorProperties (ObjectColorProperties *prop)

const Matrix &	GetModelingAxis (BaseDocument *doc)

void	SetModelingAxis (const Matrix &m)

BaseObject *	GetAndCheckHierarchyClone (HierarchyHelp hh, BaseObject op, HIERARCHYCLONEFLAGS flags, Bool dirty, AliasTrans trans, Int childCount, maxon::BaseArray< BaseObject * > *children)

BaseObject *	GetAndCheckHierarchyClone (HierarchyHelp hh, BaseObject op, HIERARCHYCLONEFLAGS flags, Bool dirty, AliasTrans trans, Bool allchildren)

BaseObject *	GetHierarchyClone (HierarchyHelp hh, BaseObject op, HIERARCHYCLONEFLAGS flags, Bool dirty, AliasTrans trans)

BaseObject *	GetHierarchyClone (HierarchyHelp hh, BaseObject op, HIERARCHYCLONEFLAGS flags, Bool dirty, AliasTrans trans, DIRTYFLAGS dirtyflags)

void	NewDependenceList (void)

Bool	CompareDependenceList (void)

void	AddDependence (HierarchyHelp hh, BaseObject op)

void	AddDependence (HierarchyHelp hh, BaseObject op, DIRTYFLAGS dirtyflags)

void	TouchDependenceList (void)

void	SetRotationOrder (ROTATIONORDER order)

ROTATIONORDER	GetRotationOrder (void) const

void	SetQuaternionRotationMode (Bool active, Bool bUndo)

Bool	IsQuaternionRotationMode (void)

Bool	SynchronizeVectorTrackKeys (Int32 vectorTrackID, Bool bUndo, BaseTime startRange=BaseTime(-108000, 1), BaseTime endRange=BaseTime(108000, 1))

Bool	FindBestEulerAngle (Int32 rotationTrackID, Bool bAdjustTangent, Bool bUndo, BaseTime startRange=BaseTime(-108000, 1), BaseTime endRange=BaseTime(108000, 1))

Bool	EvaluateSynchronizedRotation (const BaseTime &time, ANIMATEFLAGS flags, Vector *resultRotation=nullptr)

Bool	GetVectorTracks (const DescID &id, CTrack &xfound, CTrack &yfound, CTrack *&zfound)

Bool	GetVectorCurves (CCurve curveToSearch, CCurve &xfound, CCurve &yfound, CCurve &zfound)

UInt64	GetGUID ()

Int32	GetHighlightHandle (BaseDraw *bd)

SplineObject *	GetRealSpline (void)

Float	GetVisibility (Float parent)

Bool	SearchHierarchy (BaseObject *op)

BaseObject *	GetOrigin (Bool safe)

void	SetOrigin (BaseObject *origin)

BaseObject *	GetTopOrigin (Bool parent, Bool safe)

BaseObject *	GetEditObject (BaseObject **psds, DISPLAYEDITSTATE state, Bool safetey=true)

void	RemoveFromCache (void)

DRAWRESULT	ObjDraw (DRAWPASS drawpass, BaseDraw bd, BaseDrawHelp bh)

Public Member Functions inherited from BaseList2D
void	SetBit (Int32 mask)

Bool	GetBit (Int32 mask) const

void	DelBit (Int32 mask)

void	ToggleBit (Int32 mask)

Int32	GetAllBits () const

void	SetAllBits (Int32 bits)

void	SetBitEx (Int32 mask, Int32 flags)

const Char *	GetViewportRenderId (VIEWPORT_RENDER_ID typeId) const

BaseList2D *	GetNext ()

BaseList2D *	GetPred ()

BaseContainer	GetData ()

void	SetData (const BaseContainer &bc, Bool add=true)

const BaseContainer *	GetDataInstance () const

BaseContainer *	GetDataInstance ()

const BaseContainer &	GetDataInstanceRef () const

BaseContainer &	GetDataInstanceRef ()

String	GetName () const

void	SetName (const maxon::String &name)

String	GetBubbleHelp ()

Bool	TransferGoal (BaseList2D *dst, Bool undolink)

Bool	TransferMarker (BaseList2D *dst) const

Bool	Scale (Float scale)

Bool	Edit ()

void	GetIcon (IconData *dat)

GeListHead *	GetNLARoot ()

BaseList2D *	AnimationLayerRemap (BaseObject **layer=nullptr)

String	GetTypeName ()

BaseList2D *	GetMain () const

void	InsertTrackSorted (CTrack *track)

Bool	AddEventNotification (BaseList2D bl, NOTIFY_EVENT eventid, NOTIFY_EVENT_FLAG flags, const BaseContainer data)

Bool	RemoveEventNotification (BaseDocument doc, BaseList2D bl, NOTIFY_EVENT eventid)

Bool	FindEventNotification (BaseDocument doc, BaseList2D bl, NOTIFY_EVENT eventid)

Bool	SetDescIDState (const DescID &id, DESCIDSTATE descidstate)

DESCIDSTATE	GetDescIDState (const DescID &id, Bool tolerant) const

GeListHead *	GetOverrideRoot ()

BaseOverride *	GetFirstOverride ()

GeListHead *	GetShaderRepositoryRoot ()

GeListHead *	GetHiddenShaderRoot ()

maxon::NimbusForwardRef	GetNimbusRef (const maxon::Id &spaceId) const

maxon::Result< maxon::NimbusForwardRef >	PrivateGetOrCreateNimbusRef (const maxon::Id &spaceId)

void	RemoveNimbusRef (const maxon::Id &spaceId)

maxon::Result< maxon::HashMap< maxon::Id, maxon::NimbusForwardRef > >	GetAllNimbusRefs () const

Bool	IsNodeBased () const

void	GetMarkerStampEx (UInt32 l1, UInt32 l2)

const GeMarker &	GetMarker () const

void	SetMarker (const GeMarker &m)

Bool	AddUniqueID (Int32 appid, const Char *const mem, Int bytes)

Bool	FindUniqueID (Int32 appid, const Char *&mem, Int &bytes) const

Int32	GetUniqueIDCount () const

Bool	GetUniqueIDIndex (Int32 idx, Int32 &id, const Char *&mem, Int &bytes) const

Bool	SetAnimatedParameter (CTrack *track, const DescID &id, const GeData &t_data1, const GeData &t_data2, Float mix, DESCFLAGS_SET flags)

Bool	GetAnimatedParameter (const DescID &id, GeData &t_data1, GeData &t_data2, Float &mix, DESCFLAGS_GET flags)

BaseShader *	GetFirstShader () const

void	InsertShader (BaseShader shader, BaseShader pred=nullptr)

void	ClearKeyframeSelection ()

Bool	FindKeyframeSelection (const DescID &id)

Bool	SetKeyframeSelection (const DescID &id, Bool selection)

Bool	KeyframeSelectionContent ()

LayerObject *	GetLayerObject (BaseDocument *doc)

Bool	SetLayerObject (LayerObject *layer)

const LayerData *	GetLayerData (BaseDocument *doc, Bool rawdata=false)

Bool	SetLayerData (BaseDocument *doc, const LayerData &data)

GeListHead *	GetCTrackRoot ()

CTrack *	GetFirstCTrack ()

CTrack *	FindCTrack (const DescID &id)

Public Member Functions inherited from GeListNode
GeListNode *	GetNext ()

GeListNode *	GetPred ()

GeListNode *	GetDown ()

GeListNode *	GetUp ()

GeListNode *	GetDownLast ()

void	InsertBefore (GeListNode *bl)

void	InsertAfter (GeListNode *bl)

void	InsertUnder (GeListNode *bl)

void	InsertUnderLast (GeListNode *bl)

void	Remove ()

GeListHead *	GetListHead ()

Int32	GetNodeID (Int32 index=0) const

template<typename CAST >
const CAST *	GetNodeData (Int32 index=0) const

template<typename CAST >
CAST *	GetNodeData (Int32 index=0)

void	SetCustomData (GeListNode *node)

GeListNode *	GetCustomData ()

BaseDocument *	GetDocument ()

Int32	GetBranchInfo (BranchInfo *info, Int32 max, GETBRANCHINFO flags)

Bool	IsDocumentRelated ()

Int32	GetInfo () const

Bool	GetNBit (NBIT bit) const

UInt32	GetNBitMask (Int32 index) const

Bool	ChangeNBit (NBIT bit, NBITCONTROL bitmode)

Public Member Functions inherited from C4DAtom
Int32	GetType () const

Int32	GetRealType () const

Int32	GetDiskType () const

Bool	IsInstanceOf (Int32 id) const

Int32	GetClassification () const

Bool	Message (Int32 type, void *data=nullptr)

Bool	MultiMessage (MULTIMSG_ROUTE flags, Int32 type, void *data)

C4DAtom *	GetClone (COPYFLAGS flags, AliasTrans *trn)

Bool	CopyTo (C4DAtom dst, COPYFLAGS flags, AliasTrans trn)

Bool	Read (HyperFile *hf, Int32 id, Int32 level)

Bool	Write (HyperFile *hf)

Bool	ReadObject (HyperFile *hf, Bool readheader)

Bool	WriteObject (HyperFile *hf)

Bool	GetDescription (Description *description, DESCFLAGS_DESC flags)

Bool	GetParameter (const DescID &id, GeData &t_data, DESCFLAGS_GET flags)

Bool	SetParameter (const DescID &id, const GeData &t_data, DESCFLAGS_SET flags)

DynamicDescription *	GetDynamicDescription ()

Bool	GetEnabling (const DescID &id, const GeData &t_data, DESCFLAGS_ENABLE flags, const BaseContainer *itemdesc)

Bool	TranslateDescID (const DescID &id, DescID &res_id, C4DAtom *&res_at)

UInt32	GetDirty (DIRTYFLAGS flags) const

void	SetDirty (DIRTYFLAGS flags)

UInt32	GetHDirty (HDIRTYFLAGS mask) const

void	SetHDirty (HDIRTYFLAGS mask)

Static Public Member Functions inherited from BaseObject
static BaseObject *	Alloc (Int32 type)

static void	Free (BaseObject *&bl)

Static Public Member Functions inherited from BaseList2D
static BaseList2D *	Alloc (Int32 type)

static void	Free (BaseList2D *&bl)

Static Public Attributes inherited from BaseList2D
static const Int32	SETBIT_FLAG_NODIRTY

static const Int32	SETBIT_FLAG_REMOVE

Constructor & Destructor Documentation

◆ CameraObject()

CameraObject ( )

private

◆ ~CameraObject()

~CameraObject ( )

private

Member Function Documentation

◆ Alloc()

static CameraObject* Alloc ( )

static

Allocates a camera object. Destroy the allocated camera object with Free(). Use AutoAlloc to automate the allocation and destruction based on scope.

Returns: The allocated camera object, or nullptr if the allocation failed.

◆ Free()

static void Free ( CameraObject *& bl )

static

Destructs camera objects allocated with Alloc(). Use AutoAlloc to automate the allocation and destruction based on scope.

Parameters

[in,out] bl The camera object to destruct. If the pointer is nullptr nothing happens. The pointer is assigned nullptr afterwards.

◆ GetProjection()

Int32 GetProjection ( ) const

Gets the projection of the camera.

Note: For information about the projections used in Cinema 4D see BaseView::GetViewParameter()

Returns: The camera's projection. See Ocamera.h for values.

◆ SetProjection()

Bool SetProjection ( Int32 projection )

Sets the projection of the camera.

Note: For information about the projections used in Cinema 4D see BaseView::GetViewParameter()

Parameters

[in] projection The new camera projection to set. See Ocamera.h for values.

Returns: true if the camera projection was successfully set, otherwise false.

◆ GetZoom()

Float GetZoom ( ) const

Gets the zoom of the camera.

Returns: The camera's zoom.

◆ SetZoom()

Bool SetZoom ( Float zoom )

Sets the zoom of the camera.

Parameters

[in] zoom The new camera zoom to set.

Returns: true if the camera zoom was successfully set, otherwise false.

◆ GetOffset()

Vector GetOffset ( ) const

Gets the offset of the camera.
This is the midpoint for orthogonal projections. (Front/Back/Top/Bottom etc.)

Returns: The camera's offset/midpoint.

◆ SetOffset()

Bool SetOffset ( const Vector & offset )

Sets the offset of the camera.
This is the midpoint for orthogonal projections. (Front/Back/Top/Bottom etc.)

Parameters

[in] offset The new offset/midpoint.

Returns: true if the camera offset was successfully set, otherwise false.

◆ GetAperture()

Float GetAperture ( ) const

Gets the aperture width of the camera.

Returns: The camera's aperture.

◆ SetAperture()

Bool SetAperture ( Float v )

Sets the aperture width of the camera.

Parameters

[in] v The new camera aperture to set.

Returns: true if the camera aperture was successfully set, otherwise false.

◆ GetFocus()

Float GetFocus ( ) const

Gets the focus of the camera.

Returns: The camera's focus.

◆ SetFocus()

Bool SetFocus ( Float v )

Sets the focus of the camera.

Parameters

[in] v The new camera focus to set.

Returns: true if the camera focus was successfully set, otherwise false.

◆ GetTargetDistance()

Float GetTargetDistance ( BaseDocument * doc )

Gets the target distance of the camera. This function may change the CAMERAOBJECT_TARGETDISTANCE setting of the camera.

Parameters

[in] doc Document in which the camera is.

Returns: The camera's target distance.

◆ StereoGetCameraCount()

Int32 StereoGetCameraCount	(	BaseDocument *	doc,
		BaseDraw *	bd,
		RenderData *	rd,
		Int32	flags
	)		const

Gets how many cameras compose a stereo camera.

Parameters

[in]	doc	The document for the operation. The caller owns the pointed document.
[in]	bd	The stereoscopic view. The caller owns the pointed view.
[in]	rd	The stereoscopic render settings. The caller owns the pointed render data.
[in]	flags	Currently unused. Set to 0.

Returns: The number of cameras.

◆ StereoGetCameraInfo()

Bool StereoGetCameraInfo	(	BaseDocument *	doc,
		BaseDraw *	bd,
		RenderData *	rd,
		Int32	n,
		StereoCameraInfo &	info,
		Int32	flags
	)		const

Gets stereoscopic camera information.

Parameters

[in]	doc	The document for the operation. The caller owns the pointed document.
[in]	bd	The stereoscopic view. The caller owns the pointed view.
[in]	rd	The stereoscopic render settings. The caller owns the pointed render data.
[in]	n	The stereoscopic camera index: 0 <= n < StereoGetCameraCount()
[out]	info	Assigned the stereoscopic camera data.
[in]	flags	Currently unused. Set to 0.

Returns: true if the stereoscopic camera information was successfully retrieved, otherwise false.

Detailed Description

Private Member Functions

Alloc/Free

Projection

Zoom

Offset

Aperture

Focus

Stereo

Additional Inherited Members

Constructor & Destructor Documentation

◆ CameraObject()

◆ ~CameraObject()

Member Function Documentation

◆ Alloc()

◆ Free()

◆ GetProjection()

◆ SetProjection()

◆ GetZoom()

◆ SetZoom()

◆ GetOffset()

◆ SetOffset()

◆ GetAperture()

◆ SetAperture()

◆ GetFocus()

◆ SetFocus()

◆ GetTargetDistance()

◆ StereoGetCameraCount()

◆ StereoGetCameraInfo()