/*
* $RCSfile: MlibConvolveRIF.java,v $
*
* Copyright (c) 2005 Sun Microsystems, Inc. All rights reserved.
*
* Use is subject to license terms.
*
* $Revision: 1.2 $
* $Date: 2005/08/15 22:17:03 $
* $State: Exp $
*/
package com.lightcrafts.media.jai.mlib;
import java.awt.RenderingHints;
import java.awt.image.RenderedImage;
import java.awt.image.renderable.ParameterBlock;
import java.awt.image.renderable.RenderedImageFactory;
import com.lightcrafts.mediax.jai.BorderExtender;
import com.lightcrafts.mediax.jai.ImageLayout;
import com.lightcrafts.mediax.jai.KernelJAI;
import com.lightcrafts.media.jai.opimage.RIFUtil;
/**
* A <code>RIF</code> supporting the "Convolve" operation in the
* rendered image mode using MediaLib.
*
* @see com.lightcrafts.mediax.jai.operator.ConvolveDescriptor
* @see MlibConvolveOpImage
*/
public class MlibConvolveRIF implements RenderedImageFactory {
/** Constructor. */
public MlibConvolveRIF() {}
/**
* Creates a new instance of <code>MlibConvolveOpImage</code> in
* the rendered image mode.
*
* @param args The source image and convolution kernel.
* @param hints May contain rendering hints and destination image layout.
*/
public RenderedImage create(ParameterBlock args,
RenderingHints hints) {
// Get ImageLayout and TileCache from RenderingHints.
ImageLayout layout = RIFUtil.getImageLayoutHint(hints);
if (!MediaLibAccessor.isMediaLibCompatible(args, layout) ||
!MediaLibAccessor.hasSameNumBands(args, layout)) {
return null;
}
// Get BorderExtender from hints if any.
BorderExtender extender = RIFUtil.getBorderExtenderHint(hints);
RenderedImage source = args.getRenderedSource(0);
KernelJAI unRotatedKernel = (KernelJAI)args.getObjectParameter(0);
KernelJAI kJAI = unRotatedKernel.getRotatedKernel();
int kWidth = kJAI.getWidth();
int kHeight = kJAI.getHeight();
// mediaLib does not handle kernels with either dimension < 2.
if (kWidth < 2 || kHeight < 2) {
return null;
}
if (kJAI.isSeparable() && (kWidth == kHeight) &&
(kWidth == 3 || kWidth == 5 || kWidth == 7)) {
return new MlibSeparableConvolveOpImage(source,
extender, hints, layout,
kJAI);
} else if ((kWidth == kHeight) &&
(kWidth == 2 || kWidth == 3 || kWidth == 4 ||
kWidth == 5 || kWidth == 7)) {
return new MlibConvolveNxNOpImage(source,
extender, hints, layout,
kJAI);
} else {
return new MlibConvolveOpImage(source,
extender, hints, layout,
kJAI);
}
}
}