Class CameraParameters

命名空間

easyar

相機參數，包括影像大小、焦距、主點、相機類型和相機相對裝置自然方向的旋轉角度。

CameraParameters

建構函式

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)

參數

名稱	類型	描述
imageSize	Vec2I
focalLength	Vec2F
principalPoint	Vec2F
cameraDeviceType	CameraDeviceType
cameraOrientation	Int32

方法

size

影像大小。

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

傳回值

類型	描述
Vec2I

focalLength

焦距。相機的等效光心到CCD平面的距離除以寬高兩個方向的單位像素密度。單位為像素。

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

傳回值

類型	描述
Vec2F

principalPoint

主點。相機的主光軸在CCD平面上的交點到影像左上角的像素座標。單位為像素。

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

傳回值

類型	描述
Vec2F

cameraModelType

相機模型。

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

傳回值

類型	描述
CameraModelType

cameraDeviceType

相機裝置類型。預設camera、後置camera或前置camera。桌面裝置均為預設camera，行動裝置區分後置camera和前置camera。

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

傳回值

類型	描述
CameraDeviceType

cameraOrientation

camera影像在裝置的自然方向上顯示時需要順時針旋轉的角度。範圍為[0, 360)。 Android手機和部分Android平板為90度。 Android眼鏡和部分Android平板為0度。 現有iOS裝置均為90度。

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

傳回值

類型	描述
Int32

createWithDefaultIntrinsics

以預設相機內參建立CameraParameters。預設相機內參（焦距、主點）根據影像大小自動計算，但並非特別準確。

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

參數

名稱	類型	描述
imageSize	Vec2I
cameraDeviceType	CameraDeviceType
cameraOrientation	Int32

傳回值

類型	描述
CameraParameters

tryCreateWithCustomIntrinsics

使用自訂相機內參建立CameraParameters。需指定相機內參（焦距、主點、畸變係數）以及相機模型。相機模型支援參考CameraModelType。 注意: 謹慎使用該介面，輸入資料錯誤可能導致建立物件失敗，傳回為空。

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

參數

名稱	類型	描述
imageSize	Vec2I
cameraParamList	List<Single>
cameraModel	CameraModelType
cameraDeviceType	CameraDeviceType
cameraOrientation	Int32

傳回值

類型	描述
Optional<>

getResized

取得相機影像大小改變後的等效CameraParameters。

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

參數

名稱	類型	描述
imageSize	Vec2I

傳回值

類型	描述
CameraParameters

imageOrientation

計算影像需要相對於螢幕進行順時針旋轉以和螢幕對齊所需要的角度。 screenRotation為螢幕影像相對於自然方向順時針旋轉的角度。 對於iOS，有

• UIInterfaceOrientationPortrait: screenRotation = 0
• UIInterfaceOrientationLandscapeRight: screenRotation = 90
• UIInterfaceOrientationPortraitUpsideDown: screenRotation = 180
• UIInterfaceOrientationLandscapeLeft: screenRotation = 270 對於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)

參數

名稱	類型	描述
screenRotation	Int32

傳回值

類型	描述
Int32

imageHorizontalFlip

計算影像是否需要左右翻轉。影像渲染時，先進行旋轉，再進行翻轉。當cameraDeviceType為前置鏡頭時，會自動進行翻轉，可在此基礎上，傳入manualHorizontalFlip再疊加一次手動翻轉。

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

參數

名稱	類型	描述
manualHorizontalFlip	Boolean

傳回值

類型	描述
Boolean

projection

計算渲染虛擬物體所需的透視投影矩陣，將camera座標系下的點變換到剪裁座標系（[-1, 1]^4）中（包括繞z軸的旋轉）。透視投影矩陣的形式和OpenGL相同，為矩陣右邊乘以點的齊次座標的行向量，而非Direct3D的矩陣左邊乘以點的齊次座標的行向量。但資料的排列方式為row-major，與OpenGL的column-major相反。剪裁座標系和單位化裝置座標系的定義與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)

參數

名稱	類型	描述
nearPlane	Single
farPlane	Single
viewportAspectRatio	Single
screenRotation	Int32
combiningFlip	Boolean
manualHorizontalFlip	Boolean

傳回值

類型	描述
Matrix44F

imageProjection

計算渲染攝影機背景影像所需的正交投影矩陣，將影像矩形座標系下（[-1, 1]^2）的點變換到剪裁座標系（[-1, 1]^4）中（包括繞z軸的旋轉），未定義的兩維保持不變。正交投影矩陣的形式和OpenGL相同，為矩陣右邊乘以點的齊次座標，而非Direct3D的矩陣左邊乘以點的齊次座標。但資料的排列方式為row-major，與OpenGL的column-major相反。剪裁座標系和單位化裝置座標系的定義與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)

參數

名稱	類型	描述
viewportAspectRatio	Single
screenRotation	Int32
combiningFlip	Boolean
manualHorizontalFlip	Boolean

傳回值

類型	描述
Matrix44F

screenCoordinatesFromImageCoordinates

從影像座標系（[0, 1]^2）變換到螢幕座標系（[0, 1]^2），兩個座標系均x朝右、y朝下，原點在左上角。

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

參數

名稱	類型	描述
viewportAspectRatio	Single
screenRotation	Int32
combiningFlip	Boolean
manualHorizontalFlip	Boolean
imageCoordinates	Vec2F

傳回值

類型	描述
Vec2F

imageCoordinatesFromScreenCoordinates

從螢幕座標系（[0, 1]^2）變換到影像座標系（[0, 1]^2），兩個座標系均x朝右、y朝下，原點在左上角。

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

參數

名稱	類型	描述
viewportAspectRatio	Single
screenRotation	Int32
combiningFlip	Boolean
manualHorizontalFlip	Boolean
screenCoordinates	Vec2F

傳回值

類型	描述
Vec2F

equalsTo

判斷兩組參數是否相等。

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

參數

名稱	類型	描述
other	CameraParameters

傳回值

類型	描述
Boolean