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.
setUserData Internal use.
getUserData Internal use.
setActiveSets the active camera in case the scene have more than one.
setDirty Internal use.
isDirty Internal use.
Ccamera#freefreeDestroys the camera.

Inherited methods

NameDescription
isNullChecks whether the object is null.

...

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

...

TypeNameIn/OutDescription
dwordnStepsoutNumber of steps.
realshutteroutCamera shutter (1/s).
realfilmWidthoutCamera film width (mm).
realfilmHeightoutCamera film height (mm).
realisooutCamera ISO.
const char**pDiaphragmTypeoutDiaphragm type. Possible values: "CIRCULAR" and "POLYGONAL".
realangleoutShutter angle. --TODO--
dwordnBladesoutNumber of diaphragm blades if pDiaphragmType is "POLYGONAL".
dwordfpsoutFrames per second.
dwordxResoutResolution output width.
dwordyResoutResolution output height.
realpixelAspectoutPixel aspect ratio.
byteprojectionTypeoutCamera projection type. 0 (perspective, default), 1 (front), 2 (top), 3 (left), 4 (back), 5 (bottom), 6 (right).

...

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).

Return value

...

. 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

Sets camera FPS.

...

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

...

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 the "zNear", "zFar" and "enabled" cut planes" values.

Anchor
setshiftlens
setshiftlens

...

LanguageSyntax
C++byte getShiftLens( real& xShift, real& yShift )
Python['xShift','yShift'] getShiftLens()

...

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 getCustomBokeh( real& ratio, real& angle, bool& enabled )
Python(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.