Skip to main content

Speos NX library 2025 R2

SensorCameraBuilder Class Reference

Last update: 16.07.2025

Represents a Camera Sensor Builder. More...

Inheritance diagram for SensorCameraBuilder:
FeatureBuilderBuilder

Public Member Functions

'None' UpdateWavelengthSamplingFromResolution (self, resolution)
 Updates the wavelength sampling from a resolution.
 
- Public Member Functions inherited from FeatureBuilder
'None' ShowResult (self)
 Updates the feature to reflect the result of an edit to the feature for all builders that support showing results.
 
- Public Member Functions inherited from Builder
'None' Commit (self)
 Commits any edits that have been applied to the builder.
 

Static Public Attributes

str AxisSystem = property(fget=__GetAxisSystem)
 Gets the Axis System of the Sensor.
 
str BlueGain = property(fget=__GetBlueGain, fset=__SetBlueGain)
 Gets or sets the blue gain.
 
str CameraMode = property(fget=__GetCameraMode, fset=__SetCameraMode)
 Gets or sets the camera mode.
 
str ColorMode = property(fget=__GetColorMode, fset=__SetColorMode)
 Gets or sets the color mode.
 
str DisplayAperture = property(fget=__GetDisplayAperture, fset=__SetDisplayAperture)
 Gets or sets the property to enable the preview of the Aperture.
 
str DisplayCameraField = property(fget=__GetDisplayCameraField, fset=__SetDisplayCameraField)
 Gets or sets the property to enable the preview of the Camera Field.
 
str DisplayObjectField = property(fget=__GetDisplayObjectField, fset=__SetDisplayObjectField)
 Gets or sets the property to enable the preview of the Object Field.
 
str DistortionFilePath = property(fget=__GetDistortionFilePath, fset=__SetDistortionFilePath)
 Gets or sets the distortion file path.
 
str FNumber = property(fget=__GetFNumber, fset=__SetFNumber)
 Gets or sets the F number.
 
str FocalLength = property(fget=__GetFocalLength, fset=__SetFocalLength)
 Gets or sets the focal length.
 
str GammaCorrection = property(fget=__GetGammaCorrection, fset=__SetGammaCorrection)
 Gets or sets the gamma correction.
 
str GreenGain = property(fget=__GetGreenGain, fset=__SetGreenGain)
 Gets or sets the green gain.
 
str Height = property(fget=__GetHeight, fset=__SetHeight)
 Gets or sets the height .
 
str HorizontalFOV = property(fget=__GetHorizontalFOV)
 Gets the Horizontal Field of View.
 
str HorizontalPixels = property(fget=__GetHorizontalPixels, fset=__SetHorizontalPixels)
 Gets or sets the horizontal pixels .
 
str ImagerDistance = property(fget=__GetImagerDistance, fset=__SetImagerDistance)
 Gets or sets the Image Distance.
 
str Layer = property(fget=__GetLayer, fset=__SetLayer)
 Gets or sets the layer mode.
 
str PNGBits = property(fget=__GetPNGBits, fset=__SetPNGBits)
 Gets or sets the PNG Bits.
 
str RedGain = property(fget=__GetRedGain, fset=__SetRedGain)
 Gets or sets the red gain.
 
str SensitivityBlueSpectrumFilePath = property(fget=__GetSensitivityBlueSpectrumFilePath, fset=__SetSensitivityBlueSpectrumFilePath)
 Gets or sets the sensitivity blue spectrum file path.
 
str SensitivityGreenSpectrumFilePath = property(fget=__GetSensitivityGreenSpectrumFilePath, fset=__SetSensitivityGreenSpectrumFilePath)
 Gets or sets the sensitivity green spectrum file path.
 
str SensitivityMonochromaticSpectrumFilePath = property(fget=__GetSensitivityMonochromaticSpectrumFilePath, fset=__SetSensitivityMonochromaticSpectrumFilePath)
 Gets or sets the sensitivity monochromatic spectrum file path.
 
str SensitivityRedSpectrumFilePath = property(fget=__GetSensitivityRedSpectrumFilePath, fset=__SetSensitivityRedSpectrumFilePath)
 Gets or sets the sensitivity red spectrum file path.
 
str TransmittanceFilePath = property(fget=__GetTransmittanceFilePath, fset=__SetTransmittanceFilePath)
 Gets or sets the transmittance file path.
 
str VerticalFOV = property(fget=__GetVerticalFOV)
 Gets the Vertical Field of View.
 
str VerticalPixels = property(fget=__GetVerticalPixels, fset=__SetVerticalPixels)
 Gets or sets the vertical pixels .
 
str VisualizationRadius = property(fget=__GetVisualizationRadius, fset=__SetVisualizationRadius)
 Gets or sets the Visualization radius.
 
str WavelengthEnd = property(fget=__GetWavelengthEnd, fset=__SetWavelengthEnd)
 Gets or sets the higher value of the wavelength range to be considered by the sensor.
 
str WavelengthResolution = property(fget=__GetWavelengthResolution)
 Gets the Wavelength resolution.
 
str WavelengthSampling = property(fget=__GetWavelengthSampling, fset=__SetWavelengthSampling)
 Gets or sets the wavelength sampling.
 
str WavelengthStart = property(fget=__GetWavelengthStart, fset=__SetWavelengthStart)
 Gets or sets the lower value of the wavelength range to be considered by the sensor.
 
str WhiteBalanceBlueSpectrumFilePath = property(fget=__GetWhiteBalanceBlueSpectrumFilePath, fset=__SetWhiteBalanceBlueSpectrumFilePath)
 Gets or sets the white balance blue spectrum file path.
 
str WhiteBalanceGreenSpectrumFilePath = property(fget=__GetWhiteBalanceGreenSpectrumFilePath, fset=__SetWhiteBalanceGreenSpectrumFilePath)
 Gets or sets the white balance green spectrum file path.
 
str WhiteBalanceMode = property(fget=__GetWhiteBalanceMode, fset=__SetWhiteBalanceMode)
 Gets or sets the white balance mode.
 
str WhiteBalanceRedSpectrumFilePath = property(fget=__GetWhiteBalanceRedSpectrumFilePath, fset=__SetWhiteBalanceRedSpectrumFilePath)
 Gets or sets the white balance red spectrum file path.
 
str Width = property(fget=__GetWidth, fset=__SetWidth)
 Gets or sets the width .
 
- Static Public Attributes inherited from FeatureBuilder
str Feature = property(fget=__GetFeature)
 Returns the feature being edited, or the created feature if the builder is being used in creation mode.
 
str FullName = property(fget=__GetFullName)
 Gets the full name of the feature being edited.
 
str Name = property(fget=__GetName, fset=__SetName)
 Gets or sets the name of the feature being edited.
 
str NameWithContext = property(fget=__GetNameWithContext)
 Gets the name with context of the feature being edited.
 
str Status = property(fget=__GetStatus)
 Returns the status of the feature being edited.
 

Properties

 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
 
- Properties inherited from FeatureBuilder
 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
 
- Properties inherited from Builder
 thisown = property(lambda x: x.this.own(), lambda x, v: x.this.own(v), doc='The membership flag')
 

Detailed Description

Represents a Camera Sensor Builder.

The Camera Sensor Builder creates or edits Camera Sensor features.

To create a new instance of this class, use FeatureCollection.CreateSensorCameraBuilder.

With a surface source, you can simulate rays integration as in a real camera according to the camera parameters set.

Member Function Documentation

◆ UpdateWavelengthSamplingFromResolution()

'None' UpdateWavelengthSamplingFromResolution ( self,
resolution )

Updates the wavelength sampling from a resolution.

Parameters
[in]ResolutionDouble.

Member Data Documentation

◆ AxisSystem

str AxisSystem = property(fget=__GetAxisSystem)
static

Gets the Axis System of the Sensor.

Value type: AxisSystem object.

◆ BlueGain

str BlueGain = property(fget=__GetBlueGain, fset=__SetBlueGain)
static

Gets or sets the blue gain.

Prerequisite: The WhiteBalanceMode property must be 2.

Value type: Double.

The default value is 1.0.

◆ CameraMode

str CameraMode = property(fget=__GetCameraMode, fset=__SetCameraMode)
static

Gets or sets the camera mode.

The values are:
0 - Geometric, it is a simplified version of the Camera Sensor definition parameters.
1 - Photometric / Colorimetric, it allows you to set every Camera Sensor parameters, including the photometric definition parameters.

Value type: Integer.

The default value is 0.

◆ ColorMode

str ColorMode = property(fget=__GetColorMode, fset=__SetColorMode)
static

Gets or sets the color mode.

Prerequisite: The CameraMode property must be 1.

The values are:
0 - Monochrome, the simulation results are available in grey scale.
1 - Color, the simulation results are available in color according to the White Balance mode.

Value type: Integer.

The default value is 1.

◆ DisplayAperture

str DisplayAperture = property(fget=__GetDisplayAperture, fset=__SetDisplayAperture)
static

Gets or sets the property to enable the preview of the Aperture.

True: Displays the Aperture.
False: Does not display the Aperture

Value type: Boolean.

The default value is True.

◆ DisplayCameraField

str DisplayCameraField = property(fget=__GetDisplayCameraField, fset=__SetDisplayCameraField)
static

Gets or sets the property to enable the preview of the Camera Field.

True: Displays the Camera Field.
False: Does not display the Camera Field

Value type: Boolean.

The default value is True.

◆ DisplayObjectField

str DisplayObjectField = property(fget=__GetDisplayObjectField, fset=__SetDisplayObjectField)
static

Gets or sets the property to enable the preview of the Object Field.

True: Displays the Object Field.
False: Does not display the Object Field

Value type: Boolean.

The default value is True.

◆ DistortionFilePath

str DistortionFilePath = property(fget=__GetDistortionFilePath, fset=__SetDistortionFilePath)
static

Gets or sets the distortion file path.

Value type: String.

The default value is an empty file path (string).

◆ FNumber

str FNumber = property(fget=__GetFNumber, fset=__SetFNumber)
static

Gets or sets the F number.

Represents the aperture of the front lens.

Value type: Double.
Range: The value must be superior to 0.

The default value is 15.0.

◆ FocalLength

str FocalLength = property(fget=__GetFocalLength, fset=__SetFocalLength)
static

Gets or sets the focal length.

Distance between the center of the optical system and the focus.

Value type: Double (in mm).
Range: The value must be superior to 0.

The default value is 15.0 mm.

◆ GammaCorrection

str GammaCorrection = property(fget=__GetGammaCorrection, fset=__SetGammaCorrection)
static

Gets or sets the gamma correction.

Prerequisite: The CameraMode property must be 1.

Compensates the curve before the display on the screen.

Value type: Double.

The default value is 2.2.

◆ GreenGain

str GreenGain = property(fget=__GetGreenGain, fset=__SetGreenGain)
static

Gets or sets the green gain.

Prerequisite: The WhiteBalanceMode property must be 2.

Value type: Double.

The default value is 1.0.

◆ Height

str Height = property(fget=__GetHeight, fset=__SetHeight)
static

Gets or sets the height .

Defines the sensor's height.

Value type: Double (in mm).
Range: The value must be superior to 0.

The default value is 5.0 mm.

◆ HorizontalFOV

str HorizontalFOV = property(fget=__GetHorizontalFOV)
static

Gets the Horizontal Field of View.

Value type: Double.

◆ HorizontalPixels

str HorizontalPixels = property(fget=__GetHorizontalPixels, fset=__SetHorizontalPixels)
static

Gets or sets the horizontal pixels .

Defines the horizontal pixels number corresponding to the camera resolution.

Value type: Integer.
Range: The value must be superior to 0.

The default value is 640.

◆ ImagerDistance

str ImagerDistance = property(fget=__GetImagerDistance, fset=__SetImagerDistance)
static

Gets or sets the Image Distance.

Value type: Double (in mm).

The default value is 15.0 mm.

◆ Layer

str Layer = property(fget=__GetLayer, fset=__SetLayer)
static

Gets or sets the layer mode.

The values are:
0 - None, the simulation generates a Speos360 file with one layer for all sources.
1 - Data separated by Source, the result includes one layer per active source.

Value type: Integer.

The default value is 0.

◆ PNGBits

str PNGBits = property(fget=__GetPNGBits, fset=__SetPNGBits)
static

Gets or sets the PNG Bits.

Prerequisite: The CameraMode property must be 1.

The values are:
0 - 8 Bits.
1 - 10 Bits.
2 - 12 Bits.
3 - 16 Bits.

Value type: Integer.

The default value is 3.

◆ RedGain

str RedGain = property(fget=__GetRedGain, fset=__SetRedGain)
static

Gets or sets the red gain.

Prerequisite: The WhiteBalanceMode property must be 2.

Value type: Double.

The default value is 1.0.

◆ SensitivityBlueSpectrumFilePath

str SensitivityBlueSpectrumFilePath = property(fget=__GetSensitivityBlueSpectrumFilePath, fset=__SetSensitivityBlueSpectrumFilePath)
static

Gets or sets the sensitivity blue spectrum file path.

Prerequisite: The ColorMode property must be 1.

Value type: String.

The default value is an empty file path (string).

◆ SensitivityGreenSpectrumFilePath

str SensitivityGreenSpectrumFilePath = property(fget=__GetSensitivityGreenSpectrumFilePath, fset=__SetSensitivityGreenSpectrumFilePath)
static

Gets or sets the sensitivity green spectrum file path.

Prerequisite: The ColorMode property must be 1.

Value type: String.

The default value is an empty file path (string).

◆ SensitivityMonochromaticSpectrumFilePath

str SensitivityMonochromaticSpectrumFilePath = property(fget=__GetSensitivityMonochromaticSpectrumFilePath, fset=__SetSensitivityMonochromaticSpectrumFilePath)
static

Gets or sets the sensitivity monochromatic spectrum file path.

Prerequisite: The ColorMode property must be 0.

Value type: String.

The default value is an empty file path (string).

◆ SensitivityRedSpectrumFilePath

str SensitivityRedSpectrumFilePath = property(fget=__GetSensitivityRedSpectrumFilePath, fset=__SetSensitivityRedSpectrumFilePath)
static

Gets or sets the sensitivity red spectrum file path.

Prerequisite: The ColorMode property must be 1.

Value type: String.

The default value is an empty file path (string).

◆ TransmittanceFilePath

str TransmittanceFilePath = property(fget=__GetTransmittanceFilePath, fset=__SetTransmittanceFilePath)
static

Gets or sets the transmittance file path.

Value type: String.

The default value is an empty file path (string).

◆ VerticalFOV

str VerticalFOV = property(fget=__GetVerticalFOV)
static

Gets the Vertical Field of View.

Value type: Double.

◆ VerticalPixels

str VerticalPixels = property(fget=__GetVerticalPixels, fset=__SetVerticalPixels)
static

Gets or sets the vertical pixels .

Defines the vertical pixels number corresponding to the camera resolution.

Value type: Integer.
Range: The value must be superior to 0.

The default value is 480.

◆ VisualizationRadius

str VisualizationRadius = property(fget=__GetVisualizationRadius, fset=__SetVisualizationRadius)
static

Gets or sets the Visualization radius.

Changes the radius of the Object field of the camera.

Value type: Double (in mm).
Range: The parameter must be superior to 0.0.

The default value is 1000.0 mm.

◆ WavelengthEnd

str WavelengthEnd = property(fget=__GetWavelengthEnd, fset=__SetWavelengthEnd)
static

Gets or sets the higher value of the wavelength range to be considered by the sensor.

Prerequisite: The CameraMode property must be 1.

The sensor does not take into account wavelengths beyond the borders that you define.

Value type: Double (in nm).

The default value is 700.0 nm.

◆ WavelengthResolution

str WavelengthResolution = property(fget=__GetWavelengthResolution)
static

Gets the Wavelength resolution.

Prerequisite: The CameraMode property must be 1.

Value type: Double.

◆ WavelengthSampling

str WavelengthSampling = property(fget=__GetWavelengthSampling, fset=__SetWavelengthSampling)
static

Gets or sets the wavelength sampling.

Prerequisite: The CameraMode property must be 1.

Value type: Integer.
Range: The value must be superior to 0.

The default value is 13.

◆ WavelengthStart

str WavelengthStart = property(fget=__GetWavelengthStart, fset=__SetWavelengthStart)
static

Gets or sets the lower value of the wavelength range to be considered by the sensor.

Prerequisite: The CameraMode property must be 1.

The sensor does not take into account wavelengths beyond the borders that you define.

Value type: Double (in nm).

The default value is 400.0 nm.

◆ WhiteBalanceBlueSpectrumFilePath

str WhiteBalanceBlueSpectrumFilePath = property(fget=__GetWhiteBalanceBlueSpectrumFilePath, fset=__SetWhiteBalanceBlueSpectrumFilePath)
static

Gets or sets the white balance blue spectrum file path.

Prerequisite: The WhiteBalanceMode property must be 3.

Value type: String.

The default value is an empty file path (string).

◆ WhiteBalanceGreenSpectrumFilePath

str WhiteBalanceGreenSpectrumFilePath = property(fget=__GetWhiteBalanceGreenSpectrumFilePath, fset=__SetWhiteBalanceGreenSpectrumFilePath)
static

Gets or sets the white balance green spectrum file path.

Prerequisite: The WhiteBalanceMode property must be 3.

Value type: String.

The default value is an empty file path (string).

◆ WhiteBalanceMode

str WhiteBalanceMode = property(fget=__GetWhiteBalanceMode, fset=__SetWhiteBalanceMode)
static

Gets or sets the white balance mode.

Prerequisite: The ColorMode property must be 1.

The values are:
0 - None.
1 - Grey World.
2 - Use White Balance.
3 - Display Primaries.

Value type: Integer.

The default value is 0.

◆ WhiteBalanceRedSpectrumFilePath

str WhiteBalanceRedSpectrumFilePath = property(fget=__GetWhiteBalanceRedSpectrumFilePath, fset=__SetWhiteBalanceRedSpectrumFilePath)
static

Gets or sets the white balance red spectrum file path.

Prerequisite: The WhiteBalanceMode property must be 3.

Value type: String.

The default value is an empty file path (string).

◆ Width

str Width = property(fget=__GetWidth, fset=__SetWidth)
static

Gets or sets the width .

Defines the sensor's width.

Value type: Double (in mm).
Range: The value must be superior to 0.

The default value is 5.0 mm.


The documentation for this class was generated from the following file:
  • SpeosNX_2412.py

Connect with Ansys