Class CameraParameters

Espace de noms

easyar

Paramètres de la caméra, incluant la taille d'image, la distance focale, le point principal, le type de caméra et l'angle de rotation de la caméra par rapport à l'orientation naturelle de l'appareil.

CameraParameters

Constructeurs

CameraParameters

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_CameraParameters__ctor(easyar_Vec2I imageSize, easyar_Vec2F focalLength, easyar_Vec2F principalPoint, easyar_CameraDeviceType cameraDeviceType, int cameraOrientation, easyar_CameraParameters * * Return)

CameraParameters(Vec2I imageSize, Vec2F focalLength, Vec2F principalPoint, CameraDeviceType cameraDeviceType, int cameraOrientation)

public CameraParameters(@Nonnull Vec2I imageSize, @Nonnull Vec2F focalLength, @Nonnull Vec2F principalPoint, int cameraDeviceType, int cameraOrientation)

constructor(imageSize: Vec2I, focalLength: Vec2F, principalPoint: Vec2F, cameraDeviceType: Int, cameraOrientation: Int)

+ (easyar_CameraParameters *) create:(easyar_Vec2I *)imageSize focalLength:(easyar_Vec2F *)focalLength principalPoint:(easyar_Vec2F *)principalPoint cameraDeviceType:(easyar_CameraDeviceType)cameraDeviceType cameraOrientation:(int)cameraOrientation

public convenience init(_ imageSize: Vec2I, _ focalLength: Vec2F, _ principalPoint: Vec2F, _ cameraDeviceType: CameraDeviceType, _ cameraOrientation: Int32)

public CameraParameters(Vec2I imageSize, Vec2F focalLength, Vec2F principalPoint, CameraDeviceType cameraDeviceType, int cameraOrientation)

Paramètres

Nom	Type	Description
imageSize	Vec2I
focalLength	Vec2F
principalPoint	Vec2F
cameraDeviceType	CameraDeviceType
cameraOrientation	Int32

Méthodes

size

Taille de l'image

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

easyar_Vec2I easyar_CameraParameters_size(const easyar_CameraParameters * This)

Vec2I size()

public @Nonnull Vec2I size()

fun size(): Vec2I

- (easyar_Vec2I *)size

public func size() -> Vec2I

public virtual Vec2I size()

Retours

Type	Description
Vec2I

focalLength

Distance focale. Distance du plan CCD au centre optique équivalent de l'appareil photo, divisée par la densité de pixels unitaire dans les directions de largeur et hauteur. Unité en pixels.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

easyar_Vec2F easyar_CameraParameters_focalLength(const easyar_CameraParameters * This)

Vec2F focalLength()

public @Nonnull Vec2F focalLength()

fun focalLength(): Vec2F

- (easyar_Vec2F *)focalLength

public func focalLength() -> Vec2F

public virtual Vec2F focalLength()

Retours

Type	Description
Vec2F

principalPoint

Point principal. Coordonnées en pixels du point d'intersection de l'axe optique principal de la caméra avec le plan CCD, par rapport au coin supérieur gauche de l'image. Unité : pixels.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

easyar_Vec2F easyar_CameraParameters_principalPoint(const easyar_CameraParameters * This)

Vec2F principalPoint()

public @Nonnull Vec2F principalPoint()

fun principalPoint(): Vec2F

- (easyar_Vec2F *)principalPoint

public func principalPoint() -> Vec2F

public virtual Vec2F principalPoint()

Retours

Type	Description
Vec2F

cameraModelType

Modèle d'appareil photo.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

easyar_CameraModelType easyar_CameraParameters_cameraModelType(const easyar_CameraParameters * This)

CameraModelType cameraModelType()

public int cameraModelType()

fun cameraModelType(): Int

- (easyar_CameraModelType)cameraModelType

public func cameraModelType() -> CameraModelType

public virtual CameraModelType cameraModelType()

Retours

Type	Description
CameraModelType

cameraDeviceType

Type d'appareil photo. Par défaut camera, camera arrière ou camera avant. Les appareils de bureau sont tous des camera par défaut, tandis que les appareils mobiles distinguent les camera arrière et camera avant.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

easyar_CameraDeviceType easyar_CameraParameters_cameraDeviceType(const easyar_CameraParameters * This)

CameraDeviceType cameraDeviceType()

public int cameraDeviceType()

fun cameraDeviceType(): Int

- (easyar_CameraDeviceType)cameraDeviceType

public func cameraDeviceType() -> CameraDeviceType

public virtual CameraDeviceType cameraDeviceType()

Retours

Type	Description
CameraDeviceType

cameraOrientation

L'angle de rotation horaire nécessaire pour afficher l'image de la caméra dans l'orientation naturelle de l'appareil. La plage est [0, 360). Les téléphones Android et certaines tablettes Android affichent 90 degrés. Les lunettes Android et certaines tablettes Android affichent 0 degré. Les appareils iOS existants affichent tous 90 degrés.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

int easyar_CameraParameters_cameraOrientation(const easyar_CameraParameters * This)

int cameraOrientation()

public int cameraOrientation()

fun cameraOrientation(): Int

- (int)cameraOrientation

public func cameraOrientation() -> Int32

public virtual int cameraOrientation()

Retours

Type	Description
Int32

createWithDefaultIntrinsics

Création de CameraParameters avec les paramètres intrinsèques par défaut. Les paramètres intrinsèques par défaut (distance focale, point principal) sont calculés automatiquement en fonction de la taille de l'image, mais ne sont pas particulièrement précis.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_CameraParameters_createWithDefaultIntrinsics(easyar_Vec2I imageSize, easyar_CameraDeviceType cameraDeviceType, int cameraOrientation, easyar_CameraParameters * * Return)

static std::shared_ptr<CameraParameters> createWithDefaultIntrinsics(Vec2I imageSize, CameraDeviceType cameraDeviceType, int cameraOrientation)

public static @Nonnull CameraParameters createWithDefaultIntrinsics(@Nonnull Vec2I imageSize, int cameraDeviceType, int cameraOrientation)

companion object fun createWithDefaultIntrinsics(imageSize: Vec2I, cameraDeviceType: Int, cameraOrientation: Int): CameraParameters

+ (easyar_CameraParameters *)createWithDefaultIntrinsics:(easyar_Vec2I *)imageSize cameraDeviceType:(easyar_CameraDeviceType)cameraDeviceType cameraOrientation:(int)cameraOrientation

public static func createWithDefaultIntrinsics(_ imageSize: Vec2I, _ cameraDeviceType: CameraDeviceType, _ cameraOrientation: Int32) -> CameraParameters

public static CameraParameters createWithDefaultIntrinsics(Vec2I imageSize, CameraDeviceType cameraDeviceType, int cameraOrientation)

Paramètres

Nom	Type	Description
imageSize	Vec2I
cameraDeviceType	CameraDeviceType
cameraOrientation	Int32

Retours

Type	Description
CameraParameters

tryCreateWithCustomIntrinsics

Création de CameraParameters avec des paramètres intrinsèques personnalisés. Il est nécessaire de spécifier les paramètres intrinsèques de la caméra (focale, point principal, coefficients de distorsion) ainsi que le modèle de caméra. Les modèles de caméra pris en charge sont référencés dans CameraModelType. Remarque : Utilisez cette interface avec prudence. Des données d'entrée incorrectes peuvent entraîner un échec de la création de l'objet et retourner vide.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_CameraParameters_tryCreateWithCustomIntrinsics(easyar_Vec2I imageSize, easyar_ListOfFloat * cameraParamList, easyar_CameraModelType cameraModel, easyar_CameraDeviceType cameraDeviceType, int cameraOrientation, easyar_OptionalOfCameraParameters * Return)

static std::optional<std::shared_ptr<CameraParameters>> tryCreateWithCustomIntrinsics(Vec2I imageSize, std::vector<float> cameraParamList, CameraModelType cameraModel, CameraDeviceType cameraDeviceType, int cameraOrientation)

public static @Nullable CameraParameters tryCreateWithCustomIntrinsics(@Nonnull Vec2I imageSize, java.util.@Nonnull ArrayList<java.lang.@Nonnull Float> cameraParamList, int cameraModel, int cameraDeviceType, int cameraOrientation)

companion object fun tryCreateWithCustomIntrinsics(imageSize: Vec2I, cameraParamList: ArrayList<Float>, cameraModel: Int, cameraDeviceType: Int, cameraOrientation: Int): CameraParameters?

+ (easyar_CameraParameters *)tryCreateWithCustomIntrinsics:(easyar_Vec2I *)imageSize cameraParamList:(NSArray<NSNumber *> *)cameraParamList cameraModel:(easyar_CameraModelType)cameraModel cameraDeviceType:(easyar_CameraDeviceType)cameraDeviceType cameraOrientation:(int)cameraOrientation

public static func tryCreateWithCustomIntrinsics(_ imageSize: Vec2I, _ cameraParamList: [Float], _ cameraModel: CameraModelType, _ cameraDeviceType: CameraDeviceType, _ cameraOrientation: Int32) -> CameraParameters?

public static Optional<CameraParameters> tryCreateWithCustomIntrinsics(Vec2I imageSize, List<float> cameraParamList, CameraModelType cameraModel, CameraDeviceType cameraDeviceType, int cameraOrientation)

Paramètres

Nom	Type	Description
imageSize	Vec2I
cameraParamList	List<Single>
cameraModel	CameraModelType
cameraDeviceType	CameraDeviceType
cameraOrientation	Int32

Retours

Type	Description
Optional<>

getResized

Obtenir les paramètres de caméra équivalents après le changement de taille de l'image.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

void easyar_CameraParameters_getResized(easyar_CameraParameters * This, easyar_Vec2I imageSize, easyar_CameraParameters * * Return)

std::shared_ptr<CameraParameters> getResized(Vec2I imageSize)

public @Nonnull CameraParameters getResized(@Nonnull Vec2I imageSize)

fun getResized(imageSize: Vec2I): CameraParameters

- (easyar_CameraParameters *)getResized:(easyar_Vec2I *)imageSize

public func getResized(_ imageSize: Vec2I) -> CameraParameters

public virtual CameraParameters getResized(Vec2I imageSize)

Paramètres

Nom	Type	Description
imageSize	Vec2I

Retours

Type	Description
CameraParameters

imageOrientation

Calculer l'angle de rotation horaire requis pour aligner l'image avec l'écran. screenRotation est l'angle de rotation horaire de l'image de l'écran par rapport à son orientation naturelle. Pour iOS :

• UIInterfaceOrientationPortrait : screenRotation = 0
• UIInterfaceOrientationLandscapeRight : screenRotation = 90
• UIInterfaceOrientationPortraitUpsideDown : screenRotation = 180
• UIInterfaceOrientationLandscapeLeft : screenRotation = 270 Pour Android :
• Surface.ROTATION_0 : screenRotation = 0
• Surface.ROTATION_90 : screenRotation = 90
• Surface.ROTATION_180 : screenRotation = 180
• Surface.ROTATION_270 : screenRotation = 270

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

int easyar_CameraParameters_imageOrientation(const easyar_CameraParameters * This, int screenRotation)

int imageOrientation(int screenRotation)

public int imageOrientation(int screenRotation)

fun imageOrientation(screenRotation: Int): Int

- (int)imageOrientation:(int)screenRotation

public func imageOrientation(_ screenRotation: Int32) -> Int32

public virtual int imageOrientation(int screenRotation)

Paramètres

Nom	Type	Description
screenRotation	Int32

Retours

Type	Description
Int32

imageHorizontalFlip

Déterminer si l'image nécessite un retournement horizontal gauche-droite. Lors du rendu de l'image, la rotation est effectuée en premier, suivie du retournement. Lorsque le cameraDeviceType est une caméra frontale, un retournement automatique est effectué. Sur cette base, un retournement horizontal manuel (manualHorizontalFlip) peut être appliqué en supplément.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

bool easyar_CameraParameters_imageHorizontalFlip(const easyar_CameraParameters * This, bool manualHorizontalFlip)

bool imageHorizontalFlip(bool manualHorizontalFlip)

public boolean imageHorizontalFlip(boolean manualHorizontalFlip)

fun imageHorizontalFlip(manualHorizontalFlip: Boolean): Boolean

- (bool)imageHorizontalFlip:(bool)manualHorizontalFlip

public func imageHorizontalFlip(_ manualHorizontalFlip: Bool) -> Bool

public virtual bool imageHorizontalFlip(bool manualHorizontalFlip)

Paramètres

Nom	Type	Description
manualHorizontalFlip	Boolean

Retours

Type	Description
Boolean

projection

Calculer la matrice de projection en perspective nécessaire pour rendre un objet virtuel, transformant les points du système de coordonnées de la caméra vers le système de coordonnées de découpage ([-1, 1]^4) (incluant la rotation autour de l'axe z). La forme de la matrice de projection en perspective est la même que dans OpenGL, c'est-à-dire que la matrice est multipliée à droite par le vecteur colonne des coordonnées homogènes du point, et non comme dans Direct3D où la matrice est multipliée à gauche par le vecteur colonne des coordonnées homogènes du point. Cependant, la disposition des données est row-major, contrairement au column-major d'OpenGL. Les définitions du système de coordonnées de découpage et du système de coordonnées normalisées de périphérique sont identiques à celles par défaut d'OpenGL.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

easyar_Matrix44F easyar_CameraParameters_projection(const easyar_CameraParameters * This, float nearPlane, float farPlane, float viewportAspectRatio, int screenRotation, bool combiningFlip, bool manualHorizontalFlip)

Matrix44F projection(float nearPlane, float farPlane, float viewportAspectRatio, int screenRotation, bool combiningFlip, bool manualHorizontalFlip)

public @Nonnull Matrix44F projection(float nearPlane, float farPlane, float viewportAspectRatio, int screenRotation, boolean combiningFlip, boolean manualHorizontalFlip)

fun projection(nearPlane: Float, farPlane: Float, viewportAspectRatio: Float, screenRotation: Int, combiningFlip: Boolean, manualHorizontalFlip: Boolean): Matrix44F

- (easyar_Matrix44F *)projection:(float)nearPlane farPlane:(float)farPlane viewportAspectRatio:(float)viewportAspectRatio screenRotation:(int)screenRotation combiningFlip:(bool)combiningFlip manualHorizontalFlip:(bool)manualHorizontalFlip

public func projection(_ nearPlane: Float, _ farPlane: Float, _ viewportAspectRatio: Float, _ screenRotation: Int32, _ combiningFlip: Bool, _ manualHorizontalFlip: Bool) -> Matrix44F

public virtual Matrix44F projection(float nearPlane, float farPlane, float viewportAspectRatio, int screenRotation, bool combiningFlip, bool manualHorizontalFlip)

Paramètres

Nom	Type	Description
nearPlane	Single
farPlane	Single
viewportAspectRatio	Single
screenRotation	Int32
combiningFlip	Boolean
manualHorizontalFlip	Boolean

Retours

Type	Description
Matrix44F

imageProjection

Calculer la matrice de projection orthographique nécessaire pour afficher l'image d'arrière-plan de la caméra, transformant les points du système de coordonnées rectangulaires de l'image ([-1, 1]²) vers le système de coordonnées de découpage ([-1, 1]⁴) (incluant la rotation autour de l'axe z), les deux dimensions non définies restant inchangées. La forme de la matrice de projection orthographique est la même que dans OpenGL, multipliant les coordonnées homogènes du point à droite par la matrice, et non comme dans Direct3D où la matrice multiplie les coordonnées homogènes du point à gauche. Cependant, l'arrangement des données est row-major, à l'opposé du column-major d'OpenGL. Les définitions du système de coordonnées de découpage et du système de coordonnées de périphérique normalisé sont identiques à celles par défaut d'OpenGL.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

easyar_Matrix44F easyar_CameraParameters_imageProjection(const easyar_CameraParameters * This, float viewportAspectRatio, int screenRotation, bool combiningFlip, bool manualHorizontalFlip)

Matrix44F imageProjection(float viewportAspectRatio, int screenRotation, bool combiningFlip, bool manualHorizontalFlip)

public @Nonnull Matrix44F imageProjection(float viewportAspectRatio, int screenRotation, boolean combiningFlip, boolean manualHorizontalFlip)

fun imageProjection(viewportAspectRatio: Float, screenRotation: Int, combiningFlip: Boolean, manualHorizontalFlip: Boolean): Matrix44F

- (easyar_Matrix44F *)imageProjection:(float)viewportAspectRatio screenRotation:(int)screenRotation combiningFlip:(bool)combiningFlip manualHorizontalFlip:(bool)manualHorizontalFlip

public func imageProjection(_ viewportAspectRatio: Float, _ screenRotation: Int32, _ combiningFlip: Bool, _ manualHorizontalFlip: Bool) -> Matrix44F

public virtual Matrix44F imageProjection(float viewportAspectRatio, int screenRotation, bool combiningFlip, bool manualHorizontalFlip)

Paramètres

Nom	Type	Description
viewportAspectRatio	Single
screenRotation	Int32
combiningFlip	Boolean
manualHorizontalFlip	Boolean

Retours

Type	Description
Matrix44F

screenCoordinatesFromImageCoordinates

Transformation du système de coordonnées d'image ([0, 1]^2) vers le système de coordonnées d'écran ([0, 1]^2). Les deux systèmes ont l'axe x orienté vers la droite et l'axe y orienté vers le bas, avec l'origine dans le coin supérieur gauche.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

easyar_Vec2F easyar_CameraParameters_screenCoordinatesFromImageCoordinates(const easyar_CameraParameters * This, float viewportAspectRatio, int screenRotation, bool combiningFlip, bool manualHorizontalFlip, easyar_Vec2F imageCoordinates)

Vec2F screenCoordinatesFromImageCoordinates(float viewportAspectRatio, int screenRotation, bool combiningFlip, bool manualHorizontalFlip, Vec2F imageCoordinates)

public @Nonnull Vec2F screenCoordinatesFromImageCoordinates(float viewportAspectRatio, int screenRotation, boolean combiningFlip, boolean manualHorizontalFlip, @Nonnull Vec2F imageCoordinates)

fun screenCoordinatesFromImageCoordinates(viewportAspectRatio: Float, screenRotation: Int, combiningFlip: Boolean, manualHorizontalFlip: Boolean, imageCoordinates: Vec2F): Vec2F

- (easyar_Vec2F *)screenCoordinatesFromImageCoordinates:(float)viewportAspectRatio screenRotation:(int)screenRotation combiningFlip:(bool)combiningFlip manualHorizontalFlip:(bool)manualHorizontalFlip imageCoordinates:(easyar_Vec2F *)imageCoordinates

public func screenCoordinatesFromImageCoordinates(_ viewportAspectRatio: Float, _ screenRotation: Int32, _ combiningFlip: Bool, _ manualHorizontalFlip: Bool, _ imageCoordinates: Vec2F) -> Vec2F

public virtual Vec2F screenCoordinatesFromImageCoordinates(float viewportAspectRatio, int screenRotation, bool combiningFlip, bool manualHorizontalFlip, Vec2F imageCoordinates)

Paramètres

Nom	Type	Description
viewportAspectRatio	Single
screenRotation	Int32
combiningFlip	Boolean
manualHorizontalFlip	Boolean
imageCoordinates	Vec2F

Retours

Type	Description
Vec2F

imageCoordinatesFromScreenCoordinates

Transformation du système de coordonnées d'écran ([0, 1]^2) vers le système de coordonnées d'image ([0, 1]^2). Les deux systèmes ont x vers la droite et y vers le bas, avec l'origine dans le coin supérieur gauche.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

easyar_Vec2F easyar_CameraParameters_imageCoordinatesFromScreenCoordinates(const easyar_CameraParameters * This, float viewportAspectRatio, int screenRotation, bool combiningFlip, bool manualHorizontalFlip, easyar_Vec2F screenCoordinates)

Vec2F imageCoordinatesFromScreenCoordinates(float viewportAspectRatio, int screenRotation, bool combiningFlip, bool manualHorizontalFlip, Vec2F screenCoordinates)

public @Nonnull Vec2F imageCoordinatesFromScreenCoordinates(float viewportAspectRatio, int screenRotation, boolean combiningFlip, boolean manualHorizontalFlip, @Nonnull Vec2F screenCoordinates)

fun imageCoordinatesFromScreenCoordinates(viewportAspectRatio: Float, screenRotation: Int, combiningFlip: Boolean, manualHorizontalFlip: Boolean, screenCoordinates: Vec2F): Vec2F

- (easyar_Vec2F *)imageCoordinatesFromScreenCoordinates:(float)viewportAspectRatio screenRotation:(int)screenRotation combiningFlip:(bool)combiningFlip manualHorizontalFlip:(bool)manualHorizontalFlip screenCoordinates:(easyar_Vec2F *)screenCoordinates

public func imageCoordinatesFromScreenCoordinates(_ viewportAspectRatio: Float, _ screenRotation: Int32, _ combiningFlip: Bool, _ manualHorizontalFlip: Bool, _ screenCoordinates: Vec2F) -> Vec2F

public virtual Vec2F imageCoordinatesFromScreenCoordinates(float viewportAspectRatio, int screenRotation, bool combiningFlip, bool manualHorizontalFlip, Vec2F screenCoordinates)

Paramètres

Nom	Type	Description
viewportAspectRatio	Single
screenRotation	Int32
combiningFlip	Boolean
manualHorizontalFlip	Boolean
screenCoordinates	Vec2F

Retours

Type	Description
Vec2F

equalsTo

Déterminer si deux ensembles de paramètres sont égaux.

• c
• cpp
• java
• kotlin
• objective-c
• swift
• csharp

bool easyar_CameraParameters_equalsTo(const easyar_CameraParameters * This, easyar_CameraParameters * other)

bool equalsTo(std::shared_ptr<CameraParameters> other)

public boolean equalsTo(@Nonnull CameraParameters other)

fun equalsTo(other: CameraParameters): Boolean

- (bool)equalsTo:(easyar_CameraParameters *)other

public func equalsTo(_ other: CameraParameters) -> Bool

public virtual bool equalsTo(CameraParameters other)

Paramètres

Nom	Type	Description
other	CameraParameters

Retours

Type	Description
Boolean