Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

Citerator

Methods

NameDescription
setStepSets the camera parameters that can change in an animation.
getStepGets the camera parameteres that can change in an animation.
setOrthoValuesSets orthographic camera values.
getOrthoValuesGets orthographic camera values.
getValuesGets the camera parameters that cannot change in an animation.
setNameSets camera name.
getNameGets camera name.
setResolutionSets camera resolution.
getResolutionGets camera resolution.
setPixelAspectSets camera pixel aspect.
getPixelAspectGets camera pixel aspect.
setShutterSets camera shutter.
getShutterGets camera shutter.
setIsoSets camera ISO.
getIsoGets camera ISO.
setFilmSizeSets camera film size.
getFilmSizeGets camera film size.
setDiaphragmSets camera diaphragm.
getDiaphragmGets camera diaphragm.
setFPSSets camera FPS.
getFPSGets camera FPS.
setScreenRegionDefines a render region for the camera.
getScreenRegionGets render region defined.
setCutPlanesSets camera cut planes.
getCutPlanesGets camera cut planes.
setShiftLensSets camera shift lens.
getShiftLensGets camera shift lens.
setCustomBokehDefines a custom bokeh.
getCustomBokehGets custom bokeh parameters.
setHideSets camera hidden status.
isHideGets camera hidden status.
setUuidSets camera unique ID. For custom purposes.
getUuidGets camera unique ID. For custom purposes.
setUserDataInternal use.
getUserDataInternal use.
setActiveSets the active camera in case the scene have more than one.
setDirtyInternal use.
isDirtyInternal use.
Ccamera#freefreeDestroys the camera.

Inherited methods

...

LanguageSyntax
C++byte getStep( dword iStep, Cpoint& origin, Cpoint& focalPoint, Cvector& up, real& focalLength, real& fStop )
Python[ (Cvector ' origin', Cvector ' focalPoint', Cvector ' up', float ' focalLength', float ' fStop'] ) getStep( int step )

Parameters

...

0 = Error getting camera step values.

1 = Success.

Python

Tuple containing the camera parameters requested.

Anchor
setorthovalues
setorthovalues

...

LanguageSyntax
C++byte getOrthoValues( dword iStep, real& orthoX, real& orthoY, real& orthoZoom, real& focalLength, real& fStop )
Python[ (float ' orthoX', float ' orthoY', float ' ortoZoom', float ' focalLength', float ' fStop' ] ) getOrthoValues( int iStep )

...

TypeNameIn/OutDescription
dwordiStepinCamera step requested.
realorthoXoutCamera position.
realorthoYoutCamera position.
realorthoZoomoutCamera zoom.
realfocalLengthoutCamera focal length.
realfStopoutCamera f-Stop.

Return value

C++

0 = Error getting ortho values.

1 = Success.

...


Python

Tuple containing the camera parameters requested.

Anchor
getvalues
getvalues

getValues

...

LanguageSyntax
C++byte getResolution( dword& xRes, dword& yRes)
Python(x,y) getResolution()

Return value

C++

0 = Error getting camera resolution.

1 = Success.

Python

(x,y) = Tuple containing width and height.

...

LanguageSyntax
C++byte getPixelAspect( real& pixelAspect)
Pythonfloat getPixelAspect()

Return value

C++

0 = Error getting pixel aspect.

1 = Success.

Python

Pixel aspect.

Anchor
setshutter
setshutter

...

LanguageSyntax
C++byte getShutter( real& shutter )
Pythonfloat getShutter()

Return value

C++

0 = Error getting shutter.

1 = Success.

Python

Shutter.

Anchor
setiso
setiso

...

LanguageSyntax
C++byte getIso( real& iso )
Pythonfloat getIso()

Return value

C++

0 = Error getting ISO.

1 = Success.

Python

ISO.

Anchor
setfilmsize
setfilmsize

...

LanguageSyntax
C++byte getFilmSize( real& filmWidth, real& filmHeight )
Python(x,y) getFilmSize()

Return value

C++

0 = Error getting camera film size.

1 = Success.

Python

(x,y) = Tuple containing width and height.

...

TypeNameIn/OutDescription
const char*pDiaphragmTypeinDiaphgragm type. Must be one of the following values: "CIRCULAR" or "POLYGONAL".
realangleinDiaphgragm angle of "POLYGONAL" diaphragm. If pDiaphragmType is not "POLYGONAL", angle is set to 0.0.
dwordnBladesinNumber of blades ( of "POLYGONAL" diaphragm). If pDiaphragmType is not "POLYGONAL", nBlades is set to 0.

Return value

0 = Error setting camera diaphgragm.

...

LanguageSyntax
C++byte getDiaphragm( const char** pDiaphragmType, real& angle, dword& nBlades )
Python[ (str ' type', float ' angle', int ' nBlades' ] ) getDiaphragm()

Parameters

TypeNameIn/OutDescription
const char*pDiaphragmTypeoutDiaphgragm type. Can be one of the following values: "CIRCULAR" or "POLYGONAL".
realangleoutDiaphgragm angle of "POLYGONAL" diaphragm. If pDiaphragmType is not "POLYGONAL", angle is 0.0.
dwordnBladesoutNumber of blades (if of "POLYGONAL" diaphragm). If pDiaphragmType is not "POLYGONAL", nBlades is 0.

Return value

C++

0 = Error getting camera diaphragm.

1 = Success.


Python

Tuple containing the requested diaphragm parameters.

Anchor
setfps
setfps

setFPS

...

LanguageSyntax
C++byte getFPS( real& fps )
Pythonfloat getFPS()

Return value

C++

0 = Error getting FPS.

1 = Success.

Python

FPS.

Anchor
setscreenregion
setscreenregion

...

LanguageSyntax
C++byte getScreenRegion( dword& x1, dword& y1, dword& x2, dword& y2, char* pType )
Python[ (int ' x1', int ' y1', int ' x2', int ' y2', str ' type' ] ) getScreenRegion()

Parameters

TypeNameIn/OutDescription
dwordx1outX-axis up-left edge of the region (in pixels)
dwordy1outY-axis up-left edge of the region (in pixels)
dwordx2outX-axis down-right edge of the region (in pixels)
dwordy2outY-axis down-right edge of the region (in pixels)
const char*pRegionTypeoutRegion type. Must be one of the following values: "REGION" or "BLOW UP".

Return value

C++

0 = Error getting screen region.

1 = Success.

...


...

Python

Tuple containing the screen region values.

Anchor
setcutplanes
setcutplanes

setCutPlanes

Sets camera cut planes.

...

LanguageSyntax
C++byte getCutPlanes( real& zNear, real& zFar, bool& enabled )
Python['(float zNear', 'float zFar', 'float enabled'] ) getCutPlanes()

Return value

C++

0 = Error getting camera cut planes.

1 = Success.

Python

Dictionary Tuple containing "zNear", "zFar" and "enabledthe "cut planes" values.

Anchor
setshiftlens
setshiftlens

...

getShiftLens

Gets camera shift lens.

LanguageSyntax
C++byte getShiftLens( real& xShift, real& yShift )
Python(float xShift, float yShift) getShiftLens()

Return value

C++

0 = Error getting camera shift lens.

1 = Success.

Python

Tuple containing "xShift" and "yShift".

Anchor
setcustombokeh
setcustombokeh

setCustomBokeh

Defines a custom bokeh.

LanguageSyntax
C++byte setCustomBokeh( const real& ratio, const real& angle, bool enabled )
Pythonint setCustomBokeh( float ratio, float angle, bool enabled )

Return Value

0 = Error

1 = Success

Anchor
getcustombokeh
getcustombokeh

getCustomBokeh

Gets custom bokeh parameters.

LanguageSyntax
C++byte getShiftLensgetCustomBokeh( real& xShiftratio, real& angle, bool& yShift enabled )
Python['xShift','yShift'] getShiftLens(float ratio, float angle, bool enabled, int success) getCustomBokeh()

Return

...

Value

C++

0 = Error getting camera shift lens.

1 = Success.

Python

Dictionary containing "xShift" and "yShift"Tuple containing custom bokeh parameters and function success value.

Anchor
sethide
sethide

setHide

...

LanguageSyntax
C++byte isHide( bool& hide )
Pythonbool isHide()

Return value

C++

0 = Error getting camera shift lens.

1 = Success.

Python

Hidden status.

Anchor
setuuid
setuuid

...

0 = Error destroying the camera.

1 = Success.