Class CameraParameters

Espacio de nombres: easyar

Parámetros de la cámara, incluyendo tamaño de imagen, distancia focal, punto principal, tipo de cámara y ángulo de rotación de la cámara relativo a la orientación natural del dispositivo.

CameraParameters

Constructores

CameraParameters

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)

Parámetros

Nombre	Tipo	Descripción
imageSize	Vec2I
focalLength	Vec2F
principalPoint	Vec2F
cameraDeviceType	CameraDeviceType
cameraOrientation	Int32

Métodos

size

Tamaño de imagen.

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

Devuelve

Tipo	Descripción
Vec2I

focalLength

Distancia focal. Distancia equivalente desde el centro óptico de la cámara al plano CCD dividida por la densidad de píxeles por unidad en las direcciones de ancho y alto. Unidad: píxeles.

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

Devuelve

Tipo	Descripción
Vec2F

principalPoint

Punto principal. Coordenadas de píxel desde la esquina superior izquierda de la imagen hasta la intersección del eje óptico principal en el plano CCD. Unidad: píxeles.

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

Devuelve

Tipo	Descripción
Vec2F

cameraModelType

Modelo de cámara.

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

Devuelve

Tipo	Descripción
CameraModelType

cameraDeviceType

Tipo de dispositivo de cámara. Predeterminada, cámara trasera o cámara delantera. Dispositivos de escritorio usan cámara predeterminada; dispositivos móviles distinguen entre cámara trasera y delantera.

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

Devuelve

Tipo	Descripción
CameraDeviceType

cameraOrientation

Ángulo de rotación en sentido horario requerido para mostrar la imagen de la cámara en la orientación natural del dispositivo. Rango: [0, 360). Teléfonos Android y algunas tablets Android: 90 grados. Gafas Android y algunas tablets Android: 0 grados. Dispositivos iOS existentes: 90 grados.

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

Devuelve

Tipo	Descripción
Int32

createWithDefaultIntrinsics

Crea CameraParameters con parámetros intrínsecos predeterminados. Los parámetros predeterminados (distancia focal, punto principal) se calculan automáticamente según el tamaño de imagen, pero no son extremadamente precisos.

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)

Parámetros

Nombre	Tipo	Descripción
imageSize	Vec2I
cameraDeviceType	CameraDeviceType
cameraOrientation	Int32

Devuelve

Tipo	Descripción
CameraParameters

tryCreateWithCustomIntrinsics

Crea CameraParameters con parámetros intrínsecos personalizados. Requiere especificar parámetros intrínsecos (distancia focal, punto principal, coeficientes de distorsión) y modelo de cámara. Los modelos soportados se refieren a CameraModelType. Nota: Use esta interfaz con precaución. Datos incorrectos pueden causar fallo en la creación del objeto, devolviendo vacío.

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)

Parámetros

Nombre	Tipo	Descripción
imageSize	Vec2I
cameraParamList	List<Single>
cameraModel	CameraModelType
cameraDeviceType	CameraDeviceType
cameraOrientation	Int32

Devuelve

Tipo	Descripción
Optional<>

getResized

Obtiene los CameraParameters equivalentes tras cambiar el tamaño de imagen de la cámara.

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)

Parámetros

Nombre	Tipo	Descripción
imageSize	Vec2I

Devuelve

Tipo	Descripción
CameraParameters

imageOrientation

Calcula el ángulo de rotación horaria necesario para alinear la imagen con la pantalla. screenRotation es el ángulo de rotación horaria de la imagen de pantalla relativo a la orientación natural. Para iOS:

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

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)

Parámetros

Nombre	Tipo	Descripción
screenRotation	Int32

Devuelve

Tipo	Descripción
Int32

imageHorizontalFlip

Calcula si la imagen necesita volteo horizontal. Al renderizar, primero se rota, luego se voltea. Cuando cameraDeviceType es cámara frontal, se voltea automáticamente. Sobre esto, manualHorizontalFlip puede aplicar un volteo manual adicional.

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)

Parámetros

Nombre	Tipo	Descripción
manualHorizontalFlip	Boolean

Devuelve

Tipo	Descripción
Boolean

projection

Calcula la matriz de proyección en perspectiva para renderizar objetos virtuales, transformando puntos del sistema de coordenadas de la cámara al espacio de recorte ([-1, 1]^4) (incluyendo rotación sobre el eje z). La forma de la matriz coincide con OpenGL: matriz multiplicada a la derecha por el vector columna de coordenadas homogéneas, no como Direct3D (izquierda). Los datos están en row-major, opuesto a column-major de OpenGL. Los sistemas de coordenadas de recorte y normalizado coinciden con OpenGL por defecto.

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)

Parámetros

Nombre	Tipo	Descripción
nearPlane	Single
farPlane	Single
viewportAspectRatio	Single
screenRotation	Int32
combiningFlip	Boolean
manualHorizontalFlip	Boolean

Devuelve

Tipo	Descripción
Matrix44F

imageProjection

Calcula la matriz de proyección ortogonal para renderizar imágenes de fondo de cámara, transformando puntos del sistema de coordenadas del rectángulo de imagen ([-1, 1]^2) al espacio de recorte ([-1, 1]^4) (incluyendo rotación sobre el eje z), manteniendo sin cambios las dimensiones no definidas. La forma de la matriz coincide con OpenGL: matriz multiplicada a la derecha por coordenadas homogéneas, no como Direct3D (izquierda). Los datos están en row-major, opuesto a column-major de OpenGL. Los sistemas de coordenadas de recorte y normalizado coinciden con OpenGL por defecto.

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)

Parámetros

Nombre	Tipo	Descripción
viewportAspectRatio	Single
screenRotation	Int32
combiningFlip	Boolean
manualHorizontalFlip	Boolean

Devuelve

Tipo	Descripción
Matrix44F

screenCoordinatesFromImageCoordinates

Transforma del sistema de coordenadas de imagen ([0, 1]^2) al sistema de coordenadas de pantalla ([0, 1]^2). Ambos sistemas tienen x hacia la derecha, y hacia abajo, origen en esquina superior izquierda.

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)

Parámetros

Nombre	Tipo	Descripción
viewportAspectRatio	Single
screenRotation	Int32
combiningFlip	Boolean
manualHorizontalFlip	Boolean
imageCoordinates	Vec2F

Devuelve

Tipo	Descripción
Vec2F

imageCoordinatesFromScreenCoordinates

Transforma del sistema de coordenadas de pantalla ([0, 1]^2) al sistema de coordenadas de imagen ([0, 1]^2). Ambos sistemas tienen x hacia la derecha, y hacia abajo, origen en esquina superior izquierda.

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)

Parámetros

Nombre	Tipo	Descripción
viewportAspectRatio	Single
screenRotation	Int32
combiningFlip	Boolean
manualHorizontalFlip	Boolean
screenCoordinates	Vec2F

Devuelve

Tipo	Descripción
Vec2F

equalsTo

Determina si dos conjuntos de parámetros son iguales.

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)

Parámetros

Nombre	Tipo	Descripción
other	CameraParameters

Devuelve

Tipo	Descripción
Boolean

Table of Contents

Class CameraParameters

Constructores

CameraParameters

Parámetros

Métodos

size

Devuelve

focalLength

Devuelve

principalPoint

Devuelve

cameraModelType

Devuelve

cameraDeviceType

Devuelve

cameraOrientation

Devuelve

createWithDefaultIntrinsics

Parámetros

Devuelve

tryCreateWithCustomIntrinsics

Parámetros

Devuelve

getResized

Parámetros

Devuelve

imageOrientation

Parámetros

Devuelve

imageHorizontalFlip

Parámetros

Devuelve

projection

Parámetros

Devuelve

imageProjection

Parámetros

Devuelve

screenCoordinatesFromImageCoordinates

Parámetros

Devuelve

imageCoordinatesFromScreenCoordinates

Parámetros

Devuelve

equalsTo

Parámetros

Devuelve