Examples (iOS)

Using Perfectly Clear in iOS is very similar to using it on OSX. See example usage in your SDK package in Demo/ImageEngine.

Simple AI Sample - Using Scene Detection

1. Create AI-enabled engine - this should be done once when the app loads

   PFCENGINE *pEngine = PFC_CreateEngine();

2. Enable AI features (Dynamic and Scene Detection) in PFCENGINE. This requires passing your PFC SDK apikey, certificate, and paths to PFC AI models (PFCDynamicModel.pnnc and pfcsdcoreml.pnn) in the app bundle

   uint features = AI_CORRECTIONS | AI_SCENE_DETECTION;
   int featuresLoaded = PFC_LoadAIEngineNative(m_PFCEngine, features,  pathDynamic, 0, pathSD, 0, 0, apiKey.UTF8String,certificate.UTF8String, &statusCertificate);

3. OPTIONALLY: load custom AI presets (presets to be selected based on scene detection). If custom presets are not loaded, default AI presets from the SD model will be used. Export these .preset files from Pefectly Clear Workbench.

   int ret = PFC_LoadScenePresets(m_PFCEngine, pathAIPresets);

4. Detect scene. This is needs to be done once per loaded image

   PFCPROFILE pProfile;
   pProfile = PFC_Calc(&im, NULL, m_PFCEngine, CALC_ALL | CALC_SCENE_DETECTION, -1, NULL, NULL, NULL, PFC_REJECT_CLIPART, m_PFCEngine);
   int version = 0;
   int detectedScene = PFC_GetScene(pProfile, &version);

5. Read correction params from scene preset

   PFCPARAM param;
   if (detectedScene > 0) {
       PFC_ReadScenePreset(param, m_PFCEngine, *detectedScene);
   }

6. Or optionally read correction params from preset, ignoring scene detection

   PFC_ReadPresetsFromStream(param, (const char*)preset);

7. Apply Perfectly Clear:

   int status = PFC_AutoCorrect(&im, NULL, param);

8. Cleanup: Run this as the app is closing.

   PFC_DestroyEngine(pEngine);

The calling patterns are very similar to OSX or Linux, so you can also review those samples for more use-cases.