avid.externals.matchPoint.ensureMAPRegistrationArtefact

avid.externals.matchPoint.ensureMAPRegistrationArtefact(regArtefact, templateArtefact, session)

Helper function that ensures that the returned registration artefact is stored in a format that is supported by MatchPoint. If the passed artefact is valid or None, it will just a loop through (None is assumed as a valid artefact as well in this context). In other cases the function will try to convert/wrap the passed artefact/data and return a matchpoint conformant artefact. @param regArtefact: the artefact that should be checked, converted if needed. @param conversionPath: Path where any conversion artefacts, if needed, should be stored. @return: Tuple: the first is a boolean indicating if a conversion was necessary; the second is the valid (new) artefact. The value (True,None) encodes the fact, that a conversion was needed but not possible.