CIccTagMultiLocalizedUnicode Class Reference

Class: CIccTagMultiLocalizedUnicode. More...

#include <IccTagBasic.h>

Inheritance diagram for CIccTagMultiLocalizedUnicode:

Collaboration diagram for CIccTagMultiLocalizedUnicode:

Public Member Functions
	CIccTagMultiLocalizedUnicode ()
	Name: CIccTagMultiLocalizedUnicode::CIccTagMultiLocalizedUnicode.
	CIccTagMultiLocalizedUnicode (const CIccTagMultiLocalizedUnicode &ITMLU)
	Name: CIccTagMultiLocalizedUnicode::CIccTagMultiLocalizedUnicode.
virtual void	Describe (std::string &sDescription, int nVerboseness)
	Name: CIccTagMultiLocalizedUnicode::Describe.
CIccLocalizedUnicode *	Find (icLanguageCode nLanguageCode=icLanguageCodeEnglish, icCountryCode nRegionCode=icCountryCodeUSA)
	Name: refIccMAX::CIccTagMultiLocalizedUnicode::Find.
virtual const icChar *	GetClassName () const
virtual icTagTypeSignature	GetType () const
	Function: GetType()
virtual CIccTag *	NewCopy () const
	Function: NewCopy(sDescription) Each derived tag will implement it's own NewCopy() function.
CIccTagMultiLocalizedUnicode &	operator= (const CIccTagMultiLocalizedUnicode &MultiLocalizedTag)
	Name: CIccTagMultiLocalizedUnicode::operator=.
virtual bool	Read (icUInt32Number size, CIccIO *pIO)
	Name: CIccTagMultiLocalizedUnicode::Read.
void	SetText (const icChar *szText, icLanguageCode nLanguageCode=icLanguageCodeEnglish, icCountryCode nRegionCode=icCountryCodeUSA)
	Name: refIccMAX::CIccTagMultiLocalizedUnicode::SetText.
void	SetText (const icUInt16Number *sszUnicode16Text, icLanguageCode nLanguageCode=icLanguageCodeEnglish, icCountryCode nRegionCode=icCountryCodeUSA)
	Name: refIccMAX::CIccTagMultiLocalizedUnicode::SetText.
void	SetText (const icUInt32Number *sszUnicode32Text, icLanguageCode nLanguageCode=icLanguageCodeEnglish, icCountryCode nRegionCode=icCountryCodeUSA)
	Name: refIccMAX::CIccTagMultiLocalizedUnicode::SetText.
virtual icValidateStatus	Validate (std::string sigPath, std::string &sReport, const CIccProfile *pProfile=NULL) const
	Name: CIccTagMultiLocalizedUnicode::Validate.
virtual bool	Write (CIccIO *pIO)
	Name: CIccTagMultiLocalizedUnicode::Write.
virtual	~CIccTagMultiLocalizedUnicode ()
	Name: CIccTagMultiLocalizedUnicode::~CIccTagMultiLocalizedUnicode.
Public Member Functions inherited from CIccTag
	CIccTag ()
	Name: CIccTag::CIccTag.
virtual void	DetachIO ()
	Function: ReadAll() - Read All sub data for tag from file.
virtual IIccExtensionTag *	GetExtension ()
virtual icArraySignature	GetTagArrayType () const
virtual icStructSignature	GetTagStructType () const
virtual bool	IsArrayType ()
virtual bool	IsMBBType ()
virtual bool	IsNumArrayType () const
virtual bool	IsSupported ()
	Function: IsSupported(size, pIO) - Check if tag fully supported for apply purposes.
virtual bool	Read (icUInt32Number size, CIccIO *pIO, CIccProfile *pProfile)
	Function: Read(size, pIO) - Read tag from file.
virtual bool	ReadAll ()
	Function: ReadAll() - Read All sub data for tag from file.
virtual	~CIccTag ()
	Name: CIccTag::CIccTag.

Public Attributes
CIccMultiLocalizedUnicode *	m_Strings
Public Attributes inherited from CIccTag
icUInt32Number	m_nReserved

Additional Inherited Members
Static Public Member Functions inherited from CIccTag
static CIccTag *	Create (icTagTypeSignature sig)
	Name: CIccTag::Create.

Detailed Description

Class: CIccTagMultiLocalizedUnicode.

Purpose: The MultiLocalizedUnicode tag

Definition at line 1228 of file IccTagBasic.h.

Constructor & Destructor Documentation

CIccTagMultiLocalizedUnicode() [1/2]

CIccTagMultiLocalizedUnicode::CIccTagMultiLocalizedUnicode

(

)

Name: CIccTagMultiLocalizedUnicode::CIccTagMultiLocalizedUnicode.

Purpose: Constructor

Definition at line 7311 of file IccTagBasic.cpp.

{
  m_Strings = new(CIccMultiLocalizedUnicode);
}

CIccTagMultiLocalizedUnicode() [2/2]

CIccTagMultiLocalizedUnicode::CIccTagMultiLocalizedUnicode

(

const CIccTagMultiLocalizedUnicode &

ITMLU

)

Name: CIccTagMultiLocalizedUnicode::CIccTagMultiLocalizedUnicode.

Purpose: Copy Constructor

Args: ITMLU = The CIccTagMultiLocalizedUnicode object to be copied

Definition at line 7327 of file IccTagBasic.cpp.

{
  m_Strings = new(CIccMultiLocalizedUnicode);
  *m_Strings = *ITMLU.m_Strings;
}

References m_Strings.

~CIccTagMultiLocalizedUnicode()

CIccTagMultiLocalizedUnicode::~CIccTagMultiLocalizedUnicode ( )

virtual

Name: CIccTagMultiLocalizedUnicode::~CIccTagMultiLocalizedUnicode.

Purpose: Destructor

Definition at line 7364 of file IccTagBasic.cpp.

{
  delete m_Strings;
}

Member Function Documentation

Describe()

void CIccTagMultiLocalizedUnicode::Describe ( std::string & sDescription, int nVerboseness )

virtual

Name: CIccTagMultiLocalizedUnicode::Describe.

Purpose: Dump data associated with the tag to a string

Args: sDescription - string to concatenate tag dump to

Reimplemented from CIccTag.

Definition at line 7535 of file IccTagBasic.cpp.

{
  char szBuf[128];
  std::string utf8;
  int nSize = 127;
  CIccMultiLocalizedUnicode::iterator i;
 
  for (i=m_Strings->begin(); i!=m_Strings->end(); i++) {
    if (i!=m_Strings->begin())
      sDescription += "\n";
 
    // Bad ICCs can have unprintables...
    sDescription += "Language = ";
    if (isprint(i->m_nLanguageCode >> 8) && isprint(i->m_nLanguageCode & 0x00FF)) {
        sprintf(szBuf, "'%c%c'", i->m_nLanguageCode >> 8, i->m_nLanguageCode & 0x00FF);
    }
    else {
      sprintf(szBuf, "'\?\?' (0x%04X)", i->m_nLanguageCode);
    }
    sDescription += szBuf;
 
    if (i->m_nCountryCode) {
        // Region Codes are optional according to ISO 
        sDescription += ", Region = ";
        if (isprint(i->m_nCountryCode >> 8) && isprint(i->m_nCountryCode & 0x00FF)) {
          sprintf(szBuf, "'%c%c'", i->m_nCountryCode>>8, i->m_nCountryCode & 0x00FF);
        }
        else {
            sprintf(szBuf, "'\?\?' (0x%04X)", i->m_nCountryCode);
        }
        sDescription += szBuf;
    }
    sDescription += "\n";
 
    i->GetText(utf8);
    sDescription += "\"";
    sDescription += utf8;
    sDescription += "\"\n";
  }
}

Referenced by CIccDictEntry::Describe(), and CIccProfileIdDesc::Describe().

Here is the caller graph for this function:

Find()

CIccLocalizedUnicode * CIccTagMultiLocalizedUnicode::Find	(	icLanguageCode	nLanguageCode = icLanguageCodeEnglish,
		icCountryCode	nRegionCode = icCountryCodeUSA )

Name: refIccMAX::CIccTagMultiLocalizedUnicode::Find.

Purpose:

Args: nLanguageCode nRegionCode

Return: Pointer to CIccLocalizedUnicode object associated with the nLanguageCode and nRegionCode or NULL if not found

Definition at line 7629 of file IccTagBasic.cpp.

{
  CIccMultiLocalizedUnicode::iterator i;
 
  for (i=m_Strings->begin(); i!=m_Strings->end(); i++) {
    if (i->m_nLanguageCode == nLanguageCode &&
      i->m_nCountryCode == nRegionCode) {
      return &(*i);
    }
  }
 
  return NULL;
}

Referenced by icGetTagText().

Here is the caller graph for this function:

GetClassName()

virtual const icChar * CIccTagMultiLocalizedUnicode::GetClassName ( ) const

inlinevirtual

Reimplemented from CIccTag.

Reimplemented in CIccTagXmlMultiLocalizedUnicode.

Definition at line 1238 of file IccTagBasic.h.

{ return "CIcciSigMultiLocalizedUnicode"; }

GetType()

virtual icTagTypeSignature CIccTagMultiLocalizedUnicode::GetType ( ) const

inlinevirtual

Function: GetType()

Purpose: Get Tag Type. Each derived tag will implement it's own GetType() function.

Reimplemented from CIccTag.

Definition at line 1237 of file IccTagBasic.h.

{ return icSigMultiLocalizedUnicodeType; }

References icSigMultiLocalizedUnicodeType.

NewCopy()

virtual CIccTag * CIccTagMultiLocalizedUnicode::NewCopy ( ) const

inlinevirtual

Function: NewCopy(sDescription) Each derived tag will implement it's own NewCopy() function.

Parameter(s): none

Returns a new CIccTag object that is a copy of this object.

Reimplemented from CIccTag.

Reimplemented in CIccTagXmlMultiLocalizedUnicode.

Definition at line 1234 of file IccTagBasic.h.

{return new CIccTagMultiLocalizedUnicode(*this);}

Referenced by CIccDictEntry::CIccDictEntry(), and CIccDictEntry::operator=().

Here is the caller graph for this function:

operator=()

CIccTagMultiLocalizedUnicode & CIccTagMultiLocalizedUnicode::operator=

(

const CIccTagMultiLocalizedUnicode &

MultiLocalizedTag

)

Name: CIccTagMultiLocalizedUnicode::operator=.

Purpose: Copy Operator

Args: MultiLocalizedTag = The CIccTagMultiLocalizedUnicode object to be copied

Definition at line 7344 of file IccTagBasic.cpp.

{
  if (&MultiLocalizedTag == this)
    return *this;
 
  m_Strings->clear();
  *m_Strings = *MultiLocalizedTag.m_Strings;
 
  return *this;
}

References m_Strings.

Read()

bool CIccTagMultiLocalizedUnicode::Read ( icUInt32Number size, CIccIO * pIO )

virtual

Name: CIccTagMultiLocalizedUnicode::Read.

Purpose: Read in the tag contents into a data block

Since MultiLocalizedUnicode tags can be embedded in other tags this function ensures that the current read pointer will be set to the position just after the last name record.

Args: size - # of bytes in tag, pIO - IO object to read tag from

Return: true = successful, false = failure

Reimplemented from CIccTag.

Definition at line 7388 of file IccTagBasic.cpp.

{
  icTagTypeSignature sig;
  icUInt32Number nNumRec, nRecSize;
  icLanguageCode nLanguageCode;
  icCountryCode nRegionCode;
  icUInt32Number nLength, nOffset, nNumChar;
 
  if (!m_Strings->empty())
    m_Strings->clear();
 
  if (sizeof(icTagTypeSignature) + 
      sizeof(icUInt32Number)*3 > size)
    return false;
 
  if (!pIO) {
    return false;
  }
 
  icUInt32Number nTagPos = pIO->Tell();
  
  if (!pIO->Read32(&sig) ||
      !pIO->Read32(&m_nReserved) ||
      !pIO->Read32(&nNumRec) ||
      !pIO->Read32(&nRecSize))
    return false;
 
 
  if (nRecSize!=12) { //Recognized version name records are 12 bytes each
    return false;
  }
 
  icUInt32Number i; 
  CIccLocalizedUnicode Unicode;
  icUInt32Number nLastPos = 0;
 
  for (i=0; i<nNumRec; i++) {
    if (4*sizeof(icUInt32Number) + (i+1)*12 > size)
      return false;
 
    pIO->Seek(nTagPos+4*sizeof(icUInt32Number) + i*12, icSeekSet);
 
    if (!pIO->Read16(&nLanguageCode) ||
        !pIO->Read16(&nRegionCode) ||
        !pIO->Read32(&nLength) ||
        !pIO->Read32(&nOffset))
      return false;
    
    if (nOffset+nLength > size)
      return false;
 
    //Find out position of the end of last named record
    if (nOffset+nLength > nLastPos)
      nLastPos = nOffset + nLength;
 
    nNumChar = nLength / sizeof(icUInt16Number);
 
    if (!Unicode.SetSize(nNumChar))
      return false;
 
    Unicode.m_nLanguageCode = nLanguageCode;
    Unicode.m_nCountryCode = nRegionCode;
 
    pIO->Seek(nTagPos+nOffset, icSeekSet);
 
    if (pIO->Read16(Unicode.GetBuf(), nNumChar) != (icInt32Number)nNumChar)
      return false;
 
    m_Strings->push_back(Unicode);
  }
 
  //Now seek past the last named record
  if (nLastPos > 0)
    pIO->Seek(nTagPos+nLastPos, icSeekSet);
 
  return true;
}

References CIccLocalizedUnicode::GetBuf(), icSeekSet, CIccLocalizedUnicode::m_nCountryCode, CIccLocalizedUnicode::m_nLanguageCode, CIccIO::Read16(), CIccIO::Read32(), CIccIO::Seek(), CIccLocalizedUnicode::SetSize(), sig, and CIccIO::Tell().

Referenced by CIccProfileIdDesc::Read(), and CIccTagDict::Read().

Here is the call graph for this function:

Here is the caller graph for this function:

SetText() [1/3]

void CIccTagMultiLocalizedUnicode::SetText	(	const icChar *	szText,
		icLanguageCode	nLanguageCode = icLanguageCodeEnglish,
		icCountryCode	nRegionCode = icCountryCodeUSA )

Name: refIccMAX::CIccTagMultiLocalizedUnicode::SetText.

Purpose:

Args: sszUnicodeText nLanguageCode RegionCode

Definition at line 7656 of file IccTagBasic.cpp.

{
   CIccLocalizedUnicode *pText = Find(nLanguageCode, nRegionCode);
 
   if (!pText) {
     CIccLocalizedUnicode newText;
     newText.SetText(szText, nLanguageCode, nRegionCode);
     m_Strings->push_back(newText);
   }
   else {
     pText->SetText(szText, nLanguageCode, nRegionCode);
   }
}

References CIccLocalizedUnicode::SetText().

Referenced by CDevLinkWriter::begin(), CIccProfileIdDesc::CIccProfileIdDesc(), main(), CIccTagXmlDict::ParseXml(), and CIccTagXmlProfileSequenceId::ParseXml().

Here is the call graph for this function:

Here is the caller graph for this function:

SetText() [2/3]

void CIccTagMultiLocalizedUnicode::SetText	(	const icUInt16Number *	sszUnicode16Text,
		icLanguageCode	nLanguageCode = icLanguageCodeEnglish,
		icCountryCode	nRegionCode = icCountryCodeUSA )

Name: refIccMAX::CIccTagMultiLocalizedUnicode::SetText.

Purpose:

Args: sszUnicodeText nLanguageCode RegionCode

Definition at line 7685 of file IccTagBasic.cpp.

{
  CIccLocalizedUnicode *pText = Find(nLanguageCode, nRegionCode);
 
  if (!pText) {
    CIccLocalizedUnicode newText;
    newText.SetText(sszUnicode16Text, nLanguageCode, nRegionCode);
    m_Strings->push_back(newText);
  }
  else {
    pText->SetText(sszUnicode16Text, nLanguageCode, nRegionCode);
  }
}

References CIccLocalizedUnicode::SetText().

Here is the call graph for this function:

SetText() [3/3]

void CIccTagMultiLocalizedUnicode::SetText	(	const icUInt32Number *	sszUnicode32Text,
		icLanguageCode	nLanguageCode = icLanguageCodeEnglish,
		icCountryCode	nRegionCode = icCountryCodeUSA )

Name: refIccMAX::CIccTagMultiLocalizedUnicode::SetText.

Purpose:

Args: sszUnicodeText nLanguageCode RegionCode

Definition at line 7713 of file IccTagBasic.cpp.

{
  CIccLocalizedUnicode *pText = Find(nLanguageCode, nRegionCode);
 
  if (!pText) {
    CIccLocalizedUnicode newText;
    newText.SetText(sszUnicode32Text, nLanguageCode, nRegionCode);
    m_Strings->push_back(newText);
  }
  else {
    pText->SetText(sszUnicode32Text, nLanguageCode, nRegionCode);
  }
}

References CIccLocalizedUnicode::SetText().

Here is the call graph for this function:

Validate()

icValidateStatus CIccTagMultiLocalizedUnicode::Validate ( std::string sigPath, std::string & sReport, const CIccProfile * pProfile = NULL ) const

virtual

Name: CIccTagMultiLocalizedUnicode::Validate.

Purpose: Check tag data validity.

Args: sig = signature of tag being validated, sReport = String to add report information to

Return: icValidateStatusOK if valid, or other error status.

Reimplemented from CIccTag.

Definition at line 7591 of file IccTagBasic.cpp.

{
  icValidateStatus rv = CIccTag::Validate(sigPath, sReport, pProfile);
 
  CIccInfo Info;
  std::string sSigPathName = Info.GetSigPathName(sigPath);
 
  if (!m_Strings->size()) {
    sReport += icMsgValidateWarning;
    sReport += sSigPathName;
    sReport += " - Empty tag!\n";
    rv = icMaxStatus(rv, icValidateWarning);
  }
 
  CIccMultiLocalizedUnicode::iterator i;
  for (i=m_Strings->begin(); i!=m_Strings->end(); i++) {
    // TODO: Validate ISO-639 Language Codes and and ISO-3166 Country codes.
    // Needs to be done against a full set of codes or many false warnings.
  }
 
  return rv;
}

References CIccInfo::GetSigPathName(), icMaxStatus(), icMsgValidateWarning, icValidateWarning, and CIccTag::Validate().

Referenced by CIccProfileIdDesc::Validate().

Here is the call graph for this function:

Here is the caller graph for this function:

Write()

bool CIccTagMultiLocalizedUnicode::Write ( CIccIO * pIO )

virtual

Name: CIccTagMultiLocalizedUnicode::Write.

Purpose: Write the tag to a file

Args: pIO - The IO object to write tag to.

Return: true = succesful, false = failure

Reimplemented from CIccTag.

Definition at line 7480 of file IccTagBasic.cpp.

{
  icTagTypeSignature sig = GetType();
  icUInt32Number nNumRec=(icUInt32Number)m_Strings->size(), nRecSize=12;
  icUInt32Number nLength;
 
  if (!pIO) {
    return false;
  }
 
  if (!pIO->Write32(&sig) ||
      !pIO->Write32(&m_nReserved) ||
      !pIO->Write32(&nNumRec) ||
      !pIO->Write32(&nRecSize))
    return false;
 
 
  icUInt32Number nPos = 4*sizeof(icUInt32Number) + nNumRec*12;
 
  CIccMultiLocalizedUnicode::iterator i;
 
  for (i=m_Strings->begin(); i!=m_Strings->end(); i++) {
    nLength = i->GetLength() * sizeof(icUInt16Number);
 
    if (!pIO->Write16(&i->m_nLanguageCode) ||
        !pIO->Write16(&i->m_nCountryCode) ||
        !pIO->Write32(&nLength) ||
        !pIO->Write32(&nPos))
      return false;
    nPos += nLength;
  }
 
  for (i=m_Strings->begin(); i!=m_Strings->end(); i++) {
    nLength = i->GetLength();
 
    if (nLength) {
      if (pIO->Write16(i->GetBuf(), nLength) != (icInt32Number)nLength)
        return false;
    }
  }
 
  return true;
}

References sig, CIccIO::Write16(), and CIccIO::Write32().

Referenced by CIccProfileIdDesc::Write().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

m_Strings

CIccMultiLocalizedUnicode* CIccTagMultiLocalizedUnicode::m_Strings

Definition at line 1260 of file IccTagBasic.h.

Referenced by CIccTagMultiLocalizedUnicode(), main(), operator=(), and CIccTagXmlDict::ToXml().

---

The documentation for this class was generated from the following files:

• IccProfLib/IccTagBasic.h
• IccProfLib/IccTagBasic.cpp