/* JHOVE2 - Next-generation architecture for format-aware characterization
*
* Copyright (c) 2009 by The Regents of the University of California,
* Ithaka Harbors, Inc., and The Board of Trustees of the Leland Stanford
* Junior University.
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are met:
*
* o Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
*
* o Redistributions in binary form must reproduce the above copyright notice,
* this list of conditions and the following disclaimer in the documentation
* and/or other materials provided with the distribution.
*
* o Neither the name of the University of California/California Digital
* Library, Ithaka Harbors/Portico, or Stanford University, nor the names of
* its contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
package org.jhove2.module.format.icc.profile;
import java.util.ArrayList;
import java.util.Iterator;
import java.util.List;
import org.jhove2.annotation.ReportableProperty;
import org.jhove2.core.JHOVE2;
import org.jhove2.core.JHOVE2Exception;
import org.jhove2.core.Message;
import org.jhove2.core.Message.Context;
import org.jhove2.core.Message.Severity;
import org.jhove2.core.format.Format;
import org.jhove2.core.io.Input;
import org.jhove2.core.source.Source;
import org.jhove2.module.format.AbstractFormatProfile;
import org.jhove2.module.format.Validator;
import org.jhove2.module.format.icc.ICCHeader;
import org.jhove2.module.format.icc.ICCModule;
import org.jhove2.module.format.icc.ICCTag;
import org.jhove2.module.format.icc.ICCTagTable;
import org.jhove2.persist.FormatProfileAccessor;
import com.sleepycat.persist.model.Persistent;
/** ICC N-component LUT-based output profile, as defined in ICC.1:2004-10,
* \u00a7 8.5.2.
*
* @author slabrams
*/
@Persistent
public class NComponentLUTBasedOutputProfile
extends AbstractFormatProfile
implements Validator
{
/** Profile version identifier. */
public static final String VERSION = "2.0.0";
/** Profile release date. */
public static final String RELEASE = "2010-09-10";
/** Profile rights statement. */
public static final String RIGHTS =
"Copyright 2010 by The Regents of the University of California. " +
"Available under the terms of the BSD license.";
/** Profile validation coverage. */
public static final Coverage COVERAGE = Coverage.Inclusive;
/** Validation status. */
protected Validity isValid;
/** Missing required tag messages. */
protected List<Message> missingRequiredTagMessages;
/** Instantiate a new <code>NComponentLUTBasedOutputProfile</code>
* @param format Profile format
* @param formatProfileAccessor persistence manager
*/
public NComponentLUTBasedOutputProfile(Format format, FormatProfileAccessor formatProfileAccessor)
{
super(VERSION, RELEASE, RIGHTS, format, formatProfileAccessor);
this.isValid = Validity.Undetermined;
this.missingRequiredTagMessages = new ArrayList<Message>();
}
@SuppressWarnings("unused")
private NComponentLUTBasedOutputProfile(){
this(null,null);
}
/** Validate the profile.
* @param jhove2 JHOVE2 framework
* @param source ICC source unit
* @param input ICC source input
* @return Validation status
* @see org.jhove2.module.format.Validator#validate(org.jhove2.core.JHOVE2, org.jhove2.core.source.Source, org.jhove2.core.io.Input)
*/
@Override
public Validity validate(JHOVE2 jhove2, Source source, Input input)
throws JHOVE2Exception
{
if (this.getFormatModule() != null) {
ICCHeader header = ((ICCModule) this.getFormatModule()).getHeader();
ICCTagTable table = ((ICCModule) this.getFormatModule()).getTagTable();
if (table != null) {
if (table.hasCommonRequirements()) {
this.isValid = Validity.True;
boolean hasAToB0Tag = false;
boolean hasAToB1Tag = false;
boolean hasAToB2Tag = false;
boolean hasBToA0Tag = false;
boolean hasBToA1Tag = false;
boolean hasBToA2Tag = false;
boolean hasColorantTableTag = false;
boolean hasGamutTag = false;
List<ICCTag> tags = table.getTags();
Iterator<ICCTag> iter = tags.iterator();
while (iter.hasNext()) {
ICCTag tag = iter.next();
String signature = tag.getSignature_raw();
if (signature.equals("A2B0")) {
hasAToB0Tag = true;
}
else if (signature.equals("A2B1")) {
hasAToB1Tag = true;
}
else if (signature.equals("A2B2")) {
hasAToB2Tag = true;
}
else if (signature.equals("B2A0")) {
hasBToA0Tag = true;
}
else if (signature.equals("B2A1")) {
hasBToA1Tag = true;
}
else if (signature.equals("B2A2")) {
hasBToA2Tag = true;
}
else if (signature.equals("clrt")) {
hasColorantTableTag = true;
}
else if (signature.equals("gamt")) {
hasGamutTag = true;
}
}
if (!hasAToB0Tag) {
this.isValid = Validity.False;
Object [] args = new Object [] {"A-to-B0 (\"A2B0\")"};
Message msg = new Message(Severity.WARNING, Context.OBJECT,
"org.jhove2.module.format.icc.ICCTagTable.MissingRequiredTag",
args, jhove2.getConfigInfo());
this.missingRequiredTagMessages.add(msg);
}
if (!hasAToB1Tag) {
this.isValid = Validity.False;
Object [] args = new Object [] {"A-to-B1 (\"A2B1\")"};
Message msg = new Message(Severity.WARNING, Context.OBJECT,
"org.jhove2.module.format.icc.ICCTagTable.MissingRequiredTag",
args, jhove2.getConfigInfo());
this.missingRequiredTagMessages.add(msg);
}
if (!hasAToB2Tag) {
this.isValid = Validity.False;
Object [] args = new Object [] {"A-to-B2 (\"A2B2\")"};
Message msg = new Message(Severity.WARNING, Context.OBJECT,
"org.jhove2.module.format.icc.ICCTagTable.MissingRequiredTag",
args, jhove2.getConfigInfo());
this.missingRequiredTagMessages.add(msg);
}
if (!hasBToA0Tag) {
this.isValid = Validity.False;
Object [] args = new Object [] {"B-to-A0 (\"B2A0\")"};
Message msg = new Message(Severity.WARNING, Context.OBJECT,
"org.jhove2.module.format.icc.ICCTagTable.MissingRequiredTag",
args, jhove2.getConfigInfo());
this.missingRequiredTagMessages.add(msg);
}
if (!hasBToA1Tag) {
this.isValid = Validity.False;
Object [] args = new Object [] {"B-to-A1 (\"B2A1\")"};
Message msg = new Message(Severity.WARNING, Context.OBJECT,
"org.jhove2.module.format.icc.ICCTagTable.MissingRequiredTag",
args, jhove2.getConfigInfo());
this.missingRequiredTagMessages.add(msg);
}
if (!hasBToA2Tag) {
this.isValid = Validity.False;
Object [] args = new Object [] {"B-to-A2 (\"B2A2\")"};
Message msg = new Message(Severity.WARNING, Context.OBJECT,
"org.jhove2.module.format.icc.ICCTagTable.MissingRequiredTag",
args, jhove2.getConfigInfo());
this.missingRequiredTagMessages.add(msg);
}
if (!hasGamutTag) {
this.isValid = Validity.False;
Object [] args = new Object [] {"Gamut(\"gamt\")"};
Message msg = new Message(Severity.WARNING, Context.OBJECT,
"org.jhove2.module.format.icc.ICCTagTable.MissingRequiredTag",
args, jhove2.getConfigInfo());
this.missingRequiredTagMessages.add(msg);
}
/* The colorant table tag is required only for "xCLR" colour
* spaces, e.g. "2CLR", "3CLR", ..., "FCLR".
*/
String colourSpace = header.getColourSpace_raw();
int in = colourSpace.indexOf("CLR");
if (in == 1) {
if (!hasColorantTableTag) {
this.isValid = Validity.False;
Object [] args = new Object [] {"Colorant table(\"clrt\")"};
Message msg = new Message(Severity.WARNING, Context.OBJECT,
"org.jhove2.module.format.icc.ICCTagTable.MissingRequiredTag",
args, jhove2.getConfigInfo());
this.missingRequiredTagMessages.add(msg);
}
}
}
}
}
return this.isValid;
}
/** Get profile coverage.
* @return Profile coverage
* @see org.jhove2.module.format.Validator#getCoverage()
*/
@Override
public Coverage getCoverage()
{
return COVERAGE;
}
/** Get missing required tag messages.
* @return missing required messages
*/
@ReportableProperty(order=1, value="Missing required tags.",
ref="ICC.1:2004-10, \u00a7 8.5.2")
public List<Message> getMissingRequiredTagMessages() {
return this.missingRequiredTagMessages;
}
/** Get validation status.
* @return Validation status
* @see org.jhove2.module.format.Validator#isValid()
*/
@Override
public Validity isValid()
{
return this.isValid;
}
}