private void RegisterStandardAliases()
{
var aliasToArrayOrdered = new AliasOptions { IsArrayOrdered = true };
var aliasToArrayAltText = new AliasOptions { IsArrayAltText = true };
// Aliases from XMP to DC.
RegisterAlias(XmpConstants.NsXmp, "Author", XmpConstants.NsDC, "creator", aliasToArrayOrdered);
RegisterAlias(XmpConstants.NsXmp, "Authors", XmpConstants.NsDC, "creator", null);
RegisterAlias(XmpConstants.NsXmp, "Description", XmpConstants.NsDC, "description", null);
RegisterAlias(XmpConstants.NsXmp, "Format", XmpConstants.NsDC, "format", null);
RegisterAlias(XmpConstants.NsXmp, "Keywords", XmpConstants.NsDC, "subject", null);
RegisterAlias(XmpConstants.NsXmp, "Locale", XmpConstants.NsDC, "language", null);
RegisterAlias(XmpConstants.NsXmp, "Title", XmpConstants.NsDC, "title", null);
RegisterAlias(XmpConstants.NsXmpRights, "Copyright", XmpConstants.NsDC, "rights", null);
// Aliases from PDF to DC and XMP.
RegisterAlias(XmpConstants.NsPdf, "Author", XmpConstants.NsDC, "creator", aliasToArrayOrdered);
RegisterAlias(XmpConstants.NsPdf, "BaseURL", XmpConstants.NsXmp, "BaseURL", null);
RegisterAlias(XmpConstants.NsPdf, "CreationDate", XmpConstants.NsXmp, "CreateDate", null);
RegisterAlias(XmpConstants.NsPdf, "Creator", XmpConstants.NsXmp, "CreatorTool", null);
RegisterAlias(XmpConstants.NsPdf, "ModDate", XmpConstants.NsXmp, "ModifyDate", null);
RegisterAlias(XmpConstants.NsPdf, "Subject", XmpConstants.NsDC, "description", aliasToArrayAltText);
RegisterAlias(XmpConstants.NsPdf, "Title", XmpConstants.NsDC, "title", aliasToArrayAltText);
// Aliases from PHOTOSHOP to DC and XMP.
RegisterAlias(XmpConstants.NsPhotoshop, "Author", XmpConstants.NsDC, "creator", aliasToArrayOrdered);
RegisterAlias(XmpConstants.NsPhotoshop, "Caption", XmpConstants.NsDC, "description", aliasToArrayAltText);
RegisterAlias(XmpConstants.NsPhotoshop, "Copyright", XmpConstants.NsDC, "rights", aliasToArrayAltText);
RegisterAlias(XmpConstants.NsPhotoshop, "Keywords", XmpConstants.NsDC, "subject", null);
RegisterAlias(XmpConstants.NsPhotoshop, "Marked", XmpConstants.NsXmpRights, "Marked", null);
RegisterAlias(XmpConstants.NsPhotoshop, "Title", XmpConstants.NsDC, "title", aliasToArrayAltText);
RegisterAlias(XmpConstants.NsPhotoshop, "WebStatement", XmpConstants.NsXmpRights, "WebStatement", null);
// Aliases from TIFF and EXIF to DC and XMP.
RegisterAlias(XmpConstants.NsTiff, "Artist", XmpConstants.NsDC, "creator", aliasToArrayOrdered);
RegisterAlias(XmpConstants.NsTiff, "Copyright", XmpConstants.NsDC, "rights", null);
RegisterAlias(XmpConstants.NsTiff, "DateTime", XmpConstants.NsXmp, "ModifyDate", null);
RegisterAlias(XmpConstants.NsTiff, "ImageDescription", XmpConstants.NsDC, "description", null);
RegisterAlias(XmpConstants.NsTiff, "Software", XmpConstants.NsXmp, "CreatorTool", null);
// Aliases from PNG (Acrobat ImageCapture) to DC and XMP.
RegisterAlias(XmpConstants.NsPng, "Author", XmpConstants.NsDC, "creator", aliasToArrayOrdered);
RegisterAlias(XmpConstants.NsPng, "Copyright", XmpConstants.NsDC, "rights", aliasToArrayAltText);
RegisterAlias(XmpConstants.NsPng, "CreationTime", XmpConstants.NsXmp, "CreateDate", null);
RegisterAlias(XmpConstants.NsPng, "Description", XmpConstants.NsDC, "description", aliasToArrayAltText);
RegisterAlias(XmpConstants.NsPng, "ModificationTime", XmpConstants.NsXmp, "ModifyDate", null);
RegisterAlias(XmpConstants.NsPng, "Software", XmpConstants.NsXmp, "CreatorTool", null);
RegisterAlias(XmpConstants.NsPng, "Title", XmpConstants.NsDC, "title", aliasToArrayAltText);
}
public XmpAliasInfo(string actualNs, string actualPrefix, string actualProp, AliasOptions aliasOpts)
{
Namespace = actualNs;
Prefix = actualPrefix;
PropName = actualProp;
AliasForm = aliasOpts;
}
/// <summary>Associates an alias name with an actual name.</summary>
/// <remarks>
/// Associates an alias name with an actual name.
/// <para />
/// Define a alias mapping from one namespace/property to another. Both
/// property names must be simple names. An alias can be a direct mapping,
/// where the alias and actual have the same data type. It is also possible
/// to map a simple alias to an item in an array. This can either be to the
/// first item in the array, or to the 'x-default' item in an alt-text array.
/// Multiple alias names may map to the same actual, as long as the forms
/// match. It is a no-op to reregister an alias in an identical fashion.
/// Note: This method is not locking because only called by registerStandardAliases
/// which is only called by the constructor.
/// Note2: The method is only package-private so that it can be tested with unittests
/// </remarks>
/// <param name="aliasNs">The namespace URI for the alias. Must not be null or the empty string.</param>
/// <param name="aliasProp">The name of the alias. Must be a simple name, not null or the empty string and not a general path expression.</param>
/// <param name="actualNs">The namespace URI for the actual. Must not be null or the empty string.</param>
/// <param name="actualProp">The name of the actual. Must be a simple name, not null or the empty string and not a general path expression.</param>
/// <param name="aliasForm">Provides options for aliases for simple aliases to array items. This is needed to know what kind of array to create if
/// set for the first time via the simple alias. Pass <c>XMP_NoOptions</c>, the default value, for all direct aliases regardless of whether the actual
/// data type is an array or not (see <see cref="AliasOptions"/>).</param>
/// <exception cref="XmpException">for inconsistant aliases.</exception>
private void RegisterAlias(string aliasNs, string aliasProp, string actualNs, string actualProp, AliasOptions aliasForm)
{
lock (_lock)
{
ParameterAsserts.AssertSchemaNs(aliasNs);
ParameterAsserts.AssertPropName(aliasProp);
ParameterAsserts.AssertSchemaNs(actualNs);
ParameterAsserts.AssertPropName(actualProp);
// Fix the alias options
var aliasOpts = aliasForm != null ? new AliasOptions(XmpNodeUtils.VerifySetOptions(aliasForm.ToPropertyOptions(), null).GetOptions()) : new AliasOptions();
if (_p.IsMatch(aliasProp) || _p.IsMatch(actualProp))
throw new XmpException("Alias and actual property names must be simple", XmpErrorCode.BadXPath);
// check if both namespaces are registered
var aliasPrefix = GetNamespacePrefix(aliasNs);
var actualPrefix = GetNamespacePrefix(actualNs);
if (aliasPrefix == null)
throw new XmpException("Alias namespace is not registered", XmpErrorCode.BadSchema);
if (actualPrefix == null)
throw new XmpException("Actual namespace is not registered", XmpErrorCode.BadSchema);
var key = aliasPrefix + aliasProp;
// check if alias is already existing
if (_aliasMap.ContainsKey(key))
throw new XmpException("Alias is already existing", XmpErrorCode.BadParam);
if (_aliasMap.ContainsKey(actualPrefix + actualProp))
throw new XmpException("Actual property is already an alias, use the base property", XmpErrorCode.BadParam);
_aliasMap[key] = new XmpAliasInfo(actualNs, actualPrefix, actualProp, aliasOpts);
}
}
