Apache License 2.0

技术解读

以下内容由 GitRead 中文社区 编辑团队基于项目 README 与官方资料整理, 结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

FocusPointsLrC/Focus-Points:揭示背后的技术秘密

项目背景与痛点

在摄影领域,Lightroom 是一个强大的图像编辑软件,但对于某些细节问题,原生功能并不足够。例如,Lightroom 并不具备显示拍照时对焦点位置的功能。这对于摄影师来说,特别是在校正照片或进行大型摄影项目时,是一个明显的痛点。因此,“Focus-Points”插件的出现,解决了这一需求,让摄影师能够在 Lightroom 中查看每一帧图像的对焦信息。

核心技术揭秘

“Focus-Points”插件通过读取照片的元数据来确定图像的对焦点位置,这一过程涉及复杂的元数据解析和数据流处理。以下是其技术架构的剖析:

技术架构分析

该插件的设计主要采用了 C++ 语言实现,并依赖了 Adobe 提供的 SDK。以下是一个简化的技术框架图,展示了数据从读取、解析到显示的整个过程:

graph TD A[读取照片文件] --> B[解析元数据] B --> C{"对焦点数据存在?"} C -->|"是"| D[提取对焦坐标] C -->|"否"| E[返回默认值] D --> F[绘制对焦点] F --> G[显示在Lightroom界面]

技术难点

  1. 元数据解析:图像元数据的解析是该插件的关键步骤。需要准确识别并提取出与对焦点相关的 EXIF 或其他元数据信息。
  2. 跨平台兼容:Adobe SDK 的使用让插件能在不同操作系统和 Lightroom 版本上运行,但这也增加了跨平台兼容性调试的难度。
  3. 性能优化:高效的数据流处理是保障用户体验的重要因素,需要避免在解析大量照片时出现性能瓶颈。

功能亮点与差异

“Focus-Points”插件与同类插件相比,具有几个独特的亮点:

  1. 对焦点定位精确:能够识别并显示对焦点的确切位置,而非单一的点或区域。
  2. 用户界面友好:插件集成了优美的用户界面,使用户在查看对焦点信息时更加直观、便捷。
  3. 兼容性广泛:支持多种格式的相机数据记录,确保在不同设备之间使用时的兼容性。

应用场景与落地建议

在生产环境中使用“Focus-Points”插件时,需要注意以下几点:

  • 数据校验:确保照片文件中的元数据包含对焦信息。
  • 性能优化:在处理大量照片时,注意缓存机制的引入以提升性能。
  • 技术支持:针对业务场景,制定详细的技术支持计划,以便快速解决突发问题。

该插件非常适合需要精准掌握拍摄状态的摄影师和摄影工作室使用,特别适用于大型摄影项目中对对焦精度有严格要求的场景。

综合评价

“Focus-Points”插件的推出,填补了 Lightroom 一个重要的功能空白,为摄影师提供了极为珍贵的图像信息。其技术和功能设计均表现出色,但也需要解决数据解析过程中可能出现的复杂性问题。总体而言,这是一个实用性极高的工具,值得广大摄影师的青睐。

关于

GitHub 原始描述(英文)

Plugin for Lightroom to show which focus point was active in the camera when a photo was taken

描述取自 GitHub 官方 API,保持仓库作者书写的原文。

语言占比

AutoHotkey
Lua
Perl
Pro*C
Shell

README

Current stable release: V3.4.5 updated October 30, 2026 • Preview: V4 PRE 4 (“The Next Level”)

Focus Points for Lightroom Classic

Why Focus Points?

Every photograph tells two stories.

The first is the image itself.

The second is the information your camera recorded while capturing it.

Modern cameras record far more than the final photograph. Along with the image they record autofocus information, subject detection, focus distance, lens settings, camera orientation and many other details that help explain how the photograph was captured.

Lightroom Classic imports only part of this information and displays even less.

Focus Points brings this information together in a single view, allowing you to review each photograph with the information your camera actually recorded.

Whether you’re trying to understand why a photograph is perfectly sharp, why it isn’t, or simply how your camera behaved in a particular situation, Focus Points helps you see what the camera saw when you pressed the shutter.

Use Focus Points to…

  • See where your camera focused.
  • Review autofocus areas, detected faces and subjects.
  • Inspect the information recorded by your camera.
  • Search image metadata.
  • Straighten images using recorded roll-angle information.
  • Rate, flag and label photographs while reviewing them.

Lightroom Versions

Focus Points is compatible with Lightroom Classic, LR5.71 and LR6 perpetual licenses and LrC subscriptions.

Focus Points is not compatible with Lightroom Desktop or Camera RAW. It is based on the Lightroom SDK, which is only available in Lightroom Classic.

1 LR5.7 does not support tagging photos within the plugin UI or straightening images by applying compensation for camera roll angle, since the required functionality is not supported by Lightroom SDK 5.x.


Supported Cameras

Focus Points supports cameras from

Canon • Nikon • Sony • Fuji • Olympus / OM System • Panasonic • Pentax • Ricoh • Apple

The level of support depends on the information recorded by each camera model. Please refer to the compatibility list to check if your camera is supported.


Documentation

The documentation is organized by purpose.

Document Purpose
📘 User Manual Complete feature documentation and camera-specific information.
Learn how Focus Points works, how to interpret the information displayed by the plugin and how to get the best results with your camera.
If you are new to Focus Points, it is recommended that you read chapters 1, 2 and the part of chapter 3 that applies to your camera.
🚀 Quick Setup Guide Get started in minutes. Recommended settings, display modes, and the fastest way to configure Focus Points for your workflow.
▶️  Video Tutorial Watch Olivier Rocq’s complete walkthrough of Focus Points, covering installation, configuration, and everyday use. Original video in French. Choose your language in Youtube video settings, audio track.
❓ FAQ Answers to common questions about installation, supported cameras, performance, and everyday usage.
⚠️ Messages and Warnings Understand autofocus analysis results, status messages, and warnings.
📝 Release Notes Latest versions with new features, bug fixes and compatibility changes
💬 Discussions Questions, ideas and feedback from the community.

Features

Focus Point Viewer

Focus Point Viewer

The Focus Point Viewer displays the selected photograph together with autofocus information recorded by the camera.

Depending on camera support, the viewer can display

  • active autofocus point
  • user-selected autofocus point or autofocus area
  • inactive autofocus points
  • detected faces
  • detected subjects
  • crop mode

The exact information available depends on the camera model and the metadata recorded for the image.

For a complete explanation of the different markers and their meaning, see the User Manual.

Metadata Viewer

The integrated Metadata Viewer displays camera metadata that is not normally available in Lightroom Classic.

Unlike Lightroom’s Metadata panel, the Metadata Viewer reads the information directly from the original image file and provides access to camera-specific metadata, including manufacturer-specific information where available.

Features include

  • live search
  • filtering by tag name or value
  • metadata group display
  • direct access to EXIF, XMP and camera-specific metadata

The Metadata Viewer is particularly useful when analysing camera behavior, comparing photographs or exploring newly supported camera models.

Straighten Images

Many modern cameras record the camera’s roll angle when a photograph is taken.

Focus Points can use this information to automatically straighten one or more selected photographs by applying the corresponding crop angle in Lightroom Classic.

This is particularly useful when reviewing action, wildlife or sports photography where manually straightening a large number of images would be time-consuming.

Version 3.4 also introduces interactive straightening directly from the Focus Point Viewer, allowing you to preview the result immediately and undo the adjustment if required.

Availability depends on camera support for roll-angle metadata. See the compatibility section for supported camera models.


Contributing and Support

Bug reports and feature requests are always welcome. If you discover a camera that is not yet supported or notice incorrect autofocus information, please open a GitHub Issue or start a GitHub Discussion.

Camera support has grown over many years thanks to photographs and metadata provided by users around the world.

Every contribution helps improve support for future releases.

If you don’t have a GitHub account and don’t want to create one, you can email me at [email protected].


Enjoying Focus Points?

If Focus Points has become a useful part of your Lightroom workflow and you’d like to support its continued development, bug fixes, and future improvements, you can buy me a coffee on kofi Ko-fi. Your support is always appreciated, but never expected.


Acknowledgements

Focus Points began as the open-source project created by Whizzbang Inc.

Since then it has evolved through contributions from many members of the Lightroom community.

Special thanks go to Phil Harvey, creator of ExifTool. Without ExifTool, much of the camera-specific metadata displayed by Focus Points would not be accessible.

Special thanks also go to John R. Ellis for providing the algorithm used to preserve aspect ratio while rotating photographs—functionality available in Lightroom itself but not exposed through the Lightroom SDK. John is a renowned SDK expert and the creator of numerous amazing Lightroom plugins, including the Debugging Toolkit, without which this plugin wouldn’t exist.

A full list of contributors to this project can be found on the project’s GitHub Contributors page.


License

Original work © Whizzbang Inc
Ongoing maintenance and modifications © 2026 Karsten Gieselmann

Licensed under the Apache License, Version 2.0 (the “License”);
This plugin contains code from AutoHotkey (GPLv2).
See the accompanying LICENSE files for details

评论

暂无评论