XMPFilesMBS.CheckFileFormat(path as string) as Integer

CheckFileFormat tries to determine the format of a file, returning an format value. It uses the same logic as OpenFile will use to select a smart handler.

path: The path for the file, appropriate for the local operating system. Passed as a UTF-8 string. The path is the same as would be passed to OpenFile.

Returns the file's format if a smart handler would be selected, otherwise kUnknownFile.

XMPFilesMBS.CheckPackageFormat(path as string) as Integer

CheckPackageFormat tries to determine the format of a "package" given the name of the top level folder, returning an XMP_FileFormat value. Examples of recognized packages include the video formats P2, XDCAM, or Sony HDV. These packages contain collections of "clips", stored as multiple files in specific subfolders.

Path: The path for the top level folder, appropriate for the local operating
system. Passed as an UTF-8 string. The path is not the same as would be passed to OpenFile. For example the path passed to CheckPackageFormat might be ".../MyMovie", while the path passed to OpenFile would be ".../MyMovie/SomeClip".

Returns the package's format if a smart handler would be selected, otherwise kUnknownFile.

XMPFilesMBS.GetFormatInfo(format as Integer, byref handlerFlags as UInt32) as boolean

dim flags as UInt32
if XMPFilesMBS.GetFormatInfo(XMPFilesMBS.kJPEGFile, flags) then
  
  if BitwiseAnd(flags, XMPFilesMBS.kCanInjectXMP) <> 0 then
    MsgBox "Can inject first-time XMP into an existing file."
  end if
  
  if BitwiseAnd(flags, XMPFilesMBS.kCanExpand) <> 0 then
    MsgBox "Can expand XMP or other metadata in an existing file."
  end if
  
  if BitwiseAnd(flags, XMPFilesMBS.kCanRewrite) <> 0 then
    MsgBox "Can copy one file to another, writing new metadata (as in SaveAs)."
  end if
  
  if BitwiseAnd(flags, XMPFilesMBS.kCanReconcile) <> 0 then
    MsgBox "Supports reconciliation between XMP and other forms."
  end if
  
  if BitwiseAnd(flags, XMPFilesMBS.kAllowsOnlyXMP) <> 0 then
    MsgBox "Allows access to just the XMP, ignoring other forms."
  end if
  
  if BitwiseAnd(flags, XMPFilesMBS.kReturnsTNail) <> 0 then
    MsgBox "File handler returns native thumbnail information."
  end if
  
  if BitwiseAnd(flags, XMPFilesMBS.kReturnsRawPacket) <> 0 then
    MsgBox "File handler returns raw XMP packet information and string."
  end if
  
end if

The file handlers for different file formats vary considerably in what features they support. Support depends on both the general capabilities of the format and the implementation of the handler for that format.

format: The file format whose support flags are desired.
handlerFlags: A variable in which to return a logical OR of option bit flags.
The following constants are defined:

• kCanInjectXMP - Can inject first-time XMP into an existing file.
• kCanExpand - Can expand XMP or other metadata in an existing file.
• kCanRewrite - Can copy one file to another, writing new metadata (as in SaveAs)
• kCanReconcile - Supports reconciliation between XMP and other forms.
• kAllowsOnlyXMP - Allows access to just the XMP, ignoring other forms.

• kReturnsTNail - File handler returns native thumbnail information.
• kReturnsRawPacket - File handler returns raw XMP packet information and string.

XMPFilesMBS.GetVersionInfo as XMPVersionInfoMBS