Radar: Aztec and PDF417 Core Image Generators documentation missing

While researching for my book “Barcodes and iOS” I was looking at the CoreImage generators for barcodes. iOS 7 supports generating QR, Aztec and PDF417 barcodes via CoreImage generators.

But for the latter two the documentation appears to be missing, making those – technically – private APIs. I believe this to be something that was simply overlooked, since those generators seem to work just fine.

Update: An Apple evangelist responded to my inquiry and confirmed that those CI generators are indeed private API and should not be used.

BSA Banner

Summary

CI has working implementations CIAztecCodeGenerator and CIPDF417BarcodeGenerator. But they are not mentioned in the documentation. I believe these to be missing and causing developer confusion about whether or not these can be used in apps.

Steps to Reproduce

Search documentation for CIQRCodeGenerator

Search documentation for CIAztecCodeGenerator

Search documentation for CIPDF417BarcodeGenerator

Expected Results

Documentation for possible parameters should be found for all 3 barcode types in the Core Image Filter Reference.

Actual Results

Documentation is only found for CIQRCodeGenerator.

Version

iOS 7.0.5

Notes

There should be no reason for Aztec and PDF417 CI Generators being private since they seem to work. Thus we believe that the documentation was simply forgotten.