faktel-ktp/io.github.cybersafetyid.faktel.ktp

Package-level declarations

Types

ClassicalKtpDetector

class ClassicalKtpDetector(config: ClassicalKtpDetector.Config = Config()) : KtpDetector

Model-free card locator (pure Kotlin, no native code), meant as a fast fallback and for low-end devices.

KtpDetection

data class KtpDetection(val quad: Quad, val confidence: Double)

A card found in a photo/frame. confidence is 0..1 and only comparable within one KtpDetector.

KtpDetector

interface KtpDetector

Locates a card-shaped quadrilateral. Implementations must not decide whether it is a KTP - see KtpScanner.

KtpIssue

enum KtpIssue : Enum<KtpIssue>

KtpScanConfig

data class KtpScanConfig(val aspectTolerance: Double = 0.15, val minCardWidthPx: Int = 500, val minBlurScore: Double = 40.0, val maxGlareRatio: Double = 0.03, val portraitRegion: Rect = Rect(0.6, 0.2, 1.0, 0.95))

Thresholds for KtpScanner. Defaults are starting points to calibrate on your own devices and backgrounds.

KtpScanner

class KtpScanner(detector: KtpDetector = ClassicalKtpDetector(), faceDetector: FaceDetector? = null, config: KtpScanConfig = KtpScanConfig())

KTP capture pipeline: locate card -> rectify -> validate (shape, size, focus, glare, portrait placement).

KtpScanResult

data class KtpScanResult(val detection: KtpDetection?, val card: RgbImage?, val portrait: Face?, val blurScore: Double?, val glareRatio: Double?, val issues: List<KtpIssue>)

KtpSpec

object KtpSpec

Physical facts about the Indonesian e-KTP, which follows ISO/IEC 7810 ID-1 (85.60 x 53.98 mm, Permendagri No. 38/2009) - the same size as a bank card.