boofcv.alg.geo.calibration.cameras.Zhang99CameraUniversalOmni Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of boofcv-geo Show documentation

BoofCV is an open source Java library for real-time computer vision and robotics applications.

There is a newer version: 1.1.5

/*
 * Copyright (c) 2023, Peter Abeles. All Rights Reserved.
 *
 * This file is part of BoofCV (http://boofcv.org).
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package boofcv.alg.geo.calibration.cameras;

import boofcv.abst.geo.bundle.BundleAdjustmentCamera;
import boofcv.alg.geo.bundle.cameras.BundleUniversalOmni;
import boofcv.alg.geo.calibration.CalibrationObservation;
import boofcv.alg.geo.calibration.RadialDistortionEstimateLinear;
import boofcv.struct.calib.CameraModel;
import boofcv.struct.calib.CameraUniversalOmni;
import georegression.struct.point.Point2D_F64;
import org.ejml.data.DMatrixRMaj;

import java.util.List;

/**
 * Camera parameters for model {@link CameraUniversalOmni}.
 *
 * @author Peter Abeles
 */
public class Zhang99CameraUniversalOmni implements Zhang99Camera {
	boolean assumeZeroSkew;
	boolean includeTangential;
	public boolean fixedMirror;
	double mirror;

	private final RadialDistortionEstimateLinear computeRadial;

	/**
	 * Constructor where mirror offset is assumed to be known
	 */
	public Zhang99CameraUniversalOmni( boolean assumeZeroSkew, boolean includeTangential, int numRadial, double mirror ) {
		this(assumeZeroSkew, includeTangential, numRadial);
		this.fixedMirror = true;
		this.mirror = mirror;
	}

	/**
	 * Constructor where mirror offset is assumed to be unknown
	 */
	public Zhang99CameraUniversalOmni( boolean assumeZeroSkew, boolean includeTangential, int numRadial ) {
		this.assumeZeroSkew = assumeZeroSkew;
		this.includeTangential = includeTangential;
		this.fixedMirror = false;
		computeRadial = new RadialDistortionEstimateLinear(numRadial);
	}

	@Override public void setLayouts( List> layouts ) {
		computeRadial.setLayouts(layouts);
	}

	@Override public BundleAdjustmentCamera initializeCamera(
			DMatrixRMaj K, List homographies, List observations ) {
		computeRadial.process(K, homographies, observations);
		double[] radial = computeRadial.getParameters();

		BundleUniversalOmni cam = new BundleUniversalOmni(assumeZeroSkew, radial.length, includeTangential, fixedMirror);
		System.arraycopy(radial, 0, cam.radial, 0, radial.length);
		cam.setK(K);
		if (fixedMirror)
			cam.mirrorOffset = mirror;
		else
			cam.mirrorOffset = 0; // paper recommends 1. Doesn't seem to make a difference
		cam.t1 = cam.t2 = 0;
		return cam;
	}

	@Override
	public CameraModel getCameraModel( BundleAdjustmentCamera bundleCam ) {
		var cam = (BundleUniversalOmni)bundleCam;
		var out = new CameraUniversalOmni(cam.radial.length);
		cam.convert(out);
		return out;
	}
}