boofcv.alg.feature.detect.template.TemplateIntensityImage Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of boofcv-feature Show documentation
BoofCV is an open source Java library for real-time computer vision and robotics applications.
There is a newer version: 1.1.7
/*
 * Copyright (c) 2011-2019, 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.feature.detect.template;

import boofcv.alg.misc.GImageMiscOps;
import boofcv.struct.image.GrayF32;
import boofcv.struct.image.ImageBase;

/**
 * Class which computes the templates intensity across the entire image
 *
 * @author Peter Abeles
 */
public class TemplateIntensityImage>
		implements TemplateMatchingIntensity {
	// Match intensity image
	protected GrayF32 intensity = new GrayF32(1, 1);

	// references to the input
	protected T image;
	protected T template;
	protected T mask;

	// thickness of the border along the lower extents of the image
	protected int borderX0,borderY0;
	protected int borderX1,borderY1;

	protected EvaluatorMethod method;

	public TemplateIntensityImage(EvaluatorMethod method ) {
		this.method = method;
	}

	@Override
	public void setInputImage(T image) {
		this.image = image;
	}

	@Override
	public void process(T template) {
		this.template = template;
		this.mask = null;
		intensity.reshape(image.width, image.height);

		int w = image.width - template.width + 1;
		int h = image.height - template.height + 1;

		borderX0 = template.width / 2;
		borderY0 = template.height / 2;
		borderX1 = template.width-borderX0;
		borderY1 = template.height-borderY0;

		// set the outside border to the lowest possible score
		GImageMiscOps.fillBorder(intensity,0.0f,borderX0,borderY0,borderX1,borderY1);

		method.initialize(this);

		processInner(w, h);

		// deference to avoid causing a memory leak
		this.template = null;
		this.mask = null;
	}

	protected void processInner(int w, int h) {
		for (int y = 0; y < h; y++) {
			int index = intensity.startIndex + (y + borderY0) * intensity.stride + borderX0;
			for (int x = 0; x < w; x++) {
				intensity.data[index++] = method.evaluate(x, y);
			}
		}
	}

	@Override
	public void process(T template, T mask ) {
		if( mask == null ) {
			process(template);
			return;
		}

		this.template = template;
		this.mask = mask;
		intensity.reshape(image.width, image.height);

		int w = image.width - template.width + 1;
		int h = image.height - template.height + 1;

		borderX0 = template.width / 2;
		borderY0 = template.height / 2;
		borderX1 = template.width-borderX0;
		borderY1 = template.height-borderY0;

		method.initialize(this);

		processInnerMask(w, h);

		// deference to avoid causing a memory leak
		this.template = null;
		this.mask = null;
	}

	protected void processInnerMask(int w, int h) {
		for (int y = 0; y < h; y++) {
			int index = intensity.startIndex + (y + borderY0) * intensity.stride + borderX0;
			for (int x = 0; x < w; x++) {
				intensity.data[index++] = method.evaluateMask(x, y);
			}
		}
	}

	@Override
	public GrayF32 getIntensity() {
		return intensity;
	}

	@Override
	public int getBorderX0() {
		return borderX0;
	}

	@Override
	public int getBorderY0() {
		return borderY0;
	}

	@Override
	public int getBorderX1() {
		return borderX1;
	}

	@Override
	public int getBorderY1() {
		return borderY1;
	}

	@Override
	public boolean isMaximize() {
		return method.isMaximize();
	}

	@Override
	public boolean isBorderProcessed() {
		return method.isBorderProcessed();
	}

	public interface EvaluatorMethod> {
		void initialize( TemplateIntensityImage owner  );

		/**
		 * Evaluate the template at the specified location.
		 *
		 * @param tl_x Template's top left corner x-coordinate
		 * @param tl_y Template's top left corner y-coordinate
		 * @return match value with better matches having a more positive value
		 */
		float evaluate(int tl_x, int tl_y);

		/**
		 * Evaluate the masked template at the specified location.
		 *
		 * @param tl_x Template's top left corner x-coordinate
		 * @param tl_y Template's top left corner y-coordinate
		 * @return match value with better matches having a more positive value
		 */
		float evaluateMask(int tl_x, int tl_y);

		boolean isMaximize();

		boolean isBorderProcessed();
	}
}