/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You 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 org.apache.pdfbox.pdmodel.graphics.color;
import org.apache.pdfbox.cos.COSArray;
import org.apache.pdfbox.cos.COSBase;
import org.apache.pdfbox.cos.COSDictionary;
import org.apache.pdfbox.cos.COSFloat;
import org.apache.pdfbox.cos.COSName;
import org.apache.pdfbox.pdmodel.common.PDRange;
import java.awt.color.ColorSpace;
import java.awt.image.ColorModel;
import java.io.IOException;
/**
* This class represents a Lab color space.
*
* @author <a href="mailto:ben@benlitchfield.com">Ben Litchfield</a>
* @version $Revision: 1.4 $
*/
public class PDLab extends PDColorSpace
{
/**
* The name of this color space.
*/
public static final String NAME = "Lab";
private COSArray array;
private COSDictionary dictionary;
/**
* Constructor.
*/
public PDLab()
{
array = new COSArray();
dictionary = new COSDictionary();
array.add( COSName.LAB );
array.add( dictionary );
}
/**
* Constructor with array.
*
* @param lab The underlying color space.
*/
public PDLab( COSArray lab )
{
array = lab;
dictionary = (COSDictionary)array.getObject( 1 );
}
/**
* This will return the name of the color space.
*
* @return The name of the color space.
*/
public String getName()
{
return NAME;
}
/**
* Convert this standard java object to a COS object.
*
* @return The cos object that matches this Java object.
*/
public COSBase getCOSObject()
{
return array;
}
/**
* Create a Java colorspace for this colorspace.
*
* @return A color space that can be used for Java AWT operations.
*
* @throws IOException If there is an error creating the color space.
*/
protected ColorSpace createColorSpace() throws IOException
{
throw new IOException( "Not implemented" );
}
/**
* Create a Java color model for this colorspace.
*
* @param bpc The number of bits per component.
*
* @return A color model that can be used for Java AWT operations.
*
* @throws IOException If there is an error creating the color model.
*/
public ColorModel createColorModel( int bpc ) throws IOException
{
throw new IOException( "Not implemented" );
}
/**
* This will get the number of components that this color space is made up of.
*
* @return The number of components in this color space.
*
* @throws IOException If there is an error getting the number of color components.
*/
public int getNumberOfComponents() throws IOException
{
//BJL
//hmm is this correct, I am not 100% sure.
return 3;
}
/**
* This will return the whitepoint tristimulus. As this is a required field
* this will never return null. A default of 1,1,1 will be returned if the
* pdf does not have any values yet.
*
* @return The whitepoint tristimulus.
*/
public PDTristimulus getWhitepoint()
{
COSArray wp = (COSArray)dictionary.getDictionaryObject( COSName.WHITE_POINT );
if( wp == null )
{
wp = new COSArray();
wp.add( new COSFloat( 1.0f ) );
wp.add( new COSFloat( 1.0f ) );
wp.add( new COSFloat( 1.0f ) );
dictionary.setItem( COSName.WHITE_POINT, wp );
}
return new PDTristimulus( wp );
}
/**
* This will set the whitepoint tristimulus. As this is a required field
* this null should not be passed into this function.
*
* @param wp The whitepoint tristimulus.
*/
public void setWhitepoint( PDTristimulus wp )
{
COSBase wpArray = wp.getCOSObject();
if( wpArray != null )
{
dictionary.setItem( COSName.WHITE_POINT, wpArray );
}
}
/**
* This will return the BlackPoint tristimulus. This is an optional field but
* has defaults so this will never return null.
* A default of 0,0,0 will be returned if the pdf does not have any values yet.
*
* @return The blackpoint tristimulus.
*/
public PDTristimulus getBlackPoint()
{
COSArray bp = (COSArray)dictionary.getDictionaryObject( COSName.BLACK_POINT );
if( bp == null )
{
bp = new COSArray();
bp.add( new COSFloat( 0.0f ) );
bp.add( new COSFloat( 0.0f ) );
bp.add( new COSFloat( 0.0f ) );
dictionary.setItem( COSName.BLACK_POINT, bp );
}
return new PDTristimulus( bp );
}
/**
* This will set the BlackPoint tristimulus. As this is a required field
* this null should not be passed into this function.
*
* @param bp The BlackPoint tristimulus.
*/
public void setBlackPoint( PDTristimulus bp )
{
COSBase bpArray = null;
if( bp != null )
{
bpArray = bp.getCOSObject();
}
dictionary.setItem( COSName.BLACK_POINT, bpArray );
}
private COSArray getRangeArray()
{
COSArray range = (COSArray)dictionary.getDictionaryObject( COSName.RANGE );
if( range == null )
{
range = new COSArray();
dictionary.setItem( COSName.RANGE, array );
range.add( new COSFloat( -100 ) );
range.add( new COSFloat( 100 ) );
range.add( new COSFloat( -100 ) );
range.add( new COSFloat( 100 ) );
}
return range;
}
/**
* This will get the valid range for the a component. If none is found
* then the default will be returned, which is -100 to 100.
*
* @return The a range.
*/
public PDRange getARange()
{
COSArray range = getRangeArray();
return new PDRange( range, 0 );
}
/**
* This will set the a range for this color space.
*
* @param range The new range for the a component.
*/
public void setARange( PDRange range )
{
COSArray rangeArray = null;
//if null then reset to defaults
if( range == null )
{
rangeArray = getRangeArray();
rangeArray.set( 0, new COSFloat( -100 ) );
rangeArray.set( 1, new COSFloat( 100 ) );
}
else
{
rangeArray = range.getCOSArray();
}
dictionary.setItem( COSName.RANGE, rangeArray );
}
/**
* This will get the valid range for the b component. If none is found
* then the default will be returned, which is -100 to 100.
*
* @return The b range.
*/
public PDRange getBRange()
{
COSArray range = getRangeArray();
return new PDRange( range, 1 );
}
/**
* This will set the b range for this color space.
*
* @param range The new range for the b component.
*/
public void setBRange( PDRange range )
{
COSArray rangeArray = null;
//if null then reset to defaults
if( range == null )
{
rangeArray = getRangeArray();
rangeArray.set( 2, new COSFloat( -100 ) );
rangeArray.set( 3, new COSFloat( 100 ) );
}
else
{
rangeArray = range.getCOSArray();
}
dictionary.setItem( COSName.RANGE, rangeArray );
}
}